daemon: Don't use files with fixed names in /tmp (thanks Steve Kemp).
[libguestfs.git] / po-docs / ja.po
1 # SOME DESCRIPTIVE TITLE.
2 # Copyright (C) YEAR Free Software Foundation, Inc.
3 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
4 #
5 #, fuzzy
6 msgid ""
7 msgstr ""
8 "Project-Id-Version: PACKAGE VERSION\n"
9 "Report-Msgid-Bugs-To: libguestfs@redhat.com\n"
10 "POT-Creation-Date: 2011-09-16 16:37+0200\n"
11 "PO-Revision-Date: 2010-09-02 14:46+0100\n"
12 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
13 "Language-Team: LANGUAGE <LL@li.org>\n"
14 "Language: \n"
15 "MIME-Version: 1.0\n"
16 "Content-Type: text/plain; charset=UTF-8\n"
17 "Content-Transfer-Encoding: 8bit\n"
18
19 # type: =head1
20 #. type: =head1
21 #: ../src/guestfs.pod:3 ../fish/guestfish.pod:3
22 #: ../test-tool/libguestfs-test-tool.pod:3 ../fuse/guestmount.pod:3
23 #: ../tools/virt-edit.pl:32 ../tools/virt-win-reg.pl:35
24 #: ../tools/virt-resize.pl:40 ../tools/virt-list-filesystems.pl:30
25 #: ../tools/virt-tar.pl:31 ../tools/virt-make-fs.pl:35
26 #: ../tools/virt-list-partitions.pl:30
27 msgid "NAME"
28 msgstr "名前"
29
30 # type: textblock
31 #. type: textblock
32 #: ../src/guestfs.pod:5
33 msgid "guestfs - Library for accessing and modifying virtual machine images"
34 msgstr ""
35
36 # type: =head1
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-resize.pl:44 ../tools/virt-list-filesystems.pl:34
42 #: ../tools/virt-tar.pl:35 ../tools/virt-make-fs.pl:39
43 #: ../tools/virt-list-partitions.pl:34
44 msgid "SYNOPSIS"
45 msgstr ""
46
47 # type: verbatim
48 #. type: verbatim
49 #: ../src/guestfs.pod:9
50 #, no-wrap
51 msgid ""
52 " #include <guestfs.h>\n"
53 " \n"
54 msgstr ""
55
56 # type: verbatim
57 #. type: verbatim
58 #: ../src/guestfs.pod:11
59 #, no-wrap
60 msgid ""
61 " guestfs_h *g = guestfs_create ();\n"
62 " guestfs_add_drive (g, \"guest.img\");\n"
63 " guestfs_launch (g);\n"
64 " guestfs_mount (g, \"/dev/sda1\", \"/\");\n"
65 " guestfs_touch (g, \"/hello\");\n"
66 " guestfs_umount (g, \"/\");\n"
67 " guestfs_close (g);\n"
68 "\n"
69 msgstr ""
70
71 # type: verbatim
72 #. type: verbatim
73 #: ../src/guestfs.pod:19
74 #, no-wrap
75 msgid ""
76 " cc prog.c -o prog -lguestfs\n"
77 "or:\n"
78 " cc prog.c -o prog `pkg-config libguestfs --cflags --libs`\n"
79 "\n"
80 msgstr ""
81
82 # type: =head1
83 #. type: =head1
84 #: ../src/guestfs.pod:23 ../fish/guestfish.pod:30
85 #: ../test-tool/libguestfs-test-tool.pod:11 ../fuse/guestmount.pod:20
86 #: ../tools/virt-edit.pl:50 ../tools/virt-win-reg.pl:63
87 #: ../tools/virt-resize.pl:50 ../tools/virt-list-filesystems.pl:40
88 #: ../tools/virt-tar.pl:72 ../tools/virt-make-fs.pl:47
89 #: ../tools/virt-list-partitions.pl:40
90 msgid "DESCRIPTION"
91 msgstr ""
92
93 # type: textblock
94 #. type: textblock
95 #: ../src/guestfs.pod:25
96 msgid ""
97 "Libguestfs is a library for accessing and modifying guest disk images.  "
98 "Amongst the things this is good for: making batch configuration changes to "
99 "guests, getting disk used/free statistics (see also: virt-df), migrating "
100 "between virtualization systems (see also: virt-p2v), performing partial "
101 "backups, performing partial guest clones, cloning guests and changing "
102 "registry/UUID/hostname info, and much else besides."
103 msgstr ""
104
105 # type: textblock
106 #. type: textblock
107 #: ../src/guestfs.pod:33
108 msgid ""
109 "Libguestfs uses Linux kernel and qemu code, and can access any type of guest "
110 "filesystem that Linux and qemu can, including but not limited to: ext2/3/4, "
111 "btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, "
112 "qcow2, vmdk."
113 msgstr ""
114
115 # type: textblock
116 #. type: textblock
117 #: ../src/guestfs.pod:38
118 msgid ""
119 "Libguestfs provides ways to enumerate guest storage (eg. partitions, LVs, "
120 "what filesystem is in each LV, etc.).  It can also run commands in the "
121 "context of the guest.  Also you can access filesystems over FUSE."
122 msgstr ""
123
124 # type: textblock
125 #. type: textblock
126 #: ../src/guestfs.pod:43
127 msgid ""
128 "Libguestfs is a library that can be linked with C and C++ management "
129 "programs (or management programs written in OCaml, Perl, Python, Ruby, Java, "
130 "PHP, Haskell or C#).  You can also use it from shell scripts or the command "
131 "line."
132 msgstr ""
133
134 # type: textblock
135 #. type: textblock
136 #: ../src/guestfs.pod:48
137 msgid ""
138 "You don't need to be root to use libguestfs, although obviously you do need "
139 "enough permissions to access the disk images."
140 msgstr ""
141
142 # type: textblock
143 #. type: textblock
144 #: ../src/guestfs.pod:51
145 msgid ""
146 "Libguestfs is a large API because it can do many things.  For a gentle "
147 "introduction, please read the L</API OVERVIEW> section next."
148 msgstr ""
149
150 # type: textblock
151 #. type: textblock
152 #: ../src/guestfs.pod:54
153 msgid ""
154 "There are also some example programs in the L<guestfs-examples(3)> manual "
155 "page."
156 msgstr ""
157
158 # type: =head1
159 #. type: =head1
160 #: ../src/guestfs.pod:57
161 msgid "API OVERVIEW"
162 msgstr ""
163
164 # type: textblock
165 #. type: textblock
166 #: ../src/guestfs.pod:59
167 msgid ""
168 "This section provides a gentler overview of the libguestfs API.  We also try "
169 "to group API calls together, where that may not be obvious from reading "
170 "about the individual calls in the main section of this manual."
171 msgstr ""
172
173 # type: =head2
174 #. type: =head2
175 #: ../src/guestfs.pod:64
176 msgid "HANDLES"
177 msgstr ""
178
179 # type: textblock
180 #. type: textblock
181 #: ../src/guestfs.pod:66
182 msgid ""
183 "Before you can use libguestfs calls, you have to create a handle.  Then you "
184 "must add at least one disk image to the handle, followed by launching the "
185 "handle, then performing whatever operations you want, and finally closing "
186 "the handle.  By convention we use the single letter C<g> for the name of the "
187 "handle variable, although of course you can use any name you want."
188 msgstr ""
189
190 # type: textblock
191 #. type: textblock
192 #: ../src/guestfs.pod:73
193 msgid "The general structure of all libguestfs-using programs looks like this:"
194 msgstr ""
195
196 # type: verbatim
197 #. type: verbatim
198 #: ../src/guestfs.pod:76
199 #, no-wrap
200 msgid ""
201 " guestfs_h *g = guestfs_create ();\n"
202 " \n"
203 msgstr ""
204
205 # type: verbatim
206 #. type: verbatim
207 #: ../src/guestfs.pod:78
208 #, no-wrap
209 msgid ""
210 " /* Call guestfs_add_drive additional times if there are\n"
211 "  * multiple disk images.\n"
212 "  */\n"
213 " guestfs_add_drive (g, \"guest.img\");\n"
214 " \n"
215 msgstr ""
216
217 # type: verbatim
218 #. type: verbatim
219 #: ../src/guestfs.pod:83
220 #, no-wrap
221 msgid ""
222 " /* Most manipulation calls won't work until you've launched\n"
223 "  * the handle 'g'.  You have to do this _after_ adding drives\n"
224 "  * and _before_ other commands.\n"
225 "  */\n"
226 " guestfs_launch (g);\n"
227 " \n"
228 msgstr ""
229
230 # type: verbatim
231 #. type: verbatim
232 #: ../src/guestfs.pod:89
233 #, no-wrap
234 msgid ""
235 " /* Now you can examine what partitions, LVs etc are available.\n"
236 "  */\n"
237 " char **partitions = guestfs_list_partitions (g);\n"
238 " char **logvols = guestfs_lvs (g);\n"
239 " \n"
240 msgstr ""
241
242 # type: verbatim
243 #. type: verbatim
244 #: ../src/guestfs.pod:94
245 #, no-wrap
246 msgid ""
247 " /* To access a filesystem in the image, you must mount it.\n"
248 "  */\n"
249 " guestfs_mount (g, \"/dev/sda1\", \"/\");\n"
250 " \n"
251 msgstr ""
252
253 #. type: verbatim
254 #: ../src/guestfs.pod:98
255 #, no-wrap
256 msgid ""
257 " /* Now you can perform filesystem actions on the guest\n"
258 "  * disk image.\n"
259 "  */\n"
260 " guestfs_touch (g, \"/hello\");\n"
261 " \n"
262 msgstr ""
263
264 # type: verbatim
265 #. type: verbatim
266 #: ../src/guestfs.pod:103
267 #, no-wrap
268 msgid ""
269 " /* This is only needed for libguestfs < 1.5.24.  Since then\n"
270 "  * it is done automatically when you close the handle.  See\n"
271 "  * discussion of autosync in this page.\n"
272 "  */\n"
273 " guestfs_sync (g);\n"
274 " \n"
275 msgstr ""
276
277 # type: verbatim
278 #. type: verbatim
279 #: ../src/guestfs.pod:109
280 #, no-wrap
281 msgid ""
282 " /* Close the handle 'g'. */\n"
283 " guestfs_close (g);\n"
284 "\n"
285 msgstr ""
286
287 # type: textblock
288 #. type: textblock
289 #: ../src/guestfs.pod:112
290 msgid ""
291 "The code above doesn't include any error checking.  In real code you should "
292 "check return values carefully for errors.  In general all functions that "
293 "return integers return C<-1> on error, and all functions that return "
294 "pointers return C<NULL> on error.  See section L</ERROR HANDLING> below for "
295 "how to handle errors, and consult the documentation for each function call "
296 "below to see precisely how they return error indications.  See L<guestfs-"
297 "examples(3)> for fully worked examples."
298 msgstr ""
299
300 # type: =head2
301 #. type: =head2
302 #: ../src/guestfs.pod:121
303 msgid "DISK IMAGES"
304 msgstr ""
305
306 # type: textblock
307 #. type: textblock
308 #: ../src/guestfs.pod:123
309 msgid ""
310 "The image filename (C<\"guest.img\"> in the example above) could be a disk "
311 "image from a virtual machine, a L<dd(1)> copy of a physical hard disk, an "
312 "actual block device, or simply an empty file of zeroes that you have created "
313 "through L<posix_fallocate(3)>.  Libguestfs lets you do useful things to all "
314 "of these."
315 msgstr ""
316
317 # type: textblock
318 #. type: textblock
319 #: ../src/guestfs.pod:129
320 msgid ""
321 "The call you should use in modern code for adding drives is L</"
322 "guestfs_add_drive_opts>.  To add a disk image, allowing writes, and "
323 "specifying that the format is raw, do:"
324 msgstr ""
325
326 # type: verbatim
327 #. type: verbatim
328 #: ../src/guestfs.pod:133
329 #, no-wrap
330 msgid ""
331 " guestfs_add_drive_opts (g, filename,\n"
332 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"raw\",\n"
333 "                         -1);\n"
334 "\n"
335 msgstr ""
336
337 # type: textblock
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 #. type: verbatim
345 #: ../src/guestfs.pod:139
346 #, no-wrap
347 msgid ""
348 " guestfs_add_drive_opts (g, filename,\n"
349 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"raw\",\n"
350 "                         GUESTFS_ADD_DRIVE_OPTS_READONLY, 1,\n"
351 "                         -1);\n"
352 "\n"
353 msgstr ""
354
355 # type: textblock
356 #. type: textblock
357 #: ../src/guestfs.pod:144
358 msgid ""
359 "or by calling the older function L</guestfs_add_drive_ro>.  In either case "
360 "libguestfs won't modify the file."
361 msgstr ""
362
363 # type: textblock
364 #. type: textblock
365 #: ../src/guestfs.pod:147
366 msgid ""
367 "Be extremely cautious if the disk image is in use, eg. if it is being used "
368 "by a virtual machine.  Adding it read-write will almost certainly cause disk "
369 "corruption, but adding it read-only is safe."
370 msgstr ""
371
372 # type: textblock
373 #. type: textblock
374 #: ../src/guestfs.pod:151
375 msgid ""
376 "You must add at least one disk image, and you may add multiple disk images.  "
377 "In the API, the disk images are usually referred to as C</dev/sda> (for the "
378 "first one you added), C</dev/sdb> (for the second one you added), etc."
379 msgstr ""
380
381 # type: textblock
382 #. type: textblock
383 #: ../src/guestfs.pod:156
384 msgid ""
385 "Once L</guestfs_launch> has been called you cannot add any more images.  You "
386 "can call L</guestfs_list_devices> to get a list of the device names, in the "
387 "order that you added them.  See also L</BLOCK DEVICE NAMING> below."
388 msgstr ""
389
390 # type: =head2
391 #. type: =head2
392 #: ../src/guestfs.pod:161
393 msgid "MOUNTING"
394 msgstr ""
395
396 #. type: textblock
397 #: ../src/guestfs.pod:163
398 msgid ""
399 "Before you can read or write files, create directories and so on in a disk "
400 "image that contains filesystems, you have to mount those filesystems using "
401 "L</guestfs_mount_options> or L</guestfs_mount_ro>.  If you already know that "
402 "a disk image contains (for example) one partition with a filesystem on that "
403 "partition, then you can mount it directly:"
404 msgstr ""
405
406 #. type: verbatim
407 #: ../src/guestfs.pod:170
408 #, no-wrap
409 msgid ""
410 " guestfs_mount_options (g, \"\", \"/dev/sda1\", \"/\");\n"
411 "\n"
412 msgstr ""
413
414 #. type: textblock
415 #: ../src/guestfs.pod:172
416 msgid ""
417 "where C</dev/sda1> means literally the first partition (C<1>) of the first "
418 "disk image that we added (C</dev/sda>).  If the disk contains Linux LVM2 "
419 "logical volumes you could refer to those instead (eg. C</dev/VG/LV>).  Note "
420 "that these are libguestfs virtual devices, and are nothing to do with host "
421 "devices."
422 msgstr ""
423
424 #. type: textblock
425 #: ../src/guestfs.pod:178
426 msgid ""
427 "If you are given a disk image and you don't know what it contains then you "
428 "have to find out.  Libguestfs can do that too: use L</"
429 "guestfs_list_partitions> and L</guestfs_lvs> to list possible partitions and "
430 "LVs, and either try mounting each to see what is mountable, or else examine "
431 "them with L</guestfs_vfs_type> or L</guestfs_file>.  To list just "
432 "filesystems, use L</guestfs_list_filesystems>."
433 msgstr ""
434
435 #. type: textblock
436 #: ../src/guestfs.pod:186
437 msgid ""
438 "Libguestfs also has a set of APIs for inspection of unknown disk images (see "
439 "L</INSPECTION> below).  But you might find it easier to look at higher level "
440 "programs built on top of libguestfs, in particular L<virt-inspector(1)>."
441 msgstr ""
442
443 #. type: textblock
444 #: ../src/guestfs.pod:191
445 msgid ""
446 "To mount a filesystem read-only, use L</guestfs_mount_ro>.  There are "
447 "several other variations of the C<guestfs_mount_*> call."
448 msgstr ""
449
450 # type: =head2
451 #. type: =head2
452 #: ../src/guestfs.pod:194
453 msgid "FILESYSTEM ACCESS AND MODIFICATION"
454 msgstr ""
455
456 # type: textblock
457 #. type: textblock
458 #: ../src/guestfs.pod:196
459 msgid ""
460 "The majority of the libguestfs API consists of fairly low-level calls for "
461 "accessing and modifying the files, directories, symlinks etc on mounted "
462 "filesystems.  There are over a hundred such calls which you can find listed "
463 "in detail below in this man page, and we don't even pretend to cover them "
464 "all in this overview."
465 msgstr ""
466
467 # type: textblock
468 #. type: textblock
469 #: ../src/guestfs.pod:202
470 msgid ""
471 "Specify filenames as full paths, starting with C<\"/\"> and including the "
472 "mount point."
473 msgstr ""
474
475 # type: textblock
476 #. type: textblock
477 #: ../src/guestfs.pod:205
478 msgid ""
479 "For example, if you mounted a filesystem at C<\"/\"> and you want to read "
480 "the file called C<\"etc/passwd\"> then you could do:"
481 msgstr ""
482
483 # type: verbatim
484 #. type: verbatim
485 #: ../src/guestfs.pod:208
486 #, no-wrap
487 msgid ""
488 " char *data = guestfs_cat (g, \"/etc/passwd\");\n"
489 "\n"
490 msgstr ""
491
492 # type: textblock
493 #. type: textblock
494 #: ../src/guestfs.pod:210
495 msgid ""
496 "This would return C<data> as a newly allocated buffer containing the full "
497 "content of that file (with some conditions: see also L</DOWNLOADING> below), "
498 "or C<NULL> if there was an error."
499 msgstr ""
500
501 # type: textblock
502 #. type: textblock
503 #: ../src/guestfs.pod:214
504 msgid ""
505 "As another example, to create a top-level directory on that filesystem "
506 "called C<\"var\"> you would do:"
507 msgstr ""
508
509 # type: verbatim
510 #. type: verbatim
511 #: ../src/guestfs.pod:217
512 #, no-wrap
513 msgid ""
514 " guestfs_mkdir (g, \"/var\");\n"
515 "\n"
516 msgstr ""
517
518 # type: textblock
519 #. type: textblock
520 #: ../src/guestfs.pod:219
521 msgid "To create a symlink you could do:"
522 msgstr ""
523
524 # type: verbatim
525 #. type: verbatim
526 #: ../src/guestfs.pod:221
527 #, no-wrap
528 msgid ""
529 " guestfs_ln_s (g, \"/etc/init.d/portmap\",\n"
530 "               \"/etc/rc3.d/S30portmap\");\n"
531 "\n"
532 msgstr ""
533
534 # type: textblock
535 #. type: textblock
536 #: ../src/guestfs.pod:224
537 msgid ""
538 "Libguestfs will reject attempts to use relative paths and there is no "
539 "concept of a current working directory."
540 msgstr ""
541
542 # type: textblock
543 #. type: textblock
544 #: ../src/guestfs.pod:227
545 msgid ""
546 "Libguestfs can return errors in many situations: for example if the "
547 "filesystem isn't writable, or if a file or directory that you requested "
548 "doesn't exist.  If you are using the C API (documented here)  you have to "
549 "check for those error conditions after each call.  (Other language bindings "
550 "turn these errors into exceptions)."
551 msgstr ""
552
553 # type: textblock
554 #. type: textblock
555 #: ../src/guestfs.pod:233
556 msgid ""
557 "File writes are affected by the per-handle umask, set by calling L</"
558 "guestfs_umask> and defaulting to 022.  See L</UMASK>."
559 msgstr ""
560
561 # type: =head2
562 #. type: =head2
563 #: ../src/guestfs.pod:236
564 msgid "PARTITIONING"
565 msgstr ""
566
567 # type: textblock
568 #. type: textblock
569 #: ../src/guestfs.pod:238
570 msgid ""
571 "Libguestfs contains API calls to read, create and modify partition tables on "
572 "disk images."
573 msgstr ""
574
575 # type: textblock
576 #. type: textblock
577 #: ../src/guestfs.pod:241
578 msgid ""
579 "In the common case where you want to create a single partition covering the "
580 "whole disk, you should use the L</guestfs_part_disk> call:"
581 msgstr ""
582
583 # type: verbatim
584 #. type: verbatim
585 #: ../src/guestfs.pod:245
586 #, no-wrap
587 msgid ""
588 " const char *parttype = \"mbr\";\n"
589 " if (disk_is_larger_than_2TB)\n"
590 "   parttype = \"gpt\";\n"
591 " guestfs_part_disk (g, \"/dev/sda\", parttype);\n"
592 "\n"
593 msgstr ""
594
595 # type: textblock
596 #. type: textblock
597 #: ../src/guestfs.pod:250
598 msgid ""
599 "Obviously this effectively wipes anything that was on that disk image before."
600 msgstr ""
601
602 # type: =head2
603 #. type: =head2
604 #: ../src/guestfs.pod:253
605 msgid "LVM2"
606 msgstr ""
607
608 # type: textblock
609 #. type: textblock
610 #: ../src/guestfs.pod:255
611 msgid ""
612 "Libguestfs provides access to a large part of the LVM2 API, such as L</"
613 "guestfs_lvcreate> and L</guestfs_vgremove>.  It won't make much sense unless "
614 "you familiarize yourself with the concepts of physical volumes, volume "
615 "groups and logical volumes."
616 msgstr ""
617
618 # type: textblock
619 #. type: textblock
620 #: ../src/guestfs.pod:260
621 msgid ""
622 "This author strongly recommends reading the LVM HOWTO, online at L<http://"
623 "tldp.org/HOWTO/LVM-HOWTO/>."
624 msgstr ""
625
626 # type: =head2
627 #. type: =head2
628 #: ../src/guestfs.pod:263
629 msgid "DOWNLOADING"
630 msgstr ""
631
632 #. type: textblock
633 #: ../src/guestfs.pod:265
634 msgid ""
635 "Use L</guestfs_cat> to download small, text only files.  This call is "
636 "limited to files which are less than 2 MB and which cannot contain any ASCII "
637 "NUL (C<\\0>) characters.  However the API is very simple to use."
638 msgstr ""
639
640 # type: textblock
641 #. type: textblock
642 #: ../src/guestfs.pod:269
643 msgid ""
644 "L</guestfs_read_file> can be used to read files which contain arbitrary 8 "
645 "bit data, since it returns a (pointer, size) pair.  However it is still "
646 "limited to \"small\" files, less than 2 MB."
647 msgstr ""
648
649 # type: textblock
650 #. type: textblock
651 #: ../src/guestfs.pod:273
652 msgid ""
653 "L</guestfs_download> can be used to download any file, with no limits on "
654 "content or size (even files larger than 4 GB)."
655 msgstr ""
656
657 # type: textblock
658 #. type: textblock
659 #: ../src/guestfs.pod:276
660 msgid ""
661 "To download multiple files, see L</guestfs_tar_out> and L</guestfs_tgz_out>."
662 msgstr ""
663
664 # type: =head2
665 #. type: =head2
666 #: ../src/guestfs.pod:279
667 msgid "UPLOADING"
668 msgstr ""
669
670 # type: textblock
671 #. type: textblock
672 #: ../src/guestfs.pod:281
673 msgid ""
674 "It's often the case that you want to write a file or files to the disk image."
675 msgstr ""
676
677 # type: textblock
678 #. type: textblock
679 #: ../src/guestfs.pod:284
680 msgid ""
681 "To write a small file with fixed content, use L</guestfs_write>.  To create "
682 "a file of all zeroes, use L</guestfs_truncate_size> (sparse) or L</"
683 "guestfs_fallocate64> (with all disk blocks allocated).  There are a variety "
684 "of other functions for creating test files, for example L</guestfs_fill> and "
685 "L</guestfs_fill_pattern>."
686 msgstr ""
687
688 # type: textblock
689 #. type: textblock
690 #: ../src/guestfs.pod:290
691 msgid ""
692 "To upload a single file, use L</guestfs_upload>.  This call has no limits on "
693 "file content or size (even files larger than 4 GB)."
694 msgstr ""
695
696 # type: textblock
697 #. type: textblock
698 #: ../src/guestfs.pod:293
699 msgid ""
700 "To upload multiple files, see L</guestfs_tar_in> and L</guestfs_tgz_in>."
701 msgstr ""
702
703 # type: textblock
704 #. type: textblock
705 #: ../src/guestfs.pod:295
706 msgid ""
707 "However the fastest way to upload I<large numbers of arbitrary files> is to "
708 "turn them into a squashfs or CD ISO (see L<mksquashfs(8)> and L<mkisofs(8)"
709 ">), then attach this using L</guestfs_add_drive_ro>.  If you add the drive "
710 "in a predictable way (eg. adding it last after all other drives) then you "
711 "can get the device name from L</guestfs_list_devices> and mount it directly "
712 "using L</guestfs_mount_ro>.  Note that squashfs images are sometimes non-"
713 "portable between kernel versions, and they don't support labels or UUIDs.  "
714 "If you want to pre-build an image or you need to mount it using a label or "
715 "UUID, use an ISO image instead."
716 msgstr ""
717
718 # type: =head2
719 #. type: =head2
720 #: ../src/guestfs.pod:306
721 msgid "COPYING"
722 msgstr ""
723
724 # type: textblock
725 #. type: textblock
726 #: ../src/guestfs.pod:308
727 msgid ""
728 "There are various different commands for copying between files and devices "
729 "and in and out of the guest filesystem.  These are summarised in the table "
730 "below."
731 msgstr ""
732
733 # type: =item
734 #. type: =item
735 #: ../src/guestfs.pod:314
736 msgid "B<file> to B<file>"
737 msgstr ""
738
739 # type: textblock
740 #. type: textblock
741 #: ../src/guestfs.pod:316
742 msgid ""
743 "Use L</guestfs_cp> to copy a single file, or L</guestfs_cp_a> to copy "
744 "directories recursively."
745 msgstr ""
746
747 # type: =item
748 #. type: =item
749 #: ../src/guestfs.pod:319
750 msgid "B<file or device> to B<file or device>"
751 msgstr ""
752
753 # type: textblock
754 #. type: textblock
755 #: ../src/guestfs.pod:321
756 msgid ""
757 "Use L</guestfs_dd> which efficiently uses L<dd(1)> to copy between files and "
758 "devices in the guest."
759 msgstr ""
760
761 # type: textblock
762 #. type: textblock
763 #: ../src/guestfs.pod:324
764 msgid "Example: duplicate the contents of an LV:"
765 msgstr ""
766
767 # type: verbatim
768 #. type: verbatim
769 #: ../src/guestfs.pod:326
770 #, no-wrap
771 msgid ""
772 " guestfs_dd (g, \"/dev/VG/Original\", \"/dev/VG/Copy\");\n"
773 "\n"
774 msgstr ""
775
776 # type: textblock
777 #. type: textblock
778 #: ../src/guestfs.pod:328
779 msgid ""
780 "The destination (C</dev/VG/Copy>) must be at least as large as the source "
781 "(C</dev/VG/Original>).  To copy less than the whole source device, use L</"
782 "guestfs_copy_size>."
783 msgstr ""
784
785 # type: =item
786 #. type: =item
787 #: ../src/guestfs.pod:332
788 msgid "B<file on the host> to B<file or device>"
789 msgstr ""
790
791 # type: textblock
792 #. type: textblock
793 #: ../src/guestfs.pod:334
794 msgid "Use L</guestfs_upload>.  See L</UPLOADING> above."
795 msgstr ""
796
797 # type: =item
798 #. type: =item
799 #: ../src/guestfs.pod:336
800 msgid "B<file or device> to B<file on the host>"
801 msgstr ""
802
803 # type: textblock
804 #. type: textblock
805 #: ../src/guestfs.pod:338
806 msgid "Use L</guestfs_download>.  See L</DOWNLOADING> above."
807 msgstr ""
808
809 # type: =head2
810 #. type: =head2
811 #: ../src/guestfs.pod:342
812 msgid "UPLOADING AND DOWNLOADING TO PIPES AND FILE DESCRIPTORS"
813 msgstr ""
814
815 # type: textblock
816 #. type: textblock
817 #: ../src/guestfs.pod:344
818 msgid ""
819 "Calls like L</guestfs_upload>, L</guestfs_download>, L</guestfs_tar_in>, L</"
820 "guestfs_tar_out> etc appear to only take filenames as arguments, so it "
821 "appears you can only upload and download to files.  However many Un*x-like "
822 "hosts let you use the special device files C</dev/stdin>, C</dev/stdout>, C</"
823 "dev/stderr> and C</dev/fd/N> to read and write from stdin, stdout, stderr, "
824 "and arbitrary file descriptor N."
825 msgstr ""
826
827 # type: textblock
828 #. type: textblock
829 #: ../src/guestfs.pod:352
830 msgid "For example, L<virt-cat(1)> writes its output to stdout by doing:"
831 msgstr ""
832
833 #. type: verbatim
834 #: ../src/guestfs.pod:355
835 #, no-wrap
836 msgid ""
837 " guestfs_download (g, filename, \"/dev/stdout\");\n"
838 "\n"
839 msgstr ""
840
841 # type: textblock
842 #. type: textblock
843 #: ../src/guestfs.pod:357
844 msgid "and you can write tar output to a pipe C<fd> by doing:"
845 msgstr ""
846
847 #. type: verbatim
848 #: ../src/guestfs.pod:359
849 #, no-wrap
850 msgid ""
851 " char devfd[64];\n"
852 " snprintf (devfd, sizeof devfd, \"/dev/fd/%d\", fd);\n"
853 " guestfs_tar_out (g, \"/\", devfd);\n"
854 "\n"
855 msgstr ""
856
857 # type: =head2
858 #. type: =head2
859 #: ../src/guestfs.pod:363
860 msgid "LISTING FILES"
861 msgstr ""
862
863 # type: textblock
864 #. type: textblock
865 #: ../src/guestfs.pod:365
866 msgid ""
867 "L</guestfs_ll> is just designed for humans to read (mainly when using the "
868 "L<guestfish(1)>-equivalent command C<ll>)."
869 msgstr ""
870
871 # type: textblock
872 #. type: textblock
873 #: ../src/guestfs.pod:368
874 msgid ""
875 "L</guestfs_ls> is a quick way to get a list of files in a directory from "
876 "programs, as a flat list of strings."
877 msgstr ""
878
879 # type: textblock
880 #. type: textblock
881 #: ../src/guestfs.pod:371
882 msgid ""
883 "L</guestfs_readdir> is a programmatic way to get a list of files in a "
884 "directory, plus additional information about each one.  It is more "
885 "equivalent to using the L<readdir(3)> call on a local filesystem."
886 msgstr ""
887
888 # type: textblock
889 #. type: textblock
890 #: ../src/guestfs.pod:375
891 msgid ""
892 "L</guestfs_find> and L</guestfs_find0> can be used to recursively list files."
893 msgstr ""
894
895 # type: =head2
896 #. type: =head2
897 #: ../src/guestfs.pod:378
898 msgid "RUNNING COMMANDS"
899 msgstr ""
900
901 # type: textblock
902 #. type: textblock
903 #: ../src/guestfs.pod:380
904 msgid ""
905 "Although libguestfs is primarily an API for manipulating files inside guest "
906 "images, we also provide some limited facilities for running commands inside "
907 "guests."
908 msgstr ""
909
910 # type: textblock
911 #. type: textblock
912 #: ../src/guestfs.pod:384
913 msgid "There are many limitations to this:"
914 msgstr ""
915
916 # type: =item
917 #. type: =item
918 #: ../src/guestfs.pod:388 ../src/guestfs.pod:393 ../src/guestfs.pod:398
919 #: ../src/guestfs.pod:402 ../src/guestfs.pod:407 ../src/guestfs.pod:411
920 #: ../src/guestfs.pod:416 ../src/guestfs.pod:421 ../src/guestfs.pod:1011
921 #: ../src/guestfs.pod:1015 ../src/guestfs.pod:1019 ../src/guestfs.pod:1024
922 #: ../src/guestfs.pod:1032 ../src/guestfs.pod:1051 ../src/guestfs.pod:1059
923 #: ../src/guestfs.pod:1081 ../src/guestfs.pod:1085 ../src/guestfs.pod:1089
924 #: ../src/guestfs.pod:1093 ../src/guestfs.pod:1097 ../src/guestfs.pod:1101
925 #: ../src/guestfs.pod:1583 ../src/guestfs.pod:1588 ../src/guestfs.pod:1592
926 #: ../src/guestfs.pod:1702 ../src/guestfs.pod:1707 ../src/guestfs.pod:1711
927 #: ../src/guestfs.pod:2064 ../src/guestfs.pod:2070 ../src/guestfs.pod:2075
928 #: ../src/guestfs.pod:2081 ../src/guestfs.pod:2540 ../src/guestfs.pod:2544
929 #: ../src/guestfs.pod:2548 ../src/guestfs.pod:2552
930 #: ../src/guestfs-actions.pod:15 ../src/guestfs-actions.pod:22
931 #: ../src/guestfs-actions.pod:574 ../src/guestfs-actions.pod:582
932 #: ../src/guestfs-actions.pod:589 ../src/guestfs-actions.pod:596
933 #: ../src/guestfs-actions.pod:1589 ../src/guestfs-actions.pod:1593
934 #: ../src/guestfs-actions.pod:1597 ../src/guestfs-actions.pod:1601
935 #: ../src/guestfs-actions.pod:1609 ../src/guestfs-actions.pod:1613
936 #: ../src/guestfs-actions.pod:1617 ../src/guestfs-actions.pod:1627
937 #: ../src/guestfs-actions.pod:1631 ../src/guestfs-actions.pod:1635
938 #: ../src/guestfs-actions.pod:1773 ../src/guestfs-actions.pod:1777
939 #: ../src/guestfs-actions.pod:1782 ../src/guestfs-actions.pod:1787
940 #: ../src/guestfs-actions.pod:1848 ../src/guestfs-actions.pod:1852
941 #: ../src/guestfs-actions.pod:1857 ../src/guestfs-actions.pod:2238
942 #: ../src/guestfs-actions.pod:2245 ../src/guestfs-actions.pod:2252
943 #: ../fish/guestfish.pod:427 ../fish/guestfish.pod:431
944 #: ../fish/guestfish.pod:435 ../fish/guestfish.pod:439
945 #: ../fish/guestfish-actions.pod:13 ../fish/guestfish-actions.pod:20
946 #: ../fish/guestfish-actions.pod:378 ../fish/guestfish-actions.pod:386
947 #: ../fish/guestfish-actions.pod:393 ../fish/guestfish-actions.pod:400
948 #: ../fish/guestfish-actions.pod:1067 ../fish/guestfish-actions.pod:1071
949 #: ../fish/guestfish-actions.pod:1075 ../fish/guestfish-actions.pod:1079
950 #: ../fish/guestfish-actions.pod:1087 ../fish/guestfish-actions.pod:1091
951 #: ../fish/guestfish-actions.pod:1095 ../fish/guestfish-actions.pod:1105
952 #: ../fish/guestfish-actions.pod:1109 ../fish/guestfish-actions.pod:1113
953 #: ../fish/guestfish-actions.pod:1203 ../fish/guestfish-actions.pod:1207
954 #: ../fish/guestfish-actions.pod:1212 ../fish/guestfish-actions.pod:1217
955 #: ../fish/guestfish-actions.pod:1259 ../fish/guestfish-actions.pod:1263
956 #: ../fish/guestfish-actions.pod:1268 ../fish/guestfish-actions.pod:1506
957 #: ../fish/guestfish-actions.pod:1513 ../fish/guestfish-actions.pod:1520
958 #: ../tools/virt-win-reg.pl:536 ../tools/virt-win-reg.pl:542
959 #: ../tools/virt-win-reg.pl:548 ../tools/virt-resize.pl:345
960 #: ../tools/virt-resize.pl:350 ../tools/virt-resize.pl:360
961 msgid "*"
962 msgstr ""
963
964 # type: textblock
965 #. type: textblock
966 #: ../src/guestfs.pod:390
967 msgid ""
968 "The kernel version that the command runs under will be different from what "
969 "it expects."
970 msgstr ""
971
972 # type: textblock
973 #. type: textblock
974 #: ../src/guestfs.pod:395
975 msgid ""
976 "If the command needs to communicate with daemons, then most likely they "
977 "won't be running."
978 msgstr ""
979
980 # type: textblock
981 #. type: textblock
982 #: ../src/guestfs.pod:400
983 msgid "The command will be running in limited memory."
984 msgstr ""
985
986 # type: textblock
987 #. type: textblock
988 #: ../src/guestfs.pod:404
989 msgid ""
990 "The network may not be available unless you enable it (see L</"
991 "guestfs_set_network>)."
992 msgstr ""
993
994 # type: textblock
995 #. type: textblock
996 #: ../src/guestfs.pod:409
997 msgid "Only supports Linux guests (not Windows, BSD, etc)."
998 msgstr ""
999
1000 # type: textblock
1001 #. type: textblock
1002 #: ../src/guestfs.pod:413
1003 msgid ""
1004 "Architecture limitations (eg. won't work for a PPC guest on an X86 host)."
1005 msgstr ""
1006
1007 # type: textblock
1008 #. type: textblock
1009 #: ../src/guestfs.pod:418
1010 msgid ""
1011 "For SELinux guests, you may need to enable SELinux and load policy first.  "
1012 "See L</SELINUX> in this manpage."
1013 msgstr ""
1014
1015 # type: textblock
1016 #. type: textblock
1017 #: ../src/guestfs.pod:423
1018 msgid ""
1019 "I<Security:> It is not safe to run commands from untrusted, possibly "
1020 "malicious guests.  These commands may attempt to exploit your program by "
1021 "sending unexpected output.  They could also try to exploit the Linux kernel "
1022 "or qemu provided by the libguestfs appliance.  They could use the network "
1023 "provided by the libguestfs appliance to bypass ordinary network partitions "
1024 "and firewalls.  They could use the elevated privileges or different SELinux "
1025 "context of your program to their advantage."
1026 msgstr ""
1027
1028 # type: textblock
1029 #. type: textblock
1030 #: ../src/guestfs.pod:432
1031 msgid ""
1032 "A secure alternative is to use libguestfs to install a \"firstboot\" script "
1033 "(a script which runs when the guest next boots normally), and to have this "
1034 "script run the commands you want in the normal context of the running guest, "
1035 "network security and so on.  For information about other security issues, "
1036 "see L</SECURITY>."
1037 msgstr ""
1038
1039 # type: textblock
1040 #. type: textblock
1041 #: ../src/guestfs.pod:440
1042 msgid ""
1043 "The two main API calls to run commands are L</guestfs_command> and L</"
1044 "guestfs_sh> (there are also variations)."
1045 msgstr ""
1046
1047 # type: textblock
1048 #. type: textblock
1049 #: ../src/guestfs.pod:443
1050 msgid ""
1051 "The difference is that L</guestfs_sh> runs commands using the shell, so any "
1052 "shell globs, redirections, etc will work."
1053 msgstr ""
1054
1055 # type: =head2
1056 #. type: =head2
1057 #: ../src/guestfs.pod:446
1058 msgid "CONFIGURATION FILES"
1059 msgstr ""
1060
1061 # type: textblock
1062 #. type: textblock
1063 #: ../src/guestfs.pod:448
1064 msgid ""
1065 "To read and write configuration files in Linux guest filesystems, we "
1066 "strongly recommend using Augeas.  For example, Augeas understands how to "
1067 "read and write, say, a Linux shadow password file or X.org configuration "
1068 "file, and so avoids you having to write that code."
1069 msgstr ""
1070
1071 # type: textblock
1072 #. type: textblock
1073 #: ../src/guestfs.pod:453
1074 msgid ""
1075 "The main Augeas calls are bound through the C<guestfs_aug_*> APIs.  We don't "
1076 "document Augeas itself here because there is excellent documentation on the "
1077 "L<http://augeas.net/> website."
1078 msgstr ""
1079
1080 # type: textblock
1081 #. type: textblock
1082 #: ../src/guestfs.pod:457
1083 msgid ""
1084 "If you don't want to use Augeas (you fool!) then try calling L</"
1085 "guestfs_read_lines> to get the file as a list of lines which you can iterate "
1086 "over."
1087 msgstr ""
1088
1089 # type: =head2
1090 #. type: =head2
1091 #: ../src/guestfs.pod:461
1092 msgid "SELINUX"
1093 msgstr ""
1094
1095 # type: textblock
1096 #. type: textblock
1097 #: ../src/guestfs.pod:463
1098 msgid ""
1099 "We support SELinux guests.  To ensure that labeling happens correctly in "
1100 "SELinux guests, you need to enable SELinux and load the guest's policy:"
1101 msgstr ""
1102
1103 # type: =item
1104 #. type: =item
1105 #: ../src/guestfs.pod:469 ../src/guestfs.pod:1204 ../src/guestfs.pod:1335
1106 #: ../src/guestfs.pod:2109
1107 msgid "1."
1108 msgstr ""
1109
1110 # type: textblock
1111 #. type: textblock
1112 #: ../src/guestfs.pod:471
1113 msgid "Before launching, do:"
1114 msgstr ""
1115
1116 # type: verbatim
1117 #. type: verbatim
1118 #: ../src/guestfs.pod:473
1119 #, no-wrap
1120 msgid ""
1121 " guestfs_set_selinux (g, 1);\n"
1122 "\n"
1123 msgstr ""
1124
1125 # type: =item
1126 #. type: =item
1127 #: ../src/guestfs.pod:475 ../src/guestfs.pod:1208 ../src/guestfs.pod:1339
1128 #: ../src/guestfs.pod:2134
1129 msgid "2."
1130 msgstr ""
1131
1132 # type: textblock
1133 #. type: textblock
1134 #: ../src/guestfs.pod:477
1135 msgid ""
1136 "After mounting the guest's filesystem(s), load the policy.  This is best "
1137 "done by running the L<load_policy(8)> command in the guest itself:"
1138 msgstr ""
1139
1140 # type: verbatim
1141 #. type: verbatim
1142 #: ../src/guestfs.pod:481
1143 #, no-wrap
1144 msgid ""
1145 " guestfs_sh (g, \"/usr/sbin/load_policy\");\n"
1146 "\n"
1147 msgstr ""
1148
1149 # type: textblock
1150 #. type: textblock
1151 #: ../src/guestfs.pod:483
1152 msgid ""
1153 "(Older versions of C<load_policy> require you to specify the name of the "
1154 "policy file)."
1155 msgstr ""
1156
1157 # type: =item
1158 #. type: =item
1159 #: ../src/guestfs.pod:486 ../src/guestfs.pod:1345
1160 msgid "3."
1161 msgstr ""
1162
1163 # type: textblock
1164 #. type: textblock
1165 #: ../src/guestfs.pod:488
1166 msgid ""
1167 "Optionally, set the security context for the API.  The correct security "
1168 "context to use can only be known by inspecting the guest.  As an example:"
1169 msgstr ""
1170
1171 # type: verbatim
1172 #. type: verbatim
1173 #: ../src/guestfs.pod:492
1174 #, no-wrap
1175 msgid ""
1176 " guestfs_setcon (g, \"unconfined_u:unconfined_r:unconfined_t:s0\");\n"
1177 "\n"
1178 msgstr ""
1179
1180 # type: textblock
1181 #. type: textblock
1182 #: ../src/guestfs.pod:496
1183 msgid "This will work for running commands and editing existing files."
1184 msgstr ""
1185
1186 # type: textblock
1187 #. type: textblock
1188 #: ../src/guestfs.pod:498
1189 msgid ""
1190 "When new files are created, you may need to label them explicitly, for "
1191 "example by running the external command C<restorecon pathname>."
1192 msgstr ""
1193
1194 # type: =head2
1195 #. type: =head2
1196 #: ../src/guestfs.pod:502
1197 msgid "UMASK"
1198 msgstr ""
1199
1200 # type: textblock
1201 #. type: textblock
1202 #: ../src/guestfs.pod:504
1203 msgid ""
1204 "Certain calls are affected by the current file mode creation mask (the "
1205 "\"umask\").  In particular ones which create files or directories, such as "
1206 "L</guestfs_touch>, L</guestfs_mknod> or L</guestfs_mkdir>.  This affects "
1207 "either the default mode that the file is created with or modifies the mode "
1208 "that you supply."
1209 msgstr ""
1210
1211 # type: textblock
1212 #. type: textblock
1213 #: ../src/guestfs.pod:510
1214 msgid ""
1215 "The default umask is C<022>, so files are created with modes such as C<0644> "
1216 "and directories with C<0755>."
1217 msgstr ""
1218
1219 # type: textblock
1220 #. type: textblock
1221 #: ../src/guestfs.pod:513
1222 msgid ""
1223 "There are two ways to avoid being affected by umask.  Either set umask to 0 "
1224 "(call C<guestfs_umask (g, 0)> early after launching).  Or call L</"
1225 "guestfs_chmod> after creating each file or directory."
1226 msgstr ""
1227
1228 # type: textblock
1229 #. type: textblock
1230 #: ../src/guestfs.pod:517
1231 msgid "For more information about umask, see L<umask(2)>."
1232 msgstr ""
1233
1234 # type: =head1
1235 #. type: =head1
1236 #: ../src/guestfs.pod:519 ../fish/guestfish.pod:720
1237 msgid "ENCRYPTED DISKS"
1238 msgstr ""
1239
1240 # type: textblock
1241 #. type: textblock
1242 #: ../src/guestfs.pod:521
1243 msgid ""
1244 "Libguestfs allows you to access Linux guests which have been encrypted using "
1245 "whole disk encryption that conforms to the Linux Unified Key Setup (LUKS) "
1246 "standard.  This includes nearly all whole disk encryption systems used by "
1247 "modern Linux guests."
1248 msgstr ""
1249
1250 # type: textblock
1251 #. type: textblock
1252 #: ../src/guestfs.pod:527
1253 msgid ""
1254 "Use L</guestfs_vfs_type> to identify LUKS-encrypted block devices (it "
1255 "returns the string C<crypto_LUKS>)."
1256 msgstr ""
1257
1258 # type: textblock
1259 #. type: textblock
1260 #: ../src/guestfs.pod:530
1261 msgid ""
1262 "Then open these devices by calling L</guestfs_luks_open>.  Obviously you "
1263 "will require the passphrase!"
1264 msgstr ""
1265
1266 # type: textblock
1267 #. type: textblock
1268 #: ../src/guestfs.pod:533
1269 msgid ""
1270 "Opening a LUKS device creates a new device mapper device called C</dev/"
1271 "mapper/mapname> (where C<mapname> is the string you supply to L</"
1272 "guestfs_luks_open>).  Reads and writes to this mapper device are decrypted "
1273 "from and encrypted to the underlying block device respectively."
1274 msgstr ""
1275
1276 # type: textblock
1277 #. type: textblock
1278 #: ../src/guestfs.pod:539
1279 msgid ""
1280 "LVM volume groups on the device can be made visible by calling L</"
1281 "guestfs_vgscan> followed by L</guestfs_vg_activate_all>.  The logical volume"
1282 "(s) can now be mounted in the usual way."
1283 msgstr ""
1284
1285 # type: textblock
1286 #. type: textblock
1287 #: ../src/guestfs.pod:543
1288 msgid ""
1289 "Use the reverse process to close a LUKS device.  Unmount any logical volumes "
1290 "on it, deactivate the volume groups by caling C<guestfs_vg_activate (g, 0, "
1291 "[\"/dev/VG\"])>.  Then close the mapper device by calling L</"
1292 "guestfs_luks_close> on the C</dev/mapper/mapname> device (I<not> the "
1293 "underlying encrypted block device)."
1294 msgstr ""
1295
1296 # type: =head2
1297 #. type: =head2
1298 #: ../src/guestfs.pod:550
1299 msgid "INSPECTION"
1300 msgstr ""
1301
1302 # type: textblock
1303 #. type: textblock
1304 #: ../src/guestfs.pod:552
1305 msgid ""
1306 "Libguestfs has APIs for inspecting an unknown disk image to find out if it "
1307 "contains operating systems.  (These APIs used to be in a separate Perl-only "
1308 "library called L<Sys::Guestfs::Lib(3)> but since version 1.5.3 the most "
1309 "frequently used part of this library has been rewritten in C and moved into "
1310 "the core code)."
1311 msgstr ""
1312
1313 # type: textblock
1314 #. type: textblock
1315 #: ../src/guestfs.pod:558
1316 msgid ""
1317 "Add all disks belonging to the unknown virtual machine and call L</"
1318 "guestfs_launch> in the usual way."
1319 msgstr ""
1320
1321 # type: textblock
1322 #. type: textblock
1323 #: ../src/guestfs.pod:561
1324 msgid ""
1325 "Then call L</guestfs_inspect_os>.  This function uses other libguestfs calls "
1326 "and certain heuristics, and returns a list of operating systems that were "
1327 "found.  An empty list means none were found.  A single element is the root "
1328 "filesystem of the operating system.  For dual- or multi-boot guests, "
1329 "multiple roots can be returned, each one corresponding to a separate "
1330 "operating system.  (Multi-boot virtual machines are extremely rare in the "
1331 "world of virtualization, but since this scenario can happen, we have built "
1332 "libguestfs to deal with it.)"
1333 msgstr ""
1334
1335 # type: textblock
1336 #. type: textblock
1337 #: ../src/guestfs.pod:570
1338 msgid ""
1339 "For each root, you can then call various C<guestfs_inspect_get_*> functions "
1340 "to get additional details about that operating system.  For example, call L</"
1341 "guestfs_inspect_get_type> to return the string C<windows> or C<linux> for "
1342 "Windows and Linux-based operating systems respectively."
1343 msgstr ""
1344
1345 # type: textblock
1346 #. type: textblock
1347 #: ../src/guestfs.pod:576
1348 msgid ""
1349 "Un*x-like and Linux-based operating systems usually consist of several "
1350 "filesystems which are mounted at boot time (for example, a separate boot "
1351 "partition mounted on C</boot>).  The inspection rules are able to detect how "
1352 "filesystems correspond to mount points.  Call "
1353 "C<guestfs_inspect_get_mountpoints> to get this mapping.  It might return a "
1354 "hash table like this example:"
1355 msgstr ""
1356
1357 # type: verbatim
1358 #. type: verbatim
1359 #: ../src/guestfs.pod:583
1360 #, no-wrap
1361 msgid ""
1362 " /boot => /dev/sda1\n"
1363 " /     => /dev/vg_guest/lv_root\n"
1364 " /usr  => /dev/vg_guest/lv_usr\n"
1365 "\n"
1366 msgstr ""
1367
1368 # type: textblock
1369 #. type: textblock
1370 #: ../src/guestfs.pod:587
1371 msgid ""
1372 "The caller can then make calls to L</guestfs_mount_options> to mount the "
1373 "filesystems as suggested."
1374 msgstr ""
1375
1376 # type: textblock
1377 #. type: textblock
1378 #: ../src/guestfs.pod:590
1379 msgid ""
1380 "Be careful to mount filesystems in the right order (eg. C</> before C</"
1381 "usr>).  Sorting the keys of the hash by length, shortest first, should work."
1382 msgstr ""
1383
1384 # type: textblock
1385 #. type: textblock
1386 #: ../src/guestfs.pod:594
1387 msgid ""
1388 "Inspection currently only works for some common operating systems.  "
1389 "Contributors are welcome to send patches for other operating systems that we "
1390 "currently cannot detect."
1391 msgstr ""
1392
1393 # type: textblock
1394 #. type: textblock
1395 #: ../src/guestfs.pod:598
1396 msgid ""
1397 "Encrypted disks must be opened before inspection.  See L</ENCRYPTED DISKS> "
1398 "for more details.  The L</guestfs_inspect_os> function just ignores any "
1399 "encrypted devices."
1400 msgstr ""
1401
1402 # type: textblock
1403 #. type: textblock
1404 #: ../src/guestfs.pod:602
1405 msgid ""
1406 "A note on the implementation: The call L</guestfs_inspect_os> performs "
1407 "inspection and caches the results in the guest handle.  Subsequent calls to "
1408 "C<guestfs_inspect_get_*> return this cached information, but I<do not> re-"
1409 "read the disks.  If you change the content of the guest disks, you can redo "
1410 "inspection by calling L</guestfs_inspect_os> again.  (L</"
1411 "guestfs_inspect_list_applications> works a little differently from the other "
1412 "calls and does read the disks.  See documentation for that function for "
1413 "details)."
1414 msgstr ""
1415
1416 # type: =head2
1417 #. type: =head2
1418 #: ../src/guestfs.pod:611
1419 msgid "SPECIAL CONSIDERATIONS FOR WINDOWS GUESTS"
1420 msgstr ""
1421
1422 # type: textblock
1423 #. type: textblock
1424 #: ../src/guestfs.pod:613
1425 msgid ""
1426 "Libguestfs can mount NTFS partitions.  It does this using the L<http://www."
1427 "ntfs-3g.org/> driver."
1428 msgstr ""
1429
1430 # type: =head3
1431 #. type: =head3
1432 #: ../src/guestfs.pod:616
1433 msgid "DRIVE LETTERS AND PATHS"
1434 msgstr ""
1435
1436 # type: textblock
1437 #. type: textblock
1438 #: ../src/guestfs.pod:618
1439 msgid ""
1440 "DOS and Windows still use drive letters, and the filesystems are always "
1441 "treated as case insensitive by Windows itself, and therefore you might find "
1442 "a Windows configuration file referring to a path like C<c:\\windows"
1443 "\\system32>.  When the filesystem is mounted in libguestfs, that directory "
1444 "might be referred to as C</WINDOWS/System32>."
1445 msgstr ""
1446
1447 # type: textblock
1448 #. type: textblock
1449 #: ../src/guestfs.pod:624
1450 msgid ""
1451 "Drive letter mappings are outside the scope of libguestfs.  You have to use "
1452 "libguestfs to read the appropriate Windows Registry and configuration files, "
1453 "to determine yourself how drives are mapped (see also L<hivex(3)> and L<virt-"
1454 "inspector(1)>)."
1455 msgstr ""
1456
1457 # type: textblock
1458 #. type: textblock
1459 #: ../src/guestfs.pod:629
1460 msgid ""
1461 "Replacing backslash characters with forward slash characters is also outside "
1462 "the scope of libguestfs, but something that you can easily do."
1463 msgstr ""
1464
1465 # type: textblock
1466 #. type: textblock
1467 #: ../src/guestfs.pod:632
1468 msgid ""
1469 "Where we can help is in resolving the case insensitivity of paths.  For "
1470 "this, call L</guestfs_case_sensitive_path>."
1471 msgstr ""
1472
1473 # type: =head3
1474 #. type: =head3
1475 #: ../src/guestfs.pod:635
1476 msgid "ACCESSING THE WINDOWS REGISTRY"
1477 msgstr ""
1478
1479 # type: textblock
1480 #. type: textblock
1481 #: ../src/guestfs.pod:637
1482 msgid ""
1483 "Libguestfs also provides some help for decoding Windows Registry \"hive\" "
1484 "files, through the library C<hivex> which is part of the libguestfs project "
1485 "although ships as a separate tarball.  You have to locate and download the "
1486 "hive file(s) yourself, and then pass them to C<hivex> functions.  See also "
1487 "the programs L<hivexml(1)>, L<hivexsh(1)>, L<hivexregedit(1)> and L<virt-win-"
1488 "reg(1)> for more help on this issue."
1489 msgstr ""
1490
1491 # type: =head3
1492 #. type: =head3
1493 #: ../src/guestfs.pod:645
1494 msgid "SYMLINKS ON NTFS-3G FILESYSTEMS"
1495 msgstr ""
1496
1497 # type: textblock
1498 #. type: textblock
1499 #: ../src/guestfs.pod:647
1500 msgid ""
1501 "Ntfs-3g tries to rewrite \"Junction Points\" and NTFS \"symbolic links\" to "
1502 "provide something which looks like a Linux symlink.  The way it tries to do "
1503 "the rewriting is described here:"
1504 msgstr ""
1505
1506 # type: textblock
1507 #. type: textblock
1508 #: ../src/guestfs.pod:651
1509 msgid ""
1510 "L<http://www.tuxera.com/community/ntfs-3g-advanced/junction-points-and-"
1511 "symbolic-links/>"
1512 msgstr ""
1513
1514 # type: textblock
1515 #. type: textblock
1516 #: ../src/guestfs.pod:653
1517 msgid ""
1518 "The essential problem is that ntfs-3g simply does not have enough "
1519 "information to do a correct job.  NTFS links can contain drive letters and "
1520 "references to external device GUIDs that ntfs-3g has no way of resolving.  "
1521 "It is almost certainly the case that libguestfs callers should ignore what "
1522 "ntfs-3g does (ie. don't use L</guestfs_readlink> on NTFS volumes)."
1523 msgstr ""
1524
1525 # type: textblock
1526 #. type: textblock
1527 #: ../src/guestfs.pod:660
1528 msgid ""
1529 "Instead if you encounter a symbolic link on an ntfs-3g filesystem, use L</"
1530 "guestfs_lgetxattr> to read the C<system.ntfs_reparse_data> extended "
1531 "attribute, and read the raw reparse data from that (you can find the format "
1532 "documented in various places around the web)."
1533 msgstr ""
1534
1535 # type: =head3
1536 #. type: =head3
1537 #: ../src/guestfs.pod:665
1538 msgid "EXTENDED ATTRIBUTES ON NTFS-3G FILESYSTEMS"
1539 msgstr ""
1540
1541 # type: textblock
1542 #. type: textblock
1543 #: ../src/guestfs.pod:667
1544 msgid ""
1545 "There are other useful extended attributes that can be read from ntfs-3g "
1546 "filesystems (using L</guestfs_getxattr>).  See:"
1547 msgstr ""
1548
1549 # type: textblock
1550 #. type: textblock
1551 #: ../src/guestfs.pod:670
1552 msgid ""
1553 "L<http://www.tuxera.com/community/ntfs-3g-advanced/extended-attributes/>"
1554 msgstr ""
1555
1556 # type: =head2
1557 #. type: =head2
1558 #: ../src/guestfs.pod:672
1559 msgid "USING LIBGUESTFS WITH OTHER PROGRAMMING LANGUAGES"
1560 msgstr ""
1561
1562 # type: textblock
1563 #. type: textblock
1564 #: ../src/guestfs.pod:674
1565 msgid ""
1566 "Although we don't want to discourage you from using the C API, we will "
1567 "mention here that the same API is also available in other languages."
1568 msgstr ""
1569
1570 #. type: textblock
1571 #: ../src/guestfs.pod:677
1572 msgid ""
1573 "The API is broadly identical in all supported languages.  This means that "
1574 "the C call C<guestfs_add_drive_ro(g,file)> is C<$g-E<gt>add_drive_ro($file)> "
1575 "in Perl, C<g.add_drive_ro(file)> in Python, and C<g#add_drive_ro file> in "
1576 "OCaml.  In other words, a straightforward, predictable isomorphism between "
1577 "each language."
1578 msgstr ""
1579
1580 # type: textblock
1581 #. type: textblock
1582 #: ../src/guestfs.pod:683
1583 msgid ""
1584 "Error messages are automatically transformed into exceptions if the language "
1585 "supports it."
1586 msgstr ""
1587
1588 # type: textblock
1589 #. type: textblock
1590 #: ../src/guestfs.pod:686
1591 msgid ""
1592 "We don't try to \"object orientify\" parts of the API in OO languages, "
1593 "although contributors are welcome to write higher level APIs above what we "
1594 "provide in their favourite languages if they wish."
1595 msgstr ""
1596
1597 # type: =item
1598 #. type: =item
1599 #: ../src/guestfs.pod:692
1600 msgid "B<C++>"
1601 msgstr ""
1602
1603 # type: textblock
1604 #. type: textblock
1605 #: ../src/guestfs.pod:694
1606 msgid ""
1607 "You can use the I<guestfs.h> header file from C++ programs.  The C++ API is "
1608 "identical to the C API.  C++ classes and exceptions are not used."
1609 msgstr ""
1610
1611 # type: =item
1612 #. type: =item
1613 #: ../src/guestfs.pod:698
1614 msgid "B<C#>"
1615 msgstr ""
1616
1617 # type: textblock
1618 #. type: textblock
1619 #: ../src/guestfs.pod:700
1620 msgid ""
1621 "The C# bindings are highly experimental.  Please read the warnings at the "
1622 "top of C<csharp/Libguestfs.cs>."
1623 msgstr ""
1624
1625 # type: =item
1626 #. type: =item
1627 #: ../src/guestfs.pod:703
1628 msgid "B<Haskell>"
1629 msgstr ""
1630
1631 # type: textblock
1632 #. type: textblock
1633 #: ../src/guestfs.pod:705
1634 msgid ""
1635 "This is the only language binding that is working but incomplete.  Only "
1636 "calls which return simple integers have been bound in Haskell, and we are "
1637 "looking for help to complete this binding."
1638 msgstr ""
1639
1640 # type: =item
1641 #. type: =item
1642 #: ../src/guestfs.pod:709
1643 msgid "B<Java>"
1644 msgstr ""
1645
1646 # type: textblock
1647 #. type: textblock
1648 #: ../src/guestfs.pod:711
1649 msgid ""
1650 "Full documentation is contained in the Javadoc which is distributed with "
1651 "libguestfs."
1652 msgstr ""
1653
1654 # type: =item
1655 #. type: =item
1656 #: ../src/guestfs.pod:714
1657 msgid "B<OCaml>"
1658 msgstr ""
1659
1660 #. type: textblock
1661 #: ../src/guestfs.pod:716
1662 msgid "See L<guestfs-ocaml(3)>."
1663 msgstr ""
1664
1665 # type: =item
1666 #. type: =item
1667 #: ../src/guestfs.pod:718
1668 msgid "B<Perl>"
1669 msgstr ""
1670
1671 #. type: textblock
1672 #: ../src/guestfs.pod:720
1673 msgid "See L<Sys::Guestfs(3)>."
1674 msgstr ""
1675
1676 # type: =item
1677 #. type: =item
1678 #: ../src/guestfs.pod:722
1679 msgid "B<PHP>"
1680 msgstr ""
1681
1682 # type: textblock
1683 #. type: textblock
1684 #: ../src/guestfs.pod:724
1685 msgid ""
1686 "For documentation see C<README-PHP> supplied with libguestfs sources or in "
1687 "the php-libguestfs package for your distribution."
1688 msgstr ""
1689
1690 # type: textblock
1691 #. type: textblock
1692 #: ../src/guestfs.pod:727
1693 msgid "The PHP binding only works correctly on 64 bit machines."
1694 msgstr ""
1695
1696 # type: =item
1697 #. type: =item
1698 #: ../src/guestfs.pod:729
1699 msgid "B<Python>"
1700 msgstr ""
1701
1702 #. type: textblock
1703 #: ../src/guestfs.pod:731
1704 msgid "See L<guestfs-python(3)>."
1705 msgstr ""
1706
1707 # type: =item
1708 #. type: =item
1709 #: ../src/guestfs.pod:733
1710 msgid "B<Ruby>"
1711 msgstr ""
1712
1713 #. type: textblock
1714 #: ../src/guestfs.pod:735
1715 msgid "See L<guestfs-ruby(3)>."
1716 msgstr ""
1717
1718 # type: =item
1719 #. type: =item
1720 #: ../src/guestfs.pod:737
1721 msgid "B<shell scripts>"
1722 msgstr ""
1723
1724 #. type: textblock
1725 #: ../src/guestfs.pod:739
1726 msgid "See L<guestfish(1)>."
1727 msgstr ""
1728
1729 # type: =head2
1730 #. type: =head2
1731 #: ../src/guestfs.pod:743
1732 msgid "LIBGUESTFS GOTCHAS"
1733 msgstr ""
1734
1735 # type: textblock
1736 #. type: textblock
1737 #: ../src/guestfs.pod:745
1738 msgid ""
1739 "L<http://en.wikipedia.org/wiki/Gotcha_(programming)>: \"A feature of a "
1740 "system [...] that works in the way it is documented but is counterintuitive "
1741 "and almost invites mistakes.\""
1742 msgstr ""
1743
1744 # type: textblock
1745 #. type: textblock
1746 #: ../src/guestfs.pod:749
1747 msgid ""
1748 "Since we developed libguestfs and the associated tools, there are several "
1749 "things we would have designed differently, but are now stuck with for "
1750 "backwards compatibility or other reasons.  If there is ever a libguestfs 2.0 "
1751 "release, you can expect these to change.  Beware of them."
1752 msgstr ""
1753
1754 # type: =item
1755 #. type: =item
1756 #: ../src/guestfs.pod:757
1757 msgid "Autosync / forgetting to sync."
1758 msgstr ""
1759
1760 # type: textblock
1761 #. type: textblock
1762 #: ../src/guestfs.pod:759
1763 msgid ""
1764 "When modifying a filesystem from C or another language, you B<must> unmount "
1765 "all filesystems and call L</guestfs_sync> explicitly before you close the "
1766 "libguestfs handle.  You can also call:"
1767 msgstr ""
1768
1769 # type: verbatim
1770 #. type: verbatim
1771 #: ../src/guestfs.pod:763
1772 #, no-wrap
1773 msgid ""
1774 " guestfs_set_autosync (g, 1);\n"
1775 "\n"
1776 msgstr ""
1777
1778 # type: textblock
1779 #. type: textblock
1780 #: ../src/guestfs.pod:765
1781 msgid ""
1782 "to have the unmount/sync done automatically for you when the handle 'g' is "
1783 "closed.  (This feature is called \"autosync\", L</guestfs_set_autosync> q.v.)"
1784 msgstr ""
1785
1786 # type: textblock
1787 #. type: textblock
1788 #: ../src/guestfs.pod:769
1789 msgid ""
1790 "If you forget to do this, then it is entirely possible that your changes "
1791 "won't be written out, or will be partially written, or (very rarely) that "
1792 "you'll get disk corruption."
1793 msgstr ""
1794
1795 # type: textblock
1796 #. type: textblock
1797 #: ../src/guestfs.pod:773
1798 msgid ""
1799 "Note that in L<guestfish(3)> autosync is the default.  So quick and dirty "
1800 "guestfish scripts that forget to sync will work just fine, which can make "
1801 "this very puzzling if you are trying to debug a problem."
1802 msgstr ""
1803
1804 # type: textblock
1805 #. type: textblock
1806 #: ../src/guestfs.pod:777
1807 msgid ""
1808 "Update: Autosync is enabled by default for all API users starting from "
1809 "libguestfs 1.5.24."
1810 msgstr ""
1811
1812 # type: =item
1813 #. type: =item
1814 #: ../src/guestfs.pod:780
1815 msgid "Mount option C<-o sync> should not be the default."
1816 msgstr ""
1817
1818 # type: textblock
1819 #. type: textblock
1820 #: ../src/guestfs.pod:782
1821 msgid ""
1822 "If you use L</guestfs_mount>, then C<-o sync,noatime> are added implicitly.  "
1823 "However C<-o sync> does not add any reliability benefit, but does have a "
1824 "very large performance impact."
1825 msgstr ""
1826
1827 # type: textblock
1828 #. type: textblock
1829 #: ../src/guestfs.pod:786
1830 msgid ""
1831 "The work around is to use L</guestfs_mount_options> and set the mount "
1832 "options that you actually want to use."
1833 msgstr ""
1834
1835 # type: =item
1836 #. type: =item
1837 #: ../src/guestfs.pod:789
1838 msgid "Read-only should be the default."
1839 msgstr ""
1840
1841 # type: textblock
1842 #. type: textblock
1843 #: ../src/guestfs.pod:791
1844 msgid ""
1845 "In L<guestfish(3)>, I<--ro> should be the default, and you should have to "
1846 "specify I<--rw> if you want to make changes to the image."
1847 msgstr ""
1848
1849 # type: textblock
1850 #. type: textblock
1851 #: ../src/guestfs.pod:794
1852 msgid "This would reduce the potential to corrupt live VM images."
1853 msgstr ""
1854
1855 # type: textblock
1856 #. type: textblock
1857 #: ../src/guestfs.pod:796
1858 msgid ""
1859 "Note that many filesystems change the disk when you just mount and unmount, "
1860 "even if you didn't perform any writes.  You need to use L</"
1861 "guestfs_add_drive_ro> to guarantee that the disk is not changed."
1862 msgstr ""
1863
1864 # type: =item
1865 #. type: =item
1866 #: ../src/guestfs.pod:800
1867 msgid "guestfish command line is hard to use."
1868 msgstr ""
1869
1870 # type: textblock
1871 #. type: textblock
1872 #: ../src/guestfs.pod:802
1873 msgid ""
1874 "C<guestfish disk.img> doesn't do what people expect (open C<disk.img> for "
1875 "examination).  It tries to run a guestfish command C<disk.img> which doesn't "
1876 "exist, so it fails.  In earlier versions of guestfish the error message was "
1877 "also unintuitive, but we have corrected this since.  Like the Bourne shell, "
1878 "we should have used C<guestfish -c command> to run commands."
1879 msgstr ""
1880
1881 # type: =item
1882 #. type: =item
1883 #: ../src/guestfs.pod:809
1884 msgid "guestfish megabyte modifiers don't work right on all commands"
1885 msgstr ""
1886
1887 # type: textblock
1888 #. type: textblock
1889 #: ../src/guestfs.pod:811
1890 msgid ""
1891 "In recent guestfish you can use C<1M> to mean 1 megabyte (and similarly for "
1892 "other modifiers).  What guestfish actually does is to multiply the number "
1893 "part by the modifier part and pass the result to the C API.  However this "
1894 "doesn't work for a few APIs which aren't expecting bytes, but are already "
1895 "expecting some other unit (eg. megabytes)."
1896 msgstr ""
1897
1898 # type: textblock
1899 #. type: textblock
1900 #: ../src/guestfs.pod:818
1901 msgid "The most common is L</guestfs_lvcreate>.  The guestfish command:"
1902 msgstr ""
1903
1904 # type: verbatim
1905 #. type: verbatim
1906 #: ../src/guestfs.pod:820
1907 #, no-wrap
1908 msgid ""
1909 " lvcreate LV VG 100M\n"
1910 "\n"
1911 msgstr ""
1912
1913 # type: textblock
1914 #. type: textblock
1915 #: ../src/guestfs.pod:822
1916 msgid ""
1917 "does not do what you might expect.  Instead because L</guestfs_lvcreate> is "
1918 "already expecting megabytes, this tries to create a 100 I<terabyte> (100 "
1919 "megabytes * megabytes) logical volume.  The error message you get from this "
1920 "is also a little obscure."
1921 msgstr ""
1922
1923 # type: textblock
1924 #. type: textblock
1925 #: ../src/guestfs.pod:827
1926 msgid ""
1927 "This could be fixed in the generator by specially marking parameters and "
1928 "return values which take bytes or other units."
1929 msgstr ""
1930
1931 # type: =item
1932 #. type: =item
1933 #: ../src/guestfs.pod:830
1934 msgid "Ambiguity between devices and paths"
1935 msgstr ""
1936
1937 # type: textblock
1938 #. type: textblock
1939 #: ../src/guestfs.pod:832
1940 msgid ""
1941 "There is a subtle ambiguity in the API between a device name (eg. C</dev/"
1942 "sdb2>) and a similar pathname.  A file might just happen to be called "
1943 "C<sdb2> in the directory C</dev> (consider some non-Unix VM image)."
1944 msgstr ""
1945
1946 # type: textblock
1947 #. type: textblock
1948 #: ../src/guestfs.pod:837
1949 msgid ""
1950 "In the current API we usually resolve this ambiguity by having two separate "
1951 "calls, for example L</guestfs_checksum> and L</guestfs_checksum_device>.  "
1952 "Some API calls are ambiguous and (incorrectly) resolve the problem by "
1953 "detecting if the path supplied begins with C</dev/>."
1954 msgstr ""
1955
1956 # type: textblock
1957 #. type: textblock
1958 #: ../src/guestfs.pod:843
1959 msgid ""
1960 "To avoid both the ambiguity and the need to duplicate some calls, we could "
1961 "make paths/devices into structured names.  One way to do this would be to "
1962 "use a notation like grub (C<hd(0,0)>), although nobody really likes this "
1963 "aspect of grub.  Another way would be to use a structured type, equivalent "
1964 "to this OCaml type:"
1965 msgstr ""
1966
1967 # type: verbatim
1968 #. type: verbatim
1969 #: ../src/guestfs.pod:849
1970 #, no-wrap
1971 msgid ""
1972 " type path = Path of string | Device of int | Partition of int * int\n"
1973 "\n"
1974 msgstr ""
1975
1976 # type: textblock
1977 #. type: textblock
1978 #: ../src/guestfs.pod:851
1979 msgid "which would allow you to pass arguments like:"
1980 msgstr ""
1981
1982 # type: verbatim
1983 #. type: verbatim
1984 #: ../src/guestfs.pod:853
1985 #, no-wrap
1986 msgid ""
1987 " Path \"/foo/bar\"\n"
1988 " Device 1            (* /dev/sdb, or perhaps /dev/sda *)\n"
1989 " Partition (1, 2)    (* /dev/sdb2 (or is it /dev/sda2 or /dev/sdb3?) *)\n"
1990 " Path \"/dev/sdb2\"    (* not a device *)\n"
1991 "\n"
1992 msgstr ""
1993
1994 # type: textblock
1995 #. type: textblock
1996 #: ../src/guestfs.pod:858
1997 msgid ""
1998 "As you can see there are still problems to resolve even with this "
1999 "representation.  Also consider how it might work in guestfish."
2000 msgstr ""
2001
2002 # type: =head2
2003 #. type: =head2
2004 #: ../src/guestfs.pod:863
2005 msgid "PROTOCOL LIMITS"
2006 msgstr ""
2007
2008 # type: textblock
2009 #. type: textblock
2010 #: ../src/guestfs.pod:865
2011 msgid ""
2012 "Internally libguestfs uses a message-based protocol to pass API calls and "
2013 "their responses to and from a small \"appliance\" (see L</INTERNALS> for "
2014 "plenty more detail about this).  The maximum message size used by the "
2015 "protocol is slightly less than 4 MB.  For some API calls you may need to be "
2016 "aware of this limit.  The API calls which may be affected are individually "
2017 "documented, with a link back to this section of the documentation."
2018 msgstr ""
2019
2020 # type: textblock
2021 #. type: textblock
2022 #: ../src/guestfs.pod:873
2023 msgid ""
2024 "A simple call such as L</guestfs_cat> returns its result (the file data) in "
2025 "a simple string.  Because this string is at some point internally encoded as "
2026 "a message, the maximum size that it can return is slightly under 4 MB.  If "
2027 "the requested file is larger than this then you will get an error."
2028 msgstr ""
2029
2030 # type: textblock
2031 #. type: textblock
2032 #: ../src/guestfs.pod:879
2033 msgid ""
2034 "In order to transfer large files into and out of the guest filesystem, you "
2035 "need to use particular calls that support this.  The sections L</UPLOADING> "
2036 "and L</DOWNLOADING> document how to do this."
2037 msgstr ""
2038
2039 # type: textblock
2040 #. type: textblock
2041 #: ../src/guestfs.pod:883
2042 msgid ""
2043 "You might also consider mounting the disk image using our FUSE filesystem "
2044 "support (L<guestmount(1)>)."
2045 msgstr ""
2046
2047 # type: =head2
2048 #. type: =head2
2049 #: ../src/guestfs.pod:886
2050 msgid "KEYS AND PASSPHRASES"
2051 msgstr ""
2052
2053 # type: textblock
2054 #. type: textblock
2055 #: ../src/guestfs.pod:888
2056 msgid ""
2057 "Certain libguestfs calls take a parameter that contains sensitive key "
2058 "material, passed in as a C string."
2059 msgstr ""
2060
2061 # type: textblock
2062 #. type: textblock
2063 #: ../src/guestfs.pod:891
2064 msgid ""
2065 "In the future we would hope to change the libguestfs implementation so that "
2066 "keys are L<mlock(2)>-ed into physical RAM, and thus can never end up in "
2067 "swap.  However this is I<not> done at the moment, because of the complexity "
2068 "of such an implementation."
2069 msgstr ""
2070
2071 # type: textblock
2072 #. type: textblock
2073 #: ../src/guestfs.pod:896
2074 msgid ""
2075 "Therefore you should be aware that any key parameter you pass to libguestfs "
2076 "might end up being written out to the swap partition.  If this is a concern, "
2077 "scrub the swap partition or don't use libguestfs on encrypted devices."
2078 msgstr ""
2079
2080 # type: =head1
2081 #. type: =head2
2082 #: ../src/guestfs.pod:901
2083 msgid "MULTIPLE HANDLES AND MULTIPLE THREADS"
2084 msgstr ""
2085
2086 # type: textblock
2087 #. type: textblock
2088 #: ../src/guestfs.pod:903
2089 msgid ""
2090 "All high-level libguestfs actions are synchronous.  If you want to use "
2091 "libguestfs asynchronously then you must create a thread."
2092 msgstr ""
2093
2094 # type: textblock
2095 #. type: textblock
2096 #: ../src/guestfs.pod:906
2097 msgid ""
2098 "Only use the handle from a single thread.  Either use the handle exclusively "
2099 "from one thread, or provide your own mutex so that two threads cannot issue "
2100 "calls on the same handle at the same time."
2101 msgstr ""
2102
2103 # type: textblock
2104 #. type: textblock
2105 #: ../src/guestfs.pod:910
2106 msgid ""
2107 "See the graphical program guestfs-browser for one possible architecture for "
2108 "multithreaded programs using libvirt and libguestfs."
2109 msgstr ""
2110
2111 # type: =head1
2112 #. type: =head2
2113 #: ../src/guestfs.pod:913
2114 msgid "PATH"
2115 msgstr ""
2116
2117 #. type: textblock
2118 #: ../src/guestfs.pod:915
2119 msgid ""
2120 "Libguestfs needs a supermin appliance, which it finds by looking along an "
2121 "internal path."
2122 msgstr ""
2123
2124 # type: textblock
2125 #. type: textblock
2126 #: ../src/guestfs.pod:918
2127 msgid ""
2128 "By default it looks for these in the directory C<$libdir/guestfs> (eg. C</"
2129 "usr/local/lib/guestfs> or C</usr/lib64/guestfs>)."
2130 msgstr ""
2131
2132 # type: textblock
2133 #. type: textblock
2134 #: ../src/guestfs.pod:921
2135 msgid ""
2136 "Use L</guestfs_set_path> or set the environment variable L</LIBGUESTFS_PATH> "
2137 "to change the directories that libguestfs will search in.  The value is a "
2138 "colon-separated list of paths.  The current directory is I<not> searched "
2139 "unless the path contains an empty element or C<.>.  For example "
2140 "C<LIBGUESTFS_PATH=:/usr/lib/guestfs> would search the current directory and "
2141 "then C</usr/lib/guestfs>."
2142 msgstr ""
2143
2144 # type: =head1
2145 #. type: =head2
2146 #: ../src/guestfs.pod:928
2147 msgid "QEMU WRAPPERS"
2148 msgstr ""
2149
2150 # type: textblock
2151 #. type: textblock
2152 #: ../src/guestfs.pod:930
2153 msgid ""
2154 "If you want to compile your own qemu, run qemu from a non-standard location, "
2155 "or pass extra arguments to qemu, then you can write a shell-script wrapper "
2156 "around qemu."
2157 msgstr ""
2158
2159 # type: textblock
2160 #. type: textblock
2161 #: ../src/guestfs.pod:934
2162 msgid ""
2163 "There is one important rule to remember: you I<must C<exec qemu>> as the "
2164 "last command in the shell script (so that qemu replaces the shell and "
2165 "becomes the direct child of the libguestfs-using program).  If you don't do "
2166 "this, then the qemu process won't be cleaned up correctly."
2167 msgstr ""
2168
2169 # type: textblock
2170 #. type: textblock
2171 #: ../src/guestfs.pod:939
2172 msgid ""
2173 "Here is an example of a wrapper, where I have built my own copy of qemu from "
2174 "source:"
2175 msgstr ""
2176
2177 # type: verbatim
2178 #. type: verbatim
2179 #: ../src/guestfs.pod:942
2180 #, no-wrap
2181 msgid ""
2182 " #!/bin/sh -\n"
2183 " qemudir=/home/rjones/d/qemu\n"
2184 " exec $qemudir/x86_64-softmmu/qemu-system-x86_64 -L $qemudir/pc-bios \"$@\"\n"
2185 "\n"
2186 msgstr ""
2187
2188 # type: textblock
2189 #. type: textblock
2190 #: ../src/guestfs.pod:946
2191 msgid ""
2192 "Save this script as C</tmp/qemu.wrapper> (or wherever), C<chmod +x>, and "
2193 "then use it by setting the LIBGUESTFS_QEMU environment variable.  For "
2194 "example:"
2195 msgstr ""
2196
2197 # type: verbatim
2198 #. type: verbatim
2199 #: ../src/guestfs.pod:950
2200 #, no-wrap
2201 msgid ""
2202 " LIBGUESTFS_QEMU=/tmp/qemu.wrapper guestfish\n"
2203 "\n"
2204 msgstr ""
2205
2206 # type: textblock
2207 #. type: textblock
2208 #: ../src/guestfs.pod:952
2209 msgid ""
2210 "Note that libguestfs also calls qemu with the -help and -version options in "
2211 "order to determine features."
2212 msgstr ""
2213
2214 # type: =head2
2215 #. type: =head2
2216 #: ../src/guestfs.pod:955
2217 msgid "ABI GUARANTEE"
2218 msgstr ""
2219
2220 # type: textblock
2221 #. type: textblock
2222 #: ../src/guestfs.pod:957
2223 msgid ""
2224 "We guarantee the libguestfs ABI (binary interface), for public, high-level "
2225 "actions as outlined in this section.  Although we will deprecate some "
2226 "actions, for example if they get replaced by newer calls, we will keep the "
2227 "old actions forever.  This allows you the developer to program in confidence "
2228 "against the libguestfs API."
2229 msgstr ""
2230
2231 # type: =head1
2232 #. type: =head2
2233 #: ../src/guestfs.pod:963
2234 msgid "BLOCK DEVICE NAMING"
2235 msgstr ""
2236
2237 # type: textblock
2238 #. type: textblock
2239 #: ../src/guestfs.pod:965
2240 msgid ""
2241 "In the kernel there is now quite a profusion of schemata for naming block "
2242 "devices (in this context, by I<block device> I mean a physical or virtual "
2243 "hard drive).  The original Linux IDE driver used names starting with C</dev/"
2244 "hd*>.  SCSI devices have historically used a different naming scheme, C</dev/"
2245 "sd*>.  When the Linux kernel I<libata> driver became a popular replacement "
2246 "for the old IDE driver (particularly for SATA devices) those devices also "
2247 "used the C</dev/sd*> scheme.  Additionally we now have virtual machines with "
2248 "paravirtualized drivers.  This has created several different naming systems, "
2249 "such as C</dev/vd*> for virtio disks and C</dev/xvd*> for Xen PV disks."
2250 msgstr ""
2251
2252 # type: textblock
2253 #. type: textblock
2254 #: ../src/guestfs.pod:977
2255 msgid ""
2256 "As discussed above, libguestfs uses a qemu appliance running an embedded "
2257 "Linux kernel to access block devices.  We can run a variety of appliances "
2258 "based on a variety of Linux kernels."
2259 msgstr ""
2260
2261 # type: textblock
2262 #. type: textblock
2263 #: ../src/guestfs.pod:981
2264 msgid ""
2265 "This causes a problem for libguestfs because many API calls use device or "
2266 "partition names.  Working scripts and the recipe (example) scripts that we "
2267 "make available over the internet could fail if the naming scheme changes."
2268 msgstr ""
2269
2270 # type: textblock
2271 #. type: textblock
2272 #: ../src/guestfs.pod:986
2273 msgid ""
2274 "Therefore libguestfs defines C</dev/sd*> as the I<standard naming scheme>.  "
2275 "Internally C</dev/sd*> names are translated, if necessary, to other names as "
2276 "required.  For example, under RHEL 5 which uses the C</dev/hd*> scheme, any "
2277 "device parameter C</dev/sda2> is translated to C</dev/hda2> transparently."
2278 msgstr ""
2279
2280 # type: textblock
2281 #. type: textblock
2282 #: ../src/guestfs.pod:992
2283 msgid ""
2284 "Note that this I<only> applies to parameters.  The L</guestfs_list_devices>, "
2285 "L</guestfs_list_partitions> and similar calls return the true names of the "
2286 "devices and partitions as known to the appliance."
2287 msgstr ""
2288
2289 # type: =head2
2290 #. type: =head3
2291 #: ../src/guestfs.pod:997
2292 msgid "ALGORITHM FOR BLOCK DEVICE NAME TRANSLATION"
2293 msgstr ""
2294
2295 # type: textblock
2296 #. type: textblock
2297 #: ../src/guestfs.pod:999
2298 msgid ""
2299 "Usually this translation is transparent.  However in some (very rare)  cases "
2300 "you may need to know the exact algorithm.  Such cases include where you use "
2301 "L</guestfs_config> to add a mixture of virtio and IDE devices to the qemu-"
2302 "based appliance, so have a mixture of C</dev/sd*> and C</dev/vd*> devices."
2303 msgstr ""
2304
2305 # type: textblock
2306 #. type: textblock
2307 #: ../src/guestfs.pod:1005
2308 msgid ""
2309 "The algorithm is applied only to I<parameters> which are known to be either "
2310 "device or partition names.  Return values from functions such as L</"
2311 "guestfs_list_devices> are never changed."
2312 msgstr ""
2313
2314 # type: textblock
2315 #. type: textblock
2316 #: ../src/guestfs.pod:1013
2317 msgid "Is the string a parameter which is a device or partition name?"
2318 msgstr ""
2319
2320 # type: textblock
2321 #. type: textblock
2322 #: ../src/guestfs.pod:1017
2323 msgid "Does the string begin with C</dev/sd>?"
2324 msgstr ""
2325
2326 # type: textblock
2327 #. type: textblock
2328 #: ../src/guestfs.pod:1021
2329 msgid ""
2330 "Does the named device exist? If so, we use that device.  However if I<not> "
2331 "then we continue with this algorithm."
2332 msgstr ""
2333
2334 # type: textblock
2335 #. type: textblock
2336 #: ../src/guestfs.pod:1026
2337 msgid "Replace initial C</dev/sd> string with C</dev/hd>."
2338 msgstr ""
2339
2340 # type: textblock
2341 #. type: textblock
2342 #: ../src/guestfs.pod:1028
2343 msgid "For example, change C</dev/sda2> to C</dev/hda2>."
2344 msgstr ""
2345
2346 # type: textblock
2347 #. type: textblock
2348 #: ../src/guestfs.pod:1030
2349 msgid "If that named device exists, use it.  If not, continue."
2350 msgstr ""
2351
2352 # type: textblock
2353 #. type: textblock
2354 #: ../src/guestfs.pod:1034
2355 msgid "Replace initial C</dev/sd> string with C</dev/vd>."
2356 msgstr ""
2357
2358 # type: textblock
2359 #. type: textblock
2360 #: ../src/guestfs.pod:1036
2361 msgid "If that named device exists, use it.  If not, return an error."
2362 msgstr ""
2363
2364 # type: =head3
2365 #. type: =head3
2366 #: ../src/guestfs.pod:1040
2367 msgid "PORTABILITY CONCERNS WITH BLOCK DEVICE NAMING"
2368 msgstr ""
2369
2370 # type: textblock
2371 #. type: textblock
2372 #: ../src/guestfs.pod:1042
2373 msgid ""
2374 "Although the standard naming scheme and automatic translation is useful for "
2375 "simple programs and guestfish scripts, for larger programs it is best not to "
2376 "rely on this mechanism."
2377 msgstr ""
2378
2379 # type: textblock
2380 #. type: textblock
2381 #: ../src/guestfs.pod:1046
2382 msgid ""
2383 "Where possible for maximum future portability programs using libguestfs "
2384 "should use these future-proof techniques:"
2385 msgstr ""
2386
2387 # type: textblock
2388 #. type: textblock
2389 #: ../src/guestfs.pod:1053
2390 msgid ""
2391 "Use L</guestfs_list_devices> or L</guestfs_list_partitions> to list actual "
2392 "device names, and then use those names directly."
2393 msgstr ""
2394
2395 # type: textblock
2396 #. type: textblock
2397 #: ../src/guestfs.pod:1056
2398 msgid ""
2399 "Since those device names exist by definition, they will never be translated."
2400 msgstr ""
2401
2402 # type: textblock
2403 #. type: textblock
2404 #: ../src/guestfs.pod:1061
2405 msgid ""
2406 "Use higher level ways to identify filesystems, such as LVM names, UUIDs and "
2407 "filesystem labels."
2408 msgstr ""
2409
2410 # type: =head1
2411 #. type: =head1
2412 #: ../src/guestfs.pod:1066
2413 msgid "SECURITY"
2414 msgstr ""
2415
2416 # type: textblock
2417 #. type: textblock
2418 #: ../src/guestfs.pod:1068
2419 msgid ""
2420 "This section discusses security implications of using libguestfs, "
2421 "particularly with untrusted or malicious guests or disk images."
2422 msgstr ""
2423
2424 # type: =head2
2425 #. type: =head2
2426 #: ../src/guestfs.pod:1071
2427 msgid "GENERAL SECURITY CONSIDERATIONS"
2428 msgstr ""
2429
2430 # type: textblock
2431 #. type: textblock
2432 #: ../src/guestfs.pod:1073
2433 msgid ""
2434 "Be careful with any files or data that you download from a guest (by "
2435 "\"download\" we mean not just the L</guestfs_download> command but any "
2436 "command that reads files, filenames, directories or anything else from a "
2437 "disk image).  An attacker could manipulate the data to fool your program "
2438 "into doing the wrong thing.  Consider cases such as:"
2439 msgstr ""
2440
2441 # type: textblock
2442 #. type: textblock
2443 #: ../src/guestfs.pod:1083
2444 msgid "the data (file etc) not being present"
2445 msgstr ""
2446
2447 # type: textblock
2448 #. type: textblock
2449 #: ../src/guestfs.pod:1087
2450 msgid "being present but empty"
2451 msgstr ""
2452
2453 # type: textblock
2454 #. type: textblock
2455 #: ../src/guestfs.pod:1091
2456 msgid "being much larger than normal"
2457 msgstr ""
2458
2459 # type: textblock
2460 #. type: textblock
2461 #: ../src/guestfs.pod:1095
2462 msgid "containing arbitrary 8 bit data"
2463 msgstr ""
2464
2465 # type: textblock
2466 #. type: textblock
2467 #: ../src/guestfs.pod:1099
2468 msgid "being in an unexpected character encoding"
2469 msgstr ""
2470
2471 # type: textblock
2472 #. type: textblock
2473 #: ../src/guestfs.pod:1103
2474 msgid "containing homoglyphs."
2475 msgstr ""
2476
2477 # type: =head2
2478 #. type: =head2
2479 #: ../src/guestfs.pod:1107
2480 msgid "SECURITY OF MOUNTING FILESYSTEMS"
2481 msgstr ""
2482
2483 # type: textblock
2484 #. type: textblock
2485 #: ../src/guestfs.pod:1109
2486 msgid ""
2487 "When you mount a filesystem under Linux, mistakes in the kernel filesystem "
2488 "(VFS) module can sometimes be escalated into exploits by deliberately "
2489 "creating a malicious, malformed filesystem.  These exploits are very severe "
2490 "for two reasons.  Firstly there are very many filesystem drivers in the "
2491 "kernel, and many of them are infrequently used and not much developer "
2492 "attention has been paid to the code.  Linux userspace helps potential "
2493 "crackers by detecting the filesystem type and automatically choosing the "
2494 "right VFS driver, even if that filesystem type is obscure or unexpected for "
2495 "the administrator.  Secondly, a kernel-level exploit is like a local root "
2496 "exploit (worse in some ways), giving immediate and total access to the "
2497 "system right down to the hardware level."
2498 msgstr ""
2499
2500 # type: textblock
2501 #. type: textblock
2502 #: ../src/guestfs.pod:1122
2503 msgid ""
2504 "That explains why you should never mount a filesystem from an untrusted "
2505 "guest on your host kernel.  How about libguestfs? We run a Linux kernel "
2506 "inside a qemu virtual machine, usually running as a non-root user.  The "
2507 "attacker would need to write a filesystem which first exploited the kernel, "
2508 "and then exploited either qemu virtualization (eg. a faulty qemu driver) or "
2509 "the libguestfs protocol, and finally to be as serious as the host kernel "
2510 "exploit it would need to escalate its privileges to root.  This multi-step "
2511 "escalation, performed by a static piece of data, is thought to be extremely "
2512 "hard to do, although we never say 'never' about security issues."
2513 msgstr ""
2514
2515 # type: textblock
2516 #. type: textblock
2517 #: ../src/guestfs.pod:1133
2518 msgid ""
2519 "In any case callers can reduce the attack surface by forcing the filesystem "
2520 "type when mounting (use L</guestfs_mount_vfs>)."
2521 msgstr ""
2522
2523 # type: =head2
2524 #. type: =head2
2525 #: ../src/guestfs.pod:1136
2526 msgid "PROTOCOL SECURITY"
2527 msgstr ""
2528
2529 # type: textblock
2530 #. type: textblock
2531 #: ../src/guestfs.pod:1138
2532 msgid ""
2533 "The protocol is designed to be secure, being based on RFC 4506 (XDR)  with a "
2534 "defined upper message size.  However a program that uses libguestfs must "
2535 "also take care - for example you can write a program that downloads a binary "
2536 "from a disk image and executes it locally, and no amount of protocol "
2537 "security will save you from the consequences."
2538 msgstr ""
2539
2540 # type: =head2
2541 #. type: =head2
2542 #: ../src/guestfs.pod:1144
2543 msgid "INSPECTION SECURITY"
2544 msgstr ""
2545
2546 # type: textblock
2547 #. type: textblock
2548 #: ../src/guestfs.pod:1146
2549 msgid ""
2550 "Parts of the inspection API (see L</INSPECTION>) return untrusted strings "
2551 "directly from the guest, and these could contain any 8 bit data.  Callers "
2552 "should be careful to escape these before printing them to a structured file "
2553 "(for example, use HTML escaping if creating a web page)."
2554 msgstr ""
2555
2556 # type: textblock
2557 #. type: textblock
2558 #: ../src/guestfs.pod:1152
2559 msgid ""
2560 "Guest configuration may be altered in unusual ways by the administrator of "
2561 "the virtual machine, and may not reflect reality (particularly for untrusted "
2562 "or actively malicious guests).  For example we parse the hostname from "
2563 "configuration files like C</etc/sysconfig/network> that we find in the "
2564 "guest, but the guest administrator can easily manipulate these files to "
2565 "provide the wrong hostname."
2566 msgstr ""
2567
2568 # type: textblock
2569 #. type: textblock
2570 #: ../src/guestfs.pod:1160
2571 msgid ""
2572 "The inspection API parses guest configuration using two external libraries: "
2573 "Augeas (Linux configuration) and hivex (Windows Registry).  Both are "
2574 "designed to be robust in the face of malicious data, although denial of "
2575 "service attacks are still possible, for example with oversized configuration "
2576 "files."
2577 msgstr ""
2578
2579 # type: =head2
2580 #. type: =head2
2581 #: ../src/guestfs.pod:1166
2582 msgid "RUNNING UNTRUSTED GUEST COMMANDS"
2583 msgstr ""
2584
2585 # type: textblock
2586 #. type: textblock
2587 #: ../src/guestfs.pod:1168
2588 msgid ""
2589 "Be very cautious about running commands from the guest.  By running a "
2590 "command in the guest, you are giving CPU time to a binary that you do not "
2591 "control, under the same user account as the library, albeit wrapped in qemu "
2592 "virtualization.  More information and alternatives can be found in the "
2593 "section L</RUNNING COMMANDS>."
2594 msgstr ""
2595
2596 # type: =head2
2597 #. type: =head2
2598 #: ../src/guestfs.pod:1174
2599 msgid "CVE-2010-3851"
2600 msgstr ""
2601
2602 # type: textblock
2603 #. type: textblock
2604 #: ../src/guestfs.pod:1176
2605 msgid "https://bugzilla.redhat.com/642934"
2606 msgstr ""
2607
2608 # type: textblock
2609 #. type: textblock
2610 #: ../src/guestfs.pod:1178
2611 msgid ""
2612 "This security bug concerns the automatic disk format detection that qemu "
2613 "does on disk images."
2614 msgstr ""
2615
2616 # type: textblock
2617 #. type: textblock
2618 #: ../src/guestfs.pod:1181
2619 msgid ""
2620 "A raw disk image is just the raw bytes, there is no header.  Other disk "
2621 "images like qcow2 contain a special header.  Qemu deals with this by looking "
2622 "for one of the known headers, and if none is found then assuming the disk "
2623 "image must be raw."
2624 msgstr ""
2625
2626 # type: textblock
2627 #. type: textblock
2628 #: ../src/guestfs.pod:1186
2629 msgid ""
2630 "This allows a guest which has been given a raw disk image to write some "
2631 "other header.  At next boot (or when the disk image is accessed by "
2632 "libguestfs) qemu would do autodetection and think the disk image format was, "
2633 "say, qcow2 based on the header written by the guest."
2634 msgstr ""
2635
2636 # type: textblock
2637 #. type: textblock
2638 #: ../src/guestfs.pod:1191
2639 msgid ""
2640 "This in itself would not be a problem, but qcow2 offers many features, one "
2641 "of which is to allow a disk image to refer to another image (called the "
2642 "\"backing disk\").  It does this by placing the path to the backing disk "
2643 "into the qcow2 header.  This path is not validated and could point to any "
2644 "host file (eg. \"/etc/passwd\").  The backing disk is then exposed through "
2645 "\"holes\" in the qcow2 disk image, which of course is completely under the "
2646 "control of the attacker."
2647 msgstr ""
2648
2649 # type: textblock
2650 #. type: textblock
2651 #: ../src/guestfs.pod:1199
2652 msgid ""
2653 "In libguestfs this is rather hard to exploit except under two circumstances:"
2654 msgstr ""
2655
2656 # type: textblock
2657 #. type: textblock
2658 #: ../src/guestfs.pod:1206
2659 msgid "You have enabled the network or have opened the disk in write mode."
2660 msgstr ""
2661
2662 # type: textblock
2663 #. type: textblock
2664 #: ../src/guestfs.pod:1210
2665 msgid ""
2666 "You are also running untrusted code from the guest (see L</RUNNING "
2667 "COMMANDS>)."
2668 msgstr ""
2669
2670 # type: textblock
2671 #. type: textblock
2672 #: ../src/guestfs.pod:1215
2673 msgid ""
2674 "The way to avoid this is to specify the expected disk format when adding "
2675 "disks (the optional C<format> option to L</guestfs_add_drive_opts>).  You "
2676 "should always do this if the disk is raw format, and it's a good idea for "
2677 "other cases too."
2678 msgstr ""
2679
2680 # type: textblock
2681 #. type: textblock
2682 #: ../src/guestfs.pod:1220
2683 msgid ""
2684 "For disks added from libvirt using calls like L</guestfs_add_domain>, the "
2685 "format is fetched from libvirt and passed through."
2686 msgstr ""
2687
2688 # type: textblock
2689 #. type: textblock
2690 #: ../src/guestfs.pod:1223
2691 msgid ""
2692 "For libguestfs tools, use the I<--format> command line parameter as "
2693 "appropriate."
2694 msgstr ""
2695
2696 # type: =head1
2697 #. type: =head1
2698 #: ../src/guestfs.pod:1226
2699 msgid "CONNECTION MANAGEMENT"
2700 msgstr ""
2701
2702 # type: =head2
2703 #. type: =head2
2704 #: ../src/guestfs.pod:1228
2705 msgid "guestfs_h *"
2706 msgstr ""
2707
2708 # type: textblock
2709 #. type: textblock
2710 #: ../src/guestfs.pod:1230
2711 msgid ""
2712 "C<guestfs_h> is the opaque type representing a connection handle.  Create a "
2713 "handle by calling L</guestfs_create>.  Call L</guestfs_close> to free the "
2714 "handle and release all resources used."
2715 msgstr ""
2716
2717 # type: textblock
2718 #. type: textblock
2719 #: ../src/guestfs.pod:1234
2720 msgid ""
2721 "For information on using multiple handles and threads, see the section L</"
2722 "MULTIPLE HANDLES AND MULTIPLE THREADS> below."
2723 msgstr ""
2724
2725 # type: =head2
2726 #. type: =head2
2727 #: ../src/guestfs.pod:1237
2728 msgid "guestfs_create"
2729 msgstr ""
2730
2731 # type: verbatim
2732 #. type: verbatim
2733 #: ../src/guestfs.pod:1239
2734 #, no-wrap
2735 msgid ""
2736 " guestfs_h *guestfs_create (void);\n"
2737 "\n"
2738 msgstr ""
2739
2740 # type: textblock
2741 #. type: textblock
2742 #: ../src/guestfs.pod:1241
2743 msgid "Create a connection handle."
2744 msgstr ""
2745
2746 # type: textblock
2747 #. type: textblock
2748 #: ../src/guestfs.pod:1243
2749 msgid ""
2750 "You have to call L</guestfs_add_drive_opts> (or one of the equivalent calls) "
2751 "on the handle at least once."
2752 msgstr ""
2753
2754 # type: textblock
2755 #. type: textblock
2756 #: ../src/guestfs.pod:1246
2757 msgid ""
2758 "This function returns a non-NULL pointer to a handle on success or NULL on "
2759 "error."
2760 msgstr ""
2761
2762 # type: textblock
2763 #. type: textblock
2764 #: ../src/guestfs.pod:1249
2765 msgid "After configuring the handle, you have to call L</guestfs_launch>."
2766 msgstr ""
2767
2768 # type: textblock
2769 #. type: textblock
2770 #: ../src/guestfs.pod:1251
2771 msgid ""
2772 "You may also want to configure error handling for the handle.  See L</ERROR "
2773 "HANDLING> section below."
2774 msgstr ""
2775
2776 # type: =head2
2777 #. type: =head2
2778 #: ../src/guestfs.pod:1254
2779 msgid "guestfs_close"
2780 msgstr ""
2781
2782 # type: verbatim
2783 #. type: verbatim
2784 #: ../src/guestfs.pod:1256
2785 #, no-wrap
2786 msgid ""
2787 " void guestfs_close (guestfs_h *g);\n"
2788 "\n"
2789 msgstr ""
2790
2791 # type: textblock
2792 #. type: textblock
2793 #: ../src/guestfs.pod:1258
2794 msgid "This closes the connection handle and frees up all resources used."
2795 msgstr ""
2796
2797 # type: =head1
2798 #. type: =head1
2799 #: ../src/guestfs.pod:1260
2800 msgid "ERROR HANDLING"
2801 msgstr ""
2802
2803 # type: textblock
2804 #. type: textblock
2805 #: ../src/guestfs.pod:1262
2806 msgid ""
2807 "API functions can return errors.  For example, almost all functions that "
2808 "return C<int> will return C<-1> to indicate an error."
2809 msgstr ""
2810
2811 # type: textblock
2812 #. type: textblock
2813 #: ../src/guestfs.pod:1265
2814 msgid ""
2815 "Additional information is available for errors: an error message string and "
2816 "optionally an error number (errno) if the thing that failed was a system "
2817 "call."
2818 msgstr ""
2819
2820 # type: textblock
2821 #. type: textblock
2822 #: ../src/guestfs.pod:1269
2823 msgid ""
2824 "You can get at the additional information about the last error on the handle "
2825 "by calling L</guestfs_last_error>, L</guestfs_last_errno>, and/or by setting "
2826 "up an error handler with L</guestfs_set_error_handler>."
2827 msgstr ""
2828
2829 # type: textblock
2830 #. type: textblock
2831 #: ../src/guestfs.pod:1274
2832 msgid ""
2833 "When the handle is created, a default error handler is installed which "
2834 "prints the error message string to C<stderr>.  For small short-running "
2835 "command line programs it is sufficient to do:"
2836 msgstr ""
2837
2838 # type: verbatim
2839 #. type: verbatim
2840 #: ../src/guestfs.pod:1278
2841 #, no-wrap
2842 msgid ""
2843 " if (guestfs_launch (g) == -1)\n"
2844 "   exit (EXIT_FAILURE);\n"
2845 "\n"
2846 msgstr ""
2847
2848 # type: textblock
2849 #. type: textblock
2850 #: ../src/guestfs.pod:1281
2851 msgid ""
2852 "since the default error handler will ensure that an error message has been "
2853 "printed to C<stderr> before the program exits."
2854 msgstr ""
2855
2856 # type: textblock
2857 #. type: textblock
2858 #: ../src/guestfs.pod:1284
2859 msgid ""
2860 "For other programs the caller will almost certainly want to install an "
2861 "alternate error handler or do error handling in-line like this:"
2862 msgstr ""
2863
2864 # type: verbatim
2865 #. type: verbatim
2866 #: ../src/guestfs.pod:1287
2867 #, no-wrap
2868 msgid ""
2869 " g = guestfs_create ();\n"
2870 " \n"
2871 msgstr ""
2872
2873 # type: verbatim
2874 #. type: verbatim
2875 #: ../src/guestfs.pod:1289
2876 #, no-wrap
2877 msgid ""
2878 " /* This disables the default behaviour of printing errors\n"
2879 "    on stderr. */\n"
2880 " guestfs_set_error_handler (g, NULL, NULL);\n"
2881 " \n"
2882 msgstr ""
2883
2884 # type: verbatim
2885 #. type: verbatim
2886 #: ../src/guestfs.pod:1293
2887 #, no-wrap
2888 msgid ""
2889 " if (guestfs_launch (g) == -1) {\n"
2890 "   /* Examine the error message and print it etc. */\n"
2891 "   char *msg = guestfs_last_error (g);\n"
2892 "   int errnum = guestfs_last_errno (g);\n"
2893 "   fprintf (stderr, \"%s\\n\", msg);\n"
2894 "   /* ... */\n"
2895 "  }\n"
2896 "\n"
2897 msgstr ""
2898
2899 # type: textblock
2900 #. type: textblock
2901 #: ../src/guestfs.pod:1301
2902 msgid ""
2903 "Out of memory errors are handled differently.  The default action is to call "
2904 "L<abort(3)>.  If this is undesirable, then you can set a handler using L</"
2905 "guestfs_set_out_of_memory_handler>."
2906 msgstr ""
2907
2908 # type: textblock
2909 #. type: textblock
2910 #: ../src/guestfs.pod:1305
2911 msgid ""
2912 "L</guestfs_create> returns C<NULL> if the handle cannot be created, and "
2913 "because there is no handle if this happens there is no way to get additional "
2914 "error information.  However L</guestfs_create> is supposed to be a "
2915 "lightweight operation which can only fail because of insufficient memory (it "
2916 "returns NULL in this case)."
2917 msgstr ""
2918
2919 # type: =head2
2920 #. type: =head2
2921 #: ../src/guestfs.pod:1311
2922 msgid "guestfs_last_error"
2923 msgstr ""
2924
2925 # type: verbatim
2926 #. type: verbatim
2927 #: ../src/guestfs.pod:1313
2928 #, no-wrap
2929 msgid ""
2930 " const char *guestfs_last_error (guestfs_h *g);\n"
2931 "\n"
2932 msgstr ""
2933
2934 # type: textblock
2935 #. type: textblock
2936 #: ../src/guestfs.pod:1315
2937 msgid ""
2938 "This returns the last error message that happened on C<g>.  If there has not "
2939 "been an error since the handle was created, then this returns C<NULL>."
2940 msgstr ""
2941
2942 # type: textblock
2943 #. type: textblock
2944 #: ../src/guestfs.pod:1319
2945 msgid ""
2946 "The lifetime of the returned string is until the next error occurs, or L</"
2947 "guestfs_close> is called."
2948 msgstr ""
2949
2950 # type: =head2
2951 #. type: =head2
2952 #: ../src/guestfs.pod:1322
2953 msgid "guestfs_last_errno"
2954 msgstr ""
2955
2956 # type: verbatim
2957 #. type: verbatim
2958 #: ../src/guestfs.pod:1324
2959 #, no-wrap
2960 msgid ""
2961 " int guestfs_last_errno (guestfs_h *g);\n"
2962 "\n"
2963 msgstr ""
2964
2965 # type: textblock
2966 #. type: textblock
2967 #: ../src/guestfs.pod:1326
2968 msgid "This returns the last error number (errno) that happened on C<g>."
2969 msgstr ""
2970
2971 # type: textblock
2972 #. type: textblock
2973 #: ../src/guestfs.pod:1328
2974 msgid "If successful, an errno integer not equal to zero is returned."
2975 msgstr ""
2976
2977 # type: textblock
2978 #. type: textblock
2979 #: ../src/guestfs.pod:1330
2980 msgid ""
2981 "If no error, this returns 0.  This call can return 0 in three situations:"
2982 msgstr ""
2983
2984 # type: textblock
2985 #. type: textblock
2986 #: ../src/guestfs.pod:1337
2987 msgid "There has not been any error on the handle."
2988 msgstr ""
2989
2990 # type: textblock
2991 #. type: textblock
2992 #: ../src/guestfs.pod:1341
2993 msgid ""
2994 "There has been an error but the errno was meaningless.  This corresponds to "
2995 "the case where the error did not come from a failed system call, but for "
2996 "some other reason."
2997 msgstr ""
2998
2999 # type: textblock
3000 #. type: textblock
3001 #: ../src/guestfs.pod:1347
3002 msgid ""
3003 "There was an error from a failed system call, but for some reason the errno "
3004 "was not captured and returned.  This usually indicates a bug in libguestfs."
3005 msgstr ""
3006
3007 # type: textblock
3008 #. type: textblock
3009 #: ../src/guestfs.pod:1353
3010 msgid ""
3011 "Libguestfs tries to convert the errno from inside the applicance into a "
3012 "corresponding errno for the caller (not entirely trivial: the appliance "
3013 "might be running a completely different operating system from the library "
3014 "and error numbers are not standardized across Un*xen).  If this could not be "
3015 "done, then the error is translated to C<EINVAL>.  In practice this should "
3016 "only happen in very rare circumstances."
3017 msgstr ""
3018
3019 # type: =head2
3020 #. type: =head2
3021 #: ../src/guestfs.pod:1361
3022 msgid "guestfs_set_error_handler"
3023 msgstr ""
3024
3025 # type: verbatim
3026 #. type: verbatim
3027 #: ../src/guestfs.pod:1363
3028 #, no-wrap
3029 msgid ""
3030 " typedef void (*guestfs_error_handler_cb) (guestfs_h *g,\n"
3031 "                                           void *opaque,\n"
3032 "                                           const char *msg);\n"
3033 " void guestfs_set_error_handler (guestfs_h *g,\n"
3034 "                                 guestfs_error_handler_cb cb,\n"
3035 "                                 void *opaque);\n"
3036 "\n"
3037 msgstr ""
3038
3039 # type: textblock
3040 #. type: textblock
3041 #: ../src/guestfs.pod:1370
3042 msgid ""
3043 "The callback C<cb> will be called if there is an error.  The parameters "
3044 "passed to the callback are an opaque data pointer and the error message "
3045 "string."
3046 msgstr ""
3047
3048 # type: textblock
3049 #. type: textblock
3050 #: ../src/guestfs.pod:1374
3051 msgid ""
3052 "C<errno> is not passed to the callback.  To get that the callback must call "
3053 "L</guestfs_last_errno>."
3054 msgstr ""
3055
3056 # type: textblock
3057 #. type: textblock
3058 #: ../src/guestfs.pod:1377
3059 msgid ""
3060 "Note that the message string C<msg> is freed as soon as the callback "
3061 "function returns, so if you want to stash it somewhere you must make your "
3062 "own copy."
3063 msgstr ""
3064
3065 # type: textblock
3066 #. type: textblock
3067 #: ../src/guestfs.pod:1381
3068 msgid "The default handler prints messages on C<stderr>."
3069 msgstr ""
3070
3071 # type: textblock
3072 #. type: textblock
3073 #: ../src/guestfs.pod:1383
3074 msgid "If you set C<cb> to C<NULL> then I<no> handler is called."
3075 msgstr ""
3076
3077 # type: =head2
3078 #. type: =head2
3079 #: ../src/guestfs.pod:1385
3080 msgid "guestfs_get_error_handler"
3081 msgstr ""
3082
3083 # type: verbatim
3084 #. type: verbatim
3085 #: ../src/guestfs.pod:1387
3086 #, no-wrap
3087 msgid ""
3088 " guestfs_error_handler_cb guestfs_get_error_handler (guestfs_h *g,\n"
3089 "                                                     void **opaque_rtn);\n"
3090 "\n"
3091 msgstr ""
3092
3093 # type: textblock
3094 #. type: textblock
3095 #: ../src/guestfs.pod:1390
3096 msgid "Returns the current error handler callback."
3097 msgstr ""
3098
3099 # type: =head2
3100 #. type: =head2
3101 #: ../src/guestfs.pod:1392
3102 msgid "guestfs_set_out_of_memory_handler"
3103 msgstr ""
3104
3105 #. type: verbatim
3106 #: ../src/guestfs.pod:1394
3107 #, no-wrap
3108 msgid ""
3109 " typedef void (*guestfs_abort_cb) (void);\n"
3110 " void guestfs_set_out_of_memory_handler (guestfs_h *g,\n"
3111 "                                         guestfs_abort_cb);\n"
3112 "\n"
3113 msgstr ""
3114
3115 # type: textblock
3116 #. type: textblock
3117 #: ../src/guestfs.pod:1398
3118 msgid ""
3119 "The callback C<cb> will be called if there is an out of memory situation.  "
3120 "I<Note this callback must not return>."
3121 msgstr ""
3122
3123 # type: textblock
3124 #. type: textblock
3125 #: ../src/guestfs.pod:1401
3126 msgid "The default is to call L<abort(3)>."
3127 msgstr ""
3128
3129 # type: textblock
3130 #. type: textblock
3131 #: ../src/guestfs.pod:1403
3132 msgid ""
3133 "You cannot set C<cb> to C<NULL>.  You can't ignore out of memory situations."
3134 msgstr ""
3135
3136 # type: =head2
3137 #. type: =head2
3138 #: ../src/guestfs.pod:1406
3139 msgid "guestfs_get_out_of_memory_handler"
3140 msgstr ""
3141
3142 # type: verbatim
3143 #. type: verbatim
3144 #: ../src/guestfs.pod:1408
3145 #, no-wrap
3146 msgid ""
3147 " guestfs_abort_fn guestfs_get_out_of_memory_handler (guestfs_h *g);\n"
3148 "\n"
3149 msgstr ""
3150
3151 # type: textblock
3152 #. type: textblock
3153 #: ../src/guestfs.pod:1410
3154 msgid "This returns the current out of memory handler."
3155 msgstr ""
3156
3157 # type: =head1
3158 #. type: =head1
3159 #: ../src/guestfs.pod:1412
3160 msgid "API CALLS"
3161 msgstr ""
3162
3163 # type: textblock
3164 #. type: textblock
3165 #: ../src/guestfs.pod:1414 ../fish/guestfish.pod:969
3166 msgid "@ACTIONS@"
3167 msgstr ""
3168
3169 # type: =head1
3170 #. type: =head1
3171 #: ../src/guestfs.pod:1416
3172 msgid "STRUCTURES"
3173 msgstr ""
3174
3175 # type: textblock
3176 #. type: textblock
3177 #: ../src/guestfs.pod:1418
3178 msgid "@STRUCTS@"
3179 msgstr ""
3180
3181 # type: =head1
3182 #. type: =head1
3183 #: ../src/guestfs.pod:1420
3184 msgid "AVAILABILITY"
3185 msgstr ""
3186
3187 # type: =head2
3188 #. type: =head2
3189 #: ../src/guestfs.pod:1422
3190 msgid "GROUPS OF FUNCTIONALITY IN THE APPLIANCE"
3191 msgstr ""
3192
3193 # type: textblock
3194 #. type: textblock
3195 #: ../src/guestfs.pod:1424
3196 msgid ""
3197 "Using L</guestfs_available> you can test availability of the following "
3198 "groups of functions.  This test queries the appliance to see if the "
3199 "appliance you are currently using supports the functionality."
3200 msgstr ""
3201
3202 # type: textblock
3203 #. type: textblock
3204 #: ../src/guestfs.pod:1429
3205 msgid "@AVAILABILITY@"
3206 msgstr ""
3207
3208 # type: =head2
3209 #. type: =head2
3210 #: ../src/guestfs.pod:1431
3211 msgid "GUESTFISH supported COMMAND"
3212 msgstr ""
3213
3214 # type: textblock
3215 #. type: textblock
3216 #: ../src/guestfs.pod:1433
3217 msgid ""
3218 "In L<guestfish(3)> there is a handy interactive command C<supported> which "
3219 "prints out the available groups and whether they are supported by this build "
3220 "of libguestfs.  Note however that you have to do C<run> first."
3221 msgstr ""
3222
3223 # type: =head2
3224 #. type: =head2
3225 #: ../src/guestfs.pod:1438
3226 msgid "SINGLE CALLS AT COMPILE TIME"
3227 msgstr ""
3228
3229 # type: textblock
3230 #. type: textblock
3231 #: ../src/guestfs.pod:1440
3232 msgid ""
3233 "Since version 1.5.8, C<E<lt>guestfs.hE<gt>> defines symbols for each C API "
3234 "function, such as:"
3235 msgstr ""
3236
3237 # type: verbatim
3238 #. type: verbatim
3239 #: ../src/guestfs.pod:1443
3240 #, no-wrap
3241 msgid ""
3242 " #define LIBGUESTFS_HAVE_DD 1\n"
3243 "\n"
3244 msgstr ""
3245
3246 # type: textblock
3247 #. type: textblock
3248 #: ../src/guestfs.pod:1445
3249 msgid "if L</guestfs_dd> is available."
3250 msgstr ""
3251
3252 # type: textblock
3253 #. type: textblock
3254 #: ../src/guestfs.pod:1447
3255 msgid ""
3256 "Before version 1.5.8, if you needed to test whether a single libguestfs "
3257 "function is available at compile time, we recommended using build tools such "
3258 "as autoconf or cmake.  For example in autotools you could use:"
3259 msgstr ""
3260
3261 # type: verbatim
3262 #. type: verbatim
3263 #: ../src/guestfs.pod:1452
3264 #, no-wrap
3265 msgid ""
3266 " AC_CHECK_LIB([guestfs],[guestfs_create])\n"
3267 " AC_CHECK_FUNCS([guestfs_dd])\n"
3268 "\n"
3269 msgstr ""
3270
3271 # type: textblock
3272 #. type: textblock
3273 #: ../src/guestfs.pod:1455
3274 msgid ""
3275 "which would result in C<HAVE_GUESTFS_DD> being either defined or not defined "
3276 "in your program."
3277 msgstr ""
3278
3279 # type: =head2
3280 #. type: =head2
3281 #: ../src/guestfs.pod:1458
3282 msgid "SINGLE CALLS AT RUN TIME"
3283 msgstr ""
3284
3285 # type: textblock
3286 #. type: textblock
3287 #: ../src/guestfs.pod:1460
3288 msgid ""
3289 "Testing at compile time doesn't guarantee that a function really exists in "
3290 "the library.  The reason is that you might be dynamically linked against a "
3291 "previous I<libguestfs.so> (dynamic library)  which doesn't have the call.  "
3292 "This situation unfortunately results in a segmentation fault, which is a "
3293 "shortcoming of the C dynamic linking system itself."
3294 msgstr ""
3295
3296 # type: textblock
3297 #. type: textblock
3298 #: ../src/guestfs.pod:1467
3299 msgid ""
3300 "You can use L<dlopen(3)> to test if a function is available at run time, as "
3301 "in this example program (note that you still need the compile time check as "
3302 "well):"
3303 msgstr ""
3304
3305 # type: verbatim
3306 #. type: verbatim
3307 #: ../src/guestfs.pod:1471
3308 #, no-wrap
3309 msgid ""
3310 " #include <stdio.h>\n"
3311 " #include <stdlib.h>\n"
3312 " #include <unistd.h>\n"
3313 " #include <dlfcn.h>\n"
3314 " #include <guestfs.h>\n"
3315 " \n"
3316 msgstr ""
3317
3318 # type: verbatim
3319 #. type: verbatim
3320 #: ../src/guestfs.pod:1477
3321 #, no-wrap
3322 msgid ""
3323 " main ()\n"
3324 " {\n"
3325 " #ifdef LIBGUESTFS_HAVE_DD\n"
3326 "   void *dl;\n"
3327 "   int has_function;\n"
3328 " \n"
3329 msgstr ""
3330
3331 # type: verbatim
3332 #. type: verbatim
3333 #: ../src/guestfs.pod:1483
3334 #, no-wrap
3335 msgid ""
3336 "   /* Test if the function guestfs_dd is really available. */\n"
3337 "   dl = dlopen (NULL, RTLD_LAZY);\n"
3338 "   if (!dl) {\n"
3339 "     fprintf (stderr, \"dlopen: %s\\n\", dlerror ());\n"
3340 "     exit (EXIT_FAILURE);\n"
3341 "   }\n"
3342 "   has_function = dlsym (dl, \"guestfs_dd\") != NULL;\n"
3343 "   dlclose (dl);\n"
3344 " \n"
3345 msgstr ""
3346
3347 # type: verbatim
3348 #. type: verbatim
3349 #: ../src/guestfs.pod:1492
3350 #, no-wrap
3351 msgid ""
3352 "   if (!has_function)\n"
3353 "     printf (\"this libguestfs.so does NOT have guestfs_dd function\\n\");\n"
3354 "   else {\n"
3355 "     printf (\"this libguestfs.so has guestfs_dd function\\n\");\n"
3356 "     /* Now it's safe to call\n"
3357 "     guestfs_dd (g, \"foo\", \"bar\");\n"
3358 "     */\n"
3359 "   }\n"
3360 " #else\n"
3361 "   printf (\"guestfs_dd function was not found at compile time\\n\");\n"
3362 " #endif\n"
3363 "  }\n"
3364 "\n"
3365 msgstr ""
3366
3367 # type: textblock
3368 #. type: textblock
3369 #: ../src/guestfs.pod:1505
3370 msgid ""
3371 "You may think the above is an awful lot of hassle, and it is.  There are "
3372 "other ways outside of the C linking system to ensure that this kind of "
3373 "incompatibility never arises, such as using package versioning:"
3374 msgstr ""
3375
3376 # type: verbatim
3377 #. type: verbatim
3378 #: ../src/guestfs.pod:1510
3379 #, no-wrap
3380 msgid ""
3381 " Requires: libguestfs >= 1.0.80\n"
3382 "\n"
3383 msgstr ""
3384
3385 # type: =head1
3386 #. type: =head1
3387 #: ../src/guestfs.pod:1512
3388 msgid "CALLS WITH OPTIONAL ARGUMENTS"
3389 msgstr ""
3390
3391 # type: textblock
3392 #. type: textblock
3393 #: ../src/guestfs.pod:1514
3394 msgid ""
3395 "A recent feature of the API is the introduction of calls which take optional "
3396 "arguments.  In C these are declared 3 ways.  The main way is as a call which "
3397 "takes variable arguments (ie. C<...>), as in this example:"
3398 msgstr ""
3399
3400 # type: verbatim
3401 #. type: verbatim
3402 #: ../src/guestfs.pod:1519
3403 #, no-wrap
3404 msgid ""
3405 " int guestfs_add_drive_opts (guestfs_h *g, const char *filename, ...);\n"
3406 "\n"
3407 msgstr ""
3408
3409 # type: textblock
3410 #. type: textblock
3411 #: ../src/guestfs.pod:1521
3412 msgid ""
3413 "Call this with a list of optional arguments, terminated by C<-1>.  So to "
3414 "call with no optional arguments specified:"
3415 msgstr ""
3416
3417 # type: verbatim
3418 #. type: verbatim
3419 #: ../src/guestfs.pod:1524
3420 #, no-wrap
3421 msgid ""
3422 " guestfs_add_drive_opts (g, filename, -1);\n"
3423 "\n"
3424 msgstr ""
3425
3426 # type: textblock
3427 #. type: textblock
3428 #: ../src/guestfs.pod:1526
3429 msgid "With a single optional argument:"
3430 msgstr ""
3431
3432 # type: verbatim
3433 #. type: verbatim
3434 #: ../src/guestfs.pod:1528
3435 #, no-wrap
3436 msgid ""
3437 " guestfs_add_drive_opts (g, filename,\n"
3438 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"qcow2\",\n"
3439 "                         -1);\n"
3440 "\n"
3441 msgstr ""
3442
3443 # type: textblock
3444 #. type: textblock
3445 #: ../src/guestfs.pod:1532
3446 msgid "With two:"
3447 msgstr ""
3448
3449 # type: verbatim
3450 #. type: verbatim
3451 #: ../src/guestfs.pod:1534
3452 #, no-wrap
3453 msgid ""
3454 " guestfs_add_drive_opts (g, filename,\n"
3455 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"qcow2\",\n"
3456 "                         GUESTFS_ADD_DRIVE_OPTS_READONLY, 1,\n"
3457 "                         -1);\n"
3458 "\n"
3459 msgstr ""
3460
3461 # type: textblock
3462 #. type: textblock
3463 #: ../src/guestfs.pod:1539
3464 msgid ""
3465 "and so forth.  Don't forget the terminating C<-1> otherwise Bad Things will "
3466 "happen!"
3467 msgstr ""
3468
3469 # type: =head2
3470 #. type: =head2
3471 #: ../src/guestfs.pod:1542
3472 msgid "USING va_list FOR OPTIONAL ARGUMENTS"
3473 msgstr ""
3474
3475 # type: textblock
3476 #. type: textblock
3477 #: ../src/guestfs.pod:1544
3478 msgid ""
3479 "The second variant has the same name with the suffix C<_va>, which works the "
3480 "same way but takes a C<va_list>.  See the C manual for details.  For the "
3481 "example function, this is declared:"
3482 msgstr ""
3483
3484 # type: verbatim
3485 #. type: verbatim
3486 #: ../src/guestfs.pod:1548
3487 #, no-wrap
3488 msgid ""
3489 " int guestfs_add_drive_opts_va (guestfs_h *g, const char *filename,\n"
3490 "                                va_list args);\n"
3491 "\n"
3492 msgstr ""
3493
3494 # type: =head2
3495 #. type: =head2
3496 #: ../src/guestfs.pod:1551
3497 msgid "CONSTRUCTING OPTIONAL ARGUMENTS"
3498 msgstr ""
3499
3500 # type: textblock
3501 #. type: textblock
3502 #: ../src/guestfs.pod:1553
3503 msgid ""
3504 "The third variant is useful where you need to construct these calls.  You "
3505 "pass in a structure where you fill in the optional fields.  The structure "
3506 "has a bitmask as the first element which you must set to indicate which "
3507 "fields you have filled in.  For our example function the structure and call "
3508 "are declared:"
3509 msgstr ""
3510
3511 # type: verbatim
3512 #. type: verbatim
3513 #: ../src/guestfs.pod:1559
3514 #, no-wrap
3515 msgid ""
3516 " struct guestfs_add_drive_opts_argv {\n"
3517 "   uint64_t bitmask;\n"
3518 "   int readonly;\n"
3519 "   const char *format;\n"
3520 "   /* ... */\n"
3521 " };\n"
3522 " int guestfs_add_drive_opts_argv (guestfs_h *g, const char *filename,\n"
3523 "              const struct guestfs_add_drive_opts_argv *optargs);\n"
3524 "\n"
3525 msgstr ""
3526
3527 # type: textblock
3528 #. type: textblock
3529 #: ../src/guestfs.pod:1568
3530 msgid "You could call it like this:"
3531 msgstr ""
3532
3533 # type: verbatim
3534 #. type: verbatim
3535 #: ../src/guestfs.pod:1570
3536 #, no-wrap
3537 msgid ""
3538 " struct guestfs_add_drive_opts_argv optargs = {\n"
3539 "   .bitmask = GUESTFS_ADD_DRIVE_OPTS_READONLY_BITMASK |\n"
3540 "              GUESTFS_ADD_DRIVE_OPTS_FORMAT_BITMASK,\n"
3541 "   .readonly = 1,\n"
3542 "   .format = \"qcow2\"\n"
3543 " };\n"
3544 " \n"
3545 msgstr ""
3546
3547 # type: verbatim
3548 #. type: verbatim
3549 #: ../src/guestfs.pod:1577
3550 #, no-wrap
3551 msgid ""
3552 " guestfs_add_drive_opts_argv (g, filename, &optargs);\n"
3553 "\n"
3554 msgstr ""
3555
3556 # type: textblock
3557 #. type: textblock
3558 #: ../src/guestfs.pod:1579 ../src/guestfs-actions.pod:11
3559 #: ../src/guestfs-actions.pod:1844 ../src/guestfs-actions.pod:2234
3560 #: ../fish/guestfish-actions.pod:9 ../fish/guestfish-actions.pod:1255
3561 #: ../fish/guestfish-actions.pod:1502 ../tools/virt-win-reg.pl:532
3562 msgid "Notes:"
3563 msgstr ""
3564
3565 # type: textblock
3566 #. type: textblock
3567 #: ../src/guestfs.pod:1585
3568 msgid "The C<_BITMASK> suffix on each option name when specifying the bitmask."
3569 msgstr ""
3570
3571 # type: textblock
3572 #. type: textblock
3573 #: ../src/guestfs.pod:1590
3574 msgid "You do not need to fill in all fields of the structure."
3575 msgstr ""
3576
3577 # type: textblock
3578 #. type: textblock
3579 #: ../src/guestfs.pod:1594
3580 msgid ""
3581 "There must be a one-to-one correspondence between fields of the structure "
3582 "that are filled in, and bits set in the bitmask."
3583 msgstr ""
3584
3585 # type: =head2
3586 #. type: =head2
3587 #: ../src/guestfs.pod:1599
3588 msgid "OPTIONAL ARGUMENTS IN OTHER LANGUAGES"
3589 msgstr ""
3590
3591 # type: textblock
3592 #. type: textblock
3593 #: ../src/guestfs.pod:1601
3594 msgid ""
3595 "In other languages, optional arguments are expressed in the way that is "
3596 "natural for that language.  We refer you to the language-specific "
3597 "documentation for more details on that."
3598 msgstr ""
3599
3600 # type: textblock
3601 #. type: textblock
3602 #: ../src/guestfs.pod:1605
3603 msgid "For guestfish, see L<guestfish(1)/OPTIONAL ARGUMENTS>."
3604 msgstr ""
3605
3606 # type: =head2
3607 #. type: =head2
3608 #: ../src/guestfs.pod:1607
3609 msgid "SETTING CALLBACKS TO HANDLE EVENTS"
3610 msgstr ""
3611
3612 # type: textblock
3613 #. type: textblock
3614 #: ../src/guestfs.pod:1609
3615 msgid ""
3616 "The child process generates events in some situations.  Current events "
3617 "include: receiving a log message, the child process exits."
3618 msgstr ""
3619
3620 # type: textblock
3621 #. type: textblock
3622 #: ../src/guestfs.pod:1612
3623 msgid ""
3624 "Use the C<guestfs_set_*_callback> functions to set a callback for different "
3625 "types of events."
3626 msgstr ""
3627
3628 # type: textblock
3629 #. type: textblock
3630 #: ../src/guestfs.pod:1615
3631 msgid ""
3632 "Only I<one callback of each type> can be registered for each handle.  "
3633 "Calling C<guestfs_set_*_callback> again overwrites the previous callback of "
3634 "that type.  Cancel all callbacks of this type by calling this function with "
3635 "C<cb> set to C<NULL>."
3636 msgstr ""
3637
3638 # type: =head2
3639 #. type: =head2
3640 #: ../src/guestfs.pod:1620
3641 msgid "guestfs_set_log_message_callback"
3642 msgstr ""
3643
3644 # type: verbatim
3645 #. type: verbatim
3646 #: ../src/guestfs.pod:1622
3647 #, no-wrap
3648 msgid ""
3649 " typedef void (*guestfs_log_message_cb) (guestfs_h *g, void *opaque,\n"
3650 "                                         char *buf, int len);\n"
3651 " void guestfs_set_log_message_callback (guestfs_h *g,\n"
3652 "                                        guestfs_log_message_cb cb,\n"
3653 "                                        void *opaque);\n"
3654 "\n"
3655 msgstr ""
3656
3657 # type: textblock
3658 #. type: textblock
3659 #: ../src/guestfs.pod:1628
3660 msgid ""
3661 "The callback function C<cb> will be called whenever qemu or the guest writes "
3662 "anything to the console."
3663 msgstr ""
3664
3665 # type: textblock
3666 #. type: textblock
3667 #: ../src/guestfs.pod:1631
3668 msgid "Use this function to capture kernel messages and similar."
3669 msgstr ""
3670
3671 # type: textblock
3672 #. type: textblock
3673 #: ../src/guestfs.pod:1633
3674 msgid ""
3675 "Normally there is no log message handler, and log messages are just "
3676 "discarded."
3677 msgstr ""
3678
3679 # type: =head2
3680 #. type: =head2
3681 #: ../src/guestfs.pod:1636
3682 msgid "guestfs_set_subprocess_quit_callback"
3683 msgstr ""
3684
3685 # type: verbatim
3686 #. type: verbatim
3687 #: ../src/guestfs.pod:1638
3688 #, no-wrap
3689 msgid ""
3690 " typedef void (*guestfs_subprocess_quit_cb) (guestfs_h *g, void *opaque);\n"
3691 " void guestfs_set_subprocess_quit_callback (guestfs_h *g,\n"
3692 "                                            guestfs_subprocess_quit_cb cb,\n"
3693 "                                            void *opaque);\n"
3694 "\n"
3695 msgstr ""
3696
3697 # type: textblock
3698 #. type: textblock
3699 #: ../src/guestfs.pod:1643
3700 msgid ""
3701 "The callback function C<cb> will be called when the child process quits, "
3702 "either asynchronously or if killed by L</guestfs_kill_subprocess>.  (This "
3703 "corresponds to a transition from any state to the CONFIG state)."
3704 msgstr ""
3705
3706 # type: =head2
3707 #. type: =head2
3708 #: ../src/guestfs.pod:1648
3709 msgid "guestfs_set_launch_done_callback"
3710 msgstr ""
3711
3712 # type: verbatim
3713 #. type: verbatim
3714 #: ../src/guestfs.pod:1650
3715 #, no-wrap
3716 msgid ""
3717 " typedef void (*guestfs_launch_done_cb) (guestfs_h *g, void *opaque);\n"
3718 " void guestfs_set_launch_done_callback (guestfs_h *g,\n"
3719 "                                        guestfs_launch_done_cb cb,\n"
3720 "                                        void *opaque);\n"
3721 "\n"
3722 msgstr ""
3723
3724 # type: textblock
3725 #. type: textblock
3726 #: ../src/guestfs.pod:1655
3727 msgid ""
3728 "The callback function C<cb> will be called when the child process becomes "
3729 "ready first time after it has been launched.  (This corresponds to a "
3730 "transition from LAUNCHING to the READY state)."
3731 msgstr ""
3732
3733 # type: =head2
3734 #. type: =head2
3735 #: ../src/guestfs.pod:1659
3736 msgid "guestfs_set_close_callback"
3737 msgstr ""
3738
3739 # type: verbatim
3740 #. type: verbatim
3741 #: ../src/guestfs.pod:1661
3742 #, no-wrap
3743 msgid ""
3744 " typedef void (*guestfs_close_cb) (guestfs_h *g, void *opaque);\n"
3745 " void guestfs_set_close_callback (guestfs_h *g,\n"
3746 "                                  guestfs_close_cb cb,\n"
3747 "                                  void *opaque);\n"
3748 "\n"
3749 msgstr ""
3750
3751 # type: textblock
3752 #. type: textblock
3753 #: ../src/guestfs.pod:1666
3754 msgid ""
3755 "The callback function C<cb> will be called while the handle is being closed "
3756 "(synchronously from L</guestfs_close>)."
3757 msgstr ""
3758
3759 # type: textblock
3760 #. type: textblock
3761 #: ../src/guestfs.pod:1669
3762 msgid ""
3763 "Note that libguestfs installs an L<atexit(3)> handler to try to clean up "
3764 "handles that are open when the program exits.  This means that this callback "
3765 "might be called indirectly from L<exit(3)>, which can cause unexpected "
3766 "problems in higher-level languages (eg. if your HLL interpreter has already "
3767 "been cleaned up by the time this is called, and if your callback then jumps "
3768 "into some HLL function)."
3769 msgstr ""
3770
3771 # type: =head2
3772 #. type: =head2
3773 #: ../src/guestfs.pod:1677
3774 msgid "guestfs_set_progress_callback"
3775 msgstr ""
3776
3777 # type: verbatim
3778 #. type: verbatim
3779 #: ../src/guestfs.pod:1679
3780 #, no-wrap
3781 msgid ""
3782 " typedef void (*guestfs_progress_cb) (guestfs_h *g, void *opaque,\n"
3783 "                                      int proc_nr, int serial,\n"
3784 "                                      uint64_t position, uint64_t total);\n"
3785 " void guestfs_set_progress_callback (guestfs_h *g,\n"
3786 "                                     guestfs_progress_cb cb,\n"
3787 "                                     void *opaque);\n"
3788 "\n"
3789 msgstr ""
3790
3791 # type: textblock
3792 #. type: textblock
3793 #: ../src/guestfs.pod:1686
3794 msgid ""
3795 "Some long-running operations can generate progress messages.  If this "
3796 "callback is registered, then it will be called each time a progress message "
3797 "is generated (usually two seconds after the operation started, and three "
3798 "times per second thereafter until it completes, although the frequency may "
3799 "change in future versions)."
3800 msgstr ""
3801
3802 # type: textblock
3803 #. type: textblock
3804 #: ../src/guestfs.pod:1692
3805 msgid ""
3806 "The callback receives two numbers: C<position> and C<total>.  The units of "
3807 "C<total> are not defined, although for some operations C<total> may relate "
3808 "in some way to the amount of data to be transferred (eg. in bytes or "
3809 "megabytes), and C<position> may be the portion which has been transferred."
3810 msgstr ""
3811
3812 # type: textblock
3813 #. type: textblock
3814 #: ../src/guestfs.pod:1698
3815 msgid "The only defined and stable parts of the API are:"
3816 msgstr ""
3817
3818 # type: textblock
3819 #. type: textblock
3820 #: ../src/guestfs.pod:1704
3821 msgid ""
3822 "The callback can display to the user some type of progress bar or indicator "
3823 "which shows the ratio of C<position>:C<total>."
3824 msgstr ""
3825
3826 # type: textblock
3827 #. type: textblock
3828 #: ../src/guestfs.pod:1709
3829 msgid "0 E<lt>= C<position> E<lt>= C<total>"
3830 msgstr ""
3831
3832 #. type: textblock
3833 #: ../src/guestfs.pod:1713
3834 msgid ""
3835 "If any progress notification is sent during a call, then a final progress "
3836 "notification is always sent when C<position> = C<total> (I<unless> the call "
3837 "fails with an error)."
3838 msgstr ""
3839
3840 # type: textblock
3841 #. type: textblock
3842 #: ../src/guestfs.pod:1717
3843 msgid ""
3844 "This is to simplify caller code, so callers can easily set the progress "
3845 "indicator to \"100%\" at the end of the operation, without requiring special "
3846 "code to detect this case."
3847 msgstr ""
3848
3849 # type: textblock
3850 #. type: textblock
3851 #: ../src/guestfs.pod:1723
3852 msgid ""
3853 "The callback also receives the procedure number and serial number of the "
3854 "call.  These are only useful for debugging protocol issues, and the callback "
3855 "can normally ignore them.  The callback may want to print these numbers in "
3856 "error messages or debugging messages."
3857 msgstr ""
3858
3859 # type: =head1
3860 #. type: =head1
3861 #: ../src/guestfs.pod:1728
3862 msgid "PRIVATE DATA AREA"
3863 msgstr ""
3864
3865 # type: textblock
3866 #. type: textblock
3867 #: ../src/guestfs.pod:1730
3868 msgid ""
3869 "You can attach named pieces of private data to the libguestfs handle, and "
3870 "fetch them by name for the lifetime of the handle.  This is called the "
3871 "private data area and is only available from the C API."
3872 msgstr ""
3873
3874 # type: textblock
3875 #. type: textblock
3876 #: ../src/guestfs.pod:1734
3877 msgid "To attach a named piece of data, use the following call:"
3878 msgstr ""
3879
3880 # type: verbatim
3881 #. type: verbatim
3882 #: ../src/guestfs.pod:1736
3883 #, no-wrap
3884 msgid ""
3885 " void guestfs_set_private (guestfs_h *g, const char *key, void *data);\n"
3886 "\n"
3887 msgstr ""
3888
3889 # type: textblock
3890 #. type: textblock
3891 #: ../src/guestfs.pod:1738
3892 msgid ""
3893 "C<key> is the name to associate with this data, and C<data> is an arbitrary "
3894 "pointer (which can be C<NULL>).  Any previous item with the same name is "
3895 "overwritten."
3896 msgstr ""
3897
3898 # type: textblock
3899 #. type: textblock
3900 #: ../src/guestfs.pod:1742
3901 msgid ""
3902 "You can use any C<key> you want, but names beginning with an underscore "
3903 "character are reserved for internal libguestfs purposes (for implementing "
3904 "language bindings).  It is recommended to prefix the name with some unique "
3905 "string to avoid collisions with other users."
3906 msgstr ""
3907
3908 # type: textblock
3909 #. type: textblock
3910 #: ../src/guestfs.pod:1747
3911 msgid "To retrieve the pointer, use:"
3912 msgstr ""
3913
3914 # type: verbatim
3915 #. type: verbatim
3916 #: ../src/guestfs.pod:1749
3917 #, no-wrap
3918 msgid ""
3919 " void *guestfs_get_private (guestfs_h *g, const char *key);\n"
3920 "\n"
3921 msgstr ""
3922
3923 # type: textblock
3924 #. type: textblock
3925 #: ../src/guestfs.pod:1751
3926 msgid ""
3927 "This function returns C<NULL> if either no data is found associated with "
3928 "C<key>, or if the user previously set the C<key>'s C<data> pointer to "
3929 "C<NULL>."
3930 msgstr ""
3931
3932 # type: textblock
3933 #. type: textblock
3934 #: ../src/guestfs.pod:1755
3935 msgid ""
3936 "Libguestfs does not try to look at or interpret the C<data> pointer in any "
3937 "way.  As far as libguestfs is concerned, it need not be a valid pointer at "
3938 "all.  In particular, libguestfs does I<not> try to free the data when the "
3939 "handle is closed.  If the data must be freed, then the caller must either "
3940 "free it before calling L</guestfs_close> or must set up a close callback to "
3941 "do it (see L</guestfs_set_close_callback>, and note that only one callback "
3942 "can be registered for a handle)."
3943 msgstr ""
3944
3945 # type: textblock
3946 #. type: textblock
3947 #: ../src/guestfs.pod:1763
3948 msgid ""
3949 "The private data area is implemented using a hash table, and should be "
3950 "reasonably efficient for moderate numbers of keys."
3951 msgstr ""
3952
3953 # type: =end
3954 #. type: =end
3955 #: ../src/guestfs.pod:1766 ../src/guestfs.pod:1771
3956 msgid "html"
3957 msgstr ""
3958
3959 # type: textblock
3960 #. type: textblock
3961 #: ../src/guestfs.pod:1768
3962 msgid ""
3963 "<!-- old anchor for the next section --> <a name="
3964 "\"state_machine_and_low_level_event_api\"/>"
3965 msgstr ""
3966
3967 # type: =head1
3968 #. type: =head1
3969 #: ../src/guestfs.pod:1773
3970 msgid "ARCHITECTURE"
3971 msgstr ""
3972
3973 # type: textblock
3974 #. type: textblock
3975 #: ../src/guestfs.pod:1775
3976 msgid ""
3977 "Internally, libguestfs is implemented by running an appliance (a special "
3978 "type of small virtual machine) using L<qemu(1)>.  Qemu runs as a child "
3979 "process of the main program."
3980 msgstr ""
3981
3982 # type: verbatim
3983 #. type: verbatim
3984 #: ../src/guestfs.pod:1779
3985 #, no-wrap
3986 msgid ""
3987 "  ___________________\n"
3988 " /                   \\\n"
3989 " | main program      |\n"
3990 " |                   |\n"
3991 " |                   |           child process / appliance\n"
3992 " |                   |           __________________________\n"
3993 " |                   |          / qemu                     \\\n"
3994 " +-------------------+   RPC    |      +-----------------+ |\n"
3995 " | libguestfs     <--------------------> guestfsd        | |\n"
3996 " |                   |          |      +-----------------+ |\n"
3997 " \\___________________/          |      | Linux kernel    | |\n"
3998 "                                |      +--^--------------+ |\n"
3999 "                                \\_________|________________/\n"
4000 "                                          |\n"
4001 "                                   _______v______\n"
4002 "                                  /              \\\n"
4003 "                                  | Device or    |\n"
4004 "                                  | disk image   |\n"
4005 "                                  \\______________/\n"
4006 "\n"
4007 msgstr ""
4008
4009 # type: textblock
4010 #. type: textblock
4011 #: ../src/guestfs.pod:1799
4012 msgid ""
4013 "The library, linked to the main program, creates the child process and hence "
4014 "the appliance in the L</guestfs_launch> function."
4015 msgstr ""
4016
4017 # type: textblock
4018 #. type: textblock
4019 #: ../src/guestfs.pod:1802
4020 msgid ""
4021 "Inside the appliance is a Linux kernel and a complete stack of userspace "
4022 "tools (such as LVM and ext2 programs) and a small controlling daemon called "
4023 "L</guestfsd>.  The library talks to L</guestfsd> using remote procedure "
4024 "calls (RPC).  There is a mostly one-to-one correspondence between libguestfs "
4025 "API calls and RPC calls to the daemon.  Lastly the disk image(s) are "
4026 "attached to the qemu process which translates device access by the "
4027 "appliance's Linux kernel into accesses to the image."
4028 msgstr ""
4029
4030 # type: textblock
4031 #. type: textblock
4032 #: ../src/guestfs.pod:1811
4033 msgid ""
4034 "A common misunderstanding is that the appliance \"is\" the virtual machine.  "
4035 "Although the disk image you are attached to might also be used by some "
4036 "virtual machine, libguestfs doesn't know or care about this.  (But you will "
4037 "care if both libguestfs's qemu process and your virtual machine are trying "
4038 "to update the disk image at the same time, since these usually results in "
4039 "massive disk corruption)."
4040 msgstr ""
4041
4042 # type: =head1
4043 #. type: =head1
4044 #: ../src/guestfs.pod:1818
4045 msgid "STATE MACHINE"
4046 msgstr ""
4047
4048 # type: textblock
4049 #. type: textblock
4050 #: ../src/guestfs.pod:1820
4051 msgid "libguestfs uses a state machine to model the child process:"
4052 msgstr ""
4053
4054 # type: verbatim
4055 #. type: verbatim
4056 #: ../src/guestfs.pod:1822
4057 #, no-wrap
4058 msgid ""
4059 "                         |\n"
4060 "                    guestfs_create\n"
4061 "                         |\n"
4062 "                         |\n"
4063 "                     ____V_____\n"
4064 "                    /          \\\n"
4065 "                    |  CONFIG  |\n"
4066 "                    \\__________/\n"
4067 "                     ^ ^   ^  \\\n"
4068 "                    /  |    \\  \\ guestfs_launch\n"
4069 "                   /   |    _\\__V______\n"
4070 "                  /    |   /           \\\n"
4071 "                 /     |   | LAUNCHING |\n"
4072 "                /      |   \\___________/\n"
4073 "               /       |       /\n"
4074 "              /        |  guestfs_launch\n"
4075 "             /         |     /\n"
4076 "    ______  /        __|____V\n"
4077 "   /      \\ ------> /        \\\n"
4078 "   | BUSY |         | READY  |\n"
4079 "   \\______/ <------ \\________/\n"
4080 "\n"
4081 msgstr ""
4082
4083 # type: textblock
4084 #. type: textblock
4085 #: ../src/guestfs.pod:1844
4086 msgid ""
4087 "The normal transitions are (1) CONFIG (when the handle is created, but there "
4088 "is no child process), (2) LAUNCHING (when the child process is booting up), "
4089 "(3) alternating between READY and BUSY as commands are issued to, and "
4090 "carried out by, the child process."
4091 msgstr ""
4092
4093 # type: textblock
4094 #. type: textblock
4095 #: ../src/guestfs.pod:1849
4096 msgid ""
4097 "The guest may be killed by L</guestfs_kill_subprocess>, or may die "
4098 "asynchronously at any time (eg. due to some internal error), and that causes "
4099 "the state to transition back to CONFIG."
4100 msgstr ""
4101
4102 # type: textblock
4103 #. type: textblock
4104 #: ../src/guestfs.pod:1853
4105 msgid ""
4106 "Configuration commands for qemu such as L</guestfs_add_drive> can only be "
4107 "issued when in the CONFIG state."
4108 msgstr ""
4109
4110 # type: textblock
4111 #. type: textblock
4112 #: ../src/guestfs.pod:1856
4113 msgid ""
4114 "The API offers one call that goes from CONFIG through LAUNCHING to READY.  "
4115 "L</guestfs_launch> blocks until the child process is READY to accept "
4116 "commands (or until some failure or timeout).  L</guestfs_launch> internally "
4117 "moves the state from CONFIG to LAUNCHING while it is running."
4118 msgstr ""
4119
4120 # type: textblock
4121 #. type: textblock
4122 #: ../src/guestfs.pod:1862
4123 msgid ""
4124 "API actions such as L</guestfs_mount> can only be issued when in the READY "
4125 "state.  These API calls block waiting for the command to be carried out (ie. "
4126 "the state to transition to BUSY and then back to READY).  There are no non-"
4127 "blocking versions, and no way to issue more than one command per handle at "
4128 "the same time."
4129 msgstr ""
4130
4131 # type: textblock
4132 #. type: textblock
4133 #: ../src/guestfs.pod:1868
4134 msgid ""
4135 "Finally, the child process sends asynchronous messages back to the main "
4136 "program, such as kernel log messages.  You can register a callback to "
4137 "receive these messages."
4138 msgstr ""
4139
4140 # type: =head1
4141 #. type: =head1
4142 #: ../src/guestfs.pod:1872
4143 msgid "INTERNALS"
4144 msgstr ""
4145
4146 # type: =head2
4147 #. type: =head2
4148 #: ../src/guestfs.pod:1874
4149 msgid "COMMUNICATION PROTOCOL"
4150 msgstr ""
4151
4152 # type: textblock
4153 #. type: textblock
4154 #: ../src/guestfs.pod:1876
4155 msgid ""
4156 "Don't rely on using this protocol directly.  This section documents how it "
4157 "currently works, but it may change at any time."
4158 msgstr ""
4159
4160 # type: textblock
4161 #. type: textblock
4162 #: ../src/guestfs.pod:1879
4163 msgid ""
4164 "The protocol used to talk between the library and the daemon running inside "
4165 "the qemu virtual machine is a simple RPC mechanism built on top of XDR (RFC "
4166 "1014, RFC 1832, RFC 4506)."
4167 msgstr ""
4168
4169 # type: textblock
4170 #. type: textblock
4171 #: ../src/guestfs.pod:1883
4172 msgid ""
4173 "The detailed format of structures is in C<src/guestfs_protocol.x> (note: "
4174 "this file is automatically generated)."
4175 msgstr ""
4176
4177 # type: textblock
4178 #. type: textblock
4179 #: ../src/guestfs.pod:1886
4180 msgid ""
4181 "There are two broad cases, ordinary functions that don't have any C<FileIn> "
4182 "and C<FileOut> parameters, which are handled with very simple request/reply "
4183 "messages.  Then there are functions that have any C<FileIn> or C<FileOut> "
4184 "parameters, which use the same request and reply messages, but they may also "
4185 "be followed by files sent using a chunked encoding."
4186 msgstr ""
4187
4188 # type: =head3
4189 #. type: =head3
4190 #: ../src/guestfs.pod:1893
4191 msgid "ORDINARY FUNCTIONS (NO FILEIN/FILEOUT PARAMS)"
4192 msgstr ""
4193
4194 # type: textblock
4195 #. type: textblock
4196 #: ../src/guestfs.pod:1895
4197 msgid "For ordinary functions, the request message is:"
4198 msgstr ""
4199
4200 # type: verbatim
4201 #. type: verbatim
4202 #: ../src/guestfs.pod:1897
4203 #, no-wrap
4204 msgid ""
4205 " total length (header + arguments,\n"
4206 "      but not including the length word itself)\n"
4207 " struct guestfs_message_header (encoded as XDR)\n"
4208 " struct guestfs_<foo>_args (encoded as XDR)\n"
4209 "\n"
4210 msgstr ""
4211
4212 # type: textblock
4213 #. type: textblock
4214 #: ../src/guestfs.pod:1902
4215 msgid ""
4216 "The total length field allows the daemon to allocate a fixed size buffer "
4217 "into which it slurps the rest of the message.  As a result, the total length "
4218 "is limited to C<GUESTFS_MESSAGE_MAX> bytes (currently 4MB), which means the "
4219 "effective size of any request is limited to somewhere under this size."
4220 msgstr ""
4221
4222 # type: textblock
4223 #. type: textblock
4224 #: ../src/guestfs.pod:1908
4225 msgid ""
4226 "Note also that many functions don't take any arguments, in which case the "
4227 "C<guestfs_I<foo>_args> is completely omitted."
4228 msgstr ""
4229
4230 # type: textblock
4231 #. type: textblock
4232 #: ../src/guestfs.pod:1911
4233 msgid ""
4234 "The header contains the procedure number (C<guestfs_proc>) which is how the "
4235 "receiver knows what type of args structure to expect, or none at all."
4236 msgstr ""
4237
4238 # type: textblock
4239 #. type: textblock
4240 #: ../src/guestfs.pod:1915
4241 msgid ""
4242 "For functions that take optional arguments, the optional arguments are "
4243 "encoded in the C<guestfs_I<foo>_args> structure in the same way as ordinary "
4244 "arguments.  A bitmask in the header indicates which optional arguments are "
4245 "meaningful.  The bitmask is also checked to see if it contains bits set "
4246 "which the daemon does not know about (eg. if more optional arguments were "
4247 "added in a later version of the library), and this causes the call to be "
4248 "rejected."
4249 msgstr ""
4250
4251 # type: textblock
4252 #. type: textblock
4253 #: ../src/guestfs.pod:1923
4254 msgid "The reply message for ordinary functions is:"
4255 msgstr ""
4256
4257 # type: verbatim
4258 #. type: verbatim
4259 #: ../src/guestfs.pod:1925
4260 #, no-wrap
4261 msgid ""
4262 " total length (header + ret,\n"
4263 "      but not including the length word itself)\n"
4264 " struct guestfs_message_header (encoded as XDR)\n"
4265 " struct guestfs_<foo>_ret (encoded as XDR)\n"
4266 "\n"
4267 msgstr ""
4268
4269 # type: textblock
4270 #. type: textblock
4271 #: ../src/guestfs.pod:1930
4272 msgid ""
4273 "As above the C<guestfs_I<foo>_ret> structure may be completely omitted for "
4274 "functions that return no formal return values."
4275 msgstr ""
4276
4277 # type: textblock
4278 #. type: textblock
4279 #: ../src/guestfs.pod:1933
4280 msgid ""
4281 "As above the total length of the reply is limited to C<GUESTFS_MESSAGE_MAX>."
4282 msgstr ""
4283
4284 # type: textblock
4285 #. type: textblock
4286 #: ../src/guestfs.pod:1936
4287 msgid ""
4288 "In the case of an error, a flag is set in the header, and the reply message "
4289 "is slightly changed:"
4290 msgstr ""
4291
4292 # type: verbatim
4293 #. type: verbatim
4294 #: ../src/guestfs.pod:1939
4295 #, no-wrap
4296 msgid ""
4297 " total length (header + error,\n"
4298 "      but not including the length word itself)\n"
4299 " struct guestfs_message_header (encoded as XDR)\n"
4300 " struct guestfs_message_error (encoded as XDR)\n"
4301 "\n"
4302 msgstr ""
4303
4304 # type: textblock
4305 #. type: textblock
4306 #: ../src/guestfs.pod:1944
4307 msgid ""
4308 "The C<guestfs_message_error> structure contains the error message as a "
4309 "string."
4310 msgstr ""
4311
4312 # type: =head3
4313 #. type: =head3
4314 #: ../src/guestfs.pod:1947
4315 msgid "FUNCTIONS THAT HAVE FILEIN PARAMETERS"
4316 msgstr ""
4317
4318 # type: textblock
4319 #. type: textblock
4320 #: ../src/guestfs.pod:1949
4321 msgid ""
4322 "A C<FileIn> parameter indicates that we transfer a file I<into> the guest.  "
4323 "The normal request message is sent (see above).  However this is followed by "
4324 "a sequence of file chunks."
4325 msgstr ""
4326
4327 # type: verbatim
4328 #. type: verbatim
4329 #: ../src/guestfs.pod:1953
4330 #, no-wrap
4331 msgid ""
4332 " total length (header + arguments,\n"
4333 "      but not including the length word itself,\n"
4334 "      and not including the chunks)\n"
4335 " struct guestfs_message_header (encoded as XDR)\n"
4336 " struct guestfs_<foo>_args (encoded as XDR)\n"
4337 " sequence of chunks for FileIn param #0\n"
4338 " sequence of chunks for FileIn param #1 etc.\n"
4339 "\n"
4340 msgstr ""
4341
4342 # type: textblock
4343 #. type: textblock
4344 #: ../src/guestfs.pod:1961
4345 msgid "The \"sequence of chunks\" is:"
4346 msgstr ""
4347
4348 # type: verbatim
4349 #. type: verbatim
4350 #: ../src/guestfs.pod:1963
4351 #, no-wrap
4352 msgid ""
4353 " length of chunk (not including length word itself)\n"
4354 " struct guestfs_chunk (encoded as XDR)\n"
4355 " length of chunk\n"
4356 " struct guestfs_chunk (encoded as XDR)\n"
4357 "   ...\n"
4358 " length of chunk\n"
4359 " struct guestfs_chunk (with data.data_len == 0)\n"
4360 "\n"
4361 msgstr ""
4362
4363 # type: textblock
4364 #. type: textblock
4365 #: ../src/guestfs.pod:1971
4366 msgid ""
4367 "The final chunk has the C<data_len> field set to zero.  Additionally a flag "
4368 "is set in the final chunk to indicate either successful completion or early "
4369 "cancellation."
4370 msgstr ""
4371
4372 # type: textblock
4373 #. type: textblock
4374 #: ../src/guestfs.pod:1975
4375 msgid ""
4376 "At time of writing there are no functions that have more than one FileIn "
4377 "parameter.  However this is (theoretically) supported, by sending the "
4378 "sequence of chunks for each FileIn parameter one after another (from left to "
4379 "right)."
4380 msgstr ""
4381
4382 # type: textblock
4383 #. type: textblock
4384 #: ../src/guestfs.pod:1980
4385 msgid ""
4386 "Both the library (sender) I<and> the daemon (receiver) may cancel the "
4387 "transfer.  The library does this by sending a chunk with a special flag set "
4388 "to indicate cancellation.  When the daemon sees this, it cancels the whole "
4389 "RPC, does I<not> send any reply, and goes back to reading the next request."
4390 msgstr ""
4391
4392 # type: textblock
4393 #. type: textblock
4394 #: ../src/guestfs.pod:1986
4395 msgid ""
4396 "The daemon may also cancel.  It does this by writing a special word "
4397 "C<GUESTFS_CANCEL_FLAG> to the socket.  The library listens for this during "
4398 "the transfer, and if it gets it, it will cancel the transfer (it sends a "
4399 "cancel chunk).  The special word is chosen so that even if cancellation "
4400 "happens right at the end of the transfer (after the library has finished "
4401 "writing and has started listening for the reply), the \"spurious\" cancel "
4402 "flag will not be confused with the reply message."
4403 msgstr ""
4404
4405 # type: textblock
4406 #. type: textblock
4407 #: ../src/guestfs.pod:1995
4408 msgid ""
4409 "This protocol allows the transfer of arbitrary sized files (no 32 bit "
4410 "limit), and also files where the size is not known in advance (eg. from "
4411 "pipes or sockets).  However the chunks are rather small "
4412 "(C<GUESTFS_MAX_CHUNK_SIZE>), so that neither the library nor the daemon need "
4413 "to keep much in memory."
4414 msgstr ""
4415
4416 # type: =head3
4417 #. type: =head3
4418 #: ../src/guestfs.pod:2001
4419 msgid "FUNCTIONS THAT HAVE FILEOUT PARAMETERS"
4420 msgstr ""
4421
4422 # type: textblock
4423 #. type: textblock
4424 #: ../src/guestfs.pod:2003
4425 msgid ""
4426 "The protocol for FileOut parameters is exactly the same as for FileIn "
4427 "parameters, but with the roles of daemon and library reversed."
4428 msgstr ""
4429
4430 # type: verbatim
4431 #. type: verbatim
4432 #: ../src/guestfs.pod:2006
4433 #, no-wrap
4434 msgid ""
4435 " total length (header + ret,\n"
4436 "      but not including the length word itself,\n"
4437 "      and not including the chunks)\n"
4438 " struct guestfs_message_header (encoded as XDR)\n"
4439 " struct guestfs_<foo>_ret (encoded as XDR)\n"
4440 " sequence of chunks for FileOut param #0\n"
4441 " sequence of chunks for FileOut param #1 etc.\n"
4442 "\n"
4443 msgstr ""
4444
4445 # type: =head3
4446 #. type: =head3
4447 #: ../src/guestfs.pod:2014
4448 msgid "INITIAL MESSAGE"
4449 msgstr ""
4450
4451 # type: textblock
4452 #. type: textblock
4453 #: ../src/guestfs.pod:2016
4454 msgid ""
4455 "When the daemon launches it sends an initial word (C<GUESTFS_LAUNCH_FLAG>) "
4456 "which indicates that the guest and daemon is alive.  This is what L</"
4457 "guestfs_launch> waits for."
4458 msgstr ""
4459
4460 # type: =head3
4461 #. type: =head3
4462 #: ../src/guestfs.pod:2020
4463 msgid "PROGRESS NOTIFICATION MESSAGES"
4464 msgstr ""
4465
4466 # type: textblock
4467 #. type: textblock
4468 #: ../src/guestfs.pod:2022
4469 msgid ""
4470 "The daemon may send progress notification messages at any time.  These are "
4471 "distinguished by the normal length word being replaced by "
4472 "C<GUESTFS_PROGRESS_FLAG>, followed by a fixed size progress message."
4473 msgstr ""
4474
4475 # type: textblock
4476 #. type: textblock
4477 #: ../src/guestfs.pod:2026
4478 msgid ""
4479 "The library turns them into progress callbacks (see "
4480 "C<guestfs_set_progress_callback>) if there is a callback registered, or "
4481 "discards them if not."
4482 msgstr ""
4483
4484 # type: textblock
4485 #. type: textblock
4486 #: ../src/guestfs.pod:2030
4487 msgid ""
4488 "The daemon self-limits the frequency of progress messages it sends (see "
4489 "C<daemon/proto.c:notify_progress>).  Not all calls generate progress "
4490 "messages."
4491 msgstr ""
4492
4493 # type: =head1
4494 #. type: =head1
4495 #: ../src/guestfs.pod:2034
4496 msgid "LIBGUESTFS VERSION NUMBERS"
4497 msgstr ""
4498
4499 # type: textblock
4500 #. type: textblock
4501 #: ../src/guestfs.pod:2036
4502 msgid ""
4503 "Since April 2010, libguestfs has started to make separate development and "
4504 "stable releases, along with corresponding branches in our git repository.  "
4505 "These separate releases can be identified by version number:"
4506 msgstr ""
4507
4508 # type: verbatim
4509 #. type: verbatim
4510 #: ../src/guestfs.pod:2041
4511 #, no-wrap
4512 msgid ""
4513 "                 even numbers for stable: 1.2.x, 1.4.x, ...\n"
4514 "       .-------- odd numbers for development: 1.3.x, 1.5.x, ...\n"
4515 "       |\n"
4516 "       v\n"
4517 " 1  .  3  .  5\n"
4518 " ^           ^\n"
4519 " |           |\n"
4520 " |           `-------- sub-version\n"
4521 " |\n"
4522 " `------ always '1' because we don't change the ABI\n"
4523 "\n"
4524 msgstr ""
4525
4526 # type: textblock
4527 #. type: textblock
4528 #: ../src/guestfs.pod:2052
4529 msgid "Thus \"1.3.5\" is the 5th update to the development branch \"1.3\"."
4530 msgstr ""
4531
4532 # type: textblock
4533 #. type: textblock
4534 #: ../src/guestfs.pod:2054
4535 msgid ""
4536 "As time passes we cherry pick fixes from the development branch and backport "
4537 "those into the stable branch, the effect being that the stable branch should "
4538 "get more stable and less buggy over time.  So the stable releases are ideal "
4539 "for people who don't need new features but would just like the software to "
4540 "work."
4541 msgstr ""
4542
4543 # type: textblock
4544 #. type: textblock
4545 #: ../src/guestfs.pod:2060
4546 msgid "Our criteria for backporting changes are:"
4547 msgstr ""
4548
4549 # type: textblock
4550 #. type: textblock
4551 #: ../src/guestfs.pod:2066
4552 msgid ""
4553 "Documentation changes which don't affect any code are backported unless the "
4554 "documentation refers to a future feature which is not in stable."
4555 msgstr ""
4556
4557 # type: textblock
4558 #. type: textblock
4559 #: ../src/guestfs.pod:2072
4560 msgid ""
4561 "Bug fixes which are not controversial, fix obvious problems, and have been "
4562 "well tested are backported."
4563 msgstr ""
4564
4565 # type: textblock
4566 #. type: textblock
4567 #: ../src/guestfs.pod:2077
4568 msgid ""
4569 "Simple rearrangements of code which shouldn't affect how it works get "
4570 "backported.  This is so that the code in the two branches doesn't get too "
4571 "far out of step, allowing us to backport future fixes more easily."
4572 msgstr ""
4573
4574 # type: textblock
4575 #. type: textblock
4576 #: ../src/guestfs.pod:2083
4577 msgid ""
4578 "We I<don't> backport new features, new APIs, new tools etc, except in one "
4579 "exceptional case: the new feature is required in order to implement an "
4580 "important bug fix."
4581 msgstr ""
4582
4583 # type: textblock
4584 #. type: textblock
4585 #: ../src/guestfs.pod:2089
4586 msgid ""
4587 "A new stable branch starts when we think the new features in development are "
4588 "substantial and compelling enough over the current stable branch to warrant "
4589 "it.  When that happens we create new stable and development versions 1.N.0 "
4590 "and 1.(N+1).0 [N is even].  The new dot-oh release won't necessarily be so "
4591 "stable at this point, but by backporting fixes from development, that branch "
4592 "will stabilize over time."
4593 msgstr ""
4594
4595 #. type: =head1
4596 #: ../src/guestfs.pod:2097
4597 msgid "EXTENDING LIBGUESTFS"
4598 msgstr ""
4599
4600 #. type: =head2
4601 #: ../src/guestfs.pod:2099
4602 msgid "ADDING A NEW API ACTION"
4603 msgstr ""
4604
4605 #. type: textblock
4606 #: ../src/guestfs.pod:2101
4607 msgid ""
4608 "Large amounts of boilerplate code in libguestfs (RPC, bindings, "
4609 "documentation) are generated, and this makes it easy to extend the "
4610 "libguestfs API."
4611 msgstr ""
4612
4613 #. type: textblock
4614 #: ../src/guestfs.pod:2105
4615 msgid "To add a new API action there are two changes:"
4616 msgstr ""
4617
4618 #. type: textblock
4619 #: ../src/guestfs.pod:2111
4620 msgid ""
4621 "You need to add a description of the call (name, parameters, return type, "
4622 "tests, documentation) to C<generator/generator_actions.ml>."
4623 msgstr ""
4624
4625 #. type: textblock
4626 #: ../src/guestfs.pod:2114
4627 msgid ""
4628 "There are two sorts of API action, depending on whether the call goes "
4629 "through to the daemon in the appliance, or is serviced entirely by the "
4630 "library (see L</ARCHITECTURE> above).  L</guestfs_sync> is an example of the "
4631 "former, since the sync is done in the appliance.  L</guestfs_set_trace> is "
4632 "an example of the latter, since a trace flag is maintained in the handle and "
4633 "all tracing is done on the library side."
4634 msgstr ""
4635
4636 #. type: textblock
4637 #: ../src/guestfs.pod:2122
4638 msgid ""
4639 "Most new actions are of the first type, and get added to the "
4640 "C<daemon_functions> list.  Each function has a unique procedure number used "
4641 "in the RPC protocol which is assigned to that action when we publish "
4642 "libguestfs and cannot be reused.  Take the latest procedure number and "
4643 "increment it."
4644 msgstr ""
4645
4646 #. type: textblock
4647 #: ../src/guestfs.pod:2128
4648 msgid ""
4649 "For library-only actions of the second type, add to the "
4650 "C<non_daemon_functions> list.  Since these functions are serviced by the "
4651 "library and do not travel over the RPC mechanism to the daemon, these "
4652 "functions do not need a procedure number, and so the procedure number is set "
4653 "to C<-1>."
4654 msgstr ""
4655
4656 #. type: textblock
4657 #: ../src/guestfs.pod:2136
4658 msgid "Implement the action (in C):"
4659 msgstr ""
4660
4661 #. type: textblock
4662 #: ../src/guestfs.pod:2138
4663 msgid ""
4664 "For daemon actions, implement the function C<do_E<lt>nameE<gt>> in the "
4665 "C<daemon/> directory."
4666 msgstr ""
4667
4668 #. type: textblock
4669 #: ../src/guestfs.pod:2141
4670 msgid ""
4671 "For library actions, implement the function C<guestfs__E<lt>nameE<gt>> "
4672 "(note: double underscore) in the C<src/> directory."
4673 msgstr ""
4674
4675 #. type: textblock
4676 #: ../src/guestfs.pod:2144
4677 msgid "In either case, use another function as an example of what to do."
4678 msgstr ""
4679
4680 #. type: textblock
4681 #: ../src/guestfs.pod:2148
4682 msgid "After making these changes, use C<make> to compile."
4683 msgstr ""
4684
4685 #. type: textblock
4686 #: ../src/guestfs.pod:2150
4687 msgid ""
4688 "Note that you don't need to implement the RPC, language bindings, manual "
4689 "pages or anything else.  It's all automatically generated from the OCaml "
4690 "description."
4691 msgstr ""
4692
4693 #. type: =head2
4694 #: ../src/guestfs.pod:2154
4695 msgid "ADDING TESTS FOR AN API ACTION"
4696 msgstr ""
4697
4698 #. type: textblock
4699 #: ../src/guestfs.pod:2156
4700 msgid ""
4701 "You can supply zero or as many tests as you want per API call.  The tests "
4702 "can either be added as part of the API description (C<generator/"
4703 "generator_actions.ml>), or in some rarer cases you may want to drop a script "
4704 "into C<regressions/>.  Note that adding a script to C<regressions/> is "
4705 "slower, so if possible use the first method."
4706 msgstr ""
4707
4708 #. type: textblock
4709 #: ../src/guestfs.pod:2162
4710 msgid ""
4711 "The following describes the test environment used when you add an API test "
4712 "in C<generator_actions.ml>."
4713 msgstr ""
4714
4715 #. type: textblock
4716 #: ../src/guestfs.pod:2165
4717 msgid "The test environment has 4 block devices:"
4718 msgstr ""
4719
4720 #. type: =item
4721 #: ../src/guestfs.pod:2169
4722 msgid "C</dev/sda> 500MB"
4723 msgstr ""
4724
4725 #. type: textblock
4726 #: ../src/guestfs.pod:2171
4727 msgid "General block device for testing."
4728 msgstr ""
4729
4730 #. type: =item
4731 #: ../src/guestfs.pod:2173
4732 msgid "C</dev/sdb> 50MB"
4733 msgstr ""
4734
4735 #. type: textblock
4736 #: ../src/guestfs.pod:2175
4737 msgid ""
4738 "C</dev/sdb1> is an ext2 filesystem used for testing filesystem write "
4739 "operations."
4740 msgstr ""
4741
4742 #. type: =item
4743 #: ../src/guestfs.pod:2178
4744 msgid "C</dev/sdc> 10MB"
4745 msgstr ""
4746
4747 #. type: textblock
4748 #: ../src/guestfs.pod:2180
4749 msgid "Used in a few tests where two block devices are needed."
4750 msgstr ""
4751
4752 #. type: =item
4753 #: ../src/guestfs.pod:2182
4754 msgid "C</dev/sdd>"
4755 msgstr ""
4756
4757 #. type: textblock
4758 #: ../src/guestfs.pod:2184
4759 msgid "ISO with fixed content (see C<images/test.iso>)."
4760 msgstr ""
4761
4762 #. type: textblock
4763 #: ../src/guestfs.pod:2188
4764 msgid ""
4765 "To be able to run the tests in a reasonable amount of time, the libguestfs "
4766 "appliance and block devices are reused between tests.  So don't try testing "
4767 "L</guestfs_kill_subprocess> :-x"
4768 msgstr ""
4769
4770 #. type: textblock
4771 #: ../src/guestfs.pod:2192
4772 msgid ""
4773 "Each test starts with an initial scenario, selected using one of the "
4774 "C<Init*> expressions, described in C<generator/generator_types.ml>.  These "
4775 "initialize the disks mentioned above in a particular way as documented in "
4776 "C<generator_types.ml>.  You should not assume anything about the previous "
4777 "contents of other disks that are not initialized."
4778 msgstr ""
4779
4780 #. type: textblock
4781 #: ../src/guestfs.pod:2198
4782 msgid ""
4783 "You can add a prerequisite clause to any individual test.  This is a run-"
4784 "time check, which, if it fails, causes the test to be skipped.  Useful if "
4785 "testing a command which might not work on all variations of libguestfs "
4786 "builds.  A test that has prerequisite of C<Always> means to run "
4787 "unconditionally."
4788 msgstr ""
4789
4790 #. type: textblock
4791 #: ../src/guestfs.pod:2204
4792 msgid ""
4793 "In addition, packagers can skip individual tests by setting environment "
4794 "variables before running C<make check>."
4795 msgstr ""
4796
4797 #. type: verbatim
4798 #: ../src/guestfs.pod:2207
4799 #, no-wrap
4800 msgid ""
4801 " SKIP_TEST_<CMD>_<NUM>=1\n"
4802 "\n"
4803 msgstr ""
4804
4805 #. type: textblock
4806 #: ../src/guestfs.pod:2209
4807 msgid "eg: C<SKIP_TEST_COMMAND_3=1> skips test #3 of L</guestfs_command>."
4808 msgstr ""
4809
4810 #. type: textblock
4811 #: ../src/guestfs.pod:2211
4812 msgid "or:"
4813 msgstr ""
4814
4815 #. type: verbatim
4816 #: ../src/guestfs.pod:2213
4817 #, no-wrap
4818 msgid ""
4819 " SKIP_TEST_<CMD>=1\n"
4820 "\n"
4821 msgstr ""
4822
4823 #. type: textblock
4824 #: ../src/guestfs.pod:2215
4825 msgid "eg: C<SKIP_TEST_ZEROFREE=1> skips all L</guestfs_zerofree> tests."
4826 msgstr ""
4827
4828 #. type: textblock
4829 #: ../src/guestfs.pod:2217
4830 msgid "Packagers can run only certain tests by setting for example:"
4831 msgstr ""
4832
4833 #. type: verbatim
4834 #: ../src/guestfs.pod:2219
4835 #, no-wrap
4836 msgid ""
4837 " TEST_ONLY=\"vfs_type zerofree\"\n"
4838 "\n"
4839 msgstr ""
4840
4841 #. type: textblock
4842 #: ../src/guestfs.pod:2221
4843 msgid ""
4844 "See C<capitests/tests.c> for more details of how these environment variables "
4845 "work."
4846 msgstr ""
4847
4848 #. type: =head2
4849 #: ../src/guestfs.pod:2224
4850 msgid "DEBUGGING NEW API ACTIONS"
4851 msgstr ""
4852
4853 #. type: textblock
4854 #: ../src/guestfs.pod:2226
4855 msgid "Test new actions work before submitting them."
4856 msgstr ""
4857
4858 #. type: textblock
4859 #: ../src/guestfs.pod:2228
4860 msgid "You can use guestfish to try out new commands."
4861 msgstr ""
4862
4863 #. type: textblock
4864 #: ../src/guestfs.pod:2230
4865 msgid ""
4866 "Debugging the daemon is a problem because it runs inside a minimal "
4867 "environment.  However you can fprintf messages in the daemon to stderr, and "
4868 "they will show up if you use C<guestfish -v>."
4869 msgstr ""
4870
4871 #. type: =head2
4872 #: ../src/guestfs.pod:2234
4873 msgid "FORMATTING CODE AND OTHER CONVENTIONS"
4874 msgstr ""
4875
4876 #. type: textblock
4877 #: ../src/guestfs.pod:2236
4878 msgid ""
4879 "Our C source code generally adheres to some basic code-formatting "
4880 "conventions.  The existing code base is not totally consistent on this "
4881 "front, but we do prefer that contributed code be formatted similarly.  In "
4882 "short, use spaces-not-TABs for indentation, use 2 spaces for each "
4883 "indentation level, and other than that, follow the K&R style."
4884 msgstr ""
4885
4886 #. type: textblock
4887 #: ../src/guestfs.pod:2242
4888 msgid ""
4889 "If you use Emacs, add the following to one of one of your start-up files (e."
4890 "g., ~/.emacs), to help ensure that you get indentation right:"
4891 msgstr ""
4892
4893 #. type: verbatim
4894 #: ../src/guestfs.pod:2245
4895 #, no-wrap
4896 msgid ""
4897 " ;;; In libguestfs, indent with spaces everywhere (not TABs).\n"
4898 " ;;; Exceptions: Makefile and ChangeLog modes.\n"
4899 " (add-hook 'find-file-hook\n"
4900 "     '(lambda () (if (and buffer-file-name\n"
4901 "                          (string-match \"/libguestfs\\\\>\"\n"
4902 "                              (buffer-file-name))\n"
4903 "                          (not (string-equal mode-name \"Change Log\"))\n"
4904 "                          (not (string-equal mode-name \"Makefile\")))\n"
4905 "                     (setq indent-tabs-mode nil))))\n"
4906 " \n"
4907 msgstr ""
4908
4909 #. type: verbatim
4910 #: ../src/guestfs.pod:2255
4911 #, no-wrap
4912 msgid ""
4913 " ;;; When editing C sources in libguestfs, use this style.\n"
4914 " (defun libguestfs-c-mode ()\n"
4915 "   \"C mode with adjusted defaults for use with libguestfs.\"\n"
4916 "   (interactive)\n"
4917 "   (c-set-style \"K&R\")\n"
4918 "   (setq c-indent-level 2)\n"
4919 "   (setq c-basic-offset 2))\n"
4920 " (add-hook 'c-mode-hook\n"
4921 "           '(lambda () (if (string-match \"/libguestfs\\\\>\"\n"
4922 "                               (buffer-file-name))\n"
4923 "                           (libguestfs-c-mode))))\n"
4924 "\n"
4925 msgstr ""
4926
4927 #. type: textblock
4928 #: ../src/guestfs.pod:2267
4929 msgid "Enable warnings when compiling (and fix any problems this finds):"
4930 msgstr ""
4931
4932 #. type: verbatim
4933 #: ../src/guestfs.pod:2270
4934 #, no-wrap
4935 msgid ""
4936 " ./configure --enable-gcc-warnings\n"
4937 "\n"
4938 msgstr ""
4939
4940 #. type: textblock
4941 #: ../src/guestfs.pod:2272
4942 msgid "Useful targets are:"
4943 msgstr ""
4944
4945 #. type: verbatim
4946 #: ../src/guestfs.pod:2274
4947 #, no-wrap
4948 msgid ""
4949 " make syntax-check  # checks the syntax of the C code\n"
4950 " make check         # runs the test suite\n"
4951 "\n"
4952 msgstr ""
4953
4954 #. type: =head2
4955 #: ../src/guestfs.pod:2277
4956 msgid "DAEMON CUSTOM PRINTF FORMATTERS"
4957 msgstr ""
4958
4959 #. type: textblock
4960 #: ../src/guestfs.pod:2279
4961 msgid ""
4962 "In the daemon code we have created custom printf formatters C<%Q> and C<%R>, "
4963 "which are used to do shell quoting."
4964 msgstr ""
4965
4966 #. type: =item
4967 #: ../src/guestfs.pod:2284
4968 msgid "%Q"
4969 msgstr ""
4970
4971 #. type: textblock
4972 #: ../src/guestfs.pod:2286
4973 msgid ""
4974 "Simple shell quoted string.  Any spaces or other shell characters are "
4975 "escaped for you."
4976 msgstr ""
4977
4978 #. type: =item
4979 #: ../src/guestfs.pod:2289
4980 msgid "%R"
4981 msgstr ""
4982
4983 #. type: textblock
4984 #: ../src/guestfs.pod:2291
4985 msgid ""
4986 "Same as C<%Q> except the string is treated as a path which is prefixed by "
4987 "the sysroot."
4988 msgstr ""
4989
4990 # type: textblock
4991 #. type: textblock
4992 #: ../src/guestfs.pod:2296 ../fish/guestfish.pod:240 ../fish/guestfish.pod:594
4993 msgid "For example:"
4994 msgstr ""
4995
4996 #. type: verbatim
4997 #: ../src/guestfs.pod:2298
4998 #, no-wrap
4999 msgid ""
5000 " asprintf (&cmd, \"cat %R\", path);\n"
5001 "\n"
5002 msgstr ""
5003
5004 #. type: textblock
5005 #: ../src/guestfs.pod:2300
5006 msgid "would produce C<cat /sysroot/some\\ path\\ with\\ spaces>"
5007 msgstr ""
5008
5009 #. type: textblock
5010 #: ../src/guestfs.pod:2302
5011 msgid ""
5012 "I<Note:> Do I<not> use these when you are passing parameters to the C<command"
5013 "{,r,v,rv}()> functions.  These parameters do NOT need to be quoted because "
5014 "they are not passed via the shell (instead, straight to exec).  You probably "
5015 "want to use the C<sysroot_path()> function however."
5016 msgstr ""
5017
5018 #. type: =head2
5019 #: ../src/guestfs.pod:2308
5020 msgid "SUBMITTING YOUR NEW API ACTIONS"
5021 msgstr ""
5022
5023 #. type: textblock
5024 #: ../src/guestfs.pod:2310
5025 msgid ""
5026 "Submit patches to the mailing list: L<http://www.redhat.com/mailman/listinfo/"
5027 "libguestfs> and CC to L<rjones@redhat.com>."
5028 msgstr ""
5029
5030 #. type: =head2
5031 #: ../src/guestfs.pod:2314
5032 msgid "INTERNATIONALIZATION (I18N) SUPPORT"
5033 msgstr ""
5034
5035 #. type: textblock
5036 #: ../src/guestfs.pod:2316
5037 msgid "We support i18n (gettext anyhow) in the library."
5038 msgstr ""
5039
5040 #. type: textblock
5041 #: ../src/guestfs.pod:2318
5042 msgid ""
5043 "However many messages come from the daemon, and we don't translate those at "
5044 "the moment.  One reason is that the appliance generally has all locale files "
5045 "removed from it, because they take up a lot of space.  So we'd have to readd "
5046 "some of those, as well as copying our PO files into the appliance."
5047 msgstr ""
5048
5049 #. type: textblock
5050 #: ../src/guestfs.pod:2324
5051 msgid ""
5052 "Debugging messages are never translated, since they are intended for the "
5053 "programmers."
5054 msgstr ""
5055
5056 #. type: =head2
5057 #: ../src/guestfs.pod:2327
5058 msgid "SOURCE CODE SUBDIRECTORIES"
5059 msgstr ""
5060
5061 #. type: =item
5062 #: ../src/guestfs.pod:2331
5063 msgid "C<appliance>"
5064 msgstr ""
5065
5066 #. type: textblock
5067 #: ../src/guestfs.pod:2333
5068 msgid "The libguestfs appliance, build scripts and so on."
5069 msgstr ""
5070
5071 #. type: =item
5072 #: ../src/guestfs.pod:2335
5073 msgid "C<capitests>"
5074 msgstr ""
5075
5076 #. type: textblock
5077 #: ../src/guestfs.pod:2337
5078 msgid "Automated tests of the C API."
5079 msgstr ""
5080
5081 #. type: =item
5082 #: ../src/guestfs.pod:2339
5083 msgid "C<cat>"
5084 msgstr ""
5085
5086 #. type: textblock
5087 #: ../src/guestfs.pod:2341
5088 msgid ""
5089 "The L<virt-cat(1)>, L<virt-filesystems(1)> and L<virt-ls(1)> commands and "
5090 "documentation."
5091 msgstr ""
5092
5093 #. type: =item
5094 #: ../src/guestfs.pod:2344
5095 msgid "C<caution>"
5096 msgstr ""
5097
5098 #. type: textblock
5099 #: ../src/guestfs.pod:2346
5100 msgid ""
5101 "Safety and liveness tests of components that libguestfs depends upon (not of "
5102 "libguestfs itself).  Mainly this is for qemu and the kernel."
5103 msgstr ""
5104
5105 #. type: =item
5106 #: ../src/guestfs.pod:2349
5107 msgid "C<contrib>"
5108 msgstr ""
5109
5110 #. type: textblock
5111 #: ../src/guestfs.pod:2351
5112 msgid "Outside contributions, experimental parts."
5113 msgstr ""
5114
5115 #. type: =item
5116 #: ../src/guestfs.pod:2353
5117 msgid "C<daemon>"
5118 msgstr ""
5119
5120 #. type: textblock
5121 #: ../src/guestfs.pod:2355
5122 msgid ""
5123 "The daemon that runs inside the libguestfs appliance and carries out actions."
5124 msgstr ""
5125
5126 #. type: =item
5127 #: ../src/guestfs.pod:2358
5128 msgid "C<df>"
5129 msgstr ""
5130
5131 #. type: textblock
5132 #: ../src/guestfs.pod:2360
5133 msgid "L<virt-df(1)> command and documentation."
5134 msgstr ""
5135
5136 #. type: =item
5137 #: ../src/guestfs.pod:2362
5138 msgid "C<examples>"
5139 msgstr ""
5140
5141 #. type: textblock
5142 #: ../src/guestfs.pod:2364
5143 msgid "C API example code."
5144 msgstr ""
5145
5146 #. type: =item
5147 #: ../src/guestfs.pod:2366
5148 msgid "C<fish>"
5149 msgstr ""
5150
5151 #. type: textblock
5152 #: ../src/guestfs.pod:2368
5153 msgid "L<guestfish(1)>, the command-line shell."
5154 msgstr ""
5155
5156 #. type: =item
5157 #: ../src/guestfs.pod:2370
5158 msgid "C<fuse>"
5159 msgstr ""
5160
5161 #. type: textblock
5162 #: ../src/guestfs.pod:2372
5163 msgid ""
5164 "L<guestmount(1)>, FUSE (userspace filesystem) built on top of libguestfs."
5165 msgstr ""
5166
5167 #. type: =item
5168 #: ../src/guestfs.pod:2374
5169 msgid "C<generator>"
5170 msgstr ""
5171
5172 #. type: textblock
5173 #: ../src/guestfs.pod:2376
5174 msgid ""
5175 "The crucially important generator, used to automatically generate large "
5176 "amounts of boilerplate C code for things like RPC and bindings."
5177 msgstr ""
5178
5179 #. type: =item
5180 #: ../src/guestfs.pod:2379
5181 msgid "C<images>"
5182 msgstr ""
5183
5184 #. type: textblock
5185 #: ../src/guestfs.pod:2381
5186 msgid "Files used by the test suite."
5187 msgstr ""
5188
5189 #. type: textblock
5190 #: ../src/guestfs.pod:2383
5191 msgid "Some \"phony\" guest images which we test against."
5192 msgstr ""
5193
5194 #. type: =item
5195 #: ../src/guestfs.pod:2385
5196 msgid "C<inspector>"
5197 msgstr ""
5198
5199 #. type: textblock
5200 #: ../src/guestfs.pod:2387
5201 msgid "L<virt-inspector(1)>, the virtual machine image inspector."
5202 msgstr ""
5203
5204 #. type: =item
5205 #: ../src/guestfs.pod:2389
5206 msgid "C<m4>"
5207 msgstr ""
5208
5209 #. type: textblock
5210 #: ../src/guestfs.pod:2391
5211 msgid "M4 macros used by autoconf."
5212 msgstr ""
5213
5214 #. type: =item
5215 #: ../src/guestfs.pod:2393
5216 msgid "C<po>"
5217 msgstr ""
5218
5219 #. type: textblock
5220 #: ../src/guestfs.pod:2395
5221 msgid "Translations of simple gettext strings."
5222 msgstr ""
5223
5224 #. type: =item
5225 #: ../src/guestfs.pod:2397
5226 msgid "C<po-docs>"
5227 msgstr ""
5228
5229 #. type: textblock
5230 #: ../src/guestfs.pod:2399
5231 msgid ""
5232 "The build infrastructure and PO files for translations of manpages and POD "
5233 "files.  Eventually this will be combined with the C<po> directory, but that "
5234 "is rather complicated."
5235 msgstr ""
5236
5237 #. type: =item
5238 #: ../src/guestfs.pod:2403
5239 msgid "C<regressions>"
5240 msgstr ""
5241
5242 #. type: textblock
5243 #: ../src/guestfs.pod:2405
5244 msgid "Regression tests."
5245 msgstr ""
5246
5247 #. type: =item
5248 #: ../src/guestfs.pod:2407
5249 msgid "C<rescue>"
5250 msgstr ""
5251
5252 #. type: textblock
5253 #: ../src/guestfs.pod:2409
5254 msgid "L<virt-rescue(1)> command and documentation."
5255 msgstr ""
5256
5257 #. type: =item
5258 #: ../src/guestfs.pod:2411
5259 msgid "C<src>"
5260 msgstr ""
5261
5262 #. type: textblock
5263 #: ../src/guestfs.pod:2413
5264 msgid "Source code to the C library."
5265 msgstr ""
5266
5267 #. type: =item
5268 #: ../src/guestfs.pod:2415
5269 msgid "C<tools>"
5270 msgstr ""
5271
5272 #. type: textblock
5273 #: ../src/guestfs.pod:2417
5274 msgid "Command line tools written in Perl (L<virt-resize(1)> and many others)."
5275 msgstr ""
5276
5277 #. type: =item
5278 #: ../src/guestfs.pod:2419
5279 msgid "C<test-tool>"
5280 msgstr ""
5281
5282 #. type: textblock
5283 #: ../src/guestfs.pod:2421
5284 msgid ""
5285 "Test tool for end users to test if their qemu/kernel combination will work "
5286 "with libguestfs."
5287 msgstr ""
5288
5289 #. type: =item
5290 #: ../src/guestfs.pod:2424
5291 msgid "C<csharp>"
5292 msgstr ""
5293
5294 #. type: =item
5295 #: ../src/guestfs.pod:2426
5296 msgid "C<haskell>"
5297 msgstr ""
5298
5299 #. type: =item
5300 #: ../src/guestfs.pod:2428
5301 msgid "C<java>"
5302 msgstr ""
5303
5304 #. type: =item
5305 #: ../src/guestfs.pod:2430
5306 msgid "C<ocaml>"
5307 msgstr ""
5308
5309 #. type: =item
5310 #: ../src/guestfs.pod:2432
5311 msgid "C<php>"
5312 msgstr ""
5313
5314 #. type: =item
5315 #: ../src/guestfs.pod:2434
5316 msgid "C<perl>"
5317 msgstr ""
5318
5319 #. type: =item
5320 #: ../src/guestfs.pod:2436
5321 msgid "C<python>"
5322 msgstr ""
5323
5324 #. type: =item
5325 #: ../src/guestfs.pod:2438
5326 msgid "C<ruby>"
5327 msgstr ""
5328
5329 #. type: textblock
5330 #: ../src/guestfs.pod:2440
5331 msgid "Language bindings."
5332 msgstr ""
5333
5334 # type: =head1
5335 #. type: =head1
5336 #: ../src/guestfs.pod:2444 ../fish/guestfish.pod:976
5337 #: ../test-tool/libguestfs-test-tool.pod:104 ../tools/virt-edit.pl:375
5338 msgid "ENVIRONMENT VARIABLES"
5339 msgstr ""
5340
5341 # type: =item
5342 #. type: =item
5343 #: ../src/guestfs.pod:2448 ../fish/guestfish.pod:1002
5344 msgid "LIBGUESTFS_APPEND"
5345 msgstr ""
5346
5347 # type: textblock
5348 #. type: textblock
5349 #: ../src/guestfs.pod:2450 ../fish/guestfish.pod:1004
5350 msgid "Pass additional options to the guest kernel."
5351 msgstr ""
5352
5353 # type: =item
5354 #. type: =item
5355 #: ../src/guestfs.pod:2452 ../fish/guestfish.pod:1006
5356 msgid "LIBGUESTFS_DEBUG"
5357 msgstr ""
5358
5359 # type: textblock
5360 #. type: textblock
5361 #: ../src/guestfs.pod:2454
5362 msgid ""
5363 "Set C<LIBGUESTFS_DEBUG=1> to enable verbose messages.  This has the same "
5364 "effect as calling C<guestfs_set_verbose (g, 1)>."
5365 msgstr ""
5366
5367 # type: =item
5368 #. type: =item
5369 #: ../src/guestfs.pod:2457 ../fish/guestfish.pod:1011
5370 msgid "LIBGUESTFS_MEMSIZE"
5371 msgstr ""
5372
5373 # type: textblock
5374 #. type: textblock
5375 #: ../src/guestfs.pod:2459 ../fish/guestfish.pod:1013
5376 msgid ""
5377 "Set the memory allocated to the qemu process, in megabytes.  For example:"
5378 msgstr ""
5379
5380 # type: verbatim
5381 #. type: verbatim
5382 #: ../src/guestfs.pod:2462 ../fish/guestfish.pod:1016
5383 #, no-wrap
5384 msgid ""
5385 " LIBGUESTFS_MEMSIZE=700\n"
5386 "\n"
5387 msgstr ""
5388
5389 # type: =item
5390 #. type: =item
5391 #: ../src/guestfs.pod:2464 ../fish/guestfish.pod:1018
5392 msgid "LIBGUESTFS_PATH"
5393 msgstr ""
5394
5395 #. type: textblock
5396 #: ../src/guestfs.pod:2466
5397 msgid ""
5398 "Set the path that libguestfs uses to search for a supermin appliance.  See "
5399 "the discussion of paths in section L</PATH> above."
5400 msgstr ""
5401
5402 # type: =item
5403 #. type: =item
5404 #: ../src/guestfs.pod:2469 ../fish/guestfish.pod:1023
5405 msgid "LIBGUESTFS_QEMU"
5406 msgstr ""
5407
5408 # type: textblock
5409 #. type: textblock
5410 #: ../src/guestfs.pod:2471 ../fish/guestfish.pod:1025
5411 msgid ""
5412 "Set the default qemu binary that libguestfs uses.  If not set, then the qemu "
5413 "which was found at compile time by the configure script is used."
5414 msgstr ""
5415
5416 # type: textblock
5417 #. type: textblock
5418 #: ../src/guestfs.pod:2475
5419 msgid "See also L</QEMU WRAPPERS> above."
5420 msgstr ""
5421
5422 # type: =item
5423 #. type: =item
5424 #: ../src/guestfs.pod:2477 ../fish/guestfish.pod:1029
5425 msgid "LIBGUESTFS_TRACE"
5426 msgstr ""
5427
5428 # type: textblock
5429 #. type: textblock
5430 #: ../src/guestfs.pod:2479
5431 msgid ""
5432 "Set C<LIBGUESTFS_TRACE=1> to enable command traces.  This has the same "
5433 "effect as calling C<guestfs_set_trace (g, 1)>."
5434 msgstr ""
5435
5436 # type: =item
5437 #. type: =item
5438 #: ../src/guestfs.pod:2482 ../fish/guestfish.pod:1038
5439 msgid "TMPDIR"
5440 msgstr ""
5441
5442 # type: textblock
5443 #. type: textblock
5444 #: ../src/guestfs.pod:2484 ../fish/guestfish.pod:1040
5445 msgid "Location of temporary directory, defaults to C</tmp>."
5446 msgstr ""
5447
5448 # type: textblock
5449 #. type: textblock
5450 #: ../src/guestfs.pod:2486 ../fish/guestfish.pod:1042
5451 msgid ""
5452 "If libguestfs was compiled to use the supermin appliance then the real "
5453 "appliance is cached in this directory, shared between all handles belonging "
5454 "to the same EUID.  You can use C<$TMPDIR> to configure another directory to "
5455 "use in case C</tmp> is not large enough."
5456 msgstr ""
5457
5458 # type: =head1
5459 #. type: =head1
5460 #: ../src/guestfs.pod:2494 ../fish/guestfish.pod:1100
5461 #: ../test-tool/libguestfs-test-tool.pod:109 ../fuse/guestmount.pod:233
5462 #: ../tools/virt-edit.pl:395 ../tools/virt-win-reg.pl:572
5463 #: ../tools/virt-resize.pl:1483 ../tools/virt-list-filesystems.pl:189
5464 #: ../tools/virt-tar.pl:281 ../tools/virt-make-fs.pl:539
5465 #: ../tools/virt-list-partitions.pl:257
5466 msgid "SEE ALSO"
5467 msgstr ""
5468
5469 # type: textblock
5470 #. type: textblock
5471 #: ../src/guestfs.pod:2496
5472 msgid ""
5473 "L<guestfs-examples(3)>, L<guestfs-ocaml(3)>, L<guestfs-python(3)>, L<guestfs-"
5474 "ruby(3)>, L<guestfish(1)>, L<guestmount(1)>, L<virt-cat(1)>, L<virt-df(1)>, "
5475 "L<virt-edit(1)>, L<virt-filesystems(1)>, L<virt-inspector(1)>, L<virt-list-"
5476 "filesystems(1)>, L<virt-list-partitions(1)>, L<virt-ls(1)>, L<virt-make-fs(1)"
5477 ">, L<virt-rescue(1)>, L<virt-tar(1)>, L<virt-win-reg(1)>, L<qemu(1)>, "
5478 "L<febootstrap(1)>, L<hivex(3)>, L<http://libguestfs.org/>."
5479 msgstr ""
5480
5481 # type: textblock
5482 #. type: textblock
5483 #: ../src/guestfs.pod:2519
5484 msgid ""
5485 "Tools with a similar purpose: L<fdisk(8)>, L<parted(8)>, L<kpartx(8)>, L<lvm"
5486 "(8)>, L<disktype(1)>."
5487 msgstr ""
5488
5489 # type: =head1
5490 #. type: =head1
5491 #: ../src/guestfs.pod:2526 ../tools/virt-win-reg.pl:587
5492 #: ../tools/virt-make-fs.pl:553
5493 msgid "BUGS"
5494 msgstr ""
5495
5496 # type: textblock
5497 #. type: textblock
5498 #: ../src/guestfs.pod:2528
5499 msgid "To get a list of bugs against libguestfs use this link:"
5500 msgstr ""
5501
5502 # type: textblock
5503 #. type: textblock
5504 #: ../src/guestfs.pod:2530
5505 msgid ""
5506 "L<https://bugzilla.redhat.com/buglist.cgi?"
5507 "component=libguestfs&product=Virtualization+Tools>"
5508 msgstr ""
5509
5510 # type: textblock
5511 #. type: textblock
5512 #: ../src/guestfs.pod:2532
5513 msgid "To report a new bug against libguestfs use this link:"
5514 msgstr ""
5515
5516 # type: textblock
5517 #. type: textblock
5518 #: ../src/guestfs.pod:2534
5519 msgid ""
5520 "L<https://bugzilla.redhat.com/enter_bug.cgi?"
5521 "component=libguestfs&product=Virtualization+Tools>"
5522 msgstr ""
5523
5524 # type: textblock
5525 #. type: textblock
5526 #: ../src/guestfs.pod:2536
5527 msgid "When reporting a bug, please check:"
5528 msgstr ""
5529
5530 # type: textblock
5531 #. type: textblock
5532 #: ../src/guestfs.pod:2542
5533 msgid "That the bug hasn't been reported already."
5534 msgstr ""
5535
5536 # type: textblock
5537 #. type: textblock
5538 #: ../src/guestfs.pod:2546
5539 msgid "That you are testing a recent version."
5540 msgstr ""
5541
5542 # type: textblock
5543 #. type: textblock
5544 #: ../src/guestfs.pod:2550
5545 msgid "Describe the bug accurately, and give a way to reproduce it."
5546 msgstr ""
5547
5548 # type: textblock
5549 #. type: textblock
5550 #: ../src/guestfs.pod:2554
5551 msgid ""
5552 "Run libguestfs-test-tool and paste the B<complete, unedited> output into the "
5553 "bug report."
5554 msgstr ""
5555
5556 # type: =head1
5557 #. type: =head1
5558 #: ../src/guestfs.pod:2559 ../fish/guestfish.pod:1119
5559 #: ../test-tool/libguestfs-test-tool.pod:115 ../fuse/guestmount.pod:244
5560 msgid "AUTHORS"
5561 msgstr ""
5562
5563 # type: textblock
5564 #. type: textblock
5565 #: ../src/guestfs.pod:2561 ../fish/guestfish.pod:1121
5566 #: ../test-tool/libguestfs-test-tool.pod:117 ../fuse/guestmount.pod:246
5567 msgid "Richard W.M. Jones (C<rjones at redhat dot com>)"
5568 msgstr ""
5569
5570 # type: =head1
5571 #. type: =head1
5572 #: ../src/guestfs.pod:2563 ../fish/guestfish.pod:1123
5573 #: ../test-tool/libguestfs-test-tool.pod:119 ../fuse/guestmount.pod:248
5574 #: ../tools/virt-edit.pl:411 ../tools/virt-win-reg.pl:602
5575 #: ../tools/virt-resize.pl:1508 ../tools/virt-list-filesystems.pl:206
5576 #: ../tools/virt-tar.pl:296 ../tools/virt-make-fs.pl:568
5577 #: ../tools/virt-list-partitions.pl:273
5578 msgid "COPYRIGHT"
5579 msgstr ""
5580
5581 # type: textblock
5582 #. type: textblock
5583 #: ../src/guestfs.pod:2565 ../fish/guestfish.pod:1125
5584 #: ../fuse/guestmount.pod:250
5585 msgid "Copyright (C) 2009-2010 Red Hat Inc.  L<http://libguestfs.org/>"
5586 msgstr ""
5587
5588 # type: textblock
5589 #. type: textblock
5590 #: ../src/guestfs.pod:2568
5591 msgid ""
5592 "This library is free software; you can redistribute it and/or modify it "
5593 "under the terms of the GNU Lesser General Public License as published by the "
5594 "Free Software Foundation; either version 2 of the License, or (at your "
5595 "option) any later version."
5596 msgstr ""
5597
5598 # type: textblock
5599 #. type: textblock
5600 #: ../src/guestfs.pod:2573
5601 msgid ""
5602 "This library is distributed in the hope that it will be useful, but WITHOUT "
5603 "ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or "
5604 "FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public License "
5605 "for more details."
5606 msgstr ""
5607
5608 # type: textblock
5609 #. type: textblock
5610 #: ../src/guestfs.pod:2578
5611 msgid ""
5612 "You should have received a copy of the GNU Lesser General Public License "
5613 "along with this library; if not, write to the Free Software Foundation, "
5614 "Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA"
5615 msgstr ""
5616
5617 # type: =head2
5618 #. type: =head2
5619 #: ../src/guestfs-actions.pod:1
5620 msgid "guestfs_add_cdrom"
5621 msgstr ""
5622
5623 # type: verbatim
5624 #. type: verbatim
5625 #: ../src/guestfs-actions.pod:3
5626 #, no-wrap
5627 msgid ""
5628 " int\n"
5629 " guestfs_add_cdrom (guestfs_h *g,\n"
5630 "                    const char *filename);\n"
5631 "\n"
5632 msgstr ""
5633
5634 # type: textblock
5635 #. type: textblock
5636 #: ../src/guestfs-actions.pod:7 ../fish/guestfish-actions.pod:5
5637 msgid "This function adds a virtual CD-ROM disk image to the guest."
5638 msgstr ""
5639
5640 # type: textblock
5641 #. type: textblock
5642 #: ../src/guestfs-actions.pod:9 ../fish/guestfish-actions.pod:7
5643 msgid "This is equivalent to the qemu parameter C<-cdrom filename>."
5644 msgstr ""
5645
5646 # type: textblock
5647 #. type: textblock
5648 #: ../src/guestfs-actions.pod:17
5649 msgid ""
5650 "This call checks for the existence of C<filename>.  This stops you from "
5651 "specifying other types of drive which are supported by qemu such as C<nbd:> "
5652 "and C<http:> URLs.  To specify those, use the general C<guestfs_config> call "
5653 "instead."
5654 msgstr ""
5655
5656 # type: textblock
5657 #. type: textblock
5658 #: ../src/guestfs-actions.pod:24
5659 msgid ""
5660 "If you just want to add an ISO file (often you use this as an efficient way "
5661 "to transfer large files into the guest), then you should probably use "
5662 "C<guestfs_add_drive_ro> instead."
5663 msgstr ""
5664
5665 # type: textblock
5666 #. type: textblock
5667 #: ../src/guestfs-actions.pod:30 ../src/guestfs-actions.pod:126
5668 #: ../src/guestfs-actions.pod:187 ../src/guestfs-actions.pod:224
5669 #: ../src/guestfs-actions.pod:238 ../src/guestfs-actions.pod:259
5670 #: ../src/guestfs-actions.pod:279 ../src/guestfs-actions.pod:293
5671 #: ../src/guestfs-actions.pod:413 ../src/guestfs-actions.pod:433
5672 #: ../src/guestfs-actions.pod:447 ../src/guestfs-actions.pod:492
5673 #: ../src/guestfs-actions.pod:520 ../src/guestfs-actions.pod:538
5674 #: ../src/guestfs-actions.pod:605 ../src/guestfs-actions.pod:638
5675 #: ../src/guestfs-actions.pod:652 ../src/guestfs-actions.pod:667
5676 #: ../src/guestfs-actions.pod:766 ../src/guestfs-actions.pod:784
5677 #: ../src/guestfs-actions.pod:798 ../src/guestfs-actions.pod:812
5678 #: ../src/guestfs-actions.pod:973 ../src/guestfs-actions.pod:993
5679 #: ../src/guestfs-actions.pod:1011 ../src/guestfs-actions.pod:1095
5680 #: ../src/guestfs-actions.pod:1113 ../src/guestfs-actions.pod:1132
5681 #: ../src/guestfs-actions.pod:1146 ../src/guestfs-actions.pod:1166
5682 #: ../src/guestfs-actions.pod:1236 ../src/guestfs-actions.pod:1267
5683 #: ../src/guestfs-actions.pod:1292 ../src/guestfs-actions.pod:1329
5684 #: ../src/guestfs-actions.pod:1435 ../src/guestfs-actions.pod:1469
5685 #: ../src/guestfs-actions.pod:1684 ../src/guestfs-actions.pod:1706
5686 #: ../src/guestfs-actions.pod:1793 ../src/guestfs-actions.pod:2267
5687 #: ../src/guestfs-actions.pod:2411 ../src/guestfs-actions.pod:2472
5688 #: ../src/guestfs-actions.pod:2507 ../src/guestfs-actions.pod:3250
5689 #: ../src/guestfs-actions.pod:3265 ../src/guestfs-actions.pod:3285
5690 #: ../src/guestfs-actions.pod:3440 ../src/guestfs-actions.pod:3454
5691 #: ../src/guestfs-actions.pod:3467 ../src/guestfs-actions.pod:3481
5692 #: ../src/guestfs-actions.pod:3496 ../src/guestfs-actions.pod:3532
5693 #: ../src/guestfs-actions.pod:3604 ../src/guestfs-actions.pod:3624
5694 #: ../src/guestfs-actions.pod:3641 ../src/guestfs-actions.pod:3664
5695 #: ../src/guestfs-actions.pod:3687 ../src/guestfs-actions.pod:3719
5696 #: ../src/guestfs-actions.pod:3738 ../src/guestfs-actions.pod:3757
5697 #: ../src/guestfs-actions.pod:3792 ../src/guestfs-actions.pod:3804
5698 #: ../src/guestfs-actions.pod:3840 ../src/guestfs-actions.pod:3856
5699 #: ../src/guestfs-actions.pod:3869 ../src/guestfs-actions.pod:3884
5700 #: ../src/guestfs-actions.pod:3901 ../src/guestfs-actions.pod:3994
5701 #: ../src/guestfs-actions.pod:4014 ../src/guestfs-actions.pod:4027
5702 #: ../src/guestfs-actions.pod:4078 ../src/guestfs-actions.pod:4096
5703 #: ../src/guestfs-actions.pod:4114 ../src/guestfs-actions.pod:4130
5704 #: ../src/guestfs-actions.pod:4144 ../src/guestfs-actions.pod:4158
5705 #: ../src/guestfs-actions.pod:4175 ../src/guestfs-actions.pod:4190
5706 #: ../src/guestfs-actions.pod:4210 ../src/guestfs-actions.pod:4256
5707 #: ../src/guestfs-actions.pod:4329 ../src/guestfs-actions.pod:4360
5708 #: ../src/guestfs-actions.pod:4379 ../src/guestfs-actions.pod:4398
5709 #: ../src/guestfs-actions.pod:4410 ../src/guestfs-actions.pod:4427
5710 #: ../src/guestfs-actions.pod:4440 ../src/guestfs-actions.pod:4455
5711 #: ../src/guestfs-actions.pod:4470 ../src/guestfs-actions.pod:4505
5712 #: ../src/guestfs-actions.pod:4520 ../src/guestfs-actions.pod:4540
5713 #: ../src/guestfs-actions.pod:4554 ../src/guestfs-actions.pod:4571
5714 #: ../src/guestfs-actions.pod:4620 ../src/guestfs-actions.pod:4666
5715 #: ../src/guestfs-actions.pod:4680 ../src/guestfs-actions.pod:4708
5716 #: ../src/guestfs-actions.pod:4725 ../src/guestfs-actions.pod:4743
5717 #: ../src/guestfs-actions.pod:4877 ../src/guestfs-actions.pod:4934
5718 #: ../src/guestfs-actions.pod:4956 ../src/guestfs-actions.pod:4974
5719 #: ../src/guestfs-actions.pod:5006 ../src/guestfs-actions.pod:5072
5720 #: ../src/guestfs-actions.pod:5089 ../src/guestfs-actions.pod:5102
5721 #: ../src/guestfs-actions.pod:5116 ../src/guestfs-actions.pod:5405
5722 #: ../src/guestfs-actions.pod:5424 ../src/guestfs-actions.pod:5438
5723 #: ../src/guestfs-actions.pod:5450 ../src/guestfs-actions.pod:5464
5724 #: ../src/guestfs-actions.pod:5476 ../src/guestfs-actions.pod:5490
5725 #: ../src/guestfs-actions.pod:5506 ../src/guestfs-actions.pod:5527
5726 #: ../src/guestfs-actions.pod:5546 ../src/guestfs-actions.pod:5565
5727 #: ../src/guestfs-actions.pod:5583 ../src/guestfs-actions.pod:5606
5728 #: ../src/guestfs-actions.pod:5624 ../src/guestfs-actions.pod:5643
5729 #: ../src/guestfs-actions.pod:5664 ../src/guestfs-actions.pod:5683
5730 #: ../src/guestfs-actions.pod:5700 ../src/guestfs-actions.pod:5728
5731 #: ../src/guestfs-actions.pod:5752 ../src/guestfs-actions.pod:5771
5732 #: ../src/guestfs-actions.pod:5795 ../src/guestfs-actions.pod:5810
5733 #: ../src/guestfs-actions.pod:5825 ../src/guestfs-actions.pod:5844
5734 #: ../src/guestfs-actions.pod:5881 ../src/guestfs-actions.pod:5904
5735 #: ../src/guestfs-actions.pod:5930 ../src/guestfs-actions.pod:6038
5736 #: ../src/guestfs-actions.pod:6159 ../src/guestfs-actions.pod:6171
5737 #: ../src/guestfs-actions.pod:6184 ../src/guestfs-actions.pod:6197
5738 #: ../src/guestfs-actions.pod:6219 ../src/guestfs-actions.pod:6232
5739 #: ../src/guestfs-actions.pod:6245 ../src/guestfs-actions.pod:6258
5740 #: ../src/guestfs-actions.pod:6273 ../src/guestfs-actions.pod:6332
5741 #: ../src/guestfs-actions.pod:6349 ../src/guestfs-actions.pod:6365
5742 #: ../src/guestfs-actions.pod:6381 ../src/guestfs-actions.pod:6398
5743 #: ../src/guestfs-actions.pod:6411 ../src/guestfs-actions.pod:6431
5744 #: ../src/guestfs-actions.pod:6467 ../src/guestfs-actions.pod:6481
5745 #: ../src/guestfs-actions.pod:6522 ../src/guestfs-actions.pod:6535
5746 #: ../src/guestfs-actions.pod:6553 ../src/guestfs-actions.pod:6587
5747 #: ../src/guestfs-actions.pod:6623 ../src/guestfs-actions.pod:6742
5748 #: ../src/guestfs-actions.pod:6760 ../src/guestfs-actions.pod:6774
5749 #: ../src/guestfs-actions.pod:6829 ../src/guestfs-actions.pod:6842
5750 #: ../src/guestfs-actions.pod:6887 ../src/guestfs-actions.pod:6920
5751 #: ../src/guestfs-actions.pod:6974 ../src/guestfs-actions.pod:7000
5752 #: ../src/guestfs-actions.pod:7066 ../src/guestfs-actions.pod:7085
5753 #: ../src/guestfs-actions.pod:7114
5754 msgid "This function returns 0 on success or -1 on error."
5755 msgstr ""
5756
5757 #. type: textblock
5758 #: ../src/guestfs-actions.pod:32 ../src/guestfs-actions.pod:240
5759 #: ../src/guestfs-actions.pod:261
5760 msgid ""
5761 "This function is deprecated.  In new code, use the L</"
5762 "guestfs_add_drive_opts> call instead."
5763 msgstr ""
5764
5765 # type: textblock
5766 #. type: textblock
5767 #: ../src/guestfs-actions.pod:35 ../src/guestfs-actions.pod:243
5768 #: ../src/guestfs-actions.pod:264 ../src/guestfs-actions.pod:1440
5769 #: ../src/guestfs-actions.pod:1923 ../src/guestfs-actions.pod:1944
5770 #: ../src/guestfs-actions.pod:4215 ../src/guestfs-actions.pod:7008
5771 #: ../src/guestfs-actions.pod:7177 ../fish/guestfish-actions.pod:31
5772 #: ../fish/guestfish-actions.pod:154 ../fish/guestfish-actions.pod:168
5773 #: ../fish/guestfish-actions.pod:954 ../fish/guestfish-actions.pod:1308
5774 #: ../fish/guestfish-actions.pod:1322 ../fish/guestfish-actions.pod:2844
5775 #: ../fish/guestfish-actions.pod:4657 ../fish/guestfish-actions.pod:4754
5776 msgid ""
5777 "Deprecated functions will not be removed from the API, but the fact that "
5778 "they are deprecated indicates that there are problems with correct use of "
5779 "these functions."
5780 msgstr ""
5781
5782 # type: textblock
5783 #. type: textblock
5784 #: ../src/guestfs-actions.pod:39 ../src/guestfs-actions.pod:128
5785 #: ../src/guestfs-actions.pod:1097 ../src/guestfs-actions.pod:1895
5786 #: ../src/guestfs-actions.pod:1993 ../src/guestfs-actions.pod:2096
5787 #: ../src/guestfs-actions.pod:3252 ../src/guestfs-actions.pod:3267
5788 #: ../src/guestfs-actions.pod:4507 ../src/guestfs-actions.pod:5585
5789 #: ../src/guestfs-actions.pod:5702 ../src/guestfs-actions.pod:5812
5790 #: ../src/guestfs-actions.pod:6275 ../src/guestfs-actions.pod:6400
5791 #: ../src/guestfs-actions.pod:6922
5792 msgid "(Added in 0.3)"
5793 msgstr ""
5794
5795 # type: =head2
5796 #. type: =head2
5797 #: ../src/guestfs-actions.pod:41
5798 msgid "guestfs_add_domain"
5799 msgstr ""
5800
5801 # type: verbatim
5802 #. type: verbatim
5803 #: ../src/guestfs-actions.pod:43
5804 #, no-wrap
5805 msgid ""
5806 " int\n"
5807 " guestfs_add_domain (guestfs_h *g,\n"
5808 "                     const char *dom,\n"
5809 "                     ...);\n"
5810 "\n"
5811 msgstr ""
5812
5813 # type: textblock
5814 #. type: textblock
5815 #: ../src/guestfs-actions.pod:48 ../src/guestfs-actions.pod:137
5816 #: ../src/guestfs-actions.pod:4229
5817 msgid ""
5818 "You may supply a list of optional arguments to this call.  Use zero or more "
5819 "of the following pairs of parameters, and terminate the list with C<-1> on "
5820 "its own.  See L</CALLS WITH OPTIONAL ARGUMENTS>."
5821 msgstr ""
5822
5823 # type: verbatim
5824 #. type: verbatim
5825 #: ../src/guestfs-actions.pod:53
5826 #, no-wrap
5827 msgid ""
5828 " GUESTFS_ADD_DOMAIN_LIBVIRTURI, const char *libvirturi,\n"
5829 " GUESTFS_ADD_DOMAIN_READONLY, int readonly,\n"
5830 " GUESTFS_ADD_DOMAIN_IFACE, const char *iface,\n"
5831 "\n"
5832 msgstr ""
5833
5834 # type: textblock
5835 #. type: textblock
5836 #: ../src/guestfs-actions.pod:57
5837 msgid ""
5838 "This function adds the disk(s) attached to the named libvirt domain C<dom>.  "
5839 "It works by connecting to libvirt, requesting the domain and domain XML from "
5840 "libvirt, parsing it for disks, and calling C<guestfs_add_drive_opts> on each "
5841 "one."
5842 msgstr ""
5843
5844 # type: textblock
5845 #. type: textblock
5846 #: ../src/guestfs-actions.pod:62 ../fish/guestfish-actions.pod:46
5847 msgid ""
5848 "The number of disks added is returned.  This operation is atomic: if an "
5849 "error is returned, then no disks are added."
5850 msgstr ""
5851
5852 # type: textblock
5853 #. type: textblock
5854 #: ../src/guestfs-actions.pod:65 ../fish/guestfish-actions.pod:49
5855 msgid ""
5856 "This function does some minimal checks to make sure the libvirt domain is "
5857 "not running (unless C<readonly> is true).  In a future version we will try "
5858 "to acquire the libvirt lock on each disk."
5859 msgstr ""
5860
5861 # type: textblock
5862 #. type: textblock
5863 #: ../src/guestfs-actions.pod:69 ../fish/guestfish-actions.pod:53
5864 msgid ""
5865 "Disks must be accessible locally.  This often means that adding disks from a "
5866 "remote libvirt connection (see L<http://libvirt.org/remote.html>)  will fail "
5867 "unless those disks are accessible via the same device path locally too."
5868 msgstr ""
5869
5870 #. type: textblock
5871 #: ../src/guestfs-actions.pod:74 ../fish/guestfish-actions.pod:58
5872 msgid ""
5873 "The optional C<libvirturi> parameter sets the libvirt URI (see L<http://"
5874 "libvirt.org/uri.html>).  If this is not set then we connect to the default "
5875 "libvirt URI (or one set through an environment variable, see the libvirt "
5876 "documentation for full details)."
5877 msgstr ""
5878
5879 # type: textblock
5880 #. type: textblock
5881 #: ../src/guestfs-actions.pod:80
5882 msgid ""
5883 "The other optional parameters are passed directly through to "
5884 "C<guestfs_add_drive_opts>."
5885 msgstr ""
5886
5887 # type: textblock
5888 #. type: textblock
5889 #: ../src/guestfs-actions.pod:83 ../src/guestfs-actions.pod:336
5890 #: ../src/guestfs-actions.pod:506 ../src/guestfs-actions.pod:684
5891 #: ../src/guestfs-actions.pod:715 ../src/guestfs-actions.pod:733
5892 #: ../src/guestfs-actions.pod:752 ../src/guestfs-actions.pod:1312
5893 #: ../src/guestfs-actions.pod:1663 ../src/guestfs-actions.pod:1866
5894 #: ../src/guestfs-actions.pod:1965 ../src/guestfs-actions.pod:2005
5895 #: ../src/guestfs-actions.pod:2060 ../src/guestfs-actions.pod:2083
5896 #: ../src/guestfs-actions.pod:2398 ../src/guestfs-actions.pod:2686
5897 #: ../src/guestfs-actions.pod:2707 ../src/guestfs-actions.pod:4643
5898 #: ../src/guestfs-actions.pod:4780 ../src/guestfs-actions.pod:5186
5899 #: ../src/guestfs-actions.pod:5212 ../src/guestfs-actions.pod:6508
5900 #: ../src/guestfs-actions.pod:6933 ../src/guestfs-actions.pod:6946
5901 #: ../src/guestfs-actions.pod:6959
5902 msgid "On error this function returns -1."
5903 msgstr ""
5904
5905 # type: textblock
5906 #. type: textblock
5907 #: ../src/guestfs-actions.pod:85
5908 msgid "(Added in 1.7.4)"
5909 msgstr ""
5910
5911 # type: =head2
5912 #. type: =head2
5913 #: ../src/guestfs-actions.pod:87
5914 msgid "guestfs_add_domain_va"
5915 msgstr ""
5916
5917 # type: verbatim
5918 #. type: verbatim
5919 #: ../src/guestfs-actions.pod:89
5920 #, no-wrap
5921 msgid ""
5922 " int\n"
5923 " guestfs_add_domain_va (guestfs_h *g,\n"
5924 "                        const char *dom,\n"
5925 "                        va_list args);\n"
5926 "\n"
5927 msgstr ""
5928
5929 # type: textblock
5930 #. type: textblock
5931 #: ../src/guestfs-actions.pod:94
5932 msgid "This is the \"va_list variant\" of L</guestfs_add_domain>."
5933 msgstr ""
5934
5935 # type: textblock
5936 #. type: textblock
5937 #: ../src/guestfs-actions.pod:96 ../src/guestfs-actions.pod:107
5938 #: ../src/guestfs-actions.pod:200 ../src/guestfs-actions.pod:211
5939 #: ../src/guestfs-actions.pod:4270 ../src/guestfs-actions.pod:4282
5940 msgid "See L</CALLS WITH OPTIONAL ARGUMENTS>."
5941 msgstr ""
5942
5943 # type: =head2
5944 #. type: =head2
5945 #: ../src/guestfs-actions.pod:98
5946 msgid "guestfs_add_domain_argv"
5947 msgstr ""
5948
5949 # type: verbatim
5950 #. type: verbatim
5951 #: ../src/guestfs-actions.pod:100
5952 #, no-wrap
5953 msgid ""
5954 " int\n"
5955 " guestfs_add_domain_argv (guestfs_h *g,\n"
5956 "                          const char *dom,\n"
5957 "                          const struct guestfs_add_domain_argv *optargs);\n"
5958 "\n"
5959 msgstr ""
5960
5961 # type: textblock
5962 #. type: textblock
5963 #: ../src/guestfs-actions.pod:105
5964 msgid "This is the \"argv variant\" of L</guestfs_add_domain>."
5965 msgstr ""
5966
5967 # type: =head2
5968 #. type: =head2
5969 #: ../src/guestfs-actions.pod:109
5970 msgid "guestfs_add_drive"
5971 msgstr ""
5972
5973 # type: verbatim
5974 #. type: verbatim
5975 #: ../src/guestfs-actions.pod:111
5976 #, no-wrap
5977 msgid ""
5978 " int\n"
5979 " guestfs_add_drive (guestfs_h *g,\n"
5980 "                    const char *filename);\n"
5981 "\n"
5982 msgstr ""
5983
5984 # type: textblock
5985 #. type: textblock
5986 #: ../src/guestfs-actions.pod:115
5987 msgid ""
5988 "This function is the equivalent of calling C<guestfs_add_drive_opts> with no "
5989 "optional parameters, so the disk is added writable, with the format being "
5990 "detected automatically."
5991 msgstr ""
5992
5993 # type: textblock
5994 #. type: textblock
5995 #: ../src/guestfs-actions.pod:119
5996 msgid ""
5997 "Automatic detection of the format opens you up to a potential security hole "
5998 "when dealing with untrusted raw-format images.  See CVE-2010-3851 and "
5999 "RHBZ#642934.  Specifying the format closes this security hole.  Therefore "
6000 "you should think about replacing calls to this function with calls to "
6001 "C<guestfs_add_drive_opts>, and specifying the format."
6002 msgstr ""
6003
6004 # type: =head2
6005 #. type: =head2
6006 #: ../src/guestfs-actions.pod:130
6007 msgid "guestfs_add_drive_opts"
6008 msgstr ""
6009
6010 # type: verbatim
6011 #. type: verbatim
6012 #: ../src/guestfs-actions.pod:132
6013 #, no-wrap
6014 msgid ""
6015 " int\n"
6016 " guestfs_add_drive_opts (guestfs_h *g,\n"
6017 "                         const char *filename,\n"
6018 "                         ...);\n"
6019 "\n"
6020 msgstr ""
6021
6022 # type: verbatim
6023 #. type: verbatim
6024 #: ../src/guestfs-actions.pod:142
6025 #, no-wrap
6026 msgid ""
6027 " GUESTFS_ADD_DRIVE_OPTS_READONLY, int readonly,\n"
6028 " GUESTFS_ADD_DRIVE_OPTS_FORMAT, const char *format,\n"
6029 " GUESTFS_ADD_DRIVE_OPTS_IFACE, const char *iface,\n"
6030 "\n"
6031 msgstr ""
6032
6033 # type: textblock
6034 #. type: textblock
6035 #: ../src/guestfs-actions.pod:146 ../fish/guestfish-actions.pod:90
6036 msgid ""
6037 "This function adds a virtual machine disk image C<filename> to libguestfs.  "
6038 "The first time you call this function, the disk appears as C</dev/sda>, the "
6039 "second time as C</dev/sdb>, and so on."
6040 msgstr ""
6041
6042 # type: textblock
6043 #. type: textblock
6044 #: ../src/guestfs-actions.pod:151 ../fish/guestfish-actions.pod:95
6045 msgid ""
6046 "You don't necessarily need to be root when using libguestfs.  However you "
6047 "obviously do need sufficient permissions to access the filename for whatever "
6048 "operations you want to perform (ie. read access if you just want to read the "
6049 "image or write access if you want to modify the image)."
6050 msgstr ""
6051
6052 # type: textblock
6053 #. type: textblock
6054 #: ../src/guestfs-actions.pod:157 ../fish/guestfish-actions.pod:101
6055 msgid "This call checks that C<filename> exists."
6056 msgstr ""
6057
6058 # type: textblock
6059 #. type: textblock
6060 #: ../src/guestfs-actions.pod:159 ../src/guestfs-actions.pod:4239
6061 #: ../fish/guestfish-actions.pod:103 ../fish/guestfish-actions.pod:2855
6062 msgid "The optional arguments are:"
6063 msgstr ""
6064
6065 # type: =item
6066 #. type: =item
6067 #: ../src/guestfs-actions.pod:163 ../fish/guestfish-actions.pod:107
6068 msgid "C<readonly>"
6069 msgstr ""
6070
6071 # type: textblock
6072 #. type: textblock
6073 #: ../src/guestfs-actions.pod:165 ../fish/guestfish-actions.pod:109
6074 msgid ""
6075 "If true then the image is treated as read-only.  Writes are still allowed, "
6076 "but they are stored in a temporary snapshot overlay which is discarded at "
6077 "the end.  The disk that you add is not modified."
6078 msgstr ""
6079
6080 # type: =item
6081 #. type: =item
6082 #: ../src/guestfs-actions.pod:169 ../fish/guestfish-actions.pod:113
6083 msgid "C<format>"
6084 msgstr ""
6085
6086 # type: textblock
6087 #. type: textblock
6088 #: ../src/guestfs-actions.pod:171
6089 msgid ""
6090 "This forces the image format.  If you omit this (or use C<guestfs_add_drive> "
6091 "or C<guestfs_add_drive_ro>) then the format is automatically detected.  "
6092 "Possible formats include C<raw> and C<qcow2>."
6093 msgstr ""
6094
6095 # type: textblock
6096 #. type: textblock
6097 #: ../src/guestfs-actions.pod:175 ../fish/guestfish-actions.pod:119
6098 msgid ""
6099 "Automatic detection of the format opens you up to a potential security hole "
6100 "when dealing with untrusted raw-format images.  See CVE-2010-3851 and "
6101 "RHBZ#642934.  Specifying the format closes this security hole."
6102 msgstr ""
6103
6104 # type: =item
6105 #. type: =item
6106 #: ../src/guestfs-actions.pod:180 ../fish/guestfish-actions.pod:124
6107 msgid "C<iface>"
6108 msgstr ""
6109
6110 # type: textblock
6111 #. type: textblock
6112 #: ../src/guestfs-actions.pod:182
6113 msgid ""
6114 "This rarely-used option lets you emulate the behaviour of the deprecated "
6115 "C<guestfs_add_drive_with_if> call (q.v.)"
6116 msgstr ""
6117
6118 # type: textblock
6119 #. type: textblock
6120 #: ../src/guestfs-actions.pod:189
6121 msgid "(Added in 1.5.23)"
6122 msgstr ""
6123
6124 # type: =head2
6125 #. type: =head2
6126 #: ../src/guestfs-actions.pod:191
6127 msgid "guestfs_add_drive_opts_va"
6128 msgstr ""
6129
6130 # type: verbatim
6131 #. type: verbatim
6132 #: ../src/guestfs-actions.pod:193
6133 #, no-wrap
6134 msgid ""
6135 " int\n"
6136 " guestfs_add_drive_opts_va (guestfs_h *g,\n"
6137 "                            const char *filename,\n"
6138 "                            va_list args);\n"
6139 "\n"
6140 msgstr ""
6141
6142 # type: textblock
6143 #. type: textblock
6144 #: ../src/guestfs-actions.pod:198
6145 msgid "This is the \"va_list variant\" of L</guestfs_add_drive_opts>."
6146 msgstr ""
6147
6148 # type: =head2
6149 #. type: =head2
6150 #: ../src/guestfs-actions.pod:202
6151 msgid "guestfs_add_drive_opts_argv"
6152 msgstr ""
6153
6154 # type: verbatim
6155 #. type: verbatim
6156 #: ../src/guestfs-actions.pod:204
6157 #, no-wrap
6158 msgid ""
6159 " int\n"
6160 " guestfs_add_drive_opts_argv (guestfs_h *g,\n"
6161 "                              const char *filename,\n"
6162 "                              const struct guestfs_add_drive_opts_argv *optargs);\n"
6163 "\n"
6164 msgstr ""
6165
6166 # type: textblock
6167 #. type: textblock
6168 #: ../src/guestfs-actions.pod:209
6169 msgid "This is the \"argv variant\" of L</guestfs_add_drive_opts>."
6170 msgstr ""
6171
6172 # type: =head2
6173 #. type: =head2
6174 #: ../src/guestfs-actions.pod:213
6175 msgid "guestfs_add_drive_ro"
6176 msgstr ""
6177
6178 # type: verbatim
6179 #. type: verbatim
6180 #: ../src/guestfs-actions.pod:215
6181 #, no-wrap
6182 msgid ""
6183 " int\n"
6184 " guestfs_add_drive_ro (guestfs_h *g,\n"
6185 "                       const char *filename);\n"
6186 "\n"
6187 msgstr ""
6188
6189 # type: textblock
6190 #. type: textblock
6191 #: ../src/guestfs-actions.pod:219
6192 msgid ""
6193 "This function is the equivalent of calling C<guestfs_add_drive_opts> with "
6194 "the optional parameter C<GUESTFS_ADD_DRIVE_OPTS_READONLY> set to 1, so the "
6195 "disk is added read-only, with the format being detected automatically."
6196 msgstr ""
6197
6198 # type: textblock
6199 #. type: textblock
6200 #: ../src/guestfs-actions.pod:226
6201 msgid "(Added in 1.0.38)"
6202 msgstr ""
6203
6204 # type: =head2
6205 #. type: =head2
6206 #: ../src/guestfs-actions.pod:228
6207 msgid "guestfs_add_drive_ro_with_if"
6208 msgstr ""
6209
6210 # type: verbatim
6211 #. type: verbatim
6212 #: ../src/guestfs-actions.pod:230
6213 #, no-wrap
6214 msgid ""
6215 " int\n"
6216 " guestfs_add_drive_ro_with_if (guestfs_h *g,\n"
6217 "                               const char *filename,\n"
6218 "                               const char *iface);\n"
6219 "\n"
6220 msgstr ""
6221
6222 # type: textblock
6223 #. type: textblock
6224 #: ../src/guestfs-actions.pod:235
6225 msgid ""
6226 "This is the same as C<guestfs_add_drive_ro> but it allows you to specify the "
6227 "QEMU interface emulation to use at run time."
6228 msgstr ""
6229
6230 # type: textblock
6231 #. type: textblock
6232 #: ../src/guestfs-actions.pod:247 ../src/guestfs-actions.pod:268
6233 #: ../src/guestfs-actions.pod:2357
6234 msgid "(Added in 1.0.84)"
6235 msgstr ""
6236
6237 # type: =head2
6238 #. type: =head2
6239 #: ../src/guestfs-actions.pod:249
6240 msgid "guestfs_add_drive_with_if"
6241 msgstr ""
6242
6243 # type: verbatim
6244 #. type: verbatim
6245 #: ../src/guestfs-actions.pod:251
6246 #, no-wrap
6247 msgid ""
6248 " int\n"
6249 " guestfs_add_drive_with_if (guestfs_h *g,\n"
6250 "                            const char *filename,\n"
6251 "                            const char *iface);\n"
6252 "\n"
6253 msgstr ""
6254
6255 # type: textblock
6256 #. type: textblock
6257 #: ../src/guestfs-actions.pod:256
6258 msgid ""
6259 "This is the same as C<guestfs_add_drive> but it allows you to specify the "
6260 "QEMU interface emulation to use at run time."
6261 msgstr ""
6262
6263 # type: =head2
6264 #. type: =head2
6265 #: ../src/guestfs-actions.pod:270
6266 msgid "guestfs_aug_clear"
6267 msgstr ""
6268
6269 # type: verbatim
6270 #. type: verbatim
6271 #: ../src/guestfs-actions.pod:272
6272 #, no-wrap
6273 msgid ""
6274 " int\n"
6275 " guestfs_aug_clear (guestfs_h *g,\n"
6276 "                    const char *augpath);\n"
6277 "\n"
6278 msgstr ""
6279
6280 # type: textblock
6281 #. type: textblock
6282 #: ../src/guestfs-actions.pod:276 ../fish/guestfish-actions.pod:176
6283 msgid ""
6284 "Set the value associated with C<path> to C<NULL>.  This is the same as the "
6285 "L<augtool(1)> C<clear> command."
6286 msgstr ""
6287
6288 # type: textblock
6289 #. type: textblock
6290 #: ../src/guestfs-actions.pod:281 ../src/guestfs-actions.pod:2085
6291 msgid "(Added in 1.3.4)"
6292 msgstr ""
6293
6294 # type: =head2
6295 #. type: =head2
6296 #: ../src/guestfs-actions.pod:283
6297 msgid "guestfs_aug_close"
6298 msgstr ""
6299
6300 # type: verbatim
6301 #. type: verbatim
6302 #: ../src/guestfs-actions.pod:285
6303 #, no-wrap
6304 msgid ""
6305 " int\n"
6306 " guestfs_aug_close (guestfs_h *g);\n"
6307 "\n"
6308 msgstr ""
6309
6310 # type: textblock
6311 #. type: textblock
6312 #: ../src/guestfs-actions.pod:288
6313 msgid ""
6314 "Close the current Augeas handle and free up any resources used by it.  After "
6315 "calling this, you have to call C<guestfs_aug_init> again before you can use "
6316 "any other Augeas functions."
6317 msgstr ""
6318
6319 # type: textblock
6320 #. type: textblock
6321 #: ../src/guestfs-actions.pod:295 ../src/guestfs-actions.pod:320
6322 #: ../src/guestfs-actions.pod:338 ../src/guestfs-actions.pod:352
6323 #: ../src/guestfs-actions.pod:415 ../src/guestfs-actions.pod:435
6324 #: ../src/guestfs-actions.pod:449 ../src/guestfs-actions.pod:480
6325 #: ../src/guestfs-actions.pod:494 ../src/guestfs-actions.pod:508
6326 #: ../src/guestfs-actions.pod:522 ../src/guestfs-actions.pod:540
6327 #: ../src/guestfs-actions.pod:5263
6328 msgid "(Added in 0.7)"
6329 msgstr ""
6330
6331 # type: =head2
6332 #. type: =head2
6333 #: ../src/guestfs-actions.pod:297
6334 msgid "guestfs_aug_defnode"
6335 msgstr ""
6336
6337 # type: verbatim
6338 #. type: verbatim
6339 #: ../src/guestfs-actions.pod:299
6340 #, no-wrap
6341 msgid ""
6342 " struct guestfs_int_bool *\n"
6343 " guestfs_aug_defnode (guestfs_h *g,\n"
6344 "                      const char *name,\n"
6345 "                      const char *expr,\n"
6346 "                      const char *val);\n"
6347 "\n"
6348 msgstr ""
6349
6350 # type: textblock
6351 #. type: textblock
6352 #: ../src/guestfs-actions.pod:305 ../fish/guestfish-actions.pod:192
6353 msgid ""
6354 "Defines a variable C<name> whose value is the result of evaluating C<expr>."
6355 msgstr ""
6356
6357 # type: textblock
6358 #. type: textblock
6359 #: ../src/guestfs-actions.pod:308
6360 msgid ""
6361 "If C<expr> evaluates to an empty nodeset, a node is created, equivalent to "
6362 "calling C<guestfs_aug_set> C<expr>, C<value>.  C<name> will be the nodeset "
6363 "containing that single node."
6364 msgstr ""
6365
6366 # type: textblock
6367 #. type: textblock
6368 #: ../src/guestfs-actions.pod:312 ../fish/guestfish-actions.pod:199
6369 msgid ""
6370 "On success this returns a pair containing the number of nodes in the "
6371 "nodeset, and a boolean flag if a node was created."
6372 msgstr ""
6373
6374 # type: textblock
6375 #. type: textblock
6376 #: ../src/guestfs-actions.pod:316
6377 msgid ""
6378 "This function returns a C<struct guestfs_int_bool *>, or NULL if there was "
6379 "an error.  I<The caller must call C<guestfs_free_int_bool> after use>."
6380 msgstr ""
6381
6382 # type: =head2
6383 #. type: =head2
6384 #: ../src/guestfs-actions.pod:322
6385 msgid "guestfs_aug_defvar"
6386 msgstr ""
6387
6388 # type: verbatim
6389 #. type: verbatim
6390 #: ../src/guestfs-actions.pod:324
6391 #, no-wrap
6392 msgid ""
6393 " int\n"
6394 " guestfs_aug_defvar (guestfs_h *g,\n"
6395 "                     const char *name,\n"
6396 "                     const char *expr);\n"
6397 "\n"
6398 msgstr ""
6399
6400 # type: textblock
6401 #. type: textblock
6402 #: ../src/guestfs-actions.pod:329 ../fish/guestfish-actions.pod:207
6403 msgid ""
6404 "Defines an Augeas variable C<name> whose value is the result of evaluating "
6405 "C<expr>.  If C<expr> is NULL, then C<name> is undefined."
6406 msgstr ""
6407
6408 # type: textblock
6409 #. type: textblock
6410 #: ../src/guestfs-actions.pod:333 ../fish/guestfish-actions.pod:211
6411 msgid ""
6412 "On success this returns the number of nodes in C<expr>, or C<0> if C<expr> "
6413 "evaluates to something which is not a nodeset."
6414 msgstr ""
6415
6416 # type: =head2
6417 #. type: =head2
6418 #: ../src/guestfs-actions.pod:340
6419 msgid "guestfs_aug_get"
6420 msgstr ""
6421
6422 # type: verbatim
6423 #. type: verbatim
6424 #: ../src/guestfs-actions.pod:342
6425 #, no-wrap
6426 msgid ""
6427 " char *\n"
6428 " guestfs_aug_get (guestfs_h *g,\n"
6429 "                  const char *augpath);\n"
6430 "\n"
6431 msgstr ""
6432
6433 # type: textblock
6434 #. type: textblock
6435 #: ../src/guestfs-actions.pod:346 ../fish/guestfish-actions.pod:218
6436 msgid ""
6437 "Look up the value associated with C<path>.  If C<path> matches exactly one "
6438 "node, the C<value> is returned."
6439 msgstr ""
6440
6441 # type: textblock
6442 #. type: textblock
6443 #: ../src/guestfs-actions.pod:349 ../src/guestfs-actions.pod:854
6444 #: ../src/guestfs-actions.pod:872 ../src/guestfs-actions.pod:932
6445 #: ../src/guestfs-actions.pod:948 ../src/guestfs-actions.pod:1051
6446 #: ../src/guestfs-actions.pod:1181 ../src/guestfs-actions.pod:1198
6447 #: ../src/guestfs-actions.pod:1217 ../src/guestfs-actions.pod:1346
6448 #: ../src/guestfs-actions.pod:1534 ../src/guestfs-actions.pod:1646
6449 #: ../src/guestfs-actions.pod:1809 ../src/guestfs-actions.pod:1826
6450 #: ../src/guestfs-actions.pod:1917 ../src/guestfs-actions.pod:1938
6451 #: ../src/guestfs-actions.pod:2108 ../src/guestfs-actions.pod:2322
6452 #: ../src/guestfs-actions.pod:2529 ../src/guestfs-actions.pod:2610
6453 #: ../src/guestfs-actions.pod:2658 ../src/guestfs-actions.pod:2772
6454 #: ../src/guestfs-actions.pod:2803 ../src/guestfs-actions.pod:2827
6455 #: ../src/guestfs-actions.pod:2889 ../src/guestfs-actions.pod:2912
6456 #: ../src/guestfs-actions.pod:3426 ../src/guestfs-actions.pod:3776
6457 #: ../src/guestfs-actions.pod:3946 ../src/guestfs-actions.pod:4056
6458 #: ../src/guestfs-actions.pod:4798 ../src/guestfs-actions.pod:4991
6459 #: ../src/guestfs-actions.pod:5161 ../src/guestfs-actions.pod:5339
6460 #: ../src/guestfs-actions.pod:5388 ../src/guestfs-actions.pod:5951
6461 #: ../src/guestfs-actions.pod:5967 ../src/guestfs-actions.pod:5984
6462 #: ../src/guestfs-actions.pod:6008 ../src/guestfs-actions.pod:6682
6463 #: ../src/guestfs-actions.pod:6701 ../src/guestfs-actions.pod:6719
6464 #: ../src/guestfs-actions.pod:6899 ../src/guestfs-actions.pod:7171
6465 msgid ""
6466 "This function returns a string, or NULL on error.  I<The caller must free "
6467 "the returned string after use>."
6468 msgstr ""
6469
6470 # type: =head2
6471 #. type: =head2
6472 #: ../src/guestfs-actions.pod:354
6473 msgid "guestfs_aug_init"
6474 msgstr ""
6475
6476 # type: verbatim
6477 #. type: verbatim
6478 #: ../src/guestfs-actions.pod:356
6479 #, no-wrap
6480 msgid ""
6481 " int\n"
6482 " guestfs_aug_init (guestfs_h *g,\n"
6483 "                   const char *root,\n"
6484 "                   int flags);\n"
6485 "\n"
6486 msgstr ""
6487
6488 # type: textblock
6489 #. type: textblock
6490 #: ../src/guestfs-actions.pod:361 ../fish/guestfish-actions.pod:225
6491 msgid ""
6492 "Create a new Augeas handle for editing configuration files.  If there was "
6493 "any previous Augeas handle associated with this guestfs session, then it is "
6494 "closed."
6495 msgstr ""
6496
6497 # type: textblock
6498 #. type: textblock
6499 #: ../src/guestfs-actions.pod:365
6500 msgid "You must call this before using any other C<guestfs_aug_*> commands."
6501 msgstr ""
6502
6503 # type: textblock
6504 #. type: textblock
6505 #: ../src/guestfs-actions.pod:368 ../fish/guestfish-actions.pod:232
6506 msgid ""
6507 "C<root> is the filesystem root.  C<root> must not be NULL, use C</> instead."
6508 msgstr ""
6509
6510 # type: textblock
6511 #. type: textblock
6512 #: ../src/guestfs-actions.pod:371 ../fish/guestfish-actions.pod:235
6513 msgid ""
6514 "The flags are the same as the flags defined in E<lt>augeas.hE<gt>, the "
6515 "logical I<or> of the following integers:"
6516 msgstr ""
6517
6518 # type: =item
6519 #. type: =item
6520 #: ../src/guestfs-actions.pod:377 ../fish/guestfish-actions.pod:241
6521 msgid "C<AUG_SAVE_BACKUP> = 1"
6522 msgstr ""
6523
6524 # type: textblock
6525 #. type: textblock
6526 #: ../src/guestfs-actions.pod:379 ../fish/guestfish-actions.pod:243
6527 msgid "Keep the original file with a C<.augsave> extension."
6528 msgstr ""
6529
6530 # type: =item
6531 #. type: =item
6532 #: ../src/guestfs-actions.pod:381 ../fish/guestfish-actions.pod:245
6533 msgid "C<AUG_SAVE_NEWFILE> = 2"
6534 msgstr ""
6535
6536 # type: textblock
6537 #. type: textblock
6538 #: ../src/guestfs-actions.pod:383 ../fish/guestfish-actions.pod:247
6539 msgid ""
6540 "Save changes into a file with extension C<.augnew>, and do not overwrite "
6541 "original.  Overrides C<AUG_SAVE_BACKUP>."
6542 msgstr ""
6543
6544 # type: =item
6545 #. type: =item
6546 #: ../src/guestfs-actions.pod:386 ../fish/guestfish-actions.pod:250
6547 msgid "C<AUG_TYPE_CHECK> = 4"
6548 msgstr ""
6549
6550 #. type: textblock
6551 #: ../src/guestfs-actions.pod:388 ../fish/guestfish-actions.pod:252
6552 msgid "Typecheck lenses."
6553 msgstr ""
6554
6555 #. type: textblock
6556 #: ../src/guestfs-actions.pod:390
6557 msgid ""
6558 "This option is only useful when debugging Augeas lenses.  Use of this option "
6559 "may require additional memory for the libguestfs appliance.  You may need to "
6560 "set the C<LIBGUESTFS_MEMSIZE> environment variable or call "
6561 "C<guestfs_set_memsize>."
6562 msgstr ""
6563
6564 # type: =item
6565 #. type: =item
6566 #: ../src/guestfs-actions.pod:395 ../fish/guestfish-actions.pod:259
6567 msgid "C<AUG_NO_STDINC> = 8"
6568 msgstr ""
6569
6570 # type: textblock
6571 #. type: textblock
6572 #: ../src/guestfs-actions.pod:397 ../fish/guestfish-actions.pod:261
6573 msgid "Do not use standard load path for modules."
6574 msgstr ""
6575
6576 # type: =item
6577 #. type: =item
6578 #: ../src/guestfs-actions.pod:399 ../fish/guestfish-actions.pod:263
6579 msgid "C<AUG_SAVE_NOOP> = 16"
6580 msgstr ""
6581
6582 # type: textblock
6583 #. type: textblock
6584 #: ../src/guestfs-actions.pod:401 ../fish/guestfish-actions.pod:265
6585 msgid "Make save a no-op, just record what would have been changed."
6586 msgstr ""
6587
6588 # type: =item
6589 #. type: =item
6590 #: ../src/guestfs-actions.pod:403 ../fish/guestfish-actions.pod:267
6591 msgid "C<AUG_NO_LOAD> = 32"
6592 msgstr ""
6593
6594 # type: textblock
6595 #. type: textblock
6596 #: ../src/guestfs-actions.pod:405
6597 msgid "Do not load the tree in C<guestfs_aug_init>."
6598 msgstr ""
6599
6600 # type: textblock
6601 #. type: textblock
6602 #: ../src/guestfs-actions.pod:409
6603 msgid "To close the handle, you can call C<guestfs_aug_close>."
6604 msgstr ""
6605
6606 # type: textblock
6607 #. type: textblock
6608 #: ../src/guestfs-actions.pod:411 ../fish/guestfish-actions.pod:275
6609 msgid "To find out more about Augeas, see L<http://augeas.net/>."
6610 msgstr ""
6611
6612 # type: =head2
6613 #. type: =head2
6614 #: ../src/guestfs-actions.pod:417
6615 msgid "guestfs_aug_insert"
6616 msgstr ""
6617
6618 # type: verbatim
6619 #. type: verbatim
6620 #: ../src/guestfs-actions.pod:419
6621 #, no-wrap
6622 msgid ""
6623 " int\n"
6624 " guestfs_aug_insert (guestfs_h *g,\n"
6625 "                     const char *augpath,\n"
6626 "                     const char *label,\n"
6627 "                     int before);\n"
6628 "\n"
6629 msgstr ""
6630
6631 # type: textblock
6632 #. type: textblock
6633 #: ../src/guestfs-actions.pod:425 ../fish/guestfish-actions.pod:281
6634 msgid ""
6635 "Create a new sibling C<label> for C<path>, inserting it into the tree before "
6636 "or after C<path> (depending on the boolean flag C<before>)."
6637 msgstr ""
6638
6639 # type: textblock
6640 #. type: textblock
6641 #: ../src/guestfs-actions.pod:429 ../fish/guestfish-actions.pod:285
6642 msgid ""
6643 "C<path> must match exactly one existing node in the tree, and C<label> must "
6644 "be a label, ie. not contain C</>, C<*> or end with a bracketed index C<[N]>."
6645 msgstr ""
6646
6647 # type: =head2
6648 #. type: =head2
6649 #: ../src/guestfs-actions.pod:437
6650 msgid "guestfs_aug_load"
6651 msgstr ""
6652
6653 # type: verbatim
6654 #. type: verbatim
6655 #: ../src/guestfs-actions.pod:439
6656 #, no-wrap
6657 msgid ""
6658 " int\n"
6659 " guestfs_aug_load (guestfs_h *g);\n"
6660 "\n"
6661 msgstr ""
6662
6663 # type: textblock
6664 #. type: textblock
6665 #: ../src/guestfs-actions.pod:442 ../fish/guestfish-actions.pod:293
6666 msgid "Load files into the tree."
6667 msgstr ""
6668
6669 # type: textblock
6670 #. type: textblock
6671 #: ../src/guestfs-actions.pod:444 ../fish/guestfish-actions.pod:295
6672 msgid "See C<aug_load> in the Augeas documentation for the full gory details."
6673 msgstr ""
6674
6675 # type: =head2
6676 #. type: =head2
6677 #: ../src/guestfs-actions.pod:451
6678 msgid "guestfs_aug_ls"
6679 msgstr ""
6680
6681 # type: verbatim
6682 #. type: verbatim
6683 #: ../src/guestfs-actions.pod:453
6684 #, no-wrap
6685 msgid ""
6686 " char **\n"
6687 " guestfs_aug_ls (guestfs_h *g,\n"
6688 "                 const char *augpath);\n"
6689 "\n"
6690 msgstr ""
6691
6692 # type: textblock
6693 #. type: textblock
6694 #: ../src/guestfs-actions.pod:457
6695 msgid ""
6696 "This is just a shortcut for listing C<guestfs_aug_match> C<path/*> and "
6697 "sorting the resulting nodes into alphabetical order."
6698 msgstr ""
6699
6700 # type: textblock
6701 #. type: textblock
6702 #: ../src/guestfs-actions.pod:460 ../src/guestfs-actions.pod:476
6703 #: ../src/guestfs-actions.pod:622 ../src/guestfs-actions.pod:1070
6704 #: ../src/guestfs-actions.pod:1361 ../src/guestfs-actions.pod:1380
6705 #: ../src/guestfs-actions.pod:1483 ../src/guestfs-actions.pod:1502
6706 #: ../src/guestfs-actions.pod:1748 ../src/guestfs-actions.pod:2180
6707 #: ../src/guestfs-actions.pod:2196 ../src/guestfs-actions.pod:2215
6708 #: ../src/guestfs-actions.pod:2280 ../src/guestfs-actions.pod:2304
6709 #: ../src/guestfs-actions.pod:2375 ../src/guestfs-actions.pod:2424
6710 #: ../src/guestfs-actions.pod:2635 ../src/guestfs-actions.pod:2846
6711 #: ../src/guestfs-actions.pod:3061 ../src/guestfs-actions.pod:3346
6712 #: ../src/guestfs-actions.pod:3408 ../src/guestfs-actions.pod:3513
6713 #: ../src/guestfs-actions.pod:3918 ../src/guestfs-actions.pod:4604
6714 #: ../src/guestfs-actions.pod:5133 ../src/guestfs-actions.pod:5259
6715 #: ../src/guestfs-actions.pod:5373 ../src/guestfs-actions.pod:6024
6716 #: ../src/guestfs-actions.pod:6085 ../src/guestfs-actions.pod:6140
6717 #: ../src/guestfs-actions.pod:6286 ../src/guestfs-actions.pod:6310
6718 #: ../src/guestfs-actions.pod:6792 ../src/guestfs-actions.pod:6812
6719 #: ../src/guestfs-actions.pod:6859 ../src/guestfs-actions.pod:7024
6720 #: ../src/guestfs-actions.pod:7043 ../src/guestfs-actions.pod:7128
6721 #: ../src/guestfs-actions.pod:7147 ../src/guestfs-actions.pod:7193
6722 #: ../src/guestfs-actions.pod:7212
6723 msgid ""
6724 "This function returns a NULL-terminated array of strings (like L<environ(3)"
6725 ">), or NULL if there was an error.  I<The caller must free the strings and "
6726 "the array after use>."
6727 msgstr ""
6728
6729 # type: textblock
6730 #. type: textblock
6731 #: ../src/guestfs-actions.pod:464 ../src/guestfs-actions.pod:995
6732 #: ../src/guestfs-actions.pod:1013 ../src/guestfs-actions.pod:1418
6733 #: ../src/guestfs-actions.pod:3139 ../src/guestfs-actions.pod:3170
6734 #: ../src/guestfs-actions.pod:3759 ../src/guestfs-actions.pod:3809
6735 #: ../src/guestfs-actions.pod:3996 ../src/guestfs-actions.pod:4029
6736 #: ../src/guestfs-actions.pod:4192 ../src/guestfs-actions.pod:4608
6737 #: ../src/guestfs-actions.pod:5074 ../src/guestfs-actions.pod:5452
6738 #: ../src/guestfs-actions.pod:5466 ../src/guestfs-actions.pod:5478
6739 #: ../src/guestfs-actions.pod:5886 ../src/guestfs-actions.pod:6524
6740 #: ../src/guestfs-actions.pod:6537 ../src/guestfs-actions.pod:6776
6741 #: ../src/guestfs-actions.pod:7012
6742 msgid "(Added in 0.8)"
6743 msgstr ""
6744
6745 # type: =head2
6746 #. type: =head2
6747 #: ../src/guestfs-actions.pod:466
6748 msgid "guestfs_aug_match"
6749 msgstr ""
6750
6751 # type: verbatim
6752 #. type: verbatim
6753 #: ../src/guestfs-actions.pod:468
6754 #, no-wrap
6755 msgid ""
6756 " char **\n"
6757 " guestfs_aug_match (guestfs_h *g,\n"
6758 "                    const char *augpath);\n"
6759 "\n"
6760 msgstr ""
6761
6762 # type: textblock
6763 #. type: textblock
6764 #: ../src/guestfs-actions.pod:472 ../fish/guestfish-actions.pod:309
6765 msgid ""
6766 "Returns a list of paths which match the path expression C<path>.  The "
6767 "returned paths are sufficiently qualified so that they match exactly one "
6768 "node in the current tree."
6769 msgstr ""
6770
6771 # type: =head2
6772 #. type: =head2
6773 #: ../src/guestfs-actions.pod:482
6774 msgid "guestfs_aug_mv"
6775 msgstr ""
6776
6777 # type: verbatim
6778 #. type: verbatim
6779 #: ../src/guestfs-actions.pod:484
6780 #, no-wrap
6781 msgid ""
6782 " int\n"
6783 " guestfs_aug_mv (guestfs_h *g,\n"
6784 "                 const char *src,\n"
6785 "                 const char *dest);\n"
6786 "\n"
6787 msgstr ""
6788
6789 # type: textblock
6790 #. type: textblock
6791 #: ../src/guestfs-actions.pod:489 ../fish/guestfish-actions.pod:317
6792 msgid ""
6793 "Move the node C<src> to C<dest>.  C<src> must match exactly one node.  "
6794 "C<dest> is overwritten if it exists."
6795 msgstr ""
6796
6797 # type: =head2
6798 #. type: =head2
6799 #: ../src/guestfs-actions.pod:496
6800 msgid "guestfs_aug_rm"
6801 msgstr ""
6802
6803 # type: verbatim
6804 #. type: verbatim
6805 #: ../src/guestfs-actions.pod:498
6806 #, no-wrap
6807 msgid ""
6808 " int\n"
6809 " guestfs_aug_rm (guestfs_h *g,\n"
6810 "                 const char *augpath);\n"
6811 "\n"
6812 msgstr ""
6813
6814 # type: textblock
6815 #. type: textblock
6816 #: ../src/guestfs-actions.pod:502 ../fish/guestfish-actions.pod:324
6817 msgid "Remove C<path> and all of its children."
6818 msgstr ""
6819
6820 # type: textblock
6821 #. type: textblock
6822 #: ../src/guestfs-actions.pod:504 ../fish/guestfish-actions.pod:326
6823 msgid "On success this returns the number of entries which were removed."
6824 msgstr ""
6825
6826 # type: =head2
6827 #. type: =head2
6828 #: ../src/guestfs-actions.pod:510
6829 msgid "guestfs_aug_save"
6830 msgstr ""
6831
6832 # type: verbatim
6833 #. type: verbatim
6834 #: ../src/guestfs-actions.pod:512
6835 #, no-wrap
6836 msgid ""
6837 " int\n"
6838 " guestfs_aug_save (guestfs_h *g);\n"
6839 "\n"
6840 msgstr ""
6841
6842 # type: textblock
6843 #. type: textblock
6844 #: ../src/guestfs-actions.pod:515 ../fish/guestfish-actions.pod:332
6845 msgid "This writes all pending changes to disk."
6846 msgstr ""
6847
6848 # type: textblock
6849 #. type: textblock
6850 #: ../src/guestfs-actions.pod:517
6851 msgid ""
6852 "The flags which were passed to C<guestfs_aug_init> affect exactly how files "
6853 "are saved."
6854 msgstr ""
6855
6856 # type: =head2
6857 #. type: =head2
6858 #: ../src/guestfs-actions.pod:524
6859 msgid "guestfs_aug_set"
6860 msgstr ""
6861
6862 # type: verbatim
6863 #. type: verbatim
6864 #: ../src/guestfs-actions.pod:526
6865 #, no-wrap
6866 msgid ""
6867 " int\n"
6868 " guestfs_aug_set (guestfs_h *g,\n"
6869 "                  const char *augpath,\n"
6870 "                  const char *val);\n"
6871 "\n"
6872 msgstr ""
6873
6874 # type: textblock
6875 #. type: textblock
6876 #: ../src/guestfs-actions.pod:531 ../fish/guestfish-actions.pod:341
6877 msgid "Set the value associated with C<path> to C<val>."
6878 msgstr ""
6879
6880 # type: textblock
6881 #. type: textblock
6882 #: ../src/guestfs-actions.pod:533
6883 msgid ""
6884 "In the Augeas API, it is possible to clear a node by setting the value to "
6885 "NULL.  Due to an oversight in the libguestfs API you cannot do that with "
6886 "this call.  Instead you must use the C<guestfs_aug_clear> call."
6887 msgstr ""
6888
6889 # type: =head2
6890 #. type: =head2
6891 #: ../src/guestfs-actions.pod:542
6892 msgid "guestfs_available"
6893 msgstr ""
6894
6895 # type: verbatim
6896 #. type: verbatim
6897 #: ../src/guestfs-actions.pod:544
6898 #, no-wrap
6899 msgid ""
6900 " int\n"
6901 " guestfs_available (guestfs_h *g,\n"
6902 "                    char *const *groups);\n"
6903 "\n"
6904 msgstr ""
6905
6906 # type: textblock
6907 #. type: textblock
6908 #: ../src/guestfs-actions.pod:548 ../fish/guestfish-actions.pod:352
6909 msgid ""
6910 "This command is used to check the availability of some groups of "
6911 "functionality in the appliance, which not all builds of the libguestfs "
6912 "appliance will be able to provide."
6913 msgstr ""
6914
6915 # type: textblock
6916 #. type: textblock
6917 #: ../src/guestfs-actions.pod:552
6918 msgid ""
6919 "The libguestfs groups, and the functions that those groups correspond to, "
6920 "are listed in L<guestfs(3)/AVAILABILITY>.  You can also fetch this list at "
6921 "runtime by calling C<guestfs_available_all_groups>."
6922 msgstr ""
6923
6924 # type: textblock
6925 #. type: textblock
6926 #: ../src/guestfs-actions.pod:557 ../fish/guestfish-actions.pod:361
6927 msgid ""
6928 "The argument C<groups> is a list of group names, eg: C<[\"inotify\", \"augeas"
6929 "\"]> would check for the availability of the Linux inotify functions and "
6930 "Augeas (configuration file editing) functions."
6931 msgstr ""
6932
6933 # type: textblock
6934 #. type: textblock
6935 #: ../src/guestfs-actions.pod:562 ../fish/guestfish-actions.pod:366
6936 msgid "The command returns no error if I<all> requested groups are available."
6937 msgstr ""
6938
6939 # type: textblock
6940 #. type: textblock
6941 #: ../src/guestfs-actions.pod:564 ../fish/guestfish-actions.pod:368
6942 msgid ""
6943 "It fails with an error if one or more of the requested groups is unavailable "
6944 "in the appliance."
6945 msgstr ""
6946
6947 # type: textblock
6948 #. type: textblock
6949 #: ../src/guestfs-actions.pod:567 ../fish/guestfish-actions.pod:371
6950 msgid ""
6951 "If an unknown group name is included in the list of groups then an error is "
6952 "always returned."
6953 msgstr ""
6954
6955 # type: textblock
6956 #. type: textblock
6957 #: ../src/guestfs-actions.pod:570 ../fish/guestfish-actions.pod:374
6958 msgid "I<Notes:>"
6959 msgstr ""
6960
6961 # type: textblock
6962 #. type: textblock
6963 #: ../src/guestfs-actions.pod:576
6964 msgid "You must call C<guestfs_launch> before calling this function."
6965 msgstr ""
6966
6967 # type: textblock
6968 #. type: textblock
6969 #: ../src/guestfs-actions.pod:578 ../fish/guestfish-actions.pod:382
6970 msgid ""
6971 "The reason is because we don't know what groups are supported by the "
6972 "appliance/daemon until it is running and can be queried."
6973 msgstr ""
6974
6975 # type: textblock
6976 #. type: textblock
6977 #: ../src/guestfs-actions.pod:584 ../fish/guestfish-actions.pod:388
6978 msgid ""
6979 "If a group of functions is available, this does not necessarily mean that "
6980 "they will work.  You still have to check for errors when calling individual "
6981 "API functions even if they are available."
6982 msgstr ""
6983
6984 # type: textblock
6985 #. type: textblock
6986 #: ../src/guestfs-actions.pod:591 ../fish/guestfish-actions.pod:395
6987 msgid ""
6988 "It is usually the job of distro packagers to build complete functionality "
6989 "into the libguestfs appliance.  Upstream libguestfs, if built from source "
6990 "with all requirements satisfied, will support everything."
6991 msgstr ""
6992
6993 # type: textblock
6994 #. type: textblock
6995 #: ../src/guestfs-actions.pod:598
6996 msgid ""
6997 "This call was added in version C<1.0.80>.  In previous versions of "
6998 "libguestfs all you could do would be to speculatively execute a command to "
6999 "find out if the daemon implemented it.  See also C<guestfs_version>."
7000 msgstr ""
7001
7002 # type: textblock
7003 #. type: textblock
7004 #: ../src/guestfs-actions.pod:607 ../src/guestfs-actions.pod:1168
7005 msgid "(Added in 1.0.80)"
7006 msgstr ""
7007
7008 # type: =head2
7009 #. type: =head2
7010 #: ../src/guestfs-actions.pod:609
7011 msgid "guestfs_available_all_groups"
7012 msgstr ""
7013
7014 # type: verbatim
7015 #. type: verbatim
7016 #: ../src/guestfs-actions.pod:611
7017 #, no-wrap
7018 msgid ""
7019 " char **\n"
7020 " guestfs_available_all_groups (guestfs_h *g);\n"
7021 "\n"
7022 msgstr ""
7023
7024 # type: textblock
7025 #. type: textblock
7026 #: ../src/guestfs-actions.pod:614
7027 msgid ""
7028 "This command returns a list of all optional groups that this daemon knows "
7029 "about.  Note this returns both supported and unsupported groups.  To find "
7030 "out which ones the daemon can actually support you have to call "
7031 "C<guestfs_available> on each member of the returned list."
7032 msgstr ""
7033
7034 # type: textblock
7035 #. type: textblock
7036 #: ../src/guestfs-actions.pod:620
7037 msgid "See also C<guestfs_available> and L<guestfs(3)/AVAILABILITY>."
7038 msgstr ""
7039
7040 # type: textblock
7041 #. type: textblock
7042 #: ../src/guestfs-actions.pod:626
7043 msgid "(Added in 1.3.15)"
7044 msgstr ""
7045
7046 # type: =head2
7047 #. type: =head2
7048 #: ../src/guestfs-actions.pod:628
7049 msgid "guestfs_base64_in"
7050 msgstr ""
7051
7052 # type: verbatim
7053 #. type: verbatim
7054 #: ../src/guestfs-actions.pod:630
7055 #, no-wrap
7056 msgid ""
7057 " int\n"
7058 " guestfs_base64_in (guestfs_h *g,\n"
7059 "                    const char *base64file,\n"
7060 "                    const char *filename);\n"
7061 "\n"
7062 msgstr ""
7063
7064 # type: textblock
7065 #. type: textblock
7066 #: ../src/guestfs-actions.pod:635 ../fish/guestfish-actions.pod:425
7067 msgid ""
7068 "This command uploads base64-encoded data from C<base64file> to C<filename>."
7069 msgstr ""
7070
7071 # type: textblock
7072 #. type: textblock
7073 #: ../src/guestfs-actions.pod:640 ../src/guestfs-actions.pod:654
7074 msgid "(Added in 1.3.5)"
7075 msgstr ""
7076
7077 # type: =head2
7078 #. type: =head2
7079 #: ../src/guestfs-actions.pod:642
7080 msgid "guestfs_base64_out"
7081 msgstr ""
7082
7083 # type: verbatim
7084 #. type: verbatim
7085 #: ../src/guestfs-actions.pod:644
7086 #, no-wrap
7087 msgid ""
7088 " int\n"
7089 " guestfs_base64_out (guestfs_h *g,\n"
7090 "                     const char *filename,\n"
7091 "                     const char *base64file);\n"
7092 "\n"
7093 msgstr ""
7094
7095 # type: textblock
7096 #. type: textblock
7097 #: ../src/guestfs-actions.pod:649 ../fish/guestfish-actions.pod:434
7098 msgid ""
7099 "This command downloads the contents of C<filename>, writing it out to local "
7100 "file C<base64file> encoded as base64."
7101 msgstr ""
7102
7103 # type: =head2
7104 #. type: =head2
7105 #: ../src/guestfs-actions.pod:656
7106 msgid "guestfs_blockdev_flushbufs"
7107 msgstr ""
7108
7109 # type: verbatim
7110 #. type: verbatim
7111 #: ../src/guestfs-actions.pod:658
7112 #, no-wrap
7113 msgid ""
7114 " int\n"
7115 " guestfs_blockdev_flushbufs (guestfs_h *g,\n"
7116 "                             const char *device);\n"
7117 "\n"
7118 msgstr ""
7119
7120 # type: textblock
7121 #. type: textblock
7122 #: ../src/guestfs-actions.pod:662 ../fish/guestfish-actions.pod:443
7123 msgid ""
7124 "This tells the kernel to flush internal buffers associated with C<device>."
7125 msgstr ""
7126
7127 # type: textblock
7128 #. type: textblock
7129 #: ../src/guestfs-actions.pod:665 ../src/guestfs-actions.pod:682
7130 #: ../src/guestfs-actions.pod:697 ../src/guestfs-actions.pod:713
7131 #: ../src/guestfs-actions.pod:731 ../src/guestfs-actions.pod:750
7132 #: ../src/guestfs-actions.pod:764 ../src/guestfs-actions.pod:782
7133 #: ../src/guestfs-actions.pod:796 ../src/guestfs-actions.pod:810
7134 #: ../fish/guestfish-actions.pod:446 ../fish/guestfish-actions.pod:457
7135 #: ../fish/guestfish-actions.pod:466 ../fish/guestfish-actions.pod:476
7136 #: ../fish/guestfish-actions.pod:488 ../fish/guestfish-actions.pod:501
7137 #: ../fish/guestfish-actions.pod:509 ../fish/guestfish-actions.pod:520
7138 #: ../fish/guestfish-actions.pod:528 ../fish/guestfish-actions.pod:536
7139 msgid "This uses the L<blockdev(8)> command."
7140 msgstr ""
7141
7142 # type: textblock
7143 #. type: textblock
7144 #: ../src/guestfs-actions.pod:669 ../src/guestfs-actions.pod:686
7145 #: ../src/guestfs-actions.pod:701 ../src/guestfs-actions.pod:717
7146 #: ../src/guestfs-actions.pod:735 ../src/guestfs-actions.pod:754
7147 #: ../src/guestfs-actions.pod:768 ../src/guestfs-actions.pod:786
7148 #: ../src/guestfs-actions.pod:800 ../src/guestfs-actions.pod:814
7149 msgid "(Added in 0.9.3)"
7150 msgstr ""
7151
7152 # type: =head2
7153 #. type: =head2
7154 #: ../src/guestfs-actions.pod:671
7155 msgid "guestfs_blockdev_getbsz"
7156 msgstr ""
7157
7158 # type: verbatim
7159 #. type: verbatim
7160 #: ../src/guestfs-actions.pod:673
7161 #, no-wrap
7162 msgid ""
7163 " int\n"
7164 " guestfs_blockdev_getbsz (guestfs_h *g,\n"
7165 "                          const char *device);\n"
7166 "\n"
7167 msgstr ""
7168
7169 # type: textblock
7170 #. type: textblock
7171 #: ../src/guestfs-actions.pod:677 ../fish/guestfish-actions.pod:452
7172 msgid "This returns the block size of a device."
7173 msgstr ""
7174
7175 # type: textblock
7176 #. type: textblock
7177 #: ../src/guestfs-actions.pod:679 ../src/guestfs-actions.pod:779
7178 #: ../fish/guestfish-actions.pod:454 ../fish/guestfish-actions.pod:517
7179 msgid ""
7180 "(Note this is different from both I<size in blocks> and I<filesystem block "
7181 "size>)."
7182 msgstr ""
7183
7184 # type: =head2
7185 #. type: =head2
7186 #: ../src/guestfs-actions.pod:688
7187 msgid "guestfs_blockdev_getro"
7188 msgstr ""
7189
7190 # type: verbatim
7191 #. type: verbatim
7192 #: ../src/guestfs-actions.pod:690
7193 #, no-wrap
7194 msgid ""
7195 " int\n"
7196 " guestfs_blockdev_getro (guestfs_h *g,\n"
7197 "                         const char *device);\n"
7198 "\n"
7199 msgstr ""
7200
7201 # type: textblock
7202 #. type: textblock
7203 #: ../src/guestfs-actions.pod:694 ../fish/guestfish-actions.pod:463
7204 msgid ""
7205 "Returns a boolean indicating if the block device is read-only (true if read-"
7206 "only, false if not)."
7207 msgstr ""
7208
7209 # type: textblock
7210 #. type: textblock
7211 #: ../src/guestfs-actions.pod:699 ../src/guestfs-actions.pod:1401
7212 #: ../src/guestfs-actions.pod:1416 ../src/guestfs-actions.pod:1893
7213 #: ../src/guestfs-actions.pod:1904 ../src/guestfs-actions.pod:1976
7214 #: ../src/guestfs-actions.pod:2031 ../src/guestfs-actions.pod:2046
7215 #: ../src/guestfs-actions.pod:2071 ../src/guestfs-actions.pod:2094
7216 #: ../src/guestfs-actions.pod:3078 ../src/guestfs-actions.pod:3092
7217 #: ../src/guestfs-actions.pod:3107 ../src/guestfs-actions.pod:3121
7218 #: ../src/guestfs-actions.pod:3137 ../src/guestfs-actions.pod:3152
7219 #: ../src/guestfs-actions.pod:3168 ../src/guestfs-actions.pod:3182
7220 #: ../src/guestfs-actions.pod:3195 ../src/guestfs-actions.pod:3209
7221 #: ../src/guestfs-actions.pod:3224 ../src/guestfs-actions.pod:3239
7222 #: ../src/guestfs-actions.pod:4762
7223 msgid "This function returns a C truth value on success or -1 on error."
7224 msgstr ""
7225
7226 # type: =head2
7227 #. type: =head2
7228 #: ../src/guestfs-actions.pod:703
7229 msgid "guestfs_blockdev_getsize64"
7230 msgstr ""
7231
7232 # type: verbatim
7233 #. type: verbatim
7234 #: ../src/guestfs-actions.pod:705
7235 #, no-wrap
7236 msgid ""
7237 " int64_t\n"
7238 " guestfs_blockdev_getsize64 (guestfs_h *g,\n"
7239 "                             const char *device);\n"
7240 "\n"
7241 msgstr ""
7242
7243 # type: textblock
7244 #. type: textblock
7245 #: ../src/guestfs-actions.pod:709 ../fish/guestfish-actions.pod:472
7246 msgid "This returns the size of the device in bytes."
7247 msgstr ""
7248
7249 # type: textblock
7250 #. type: textblock
7251 #: ../src/guestfs-actions.pod:711
7252 msgid "See also C<guestfs_blockdev_getsz>."
7253 msgstr ""
7254
7255 # type: =head2
7256 #. type: =head2
7257 #: ../src/guestfs-actions.pod:719
7258 msgid "guestfs_blockdev_getss"
7259 msgstr ""
7260
7261 # type: verbatim
7262 #. type: verbatim
7263 #: ../src/guestfs-actions.pod:721
7264 #, no-wrap
7265 msgid ""
7266 " int\n"
7267 " guestfs_blockdev_getss (guestfs_h *g,\n"
7268 "                         const char *device);\n"
7269 "\n"
7270 msgstr ""
7271
7272 # type: textblock
7273 #. type: textblock
7274 #: ../src/guestfs-actions.pod:725 ../fish/guestfish-actions.pod:482
7275 msgid ""
7276 "This returns the size of sectors on a block device.  Usually 512, but can be "
7277 "larger for modern devices."
7278 msgstr ""
7279
7280 # type: textblock
7281 #. type: textblock
7282 #: ../src/guestfs-actions.pod:728
7283 msgid ""
7284 "(Note, this is not the size in sectors, use C<guestfs_blockdev_getsz> for "
7285 "that)."
7286 msgstr ""
7287
7288 # type: =head2
7289 #. type: =head2
7290 #: ../src/guestfs-actions.pod:737
7291 msgid "guestfs_blockdev_getsz"
7292 msgstr ""
7293
7294 # type: verbatim
7295 #. type: verbatim
7296 #: ../src/guestfs-actions.pod:739
7297 #, no-wrap
7298 msgid ""
7299 " int64_t\n"
7300 " guestfs_blockdev_getsz (guestfs_h *g,\n"
7301 "                         const char *device);\n"
7302 "\n"
7303 msgstr ""
7304
7305 # type: textblock
7306 #. type: textblock
7307 #: ../src/guestfs-actions.pod:743 ../fish/guestfish-actions.pod:494
7308 msgid ""
7309 "This returns the size of the device in units of 512-byte sectors (even if "
7310 "the sectorsize isn't 512 bytes ... weird)."
7311 msgstr ""
7312
7313 # type: textblock
7314 #. type: textblock
7315 #: ../src/guestfs-actions.pod:746
7316 msgid ""
7317 "See also C<guestfs_blockdev_getss> for the real sector size of the device, "
7318 "and C<guestfs_blockdev_getsize64> for the more useful I<size in bytes>."
7319 msgstr ""
7320
7321 # type: =head2
7322 #. type: =head2
7323 #: ../src/guestfs-actions.pod:756
7324 msgid "guestfs_blockdev_rereadpt"
7325 msgstr ""
7326
7327 # type: verbatim
7328 #. type: verbatim
7329 #: ../src/guestfs-actions.pod:758
7330 #, no-wrap
7331 msgid ""
7332 " int\n"
7333 " guestfs_blockdev_rereadpt (guestfs_h *g,\n"
7334 "                            const char *device);\n"
7335 "\n"
7336 msgstr ""
7337
7338 # type: textblock
7339 #. type: textblock
7340 #: ../src/guestfs-actions.pod:762 ../fish/guestfish-actions.pod:507
7341 msgid "Reread the partition table on C<device>."
7342 msgstr ""
7343
7344 # type: =head2
7345 #. type: =head2
7346 #: ../src/guestfs-actions.pod:770
7347 msgid "guestfs_blockdev_setbsz"
7348 msgstr ""
7349
7350 # type: verbatim
7351 #. type: verbatim
7352 #: ../src/guestfs-actions.pod:772
7353 #, no-wrap
7354 msgid ""
7355 " int\n"
7356 " guestfs_blockdev_setbsz (guestfs_h *g,\n"
7357 "                          const char *device,\n"
7358 "                          int blocksize);\n"
7359 "\n"
7360 msgstr ""
7361
7362 # type: textblock
7363 #. type: textblock
7364 #: ../src/guestfs-actions.pod:777 ../fish/guestfish-actions.pod:515
7365 msgid "This sets the block size of a device."
7366 msgstr ""
7367
7368 # type: =head2
7369 #. type: =head2
7370 #: ../src/guestfs-actions.pod:788
7371 msgid "guestfs_blockdev_setro"
7372 msgstr ""
7373
7374 # type: verbatim
7375 #. type: verbatim
7376 #: ../src/guestfs-actions.pod:790
7377 #, no-wrap
7378 msgid ""
7379 " int\n"
7380 " guestfs_blockdev_setro (guestfs_h *g,\n"
7381 "                         const char *device);\n"
7382 "\n"
7383 msgstr ""
7384
7385 # type: textblock
7386 #. type: textblock
7387 #: ../src/guestfs-actions.pod:794 ../fish/guestfish-actions.pod:526
7388 msgid "Sets the block device named C<device> to read-only."
7389 msgstr ""
7390
7391 # type: =head2
7392 #. type: =head2
7393 #: ../src/guestfs-actions.pod:802
7394 msgid "guestfs_blockdev_setrw"
7395 msgstr ""
7396
7397 # type: verbatim
7398 #. type: verbatim
7399 #: ../src/guestfs-actions.pod:804
7400 #, no-wrap
7401 msgid ""
7402 " int\n"
7403 " guestfs_blockdev_setrw (guestfs_h *g,\n"
7404 "                         const char *device);\n"
7405 "\n"
7406 msgstr ""
7407
7408 # type: textblock
7409 #. type: textblock
7410 #: ../src/guestfs-actions.pod:808 ../fish/guestfish-actions.pod:534
7411 msgid "Sets the block device named C<device> to read-write."
7412 msgstr ""
7413
7414 # type: =head2
7415 #. type: =head2
7416 #: ../src/guestfs-actions.pod:816
7417 msgid "guestfs_case_sensitive_path"
7418 msgstr ""
7419
7420 # type: verbatim
7421 #. type: verbatim
7422 #: ../src/guestfs-actions.pod:818
7423 #, no-wrap
7424 msgid ""
7425 " char *\n"
7426 " guestfs_case_sensitive_path (guestfs_h *g,\n"
7427 "                              const char *path);\n"
7428 "\n"
7429 msgstr ""
7430
7431 # type: textblock
7432 #. type: textblock
7433 #: ../src/guestfs-actions.pod:822 ../fish/guestfish-actions.pod:542
7434 msgid ""
7435 "This can be used to resolve case insensitive paths on a filesystem which is "
7436 "case sensitive.  The use case is to resolve paths which you have read from "
7437 "Windows configuration files or the Windows Registry, to the true path."
7438 msgstr ""
7439
7440 # type: textblock
7441 #. type: textblock
7442 #: ../src/guestfs-actions.pod:827 ../fish/guestfish-actions.pod:547
7443 msgid ""
7444 "The command handles a peculiarity of the Linux ntfs-3g filesystem driver "
7445 "(and probably others), which is that although the underlying filesystem is "
7446 "case-insensitive, the driver exports the filesystem to Linux as case-"
7447 "sensitive."
7448 msgstr ""
7449
7450 # type: textblock
7451 #. type: textblock
7452 #: ../src/guestfs-actions.pod:832 ../fish/guestfish-actions.pod:552
7453 msgid ""
7454 "One consequence of this is that special directories such as C<c:\\windows> "
7455 "may appear as C</WINDOWS> or C</windows> (or other things) depending on the "
7456 "precise details of how they were created.  In Windows itself this would not "
7457 "be a problem."
7458 msgstr ""
7459
7460 # type: textblock
7461 #. type: textblock
7462 #: ../src/guestfs-actions.pod:838 ../fish/guestfish-actions.pod:558
7463 msgid ""
7464 "Bug or feature? You decide: L<http://www.tuxera.com/community/ntfs-3g-faq/"
7465 "#posixfilenames1>"
7466 msgstr ""
7467
7468 # type: textblock
7469 #. type: textblock
7470 #: ../src/guestfs-actions.pod:841 ../fish/guestfish-actions.pod:561
7471 msgid ""
7472 "This function resolves the true case of each element in the path and returns "
7473 "the case-sensitive path."
7474 msgstr ""
7475
7476 # type: textblock
7477 #. type: textblock
7478 #: ../src/guestfs-actions.pod:844
7479 msgid ""
7480 "Thus C<guestfs_case_sensitive_path> (\"/Windows/System32\")  might return C<"
7481 "\"/WINDOWS/system32\"> (the exact return value would depend on details of "
7482 "how the directories were originally created under Windows)."
7483 msgstr ""
7484
7485 # type: textblock
7486 #. type: textblock
7487 #: ../src/guestfs-actions.pod:849 ../fish/guestfish-actions.pod:569
7488 msgid "I<Note>: This function does not handle drive names, backslashes etc."
7489 msgstr ""
7490
7491 # type: textblock
7492 #. type: textblock
7493 #: ../src/guestfs-actions.pod:852
7494 msgid "See also C<guestfs_realpath>."
7495 msgstr ""
7496
7497 # type: textblock
7498 #. type: textblock
7499 #: ../src/guestfs-actions.pod:857 ../src/guestfs-actions.pod:6704
7500 msgid "(Added in 1.0.75)"
7501 msgstr ""
7502
7503 # type: =head2
7504 #. type: =head2
7505 #: ../src/guestfs-actions.pod:859
7506 msgid "guestfs_cat"
7507 msgstr ""
7508
7509 # type: verbatim
7510 #. type: verbatim
7511 #: ../src/guestfs-actions.pod:861
7512 #, no-wrap
7513 msgid ""
7514 " char *\n"
7515 " guestfs_cat (guestfs_h *g,\n"
7516 "              const char *path);\n"
7517 "\n"
7518 msgstr ""
7519
7520 # type: textblock
7521 #. type: textblock
7522 #: ../src/guestfs-actions.pod:865 ../src/guestfs-actions.pod:5249
7523 #: ../fish/guestfish-actions.pod:578 ../fish/guestfish-actions.pod:3501
7524 msgid "Return the contents of the file named C<path>."
7525 msgstr ""
7526
7527 # type: textblock
7528 #. type: textblock
7529 #: ../src/guestfs-actions.pod:867
7530 msgid ""
7531 "Note that this function cannot correctly handle binary files (specifically, "
7532 "files containing C<\\0> character which is treated as end of string).  For "
7533 "those you need to use the C<guestfs_read_file> or C<guestfs_download> "
7534 "functions which have a more complex interface."
7535 msgstr ""
7536
7537 # type: textblock
7538 #. type: textblock
7539 #: ../src/guestfs-actions.pod:875 ../src/guestfs-actions.pod:1054
7540 #: ../src/guestfs-actions.pod:1074 ../src/guestfs-actions.pod:1365
7541 #: ../src/guestfs-actions.pod:1384 ../src/guestfs-actions.pod:1487
7542 #: ../src/guestfs-actions.pod:1506 ../src/guestfs-actions.pod:1752
7543 #: ../src/guestfs-actions.pod:2200 ../src/guestfs-actions.pod:2219
7544 #: ../src/guestfs-actions.pod:2284 ../src/guestfs-actions.pod:2308
7545 #: ../src/guestfs-actions.pod:2325 ../src/guestfs-actions.pod:2354
7546 #: ../src/guestfs-actions.pod:5031 ../src/guestfs-actions.pod:5057
7547 #: ../src/guestfs-actions.pod:5188 ../src/guestfs-actions.pod:5214
7548 #: ../src/guestfs-actions.pod:5238 ../src/guestfs-actions.pod:6089
7549 #: ../src/guestfs-actions.pod:6144 ../src/guestfs-actions.pod:6290
7550 #: ../src/guestfs-actions.pod:6314 ../src/guestfs-actions.pod:6976
7551 #: ../src/guestfs-actions.pod:7002 ../src/guestfs-actions.pod:7028
7552 #: ../src/guestfs-actions.pod:7047 ../src/guestfs-actions.pod:7132
7553 #: ../src/guestfs-actions.pod:7151 ../src/guestfs-actions.pod:7197
7554 #: ../src/guestfs-actions.pod:7216 ../fish/guestfish-actions.pod:585
7555 #: ../fish/guestfish-actions.pod:720 ../fish/guestfish-actions.pod:732
7556 #: ../fish/guestfish-actions.pod:908 ../fish/guestfish-actions.pod:918
7557 #: ../fish/guestfish-actions.pod:985 ../fish/guestfish-actions.pod:995
7558 #: ../fish/guestfish-actions.pod:1187 ../fish/guestfish-actions.pod:1482
7559 #: ../fish/guestfish-actions.pod:1492 ../fish/guestfish-actions.pod:1542
7560 #: ../fish/guestfish-actions.pod:1557 ../fish/guestfish-actions.pod:1567
7561 #: ../fish/guestfish-actions.pod:1586 ../fish/guestfish-actions.pod:3371
7562 #: ../fish/guestfish-actions.pod:3386 ../fish/guestfish-actions.pod:3462
7563 #: ../fish/guestfish-actions.pod:3479 ../fish/guestfish-actions.pod:3494
7564 #: ../fish/guestfish-actions.pod:4077 ../fish/guestfish-actions.pod:4123
7565 #: ../fish/guestfish-actions.pod:4208 ../fish/guestfish-actions.pod:4223
7566 #: ../fish/guestfish-actions.pod:4633 ../fish/guestfish-actions.pod:4651
7567 #: ../fish/guestfish-actions.pod:4668 ../fish/guestfish-actions.pod:4678
7568 #: ../fish/guestfish-actions.pod:4726 ../fish/guestfish-actions.pod:4736
7569 #: ../fish/guestfish-actions.pod:4765 ../fish/guestfish-actions.pod:4775
7570 msgid ""
7571 "Because of the message protocol, there is a transfer limit of somewhere "
7572 "between 2MB and 4MB.  See L<guestfs(3)/PROTOCOL LIMITS>."
7573 msgstr ""
7574
7575 # type: textblock
7576 #. type: textblock
7577 #: ../src/guestfs-actions.pod:878 ../src/guestfs-actions.pod:3350
7578 #: ../src/guestfs-actions.pod:3412 ../src/guestfs-actions.pod:3429
7579 #: ../src/guestfs-actions.pod:3517 ../src/guestfs-actions.pod:3922
7580 #: ../src/guestfs-actions.pod:3936 ../src/guestfs-actions.pod:5137
7581 #: ../src/guestfs-actions.pod:5151 ../src/guestfs-actions.pod:6863
7582 #: ../src/guestfs-actions.pod:6877
7583 msgid "(Added in 0.4)"
7584 msgstr ""
7585
7586 # type: =head2
7587 #. type: =head2
7588 #: ../src/guestfs-actions.pod:880
7589 msgid "guestfs_checksum"
7590 msgstr ""
7591
7592 # type: verbatim
7593 #. type: verbatim
7594 #: ../src/guestfs-actions.pod:882
7595 #, no-wrap
7596 msgid ""
7597 " char *\n"
7598 " guestfs_checksum (guestfs_h *g,\n"
7599 "                   const char *csumtype,\n"
7600 "                   const char *path);\n"
7601 "\n"
7602 msgstr ""
7603
7604 # type: textblock
7605 #. type: textblock
7606 #: ../src/guestfs-actions.pod:887 ../fish/guestfish-actions.pod:592
7607 msgid ""
7608 "This call computes the MD5, SHAx or CRC checksum of the file named C<path>."
7609 msgstr ""
7610
7611 # type: textblock
7612 #. type: textblock
7613 #: ../src/guestfs-actions.pod:890 ../fish/guestfish-actions.pod:595
7614 msgid ""
7615 "The type of checksum to compute is given by the C<csumtype> parameter which "
7616 "must have one of the following values:"
7617 msgstr ""
7618
7619 # type: =item
7620 #. type: =item
7621 #: ../src/guestfs-actions.pod:895 ../fish/guestfish-actions.pod:600
7622 msgid "C<crc>"
7623 msgstr ""
7624
7625 # type: textblock
7626 #. type: textblock
7627 #: ../src/guestfs-actions.pod:897 ../fish/guestfish-actions.pod:602
7628 msgid ""
7629 "Compute the cyclic redundancy check (CRC) specified by POSIX for the "
7630 "C<cksum> command."
7631 msgstr ""
7632
7633 # type: =item
7634 #. type: =item
7635 #: ../src/guestfs-actions.pod:900 ../fish/guestfish-actions.pod:605
7636 msgid "C<md5>"
7637 msgstr ""
7638
7639 # type: textblock
7640 #. type: textblock
7641 #: ../src/guestfs-actions.pod:902 ../fish/guestfish-actions.pod:607
7642 msgid "Compute the MD5 hash (using the C<md5sum> program)."
7643 msgstr ""
7644
7645 # type: =item
7646 #. type: =item
7647 #: ../src/guestfs-actions.pod:904 ../fish/guestfish-actions.pod:609
7648 msgid "C<sha1>"
7649 msgstr ""
7650
7651 # type: textblock
7652 #. type: textblock
7653 #: ../src/guestfs-actions.pod:906 ../fish/guestfish-actions.pod:611
7654 msgid "Compute the SHA1 hash (using the C<sha1sum> program)."
7655 msgstr ""
7656
7657 # type: =item
7658 #. type: =item
7659 #: ../src/guestfs-actions.pod:908 ../fish/guestfish-actions.pod:613
7660 msgid "C<sha224>"
7661 msgstr ""
7662
7663 # type: textblock
7664 #. type: textblock
7665 #: ../src/guestfs-actions.pod:910 ../fish/guestfish-actions.pod:615
7666 msgid "Compute the SHA224 hash (using the C<sha224sum> program)."
7667 msgstr ""
7668
7669 # type: =item
7670 #. type: =item
7671 #: ../src/guestfs-actions.pod:912 ../fish/guestfish-actions.pod:617
7672 msgid "C<sha256>"
7673 msgstr ""
7674
7675 # type: textblock
7676 #. type: textblock
7677 #: ../src/guestfs-actions.pod:914 ../fish/guestfish-actions.pod:619
7678 msgid "Compute the SHA256 hash (using the C<sha256sum> program)."
7679 msgstr ""
7680
7681 # type: =item
7682 #. type: =item
7683 #: ../src/guestfs-actions.pod:916 ../fish/guestfish-actions.pod:621
7684 msgid "C<sha384>"
7685 msgstr ""
7686
7687 # type: textblock
7688 #. type: textblock
7689 #: ../src/guestfs-actions.pod:918 ../fish/guestfish-actions.pod:623
7690 msgid "Compute the SHA384 hash (using the C<sha384sum> program)."
7691 msgstr ""
7692
7693 # type: =item
7694 #. type: =item
7695 #: ../src/guestfs-actions.pod:920 ../fish/guestfish-actions.pod:625
7696 msgid "C<sha512>"
7697 msgstr ""
7698
7699 # type: textblock
7700 #. type: textblock
7701 #: ../src/guestfs-actions.pod:922 ../fish/guestfish-actions.pod:627
7702 msgid "Compute the SHA512 hash (using the C<sha512sum> program)."
7703 msgstr ""
7704
7705 # type: textblock
7706 #. type: textblock
7707 #: ../src/guestfs-actions.pod:926 ../fish/guestfish-actions.pod:631
7708 msgid "The checksum is returned as a printable string."
7709 msgstr ""
7710
7711 # type: textblock
7712 #. type: textblock
7713 #: ../src/guestfs-actions.pod:928
7714 msgid "To get the checksum for a device, use C<guestfs_checksum_device>."
7715 msgstr ""
7716
7717 # type: textblock
7718 #. type: textblock
7719 #: ../src/guestfs-actions.pod:930
7720 msgid "To get the checksums for many files, use C<guestfs_checksums_out>."
7721 msgstr ""
7722
7723 # type: textblock
7724 #. type: textblock
7725 #: ../src/guestfs-actions.pod:935 ../src/guestfs-actions.pod:1243
7726 #: ../src/guestfs-actions.pod:2062 ../src/guestfs-actions.pod:3094
7727 #: ../src/guestfs-actions.pod:3123 ../src/guestfs-actions.pod:3184
7728 #: ../src/guestfs-actions.pod:3211 ../src/guestfs-actions.pod:6560
7729 msgid "(Added in 1.0.2)"
7730 msgstr ""
7731
7732 # type: =head2
7733 #. type: =head2
7734 #: ../src/guestfs-actions.pod:937
7735 msgid "guestfs_checksum_device"
7736 msgstr ""
7737
7738 # type: verbatim
7739 #. type: verbatim
7740 #: ../src/guestfs-actions.pod:939
7741 #, no-wrap
7742 msgid ""
7743 " char *\n"
7744 " guestfs_checksum_device (guestfs_h *g,\n"
7745 "                          const char *csumtype,\n"
7746 "                          const char *device);\n"
7747 "\n"
7748 msgstr ""
7749
7750 # type: textblock
7751 #. type: textblock
7752 #: ../src/guestfs-actions.pod:944
7753 msgid ""
7754 "This call computes the MD5, SHAx or CRC checksum of the contents of the "
7755 "device named C<device>.  For the types of checksums supported see the "
7756 "C<guestfs_checksum> command."
7757 msgstr ""
7758
7759 # type: textblock
7760 #. type: textblock
7761 #: ../src/guestfs-actions.pod:951 ../src/guestfs-actions.pod:4668
7762 #: ../src/guestfs-actions.pod:4727 ../src/guestfs-actions.pod:4764
7763 #: ../src/guestfs-actions.pod:4782 ../src/guestfs-actions.pod:4958
7764 #: ../src/guestfs-actions.pod:6469 ../src/guestfs-actions.pod:6483
7765 #: ../src/guestfs-actions.pod:6889
7766 msgid "(Added in 1.3.2)"
7767 msgstr ""
7768
7769 # type: =head2
7770 #. type: =head2
7771 #: ../src/guestfs-actions.pod:953
7772 msgid "guestfs_checksums_out"
7773 msgstr ""
7774
7775 # type: verbatim
7776 #. type: verbatim
7777 #: ../src/guestfs-actions.pod:955
7778 #, no-wrap
7779 msgid ""
7780 " int\n"
7781 " guestfs_checksums_out (guestfs_h *g,\n"
7782 "                        const char *csumtype,\n"
7783 "                        const char *directory,\n"
7784 "                        const char *sumsfile);\n"
7785 "\n"
7786 msgstr ""
7787
7788 # type: textblock
7789 #. type: textblock
7790 #: ../src/guestfs-actions.pod:961 ../fish/guestfish-actions.pod:649
7791 msgid ""
7792 "This command computes the checksums of all regular files in C<directory> and "
7793 "then emits a list of those checksums to the local output file C<sumsfile>."
7794 msgstr ""
7795
7796 # type: textblock
7797 #. type: textblock
7798 #: ../src/guestfs-actions.pod:965 ../fish/guestfish-actions.pod:653
7799 msgid ""
7800 "This can be used for verifying the integrity of a virtual machine.  However "
7801 "to be properly secure you should pay attention to the output of the checksum "
7802 "command (it uses the ones from GNU coreutils).  In particular when the "
7803 "filename is not printable, coreutils uses a special backslash syntax.  For "
7804 "more information, see the GNU coreutils info file."
7805 msgstr ""
7806
7807 # type: textblock
7808 #. type: textblock
7809 #: ../src/guestfs-actions.pod:975
7810 msgid "(Added in 1.3.7)"
7811 msgstr ""
7812
7813 # type: =head2
7814 #. type: =head2
7815 #: ../src/guestfs-actions.pod:977
7816 msgid "guestfs_chmod"
7817 msgstr ""
7818
7819 # type: verbatim
7820 #. type: verbatim
7821 #: ../src/guestfs-actions.pod:979
7822 #, no-wrap
7823 msgid ""
7824 " int\n"
7825 " guestfs_chmod (guestfs_h *g,\n"
7826 "                int mode,\n"
7827 "                const char *path);\n"
7828 "\n"
7829 msgstr ""
7830
7831 # type: textblock
7832 #. type: textblock
7833 #: ../src/guestfs-actions.pod:984 ../fish/guestfish-actions.pod:667
7834 msgid ""
7835 "Change the mode (permissions) of C<path> to C<mode>.  Only numeric modes are "
7836 "supported."
7837 msgstr ""
7838
7839 # type: textblock
7840 #. type: textblock
7841 #: ../src/guestfs-actions.pod:987 ../fish/guestfish-actions.pod:670
7842 msgid ""
7843 "I<Note>: When using this command from guestfish, C<mode> by default would be "
7844 "decimal, unless you prefix it with C<0> to get octal, ie. use C<0700> not "
7845 "C<700>."
7846 msgstr ""
7847
7848 # type: textblock
7849 #. type: textblock
7850 #: ../src/guestfs-actions.pod:991 ../src/guestfs-actions.pod:4173
7851 #: ../src/guestfs-actions.pod:4358 ../src/guestfs-actions.pod:4377
7852 #: ../src/guestfs-actions.pod:4396 ../fish/guestfish-actions.pod:674
7853 #: ../fish/guestfish-actions.pod:2819 ../fish/guestfish-actions.pod:2937
7854 #: ../fish/guestfish-actions.pod:2947 ../fish/guestfish-actions.pod:2957
7855 msgid "The mode actually set is affected by the umask."
7856 msgstr ""
7857
7858 # type: =head2
7859 #. type: =head2
7860 #: ../src/guestfs-actions.pod:997
7861 msgid "guestfs_chown"
7862 msgstr ""
7863
7864 # type: verbatim
7865 #. type: verbatim
7866 #: ../src/guestfs-actions.pod:999
7867 #, no-wrap
7868 msgid ""
7869 " int\n"
7870 " guestfs_chown (guestfs_h *g,\n"
7871 "                int owner,\n"
7872 "                int group,\n"
7873 "                const char *path);\n"
7874 "\n"
7875 msgstr ""
7876
7877 # type: textblock
7878 #. type: textblock
7879 #: ../src/guestfs-actions.pod:1005 ../fish/guestfish-actions.pod:680
7880 msgid "Change the file owner to C<owner> and group to C<group>."
7881 msgstr ""
7882
7883 # type: textblock
7884 #. type: textblock
7885 #: ../src/guestfs-actions.pod:1007 ../src/guestfs-actions.pod:3281
7886 #: ../fish/guestfish-actions.pod:682 ../fish/guestfish-actions.pod:2277
7887 msgid ""
7888 "Only numeric uid and gid are supported.  If you want to use names, you will "
7889 "need to locate and parse the password file yourself (Augeas support makes "
7890 "this relatively easy)."
7891 msgstr ""
7892
7893 # type: =head2
7894 #. type: =head2
7895 #: ../src/guestfs-actions.pod:1015
7896 msgid "guestfs_command"
7897 msgstr ""
7898
7899 # type: verbatim
7900 #. type: verbatim
7901 #: ../src/guestfs-actions.pod:1017
7902 #, no-wrap
7903 msgid ""
7904 " char *\n"
7905 " guestfs_command (guestfs_h *g,\n"
7906 "                  char *const *arguments);\n"
7907 "\n"
7908 msgstr ""
7909
7910 # type: textblock
7911 #. type: textblock
7912 #: ../src/guestfs-actions.pod:1021 ../fish/guestfish-actions.pod:690
7913 msgid ""
7914 "This call runs a command from the guest filesystem.  The filesystem must be "
7915 "mounted, and must contain a compatible operating system (ie. something "
7916 "Linux, with the same or compatible processor architecture)."
7917 msgstr ""
7918
7919 # type: textblock
7920 #. type: textblock
7921 #: ../src/guestfs-actions.pod:1026
7922 msgid ""
7923 "The single parameter is an argv-style list of arguments.  The first element "
7924 "is the name of the program to run.  Subsequent elements are parameters.  The "
7925 "list must be non-empty (ie. must contain a program name).  Note that the "
7926 "command runs directly, and is I<not> invoked via the shell (see "
7927 "C<guestfs_sh>)."
7928 msgstr ""
7929
7930 # type: textblock
7931 #. type: textblock
7932 #: ../src/guestfs-actions.pod:1033 ../fish/guestfish-actions.pod:702
7933 msgid "The return value is anything printed to I<stdout> by the command."
7934 msgstr ""
7935
7936 # type: textblock
7937 #. type: textblock
7938 #: ../src/guestfs-actions.pod:1036 ../fish/guestfish-actions.pod:705
7939 msgid ""
7940 "If the command returns a non-zero exit status, then this function returns an "
7941 "error message.  The error message string is the content of I<stderr> from "
7942 "the command."
7943 msgstr ""
7944
7945 # type: textblock
7946 #. type: textblock
7947 #: ../src/guestfs-actions.pod:1040 ../fish/guestfish-actions.pod:709
7948 msgid ""
7949 "The C<$PATH> environment variable will contain at least C</usr/bin> and C</"
7950 "bin>.  If you require a program from another location, you should provide "
7951 "the full path in the first parameter."
7952 msgstr ""
7953
7954 # type: textblock
7955 #. type: textblock
7956 #: ../src/guestfs-actions.pod:1045 ../fish/guestfish-actions.pod:714
7957 msgid ""
7958 "Shared libraries and data files required by the program must be available on "
7959 "filesystems which are mounted in the correct places.  It is the caller's "
7960 "responsibility to ensure all filesystems that are needed are mounted at the "
7961 "right locations."
7962 msgstr ""
7963
7964 # type: textblock
7965 #. type: textblock
7966 #: ../src/guestfs-actions.pod:1057 ../src/guestfs-actions.pod:1077
7967 #: ../src/guestfs-actions.pod:1537
7968 msgid "(Added in 0.9.1)"
7969 msgstr ""
7970
7971 # type: =head2
7972 #. type: =head2
7973 #: ../src/guestfs-actions.pod:1059
7974 msgid "guestfs_command_lines"
7975 msgstr ""
7976
7977 # type: verbatim
7978 #. type: verbatim
7979 #: ../src/guestfs-actions.pod:1061
7980 #, no-wrap
7981 msgid ""
7982 " char **\n"
7983 " guestfs_command_lines (guestfs_h *g,\n"
7984 "                        char *const *arguments);\n"
7985 "\n"
7986 msgstr ""
7987
7988 # type: textblock
7989 #. type: textblock
7990 #: ../src/guestfs-actions.pod:1065
7991 msgid ""
7992 "This is the same as C<guestfs_command>, but splits the result into a list of "
7993 "lines."
7994 msgstr ""
7995
7996 # type: textblock
7997 #. type: textblock
7998 #: ../src/guestfs-actions.pod:1068
7999 msgid "See also: C<guestfs_sh_lines>"
8000 msgstr ""
8001
8002 # type: =head2
8003 #. type: =head2
8004 #: ../src/guestfs-actions.pod:1079
8005 msgid "guestfs_config"
8006 msgstr ""
8007
8008 # type: verbatim
8009 #. type: verbatim
8010 #: ../src/guestfs-actions.pod:1081
8011 #, no-wrap
8012 msgid ""
8013 " int\n"
8014 " guestfs_config (guestfs_h *g,\n"
8015 "                 const char *qemuparam,\n"
8016 "                 const char *qemuvalue);\n"
8017 "\n"
8018 msgstr ""
8019
8020 # type: textblock
8021 #. type: textblock
8022 #: ../src/guestfs-actions.pod:1086 ../fish/guestfish-actions.pod:739
8023 msgid ""
8024 "This can be used to add arbitrary qemu command line parameters of the form "
8025 "C<-param value>.  Actually it's not quite arbitrary - we prevent you from "
8026 "setting some parameters which would interfere with parameters that we use."
8027 msgstr ""
8028
8029 # type: textblock
8030 #. type: textblock
8031 #: ../src/guestfs-actions.pod:1091 ../fish/guestfish-actions.pod:744
8032 msgid "The first character of C<param> string must be a C<-> (dash)."
8033 msgstr ""
8034
8035 # type: textblock
8036 #. type: textblock
8037 #: ../src/guestfs-actions.pod:1093 ../fish/guestfish-actions.pod:746
8038 msgid "C<value> can be NULL."
8039 msgstr ""
8040
8041 # type: =head2
8042 #. type: =head2
8043 #: ../src/guestfs-actions.pod:1099
8044 msgid "guestfs_copy_size"
8045 msgstr ""
8046
8047 # type: verbatim
8048 #. type: verbatim
8049 #: ../src/guestfs-actions.pod:1101
8050 #, no-wrap
8051 msgid ""
8052 " int\n"
8053 " guestfs_copy_size (guestfs_h *g,\n"
8054 "                    const char *src,\n"
8055 "                    const char *dest,\n"
8056 "                    int64_t size);\n"
8057 "\n"
8058 msgstr ""
8059
8060 # type: textblock
8061 #. type: textblock
8062 #: ../src/guestfs-actions.pod:1107 ../fish/guestfish-actions.pod:752
8063 msgid ""
8064 "This command copies exactly C<size> bytes from one source device or file "
8065 "C<src> to another destination device or file C<dest>."
8066 msgstr ""
8067
8068 # type: textblock
8069 #. type: textblock
8070 #: ../src/guestfs-actions.pod:1110 ../fish/guestfish-actions.pod:755
8071 msgid ""
8072 "Note this will fail if the source is too short or if the destination is not "
8073 "large enough."
8074 msgstr ""
8075
8076 # type: textblock
8077 #. type: textblock
8078 #: ../src/guestfs-actions.pod:1115 ../src/guestfs-actions.pod:1238
8079 #: ../src/guestfs-actions.pod:1269 ../src/guestfs-actions.pod:1686
8080 #: ../src/guestfs-actions.pod:1708 ../src/guestfs-actions.pod:6555
8081 #: ../src/guestfs-actions.pod:6589 ../src/guestfs-actions.pod:7068
8082 #: ../src/guestfs-actions.pod:7087
8083 msgid ""
8084 "This long-running command can generate progress notification messages so "
8085 "that the caller can display a progress bar or indicator.  To receive these "
8086 "messages, the caller must register a progress callback.  See L<guestfs(3)/"
8087 "guestfs_set_progress_callback>."
8088 msgstr ""
8089
8090 # type: textblock
8091 #. type: textblock
8092 #: ../src/guestfs-actions.pod:1120 ../src/guestfs-actions.pod:3949
8093 #: ../src/guestfs-actions.pod:5164 ../src/guestfs-actions.pod:6796
8094 #: ../src/guestfs-actions.pod:6816 ../src/guestfs-actions.pod:6902
8095 msgid "(Added in 1.0.87)"
8096 msgstr ""
8097
8098 # type: =head2
8099 #. type: =head2
8100 #: ../src/guestfs-actions.pod:1122
8101 msgid "guestfs_cp"
8102 msgstr ""
8103
8104 # type: verbatim
8105 #. type: verbatim
8106 #: ../src/guestfs-actions.pod:1124
8107 #, no-wrap
8108 msgid ""
8109 " int\n"
8110 " guestfs_cp (guestfs_h *g,\n"
8111 "             const char *src,\n"
8112 "             const char *dest);\n"
8113 "\n"
8114 msgstr ""
8115
8116 # type: textblock
8117 #. type: textblock
8118 #: ../src/guestfs-actions.pod:1129 ../fish/guestfish-actions.pod:762
8119 msgid ""
8120 "This copies a file from C<src> to C<dest> where C<dest> is either a "
8121 "destination filename or destination directory."
8122 msgstr ""
8123
8124 # type: textblock
8125 #. type: textblock
8126 #: ../src/guestfs-actions.pod:1134 ../src/guestfs-actions.pod:1148
8127 #: ../src/guestfs-actions.pod:1220 ../src/guestfs-actions.pod:1294
8128 #: ../src/guestfs-actions.pod:1403 ../src/guestfs-actions.pod:4622
8129 #: ../src/guestfs-actions.pod:5008
8130 msgid "(Added in 1.0.18)"
8131 msgstr ""
8132
8133 # type: =head2
8134 #. type: =head2
8135 #: ../src/guestfs-actions.pod:1136
8136 msgid "guestfs_cp_a"
8137 msgstr ""
8138
8139 # type: verbatim
8140 #. type: verbatim
8141 #: ../src/guestfs-actions.pod:1138
8142 #, no-wrap
8143 msgid ""
8144 " int\n"
8145 " guestfs_cp_a (guestfs_h *g,\n"
8146 "               const char *src,\n"
8147 "               const char *dest);\n"
8148 "\n"
8149 msgstr ""
8150
8151 # type: textblock
8152 #. type: textblock
8153 #: ../src/guestfs-actions.pod:1143 ../fish/guestfish-actions.pod:769
8154 msgid ""
8155 "This copies a file or directory from C<src> to C<dest> recursively using the "
8156 "C<cp -a> command."
8157 msgstr ""
8158
8159 # type: =head2
8160 #. type: =head2
8161 #: ../src/guestfs-actions.pod:1150
8162 msgid "guestfs_dd"
8163 msgstr ""
8164
8165 # type: verbatim
8166 #. type: verbatim
8167 #: ../src/guestfs-actions.pod:1152
8168 #, no-wrap
8169 msgid ""
8170 " int\n"
8171 " guestfs_dd (guestfs_h *g,\n"
8172 "             const char *src,\n"
8173 "             const char *dest);\n"
8174 "\n"
8175 msgstr ""
8176
8177 # type: textblock
8178 #. type: textblock
8179 #: ../src/guestfs-actions.pod:1157 ../fish/guestfish-actions.pod:776
8180 msgid ""
8181 "This command copies from one source device or file C<src> to another "
8182 "destination device or file C<dest>.  Normally you would use this to copy to "
8183 "or from a device or partition, for example to duplicate a filesystem."
8184 msgstr ""
8185
8186 # type: textblock
8187 #. type: textblock
8188 #: ../src/guestfs-actions.pod:1162
8189 msgid ""
8190 "If the destination is a device, it must be as large or larger than the "
8191 "source file or device, otherwise the copy will fail.  This command cannot do "
8192 "partial copies (see C<guestfs_copy_size>)."
8193 msgstr ""
8194
8195 # type: =head2
8196 #. type: =head2
8197 #: ../src/guestfs-actions.pod:1170
8198 msgid "guestfs_df"
8199 msgstr ""
8200
8201 # type: verbatim
8202 #. type: verbatim
8203 #: ../src/guestfs-actions.pod:1172
8204 #, no-wrap
8205 msgid ""
8206 " char *\n"
8207 " guestfs_df (guestfs_h *g);\n"
8208 "\n"
8209 msgstr ""
8210
8211 # type: textblock
8212 #. type: textblock
8213 #: ../src/guestfs-actions.pod:1175 ../fish/guestfish-actions.pod:789
8214 msgid "This command runs the C<df> command to report disk space used."
8215 msgstr ""
8216
8217 # type: textblock
8218 #. type: textblock
8219 #: ../src/guestfs-actions.pod:1177 ../src/guestfs-actions.pod:1194
8220 msgid ""
8221 "This command is mostly useful for interactive sessions.  It is I<not> "
8222 "intended that you try to parse the output string.  Use C<guestfs_statvfs> "
8223 "from programs."
8224 msgstr ""
8225
8226 # type: textblock
8227 #. type: textblock
8228 #: ../src/guestfs-actions.pod:1184 ../src/guestfs-actions.pod:1201
8229 #: ../src/guestfs-actions.pod:1314 ../src/guestfs-actions.pod:2287
8230 #: ../src/guestfs-actions.pod:2311 ../src/guestfs-actions.pod:2379
8231 #: ../src/guestfs-actions.pod:4059 ../src/guestfs-actions.pod:4522
8232 #: ../src/guestfs-actions.pod:6293 ../src/guestfs-actions.pod:6317
8233 #: ../src/guestfs-actions.pod:6935 ../src/guestfs-actions.pod:6948
8234 #: ../src/guestfs-actions.pod:6961
8235 msgid "(Added in 1.0.54)"
8236 msgstr ""
8237
8238 # type: =head2
8239 #. type: =head2
8240 #: ../src/guestfs-actions.pod:1186
8241 msgid "guestfs_df_h"
8242 msgstr ""
8243
8244 # type: verbatim
8245 #. type: verbatim
8246 #: ../src/guestfs-actions.pod:1188
8247 #, no-wrap
8248 msgid ""
8249 " char *\n"
8250 " guestfs_df_h (guestfs_h *g);\n"
8251 "\n"
8252 msgstr ""
8253
8254 # type: textblock
8255 #. type: textblock
8256 #: ../src/guestfs-actions.pod:1191 ../fish/guestfish-actions.pod:799
8257 msgid ""
8258 "This command runs the C<df -h> command to report disk space used in human-"
8259 "readable format."
8260 msgstr ""
8261
8262 # type: =head2
8263 #. type: =head2
8264 #: ../src/guestfs-actions.pod:1203
8265 msgid "guestfs_dmesg"
8266 msgstr ""
8267
8268 # type: verbatim
8269 #. type: verbatim
8270 #: ../src/guestfs-actions.pod:1205
8271 #, no-wrap
8272 msgid ""
8273 " char *\n"
8274 " guestfs_dmesg (guestfs_h *g);\n"
8275 "\n"
8276 msgstr ""
8277
8278 # type: textblock
8279 #. type: textblock
8280 #: ../src/guestfs-actions.pod:1208 ../fish/guestfish-actions.pod:810
8281 msgid ""
8282 "This returns the kernel messages (C<dmesg> output) from the guest kernel.  "
8283 "This is sometimes useful for extended debugging of problems."
8284 msgstr ""
8285
8286 # type: textblock
8287 #. type: textblock
8288 #: ../src/guestfs-actions.pod:1212
8289 msgid ""
8290 "Another way to get the same information is to enable verbose messages with "
8291 "C<guestfs_set_verbose> or by setting the environment variable "
8292 "C<LIBGUESTFS_DEBUG=1> before running the program."
8293 msgstr ""
8294
8295 # type: =head2
8296 #. type: =head2
8297 #: ../src/guestfs-actions.pod:1222
8298 msgid "guestfs_download"
8299 msgstr ""
8300
8301 # type: verbatim
8302 #. type: verbatim
8303 #: ../src/guestfs-actions.pod:1224
8304 #, no-wrap
8305 msgid ""
8306 " int\n"
8307 " guestfs_download (guestfs_h *g,\n"
8308 "                   const char *remotefilename,\n"
8309 "                   const char *filename);\n"
8310 "\n"
8311 msgstr ""
8312
8313 # type: textblock
8314 #. type: textblock
8315 #: ../src/guestfs-actions.pod:1229 ../src/guestfs-actions.pod:1254
8316 #: ../fish/guestfish-actions.pod:823 ../fish/guestfish-actions.pod:836
8317 msgid ""
8318 "Download file C<remotefilename> and save it as C<filename> on the local "
8319 "machine."
8320 msgstr ""
8321
8322 # type: textblock
8323 #. type: textblock
8324 #: ../src/guestfs-actions.pod:1232 ../src/guestfs-actions.pod:6549
8325 #: ../fish/guestfish-actions.pod:826 ../fish/guestfish-actions.pod:4381
8326 msgid "C<filename> can also be a named pipe."
8327 msgstr ""
8328
8329 # type: textblock
8330 #. type: textblock
8331 #: ../src/guestfs-actions.pod:1234
8332 msgid "See also C<guestfs_upload>, C<guestfs_cat>."
8333 msgstr ""
8334
8335 # type: =head2
8336 #. type: =head2
8337 #: ../src/guestfs-actions.pod:1245
8338 msgid "guestfs_download_offset"
8339 msgstr ""
8340
8341 # type: verbatim
8342 #. type: verbatim
8343 #: ../src/guestfs-actions.pod:1247
8344 #, no-wrap
8345 msgid ""
8346 " int\n"
8347 " guestfs_download_offset (guestfs_h *g,\n"
8348 "                          const char *remotefilename,\n"
8349 "                          const char *filename,\n"
8350 "                          int64_t offset,\n"
8351 "                          int64_t size);\n"
8352 "\n"
8353 msgstr ""
8354
8355 # type: textblock
8356 #. type: textblock
8357 #: ../src/guestfs-actions.pod:1257 ../fish/guestfish-actions.pod:839
8358 msgid ""
8359 "C<remotefilename> is read for C<size> bytes starting at C<offset> (this "
8360 "region must be within the file or device)."
8361 msgstr ""
8362
8363 # type: textblock
8364 #. type: textblock
8365 #: ../src/guestfs-actions.pod:1260
8366 msgid ""
8367 "Note that there is no limit on the amount of data that can be downloaded "
8368 "with this call, unlike with C<guestfs_pread>, and this call always reads the "
8369 "full amount unless an error occurs."
8370 msgstr ""
8371
8372 # type: textblock
8373 #. type: textblock
8374 #: ../src/guestfs-actions.pod:1265
8375 msgid "See also C<guestfs_download>, C<guestfs_pread>."
8376 msgstr ""
8377
8378 # type: textblock
8379 #. type: textblock
8380 #: ../src/guestfs-actions.pod:1274 ../src/guestfs-actions.pod:6594
8381 msgid "(Added in 1.5.17)"
8382 msgstr ""
8383
8384 # type: =head2
8385 #. type: =head2
8386 #: ../src/guestfs-actions.pod:1276
8387 msgid "guestfs_drop_caches"
8388 msgstr ""
8389
8390 # type: verbatim
8391 #. type: verbatim
8392 #: ../src/guestfs-actions.pod:1278
8393 #, no-wrap
8394 msgid ""
8395 " int\n"
8396 " guestfs_drop_caches (guestfs_h *g,\n"
8397 "                      int whattodrop);\n"
8398 "\n"
8399 msgstr ""
8400
8401 # type: textblock
8402 #. type: textblock
8403 #: ../src/guestfs-actions.pod:1282 ../fish/guestfish-actions.pod:855
8404 msgid ""
8405 "This instructs the guest kernel to drop its page cache, and/or dentries and "
8406 "inode caches.  The parameter C<whattodrop> tells the kernel what precisely "
8407 "to drop, see L<http://linux-mm.org/Drop_Caches>"
8408 msgstr ""
8409
8410 # type: textblock
8411 #. type: textblock
8412 #: ../src/guestfs-actions.pod:1287 ../fish/guestfish-actions.pod:860
8413 msgid "Setting C<whattodrop> to 3 should drop everything."
8414 msgstr ""
8415
8416 # type: textblock
8417 #. type: textblock
8418 #: ../src/guestfs-actions.pod:1289 ../fish/guestfish-actions.pod:862
8419 msgid ""
8420 "This automatically calls L<sync(2)> before the operation, so that the "
8421 "maximum guest memory is freed."
8422 msgstr ""
8423
8424 # type: =head2
8425 #. type: =head2
8426 #: ../src/guestfs-actions.pod:1296
8427 msgid "guestfs_du"
8428 msgstr ""
8429
8430 # type: verbatim
8431 #. type: verbatim
8432 #: ../src/guestfs-actions.pod:1298
8433 #, no-wrap
8434 msgid ""
8435 " int64_t\n"
8436 " guestfs_du (guestfs_h *g,\n"
8437 "             const char *path);\n"
8438 "\n"
8439 msgstr ""
8440
8441 # type: textblock
8442 #. type: textblock
8443 #: ../src/guestfs-actions.pod:1302 ../fish/guestfish-actions.pod:869
8444 msgid ""
8445 "This command runs the C<du -s> command to estimate file space usage for "
8446 "C<path>."
8447 msgstr ""
8448
8449 # type: textblock
8450 #. type: textblock
8451 #: ../src/guestfs-actions.pod:1305 ../fish/guestfish-actions.pod:872
8452 msgid ""
8453 "C<path> can be a file or a directory.  If C<path> is a directory then the "
8454 "estimate includes the contents of the directory and all subdirectories "
8455 "(recursively)."
8456 msgstr ""
8457
8458 # type: textblock
8459 #. type: textblock
8460 #: ../src/guestfs-actions.pod:1309 ../fish/guestfish-actions.pod:876
8461 msgid ""
8462 "The result is the estimated size in I<kilobytes> (ie. units of 1024 bytes)."
8463 msgstr ""
8464
8465 # type: =head2
8466 #. type: =head2
8467 #: ../src/guestfs-actions.pod:1316
8468 msgid "guestfs_e2fsck_f"
8469 msgstr ""
8470
8471 # type: verbatim
8472 #. type: verbatim
8473 #: ../src/guestfs-actions.pod:1318
8474 #, no-wrap
8475 msgid ""
8476 " int\n"
8477 " guestfs_e2fsck_f (guestfs_h *g,\n"
8478 "                   const char *device);\n"
8479 "\n"
8480 msgstr ""
8481
8482 # type: textblock
8483 #. type: textblock
8484 #: ../src/guestfs-actions.pod:1322 ../fish/guestfish-actions.pod:883
8485 msgid ""
8486 "This runs C<e2fsck -p -f device>, ie. runs the ext2/ext3 filesystem checker "
8487 "on C<device>, noninteractively (C<-p>), even if the filesystem appears to be "
8488 "clean (C<-f>)."
8489 msgstr ""
8490
8491 # type: textblock
8492 #. type: textblock
8493 #: ../src/guestfs-actions.pod:1326
8494 msgid ""
8495 "This command is only needed because of C<guestfs_resize2fs> (q.v.).  "
8496 "Normally you should use C<guestfs_fsck>."
8497 msgstr ""
8498
8499 # type: textblock
8500 #. type: textblock
8501 #: ../src/guestfs-actions.pod:1331
8502 msgid "(Added in 1.0.29)"
8503 msgstr ""
8504
8505 # type: =head2
8506 #. type: =head2
8507 #: ../src/guestfs-actions.pod:1333
8508 msgid "guestfs_echo_daemon"
8509 msgstr ""
8510
8511 # type: verbatim
8512 #. type: verbatim
8513 #: ../src/guestfs-actions.pod:1335
8514 #, no-wrap
8515 msgid ""
8516 " char *\n"
8517 " guestfs_echo_daemon (guestfs_h *g,\n"
8518 "                      char *const *words);\n"
8519 "\n"
8520 msgstr ""
8521
8522 # type: textblock
8523 #. type: textblock
8524 #: ../src/guestfs-actions.pod:1339 ../fish/guestfish-actions.pod:894
8525 msgid ""
8526 "This command concatenates the list of C<words> passed with single spaces "
8527 "between them and returns the resulting string."
8528 msgstr ""
8529
8530 # type: textblock
8531 #. type: textblock
8532 #: ../src/guestfs-actions.pod:1342 ../fish/guestfish-actions.pod:897
8533 msgid "You can use this command to test the connection through to the daemon."
8534 msgstr ""
8535
8536 # type: textblock
8537 #. type: textblock
8538 #: ../src/guestfs-actions.pod:1344
8539 msgid "See also C<guestfs_ping_daemon>."
8540 msgstr ""
8541
8542 # type: textblock
8543 #. type: textblock
8544 #: ../src/guestfs-actions.pod:1349 ../src/guestfs-actions.pod:2073
8545 #: ../src/guestfs-actions.pod:5797
8546 msgid "(Added in 1.0.69)"
8547 msgstr ""
8548
8549 # type: =head2
8550 #. type: =head2
8551 #: ../src/guestfs-actions.pod:1351
8552 msgid "guestfs_egrep"
8553 msgstr ""
8554
8555 # type: verbatim
8556 #. type: verbatim
8557 #: ../src/guestfs-actions.pod:1353
8558 #, no-wrap
8559 msgid ""
8560 " char **\n"
8561 " guestfs_egrep (guestfs_h *g,\n"
8562 "                const char *regex,\n"
8563 "                const char *path);\n"
8564 "\n"
8565 msgstr ""
8566
8567 # type: textblock
8568 #. type: textblock
8569 #: ../src/guestfs-actions.pod:1358 ../fish/guestfish-actions.pod:905
8570 msgid ""
8571 "This calls the external C<egrep> program and returns the matching lines."
8572 msgstr ""
8573
8574 # type: textblock
8575 #. type: textblock
8576 #: ../src/guestfs-actions.pod:1368 ../src/guestfs-actions.pod:1387
8577 #: ../src/guestfs-actions.pod:1444 ../src/guestfs-actions.pod:1490
8578 #: ../src/guestfs-actions.pod:1509 ../src/guestfs-actions.pod:2203
8579 #: ../src/guestfs-actions.pod:2222 ../src/guestfs-actions.pod:2400
8580 #: ../src/guestfs-actions.pod:2413 ../src/guestfs-actions.pod:2428
8581 #: ../src/guestfs-actions.pod:2474 ../src/guestfs-actions.pod:2496
8582 #: ../src/guestfs-actions.pod:2509 ../src/guestfs-actions.pod:3442
8583 #: ../src/guestfs-actions.pod:3456 ../src/guestfs-actions.pod:3469
8584 #: ../src/guestfs-actions.pod:3483 ../src/guestfs-actions.pod:4457
8585 #: ../src/guestfs-actions.pod:5342 ../src/guestfs-actions.pod:5391
8586 #: ../src/guestfs-actions.pod:6161 ../src/guestfs-actions.pod:6173
8587 #: ../src/guestfs-actions.pod:6186 ../src/guestfs-actions.pod:6199
8588 #: ../src/guestfs-actions.pod:6221 ../src/guestfs-actions.pod:6234
8589 #: ../src/guestfs-actions.pod:6247 ../src/guestfs-actions.pod:6260
8590 #: ../src/guestfs-actions.pod:7031 ../src/guestfs-actions.pod:7050
8591 #: ../src/guestfs-actions.pod:7135 ../src/guestfs-actions.pod:7154
8592 #: ../src/guestfs-actions.pod:7200 ../src/guestfs-actions.pod:7219
8593 msgid "(Added in 1.0.66)"
8594 msgstr ""
8595
8596 # type: =head2
8597 #. type: =head2
8598 #: ../src/guestfs-actions.pod:1370
8599 msgid "guestfs_egrepi"
8600 msgstr ""
8601
8602 # type: verbatim
8603 #. type: verbatim
8604 #: ../src/guestfs-actions.pod:1372
8605 #, no-wrap
8606 msgid ""
8607 " char **\n"
8608 " guestfs_egrepi (guestfs_h *g,\n"
8609 "                 const char *regex,\n"
8610 "                 const char *path);\n"
8611 "\n"
8612 msgstr ""
8613
8614 # type: textblock
8615 #. type: textblock
8616 #: ../src/guestfs-actions.pod:1377 ../fish/guestfish-actions.pod:915
8617 msgid ""
8618 "This calls the external C<egrep -i> program and returns the matching lines."
8619 msgstr ""
8620
8621 # type: =head2
8622 #. type: =head2
8623 #: ../src/guestfs-actions.pod:1389
8624 msgid "guestfs_equal"
8625 msgstr ""
8626
8627 # type: verbatim
8628 #. type: verbatim
8629 #: ../src/guestfs-actions.pod:1391
8630 #, no-wrap
8631 msgid ""
8632 " int\n"
8633 " guestfs_equal (guestfs_h *g,\n"
8634 "                const char *file1,\n"
8635 "                const char *file2);\n"
8636 "\n"
8637 msgstr ""
8638
8639 # type: textblock
8640 #. type: textblock
8641 #: ../src/guestfs-actions.pod:1396 ../fish/guestfish-actions.pod:925
8642 msgid ""
8643 "This compares the two files C<file1> and C<file2> and returns true if their "
8644 "content is exactly equal, or false otherwise."
8645 msgstr ""
8646
8647 # type: textblock
8648 #. type: textblock
8649 #: ../src/guestfs-actions.pod:1399 ../fish/guestfish-actions.pod:928
8650 msgid "The external L<cmp(1)> program is used for the comparison."
8651 msgstr ""
8652
8653 # type: =head2
8654 #. type: =head2
8655 #: ../src/guestfs-actions.pod:1405
8656 msgid "guestfs_exists"
8657 msgstr ""
8658
8659 # type: verbatim
8660 #. type: verbatim
8661 #: ../src/guestfs-actions.pod:1407
8662 #, no-wrap
8663 msgid ""
8664 " int\n"
8665 " guestfs_exists (guestfs_h *g,\n"
8666 "                 const char *path);\n"
8667 "\n"
8668 msgstr ""
8669
8670 # type: textblock
8671 #. type: textblock
8672 #: ../src/guestfs-actions.pod:1411 ../fish/guestfish-actions.pod:934
8673 msgid ""
8674 "This returns C<true> if and only if there is a file, directory (or anything) "
8675 "with the given C<path> name."
8676 msgstr ""
8677
8678 # type: textblock
8679 #. type: textblock
8680 #: ../src/guestfs-actions.pod:1414
8681 msgid "See also C<guestfs_is_file>, C<guestfs_is_dir>, C<guestfs_stat>."
8682 msgstr ""
8683
8684 # type: =head2
8685 #. type: =head2
8686 #: ../src/guestfs-actions.pod:1420
8687 msgid "guestfs_fallocate"
8688 msgstr ""
8689
8690 # type: verbatim
8691 #. type: verbatim
8692 #: ../src/guestfs-actions.pod:1422
8693 #, no-wrap
8694 msgid ""
8695 " int\n"
8696 " guestfs_fallocate (guestfs_h *g,\n"
8697 "                    const char *path,\n"
8698 "                    int len);\n"
8699 "\n"
8700 msgstr ""
8701
8702 # type: textblock
8703 #. type: textblock
8704 #: ../src/guestfs-actions.pod:1427 ../src/guestfs-actions.pod:1453
8705 #: ../fish/guestfish-actions.pod:943 ../fish/guestfish-actions.pod:962
8706 msgid ""
8707 "This command preallocates a file (containing zero bytes) named C<path> of "
8708 "size C<len> bytes.  If the file exists already, it is overwritten."
8709 msgstr ""
8710
8711 # type: textblock
8712 #. type: textblock
8713 #: ../src/guestfs-actions.pod:1431 ../fish/guestfish-actions.pod:947
8714 msgid ""
8715 "Do not confuse this with the guestfish-specific C<alloc> command which "
8716 "allocates a file in the host and attaches it as a device."
8717 msgstr ""
8718
8719 #. type: textblock
8720 #: ../src/guestfs-actions.pod:1437
8721 msgid ""
8722 "This function is deprecated.  In new code, use the L</guestfs_fallocate64> "
8723 "call instead."
8724 msgstr ""
8725
8726 # type: =head2
8727 #. type: =head2
8728 #: ../src/guestfs-actions.pod:1446
8729 msgid "guestfs_fallocate64"
8730 msgstr ""
8731
8732 # type: verbatim
8733 #. type: verbatim
8734 #: ../src/guestfs-actions.pod:1448
8735 #, no-wrap
8736 msgid ""
8737 " int\n"
8738 " guestfs_fallocate64 (guestfs_h *g,\n"
8739 "                      const char *path,\n"
8740 "                      int64_t len);\n"
8741 "\n"
8742 msgstr ""
8743
8744 # type: textblock
8745 #. type: textblock
8746 #: ../src/guestfs-actions.pod:1457
8747 msgid ""
8748 "Note that this call allocates disk blocks for the file.  To create a sparse "
8749 "file use C<guestfs_truncate_size> instead."
8750 msgstr ""
8751
8752 # type: textblock
8753 #. type: textblock
8754 #: ../src/guestfs-actions.pod:1460
8755 msgid ""
8756 "The deprecated call C<guestfs_fallocate> does the same, but owing to an "
8757 "oversight it only allowed 30 bit lengths to be specified, effectively "
8758 "limiting the maximum size of files created through that call to 1GB."
8759 msgstr ""
8760
8761 # type: textblock
8762 #. type: textblock
8763 #: ../src/guestfs-actions.pod:1465 ../fish/guestfish-actions.pod:974
8764 msgid ""
8765 "Do not confuse this with the guestfish-specific C<alloc> and C<sparse> "
8766 "commands which create a file in the host and attach it as a device."
8767 msgstr ""
8768
8769 # type: textblock
8770 #. type: textblock
8771 #: ../src/guestfs-actions.pod:1471
8772 msgid "(Added in 1.3.17)"
8773 msgstr ""
8774
8775 # type: =head2
8776 #. type: =head2
8777 #: ../src/guestfs-actions.pod:1473
8778 msgid "guestfs_fgrep"
8779 msgstr ""
8780
8781 # type: verbatim
8782 #. type: verbatim
8783 #: ../src/guestfs-actions.pod:1475
8784 #, no-wrap
8785 msgid ""
8786 " char **\n"
8787 " guestfs_fgrep (guestfs_h *g,\n"
8788 "                const char *pattern,\n"
8789 "                const char *path);\n"
8790 "\n"
8791 msgstr ""
8792
8793 # type: textblock
8794 #. type: textblock
8795 #: ../src/guestfs-actions.pod:1480 ../fish/guestfish-actions.pod:982
8796 msgid ""
8797 "This calls the external C<fgrep> program and returns the matching lines."
8798 msgstr ""
8799
8800 # type: =head2
8801 #. type: =head2
8802 #: ../src/guestfs-actions.pod:1492
8803 msgid "guestfs_fgrepi"
8804 msgstr ""
8805
8806 # type: verbatim
8807 #. type: verbatim
8808 #: ../src/guestfs-actions.pod:1494
8809 #, no-wrap
8810 msgid ""
8811 " char **\n"
8812 " guestfs_fgrepi (guestfs_h *g,\n"
8813 "                 const char *pattern,\n"
8814 "                 const char *path);\n"
8815 "\n"
8816 msgstr ""
8817
8818 # type: textblock
8819 #. type: textblock
8820 #: ../src/guestfs-actions.pod:1499 ../fish/guestfish-actions.pod:992
8821 msgid ""
8822 "This calls the external C<fgrep -i> program and returns the matching lines."
8823 msgstr ""
8824
8825 # type: =head2
8826 #. type: =head2
8827 #: ../src/guestfs-actions.pod:1511
8828 msgid "guestfs_file"
8829 msgstr ""
8830
8831 # type: verbatim
8832 #. type: verbatim
8833 #: ../src/guestfs-actions.pod:1513
8834 #, no-wrap
8835 msgid ""
8836 " char *\n"
8837 " guestfs_file (guestfs_h *g,\n"
8838 "               const char *path);\n"
8839 "\n"
8840 msgstr ""
8841
8842 # type: textblock
8843 #. type: textblock
8844 #: ../src/guestfs-actions.pod:1517 ../fish/guestfish-actions.pod:1002
8845 msgid ""
8846 "This call uses the standard L<file(1)> command to determine the type or "
8847 "contents of the file."
8848 msgstr ""
8849
8850 # type: textblock
8851 #. type: textblock
8852 #: ../src/guestfs-actions.pod:1520 ../fish/guestfish-actions.pod:1005
8853 msgid ""
8854 "This call will also transparently look inside various types of compressed "
8855 "file."
8856 msgstr ""
8857
8858 # type: textblock
8859 #. type: textblock
8860 #: ../src/guestfs-actions.pod:1523 ../fish/guestfish-actions.pod:1008
8861 msgid ""
8862 "The exact command which runs is C<file -zb path>.  Note in particular that "
8863 "the filename is not prepended to the output (the C<-b> option)."
8864 msgstr ""
8865
8866 #. type: textblock
8867 #: ../src/guestfs-actions.pod:1527 ../fish/guestfish-actions.pod:1012
8868 msgid ""
8869 "The output depends on the output of the underlying L<file(1)> command and it "
8870 "can change in future in ways beyond our control.  In other words, the output "
8871 "is not guaranteed by the ABI."
8872 msgstr ""
8873
8874 #. type: textblock
8875 #: ../src/guestfs-actions.pod:1531
8876 msgid ""
8877 "See also: L<file(1)>, C<guestfs_vfs_type>, C<guestfs_lstat>, "
8878 "C<guestfs_is_file>, C<guestfs_is_blockdev> (etc)."
8879 msgstr ""
8880
8881 # type: =head2
8882 #. type: =head2
8883 #: ../src/guestfs-actions.pod:1539
8884 msgid "guestfs_file_architecture"
8885 msgstr ""
8886
8887 # type: verbatim
8888 #. type: verbatim
8889 #: ../src/guestfs-actions.pod:1541
8890 #, no-wrap
8891 msgid ""
8892 " char *\n"
8893 " guestfs_file_architecture (guestfs_h *g,\n"
8894 "                            const char *filename);\n"
8895 "\n"
8896 msgstr ""
8897
8898 # type: textblock
8899 #. type: textblock
8900 #: ../src/guestfs-actions.pod:1545 ../fish/guestfish-actions.pod:1023
8901 msgid ""
8902 "This detects the architecture of the binary C<filename>, and returns it if "
8903 "known."
8904 msgstr ""
8905
8906 # type: textblock
8907 #. type: textblock
8908 #: ../src/guestfs-actions.pod:1548 ../fish/guestfish-actions.pod:1026
8909 msgid "Currently defined architectures are:"
8910 msgstr ""
8911
8912 # type: =item
8913 #. type: =item
8914 #: ../src/guestfs-actions.pod:1552 ../fish/guestfish-actions.pod:1030
8915 msgid "\"i386\""
8916 msgstr ""
8917
8918 # type: textblock
8919 #. type: textblock
8920 #: ../src/guestfs-actions.pod:1554 ../fish/guestfish-actions.pod:1032
8921 msgid ""
8922 "This string is returned for all 32 bit i386, i486, i586, i686 binaries "
8923 "irrespective of the precise processor requirements of the binary."
8924 msgstr ""
8925
8926 # type: =item
8927 #. type: =item
8928 #: ../src/guestfs-actions.pod:1557 ../fish/guestfish-actions.pod:1035
8929 msgid "\"x86_64\""
8930 msgstr ""
8931
8932 # type: textblock
8933 #. type: textblock
8934 #: ../src/guestfs-actions.pod:1559 ../fish/guestfish-actions.pod:1037
8935 msgid "64 bit x86-64."
8936 msgstr ""
8937
8938 # type: =item
8939 #. type: =item
8940 #: ../src/guestfs-actions.pod:1561 ../fish/guestfish-actions.pod:1039
8941 msgid "\"sparc\""
8942 msgstr ""
8943
8944 # type: textblock
8945 #. type: textblock
8946 #: ../src/guestfs-actions.pod:1563 ../fish/guestfish-actions.pod:1041
8947 msgid "32 bit SPARC."
8948 msgstr ""
8949
8950 # type: =item
8951 #. type: =item
8952 #: ../src/guestfs-actions.pod:1565 ../fish/guestfish-actions.pod:1043
8953 msgid "\"sparc64\""
8954 msgstr ""
8955
8956 # type: textblock
8957 #. type: textblock
8958 #: ../src/guestfs-actions.pod:1567 ../fish/guestfish-actions.pod:1045
8959 msgid "64 bit SPARC V9 and above."
8960 msgstr ""
8961
8962 # type: =item
8963 #. type: =item
8964 #: ../src/guestfs-actions.pod:1569 ../fish/guestfish-actions.pod:1047
8965 msgid "\"ia64\""
8966 msgstr ""
8967
8968 # type: textblock
8969 #. type: textblock
8970 #: ../src/guestfs-actions.pod:1571 ../fish/guestfish-actions.pod:1049
8971 msgid "Intel Itanium."
8972 msgstr ""
8973
8974 # type: =item
8975 #. type: =item
8976 #: ../src/guestfs-actions.pod:1573 ../fish/guestfish-actions.pod:1051
8977 msgid "\"ppc\""
8978 msgstr ""
8979
8980 # type: textblock
8981 #. type: textblock
8982 #: ../src/guestfs-actions.pod:1575 ../fish/guestfish-actions.pod:1053
8983 msgid "32 bit Power PC."
8984 msgstr ""
8985
8986 # type: =item
8987 #. type: =item
8988 #: ../src/guestfs-actions.pod:1577 ../fish/guestfish-actions.pod:1055
8989 msgid "\"ppc64\""
8990 msgstr ""
8991
8992 # type: textblock
8993 #. type: textblock
8994 #: ../src/guestfs-actions.pod:1579 ../fish/guestfish-actions.pod:1057
8995 msgid "64 bit Power PC."
8996 msgstr ""
8997
8998 # type: textblock
8999 #. type: textblock
9000 #: ../src/guestfs-actions.pod:1583 ../fish/guestfish-actions.pod:1061
9001 msgid "Libguestfs may return other architecture strings in future."
9002 msgstr ""
9003
9004 # type: textblock
9005 #. type: textblock
9006 #: ../src/guestfs-actions.pod:1585 ../fish/guestfish-actions.pod:1063
9007 msgid "The function works on at least the following types of files:"
9008 msgstr ""
9009
9010 # type: textblock
9011 #. type: textblock
9012 #: ../src/guestfs-actions.pod:1591 ../fish/guestfish-actions.pod:1069
9013 msgid "many types of Un*x and Linux binary"
9014 msgstr ""
9015
9016 # type: textblock
9017 #. type: textblock
9018 #: ../src/guestfs-actions.pod:1595 ../fish/guestfish-actions.pod:1073
9019 msgid "many types of Un*x and Linux shared library"
9020 msgstr ""
9021
9022 # type: textblock
9023 #. type: textblock
9024 #: ../src/guestfs-actions.pod:1599 ../fish/guestfish-actions.pod:1077
9025 msgid "Windows Win32 and Win64 binaries"
9026 msgstr ""
9027
9028 # type: textblock
9029 #. type: textblock
9030 #: ../src/guestfs-actions.pod:1603 ../fish/guestfish-actions.pod:1081
9031 msgid "Windows Win32 and Win64 DLLs"
9032 msgstr ""
9033
9034 # type: textblock
9035 #. type: textblock
9036 #: ../src/guestfs-actions.pod:1605 ../fish/guestfish-actions.pod:1083
9037 msgid "Win32 binaries and DLLs return C<i386>."
9038 msgstr ""
9039
9040 # type: textblock
9041 #. type: textblock
9042 #: ../src/guestfs-actions.pod:1607 ../fish/guestfish-actions.pod:1085
9043 msgid "Win64 binaries and DLLs return C<x86_64>."
9044 msgstr ""
9045
9046 # type: textblock
9047 #. type: textblock
9048 #: ../src/guestfs-actions.pod:1611 ../fish/guestfish-actions.pod:1089
9049 msgid "Linux kernel modules"
9050 msgstr ""
9051
9052 # type: textblock
9053 #. type: textblock
9054 #: ../src/guestfs-actions.pod:1615 ../fish/guestfish-actions.pod:1093
9055 msgid "Linux new-style initrd images"
9056 msgstr ""
9057
9058 # type: textblock
9059 #. type: textblock
9060 #: ../src/guestfs-actions.pod:1619 ../fish/guestfish-actions.pod:1097
9061 msgid "some non-x86 Linux vmlinuz kernels"
9062 msgstr ""
9063
9064 # type: textblock
9065 #. type: textblock
9066 #: ../src/guestfs-actions.pod:1623 ../fish/guestfish-actions.pod:1101
9067 msgid "What it can't do currently:"
9068 msgstr ""
9069
9070 # type: textblock
9071 #. type: textblock
9072 #: ../src/guestfs-actions.pod:1629 ../fish/guestfish-actions.pod:1107
9073 msgid "static libraries (libfoo.a)"
9074 msgstr ""
9075
9076 # type: textblock
9077 #. type: textblock
9078 #: ../src/guestfs-actions.pod:1633 ../fish/guestfish-actions.pod:1111
9079 msgid "Linux old-style initrd as compressed ext2 filesystem (RHEL 3)"
9080 msgstr ""
9081
9082 # type: textblock
9083 #. type: textblock
9084 #: ../src/guestfs-actions.pod:1637 ../fish/guestfish-actions.pod:1115
9085 msgid "x86 Linux vmlinuz kernels"
9086 msgstr ""
9087
9088 # type: textblock
9089 #. type: textblock
9090 #: ../src/guestfs-actions.pod:1639 ../fish/guestfish-actions.pod:1117
9091 msgid ""
9092 "x86 vmlinuz images (bzImage format) consist of a mix of 16-, 32- and "
9093 "compressed code, and are horribly hard to unpack.  If you want to find the "
9094 "architecture of a kernel, use the architecture of the associated initrd or "
9095 "kernel module(s) instead."
9096 msgstr ""
9097
9098 # type: textblock
9099 #. type: textblock
9100 #: ../src/guestfs-actions.pod:1649 ../src/guestfs-actions.pod:1812
9101 #: ../src/guestfs-actions.pod:1829 ../src/guestfs-actions.pod:2532
9102 #: ../src/guestfs-actions.pod:2613 ../src/guestfs-actions.pod:2639
9103 #: ../src/guestfs-actions.pod:2688 ../src/guestfs-actions.pod:2709
9104 #: ../src/guestfs-actions.pod:2746 ../src/guestfs-actions.pod:2830
9105 #: ../src/guestfs-actions.pod:2892 ../src/guestfs-actions.pod:3065
9106 #: ../src/guestfs-actions.pod:3197
9107 msgid "(Added in 1.5.3)"
9108 msgstr ""
9109
9110 # type: =head2
9111 #. type: =head2
9112 #: ../src/guestfs-actions.pod:1651
9113 msgid "guestfs_filesize"
9114 msgstr ""
9115
9116 # type: verbatim
9117 #. type: verbatim
9118 #: ../src/guestfs-actions.pod:1653
9119 #, no-wrap
9120 msgid ""
9121 " int64_t\n"
9122 " guestfs_filesize (guestfs_h *g,\n"
9123 "                   const char *file);\n"
9124 "\n"
9125 msgstr ""
9126
9127 # type: textblock
9128 #. type: textblock
9129 #: ../src/guestfs-actions.pod:1657 ../fish/guestfish-actions.pod:1128
9130 msgid "This command returns the size of C<file> in bytes."
9131 msgstr ""
9132
9133 # type: textblock
9134 #. type: textblock
9135 #: ../src/guestfs-actions.pod:1659
9136 msgid ""
9137 "To get other stats about a file, use C<guestfs_stat>, C<guestfs_lstat>, "
9138 "C<guestfs_is_dir>, C<guestfs_is_file> etc.  To get the size of block "
9139 "devices, use C<guestfs_blockdev_getsize64>."
9140 msgstr ""
9141
9142 # type: textblock
9143 #. type: textblock
9144 #: ../src/guestfs-actions.pod:1665
9145 msgid "(Added in 1.0.82)"
9146 msgstr ""
9147
9148 # type: =head2
9149 #. type: =head2
9150 #: ../src/guestfs-actions.pod:1667
9151 msgid "guestfs_fill"
9152 msgstr ""
9153
9154 # type: verbatim
9155 #. type: verbatim
9156 #: ../src/guestfs-actions.pod:1669
9157 #, no-wrap
9158 msgid ""
9159 " int\n"
9160 " guestfs_fill (guestfs_h *g,\n"
9161 "               int c,\n"
9162 "               int len,\n"
9163 "               const char *path);\n"
9164 "\n"
9165 msgstr ""
9166
9167 # type: textblock
9168 #. type: textblock
9169 #: ../src/guestfs-actions.pod:1675 ../fish/guestfish-actions.pod:1138
9170 msgid ""
9171 "This command creates a new file called C<path>.  The initial content of the "
9172 "file is C<len> octets of C<c>, where C<c> must be a number in the range C<"
9173 "[0..255]>."
9174 msgstr ""
9175
9176 # type: textblock
9177 #. type: textblock
9178 #: ../src/guestfs-actions.pod:1679
9179 msgid ""
9180 "To fill a file with zero bytes (sparsely), it is much more efficient to use "
9181 "C<guestfs_truncate_size>.  To create a file with a pattern of repeating "
9182 "bytes use C<guestfs_fill_pattern>."
9183 msgstr ""
9184
9185 # type: textblock
9186 #. type: textblock
9187 #: ../src/guestfs-actions.pod:1691
9188 msgid "(Added in 1.0.79)"
9189 msgstr ""
9190
9191 # type: =head2
9192 #. type: =head2
9193 #: ../src/guestfs-actions.pod:1693
9194 msgid "guestfs_fill_pattern"
9195 msgstr ""
9196
9197 # type: verbatim
9198 #. type: verbatim
9199 #: ../src/guestfs-actions.pod:1695
9200 #, no-wrap
9201 msgid ""
9202 " int\n"
9203 " guestfs_fill_pattern (guestfs_h *g,\n"
9204 "                       const char *pattern,\n"
9205 "                       int len,\n"
9206 "                       const char *path);\n"
9207 "\n"
9208 msgstr ""
9209
9210 # type: textblock
9211 #. type: textblock
9212 #: ../src/guestfs-actions.pod:1701
9213 msgid ""
9214 "This function is like C<guestfs_fill> except that it creates a new file of "
9215 "length C<len> containing the repeating pattern of bytes in C<pattern>.  The "
9216 "pattern is truncated if necessary to ensure the length of the file is "
9217 "exactly C<len> bytes."
9218 msgstr ""
9219
9220 # type: textblock
9221 #. type: textblock
9222 #: ../src/guestfs-actions.pod:1713
9223 msgid "(Added in 1.3.12)"
9224 msgstr ""
9225
9226 # type: =head2
9227 #. type: =head2
9228 #: ../src/guestfs-actions.pod:1715
9229 msgid "guestfs_find"
9230 msgstr ""
9231
9232 # type: verbatim
9233 #. type: verbatim
9234 #: ../src/guestfs-actions.pod:1717
9235 #, no-wrap
9236 msgid ""
9237 " char **\n"
9238 " guestfs_find (guestfs_h *g,\n"
9239 "               const char *directory);\n"
9240 "\n"
9241 msgstr ""
9242
9243 # type: textblock
9244 #. type: textblock
9245 #: ../src/guestfs-actions.pod:1721 ../fish/guestfish-actions.pod:1160
9246 msgid ""
9247 "This command lists out all files and directories, recursively, starting at "
9248 "C<directory>.  It is essentially equivalent to running the shell command "
9249 "C<find directory -print> but some post-processing happens on the output, "
9250 "described below."
9251 msgstr ""
9252
9253 # type: textblock
9254 #. type: textblock
9255 #: ../src/guestfs-actions.pod:1726 ../fish/guestfish-actions.pod:1165
9256 msgid ""
9257 "This returns a list of strings I<without any prefix>.  Thus if the directory "
9258 "structure was:"
9259 msgstr ""
9260
9261 # type: verbatim
9262 #. type: verbatim
9263 #: ../src/guestfs-actions.pod:1729 ../fish/guestfish-actions.pod:1168
9264 #, no-wrap
9265 msgid ""
9266 " /tmp/a\n"
9267 " /tmp/b\n"
9268 " /tmp/c/d\n"
9269 "\n"
9270 msgstr ""
9271
9272 # type: textblock
9273 #. type: textblock
9274 #: ../src/guestfs-actions.pod:1733
9275 msgid ""
9276 "then the returned list from C<guestfs_find> C</tmp> would be 4 elements:"
9277 msgstr ""
9278
9279 # type: verbatim
9280 #. type: verbatim
9281 #: ../src/guestfs-actions.pod:1736 ../fish/guestfish-actions.pod:1175
9282 #, no-wrap
9283 msgid ""
9284 " a\n"
9285 " b\n"
9286 " c\n"
9287 " c/d\n"
9288 "\n"
9289 msgstr ""
9290
9291 # type: textblock
9292 #. type: textblock
9293 #: ../src/guestfs-actions.pod:1741 ../fish/guestfish-actions.pod:1180
9294 msgid "If C<directory> is not a directory, then this command returns an error."
9295 msgstr ""
9296
9297 # type: textblock
9298 #. type: textblock
9299 #: ../src/guestfs-actions.pod:1744 ../fish/guestfish-actions.pod:1183
9300 msgid "The returned list is sorted."
9301 msgstr ""
9302
9303 # type: textblock
9304 #. type: textblock
9305 #: ../src/guestfs-actions.pod:1746
9306 msgid "See also C<guestfs_find0>."
9307 msgstr ""
9308
9309 # type: textblock
9310 #. type: textblock
9311 #: ../src/guestfs-actions.pod:1755 ../src/guestfs-actions.pod:3886
9312 #: ../src/guestfs-actions.pod:5426
9313 msgid "(Added in 1.0.27)"
9314 msgstr ""
9315
9316 # type: =head2
9317 #. type: =head2
9318 #: ../src/guestfs-actions.pod:1757
9319 msgid "guestfs_find0"
9320 msgstr ""
9321
9322 # type: verbatim
9323 #. type: verbatim
9324 #: ../src/guestfs-actions.pod:1759
9325 #, no-wrap
9326 msgid ""
9327 " int\n"
9328 " guestfs_find0 (guestfs_h *g,\n"
9329 "                const char *directory,\n"
9330 "                const char *files);\n"
9331 "\n"
9332 msgstr ""
9333
9334 # type: textblock
9335 #. type: textblock
9336 #: ../src/guestfs-actions.pod:1764 ../fish/guestfish-actions.pod:1194
9337 msgid ""
9338 "This command lists out all files and directories, recursively, starting at "
9339 "C<directory>, placing the resulting list in the external file called "
9340 "C<files>."
9341 msgstr ""
9342
9343 # type: textblock
9344 #. type: textblock
9345 #: ../src/guestfs-actions.pod:1768
9346 msgid ""
9347 "This command works the same way as C<guestfs_find> with the following "
9348 "exceptions:"
9349 msgstr ""
9350
9351 # type: textblock
9352 #. type: textblock
9353 #: ../src/guestfs-actions.pod:1775 ../fish/guestfish-actions.pod:1205
9354 msgid "The resulting list is written to an external file."
9355 msgstr ""
9356
9357 # type: textblock
9358 #. type: textblock
9359 #: ../src/guestfs-actions.pod:1779 ../fish/guestfish-actions.pod:1209
9360 msgid ""
9361 "Items (filenames) in the result are separated by C<\\0> characters.  See "
9362 "L<find(1)> option I<-print0>."
9363 msgstr ""
9364
9365 # type: textblock
9366 #. type: textblock
9367 #: ../src/guestfs-actions.pod:1784 ../fish/guestfish-actions.pod:1214
9368 msgid "This command is not limited in the number of names that it can return."
9369 msgstr ""
9370
9371 # type: textblock
9372 #. type: textblock
9373 #: ../src/guestfs-actions.pod:1789 ../fish/guestfish-actions.pod:1219
9374 msgid "The result list is not sorted."
9375 msgstr ""
9376
9377 # type: textblock
9378 #. type: textblock
9379 #: ../src/guestfs-actions.pod:1795
9380 msgid "(Added in 1.0.74)"
9381 msgstr ""
9382
9383 # type: =head2
9384 #. type: =head2
9385 #: ../src/guestfs-actions.pod:1797
9386 msgid "guestfs_findfs_label"
9387 msgstr ""
9388
9389 # type: verbatim
9390 #. type: verbatim
9391 #: ../src/guestfs-actions.pod:1799
9392 #, no-wrap
9393 msgid ""
9394 " char *\n"
9395 " guestfs_findfs_label (guestfs_h *g,\n"
9396 "                       const char *label);\n"
9397 "\n"
9398 msgstr ""
9399
9400 # type: textblock
9401 #. type: textblock
9402 #: ../src/guestfs-actions.pod:1803 ../fish/guestfish-actions.pod:1229
9403 msgid ""
9404 "This command searches the filesystems and returns the one which has the "
9405 "given label.  An error is returned if no such filesystem can be found."
9406 msgstr ""
9407
9408 # type: textblock
9409 #. type: textblock
9410 #: ../src/guestfs-actions.pod:1807
9411 msgid "To find the label of a filesystem, use C<guestfs_vfs_label>."
9412 msgstr ""
9413
9414 # type: =head2
9415 #. type: =head2
9416 #: ../src/guestfs-actions.pod:1814
9417 msgid "guestfs_findfs_uuid"
9418 msgstr ""
9419
9420 # type: verbatim
9421 #. type: verbatim
9422 #: ../src/guestfs-actions.pod:1816
9423 #, no-wrap
9424 msgid ""
9425 " char *\n"
9426 " guestfs_findfs_uuid (guestfs_h *g,\n"
9427 "                      const char *uuid);\n"
9428 "\n"
9429 msgstr ""
9430
9431 # type: textblock
9432 #. type: textblock
9433 #: ../src/guestfs-actions.pod:1820 ../fish/guestfish-actions.pod:1239
9434 msgid ""
9435 "This command searches the filesystems and returns the one which has the "
9436 "given UUID.  An error is returned if no such filesystem can be found."
9437 msgstr ""
9438
9439 # type: textblock
9440 #. type: textblock
9441 #: ../src/guestfs-actions.pod:1824
9442 msgid "To find the UUID of a filesystem, use C<guestfs_vfs_uuid>."
9443 msgstr ""
9444
9445 # type: =head2
9446 #. type: =head2
9447 #: ../src/guestfs-actions.pod:1831
9448 msgid "guestfs_fsck"
9449 msgstr ""
9450
9451 # type: verbatim
9452 #. type: verbatim
9453 #: ../src/guestfs-actions.pod:1833
9454 #, no-wrap
9455 msgid ""
9456 " int\n"
9457 " guestfs_fsck (guestfs_h *g,\n"
9458 "               const char *fstype,\n"
9459 "               const char *device);\n"
9460 "\n"
9461 msgstr ""
9462
9463 # type: textblock
9464 #. type: textblock
9465 #: ../src/guestfs-actions.pod:1838 ../fish/guestfish-actions.pod:1249
9466 msgid ""
9467 "This runs the filesystem checker (fsck) on C<device> which should have "
9468 "filesystem type C<fstype>."
9469 msgstr ""
9470
9471 # type: textblock
9472 #. type: textblock
9473 #: ../src/guestfs-actions.pod:1841 ../fish/guestfish-actions.pod:1252
9474 msgid ""
9475 "The returned integer is the status.  See L<fsck(8)> for the list of status "
9476 "codes from C<fsck>."
9477 msgstr ""
9478
9479 # type: textblock
9480 #. type: textblock
9481 #: ../src/guestfs-actions.pod:1850 ../fish/guestfish-actions.pod:1261
9482 msgid "Multiple status codes can be summed together."
9483 msgstr ""
9484
9485 # type: textblock
9486 #. type: textblock
9487 #: ../src/guestfs-actions.pod:1854 ../fish/guestfish-actions.pod:1265
9488 msgid ""
9489 "A non-zero return code can mean \"success\", for example if errors have been "
9490 "corrected on the filesystem."
9491 msgstr ""
9492
9493 # type: textblock
9494 #. type: textblock
9495 #: ../src/guestfs-actions.pod:1859 ../fish/guestfish-actions.pod:1270
9496 msgid "Checking or repairing NTFS volumes is not supported (by linux-ntfs)."
9497 msgstr ""
9498
9499 # type: textblock
9500 #. type: textblock
9501 #: ../src/guestfs-actions.pod:1864 ../fish/guestfish-actions.pod:1275
9502 msgid ""
9503 "This command is entirely equivalent to running C<fsck -a -t fstype device>."
9504 msgstr ""
9505
9506 # type: textblock
9507 #. type: textblock
9508 #: ../src/guestfs-actions.pod:1868 ../src/guestfs-actions.pod:7073
9509 msgid "(Added in 1.0.16)"
9510 msgstr ""
9511
9512 # type: =head2
9513 #. type: =head2
9514 #: ../src/guestfs-actions.pod:1870
9515 msgid "guestfs_get_append"
9516 msgstr ""
9517
9518 # type: verbatim
9519 #. type: verbatim
9520 #: ../src/guestfs-actions.pod:1872
9521 #, no-wrap
9522 msgid ""
9523 " const char *\n"
9524 " guestfs_get_append (guestfs_h *g);\n"
9525 "\n"
9526 msgstr ""
9527
9528 # type: textblock
9529 #. type: textblock
9530 #: ../src/guestfs-actions.pod:1875 ../fish/guestfish-actions.pod:1281
9531 msgid ""
9532 "Return the additional kernel options which are added to the guest kernel "
9533 "command line."
9534 msgstr ""
9535
9536 # type: textblock
9537 #. type: textblock
9538 #: ../src/guestfs-actions.pod:1878 ../fish/guestfish-actions.pod:1284
9539 msgid "If C<NULL> then no options are added."
9540 msgstr ""
9541
9542 # type: textblock
9543 #. type: textblock
9544 #: ../src/guestfs-actions.pod:1880
9545 msgid ""
9546 "This function returns a string which may be NULL.  There is no way to return "
9547 "an error from this function.  The string is owned by the guest handle and "
9548 "must I<not> be freed."
9549 msgstr ""
9550
9551 # type: textblock
9552 #. type: textblock
9553 #: ../src/guestfs-actions.pod:1884 ../src/guestfs-actions.pod:5104
9554 #: ../src/guestfs-actions.pod:5567 ../src/guestfs-actions.pod:5935
9555 #: ../src/guestfs-actions.pod:5954 ../src/guestfs-actions.pod:5970
9556 #: ../src/guestfs-actions.pod:5987 ../src/guestfs-actions.pod:6744
9557 #: ../src/guestfs-actions.pod:6762 ../src/guestfs-actions.pod:7116
9558 msgid "(Added in 1.0.26)"
9559 msgstr ""
9560
9561 # type: =head2
9562 #. type: =head2
9563 #: ../src/guestfs-actions.pod:1886
9564 msgid "guestfs_get_autosync"
9565 msgstr ""
9566
9567 # type: verbatim
9568 #. type: verbatim
9569 #: ../src/guestfs-actions.pod:1888
9570 #, no-wrap
9571 msgid ""
9572 " int\n"
9573 " guestfs_get_autosync (guestfs_h *g);\n"
9574 "\n"
9575 msgstr ""
9576
9577 # type: textblock
9578 #. type: textblock
9579 #: ../src/guestfs-actions.pod:1891 ../fish/guestfish-actions.pod:1290
9580 msgid "Get the autosync flag."
9581 msgstr ""
9582
9583 # type: =head2
9584 #. type: =head2
9585 #: ../src/guestfs-actions.pod:1897
9586 msgid "guestfs_get_direct"
9587 msgstr ""
9588
9589 # type: verbatim
9590 #. type: verbatim
9591 #: ../src/guestfs-actions.pod:1899
9592 #, no-wrap
9593 msgid ""
9594 " int\n"
9595 " guestfs_get_direct (guestfs_h *g);\n"
9596 "\n"
9597 msgstr ""
9598
9599 # type: textblock
9600 #. type: textblock
9601 #: ../src/guestfs-actions.pod:1902 ../fish/guestfish-actions.pod:1296
9602 msgid "Return the direct appliance mode flag."
9603 msgstr ""
9604
9605 # type: textblock
9606 #. type: textblock
9607 #: ../src/guestfs-actions.pod:1906 ../src/guestfs-actions.pod:5608
9608 msgid "(Added in 1.0.72)"
9609 msgstr ""
9610
9611 # type: =head2
9612 #. type: =head2
9613 #: ../src/guestfs-actions.pod:1908
9614 msgid "guestfs_get_e2label"
9615 msgstr ""
9616
9617 # type: verbatim
9618 #. type: verbatim
9619 #: ../src/guestfs-actions.pod:1910
9620 #, no-wrap
9621 msgid ""
9622 " char *\n"
9623 " guestfs_get_e2label (guestfs_h *g,\n"
9624 "                      const char *device);\n"
9625 "\n"
9626 msgstr ""
9627
9628 # type: textblock
9629 #. type: textblock
9630 #: ../src/guestfs-actions.pod:1914 ../fish/guestfish-actions.pod:1302
9631 msgid ""
9632 "This returns the ext2/3/4 filesystem label of the filesystem on C<device>."
9633 msgstr ""
9634
9635 #. type: textblock
9636 #: ../src/guestfs-actions.pod:1920
9637 msgid ""
9638 "This function is deprecated.  In new code, use the L</guestfs_vfs_label> "
9639 "call instead."
9640 msgstr ""
9641
9642 # type: textblock
9643 #. type: textblock
9644 #: ../src/guestfs-actions.pod:1927 ../src/guestfs-actions.pod:1948
9645 #: ../src/guestfs-actions.pod:5626 ../src/guestfs-actions.pod:5645
9646 msgid "(Added in 1.0.15)"
9647 msgstr ""
9648
9649 # type: =head2
9650 #. type: =head2
9651 #: ../src/guestfs-actions.pod:1929
9652 msgid "guestfs_get_e2uuid"
9653 msgstr ""
9654
9655 # type: verbatim
9656 #. type: verbatim
9657 #: ../src/guestfs-actions.pod:1931
9658 #, no-wrap
9659 msgid ""
9660 " char *\n"
9661 " guestfs_get_e2uuid (guestfs_h *g,\n"
9662 "                     const char *device);\n"
9663 "\n"
9664 msgstr ""
9665
9666 # type: textblock
9667 #. type: textblock
9668 #: ../src/guestfs-actions.pod:1935 ../fish/guestfish-actions.pod:1316
9669 msgid ""
9670 "This returns the ext2/3/4 filesystem UUID of the filesystem on C<device>."
9671 msgstr ""
9672
9673 #. type: textblock
9674 #: ../src/guestfs-actions.pod:1941
9675 msgid ""
9676 "This function is deprecated.  In new code, use the L</guestfs_vfs_uuid> call "
9677 "instead."
9678 msgstr ""
9679
9680 # type: =head2
9681 #. type: =head2
9682 #: ../src/guestfs-actions.pod:1950
9683 msgid "guestfs_get_memsize"
9684 msgstr ""
9685
9686 # type: verbatim
9687 #. type: verbatim
9688 #: ../src/guestfs-actions.pod:1952
9689 #, no-wrap
9690 msgid ""
9691 " int\n"
9692 " guestfs_get_memsize (guestfs_h *g);\n"
9693 "\n"
9694 msgstr ""
9695
9696 # type: textblock
9697 #. type: textblock
9698 #: ../src/guestfs-actions.pod:1955 ../fish/guestfish-actions.pod:1330
9699 msgid ""
9700 "This gets the memory size in megabytes allocated to the qemu subprocess."
9701 msgstr ""
9702
9703 # type: textblock
9704 #. type: textblock
9705 #: ../src/guestfs-actions.pod:1958
9706 msgid ""
9707 "If C<guestfs_set_memsize> was not called on this handle, and if "
9708 "C<LIBGUESTFS_MEMSIZE> was not set, then this returns the compiled-in default "
9709 "value for memsize."
9710 msgstr ""
9711
9712 # type: textblock
9713 #. type: textblock
9714 #: ../src/guestfs-actions.pod:1962 ../src/guestfs-actions.pod:2043
9715 #: ../src/guestfs-actions.pod:5661 ../src/guestfs-actions.pod:5768
9716 #: ../fish/guestfish-actions.pod:1337 ../fish/guestfish-actions.pod:1388
9717 #: ../fish/guestfish-actions.pod:3788 ../fish/guestfish-actions.pod:3875
9718 msgid ""
9719 "For more information on the architecture of libguestfs, see L<guestfs(3)>."
9720 msgstr ""
9721
9722 # type: textblock
9723 #. type: textblock
9724 #: ../src/guestfs-actions.pod:1967 ../src/guestfs-actions.pod:4177
9725 #: ../src/guestfs-actions.pod:4362 ../src/guestfs-actions.pod:4381
9726 #: ../src/guestfs-actions.pod:4400 ../src/guestfs-actions.pod:4412
9727 #: ../src/guestfs-actions.pod:4429 ../src/guestfs-actions.pod:4442
9728 #: ../src/guestfs-actions.pod:5329 ../src/guestfs-actions.pod:5666
9729 #: ../src/guestfs-actions.pod:5909 ../src/guestfs-actions.pod:6510
9730 msgid "(Added in 1.0.55)"
9731 msgstr ""
9732
9733 # type: =head2
9734 #. type: =head2
9735 #: ../src/guestfs-actions.pod:1969
9736 msgid "guestfs_get_network"
9737 msgstr ""
9738
9739 # type: verbatim
9740 #. type: verbatim
9741 #: ../src/guestfs-actions.pod:1971
9742 #, no-wrap
9743 msgid ""
9744 " int\n"
9745 " guestfs_get_network (guestfs_h *g);\n"
9746 "\n"
9747 msgstr ""
9748
9749 # type: textblock
9750 #. type: textblock
9751 #: ../src/guestfs-actions.pod:1974 ../fish/guestfish-actions.pod:1344
9752 msgid "This returns the enable network flag."
9753 msgstr ""
9754
9755 # type: textblock
9756 #. type: textblock
9757 #: ../src/guestfs-actions.pod:1978 ../src/guestfs-actions.pod:5685
9758 msgid "(Added in 1.5.4)"
9759 msgstr ""
9760
9761 # type: =head2
9762 #. type: =head2
9763 #: ../src/guestfs-actions.pod:1980
9764 msgid "guestfs_get_path"
9765 msgstr ""
9766
9767 # type: verbatim
9768 #. type: verbatim
9769 #: ../src/guestfs-actions.pod:1982
9770 #, no-wrap
9771 msgid ""
9772 " const char *\n"
9773 " guestfs_get_path (guestfs_h *g);\n"
9774 "\n"
9775 msgstr ""
9776
9777 # type: textblock
9778 #. type: textblock
9779 #: ../src/guestfs-actions.pod:1985 ../fish/guestfish-actions.pod:1350
9780 msgid "Return the current search path."
9781 msgstr ""
9782
9783 # type: textblock
9784 #. type: textblock
9785 #: ../src/guestfs-actions.pod:1987 ../fish/guestfish-actions.pod:1352
9786 msgid ""
9787 "This is always non-NULL.  If it wasn't set already, then this will return "
9788 "the default path."
9789 msgstr ""
9790
9791 # type: textblock
9792 #. type: textblock
9793 #: ../src/guestfs-actions.pod:1990 ../src/guestfs-actions.pod:2019
9794 msgid ""
9795 "This function returns a string, or NULL on error.  The string is owned by "
9796 "the guest handle and must I<not> be freed."
9797 msgstr ""
9798
9799 # type: =head2
9800 #. type: =head2
9801 #: ../src/guestfs-actions.pod:1995
9802 msgid "guestfs_get_pid"
9803 msgstr ""
9804
9805 # type: verbatim
9806 #. type: verbatim
9807 #: ../src/guestfs-actions.pod:1997
9808 #, no-wrap
9809 msgid ""
9810 " int\n"
9811 " guestfs_get_pid (guestfs_h *g);\n"
9812 "\n"
9813 msgstr ""
9814
9815 # type: textblock
9816 #. type: textblock
9817 #: ../src/guestfs-actions.pod:2000 ../fish/guestfish-actions.pod:1361
9818 msgid ""
9819 "Return the process ID of the qemu subprocess.  If there is no qemu "
9820 "subprocess, then this will return an error."
9821 msgstr ""
9822
9823 # type: textblock
9824 #. type: textblock
9825 #: ../src/guestfs-actions.pod:2003 ../fish/guestfish-actions.pod:1364
9826 msgid "This is an internal call used for debugging and testing."
9827 msgstr ""
9828
9829 # type: textblock
9830 #. type: textblock
9831 #: ../src/guestfs-actions.pod:2007
9832 msgid "(Added in 1.0.56)"
9833 msgstr ""
9834
9835 # type: =head2
9836 #. type: =head2
9837 #: ../src/guestfs-actions.pod:2009
9838 msgid "guestfs_get_qemu"
9839 msgstr ""
9840
9841 # type: verbatim
9842 #. type: verbatim
9843 #: ../src/guestfs-actions.pod:2011
9844 #, no-wrap
9845 msgid ""
9846 " const char *\n"
9847 " guestfs_get_qemu (guestfs_h *g);\n"
9848 "\n"
9849 msgstr ""
9850
9851 # type: textblock
9852 #. type: textblock
9853 #: ../src/guestfs-actions.pod:2014 ../fish/guestfish-actions.pod:1370
9854 msgid "Return the current qemu binary."
9855 msgstr ""
9856
9857 # type: textblock
9858 #. type: textblock
9859 #: ../src/guestfs-actions.pod:2016 ../fish/guestfish-actions.pod:1372
9860 msgid ""
9861 "This is always non-NULL.  If it wasn't set already, then this will return "
9862 "the default qemu binary name."
9863 msgstr ""
9864
9865 # type: textblock
9866 #. type: textblock
9867 #: ../src/guestfs-actions.pod:2022 ../src/guestfs-actions.pod:5730
9868 msgid "(Added in 1.0.6)"
9869 msgstr ""
9870
9871 # type: =head2
9872 #. type: =head2
9873 #: ../src/guestfs-actions.pod:2024
9874 msgid "guestfs_get_recovery_proc"
9875 msgstr ""
9876
9877 # type: verbatim
9878 #. type: verbatim
9879 #: ../src/guestfs-actions.pod:2026
9880 #, no-wrap
9881 msgid ""
9882 " int\n"
9883 " guestfs_get_recovery_proc (guestfs_h *g);\n"
9884 "\n"
9885 msgstr ""
9886
9887 # type: textblock
9888 #. type: textblock
9889 #: ../src/guestfs-actions.pod:2029 ../fish/guestfish-actions.pod:1379
9890 msgid "Return the recovery process enabled flag."
9891 msgstr ""
9892
9893 # type: textblock
9894 #. type: textblock
9895 #: ../src/guestfs-actions.pod:2033 ../src/guestfs-actions.pod:3287
9896 #: ../src/guestfs-actions.pod:3584 ../src/guestfs-actions.pod:3984
9897 #: ../src/guestfs-actions.pod:4016 ../src/guestfs-actions.pod:5034
9898 #: ../src/guestfs-actions.pod:5377 ../src/guestfs-actions.pod:5754
9899 #: ../src/guestfs-actions.pod:6413 ../src/guestfs-actions.pod:6433
9900 #: ../src/guestfs-actions.pod:6625
9901 msgid "(Added in 1.0.77)"
9902 msgstr ""
9903
9904 # type: =head2
9905 #. type: =head2
9906 #: ../src/guestfs-actions.pod:2035
9907 msgid "guestfs_get_selinux"
9908 msgstr ""
9909
9910 # type: verbatim
9911 #. type: verbatim
9912 #: ../src/guestfs-actions.pod:2037
9913 #, no-wrap
9914 msgid ""
9915 " int\n"
9916 " guestfs_get_selinux (guestfs_h *g);\n"
9917 "\n"
9918 msgstr ""
9919
9920 # type: textblock
9921 #. type: textblock
9922 #: ../src/guestfs-actions.pod:2040
9923 msgid ""
9924 "This returns the current setting of the selinux flag which is passed to the "
9925 "appliance at boot time.  See C<guestfs_set_selinux>."
9926 msgstr ""
9927
9928 # type: textblock
9929 #. type: textblock
9930 #: ../src/guestfs-actions.pod:2048 ../src/guestfs-actions.pod:2111
9931 #: ../src/guestfs-actions.pod:5773 ../src/guestfs-actions.pod:5827
9932 msgid "(Added in 1.0.67)"
9933 msgstr ""
9934
9935 # type: =head2
9936 #. type: =head2
9937 #: ../src/guestfs-actions.pod:2050
9938 msgid "guestfs_get_state"
9939 msgstr ""
9940
9941 # type: verbatim
9942 #. type: verbatim
9943 #: ../src/guestfs-actions.pod:2052
9944 #, no-wrap
9945 msgid ""
9946 " int\n"
9947 " guestfs_get_state (guestfs_h *g);\n"
9948 "\n"
9949 msgstr ""
9950
9951 # type: textblock
9952 #. type: textblock
9953 #: ../src/guestfs-actions.pod:2055 ../fish/guestfish-actions.pod:1395
9954 msgid ""
9955 "This returns the current state as an opaque integer.  This is only useful "
9956 "for printing debug and internal error messages."
9957 msgstr ""
9958
9959 # type: textblock
9960 #. type: textblock
9961 #: ../src/guestfs-actions.pod:2058 ../src/guestfs-actions.pod:3090
9962 #: ../src/guestfs-actions.pod:3119 ../src/guestfs-actions.pod:3180
9963 #: ../src/guestfs-actions.pod:3207 ../fish/guestfish-actions.pod:1398
9964 #: ../fish/guestfish-actions.pod:2159 ../fish/guestfish-actions.pod:2177
9965 #: ../fish/guestfish-actions.pod:2215 ../fish/guestfish-actions.pod:2231
9966 msgid "For more information on states, see L<guestfs(3)>."
9967 msgstr ""
9968
9969 # type: =head2
9970 #. type: =head2
9971 #: ../src/guestfs-actions.pod:2064
9972 msgid "guestfs_get_trace"
9973 msgstr ""
9974
9975 # type: verbatim
9976 #. type: verbatim
9977 #: ../src/guestfs-actions.pod:2066
9978 #, no-wrap
9979 msgid ""
9980 " int\n"
9981 " guestfs_get_trace (guestfs_h *g);\n"
9982 "\n"
9983 msgstr ""
9984
9985 # type: textblock
9986 #. type: textblock
9987 #: ../src/guestfs-actions.pod:2069 ../fish/guestfish-actions.pod:1404
9988 msgid "Return the command trace flag."
9989 msgstr ""
9990
9991 # type: =head2
9992 #. type: =head2
9993 #: ../src/guestfs-actions.pod:2075
9994 msgid "guestfs_get_umask"
9995 msgstr ""
9996
9997 # type: verbatim
9998 #. type: verbatim
9999 #: ../src/guestfs-actions.pod:2077
10000 #, no-wrap
10001 msgid ""
10002 " int\n"
10003 " guestfs_get_umask (guestfs_h *g);\n"
10004 "\n"
10005 msgstr ""
10006
10007 # type: textblock
10008 #. type: textblock
10009 #: ../src/guestfs-actions.pod:2080
10010 msgid ""
10011 "Return the current umask.  By default the umask is C<022> unless it has been "
10012 "set by calling C<guestfs_umask>."
10013 msgstr ""
10014
10015 # type: =head2
10016 #. type: =head2
10017 #: ../src/guestfs-actions.pod:2087
10018 msgid "guestfs_get_verbose"
10019 msgstr ""
10020
10021 # type: verbatim
10022 #. type: verbatim
10023 #: ../src/guestfs-actions.pod:2089
10024 #, no-wrap
10025 msgid ""
10026 " int\n"
10027 " guestfs_get_verbose (guestfs_h *g);\n"
10028 "\n"
10029 msgstr ""
10030
10031 # type: textblock
10032 #. type: textblock
10033 #: ../src/guestfs-actions.pod:2092 ../fish/guestfish-actions.pod:1417
10034 msgid "This returns the verbose messages flag."
10035 msgstr ""
10036
10037 # type: =head2
10038 #. type: =head2
10039 #: ../src/guestfs-actions.pod:2098
10040 msgid "guestfs_getcon"
10041 msgstr ""
10042
10043 # type: verbatim
10044 #. type: verbatim
10045 #: ../src/guestfs-actions.pod:2100
10046 #, no-wrap
10047 msgid ""
10048 " char *\n"
10049 " guestfs_getcon (guestfs_h *g);\n"
10050 "\n"
10051 msgstr ""
10052
10053 # type: textblock
10054 #. type: textblock
10055 #: ../src/guestfs-actions.pod:2103 ../fish/guestfish-actions.pod:1423
10056 msgid "This gets the SELinux security context of the daemon."
10057 msgstr ""
10058
10059 # type: textblock
10060 #. type: textblock
10061 #: ../src/guestfs-actions.pod:2105
10062 msgid ""
10063 "See the documentation about SELINUX in L<guestfs(3)>, and C<guestfs_setcon>"
10064 msgstr ""
10065
10066 # type: =head2
10067 #. type: =head2
10068 #: ../src/guestfs-actions.pod:2113
10069 msgid "guestfs_getxattr"
10070 msgstr ""
10071
10072 # type: verbatim
10073 #. type: verbatim
10074 #: ../src/guestfs-actions.pod:2115
10075 #, no-wrap
10076 msgid ""
10077 " char *\n"
10078 " guestfs_getxattr (guestfs_h *g,\n"
10079 "                   const char *path,\n"
10080 "                   const char *name,\n"
10081 "                   size_t *size_r);\n"
10082 "\n"
10083 msgstr ""
10084
10085 # type: textblock
10086 #. type: textblock
10087 #: ../src/guestfs-actions.pod:2121
10088 msgid ""
10089 "Get a single extended attribute from file C<path> named C<name>.  This call "
10090 "follows symlinks.  If you want to lookup an extended attribute for the "
10091 "symlink itself, use C<guestfs_lgetxattr>."
10092 msgstr ""
10093
10094 # type: textblock
10095 #. type: textblock
10096 #: ../src/guestfs-actions.pod:2125 ../src/guestfs-actions.pod:3301
10097 msgid ""
10098 "Normally it is better to get all extended attributes from a file in one go "
10099 "by calling C<guestfs_getxattrs>.  However some Linux filesystem "
10100 "implementations are buggy and do not provide a way to list out attributes.  "
10101 "For these filesystems (notably ntfs-3g)  you have to know the names of the "
10102 "extended attributes you want in advance and call this function."
10103 msgstr ""
10104
10105 # type: textblock
10106 #. type: textblock
10107 #: ../src/guestfs-actions.pod:2132 ../src/guestfs-actions.pod:3308
10108 #: ../fish/guestfish-actions.pod:1443 ../fish/guestfish-actions.pod:2296
10109 msgid ""
10110 "Extended attribute values are blobs of binary data.  If there is no extended "
10111 "attribute named C<name>, this returns an error."
10112 msgstr ""
10113
10114 # type: textblock
10115 #. type: textblock
10116 #: ../src/guestfs-actions.pod:2135
10117 msgid "See also: C<guestfs_getxattrs>, C<guestfs_lgetxattr>, L<attr(5)>."
10118 msgstr ""
10119
10120 # type: textblock
10121 #. type: textblock
10122 #: ../src/guestfs-actions.pod:2137 ../src/guestfs-actions.pod:2350
10123 #: ../src/guestfs-actions.pod:3313 ../src/guestfs-actions.pod:5027
10124 #: ../src/guestfs-actions.pod:5053 ../src/guestfs-actions.pod:5234
10125 msgid ""
10126 "This function returns a buffer, or NULL on error.  The size of the returned "
10127 "buffer is written to C<*size_r>.  I<The caller must free the returned buffer "
10128 "after use>."
10129 msgstr ""
10130
10131 #. type: textblock
10132 #: ../src/guestfs-actions.pod:2141 ../src/guestfs-actions.pod:3317
10133 msgid "(Added in 1.7.24)"
10134 msgstr ""
10135
10136 # type: =head2
10137 #. type: =head2
10138 #: ../src/guestfs-actions.pod:2143
10139 msgid "guestfs_getxattrs"
10140 msgstr ""
10141
10142 # type: verbatim
10143 #. type: verbatim
10144 #: ../src/guestfs-actions.pod:2145
10145 #, no-wrap
10146 msgid ""
10147 " struct guestfs_xattr_list *\n"
10148 " guestfs_getxattrs (guestfs_h *g,\n"
10149 "                    const char *path);\n"
10150 "\n"
10151 msgstr ""
10152
10153 # type: textblock
10154 #. type: textblock
10155 #: ../src/guestfs-actions.pod:2149 ../fish/guestfish-actions.pod:1452
10156 msgid ""
10157 "This call lists the extended attributes of the file or directory C<path>."
10158 msgstr ""
10159
10160 # type: textblock
10161 #. type: textblock
10162 #: ../src/guestfs-actions.pod:2152 ../fish/guestfish-actions.pod:1455
10163 msgid ""
10164 "At the system call level, this is a combination of the L<listxattr(2)> and "
10165 "L<getxattr(2)> calls."
10166 msgstr ""
10167
10168 # type: textblock
10169 #. type: textblock
10170 #: ../src/guestfs-actions.pod:2155
10171 msgid "See also: C<guestfs_lgetxattrs>, L<attr(5)>."
10172 msgstr ""
10173
10174 # type: textblock
10175 #. type: textblock
10176 #: ../src/guestfs-actions.pod:2157 ../src/guestfs-actions.pod:3329
10177 #: ../src/guestfs-actions.pod:3980
10178 msgid ""
10179 "This function returns a C<struct guestfs_xattr_list *>, or NULL if there was "
10180 "an error.  I<The caller must call C<guestfs_free_xattr_list> after use>."
10181 msgstr ""
10182
10183 # type: textblock
10184 #. type: textblock
10185 #: ../src/guestfs-actions.pod:2161 ../src/guestfs-actions.pod:3333
10186 #: ../src/guestfs-actions.pod:3498 ../src/guestfs-actions.pod:3534
10187 #: ../src/guestfs-actions.pod:5407 ../src/guestfs-actions.pod:5846
10188 #: ../src/guestfs-actions.pod:7181
10189 msgid "(Added in 1.0.59)"
10190 msgstr ""
10191
10192 # type: =head2
10193 #. type: =head2
10194 #: ../src/guestfs-actions.pod:2163
10195 msgid "guestfs_glob_expand"
10196 msgstr ""
10197
10198 # type: verbatim
10199 #. type: verbatim
10200 #: ../src/guestfs-actions.pod:2165
10201 #, no-wrap
10202 msgid ""
10203 " char **\n"
10204 " guestfs_glob_expand (guestfs_h *g,\n"
10205 "                      const char *pattern);\n"
10206 "\n"
10207 msgstr ""
10208
10209 # type: textblock
10210 #. type: textblock
10211 #: ../src/guestfs-actions.pod:2169 ../fish/guestfish-actions.pod:1464
10212 msgid ""
10213 "This command searches for all the pathnames matching C<pattern> according to "
10214 "the wildcard expansion rules used by the shell."
10215 msgstr ""
10216
10217 # type: textblock
10218 #. type: textblock
10219 #: ../src/guestfs-actions.pod:2173 ../fish/guestfish-actions.pod:1468
10220 msgid ""
10221 "If no paths match, then this returns an empty list (note: not an error)."
10222 msgstr ""
10223
10224 # type: textblock
10225 #. type: textblock
10226 #: ../src/guestfs-actions.pod:2176 ../fish/guestfish-actions.pod:1471
10227 msgid ""
10228 "It is just a wrapper around the C L<glob(3)> function with flags C<GLOB_MARK|"
10229 "GLOB_BRACE>.  See that manual page for more details."
10230 msgstr ""
10231
10232 # type: textblock
10233 #. type: textblock
10234 #: ../src/guestfs-actions.pod:2184 ../src/guestfs-actions.pod:6011
10235 #: ../src/guestfs-actions.pod:6028
10236 msgid "(Added in 1.0.50)"
10237 msgstr ""
10238
10239 # type: =head2
10240 #. type: =head2
10241 #: ../src/guestfs-actions.pod:2186
10242 msgid "guestfs_grep"
10243 msgstr ""
10244
10245 # type: verbatim
10246 #. type: verbatim
10247 #: ../src/guestfs-actions.pod:2188
10248 #, no-wrap
10249 msgid ""
10250 " char **\n"
10251 " guestfs_grep (guestfs_h *g,\n"
10252 "               const char *regex,\n"
10253 "               const char *path);\n"
10254 "\n"
10255 msgstr ""
10256
10257 # type: textblock
10258 #. type: textblock
10259 #: ../src/guestfs-actions.pod:2193 ../fish/guestfish-actions.pod:1479
10260 msgid "This calls the external C<grep> program and returns the matching lines."
10261 msgstr ""
10262
10263 # type: =head2
10264 #. type: =head2
10265 #: ../src/guestfs-actions.pod:2205
10266 msgid "guestfs_grepi"
10267 msgstr ""
10268
10269 # type: verbatim
10270 #. type: verbatim
10271 #: ../src/guestfs-actions.pod:2207
10272 #, no-wrap
10273 msgid ""
10274 " char **\n"
10275 " guestfs_grepi (guestfs_h *g,\n"
10276 "                const char *regex,\n"
10277 "                const char *path);\n"
10278 "\n"
10279 msgstr ""
10280
10281 # type: textblock
10282 #. type: textblock
10283 #: ../src/guestfs-actions.pod:2212 ../fish/guestfish-actions.pod:1489
10284 msgid ""
10285 "This calls the external C<grep -i> program and returns the matching lines."
10286 msgstr ""
10287
10288 # type: =head2
10289 #. type: =head2
10290 #: ../src/guestfs-actions.pod:2224
10291 msgid "guestfs_grub_install"
10292 msgstr ""
10293
10294 # type: verbatim
10295 #. type: verbatim
10296 #: ../src/guestfs-actions.pod:2226
10297 #, no-wrap
10298 msgid ""
10299 " int\n"
10300 " guestfs_grub_install (guestfs_h *g,\n"
10301 "                       const char *root,\n"
10302 "                       const char *device);\n"
10303 "\n"
10304 msgstr ""
10305
10306 #. type: textblock
10307 #: ../src/guestfs-actions.pod:2231 ../fish/guestfish-actions.pod:1499
10308 msgid ""
10309 "This command installs GRUB 1 (the Grand Unified Bootloader) on C<device>, "
10310 "with the root directory being C<root>."
10311 msgstr ""
10312
10313 #. type: textblock
10314 #: ../src/guestfs-actions.pod:2240 ../fish/guestfish-actions.pod:1508
10315 msgid ""
10316 "There is currently no way in the API to install grub2, which is used by most "
10317 "modern Linux guests.  It is possible to run the grub2 command from the "
10318 "guest, although see the caveats in L<guestfs(3)/RUNNING COMMANDS>."
10319 msgstr ""
10320
10321 #. type: textblock
10322 #: ../src/guestfs-actions.pod:2247 ../fish/guestfish-actions.pod:1515
10323 msgid ""
10324 "This uses C<grub-install> from the host.  Unfortunately grub is not always "
10325 "compatible with itself, so this only works in rather narrow circumstances.  "
10326 "Careful testing with each guest version is advisable."
10327 msgstr ""
10328
10329 #. type: textblock
10330 #: ../src/guestfs-actions.pod:2254 ../fish/guestfish-actions.pod:1522
10331 msgid ""
10332 "If grub-install reports the error \"No suitable drive was found in the "
10333 "generated device map.\" it may be that you need to create a C</boot/grub/"
10334 "device.map> file first that contains the mapping between grub device names "
10335 "and Linux device names.  It is usually sufficient to create a file "
10336 "containing:"
10337 msgstr ""
10338
10339 # type: verbatim
10340 #. type: verbatim
10341 #: ../src/guestfs-actions.pod:2261 ../fish/guestfish-actions.pod:1529
10342 #, no-wrap
10343 msgid ""
10344 " (hd0) /dev/vda\n"
10345 "\n"
10346 msgstr ""
10347
10348 # type: textblock
10349 #. type: textblock
10350 #: ../src/guestfs-actions.pod:2263 ../fish/guestfish-actions.pod:1531
10351 msgid "replacing C</dev/vda> with the name of the installation device."
10352 msgstr ""
10353
10354 # type: textblock
10355 #. type: textblock
10356 #: ../src/guestfs-actions.pod:2269
10357 msgid "(Added in 1.0.17)"
10358 msgstr ""
10359
10360 # type: =head2
10361 #. type: =head2
10362 #: ../src/guestfs-actions.pod:2271
10363 msgid "guestfs_head"
10364 msgstr ""
10365
10366 # type: verbatim
10367 #. type: verbatim
10368 #: ../src/guestfs-actions.pod:2273
10369 #, no-wrap
10370 msgid ""
10371 " char **\n"
10372 " guestfs_head (guestfs_h *g,\n"
10373 "               const char *path);\n"
10374 "\n"
10375 msgstr ""
10376
10377 # type: textblock
10378 #. type: textblock
10379 #: ../src/guestfs-actions.pod:2277 ../fish/guestfish-actions.pod:1539
10380 msgid ""
10381 "This command returns up to the first 10 lines of a file as a list of strings."
10382 msgstr ""
10383
10384 # type: =head2
10385 #. type: =head2
10386 #: ../src/guestfs-actions.pod:2289
10387 msgid "guestfs_head_n"
10388 msgstr ""
10389
10390 # type: verbatim
10391 #. type: verbatim
10392 #: ../src/guestfs-actions.pod:2291
10393 #, no-wrap
10394 msgid ""
10395 " char **\n"
10396 " guestfs_head_n (guestfs_h *g,\n"
10397 "                 int nrlines,\n"
10398 "                 const char *path);\n"
10399 "\n"
10400 msgstr ""
10401
10402 # type: textblock
10403 #. type: textblock
10404 #: ../src/guestfs-actions.pod:2296 ../fish/guestfish-actions.pod:1549
10405 msgid ""
10406 "If the parameter C<nrlines> is a positive number, this returns the first "
10407 "C<nrlines> lines of the file C<path>."
10408 msgstr ""
10409
10410 # type: textblock
10411 #. type: textblock
10412 #: ../src/guestfs-actions.pod:2299 ../fish/guestfish-actions.pod:1552
10413 msgid ""
10414 "If the parameter C<nrlines> is a negative number, this returns lines from "
10415 "the file C<path>, excluding the last C<nrlines> lines."
10416 msgstr ""
10417
10418 # type: textblock
10419 #. type: textblock
10420 #: ../src/guestfs-actions.pod:2302 ../src/guestfs-actions.pod:6308
10421 #: ../fish/guestfish-actions.pod:1555 ../fish/guestfish-actions.pod:4221
10422 msgid "If the parameter C<nrlines> is zero, this returns an empty list."
10423 msgstr ""
10424
10425 # type: =head2
10426 #. type: =head2
10427 #: ../src/guestfs-actions.pod:2313
10428 msgid "guestfs_hexdump"
10429 msgstr ""
10430
10431 # type: verbatim
10432 #. type: verbatim
10433 #: ../src/guestfs-actions.pod:2315
10434 #, no-wrap
10435 msgid ""
10436 " char *\n"
10437 " guestfs_hexdump (guestfs_h *g,\n"
10438 "                  const char *path);\n"
10439 "\n"
10440 msgstr ""
10441
10442 # type: textblock
10443 #. type: textblock
10444 #: ../src/guestfs-actions.pod:2319 ../fish/guestfish-actions.pod:1564
10445 msgid ""
10446 "This runs C<hexdump -C> on the given C<path>.  The result is the human-"
10447 "readable, canonical hex dump of the file."
10448 msgstr ""
10449
10450 # type: textblock
10451 #. type: textblock
10452 #: ../src/guestfs-actions.pod:2328 ../src/guestfs-actions.pod:6092
10453 #: ../src/guestfs-actions.pod:6147
10454 msgid "(Added in 1.0.22)"
10455 msgstr ""
10456
10457 # type: =head2
10458 #. type: =head2
10459 #: ../src/guestfs-actions.pod:2330
10460 msgid "guestfs_initrd_cat"
10461 msgstr ""
10462
10463 # type: verbatim
10464 #. type: verbatim
10465 #: ../src/guestfs-actions.pod:2332
10466 #, no-wrap
10467 msgid ""
10468 " char *\n"
10469 " guestfs_initrd_cat (guestfs_h *g,\n"
10470 "                     const char *initrdpath,\n"
10471 "                     const char *filename,\n"
10472 "                     size_t *size_r);\n"
10473 "\n"
10474 msgstr ""
10475
10476 # type: textblock
10477 #. type: textblock
10478 #: ../src/guestfs-actions.pod:2338 ../fish/guestfish-actions.pod:1574
10479 msgid ""
10480 "This command unpacks the file C<filename> from the initrd file called "
10481 "C<initrdpath>.  The filename must be given I<without> the initial C</> "
10482 "character."
10483 msgstr ""
10484
10485 # type: textblock
10486 #. type: textblock
10487 #: ../src/guestfs-actions.pod:2342 ../fish/guestfish-actions.pod:1578
10488 msgid ""
10489 "For example, in guestfish you could use the following command to examine the "
10490 "boot script (usually called C</init>)  contained in a Linux initrd or "
10491 "initramfs image:"
10492 msgstr ""
10493
10494 # type: verbatim
10495 #. type: verbatim
10496 #: ../src/guestfs-actions.pod:2346 ../fish/guestfish-actions.pod:1582
10497 #, no-wrap
10498 msgid ""
10499 " initrd-cat /boot/initrd-<version>.img init\n"
10500 "\n"
10501 msgstr ""
10502
10503 # type: textblock
10504 #. type: textblock
10505 #: ../src/guestfs-actions.pod:2348
10506 msgid "See also C<guestfs_initrd_list>."
10507 msgstr ""
10508
10509 # type: =head2
10510 #. type: =head2
10511 #: ../src/guestfs-actions.pod:2359
10512 msgid "guestfs_initrd_list"
10513 msgstr ""
10514
10515 # type: verbatim
10516 #. type: verbatim
10517 #: ../src/guestfs-actions.pod:2361
10518 #, no-wrap
10519 msgid ""
10520 " char **\n"
10521 " guestfs_initrd_list (guestfs_h *g,\n"
10522 "                      const char *path);\n"
10523 "\n"
10524 msgstr ""
10525
10526 # type: textblock
10527 #. type: textblock
10528 #: ../src/guestfs-actions.pod:2365 ../fish/guestfish-actions.pod:1593
10529 msgid "This command lists out files contained in an initrd."
10530 msgstr ""
10531
10532 # type: textblock
10533 #. type: textblock
10534 #: ../src/guestfs-actions.pod:2367 ../fish/guestfish-actions.pod:1595
10535 msgid ""
10536 "The files are listed without any initial C</> character.  The files are "
10537 "listed in the order they appear (not necessarily alphabetical).  Directory "
10538 "names are listed as separate items."
10539 msgstr ""
10540
10541 # type: textblock
10542 #. type: textblock
10543 #: ../src/guestfs-actions.pod:2371 ../fish/guestfish-actions.pod:1599
10544 msgid ""
10545 "Old Linux kernels (2.4 and earlier) used a compressed ext2 filesystem as "
10546 "initrd.  We I<only> support the newer initramfs format (compressed cpio "
10547 "files)."
10548 msgstr ""
10549
10550 # type: =head2
10551 #. type: =head2
10552 #: ../src/guestfs-actions.pod:2381
10553 msgid "guestfs_inotify_add_watch"
10554 msgstr ""
10555
10556 # type: verbatim
10557 #. type: verbatim
10558 #: ../src/guestfs-actions.pod:2383
10559 #, no-wrap
10560 msgid ""
10561 " int64_t\n"
10562 " guestfs_inotify_add_watch (guestfs_h *g,\n"
10563 "                            const char *path,\n"
10564 "                            int mask);\n"
10565 "\n"
10566 msgstr ""
10567
10568 # type: textblock
10569 #. type: textblock
10570 #: ../src/guestfs-actions.pod:2388 ../fish/guestfish-actions.pod:1607
10571 msgid "Watch C<path> for the events listed in C<mask>."
10572 msgstr ""
10573
10574 # type: textblock
10575 #. type: textblock
10576 #: ../src/guestfs-actions.pod:2390 ../fish/guestfish-actions.pod:1609
10577 msgid ""
10578 "Note that if C<path> is a directory then events within that directory are "
10579 "watched, but this does I<not> happen recursively (in subdirectories)."
10580 msgstr ""
10581
10582 # type: textblock
10583 #. type: textblock
10584 #: ../src/guestfs-actions.pod:2394 ../fish/guestfish-actions.pod:1613
10585 msgid ""
10586 "Note for non-C or non-Linux callers: the inotify events are defined by the "
10587 "Linux kernel ABI and are listed in C</usr/include/sys/inotify.h>."
10588 msgstr ""
10589
10590 # type: =head2
10591 #. type: =head2
10592 #: ../src/guestfs-actions.pod:2402
10593 msgid "guestfs_inotify_close"
10594 msgstr ""
10595
10596 # type: verbatim
10597 #. type: verbatim
10598 #: ../src/guestfs-actions.pod:2404
10599 #, no-wrap
10600 msgid ""
10601 " int\n"
10602 " guestfs_inotify_close (guestfs_h *g);\n"
10603 "\n"
10604 msgstr ""
10605
10606 # type: textblock
10607 #. type: textblock
10608 #: ../src/guestfs-actions.pod:2407 ../fish/guestfish-actions.pod:1621
10609 msgid ""
10610 "This closes the inotify handle which was previously opened by inotify_init.  "
10611 "It removes all watches, throws away any pending events, and deallocates all "
10612 "resources."
10613 msgstr ""
10614
10615 # type: =head2
10616 #. type: =head2
10617 #: ../src/guestfs-actions.pod:2415
10618 msgid "guestfs_inotify_files"
10619 msgstr ""
10620
10621 # type: verbatim
10622 #. type: verbatim
10623 #: ../src/guestfs-actions.pod:2417
10624 #, no-wrap
10625 msgid ""
10626 " char **\n"
10627 " guestfs_inotify_files (guestfs_h *g);\n"
10628 "\n"
10629 msgstr ""
10630
10631 # type: textblock
10632 #. type: textblock
10633 #: ../src/guestfs-actions.pod:2420
10634 msgid ""
10635 "This function is a helpful wrapper around C<guestfs_inotify_read> which just "
10636 "returns a list of pathnames of objects that were touched.  The returned "
10637 "pathnames are sorted and deduplicated."
10638 msgstr ""
10639
10640 # type: =head2
10641 #. type: =head2
10642 #: ../src/guestfs-actions.pod:2430
10643 msgid "guestfs_inotify_init"
10644 msgstr ""
10645
10646 # type: verbatim
10647 #. type: verbatim
10648 #: ../src/guestfs-actions.pod:2432
10649 #, no-wrap
10650 msgid ""
10651 " int\n"
10652 " guestfs_inotify_init (guestfs_h *g,\n"
10653 "                       int maxevents);\n"
10654 "\n"
10655 msgstr ""
10656
10657 # type: textblock
10658 #. type: textblock
10659 #: ../src/guestfs-actions.pod:2436 ../fish/guestfish-actions.pod:1637
10660 msgid ""
10661 "This command creates a new inotify handle.  The inotify subsystem can be "
10662 "used to notify events which happen to objects in the guest filesystem."
10663 msgstr ""
10664
10665 # type: textblock
10666 #. type: textblock
10667 #: ../src/guestfs-actions.pod:2440
10668 msgid ""
10669 "C<maxevents> is the maximum number of events which will be queued up between "
10670 "calls to C<guestfs_inotify_read> or C<guestfs_inotify_files>.  If this is "
10671 "passed as C<0>, then the kernel (or previously set)  default is used.  For "
10672 "Linux 2.6.29 the default was 16384 events.  Beyond this limit, the kernel "
10673 "throws away events, but records the fact that it threw them away by setting "
10674 "a flag C<IN_Q_OVERFLOW> in the returned structure list (see "
10675 "C<guestfs_inotify_read>)."
10676 msgstr ""
10677
10678 # type: textblock
10679 #. type: textblock
10680 #: ../src/guestfs-actions.pod:2450
10681 msgid ""
10682 "Before any events are generated, you have to add some watches to the "
10683 "internal watch list.  See: C<guestfs_inotify_add_watch>, "
10684 "C<guestfs_inotify_rm_watch> and C<guestfs_inotify_watch_all>."
10685 msgstr ""
10686
10687 # type: textblock
10688 #. type: textblock
10689 #: ../src/guestfs-actions.pod:2456
10690 msgid ""
10691 "Queued up events should be read periodically by calling "
10692 "C<guestfs_inotify_read> (or C<guestfs_inotify_files> which is just a helpful "
10693 "wrapper around C<guestfs_inotify_read>).  If you don't read the events out "
10694 "often enough then you risk the internal queue overflowing."
10695 msgstr ""
10696
10697 # type: textblock
10698 #. type: textblock
10699 #: ../src/guestfs-actions.pod:2463
10700 msgid ""
10701 "The handle should be closed after use by calling C<guestfs_inotify_close>.  "
10702 "This also removes any watches automatically."
10703 msgstr ""
10704
10705 # type: textblock
10706 #. type: textblock
10707 #: ../src/guestfs-actions.pod:2467 ../fish/guestfish-actions.pod:1668
10708 msgid ""
10709 "See also L<inotify(7)> for an overview of the inotify interface as exposed "
10710 "by the Linux kernel, which is roughly what we expose via libguestfs.  Note "
10711 "that there is one global inotify handle per libguestfs instance."
10712 msgstr ""
10713
10714 # type: =head2
10715 #. type: =head2
10716 #: ../src/guestfs-actions.pod:2476
10717 msgid "guestfs_inotify_read"
10718 msgstr ""
10719
10720 # type: verbatim
10721 #. type: verbatim
10722 #: ../src/guestfs-actions.pod:2478
10723 #, no-wrap
10724 msgid ""
10725 " struct guestfs_inotify_event_list *\n"
10726 " guestfs_inotify_read (guestfs_h *g);\n"
10727 "\n"
10728 msgstr ""
10729
10730 # type: textblock
10731 #. type: textblock
10732 #: ../src/guestfs-actions.pod:2481 ../fish/guestfish-actions.pod:1677
10733 msgid ""
10734 "Return the complete queue of events that have happened since the previous "
10735 "read call."
10736 msgstr ""
10737
10738 # type: textblock
10739 #. type: textblock
10740 #: ../src/guestfs-actions.pod:2484 ../fish/guestfish-actions.pod:1680
10741 msgid "If no events have happened, this returns an empty list."
10742 msgstr ""
10743
10744 # type: textblock
10745 #. type: textblock
10746 #: ../src/guestfs-actions.pod:2486 ../fish/guestfish-actions.pod:1682
10747 msgid ""
10748 "I<Note>: In order to make sure that all events have been read, you must call "
10749 "this function repeatedly until it returns an empty list.  The reason is that "
10750 "the call will read events up to the maximum appliance-to-host message size "
10751 "and leave remaining events in the queue."
10752 msgstr ""
10753
10754 # type: textblock
10755 #. type: textblock
10756 #: ../src/guestfs-actions.pod:2492
10757 msgid ""
10758 "This function returns a C<struct guestfs_inotify_event_list *>, or NULL if "
10759 "there was an error.  I<The caller must call "
10760 "C<guestfs_free_inotify_event_list> after use>."
10761 msgstr ""
10762
10763 # type: =head2
10764 #. type: =head2
10765 #: ../src/guestfs-actions.pod:2498
10766 msgid "guestfs_inotify_rm_watch"
10767 msgstr ""
10768
10769 # type: verbatim
10770 #. type: verbatim
10771 #: ../src/guestfs-actions.pod:2500
10772 #, no-wrap
10773 msgid ""
10774 " int\n"
10775 " guestfs_inotify_rm_watch (guestfs_h *g,\n"
10776 "                           int wd);\n"
10777 "\n"
10778 msgstr ""
10779
10780 # type: textblock
10781 #. type: textblock
10782 #: ../src/guestfs-actions.pod:2504
10783 msgid ""
10784 "Remove a previously defined inotify watch.  See C<guestfs_inotify_add_watch>."
10785 msgstr ""
10786
10787 # type: =head2
10788 #. type: =head2
10789 #: ../src/guestfs-actions.pod:2511
10790 msgid "guestfs_inspect_get_arch"
10791 msgstr ""
10792
10793 # type: verbatim
10794 #. type: verbatim
10795 #: ../src/guestfs-actions.pod:2513
10796 #, no-wrap
10797 msgid ""
10798 " char *\n"
10799 " guestfs_inspect_get_arch (guestfs_h *g,\n"
10800 "                           const char *root);\n"
10801 "\n"
10802 msgstr ""
10803
10804 # type: textblock
10805 #. type: textblock
10806 #: ../src/guestfs-actions.pod:2517 ../src/guestfs-actions.pod:2540
10807 #: ../src/guestfs-actions.pod:2621 ../src/guestfs-actions.pod:2647
10808 #: ../src/guestfs-actions.pod:2669 ../src/guestfs-actions.pod:2696
10809 #: ../src/guestfs-actions.pod:2717 ../src/guestfs-actions.pod:2754
10810 #: ../src/guestfs-actions.pod:2783 ../src/guestfs-actions.pod:2814
10811 #: ../src/guestfs-actions.pod:2858 ../src/guestfs-actions.pod:2900
10812 #: ../src/guestfs-actions.pod:2923
10813 msgid ""
10814 "This function should only be called with a root device string as returned by "
10815 "C<guestfs_inspect_os>."
10816 msgstr ""
10817
10818 # type: textblock
10819 #. type: textblock
10820 #: ../src/guestfs-actions.pod:2520
10821 msgid ""
10822 "This returns the architecture of the inspected operating system.  The "
10823 "possible return values are listed under C<guestfs_file_architecture>."
10824 msgstr ""
10825
10826 # type: textblock
10827 #. type: textblock
10828 #: ../src/guestfs-actions.pod:2524 ../fish/guestfish-actions.pod:1706
10829 msgid ""
10830 "If the architecture could not be determined, then the string C<unknown> is "
10831 "returned."
10832 msgstr ""
10833
10834 # type: textblock
10835 #. type: textblock
10836 #: ../src/guestfs-actions.pod:2527 ../src/guestfs-actions.pod:2608
10837 #: ../src/guestfs-actions.pod:2656 ../src/guestfs-actions.pod:2684
10838 #: ../src/guestfs-actions.pod:2770 ../src/guestfs-actions.pod:2801
10839 #: ../src/guestfs-actions.pod:2825 ../src/guestfs-actions.pod:2844
10840 #: ../src/guestfs-actions.pod:2887 ../src/guestfs-actions.pod:2910
10841 #: ../src/guestfs-actions.pod:3016 ../src/guestfs-actions.pod:3057
10842 #: ../fish/guestfish-actions.pod:1709 ../fish/guestfish-actions.pod:1783
10843 #: ../fish/guestfish-actions.pod:1816 ../fish/guestfish-actions.pod:1837
10844 #: ../fish/guestfish-actions.pod:1901 ../fish/guestfish-actions.pod:1925
10845 #: ../fish/guestfish-actions.pod:1942 ../fish/guestfish-actions.pod:1955
10846 #: ../fish/guestfish-actions.pod:1990 ../fish/guestfish-actions.pod:2006
10847 #: ../fish/guestfish-actions.pod:2105 ../fish/guestfish-actions.pod:2139
10848 msgid "Please read L<guestfs(3)/INSPECTION> for more details."
10849 msgstr ""
10850
10851 # type: =head2
10852 #. type: =head2
10853 #: ../src/guestfs-actions.pod:2534
10854 msgid "guestfs_inspect_get_distro"
10855 msgstr ""
10856
10857 # type: verbatim
10858 #. type: verbatim
10859 #: ../src/guestfs-actions.pod:2536
10860 #, no-wrap
10861 msgid ""
10862 " char *\n"
10863 " guestfs_inspect_get_distro (guestfs_h *g,\n"
10864 "                             const char *root);\n"
10865 "\n"
10866 msgstr ""
10867
10868 # type: textblock
10869 #. type: textblock
10870 #: ../src/guestfs-actions.pod:2543 ../fish/guestfish-actions.pod:1718
10871 msgid ""
10872 "This returns the distro (distribution) of the inspected operating system."
10873 msgstr ""
10874
10875 # type: textblock
10876 #. type: textblock
10877 #: ../src/guestfs-actions.pod:2546 ../fish/guestfish-actions.pod:1721
10878 msgid "Currently defined distros are:"
10879 msgstr ""
10880
10881 # type: =item
10882 #. type: =item
10883 #: ../src/guestfs-actions.pod:2550 ../fish/guestfish-actions.pod:1725
10884 msgid "\"archlinux\""
10885 msgstr ""
10886
10887 # type: textblock
10888 #. type: textblock
10889 #: ../src/guestfs-actions.pod:2552 ../fish/guestfish-actions.pod:1727
10890 msgid "Arch Linux."
10891 msgstr ""
10892
10893 # type: =item
10894 #. type: =item
10895 #: ../src/guestfs-actions.pod:2554 ../fish/guestfish-actions.pod:1729
10896 msgid "\"debian\""
10897 msgstr ""
10898
10899 # type: textblock
10900 #. type: textblock
10901 #: ../src/guestfs-actions.pod:2556 ../fish/guestfish-actions.pod:1731
10902 msgid "Debian."
10903 msgstr ""
10904
10905 # type: =item
10906 #. type: =item
10907 #: ../src/guestfs-actions.pod:2558 ../fish/guestfish-actions.pod:1733
10908 msgid "\"fedora\""
10909 msgstr ""
10910
10911 # type: textblock
10912 #. type: textblock
10913 #: ../src/guestfs-actions.pod:2560 ../fish/guestfish-actions.pod:1735
10914 msgid "Fedora."
10915 msgstr ""
10916
10917 # type: =item
10918 #. type: =item
10919 #: ../src/guestfs-actions.pod:2562 ../fish/guestfish-actions.pod:1737
10920 msgid "\"gentoo\""
10921 msgstr ""
10922
10923 # type: textblock
10924 #. type: textblock
10925 #: ../src/guestfs-actions.pod:2564 ../fish/guestfish-actions.pod:1739
10926 msgid "Gentoo."
10927 msgstr ""
10928
10929 # type: =item
10930 #. type: =item
10931 #: ../src/guestfs-actions.pod:2566 ../fish/guestfish-actions.pod:1741
10932 msgid "\"linuxmint\""
10933 msgstr ""
10934
10935 # type: textblock
10936 #. type: textblock
10937 #: ../src/guestfs-actions.pod:2568 ../fish/guestfish-actions.pod:1743
10938 msgid "Linux Mint."
10939 msgstr ""
10940
10941 # type: =item
10942 #. type: =item
10943 #: ../src/guestfs-actions.pod:2570 ../fish/guestfish-actions.pod:1745
10944 msgid "\"mandriva\""
10945 msgstr ""
10946
10947 # type: textblock
10948 #. type: textblock
10949 #: ../src/guestfs-actions.pod:2572 ../fish/guestfish-actions.pod:1747
10950 msgid "Mandriva."
10951 msgstr ""
10952
10953 # type: =item
10954 #. type: =item
10955 #: ../src/guestfs-actions.pod:2574 ../fish/guestfish-actions.pod:1749
10956 msgid "\"meego\""
10957 msgstr ""
10958
10959 # type: textblock
10960 #. type: textblock
10961 #: ../src/guestfs-actions.pod:2576 ../fish/guestfish-actions.pod:1751
10962 msgid "MeeGo."
10963 msgstr ""
10964
10965 # type: =item
10966 #. type: =item
10967 #: ../src/guestfs-actions.pod:2578 ../fish/guestfish-actions.pod:1753
10968 msgid "\"pardus\""
10969 msgstr ""
10970
10971 # type: textblock
10972 #. type: textblock
10973 #: ../src/guestfs-actions.pod:2580 ../fish/guestfish-actions.pod:1755
10974 msgid "Pardus."
10975 msgstr ""
10976
10977 # type: =item
10978 #. type: =item
10979 #: ../src/guestfs-actions.pod:2582 ../fish/guestfish-actions.pod:1757
10980 msgid "\"redhat-based\""
10981 msgstr ""
10982
10983 # type: textblock
10984 #. type: textblock
10985 #: ../src/guestfs-actions.pod:2584 ../fish/guestfish-actions.pod:1759
10986 msgid "Some Red Hat-derived distro."
10987 msgstr ""
10988
10989 # type: =item
10990 #. type: =item
10991 #: ../src/guestfs-actions.pod:2586 ../fish/guestfish-actions.pod:1761
10992 msgid "\"rhel\""
10993 msgstr ""
10994
10995 # type: textblock
10996 #. type: textblock
10997 #: ../src/guestfs-actions.pod:2588 ../fish/guestfish-actions.pod:1763
10998 msgid "Red Hat Enterprise Linux and some derivatives."
10999 msgstr ""
11000
11001 # type: =item
11002 #. type: =item
11003 #: ../src/guestfs-actions.pod:2590 ../fish/guestfish-actions.pod:1765
11004 msgid "\"ubuntu\""
11005 msgstr ""
11006
11007 # type: textblock
11008 #. type: textblock
11009 #: ../src/guestfs-actions.pod:2592 ../fish/guestfish-actions.pod:1767
11010 msgid "Ubuntu."
11011 msgstr ""
11012
11013 # type: =item
11014 #. type: =item
11015 #: ../src/guestfs-actions.pod:2594 ../src/guestfs-actions.pod:2878
11016 #: ../fish/guestfish-actions.pod:1769 ../fish/guestfish-actions.pod:1981
11017 msgid "\"unknown\""
11018 msgstr ""
11019
11020 # type: textblock
11021 #. type: textblock
11022 #: ../src/guestfs-actions.pod:2596 ../fish/guestfish-actions.pod:1771
11023 msgid "The distro could not be determined."
11024 msgstr ""
11025
11026 # type: =item
11027 #. type: =item
11028 #: ../src/guestfs-actions.pod:2598 ../src/guestfs-actions.pod:2870
11029 #: ../fish/guestfish-actions.pod:1773 ../fish/guestfish-actions.pod:1973
11030 msgid "\"windows\""
11031 msgstr ""
11032
11033 # type: textblock
11034 #. type: textblock
11035 #: ../src/guestfs-actions.pod:2600 ../fish/guestfish-actions.pod:1775
11036 msgid ""
11037 "Windows does not have distributions.  This string is returned if the OS type "
11038 "is Windows."
11039 msgstr ""
11040
11041 # type: textblock
11042 #. type: textblock
11043 #: ../src/guestfs-actions.pod:2605 ../src/guestfs-actions.pod:2884
11044 #: ../fish/guestfish-actions.pod:1780 ../fish/guestfish-actions.pod:1987
11045 msgid ""
11046 "Future versions of libguestfs may return other strings here.  The caller "
11047 "should be prepared to handle any string."
11048 msgstr ""
11049
11050 # type: =head2
11051 #. type: =head2
11052 #: ../src/guestfs-actions.pod:2615
11053 msgid "guestfs_inspect_get_filesystems"
11054 msgstr ""
11055
11056 # type: verbatim
11057 #. type: verbatim
11058 #: ../src/guestfs-actions.pod:2617
11059 #, no-wrap
11060 msgid ""
11061 " char **\n"
11062 " guestfs_inspect_get_filesystems (guestfs_h *g,\n"
11063 "                                  const char *root);\n"
11064 "\n"
11065 msgstr ""
11066
11067 # type: textblock
11068 #. type: textblock
11069 #: ../src/guestfs-actions.pod:2624 ../fish/guestfish-actions.pod:1792
11070 msgid ""
11071 "This returns a list of all the filesystems that we think are associated with "
11072 "this operating system.  This includes the root filesystem, other ordinary "
11073 "filesystems, and non-mounted devices like swap partitions."
11074 msgstr ""
11075
11076 # type: textblock
11077 #. type: textblock
11078 #: ../src/guestfs-actions.pod:2629 ../fish/guestfish-actions.pod:1797
11079 msgid ""
11080 "In the case of a multi-boot virtual machine, it is possible for a filesystem "
11081 "to be shared between operating systems."
11082 msgstr ""
11083
11084 # type: textblock
11085 #. type: textblock
11086 #: ../src/guestfs-actions.pod:2632
11087 msgid ""
11088 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
11089 "C<guestfs_inspect_get_mountpoints>."
11090 msgstr ""
11091
11092 # type: =head2
11093 #. type: =head2
11094 #: ../src/guestfs-actions.pod:2641
11095 msgid "guestfs_inspect_get_hostname"
11096 msgstr ""
11097
11098 # type: verbatim
11099 #. type: verbatim
11100 #: ../src/guestfs-actions.pod:2643
11101 #, no-wrap
11102 msgid ""
11103 " char *\n"
11104 " guestfs_inspect_get_hostname (guestfs_h *g,\n"
11105 "                               const char *root);\n"
11106 "\n"
11107 msgstr ""
11108
11109 # type: textblock
11110 #. type: textblock
11111 #: ../src/guestfs-actions.pod:2650 ../fish/guestfish-actions.pod:1810
11112 msgid ""
11113 "This function returns the hostname of the operating system as found by "
11114 "inspection of the guest's configuration files."
11115 msgstr ""
11116
11117 # type: textblock
11118 #. type: textblock
11119 #: ../src/guestfs-actions.pod:2653 ../fish/guestfish-actions.pod:1813
11120 msgid ""
11121 "If the hostname could not be determined, then the string C<unknown> is "
11122 "returned."
11123 msgstr ""
11124
11125 # type: textblock
11126 #. type: textblock
11127 #: ../src/guestfs-actions.pod:2661
11128 msgid "(Added in 1.7.9)"
11129 msgstr ""
11130
11131 # type: =head2
11132 #. type: =head2
11133 #: ../src/guestfs-actions.pod:2663
11134 msgid "guestfs_inspect_get_major_version"
11135 msgstr ""
11136
11137 # type: verbatim
11138 #. type: verbatim
11139 #: ../src/guestfs-actions.pod:2665
11140 #, no-wrap
11141 msgid ""
11142 " int\n"
11143 " guestfs_inspect_get_major_version (guestfs_h *g,\n"
11144 "                                    const char *root);\n"
11145 "\n"
11146 msgstr ""
11147
11148 # type: textblock
11149 #. type: textblock
11150 #: ../src/guestfs-actions.pod:2672 ../fish/guestfish-actions.pod:1825
11151 msgid ""
11152 "This returns the major version number of the inspected operating system."
11153 msgstr ""
11154
11155 # type: textblock
11156 #. type: textblock
11157 #: ../src/guestfs-actions.pod:2675 ../fish/guestfish-actions.pod:1828
11158 msgid ""
11159 "Windows uses a consistent versioning scheme which is I<not> reflected in the "
11160 "popular public names used by the operating system.  Notably the operating "
11161 "system known as \"Windows 7\" is really version 6.1 (ie. major = 6, minor = "
11162 "1).  You can find out the real versions corresponding to releases of Windows "
11163 "by consulting Wikipedia or MSDN."
11164 msgstr ""
11165
11166 # type: textblock
11167 #. type: textblock
11168 #: ../src/guestfs-actions.pod:2682 ../src/guestfs-actions.pod:2702
11169 #: ../fish/guestfish-actions.pod:1835 ../fish/guestfish-actions.pod:1849
11170 msgid "If the version could not be determined, then C<0> is returned."
11171 msgstr ""
11172
11173 # type: =head2
11174 #. type: =head2
11175 #: ../src/guestfs-actions.pod:2690
11176 msgid "guestfs_inspect_get_minor_version"
11177 msgstr ""
11178
11179 # type: verbatim
11180 #. type: verbatim
11181 #: ../src/guestfs-actions.pod:2692
11182 #, no-wrap
11183 msgid ""
11184 " int\n"
11185 " guestfs_inspect_get_minor_version (guestfs_h *g,\n"
11186 "                                    const char *root);\n"
11187 "\n"
11188 msgstr ""
11189
11190 # type: textblock
11191 #. type: textblock
11192 #: ../src/guestfs-actions.pod:2699 ../fish/guestfish-actions.pod:1846
11193 msgid ""
11194 "This returns the minor version number of the inspected operating system."
11195 msgstr ""
11196
11197 # type: textblock
11198 #. type: textblock
11199 #: ../src/guestfs-actions.pod:2704
11200 msgid ""
11201 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
11202 "C<guestfs_inspect_get_major_version>."
11203 msgstr ""
11204
11205 # type: =head2
11206 #. type: =head2
11207 #: ../src/guestfs-actions.pod:2711
11208 msgid "guestfs_inspect_get_mountpoints"
11209 msgstr ""
11210
11211 # type: verbatim
11212 #. type: verbatim
11213 #: ../src/guestfs-actions.pod:2713
11214 #, no-wrap
11215 msgid ""
11216 " char **\n"
11217 " guestfs_inspect_get_mountpoints (guestfs_h *g,\n"
11218 "                                  const char *root);\n"
11219 "\n"
11220 msgstr ""
11221
11222 #. type: textblock
11223 #: ../src/guestfs-actions.pod:2720 ../fish/guestfish-actions.pod:1861
11224 msgid ""
11225 "This returns a hash of where we think the filesystems associated with this "
11226 "operating system should be mounted.  Callers should note that this is at "
11227 "best an educated guess made by reading configuration files such as C</etc/"
11228 "fstab>.  I<In particular note> that this may return filesystems which are "
11229 "non-existent or not mountable and callers should be prepared to handle or "
11230 "ignore failures if they try to mount them."
11231 msgstr ""
11232
11233 # type: textblock
11234 #. type: textblock
11235 #: ../src/guestfs-actions.pod:2729 ../fish/guestfish-actions.pod:1870
11236 msgid ""
11237 "Each element in the returned hashtable has a key which is the path of the "
11238 "mountpoint (eg. C</boot>) and a value which is the filesystem that would be "
11239 "mounted there (eg. C</dev/sda1>)."
11240 msgstr ""
11241
11242 # type: textblock
11243 #. type: textblock
11244 #: ../src/guestfs-actions.pod:2734 ../fish/guestfish-actions.pod:1875
11245 msgid ""
11246 "Non-mounted devices such as swap devices are I<not> returned in this list."
11247 msgstr ""
11248
11249 # type: textblock
11250 #. type: textblock
11251 #: ../src/guestfs-actions.pod:2737
11252 msgid ""
11253 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
11254 "C<guestfs_inspect_get_filesystems>."
11255 msgstr ""
11256
11257 # type: textblock
11258 #. type: textblock
11259 #: ../src/guestfs-actions.pod:2740 ../src/guestfs-actions.pod:3386
11260 #: ../src/guestfs-actions.pod:4584 ../src/guestfs-actions.pod:6449
11261 msgid ""
11262 "This function returns a NULL-terminated array of strings, or NULL if there "
11263 "was an error.  The array of strings will always have length C<2n+1>, where "
11264 "C<n> keys and values alternate, followed by the trailing NULL entry.  I<The "
11265 "caller must free the strings and the array after use>."
11266 msgstr ""
11267
11268 # type: =head2
11269 #. type: =head2
11270 #: ../src/guestfs-actions.pod:2748
11271 msgid "guestfs_inspect_get_package_format"
11272 msgstr ""
11273
11274 # type: verbatim
11275 #. type: verbatim
11276 #: ../src/guestfs-actions.pod:2750
11277 #, no-wrap
11278 msgid ""
11279 " char *\n"
11280 " guestfs_inspect_get_package_format (guestfs_h *g,\n"
11281 "                                     const char *root);\n"
11282 "\n"
11283 msgstr ""
11284
11285 # type: textblock
11286 #. type: textblock
11287 #: ../src/guestfs-actions.pod:2757
11288 msgid ""
11289 "This function and C<guestfs_inspect_get_package_management> return the "
11290 "package format and package management tool used by the inspected operating "
11291 "system.  For example for Fedora these functions would return C<rpm> (package "
11292 "format) and C<yum> (package management)."
11293 msgstr ""
11294
11295 # type: textblock
11296 #. type: textblock
11297 #: ../src/guestfs-actions.pod:2763 ../fish/guestfish-actions.pod:1894
11298 msgid ""
11299 "This returns the string C<unknown> if we could not determine the package "
11300 "format I<or> if the operating system does not have a real packaging system "
11301 "(eg. Windows)."
11302 msgstr ""
11303
11304 # type: textblock
11305 #. type: textblock
11306 #: ../src/guestfs-actions.pod:2767 ../fish/guestfish-actions.pod:1898
11307 msgid ""
11308 "Possible strings include: C<rpm>, C<deb>, C<ebuild>, C<pisi>, C<pacman>.  "
11309 "Future versions of libguestfs may return other strings."
11310 msgstr ""
11311
11312 # type: textblock
11313 #. type: textblock
11314 #: ../src/guestfs-actions.pod:2775 ../src/guestfs-actions.pod:2806
11315 msgid "(Added in 1.7.5)"
11316 msgstr ""
11317
11318 # type: =head2
11319 #. type: =head2
11320 #: ../src/guestfs-actions.pod:2777
11321 msgid "guestfs_inspect_get_package_management"
11322 msgstr ""
11323
11324 # type: verbatim
11325 #. type: verbatim
11326 #: ../src/guestfs-actions.pod:2779
11327 #, no-wrap
11328 msgid ""
11329 " char *\n"
11330 " guestfs_inspect_get_package_management (guestfs_h *g,\n"
11331 "                                         const char *root);\n"
11332 "\n"
11333 msgstr ""
11334
11335 # type: textblock
11336 #. type: textblock
11337 #: ../src/guestfs-actions.pod:2786
11338 msgid ""
11339 "C<guestfs_inspect_get_package_format> and this function return the package "
11340 "format and package management tool used by the inspected operating system.  "
11341 "For example for Fedora these functions would return C<rpm> (package format) "
11342 "and C<yum> (package management)."
11343 msgstr ""
11344
11345 # type: textblock
11346 #. type: textblock
11347 #: ../src/guestfs-actions.pod:2792 ../fish/guestfish-actions.pod:1916
11348 msgid ""
11349 "This returns the string C<unknown> if we could not determine the package "
11350 "management tool I<or> if the operating system does not have a real packaging "
11351 "system (eg. Windows)."
11352 msgstr ""
11353
11354 # type: textblock
11355 #. type: textblock
11356 #: ../src/guestfs-actions.pod:2796 ../fish/guestfish-actions.pod:1920
11357 msgid ""
11358 "Possible strings include: C<yum>, C<up2date>, C<apt> (for all Debian "
11359 "derivatives), C<portage>, C<pisi>, C<pacman>, C<urpmi>.  Future versions of "
11360 "libguestfs may return other strings."
11361 msgstr ""
11362
11363 # type: =head2
11364 #. type: =head2
11365 #: ../src/guestfs-actions.pod:2808
11366 msgid "guestfs_inspect_get_product_name"
11367 msgstr ""
11368
11369 # type: verbatim
11370 #. type: verbatim
11371 #: ../src/guestfs-actions.pod:2810
11372 #, no-wrap
11373 msgid ""
11374 " char *\n"
11375 " guestfs_inspect_get_product_name (guestfs_h *g,\n"
11376 "                                   const char *root);\n"
11377 "\n"
11378 msgstr ""
11379
11380 # type: textblock
11381 #. type: textblock
11382 #: ../src/guestfs-actions.pod:2817 ../fish/guestfish-actions.pod:1934
11383 msgid ""
11384 "This returns the product name of the inspected operating system.  The "
11385 "product name is generally some freeform string which can be displayed to the "
11386 "user, but should not be parsed by programs."
11387 msgstr ""
11388
11389 # type: textblock
11390 #. type: textblock
11391 #: ../src/guestfs-actions.pod:2822 ../fish/guestfish-actions.pod:1939
11392 msgid ""
11393 "If the product name could not be determined, then the string C<unknown> is "
11394 "returned."
11395 msgstr ""
11396
11397 # type: =head2
11398 #. type: =head2
11399 #: ../src/guestfs-actions.pod:2832
11400 msgid "guestfs_inspect_get_roots"
11401 msgstr ""
11402
11403 # type: verbatim
11404 #. type: verbatim
11405 #: ../src/guestfs-actions.pod:2834
11406 #, no-wrap
11407 msgid ""
11408 " char **\n"
11409 " guestfs_inspect_get_roots (guestfs_h *g);\n"
11410 "\n"
11411 msgstr ""
11412
11413 # type: textblock
11414 #. type: textblock
11415 #: ../src/guestfs-actions.pod:2837
11416 msgid ""
11417 "This function is a convenient way to get the list of root devices, as "
11418 "returned from a previous call to C<guestfs_inspect_os>, but without redoing "
11419 "the whole inspection process."
11420 msgstr ""
11421
11422 # type: textblock
11423 #. type: textblock
11424 #: ../src/guestfs-actions.pod:2841
11425 msgid ""
11426 "This returns an empty list if either no root devices were found or the "
11427 "caller has not called C<guestfs_inspect_os>."
11428 msgstr ""
11429
11430 # type: textblock
11431 #. type: textblock
11432 #: ../src/guestfs-actions.pod:2850
11433 msgid "(Added in 1.7.3)"
11434 msgstr ""
11435
11436 # type: =head2
11437 #. type: =head2
11438 #: ../src/guestfs-actions.pod:2852
11439 msgid "guestfs_inspect_get_type"
11440 msgstr ""
11441
11442 # type: verbatim
11443 #. type: verbatim
11444 #: ../src/guestfs-actions.pod:2854
11445 #, no-wrap
11446 msgid ""
11447 " char *\n"
11448 " guestfs_inspect_get_type (guestfs_h *g,\n"
11449 "                           const char *root);\n"
11450 "\n"
11451 msgstr ""
11452
11453 # type: textblock
11454 #. type: textblock
11455 #: ../src/guestfs-actions.pod:2861 ../fish/guestfish-actions.pod:1964
11456 msgid ""
11457 "This returns the type of the inspected operating system.  Currently defined "
11458 "types are:"
11459 msgstr ""
11460
11461 # type: =item
11462 #. type: =item
11463 #: ../src/guestfs-actions.pod:2866 ../fish/guestfish-actions.pod:1969
11464 msgid "\"linux\""
11465 msgstr ""
11466
11467 # type: textblock
11468 #. type: textblock
11469 #: ../src/guestfs-actions.pod:2868 ../fish/guestfish-actions.pod:1971
11470 msgid "Any Linux-based operating system."
11471 msgstr ""
11472
11473 # type: textblock
11474 #. type: textblock
11475 #: ../src/guestfs-actions.pod:2872 ../fish/guestfish-actions.pod:1975
11476 msgid "Any Microsoft Windows operating system."
11477 msgstr ""
11478
11479 # type: =item
11480 #. type: =item
11481 #: ../src/guestfs-actions.pod:2874 ../fish/guestfish-actions.pod:1977
11482 msgid "\"freebsd\""
11483 msgstr ""
11484
11485 # type: textblock
11486 #. type: textblock
11487 #: ../src/guestfs-actions.pod:2876 ../fish/guestfish-actions.pod:1979
11488 msgid "FreeBSD."
11489 msgstr ""
11490
11491 # type: textblock
11492 #. type: textblock
11493 #: ../src/guestfs-actions.pod:2880 ../fish/guestfish-actions.pod:1983
11494 msgid "The operating system type could not be determined."
11495 msgstr ""
11496
11497 # type: =head2
11498 #. type: =head2
11499 #: ../src/guestfs-actions.pod:2894
11500 msgid "guestfs_inspect_get_windows_systemroot"
11501 msgstr ""
11502
11503 # type: verbatim
11504 #. type: verbatim
11505 #: ../src/guestfs-actions.pod:2896
11506 #, no-wrap
11507 msgid ""
11508 " char *\n"
11509 " guestfs_inspect_get_windows_systemroot (guestfs_h *g,\n"
11510 "                                         const char *root);\n"
11511 "\n"
11512 msgstr ""
11513
11514 # type: textblock
11515 #. type: textblock
11516 #: ../src/guestfs-actions.pod:2903 ../fish/guestfish-actions.pod:1999
11517 msgid ""
11518 "This returns the Windows systemroot of the inspected guest.  The systemroot "
11519 "is a directory path such as C</WINDOWS>."
11520 msgstr ""
11521
11522 # type: textblock
11523 #. type: textblock
11524 #: ../src/guestfs-actions.pod:2906 ../fish/guestfish-actions.pod:2002
11525 msgid ""
11526 "This call assumes that the guest is Windows and that the systemroot could be "
11527 "determined by inspection.  If this is not the case then an error is returned."
11528 msgstr ""
11529
11530 # type: textblock
11531 #. type: textblock
11532 #: ../src/guestfs-actions.pod:2915
11533 msgid "(Added in 1.5.25)"
11534 msgstr ""
11535
11536 # type: =head2
11537 #. type: =head2
11538 #: ../src/guestfs-actions.pod:2917
11539 msgid "guestfs_inspect_list_applications"
11540 msgstr ""
11541
11542 # type: verbatim
11543 #. type: verbatim
11544 #: ../src/guestfs-actions.pod:2919
11545 #, no-wrap
11546 msgid ""
11547 " struct guestfs_application_list *\n"
11548 " guestfs_inspect_list_applications (guestfs_h *g,\n"
11549 "                                    const char *root);\n"
11550 "\n"
11551 msgstr ""
11552
11553 # type: textblock
11554 #. type: textblock
11555 #: ../src/guestfs-actions.pod:2926 ../fish/guestfish-actions.pod:2015
11556 msgid "Return the list of applications installed in the operating system."
11557 msgstr ""
11558
11559 # type: textblock
11560 #. type: textblock
11561 #: ../src/guestfs-actions.pod:2928
11562 msgid ""
11563 "I<Note:> This call works differently from other parts of the inspection "
11564 "API.  You have to call C<guestfs_inspect_os>, then "
11565 "C<guestfs_inspect_get_mountpoints>, then mount up the disks, before calling "
11566 "this.  Listing applications is a significantly more difficult operation "
11567 "which requires access to the full filesystem.  Also note that unlike the "
11568 "other C<guestfs_inspect_get_*> calls which are just returning data cached in "
11569 "the libguestfs handle, this call actually reads parts of the mounted "
11570 "filesystems during the call."
11571 msgstr ""
11572
11573 # type: textblock
11574 #. type: textblock
11575 #: ../src/guestfs-actions.pod:2938 ../fish/guestfish-actions.pod:2027
11576 msgid ""
11577 "This returns an empty list if the inspection code was not able to determine "
11578 "the list of applications."
11579 msgstr ""
11580
11581 # type: textblock
11582 #. type: textblock
11583 #: ../src/guestfs-actions.pod:2941 ../fish/guestfish-actions.pod:2030
11584 msgid "The application structure contains the following fields:"
11585 msgstr ""
11586
11587 # type: =item
11588 #. type: =item
11589 #: ../src/guestfs-actions.pod:2945 ../fish/guestfish-actions.pod:2034
11590 msgid "C<app_name>"
11591 msgstr ""
11592
11593 # type: textblock
11594 #. type: textblock
11595 #: ../src/guestfs-actions.pod:2947 ../fish/guestfish-actions.pod:2036
11596 msgid ""
11597 "The name of the application.  For Red Hat-derived and Debian-derived Linux "
11598 "guests, this is the package name."
11599 msgstr ""
11600
11601 # type: =item
11602 #. type: =item
11603 #: ../src/guestfs-actions.pod:2950 ../fish/guestfish-actions.pod:2039
11604 msgid "C<app_display_name>"
11605 msgstr ""
11606
11607 # type: textblock
11608 #. type: textblock
11609 #: ../src/guestfs-actions.pod:2952 ../fish/guestfish-actions.pod:2041
11610 msgid ""
11611 "The display name of the application, sometimes localized to the install "
11612 "language of the guest operating system."
11613 msgstr ""
11614
11615 # type: textblock
11616 #. type: textblock
11617 #: ../src/guestfs-actions.pod:2955 ../fish/guestfish-actions.pod:2044
11618 msgid ""
11619 "If unavailable this is returned as an empty string C<\"\">.  Callers needing "
11620 "to display something can use C<app_name> instead."
11621 msgstr ""
11622
11623 # type: =item
11624 #. type: =item
11625 #: ../src/guestfs-actions.pod:2958 ../fish/guestfish-actions.pod:2047
11626 msgid "C<app_epoch>"
11627 msgstr ""
11628
11629 # type: textblock
11630 #. type: textblock
11631 #: ../src/guestfs-actions.pod:2960 ../fish/guestfish-actions.pod:2049
11632 msgid ""
11633 "For package managers which use epochs, this contains the epoch of the "
11634 "package (an integer).  If unavailable, this is returned as C<0>."
11635 msgstr ""
11636
11637 # type: =item
11638 #. type: =item
11639 #: ../src/guestfs-actions.pod:2963 ../fish/guestfish-actions.pod:2052
11640 msgid "C<app_version>"
11641 msgstr ""
11642
11643 # type: textblock
11644 #. type: textblock
11645 #: ../src/guestfs-actions.pod:2965 ../fish/guestfish-actions.pod:2054
11646 msgid ""
11647 "The version string of the application or package.  If unavailable this is "
11648 "returned as an empty string C<\"\">."
11649 msgstr ""
11650
11651 # type: =item
11652 #. type: =item
11653 #: ../src/guestfs-actions.pod:2968 ../fish/guestfish-actions.pod:2057
11654 msgid "C<app_release>"
11655 msgstr ""
11656
11657 # type: textblock
11658 #. type: textblock
11659 #: ../src/guestfs-actions.pod:2970 ../fish/guestfish-actions.pod:2059
11660 msgid ""
11661 "The release string of the application or package, for package managers that "
11662 "use this.  If unavailable this is returned as an empty string C<\"\">."
11663 msgstr ""
11664
11665 # type: =item
11666 #. type: =item
11667 #: ../src/guestfs-actions.pod:2974 ../fish/guestfish-actions.pod:2063
11668 msgid "C<app_install_path>"
11669 msgstr ""
11670
11671 # type: textblock
11672 #. type: textblock
11673 #: ../src/guestfs-actions.pod:2976 ../fish/guestfish-actions.pod:2065
11674 msgid ""
11675 "The installation path of the application (on operating systems such as "
11676 "Windows which use installation paths).  This path is in the format used by "
11677 "the guest operating system, it is not a libguestfs path."
11678 msgstr ""
11679
11680 # type: textblock
11681 #. type: textblock
11682 #: ../src/guestfs-actions.pod:2981 ../fish/guestfish-actions.pod:2070
11683 msgid "If unavailable this is returned as an empty string C<\"\">."
11684 msgstr ""
11685
11686 # type: =item
11687 #. type: =item
11688 #: ../src/guestfs-actions.pod:2983 ../fish/guestfish-actions.pod:2072
11689 msgid "C<app_trans_path>"
11690 msgstr ""
11691
11692 # type: textblock
11693 #. type: textblock
11694 #: ../src/guestfs-actions.pod:2985 ../fish/guestfish-actions.pod:2074
11695 msgid ""
11696 "The install path translated into a libguestfs path.  If unavailable this is "
11697 "returned as an empty string C<\"\">."
11698 msgstr ""
11699
11700 # type: =item
11701 #. type: =item
11702 #: ../src/guestfs-actions.pod:2988 ../fish/guestfish-actions.pod:2077
11703 msgid "C<app_publisher>"
11704 msgstr ""
11705
11706 # type: textblock
11707 #. type: textblock
11708 #: ../src/guestfs-actions.pod:2990 ../fish/guestfish-actions.pod:2079
11709 msgid ""
11710 "The name of the publisher of the application, for package managers that use "
11711 "this.  If unavailable this is returned as an empty string C<\"\">."
11712 msgstr ""
11713
11714 # type: =item
11715 #. type: =item
11716 #: ../src/guestfs-actions.pod:2994 ../fish/guestfish-actions.pod:2083
11717 msgid "C<app_url>"
11718 msgstr ""
11719
11720 # type: textblock
11721 #. type: textblock
11722 #: ../src/guestfs-actions.pod:2996 ../fish/guestfish-actions.pod:2085
11723 msgid ""
11724 "The URL (eg. upstream URL) of the application.  If unavailable this is "
11725 "returned as an empty string C<\"\">."
11726 msgstr ""
11727
11728 # type: =item
11729 #. type: =item
11730 #: ../src/guestfs-actions.pod:2999 ../fish/guestfish-actions.pod:2088
11731 msgid "C<app_source_package>"
11732 msgstr ""
11733
11734 # type: textblock
11735 #. type: textblock
11736 #: ../src/guestfs-actions.pod:3001 ../fish/guestfish-actions.pod:2090
11737 msgid ""
11738 "For packaging systems which support this, the name of the source package.  "
11739 "If unavailable this is returned as an empty string C<\"\">."
11740 msgstr ""
11741
11742 # type: =item
11743 #. type: =item
11744 #: ../src/guestfs-actions.pod:3004 ../fish/guestfish-actions.pod:2093
11745 msgid "C<app_summary>"
11746 msgstr ""
11747
11748 # type: textblock
11749 #. type: textblock
11750 #: ../src/guestfs-actions.pod:3006 ../fish/guestfish-actions.pod:2095
11751 msgid ""
11752 "A short (usually one line) description of the application or package.  If "
11753 "unavailable this is returned as an empty string C<\"\">."
11754 msgstr ""
11755
11756 # type: =item
11757 #. type: =item
11758 #: ../src/guestfs-actions.pod:3009 ../fish/guestfish-actions.pod:2098
11759 msgid "C<app_description>"
11760 msgstr ""
11761
11762 # type: textblock
11763 #. type: textblock
11764 #: ../src/guestfs-actions.pod:3011 ../fish/guestfish-actions.pod:2100
11765 msgid ""
11766 "A longer description of the application or package.  If unavailable this is "
11767 "returned as an empty string C<\"\">."
11768 msgstr ""
11769
11770 # type: textblock
11771 #. type: textblock
11772 #: ../src/guestfs-actions.pod:3018
11773 msgid ""
11774 "This function returns a C<struct guestfs_application_list *>, or NULL if "
11775 "there was an error.  I<The caller must call C<guestfs_free_application_list> "
11776 "after use>."
11777 msgstr ""
11778
11779 # type: textblock
11780 #. type: textblock
11781 #: ../src/guestfs-actions.pod:3022
11782 msgid "(Added in 1.7.8)"
11783 msgstr ""
11784
11785 # type: =head2
11786 #. type: =head2
11787 #: ../src/guestfs-actions.pod:3024
11788 msgid "guestfs_inspect_os"
11789 msgstr ""
11790
11791 # type: verbatim
11792 #. type: verbatim
11793 #: ../src/guestfs-actions.pod:3026
11794 #, no-wrap
11795 msgid ""
11796 " char **\n"
11797 " guestfs_inspect_os (guestfs_h *g);\n"
11798 "\n"
11799 msgstr ""
11800
11801 # type: textblock
11802 #. type: textblock
11803 #: ../src/guestfs-actions.pod:3029 ../fish/guestfish-actions.pod:2111
11804 msgid ""
11805 "This function uses other libguestfs functions and certain heuristics to "
11806 "inspect the disk(s) (usually disks belonging to a virtual machine), looking "
11807 "for operating systems."
11808 msgstr ""
11809
11810 # type: textblock
11811 #. type: textblock
11812 #: ../src/guestfs-actions.pod:3033 ../fish/guestfish-actions.pod:2115
11813 msgid "The list returned is empty if no operating systems were found."
11814 msgstr ""
11815
11816 # type: textblock
11817 #. type: textblock
11818 #: ../src/guestfs-actions.pod:3035 ../fish/guestfish-actions.pod:2117
11819 msgid ""
11820 "If one operating system was found, then this returns a list with a single "
11821 "element, which is the name of the root filesystem of this operating system.  "
11822 "It is also possible for this function to return a list containing more than "
11823 "one element, indicating a dual-boot or multi-boot virtual machine, with each "
11824 "element being the root filesystem of one of the operating systems."
11825 msgstr ""
11826
11827 # type: textblock
11828 #. type: textblock
11829 #: ../src/guestfs-actions.pod:3042
11830 msgid ""
11831 "You can pass the root string(s) returned to other C<guestfs_inspect_get_*> "
11832 "functions in order to query further information about each operating system, "
11833 "such as the name and version."
11834 msgstr ""
11835
11836 # type: textblock
11837 #. type: textblock
11838 #: ../src/guestfs-actions.pod:3047
11839 msgid ""
11840 "This function uses other libguestfs features such as C<guestfs_mount_ro> and "
11841 "C<guestfs_umount_all> in order to mount and unmount filesystems and look at "
11842 "the contents.  This should be called with no disks currently mounted.  The "
11843 "function may also use Augeas, so any existing Augeas handle will be closed."
11844 msgstr ""
11845
11846 # type: textblock
11847 #. type: textblock
11848 #: ../src/guestfs-actions.pod:3053 ../fish/guestfish-actions.pod:2135
11849 msgid ""
11850 "This function cannot decrypt encrypted disks.  The caller must do that first "
11851 "(supplying the necessary keys) if the disk is encrypted."
11852 msgstr ""
11853
11854 # type: textblock
11855 #. type: textblock
11856 #: ../src/guestfs-actions.pod:3059 ../src/guestfs-actions.pod:3344
11857 #: ../src/guestfs-actions.pod:3406
11858 msgid "See also C<guestfs_list_filesystems>."
11859 msgstr ""
11860
11861 # type: =head2
11862 #. type: =head2
11863 #: ../src/guestfs-actions.pod:3067
11864 msgid "guestfs_is_blockdev"
11865 msgstr ""
11866
11867 # type: verbatim
11868 #. type: verbatim
11869 #: ../src/guestfs-actions.pod:3069
11870 #, no-wrap
11871 msgid ""
11872 " int\n"
11873 " guestfs_is_blockdev (guestfs_h *g,\n"
11874 "                      const char *path);\n"
11875 "\n"
11876 msgstr ""
11877
11878 # type: textblock
11879 #. type: textblock
11880 #: ../src/guestfs-actions.pod:3073 ../fish/guestfish-actions.pod:2147
11881 msgid ""
11882 "This returns C<true> if and only if there is a block device with the given "
11883 "C<path> name."
11884 msgstr ""
11885
11886 # type: textblock
11887 #. type: textblock
11888 #: ../src/guestfs-actions.pod:3076 ../src/guestfs-actions.pod:3105
11889 #: ../src/guestfs-actions.pod:3135 ../src/guestfs-actions.pod:3150
11890 #: ../src/guestfs-actions.pod:3166 ../src/guestfs-actions.pod:3222
11891 #: ../src/guestfs-actions.pod:3237
11892 msgid "See also C<guestfs_stat>."
11893 msgstr ""
11894
11895 # type: textblock
11896 #. type: textblock
11897 #: ../src/guestfs-actions.pod:3080 ../src/guestfs-actions.pod:3109
11898 #: ../src/guestfs-actions.pod:3154 ../src/guestfs-actions.pod:3226
11899 #: ../src/guestfs-actions.pod:3241
11900 msgid "(Added in 1.5.10)"
11901 msgstr ""
11902
11903 # type: =head2
11904 #. type: =head2
11905 #: ../src/guestfs-actions.pod:3082
11906 msgid "guestfs_is_busy"
11907 msgstr ""
11908
11909 # type: verbatim
11910 #. type: verbatim
11911 #: ../src/guestfs-actions.pod:3084
11912 #, no-wrap
11913 msgid ""
11914 " int\n"
11915 " guestfs_is_busy (guestfs_h *g);\n"
11916 "\n"
11917 msgstr ""
11918
11919 # type: textblock
11920 #. type: textblock
11921 #: ../src/guestfs-actions.pod:3087 ../fish/guestfish-actions.pod:2156
11922 msgid ""
11923 "This returns true iff this handle is busy processing a command (in the "
11924 "C<BUSY> state)."
11925 msgstr ""
11926
11927 # type: =head2
11928 #. type: =head2
11929 #: ../src/guestfs-actions.pod:3096
11930 msgid "guestfs_is_chardev"
11931 msgstr ""
11932
11933 # type: verbatim
11934 #. type: verbatim
11935 #: ../src/guestfs-actions.pod:3098
11936 #, no-wrap
11937 msgid ""
11938 " int\n"
11939 " guestfs_is_chardev (guestfs_h *g,\n"
11940 "                     const char *path);\n"
11941 "\n"
11942 msgstr ""
11943
11944 # type: textblock
11945 #. type: textblock
11946 #: ../src/guestfs-actions.pod:3102 ../fish/guestfish-actions.pod:2165
11947 msgid ""
11948 "This returns C<true> if and only if there is a character device with the "
11949 "given C<path> name."
11950 msgstr ""
11951
11952 # type: =head2
11953 #. type: =head2
11954 #: ../src/guestfs-actions.pod:3111
11955 msgid "guestfs_is_config"
11956 msgstr ""
11957
11958 # type: verbatim
11959 #. type: verbatim
11960 #: ../src/guestfs-actions.pod:3113
11961 #, no-wrap
11962 msgid ""
11963 " int\n"
11964 " guestfs_is_config (guestfs_h *g);\n"
11965 "\n"
11966 msgstr ""
11967
11968 # type: textblock
11969 #. type: textblock
11970 #: ../src/guestfs-actions.pod:3116 ../fish/guestfish-actions.pod:2174
11971 msgid ""
11972 "This returns true iff this handle is being configured (in the C<CONFIG> "
11973 "state)."
11974 msgstr ""
11975
11976 # type: =head2
11977 #. type: =head2
11978 #: ../src/guestfs-actions.pod:3125
11979 msgid "guestfs_is_dir"
11980 msgstr ""
11981
11982 # type: verbatim
11983 #. type: verbatim
11984 #: ../src/guestfs-actions.pod:3127
11985 #, no-wrap
11986 msgid ""
11987 " int\n"
11988 " guestfs_is_dir (guestfs_h *g,\n"
11989 "                 const char *path);\n"
11990 "\n"
11991 msgstr ""
11992
11993 # type: textblock
11994 #. type: textblock
11995 #: ../src/guestfs-actions.pod:3131 ../fish/guestfish-actions.pod:2183
11996 msgid ""
11997 "This returns C<true> if and only if there is a directory with the given "
11998 "C<path> name.  Note that it returns false for other objects like files."
11999 msgstr ""
12000
12001 # type: =head2
12002 #. type: =head2
12003 #: ../src/guestfs-actions.pod:3141
12004 msgid "guestfs_is_fifo"
12005 msgstr ""
12006
12007 # type: verbatim
12008 #. type: verbatim
12009 #: ../src/guestfs-actions.pod:3143
12010 #, no-wrap
12011 msgid ""
12012 " int\n"
12013 " guestfs_is_fifo (guestfs_h *g,\n"
12014 "                  const char *path);\n"
12015 "\n"
12016 msgstr ""
12017
12018 # type: textblock
12019 #. type: textblock
12020 #: ../src/guestfs-actions.pod:3147 ../fish/guestfish-actions.pod:2193
12021 msgid ""
12022 "This returns C<true> if and only if there is a FIFO (named pipe)  with the "
12023 "given C<path> name."
12024 msgstr ""
12025
12026 # type: =head2
12027 #. type: =head2
12028 #: ../src/guestfs-actions.pod:3156
12029 msgid "guestfs_is_file"
12030 msgstr ""
12031
12032 # type: verbatim
12033 #. type: verbatim
12034 #: ../src/guestfs-actions.pod:3158
12035 #, no-wrap
12036 msgid ""
12037 " int\n"
12038 " guestfs_is_file (guestfs_h *g,\n"
12039 "                  const char *path);\n"
12040 "\n"
12041 msgstr ""
12042
12043 # type: textblock
12044 #. type: textblock
12045 #: ../src/guestfs-actions.pod:3162 ../fish/guestfish-actions.pod:2202
12046 msgid ""
12047 "This returns C<true> if and only if there is a regular file with the given "
12048 "C<path> name.  Note that it returns false for other objects like directories."
12049 msgstr ""
12050
12051 # type: =head2
12052 #. type: =head2
12053 #: ../src/guestfs-actions.pod:3172
12054 msgid "guestfs_is_launching"
12055 msgstr ""
12056
12057 # type: verbatim
12058 #. type: verbatim
12059 #: ../src/guestfs-actions.pod:3174
12060 #, no-wrap
12061 msgid ""
12062 " int\n"
12063 " guestfs_is_launching (guestfs_h *g);\n"
12064 "\n"
12065 msgstr ""
12066
12067 # type: textblock
12068 #. type: textblock
12069 #: ../src/guestfs-actions.pod:3177 ../fish/guestfish-actions.pod:2212
12070 msgid ""
12071 "This returns true iff this handle is launching the subprocess (in the "
12072 "C<LAUNCHING> state)."
12073 msgstr ""
12074
12075 # type: =head2
12076 #. type: =head2
12077 #: ../src/guestfs-actions.pod:3186
12078 msgid "guestfs_is_lv"
12079 msgstr ""
12080
12081 # type: verbatim
12082 #. type: verbatim
12083 #: ../src/guestfs-actions.pod:3188
12084 #, no-wrap
12085 msgid ""
12086 " int\n"
12087 " guestfs_is_lv (guestfs_h *g,\n"
12088 "                const char *device);\n"
12089 "\n"
12090 msgstr ""
12091
12092 # type: textblock
12093 #. type: textblock
12094 #: ../src/guestfs-actions.pod:3192 ../fish/guestfish-actions.pod:2221
12095 msgid ""
12096 "This command tests whether C<device> is a logical volume, and returns true "
12097 "iff this is the case."
12098 msgstr ""
12099
12100 # type: =head2
12101 #. type: =head2
12102 #: ../src/guestfs-actions.pod:3199
12103 msgid "guestfs_is_ready"
12104 msgstr ""
12105
12106 # type: verbatim
12107 #. type: verbatim
12108 #: ../src/guestfs-actions.pod:3201
12109 #, no-wrap
12110 msgid ""
12111 " int\n"
12112 " guestfs_is_ready (guestfs_h *g);\n"
12113 "\n"
12114 msgstr ""
12115
12116 # type: textblock
12117 #. type: textblock
12118 #: ../src/guestfs-actions.pod:3204 ../fish/guestfish-actions.pod:2228
12119 msgid ""
12120 "This returns true iff this handle is ready to accept commands (in the "
12121 "C<READY> state)."
12122 msgstr ""
12123
12124 # type: =head2
12125 #. type: =head2
12126 #: ../src/guestfs-actions.pod:3213
12127 msgid "guestfs_is_socket"
12128 msgstr ""
12129
12130 # type: verbatim
12131 #. type: verbatim
12132 #: ../src/guestfs-actions.pod:3215
12133 #, no-wrap
12134 msgid ""
12135 " int\n"
12136 " guestfs_is_socket (guestfs_h *g,\n"
12137 "                    const char *path);\n"
12138 "\n"
12139 msgstr ""
12140
12141 # type: textblock
12142 #. type: textblock
12143 #: ../src/guestfs-actions.pod:3219 ../fish/guestfish-actions.pod:2237
12144 msgid ""
12145 "This returns C<true> if and only if there is a Unix domain socket with the "
12146 "given C<path> name."
12147 msgstr ""
12148
12149 # type: =head2
12150 #. type: =head2
12151 #: ../src/guestfs-actions.pod:3228
12152 msgid "guestfs_is_symlink"
12153 msgstr ""
12154
12155 # type: verbatim
12156 #. type: verbatim
12157 #: ../src/guestfs-actions.pod:3230
12158 #, no-wrap
12159 msgid ""
12160 " int\n"
12161 " guestfs_is_symlink (guestfs_h *g,\n"
12162 "                     const char *path);\n"
12163 "\n"
12164 msgstr ""
12165
12166 # type: textblock
12167 #. type: textblock
12168 #: ../src/guestfs-actions.pod:3234 ../fish/guestfish-actions.pod:2246
12169 msgid ""
12170 "This returns C<true> if and only if there is a symbolic link with the given "
12171 "C<path> name."
12172 msgstr ""
12173
12174 # type: =head2
12175 #. type: =head2
12176 #: ../src/guestfs-actions.pod:3243
12177 msgid "guestfs_kill_subprocess"
12178 msgstr ""
12179
12180 # type: verbatim
12181 #. type: verbatim
12182 #: ../src/guestfs-actions.pod:3245
12183 #, no-wrap
12184 msgid ""
12185 " int\n"
12186 " guestfs_kill_subprocess (guestfs_h *g);\n"
12187 "\n"
12188 msgstr ""
12189
12190 # type: textblock
12191 #. type: textblock
12192 #: ../src/guestfs-actions.pod:3248 ../fish/guestfish-actions.pod:2255
12193 msgid "This kills the qemu subprocess.  You should never need to call this."
12194 msgstr ""
12195
12196 # type: =head2
12197 #. type: =head2
12198 #: ../src/guestfs-actions.pod:3254
12199 msgid "guestfs_launch"
12200 msgstr ""
12201
12202 # type: verbatim
12203 #. type: verbatim
12204 #: ../src/guestfs-actions.pod:3256
12205 #, no-wrap
12206 msgid ""
12207 " int\n"
12208 " guestfs_launch (guestfs_h *g);\n"
12209 "\n"
12210 msgstr ""
12211
12212 # type: textblock
12213 #. type: textblock
12214 #: ../src/guestfs-actions.pod:3259 ../fish/guestfish-actions.pod:2263
12215 msgid ""
12216 "Internally libguestfs is implemented by running a virtual machine using "
12217 "L<qemu(1)>."
12218 msgstr ""
12219
12220 # type: textblock
12221 #. type: textblock
12222 #: ../src/guestfs-actions.pod:3262 ../fish/guestfish-actions.pod:2266
12223 msgid ""
12224 "You should call this after configuring the handle (eg. adding drives) but "
12225 "before performing any actions."
12226 msgstr ""
12227
12228 # type: =head2
12229 #. type: =head2
12230 #: ../src/guestfs-actions.pod:3269
12231 msgid "guestfs_lchown"
12232 msgstr ""
12233
12234 # type: verbatim
12235 #. type: verbatim
12236 #: ../src/guestfs-actions.pod:3271
12237 #, no-wrap
12238 msgid ""
12239 " int\n"
12240 " guestfs_lchown (guestfs_h *g,\n"
12241 "                 int owner,\n"
12242 "                 int group,\n"
12243 "                 const char *path);\n"
12244 "\n"
12245 msgstr ""
12246
12247 # type: textblock
12248 #. type: textblock
12249 #: ../src/guestfs-actions.pod:3277
12250 msgid ""
12251 "Change the file owner to C<owner> and group to C<group>.  This is like "
12252 "C<guestfs_chown> but if C<path> is a symlink then the link itself is "
12253 "changed, not the target."
12254 msgstr ""
12255
12256 # type: =head2
12257 #. type: =head2
12258 #: ../src/guestfs-actions.pod:3289
12259 msgid "guestfs_lgetxattr"
12260 msgstr ""
12261
12262 # type: verbatim
12263 #. type: verbatim
12264 #: ../src/guestfs-actions.pod:3291
12265 #, no-wrap
12266 msgid ""
12267 " char *\n"
12268 " guestfs_lgetxattr (guestfs_h *g,\n"
12269 "                    const char *path,\n"
12270 "                    const char *name,\n"
12271 "                    size_t *size_r);\n"
12272 "\n"
12273 msgstr ""
12274
12275 # type: textblock
12276 #. type: textblock
12277 #: ../src/guestfs-actions.pod:3297 ../fish/guestfish-actions.pod:2285
12278 msgid ""
12279 "Get a single extended attribute from file C<path> named C<name>.  If C<path> "
12280 "is a symlink, then this call returns an extended attribute from the symlink."
12281 msgstr ""
12282
12283 # type: textblock
12284 #. type: textblock
12285 #: ../src/guestfs-actions.pod:3311
12286 msgid "See also: C<guestfs_lgetxattrs>, C<guestfs_getxattr>, L<attr(5)>."
12287 msgstr ""
12288
12289 # type: =head2
12290 #. type: =head2
12291 #: ../src/guestfs-actions.pod:3319
12292 msgid "guestfs_lgetxattrs"
12293 msgstr ""
12294
12295 # type: verbatim
12296 #. type: verbatim
12297 #: ../src/guestfs-actions.pod:3321
12298 #, no-wrap
12299 msgid ""
12300 " struct guestfs_xattr_list *\n"
12301 " guestfs_lgetxattrs (guestfs_h *g,\n"
12302 "                     const char *path);\n"
12303 "\n"
12304 msgstr ""
12305
12306 # type: textblock
12307 #. type: textblock
12308 #: ../src/guestfs-actions.pod:3325
12309 msgid ""
12310 "This is the same as C<guestfs_getxattrs>, but if C<path> is a symbolic link, "
12311 "then it returns the extended attributes of the link itself."
12312 msgstr ""
12313
12314 # type: =head2
12315 #. type: =head2
12316 #: ../src/guestfs-actions.pod:3335
12317 msgid "guestfs_list_devices"
12318 msgstr ""
12319
12320 # type: verbatim
12321 #. type: verbatim
12322 #: ../src/guestfs-actions.pod:3337
12323 #, no-wrap
12324 msgid ""
12325 " char **\n"
12326 " guestfs_list_devices (guestfs_h *g);\n"
12327 "\n"
12328 msgstr ""
12329
12330 # type: textblock
12331 #. type: textblock
12332 #: ../src/guestfs-actions.pod:3340 ../fish/guestfish-actions.pod:2313
12333 msgid "List all the block devices."
12334 msgstr ""
12335
12336 # type: textblock
12337 #. type: textblock
12338 #: ../src/guestfs-actions.pod:3342 ../fish/guestfish-actions.pod:2315
12339 msgid "The full block device names are returned, eg. C</dev/sda>."
12340 msgstr ""
12341
12342 # type: =head2
12343 #. type: =head2
12344 #: ../src/guestfs-actions.pod:3352
12345 msgid "guestfs_list_filesystems"
12346 msgstr ""
12347
12348 # type: verbatim
12349 #. type: verbatim
12350 #: ../src/guestfs-actions.pod:3354
12351 #, no-wrap
12352 msgid ""
12353 " char **\n"
12354 " guestfs_list_filesystems (guestfs_h *g);\n"
12355 "\n"
12356 msgstr ""
12357
12358 # type: textblock
12359 #. type: textblock
12360 #: ../src/guestfs-actions.pod:3357 ../fish/guestfish-actions.pod:2323
12361 msgid ""
12362 "This inspection command looks for filesystems on partitions, block devices "
12363 "and logical volumes, returning a list of devices containing filesystems and "
12364 "their type."
12365 msgstr ""
12366
12367 # type: textblock
12368 #. type: textblock
12369 #: ../src/guestfs-actions.pod:3361 ../fish/guestfish-actions.pod:2327
12370 msgid ""
12371 "The return value is a hash, where the keys are the devices containing "
12372 "filesystems, and the values are the filesystem types.  For example:"
12373 msgstr ""
12374
12375 # type: verbatim
12376 #. type: verbatim
12377 #: ../src/guestfs-actions.pod:3365 ../fish/guestfish-actions.pod:2331
12378 #, no-wrap
12379 msgid ""
12380 " \"/dev/sda1\" => \"ntfs\"\n"
12381 " \"/dev/sda2\" => \"ext2\"\n"
12382 " \"/dev/vg_guest/lv_root\" => \"ext4\"\n"
12383 " \"/dev/vg_guest/lv_swap\" => \"swap\"\n"
12384 "\n"
12385 msgstr ""
12386
12387 # type: textblock
12388 #. type: textblock
12389 #: ../src/guestfs-actions.pod:3370 ../fish/guestfish-actions.pod:2336
12390 msgid ""
12391 "The value can have the special value \"unknown\", meaning the content of the "
12392 "device is undetermined or empty.  \"swap\" means a Linux swap partition."
12393 msgstr ""
12394
12395 # type: textblock
12396 #. type: textblock
12397 #: ../src/guestfs-actions.pod:3374
12398 msgid ""
12399 "This command runs other libguestfs commands, which might include "
12400 "C<guestfs_mount> and C<guestfs_umount>, and therefore you should use this "
12401 "soon after launch and only when nothing is mounted."
12402 msgstr ""
12403
12404 # type: textblock
12405 #. type: textblock
12406 #: ../src/guestfs-actions.pod:3378
12407 msgid ""
12408 "Not all of the filesystems returned will be mountable.  In particular, swap "
12409 "partitions are returned in the list.  Also this command does not check that "
12410 "each filesystem found is valid and mountable, and some filesystems might be "
12411 "mountable but require special options.  Filesystems may not all belong to a "
12412 "single logical operating system (use C<guestfs_inspect_os> to look for OSes)."
12413 msgstr ""
12414
12415 # type: textblock
12416 #. type: textblock
12417 #: ../src/guestfs-actions.pod:3392 ../src/guestfs-actions.pod:4994
12418 msgid "(Added in 1.5.15)"
12419 msgstr ""
12420
12421 # type: =head2
12422 #. type: =head2
12423 #: ../src/guestfs-actions.pod:3394
12424 msgid "guestfs_list_partitions"
12425 msgstr ""
12426
12427 # type: verbatim
12428 #. type: verbatim
12429 #: ../src/guestfs-actions.pod:3396
12430 #, no-wrap
12431 msgid ""
12432 " char **\n"
12433 " guestfs_list_partitions (guestfs_h *g);\n"
12434 "\n"
12435 msgstr ""
12436
12437 # type: textblock
12438 #. type: textblock
12439 #: ../src/guestfs-actions.pod:3399 ../fish/guestfish-actions.pod:2356
12440 msgid "List all the partitions detected on all block devices."
12441 msgstr ""
12442
12443 # type: textblock
12444 #. type: textblock
12445 #: ../src/guestfs-actions.pod:3401 ../fish/guestfish-actions.pod:2358
12446 msgid "The full partition device names are returned, eg. C</dev/sda1>"
12447 msgstr ""
12448
12449 # type: textblock
12450 #. type: textblock
12451 #: ../src/guestfs-actions.pod:3403
12452 msgid ""
12453 "This does not return logical volumes.  For that you will need to call "
12454 "C<guestfs_lvs>."
12455 msgstr ""
12456
12457 # type: =head2
12458 #. type: =head2
12459 #: ../src/guestfs-actions.pod:3414
12460 msgid "guestfs_ll"
12461 msgstr ""
12462
12463 # type: verbatim
12464 #. type: verbatim
12465 #: ../src/guestfs-actions.pod:3416
12466 #, no-wrap
12467 msgid ""
12468 " char *\n"
12469 " guestfs_ll (guestfs_h *g,\n"
12470 "             const char *directory);\n"
12471 "\n"
12472 msgstr ""
12473
12474 # type: textblock
12475 #. type: textblock
12476 #: ../src/guestfs-actions.pod:3420 ../fish/guestfish-actions.pod:2369
12477 msgid ""
12478 "List the files in C<directory> (relative to the root directory, there is no "
12479 "cwd) in the format of 'ls -la'."
12480 msgstr ""
12481
12482 # type: textblock
12483 #. type: textblock
12484 #: ../src/guestfs-actions.pod:3423 ../fish/guestfish-actions.pod:2372
12485 msgid ""
12486 "This command is mostly useful for interactive sessions.  It is I<not> "
12487 "intended that you try to parse the output string."
12488 msgstr ""
12489
12490 # type: =head2
12491 #. type: =head2
12492 #: ../src/guestfs-actions.pod:3431
12493 msgid "guestfs_ln"
12494 msgstr ""
12495
12496 # type: verbatim
12497 #. type: verbatim
12498 #: ../src/guestfs-actions.pod:3433
12499 #, no-wrap
12500 msgid ""
12501 " int\n"
12502 " guestfs_ln (guestfs_h *g,\n"
12503 "             const char *target,\n"
12504 "             const char *linkname);\n"
12505 "\n"
12506 msgstr ""
12507
12508 # type: textblock
12509 #. type: textblock
12510 #: ../src/guestfs-actions.pod:3438 ../fish/guestfish-actions.pod:2379
12511 msgid "This command creates a hard link using the C<ln> command."
12512 msgstr ""
12513
12514 # type: =head2
12515 #. type: =head2
12516 #: ../src/guestfs-actions.pod:3444
12517 msgid "guestfs_ln_f"
12518 msgstr ""
12519
12520 # type: verbatim
12521 #. type: verbatim
12522 #: ../src/guestfs-actions.pod:3446
12523 #, no-wrap
12524 msgid ""
12525 " int\n"
12526 " guestfs_ln_f (guestfs_h *g,\n"
12527 "               const char *target,\n"
12528 "               const char *linkname);\n"
12529 "\n"
12530 msgstr ""
12531
12532 # type: textblock
12533 #. type: textblock
12534 #: ../src/guestfs-actions.pod:3451 ../fish/guestfish-actions.pod:2385
12535 msgid ""
12536 "This command creates a hard link using the C<ln -f> command.  The C<-f> "
12537 "option removes the link (C<linkname>) if it exists already."
12538 msgstr ""
12539
12540 # type: =head2
12541 #. type: =head2
12542 #: ../src/guestfs-actions.pod:3458
12543 msgid "guestfs_ln_s"
12544 msgstr ""
12545
12546 # type: verbatim
12547 #. type: verbatim
12548 #: ../src/guestfs-actions.pod:3460
12549 #, no-wrap
12550 msgid ""
12551 " int\n"
12552 " guestfs_ln_s (guestfs_h *g,\n"
12553 "               const char *target,\n"
12554 "               const char *linkname);\n"
12555 "\n"
12556 msgstr ""
12557
12558 # type: textblock
12559 #. type: textblock
12560 #: ../src/guestfs-actions.pod:3465 ../fish/guestfish-actions.pod:2392
12561 msgid "This command creates a symbolic link using the C<ln -s> command."
12562 msgstr ""
12563
12564 # type: =head2
12565 #. type: =head2
12566 #: ../src/guestfs-actions.pod:3471
12567 msgid "guestfs_ln_sf"
12568 msgstr ""
12569
12570 # type: verbatim
12571 #. type: verbatim
12572 #: ../src/guestfs-actions.pod:3473
12573 #, no-wrap
12574 msgid ""
12575 " int\n"
12576 " guestfs_ln_sf (guestfs_h *g,\n"
12577 "                const char *target,\n"
12578 "                const char *linkname);\n"
12579 "\n"
12580 msgstr ""
12581
12582 # type: textblock
12583 #. type: textblock
12584 #: ../src/guestfs-actions.pod:3478 ../fish/guestfish-actions.pod:2398
12585 msgid ""
12586 "This command creates a symbolic link using the C<ln -sf> command, The C<-f> "
12587 "option removes the link (C<linkname>) if it exists already."
12588 msgstr ""
12589
12590 # type: =head2
12591 #. type: =head2
12592 #: ../src/guestfs-actions.pod:3485
12593 msgid "guestfs_lremovexattr"
12594 msgstr ""
12595
12596 # type: verbatim
12597 #. type: verbatim
12598 #: ../src/guestfs-actions.pod:3487
12599 #, no-wrap
12600 msgid ""
12601 " int\n"
12602 " guestfs_lremovexattr (guestfs_h *g,\n"
12603 "                       const char *xattr,\n"
12604 "                       const char *path);\n"
12605 "\n"
12606 msgstr ""
12607
12608 # type: textblock
12609 #. type: textblock
12610 #: ../src/guestfs-actions.pod:3492
12611 msgid ""
12612 "This is the same as C<guestfs_removexattr>, but if C<path> is a symbolic "
12613 "link, then it removes an extended attribute of the link itself."
12614 msgstr ""
12615
12616 # type: =head2
12617 #. type: =head2
12618 #: ../src/guestfs-actions.pod:3500
12619 msgid "guestfs_ls"
12620 msgstr ""
12621
12622 # type: verbatim
12623 #. type: verbatim
12624 #: ../src/guestfs-actions.pod:3502
12625 #, no-wrap
12626 msgid ""
12627 " char **\n"
12628 " guestfs_ls (guestfs_h *g,\n"
12629 "             const char *directory);\n"
12630 "\n"
12631 msgstr ""
12632
12633 # type: textblock
12634 #. type: textblock
12635 #: ../src/guestfs-actions.pod:3506 ../fish/guestfish-actions.pod:2413
12636 msgid ""
12637 "List the files in C<directory> (relative to the root directory, there is no "
12638 "cwd).  The '.' and '..' entries are not returned, but hidden files are shown."
12639 msgstr ""
12640
12641 # type: textblock
12642 #. type: textblock
12643 #: ../src/guestfs-actions.pod:3510
12644 msgid ""
12645 "This command is mostly useful for interactive sessions.  Programs should "
12646 "probably use C<guestfs_readdir> instead."
12647 msgstr ""
12648
12649 # type: =head2
12650 #. type: =head2
12651 #: ../src/guestfs-actions.pod:3519
12652 msgid "guestfs_lsetxattr"
12653 msgstr ""
12654
12655 # type: verbatim
12656 #. type: verbatim
12657 #: ../src/guestfs-actions.pod:3521
12658 #, no-wrap
12659 msgid ""
12660 " int\n"
12661 " guestfs_lsetxattr (guestfs_h *g,\n"
12662 "                    const char *xattr,\n"
12663 "                    const char *val,\n"
12664 "                    int vallen,\n"
12665 "                    const char *path);\n"
12666 "\n"
12667 msgstr ""
12668
12669 # type: textblock
12670 #. type: textblock
12671 #: ../src/guestfs-actions.pod:3528
12672 msgid ""
12673 "This is the same as C<guestfs_setxattr>, but if C<path> is a symbolic link, "
12674 "then it sets an extended attribute of the link itself."
12675 msgstr ""
12676
12677 # type: =head2
12678 #. type: =head2
12679 #: ../src/guestfs-actions.pod:3536
12680 msgid "guestfs_lstat"
12681 msgstr ""
12682
12683 # type: verbatim
12684 #. type: verbatim
12685 #: ../src/guestfs-actions.pod:3538
12686 #, no-wrap
12687 msgid ""
12688 " struct guestfs_stat *\n"
12689 " guestfs_lstat (guestfs_h *g,\n"
12690 "                const char *path);\n"
12691 "\n"
12692 msgstr ""
12693
12694 # type: textblock
12695 #. type: textblock
12696 #: ../src/guestfs-actions.pod:3542 ../src/guestfs-actions.pod:6048
12697 #: ../fish/guestfish-actions.pod:2432 ../fish/guestfish-actions.pod:4056
12698 msgid "Returns file information for the given C<path>."
12699 msgstr ""
12700
12701 # type: textblock
12702 #. type: textblock
12703 #: ../src/guestfs-actions.pod:3544
12704 msgid ""
12705 "This is the same as C<guestfs_stat> except that if C<path> is a symbolic "
12706 "link, then the link is stat-ed, not the file it refers to."
12707 msgstr ""
12708
12709 # type: textblock
12710 #. type: textblock
12711 #: ../src/guestfs-actions.pod:3548 ../fish/guestfish-actions.pod:2438
12712 msgid "This is the same as the C<lstat(2)> system call."
12713 msgstr ""
12714
12715 # type: textblock
12716 #. type: textblock
12717 #: ../src/guestfs-actions.pod:3550 ../src/guestfs-actions.pod:6052
12718 msgid ""
12719 "This function returns a C<struct guestfs_stat *>, or NULL if there was an "
12720 "error.  I<The caller must call C<guestfs_free_stat> after use>."
12721 msgstr ""
12722
12723 # type: textblock
12724 #. type: textblock
12725 #: ../src/guestfs-actions.pod:3554 ../src/guestfs-actions.pod:6056
12726 #: ../src/guestfs-actions.pod:6074 ../src/guestfs-actions.pod:6455
12727 msgid "(Added in 0.9.2)"
12728 msgstr ""
12729
12730 # type: =head2
12731 #. type: =head2
12732 #: ../src/guestfs-actions.pod:3556
12733 msgid "guestfs_lstatlist"
12734 msgstr ""
12735
12736 # type: verbatim
12737 #. type: verbatim
12738 #: ../src/guestfs-actions.pod:3558
12739 #, no-wrap
12740 msgid ""
12741 " struct guestfs_stat_list *\n"
12742 " guestfs_lstatlist (guestfs_h *g,\n"
12743 "                    const char *path,\n"
12744 "                    char *const *names);\n"
12745 "\n"
12746 msgstr ""
12747
12748 # type: textblock
12749 #. type: textblock
12750 #: ../src/guestfs-actions.pod:3563
12751 msgid ""
12752 "This call allows you to perform the C<guestfs_lstat> operation on multiple "
12753 "files, where all files are in the directory C<path>.  C<names> is the list "
12754 "of files from this directory."
12755 msgstr ""
12756
12757 # type: textblock
12758 #. type: textblock
12759 #: ../src/guestfs-actions.pod:3567 ../fish/guestfish-actions.pod:2448
12760 msgid ""
12761 "On return you get a list of stat structs, with a one-to-one correspondence "
12762 "to the C<names> list.  If any name did not exist or could not be lstat'd, "
12763 "then the C<ino> field of that structure is set to C<-1>."
12764 msgstr ""
12765
12766 # type: textblock
12767 #. type: textblock
12768 #: ../src/guestfs-actions.pod:3572
12769 msgid ""
12770 "This call is intended for programs that want to efficiently list a directory "
12771 "contents without making many round-trips.  See also C<guestfs_lxattrlist> "
12772 "for a similarly efficient call for getting extended attributes.  Very long "
12773 "directory listings might cause the protocol message size to be exceeded, "
12774 "causing this call to fail.  The caller must split up such requests into "
12775 "smaller groups of names."
12776 msgstr ""
12777
12778 # type: textblock
12779 #. type: textblock
12780 #: ../src/guestfs-actions.pod:3580
12781 msgid ""
12782 "This function returns a C<struct guestfs_stat_list *>, or NULL if there was "
12783 "an error.  I<The caller must call C<guestfs_free_stat_list> after use>."
12784 msgstr ""
12785
12786 # type: =head2
12787 #. type: =head2
12788 #: ../src/guestfs-actions.pod:3586
12789 msgid "guestfs_luks_add_key"
12790 msgstr ""
12791
12792 # type: verbatim
12793 #. type: verbatim
12794 #: ../src/guestfs-actions.pod:3588
12795 #, no-wrap
12796 msgid ""
12797 " int\n"
12798 " guestfs_luks_add_key (guestfs_h *g,\n"
12799 "                       const char *device,\n"
12800 "                       const char *key,\n"
12801 "                       const char *newkey,\n"
12802 "                       int keyslot);\n"
12803 "\n"
12804 msgstr ""
12805
12806 # type: textblock
12807 #. type: textblock
12808 #: ../src/guestfs-actions.pod:3595 ../fish/guestfish-actions.pod:2465
12809 msgid ""
12810 "This command adds a new key on LUKS device C<device>.  C<key> is any "
12811 "existing key, and is used to access the device.  C<newkey> is the new key to "
12812 "add.  C<keyslot> is the key slot that will be replaced."
12813 msgstr ""
12814
12815 # type: textblock
12816 #. type: textblock
12817 #: ../src/guestfs-actions.pod:3600
12818 msgid ""
12819 "Note that if C<keyslot> already contains a key, then this command will "
12820 "fail.  You have to use C<guestfs_luks_kill_slot> first to remove that key."
12821 msgstr ""
12822
12823 # type: textblock
12824 #. type: textblock
12825 #: ../src/guestfs-actions.pod:3606 ../src/guestfs-actions.pod:3646
12826 #: ../src/guestfs-actions.pod:3669 ../src/guestfs-actions.pod:3689
12827 #: ../src/guestfs-actions.pod:3721 ../src/guestfs-actions.pod:3740
12828 msgid ""
12829 "This function takes a key or passphrase parameter which could contain "
12830 "sensitive material.  Read the section L</KEYS AND PASSPHRASES> for more "
12831 "information."
12832 msgstr ""
12833
12834 # type: textblock
12835 #. type: textblock
12836 #: ../src/guestfs-actions.pod:3610 ../src/guestfs-actions.pod:3650
12837 #: ../src/guestfs-actions.pod:3673 ../src/guestfs-actions.pod:3693
12838 msgid "(Added in 1.5.2)"
12839 msgstr ""
12840
12841 # type: =head2
12842 #. type: =head2
12843 #: ../src/guestfs-actions.pod:3612
12844 msgid "guestfs_luks_close"
12845 msgstr ""
12846
12847 # type: verbatim
12848 #. type: verbatim
12849 #: ../src/guestfs-actions.pod:3614
12850 #, no-wrap
12851 msgid ""
12852 " int\n"
12853 " guestfs_luks_close (guestfs_h *g,\n"
12854 "                     const char *device);\n"
12855 "\n"
12856 msgstr ""
12857
12858 # type: textblock
12859 #. type: textblock
12860 #: ../src/guestfs-actions.pod:3618
12861 msgid ""
12862 "This closes a LUKS device that was created earlier by C<guestfs_luks_open> "
12863 "or C<guestfs_luks_open_ro>.  The C<device> parameter must be the name of the "
12864 "LUKS mapping device (ie. C</dev/mapper/mapname>) and I<not> the name of the "
12865 "underlying block device."
12866 msgstr ""
12867
12868 # type: textblock
12869 #. type: textblock
12870 #: ../src/guestfs-actions.pod:3626 ../src/guestfs-actions.pod:3725
12871 #: ../src/guestfs-actions.pod:3744 ../src/guestfs-actions.pod:3794
12872 #: ../src/guestfs-actions.pod:3842
12873 msgid "(Added in 1.5.1)"
12874 msgstr ""
12875
12876 # type: =head2
12877 #. type: =head2
12878 #: ../src/guestfs-actions.pod:3628
12879 msgid "guestfs_luks_format"
12880 msgstr ""
12881
12882 # type: verbatim
12883 #. type: verbatim
12884 #: ../src/guestfs-actions.pod:3630
12885 #, no-wrap
12886 msgid ""
12887 " int\n"
12888 " guestfs_luks_format (guestfs_h *g,\n"
12889 "                      const char *device,\n"
12890 "                      const char *key,\n"
12891 "                      int keyslot);\n"
12892 "\n"
12893 msgstr ""
12894
12895 # type: textblock
12896 #. type: textblock
12897 #: ../src/guestfs-actions.pod:3636 ../fish/guestfish-actions.pod:2491
12898 msgid ""
12899 "This command erases existing data on C<device> and formats the device as a "
12900 "LUKS encrypted device.  C<key> is the initial key, which is added to key "
12901 "slot C<slot>.  (LUKS supports 8 key slots, numbered 0-7)."
12902 msgstr ""
12903
12904 # type: textblock
12905 #. type: textblock
12906 #: ../src/guestfs-actions.pod:3643 ../src/guestfs-actions.pod:3666
12907 #: ../src/guestfs-actions.pod:3806 ../src/guestfs-actions.pod:4745
12908 #: ../src/guestfs-actions.pod:5508 ../src/guestfs-actions.pod:5883
12909 #: ../src/guestfs-actions.pod:5906 ../src/guestfs-actions.pod:5932
12910 #: ../src/guestfs-actions.pod:7092 ../fish/guestfish-actions.pod:2499
12911 #: ../fish/guestfish-actions.pod:2512 ../fish/guestfish-actions.pod:2596
12912 #: ../fish/guestfish-actions.pod:3168 ../fish/guestfish-actions.pod:3675
12913 #: ../fish/guestfish-actions.pod:3955 ../fish/guestfish-actions.pod:3971
12914 #: ../fish/guestfish-actions.pod:3986 ../fish/guestfish-actions.pod:4701
12915 msgid ""
12916 "B<This command is dangerous.  Without careful use you can easily destroy all "
12917 "your data>."
12918 msgstr ""
12919
12920 # type: =head2
12921 #. type: =head2
12922 #: ../src/guestfs-actions.pod:3652
12923 msgid "guestfs_luks_format_cipher"
12924 msgstr ""
12925
12926 # type: verbatim
12927 #. type: verbatim
12928 #: ../src/guestfs-actions.pod:3654
12929 #, no-wrap
12930 msgid ""
12931 " int\n"
12932 " guestfs_luks_format_cipher (guestfs_h *g,\n"
12933 "                             const char *device,\n"
12934 "                             const char *key,\n"
12935 "                             int keyslot,\n"
12936 "                             const char *cipher);\n"
12937 "\n"
12938 msgstr ""
12939
12940 # type: textblock
12941 #. type: textblock
12942 #: ../src/guestfs-actions.pod:3661
12943 msgid ""
12944 "This command is the same as C<guestfs_luks_format> but it also allows you to "
12945 "set the C<cipher> used."
12946 msgstr ""
12947
12948 # type: =head2
12949 #. type: =head2
12950 #: ../src/guestfs-actions.pod:3675
12951 msgid "guestfs_luks_kill_slot"
12952 msgstr ""
12953
12954 # type: verbatim
12955 #. type: verbatim
12956 #: ../src/guestfs-actions.pod:3677
12957 #, no-wrap
12958 msgid ""
12959 " int\n"
12960 " guestfs_luks_kill_slot (guestfs_h *g,\n"
12961 "                         const char *device,\n"
12962 "                         const char *key,\n"
12963 "                         int keyslot);\n"
12964 "\n"
12965 msgstr ""
12966
12967 # type: textblock
12968 #. type: textblock
12969 #: ../src/guestfs-actions.pod:3683 ../fish/guestfish-actions.pod:2519
12970 msgid ""
12971 "This command deletes the key in key slot C<keyslot> from the encrypted LUKS "
12972 "device C<device>.  C<key> must be one of the I<other> keys."
12973 msgstr ""
12974
12975 # type: =head2
12976 #. type: =head2
12977 #: ../src/guestfs-actions.pod:3695
12978 msgid "guestfs_luks_open"
12979 msgstr ""
12980
12981 # type: verbatim
12982 #. type: verbatim
12983 #: ../src/guestfs-actions.pod:3697
12984 #, no-wrap
12985 msgid ""
12986 " int\n"
12987 " guestfs_luks_open (guestfs_h *g,\n"
12988 "                    const char *device,\n"
12989 "                    const char *key,\n"
12990 "                    const char *mapname);\n"
12991 "\n"
12992 msgstr ""
12993
12994 # type: textblock
12995 #. type: textblock
12996 #: ../src/guestfs-actions.pod:3703 ../fish/guestfish-actions.pod:2530
12997 msgid ""
12998 "This command opens a block device which has been encrypted according to the "
12999 "Linux Unified Key Setup (LUKS) standard."
13000 msgstr ""
13001
13002 # type: textblock
13003 #. type: textblock
13004 #: ../src/guestfs-actions.pod:3706 ../fish/guestfish-actions.pod:2533
13005 msgid "C<device> is the encrypted block device or partition."
13006 msgstr ""
13007
13008 # type: textblock
13009 #. type: textblock
13010 #: ../src/guestfs-actions.pod:3708 ../fish/guestfish-actions.pod:2535
13011 msgid ""
13012 "The caller must supply one of the keys associated with the LUKS block "
13013 "device, in the C<key> parameter."
13014 msgstr ""
13015
13016 # type: textblock
13017 #. type: textblock
13018 #: ../src/guestfs-actions.pod:3711 ../fish/guestfish-actions.pod:2538
13019 msgid ""
13020 "This creates a new block device called C</dev/mapper/mapname>.  Reads and "
13021 "writes to this block device are decrypted from and encrypted to the "
13022 "underlying C<device> respectively."
13023 msgstr ""
13024
13025 # type: textblock
13026 #. type: textblock
13027 #: ../src/guestfs-actions.pod:3715
13028 msgid ""
13029 "If this block device contains LVM volume groups, then calling "
13030 "C<guestfs_vgscan> followed by C<guestfs_vg_activate_all> will make them "
13031 "visible."
13032 msgstr ""
13033
13034 # type: =head2
13035 #. type: =head2
13036 #: ../src/guestfs-actions.pod:3727
13037 msgid "guestfs_luks_open_ro"
13038 msgstr ""
13039
13040 # type: verbatim
13041 #. type: verbatim
13042 #: ../src/guestfs-actions.pod:3729
13043 #, no-wrap
13044 msgid ""
13045 " int\n"
13046 " guestfs_luks_open_ro (guestfs_h *g,\n"
13047 "                       const char *device,\n"
13048 "                       const char *key,\n"
13049 "                       const char *mapname);\n"
13050 "\n"
13051 msgstr ""
13052
13053 # type: textblock
13054 #. type: textblock
13055 #: ../src/guestfs-actions.pod:3735
13056 msgid ""
13057 "This is the same as C<guestfs_luks_open> except that a read-only mapping is "
13058 "created."
13059 msgstr ""
13060
13061 # type: =head2
13062 #. type: =head2
13063 #: ../src/guestfs-actions.pod:3746
13064 msgid "guestfs_lvcreate"
13065 msgstr ""
13066
13067 # type: verbatim
13068 #. type: verbatim
13069 #: ../src/guestfs-actions.pod:3748
13070 #, no-wrap
13071 msgid ""
13072 " int\n"
13073 " guestfs_lvcreate (guestfs_h *g,\n"
13074 "                   const char *logvol,\n"
13075 "                   const char *volgroup,\n"
13076 "                   int mbytes);\n"
13077 "\n"
13078 msgstr ""
13079
13080 # type: textblock
13081 #. type: textblock
13082 #: ../src/guestfs-actions.pod:3754 ../fish/guestfish-actions.pod:2563
13083 msgid ""
13084 "This creates an LVM logical volume called C<logvol> on the volume group "
13085 "C<volgroup>, with C<size> megabytes."
13086 msgstr ""
13087
13088 # type: =head2
13089 #. type: =head2
13090 #: ../src/guestfs-actions.pod:3761
13091 msgid "guestfs_lvm_canonical_lv_name"
13092 msgstr ""
13093
13094 # type: verbatim
13095 #. type: verbatim
13096 #: ../src/guestfs-actions.pod:3763
13097 #, no-wrap
13098 msgid ""
13099 " char *\n"
13100 " guestfs_lvm_canonical_lv_name (guestfs_h *g,\n"
13101 "                                const char *lvname);\n"
13102 "\n"
13103 msgstr ""
13104
13105 # type: textblock
13106 #. type: textblock
13107 #: ../src/guestfs-actions.pod:3767 ../fish/guestfish-actions.pod:2570
13108 msgid ""
13109 "This converts alternative naming schemes for LVs that you might find to the "
13110 "canonical name.  For example, C</dev/mapper/VG-LV> is converted to C</dev/VG/"
13111 "LV>."
13112 msgstr ""
13113
13114 # type: textblock
13115 #. type: textblock
13116 #: ../src/guestfs-actions.pod:3771 ../fish/guestfish-actions.pod:2574
13117 msgid ""
13118 "This command returns an error if the C<lvname> parameter does not refer to a "
13119 "logical volume."
13120 msgstr ""
13121
13122 # type: textblock
13123 #. type: textblock
13124 #: ../src/guestfs-actions.pod:3774
13125 msgid "See also C<guestfs_is_lv>."
13126 msgstr ""
13127
13128 # type: textblock
13129 #. type: textblock
13130 #: ../src/guestfs-actions.pod:3779
13131 msgid "(Added in 1.5.24)"
13132 msgstr ""
13133
13134 # type: =head2
13135 #. type: =head2
13136 #: ../src/guestfs-actions.pod:3781
13137 msgid "guestfs_lvm_clear_filter"
13138 msgstr ""
13139
13140 # type: verbatim
13141 #. type: verbatim
13142 #: ../src/guestfs-actions.pod:3783
13143 #, no-wrap
13144 msgid ""
13145 " int\n"
13146 " guestfs_lvm_clear_filter (guestfs_h *g);\n"
13147 "\n"
13148 msgstr ""
13149
13150 # type: textblock
13151 #. type: textblock
13152 #: ../src/guestfs-actions.pod:3786
13153 msgid ""
13154 "This undoes the effect of C<guestfs_lvm_set_filter>.  LVM will be able to "
13155 "see every block device."
13156 msgstr ""
13157
13158 # type: textblock
13159 #. type: textblock
13160 #: ../src/guestfs-actions.pod:3789 ../src/guestfs-actions.pod:3831
13161 #: ../fish/guestfish-actions.pod:2586 ../fish/guestfish-actions.pod:2617
13162 msgid ""
13163 "This command also clears the LVM cache and performs a volume group scan."
13164 msgstr ""
13165
13166 # type: =head2
13167 #. type: =head2
13168 #: ../src/guestfs-actions.pod:3796
13169 msgid "guestfs_lvm_remove_all"
13170 msgstr ""
13171
13172 # type: verbatim
13173 #. type: verbatim
13174 #: ../src/guestfs-actions.pod:3798
13175 #, no-wrap
13176 msgid ""
13177 " int\n"
13178 " guestfs_lvm_remove_all (guestfs_h *g);\n"
13179 "\n"
13180 msgstr ""
13181
13182 # type: textblock
13183 #. type: textblock
13184 #: ../src/guestfs-actions.pod:3801 ../fish/guestfish-actions.pod:2593
13185 msgid ""
13186 "This command removes all LVM logical volumes, volume groups and physical "
13187 "volumes."
13188 msgstr ""
13189
13190 # type: =head2
13191 #. type: =head2
13192 #: ../src/guestfs-actions.pod:3811
13193 msgid "guestfs_lvm_set_filter"
13194 msgstr ""
13195
13196 # type: verbatim
13197 #. type: verbatim
13198 #: ../src/guestfs-actions.pod:3813
13199 #, no-wrap
13200 msgid ""
13201 " int\n"
13202 " guestfs_lvm_set_filter (guestfs_h *g,\n"
13203 "                         char *const *devices);\n"
13204 "\n"
13205 msgstr ""
13206
13207 # type: textblock
13208 #. type: textblock
13209 #: ../src/guestfs-actions.pod:3817 ../fish/guestfish-actions.pod:2603
13210 msgid ""
13211 "This sets the LVM device filter so that LVM will only be able to \"see\" the "
13212 "block devices in the list C<devices>, and will ignore all other attached "
13213 "block devices."
13214 msgstr ""
13215
13216 # type: textblock
13217 #. type: textblock
13218 #: ../src/guestfs-actions.pod:3821 ../fish/guestfish-actions.pod:2607
13219 msgid ""
13220 "Where disk image(s) contain duplicate PVs or VGs, this command is useful to "
13221 "get LVM to ignore the duplicates, otherwise LVM can get confused.  Note also "
13222 "there are two types of duplication possible: either cloned PVs/VGs which "
13223 "have identical UUIDs; or VGs that are not cloned but just happen to have the "
13224 "same name.  In normal operation you cannot create this situation, but you "
13225 "can do it outside LVM, eg.  by cloning disk images or by bit twiddling "
13226 "inside the LVM metadata."
13227 msgstr ""
13228
13229 # type: textblock
13230 #. type: textblock
13231 #: ../src/guestfs-actions.pod:3834 ../fish/guestfish-actions.pod:2620
13232 msgid "You can filter whole block devices or individual partitions."
13233 msgstr ""
13234
13235 # type: textblock
13236 #. type: textblock
13237 #: ../src/guestfs-actions.pod:3836 ../fish/guestfish-actions.pod:2622
13238 msgid ""
13239 "You cannot use this if any VG is currently in use (eg.  contains a mounted "
13240 "filesystem), even if you are not filtering out that VG."
13241 msgstr ""
13242
13243 # type: =head2
13244 #. type: =head2
13245 #: ../src/guestfs-actions.pod:3844
13246 msgid "guestfs_lvremove"
13247 msgstr ""
13248
13249 # type: verbatim
13250 #. type: verbatim
13251 #: ../src/guestfs-actions.pod:3846
13252 #, no-wrap
13253 msgid ""
13254 " int\n"
13255 " guestfs_lvremove (guestfs_h *g,\n"
13256 "                   const char *device);\n"
13257 "\n"
13258 msgstr ""
13259
13260 # type: textblock
13261 #. type: textblock
13262 #: ../src/guestfs-actions.pod:3850 ../fish/guestfish-actions.pod:2630
13263 msgid ""
13264 "Remove an LVM logical volume C<device>, where C<device> is the path to the "
13265 "LV, such as C</dev/VG/LV>."
13266 msgstr ""
13267
13268 # type: textblock
13269 #. type: textblock
13270 #: ../src/guestfs-actions.pod:3853 ../fish/guestfish-actions.pod:2633
13271 msgid ""
13272 "You can also remove all LVs in a volume group by specifying the VG name, C</"
13273 "dev/VG>."
13274 msgstr ""
13275
13276 # type: textblock
13277 #. type: textblock
13278 #: ../src/guestfs-actions.pod:3858 ../src/guestfs-actions.pod:5091
13279 #: ../src/guestfs-actions.pod:6831
13280 msgid "(Added in 1.0.13)"
13281 msgstr ""
13282
13283 # type: =head2
13284 #. type: =head2
13285 #: ../src/guestfs-actions.pod:3860
13286 msgid "guestfs_lvrename"
13287 msgstr ""
13288
13289 # type: verbatim
13290 #. type: verbatim
13291 #: ../src/guestfs-actions.pod:3862
13292 #, no-wrap
13293 msgid ""
13294 " int\n"
13295 " guestfs_lvrename (guestfs_h *g,\n"
13296 "                   const char *logvol,\n"
13297 "                   const char *newlogvol);\n"
13298 "\n"
13299 msgstr ""
13300
13301 # type: textblock
13302 #. type: textblock
13303 #: ../src/guestfs-actions.pod:3867 ../fish/guestfish-actions.pod:2640
13304 msgid "Rename a logical volume C<logvol> with the new name C<newlogvol>."
13305 msgstr ""
13306
13307 # type: textblock
13308 #. type: textblock
13309 #: ../src/guestfs-actions.pod:3871 ../src/guestfs-actions.pod:6844
13310 msgid "(Added in 1.0.83)"
13311 msgstr ""
13312
13313 # type: =head2
13314 #. type: =head2
13315 #: ../src/guestfs-actions.pod:3873
13316 msgid "guestfs_lvresize"
13317 msgstr ""
13318
13319 # type: verbatim
13320 #. type: verbatim
13321 #: ../src/guestfs-actions.pod:3875
13322 #, no-wrap
13323 msgid ""
13324 " int\n"
13325 " guestfs_lvresize (guestfs_h *g,\n"
13326 "                   const char *device,\n"
13327 "                   int mbytes);\n"
13328 "\n"
13329 msgstr ""
13330
13331 # type: textblock
13332 #. type: textblock
13333 #: ../src/guestfs-actions.pod:3880 ../fish/guestfish-actions.pod:2646
13334 msgid ""
13335 "This resizes (expands or shrinks) an existing LVM logical volume to "
13336 "C<mbytes>.  When reducing, data in the reduced part is lost."
13337 msgstr ""
13338
13339 # type: =head2
13340 #. type: =head2
13341 #: ../src/guestfs-actions.pod:3888
13342 msgid "guestfs_lvresize_free"
13343 msgstr ""
13344
13345 # type: verbatim
13346 #. type: verbatim
13347 #: ../src/guestfs-actions.pod:3890
13348 #, no-wrap
13349 msgid ""
13350 " int\n"
13351 " guestfs_lvresize_free (guestfs_h *g,\n"
13352 "                        const char *lv,\n"
13353 "                        int percent);\n"
13354 "\n"
13355 msgstr ""
13356
13357 # type: textblock
13358 #. type: textblock
13359 #: ../src/guestfs-actions.pod:3895 ../fish/guestfish-actions.pod:2654
13360 msgid ""
13361 "This expands an existing logical volume C<lv> so that it fills C<pc>% of the "
13362 "remaining free space in the volume group.  Commonly you would call this with "
13363 "pc = 100 which expands the logical volume as much as possible, using all "
13364 "remaining free space in the volume group."
13365 msgstr ""
13366
13367 # type: textblock
13368 #. type: textblock
13369 #: ../src/guestfs-actions.pod:3903
13370 msgid "(Added in 1.3.3)"
13371 msgstr ""
13372
13373 # type: =head2
13374 #. type: =head2
13375 #: ../src/guestfs-actions.pod:3905
13376 msgid "guestfs_lvs"
13377 msgstr ""
13378
13379 # type: verbatim
13380 #. type: verbatim
13381 #: ../src/guestfs-actions.pod:3907
13382 #, no-wrap
13383 msgid ""
13384 " char **\n"
13385 " guestfs_lvs (guestfs_h *g);\n"
13386 "\n"
13387 msgstr ""
13388
13389 # type: textblock
13390 #. type: textblock
13391 #: ../src/guestfs-actions.pod:3910 ../fish/guestfish-actions.pod:2664
13392 msgid ""
13393 "List all the logical volumes detected.  This is the equivalent of the L<lvs"
13394 "(8)> command."
13395 msgstr ""
13396
13397 # type: textblock
13398 #. type: textblock
13399 #: ../src/guestfs-actions.pod:3913 ../fish/guestfish-actions.pod:2667
13400 msgid ""
13401 "This returns a list of the logical volume device names (eg. C</dev/"
13402 "VolGroup00/LogVol00>)."
13403 msgstr ""
13404
13405 # type: textblock
13406 #. type: textblock
13407 #: ../src/guestfs-actions.pod:3916
13408 msgid "See also C<guestfs_lvs_full>, C<guestfs_list_filesystems>."
13409 msgstr ""
13410
13411 # type: =head2
13412 #. type: =head2
13413 #: ../src/guestfs-actions.pod:3924
13414 msgid "guestfs_lvs_full"
13415 msgstr ""
13416
13417 # type: verbatim
13418 #. type: verbatim
13419 #: ../src/guestfs-actions.pod:3926
13420 #, no-wrap
13421 msgid ""
13422 " struct guestfs_lvm_lv_list *\n"
13423 " guestfs_lvs_full (guestfs_h *g);\n"
13424 "\n"
13425 msgstr ""
13426
13427 # type: textblock
13428 #. type: textblock
13429 #: ../src/guestfs-actions.pod:3929 ../fish/guestfish-actions.pod:2676
13430 msgid ""
13431 "List all the logical volumes detected.  This is the equivalent of the L<lvs"
13432 "(8)> command.  The \"full\" version includes all fields."
13433 msgstr ""
13434
13435 # type: textblock
13436 #. type: textblock
13437 #: ../src/guestfs-actions.pod:3932
13438 msgid ""
13439 "This function returns a C<struct guestfs_lvm_lv_list *>, or NULL if there "
13440 "was an error.  I<The caller must call C<guestfs_free_lvm_lv_list> after use>."
13441 msgstr ""
13442
13443 # type: =head2
13444 #. type: =head2
13445 #: ../src/guestfs-actions.pod:3938
13446 msgid "guestfs_lvuuid"
13447 msgstr ""
13448
13449 # type: verbatim
13450 #. type: verbatim
13451 #: ../src/guestfs-actions.pod:3940
13452 #, no-wrap
13453 msgid ""
13454 " char *\n"
13455 " guestfs_lvuuid (guestfs_h *g,\n"
13456 "                 const char *device);\n"
13457 "\n"
13458 msgstr ""
13459
13460 # type: textblock
13461 #. type: textblock
13462 #: ../src/guestfs-actions.pod:3944 ../fish/guestfish-actions.pod:2683
13463 msgid "This command returns the UUID of the LVM LV C<device>."
13464 msgstr ""
13465
13466 # type: =head2
13467 #. type: =head2
13468 #: ../src/guestfs-actions.pod:3951
13469 msgid "guestfs_lxattrlist"
13470 msgstr ""
13471
13472 # type: verbatim
13473 #. type: verbatim
13474 #: ../src/guestfs-actions.pod:3953
13475 #, no-wrap
13476 msgid ""
13477 " struct guestfs_xattr_list *\n"
13478 " guestfs_lxattrlist (guestfs_h *g,\n"
13479 "                     const char *path,\n"
13480 "                     char *const *names);\n"
13481 "\n"
13482 msgstr ""
13483
13484 # type: textblock
13485 #. type: textblock
13486 #: ../src/guestfs-actions.pod:3958 ../fish/guestfish-actions.pod:2689
13487 msgid ""
13488 "This call allows you to get the extended attributes of multiple files, where "
13489 "all files are in the directory C<path>.  C<names> is the list of files from "
13490 "this directory."
13491 msgstr ""
13492
13493 # type: textblock
13494 #. type: textblock
13495 #: ../src/guestfs-actions.pod:3962 ../fish/guestfish-actions.pod:2693
13496 msgid ""
13497 "On return you get a flat list of xattr structs which must be interpreted "
13498 "sequentially.  The first xattr struct always has a zero-length C<attrname>.  "
13499 "C<attrval> in this struct is zero-length to indicate there was an error "
13500 "doing C<lgetxattr> for this file, I<or> is a C string which is a decimal "
13501 "number (the number of following attributes for this file, which could be C<"
13502 "\"0\">).  Then after the first xattr struct are the zero or more attributes "
13503 "for the first named file.  This repeats for the second and subsequent files."
13504 msgstr ""
13505
13506 # type: textblock
13507 #. type: textblock
13508 #: ../src/guestfs-actions.pod:3972
13509 msgid ""
13510 "This call is intended for programs that want to efficiently list a directory "
13511 "contents without making many round-trips.  See also C<guestfs_lstatlist> for "
13512 "a similarly efficient call for getting standard stats.  Very long directory "
13513 "listings might cause the protocol message size to be exceeded, causing this "
13514 "call to fail.  The caller must split up such requests into smaller groups of "
13515 "names."
13516 msgstr ""
13517
13518 # type: =head2
13519 #. type: =head2
13520 #: ../src/guestfs-actions.pod:3986
13521 msgid "guestfs_mkdir"
13522 msgstr ""
13523
13524 # type: verbatim
13525 #. type: verbatim
13526 #: ../src/guestfs-actions.pod:3988
13527 #, no-wrap
13528 msgid ""
13529 " int\n"
13530 " guestfs_mkdir (guestfs_h *g,\n"
13531 "                const char *path);\n"
13532 "\n"
13533 msgstr ""
13534
13535 # type: textblock
13536 #. type: textblock
13537 #: ../src/guestfs-actions.pod:3992 ../fish/guestfish-actions.pod:2715
13538 msgid "Create a directory named C<path>."
13539 msgstr ""
13540
13541 # type: =head2
13542 #. type: =head2
13543 #: ../src/guestfs-actions.pod:3998
13544 msgid "guestfs_mkdir_mode"
13545 msgstr ""
13546
13547 # type: verbatim
13548 #. type: verbatim
13549 #: ../src/guestfs-actions.pod:4000
13550 #, no-wrap
13551 msgid ""
13552 " int\n"
13553 " guestfs_mkdir_mode (guestfs_h *g,\n"
13554 "                     const char *path,\n"
13555 "                     int mode);\n"
13556 "\n"
13557 msgstr ""
13558
13559 # type: textblock
13560 #. type: textblock
13561 #: ../src/guestfs-actions.pod:4005 ../fish/guestfish-actions.pod:2721
13562 msgid ""
13563 "This command creates a directory, setting the initial permissions of the "
13564 "directory to C<mode>."
13565 msgstr ""
13566
13567 # type: textblock
13568 #. type: textblock
13569 #: ../src/guestfs-actions.pod:4008 ../fish/guestfish-actions.pod:2724
13570 msgid ""
13571 "For common Linux filesystems, the actual mode which is set will be C<mode & "
13572 "~umask & 01777>.  Non-native-Linux filesystems may interpret the mode in "
13573 "other ways."
13574 msgstr ""
13575
13576 # type: textblock
13577 #. type: textblock
13578 #: ../src/guestfs-actions.pod:4012
13579 msgid "See also C<guestfs_mkdir>, C<guestfs_umask>"
13580 msgstr ""
13581
13582 # type: =head2
13583 #. type: =head2
13584 #: ../src/guestfs-actions.pod:4018
13585 msgid "guestfs_mkdir_p"
13586 msgstr ""
13587
13588 # type: verbatim
13589 #. type: verbatim
13590 #: ../src/guestfs-actions.pod:4020
13591 #, no-wrap
13592 msgid ""
13593 " int\n"
13594 " guestfs_mkdir_p (guestfs_h *g,\n"
13595 "                  const char *path);\n"
13596 "\n"
13597 msgstr ""
13598
13599 # type: textblock
13600 #. type: textblock
13601 #: ../src/guestfs-actions.pod:4024 ../fish/guestfish-actions.pod:2734
13602 msgid ""
13603 "Create a directory named C<path>, creating any parent directories as "
13604 "necessary.  This is like the C<mkdir -p> shell command."
13605 msgstr ""
13606
13607 # type: =head2
13608 #. type: =head2
13609 #: ../src/guestfs-actions.pod:4031
13610 msgid "guestfs_mkdtemp"
13611 msgstr ""
13612
13613 # type: verbatim
13614 #. type: verbatim
13615 #: ../src/guestfs-actions.pod:4033
13616 #, no-wrap
13617 msgid ""
13618 " char *\n"
13619 " guestfs_mkdtemp (guestfs_h *g,\n"
13620 "                  const char *template);\n"
13621 "\n"
13622 msgstr ""
13623
13624 # type: textblock
13625 #. type: textblock
13626 #: ../src/guestfs-actions.pod:4037 ../fish/guestfish-actions.pod:2741
13627 msgid ""
13628 "This command creates a temporary directory.  The C<template> parameter "
13629 "should be a full pathname for the temporary directory name with the final "
13630 "six characters being \"XXXXXX\"."
13631 msgstr ""
13632
13633 # type: textblock
13634 #. type: textblock
13635 #: ../src/guestfs-actions.pod:4042 ../fish/guestfish-actions.pod:2746
13636 msgid ""
13637 "For example: \"/tmp/myprogXXXXXX\" or \"/Temp/myprogXXXXXX\", the second one "
13638 "being suitable for Windows filesystems."
13639 msgstr ""
13640
13641 # type: textblock
13642 #. type: textblock
13643 #: ../src/guestfs-actions.pod:4045 ../fish/guestfish-actions.pod:2749
13644 msgid "The name of the temporary directory that was created is returned."
13645 msgstr ""
13646
13647 # type: textblock
13648 #. type: textblock
13649 #: ../src/guestfs-actions.pod:4048 ../fish/guestfish-actions.pod:2752
13650 msgid "The temporary directory is created with mode 0700 and is owned by root."
13651 msgstr ""
13652
13653 # type: textblock
13654 #. type: textblock
13655 #: ../src/guestfs-actions.pod:4051 ../fish/guestfish-actions.pod:2755
13656 msgid ""
13657 "The caller is responsible for deleting the temporary directory and its "
13658 "contents after use."
13659 msgstr ""
13660
13661 # type: textblock
13662 #. type: textblock
13663 #: ../src/guestfs-actions.pod:4054 ../fish/guestfish-actions.pod:2758
13664 msgid "See also: L<mkdtemp(3)>"
13665 msgstr ""
13666
13667 # type: =head2
13668 #. type: =head2
13669 #: ../src/guestfs-actions.pod:4061
13670 msgid "guestfs_mke2fs_J"
13671 msgstr ""
13672
13673 # type: verbatim
13674 #. type: verbatim
13675 #: ../src/guestfs-actions.pod:4063
13676 #, no-wrap
13677 msgid ""
13678 " int\n"
13679 " guestfs_mke2fs_J (guestfs_h *g,\n"
13680 "                   const char *fstype,\n"
13681 "                   int blocksize,\n"
13682 "                   const char *device,\n"
13683 "                   const char *journal);\n"
13684 "\n"
13685 msgstr ""
13686
13687 # type: textblock
13688 #. type: textblock
13689 #: ../src/guestfs-actions.pod:4070 ../fish/guestfish-actions.pod:2764
13690 msgid ""
13691 "This creates an ext2/3/4 filesystem on C<device> with an external journal on "
13692 "C<journal>.  It is equivalent to the command:"
13693 msgstr ""
13694
13695 # type: verbatim
13696 #. type: verbatim
13697 #: ../src/guestfs-actions.pod:4074 ../fish/guestfish-actions.pod:2768
13698 #, no-wrap
13699 msgid ""
13700 " mke2fs -t fstype -b blocksize -J device=<journal> <device>\n"
13701 "\n"
13702 msgstr ""
13703
13704 # type: textblock
13705 #. type: textblock
13706 #: ../src/guestfs-actions.pod:4076
13707 msgid "See also C<guestfs_mke2journal>."
13708 msgstr ""
13709
13710 # type: textblock
13711 #. type: textblock
13712 #: ../src/guestfs-actions.pod:4080 ../src/guestfs-actions.pod:4098
13713 #: ../src/guestfs-actions.pod:4116 ../src/guestfs-actions.pod:4132
13714 #: ../src/guestfs-actions.pod:4146 ../src/guestfs-actions.pod:4160
13715 #: ../src/guestfs-actions.pod:4219 ../src/guestfs-actions.pod:4472
13716 msgid "(Added in 1.0.68)"
13717 msgstr ""
13718
13719 # type: =head2
13720 #. type: =head2
13721 #: ../src/guestfs-actions.pod:4082
13722 msgid "guestfs_mke2fs_JL"
13723 msgstr ""
13724
13725 # type: verbatim
13726 #. type: verbatim
13727 #: ../src/guestfs-actions.pod:4084
13728 #, no-wrap
13729 msgid ""
13730 " int\n"
13731 " guestfs_mke2fs_JL (guestfs_h *g,\n"
13732 "                    const char *fstype,\n"
13733 "                    int blocksize,\n"
13734 "                    const char *device,\n"
13735 "                    const char *label);\n"
13736 "\n"
13737 msgstr ""
13738
13739 # type: textblock
13740 #. type: textblock
13741 #: ../src/guestfs-actions.pod:4091 ../fish/guestfish-actions.pod:2776
13742 msgid ""
13743 "This creates an ext2/3/4 filesystem on C<device> with an external journal on "
13744 "the journal labeled C<label>."
13745 msgstr ""
13746
13747 # type: textblock
13748 #. type: textblock
13749 #: ../src/guestfs-actions.pod:4094
13750 msgid "See also C<guestfs_mke2journal_L>."
13751 msgstr ""
13752
13753 # type: =head2
13754 #. type: =head2
13755 #: ../src/guestfs-actions.pod:4100
13756 msgid "guestfs_mke2fs_JU"
13757 msgstr ""
13758
13759 # type: verbatim
13760 #. type: verbatim
13761 #: ../src/guestfs-actions.pod:4102
13762 #, no-wrap
13763 msgid ""
13764 " int\n"
13765 " guestfs_mke2fs_JU (guestfs_h *g,\n"
13766 "                    const char *fstype,\n"
13767 "                    int blocksize,\n"
13768 "                    const char *device,\n"
13769 "                    const char *uuid);\n"
13770 "\n"
13771 msgstr ""
13772
13773 # type: textblock
13774 #. type: textblock
13775 #: ../src/guestfs-actions.pod:4109 ../fish/guestfish-actions.pod:2785
13776 msgid ""
13777 "This creates an ext2/3/4 filesystem on C<device> with an external journal on "
13778 "the journal with UUID C<uuid>."
13779 msgstr ""
13780
13781 # type: textblock
13782 #. type: textblock
13783 #: ../src/guestfs-actions.pod:4112
13784 msgid "See also C<guestfs_mke2journal_U>."
13785 msgstr ""
13786
13787 # type: =head2
13788 #. type: =head2
13789 #: ../src/guestfs-actions.pod:4118
13790 msgid "guestfs_mke2journal"
13791 msgstr ""
13792
13793 # type: verbatim
13794 #. type: verbatim
13795 #: ../src/guestfs-actions.pod:4120
13796 #, no-wrap
13797 msgid ""
13798 " int\n"
13799 " guestfs_mke2journal (guestfs_h *g,\n"
13800 "                      int blocksize,\n"
13801 "                      const char *device);\n"
13802 "\n"
13803 msgstr ""
13804
13805 # type: textblock
13806 #. type: textblock
13807 #: ../src/guestfs-actions.pod:4125 ../fish/guestfish-actions.pod:2794
13808 msgid ""
13809 "This creates an ext2 external journal on C<device>.  It is equivalent to the "
13810 "command:"
13811 msgstr ""
13812
13813 # type: verbatim
13814 #. type: verbatim
13815 #: ../src/guestfs-actions.pod:4128 ../fish/guestfish-actions.pod:2797
13816 #, no-wrap
13817 msgid ""
13818 " mke2fs -O journal_dev -b blocksize device\n"
13819 "\n"
13820 msgstr ""
13821
13822 # type: =head2
13823 #. type: =head2
13824 #: ../src/guestfs-actions.pod:4134
13825 msgid "guestfs_mke2journal_L"
13826 msgstr ""
13827
13828 # type: verbatim
13829 #. type: verbatim
13830 #: ../src/guestfs-actions.pod:4136
13831 #, no-wrap
13832 msgid ""
13833 " int\n"
13834 " guestfs_mke2journal_L (guestfs_h *g,\n"
13835 "                        int blocksize,\n"
13836 "                        const char *label,\n"
13837 "                        const char *device);\n"
13838 "\n"
13839 msgstr ""
13840
13841 # type: textblock
13842 #. type: textblock
13843 #: ../src/guestfs-actions.pod:4142 ../fish/guestfish-actions.pod:2803
13844 msgid "This creates an ext2 external journal on C<device> with label C<label>."
13845 msgstr ""
13846
13847 # type: =head2
13848 #. type: =head2
13849 #: ../src/guestfs-actions.pod:4148
13850 msgid "guestfs_mke2journal_U"
13851 msgstr ""
13852
13853 # type: verbatim
13854 #. type: verbatim
13855 #: ../src/guestfs-actions.pod:4150
13856 #, no-wrap
13857 msgid ""
13858 " int\n"
13859 " guestfs_mke2journal_U (guestfs_h *g,\n"
13860 "                        int blocksize,\n"
13861 "                        const char *uuid,\n"
13862 "                        const char *device);\n"
13863 "\n"
13864 msgstr ""
13865
13866 # type: textblock
13867 #. type: textblock
13868 #: ../src/guestfs-actions.pod:4156 ../fish/guestfish-actions.pod:2809
13869 msgid "This creates an ext2 external journal on C<device> with UUID C<uuid>."
13870 msgstr ""
13871
13872 # type: =head2
13873 #. type: =head2
13874 #: ../src/guestfs-actions.pod:4162
13875 msgid "guestfs_mkfifo"
13876 msgstr ""
13877
13878 # type: verbatim
13879 #. type: verbatim
13880 #: ../src/guestfs-actions.pod:4164
13881 #, no-wrap
13882 msgid ""
13883 " int\n"
13884 " guestfs_mkfifo (guestfs_h *g,\n"
13885 "                 int mode,\n"
13886 "                 const char *path);\n"
13887 "\n"
13888 msgstr ""
13889
13890 # type: textblock
13891 #. type: textblock
13892 #: ../src/guestfs-actions.pod:4169
13893 msgid ""
13894 "This call creates a FIFO (named pipe) called C<path> with mode C<mode>.  It "
13895 "is just a convenient wrapper around C<guestfs_mknod>."
13896 msgstr ""
13897
13898 # type: =head2
13899 #. type: =head2
13900 #: ../src/guestfs-actions.pod:4179
13901 msgid "guestfs_mkfs"
13902 msgstr ""
13903
13904 # type: verbatim
13905 #. type: verbatim
13906 #: ../src/guestfs-actions.pod:4181
13907 #, no-wrap
13908 msgid ""
13909 " int\n"
13910 " guestfs_mkfs (guestfs_h *g,\n"
13911 "               const char *fstype,\n"
13912 "               const char *device);\n"
13913 "\n"
13914 msgstr ""
13915
13916 # type: textblock
13917 #. type: textblock
13918 #: ../src/guestfs-actions.pod:4186 ../fish/guestfish-actions.pod:2825
13919 msgid ""
13920 "This creates a filesystem on C<device> (usually a partition or LVM logical "
13921 "volume).  The filesystem type is C<fstype>, for example C<ext3>."
13922 msgstr ""
13923
13924 # type: =head2
13925 #. type: =head2
13926 #: ../src/guestfs-actions.pod:4194
13927 msgid "guestfs_mkfs_b"
13928 msgstr ""
13929
13930 # type: verbatim
13931 #. type: verbatim
13932 #: ../src/guestfs-actions.pod:4196
13933 #, no-wrap
13934 msgid ""
13935 " int\n"
13936 " guestfs_mkfs_b (guestfs_h *g,\n"
13937 "                 const char *fstype,\n"
13938 "                 int blocksize,\n"
13939 "                 const char *device);\n"
13940 "\n"
13941 msgstr ""
13942
13943 # type: textblock
13944 #. type: textblock
13945 #: ../src/guestfs-actions.pod:4202
13946 msgid ""
13947 "This call is similar to C<guestfs_mkfs>, but it allows you to control the "
13948 "block size of the resulting filesystem.  Supported block sizes depend on the "
13949 "filesystem type, but typically they are C<1024>, C<2048> or C<4096> only."
13950 msgstr ""
13951
13952 # type: textblock
13953 #. type: textblock
13954 #: ../src/guestfs-actions.pod:4207 ../src/guestfs-actions.pod:4249
13955 #: ../fish/guestfish-actions.pod:2838 ../fish/guestfish-actions.pod:2865
13956 msgid ""
13957 "For VFAT and NTFS the C<blocksize> parameter is treated as the requested "
13958 "cluster size."
13959 msgstr ""
13960
13961 #. type: textblock
13962 #: ../src/guestfs-actions.pod:4212
13963 msgid ""
13964 "This function is deprecated.  In new code, use the L</guestfs_mkfs_opts> "
13965 "call instead."
13966 msgstr ""
13967
13968 # type: =head2
13969 #. type: =head2
13970 #: ../src/guestfs-actions.pod:4221
13971 msgid "guestfs_mkfs_opts"
13972 msgstr ""
13973
13974 # type: verbatim
13975 #. type: verbatim
13976 #: ../src/guestfs-actions.pod:4223
13977 #, no-wrap
13978 msgid ""
13979 " int\n"
13980 " guestfs_mkfs_opts (guestfs_h *g,\n"
13981 "                    const char *fstype,\n"
13982 "                    const char *device,\n"
13983 "                    ...);\n"
13984 "\n"
13985 msgstr ""
13986
13987 # type: verbatim
13988 #. type: verbatim
13989 #: ../src/guestfs-actions.pod:4234
13990 #, no-wrap
13991 msgid ""
13992 " GUESTFS_MKFS_OPTS_BLOCKSIZE, int blocksize,\n"
13993 "\n"
13994 msgstr ""
13995
13996 # type: textblock
13997 #. type: textblock
13998 #: ../src/guestfs-actions.pod:4236 ../fish/guestfish-actions.pod:2852
13999 msgid ""
14000 "This function creates a filesystem on C<device>.  The filesystem type is "
14001 "C<fstype>, for example C<ext3>."
14002 msgstr ""
14003
14004 # type: =item
14005 #. type: =item
14006 #: ../src/guestfs-actions.pod:4243 ../fish/guestfish-actions.pod:2859
14007 msgid "C<blocksize>"
14008 msgstr ""
14009
14010 # type: textblock
14011 #. type: textblock
14012 #: ../src/guestfs-actions.pod:4245 ../fish/guestfish-actions.pod:2861
14013 msgid ""
14014 "The filesystem block size.  Supported block sizes depend on the filesystem "
14015 "type, but typically they are C<1024>, C<2048> or C<4096> for Linux ext2/3 "
14016 "filesystems."
14017 msgstr ""
14018
14019 #. type: textblock
14020 #: ../src/guestfs-actions.pod:4252 ../fish/guestfish-actions.pod:2868
14021 msgid "For UFS block sizes, please see L<mkfs.ufs(8)>."
14022 msgstr ""
14023
14024 #. type: textblock
14025 #: ../src/guestfs-actions.pod:4258
14026 msgid "(Added in 1.7.19)"
14027 msgstr ""
14028
14029 # type: =head2
14030 #. type: =head2
14031 #: ../src/guestfs-actions.pod:4260
14032 msgid "guestfs_mkfs_opts_va"
14033 msgstr ""
14034
14035 # type: verbatim
14036 #. type: verbatim
14037 #: ../src/guestfs-actions.pod:4262
14038 #, no-wrap
14039 msgid ""
14040 " int\n"
14041 " guestfs_mkfs_opts_va (guestfs_h *g,\n"
14042 "                       const char *fstype,\n"
14043 "                       const char *device,\n"
14044 "                       va_list args);\n"
14045 "\n"
14046 msgstr ""
14047
14048 # type: textblock
14049 #. type: textblock
14050 #: ../src/guestfs-actions.pod:4268
14051 msgid "This is the \"va_list variant\" of L</guestfs_mkfs_opts>."
14052 msgstr ""
14053
14054 # type: =head2
14055 #. type: =head2
14056 #: ../src/guestfs-actions.pod:4272
14057 msgid "guestfs_mkfs_opts_argv"
14058 msgstr ""
14059
14060 # type: verbatim
14061 #. type: verbatim
14062 #: ../src/guestfs-actions.pod:4274
14063 #, no-wrap
14064 msgid ""
14065 " int\n"
14066 " guestfs_mkfs_opts_argv (guestfs_h *g,\n"
14067 "                         const char *fstype,\n"
14068 "                         const char *device,\n"
14069 "                         const struct guestfs_mkfs_opts_argv *optargs);\n"
14070 "\n"
14071 msgstr ""
14072
14073 # type: textblock
14074 #. type: textblock
14075 #: ../src/guestfs-actions.pod:4280
14076 msgid "This is the \"argv variant\" of L</guestfs_mkfs_opts>."
14077 msgstr ""
14078
14079 # type: =head2
14080 #. type: =head2
14081 #: ../src/guestfs-actions.pod:4284
14082 msgid "guestfs_mkmountpoint"
14083 msgstr ""
14084
14085 # type: verbatim
14086 #. type: verbatim
14087 #: ../src/guestfs-actions.pod:4286
14088 #, no-wrap
14089 msgid ""
14090 " int\n"
14091 " guestfs_mkmountpoint (guestfs_h *g,\n"
14092 "                       const char *exemptpath);\n"
14093 "\n"
14094 msgstr ""
14095
14096 # type: textblock
14097 #. type: textblock
14098 #: ../src/guestfs-actions.pod:4290
14099 msgid ""
14100 "C<guestfs_mkmountpoint> and C<guestfs_rmmountpoint> are specialized calls "
14101 "that can be used to create extra mountpoints before mounting the first "
14102 "filesystem."
14103 msgstr ""
14104
14105 # type: textblock
14106 #. type: textblock
14107 #: ../src/guestfs-actions.pod:4294 ../fish/guestfish-actions.pod:2882
14108 msgid ""
14109 "These calls are I<only> necessary in some very limited circumstances, mainly "
14110 "the case where you want to mount a mix of unrelated and/or read-only "
14111 "filesystems together."
14112 msgstr ""
14113
14114 # type: textblock
14115 #. type: textblock
14116 #: ../src/guestfs-actions.pod:4298 ../fish/guestfish-actions.pod:2886
14117 msgid ""
14118 "For example, live CDs often contain a \"Russian doll\" nest of filesystems, "
14119 "an ISO outer layer, with a squashfs image inside, with an ext2/3 image "
14120 "inside that.  You can unpack this as follows in guestfish:"
14121 msgstr ""
14122
14123 # type: verbatim
14124 #. type: verbatim
14125 #: ../src/guestfs-actions.pod:4303 ../fish/guestfish-actions.pod:2891
14126 #, no-wrap
14127 msgid ""
14128 " add-ro Fedora-11-i686-Live.iso\n"
14129 " run\n"
14130 " mkmountpoint /cd\n"
14131 " mkmountpoint /sqsh\n"
14132 " mkmountpoint /ext3fs\n"
14133 " mount /dev/sda /cd\n"
14134 " mount-loop /cd/LiveOS/squashfs.img /sqsh\n"
14135 " mount-loop /sqsh/LiveOS/ext3fs.img /ext3fs\n"
14136 "\n"
14137 msgstr ""
14138
14139 # type: textblock
14140 #. type: textblock
14141 #: ../src/guestfs-actions.pod:4312 ../fish/guestfish-actions.pod:2900
14142 msgid "The inner filesystem is now unpacked under the /ext3fs mountpoint."
14143 msgstr ""
14144
14145 # type: textblock
14146 #. type: textblock
14147 #: ../src/guestfs-actions.pod:4314
14148 msgid ""
14149 "C<guestfs_mkmountpoint> is not compatible with C<guestfs_umount_all>.  You "
14150 "may get unexpected errors if you try to mix these calls.  It is safest to "
14151 "manually unmount filesystems and remove mountpoints after use."
14152 msgstr ""
14153
14154 # type: textblock
14155 #. type: textblock
14156 #: ../src/guestfs-actions.pod:4318
14157 msgid ""
14158 "C<guestfs_umount_all> unmounts filesystems by sorting the paths longest "
14159 "first, so for this to work for manual mountpoints, you must ensure that the "
14160 "innermost mountpoints have the longest pathnames, as in the example code "
14161 "above."
14162 msgstr ""
14163
14164 # type: textblock
14165 #. type: textblock
14166 #: ../src/guestfs-actions.pod:4323 ../fish/guestfish-actions.pod:2911
14167 msgid ""
14168 "For more details see L<https://bugzilla.redhat.com/show_bug.cgi?id=599503>"
14169 msgstr ""
14170
14171 # type: textblock
14172 #. type: textblock
14173 #: ../src/guestfs-actions.pod:4325
14174 msgid ""
14175 "Autosync [see C<guestfs_set_autosync>, this is set by default on handles] "
14176 "means that C<guestfs_umount_all> is called when the handle is closed which "
14177 "can also trigger these issues."
14178 msgstr ""
14179
14180 # type: textblock
14181 #. type: textblock
14182 #: ../src/guestfs-actions.pod:4331 ../src/guestfs-actions.pod:4590
14183 #: ../src/guestfs-actions.pod:5492
14184 msgid "(Added in 1.0.62)"
14185 msgstr ""
14186
14187 # type: =head2
14188 #. type: =head2
14189 #: ../src/guestfs-actions.pod:4333
14190 msgid "guestfs_mknod"
14191 msgstr ""
14192
14193 # type: verbatim
14194 #. type: verbatim
14195 #: ../src/guestfs-actions.pod:4335
14196 #, no-wrap
14197 msgid ""
14198 " int\n"
14199 " guestfs_mknod (guestfs_h *g,\n"
14200 "                int mode,\n"
14201 "                int devmajor,\n"
14202 "                int devminor,\n"
14203 "                const char *path);\n"
14204 "\n"
14205 msgstr ""
14206
14207 # type: textblock
14208 #. type: textblock
14209 #: ../src/guestfs-actions.pod:4342 ../fish/guestfish-actions.pod:2921
14210 msgid ""
14211 "This call creates block or character special devices, or named pipes (FIFOs)."
14212 msgstr ""
14213
14214 # type: textblock
14215 #. type: textblock
14216 #: ../src/guestfs-actions.pod:4345 ../fish/guestfish-actions.pod:2924
14217 msgid ""
14218 "The C<mode> parameter should be the mode, using the standard constants.  "
14219 "C<devmajor> and C<devminor> are the device major and minor numbers, only "
14220 "used when creating block and character special devices."
14221 msgstr ""
14222
14223 # type: textblock
14224 #. type: textblock
14225 #: ../src/guestfs-actions.pod:4350
14226 msgid ""
14227 "Note that, just like L<mknod(2)>, the mode must be bitwise OR'd with "
14228 "S_IFBLK, S_IFCHR, S_IFIFO or S_IFSOCK (otherwise this call just creates a "
14229 "regular file).  These constants are available in the standard Linux header "
14230 "files, or you can use C<guestfs_mknod_b>, C<guestfs_mknod_c> or "
14231 "C<guestfs_mkfifo> which are wrappers around this command which bitwise OR in "
14232 "the appropriate constant for you."
14233 msgstr ""
14234
14235 # type: =head2
14236 #. type: =head2
14237 #: ../src/guestfs-actions.pod:4364
14238 msgid "guestfs_mknod_b"
14239 msgstr ""
14240
14241 # type: verbatim
14242 #. type: verbatim
14243 #: ../src/guestfs-actions.pod:4366
14244 #, no-wrap
14245 msgid ""
14246 " int\n"
14247 " guestfs_mknod_b (guestfs_h *g,\n"
14248 "                  int mode,\n"
14249 "                  int devmajor,\n"
14250 "                  int devminor,\n"
14251 "                  const char *path);\n"
14252 "\n"
14253 msgstr ""
14254
14255 # type: textblock
14256 #. type: textblock
14257 #: ../src/guestfs-actions.pod:4373
14258 msgid ""
14259 "This call creates a block device node called C<path> with mode C<mode> and "
14260 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
14261 "wrapper around C<guestfs_mknod>."
14262 msgstr ""
14263
14264 # type: =head2
14265 #. type: =head2
14266 #: ../src/guestfs-actions.pod:4383
14267 msgid "guestfs_mknod_c"
14268 msgstr ""
14269
14270 # type: verbatim
14271 #. type: verbatim
14272 #: ../src/guestfs-actions.pod:4385
14273 #, no-wrap
14274 msgid ""
14275 " int\n"
14276 " guestfs_mknod_c (guestfs_h *g,\n"
14277 "                  int mode,\n"
14278 "                  int devmajor,\n"
14279 "                  int devminor,\n"
14280 "                  const char *path);\n"
14281 "\n"
14282 msgstr ""
14283
14284 # type: textblock
14285 #. type: textblock
14286 #: ../src/guestfs-actions.pod:4392
14287 msgid ""
14288 "This call creates a char device node called C<path> with mode C<mode> and "
14289 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
14290 "wrapper around C<guestfs_mknod>."
14291 msgstr ""
14292
14293 # type: =head2
14294 #. type: =head2
14295 #: ../src/guestfs-actions.pod:4402
14296 msgid "guestfs_mkswap"
14297 msgstr ""
14298
14299 # type: verbatim
14300 #. type: verbatim
14301 #: ../src/guestfs-actions.pod:4404
14302 #, no-wrap
14303 msgid ""
14304 " int\n"
14305 " guestfs_mkswap (guestfs_h *g,\n"
14306 "                 const char *device);\n"
14307 "\n"
14308 msgstr ""
14309
14310 # type: textblock
14311 #. type: textblock
14312 #: ../src/guestfs-actions.pod:4408 ../fish/guestfish-actions.pod:2963
14313 msgid "Create a swap partition on C<device>."
14314 msgstr ""
14315
14316 # type: =head2
14317 #. type: =head2
14318 #: ../src/guestfs-actions.pod:4414
14319 msgid "guestfs_mkswap_L"
14320 msgstr ""
14321
14322 # type: verbatim
14323 #. type: verbatim
14324 #: ../src/guestfs-actions.pod:4416
14325 #, no-wrap
14326 msgid ""
14327 " int\n"
14328 " guestfs_mkswap_L (guestfs_h *g,\n"
14329 "                   const char *label,\n"
14330 "                   const char *device);\n"
14331 "\n"
14332 msgstr ""
14333
14334 # type: textblock
14335 #. type: textblock
14336 #: ../src/guestfs-actions.pod:4421 ../fish/guestfish-actions.pod:2969
14337 msgid "Create a swap partition on C<device> with label C<label>."
14338 msgstr ""
14339
14340 # type: textblock
14341 #. type: textblock
14342 #: ../src/guestfs-actions.pod:4423 ../fish/guestfish-actions.pod:2971
14343 msgid ""
14344 "Note that you cannot attach a swap label to a block device (eg. C</dev/"
14345 "sda>), just to a partition.  This appears to be a limitation of the kernel "
14346 "or swap tools."
14347 msgstr ""
14348
14349 # type: =head2
14350 #. type: =head2
14351 #: ../src/guestfs-actions.pod:4431
14352 msgid "guestfs_mkswap_U"
14353 msgstr ""
14354
14355 # type: verbatim
14356 #. type: verbatim
14357 #: ../src/guestfs-actions.pod:4433
14358 #, no-wrap
14359 msgid ""
14360 " int\n"
14361 " guestfs_mkswap_U (guestfs_h *g,\n"
14362 "                   const char *uuid,\n"
14363 "                   const char *device);\n"
14364 "\n"
14365 msgstr ""
14366
14367 # type: textblock
14368 #. type: textblock
14369 #: ../src/guestfs-actions.pod:4438 ../fish/guestfish-actions.pod:2979
14370 msgid "Create a swap partition on C<device> with UUID C<uuid>."
14371 msgstr ""
14372
14373 # type: =head2
14374 #. type: =head2
14375 #: ../src/guestfs-actions.pod:4444
14376 msgid "guestfs_mkswap_file"
14377 msgstr ""
14378
14379 # type: verbatim
14380 #. type: verbatim
14381 #: ../src/guestfs-actions.pod:4446
14382 #, no-wrap
14383 msgid ""
14384 " int\n"
14385 " guestfs_mkswap_file (guestfs_h *g,\n"
14386 "                      const char *path);\n"
14387 "\n"
14388 msgstr ""
14389
14390 # type: textblock
14391 #. type: textblock
14392 #: ../src/guestfs-actions.pod:4450 ../fish/guestfish-actions.pod:2985
14393 msgid "Create a swap file."
14394 msgstr ""
14395
14396 # type: textblock
14397 #. type: textblock
14398 #: ../src/guestfs-actions.pod:4452
14399 msgid ""
14400 "This command just writes a swap file signature to an existing file.  To "
14401 "create the file itself, use something like C<guestfs_fallocate>."
14402 msgstr ""
14403
14404 # type: =head2
14405 #. type: =head2
14406 #: ../src/guestfs-actions.pod:4459
14407 msgid "guestfs_modprobe"
14408 msgstr ""
14409
14410 # type: verbatim
14411 #. type: verbatim
14412 #: ../src/guestfs-actions.pod:4461
14413 #, no-wrap
14414 msgid ""
14415 " int\n"
14416 " guestfs_modprobe (guestfs_h *g,\n"
14417 "                   const char *modulename);\n"
14418 "\n"
14419 msgstr ""
14420
14421 # type: textblock
14422 #. type: textblock
14423 #: ../src/guestfs-actions.pod:4465 ../fish/guestfish-actions.pod:2994
14424 msgid "This loads a kernel module in the appliance."
14425 msgstr ""
14426
14427 # type: textblock
14428 #. type: textblock
14429 #: ../src/guestfs-actions.pod:4467 ../fish/guestfish-actions.pod:2996
14430 msgid ""
14431 "The kernel module must have been whitelisted when libguestfs was built (see "
14432 "C<appliance/kmod.whitelist.in> in the source)."
14433 msgstr ""
14434
14435 # type: =head2
14436 #. type: =head2
14437 #: ../src/guestfs-actions.pod:4474
14438 msgid "guestfs_mount"
14439 msgstr ""
14440
14441 # type: verbatim
14442 #. type: verbatim
14443 #: ../src/guestfs-actions.pod:4476
14444 #, no-wrap
14445 msgid ""
14446 " int\n"
14447 " guestfs_mount (guestfs_h *g,\n"
14448 "                const char *device,\n"
14449 "                const char *mountpoint);\n"
14450 "\n"
14451 msgstr ""
14452
14453 # type: textblock
14454 #. type: textblock
14455 #: ../src/guestfs-actions.pod:4481 ../fish/guestfish-actions.pod:3003
14456 msgid ""
14457 "Mount a guest disk at a position in the filesystem.  Block devices are named "
14458 "C</dev/sda>, C</dev/sdb> and so on, as they were added to the guest.  If "
14459 "those block devices contain partitions, they will have the usual names (eg. "
14460 "C</dev/sda1>).  Also LVM C</dev/VG/LV>-style names can be used."
14461 msgstr ""
14462
14463 # type: textblock
14464 #. type: textblock
14465 #: ../src/guestfs-actions.pod:4487 ../fish/guestfish-actions.pod:3009
14466 msgid ""
14467 "The rules are the same as for L<mount(2)>: A filesystem must first be "
14468 "mounted on C</> before others can be mounted.  Other filesystems can only be "
14469 "mounted on directories which already exist."
14470 msgstr ""
14471
14472 # type: textblock
14473 #. type: textblock
14474 #: ../src/guestfs-actions.pod:4492 ../fish/guestfish-actions.pod:3014
14475 msgid ""
14476 "The mounted filesystem is writable, if we have sufficient permissions on the "
14477 "underlying device."
14478 msgstr ""
14479
14480 # type: textblock
14481 #. type: textblock
14482 #: ../src/guestfs-actions.pod:4495
14483 msgid ""
14484 "B<Important note:> When you use this call, the filesystem options C<sync> "
14485 "and C<noatime> are set implicitly.  This was originally done because we "
14486 "thought it would improve reliability, but it turns out that I<-o sync> has a "
14487 "very large negative performance impact and negligible effect on "
14488 "reliability.  Therefore we recommend that you avoid using C<guestfs_mount> "
14489 "in any code that needs performance, and instead use C<guestfs_mount_options> "
14490 "(use an empty string for the first parameter if you don't want any options)."
14491 msgstr ""
14492
14493 # type: =head2
14494 #. type: =head2
14495 #: ../src/guestfs-actions.pod:4509
14496 msgid "guestfs_mount_loop"
14497 msgstr ""
14498
14499 # type: verbatim
14500 #. type: verbatim
14501 #: ../src/guestfs-actions.pod:4511
14502 #, no-wrap
14503 msgid ""
14504 " int\n"
14505 " guestfs_mount_loop (guestfs_h *g,\n"
14506 "                     const char *file,\n"
14507 "                     const char *mountpoint);\n"
14508 "\n"
14509 msgstr ""
14510
14511 # type: textblock
14512 #. type: textblock
14513 #: ../src/guestfs-actions.pod:4516 ../fish/guestfish-actions.pod:3031
14514 msgid ""
14515 "This command lets you mount C<file> (a filesystem image in a file) on a "
14516 "mount point.  It is entirely equivalent to the command C<mount -o loop file "
14517 "mountpoint>."
14518 msgstr ""
14519
14520 # type: =head2
14521 #. type: =head2
14522 #: ../src/guestfs-actions.pod:4524
14523 msgid "guestfs_mount_options"
14524 msgstr ""
14525
14526 # type: verbatim
14527 #. type: verbatim
14528 #: ../src/guestfs-actions.pod:4526
14529 #, no-wrap
14530 msgid ""
14531 " int\n"
14532 " guestfs_mount_options (guestfs_h *g,\n"
14533 "                        const char *options,\n"
14534 "                        const char *device,\n"
14535 "                        const char *mountpoint);\n"
14536 "\n"
14537 msgstr ""
14538
14539 # type: textblock
14540 #. type: textblock
14541 #: ../src/guestfs-actions.pod:4532
14542 msgid ""
14543 "This is the same as the C<guestfs_mount> command, but it allows you to set "
14544 "the mount options as for the L<mount(8)> I<-o> flag."
14545 msgstr ""
14546
14547 # type: textblock
14548 #. type: textblock
14549 #: ../src/guestfs-actions.pod:4536 ../fish/guestfish-actions.pod:3043
14550 msgid ""
14551 "If the C<options> parameter is an empty string, then no options are passed "
14552 "(all options default to whatever the filesystem uses)."
14553 msgstr ""
14554
14555 # type: textblock
14556 #. type: textblock
14557 #: ../src/guestfs-actions.pod:4542 ../src/guestfs-actions.pod:4556
14558 #: ../src/guestfs-actions.pod:4573
14559 msgid "(Added in 1.0.10)"
14560 msgstr ""
14561
14562 # type: =head2
14563 #. type: =head2
14564 #: ../src/guestfs-actions.pod:4544
14565 msgid "guestfs_mount_ro"
14566 msgstr ""
14567
14568 # type: verbatim
14569 #. type: verbatim
14570 #: ../src/guestfs-actions.pod:4546
14571 #, no-wrap
14572 msgid ""
14573 " int\n"
14574 " guestfs_mount_ro (guestfs_h *g,\n"
14575 "                   const char *device,\n"
14576 "                   const char *mountpoint);\n"
14577 "\n"
14578 msgstr ""
14579
14580 # type: textblock
14581 #. type: textblock
14582 #: ../src/guestfs-actions.pod:4551
14583 msgid ""
14584 "This is the same as the C<guestfs_mount> command, but it mounts the "
14585 "filesystem with the read-only (I<-o ro>) flag."
14586 msgstr ""
14587
14588 # type: =head2
14589 #. type: =head2
14590 #: ../src/guestfs-actions.pod:4558
14591 msgid "guestfs_mount_vfs"
14592 msgstr ""
14593
14594 # type: verbatim
14595 #. type: verbatim
14596 #: ../src/guestfs-actions.pod:4560
14597 #, no-wrap
14598 msgid ""
14599 " int\n"
14600 " guestfs_mount_vfs (guestfs_h *g,\n"
14601 "                    const char *options,\n"
14602 "                    const char *vfstype,\n"
14603 "                    const char *device,\n"
14604 "                    const char *mountpoint);\n"
14605 "\n"
14606 msgstr ""
14607
14608 # type: textblock
14609 #. type: textblock
14610 #: ../src/guestfs-actions.pod:4567
14611 msgid ""
14612 "This is the same as the C<guestfs_mount> command, but it allows you to set "
14613 "both the mount options and the vfstype as for the L<mount(8)> I<-o> and I<-"
14614 "t> flags."
14615 msgstr ""
14616
14617 # type: =head2
14618 #. type: =head2
14619 #: ../src/guestfs-actions.pod:4575
14620 msgid "guestfs_mountpoints"
14621 msgstr ""
14622
14623 # type: verbatim
14624 #. type: verbatim
14625 #: ../src/guestfs-actions.pod:4577
14626 #, no-wrap
14627 msgid ""
14628 " char **\n"
14629 " guestfs_mountpoints (guestfs_h *g);\n"
14630 "\n"
14631 msgstr ""
14632
14633 # type: textblock
14634 #. type: textblock
14635 #: ../src/guestfs-actions.pod:4580
14636 msgid ""
14637 "This call is similar to C<guestfs_mounts>.  That call returns a list of "
14638 "devices.  This one returns a hash table (map) of device name to directory "
14639 "where the device is mounted."
14640 msgstr ""
14641
14642 # type: =head2
14643 #. type: =head2
14644 #: ../src/guestfs-actions.pod:4592
14645 msgid "guestfs_mounts"
14646 msgstr ""
14647
14648 # type: verbatim
14649 #. type: verbatim
14650 #: ../src/guestfs-actions.pod:4594
14651 #, no-wrap
14652 msgid ""
14653 " char **\n"
14654 " guestfs_mounts (guestfs_h *g);\n"
14655 "\n"
14656 msgstr ""
14657
14658 # type: textblock
14659 #. type: textblock
14660 #: ../src/guestfs-actions.pod:4597 ../fish/guestfish-actions.pod:3074
14661 msgid ""
14662 "This returns the list of currently mounted filesystems.  It returns the list "
14663 "of devices (eg. C</dev/sda1>, C</dev/VG/LV>)."
14664 msgstr ""
14665
14666 # type: textblock
14667 #. type: textblock
14668 #: ../src/guestfs-actions.pod:4600 ../fish/guestfish-actions.pod:3077
14669 msgid "Some internal mounts are not shown."
14670 msgstr ""
14671
14672 # type: textblock
14673 #. type: textblock
14674 #: ../src/guestfs-actions.pod:4602
14675 msgid "See also: C<guestfs_mountpoints>"
14676 msgstr ""
14677
14678 # type: =head2
14679 #. type: =head2
14680 #: ../src/guestfs-actions.pod:4610
14681 msgid "guestfs_mv"
14682 msgstr ""
14683
14684 # type: verbatim
14685 #. type: verbatim
14686 #: ../src/guestfs-actions.pod:4612
14687 #, no-wrap
14688 msgid ""
14689 " int\n"
14690 " guestfs_mv (guestfs_h *g,\n"
14691 "             const char *src,\n"
14692 "             const char *dest);\n"
14693 "\n"
14694 msgstr ""
14695
14696 # type: textblock
14697 #. type: textblock
14698 #: ../src/guestfs-actions.pod:4617 ../fish/guestfish-actions.pod:3085
14699 msgid ""
14700 "This moves a file from C<src> to C<dest> where C<dest> is either a "
14701 "destination filename or destination directory."
14702 msgstr ""
14703
14704 # type: =head2
14705 #. type: =head2
14706 #: ../src/guestfs-actions.pod:4624
14707 msgid "guestfs_ntfs_3g_probe"
14708 msgstr ""
14709
14710 # type: verbatim
14711 #. type: verbatim
14712 #: ../src/guestfs-actions.pod:4626
14713 #, no-wrap
14714 msgid ""
14715 " int\n"
14716 " guestfs_ntfs_3g_probe (guestfs_h *g,\n"
14717 "                        int rw,\n"
14718 "                        const char *device);\n"
14719 "\n"
14720 msgstr ""
14721
14722 # type: textblock
14723 #. type: textblock
14724 #: ../src/guestfs-actions.pod:4631 ../fish/guestfish-actions.pod:3092
14725 msgid ""
14726 "This command runs the L<ntfs-3g.probe(8)> command which probes an NTFS "
14727 "C<device> for mountability.  (Not all NTFS volumes can be mounted read-"
14728 "write, and some cannot be mounted at all)."
14729 msgstr ""
14730
14731 # type: textblock
14732 #. type: textblock
14733 #: ../src/guestfs-actions.pod:4635 ../fish/guestfish-actions.pod:3096
14734 msgid ""
14735 "C<rw> is a boolean flag.  Set it to true if you want to test if the volume "
14736 "can be mounted read-write.  Set it to false if you want to test if the "
14737 "volume can be mounted read-only."
14738 msgstr ""
14739
14740 # type: textblock
14741 #. type: textblock
14742 #: ../src/guestfs-actions.pod:4639 ../fish/guestfish-actions.pod:3100
14743 msgid ""
14744 "The return value is an integer which C<0> if the operation would succeed, or "
14745 "some non-zero value documented in the L<ntfs-3g.probe(8)> manual page."
14746 msgstr ""
14747
14748 # type: textblock
14749 #. type: textblock
14750 #: ../src/guestfs-actions.pod:4645
14751 msgid "(Added in 1.0.43)"
14752 msgstr ""
14753
14754 # type: =head2
14755 #. type: =head2
14756 #: ../src/guestfs-actions.pod:4647
14757 msgid "guestfs_ntfsresize"
14758 msgstr ""
14759
14760 # type: verbatim
14761 #. type: verbatim
14762 #: ../src/guestfs-actions.pod:4649
14763 #, no-wrap
14764 msgid ""
14765 " int\n"
14766 " guestfs_ntfsresize (guestfs_h *g,\n"
14767 "                     const char *device);\n"
14768 "\n"
14769 msgstr ""
14770
14771 #. type: textblock
14772 #: ../src/guestfs-actions.pod:4653 ../fish/guestfish-actions.pod:3108
14773 msgid ""
14774 "This command resizes an NTFS filesystem, expanding or shrinking it to the "
14775 "size of the underlying device."
14776 msgstr ""
14777
14778 #. type: textblock
14779 #: ../src/guestfs-actions.pod:4656 ../fish/guestfish-actions.pod:3111
14780 msgid ""
14781 "I<Note:> After the resize operation, the filesystem is marked as requiring a "
14782 "consistency check (for safety).  You have to boot into Windows to perform "
14783 "this check and clear this condition.  Furthermore, ntfsresize refuses to "
14784 "resize filesystems which have been marked in this way.  So in effect it is "
14785 "not possible to call ntfsresize multiple times on a single filesystem "
14786 "without booting into Windows between each resize."
14787 msgstr ""
14788
14789 #. type: textblock
14790 #: ../src/guestfs-actions.pod:4664 ../fish/guestfish-actions.pod:3119
14791 msgid "See also L<ntfsresize(8)>."
14792 msgstr ""
14793
14794 # type: =head2
14795 #. type: =head2
14796 #: ../src/guestfs-actions.pod:4670
14797 msgid "guestfs_ntfsresize_size"
14798 msgstr ""
14799
14800 # type: verbatim
14801 #. type: verbatim
14802 #: ../src/guestfs-actions.pod:4672
14803 #, no-wrap
14804 msgid ""
14805 " int\n"
14806 " guestfs_ntfsresize_size (guestfs_h *g,\n"
14807 "                          const char *device,\n"
14808 "                          int64_t size);\n"
14809 "\n"
14810 msgstr ""
14811
14812 # type: textblock
14813 #. type: textblock
14814 #: ../src/guestfs-actions.pod:4677
14815 msgid ""
14816 "This command is the same as C<guestfs_ntfsresize> except that it allows you "
14817 "to specify the new size (in bytes) explicitly."
14818 msgstr ""
14819
14820 # type: textblock
14821 #. type: textblock
14822 #: ../src/guestfs-actions.pod:4682 ../src/guestfs-actions.pod:5118
14823 #: ../src/guestfs-actions.pod:5191 ../src/guestfs-actions.pod:5440
14824 #: ../src/guestfs-actions.pod:6979
14825 msgid "(Added in 1.3.14)"
14826 msgstr ""
14827
14828 # type: =head2
14829 #. type: =head2
14830 #: ../src/guestfs-actions.pod:4684
14831 msgid "guestfs_part_add"
14832 msgstr ""
14833
14834 # type: verbatim
14835 #. type: verbatim
14836 #: ../src/guestfs-actions.pod:4686
14837 #, no-wrap
14838 msgid ""
14839 " int\n"
14840 " guestfs_part_add (guestfs_h *g,\n"
14841 "                   const char *device,\n"
14842 "                   const char *prlogex,\n"
14843 "                   int64_t startsect,\n"
14844 "                   int64_t endsect);\n"
14845 "\n"
14846 msgstr ""
14847
14848 # type: textblock
14849 #. type: textblock
14850 #: ../src/guestfs-actions.pod:4693
14851 msgid ""
14852 "This command adds a partition to C<device>.  If there is no partition table "
14853 "on the device, call C<guestfs_part_init> first."
14854 msgstr ""
14855
14856 # type: textblock
14857 #. type: textblock
14858 #: ../src/guestfs-actions.pod:4696 ../fish/guestfish-actions.pod:3135
14859 msgid ""
14860 "The C<prlogex> parameter is the type of partition.  Normally you should pass "
14861 "C<p> or C<primary> here, but MBR partition tables also support C<l> (or "
14862 "C<logical>) and C<e> (or C<extended>) partition types."
14863 msgstr ""
14864
14865 # type: textblock
14866 #. type: textblock
14867 #: ../src/guestfs-actions.pod:4701 ../fish/guestfish-actions.pod:3140
14868 msgid ""
14869 "C<startsect> and C<endsect> are the start and end of the partition in "
14870 "I<sectors>.  C<endsect> may be negative, which means it counts backwards "
14871 "from the end of the disk (C<-1> is the last sector)."
14872 msgstr ""
14873
14874 # type: textblock
14875 #. type: textblock
14876 #: ../src/guestfs-actions.pod:4705
14877 msgid ""
14878 "Creating a partition which covers the whole disk is not so easy.  Use "
14879 "C<guestfs_part_disk> to do that."
14880 msgstr ""
14881
14882 # type: textblock
14883 #. type: textblock
14884 #: ../src/guestfs-actions.pod:4710 ../src/guestfs-actions.pod:4748
14885 #: ../src/guestfs-actions.pod:4801 ../src/guestfs-actions.pod:4879
14886 #: ../src/guestfs-actions.pod:4917 ../src/guestfs-actions.pod:4936
14887 #: ../src/guestfs-actions.pod:4976
14888 msgid "(Added in 1.0.78)"
14889 msgstr ""
14890
14891 # type: =head2
14892 #. type: =head2
14893 #: ../src/guestfs-actions.pod:4712
14894 msgid "guestfs_part_del"
14895 msgstr ""
14896
14897 # type: verbatim
14898 #. type: verbatim
14899 #: ../src/guestfs-actions.pod:4714
14900 #, no-wrap
14901 msgid ""
14902 " int\n"
14903 " guestfs_part_del (guestfs_h *g,\n"
14904 "                   const char *device,\n"
14905 "                   int partnum);\n"
14906 "\n"
14907 msgstr ""
14908
14909 # type: textblock
14910 #. type: textblock
14911 #: ../src/guestfs-actions.pod:4719 ../fish/guestfish-actions.pod:3151
14912 msgid "This command deletes the partition numbered C<partnum> on C<device>."
14913 msgstr ""
14914
14915 # type: textblock
14916 #. type: textblock
14917 #: ../src/guestfs-actions.pod:4721 ../fish/guestfish-actions.pod:3153
14918 msgid ""
14919 "Note that in the case of MBR partitioning, deleting an extended partition "
14920 "also deletes any logical partitions it contains."
14921 msgstr ""
14922
14923 # type: =head2
14924 #. type: =head2
14925 #: ../src/guestfs-actions.pod:4729
14926 msgid "guestfs_part_disk"
14927 msgstr ""
14928
14929 # type: verbatim
14930 #. type: verbatim
14931 #: ../src/guestfs-actions.pod:4731
14932 #, no-wrap
14933 msgid ""
14934 " int\n"
14935 " guestfs_part_disk (guestfs_h *g,\n"
14936 "                    const char *device,\n"
14937 "                    const char *parttype);\n"
14938 "\n"
14939 msgstr ""
14940
14941 # type: textblock
14942 #. type: textblock
14943 #: ../src/guestfs-actions.pod:4736
14944 msgid ""
14945 "This command is simply a combination of C<guestfs_part_init> followed by "
14946 "C<guestfs_part_add> to create a single primary partition covering the whole "
14947 "disk."
14948 msgstr ""
14949
14950 # type: textblock
14951 #. type: textblock
14952 #: ../src/guestfs-actions.pod:4740
14953 msgid ""
14954 "C<parttype> is the partition table type, usually C<mbr> or C<gpt>, but other "
14955 "possible values are described in C<guestfs_part_init>."
14956 msgstr ""
14957
14958 # type: =head2
14959 #. type: =head2
14960 #: ../src/guestfs-actions.pod:4750
14961 msgid "guestfs_part_get_bootable"
14962 msgstr ""
14963
14964 # type: verbatim
14965 #. type: verbatim
14966 #: ../src/guestfs-actions.pod:4752
14967 #, no-wrap
14968 msgid ""
14969 " int\n"
14970 " guestfs_part_get_bootable (guestfs_h *g,\n"
14971 "                            const char *device,\n"
14972 "                            int partnum);\n"
14973 "\n"
14974 msgstr ""
14975
14976 # type: textblock
14977 #. type: textblock
14978 #: ../src/guestfs-actions.pod:4757 ../fish/guestfish-actions.pod:3175
14979 msgid ""
14980 "This command returns true if the partition C<partnum> on C<device> has the "
14981 "bootable flag set."
14982 msgstr ""
14983
14984 # type: textblock
14985 #. type: textblock
14986 #: ../src/guestfs-actions.pod:4760
14987 msgid "See also C<guestfs_part_set_bootable>."
14988 msgstr ""
14989
14990 # type: =head2
14991 #. type: =head2
14992 #: ../src/guestfs-actions.pod:4766
14993 msgid "guestfs_part_get_mbr_id"
14994 msgstr ""
14995
14996 # type: verbatim
14997 #. type: verbatim
14998 #: ../src/guestfs-actions.pod:4768
14999 #, no-wrap
15000 msgid ""
15001 " int\n"
15002 " guestfs_part_get_mbr_id (guestfs_h *g,\n"
15003 "                          const char *device,\n"
15004 "                          int partnum);\n"
15005 "\n"
15006 msgstr ""
15007
15008 # type: textblock
15009 #. type: textblock
15010 #: ../src/guestfs-actions.pod:4773 ../fish/guestfish-actions.pod:3184
15011 msgid ""
15012 "Returns the MBR type byte (also known as the ID byte) from the numbered "
15013 "partition C<partnum>."
15014 msgstr ""
15015
15016 # type: textblock
15017 #. type: textblock
15018 #: ../src/guestfs-actions.pod:4776 ../src/guestfs-actions.pod:4952
15019 msgid ""
15020 "Note that only MBR (old DOS-style) partitions have type bytes.  You will get "
15021 "undefined results for other partition table types (see "
15022 "C<guestfs_part_get_parttype>)."
15023 msgstr ""
15024
15025 # type: =head2
15026 #. type: =head2
15027 #: ../src/guestfs-actions.pod:4784
15028 msgid "guestfs_part_get_parttype"
15029 msgstr ""
15030
15031 # type: verbatim
15032 #. type: verbatim
15033 #: ../src/guestfs-actions.pod:4786
15034 #, no-wrap
15035 msgid ""
15036 " char *\n"
15037 " guestfs_part_get_parttype (guestfs_h *g,\n"
15038 "                            const char *device);\n"
15039 "\n"
15040 msgstr ""
15041
15042 # type: textblock
15043 #. type: textblock
15044 #: ../src/guestfs-actions.pod:4790 ../fish/guestfish-actions.pod:3195
15045 msgid ""
15046 "This command examines the partition table on C<device> and returns the "
15047 "partition table type (format) being used."
15048 msgstr ""
15049
15050 # type: textblock
15051 #. type: textblock
15052 #: ../src/guestfs-actions.pod:4793
15053 msgid ""
15054 "Common return values include: C<msdos> (a DOS/Windows style MBR partition "
15055 "table), C<gpt> (a GPT/EFI-style partition table).  Other values are "
15056 "possible, although unusual.  See C<guestfs_part_init> for a full list."
15057 msgstr ""
15058
15059 # type: =head2
15060 #. type: =head2
15061 #: ../src/guestfs-actions.pod:4803
15062 msgid "guestfs_part_init"
15063 msgstr ""
15064
15065 # type: verbatim
15066 #. type: verbatim
15067 #: ../src/guestfs-actions.pod:4805
15068 #, no-wrap
15069 msgid ""
15070 " int\n"
15071 " guestfs_part_init (guestfs_h *g,\n"
15072 "                    const char *device,\n"
15073 "                    const char *parttype);\n"
15074 "\n"
15075 msgstr ""
15076
15077 # type: textblock
15078 #. type: textblock
15079 #: ../src/guestfs-actions.pod:4810 ../fish/guestfish-actions.pod:3207
15080 msgid ""
15081 "This creates an empty partition table on C<device> of one of the partition "
15082 "types listed below.  Usually C<parttype> should be either C<msdos> or C<gpt> "
15083 "(for large disks)."
15084 msgstr ""
15085
15086 # type: textblock
15087 #. type: textblock
15088 #: ../src/guestfs-actions.pod:4814
15089 msgid ""
15090 "Initially there are no partitions.  Following this, you should call "
15091 "C<guestfs_part_add> for each partition required."
15092 msgstr ""
15093
15094 # type: textblock
15095 #. type: textblock
15096 #: ../src/guestfs-actions.pod:4817 ../fish/guestfish-actions.pod:3214
15097 msgid "Possible values for C<parttype> are:"
15098 msgstr ""
15099
15100 # type: =item
15101 #. type: =item
15102 #: ../src/guestfs-actions.pod:4821 ../fish/guestfish-actions.pod:3218
15103 msgid "B<efi> | B<gpt>"
15104 msgstr ""
15105
15106 # type: textblock
15107 #. type: textblock
15108 #: ../src/guestfs-actions.pod:4823 ../fish/guestfish-actions.pod:3220
15109 msgid "Intel EFI / GPT partition table."
15110 msgstr ""
15111
15112 # type: textblock
15113 #. type: textblock
15114 #: ../src/guestfs-actions.pod:4825 ../fish/guestfish-actions.pod:3222
15115 msgid ""
15116 "This is recommended for >= 2 TB partitions that will be accessed from Linux "
15117 "and Intel-based Mac OS X.  It also has limited backwards compatibility with "
15118 "the C<mbr> format."
15119 msgstr ""
15120
15121 # type: =item
15122 #. type: =item
15123 #: ../src/guestfs-actions.pod:4829 ../fish/guestfish-actions.pod:3226
15124 msgid "B<mbr> | B<msdos>"
15125 msgstr ""
15126
15127 # type: textblock
15128 #. type: textblock
15129 #: ../src/guestfs-actions.pod:4831 ../fish/guestfish-actions.pod:3228
15130 msgid ""
15131 "The standard PC \"Master Boot Record\" (MBR) format used by MS-DOS and "
15132 "Windows.  This partition type will B<only> work for device sizes up to 2 "
15133 "TB.  For large disks we recommend using C<gpt>."
15134 msgstr ""
15135
15136 # type: textblock
15137 #. type: textblock
15138 #: ../src/guestfs-actions.pod:4838 ../fish/guestfish-actions.pod:3235
15139 msgid ""
15140 "Other partition table types that may work but are not supported include:"
15141 msgstr ""
15142
15143 # type: =item
15144 #. type: =item
15145 #: ../src/guestfs-actions.pod:4843 ../fish/guestfish-actions.pod:3240
15146 msgid "B<aix>"
15147 msgstr ""
15148
15149 # type: textblock
15150 #. type: textblock
15151 #: ../src/guestfs-actions.pod:4845 ../fish/guestfish-actions.pod:3242
15152 msgid "AIX disk labels."
15153 msgstr ""
15154
15155 # type: =item
15156 #. type: =item
15157 #: ../src/guestfs-actions.pod:4847 ../fish/guestfish-actions.pod:3244
15158 msgid "B<amiga> | B<rdb>"
15159 msgstr ""
15160
15161 # type: textblock
15162 #. type: textblock
15163 #: ../src/guestfs-actions.pod:4849 ../fish/guestfish-actions.pod:3246
15164 msgid "Amiga \"Rigid Disk Block\" format."
15165 msgstr ""
15166
15167 # type: =item
15168 #. type: =item
15169 #: ../src/guestfs-actions.pod:4851 ../fish/guestfish-actions.pod:3248
15170 msgid "B<bsd>"
15171 msgstr ""
15172
15173 # type: textblock
15174 #. type: textblock
15175 #: ../src/guestfs-actions.pod:4853 ../fish/guestfish-actions.pod:3250
15176 msgid "BSD disk labels."
15177 msgstr ""
15178
15179 # type: =item
15180 #. type: =item
15181 #: ../src/guestfs-actions.pod:4855 ../fish/guestfish-actions.pod:3252
15182 msgid "B<dasd>"
15183 msgstr ""
15184
15185 # type: textblock
15186 #. type: textblock
15187 #: ../src/guestfs-actions.pod:4857 ../fish/guestfish-actions.pod:3254
15188 msgid "DASD, used on IBM mainframes."
15189 msgstr ""
15190
15191 # type: =item
15192 #. type: =item
15193 #: ../src/guestfs-actions.pod:4859 ../fish/guestfish-actions.pod:3256
15194 msgid "B<dvh>"
15195 msgstr ""
15196
15197 # type: textblock
15198 #. type: textblock
15199 #: ../src/guestfs-actions.pod:4861 ../fish/guestfish-actions.pod:3258
15200 msgid "MIPS/SGI volumes."
15201 msgstr ""
15202
15203 # type: =item
15204 #. type: =item
15205 #: ../src/guestfs-actions.pod:4863 ../fish/guestfish-actions.pod:3260
15206 msgid "B<mac>"
15207 msgstr ""
15208
15209 # type: textblock
15210 #. type: textblock
15211 #: ../src/guestfs-actions.pod:4865 ../fish/guestfish-actions.pod:3262
15212 msgid "Old Mac partition format.  Modern Macs use C<gpt>."
15213 msgstr ""
15214
15215 # type: =item
15216 #. type: =item
15217 #: ../src/guestfs-actions.pod:4867 ../fish/guestfish-actions.pod:3264
15218 msgid "B<pc98>"
15219 msgstr ""
15220
15221 # type: textblock
15222 #. type: textblock
15223 #: ../src/guestfs-actions.pod:4869 ../fish/guestfish-actions.pod:3266
15224 msgid "NEC PC-98 format, common in Japan apparently."
15225 msgstr ""
15226
15227 # type: =item
15228 #. type: =item
15229 #: ../src/guestfs-actions.pod:4871 ../fish/guestfish-actions.pod:3268
15230 msgid "B<sun>"
15231 msgstr ""
15232
15233 # type: textblock
15234 #. type: textblock
15235 #: ../src/guestfs-actions.pod:4873 ../fish/guestfish-actions.pod:3270
15236 msgid "Sun disk labels."
15237 msgstr ""
15238
15239 # type: =head2
15240 #. type: =head2
15241 #: ../src/guestfs-actions.pod:4881
15242 msgid "guestfs_part_list"
15243 msgstr ""
15244
15245 # type: verbatim
15246 #. type: verbatim
15247 #: ../src/guestfs-actions.pod:4883
15248 #, no-wrap
15249 msgid ""
15250 " struct guestfs_partition_list *\n"
15251 " guestfs_part_list (guestfs_h *g,\n"
15252 "                    const char *device);\n"
15253 "\n"
15254 msgstr ""
15255
15256 # type: textblock
15257 #. type: textblock
15258 #: ../src/guestfs-actions.pod:4887 ../fish/guestfish-actions.pod:3278
15259 msgid ""
15260 "This command parses the partition table on C<device> and returns the list of "
15261 "partitions found."
15262 msgstr ""
15263
15264 # type: textblock
15265 #. type: textblock
15266 #: ../src/guestfs-actions.pod:4890 ../fish/guestfish-actions.pod:3281
15267 msgid "The fields in the returned structure are:"
15268 msgstr ""
15269
15270 # type: =item
15271 #. type: =item
15272 #: ../src/guestfs-actions.pod:4894 ../fish/guestfish-actions.pod:3285
15273 msgid "B<part_num>"
15274 msgstr ""
15275
15276 # type: textblock
15277 #. type: textblock
15278 #: ../src/guestfs-actions.pod:4896 ../fish/guestfish-actions.pod:3287
15279 msgid "Partition number, counting from 1."
15280 msgstr ""
15281
15282 # type: =item
15283 #. type: =item
15284 #: ../src/guestfs-actions.pod:4898 ../fish/guestfish-actions.pod:3289
15285 msgid "B<part_start>"
15286 msgstr ""
15287
15288 # type: textblock
15289 #. type: textblock
15290 #: ../src/guestfs-actions.pod:4900
15291 msgid ""
15292 "Start of the partition I<in bytes>.  To get sectors you have to divide by "
15293 "the device's sector size, see C<guestfs_blockdev_getss>."
15294 msgstr ""
15295
15296 # type: =item
15297 #. type: =item
15298 #: ../src/guestfs-actions.pod:4903 ../fish/guestfish-actions.pod:3294
15299 msgid "B<part_end>"
15300 msgstr ""
15301
15302 # type: textblock
15303 #. type: textblock
15304 #: ../src/guestfs-actions.pod:4905 ../fish/guestfish-actions.pod:3296
15305 msgid "End of the partition in bytes."
15306 msgstr ""
15307
15308 # type: =item
15309 #. type: =item
15310 #: ../src/guestfs-actions.pod:4907 ../fish/guestfish-actions.pod:3298
15311 msgid "B<part_size>"
15312 msgstr ""
15313
15314 # type: textblock
15315 #. type: textblock
15316 #: ../src/guestfs-actions.pod:4909 ../fish/guestfish-actions.pod:3300
15317 msgid "Size of the partition in bytes."
15318 msgstr ""
15319
15320 # type: textblock
15321 #. type: textblock
15322 #: ../src/guestfs-actions.pod:4913
15323 msgid ""
15324 "This function returns a C<struct guestfs_partition_list *>, or NULL if there "
15325 "was an error.  I<The caller must call C<guestfs_free_partition_list> after "
15326 "use>."
15327 msgstr ""
15328
15329 # type: =head2
15330 #. type: =head2
15331 #: ../src/guestfs-actions.pod:4919
15332 msgid "guestfs_part_set_bootable"
15333 msgstr ""
15334
15335 # type: verbatim
15336 #. type: verbatim
15337 #: ../src/guestfs-actions.pod:4921
15338 #, no-wrap
15339 msgid ""
15340 " int\n"
15341 " guestfs_part_set_bootable (guestfs_h *g,\n"
15342 "                            const char *device,\n"
15343 "                            int partnum,\n"
15344 "                            int bootable);\n"
15345 "\n"
15346 msgstr ""
15347
15348 # type: textblock
15349 #. type: textblock
15350 #: ../src/guestfs-actions.pod:4927 ../fish/guestfish-actions.pod:3308
15351 msgid ""
15352 "This sets the bootable flag on partition numbered C<partnum> on device "
15353 "C<device>.  Note that partitions are numbered from 1."
15354 msgstr ""
15355
15356 # type: textblock
15357 #. type: textblock
15358 #: ../src/guestfs-actions.pod:4930 ../fish/guestfish-actions.pod:3311
15359 msgid ""
15360 "The bootable flag is used by some operating systems (notably Windows) to "
15361 "determine which partition to boot from.  It is by no means universally "
15362 "recognized."
15363 msgstr ""
15364
15365 # type: =head2
15366 #. type: =head2
15367 #: ../src/guestfs-actions.pod:4938
15368 msgid "guestfs_part_set_mbr_id"
15369 msgstr ""
15370
15371 # type: verbatim
15372 #. type: verbatim
15373 #: ../src/guestfs-actions.pod:4940
15374 #, no-wrap
15375 msgid ""
15376 " int\n"
15377 " guestfs_part_set_mbr_id (guestfs_h *g,\n"
15378 "                          const char *device,\n"
15379 "                          int partnum,\n"
15380 "                          int idbyte);\n"
15381 "\n"
15382 msgstr ""
15383
15384 # type: textblock
15385 #. type: textblock
15386 #: ../src/guestfs-actions.pod:4946 ../fish/guestfish-actions.pod:3319
15387 msgid ""
15388 "Sets the MBR type byte (also known as the ID byte) of the numbered partition "
15389 "C<partnum> to C<idbyte>.  Note that the type bytes quoted in most "
15390 "documentation are in fact hexadecimal numbers, but usually documented "
15391 "without any leading \"0x\" which might be confusing."
15392 msgstr ""
15393
15394 # type: =head2
15395 #. type: =head2
15396 #: ../src/guestfs-actions.pod:4960
15397 msgid "guestfs_part_set_name"
15398 msgstr ""
15399
15400 # type: verbatim
15401 #. type: verbatim
15402 #: ../src/guestfs-actions.pod:4962
15403 #, no-wrap
15404 msgid ""
15405 " int\n"
15406 " guestfs_part_set_name (guestfs_h *g,\n"
15407 "                        const char *device,\n"
15408 "                        int partnum,\n"
15409 "                        const char *name);\n"
15410 "\n"
15411 msgstr ""
15412
15413 # type: textblock
15414 #. type: textblock
15415 #: ../src/guestfs-actions.pod:4968 ../fish/guestfish-actions.pod:3333
15416 msgid ""
15417 "This sets the partition name on partition numbered C<partnum> on device "
15418 "C<device>.  Note that partitions are numbered from 1."
15419 msgstr ""
15420
15421 # type: textblock
15422 #. type: textblock
15423 #: ../src/guestfs-actions.pod:4971 ../fish/guestfish-actions.pod:3336
15424 msgid ""
15425 "The partition name can only be set on certain types of partition table.  "
15426 "This works on C<gpt> but not on C<mbr> partitions."
15427 msgstr ""
15428
15429 # type: =head2
15430 #. type: =head2
15431 #: ../src/guestfs-actions.pod:4978
15432 msgid "guestfs_part_to_dev"
15433 msgstr ""
15434
15435 # type: verbatim
15436 #. type: verbatim
15437 #: ../src/guestfs-actions.pod:4980
15438 #, no-wrap
15439 msgid ""
15440 " char *\n"
15441 " guestfs_part_to_dev (guestfs_h *g,\n"
15442 "                      const char *partition);\n"
15443 "\n"
15444 msgstr ""
15445
15446 # type: textblock
15447 #. type: textblock
15448 #: ../src/guestfs-actions.pod:4984 ../fish/guestfish-actions.pod:3343
15449 msgid ""
15450 "This function takes a partition name (eg. \"/dev/sdb1\") and removes the "
15451 "partition number, returning the device name (eg. \"/dev/sdb\")."
15452 msgstr ""
15453
15454 # type: textblock
15455 #. type: textblock
15456 #: ../src/guestfs-actions.pod:4988
15457 msgid ""
15458 "The named partition must exist, for example as a string returned from "
15459 "C<guestfs_list_partitions>."
15460 msgstr ""
15461
15462 # type: =head2
15463 #. type: =head2
15464 #: ../src/guestfs-actions.pod:4996
15465 msgid "guestfs_ping_daemon"
15466 msgstr ""
15467
15468 # type: verbatim
15469 #. type: verbatim
15470 #: ../src/guestfs-actions.pod:4998
15471 #, no-wrap
15472 msgid ""
15473 " int\n"
15474 " guestfs_ping_daemon (guestfs_h *g);\n"
15475 "\n"
15476 msgstr ""
15477
15478 # type: textblock
15479 #. type: textblock
15480 #: ../src/guestfs-actions.pod:5001 ../fish/guestfish-actions.pod:3354
15481 msgid ""
15482 "This is a test probe into the guestfs daemon running inside the qemu "
15483 "subprocess.  Calling this function checks that the daemon responds to the "
15484 "ping message, without affecting the daemon or attached block device(s) in "
15485 "any other way."
15486 msgstr ""
15487
15488 # type: =head2
15489 #. type: =head2
15490 #: ../src/guestfs-actions.pod:5010
15491 msgid "guestfs_pread"
15492 msgstr ""
15493
15494 # type: verbatim
15495 #. type: verbatim
15496 #: ../src/guestfs-actions.pod:5012
15497 #, no-wrap
15498 msgid ""
15499 " char *\n"
15500 " guestfs_pread (guestfs_h *g,\n"
15501 "                const char *path,\n"
15502 "                int count,\n"
15503 "                int64_t offset,\n"
15504 "                size_t *size_r);\n"
15505 "\n"
15506 msgstr ""
15507
15508 # type: textblock
15509 #. type: textblock
15510 #: ../src/guestfs-actions.pod:5019 ../fish/guestfish-actions.pod:3363
15511 msgid ""
15512 "This command lets you read part of a file.  It reads C<count> bytes of the "
15513 "file, starting at C<offset>, from file C<path>."
15514 msgstr ""
15515
15516 # type: textblock
15517 #. type: textblock
15518 #: ../src/guestfs-actions.pod:5022 ../src/guestfs-actions.pod:5048
15519 #: ../fish/guestfish-actions.pod:3366 ../fish/guestfish-actions.pod:3381
15520 msgid ""
15521 "This may read fewer bytes than requested.  For further details see the "
15522 "L<pread(2)> system call."
15523 msgstr ""
15524
15525 # type: textblock
15526 #. type: textblock
15527 #: ../src/guestfs-actions.pod:5025
15528 msgid "See also C<guestfs_pwrite>, C<guestfs_pread_device>."
15529 msgstr ""
15530
15531 # type: =head2
15532 #. type: =head2
15533 #: ../src/guestfs-actions.pod:5036
15534 msgid "guestfs_pread_device"
15535 msgstr ""
15536
15537 # type: verbatim
15538 #. type: verbatim
15539 #: ../src/guestfs-actions.pod:5038
15540 #, no-wrap
15541 msgid ""
15542 " char *\n"
15543 " guestfs_pread_device (guestfs_h *g,\n"
15544 "                       const char *device,\n"
15545 "                       int count,\n"
15546 "                       int64_t offset,\n"
15547 "                       size_t *size_r);\n"
15548 "\n"
15549 msgstr ""
15550
15551 # type: textblock
15552 #. type: textblock
15553 #: ../src/guestfs-actions.pod:5045 ../fish/guestfish-actions.pod:3378
15554 msgid ""
15555 "This command lets you read part of a file.  It reads C<count> bytes of "
15556 "C<device>, starting at C<offset>."
15557 msgstr ""
15558
15559 # type: textblock
15560 #. type: textblock
15561 #: ../src/guestfs-actions.pod:5051
15562 msgid "See also C<guestfs_pread>."
15563 msgstr ""
15564
15565 # type: textblock
15566 #. type: textblock
15567 #: ../src/guestfs-actions.pod:5060
15568 msgid "(Added in 1.5.21)"
15569 msgstr ""
15570
15571 # type: =head2
15572 #. type: =head2
15573 #: ../src/guestfs-actions.pod:5062
15574 msgid "guestfs_pvcreate"
15575 msgstr ""
15576
15577 # type: verbatim
15578 #. type: verbatim
15579 #: ../src/guestfs-actions.pod:5064
15580 #, no-wrap
15581 msgid ""
15582 " int\n"
15583 " guestfs_pvcreate (guestfs_h *g,\n"
15584 "                   const char *device);\n"
15585 "\n"
15586 msgstr ""
15587
15588 # type: textblock
15589 #. type: textblock
15590 #: ../src/guestfs-actions.pod:5068 ../fish/guestfish-actions.pod:3393
15591 msgid ""
15592 "This creates an LVM physical volume on the named C<device>, where C<device> "
15593 "should usually be a partition name such as C</dev/sda1>."
15594 msgstr ""
15595
15596 # type: =head2
15597 #. type: =head2
15598 #: ../src/guestfs-actions.pod:5076
15599 msgid "guestfs_pvremove"
15600 msgstr ""
15601
15602 # type: verbatim
15603 #. type: verbatim
15604 #: ../src/guestfs-actions.pod:5078
15605 #, no-wrap
15606 msgid ""
15607 " int\n"
15608 " guestfs_pvremove (guestfs_h *g,\n"
15609 "                   const char *device);\n"
15610 "\n"
15611 msgstr ""
15612
15613 # type: textblock
15614 #. type: textblock
15615 #: ../src/guestfs-actions.pod:5082 ../fish/guestfish-actions.pod:3401
15616 msgid ""
15617 "This wipes a physical volume C<device> so that LVM will no longer recognise "
15618 "it."
15619 msgstr ""
15620
15621 # type: textblock
15622 #. type: textblock
15623 #: ../src/guestfs-actions.pod:5085 ../fish/guestfish-actions.pod:3404
15624 msgid ""
15625 "The implementation uses the C<pvremove> command which refuses to wipe "
15626 "physical volumes that contain any volume groups, so you have to remove those "
15627 "first."
15628 msgstr ""
15629
15630 # type: =head2
15631 #. type: =head2
15632 #: ../src/guestfs-actions.pod:5093
15633 msgid "guestfs_pvresize"
15634 msgstr ""
15635
15636 # type: verbatim
15637 #. type: verbatim
15638 #: ../src/guestfs-actions.pod:5095
15639 #, no-wrap
15640 msgid ""
15641 " int\n"
15642 " guestfs_pvresize (guestfs_h *g,\n"
15643 "                   const char *device);\n"
15644 "\n"
15645 msgstr ""
15646
15647 # type: textblock
15648 #. type: textblock
15649 #: ../src/guestfs-actions.pod:5099 ../fish/guestfish-actions.pod:3412
15650 msgid ""
15651 "This resizes (expands or shrinks) an existing LVM physical volume to match "
15652 "the new size of the underlying device."
15653 msgstr ""
15654
15655 # type: =head2
15656 #. type: =head2
15657 #: ../src/guestfs-actions.pod:5106
15658 msgid "guestfs_pvresize_size"
15659 msgstr ""
15660
15661 # type: verbatim
15662 #. type: verbatim
15663 #: ../src/guestfs-actions.pod:5108
15664 #, no-wrap
15665 msgid ""
15666 " int\n"
15667 " guestfs_pvresize_size (guestfs_h *g,\n"
15668 "                        const char *device,\n"
15669 "                        int64_t size);\n"
15670 "\n"
15671 msgstr ""
15672
15673 # type: textblock
15674 #. type: textblock
15675 #: ../src/guestfs-actions.pod:5113
15676 msgid ""
15677 "This command is the same as C<guestfs_pvresize> except that it allows you to "
15678 "specify the new size (in bytes) explicitly."
15679 msgstr ""
15680
15681 # type: =head2
15682 #. type: =head2
15683 #: ../src/guestfs-actions.pod:5120
15684 msgid "guestfs_pvs"
15685 msgstr ""
15686
15687 # type: verbatim
15688 #. type: verbatim
15689 #: ../src/guestfs-actions.pod:5122
15690 #, no-wrap
15691 msgid ""
15692 " char **\n"
15693 " guestfs_pvs (guestfs_h *g);\n"
15694 "\n"
15695 msgstr ""
15696
15697 # type: textblock
15698 #. type: textblock
15699 #: ../src/guestfs-actions.pod:5125 ../fish/guestfish-actions.pod:3426
15700 msgid ""
15701 "List all the physical volumes detected.  This is the equivalent of the L<pvs"
15702 "(8)> command."
15703 msgstr ""
15704
15705 # type: textblock
15706 #. type: textblock
15707 #: ../src/guestfs-actions.pod:5128 ../fish/guestfish-actions.pod:3429
15708 msgid ""
15709 "This returns a list of just the device names that contain PVs (eg. C</dev/"
15710 "sda2>)."
15711 msgstr ""
15712
15713 # type: textblock
15714 #. type: textblock
15715 #: ../src/guestfs-actions.pod:5131
15716 msgid "See also C<guestfs_pvs_full>."
15717 msgstr ""
15718
15719 # type: =head2
15720 #. type: =head2
15721 #: ../src/guestfs-actions.pod:5139
15722 msgid "guestfs_pvs_full"
15723 msgstr ""
15724
15725 # type: verbatim
15726 #. type: verbatim
15727 #: ../src/guestfs-actions.pod:5141
15728 #, no-wrap
15729 msgid ""
15730 " struct guestfs_lvm_pv_list *\n"
15731 " guestfs_pvs_full (guestfs_h *g);\n"
15732 "\n"
15733 msgstr ""
15734
15735 # type: textblock
15736 #. type: textblock
15737 #: ../src/guestfs-actions.pod:5144 ../fish/guestfish-actions.pod:3438
15738 msgid ""
15739 "List all the physical volumes detected.  This is the equivalent of the L<pvs"
15740 "(8)> command.  The \"full\" version includes all fields."
15741 msgstr ""
15742
15743 # type: textblock
15744 #. type: textblock
15745 #: ../src/guestfs-actions.pod:5147
15746 msgid ""
15747 "This function returns a C<struct guestfs_lvm_pv_list *>, or NULL if there "
15748 "was an error.  I<The caller must call C<guestfs_free_lvm_pv_list> after use>."
15749 msgstr ""
15750
15751 # type: =head2
15752 #. type: =head2
15753 #: ../src/guestfs-actions.pod:5153
15754 msgid "guestfs_pvuuid"
15755 msgstr ""
15756
15757 # type: verbatim
15758 #. type: verbatim
15759 #: ../src/guestfs-actions.pod:5155
15760 #, no-wrap
15761 msgid ""
15762 " char *\n"
15763 " guestfs_pvuuid (guestfs_h *g,\n"
15764 "                 const char *device);\n"
15765 "\n"
15766 msgstr ""
15767
15768 # type: textblock
15769 #. type: textblock
15770 #: ../src/guestfs-actions.pod:5159 ../fish/guestfish-actions.pod:3445
15771 msgid "This command returns the UUID of the LVM PV C<device>."
15772 msgstr ""
15773
15774 # type: =head2
15775 #. type: =head2
15776 #: ../src/guestfs-actions.pod:5166
15777 msgid "guestfs_pwrite"
15778 msgstr ""
15779
15780 # type: verbatim
15781 #. type: verbatim
15782 #: ../src/guestfs-actions.pod:5168
15783 #, no-wrap
15784 msgid ""
15785 " int\n"
15786 " guestfs_pwrite (guestfs_h *g,\n"
15787 "                 const char *path,\n"
15788 "                 const char *content,\n"
15789 "                 size_t content_size,\n"
15790 "                 int64_t offset);\n"
15791 "\n"
15792 msgstr ""
15793
15794 # type: textblock
15795 #. type: textblock
15796 #: ../src/guestfs-actions.pod:5175 ../fish/guestfish-actions.pod:3451
15797 msgid ""
15798 "This command writes to part of a file.  It writes the data buffer C<content> "
15799 "to the file C<path> starting at offset C<offset>."
15800 msgstr ""
15801
15802 # type: textblock
15803 #. type: textblock
15804 #: ../src/guestfs-actions.pod:5178 ../fish/guestfish-actions.pod:3454
15805 msgid ""
15806 "This command implements the L<pwrite(2)> system call, and like that system "
15807 "call it may not write the full data requested.  The return value is the "
15808 "number of bytes that were actually written to the file.  This could even be "
15809 "0, although short writes are unlikely for regular files in ordinary "
15810 "circumstances."
15811 msgstr ""
15812
15813 # type: textblock
15814 #. type: textblock
15815 #: ../src/guestfs-actions.pod:5184
15816 msgid "See also C<guestfs_pread>, C<guestfs_pwrite_device>."
15817 msgstr ""
15818
15819 # type: =head2
15820 #. type: =head2
15821 #: ../src/guestfs-actions.pod:5193
15822 msgid "guestfs_pwrite_device"
15823 msgstr ""
15824
15825 # type: verbatim
15826 #. type: verbatim
15827 #: ../src/guestfs-actions.pod:5195
15828 #, no-wrap
15829 msgid ""
15830 " int\n"
15831 " guestfs_pwrite_device (guestfs_h *g,\n"
15832 "                        const char *device,\n"
15833 "                        const char *content,\n"
15834 "                        size_t content_size,\n"
15835 "                        int64_t offset);\n"
15836 "\n"
15837 msgstr ""
15838
15839 # type: textblock
15840 #. type: textblock
15841 #: ../src/guestfs-actions.pod:5202 ../fish/guestfish-actions.pod:3469
15842 msgid ""
15843 "This command writes to part of a device.  It writes the data buffer "
15844 "C<content> to C<device> starting at offset C<offset>."
15845 msgstr ""
15846
15847 # type: textblock
15848 #. type: textblock
15849 #: ../src/guestfs-actions.pod:5205 ../fish/guestfish-actions.pod:3472
15850 msgid ""
15851 "This command implements the L<pwrite(2)> system call, and like that system "
15852 "call it may not write the full data requested (although short writes to disk "
15853 "devices and partitions are probably impossible with standard Linux kernels)."
15854 msgstr ""
15855
15856 # type: textblock
15857 #. type: textblock
15858 #: ../src/guestfs-actions.pod:5210
15859 msgid "See also C<guestfs_pwrite>."
15860 msgstr ""
15861
15862 # type: textblock
15863 #. type: textblock
15864 #: ../src/guestfs-actions.pod:5217
15865 msgid "(Added in 1.5.20)"
15866 msgstr ""
15867
15868 # type: =head2
15869 #. type: =head2
15870 #: ../src/guestfs-actions.pod:5219
15871 msgid "guestfs_read_file"
15872 msgstr ""
15873
15874 # type: verbatim
15875 #. type: verbatim
15876 #: ../src/guestfs-actions.pod:5221
15877 #, no-wrap
15878 msgid ""
15879 " char *\n"
15880 " guestfs_read_file (guestfs_h *g,\n"
15881 "                    const char *path,\n"
15882 "                    size_t *size_r);\n"
15883 "\n"
15884 msgstr ""
15885
15886 # type: textblock
15887 #. type: textblock
15888 #: ../src/guestfs-actions.pod:5226 ../fish/guestfish-actions.pod:3486
15889 msgid "This calls returns the contents of the file C<path> as a buffer."
15890 msgstr ""
15891
15892 # type: textblock
15893 #. type: textblock
15894 #: ../src/guestfs-actions.pod:5229
15895 msgid ""
15896 "Unlike C<guestfs_cat>, this function can correctly handle files that contain "
15897 "embedded ASCII NUL characters.  However unlike C<guestfs_download>, this "
15898 "function is limited in the total size of file that can be handled."
15899 msgstr ""
15900
15901 # type: textblock
15902 #. type: textblock
15903 #: ../src/guestfs-actions.pod:5241
15904 msgid "(Added in 1.0.63)"
15905 msgstr ""
15906
15907 # type: =head2
15908 #. type: =head2
15909 #: ../src/guestfs-actions.pod:5243
15910 msgid "guestfs_read_lines"
15911 msgstr ""
15912
15913 # type: verbatim
15914 #. type: verbatim
15915 #: ../src/guestfs-actions.pod:5245
15916 #, no-wrap
15917 msgid ""
15918 " char **\n"
15919 " guestfs_read_lines (guestfs_h *g,\n"
15920 "                     const char *path);\n"
15921 "\n"
15922 msgstr ""
15923
15924 # type: textblock
15925 #. type: textblock
15926 #: ../src/guestfs-actions.pod:5251 ../fish/guestfish-actions.pod:3503
15927 msgid ""
15928 "The file contents are returned as a list of lines.  Trailing C<LF> and "
15929 "C<CRLF> character sequences are I<not> returned."
15930 msgstr ""
15931
15932 # type: textblock
15933 #. type: textblock
15934 #: ../src/guestfs-actions.pod:5254
15935 msgid ""
15936 "Note that this function cannot correctly handle binary files (specifically, "
15937 "files containing C<\\0> character which is treated as end of line).  For "
15938 "those you need to use the C<guestfs_read_file> function which has a more "
15939 "complex interface."
15940 msgstr ""
15941
15942 # type: =head2
15943 #. type: =head2
15944 #: ../src/guestfs-actions.pod:5265
15945 msgid "guestfs_readdir"
15946 msgstr ""
15947
15948 # type: verbatim
15949 #. type: verbatim
15950 #: ../src/guestfs-actions.pod:5267
15951 #, no-wrap
15952 msgid ""
15953 " struct guestfs_dirent_list *\n"
15954 " guestfs_readdir (guestfs_h *g,\n"
15955 "                  const char *dir);\n"
15956 "\n"
15957 msgstr ""
15958
15959 # type: textblock
15960 #. type: textblock
15961 #: ../src/guestfs-actions.pod:5271 ../fish/guestfish-actions.pod:3515
15962 msgid "This returns the list of directory entries in directory C<dir>."
15963 msgstr ""
15964
15965 # type: textblock
15966 #. type: textblock
15967 #: ../src/guestfs-actions.pod:5273 ../fish/guestfish-actions.pod:3517
15968 msgid ""
15969 "All entries in the directory are returned, including C<.> and C<..>.  The "
15970 "entries are I<not> sorted, but returned in the same order as the underlying "
15971 "filesystem."
15972 msgstr ""
15973
15974 # type: textblock
15975 #. type: textblock
15976 #: ../src/guestfs-actions.pod:5277 ../fish/guestfish-actions.pod:3521
15977 msgid ""
15978 "Also this call returns basic file type information about each file.  The "
15979 "C<ftyp> field will contain one of the following characters:"
15980 msgstr ""
15981
15982 # type: =item
15983 #. type: =item
15984 #: ../src/guestfs-actions.pod:5282 ../fish/guestfish-actions.pod:3526
15985 msgid "'b'"
15986 msgstr ""
15987
15988 # type: textblock
15989 #. type: textblock
15990 #: ../src/guestfs-actions.pod:5284 ../fish/guestfish-actions.pod:3528
15991 msgid "Block special"
15992 msgstr ""
15993
15994 # type: =item
15995 #. type: =item
15996 #: ../src/guestfs-actions.pod:5286 ../fish/guestfish-actions.pod:3530
15997 msgid "'c'"
15998 msgstr ""
15999
16000 # type: textblock
16001 #. type: textblock
16002 #: ../src/guestfs-actions.pod:5288 ../fish/guestfish-actions.pod:3532
16003 msgid "Char special"
16004 msgstr ""
16005
16006 # type: =item
16007 #. type: =item
16008 #: ../src/guestfs-actions.pod:5290 ../fish/guestfish-actions.pod:3534
16009 msgid "'d'"
16010 msgstr ""
16011
16012 # type: textblock
16013 #. type: textblock
16014 #: ../src/guestfs-actions.pod:5292 ../fish/guestfish-actions.pod:3536
16015 msgid "Directory"
16016 msgstr ""
16017
16018 # type: =item
16019 #. type: =item
16020 #: ../src/guestfs-actions.pod:5294 ../fish/guestfish-actions.pod:3538
16021 msgid "'f'"
16022 msgstr ""
16023
16024 # type: textblock
16025 #. type: textblock
16026 #: ../src/guestfs-actions.pod:5296 ../fish/guestfish-actions.pod:3540
16027 msgid "FIFO (named pipe)"
16028 msgstr ""
16029
16030 # type: =item
16031 #. type: =item
16032 #: ../src/guestfs-actions.pod:5298 ../fish/guestfish-actions.pod:3542
16033 msgid "'l'"
16034 msgstr ""
16035
16036 # type: textblock
16037 #. type: textblock
16038 #: ../src/guestfs-actions.pod:5300 ../fish/guestfish-actions.pod:3544
16039 msgid "Symbolic link"
16040 msgstr ""
16041
16042 # type: =item
16043 #. type: =item
16044 #: ../src/guestfs-actions.pod:5302 ../fish/guestfish-actions.pod:3546
16045 msgid "'r'"
16046 msgstr ""
16047
16048 # type: textblock
16049 #. type: textblock
16050 #: ../src/guestfs-actions.pod:5304 ../fish/guestfish-actions.pod:3548
16051 msgid "Regular file"
16052 msgstr ""
16053
16054 # type: =item
16055 #. type: =item
16056 #: ../src/guestfs-actions.pod:5306 ../fish/guestfish-actions.pod:3550
16057 msgid "'s'"
16058 msgstr ""
16059
16060 # type: textblock
16061 #. type: textblock
16062 #: ../src/guestfs-actions.pod:5308 ../fish/guestfish-actions.pod:3552
16063 msgid "Socket"
16064 msgstr ""
16065
16066 # type: =item
16067 #. type: =item
16068 #: ../src/guestfs-actions.pod:5310 ../fish/guestfish-actions.pod:3554
16069 msgid "'u'"
16070 msgstr ""
16071
16072 # type: textblock
16073 #. type: textblock
16074 #: ../src/guestfs-actions.pod:5312 ../fish/guestfish-actions.pod:3556
16075 msgid "Unknown file type"
16076 msgstr ""
16077
16078 # type: =item
16079 #. type: =item
16080 #: ../src/guestfs-actions.pod:5314 ../fish/guestfish-actions.pod:3558
16081 msgid "'?'"
16082 msgstr ""
16083
16084 # type: textblock
16085 #. type: textblock
16086 #: ../src/guestfs-actions.pod:5316 ../fish/guestfish-actions.pod:3560
16087 msgid ""
16088 "The L<readdir(3)> call returned a C<d_type> field with an unexpected value"
16089 msgstr ""
16090
16091 # type: textblock
16092 #. type: textblock
16093 #: ../src/guestfs-actions.pod:5321
16094 msgid ""
16095 "This function is primarily intended for use by programs.  To get a simple "
16096 "list of names, use C<guestfs_ls>.  To get a printable directory for human "
16097 "consumption, use C<guestfs_ll>."
16098 msgstr ""
16099
16100 # type: textblock
16101 #. type: textblock
16102 #: ../src/guestfs-actions.pod:5325
16103 msgid ""
16104 "This function returns a C<struct guestfs_dirent_list *>, or NULL if there "
16105 "was an error.  I<The caller must call C<guestfs_free_dirent_list> after use>."
16106 msgstr ""
16107
16108 # type: =head2
16109 #. type: =head2
16110 #: ../src/guestfs-actions.pod:5331
16111 msgid "guestfs_readlink"
16112 msgstr ""
16113
16114 # type: verbatim
16115 #. type: verbatim
16116 #: ../src/guestfs-actions.pod:5333
16117 #, no-wrap
16118 msgid ""
16119 " char *\n"
16120 " guestfs_readlink (guestfs_h *g,\n"
16121 "                   const char *path);\n"
16122 "\n"
16123 msgstr ""
16124
16125 # type: textblock
16126 #. type: textblock
16127 #: ../src/guestfs-actions.pod:5337 ../fish/guestfish-actions.pod:3573
16128 msgid "This command reads the target of a symbolic link."
16129 msgstr ""
16130
16131 # type: =head2
16132 #. type: =head2
16133 #: ../src/guestfs-actions.pod:5344
16134 msgid "guestfs_readlinklist"
16135 msgstr ""
16136
16137 # type: verbatim
16138 #. type: verbatim
16139 #: ../src/guestfs-actions.pod:5346
16140 #, no-wrap
16141 msgid ""
16142 " char **\n"
16143 " guestfs_readlinklist (guestfs_h *g,\n"
16144 "                       const char *path,\n"
16145 "                       char *const *names);\n"
16146 "\n"
16147 msgstr ""
16148
16149 # type: textblock
16150 #. type: textblock
16151 #: ../src/guestfs-actions.pod:5351 ../fish/guestfish-actions.pod:3579
16152 msgid ""
16153 "This call allows you to do a C<readlink> operation on multiple files, where "
16154 "all files are in the directory C<path>.  C<names> is the list of files from "
16155 "this directory."
16156 msgstr ""
16157
16158 # type: textblock
16159 #. type: textblock
16160 #: ../src/guestfs-actions.pod:5355 ../fish/guestfish-actions.pod:3583
16161 msgid ""
16162 "On return you get a list of strings, with a one-to-one correspondence to the "
16163 "C<names> list.  Each string is the value of the symbolic link."
16164 msgstr ""
16165
16166 # type: textblock
16167 #. type: textblock
16168 #: ../src/guestfs-actions.pod:5359 ../fish/guestfish-actions.pod:3587
16169 msgid ""
16170 "If the C<readlink(2)> operation fails on any name, then the corresponding "
16171 "result string is the empty string C<\"\">.  However the whole operation is "
16172 "completed even if there were C<readlink(2)> errors, and so you can call this "
16173 "function with names where you don't know if they are symbolic links already "
16174 "(albeit slightly less efficient)."
16175 msgstr ""
16176
16177 # type: textblock
16178 #. type: textblock
16179 #: ../src/guestfs-actions.pod:5366 ../fish/guestfish-actions.pod:3594
16180 msgid ""
16181 "This call is intended for programs that want to efficiently list a directory "
16182 "contents without making many round-trips.  Very long directory listings "
16183 "might cause the protocol message size to be exceeded, causing this call to "
16184 "fail.  The caller must split up such requests into smaller groups of names."
16185 msgstr ""
16186
16187 # type: =head2
16188 #. type: =head2
16189 #: ../src/guestfs-actions.pod:5379
16190 msgid "guestfs_realpath"
16191 msgstr ""
16192
16193 # type: verbatim
16194 #. type: verbatim
16195 #: ../src/guestfs-actions.pod:5381
16196 #, no-wrap
16197 msgid ""
16198 " char *\n"
16199 " guestfs_realpath (guestfs_h *g,\n"
16200 "                   const char *path);\n"
16201 "\n"
16202 msgstr ""
16203
16204 # type: textblock
16205 #. type: textblock
16206 #: ../src/guestfs-actions.pod:5385 ../fish/guestfish-actions.pod:3605
16207 msgid ""
16208 "Return the canonicalized absolute pathname of C<path>.  The returned path "
16209 "has no C<.>, C<..> or symbolic link path elements."
16210 msgstr ""
16211
16212 # type: =head2
16213 #. type: =head2
16214 #: ../src/guestfs-actions.pod:5393
16215 msgid "guestfs_removexattr"
16216 msgstr ""
16217
16218 # type: verbatim
16219 #. type: verbatim
16220 #: ../src/guestfs-actions.pod:5395
16221 #, no-wrap
16222 msgid ""
16223 " int\n"
16224 " guestfs_removexattr (guestfs_h *g,\n"
16225 "                      const char *xattr,\n"
16226 "                      const char *path);\n"
16227 "\n"
16228 msgstr ""
16229
16230 # type: textblock
16231 #. type: textblock
16232 #: ../src/guestfs-actions.pod:5400 ../fish/guestfish-actions.pod:3612
16233 msgid ""
16234 "This call removes the extended attribute named C<xattr> of the file C<path>."
16235 msgstr ""
16236
16237 # type: textblock
16238 #. type: textblock
16239 #: ../src/guestfs-actions.pod:5403
16240 msgid "See also: C<guestfs_lremovexattr>, L<attr(5)>."
16241 msgstr ""
16242
16243 # type: =head2
16244 #. type: =head2
16245 #: ../src/guestfs-actions.pod:5409
16246 msgid "guestfs_resize2fs"
16247 msgstr ""
16248
16249 # type: verbatim
16250 #. type: verbatim
16251 #: ../src/guestfs-actions.pod:5411
16252 #, no-wrap
16253 msgid ""
16254 " int\n"
16255 " guestfs_resize2fs (guestfs_h *g,\n"
16256 "                    const char *device);\n"
16257 "\n"
16258 msgstr ""
16259
16260 # type: textblock
16261 #. type: textblock
16262 #: ../src/guestfs-actions.pod:5415 ../fish/guestfish-actions.pod:3621
16263 msgid ""
16264 "This resizes an ext2, ext3 or ext4 filesystem to match the size of the "
16265 "underlying device."
16266 msgstr ""
16267
16268 # type: textblock
16269 #. type: textblock
16270 #: ../src/guestfs-actions.pod:5418
16271 msgid ""
16272 "I<Note:> It is sometimes required that you run C<guestfs_e2fsck_f> on the "
16273 "C<device> before calling this command.  For unknown reasons C<resize2fs> "
16274 "sometimes gives an error about this and sometimes not.  In any case, it is "
16275 "always safe to call C<guestfs_e2fsck_f> before calling this function."
16276 msgstr ""
16277
16278 # type: =head2
16279 #. type: =head2
16280 #: ../src/guestfs-actions.pod:5428
16281 msgid "guestfs_resize2fs_size"
16282 msgstr ""
16283
16284 # type: verbatim
16285 #. type: verbatim
16286 #: ../src/guestfs-actions.pod:5430
16287 #, no-wrap
16288 msgid ""
16289 " int\n"
16290 " guestfs_resize2fs_size (guestfs_h *g,\n"
16291 "                         const char *device,\n"
16292 "                         int64_t size);\n"
16293 "\n"
16294 msgstr ""
16295
16296 # type: textblock
16297 #. type: textblock
16298 #: ../src/guestfs-actions.pod:5435
16299 msgid ""
16300 "This command is the same as C<guestfs_resize2fs> except that it allows you "
16301 "to specify the new size (in bytes) explicitly."
16302 msgstr ""
16303
16304 # type: =head2
16305 #. type: =head2
16306 #: ../src/guestfs-actions.pod:5442
16307 msgid "guestfs_rm"
16308 msgstr ""
16309
16310 # type: verbatim
16311 #. type: verbatim
16312 #: ../src/guestfs-actions.pod:5444
16313 #, no-wrap
16314 msgid ""
16315 " int\n"
16316 " guestfs_rm (guestfs_h *g,\n"
16317 "             const char *path);\n"
16318 "\n"
16319 msgstr ""
16320
16321 # type: textblock
16322 #. type: textblock
16323 #: ../src/guestfs-actions.pod:5448 ../fish/guestfish-actions.pod:3641
16324 msgid "Remove the single file C<path>."
16325 msgstr ""
16326
16327 # type: =head2
16328 #. type: =head2
16329 #: ../src/guestfs-actions.pod:5454
16330 msgid "guestfs_rm_rf"
16331 msgstr ""
16332
16333 # type: verbatim
16334 #. type: verbatim
16335 #: ../src/guestfs-actions.pod:5456
16336 #, no-wrap
16337 msgid ""
16338 " int\n"
16339 " guestfs_rm_rf (guestfs_h *g,\n"
16340 "                const char *path);\n"
16341 "\n"
16342 msgstr ""
16343
16344 # type: textblock
16345 #. type: textblock
16346 #: ../src/guestfs-actions.pod:5460 ../fish/guestfish-actions.pod:3647
16347 msgid ""
16348 "Remove the file or directory C<path>, recursively removing the contents if "
16349 "its a directory.  This is like the C<rm -rf> shell command."
16350 msgstr ""
16351
16352 # type: =head2
16353 #. type: =head2
16354 #: ../src/guestfs-actions.pod:5468
16355 msgid "guestfs_rmdir"
16356 msgstr ""
16357
16358 # type: verbatim
16359 #. type: verbatim
16360 #: ../src/guestfs-actions.pod:5470
16361 #, no-wrap
16362 msgid ""
16363 " int\n"
16364 " guestfs_rmdir (guestfs_h *g,\n"
16365 "                const char *path);\n"
16366 "\n"
16367 msgstr ""
16368
16369 # type: textblock
16370 #. type: textblock
16371 #: ../src/guestfs-actions.pod:5474 ../fish/guestfish-actions.pod:3655
16372 msgid "Remove the single directory C<path>."
16373 msgstr ""
16374
16375 # type: =head2
16376 #. type: =head2
16377 #: ../src/guestfs-actions.pod:5480
16378 msgid "guestfs_rmmountpoint"
16379 msgstr ""
16380
16381 # type: verbatim
16382 #. type: verbatim
16383 #: ../src/guestfs-actions.pod:5482
16384 #, no-wrap
16385 msgid ""
16386 " int\n"
16387 " guestfs_rmmountpoint (guestfs_h *g,\n"
16388 "                       const char *exemptpath);\n"
16389 "\n"
16390 msgstr ""
16391
16392 # type: textblock
16393 #. type: textblock
16394 #: ../src/guestfs-actions.pod:5486
16395 msgid ""
16396 "This calls removes a mountpoint that was previously created with "
16397 "C<guestfs_mkmountpoint>.  See C<guestfs_mkmountpoint> for full details."
16398 msgstr ""
16399
16400 # type: =head2
16401 #. type: =head2
16402 #: ../src/guestfs-actions.pod:5494
16403 msgid "guestfs_scrub_device"
16404 msgstr ""
16405
16406 # type: verbatim
16407 #. type: verbatim
16408 #: ../src/guestfs-actions.pod:5496
16409 #, no-wrap
16410 msgid ""
16411 " int\n"
16412 " guestfs_scrub_device (guestfs_h *g,\n"
16413 "                       const char *device);\n"
16414 "\n"
16415 msgstr ""
16416
16417 # type: textblock
16418 #. type: textblock
16419 #: ../src/guestfs-actions.pod:5500 ../fish/guestfish-actions.pod:3669
16420 msgid ""
16421 "This command writes patterns over C<device> to make data retrieval more "
16422 "difficult."
16423 msgstr ""
16424
16425 # type: textblock
16426 #. type: textblock
16427 #: ../src/guestfs-actions.pod:5503 ../src/guestfs-actions.pod:5524
16428 #: ../src/guestfs-actions.pod:5543 ../fish/guestfish-actions.pod:3672
16429 #: ../fish/guestfish-actions.pod:3687 ../fish/guestfish-actions.pod:3700
16430 msgid ""
16431 "It is an interface to the L<scrub(1)> program.  See that manual page for "
16432 "more details."
16433 msgstr ""
16434
16435 # type: textblock
16436 #. type: textblock
16437 #: ../src/guestfs-actions.pod:5511 ../src/guestfs-actions.pod:5529
16438 #: ../src/guestfs-actions.pod:5548
16439 msgid "(Added in 1.0.52)"
16440 msgstr ""
16441
16442 # type: =head2
16443 #. type: =head2
16444 #: ../src/guestfs-actions.pod:5513
16445 msgid "guestfs_scrub_file"
16446 msgstr ""
16447
16448 # type: verbatim
16449 #. type: verbatim
16450 #: ../src/guestfs-actions.pod:5515
16451 #, no-wrap
16452 msgid ""
16453 " int\n"
16454 " guestfs_scrub_file (guestfs_h *g,\n"
16455 "                     const char *file);\n"
16456 "\n"
16457 msgstr ""
16458
16459 # type: textblock
16460 #. type: textblock
16461 #: ../src/guestfs-actions.pod:5519 ../fish/guestfish-actions.pod:3682
16462 msgid ""
16463 "This command writes patterns over a file to make data retrieval more "
16464 "difficult."
16465 msgstr ""
16466
16467 # type: textblock
16468 #. type: textblock
16469 #: ../src/guestfs-actions.pod:5522 ../fish/guestfish-actions.pod:3685
16470 msgid "The file is I<removed> after scrubbing."
16471 msgstr ""
16472
16473 # type: =head2
16474 #. type: =head2
16475 #: ../src/guestfs-actions.pod:5531
16476 msgid "guestfs_scrub_freespace"
16477 msgstr ""
16478
16479 # type: verbatim
16480 #. type: verbatim
16481 #: ../src/guestfs-actions.pod:5533
16482 #, no-wrap
16483 msgid ""
16484 " int\n"
16485 " guestfs_scrub_freespace (guestfs_h *g,\n"
16486 "                          const char *dir);\n"
16487 "\n"
16488 msgstr ""
16489
16490 # type: textblock
16491 #. type: textblock
16492 #: ../src/guestfs-actions.pod:5537
16493 msgid ""
16494 "This command creates the directory C<dir> and then fills it with files until "
16495 "the filesystem is full, and scrubs the files as for C<guestfs_scrub_file>, "
16496 "and deletes them.  The intention is to scrub any free space on the partition "
16497 "containing C<dir>."
16498 msgstr ""
16499
16500 # type: =head2
16501 #. type: =head2
16502 #: ../src/guestfs-actions.pod:5550
16503 msgid "guestfs_set_append"
16504 msgstr ""
16505
16506 # type: verbatim
16507 #. type: verbatim
16508 #: ../src/guestfs-actions.pod:5552
16509 #, no-wrap
16510 msgid ""
16511 " int\n"
16512 " guestfs_set_append (guestfs_h *g,\n"
16513 "                     const char *append);\n"
16514 "\n"
16515 msgstr ""
16516
16517 # type: textblock
16518 #. type: textblock
16519 #: ../src/guestfs-actions.pod:5556 ../fish/guestfish-actions.pod:3709
16520 msgid ""
16521 "This function is used to add additional options to the guest kernel command "
16522 "line."
16523 msgstr ""
16524
16525 # type: textblock
16526 #. type: textblock
16527 #: ../src/guestfs-actions.pod:5559 ../fish/guestfish-actions.pod:3712
16528 msgid ""
16529 "The default is C<NULL> unless overridden by setting C<LIBGUESTFS_APPEND> "
16530 "environment variable."
16531 msgstr ""
16532
16533 # type: textblock
16534 #. type: textblock
16535 #: ../src/guestfs-actions.pod:5562 ../fish/guestfish-actions.pod:3715
16536 msgid ""
16537 "Setting C<append> to C<NULL> means I<no> additional options are passed "
16538 "(libguestfs always adds a few of its own)."
16539 msgstr ""
16540
16541 # type: =head2
16542 #. type: =head2
16543 #: ../src/guestfs-actions.pod:5569
16544 msgid "guestfs_set_autosync"
16545 msgstr ""
16546
16547 # type: verbatim
16548 #. type: verbatim
16549 #: ../src/guestfs-actions.pod:5571
16550 #, no-wrap
16551 msgid ""
16552 " int\n"
16553 " guestfs_set_autosync (guestfs_h *g,\n"
16554 "                       int autosync);\n"
16555 "\n"
16556 msgstr ""
16557
16558 # type: textblock
16559 #. type: textblock
16560 #: ../src/guestfs-actions.pod:5575
16561 msgid ""
16562 "If C<autosync> is true, this enables autosync.  Libguestfs will make a best "
16563 "effort attempt to run C<guestfs_umount_all> followed by C<guestfs_sync> when "
16564 "the handle is closed (also if the program exits without closing handles)."
16565 msgstr ""
16566
16567 # type: textblock
16568 #. type: textblock
16569 #: ../src/guestfs-actions.pod:5580 ../fish/guestfish-actions.pod:3729
16570 msgid ""
16571 "This is enabled by default (since libguestfs 1.5.24, previously it was "
16572 "disabled by default)."
16573 msgstr ""
16574
16575 # type: =head2
16576 #. type: =head2
16577 #: ../src/guestfs-actions.pod:5587
16578 msgid "guestfs_set_direct"
16579 msgstr ""
16580
16581 # type: verbatim
16582 #. type: verbatim
16583 #: ../src/guestfs-actions.pod:5589
16584 #, no-wrap
16585 msgid ""
16586 " int\n"
16587 " guestfs_set_direct (guestfs_h *g,\n"
16588 "                     int direct);\n"
16589 "\n"
16590 msgstr ""
16591
16592 # type: textblock
16593 #. type: textblock
16594 #: ../src/guestfs-actions.pod:5593 ../fish/guestfish-actions.pod:3738
16595 msgid ""
16596 "If the direct appliance mode flag is enabled, then stdin and stdout are "
16597 "passed directly through to the appliance once it is launched."
16598 msgstr ""
16599
16600 # type: textblock
16601 #. type: textblock
16602 #: ../src/guestfs-actions.pod:5597
16603 msgid ""
16604 "One consequence of this is that log messages aren't caught by the library "
16605 "and handled by C<guestfs_set_log_message_callback>, but go straight to "
16606 "stdout."
16607 msgstr ""
16608
16609 # type: textblock
16610 #. type: textblock
16611 #: ../src/guestfs-actions.pod:5601 ../fish/guestfish-actions.pod:3746
16612 msgid "You probably don't want to use this unless you know what you are doing."
16613 msgstr ""
16614
16615 # type: textblock
16616 #. type: textblock
16617 #: ../src/guestfs-actions.pod:5604 ../fish/guestfish-actions.pod:3749
16618 msgid "The default is disabled."
16619 msgstr ""
16620
16621 # type: =head2
16622 #. type: =head2
16623 #: ../src/guestfs-actions.pod:5610
16624 msgid "guestfs_set_e2label"
16625 msgstr ""
16626
16627 # type: verbatim
16628 #. type: verbatim
16629 #: ../src/guestfs-actions.pod:5612
16630 #, no-wrap
16631 msgid ""
16632 " int\n"
16633 " guestfs_set_e2label (guestfs_h *g,\n"
16634 "                      const char *device,\n"
16635 "                      const char *label);\n"
16636 "\n"
16637 msgstr ""
16638
16639 # type: textblock
16640 #. type: textblock
16641 #: ../src/guestfs-actions.pod:5617 ../fish/guestfish-actions.pod:3755
16642 msgid ""
16643 "This sets the ext2/3/4 filesystem label of the filesystem on C<device> to "
16644 "C<label>.  Filesystem labels are limited to 16 characters."
16645 msgstr ""
16646
16647 # type: textblock
16648 #. type: textblock
16649 #: ../src/guestfs-actions.pod:5621
16650 msgid ""
16651 "You can use either C<guestfs_tune2fs_l> or C<guestfs_get_e2label> to return "
16652 "the existing label on a filesystem."
16653 msgstr ""
16654
16655 # type: =head2
16656 #. type: =head2
16657 #: ../src/guestfs-actions.pod:5628
16658 msgid "guestfs_set_e2uuid"
16659 msgstr ""
16660
16661 # type: verbatim
16662 #. type: verbatim
16663 #: ../src/guestfs-actions.pod:5630
16664 #, no-wrap
16665 msgid ""
16666 " int\n"
16667 " guestfs_set_e2uuid (guestfs_h *g,\n"
16668 "                     const char *device,\n"
16669 "                     const char *uuid);\n"
16670 "\n"
16671 msgstr ""
16672
16673 # type: textblock
16674 #. type: textblock
16675 #: ../src/guestfs-actions.pod:5635 ../fish/guestfish-actions.pod:3766
16676 msgid ""
16677 "This sets the ext2/3/4 filesystem UUID of the filesystem on C<device> to "
16678 "C<uuid>.  The format of the UUID and alternatives such as C<clear>, "
16679 "C<random> and C<time> are described in the L<tune2fs(8)> manpage."
16680 msgstr ""
16681
16682 # type: textblock
16683 #. type: textblock
16684 #: ../src/guestfs-actions.pod:5640
16685 msgid ""
16686 "You can use either C<guestfs_tune2fs_l> or C<guestfs_get_e2uuid> to return "
16687 "the existing UUID of a filesystem."
16688 msgstr ""
16689
16690 # type: =head2
16691 #. type: =head2
16692 #: ../src/guestfs-actions.pod:5647
16693 msgid "guestfs_set_memsize"
16694 msgstr ""
16695
16696 # type: verbatim
16697 #. type: verbatim
16698 #: ../src/guestfs-actions.pod:5649
16699 #, no-wrap
16700 msgid ""
16701 " int\n"
16702 " guestfs_set_memsize (guestfs_h *g,\n"
16703 "                      int memsize);\n"
16704 "\n"
16705 msgstr ""
16706
16707 # type: textblock
16708 #. type: textblock
16709 #: ../src/guestfs-actions.pod:5653
16710 msgid ""
16711 "This sets the memory size in megabytes allocated to the qemu subprocess.  "
16712 "This only has any effect if called before C<guestfs_launch>."
16713 msgstr ""
16714
16715 # type: textblock
16716 #. type: textblock
16717 #: ../src/guestfs-actions.pod:5657 ../fish/guestfish-actions.pod:3784
16718 msgid ""
16719 "You can also change this by setting the environment variable "
16720 "C<LIBGUESTFS_MEMSIZE> before the handle is created."
16721 msgstr ""
16722
16723 # type: =head2
16724 #. type: =head2
16725 #: ../src/guestfs-actions.pod:5668
16726 msgid "guestfs_set_network"
16727 msgstr ""
16728
16729 # type: verbatim
16730 #. type: verbatim
16731 #: ../src/guestfs-actions.pod:5670
16732 #, no-wrap
16733 msgid ""
16734 " int\n"
16735 " guestfs_set_network (guestfs_h *g,\n"
16736 "                      int network);\n"
16737 "\n"
16738 msgstr ""
16739
16740 # type: textblock
16741 #. type: textblock
16742 #: ../src/guestfs-actions.pod:5674 ../fish/guestfish-actions.pod:3797
16743 msgid ""
16744 "If C<network> is true, then the network is enabled in the libguestfs "
16745 "appliance.  The default is false."
16746 msgstr ""
16747
16748 # type: textblock
16749 #. type: textblock
16750 #: ../src/guestfs-actions.pod:5677 ../fish/guestfish-actions.pod:3800
16751 msgid ""
16752 "This affects whether commands are able to access the network (see L<guestfs"
16753 "(3)/RUNNING COMMANDS>)."
16754 msgstr ""
16755
16756 # type: textblock
16757 #. type: textblock
16758 #: ../src/guestfs-actions.pod:5680
16759 msgid ""
16760 "You must call this before calling C<guestfs_launch>, otherwise it has no "
16761 "effect."
16762 msgstr ""
16763
16764 # type: =head2
16765 #. type: =head2
16766 #: ../src/guestfs-actions.pod:5687
16767 msgid "guestfs_set_path"
16768 msgstr ""
16769
16770 # type: verbatim
16771 #. type: verbatim
16772 #: ../src/guestfs-actions.pod:5689
16773 #, no-wrap
16774 msgid ""
16775 " int\n"
16776 " guestfs_set_path (guestfs_h *g,\n"
16777 "                   const char *searchpath);\n"
16778 "\n"
16779 msgstr ""
16780
16781 # type: textblock
16782 #. type: textblock
16783 #: ../src/guestfs-actions.pod:5693 ../fish/guestfish-actions.pod:3812
16784 msgid "Set the path that libguestfs searches for kernel and initrd.img."
16785 msgstr ""
16786
16787 # type: textblock
16788 #. type: textblock
16789 #: ../src/guestfs-actions.pod:5695 ../fish/guestfish-actions.pod:3814
16790 msgid ""
16791 "The default is C<$libdir/guestfs> unless overridden by setting "
16792 "C<LIBGUESTFS_PATH> environment variable."
16793 msgstr ""
16794
16795 # type: textblock
16796 #. type: textblock
16797 #: ../src/guestfs-actions.pod:5698 ../fish/guestfish-actions.pod:3817
16798 msgid "Setting C<path> to C<NULL> restores the default path."
16799 msgstr ""
16800
16801 # type: =head2
16802 #. type: =head2
16803 #: ../src/guestfs-actions.pod:5704
16804 msgid "guestfs_set_qemu"
16805 msgstr ""
16806
16807 # type: verbatim
16808 #. type: verbatim
16809 #: ../src/guestfs-actions.pod:5706
16810 #, no-wrap
16811 msgid ""
16812 " int\n"
16813 " guestfs_set_qemu (guestfs_h *g,\n"
16814 "                   const char *qemu);\n"
16815 "\n"
16816 msgstr ""
16817
16818 # type: textblock
16819 #. type: textblock
16820 #: ../src/guestfs-actions.pod:5710 ../fish/guestfish-actions.pod:3825
16821 msgid "Set the qemu binary that we will use."
16822 msgstr ""
16823
16824 # type: textblock
16825 #. type: textblock
16826 #: ../src/guestfs-actions.pod:5712 ../fish/guestfish-actions.pod:3827
16827 msgid ""
16828 "The default is chosen when the library was compiled by the configure script."
16829 msgstr ""
16830
16831 # type: textblock
16832 #. type: textblock
16833 #: ../src/guestfs-actions.pod:5715 ../fish/guestfish-actions.pod:3830
16834 msgid ""
16835 "You can also override this by setting the C<LIBGUESTFS_QEMU> environment "
16836 "variable."
16837 msgstr ""
16838
16839 # type: textblock
16840 #. type: textblock
16841 #: ../src/guestfs-actions.pod:5718 ../fish/guestfish-actions.pod:3833
16842 msgid "Setting C<qemu> to C<NULL> restores the default qemu binary."
16843 msgstr ""
16844
16845 # type: textblock
16846 #. type: textblock
16847 #: ../src/guestfs-actions.pod:5720 ../fish/guestfish-actions.pod:3835
16848 msgid ""
16849 "Note that you should call this function as early as possible after creating "
16850 "the handle.  This is because some pre-launch operations depend on testing "
16851 "qemu features (by running C<qemu -help>).  If the qemu binary changes, we "
16852 "don't retest features, and so you might see inconsistent results.  Using the "
16853 "environment variable C<LIBGUESTFS_QEMU> is safest of all since that picks "
16854 "the qemu binary at the same time as the handle is created."
16855 msgstr ""
16856
16857 # type: =head2
16858 #. type: =head2
16859 #: ../src/guestfs-actions.pod:5732
16860 msgid "guestfs_set_recovery_proc"
16861 msgstr ""
16862
16863 # type: verbatim
16864 #. type: verbatim
16865 #: ../src/guestfs-actions.pod:5734
16866 #, no-wrap
16867 msgid ""
16868 " int\n"
16869 " guestfs_set_recovery_proc (guestfs_h *g,\n"
16870 "                            int recoveryproc);\n"
16871 "\n"
16872 msgstr ""
16873
16874 # type: textblock
16875 #. type: textblock
16876 #: ../src/guestfs-actions.pod:5738
16877 msgid ""
16878 "If this is called with the parameter C<false> then C<guestfs_launch> does "
16879 "not create a recovery process.  The purpose of the recovery process is to "
16880 "stop runaway qemu processes in the case where the main program aborts "
16881 "abruptly."
16882 msgstr ""
16883
16884 # type: textblock
16885 #. type: textblock
16886 #: ../src/guestfs-actions.pod:5743
16887 msgid ""
16888 "This only has any effect if called before C<guestfs_launch>, and the default "
16889 "is true."
16890 msgstr ""
16891
16892 # type: textblock
16893 #. type: textblock
16894 #: ../src/guestfs-actions.pod:5746 ../fish/guestfish-actions.pod:3857
16895 msgid ""
16896 "About the only time when you would want to disable this is if the main "
16897 "process will fork itself into the background (\"daemonize\" itself).  In "
16898 "this case the recovery process thinks that the main program has disappeared "
16899 "and so kills qemu, which is not very helpful."
16900 msgstr ""
16901
16902 # type: =head2
16903 #. type: =head2
16904 #: ../src/guestfs-actions.pod:5756
16905 msgid "guestfs_set_selinux"
16906 msgstr ""
16907
16908 # type: verbatim
16909 #. type: verbatim
16910 #: ../src/guestfs-actions.pod:5758
16911 #, no-wrap
16912 msgid ""
16913 " int\n"
16914 " guestfs_set_selinux (guestfs_h *g,\n"
16915 "                      int selinux);\n"
16916 "\n"
16917 msgstr ""
16918
16919 # type: textblock
16920 #. type: textblock
16921 #: ../src/guestfs-actions.pod:5762 ../fish/guestfish-actions.pod:3869
16922 msgid ""
16923 "This sets the selinux flag that is passed to the appliance at boot time.  "
16924 "The default is C<selinux=0> (disabled)."
16925 msgstr ""
16926
16927 # type: textblock
16928 #. type: textblock
16929 #: ../src/guestfs-actions.pod:5765 ../fish/guestfish-actions.pod:3872
16930 msgid ""
16931 "Note that if SELinux is enabled, it is always in Permissive mode "
16932 "(C<enforcing=0>)."
16933 msgstr ""
16934
16935 # type: =head2
16936 #. type: =head2
16937 #: ../src/guestfs-actions.pod:5775
16938 msgid "guestfs_set_trace"
16939 msgstr ""
16940
16941 # type: verbatim
16942 #. type: verbatim
16943 #: ../src/guestfs-actions.pod:5777
16944 #, no-wrap
16945 msgid ""
16946 " int\n"
16947 " guestfs_set_trace (guestfs_h *g,\n"
16948 "                    int trace);\n"
16949 "\n"
16950 msgstr ""
16951
16952 # type: textblock
16953 #. type: textblock
16954 #: ../src/guestfs-actions.pod:5781 ../fish/guestfish-actions.pod:3884
16955 msgid ""
16956 "If the command trace flag is set to 1, then commands are printed on stderr "
16957 "before they are executed in a format which is very similar to the one used "
16958 "by guestfish.  In other words, you can run a program with this enabled, and "
16959 "you will get out a script which you can feed to guestfish to perform the "
16960 "same set of actions."
16961 msgstr ""
16962
16963 # type: textblock
16964 #. type: textblock
16965 #: ../src/guestfs-actions.pod:5788 ../fish/guestfish-actions.pod:3891
16966 msgid ""
16967 "If you want to trace C API calls into libguestfs (and other libraries) then "
16968 "possibly a better way is to use the external ltrace(1) command."
16969 msgstr ""
16970
16971 # type: textblock
16972 #. type: textblock
16973 #: ../src/guestfs-actions.pod:5792 ../fish/guestfish-actions.pod:3895
16974 msgid ""
16975 "Command traces are disabled unless the environment variable "
16976 "C<LIBGUESTFS_TRACE> is defined and set to C<1>."
16977 msgstr ""
16978
16979 # type: =head2
16980 #. type: =head2
16981 #: ../src/guestfs-actions.pod:5799
16982 msgid "guestfs_set_verbose"
16983 msgstr ""
16984
16985 # type: verbatim
16986 #. type: verbatim
16987 #: ../src/guestfs-actions.pod:5801
16988 #, no-wrap
16989 msgid ""
16990 " int\n"
16991 " guestfs_set_verbose (guestfs_h *g,\n"
16992 "                      int verbose);\n"
16993 "\n"
16994 msgstr ""
16995
16996 # type: textblock
16997 #. type: textblock
16998 #: ../src/guestfs-actions.pod:5805 ../fish/guestfish-actions.pod:3904
16999 msgid "If C<verbose> is true, this turns on verbose messages (to C<stderr>)."
17000 msgstr ""
17001
17002 # type: textblock
17003 #. type: textblock
17004 #: ../src/guestfs-actions.pod:5807 ../fish/guestfish-actions.pod:3906
17005 msgid ""
17006 "Verbose messages are disabled unless the environment variable "
17007 "C<LIBGUESTFS_DEBUG> is defined and set to C<1>."
17008 msgstr ""
17009
17010 # type: =head2
17011 #. type: =head2
17012 #: ../src/guestfs-actions.pod:5814
17013 msgid "guestfs_setcon"
17014 msgstr ""
17015
17016 # type: verbatim
17017 #. type: verbatim
17018 #: ../src/guestfs-actions.pod:5816
17019 #, no-wrap
17020 msgid ""
17021 " int\n"
17022 " guestfs_setcon (guestfs_h *g,\n"
17023 "                 const char *context);\n"
17024 "\n"
17025 msgstr ""
17026
17027 # type: textblock
17028 #. type: textblock
17029 #: ../src/guestfs-actions.pod:5820 ../fish/guestfish-actions.pod:3913
17030 msgid ""
17031 "This sets the SELinux security context of the daemon to the string "
17032 "C<context>."
17033 msgstr ""
17034
17035 # type: textblock
17036 #. type: textblock
17037 #: ../src/guestfs-actions.pod:5823 ../fish/guestfish-actions.pod:3916
17038 msgid "See the documentation about SELINUX in L<guestfs(3)>."
17039 msgstr ""
17040
17041 # type: =head2
17042 #. type: =head2
17043 #: ../src/guestfs-actions.pod:5829
17044 msgid "guestfs_setxattr"
17045 msgstr ""
17046
17047 # type: verbatim
17048 #. type: verbatim
17049 #: ../src/guestfs-actions.pod:5831
17050 #, no-wrap
17051 msgid ""
17052 " int\n"
17053 " guestfs_setxattr (guestfs_h *g,\n"
17054 "                   const char *xattr,\n"
17055 "                   const char *val,\n"
17056 "                   int vallen,\n"
17057 "                   const char *path);\n"
17058 "\n"
17059 msgstr ""
17060
17061 # type: textblock
17062 #. type: textblock
17063 #: ../src/guestfs-actions.pod:5838 ../fish/guestfish-actions.pod:3922
17064 msgid ""
17065 "This call sets the extended attribute named C<xattr> of the file C<path> to "
17066 "the value C<val> (of length C<vallen>).  The value is arbitrary 8 bit data."
17067 msgstr ""
17068
17069 # type: textblock
17070 #. type: textblock
17071 #: ../src/guestfs-actions.pod:5842
17072 msgid "See also: C<guestfs_lsetxattr>, L<attr(5)>."
17073 msgstr ""
17074
17075 # type: =head2
17076 #. type: =head2
17077 #: ../src/guestfs-actions.pod:5848
17078 msgid "guestfs_sfdisk"
17079 msgstr ""
17080
17081 # type: verbatim
17082 #. type: verbatim
17083 #: ../src/guestfs-actions.pod:5850
17084 #, no-wrap
17085 msgid ""
17086 " int\n"
17087 " guestfs_sfdisk (guestfs_h *g,\n"
17088 "                 const char *device,\n"
17089 "                 int cyls,\n"
17090 "                 int heads,\n"
17091 "                 int sectors,\n"
17092 "                 char *const *lines);\n"
17093 "\n"
17094 msgstr ""
17095
17096 # type: textblock
17097 #. type: textblock
17098 #: ../src/guestfs-actions.pod:5858 ../fish/guestfish-actions.pod:3932
17099 msgid ""
17100 "This is a direct interface to the L<sfdisk(8)> program for creating "
17101 "partitions on block devices."
17102 msgstr ""
17103
17104 # type: textblock
17105 #. type: textblock
17106 #: ../src/guestfs-actions.pod:5861 ../fish/guestfish-actions.pod:3935
17107 msgid "C<device> should be a block device, for example C</dev/sda>."
17108 msgstr ""
17109
17110 # type: textblock
17111 #. type: textblock
17112 #: ../src/guestfs-actions.pod:5863 ../fish/guestfish-actions.pod:3937
17113 msgid ""
17114 "C<cyls>, C<heads> and C<sectors> are the number of cylinders, heads and "
17115 "sectors on the device, which are passed directly to sfdisk as the I<-C>, I<-"
17116 "H> and I<-S> parameters.  If you pass C<0> for any of these, then the "
17117 "corresponding parameter is omitted.  Usually for 'large' disks, you can just "
17118 "pass C<0> for these, but for small (floppy-sized) disks, sfdisk (or rather, "
17119 "the kernel) cannot work out the right geometry and you will need to tell it."
17120 msgstr ""
17121
17122 # type: textblock
17123 #. type: textblock
17124 #: ../src/guestfs-actions.pod:5871 ../fish/guestfish-actions.pod:3945
17125 msgid ""
17126 "C<lines> is a list of lines that we feed to C<sfdisk>.  For more information "
17127 "refer to the L<sfdisk(8)> manpage."
17128 msgstr ""
17129
17130 # type: textblock
17131 #. type: textblock
17132 #: ../src/guestfs-actions.pod:5874 ../fish/guestfish-actions.pod:3948
17133 msgid ""
17134 "To create a single partition occupying the whole disk, you would pass "
17135 "C<lines> as a single element list, when the single element being the string "
17136 "C<,> (comma)."
17137 msgstr ""
17138
17139 # type: textblock
17140 #. type: textblock
17141 #: ../src/guestfs-actions.pod:5878
17142 msgid ""
17143 "See also: C<guestfs_sfdisk_l>, C<guestfs_sfdisk_N>, C<guestfs_part_init>"
17144 msgstr ""
17145
17146 # type: =head2
17147 #. type: =head2
17148 #: ../src/guestfs-actions.pod:5888
17149 msgid "guestfs_sfdiskM"
17150 msgstr ""
17151
17152 # type: verbatim
17153 #. type: verbatim
17154 #: ../src/guestfs-actions.pod:5890
17155 #, no-wrap
17156 msgid ""
17157 " int\n"
17158 " guestfs_sfdiskM (guestfs_h *g,\n"
17159 "                  const char *device,\n"
17160 "                  char *const *lines);\n"
17161 "\n"
17162 msgstr ""
17163
17164 # type: textblock
17165 #. type: textblock
17166 #: ../src/guestfs-actions.pod:5895
17167 msgid ""
17168 "This is a simplified interface to the C<guestfs_sfdisk> command, where "
17169 "partition sizes are specified in megabytes only (rounded to the nearest "
17170 "cylinder) and you don't need to specify the cyls, heads and sectors "
17171 "parameters which were rarely if ever used anyway."
17172 msgstr ""
17173
17174 # type: textblock
17175 #. type: textblock
17176 #: ../src/guestfs-actions.pod:5901
17177 msgid ""
17178 "See also: C<guestfs_sfdisk>, the L<sfdisk(8)> manpage and "
17179 "C<guestfs_part_disk>"
17180 msgstr ""
17181
17182 # type: =head2
17183 #. type: =head2
17184 #: ../src/guestfs-actions.pod:5911
17185 msgid "guestfs_sfdisk_N"
17186 msgstr ""
17187
17188 # type: verbatim
17189 #. type: verbatim
17190 #: ../src/guestfs-actions.pod:5913
17191 #, no-wrap
17192 msgid ""
17193 " int\n"
17194 " guestfs_sfdisk_N (guestfs_h *g,\n"
17195 "                   const char *device,\n"
17196 "                   int partnum,\n"
17197 "                   int cyls,\n"
17198 "                   int heads,\n"
17199 "                   int sectors,\n"
17200 "                   const char *line);\n"
17201 "\n"
17202 msgstr ""
17203
17204 # type: textblock
17205 #. type: textblock
17206 #: ../src/guestfs-actions.pod:5922 ../fish/guestfish-actions.pod:3978
17207 msgid ""
17208 "This runs L<sfdisk(8)> option to modify just the single partition C<n> "
17209 "(note: C<n> counts from 1)."
17210 msgstr ""
17211
17212 # type: textblock
17213 #. type: textblock
17214 #: ../src/guestfs-actions.pod:5925
17215 msgid ""
17216 "For other parameters, see C<guestfs_sfdisk>.  You should usually pass C<0> "
17217 "for the cyls/heads/sectors parameters."
17218 msgstr ""
17219
17220 # type: textblock
17221 #. type: textblock
17222 #: ../src/guestfs-actions.pod:5928
17223 msgid "See also: C<guestfs_part_add>"
17224 msgstr ""
17225
17226 # type: =head2
17227 #. type: =head2
17228 #: ../src/guestfs-actions.pod:5937
17229 msgid "guestfs_sfdisk_disk_geometry"
17230 msgstr ""
17231
17232 # type: verbatim
17233 #. type: verbatim
17234 #: ../src/guestfs-actions.pod:5939
17235 #, no-wrap
17236 msgid ""
17237 " char *\n"
17238 " guestfs_sfdisk_disk_geometry (guestfs_h *g,\n"
17239 "                               const char *device);\n"
17240 "\n"
17241 msgstr ""
17242
17243 # type: textblock
17244 #. type: textblock
17245 #: ../src/guestfs-actions.pod:5943
17246 msgid ""
17247 "This displays the disk geometry of C<device> read from the partition table.  "
17248 "Especially in the case where the underlying block device has been resized, "
17249 "this can be different from the kernel's idea of the geometry (see "
17250 "C<guestfs_sfdisk_kernel_geometry>)."
17251 msgstr ""
17252
17253 # type: textblock
17254 #. type: textblock
17255 #: ../src/guestfs-actions.pod:5948 ../src/guestfs-actions.pod:5964
17256 #: ../fish/guestfish-actions.pod:3998 ../fish/guestfish-actions.pod:4007
17257 msgid "The result is in human-readable format, and not designed to be parsed."
17258 msgstr ""
17259
17260 # type: =head2
17261 #. type: =head2
17262 #: ../src/guestfs-actions.pod:5956
17263 msgid "guestfs_sfdisk_kernel_geometry"
17264 msgstr ""
17265
17266 # type: verbatim
17267 #. type: verbatim
17268 #: ../src/guestfs-actions.pod:5958
17269 #, no-wrap
17270 msgid ""
17271 " char *\n"
17272 " guestfs_sfdisk_kernel_geometry (guestfs_h *g,\n"
17273 "                                 const char *device);\n"
17274 "\n"
17275 msgstr ""
17276
17277 # type: textblock
17278 #. type: textblock
17279 #: ../src/guestfs-actions.pod:5962 ../fish/guestfish-actions.pod:4005
17280 msgid "This displays the kernel's idea of the geometry of C<device>."
17281 msgstr ""
17282
17283 # type: =head2
17284 #. type: =head2
17285 #: ../src/guestfs-actions.pod:5972
17286 msgid "guestfs_sfdisk_l"
17287 msgstr ""
17288
17289 # type: verbatim
17290 #. type: verbatim
17291 #: ../src/guestfs-actions.pod:5974
17292 #, no-wrap
17293 msgid ""
17294 " char *\n"
17295 " guestfs_sfdisk_l (guestfs_h *g,\n"
17296 "                   const char *device);\n"
17297 "\n"
17298 msgstr ""
17299
17300 # type: textblock
17301 #. type: textblock
17302 #: ../src/guestfs-actions.pod:5978 ../fish/guestfish-actions.pod:4014
17303 msgid ""
17304 "This displays the partition table on C<device>, in the human-readable output "
17305 "of the L<sfdisk(8)> command.  It is not intended to be parsed."
17306 msgstr ""
17307
17308 # type: textblock
17309 #. type: textblock
17310 #: ../src/guestfs-actions.pod:5982
17311 msgid "See also: C<guestfs_part_list>"
17312 msgstr ""
17313
17314 # type: =head2
17315 #. type: =head2
17316 #: ../src/guestfs-actions.pod:5989
17317 msgid "guestfs_sh"
17318 msgstr ""
17319
17320 # type: verbatim
17321 #. type: verbatim
17322 #: ../src/guestfs-actions.pod:5991
17323 #, no-wrap
17324 msgid ""
17325 " char *\n"
17326 " guestfs_sh (guestfs_h *g,\n"
17327 "             const char *command);\n"
17328 "\n"
17329 msgstr ""
17330
17331 # type: textblock
17332 #. type: textblock
17333 #: ../src/guestfs-actions.pod:5995 ../fish/guestfish-actions.pod:4024
17334 msgid ""
17335 "This call runs a command from the guest filesystem via the guest's C</bin/"
17336 "sh>."
17337 msgstr ""
17338
17339 # type: textblock
17340 #. type: textblock
17341 #: ../src/guestfs-actions.pod:5998
17342 msgid "This is like C<guestfs_command>, but passes the command to:"
17343 msgstr ""
17344
17345 # type: verbatim
17346 #. type: verbatim
17347 #: ../src/guestfs-actions.pod:6000 ../fish/guestfish-actions.pod:4029
17348 #, no-wrap
17349 msgid ""
17350 " /bin/sh -c \"command\"\n"
17351 "\n"
17352 msgstr ""
17353
17354 # type: textblock
17355 #. type: textblock
17356 #: ../src/guestfs-actions.pod:6002 ../fish/guestfish-actions.pod:4031
17357 msgid ""
17358 "Depending on the guest's shell, this usually results in wildcards being "
17359 "expanded, shell expressions being interpolated and so on."
17360 msgstr ""
17361
17362 # type: textblock
17363 #. type: textblock
17364 #: ../src/guestfs-actions.pod:6006
17365 msgid "All the provisos about C<guestfs_command> apply to this call."
17366 msgstr ""
17367
17368 # type: =head2
17369 #. type: =head2
17370 #: ../src/guestfs-actions.pod:6013
17371 msgid "guestfs_sh_lines"
17372 msgstr ""
17373
17374 # type: verbatim
17375 #. type: verbatim
17376 #: ../src/guestfs-actions.pod:6015
17377 #, no-wrap
17378 msgid ""
17379 " char **\n"
17380 " guestfs_sh_lines (guestfs_h *g,\n"
17381 "                   const char *command);\n"
17382 "\n"
17383 msgstr ""
17384
17385 # type: textblock
17386 #. type: textblock
17387 #: ../src/guestfs-actions.pod:6019
17388 msgid ""
17389 "This is the same as C<guestfs_sh>, but splits the result into a list of "
17390 "lines."
17391 msgstr ""
17392
17393 # type: textblock
17394 #. type: textblock
17395 #: ../src/guestfs-actions.pod:6022
17396 msgid "See also: C<guestfs_command_lines>"
17397 msgstr ""
17398
17399 # type: =head2
17400 #. type: =head2
17401 #: ../src/guestfs-actions.pod:6030
17402 msgid "guestfs_sleep"
17403 msgstr ""
17404
17405 # type: verbatim
17406 #. type: verbatim
17407 #: ../src/guestfs-actions.pod:6032
17408 #, no-wrap
17409 msgid ""
17410 " int\n"
17411 " guestfs_sleep (guestfs_h *g,\n"
17412 "                int secs);\n"
17413 "\n"
17414 msgstr ""
17415
17416 # type: textblock
17417 #. type: textblock
17418 #: ../src/guestfs-actions.pod:6036 ../fish/guestfish-actions.pod:4050
17419 msgid "Sleep for C<secs> seconds."
17420 msgstr ""
17421
17422 # type: textblock
17423 #. type: textblock
17424 #: ../src/guestfs-actions.pod:6040
17425 msgid "(Added in 1.0.41)"
17426 msgstr ""
17427
17428 # type: =head2
17429 #. type: =head2
17430 #: ../src/guestfs-actions.pod:6042 ../src/guestfs-structs.pod:109
17431 msgid "guestfs_stat"
17432 msgstr ""
17433
17434 # type: verbatim
17435 #. type: verbatim
17436 #: ../src/guestfs-actions.pod:6044
17437 #, no-wrap
17438 msgid ""
17439 " struct guestfs_stat *\n"
17440 " guestfs_stat (guestfs_h *g,\n"
17441 "               const char *path);\n"
17442 "\n"
17443 msgstr ""
17444
17445 # type: textblock
17446 #. type: textblock
17447 #: ../src/guestfs-actions.pod:6050 ../fish/guestfish-actions.pod:4058
17448 msgid "This is the same as the C<stat(2)> system call."
17449 msgstr ""
17450
17451 # type: =head2
17452 #. type: =head2
17453 #: ../src/guestfs-actions.pod:6058 ../src/guestfs-structs.pod:135
17454 msgid "guestfs_statvfs"
17455 msgstr ""
17456
17457 # type: verbatim
17458 #. type: verbatim
17459 #: ../src/guestfs-actions.pod:6060
17460 #, no-wrap
17461 msgid ""
17462 " struct guestfs_statvfs *\n"
17463 " guestfs_statvfs (guestfs_h *g,\n"
17464 "                  const char *path);\n"
17465 "\n"
17466 msgstr ""
17467
17468 # type: textblock
17469 #. type: textblock
17470 #: ../src/guestfs-actions.pod:6064 ../fish/guestfish-actions.pod:4064
17471 msgid ""
17472 "Returns file system statistics for any mounted file system.  C<path> should "
17473 "be a file or directory in the mounted file system (typically it is the mount "
17474 "point itself, but it doesn't need to be)."
17475 msgstr ""
17476
17477 # type: textblock
17478 #. type: textblock
17479 #: ../src/guestfs-actions.pod:6068 ../fish/guestfish-actions.pod:4068
17480 msgid "This is the same as the C<statvfs(2)> system call."
17481 msgstr ""
17482
17483 # type: textblock
17484 #. type: textblock
17485 #: ../src/guestfs-actions.pod:6070
17486 msgid ""
17487 "This function returns a C<struct guestfs_statvfs *>, or NULL if there was an "
17488 "error.  I<The caller must call C<guestfs_free_statvfs> after use>."
17489 msgstr ""
17490
17491 # type: =head2
17492 #. type: =head2
17493 #: ../src/guestfs-actions.pod:6076
17494 msgid "guestfs_strings"
17495 msgstr ""
17496
17497 # type: verbatim
17498 #. type: verbatim
17499 #: ../src/guestfs-actions.pod:6078
17500 #, no-wrap
17501 msgid ""
17502 " char **\n"
17503 " guestfs_strings (guestfs_h *g,\n"
17504 "                  const char *path);\n"
17505 "\n"
17506 msgstr ""
17507
17508 # type: textblock
17509 #. type: textblock
17510 #: ../src/guestfs-actions.pod:6082 ../fish/guestfish-actions.pod:4074
17511 msgid ""
17512 "This runs the L<strings(1)> command on a file and returns the list of "
17513 "printable strings found."
17514 msgstr ""
17515
17516 # type: =head2
17517 #. type: =head2
17518 #: ../src/guestfs-actions.pod:6094
17519 msgid "guestfs_strings_e"
17520 msgstr ""
17521
17522 # type: verbatim
17523 #. type: verbatim
17524 #: ../src/guestfs-actions.pod:6096
17525 #, no-wrap
17526 msgid ""
17527 " char **\n"
17528 " guestfs_strings_e (guestfs_h *g,\n"
17529 "                    const char *encoding,\n"
17530 "                    const char *path);\n"
17531 "\n"
17532 msgstr ""
17533
17534 # type: textblock
17535 #. type: textblock
17536 #: ../src/guestfs-actions.pod:6101
17537 msgid ""
17538 "This is like the C<guestfs_strings> command, but allows you to specify the "
17539 "encoding of strings that are looked for in the source file C<path>."
17540 msgstr ""
17541
17542 # type: textblock
17543 #. type: textblock
17544 #: ../src/guestfs-actions.pod:6105 ../fish/guestfish-actions.pod:4088
17545 msgid "Allowed encodings are:"
17546 msgstr ""
17547
17548 # type: =item
17549 #. type: =item
17550 #: ../src/guestfs-actions.pod:6109 ../fish/guestfish-actions.pod:4092
17551 msgid "s"
17552 msgstr ""
17553
17554 # type: textblock
17555 #. type: textblock
17556 #: ../src/guestfs-actions.pod:6111
17557 msgid ""
17558 "Single 7-bit-byte characters like ASCII and the ASCII-compatible parts of "
17559 "ISO-8859-X (this is what C<guestfs_strings> uses)."
17560 msgstr ""
17561
17562 # type: =item
17563 #. type: =item
17564 #: ../src/guestfs-actions.pod:6114 ../fish/guestfish-actions.pod:4097
17565 msgid "S"
17566 msgstr ""
17567
17568 # type: textblock
17569 #. type: textblock
17570 #: ../src/guestfs-actions.pod:6116 ../fish/guestfish-actions.pod:4099
17571 msgid "Single 8-bit-byte characters."
17572 msgstr ""
17573
17574 # type: =item
17575 #. type: =item
17576 #: ../src/guestfs-actions.pod:6118 ../fish/guestfish-actions.pod:4101
17577 msgid "b"
17578 msgstr ""
17579
17580 # type: textblock
17581 #. type: textblock
17582 #: ../src/guestfs-actions.pod:6120 ../fish/guestfish-actions.pod:4103
17583 msgid "16-bit big endian strings such as those encoded in UTF-16BE or UCS-2BE."
17584 msgstr ""
17585
17586 # type: =item
17587 #. type: =item
17588 #: ../src/guestfs-actions.pod:6123 ../fish/guestfish-actions.pod:4106
17589 msgid "l (lower case letter L)"
17590 msgstr ""
17591
17592 # type: textblock
17593 #. type: textblock
17594 #: ../src/guestfs-actions.pod:6125 ../fish/guestfish-actions.pod:4108
17595 msgid ""
17596 "16-bit little endian such as UTF-16LE and UCS-2LE.  This is useful for "
17597 "examining binaries in Windows guests."
17598 msgstr ""
17599
17600 # type: =item
17601 #. type: =item
17602 #: ../src/guestfs-actions.pod:6128 ../fish/guestfish-actions.pod:4111
17603 msgid "B"
17604 msgstr ""
17605
17606 # type: textblock
17607 #. type: textblock
17608 #: ../src/guestfs-actions.pod:6130 ../fish/guestfish-actions.pod:4113
17609 msgid "32-bit big endian such as UCS-4BE."
17610 msgstr ""
17611
17612 # type: =item
17613 #. type: =item
17614 #: ../src/guestfs-actions.pod:6132 ../fish/guestfish-actions.pod:4115
17615 msgid "L"
17616 msgstr ""
17617
17618 # type: textblock
17619 #. type: textblock
17620 #: ../src/guestfs-actions.pod:6134 ../fish/guestfish-actions.pod:4117
17621 msgid "32-bit little endian such as UCS-4LE."
17622 msgstr ""
17623
17624 # type: textblock
17625 #. type: textblock
17626 #: ../src/guestfs-actions.pod:6138 ../fish/guestfish-actions.pod:4121
17627 msgid "The returned strings are transcoded to UTF-8."
17628 msgstr ""
17629
17630 # type: =head2
17631 #. type: =head2
17632 #: ../src/guestfs-actions.pod:6149
17633 msgid "guestfs_swapoff_device"
17634 msgstr ""
17635
17636 # type: verbatim
17637 #. type: verbatim
17638 #: ../src/guestfs-actions.pod:6151
17639 #, no-wrap
17640 msgid ""
17641 " int\n"
17642 " guestfs_swapoff_device (guestfs_h *g,\n"
17643 "                         const char *device);\n"
17644 "\n"
17645 msgstr ""
17646
17647 # type: textblock
17648 #. type: textblock
17649 #: ../src/guestfs-actions.pod:6155
17650 msgid ""
17651 "This command disables the libguestfs appliance swap device or partition "
17652 "named C<device>.  See C<guestfs_swapon_device>."
17653 msgstr ""
17654
17655 # type: =head2
17656 #. type: =head2
17657 #: ../src/guestfs-actions.pod:6163
17658 msgid "guestfs_swapoff_file"
17659 msgstr ""
17660
17661 # type: verbatim
17662 #. type: verbatim
17663 #: ../src/guestfs-actions.pod:6165
17664 #, no-wrap
17665 msgid ""
17666 " int\n"
17667 " guestfs_swapoff_file (guestfs_h *g,\n"
17668 "                       const char *file);\n"
17669 "\n"
17670 msgstr ""
17671
17672 # type: textblock
17673 #. type: textblock
17674 #: ../src/guestfs-actions.pod:6169 ../fish/guestfish-actions.pod:4138
17675 msgid "This command disables the libguestfs appliance swap on file."
17676 msgstr ""
17677
17678 # type: =head2
17679 #. type: =head2
17680 #: ../src/guestfs-actions.pod:6175
17681 msgid "guestfs_swapoff_label"
17682 msgstr ""
17683
17684 # type: verbatim
17685 #. type: verbatim
17686 #: ../src/guestfs-actions.pod:6177
17687 #, no-wrap
17688 msgid ""
17689 " int\n"
17690 " guestfs_swapoff_label (guestfs_h *g,\n"
17691 "                        const char *label);\n"
17692 "\n"
17693 msgstr ""
17694
17695 # type: textblock
17696 #. type: textblock
17697 #: ../src/guestfs-actions.pod:6181 ../fish/guestfish-actions.pod:4144
17698 msgid ""
17699 "This command disables the libguestfs appliance swap on labeled swap "
17700 "partition."
17701 msgstr ""
17702
17703 # type: =head2
17704 #. type: =head2
17705 #: ../src/guestfs-actions.pod:6188
17706 msgid "guestfs_swapoff_uuid"
17707 msgstr ""
17708
17709 # type: verbatim
17710 #. type: verbatim
17711 #: ../src/guestfs-actions.pod:6190
17712 #, no-wrap
17713 msgid ""
17714 " int\n"
17715 " guestfs_swapoff_uuid (guestfs_h *g,\n"
17716 "                       const char *uuid);\n"
17717 "\n"
17718 msgstr ""
17719
17720 # type: textblock
17721 #. type: textblock
17722 #: ../src/guestfs-actions.pod:6194 ../fish/guestfish-actions.pod:4151
17723 msgid ""
17724 "This command disables the libguestfs appliance swap partition with the given "
17725 "UUID."
17726 msgstr ""
17727
17728 # type: =head2
17729 #. type: =head2
17730 #: ../src/guestfs-actions.pod:6201
17731 msgid "guestfs_swapon_device"
17732 msgstr ""
17733
17734 # type: verbatim
17735 #. type: verbatim
17736 #: ../src/guestfs-actions.pod:6203
17737 #, no-wrap
17738 msgid ""
17739 " int\n"
17740 " guestfs_swapon_device (guestfs_h *g,\n"
17741 "                        const char *device);\n"
17742 "\n"
17743 msgstr ""
17744
17745 # type: textblock
17746 #. type: textblock
17747 #: ../src/guestfs-actions.pod:6207
17748 msgid ""
17749 "This command enables the libguestfs appliance to use the swap device or "
17750 "partition named C<device>.  The increased memory is made available for all "
17751 "commands, for example those run using C<guestfs_command> or C<guestfs_sh>."
17752 msgstr ""
17753
17754 # type: textblock
17755 #. type: textblock
17756 #: ../src/guestfs-actions.pod:6212 ../fish/guestfish-actions.pod:4163
17757 msgid ""
17758 "Note that you should not swap to existing guest swap partitions unless you "
17759 "know what you are doing.  They may contain hibernation information, or other "
17760 "information that the guest doesn't want you to trash.  You also risk leaking "
17761 "information about the host to the guest this way.  Instead, attach a new "
17762 "host device to the guest and swap on that."
17763 msgstr ""
17764
17765 # type: =head2
17766 #. type: =head2
17767 #: ../src/guestfs-actions.pod:6223
17768 msgid "guestfs_swapon_file"
17769 msgstr ""
17770
17771 # type: verbatim
17772 #. type: verbatim
17773 #: ../src/guestfs-actions.pod:6225
17774 #, no-wrap
17775 msgid ""
17776 " int\n"
17777 " guestfs_swapon_file (guestfs_h *g,\n"
17778 "                      const char *file);\n"
17779 "\n"
17780 msgstr ""
17781
17782 # type: textblock
17783 #. type: textblock
17784 #: ../src/guestfs-actions.pod:6229
17785 msgid ""
17786 "This command enables swap to a file.  See C<guestfs_swapon_device> for other "
17787 "notes."
17788 msgstr ""
17789
17790 # type: =head2
17791 #. type: =head2
17792 #: ../src/guestfs-actions.pod:6236
17793 msgid "guestfs_swapon_label"
17794 msgstr ""
17795
17796 # type: verbatim
17797 #. type: verbatim
17798 #: ../src/guestfs-actions.pod:6238
17799 #, no-wrap
17800 msgid ""
17801 " int\n"
17802 " guestfs_swapon_label (guestfs_h *g,\n"
17803 "                       const char *label);\n"
17804 "\n"
17805 msgstr ""
17806
17807 # type: textblock
17808 #. type: textblock
17809 #: ../src/guestfs-actions.pod:6242
17810 msgid ""
17811 "This command enables swap to a labeled swap partition.  See "
17812 "C<guestfs_swapon_device> for other notes."
17813 msgstr ""
17814
17815 # type: =head2
17816 #. type: =head2
17817 #: ../src/guestfs-actions.pod:6249
17818 msgid "guestfs_swapon_uuid"
17819 msgstr ""
17820
17821 # type: verbatim
17822 #. type: verbatim
17823 #: ../src/guestfs-actions.pod:6251
17824 #, no-wrap
17825 msgid ""
17826 " int\n"
17827 " guestfs_swapon_uuid (guestfs_h *g,\n"
17828 "                      const char *uuid);\n"
17829 "\n"
17830 msgstr ""
17831
17832 # type: textblock
17833 #. type: textblock
17834 #: ../src/guestfs-actions.pod:6255
17835 msgid ""
17836 "This command enables swap to a swap partition with the given UUID.  See "
17837 "C<guestfs_swapon_device> for other notes."
17838 msgstr ""
17839
17840 # type: =head2
17841 #. type: =head2
17842 #: ../src/guestfs-actions.pod:6262
17843 msgid "guestfs_sync"
17844 msgstr ""
17845
17846 # type: verbatim
17847 #. type: verbatim
17848 #: ../src/guestfs-actions.pod:6264
17849 #, no-wrap
17850 msgid ""
17851 " int\n"
17852 " guestfs_sync (guestfs_h *g);\n"
17853 "\n"
17854 msgstr ""
17855
17856 # type: textblock
17857 #. type: textblock
17858 #: ../src/guestfs-actions.pod:6267 ../fish/guestfish-actions.pod:4195
17859 msgid ""
17860 "This syncs the disk, so that any writes are flushed through to the "
17861 "underlying disk image."
17862 msgstr ""
17863
17864 # type: textblock
17865 #. type: textblock
17866 #: ../src/guestfs-actions.pod:6270 ../fish/guestfish-actions.pod:4198
17867 msgid ""
17868 "You should always call this if you have modified a disk image, before "
17869 "closing the handle."
17870 msgstr ""
17871
17872 # type: =head2
17873 #. type: =head2
17874 #: ../src/guestfs-actions.pod:6277
17875 msgid "guestfs_tail"
17876 msgstr ""
17877
17878 # type: verbatim
17879 #. type: verbatim
17880 #: ../src/guestfs-actions.pod:6279
17881 #, no-wrap
17882 msgid ""
17883 " char **\n"
17884 " guestfs_tail (guestfs_h *g,\n"
17885 "               const char *path);\n"
17886 "\n"
17887 msgstr ""
17888
17889 # type: textblock
17890 #. type: textblock
17891 #: ../src/guestfs-actions.pod:6283 ../fish/guestfish-actions.pod:4205
17892 msgid ""
17893 "This command returns up to the last 10 lines of a file as a list of strings."
17894 msgstr ""
17895
17896 # type: =head2
17897 #. type: =head2
17898 #: ../src/guestfs-actions.pod:6295
17899 msgid "guestfs_tail_n"
17900 msgstr ""
17901
17902 # type: verbatim
17903 #. type: verbatim
17904 #: ../src/guestfs-actions.pod:6297
17905 #, no-wrap
17906 msgid ""
17907 " char **\n"
17908 " guestfs_tail_n (guestfs_h *g,\n"
17909 "                 int nrlines,\n"
17910 "                 const char *path);\n"
17911 "\n"
17912 msgstr ""
17913
17914 # type: textblock
17915 #. type: textblock
17916 #: ../src/guestfs-actions.pod:6302 ../fish/guestfish-actions.pod:4215
17917 msgid ""
17918 "If the parameter C<nrlines> is a positive number, this returns the last "
17919 "C<nrlines> lines of the file C<path>."
17920 msgstr ""
17921
17922 # type: textblock
17923 #. type: textblock
17924 #: ../src/guestfs-actions.pod:6305 ../fish/guestfish-actions.pod:4218
17925 msgid ""
17926 "If the parameter C<nrlines> is a negative number, this returns lines from "
17927 "the file C<path>, starting with the C<-nrlines>th line."
17928 msgstr ""
17929
17930 # type: =head2
17931 #. type: =head2
17932 #: ../src/guestfs-actions.pod:6319
17933 msgid "guestfs_tar_in"
17934 msgstr ""
17935
17936 # type: verbatim
17937 #. type: verbatim
17938 #: ../src/guestfs-actions.pod:6321
17939 #, no-wrap
17940 msgid ""
17941 " int\n"
17942 " guestfs_tar_in (guestfs_h *g,\n"
17943 "                 const char *tarfile,\n"
17944 "                 const char *directory);\n"
17945 "\n"
17946 msgstr ""
17947
17948 # type: textblock
17949 #. type: textblock
17950 #: ../src/guestfs-actions.pod:6326 ../fish/guestfish-actions.pod:4230
17951 msgid ""
17952 "This command uploads and unpacks local file C<tarfile> (an I<uncompressed> "
17953 "tar file) into C<directory>."
17954 msgstr ""
17955
17956 # type: textblock
17957 #. type: textblock
17958 #: ../src/guestfs-actions.pod:6329
17959 msgid ""
17960 "To upload a compressed tarball, use C<guestfs_tgz_in> or C<guestfs_txz_in>."
17961 msgstr ""
17962
17963 # type: textblock
17964 #. type: textblock
17965 #: ../src/guestfs-actions.pod:6334 ../src/guestfs-actions.pod:6351
17966 #: ../src/guestfs-actions.pod:6367 ../src/guestfs-actions.pod:6383
17967 msgid "(Added in 1.0.3)"
17968 msgstr ""
17969
17970 # type: =head2
17971 #. type: =head2
17972 #: ../src/guestfs-actions.pod:6336
17973 msgid "guestfs_tar_out"
17974 msgstr ""
17975
17976 # type: verbatim
17977 #. type: verbatim
17978 #: ../src/guestfs-actions.pod:6338
17979 #, no-wrap
17980 msgid ""
17981 " int\n"
17982 " guestfs_tar_out (guestfs_h *g,\n"
17983 "                  const char *directory,\n"
17984 "                  const char *tarfile);\n"
17985 "\n"
17986 msgstr ""
17987
17988 # type: textblock
17989 #. type: textblock
17990 #: ../src/guestfs-actions.pod:6343 ../fish/guestfish-actions.pod:4242
17991 msgid ""
17992 "This command packs the contents of C<directory> and downloads it to local "
17993 "file C<tarfile>."
17994 msgstr ""
17995
17996 # type: textblock
17997 #. type: textblock
17998 #: ../src/guestfs-actions.pod:6346
17999 msgid ""
18000 "To download a compressed tarball, use C<guestfs_tgz_out> or "
18001 "C<guestfs_txz_out>."
18002 msgstr ""
18003
18004 # type: =head2
18005 #. type: =head2
18006 #: ../src/guestfs-actions.pod:6353
18007 msgid "guestfs_tgz_in"
18008 msgstr ""
18009
18010 # type: verbatim
18011 #. type: verbatim
18012 #: ../src/guestfs-actions.pod:6355
18013 #, no-wrap
18014 msgid ""
18015 " int\n"
18016 " guestfs_tgz_in (guestfs_h *g,\n"
18017 "                 const char *tarball,\n"
18018 "                 const char *directory);\n"
18019 "\n"
18020 msgstr ""
18021
18022 # type: textblock
18023 #. type: textblock
18024 #: ../src/guestfs-actions.pod:6360 ../fish/guestfish-actions.pod:4254
18025 msgid ""
18026 "This command uploads and unpacks local file C<tarball> (a I<gzip compressed> "
18027 "tar file) into C<directory>."
18028 msgstr ""
18029
18030 # type: textblock
18031 #. type: textblock
18032 #: ../src/guestfs-actions.pod:6363
18033 msgid "To upload an uncompressed tarball, use C<guestfs_tar_in>."
18034 msgstr ""
18035
18036 # type: =head2
18037 #. type: =head2
18038 #: ../src/guestfs-actions.pod:6369
18039 msgid "guestfs_tgz_out"
18040 msgstr ""
18041
18042 # type: verbatim
18043 #. type: verbatim
18044 #: ../src/guestfs-actions.pod:6371
18045 #, no-wrap
18046 msgid ""
18047 " int\n"
18048 " guestfs_tgz_out (guestfs_h *g,\n"
18049 "                  const char *directory,\n"
18050 "                  const char *tarball);\n"
18051 "\n"
18052 msgstr ""
18053
18054 # type: textblock
18055 #. type: textblock
18056 #: ../src/guestfs-actions.pod:6376 ../fish/guestfish-actions.pod:4265
18057 msgid ""
18058 "This command packs the contents of C<directory> and downloads it to local "
18059 "file C<tarball>."
18060 msgstr ""
18061
18062 # type: textblock
18063 #. type: textblock
18064 #: ../src/guestfs-actions.pod:6379
18065 msgid "To download an uncompressed tarball, use C<guestfs_tar_out>."
18066 msgstr ""
18067
18068 # type: =head2
18069 #. type: =head2
18070 #: ../src/guestfs-actions.pod:6385
18071 msgid "guestfs_touch"
18072 msgstr ""
18073
18074 # type: verbatim
18075 #. type: verbatim
18076 #: ../src/guestfs-actions.pod:6387
18077 #, no-wrap
18078 msgid ""
18079 " int\n"
18080 " guestfs_touch (guestfs_h *g,\n"
18081 "                const char *path);\n"
18082 "\n"
18083 msgstr ""
18084
18085 # type: textblock
18086 #. type: textblock
18087 #: ../src/guestfs-actions.pod:6391 ../fish/guestfish-actions.pod:4276
18088 msgid ""
18089 "Touch acts like the L<touch(1)> command.  It can be used to update the "
18090 "timestamps on a file, or, if the file does not exist, to create a new zero-"
18091 "length file."
18092 msgstr ""
18093
18094 # type: textblock
18095 #. type: textblock
18096 #: ../src/guestfs-actions.pod:6395 ../fish/guestfish-actions.pod:4280
18097 msgid ""
18098 "This command only works on regular files, and will fail on other file types "
18099 "such as directories, symbolic links, block special etc."
18100 msgstr ""
18101
18102 # type: =head2
18103 #. type: =head2
18104 #: ../src/guestfs-actions.pod:6402
18105 msgid "guestfs_truncate"
18106 msgstr ""
18107
18108 # type: verbatim
18109 #. type: verbatim
18110 #: ../src/guestfs-actions.pod:6404
18111 #, no-wrap
18112 msgid ""
18113 " int\n"
18114 " guestfs_truncate (guestfs_h *g,\n"
18115 "                   const char *path);\n"
18116 "\n"
18117 msgstr ""
18118
18119 # type: textblock
18120 #. type: textblock
18121 #: ../src/guestfs-actions.pod:6408 ../fish/guestfish-actions.pod:4287
18122 msgid ""
18123 "This command truncates C<path> to a zero-length file.  The file must exist "
18124 "already."
18125 msgstr ""
18126
18127 # type: =head2
18128 #. type: =head2
18129 #: ../src/guestfs-actions.pod:6415
18130 msgid "guestfs_truncate_size"
18131 msgstr ""
18132
18133 # type: verbatim
18134 #. type: verbatim
18135 #: ../src/guestfs-actions.pod:6417
18136 #, no-wrap
18137 msgid ""
18138 " int\n"
18139 " guestfs_truncate_size (guestfs_h *g,\n"
18140 "                        const char *path,\n"
18141 "                        int64_t size);\n"
18142 "\n"
18143 msgstr ""
18144
18145 # type: textblock
18146 #. type: textblock
18147 #: ../src/guestfs-actions.pod:6422 ../fish/guestfish-actions.pod:4294
18148 msgid ""
18149 "This command truncates C<path> to size C<size> bytes.  The file must exist "
18150 "already."
18151 msgstr ""
18152
18153 # type: textblock
18154 #. type: textblock
18155 #: ../src/guestfs-actions.pod:6425
18156 msgid ""
18157 "If the current file size is less than C<size> then the file is extended to "
18158 "the required size with zero bytes.  This creates a sparse file (ie. disk "
18159 "blocks are not allocated for the file until you write to it).  To create a "
18160 "non-sparse file of zeroes, use C<guestfs_fallocate64> instead."
18161 msgstr ""
18162
18163 # type: =head2
18164 #. type: =head2
18165 #: ../src/guestfs-actions.pod:6435
18166 msgid "guestfs_tune2fs_l"
18167 msgstr ""
18168
18169 # type: verbatim
18170 #. type: verbatim
18171 #: ../src/guestfs-actions.pod:6437
18172 #, no-wrap
18173 msgid ""
18174 " char **\n"
18175 " guestfs_tune2fs_l (guestfs_h *g,\n"
18176 "                    const char *device);\n"
18177 "\n"
18178 msgstr ""
18179
18180 # type: textblock
18181 #. type: textblock
18182 #: ../src/guestfs-actions.pod:6441 ../fish/guestfish-actions.pod:4307
18183 msgid ""
18184 "This returns the contents of the ext2, ext3 or ext4 filesystem superblock on "
18185 "C<device>."
18186 msgstr ""
18187
18188 # type: textblock
18189 #. type: textblock
18190 #: ../src/guestfs-actions.pod:6444 ../fish/guestfish-actions.pod:4310
18191 msgid ""
18192 "It is the same as running C<tune2fs -l device>.  See L<tune2fs(8)> manpage "
18193 "for more details.  The list of fields returned isn't clearly defined, and "
18194 "depends on both the version of C<tune2fs> that libguestfs was built against, "
18195 "and the filesystem itself."
18196 msgstr ""
18197
18198 # type: =head2
18199 #. type: =head2
18200 #: ../src/guestfs-actions.pod:6457
18201 msgid "guestfs_txz_in"
18202 msgstr ""
18203
18204 # type: verbatim
18205 #. type: verbatim
18206 #: ../src/guestfs-actions.pod:6459
18207 #, no-wrap
18208 msgid ""
18209 " int\n"
18210 " guestfs_txz_in (guestfs_h *g,\n"
18211 "                 const char *tarball,\n"
18212 "                 const char *directory);\n"
18213 "\n"
18214 msgstr ""
18215
18216 # type: textblock
18217 #. type: textblock
18218 #: ../src/guestfs-actions.pod:6464 ../fish/guestfish-actions.pod:4319
18219 msgid ""
18220 "This command uploads and unpacks local file C<tarball> (an I<xz compressed> "
18221 "tar file) into C<directory>."
18222 msgstr ""
18223
18224 # type: =head2
18225 #. type: =head2
18226 #: ../src/guestfs-actions.pod:6471
18227 msgid "guestfs_txz_out"
18228 msgstr ""
18229
18230 # type: verbatim
18231 #. type: verbatim
18232 #: ../src/guestfs-actions.pod:6473
18233 #, no-wrap
18234 msgid ""
18235 " int\n"
18236 " guestfs_txz_out (guestfs_h *g,\n"
18237 "                  const char *directory,\n"
18238 "                  const char *tarball);\n"
18239 "\n"
18240 msgstr ""
18241
18242 # type: textblock
18243 #. type: textblock
18244 #: ../src/guestfs-actions.pod:6478 ../fish/guestfish-actions.pod:4328
18245 msgid ""
18246 "This command packs the contents of C<directory> and downloads it to local "
18247 "file C<tarball> (as an xz compressed tar archive)."
18248 msgstr ""
18249
18250 # type: =head2
18251 #. type: =head2
18252 #: ../src/guestfs-actions.pod:6485
18253 msgid "guestfs_umask"
18254 msgstr ""
18255
18256 # type: verbatim
18257 #. type: verbatim
18258 #: ../src/guestfs-actions.pod:6487
18259 #, no-wrap
18260 msgid ""
18261 " int\n"
18262 " guestfs_umask (guestfs_h *g,\n"
18263 "                int mask);\n"
18264 "\n"
18265 msgstr ""
18266
18267 # type: textblock
18268 #. type: textblock
18269 #: ../src/guestfs-actions.pod:6491 ../fish/guestfish-actions.pod:4337
18270 msgid ""
18271 "This function sets the mask used for creating new files and device nodes to "
18272 "C<mask & 0777>."
18273 msgstr ""
18274
18275 # type: textblock
18276 #. type: textblock
18277 #: ../src/guestfs-actions.pod:6494 ../fish/guestfish-actions.pod:4340
18278 msgid ""
18279 "Typical umask values would be C<022> which creates new files with "
18280 "permissions like \"-rw-r--r--\" or \"-rwxr-xr-x\", and C<002> which creates "
18281 "new files with permissions like \"-rw-rw-r--\" or \"-rwxrwxr-x\"."
18282 msgstr ""
18283
18284 # type: textblock
18285 #. type: textblock
18286 #: ../src/guestfs-actions.pod:6499 ../fish/guestfish-actions.pod:4345
18287 msgid ""
18288 "The default umask is C<022>.  This is important because it means that "
18289 "directories and device nodes will be created with C<0644> or C<0755> mode "
18290 "even if you specify C<0777>."
18291 msgstr ""
18292
18293 # type: textblock
18294 #. type: textblock
18295 #: ../src/guestfs-actions.pod:6503
18296 msgid ""
18297 "See also C<guestfs_get_umask>, L<umask(2)>, C<guestfs_mknod>, "
18298 "C<guestfs_mkdir>."
18299 msgstr ""
18300
18301 # type: textblock
18302 #. type: textblock
18303 #: ../src/guestfs-actions.pod:6506 ../fish/guestfish-actions.pod:4352
18304 msgid "This call returns the previous umask."
18305 msgstr ""
18306
18307 # type: =head2
18308 #. type: =head2
18309 #: ../src/guestfs-actions.pod:6512
18310 msgid "guestfs_umount"
18311 msgstr ""
18312
18313 # type: verbatim
18314 #. type: verbatim
18315 #: ../src/guestfs-actions.pod:6514
18316 #, no-wrap
18317 msgid ""
18318 " int\n"
18319 " guestfs_umount (guestfs_h *g,\n"
18320 "                 const char *pathordevice);\n"
18321 "\n"
18322 msgstr ""
18323
18324 # type: textblock
18325 #. type: textblock
18326 #: ../src/guestfs-actions.pod:6518 ../fish/guestfish-actions.pod:4360
18327 msgid ""
18328 "This unmounts the given filesystem.  The filesystem may be specified either "
18329 "by its mountpoint (path) or the device which contains the filesystem."
18330 msgstr ""
18331
18332 # type: =head2
18333 #. type: =head2
18334 #: ../src/guestfs-actions.pod:6526
18335 msgid "guestfs_umount_all"
18336 msgstr ""
18337
18338 # type: verbatim
18339 #. type: verbatim
18340 #: ../src/guestfs-actions.pod:6528
18341 #, no-wrap
18342 msgid ""
18343 " int\n"
18344 " guestfs_umount_all (guestfs_h *g);\n"
18345 "\n"
18346 msgstr ""
18347
18348 # type: textblock
18349 #. type: textblock
18350 #: ../src/guestfs-actions.pod:6531 ../fish/guestfish-actions.pod:4370
18351 msgid "This unmounts all mounted filesystems."
18352 msgstr ""
18353
18354 # type: textblock
18355 #. type: textblock
18356 #: ../src/guestfs-actions.pod:6533 ../fish/guestfish-actions.pod:4372
18357 msgid "Some internal mounts are not unmounted by this call."
18358 msgstr ""
18359
18360 # type: =head2
18361 #. type: =head2
18362 #: ../src/guestfs-actions.pod:6539
18363 msgid "guestfs_upload"
18364 msgstr ""
18365
18366 # type: verbatim
18367 #. type: verbatim
18368 #: ../src/guestfs-actions.pod:6541
18369 #, no-wrap
18370 msgid ""
18371 " int\n"
18372 " guestfs_upload (guestfs_h *g,\n"
18373 "                 const char *filename,\n"
18374 "                 const char *remotefilename);\n"
18375 "\n"
18376 msgstr ""
18377
18378 # type: textblock
18379 #. type: textblock
18380 #: ../src/guestfs-actions.pod:6546 ../src/guestfs-actions.pod:6570
18381 #: ../fish/guestfish-actions.pod:4378 ../fish/guestfish-actions.pod:4391
18382 msgid "Upload local file C<filename> to C<remotefilename> on the filesystem."
18383 msgstr ""
18384
18385 # type: textblock
18386 #. type: textblock
18387 #: ../src/guestfs-actions.pod:6551
18388 msgid "See also C<guestfs_download>."
18389 msgstr ""
18390
18391 # type: =head2
18392 #. type: =head2
18393 #: ../src/guestfs-actions.pod:6562
18394 msgid "guestfs_upload_offset"
18395 msgstr ""
18396
18397 # type: verbatim
18398 #. type: verbatim
18399 #: ../src/guestfs-actions.pod:6564
18400 #, no-wrap
18401 msgid ""
18402 " int\n"
18403 " guestfs_upload_offset (guestfs_h *g,\n"
18404 "                        const char *filename,\n"
18405 "                        const char *remotefilename,\n"
18406 "                        int64_t offset);\n"
18407 "\n"
18408 msgstr ""
18409
18410 # type: textblock
18411 #. type: textblock
18412 #: ../src/guestfs-actions.pod:6573 ../fish/guestfish-actions.pod:4394
18413 msgid ""
18414 "C<remotefilename> is overwritten starting at the byte C<offset> specified.  "
18415 "The intention is to overwrite parts of existing files or devices, although "
18416 "if a non-existant file is specified then it is created with a \"hole\" "
18417 "before C<offset>.  The size of the data written is implicit in the size of "
18418 "the source C<filename>."
18419 msgstr ""
18420
18421 # type: textblock
18422 #. type: textblock
18423 #: ../src/guestfs-actions.pod:6580
18424 msgid ""
18425 "Note that there is no limit on the amount of data that can be uploaded with "
18426 "this call, unlike with C<guestfs_pwrite>, and this call always writes the "
18427 "full amount unless an error occurs."
18428 msgstr ""
18429
18430 # type: textblock
18431 #. type: textblock
18432 #: ../src/guestfs-actions.pod:6585
18433 msgid "See also C<guestfs_upload>, C<guestfs_pwrite>."
18434 msgstr ""
18435
18436 # type: =head2
18437 #. type: =head2
18438 #: ../src/guestfs-actions.pod:6596
18439 msgid "guestfs_utimens"
18440 msgstr ""
18441
18442 # type: verbatim
18443 #. type: verbatim
18444 #: ../src/guestfs-actions.pod:6598
18445 #, no-wrap
18446 msgid ""
18447 " int\n"
18448 " guestfs_utimens (guestfs_h *g,\n"
18449 "                  const char *path,\n"
18450 "                  int64_t atsecs,\n"
18451 "                  int64_t atnsecs,\n"
18452 "                  int64_t mtsecs,\n"
18453 "                  int64_t mtnsecs);\n"
18454 "\n"
18455 msgstr ""
18456
18457 # type: textblock
18458 #. type: textblock
18459 #: ../src/guestfs-actions.pod:6606 ../fish/guestfish-actions.pod:4414
18460 msgid "This command sets the timestamps of a file with nanosecond precision."
18461 msgstr ""
18462
18463 # type: textblock
18464 #. type: textblock
18465 #: ../src/guestfs-actions.pod:6609 ../fish/guestfish-actions.pod:4417
18466 msgid ""
18467 "C<atsecs, atnsecs> are the last access time (atime) in secs and nanoseconds "
18468 "from the epoch."
18469 msgstr ""
18470
18471 # type: textblock
18472 #. type: textblock
18473 #: ../src/guestfs-actions.pod:6612 ../fish/guestfish-actions.pod:4420
18474 msgid ""
18475 "C<mtsecs, mtnsecs> are the last modification time (mtime) in secs and "
18476 "nanoseconds from the epoch."
18477 msgstr ""
18478
18479 # type: textblock
18480 #. type: textblock
18481 #: ../src/guestfs-actions.pod:6615 ../fish/guestfish-actions.pod:4423
18482 msgid ""
18483 "If the C<*nsecs> field contains the special value C<-1> then the "
18484 "corresponding timestamp is set to the current time.  (The C<*secs> field is "
18485 "ignored in this case)."
18486 msgstr ""
18487
18488 # type: textblock
18489 #. type: textblock
18490 #: ../src/guestfs-actions.pod:6619 ../fish/guestfish-actions.pod:4427
18491 msgid ""
18492 "If the C<*nsecs> field contains the special value C<-2> then the "
18493 "corresponding timestamp is left unchanged.  (The C<*secs> field is ignored "
18494 "in this case)."
18495 msgstr ""
18496
18497 # type: =head2
18498 #. type: =head2
18499 #: ../src/guestfs-actions.pod:6627 ../src/guestfs-structs.pod:175
18500 msgid "guestfs_version"
18501 msgstr ""
18502
18503 # type: verbatim
18504 #. type: verbatim
18505 #: ../src/guestfs-actions.pod:6629
18506 #, no-wrap
18507 msgid ""
18508 " struct guestfs_version *\n"
18509 " guestfs_version (guestfs_h *g);\n"
18510 "\n"
18511 msgstr ""
18512
18513 # type: textblock
18514 #. type: textblock
18515 #: ../src/guestfs-actions.pod:6632 ../fish/guestfish-actions.pod:4435
18516 msgid ""
18517 "Return the libguestfs version number that the program is linked against."
18518 msgstr ""
18519
18520 # type: textblock
18521 #. type: textblock
18522 #: ../src/guestfs-actions.pod:6635 ../fish/guestfish-actions.pod:4438
18523 msgid ""
18524 "Note that because of dynamic linking this is not necessarily the version of "
18525 "libguestfs that you compiled against.  You can compile the program, and then "
18526 "at runtime dynamically link against a completely different C<libguestfs.so> "
18527 "library."
18528 msgstr ""
18529
18530 # type: textblock
18531 #. type: textblock
18532 #: ../src/guestfs-actions.pod:6640 ../fish/guestfish-actions.pod:4443
18533 msgid ""
18534 "This call was added in version C<1.0.58>.  In previous versions of "
18535 "libguestfs there was no way to get the version number.  From C code you can "
18536 "use dynamic linker functions to find out if this symbol exists (if it "
18537 "doesn't, then it's an earlier version)."
18538 msgstr ""
18539
18540 # type: textblock
18541 #. type: textblock
18542 #: ../src/guestfs-actions.pod:6646 ../fish/guestfish-actions.pod:4449
18543 msgid ""
18544 "The call returns a structure with four elements.  The first three (C<major>, "
18545 "C<minor> and C<release>) are numbers and correspond to the usual version "
18546 "triplet.  The fourth element (C<extra>) is a string and is normally empty, "
18547 "but may be used for distro-specific information."
18548 msgstr ""
18549
18550 # type: textblock
18551 #. type: textblock
18552 #: ../src/guestfs-actions.pod:6652 ../fish/guestfish-actions.pod:4455
18553 msgid ""
18554 "To construct the original version string: C<$major.$minor.$release$extra>"
18555 msgstr ""
18556
18557 # type: textblock
18558 #. type: textblock
18559 #: ../src/guestfs-actions.pod:6655 ../fish/guestfish-actions.pod:4458
18560 msgid "See also: L<guestfs(3)/LIBGUESTFS VERSION NUMBERS>."
18561 msgstr ""
18562
18563 # type: textblock
18564 #. type: textblock
18565 #: ../src/guestfs-actions.pod:6657
18566 msgid ""
18567 "I<Note:> Don't use this call to test for availability of features.  In "
18568 "enterprise distributions we backport features from later versions into "
18569 "earlier versions, making this an unreliable way to test for features.  Use "
18570 "C<guestfs_available> instead."
18571 msgstr ""
18572
18573 # type: textblock
18574 #. type: textblock
18575 #: ../src/guestfs-actions.pod:6663
18576 msgid ""
18577 "This function returns a C<struct guestfs_version *>, or NULL if there was an "
18578 "error.  I<The caller must call C<guestfs_free_version> after use>."
18579 msgstr ""
18580
18581 # type: textblock
18582 #. type: textblock
18583 #: ../src/guestfs-actions.pod:6667
18584 msgid "(Added in 1.0.58)"
18585 msgstr ""
18586
18587 # type: =head2
18588 #. type: =head2
18589 #: ../src/guestfs-actions.pod:6669
18590 msgid "guestfs_vfs_label"
18591 msgstr ""
18592
18593 # type: verbatim
18594 #. type: verbatim
18595 #: ../src/guestfs-actions.pod:6671
18596 #, no-wrap
18597 msgid ""
18598 " char *\n"
18599 " guestfs_vfs_label (guestfs_h *g,\n"
18600 "                    const char *device);\n"
18601 "\n"
18602 msgstr ""
18603
18604 # type: textblock
18605 #. type: textblock
18606 #: ../src/guestfs-actions.pod:6675 ../fish/guestfish-actions.pod:4470
18607 msgid "This returns the filesystem label of the filesystem on C<device>."
18608 msgstr ""
18609
18610 # type: textblock
18611 #. type: textblock
18612 #: ../src/guestfs-actions.pod:6678 ../fish/guestfish-actions.pod:4473
18613 msgid "If the filesystem is unlabeled, this returns the empty string."
18614 msgstr ""
18615
18616 # type: textblock
18617 #. type: textblock
18618 #: ../src/guestfs-actions.pod:6680
18619 msgid "To find a filesystem from the label, use C<guestfs_findfs_label>."
18620 msgstr ""
18621
18622 # type: textblock
18623 #. type: textblock
18624 #: ../src/guestfs-actions.pod:6685 ../src/guestfs-actions.pod:6722
18625 msgid "(Added in 1.3.18)"
18626 msgstr ""
18627
18628 # type: =head2
18629 #. type: =head2
18630 #: ../src/guestfs-actions.pod:6687
18631 msgid "guestfs_vfs_type"
18632 msgstr ""
18633
18634 # type: verbatim
18635 #. type: verbatim
18636 #: ../src/guestfs-actions.pod:6689
18637 #, no-wrap
18638 msgid ""
18639 " char *\n"
18640 " guestfs_vfs_type (guestfs_h *g,\n"
18641 "                   const char *device);\n"
18642 "\n"
18643 msgstr ""
18644
18645 # type: textblock
18646 #. type: textblock
18647 #: ../src/guestfs-actions.pod:6693 ../fish/guestfish-actions.pod:4481
18648 msgid ""
18649 "This command gets the filesystem type corresponding to the filesystem on "
18650 "C<device>."
18651 msgstr ""
18652
18653 # type: textblock
18654 #. type: textblock
18655 #: ../src/guestfs-actions.pod:6696 ../fish/guestfish-actions.pod:4484
18656 msgid ""
18657 "For most filesystems, the result is the name of the Linux VFS module which "
18658 "would be used to mount this filesystem if you mounted it without specifying "
18659 "the filesystem type.  For example a string such as C<ext3> or C<ntfs>."
18660 msgstr ""
18661
18662 # type: =head2
18663 #. type: =head2
18664 #: ../src/guestfs-actions.pod:6706
18665 msgid "guestfs_vfs_uuid"
18666 msgstr ""
18667
18668 # type: verbatim
18669 #. type: verbatim
18670 #: ../src/guestfs-actions.pod:6708
18671 #, no-wrap
18672 msgid ""
18673 " char *\n"
18674 " guestfs_vfs_uuid (guestfs_h *g,\n"
18675 "                   const char *device);\n"
18676 "\n"
18677 msgstr ""
18678
18679 # type: textblock
18680 #. type: textblock
18681 #: ../src/guestfs-actions.pod:6712 ../fish/guestfish-actions.pod:4493
18682 msgid "This returns the filesystem UUID of the filesystem on C<device>."
18683 msgstr ""
18684
18685 # type: textblock
18686 #. type: textblock
18687 #: ../src/guestfs-actions.pod:6715 ../fish/guestfish-actions.pod:4496
18688 msgid "If the filesystem does not have a UUID, this returns the empty string."
18689 msgstr ""
18690
18691 # type: textblock
18692 #. type: textblock
18693 #: ../src/guestfs-actions.pod:6717
18694 msgid "To find a filesystem from the UUID, use C<guestfs_findfs_uuid>."
18695 msgstr ""
18696
18697 # type: =head2
18698 #. type: =head2
18699 #: ../src/guestfs-actions.pod:6724
18700 msgid "guestfs_vg_activate"
18701 msgstr ""
18702
18703 # type: verbatim
18704 #. type: verbatim
18705 #: ../src/guestfs-actions.pod:6726
18706 #, no-wrap
18707 msgid ""
18708 " int\n"
18709 " guestfs_vg_activate (guestfs_h *g,\n"
18710 "                      int activate,\n"
18711 "                      char *const *volgroups);\n"
18712 "\n"
18713 msgstr ""
18714
18715 # type: textblock
18716 #. type: textblock
18717 #: ../src/guestfs-actions.pod:6731 ../fish/guestfish-actions.pod:4504
18718 msgid ""
18719 "This command activates or (if C<activate> is false) deactivates all logical "
18720 "volumes in the listed volume groups C<volgroups>.  If activated, then they "
18721 "are made known to the kernel, ie. they appear as C</dev/mapper> devices.  If "
18722 "deactivated, then those devices disappear."
18723 msgstr ""
18724
18725 # type: textblock
18726 #. type: textblock
18727 #: ../src/guestfs-actions.pod:6737 ../fish/guestfish-actions.pod:4510
18728 msgid "This command is the same as running C<vgchange -a y|n volgroups...>"
18729 msgstr ""
18730
18731 # type: textblock
18732 #. type: textblock
18733 #: ../src/guestfs-actions.pod:6739 ../fish/guestfish-actions.pod:4512
18734 msgid ""
18735 "Note that if C<volgroups> is an empty list then B<all> volume groups are "
18736 "activated or deactivated."
18737 msgstr ""
18738
18739 # type: =head2
18740 #. type: =head2
18741 #: ../src/guestfs-actions.pod:6746
18742 msgid "guestfs_vg_activate_all"
18743 msgstr ""
18744
18745 # type: verbatim
18746 #. type: verbatim
18747 #: ../src/guestfs-actions.pod:6748
18748 #, no-wrap
18749 msgid ""
18750 " int\n"
18751 " guestfs_vg_activate_all (guestfs_h *g,\n"
18752 "                          int activate);\n"
18753 "\n"
18754 msgstr ""
18755
18756 # type: textblock
18757 #. type: textblock
18758 #: ../src/guestfs-actions.pod:6752 ../fish/guestfish-actions.pod:4519
18759 msgid ""
18760 "This command activates or (if C<activate> is false) deactivates all logical "
18761 "volumes in all volume groups.  If activated, then they are made known to the "
18762 "kernel, ie. they appear as C</dev/mapper> devices.  If deactivated, then "
18763 "those devices disappear."
18764 msgstr ""
18765
18766 # type: textblock
18767 #. type: textblock
18768 #: ../src/guestfs-actions.pod:6758 ../fish/guestfish-actions.pod:4525
18769 msgid "This command is the same as running C<vgchange -a y|n>"
18770 msgstr ""
18771
18772 # type: =head2
18773 #. type: =head2
18774 #: ../src/guestfs-actions.pod:6764
18775 msgid "guestfs_vgcreate"
18776 msgstr ""
18777
18778 # type: verbatim
18779 #. type: verbatim
18780 #: ../src/guestfs-actions.pod:6766
18781 #, no-wrap
18782 msgid ""
18783 " int\n"
18784 " guestfs_vgcreate (guestfs_h *g,\n"
18785 "                   const char *volgroup,\n"
18786 "                   char *const *physvols);\n"
18787 "\n"
18788 msgstr ""
18789
18790 # type: textblock
18791 #. type: textblock
18792 #: ../src/guestfs-actions.pod:6771 ../fish/guestfish-actions.pod:4531
18793 msgid ""
18794 "This creates an LVM volume group called C<volgroup> from the non-empty list "
18795 "of physical volumes C<physvols>."
18796 msgstr ""
18797
18798 # type: =head2
18799 #. type: =head2
18800 #: ../src/guestfs-actions.pod:6778
18801 msgid "guestfs_vglvuuids"
18802 msgstr ""
18803
18804 # type: verbatim
18805 #. type: verbatim
18806 #: ../src/guestfs-actions.pod:6780
18807 #, no-wrap
18808 msgid ""
18809 " char **\n"
18810 " guestfs_vglvuuids (guestfs_h *g,\n"
18811 "                    const char *vgname);\n"
18812 "\n"
18813 msgstr ""
18814
18815 # type: textblock
18816 #. type: textblock
18817 #: ../src/guestfs-actions.pod:6784 ../fish/guestfish-actions.pod:4538
18818 msgid ""
18819 "Given a VG called C<vgname>, this returns the UUIDs of all the logical "
18820 "volumes created in this volume group."
18821 msgstr ""
18822
18823 # type: textblock
18824 #. type: textblock
18825 #: ../src/guestfs-actions.pod:6787
18826 msgid ""
18827 "You can use this along with C<guestfs_lvs> and C<guestfs_lvuuid> calls to "
18828 "associate logical volumes and volume groups."
18829 msgstr ""
18830
18831 # type: textblock
18832 #. type: textblock
18833 #: ../src/guestfs-actions.pod:6790
18834 msgid "See also C<guestfs_vgpvuuids>."
18835 msgstr ""
18836
18837 # type: =head2
18838 #. type: =head2
18839 #: ../src/guestfs-actions.pod:6798
18840 msgid "guestfs_vgpvuuids"
18841 msgstr ""
18842
18843 # type: verbatim
18844 #. type: verbatim
18845 #: ../src/guestfs-actions.pod:6800
18846 #, no-wrap
18847 msgid ""
18848 " char **\n"
18849 " guestfs_vgpvuuids (guestfs_h *g,\n"
18850 "                    const char *vgname);\n"
18851 "\n"
18852 msgstr ""
18853
18854 # type: textblock
18855 #. type: textblock
18856 #: ../src/guestfs-actions.pod:6804 ../fish/guestfish-actions.pod:4550
18857 msgid ""
18858 "Given a VG called C<vgname>, this returns the UUIDs of all the physical "
18859 "volumes that this volume group resides on."
18860 msgstr ""
18861
18862 # type: textblock
18863 #. type: textblock
18864 #: ../src/guestfs-actions.pod:6807
18865 msgid ""
18866 "You can use this along with C<guestfs_pvs> and C<guestfs_pvuuid> calls to "
18867 "associate physical volumes and volume groups."
18868 msgstr ""
18869
18870 # type: textblock
18871 #. type: textblock
18872 #: ../src/guestfs-actions.pod:6810
18873 msgid "See also C<guestfs_vglvuuids>."
18874 msgstr ""
18875
18876 # type: =head2
18877 #. type: =head2
18878 #: ../src/guestfs-actions.pod:6818
18879 msgid "guestfs_vgremove"
18880 msgstr ""
18881
18882 # type: verbatim
18883 #. type: verbatim
18884 #: ../src/guestfs-actions.pod:6820
18885 #, no-wrap
18886 msgid ""
18887 " int\n"
18888 " guestfs_vgremove (guestfs_h *g,\n"
18889 "                   const char *vgname);\n"
18890 "\n"
18891 msgstr ""
18892
18893 # type: textblock
18894 #. type: textblock
18895 #: ../src/guestfs-actions.pod:6824 ../fish/guestfish-actions.pod:4562
18896 msgid "Remove an LVM volume group C<vgname>, (for example C<VG>)."
18897 msgstr ""
18898
18899 # type: textblock
18900 #. type: textblock
18901 #: ../src/guestfs-actions.pod:6826 ../fish/guestfish-actions.pod:4564
18902 msgid ""
18903 "This also forcibly removes all logical volumes in the volume group (if any)."
18904 msgstr ""
18905
18906 # type: =head2
18907 #. type: =head2
18908 #: ../src/guestfs-actions.pod:6833
18909 msgid "guestfs_vgrename"
18910 msgstr ""
18911
18912 # type: verbatim
18913 #. type: verbatim
18914 #: ../src/guestfs-actions.pod:6835
18915 #, no-wrap
18916 msgid ""
18917 " int\n"
18918 " guestfs_vgrename (guestfs_h *g,\n"
18919 "                   const char *volgroup,\n"
18920 "                   const char *newvolgroup);\n"
18921 "\n"
18922 msgstr ""
18923
18924 # type: textblock
18925 #. type: textblock
18926 #: ../src/guestfs-actions.pod:6840 ../fish/guestfish-actions.pod:4571
18927 msgid "Rename a volume group C<volgroup> with the new name C<newvolgroup>."
18928 msgstr ""
18929
18930 # type: =head2
18931 #. type: =head2
18932 #: ../src/guestfs-actions.pod:6846
18933 msgid "guestfs_vgs"
18934 msgstr ""
18935
18936 # type: verbatim
18937 #. type: verbatim
18938 #: ../src/guestfs-actions.pod:6848
18939 #, no-wrap
18940 msgid ""
18941 " char **\n"
18942 " guestfs_vgs (guestfs_h *g);\n"
18943 "\n"
18944 msgstr ""
18945
18946 # type: textblock
18947 #. type: textblock
18948 #: ../src/guestfs-actions.pod:6851 ../fish/guestfish-actions.pod:4577
18949 msgid ""
18950 "List all the volumes groups detected.  This is the equivalent of the L<vgs(8)"
18951 "> command."
18952 msgstr ""
18953
18954 # type: textblock
18955 #. type: textblock
18956 #: ../src/guestfs-actions.pod:6854 ../fish/guestfish-actions.pod:4580
18957 msgid ""
18958 "This returns a list of just the volume group names that were detected (eg. "
18959 "C<VolGroup00>)."
18960 msgstr ""
18961
18962 # type: textblock
18963 #. type: textblock
18964 #: ../src/guestfs-actions.pod:6857
18965 msgid "See also C<guestfs_vgs_full>."
18966 msgstr ""
18967
18968 # type: =head2
18969 #. type: =head2
18970 #: ../src/guestfs-actions.pod:6865
18971 msgid "guestfs_vgs_full"
18972 msgstr ""
18973
18974 # type: verbatim
18975 #. type: verbatim
18976 #: ../src/guestfs-actions.pod:6867
18977 #, no-wrap
18978 msgid ""
18979 " struct guestfs_lvm_vg_list *\n"
18980 " guestfs_vgs_full (guestfs_h *g);\n"
18981 "\n"
18982 msgstr ""
18983
18984 # type: textblock
18985 #. type: textblock
18986 #: ../src/guestfs-actions.pod:6870 ../fish/guestfish-actions.pod:4589
18987 msgid ""
18988 "List all the volumes groups detected.  This is the equivalent of the L<vgs(8)"
18989 "> command.  The \"full\" version includes all fields."
18990 msgstr ""
18991
18992 # type: textblock
18993 #. type: textblock
18994 #: ../src/guestfs-actions.pod:6873
18995 msgid ""
18996 "This function returns a C<struct guestfs_lvm_vg_list *>, or NULL if there "
18997 "was an error.  I<The caller must call C<guestfs_free_lvm_vg_list> after use>."
18998 msgstr ""
18999
19000 # type: =head2
19001 #. type: =head2
19002 #: ../src/guestfs-actions.pod:6879
19003 msgid "guestfs_vgscan"
19004 msgstr ""
19005
19006 # type: verbatim
19007 #. type: verbatim
19008 #: ../src/guestfs-actions.pod:6881
19009 #, no-wrap
19010 msgid ""
19011 " int\n"
19012 " guestfs_vgscan (guestfs_h *g);\n"
19013 "\n"
19014 msgstr ""
19015
19016 # type: textblock
19017 #. type: textblock
19018 #: ../src/guestfs-actions.pod:6884 ../fish/guestfish-actions.pod:4596
19019 msgid ""
19020 "This rescans all block devices and rebuilds the list of LVM physical "
19021 "volumes, volume groups and logical volumes."
19022 msgstr ""
19023
19024 # type: =head2
19025 #. type: =head2
19026 #: ../src/guestfs-actions.pod:6891
19027 msgid "guestfs_vguuid"
19028 msgstr ""
19029
19030 # type: verbatim
19031 #. type: verbatim
19032 #: ../src/guestfs-actions.pod:6893
19033 #, no-wrap
19034 msgid ""
19035 " char *\n"
19036 " guestfs_vguuid (guestfs_h *g,\n"
19037 "                 const char *vgname);\n"
19038 "\n"
19039 msgstr ""
19040
19041 # type: textblock
19042 #. type: textblock
19043 #: ../src/guestfs-actions.pod:6897 ../fish/guestfish-actions.pod:4603
19044 msgid "This command returns the UUID of the LVM VG named C<vgname>."
19045 msgstr ""
19046
19047 # type: =head2
19048 #. type: =head2
19049 #: ../src/guestfs-actions.pod:6904
19050 msgid "guestfs_wait_ready"
19051 msgstr ""
19052
19053 # type: verbatim
19054 #. type: verbatim
19055 #: ../src/guestfs-actions.pod:6906
19056 #, no-wrap
19057 msgid ""
19058 " int\n"
19059 " guestfs_wait_ready (guestfs_h *g);\n"
19060 "\n"
19061 msgstr ""
19062
19063 # type: textblock
19064 #. type: textblock
19065 #: ../src/guestfs-actions.pod:6909
19066 msgid "This function is a no op."
19067 msgstr ""
19068
19069 # type: textblock
19070 #. type: textblock
19071 #: ../src/guestfs-actions.pod:6911
19072 msgid ""
19073 "In versions of the API E<lt> 1.0.71 you had to call this function just after "
19074 "calling C<guestfs_launch> to wait for the launch to complete.  However this "
19075 "is no longer necessary because C<guestfs_launch> now does the waiting."
19076 msgstr ""
19077
19078 # type: textblock
19079 #. type: textblock
19080 #: ../src/guestfs-actions.pod:6916
19081 msgid ""
19082 "If you see any calls to this function in code then you can just remove them, "
19083 "unless you want to retain compatibility with older versions of the API."
19084 msgstr ""
19085
19086 # type: =head2
19087 #. type: =head2
19088 #: ../src/guestfs-actions.pod:6924
19089 msgid "guestfs_wc_c"
19090 msgstr ""
19091
19092 # type: verbatim
19093 #. type: verbatim
19094 #: ../src/guestfs-actions.pod:6926
19095 #, no-wrap
19096 msgid ""
19097 " int\n"
19098 " guestfs_wc_c (guestfs_h *g,\n"
19099 "               const char *path);\n"
19100 "\n"
19101 msgstr ""
19102
19103 # type: textblock
19104 #. type: textblock
19105 #: ../src/guestfs-actions.pod:6930 ../fish/guestfish-actions.pod:4609
19106 msgid ""
19107 "This command counts the characters in a file, using the C<wc -c> external "
19108 "command."
19109 msgstr ""
19110
19111 # type: =head2
19112 #. type: =head2
19113 #: ../src/guestfs-actions.pod:6937
19114 msgid "guestfs_wc_l"
19115 msgstr ""
19116
19117 # type: verbatim
19118 #. type: verbatim
19119 #: ../src/guestfs-actions.pod:6939
19120 #, no-wrap
19121 msgid ""
19122 " int\n"
19123 " guestfs_wc_l (guestfs_h *g,\n"
19124 "               const char *path);\n"
19125 "\n"
19126 msgstr ""
19127
19128 # type: textblock
19129 #. type: textblock
19130 #: ../src/guestfs-actions.pod:6943 ../fish/guestfish-actions.pod:4616
19131 msgid ""
19132 "This command counts the lines in a file, using the C<wc -l> external command."
19133 msgstr ""
19134
19135 # type: =head2
19136 #. type: =head2
19137 #: ../src/guestfs-actions.pod:6950
19138 msgid "guestfs_wc_w"
19139 msgstr ""
19140
19141 # type: verbatim
19142 #. type: verbatim
19143 #: ../src/guestfs-actions.pod:6952
19144 #, no-wrap
19145 msgid ""
19146 " int\n"
19147 " guestfs_wc_w (guestfs_h *g,\n"
19148 "               const char *path);\n"
19149 "\n"
19150 msgstr ""
19151
19152 # type: textblock
19153 #. type: textblock
19154 #: ../src/guestfs-actions.pod:6956 ../fish/guestfish-actions.pod:4623
19155 msgid ""
19156 "This command counts the words in a file, using the C<wc -w> external command."
19157 msgstr ""
19158
19159 # type: =head2
19160 #. type: =head2
19161 #: ../src/guestfs-actions.pod:6963
19162 msgid "guestfs_write"
19163 msgstr ""
19164
19165 # type: verbatim
19166 #. type: verbatim
19167 #: ../src/guestfs-actions.pod:6965
19168 #, no-wrap
19169 msgid ""
19170 " int\n"
19171 " guestfs_write (guestfs_h *g,\n"
19172 "                const char *path,\n"
19173 "                const char *content,\n"
19174 "                size_t content_size);\n"
19175 "\n"
19176 msgstr ""
19177
19178 # type: textblock
19179 #. type: textblock
19180 #: ../src/guestfs-actions.pod:6971 ../fish/guestfish-actions.pod:4630
19181 msgid ""
19182 "This call creates a file called C<path>.  The content of the file is the "
19183 "string C<content> (which can contain any 8 bit data)."
19184 msgstr ""
19185
19186 # type: =head2
19187 #. type: =head2
19188 #: ../src/guestfs-actions.pod:6981
19189 msgid "guestfs_write_file"
19190 msgstr ""
19191
19192 # type: verbatim
19193 #. type: verbatim
19194 #: ../src/guestfs-actions.pod:6983
19195 #, no-wrap
19196 msgid ""
19197 " int\n"
19198 " guestfs_write_file (guestfs_h *g,\n"
19199 "                     const char *path,\n"
19200 "                     const char *content,\n"
19201 "                     int size);\n"
19202 "\n"
19203 msgstr ""
19204
19205 # type: textblock
19206 #. type: textblock
19207 #: ../src/guestfs-actions.pod:6989 ../fish/guestfish-actions.pod:4640
19208 msgid ""
19209 "This call creates a file called C<path>.  The contents of the file is the "
19210 "string C<content> (which can contain any 8 bit data), with length C<size>."
19211 msgstr ""
19212
19213 # type: textblock
19214 #. type: textblock
19215 #: ../src/guestfs-actions.pod:6993 ../fish/guestfish-actions.pod:4644
19216 msgid ""
19217 "As a special case, if C<size> is C<0> then the length is calculated using "
19218 "C<strlen> (so in this case the content cannot contain embedded ASCII NULs)."
19219 msgstr ""
19220
19221 # type: textblock
19222 #. type: textblock
19223 #: ../src/guestfs-actions.pod:6997 ../fish/guestfish-actions.pod:4648
19224 msgid ""
19225 "I<NB.> Owing to a bug, writing content containing ASCII NUL characters does "
19226 "I<not> work, even if the length is specified."
19227 msgstr ""
19228
19229 #. type: textblock
19230 #: ../src/guestfs-actions.pod:7005
19231 msgid ""
19232 "This function is deprecated.  In new code, use the L</guestfs_write> call "
19233 "instead."
19234 msgstr ""
19235
19236 # type: =head2
19237 #. type: =head2
19238 #: ../src/guestfs-actions.pod:7014
19239 msgid "guestfs_zegrep"
19240 msgstr ""
19241
19242 # type: verbatim
19243 #. type: verbatim
19244 #: ../src/guestfs-actions.pod:7016
19245 #, no-wrap
19246 msgid ""
19247 " char **\n"
19248 " guestfs_zegrep (guestfs_h *g,\n"
19249 "                 const char *regex,\n"
19250 "                 const char *path);\n"
19251 "\n"
19252 msgstr ""
19253
19254 # type: textblock
19255 #. type: textblock
19256 #: ../src/guestfs-actions.pod:7021 ../fish/guestfish-actions.pod:4665
19257 msgid ""
19258 "This calls the external C<zegrep> program and returns the matching lines."
19259 msgstr ""
19260
19261 # type: =head2
19262 #. type: =head2
19263 #: ../src/guestfs-actions.pod:7033
19264 msgid "guestfs_zegrepi"
19265 msgstr ""
19266
19267 # type: verbatim
19268 #. type: verbatim
19269 #: ../src/guestfs-actions.pod:7035
19270 #, no-wrap
19271 msgid ""
19272 " char **\n"
19273 " guestfs_zegrepi (guestfs_h *g,\n"
19274 "                  const char *regex,\n"
19275 "                  const char *path);\n"
19276 "\n"
19277 msgstr ""
19278
19279 # type: textblock
19280 #. type: textblock
19281 #: ../src/guestfs-actions.pod:7040 ../fish/guestfish-actions.pod:4675
19282 msgid ""
19283 "This calls the external C<zegrep -i> program and returns the matching lines."
19284 msgstr ""
19285
19286 # type: =head2
19287 #. type: =head2
19288 #: ../src/guestfs-actions.pod:7052
19289 msgid "guestfs_zero"
19290 msgstr ""
19291
19292 # type: verbatim
19293 #. type: verbatim
19294 #: ../src/guestfs-actions.pod:7054
19295 #, no-wrap
19296 msgid ""
19297 " int\n"
19298 " guestfs_zero (guestfs_h *g,\n"
19299 "               const char *device);\n"
19300 "\n"
19301 msgstr ""
19302
19303 # type: textblock
19304 #. type: textblock
19305 #: ../src/guestfs-actions.pod:7058 ../fish/guestfish-actions.pod:4685
19306 msgid "This command writes zeroes over the first few blocks of C<device>."
19307 msgstr ""
19308
19309 # type: textblock
19310 #. type: textblock
19311 #: ../src/guestfs-actions.pod:7060 ../fish/guestfish-actions.pod:4687
19312 msgid ""
19313 "How many blocks are zeroed isn't specified (but it's I<not> enough to "
19314 "securely wipe the device).  It should be sufficient to remove any partition "
19315 "tables, filesystem superblocks and so on."
19316 msgstr ""
19317
19318 # type: textblock
19319 #. type: textblock
19320 #: ../src/guestfs-actions.pod:7064
19321 msgid "See also: C<guestfs_zero_device>, C<guestfs_scrub_device>."
19322 msgstr ""
19323
19324 # type: =head2
19325 #. type: =head2
19326 #: ../src/guestfs-actions.pod:7075
19327 msgid "guestfs_zero_device"
19328 msgstr ""
19329
19330 # type: verbatim
19331 #. type: verbatim
19332 #: ../src/guestfs-actions.pod:7077
19333 #, no-wrap
19334 msgid ""
19335 " int\n"
19336 " guestfs_zero_device (guestfs_h *g,\n"
19337 "                      const char *device);\n"
19338 "\n"
19339 msgstr ""
19340
19341 # type: textblock
19342 #. type: textblock
19343 #: ../src/guestfs-actions.pod:7081
19344 msgid ""
19345 "This command writes zeroes over the entire C<device>.  Compare with "
19346 "C<guestfs_zero> which just zeroes the first few blocks of a device."
19347 msgstr ""
19348
19349 # type: textblock
19350 #. type: textblock
19351 #: ../src/guestfs-actions.pod:7095
19352 msgid "(Added in 1.3.1)"
19353 msgstr ""
19354
19355 # type: =head2
19356 #. type: =head2
19357 #: ../src/guestfs-actions.pod:7097
19358 msgid "guestfs_zerofree"
19359 msgstr ""
19360
19361 # type: verbatim
19362 #. type: verbatim
19363 #: ../src/guestfs-actions.pod:7099
19364 #, no-wrap
19365 msgid ""
19366 " int\n"
19367 " guestfs_zerofree (guestfs_h *g,\n"
19368 "                   const char *device);\n"
19369 "\n"
19370 msgstr ""
19371
19372 # type: textblock
19373 #. type: textblock
19374 #: ../src/guestfs-actions.pod:7103 ../fish/guestfish-actions.pod:4708
19375 msgid ""
19376 "This runs the I<zerofree> program on C<device>.  This program claims to zero "
19377 "unused inodes and disk blocks on an ext2/3 filesystem, thus making it "
19378 "possible to compress the filesystem more effectively."
19379 msgstr ""
19380
19381 # type: textblock
19382 #. type: textblock
19383 #: ../src/guestfs-actions.pod:7108 ../fish/guestfish-actions.pod:4713
19384 msgid "You should B<not> run this program if the filesystem is mounted."
19385 msgstr ""
19386
19387 # type: textblock
19388 #. type: textblock
19389 #: ../src/guestfs-actions.pod:7111 ../fish/guestfish-actions.pod:4716
19390 msgid ""
19391 "It is possible that using this program can damage the filesystem or data on "
19392 "the filesystem."
19393 msgstr ""
19394
19395 # type: =head2
19396 #. type: =head2
19397 #: ../src/guestfs-actions.pod:7118
19398 msgid "guestfs_zfgrep"
19399 msgstr ""
19400
19401 # type: verbatim
19402 #. type: verbatim
19403 #: ../src/guestfs-actions.pod:7120
19404 #, no-wrap
19405 msgid ""
19406 " char **\n"
19407 " guestfs_zfgrep (guestfs_h *g,\n"
19408 "                 const char *pattern,\n"
19409 "                 const char *path);\n"
19410 "\n"
19411 msgstr ""
19412
19413 # type: textblock
19414 #. type: textblock
19415 #: ../src/guestfs-actions.pod:7125 ../fish/guestfish-actions.pod:4723
19416 msgid ""
19417 "This calls the external C<zfgrep> program and returns the matching lines."
19418 msgstr ""
19419
19420 # type: =head2
19421 #. type: =head2
19422 #: ../src/guestfs-actions.pod:7137
19423 msgid "guestfs_zfgrepi"
19424 msgstr ""
19425
19426 # type: verbatim
19427 #. type: verbatim
19428 #: ../src/guestfs-actions.pod:7139
19429 #, no-wrap
19430 msgid ""
19431 " char **\n"
19432 " guestfs_zfgrepi (guestfs_h *g,\n"
19433 "                  const char *pattern,\n"
19434 "                  const char *path);\n"
19435 "\n"
19436 msgstr ""
19437
19438 # type: textblock
19439 #. type: textblock
19440 #: ../src/guestfs-actions.pod:7144 ../fish/guestfish-actions.pod:4733
19441 msgid ""
19442 "This calls the external C<zfgrep -i> program and returns the matching lines."
19443 msgstr ""
19444
19445 # type: =head2
19446 #. type: =head2
19447 #: ../src/guestfs-actions.pod:7156
19448 msgid "guestfs_zfile"
19449 msgstr ""
19450
19451 # type: verbatim
19452 #. type: verbatim
19453 #: ../src/guestfs-actions.pod:7158
19454 #, no-wrap
19455 msgid ""
19456 " char *\n"
19457 " guestfs_zfile (guestfs_h *g,\n"
19458 "                const char *meth,\n"
19459 "                const char *path);\n"
19460 "\n"
19461 msgstr ""
19462
19463 # type: textblock
19464 #. type: textblock
19465 #: ../src/guestfs-actions.pod:7163 ../fish/guestfish-actions.pod:4743
19466 msgid ""
19467 "This command runs C<file> after first decompressing C<path> using C<method>."
19468 msgstr ""
19469
19470 # type: textblock
19471 #. type: textblock
19472 #: ../src/guestfs-actions.pod:7166 ../fish/guestfish-actions.pod:4746
19473 msgid "C<method> must be one of C<gzip>, C<compress> or C<bzip2>."
19474 msgstr ""
19475
19476 # type: textblock
19477 #. type: textblock
19478 #: ../src/guestfs-actions.pod:7168
19479 msgid ""
19480 "Since 1.0.63, use C<guestfs_file> instead which can now process compressed "
19481 "files."
19482 msgstr ""
19483
19484 #. type: textblock
19485 #: ../src/guestfs-actions.pod:7174
19486 msgid ""
19487 "This function is deprecated.  In new code, use the L</guestfs_file> call "
19488 "instead."
19489 msgstr ""
19490
19491 # type: =head2
19492 #. type: =head2
19493 #: ../src/guestfs-actions.pod:7183
19494 msgid "guestfs_zgrep"
19495 msgstr ""
19496
19497 # type: verbatim
19498 #. type: verbatim
19499 #: ../src/guestfs-actions.pod:7185
19500 #, no-wrap
19501 msgid ""
19502 " char **\n"
19503 " guestfs_zgrep (guestfs_h *g,\n"
19504 "                const char *regex,\n"
19505 "                const char *path);\n"
19506 "\n"
19507 msgstr ""
19508
19509 # type: textblock
19510 #. type: textblock
19511 #: ../src/guestfs-actions.pod:7190 ../fish/guestfish-actions.pod:4762
19512 msgid ""
19513 "This calls the external C<zgrep> program and returns the matching lines."
19514 msgstr ""
19515
19516 # type: =head2
19517 #. type: =head2
19518 #: ../src/guestfs-actions.pod:7202
19519 msgid "guestfs_zgrepi"
19520 msgstr ""
19521
19522 # type: verbatim
19523 #. type: verbatim
19524 #: ../src/guestfs-actions.pod:7204
19525 #, no-wrap
19526 msgid ""
19527 " char **\n"
19528 " guestfs_zgrepi (guestfs_h *g,\n"
19529 "                 const char *regex,\n"
19530 "                 const char *path);\n"
19531 "\n"
19532 msgstr ""
19533
19534 # type: textblock
19535 #. type: textblock
19536 #: ../src/guestfs-actions.pod:7209 ../fish/guestfish-actions.pod:4772
19537 msgid ""
19538 "This calls the external C<zgrep -i> program and returns the matching lines."
19539 msgstr ""
19540
19541 # type: =item
19542 #. type: =item
19543 #: ../src/guestfs-availability.pod:3
19544 msgid "B<augeas>"
19545 msgstr ""
19546
19547 # type: textblock
19548 #. type: textblock
19549 #: ../src/guestfs-availability.pod:5
19550 msgid ""
19551 "The following functions: L</guestfs_aug_clear> L</guestfs_aug_close> L</"
19552 "guestfs_aug_defnode> L</guestfs_aug_defvar> L</guestfs_aug_get> L</"
19553 "guestfs_aug_init> L</guestfs_aug_insert> L</guestfs_aug_load> L</"
19554 "guestfs_aug_ls> L</guestfs_aug_match> L</guestfs_aug_mv> L</guestfs_aug_rm> "
19555 "L</guestfs_aug_save> L</guestfs_aug_set>"
19556 msgstr ""
19557
19558 #. type: =item
19559 #: ../src/guestfs-availability.pod:21
19560 msgid "B<grub>"
19561 msgstr ""
19562
19563 #. type: textblock
19564 #: ../src/guestfs-availability.pod:23
19565 msgid "The following functions: L</guestfs_grub_install>"
19566 msgstr ""
19567
19568 # type: =item
19569 #. type: =item
19570 #: ../src/guestfs-availability.pod:26
19571 msgid "B<inotify>"
19572 msgstr ""
19573
19574 # type: textblock
19575 #. type: textblock
19576 #: ../src/guestfs-availability.pod:28
19577 msgid ""
19578 "The following functions: L</guestfs_inotify_add_watch> L</"
19579 "guestfs_inotify_close> L</guestfs_inotify_files> L</guestfs_inotify_init> L</"
19580 "guestfs_inotify_read> L</guestfs_inotify_rm_watch>"
19581 msgstr ""
19582
19583 # type: =item
19584 #. type: =item
19585 #: ../src/guestfs-availability.pod:36
19586 msgid "B<linuxfsuuid>"
19587 msgstr ""
19588
19589 # type: textblock
19590 #. type: textblock
19591 #: ../src/guestfs-availability.pod:38
19592 msgid ""
19593 "The following functions: L</guestfs_mke2fs_JU> L</guestfs_mke2journal_U> L</"
19594 "guestfs_mkswap_U> L</guestfs_swapoff_uuid> L</guestfs_swapon_uuid>"
19595 msgstr ""
19596
19597 # type: =item
19598 #. type: =item
19599 #: ../src/guestfs-availability.pod:45
19600 msgid "B<linuxmodules>"
19601 msgstr ""
19602
19603 # type: textblock
19604 #. type: textblock
19605 #: ../src/guestfs-availability.pod:47
19606 msgid "The following functions: L</guestfs_modprobe>"
19607 msgstr ""
19608
19609 # type: =item
19610 #. type: =item
19611 #: ../src/guestfs-availability.pod:50
19612 msgid "B<linuxxattrs>"
19613 msgstr ""
19614
19615 # type: textblock
19616 #. type: textblock
19617 #: ../src/guestfs-availability.pod:52
19618 msgid ""
19619 "The following functions: L</guestfs_getxattr> L</guestfs_getxattrs> L</"
19620 "guestfs_lgetxattr> L</guestfs_lgetxattrs> L</guestfs_lremovexattr> L</"
19621 "guestfs_lsetxattr> L</guestfs_lxattrlist> L</guestfs_removexattr> L</"
19622 "guestfs_setxattr>"
19623 msgstr ""
19624
19625 # type: =item
19626 #. type: =item
19627 #: ../src/guestfs-availability.pod:63
19628 msgid "B<luks>"
19629 msgstr ""
19630
19631 # type: textblock
19632 #. type: textblock
19633 #: ../src/guestfs-availability.pod:65
19634 msgid ""
19635 "The following functions: L</guestfs_luks_add_key> L</guestfs_luks_close> L</"
19636 "guestfs_luks_format> L</guestfs_luks_format_cipher> L</"
19637 "guestfs_luks_kill_slot> L</guestfs_luks_open> L</guestfs_luks_open_ro>"
19638 msgstr ""
19639
19640 # type: =item
19641 #. type: =item
19642 #: ../src/guestfs-availability.pod:74
19643 msgid "B<lvm2>"
19644 msgstr ""
19645
19646 # type: textblock
19647 #. type: textblock
19648 #: ../src/guestfs-availability.pod:76
19649 msgid ""
19650 "The following functions: L</guestfs_is_lv> L</guestfs_lvcreate> L</"
19651 "guestfs_lvm_remove_all> L</guestfs_lvm_set_filter> L</guestfs_lvremove> L</"
19652 "guestfs_lvresize> L</guestfs_lvresize_free> L</guestfs_lvs> L</"
19653 "guestfs_lvs_full> L</guestfs_pvcreate> L</guestfs_pvremove> L</"
19654 "guestfs_pvresize> L</guestfs_pvresize_size> L</guestfs_pvs> L</"
19655 "guestfs_pvs_full> L</guestfs_vg_activate> L</guestfs_vg_activate_all> L</"
19656 "guestfs_vgcreate> L</guestfs_vgremove> L</guestfs_vgs> L</guestfs_vgs_full>"
19657 msgstr ""
19658
19659 # type: =item
19660 #. type: =item
19661 #: ../src/guestfs-availability.pod:99
19662 msgid "B<mknod>"
19663 msgstr ""
19664
19665 # type: textblock
19666 #. type: textblock
19667 #: ../src/guestfs-availability.pod:101
19668 msgid ""
19669 "The following functions: L</guestfs_mkfifo> L</guestfs_mknod> L</"
19670 "guestfs_mknod_b> L</guestfs_mknod_c>"
19671 msgstr ""
19672
19673 # type: =item
19674 #. type: =item
19675 #: ../src/guestfs-availability.pod:107
19676 msgid "B<ntfs3g>"
19677 msgstr ""
19678
19679 # type: textblock
19680 #. type: textblock
19681 #: ../src/guestfs-availability.pod:109
19682 msgid "The following functions: L</guestfs_ntfs_3g_probe>"
19683 msgstr ""
19684
19685 # type: =item
19686 #. type: =item
19687 #: ../src/guestfs-availability.pod:112
19688 msgid "B<ntfsprogs>"
19689 msgstr ""
19690
19691 # type: textblock
19692 #. type: textblock
19693 #: ../src/guestfs-availability.pod:114
19694 msgid ""
19695 "The following functions: L</guestfs_ntfsresize> L</guestfs_ntfsresize_size>"
19696 msgstr ""
19697
19698 # type: =item
19699 #. type: =item
19700 #: ../src/guestfs-availability.pod:118
19701 msgid "B<realpath>"
19702 msgstr ""
19703
19704 # type: textblock
19705 #. type: textblock
19706 #: ../src/guestfs-availability.pod:120
19707 msgid "The following functions: L</guestfs_realpath>"
19708 msgstr ""
19709
19710 # type: =item
19711 #. type: =item
19712 #: ../src/guestfs-availability.pod:123
19713 msgid "B<scrub>"
19714 msgstr ""
19715
19716 # type: textblock
19717 #. type: textblock
19718 #: ../src/guestfs-availability.pod:125
19719 msgid ""
19720 "The following functions: L</guestfs_scrub_device> L</guestfs_scrub_file> L</"
19721 "guestfs_scrub_freespace>"
19722 msgstr ""
19723
19724 # type: =item
19725 #. type: =item
19726 #: ../src/guestfs-availability.pod:130
19727 msgid "B<selinux>"
19728 msgstr ""
19729
19730 # type: textblock
19731 #. type: textblock
19732 #: ../src/guestfs-availability.pod:132
19733 msgid "The following functions: L</guestfs_getcon> L</guestfs_setcon>"
19734 msgstr ""
19735
19736 # type: =item
19737 #. type: =item
19738 #: ../src/guestfs-availability.pod:136
19739 msgid "B<xz>"
19740 msgstr ""
19741
19742 # type: textblock
19743 #. type: textblock
19744 #: ../src/guestfs-availability.pod:138
19745 msgid "The following functions: L</guestfs_txz_in> L</guestfs_txz_out>"
19746 msgstr ""
19747
19748 # type: =item
19749 #. type: =item
19750 #: ../src/guestfs-availability.pod:142
19751 msgid "B<zerofree>"
19752 msgstr ""
19753
19754 # type: textblock
19755 #. type: textblock
19756 #: ../src/guestfs-availability.pod:144
19757 msgid "The following functions: L</guestfs_zerofree>"
19758 msgstr ""
19759
19760 # type: =head2
19761 #. type: =head2
19762 #: ../src/guestfs-structs.pod:1
19763 msgid "guestfs_int_bool"
19764 msgstr ""
19765
19766 # type: verbatim
19767 #. type: verbatim
19768 #: ../src/guestfs-structs.pod:3
19769 #, no-wrap
19770 msgid ""
19771 " struct guestfs_int_bool {\n"
19772 "   int32_t i;\n"
19773 "   int32_t b;\n"
19774 " };\n"
19775 " \n"
19776 msgstr ""
19777
19778 # type: verbatim
19779 #. type: verbatim
19780 #: ../src/guestfs-structs.pod:8
19781 #, no-wrap
19782 msgid ""
19783 " struct guestfs_int_bool_list {\n"
19784 "   uint32_t len; /* Number of elements in list. */\n"
19785 "   struct guestfs_int_bool *val; /* Elements. */\n"
19786 " };\n"
19787 " \n"
19788 msgstr ""
19789
19790 # type: verbatim
19791 #. type: verbatim
19792 #: ../src/guestfs-structs.pod:13
19793 #, no-wrap
19794 msgid ""
19795 " void guestfs_free_int_bool (struct guestfs_free_int_bool *);\n"
19796 " void guestfs_free_int_bool_list (struct guestfs_free_int_bool_list *);\n"
19797 "\n"
19798 msgstr ""
19799
19800 # type: =head2
19801 #. type: =head2
19802 #: ../src/guestfs-structs.pod:16
19803 msgid "guestfs_lvm_pv"
19804 msgstr ""
19805
19806 # type: verbatim
19807 #. type: verbatim
19808 #: ../src/guestfs-structs.pod:18
19809 #, no-wrap
19810 msgid ""
19811 " struct guestfs_lvm_pv {\n"
19812 "   char *pv_name;\n"
19813 "   /* The next field is NOT nul-terminated, be careful when printing it: */\n"
19814 "   char pv_uuid[32];\n"
19815 "   char *pv_fmt;\n"
19816 "   uint64_t pv_size;\n"
19817 "   uint64_t dev_size;\n"
19818 "   uint64_t pv_free;\n"
19819 "   uint64_t pv_used;\n"
19820 "   char *pv_attr;\n"
19821 "   int64_t pv_pe_count;\n"
19822 "   int64_t pv_pe_alloc_count;\n"
19823 "   char *pv_tags;\n"
19824 "   uint64_t pe_start;\n"
19825 "   int64_t pv_mda_count;\n"
19826 "   uint64_t pv_mda_free;\n"
19827 " };\n"
19828 " \n"
19829 msgstr ""
19830
19831 # type: verbatim
19832 #. type: verbatim
19833 #: ../src/guestfs-structs.pod:36
19834 #, no-wrap
19835 msgid ""
19836 " struct guestfs_lvm_pv_list {\n"
19837 "   uint32_t len; /* Number of elements in list. */\n"
19838 "   struct guestfs_lvm_pv *val; /* Elements. */\n"
19839 " };\n"
19840 " \n"
19841 msgstr ""
19842
19843 # type: verbatim
19844 #. type: verbatim
19845 #: ../src/guestfs-structs.pod:41
19846 #, no-wrap
19847 msgid ""
19848 " void guestfs_free_lvm_pv (struct guestfs_free_lvm_pv *);\n"
19849 " void guestfs_free_lvm_pv_list (struct guestfs_free_lvm_pv_list *);\n"
19850 "\n"
19851 msgstr ""
19852
19853 # type: =head2
19854 #. type: =head2
19855 #: ../src/guestfs-structs.pod:44
19856 msgid "guestfs_lvm_vg"
19857 msgstr ""
19858
19859 # type: verbatim
19860 #. type: verbatim
19861 #: ../src/guestfs-structs.pod:46
19862 #, no-wrap
19863 msgid ""
19864 " struct guestfs_lvm_vg {\n"
19865 "   char *vg_name;\n"
19866 "   /* The next field is NOT nul-terminated, be careful when printing it: */\n"
19867 "   char vg_uuid[32];\n"
19868 "   char *vg_fmt;\n"
19869 "   char *vg_attr;\n"
19870 "   uint64_t vg_size;\n"
19871 "   uint64_t vg_free;\n"
19872 "   char *vg_sysid;\n"
19873 "   uint64_t vg_extent_size;\n"
19874 "   int64_t vg_extent_count;\n"
19875 "   int64_t vg_free_count;\n"
19876 "   int64_t max_lv;\n"
19877 "   int64_t max_pv;\n"
19878 "   int64_t pv_count;\n"
19879 "   int64_t lv_count;\n"
19880 "   int64_t snap_count;\n"
19881 "   int64_t vg_seqno;\n"
19882 "   char *vg_tags;\n"
19883 "   int64_t vg_mda_count;\n"
19884 "   uint64_t vg_mda_free;\n"
19885 " };\n"
19886 " \n"
19887 msgstr ""
19888
19889 # type: verbatim
19890 #. type: verbatim
19891 #: ../src/guestfs-structs.pod:69
19892 #, no-wrap
19893 msgid ""
19894 " struct guestfs_lvm_vg_list {\n"
19895 "   uint32_t len; /* Number of elements in list. */\n"
19896 "   struct guestfs_lvm_vg *val; /* Elements. */\n"
19897 " };\n"
19898 " \n"
19899 msgstr ""
19900
19901 # type: verbatim
19902 #. type: verbatim
19903 #: ../src/guestfs-structs.pod:74
19904 #, no-wrap
19905 msgid ""
19906 " void guestfs_free_lvm_vg (struct guestfs_free_lvm_vg *);\n"
19907 " void guestfs_free_lvm_vg_list (struct guestfs_free_lvm_vg_list *);\n"
19908 "\n"
19909 msgstr ""
19910
19911 # type: =head2
19912 #. type: =head2
19913 #: ../src/guestfs-structs.pod:77
19914 msgid "guestfs_lvm_lv"
19915 msgstr ""
19916
19917 # type: verbatim
19918 #. type: verbatim
19919 #: ../src/guestfs-structs.pod:79
19920 #, no-wrap
19921 msgid ""
19922 " struct guestfs_lvm_lv {\n"
19923 "   char *lv_name;\n"
19924 "   /* The next field is NOT nul-terminated, be careful when printing it: */\n"
19925 "   char lv_uuid[32];\n"
19926 "   char *lv_attr;\n"
19927 "   int64_t lv_major;\n"
19928 "   int64_t lv_minor;\n"
19929 "   int64_t lv_kernel_major;\n"
19930 "   int64_t lv_kernel_minor;\n"
19931 "   uint64_t lv_size;\n"
19932 "   int64_t seg_count;\n"
19933 "   char *origin;\n"
19934 "   /* The next field is [0..100] or -1 meaning 'not present': */\n"
19935 "   float snap_percent;\n"
19936 "   /* The next field is [0..100] or -1 meaning 'not present': */\n"
19937 "   float copy_percent;\n"
19938 "   char *move_pv;\n"
19939 "   char *lv_tags;\n"
19940 "   char *mirror_log;\n"
19941 "   char *modules;\n"
19942 " };\n"
19943 " \n"
19944 msgstr ""
19945
19946 # type: verbatim
19947 #. type: verbatim
19948 #: ../src/guestfs-structs.pod:101
19949 #, no-wrap
19950 msgid ""
19951 " struct guestfs_lvm_lv_list {\n"
19952 "   uint32_t len; /* Number of elements in list. */\n"
19953 "   struct guestfs_lvm_lv *val; /* Elements. */\n"
19954 " };\n"
19955 " \n"
19956 msgstr ""
19957
19958 # type: verbatim
19959 #. type: verbatim
19960 #: ../src/guestfs-structs.pod:106
19961 #, no-wrap
19962 msgid ""
19963 " void guestfs_free_lvm_lv (struct guestfs_free_lvm_lv *);\n"
19964 " void guestfs_free_lvm_lv_list (struct guestfs_free_lvm_lv_list *);\n"
19965 "\n"
19966 msgstr ""
19967
19968 # type: verbatim
19969 #. type: verbatim
19970 #: ../src/guestfs-structs.pod:111
19971 #, no-wrap
19972 msgid ""
19973 " struct guestfs_stat {\n"
19974 "   int64_t dev;\n"
19975 "   int64_t ino;\n"
19976 "   int64_t mode;\n"
19977 "   int64_t nlink;\n"
19978 "   int64_t uid;\n"
19979 "   int64_t gid;\n"
19980 "   int64_t rdev;\n"
19981 "   int64_t size;\n"
19982 "   int64_t blksize;\n"
19983 "   int64_t blocks;\n"
19984 "   int64_t atime;\n"
19985 "   int64_t mtime;\n"
19986 "   int64_t ctime;\n"
19987 " };\n"
19988 " \n"
19989 msgstr ""
19990
19991 # type: verbatim
19992 #. type: verbatim
19993 #: ../src/guestfs-structs.pod:127
19994 #, no-wrap
19995 msgid ""
19996 " struct guestfs_stat_list {\n"
19997 "   uint32_t len; /* Number of elements in list. */\n"
19998 "   struct guestfs_stat *val; /* Elements. */\n"
19999 " };\n"
20000 " \n"
20001 msgstr ""
20002
20003 # type: verbatim
20004 #. type: verbatim
20005 #: ../src/guestfs-structs.pod:132
20006 #, no-wrap
20007 msgid ""
20008 " void guestfs_free_stat (struct guestfs_free_stat *);\n"
20009 " void guestfs_free_stat_list (struct guestfs_free_stat_list *);\n"
20010 "\n"
20011 msgstr ""
20012
20013 # type: verbatim
20014 #. type: verbatim
20015 #: ../src/guestfs-structs.pod:137
20016 #, no-wrap
20017 msgid ""
20018 " struct guestfs_statvfs {\n"
20019 "   int64_t bsize;\n"
20020 "   int64_t frsize;\n"
20021 "   int64_t blocks;\n"
20022 "   int64_t bfree;\n"
20023 "   int64_t bavail;\n"
20024 "   int64_t files;\n"
20025 "   int64_t ffree;\n"
20026 "   int64_t favail;\n"
20027 "   int64_t fsid;\n"
20028 "   int64_t flag;\n"
20029 "   int64_t namemax;\n"
20030 " };\n"
20031 " \n"
20032 msgstr ""
20033
20034 # type: verbatim
20035 #. type: verbatim
20036 #: ../src/guestfs-structs.pod:151
20037 #, no-wrap
20038 msgid ""
20039 " struct guestfs_statvfs_list {\n"
20040 "   uint32_t len; /* Number of elements in list. */\n"
20041 "   struct guestfs_statvfs *val; /* Elements. */\n"
20042 " };\n"
20043 " \n"
20044 msgstr ""
20045
20046 # type: verbatim
20047 #. type: verbatim
20048 #: ../src/guestfs-structs.pod:156
20049 #, no-wrap
20050 msgid ""
20051 " void guestfs_free_statvfs (struct guestfs_free_statvfs *);\n"
20052 " void guestfs_free_statvfs_list (struct guestfs_free_statvfs_list *);\n"
20053 "\n"
20054 msgstr ""
20055
20056 # type: =head2
20057 #. type: =head2
20058 #: ../src/guestfs-structs.pod:159
20059 msgid "guestfs_dirent"
20060 msgstr ""
20061
20062 # type: verbatim
20063 #. type: verbatim
20064 #: ../src/guestfs-structs.pod:161
20065 #, no-wrap
20066 msgid ""
20067 " struct guestfs_dirent {\n"
20068 "   int64_t ino;\n"
20069 "   char ftyp;\n"
20070 "   char *name;\n"
20071 " };\n"
20072 " \n"
20073 msgstr ""
20074
20075 # type: verbatim
20076 #. type: verbatim
20077 #: ../src/guestfs-structs.pod:167
20078 #, no-wrap
20079 msgid ""
20080 " struct guestfs_dirent_list {\n"
20081 "   uint32_t len; /* Number of elements in list. */\n"
20082 "   struct guestfs_dirent *val; /* Elements. */\n"
20083 " };\n"
20084 " \n"
20085 msgstr ""
20086
20087 # type: verbatim
20088 #. type: verbatim
20089 #: ../src/guestfs-structs.pod:172
20090 #, no-wrap
20091 msgid ""
20092 " void guestfs_free_dirent (struct guestfs_free_dirent *);\n"
20093 " void guestfs_free_dirent_list (struct guestfs_free_dirent_list *);\n"
20094 "\n"
20095 msgstr ""
20096
20097 # type: verbatim
20098 #. type: verbatim
20099 #: ../src/guestfs-structs.pod:177
20100 #, no-wrap
20101 msgid ""
20102 " struct guestfs_version {\n"
20103 "   int64_t major;\n"
20104 "   int64_t minor;\n"
20105 "   int64_t release;\n"
20106 "   char *extra;\n"
20107 " };\n"
20108 " \n"
20109 msgstr ""
20110
20111 # type: verbatim
20112 #. type: verbatim
20113 #: ../src/guestfs-structs.pod:184
20114 #, no-wrap
20115 msgid ""
20116 " struct guestfs_version_list {\n"
20117 "   uint32_t len; /* Number of elements in list. */\n"
20118 "   struct guestfs_version *val; /* Elements. */\n"
20119 " };\n"
20120 " \n"
20121 msgstr ""
20122
20123 # type: verbatim
20124 #. type: verbatim
20125 #: ../src/guestfs-structs.pod:189
20126 #, no-wrap
20127 msgid ""
20128 " void guestfs_free_version (struct guestfs_free_version *);\n"
20129 " void guestfs_free_version_list (struct guestfs_free_version_list *);\n"
20130 "\n"
20131 msgstr ""
20132
20133 # type: =head2
20134 #. type: =head2
20135 #: ../src/guestfs-structs.pod:192
20136 msgid "guestfs_xattr"
20137 msgstr ""
20138
20139 # type: verbatim
20140 #. type: verbatim
20141 #: ../src/guestfs-structs.pod:194
20142 #, no-wrap
20143 msgid ""
20144 " struct guestfs_xattr {\n"
20145 "   char *attrname;\n"
20146 "   /* The next two fields describe a byte array. */\n"
20147 "   uint32_t attrval_len;\n"
20148 "   char *attrval;\n"
20149 " };\n"
20150 " \n"
20151 msgstr ""
20152
20153 # type: verbatim
20154 #. type: verbatim
20155 #: ../src/guestfs-structs.pod:201
20156 #, no-wrap
20157 msgid ""
20158 " struct guestfs_xattr_list {\n"
20159 "   uint32_t len; /* Number of elements in list. */\n"
20160 "   struct guestfs_xattr *val; /* Elements. */\n"
20161 " };\n"
20162 " \n"
20163 msgstr ""
20164
20165 # type: verbatim
20166 #. type: verbatim
20167 #: ../src/guestfs-structs.pod:206
20168 #, no-wrap
20169 msgid ""
20170 " void guestfs_free_xattr (struct guestfs_free_xattr *);\n"
20171 " void guestfs_free_xattr_list (struct guestfs_free_xattr_list *);\n"
20172 "\n"
20173 msgstr ""
20174
20175 # type: =head2
20176 #. type: =head2
20177 #: ../src/guestfs-structs.pod:209
20178 msgid "guestfs_inotify_event"
20179 msgstr ""
20180
20181 # type: verbatim
20182 #. type: verbatim
20183 #: ../src/guestfs-structs.pod:211
20184 #, no-wrap
20185 msgid ""
20186 " struct guestfs_inotify_event {\n"
20187 "   int64_t in_wd;\n"
20188 "   uint32_t in_mask;\n"
20189 "   uint32_t in_cookie;\n"
20190 "   char *in_name;\n"
20191 " };\n"
20192 " \n"
20193 msgstr ""
20194
20195 # type: verbatim
20196 #. type: verbatim
20197 #: ../src/guestfs-structs.pod:218
20198 #, no-wrap
20199 msgid ""
20200 " struct guestfs_inotify_event_list {\n"
20201 "   uint32_t len; /* Number of elements in list. */\n"
20202 "   struct guestfs_inotify_event *val; /* Elements. */\n"
20203 " };\n"
20204 " \n"
20205 msgstr ""
20206
20207 # type: verbatim
20208 #. type: verbatim
20209 #: ../src/guestfs-structs.pod:223
20210 #, no-wrap
20211 msgid ""
20212 " void guestfs_free_inotify_event (struct guestfs_free_inotify_event *);\n"
20213 " void guestfs_free_inotify_event_list (struct guestfs_free_inotify_event_list *);\n"
20214 "\n"
20215 msgstr ""
20216
20217 # type: =head2
20218 #. type: =head2
20219 #: ../src/guestfs-structs.pod:226
20220 msgid "guestfs_partition"
20221 msgstr ""
20222
20223 # type: verbatim
20224 #. type: verbatim
20225 #: ../src/guestfs-structs.pod:228
20226 #, no-wrap
20227 msgid ""
20228 " struct guestfs_partition {\n"
20229 "   int32_t part_num;\n"
20230 "   uint64_t part_start;\n"
20231 "   uint64_t part_end;\n"
20232 "   uint64_t part_size;\n"
20233 " };\n"
20234 " \n"
20235 msgstr ""
20236
20237 # type: verbatim
20238 #. type: verbatim
20239 #: ../src/guestfs-structs.pod:235
20240 #, no-wrap
20241 msgid ""
20242 " struct guestfs_partition_list {\n"
20243 "   uint32_t len; /* Number of elements in list. */\n"
20244 "   struct guestfs_partition *val; /* Elements. */\n"
20245 " };\n"
20246 " \n"
20247 msgstr ""
20248
20249 # type: verbatim
20250 #. type: verbatim
20251 #: ../src/guestfs-structs.pod:240
20252 #, no-wrap
20253 msgid ""
20254 " void guestfs_free_partition (struct guestfs_free_partition *);\n"
20255 " void guestfs_free_partition_list (struct guestfs_free_partition_list *);\n"
20256 "\n"
20257 msgstr ""
20258
20259 # type: =head2
20260 #. type: =head2
20261 #: ../src/guestfs-structs.pod:243
20262 msgid "guestfs_application"
20263 msgstr ""
20264
20265 # type: verbatim
20266 #. type: verbatim
20267 #: ../src/guestfs-structs.pod:245
20268 #, no-wrap
20269 msgid ""
20270 " struct guestfs_application {\n"
20271 "   char *app_name;\n"
20272 "   char *app_display_name;\n"
20273 "   int32_t app_epoch;\n"
20274 "   char *app_version;\n"
20275 "   char *app_release;\n"
20276 "   char *app_install_path;\n"
20277 "   char *app_trans_path;\n"
20278 "   char *app_publisher;\n"
20279 "   char *app_url;\n"
20280 "   char *app_source_package;\n"
20281 "   char *app_summary;\n"
20282 "   char *app_description;\n"
20283 " };\n"
20284 " \n"
20285 msgstr ""
20286
20287 # type: verbatim
20288 #. type: verbatim
20289 #: ../src/guestfs-structs.pod:260
20290 #, no-wrap
20291 msgid ""
20292 " struct guestfs_application_list {\n"
20293 "   uint32_t len; /* Number of elements in list. */\n"
20294 "   struct guestfs_application *val; /* Elements. */\n"
20295 " };\n"
20296 " \n"
20297 msgstr ""
20298
20299 # type: verbatim
20300 #. type: verbatim
20301 #: ../src/guestfs-structs.pod:265
20302 #, no-wrap
20303 msgid ""
20304 " void guestfs_free_application (struct guestfs_free_application *);\n"
20305 " void guestfs_free_application_list (struct guestfs_free_application_list *);\n"
20306 "\n"
20307 msgstr ""
20308
20309 # type: textblock
20310 #. type: textblock
20311 #: ../fish/guestfish.pod:5
20312 msgid "guestfish - the libguestfs Filesystem Interactive SHell"
20313 msgstr ""
20314
20315 # type: verbatim
20316 #. type: verbatim
20317 #: ../fish/guestfish.pod:9
20318 #, no-wrap
20319 msgid ""
20320 " guestfish [--options] [commands]\n"
20321 "\n"
20322 msgstr ""
20323
20324 # type: verbatim
20325 #. type: verbatim
20326 #: ../fish/guestfish.pod:11
20327 #, no-wrap
20328 msgid ""
20329 " guestfish\n"
20330 "\n"
20331 msgstr ""
20332
20333 # type: verbatim
20334 #. type: verbatim
20335 #: ../fish/guestfish.pod:13
20336 #, no-wrap
20337 msgid ""
20338 " guestfish [--ro|--rw] -a disk.img\n"
20339 "\n"
20340 msgstr ""
20341
20342 # type: verbatim
20343 #. type: verbatim
20344 #: ../fish/guestfish.pod:15
20345 #, no-wrap
20346 msgid ""
20347 " guestfish [--ro|--rw] -a disk.img -m dev[:mountpoint]\n"
20348 "\n"
20349 msgstr ""
20350
20351 # type: verbatim
20352 #. type: verbatim
20353 #: ../fish/guestfish.pod:17
20354 #, no-wrap
20355 msgid ""
20356 " guestfish -d libvirt-domain\n"
20357 "\n"
20358 msgstr ""
20359
20360 # type: verbatim
20361 #. type: verbatim
20362 #: ../fish/guestfish.pod:19
20363 #, no-wrap
20364 msgid ""
20365 " guestfish [--ro|--rw] -a disk.img -i\n"
20366 "\n"
20367 msgstr ""
20368
20369 # type: verbatim
20370 #. type: verbatim
20371 #: ../fish/guestfish.pod:21
20372 #, no-wrap
20373 msgid ""
20374 " guestfish -d libvirt-domain -i\n"
20375 "\n"
20376 msgstr ""
20377
20378 # type: =head1
20379 #. type: =head1
20380 #: ../fish/guestfish.pod:23 ../fuse/guestmount.pod:15 ../tools/virt-edit.pl:44
20381 #: ../tools/virt-win-reg.pl:51 ../tools/virt-tar.pl:59
20382 msgid "WARNING"
20383 msgstr ""
20384
20385 # type: textblock
20386 #. type: textblock
20387 #: ../fish/guestfish.pod:25
20388 msgid ""
20389 "Using guestfish in read/write mode on live virtual machines can be "
20390 "dangerous, potentially causing disk corruption.  Use the I<--ro> (read-only) "
20391 "option to use guestfish safely if the disk image or virtual machine might be "
20392 "live."
20393 msgstr ""
20394
20395 # type: textblock
20396 #. type: textblock
20397 #: ../fish/guestfish.pod:32
20398 msgid ""
20399 "Guestfish is a shell and command-line tool for examining and modifying "
20400 "virtual machine filesystems.  It uses libguestfs and exposes all of the "
20401 "functionality of the guestfs API, see L<guestfs(3)>."
20402 msgstr ""
20403
20404 # type: textblock
20405 #. type: textblock
20406 #: ../fish/guestfish.pod:36
20407 msgid ""
20408 "Guestfish gives you structured access to the libguestfs API, from shell "
20409 "scripts or the command line or interactively.  If you want to rescue a "
20410 "broken virtual machine image, you should look at the L<virt-rescue(1)> "
20411 "command."
20412 msgstr ""
20413
20414 # type: =head1
20415 #. type: =head1
20416 #: ../fish/guestfish.pod:41 ../fish/guestfish.pod:908
20417 #: ../fuse/guestmount.pod:39 ../tools/virt-edit.pl:63
20418 #: ../tools/virt-resize.pl:64 ../tools/virt-tar.pl:45
20419 msgid "EXAMPLES"
20420 msgstr ""
20421
20422 # type: =head2
20423 #. type: =head2
20424 #: ../fish/guestfish.pod:43
20425 msgid "As an interactive shell"
20426 msgstr ""
20427
20428 # type: verbatim
20429 #. type: verbatim
20430 #: ../fish/guestfish.pod:45
20431 #, no-wrap
20432 msgid ""
20433 " $ guestfish\n"
20434 " \n"
20435 msgstr ""
20436
20437 # type: verbatim
20438 #. type: verbatim
20439 #: ../fish/guestfish.pod:47
20440 #, no-wrap
20441 msgid ""
20442 " Welcome to guestfish, the libguestfs filesystem interactive shell for\n"
20443 " editing virtual machine filesystems.\n"
20444 " \n"
20445 msgstr ""
20446
20447 # type: verbatim
20448 #. type: verbatim
20449 #: ../fish/guestfish.pod:50
20450 #, no-wrap
20451 msgid ""
20452 " Type: 'help' for a list of commands\n"
20453 "       'man' to read the manual\n"
20454 "       'quit' to quit the shell\n"
20455 " \n"
20456 msgstr ""
20457
20458 # type: verbatim
20459 #. type: verbatim
20460 #: ../fish/guestfish.pod:54
20461 #, no-wrap
20462 msgid ""
20463 " ><fs> add-ro disk.img\n"
20464 " ><fs> run\n"
20465 " ><fs> list-filesystems\n"
20466 " /dev/sda1: ext4\n"
20467 " /dev/vg_guest/lv_root: ext4\n"
20468 " /dev/vg_guest/lv_swap: swap\n"
20469 " ><fs> mount /dev/vg_guest/lv_root /\n"
20470 " ><fs> cat /etc/fstab\n"
20471 " # /etc/fstab\n"
20472 " # Created by anaconda\n"
20473 " [...]\n"
20474 " ><fs> exit\n"
20475 "\n"
20476 msgstr ""
20477
20478 # type: =head2
20479 #. type: =head2
20480 #: ../fish/guestfish.pod:67
20481 msgid "From shell scripts"
20482 msgstr ""
20483
20484 # type: textblock
20485 #. type: textblock
20486 #: ../fish/guestfish.pod:69
20487 msgid "Create a new C</etc/motd> file in a guest or disk image:"
20488 msgstr ""
20489
20490 # type: verbatim
20491 #. type: verbatim
20492 #: ../fish/guestfish.pod:71
20493 #, no-wrap
20494 msgid ""
20495 " guestfish <<_EOF_\n"
20496 " add disk.img\n"
20497 " run\n"
20498 " mount /dev/vg_guest/lv_root /\n"
20499 " write /etc/motd \"Welcome, new users\"\n"
20500 " _EOF_\n"
20501 "\n"
20502 msgstr ""
20503
20504 # type: textblock
20505 #. type: textblock
20506 #: ../fish/guestfish.pod:78
20507 msgid "List the LVM logical volumes in a disk image:"
20508 msgstr ""
20509
20510 # type: verbatim
20511 #. type: verbatim
20512 #: ../fish/guestfish.pod:80
20513 #, no-wrap
20514 msgid ""
20515 " guestfish -a disk.img --ro <<_EOF_\n"
20516 " run\n"
20517 " lvs\n"
20518 " _EOF_\n"
20519 "\n"
20520 msgstr ""
20521
20522 # type: textblock
20523 #. type: textblock
20524 #: ../fish/guestfish.pod:85
20525 msgid "List all the filesystems in a disk image:"
20526 msgstr ""
20527
20528 # type: verbatim
20529 #. type: verbatim
20530 #: ../fish/guestfish.pod:87
20531 #, no-wrap
20532 msgid ""
20533 " guestfish -a disk.img --ro <<_EOF_\n"
20534 " run\n"
20535 " list-filesystems\n"
20536 " _EOF_\n"
20537 "\n"
20538 msgstr ""
20539
20540 # type: =head2
20541 #. type: =head2
20542 #: ../fish/guestfish.pod:92
20543 msgid "On one command line"
20544 msgstr ""
20545
20546 # type: textblock
20547 #. type: textblock
20548 #: ../fish/guestfish.pod:94
20549 msgid "Update C</etc/resolv.conf> in a guest:"
20550 msgstr ""
20551
20552 # type: verbatim
20553 #. type: verbatim
20554 #: ../fish/guestfish.pod:96
20555 #, no-wrap
20556 msgid ""
20557 " guestfish \\\n"
20558 "   add disk.img : run : mount /dev/vg_guest/lv_root / : \\\n"
20559 "   write /etc/resolv.conf \"nameserver 1.2.3.4\"\n"
20560 "\n"
20561 msgstr ""
20562
20563 # type: textblock
20564 #. type: textblock
20565 #: ../fish/guestfish.pod:100
20566 msgid "Edit C</boot/grub/grub.conf> interactively:"
20567 msgstr ""
20568
20569 # type: verbatim
20570 #. type: verbatim
20571 #: ../fish/guestfish.pod:102
20572 #, no-wrap
20573 msgid ""
20574 " guestfish --rw --add disk.img \\\n"
20575 "   --mount /dev/vg_guest/lv_root \\\n"
20576 "   --mount /dev/sda1:/boot \\\n"
20577 "   edit /boot/grub/grub.conf\n"
20578 "\n"
20579 msgstr ""
20580
20581 # type: =head2
20582 #. type: =head2
20583 #: ../fish/guestfish.pod:107
20584 msgid "Mount disks automatically"
20585 msgstr ""
20586
20587 # type: textblock
20588 #. type: textblock
20589 #: ../fish/guestfish.pod:109
20590 msgid ""
20591 "Use the I<-i> option to automatically mount the disks from a virtual machine:"
20592 msgstr ""
20593
20594 # type: verbatim
20595 #. type: verbatim
20596 #: ../fish/guestfish.pod:112
20597 #, no-wrap
20598 msgid ""
20599 " guestfish --ro -a disk.img -i cat /etc/group\n"
20600 "\n"
20601 msgstr ""
20602
20603 # type: verbatim
20604 #. type: verbatim
20605 #: ../fish/guestfish.pod:114
20606 #, no-wrap
20607 msgid ""
20608 " guestfish --ro -d libvirt-domain -i cat /etc/group\n"
20609 "\n"
20610 msgstr ""
20611
20612 # type: textblock
20613 #. type: textblock
20614 #: ../fish/guestfish.pod:116
20615 msgid "Another way to edit C</boot/grub/grub.conf> interactively is:"
20616 msgstr ""
20617
20618 # type: verbatim
20619 #. type: verbatim
20620 #: ../fish/guestfish.pod:118
20621 #, no-wrap
20622 msgid ""
20623 " guestfish --rw -a disk.img -i edit /boot/grub/grub.conf\n"
20624 "\n"
20625 msgstr ""
20626
20627 # type: =head2
20628 #. type: =head2
20629 #: ../fish/guestfish.pod:120
20630 msgid "As a script interpreter"
20631 msgstr ""
20632
20633 # type: textblock
20634 #. type: textblock
20635 #: ../fish/guestfish.pod:122
20636 msgid "Create a 100MB disk containing an ext2-formatted partition:"
20637 msgstr ""
20638
20639 # type: verbatim
20640 #. type: verbatim
20641 #: ../fish/guestfish.pod:124
20642 #, no-wrap
20643 msgid ""
20644 " #!/usr/bin/guestfish -f\n"
20645 " sparse test1.img 100M\n"
20646 " run\n"
20647 " part-disk /dev/sda mbr\n"
20648 " mkfs ext2 /dev/sda1\n"
20649 "\n"
20650 msgstr ""
20651
20652 # type: =head2
20653 #. type: =head2
20654 #: ../fish/guestfish.pod:130
20655 msgid "Start with a prepared disk"
20656 msgstr ""
20657
20658 # type: textblock
20659 #. type: textblock
20660 #: ../fish/guestfish.pod:132
20661 msgid ""
20662 "An alternate way to create a 100MB disk called C<test1.img> containing a "
20663 "single ext2-formatted partition:"
20664 msgstr ""
20665
20666 # type: verbatim
20667 #. type: verbatim
20668 #: ../fish/guestfish.pod:135
20669 #, no-wrap
20670 msgid ""
20671 " guestfish -N fs\n"
20672 "\n"
20673 msgstr ""
20674
20675 # type: textblock
20676 #. type: textblock
20677 #: ../fish/guestfish.pod:137
20678 msgid "To list what is available do:"
20679 msgstr ""
20680
20681 # type: verbatim
20682 #. type: verbatim
20683 #: ../fish/guestfish.pod:139 ../fish/guestfish.pod:899
20684 #, no-wrap
20685 msgid ""
20686 " guestfish -N help | less\n"
20687 "\n"
20688 msgstr ""
20689
20690 # type: =head2
20691 #. type: =head2
20692 #: ../fish/guestfish.pod:141
20693 msgid "Remote control"
20694 msgstr ""
20695
20696 # type: verbatim
20697 #. type: verbatim
20698 #: ../fish/guestfish.pod:143
20699 #, no-wrap
20700 msgid ""
20701 " eval \"`guestfish --listen`\"\n"
20702 " guestfish --remote add-ro disk.img\n"
20703 " guestfish --remote run\n"
20704 " guestfish --remote lvs\n"
20705 "\n"
20706 msgstr ""
20707
20708 # type: =head1
20709 #. type: =head1
20710 #: ../fish/guestfish.pod:148 ../test-tool/libguestfs-test-tool.pod:37
20711 #: ../fuse/guestmount.pod:73 ../tools/virt-edit.pl:77
20712 #: ../tools/virt-win-reg.pl:96 ../tools/virt-resize.pl:254
20713 #: ../tools/virt-list-filesystems.pl:53 ../tools/virt-tar.pl:98
20714 #: ../tools/virt-make-fs.pl:153 ../tools/virt-list-partitions.pl:54
20715 msgid "OPTIONS"
20716 msgstr ""
20717
20718 # type: =item
20719 #. type: =item
20720 #: ../fish/guestfish.pod:152 ../fuse/guestmount.pod:131
20721 #: ../tools/virt-edit.pl:85 ../tools/virt-win-reg.pl:104
20722 #: ../tools/virt-resize.pl:262 ../tools/virt-list-filesystems.pl:61
20723 #: ../tools/virt-tar.pl:106 ../tools/virt-make-fs.pl:161
20724 #: ../tools/virt-list-partitions.pl:62
20725 msgid "B<--help>"
20726 msgstr ""
20727
20728 # type: textblock
20729 #. type: textblock
20730 #: ../fish/guestfish.pod:154
20731 msgid "Displays general help on options."
20732 msgstr ""
20733
20734 # type: =item
20735 #. type: =item
20736 #: ../fish/guestfish.pod:156
20737 msgid "B<-h>"
20738 msgstr ""
20739
20740 # type: =item
20741 #. type: =item
20742 #: ../fish/guestfish.pod:158
20743 msgid "B<--cmd-help>"
20744 msgstr ""
20745
20746 # type: textblock
20747 #. type: textblock
20748 #: ../fish/guestfish.pod:160
20749 msgid "Lists all available guestfish commands."
20750 msgstr ""
20751
20752 # type: =item
20753 #. type: =item
20754 #: ../fish/guestfish.pod:162
20755 msgid "B<-h cmd>"
20756 msgstr ""
20757
20758 # type: =item
20759 #. type: =item
20760 #: ../fish/guestfish.pod:164
20761 msgid "B<--cmd-help cmd>"
20762 msgstr ""
20763
20764 # type: textblock
20765 #. type: textblock
20766 #: ../fish/guestfish.pod:166
20767 msgid "Displays detailed help on a single command C<cmd>."
20768 msgstr ""
20769
20770 # type: =item
20771 #. type: =item
20772 #: ../fish/guestfish.pod:168
20773 msgid "B<-a image>"
20774 msgstr ""
20775
20776 # type: =item
20777 #. type: =item
20778 #: ../fish/guestfish.pod:170
20779 msgid "B<--add image>"
20780 msgstr ""
20781
20782 # type: textblock
20783 #. type: textblock
20784 #: ../fish/guestfish.pod:172
20785 msgid "Add a block device or virtual machine image to the shell."
20786 msgstr ""
20787
20788 # type: textblock
20789 #. type: textblock
20790 #: ../fish/guestfish.pod:174 ../fuse/guestmount.pod:81
20791 msgid ""
20792 "The format of the disk image is auto-detected.  To override this and force a "
20793 "particular format use the I<--format=..> option."
20794 msgstr ""
20795
20796 #. type: textblock
20797 #: ../fish/guestfish.pod:177
20798 msgid ""
20799 "Using this flag is mostly equivalent to using the C<add> command, with "
20800 "C<readonly:true> if the I<--ro> flag was given, and with C<format:...> if "
20801 "the I<--format=...> flag was given."
20802 msgstr ""
20803
20804 # type: =item
20805 #. type: =item
20806 #: ../fish/guestfish.pod:181
20807 msgid "B<-c URI>"
20808 msgstr ""
20809
20810 # type: =item
20811 #. type: =item
20812 #: ../fish/guestfish.pod:183
20813 msgid "B<--connect URI>"
20814 msgstr ""
20815
20816 # type: textblock
20817 #. type: textblock
20818 #: ../fish/guestfish.pod:185 ../fuse/guestmount.pod:86
20819 msgid ""
20820 "When used in conjunction with the I<-d> option, this specifies the libvirt "
20821 "URI to use.  The default is to use the default libvirt connection."
20822 msgstr ""
20823
20824 # type: =item
20825 #. type: =item
20826 #: ../fish/guestfish.pod:189
20827 msgid "B<--csh>"
20828 msgstr ""
20829
20830 # type: textblock
20831 #. type: textblock
20832 #: ../fish/guestfish.pod:191
20833 msgid ""
20834 "If using the I<--listen> option and a csh-like shell, use this option.  See "
20835 "section L</REMOTE CONTROL AND CSH> below."
20836 msgstr ""
20837
20838 # type: =item
20839 #. type: =item
20840 #: ../fish/guestfish.pod:194
20841 msgid "B<-d libvirt-domain>"
20842 msgstr ""
20843
20844 # type: =item
20845 #. type: =item
20846 #: ../fish/guestfish.pod:196
20847 msgid "B<--domain libvirt-domain>"
20848 msgstr ""
20849
20850 # type: textblock
20851 #. type: textblock
20852 #: ../fish/guestfish.pod:198 ../fuse/guestmount.pod:92
20853 msgid ""
20854 "Add disks from the named libvirt domain.  If the I<--ro> option is also "
20855 "used, then any libvirt domain can be used.  However in write mode, only "
20856 "libvirt domains which are shut down can be named here."
20857 msgstr ""
20858
20859 # type: textblock
20860 #. type: textblock
20861 #: ../fish/guestfish.pod:202
20862 msgid ""
20863 "Using this flag is mostly equivalent to using the C<add-domain> command, "
20864 "with C<readonly:true> if the I<--ro> flag was given, and with C<format:...> "
20865 "if the I<--format:...> flag was given."
20866 msgstr ""
20867
20868 # type: =item
20869 #. type: =item
20870 #: ../fish/guestfish.pod:206
20871 msgid "B<-D>"
20872 msgstr ""
20873
20874 # type: =item
20875 #. type: =item
20876 #: ../fish/guestfish.pod:208
20877 msgid "B<--no-dest-paths>"
20878 msgstr ""
20879
20880 # type: textblock
20881 #. type: textblock
20882 #: ../fish/guestfish.pod:210
20883 msgid ""
20884 "Don't tab-complete paths on the guest filesystem.  It is useful to be able "
20885 "to hit the tab key to complete paths on the guest filesystem, but this "
20886 "causes extra \"hidden\" guestfs calls to be made, so this option is here to "
20887 "allow this feature to be disabled."
20888 msgstr ""
20889
20890 # type: =item
20891 #. type: =item
20892 #: ../fish/guestfish.pod:215 ../fuse/guestmount.pod:108
20893 msgid "B<--echo-keys>"
20894 msgstr ""
20895
20896 # type: textblock
20897 #. type: textblock
20898 #: ../fish/guestfish.pod:217 ../fuse/guestmount.pod:110
20899 msgid ""
20900 "When prompting for keys and passphrases, guestfish normally turns echoing "
20901 "off so you cannot see what you are typing.  If you are not worried about "
20902 "Tempest attacks and there is no one else in the room you can specify this "
20903 "flag to see what you are typing."
20904 msgstr ""
20905
20906 # type: =item
20907 #. type: =item
20908 #: ../fish/guestfish.pod:222
20909 msgid "B<-f file>"
20910 msgstr ""
20911
20912 # type: =item
20913 #. type: =item
20914 #: ../fish/guestfish.pod:224
20915 msgid "B<--file file>"
20916 msgstr ""
20917
20918 # type: textblock
20919 #. type: textblock
20920 #: ../fish/guestfish.pod:226
20921 msgid "Read commands from C<file>.  To write pure guestfish scripts, use:"
20922 msgstr ""
20923
20924 # type: verbatim
20925 #. type: verbatim
20926 #: ../fish/guestfish.pod:229
20927 #, no-wrap
20928 msgid ""
20929 " #!/usr/bin/guestfish -f\n"
20930 "\n"
20931 msgstr ""
20932
20933 # type: =item
20934 #. type: =item
20935 #: ../fish/guestfish.pod:231
20936 msgid "B<--format=raw|qcow2|..>"
20937 msgstr ""
20938
20939 # type: =item
20940 #. type: =item
20941 #: ../fish/guestfish.pod:233
20942 msgid "B<--format>"
20943 msgstr ""
20944
20945 # type: textblock
20946 #. type: textblock
20947 #: ../fish/guestfish.pod:235 ../fuse/guestmount.pod:117
20948 msgid ""
20949 "The default for the I<-a> option is to auto-detect the format of the disk "
20950 "image.  Using this forces the disk format for I<-a> options which follow on "
20951 "the command line.  Using I<--format> with no argument switches back to auto-"
20952 "detection for subsequent I<-a> options."
20953 msgstr ""
20954
20955 # type: verbatim
20956 #. type: verbatim
20957 #: ../fish/guestfish.pod:242
20958 #, no-wrap
20959 msgid ""
20960 " guestfish --format=raw -a disk.img\n"
20961 "\n"
20962 msgstr ""
20963
20964 # type: textblock
20965 #. type: textblock
20966 #: ../fish/guestfish.pod:244
20967 msgid "forces raw format (no auto-detection) for C<disk.img>."
20968 msgstr ""
20969
20970 # type: verbatim
20971 #. type: verbatim
20972 #: ../fish/guestfish.pod:246
20973 #, no-wrap
20974 msgid ""
20975 " guestfish --format=raw -a disk.img --format -a another.img\n"
20976 "\n"
20977 msgstr ""
20978
20979 # type: textblock
20980 #. type: textblock
20981 #: ../fish/guestfish.pod:248
20982 msgid ""
20983 "forces raw format (no auto-detection) for C<disk.img> and reverts to auto-"
20984 "detection for C<another.img>."
20985 msgstr ""
20986
20987 # type: textblock
20988 #. type: textblock
20989 #: ../fish/guestfish.pod:251
20990 msgid ""
20991 "If you have untrusted raw-format guest disk images, you should use this "
20992 "option to specify the disk format.  This avoids a possible security problem "
20993 "with malicious guests (CVE-2010-3851).  See also L</add-drive-opts>."
20994 msgstr ""
20995
20996 # type: =item
20997 #. type: =item
20998 #: ../fish/guestfish.pod:256
20999 msgid "B<-i>"
21000 msgstr ""
21001
21002 # type: =item
21003 #. type: =item
21004 #: ../fish/guestfish.pod:258
21005 msgid "B<--inspector>"
21006 msgstr ""
21007
21008 # type: textblock
21009 #. type: textblock
21010 #: ../fish/guestfish.pod:260 ../fuse/guestmount.pod:137
21011 msgid ""
21012 "Using L<virt-inspector(1)> code, inspect the disks looking for an operating "
21013 "system and mount filesystems as they would be mounted on the real virtual "
21014 "machine."
21015 msgstr ""
21016
21017 # type: textblock
21018 #. type: textblock
21019 #: ../fish/guestfish.pod:264
21020 msgid "Typical usage is either:"
21021 msgstr ""
21022
21023 # type: verbatim
21024 #. type: verbatim
21025 #: ../fish/guestfish.pod:266
21026 #, no-wrap
21027 msgid ""
21028 " guestfish -d myguest -i\n"
21029 "\n"
21030 msgstr ""
21031
21032 # type: textblock
21033 #. type: textblock
21034 #: ../fish/guestfish.pod:268
21035 msgid "(for an inactive libvirt domain called I<myguest>), or:"
21036 msgstr ""
21037
21038 # type: verbatim
21039 #. type: verbatim
21040 #: ../fish/guestfish.pod:270
21041 #, no-wrap
21042 msgid ""
21043 " guestfish --ro -d myguest -i\n"
21044 "\n"
21045 msgstr ""
21046
21047 # type: textblock
21048 #. type: textblock
21049 #: ../fish/guestfish.pod:272
21050 msgid "(for active domains, readonly), or specify the block device directly:"
21051 msgstr ""
21052
21053 # type: verbatim
21054 #. type: verbatim
21055 #: ../fish/guestfish.pod:274
21056 #, no-wrap
21057 msgid ""
21058 " guestfish --rw -a /dev/Guests/MyGuest -i\n"
21059 "\n"
21060 msgstr ""
21061
21062 # type: textblock
21063 #. type: textblock
21064 #: ../fish/guestfish.pod:276
21065 msgid ""
21066 "Note that the command line syntax changed slightly over older versions of "
21067 "guestfish.  You can still use the old syntax:"
21068 msgstr ""
21069
21070 # type: verbatim
21071 #. type: verbatim
21072 #: ../fish/guestfish.pod:279
21073 #, no-wrap
21074 msgid ""
21075 " guestfish [--ro] -i disk.img\n"
21076 "\n"
21077 msgstr ""
21078
21079 # type: verbatim
21080 #. type: verbatim
21081 #: ../fish/guestfish.pod:281
21082 #, no-wrap
21083 msgid ""
21084 " guestfish [--ro] -i libvirt-domain\n"
21085 "\n"
21086 msgstr ""
21087
21088 # type: textblock
21089 #. type: textblock
21090 #: ../fish/guestfish.pod:283
21091 msgid ""
21092 "Using this flag is mostly equivalent to using the C<inspect-os> command and "
21093 "then using other commands to mount the filesystems that were found."
21094 msgstr ""
21095
21096 # type: =item
21097 #. type: =item
21098 #: ../fish/guestfish.pod:287 ../fuse/guestmount.pod:141
21099 msgid "B<--keys-from-stdin>"
21100 msgstr ""
21101
21102 # type: textblock
21103 #. type: textblock
21104 #: ../fish/guestfish.pod:289 ../fuse/guestmount.pod:143
21105 msgid ""
21106 "Read key or passphrase parameters from stdin.  The default is to try to read "
21107 "passphrases from the user by opening C</dev/tty>."
21108 msgstr ""
21109
21110 # type: =item
21111 #. type: =item
21112 #: ../fish/guestfish.pod:292
21113 msgid "B<--listen>"
21114 msgstr ""
21115
21116 # type: textblock
21117 #. type: textblock
21118 #: ../fish/guestfish.pod:294
21119 msgid ""
21120 "Fork into the background and listen for remote commands.  See section L</"
21121 "REMOTE CONTROL GUESTFISH OVER A SOCKET> below."
21122 msgstr ""
21123
21124 # type: =item
21125 #. type: =item
21126 #: ../fish/guestfish.pod:297
21127 msgid "B<-m dev[:mountpoint]>"
21128 msgstr ""
21129
21130 # type: =item
21131 #. type: =item
21132 #: ../fish/guestfish.pod:299
21133 msgid "B<--mount dev[:mountpoint]>"
21134 msgstr ""
21135
21136 # type: textblock
21137 #. type: textblock
21138 #: ../fish/guestfish.pod:301
21139 msgid "Mount the named partition or logical volume on the given mountpoint."
21140 msgstr ""
21141
21142 # type: textblock
21143 #. type: textblock
21144 #: ../fish/guestfish.pod:303
21145 msgid "If the mountpoint is omitted, it defaults to C</>."
21146 msgstr ""
21147
21148 # type: textblock
21149 #. type: textblock
21150 #: ../fish/guestfish.pod:305
21151 msgid "You have to mount something on C</> before most commands will work."
21152 msgstr ""
21153
21154 # type: textblock
21155 #. type: textblock
21156 #: ../fish/guestfish.pod:307
21157 msgid ""
21158 "If any I<-m> or I<--mount> options are given, the guest is automatically "
21159 "launched."
21160 msgstr ""
21161
21162 # type: textblock
21163 #. type: textblock
21164 #: ../fish/guestfish.pod:310
21165 msgid ""
21166 "If you don't know what filesystems a disk image contains, you can either run "
21167 "guestfish without this option, then list the partitions, filesystems and LVs "
21168 "available (see L</list-partitions>, L</list-filesystems> and L</lvs> "
21169 "commands), or you can use the L<virt-filesystems(1)> program."
21170 msgstr ""
21171
21172 # type: textblock
21173 #. type: textblock
21174 #: ../fish/guestfish.pod:316
21175 msgid ""
21176 "Using this flag is mostly equivalent to using the C<mount-options> command "
21177 "or the C<mount-ro> command if the I<--ro> flag was given."
21178 msgstr ""
21179
21180 # type: =item
21181 #. type: =item
21182 #: ../fish/guestfish.pod:319
21183 msgid "B<-n>"
21184 msgstr ""
21185
21186 # type: =item
21187 #. type: =item
21188 #: ../fish/guestfish.pod:321
21189 msgid "B<--no-sync>"
21190 msgstr ""
21191
21192 # type: textblock
21193 #. type: textblock
21194 #: ../fish/guestfish.pod:323
21195 msgid ""
21196 "Disable autosync.  This is enabled by default.  See the discussion of "
21197 "autosync in the L<guestfs(3)> manpage."
21198 msgstr ""
21199
21200 # type: =item
21201 #. type: =item
21202 #: ../fish/guestfish.pod:326
21203 msgid "B<-N type>"
21204 msgstr ""
21205
21206 # type: =item
21207 #. type: =item
21208 #: ../fish/guestfish.pod:328
21209 msgid "B<--new type>"
21210 msgstr ""
21211
21212 # type: =item
21213 #. type: =item
21214 #: ../fish/guestfish.pod:330
21215 msgid "B<-N help>"
21216 msgstr ""
21217
21218 # type: textblock
21219 #. type: textblock
21220 #: ../fish/guestfish.pod:332
21221 msgid ""
21222 "Prepare a fresh disk image formatted as \"type\".  This is an alternative to "
21223 "the I<-a> option: whereas I<-a> adds an existing disk, I<-N> creates a "
21224 "preformatted disk with a filesystem and adds it.  See L</PREPARED DISK "
21225 "IMAGES> below."
21226 msgstr ""
21227
21228 # type: =item
21229 #. type: =item
21230 #: ../fish/guestfish.pod:337
21231 msgid "B<--progress-bars>"
21232 msgstr ""
21233
21234 # type: textblock
21235 #. type: textblock
21236 #: ../fish/guestfish.pod:339
21237 msgid "Enable progress bars, even when guestfish is used non-interactively."
21238 msgstr ""
21239
21240 # type: textblock
21241 #. type: textblock
21242 #: ../fish/guestfish.pod:341
21243 msgid ""
21244 "Progress bars are enabled by default when guestfish is used as an "
21245 "interactive shell."
21246 msgstr ""
21247
21248 # type: =item
21249 #. type: =item
21250 #: ../fish/guestfish.pod:344
21251 msgid "B<--no-progress-bars>"
21252 msgstr ""
21253
21254 # type: textblock
21255 #. type: textblock
21256 #: ../fish/guestfish.pod:346
21257 msgid "Disable progress bars."
21258 msgstr ""
21259
21260 # type: =item
21261 #. type: =item
21262 #: ../fish/guestfish.pod:348
21263 msgid "B<--remote[=pid]>"
21264 msgstr ""
21265
21266 # type: textblock
21267 #. type: textblock
21268 #: ../fish/guestfish.pod:350
21269 msgid ""
21270 "Send remote commands to C<$GUESTFISH_PID> or C<pid>.  See section L</REMOTE "
21271 "CONTROL GUESTFISH OVER A SOCKET> below."
21272 msgstr ""
21273
21274 # type: =item
21275 #. type: =item
21276 #: ../fish/guestfish.pod:353
21277 msgid "B<-r>"
21278 msgstr ""
21279
21280 # type: =item
21281 #. type: =item
21282 #: ../fish/guestfish.pod:355
21283 msgid "B<--ro>"
21284 msgstr ""
21285
21286 # type: textblock
21287 #. type: textblock
21288 #: ../fish/guestfish.pod:357
21289 msgid ""
21290 "This changes the I<-a>, I<-d> and I<-m> options so that disks are added and "
21291 "mounts are done read-only."
21292 msgstr ""
21293
21294 # type: textblock
21295 #. type: textblock
21296 #: ../fish/guestfish.pod:360
21297 msgid ""
21298 "The option must always be used if the disk image or virtual machine might be "
21299 "running, and is generally recommended in cases where you don't need write "
21300 "access to the disk."
21301 msgstr ""
21302
21303 # type: textblock
21304 #. type: textblock
21305 #: ../fish/guestfish.pod:364
21306 msgid ""
21307 "Note that prepared disk images created with I<-N> are not affected by this "
21308 "option.  Also commands like C<add> are not affected - you have to specify "
21309 "the C<readonly:true> option explicitly if you need it."
21310 msgstr ""
21311
21312 # type: textblock
21313 #. type: textblock
21314 #: ../fish/guestfish.pod:368
21315 msgid "See also L</OPENING DISKS FOR READ AND WRITE> below."
21316 msgstr ""
21317
21318 # type: =item
21319 #. type: =item
21320 #: ../fish/guestfish.pod:370 ../fuse/guestmount.pod:208
21321 msgid "B<--selinux>"
21322 msgstr ""
21323
21324 # type: textblock
21325 #. type: textblock
21326 #: ../fish/guestfish.pod:372
21327 msgid "Enable SELinux support for the guest.  See L<guestfs(3)/SELINUX>."
21328 msgstr ""
21329
21330 # type: =item
21331 #. type: =item
21332 #: ../fish/guestfish.pod:374
21333 msgid "B<-v>"
21334 msgstr ""
21335
21336 # type: =item
21337 #. type: =item
21338 #: ../fish/guestfish.pod:376
21339 msgid "B<--verbose>"
21340 msgstr ""
21341
21342 # type: textblock
21343 #. type: textblock
21344 #: ../fish/guestfish.pod:378
21345 msgid ""
21346 "Enable very verbose messages.  This is particularly useful if you find a bug."
21347 msgstr ""
21348
21349 # type: =item
21350 #. type: =item
21351 #: ../fish/guestfish.pod:381
21352 msgid "B<-V>"
21353 msgstr ""
21354
21355 # type: =item
21356 #. type: =item
21357 #: ../fish/guestfish.pod:383 ../tools/virt-edit.pl:93
21358 #: ../tools/virt-win-reg.pl:112 ../tools/virt-resize.pl:270
21359 #: ../tools/virt-list-filesystems.pl:69 ../tools/virt-tar.pl:114
21360 #: ../tools/virt-make-fs.pl:169 ../tools/virt-list-partitions.pl:70
21361 msgid "B<--version>"
21362 msgstr ""
21363
21364 # type: textblock
21365 #. type: textblock
21366 #: ../fish/guestfish.pod:385
21367 msgid "Display the guestfish / libguestfs version number and exit."
21368 msgstr ""
21369
21370 # type: =item
21371 #. type: =item
21372 #: ../fish/guestfish.pod:387
21373 msgid "B<-w>"
21374 msgstr ""
21375
21376 # type: =item
21377 #. type: =item
21378 #: ../fish/guestfish.pod:389
21379 msgid "B<--rw>"
21380 msgstr ""
21381
21382 # type: textblock
21383 #. type: textblock
21384 #: ../fish/guestfish.pod:391
21385 msgid ""
21386 "This option does nothing at the moment.  See L</OPENING DISKS FOR READ AND "
21387 "WRITE> below."
21388 msgstr ""
21389
21390 # type: =item
21391 #. type: =item
21392 #: ../fish/guestfish.pod:394
21393 msgid "B<-x>"
21394 msgstr ""
21395
21396 # type: textblock
21397 #. type: textblock
21398 #: ../fish/guestfish.pod:396
21399 msgid "Echo each command before executing it."
21400 msgstr ""
21401
21402 # type: =head1
21403 #. type: =head1
21404 #: ../fish/guestfish.pod:400
21405 msgid "COMMANDS ON COMMAND LINE"
21406 msgstr ""
21407
21408 # type: textblock
21409 #. type: textblock
21410 #: ../fish/guestfish.pod:402
21411 msgid ""
21412 "Any additional (non-option) arguments are treated as commands to execute."
21413 msgstr ""
21414
21415 # type: textblock
21416 #. type: textblock
21417 #: ../fish/guestfish.pod:405
21418 msgid ""
21419 "Commands to execute should be separated by a colon (C<:>), where the colon "
21420 "is a separate parameter.  Thus:"
21421 msgstr ""
21422
21423 # type: verbatim
21424 #. type: verbatim
21425 #: ../fish/guestfish.pod:408
21426 #, no-wrap
21427 msgid ""
21428 " guestfish cmd [args...] : cmd [args...] : cmd [args...] ...\n"
21429 "\n"
21430 msgstr ""
21431
21432 # type: textblock
21433 #. type: textblock
21434 #: ../fish/guestfish.pod:410
21435 msgid ""
21436 "If there are no additional arguments, then we enter a shell, either an "
21437 "interactive shell with a prompt (if the input is a terminal) or a non-"
21438 "interactive shell."
21439 msgstr ""
21440
21441 # type: textblock
21442 #. type: textblock
21443 #: ../fish/guestfish.pod:414
21444 msgid ""
21445 "In either command line mode or non-interactive shell, the first command that "
21446 "gives an error causes the whole shell to exit.  In interactive mode (with a "
21447 "prompt) if a command fails, you can continue to enter commands."
21448 msgstr ""
21449
21450 # type: =head1
21451 #. type: =head1
21452 #: ../fish/guestfish.pod:419
21453 msgid "USING launch (OR run)"
21454 msgstr ""
21455
21456 # type: textblock
21457 #. type: textblock
21458 #: ../fish/guestfish.pod:421
21459 msgid ""
21460 "As with L<guestfs(3)>, you must first configure your guest by adding disks, "
21461 "then launch it, then mount any disks you need, and finally issue actions/"
21462 "commands.  So the general order of the day is:"
21463 msgstr ""
21464
21465 # type: textblock
21466 #. type: textblock
21467 #: ../fish/guestfish.pod:429
21468 msgid "add or -a/--add"
21469 msgstr ""
21470
21471 # type: textblock
21472 #. type: textblock
21473 #: ../fish/guestfish.pod:433
21474 msgid "launch (aka run)"
21475 msgstr ""
21476
21477 # type: textblock
21478 #. type: textblock
21479 #: ../fish/guestfish.pod:437
21480 msgid "mount or -m/--mount"
21481 msgstr ""
21482
21483 # type: textblock
21484 #. type: textblock
21485 #: ../fish/guestfish.pod:441
21486 msgid "any other commands"
21487 msgstr ""
21488
21489 # type: textblock
21490 #. type: textblock
21491 #: ../fish/guestfish.pod:445
21492 msgid ""
21493 "C<run> is a synonym for C<launch>.  You must C<launch> (or C<run>)  your "
21494 "guest before mounting or performing any other commands."
21495 msgstr ""
21496
21497 # type: textblock
21498 #. type: textblock
21499 #: ../fish/guestfish.pod:448
21500 msgid ""
21501 "The only exception is that if any of the I<-i>, I<-m>, I<--mount>, I<-N> or "
21502 "I<--new> options were given then C<run> is done automatically, simply "
21503 "because guestfish can't perform the action you asked for without doing this."
21504 msgstr ""
21505
21506 # type: =head1
21507 #. type: =head1
21508 #: ../fish/guestfish.pod:453
21509 msgid "OPENING DISKS FOR READ AND WRITE"
21510 msgstr ""
21511
21512 # type: textblock
21513 #. type: textblock
21514 #: ../fish/guestfish.pod:455
21515 msgid ""
21516 "The guestfish (and L<guestmount(1)>) options I<--ro> and I<--rw> affect "
21517 "whether the other command line options I<-a>, I<-c>, I<-d>, I<-i> and I<-m> "
21518 "open disk images read-only or for writing."
21519 msgstr ""
21520
21521 # type: textblock
21522 #. type: textblock
21523 #: ../fish/guestfish.pod:459
21524 msgid ""
21525 "In libguestfs E<lt> 1.6.2, guestfish and guestmount defaulted to opening "
21526 "disk images supplied on the command line for write.  To open a disk image "
21527 "read-only you have to do I<-a image --ro>."
21528 msgstr ""
21529
21530 # type: textblock
21531 #. type: textblock
21532 #: ../fish/guestfish.pod:463
21533 msgid ""
21534 "This matters: If you accidentally open a live VM disk image writable then "
21535 "you will cause irreversible disk corruption."
21536 msgstr ""
21537
21538 #. type: textblock
21539 #: ../fish/guestfish.pod:466
21540 msgid ""
21541 "By libguestfs 1.10 we intend to change the default the other way.  Disk "
21542 "images will be opened read-only.  You will have to either specify "
21543 "I<guestfish --rw> or change a configuration file in order to get write "
21544 "access for disk images specified by those other command line options."
21545 msgstr ""
21546
21547 # type: textblock
21548 #. type: textblock
21549 #: ../fish/guestfish.pod:471
21550 msgid ""
21551 "This version of guestfish has a I<--rw> option which does nothing (it is "
21552 "already the default).  However it is highly recommended that you use this "
21553 "option to indicate that guestfish needs write access, and to prepare your "
21554 "scripts for the day when this option will be required for write access."
21555 msgstr ""
21556
21557 # type: textblock
21558 #. type: textblock
21559 #: ../fish/guestfish.pod:477
21560 msgid ""
21561 "B<Note:> This does I<not> affect commands like L</add> and L</mount>, or any "
21562 "other libguestfs program apart from guestfish and guestmount."
21563 msgstr ""
21564
21565 # type: =head1
21566 #. type: =head1
21567 #: ../fish/guestfish.pod:480
21568 msgid "QUOTING"
21569 msgstr ""
21570
21571 # type: textblock
21572 #. type: textblock
21573 #: ../fish/guestfish.pod:482
21574 msgid ""
21575 "You can quote ordinary parameters using either single or double quotes.  For "
21576 "example:"
21577 msgstr ""
21578
21579 # type: verbatim
21580 #. type: verbatim
21581 #: ../fish/guestfish.pod:485
21582 #, no-wrap
21583 msgid ""
21584 " add \"file with a space.img\"\n"
21585 "\n"
21586 msgstr ""
21587
21588 # type: verbatim
21589 #. type: verbatim
21590 #: ../fish/guestfish.pod:487
21591 #, no-wrap
21592 msgid ""
21593 " rm '/file name'\n"
21594 "\n"
21595 msgstr ""
21596
21597 # type: verbatim
21598 #. type: verbatim
21599 #: ../fish/guestfish.pod:489
21600 #, no-wrap
21601 msgid ""
21602 " rm '/\"'\n"
21603 "\n"
21604 msgstr ""
21605
21606 # type: textblock
21607 #. type: textblock
21608 #: ../fish/guestfish.pod:491
21609 msgid ""
21610 "A few commands require a list of strings to be passed.  For these, use a "
21611 "whitespace-separated list, enclosed in quotes.  Strings containing "
21612 "whitespace to be passed through must be enclosed in single quotes.  A "
21613 "literal single quote must be escaped with a backslash."
21614 msgstr ""
21615
21616 # type: verbatim
21617 #. type: verbatim
21618 #: ../fish/guestfish.pod:496
21619 #, no-wrap
21620 msgid ""
21621 " vgcreate VG \"/dev/sda1 /dev/sdb1\"\n"
21622 " command \"/bin/echo 'foo      bar'\"\n"
21623 " command \"/bin/echo \\'foo\\'\"\n"
21624 "\n"
21625 msgstr ""
21626
21627 # type: =head1
21628 #. type: =head1
21629 #: ../fish/guestfish.pod:500
21630 msgid "OPTIONAL ARGUMENTS"
21631 msgstr ""
21632
21633 # type: textblock
21634 #. type: textblock
21635 #: ../fish/guestfish.pod:502
21636 msgid ""
21637 "Some commands take optional arguments.  These arguments appear in this "
21638 "documentation as C<[argname:..]>.  You can use them as in these examples:"
21639 msgstr ""
21640
21641 # type: verbatim
21642 #. type: verbatim
21643 #: ../fish/guestfish.pod:506
21644 #, no-wrap
21645 msgid ""
21646 " add-drive-opts filename\n"
21647 "\n"
21648 msgstr ""
21649
21650 # type: verbatim
21651 #. type: verbatim
21652 #: ../fish/guestfish.pod:508
21653 #, no-wrap
21654 msgid ""
21655 " add-drive-opts filename readonly:true\n"
21656 "\n"
21657 msgstr ""
21658
21659 # type: verbatim
21660 #. type: verbatim
21661 #: ../fish/guestfish.pod:510
21662 #, no-wrap
21663 msgid ""
21664 " add-drive-opts filename format:qcow2 readonly:false\n"
21665 "\n"
21666 msgstr ""
21667
21668 # type: textblock
21669 #. type: textblock
21670 #: ../fish/guestfish.pod:512
21671 msgid ""
21672 "Each optional argument can appear at most once.  All optional arguments must "
21673 "appear after the required ones."
21674 msgstr ""
21675
21676 # type: =head1
21677 #. type: =head1
21678 #: ../fish/guestfish.pod:515
21679 msgid "NUMBERS"
21680 msgstr ""
21681
21682 # type: textblock
21683 #. type: textblock
21684 #: ../fish/guestfish.pod:517
21685 msgid ""
21686 "This section applies to all commands which can take integers as parameters."
21687 msgstr ""
21688
21689 # type: =head2
21690 #. type: =head2
21691 #: ../fish/guestfish.pod:520
21692 msgid "SIZE SUFFIX"
21693 msgstr ""
21694
21695 # type: textblock
21696 #. type: textblock
21697 #: ../fish/guestfish.pod:522
21698 msgid ""
21699 "When the command takes a parameter measured in bytes, you can use one of the "
21700 "following suffixes to specify kilobytes, megabytes and larger sizes:"
21701 msgstr ""
21702
21703 # type: =item
21704 #. type: =item
21705 #: ../fish/guestfish.pod:528
21706 msgid "B<k> or B<K> or B<KiB>"
21707 msgstr ""
21708
21709 # type: textblock
21710 #. type: textblock
21711 #: ../fish/guestfish.pod:530
21712 msgid "The size in kilobytes (multiplied by 1024)."
21713 msgstr ""
21714
21715 # type: =item
21716 #. type: =item
21717 #: ../fish/guestfish.pod:532
21718 msgid "B<KB>"
21719 msgstr ""
21720
21721 # type: textblock
21722 #. type: textblock
21723 #: ../fish/guestfish.pod:534
21724 msgid "The size in SI 1000 byte units."
21725 msgstr ""
21726
21727 # type: =item
21728 #. type: =item
21729 #: ../fish/guestfish.pod:536
21730 msgid "B<M> or B<MiB>"
21731 msgstr ""
21732
21733 # type: textblock
21734 #. type: textblock
21735 #: ../fish/guestfish.pod:538
21736 msgid "The size in megabytes (multiplied by 1048576)."
21737 msgstr ""
21738
21739 # type: =item
21740 #. type: =item
21741 #: ../fish/guestfish.pod:540
21742 msgid "B<MB>"
21743 msgstr ""
21744
21745 # type: textblock
21746 #. type: textblock
21747 #: ../fish/guestfish.pod:542
21748 msgid "The size in SI 1000000 byte units."
21749 msgstr ""
21750
21751 # type: =item
21752 #. type: =item
21753 #: ../fish/guestfish.pod:544
21754 msgid "B<G> or B<GiB>"
21755 msgstr ""
21756
21757 # type: textblock
21758 #. type: textblock
21759 #: ../fish/guestfish.pod:546
21760 msgid "The size in gigabytes (multiplied by 2**30)."
21761 msgstr ""
21762
21763 # type: =item
21764 #. type: =item
21765 #: ../fish/guestfish.pod:548
21766 msgid "B<GB>"
21767 msgstr ""
21768
21769 # type: textblock
21770 #. type: textblock
21771 #: ../fish/guestfish.pod:550
21772 msgid "The size in SI 10**9 byte units."
21773 msgstr ""
21774
21775 # type: =item
21776 #. type: =item
21777 #: ../fish/guestfish.pod:552
21778 msgid "B<T> or B<TiB>"
21779 msgstr ""
21780
21781 # type: textblock
21782 #. type: textblock
21783 #: ../fish/guestfish.pod:554
21784 msgid "The size in terabytes (multiplied by 2**40)."
21785 msgstr ""
21786
21787 # type: =item
21788 #. type: =item
21789 #: ../fish/guestfish.pod:556
21790 msgid "B<TB>"
21791 msgstr ""
21792
21793 # type: textblock
21794 #. type: textblock
21795 #: ../fish/guestfish.pod:558
21796 msgid "The size in SI 10**12 byte units."
21797 msgstr ""
21798
21799 # type: =item
21800 #. type: =item
21801 #: ../fish/guestfish.pod:560
21802 msgid "B<P> or B<PiB>"
21803 msgstr ""
21804
21805 # type: textblock
21806 #. type: textblock
21807 #: ../fish/guestfish.pod:562
21808 msgid "The size in petabytes (multiplied by 2**50)."
21809 msgstr ""
21810
21811 # type: =item
21812 #. type: =item
21813 #: ../fish/guestfish.pod:564
21814 msgid "B<PB>"
21815 msgstr ""
21816
21817 # type: textblock
21818 #. type: textblock
21819 #: ../fish/guestfish.pod:566
21820 msgid "The size in SI 10**15 byte units."
21821 msgstr ""
21822
21823 # type: =item
21824 #. type: =item
21825 #: ../fish/guestfish.pod:568
21826 msgid "B<E> or B<EiB>"
21827 msgstr ""
21828
21829 # type: textblock
21830 #. type: textblock
21831 #: ../fish/guestfish.pod:570
21832 msgid "The size in exabytes (multiplied by 2**60)."
21833 msgstr ""
21834
21835 # type: =item
21836 #. type: =item
21837 #: ../fish/guestfish.pod:572
21838 msgid "B<EB>"
21839 msgstr ""
21840
21841 # type: textblock
21842 #. type: textblock
21843 #: ../fish/guestfish.pod:574
21844 msgid "The size in SI 10**18 byte units."
21845 msgstr ""
21846
21847 # type: =item
21848 #. type: =item
21849 #: ../fish/guestfish.pod:576
21850 msgid "B<Z> or B<ZiB>"
21851 msgstr ""
21852
21853 # type: textblock
21854 #. type: textblock
21855 #: ../fish/guestfish.pod:578
21856 msgid "The size in zettabytes (multiplied by 2**70)."
21857 msgstr ""
21858
21859 # type: =item
21860 #. type: =item
21861 #: ../fish/guestfish.pod:580
21862 msgid "B<ZB>"
21863 msgstr ""
21864
21865 # type: textblock
21866 #. type: textblock
21867 #: ../fish/guestfish.pod:582
21868 msgid "The size in SI 10**21 byte units."
21869 msgstr ""
21870
21871 # type: =item
21872 #. type: =item
21873 #: ../fish/guestfish.pod:584
21874 msgid "B<Y> or B<YiB>"
21875 msgstr ""
21876
21877 # type: textblock
21878 #. type: textblock
21879 #: ../fish/guestfish.pod:586
21880 msgid "The size in yottabytes (multiplied by 2**80)."
21881 msgstr ""
21882
21883 # type: =item
21884 #. type: =item
21885 #: ../fish/guestfish.pod:588
21886 msgid "B<YB>"
21887 msgstr ""
21888
21889 # type: textblock
21890 #. type: textblock
21891 #: ../fish/guestfish.pod:590
21892 msgid "The size in SI 10**24 byte units."
21893 msgstr ""
21894
21895 # type: verbatim
21896 #. type: verbatim
21897 #: ../fish/guestfish.pod:596
21898 #, no-wrap
21899 msgid ""
21900 " truncate-size /file 1G\n"
21901 "\n"
21902 msgstr ""
21903
21904 # type: textblock
21905 #. type: textblock
21906 #: ../fish/guestfish.pod:598
21907 msgid "would truncate the file to 1 gigabyte."
21908 msgstr ""
21909
21910 # type: textblock
21911 #. type: textblock
21912 #: ../fish/guestfish.pod:600
21913 msgid ""
21914 "Be careful because a few commands take sizes in kilobytes or megabytes (eg. "
21915 "the parameter to L</memsize> is specified in megabytes already).  Adding a "
21916 "suffix will probably not do what you expect."
21917 msgstr ""
21918
21919 # type: =head2
21920 #. type: =head2
21921 #: ../fish/guestfish.pod:604
21922 msgid "OCTAL AND HEXADECIMAL NUMBERS"
21923 msgstr ""
21924
21925 # type: textblock
21926 #. type: textblock
21927 #: ../fish/guestfish.pod:606
21928 msgid ""
21929 "For specifying the radix (base) use the C convention: C<0> to prefix an "
21930 "octal number or C<0x> to prefix a hexadecimal number.  For example:"
21931 msgstr ""
21932
21933 # type: verbatim
21934 #. type: verbatim
21935 #: ../fish/guestfish.pod:609
21936 #, no-wrap
21937 msgid ""
21938 " 1234      decimal number 1234\n"
21939 " 02322     octal number, equivalent to decimal 1234\n"
21940 " 0x4d2     hexadecimal number, equivalent to decimal 1234\n"
21941 "\n"
21942 msgstr ""
21943
21944 # type: textblock
21945 #. type: textblock
21946 #: ../fish/guestfish.pod:613
21947 msgid ""
21948 "When using the C<chmod> command, you almost always want to specify an octal "
21949 "number for the mode, and you must prefix it with C<0> (unlike the Unix "
21950 "L<chmod(1)> program):"
21951 msgstr ""
21952
21953 # type: verbatim
21954 #. type: verbatim
21955 #: ../fish/guestfish.pod:617
21956 #, no-wrap
21957 msgid ""
21958 " chmod 0777 /public  # OK\n"
21959 " chmod 777 /public   # WRONG! This is mode 777 decimal = 01411 octal.\n"
21960 "\n"
21961 msgstr ""
21962
21963 # type: textblock
21964 #. type: textblock
21965 #: ../fish/guestfish.pod:620
21966 msgid ""
21967 "Commands that return numbers usually print them in decimal, but some "
21968 "commands print numbers in other radices (eg. C<umask> prints the mode in "
21969 "octal, preceeded by C<0>)."
21970 msgstr ""
21971
21972 # type: =head1
21973 #. type: =head1
21974 #: ../fish/guestfish.pod:624
21975 msgid "WILDCARDS AND GLOBBING"
21976 msgstr ""
21977
21978 # type: textblock
21979 #. type: textblock
21980 #: ../fish/guestfish.pod:626
21981 msgid ""
21982 "Neither guestfish nor the underlying guestfs API performs wildcard expansion "
21983 "(globbing) by default.  So for example the following will not do what you "
21984 "expect:"
21985 msgstr ""
21986
21987 # type: verbatim
21988 #. type: verbatim
21989 #: ../fish/guestfish.pod:630
21990 #, no-wrap
21991 msgid ""
21992 " rm-rf /home/*\n"
21993 "\n"
21994 msgstr ""
21995
21996 # type: textblock
21997 #. type: textblock
21998 #: ../fish/guestfish.pod:632
21999 msgid ""
22000 "Assuming you don't have a directory called literally C</home/*> then the "
22001 "above command will return an error."
22002 msgstr ""
22003
22004 # type: textblock
22005 #. type: textblock
22006 #: ../fish/guestfish.pod:635
22007 msgid "To perform wildcard expansion, use the C<glob> command."
22008 msgstr ""
22009
22010 # type: verbatim
22011 #. type: verbatim
22012 #: ../fish/guestfish.pod:637
22013 #, no-wrap
22014 msgid ""
22015 " glob rm-rf /home/*\n"
22016 "\n"
22017 msgstr ""
22018
22019 # type: textblock
22020 #. type: textblock
22021 #: ../fish/guestfish.pod:639
22022 msgid ""
22023 "runs C<rm-rf> on each path that matches (ie. potentially running the command "
22024 "many times), equivalent to:"
22025 msgstr ""
22026
22027 # type: verbatim
22028 #. type: verbatim
22029 #: ../fish/guestfish.pod:642
22030 #, no-wrap
22031 msgid ""
22032 " rm-rf /home/jim\n"
22033 " rm-rf /home/joe\n"
22034 " rm-rf /home/mary\n"
22035 "\n"
22036 msgstr ""
22037
22038 # type: textblock
22039 #. type: textblock
22040 #: ../fish/guestfish.pod:646
22041 msgid "C<glob> only works on simple guest paths and not on device names."
22042 msgstr ""
22043
22044 # type: textblock
22045 #. type: textblock
22046 #: ../fish/guestfish.pod:648
22047 msgid ""
22048 "If you have several parameters, each containing a wildcard, then glob will "
22049 "perform a Cartesian product."
22050 msgstr ""
22051
22052 # type: =head1
22053 #. type: =head1
22054 #: ../fish/guestfish.pod:651
22055 msgid "COMMENTS"
22056 msgstr ""
22057
22058 # type: textblock
22059 #. type: textblock
22060 #: ../fish/guestfish.pod:653
22061 msgid ""
22062 "Any line which starts with a I<#> character is treated as a comment and "
22063 "ignored.  The I<#> can optionally be preceeded by whitespace, but B<not> by "
22064 "a command.  For example:"
22065 msgstr ""
22066
22067 # type: verbatim
22068 #. type: verbatim
22069 #: ../fish/guestfish.pod:657
22070 #, no-wrap
22071 msgid ""
22072 " # this is a comment\n"
22073 "         # this is a comment\n"
22074 " foo # NOT a comment\n"
22075 "\n"
22076 msgstr ""
22077
22078 # type: textblock
22079 #. type: textblock
22080 #: ../fish/guestfish.pod:661
22081 msgid "Blank lines are also ignored."
22082 msgstr ""
22083
22084 # type: =head1
22085 #. type: =head1
22086 #: ../fish/guestfish.pod:663
22087 msgid "RUNNING COMMANDS LOCALLY"
22088 msgstr ""
22089
22090 # type: textblock
22091 #. type: textblock
22092 #: ../fish/guestfish.pod:665
22093 msgid ""
22094 "Any line which starts with a I<!> character is treated as a command sent to "
22095 "the local shell (C</bin/sh> or whatever L<system(3)> uses).  For example:"
22096 msgstr ""
22097
22098 # type: verbatim
22099 #. type: verbatim
22100 #: ../fish/guestfish.pod:669
22101 #, no-wrap
22102 msgid ""
22103 " !mkdir local\n"
22104 " tgz-out /remote local/remote-data.tar.gz\n"
22105 "\n"
22106 msgstr ""
22107
22108 # type: textblock
22109 #. type: textblock
22110 #: ../fish/guestfish.pod:672
22111 msgid ""
22112 "will create a directory C<local> on the host, and then export the contents "
22113 "of C</remote> on the mounted filesystem to C<local/remote-data.tar.gz>.  "
22114 "(See C<tgz-out>)."
22115 msgstr ""
22116
22117 # type: textblock
22118 #. type: textblock
22119 #: ../fish/guestfish.pod:676
22120 msgid ""
22121 "To change the local directory, use the C<lcd> command.  C<!cd> will have no "
22122 "effect, due to the way that subprocesses work in Unix."
22123 msgstr ""
22124
22125 # type: =head1
22126 #. type: =head1
22127 #: ../fish/guestfish.pod:679
22128 msgid "PIPES"
22129 msgstr ""
22130
22131 # type: textblock
22132 #. type: textblock
22133 #: ../fish/guestfish.pod:681
22134 msgid ""
22135 "Use C<command E<lt>spaceE<gt> | command> to pipe the output of the first "
22136 "command (a guestfish command) to the second command (any host command).  For "
22137 "example:"
22138 msgstr ""
22139
22140 # type: verbatim
22141 #. type: verbatim
22142 #: ../fish/guestfish.pod:685
22143 #, no-wrap
22144 msgid ""
22145 " cat /etc/passwd | awk -F: '$3 == 0 { print }'\n"
22146 "\n"
22147 msgstr ""
22148
22149 # type: textblock
22150 #. type: textblock
22151 #: ../fish/guestfish.pod:687
22152 msgid ""
22153 "(where C<cat> is the guestfish cat command, but C<awk> is the host awk "
22154 "program).  The above command would list all accounts in the guest filesystem "
22155 "which have UID 0, ie. root accounts including backdoors.  Other examples:"
22156 msgstr ""
22157
22158 # type: verbatim
22159 #. type: verbatim
22160 #: ../fish/guestfish.pod:692
22161 #, no-wrap
22162 msgid ""
22163 " hexdump /bin/ls | head\n"
22164 " list-devices | tail -1\n"
22165 " tgz-out / - | tar ztf -\n"
22166 "\n"
22167 msgstr ""
22168
22169 # type: textblock
22170 #. type: textblock
22171 #: ../fish/guestfish.pod:696
22172 msgid ""
22173 "The space before the pipe symbol is required, any space after the pipe "
22174 "symbol is optional.  Everything after the pipe symbol is just passed "
22175 "straight to the host shell, so it can contain redirections, globs and "
22176 "anything else that makes sense on the host side."
22177 msgstr ""
22178
22179 # type: textblock
22180 #. type: textblock
22181 #: ../fish/guestfish.pod:701
22182 msgid ""
22183 "To use a literal argument which begins with a pipe symbol, you have to quote "
22184 "it, eg:"
22185 msgstr ""
22186
22187 # type: verbatim
22188 #. type: verbatim
22189 #: ../fish/guestfish.pod:704
22190 #, no-wrap
22191 msgid ""
22192 " echo \"|\"\n"
22193 "\n"
22194 msgstr ""
22195
22196 # type: =head1
22197 #. type: =head1
22198 #: ../fish/guestfish.pod:706
22199 msgid "HOME DIRECTORIES"
22200 msgstr ""
22201
22202 # type: textblock
22203 #. type: textblock
22204 #: ../fish/guestfish.pod:708
22205 msgid ""
22206 "If a parameter starts with the character C<~> then the tilde may be expanded "
22207 "as a home directory path (either C<~> for the current user's home directory, "
22208 "or C<~user> for another user)."
22209 msgstr ""
22210
22211 # type: textblock
22212 #. type: textblock
22213 #: ../fish/guestfish.pod:712
22214 msgid ""
22215 "Note that home directory expansion happens for users known I<on the host>, "
22216 "not in the guest filesystem."
22217 msgstr ""
22218
22219 # type: textblock
22220 #. type: textblock
22221 #: ../fish/guestfish.pod:715
22222 msgid ""
22223 "To use a literal argument which begins with a tilde, you have to quote it, "
22224 "eg:"
22225 msgstr ""
22226
22227 # type: verbatim
22228 #. type: verbatim
22229 #: ../fish/guestfish.pod:718
22230 #, no-wrap
22231 msgid ""
22232 " echo \"~\"\n"
22233 "\n"
22234 msgstr ""
22235
22236 # type: textblock
22237 #. type: textblock
22238 #: ../fish/guestfish.pod:722
22239 msgid ""
22240 "Libguestfs has some support for Linux guests encrypted according to the "
22241 "Linux Unified Key Setup (LUKS) standard, which includes nearly all whole "
22242 "disk encryption systems used by modern Linux guests.  Currently only LVM-on-"
22243 "LUKS is supported."
22244 msgstr ""
22245
22246 # type: textblock
22247 #. type: textblock
22248 #: ../fish/guestfish.pod:727
22249 msgid "Identify encrypted block devices and partitions using L</vfs-type>:"
22250 msgstr ""
22251
22252 # type: verbatim
22253 #. type: verbatim
22254 #: ../fish/guestfish.pod:729
22255 #, no-wrap
22256 msgid ""
22257 " ><fs> vfs-type /dev/sda2\n"
22258 " crypto_LUKS\n"
22259 "\n"
22260 msgstr ""
22261
22262 # type: textblock
22263 #. type: textblock
22264 #: ../fish/guestfish.pod:732
22265 msgid ""
22266 "Then open those devices using L</luks-open>.  This creates a device-mapper "
22267 "device called C</dev/mapper/luksdev>."
22268 msgstr ""
22269
22270 # type: verbatim
22271 #. type: verbatim
22272 #: ../fish/guestfish.pod:735
22273 #, no-wrap
22274 msgid ""
22275 " ><fs> luks-open /dev/sda2 luksdev\n"
22276 " Enter key or passphrase (\"key\"): <enter the passphrase>\n"
22277 "\n"
22278 msgstr ""
22279
22280 # type: textblock
22281 #. type: textblock
22282 #: ../fish/guestfish.pod:738
22283 msgid ""
22284 "Finally you have to tell LVM to scan for volume groups on the newly created "
22285 "mapper device:"
22286 msgstr ""
22287
22288 # type: verbatim
22289 #. type: verbatim
22290 #: ../fish/guestfish.pod:741
22291 #, no-wrap
22292 msgid ""
22293 " vgscan\n"
22294 " vg-activate-all true\n"
22295 "\n"
22296 msgstr ""
22297
22298 # type: textblock
22299 #. type: textblock
22300 #: ../fish/guestfish.pod:744
22301 msgid "The logical volume(s) can now be mounted in the usual way."
22302 msgstr ""
22303
22304 # type: textblock
22305 #. type: textblock
22306 #: ../fish/guestfish.pod:746
22307 msgid ""
22308 "Before closing a LUKS device you must unmount any logical volumes on it and "
22309 "deactivate the volume groups by calling C<vg-activate false VG> on each "
22310 "one.  Then you can close the mapper device:"
22311 msgstr ""
22312
22313 # type: verbatim
22314 #. type: verbatim
22315 #: ../fish/guestfish.pod:750
22316 #, no-wrap
22317 msgid ""
22318 " vg-activate false /dev/VG\n"
22319 " luks-close /dev/mapper/luksdev\n"
22320 "\n"
22321 msgstr ""
22322
22323 # type: =head1
22324 #. type: =head1
22325 #: ../fish/guestfish.pod:753
22326 msgid "WINDOWS PATHS"
22327 msgstr ""
22328
22329 # type: textblock
22330 #. type: textblock
22331 #: ../fish/guestfish.pod:755
22332 msgid ""
22333 "If a path is prefixed with C<win:> then you can use Windows-style paths "
22334 "(with some limitations).  The following commands are equivalent:"
22335 msgstr ""
22336
22337 # type: verbatim
22338 #. type: verbatim
22339 #: ../fish/guestfish.pod:758
22340 #, no-wrap
22341 msgid ""
22342 " file /WINDOWS/system32/config/system.LOG\n"
22343 "\n"
22344 msgstr ""
22345
22346 # type: verbatim
22347 #. type: verbatim
22348 #: ../fish/guestfish.pod:760
22349 #, no-wrap
22350 msgid ""
22351 " file win:/windows/system32/config/system.log\n"
22352 "\n"
22353 msgstr ""
22354
22355 # type: verbatim
22356 #. type: verbatim
22357 #: ../fish/guestfish.pod:762
22358 #, no-wrap
22359 msgid ""
22360 " file win:\\windows\\system32\\config\\system.log\n"
22361 "\n"
22362 msgstr ""
22363
22364 # type: verbatim
22365 #. type: verbatim
22366 #: ../fish/guestfish.pod:764
22367 #, no-wrap
22368 msgid ""
22369 " file WIN:C:\\Windows\\SYSTEM32\\conFIG\\SYSTEM.LOG\n"
22370 "\n"
22371 msgstr ""
22372
22373 # type: textblock
22374 #. type: textblock
22375 #: ../fish/guestfish.pod:766
22376 msgid ""
22377 "This syntax implicitly calls C<case-sensitive-path> (q.v.) so it also "
22378 "handles case insensitivity like Windows would.  This only works in argument "
22379 "positions that expect a path."
22380 msgstr ""
22381
22382 # type: =head1
22383 #. type: =head1
22384 #: ../fish/guestfish.pod:770
22385 msgid "UPLOADING AND DOWNLOADING FILES"
22386 msgstr ""
22387
22388 # type: textblock
22389 #. type: textblock
22390 #: ../fish/guestfish.pod:772
22391 msgid ""
22392 "For commands such as C<upload>, C<download>, C<tar-in>, C<tar-out> and "
22393 "others which upload from or download to a local file, you can use the "
22394 "special filename C<-> to mean \"from stdin\" or \"to stdout\".  For example:"
22395 msgstr ""
22396
22397 # type: verbatim
22398 #. type: verbatim
22399 #: ../fish/guestfish.pod:776
22400 #, no-wrap
22401 msgid ""
22402 " upload - /foo\n"
22403 "\n"
22404 msgstr ""
22405
22406 # type: textblock
22407 #. type: textblock
22408 #: ../fish/guestfish.pod:778
22409 msgid ""
22410 "reads stdin and creates from that a file C</foo> in the disk image, and:"
22411 msgstr ""
22412
22413 # type: verbatim
22414 #. type: verbatim
22415 #: ../fish/guestfish.pod:781
22416 #, no-wrap
22417 msgid ""
22418 " tar-out /etc - | tar tf -\n"
22419 "\n"
22420 msgstr ""
22421
22422 # type: textblock
22423 #. type: textblock
22424 #: ../fish/guestfish.pod:783
22425 msgid ""
22426 "writes the tarball to stdout and then pipes that into the external \"tar\" "
22427 "command (see L</PIPES>)."
22428 msgstr ""
22429
22430 # type: textblock
22431 #. type: textblock
22432 #: ../fish/guestfish.pod:786
22433 msgid ""
22434 "When using C<-> to read from stdin, the input is read up to the end of "
22435 "stdin.  You can also use a special \"heredoc\"-like syntax to read up to "
22436 "some arbitrary end marker:"
22437 msgstr ""
22438
22439 # type: verbatim
22440 #. type: verbatim
22441 #: ../fish/guestfish.pod:790
22442 #, no-wrap
22443 msgid ""
22444 " upload -<<END /foo\n"
22445 " input line 1\n"
22446 " input line 2\n"
22447 " input line 3\n"
22448 " END\n"
22449 "\n"
22450 msgstr ""
22451
22452 # type: textblock
22453 #. type: textblock
22454 #: ../fish/guestfish.pod:796
22455 msgid ""
22456 "Any string of characters can be used instead of C<END>.  The end marker must "
22457 "appear on a line of its own, without any preceeding or following characters "
22458 "(not even spaces)."
22459 msgstr ""
22460
22461 # type: textblock
22462 #. type: textblock
22463 #: ../fish/guestfish.pod:800
22464 msgid ""
22465 "Note that the C<-E<lt>E<lt>> syntax only applies to parameters used to "
22466 "upload local files (so-called \"FileIn\" parameters in the generator)."
22467 msgstr ""
22468
22469 # type: =head1
22470 #. type: =head1
22471 #: ../fish/guestfish.pod:803
22472 msgid "EXIT ON ERROR BEHAVIOUR"
22473 msgstr ""
22474
22475 # type: textblock
22476 #. type: textblock
22477 #: ../fish/guestfish.pod:805
22478 msgid ""
22479 "By default, guestfish will ignore any errors when in interactive mode (ie. "
22480 "taking commands from a human over a tty), and will exit on the first error "
22481 "in non-interactive mode (scripts, commands given on the command line)."
22482 msgstr ""
22483
22484 # type: textblock
22485 #. type: textblock
22486 #: ../fish/guestfish.pod:810
22487 msgid ""
22488 "If you prefix a command with a I<-> character, then that command will not "
22489 "cause guestfish to exit, even if that (one) command returns an error."
22490 msgstr ""
22491
22492 # type: =head1
22493 #. type: =head1
22494 #: ../fish/guestfish.pod:814
22495 msgid "REMOTE CONTROL GUESTFISH OVER A SOCKET"
22496 msgstr ""
22497
22498 # type: textblock
22499 #. type: textblock
22500 #: ../fish/guestfish.pod:816
22501 msgid ""
22502 "Guestfish can be remote-controlled over a socket.  This is useful "
22503 "particularly in shell scripts where you want to make several different "
22504 "changes to a filesystem, but you don't want the overhead of starting up a "
22505 "guestfish process each time."
22506 msgstr ""
22507
22508 # type: textblock
22509 #. type: textblock
22510 #: ../fish/guestfish.pod:821
22511 msgid "Start a guestfish server process using:"
22512 msgstr ""
22513
22514 # type: verbatim
22515 #. type: verbatim
22516 #: ../fish/guestfish.pod:823
22517 #, no-wrap
22518 msgid ""
22519 " eval \"`guestfish --listen`\"\n"
22520 "\n"
22521 msgstr ""
22522
22523 # type: textblock
22524 #. type: textblock
22525 #: ../fish/guestfish.pod:825
22526 msgid "and then send it commands by doing:"
22527 msgstr ""
22528
22529 # type: verbatim
22530 #. type: verbatim
22531 #: ../fish/guestfish.pod:827
22532 #, no-wrap
22533 msgid ""
22534 " guestfish --remote cmd [...]\n"
22535 "\n"
22536 msgstr ""
22537
22538 # type: textblock
22539 #. type: textblock
22540 #: ../fish/guestfish.pod:829
22541 msgid "To cause the server to exit, send it the exit command:"
22542 msgstr ""
22543
22544 # type: verbatim
22545 #. type: verbatim
22546 #: ../fish/guestfish.pod:831
22547 #, no-wrap
22548 msgid ""
22549 " guestfish --remote exit\n"
22550 "\n"
22551 msgstr ""
22552
22553 # type: textblock
22554 #. type: textblock
22555 #: ../fish/guestfish.pod:833
22556 msgid ""
22557 "Note that the server will normally exit if there is an error in a command.  "
22558 "You can change this in the usual way.  See section L</EXIT ON ERROR "
22559 "BEHAVIOUR>."
22560 msgstr ""
22561
22562 # type: =head2
22563 #. type: =head2
22564 #: ../fish/guestfish.pod:837
22565 msgid "CONTROLLING MULTIPLE GUESTFISH PROCESSES"
22566 msgstr ""
22567
22568 # type: textblock
22569 #. type: textblock
22570 #: ../fish/guestfish.pod:839
22571 msgid ""
22572 "The C<eval> statement sets the environment variable C<$GUESTFISH_PID>, which "
22573 "is how the I<--remote> option knows where to send the commands.  You can "
22574 "have several guestfish listener processes running using:"
22575 msgstr ""
22576
22577 # type: verbatim
22578 #. type: verbatim
22579 #: ../fish/guestfish.pod:843
22580 #, no-wrap
22581 msgid ""
22582 " eval \"`guestfish --listen`\"\n"
22583 " pid1=$GUESTFISH_PID\n"
22584 " eval \"`guestfish --listen`\"\n"
22585 " pid2=$GUESTFISH_PID\n"
22586 " ...\n"
22587 " guestfish --remote=$pid1 cmd\n"
22588 " guestfish --remote=$pid2 cmd\n"
22589 "\n"
22590 msgstr ""
22591
22592 # type: =head2
22593 #. type: =head2
22594 #: ../fish/guestfish.pod:851
22595 msgid "REMOTE CONTROL AND CSH"
22596 msgstr ""
22597
22598 # type: textblock
22599 #. type: textblock
22600 #: ../fish/guestfish.pod:853
22601 msgid ""
22602 "When using csh-like shells (csh, tcsh etc) you have to add the I<--csh> "
22603 "option:"
22604 msgstr ""
22605
22606 # type: verbatim
22607 #. type: verbatim
22608 #: ../fish/guestfish.pod:856
22609 #, no-wrap
22610 msgid ""
22611 " eval \"`guestfish --listen --csh`\"\n"
22612 "\n"
22613 msgstr ""
22614
22615 # type: =head2
22616 #. type: =head2
22617 #: ../fish/guestfish.pod:858
22618 msgid "REMOTE CONTROL DETAILS"
22619 msgstr ""
22620
22621 # type: textblock
22622 #. type: textblock
22623 #: ../fish/guestfish.pod:860
22624 msgid ""
22625 "Remote control happens over a Unix domain socket called C</tmp/.guestfish-"
22626 "$UID/socket-$PID>, where C<$UID> is the effective user ID of the process, "
22627 "and C<$PID> is the process ID of the server."
22628 msgstr ""
22629
22630 # type: textblock
22631 #. type: textblock
22632 #: ../fish/guestfish.pod:864
22633 msgid "Guestfish client and server versions must match exactly."
22634 msgstr ""
22635
22636 #. type: =head2
22637 #: ../fish/guestfish.pod:866
22638 msgid "REMOTE CONTROL RUN COMMAND HANGING"
22639 msgstr ""
22640
22641 #. type: textblock
22642 #: ../fish/guestfish.pod:868
22643 msgid ""
22644 "Using the C<run> (or C<launch>) command remotely in a command substitution "
22645 "context hangs, ie. don't do (note the backquotes):"
22646 msgstr ""
22647
22648 #. type: verbatim
22649 #: ../fish/guestfish.pod:871
22650 #, no-wrap
22651 msgid ""
22652 " a=`guestfish --remote run`\n"
22653 "\n"
22654 msgstr ""
22655
22656 #. type: textblock
22657 #: ../fish/guestfish.pod:873
22658 msgid ""
22659 "Since the C<run> command produces no output on stdout, this is not useful "
22660 "anyway.  For further information see L<https://bugzilla.redhat.com/show_bug."
22661 "cgi?id=592910>."
22662 msgstr ""
22663
22664 # type: =head1
22665 #. type: =head1
22666 #: ../fish/guestfish.pod:877
22667 msgid "PREPARED DISK IMAGES"
22668 msgstr ""
22669
22670 # type: textblock
22671 #. type: textblock
22672 #: ../fish/guestfish.pod:879
22673 msgid ""
22674 "Use the I<-N type> or I<--new type> parameter to select one of a set of "
22675 "preformatted disk images that guestfish can make for you to save typing.  "
22676 "This is particularly useful for testing purposes.  This option is used "
22677 "instead of the I<-a> option, and like I<-a> can appear multiple times (and "
22678 "can be mixed with I<-a>)."
22679 msgstr ""
22680
22681 # type: textblock
22682 #. type: textblock
22683 #: ../fish/guestfish.pod:885
22684 msgid ""
22685 "The new disk is called C<test1.img> for the first I<-N>, C<test2.img> for "
22686 "the second and so on.  Existing files in the current directory are "
22687 "I<overwritten>."
22688 msgstr ""
22689
22690 # type: textblock
22691 #. type: textblock
22692 #: ../fish/guestfish.pod:889
22693 msgid ""
22694 "The type briefly describes how the disk should be sized, partitioned, how "
22695 "filesystem(s) should be created, and how content should be added.  "
22696 "Optionally the type can be followed by extra parameters, separated by C<:> "
22697 "(colon) characters.  For example, I<-N fs> creates a default 100MB, sparsely-"
22698 "allocated disk, containing a single partition, with the partition formatted "
22699 "as ext2.  I<-N fs:ext4:1G> is the same, but for an ext4 filesystem on a 1GB "
22700 "disk instead."
22701 msgstr ""
22702
22703 # type: textblock
22704 #. type: textblock
22705 #: ../fish/guestfish.pod:897
22706 msgid "To list the available types and any extra parameters they take, run:"
22707 msgstr ""
22708
22709 # type: textblock
22710 #. type: textblock
22711 #: ../fish/guestfish.pod:901
22712 msgid ""
22713 "Note that the prepared filesystem is not mounted.  You would usually have to "
22714 "use the C<mount /dev/sda1 /> command or add the I<-m /dev/sda1> option."
22715 msgstr ""
22716
22717 # type: textblock
22718 #. type: textblock
22719 #: ../fish/guestfish.pod:905
22720 msgid ""
22721 "If any I<-N> or I<--new> options are given, the guest is automatically "
22722 "launched."
22723 msgstr ""
22724
22725 # type: textblock
22726 #. type: textblock
22727 #: ../fish/guestfish.pod:910
22728 msgid "Create a 100MB disk with an ext4-formatted partition:"
22729 msgstr ""
22730
22731 # type: verbatim
22732 #. type: verbatim
22733 #: ../fish/guestfish.pod:912
22734 #, no-wrap
22735 msgid ""
22736 " guestfish -N fs:ext4\n"
22737 "\n"
22738 msgstr ""
22739
22740 # type: textblock
22741 #. type: textblock
22742 #: ../fish/guestfish.pod:914
22743 msgid "Create a 32MB disk with a VFAT-formatted partition, and mount it:"
22744 msgstr ""
22745
22746 # type: verbatim
22747 #. type: verbatim
22748 #: ../fish/guestfish.pod:916
22749 #, no-wrap
22750 msgid ""
22751 " guestfish -N fs:vfat:32M -m /dev/sda1\n"
22752 "\n"
22753 msgstr ""
22754
22755 # type: textblock
22756 #. type: textblock
22757 #: ../fish/guestfish.pod:918
22758 msgid "Create a blank 200MB disk:"
22759 msgstr ""
22760
22761 # type: verbatim
22762 #. type: verbatim
22763 #: ../fish/guestfish.pod:920
22764 #, no-wrap
22765 msgid ""
22766 " guestfish -N disk:200M\n"
22767 "\n"
22768 msgstr ""
22769
22770 # type: =head1
22771 #. type: =head1
22772 #: ../fish/guestfish.pod:922
22773 msgid "PROGRESS BARS"
22774 msgstr ""
22775
22776 # type: textblock
22777 #. type: textblock
22778 #: ../fish/guestfish.pod:924
22779 msgid ""
22780 "Some (not all) long-running commands send progress notification messages as "
22781 "they are running.  Guestfish turns these messages into progress bars."
22782 msgstr ""
22783
22784 # type: textblock
22785 #. type: textblock
22786 #: ../fish/guestfish.pod:928
22787 msgid ""
22788 "When a command that supports progress bars takes longer than two seconds to "
22789 "run, and if progress bars are enabled, then you will see one appearing below "
22790 "the command:"
22791 msgstr ""
22792
22793 # type: verbatim
22794 #. type: verbatim
22795 #: ../fish/guestfish.pod:932
22796 #, no-wrap
22797 msgid ""
22798 " ><fs> copy-size /large-file /another-file 2048M\n"
22799 " / 10% [#####-----------------------------------------] 00:30\n"
22800 "\n"
22801 msgstr ""
22802
22803 # type: textblock
22804 #. type: textblock
22805 #: ../fish/guestfish.pod:935
22806 msgid ""
22807 "The spinner on the left hand side moves round once for every progress "
22808 "notification received from the backend.  This is a (reasonably) golden "
22809 "assurance that the command is \"doing something\" even if the progress bar "
22810 "is not moving, because the command is able to send the progress "
22811 "notifications.  When the bar reaches 100% and the command finishes, the "
22812 "spinner disappears."
22813 msgstr ""
22814
22815 # type: textblock
22816 #. type: textblock
22817 #: ../fish/guestfish.pod:942
22818 msgid ""
22819 "Progress bars are enabled by default when guestfish is used interactively.  "
22820 "You can enable them even for non-interactive modes using I<--progress-bars>, "
22821 "and you can disable them completely using I<--no-progress-bars>."
22822 msgstr ""
22823
22824 # type: =head1
22825 #. type: =head1
22826 #: ../fish/guestfish.pod:947
22827 msgid "GUESTFISH COMMANDS"
22828 msgstr ""
22829
22830 # type: textblock
22831 #. type: textblock
22832 #: ../fish/guestfish.pod:949
22833 msgid ""
22834 "The commands in this section are guestfish convenience commands, in other "
22835 "words, they are not part of the L<guestfs(3)> API."
22836 msgstr ""
22837
22838 # type: =head2
22839 #. type: =head2
22840 #: ../fish/guestfish.pod:952
22841 msgid "help"
22842 msgstr ""
22843
22844 # type: verbatim
22845 #. type: verbatim
22846 #: ../fish/guestfish.pod:954
22847 #, no-wrap
22848 msgid ""
22849 " help\n"
22850 " help cmd\n"
22851 "\n"
22852 msgstr ""
22853
22854 # type: textblock
22855 #. type: textblock
22856 #: ../fish/guestfish.pod:957
22857 msgid "Without any parameter, this provides general help."
22858 msgstr ""
22859
22860 # type: textblock
22861 #. type: textblock
22862 #: ../fish/guestfish.pod:959
22863 msgid "With a C<cmd> parameter, this displays detailed help for that command."
22864 msgstr ""
22865
22866 # type: =head2
22867 #. type: =head2
22868 #: ../fish/guestfish.pod:961
22869 msgid "quit | exit"
22870 msgstr ""
22871
22872 # type: textblock
22873 #. type: textblock
22874 #: ../fish/guestfish.pod:963
22875 msgid "This exits guestfish.  You can also use C<^D> key."
22876 msgstr ""
22877
22878 # type: textblock
22879 #. type: textblock
22880 #: ../fish/guestfish.pod:965
22881 msgid "@FISH_COMMANDS@"
22882 msgstr ""
22883
22884 # type: =head1
22885 #. type: =head1
22886 #: ../fish/guestfish.pod:967
22887 msgid "COMMANDS"
22888 msgstr ""
22889
22890 # type: =head1
22891 #. type: =head1
22892 #: ../fish/guestfish.pod:971 ../test-tool/libguestfs-test-tool.pod:83
22893 msgid "EXIT CODE"
22894 msgstr ""
22895
22896 # type: textblock
22897 #. type: textblock
22898 #: ../fish/guestfish.pod:973
22899 msgid ""
22900 "guestfish returns 0 if the commands completed without error, or 1 if there "
22901 "was an error."
22902 msgstr ""
22903
22904 # type: =item
22905 #. type: =item
22906 #: ../fish/guestfish.pod:980
22907 msgid "EDITOR"
22908 msgstr ""
22909
22910 # type: textblock
22911 #. type: textblock
22912 #: ../fish/guestfish.pod:982
22913 msgid ""
22914 "The C<edit> command uses C<$EDITOR> as the editor.  If not set, it uses "
22915 "C<vi>."
22916 msgstr ""
22917
22918 # type: =item
22919 #. type: =item
22920 #: ../fish/guestfish.pod:985
22921 msgid "GUESTFISH_PID"
22922 msgstr ""
22923
22924 # type: textblock
22925 #. type: textblock
22926 #: ../fish/guestfish.pod:987
22927 msgid ""
22928 "Used with the I<--remote> option to specify the remote guestfish process to "
22929 "control.  See section L</REMOTE CONTROL GUESTFISH OVER A SOCKET>."
22930 msgstr ""
22931
22932 # type: =item
22933 #. type: =item
22934 #: ../fish/guestfish.pod:991
22935 msgid "HEXEDITOR"
22936 msgstr ""
22937
22938 # type: textblock
22939 #. type: textblock
22940 #: ../fish/guestfish.pod:993
22941 msgid ""
22942 "The L</hexedit> command uses C<$HEXEDITOR> as the external hex editor.  If "
22943 "not specified, the external L<hexedit(1)> program is used."
22944 msgstr ""
22945
22946 # type: =item
22947 #. type: =item
22948 #: ../fish/guestfish.pod:997
22949 msgid "HOME"
22950 msgstr ""
22951
22952 # type: textblock
22953 #. type: textblock
22954 #: ../fish/guestfish.pod:999
22955 msgid ""
22956 "If compiled with GNU readline support, various files in the home directory "
22957 "can be used.  See L</FILES>."
22958 msgstr ""
22959
22960 # type: textblock
22961 #. type: textblock
22962 #: ../fish/guestfish.pod:1008
22963 msgid ""
22964 "Set C<LIBGUESTFS_DEBUG=1> to enable verbose messages.  This has the same "
22965 "effect as using the B<-v> option."
22966 msgstr ""
22967
22968 # type: textblock
22969 #. type: textblock
22970 #: ../fish/guestfish.pod:1020
22971 msgid ""
22972 "Set the path that guestfish uses to search for kernel and initrd.img.  See "
22973 "the discussion of paths in L<guestfs(3)>."
22974 msgstr ""
22975
22976 # type: textblock
22977 #. type: textblock
22978 #: ../fish/guestfish.pod:1031
22979 msgid "Set C<LIBGUESTFS_TRACE=1> to enable command traces."
22980 msgstr ""
22981
22982 # type: =item
22983 #. type: =item
22984 #: ../fish/guestfish.pod:1033
22985 msgid "PAGER"
22986 msgstr ""
22987
22988 # type: textblock
22989 #. type: textblock
22990 #: ../fish/guestfish.pod:1035
22991 msgid ""
22992 "The C<more> command uses C<$PAGER> as the pager.  If not set, it uses "
22993 "C<more>."
22994 msgstr ""
22995
22996 # type: =head1
22997 #. type: =head1
22998 #: ../fish/guestfish.pod:1050 ../test-tool/libguestfs-test-tool.pod:88
22999 msgid "FILES"
23000 msgstr ""
23001
23002 # type: =item
23003 #. type: =item
23004 #: ../fish/guestfish.pod:1054
23005 msgid "$HOME/.guestfish"
23006 msgstr ""
23007
23008 # type: textblock
23009 #. type: textblock
23010 #: ../fish/guestfish.pod:1056
23011 msgid ""
23012 "If compiled with GNU readline support, then the command history is saved in "
23013 "this file."
23014 msgstr ""
23015
23016 # type: =item
23017 #. type: =item
23018 #: ../fish/guestfish.pod:1059
23019 msgid "$HOME/.inputrc"
23020 msgstr ""
23021
23022 # type: =item
23023 #. type: =item
23024 #: ../fish/guestfish.pod:1061
23025 msgid "/etc/inputrc"
23026 msgstr ""
23027
23028 # type: textblock
23029 #. type: textblock
23030 #: ../fish/guestfish.pod:1063
23031 msgid ""
23032 "If compiled with GNU readline support, then these files can be used to "
23033 "configure readline.  For further information, please see L<readline(3)/"
23034 "INITIALIZATION FILE>."
23035 msgstr ""
23036
23037 # type: textblock
23038 #. type: textblock
23039 #: ../fish/guestfish.pod:1067
23040 msgid "To write rules which only apply to guestfish, use:"
23041 msgstr ""
23042
23043 # type: verbatim
23044 #. type: verbatim
23045 #: ../fish/guestfish.pod:1069
23046 #, no-wrap
23047 msgid ""
23048 " $if guestfish\n"
23049 " ...\n"
23050 " $endif\n"
23051 "\n"
23052 msgstr ""
23053
23054 # type: textblock
23055 #. type: textblock
23056 #: ../fish/guestfish.pod:1073
23057 msgid ""
23058 "Variables that you can set in inputrc that change the behaviour of guestfish "
23059 "in useful ways include:"
23060 msgstr ""
23061
23062 # type: =item
23063 #. type: =item
23064 #: ../fish/guestfish.pod:1078
23065 msgid "completion-ignore-case (default: on)"
23066 msgstr ""
23067
23068 # type: textblock
23069 #. type: textblock
23070 #: ../fish/guestfish.pod:1080
23071 msgid ""
23072 "By default, guestfish will ignore case when tab-completing paths on the "
23073 "disk.  Use:"
23074 msgstr ""
23075
23076 # type: verbatim
23077 #. type: verbatim
23078 #: ../fish/guestfish.pod:1083
23079 #, no-wrap
23080 msgid ""
23081 " set completion-ignore-case off\n"
23082 "\n"
23083 msgstr ""
23084
23085 # type: textblock
23086 #. type: textblock
23087 #: ../fish/guestfish.pod:1085
23088 msgid "to make guestfish case sensitive."
23089 msgstr ""
23090
23091 # type: =item
23092 #. type: =item
23093 #: ../fish/guestfish.pod:1089
23094 msgid "test1.img"
23095 msgstr ""
23096
23097 # type: =item
23098 #. type: =item
23099 #: ../fish/guestfish.pod:1091
23100 msgid "test2.img (etc)"
23101 msgstr ""
23102
23103 # type: textblock
23104 #. type: textblock
23105 #: ../fish/guestfish.pod:1093
23106 msgid ""
23107 "When using the C<-N> or C<--new> option, the prepared disk or filesystem "
23108 "will be created in the file C<test1.img> in the current directory.  The "
23109 "second use of C<-N> will use C<test2.img> and so on.  Any existing file with "
23110 "the same name will be overwritten."
23111 msgstr ""
23112
23113 # type: textblock
23114 #. type: textblock
23115 #: ../fish/guestfish.pod:1102
23116 msgid ""
23117 "L<guestfs(3)>, L<http://libguestfs.org/>, L<virt-cat(1)>, L<virt-df(1)>, "
23118 "L<virt-edit(1)>, L<virt-filesystems(1)>, L<virt-inspector(1)>, L<virt-list-"
23119 "filesystems(1)>, L<virt-list-partitions(1)>, L<virt-ls(1)>, L<virt-make-fs(1)"
23120 ">, L<virt-rescue(1)>, L<virt-resize(1)>, L<virt-tar(1)>, L<virt-win-reg(1)>, "
23121 "L<hexedit(1)>."
23122 msgstr ""
23123
23124 # type: textblock
23125 #. type: textblock
23126 #: ../fish/guestfish.pod:1128 ../test-tool/libguestfs-test-tool.pod:124
23127 #: ../fuse/guestmount.pod:253 ../tools/virt-edit.pl:415
23128 #: ../tools/virt-win-reg.pl:606 ../tools/virt-resize.pl:1512
23129 #: ../tools/virt-list-filesystems.pl:210 ../tools/virt-tar.pl:300
23130 #: ../tools/virt-make-fs.pl:572 ../tools/virt-list-partitions.pl:277
23131 msgid ""
23132 "This program is free software; you can redistribute it and/or modify it "
23133 "under the terms of the GNU General Public License as published by the Free "
23134 "Software Foundation; either version 2 of the License, or (at your option) "
23135 "any later version."
23136 msgstr ""
23137
23138 # type: textblock
23139 #. type: textblock
23140 #: ../fish/guestfish.pod:1133 ../test-tool/libguestfs-test-tool.pod:129
23141 #: ../fuse/guestmount.pod:258 ../tools/virt-edit.pl:420
23142 #: ../tools/virt-win-reg.pl:611 ../tools/virt-resize.pl:1517
23143 #: ../tools/virt-list-filesystems.pl:215 ../tools/virt-tar.pl:305
23144 #: ../tools/virt-make-fs.pl:577 ../tools/virt-list-partitions.pl:282
23145 msgid ""
23146 "This program is distributed in the hope that it will be useful, but WITHOUT "
23147 "ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or "
23148 "FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for "
23149 "more details."
23150 msgstr ""
23151
23152 # type: textblock
23153 #. type: textblock
23154 #: ../fish/guestfish.pod:1138 ../test-tool/libguestfs-test-tool.pod:134
23155 #: ../fuse/guestmount.pod:263 ../tools/virt-edit.pl:425
23156 #: ../tools/virt-win-reg.pl:616 ../tools/virt-resize.pl:1522
23157 #: ../tools/virt-list-filesystems.pl:220 ../tools/virt-tar.pl:310
23158 #: ../tools/virt-make-fs.pl:582 ../tools/virt-list-partitions.pl:287
23159 msgid ""
23160 "You should have received a copy of the GNU General Public License along with "
23161 "this program; if not, write to the Free Software Foundation, Inc., 675 Mass "
23162 "Ave, Cambridge, MA 02139, USA."
23163 msgstr ""
23164
23165 # type: =head2
23166 #. type: =head2
23167 #: ../fish/guestfish-actions.pod:1
23168 msgid "add-cdrom"
23169 msgstr ""
23170
23171 # type: verbatim
23172 #. type: verbatim
23173 #: ../fish/guestfish-actions.pod:3
23174 #, no-wrap
23175 msgid ""
23176 " add-cdrom filename\n"
23177 "\n"
23178 msgstr ""
23179
23180 # type: textblock
23181 #. type: textblock
23182 #: ../fish/guestfish-actions.pod:15
23183 msgid ""
23184 "This call checks for the existence of C<filename>.  This stops you from "
23185 "specifying other types of drive which are supported by qemu such as C<nbd:> "
23186 "and C<http:> URLs.  To specify those, use the general L</config> call "
23187 "instead."
23188 msgstr ""
23189
23190 # type: textblock
23191 #. type: textblock
23192 #: ../fish/guestfish-actions.pod:22
23193 msgid ""
23194 "If you just want to add an ISO file (often you use this as an efficient way "
23195 "to transfer large files into the guest), then you should probably use L</add-"
23196 "drive-ro> instead."
23197 msgstr ""
23198
23199 #. type: textblock
23200 #: ../fish/guestfish-actions.pod:28 ../fish/guestfish-actions.pod:151
23201 #: ../fish/guestfish-actions.pod:165
23202 msgid ""
23203 "This function is deprecated.  In new code, use the L</add_drive_opts> call "
23204 "instead."
23205 msgstr ""
23206
23207 # type: =head2
23208 #. type: =head2
23209 #: ../fish/guestfish-actions.pod:35
23210 msgid "add-domain"
23211 msgstr ""
23212
23213 # type: =head2
23214 #. type: =head2
23215 #: ../fish/guestfish-actions.pod:37
23216 msgid "domain"
23217 msgstr ""
23218
23219 # type: verbatim
23220 #. type: verbatim
23221 #: ../fish/guestfish-actions.pod:39
23222 #, no-wrap
23223 msgid ""
23224 " add-domain dom [libvirturi:..] [readonly:..] [iface:..]\n"
23225 "\n"
23226 msgstr ""
23227
23228 # type: textblock
23229 #. type: textblock
23230 #: ../fish/guestfish-actions.pod:41
23231 msgid ""
23232 "This function adds the disk(s) attached to the named libvirt domain C<dom>.  "
23233 "It works by connecting to libvirt, requesting the domain and domain XML from "
23234 "libvirt, parsing it for disks, and calling L</add-drive-opts> on each one."
23235 msgstr ""
23236
23237 # type: textblock
23238 #. type: textblock
23239 #: ../fish/guestfish-actions.pod:64
23240 msgid ""
23241 "The other optional parameters are passed directly through to L</add-drive-"
23242 "opts>."
23243 msgstr ""
23244
23245 # type: textblock
23246 #. type: textblock
23247 #: ../fish/guestfish-actions.pod:67 ../fish/guestfish-actions.pod:131
23248 #: ../fish/guestfish-actions.pod:2872
23249 msgid ""
23250 "This command has one or more optional arguments.  See L</OPTIONAL ARGUMENTS>."
23251 msgstr ""
23252
23253 # type: =head2
23254 #. type: =head2
23255 #: ../fish/guestfish-actions.pod:69
23256 msgid "add-drive"
23257 msgstr ""
23258
23259 # type: verbatim
23260 #. type: verbatim
23261 #: ../fish/guestfish-actions.pod:71
23262 #, no-wrap
23263 msgid ""
23264 " add-drive filename\n"
23265 "\n"
23266 msgstr ""
23267
23268 # type: textblock
23269 #. type: textblock
23270 #: ../fish/guestfish-actions.pod:73
23271 msgid ""
23272 "This function is the equivalent of calling L</add-drive-opts> with no "
23273 "optional parameters, so the disk is added writable, with the format being "
23274 "detected automatically."
23275 msgstr ""
23276
23277 # type: textblock
23278 #. type: textblock
23279 #: ../fish/guestfish-actions.pod:77
23280 msgid ""
23281 "Automatic detection of the format opens you up to a potential security hole "
23282 "when dealing with untrusted raw-format images.  See CVE-2010-3851 and "
23283 "RHBZ#642934.  Specifying the format closes this security hole.  Therefore "
23284 "you should think about replacing calls to this function with calls to L</add-"
23285 "drive-opts>, and specifying the format."
23286 msgstr ""
23287
23288 # type: =head2
23289 #. type: =head2
23290 #: ../fish/guestfish-actions.pod:84
23291 msgid "add-drive-opts"
23292 msgstr ""
23293
23294 # type: =head2
23295 #. type: =head2
23296 #: ../fish/guestfish-actions.pod:86
23297 msgid "add"
23298 msgstr ""
23299
23300 # type: verbatim
23301 #. type: verbatim
23302 #: ../fish/guestfish-actions.pod:88
23303 #, no-wrap
23304 msgid ""
23305 " add-drive-opts filename [readonly:..] [format:..] [iface:..]\n"
23306 "\n"
23307 msgstr ""
23308
23309 # type: textblock
23310 #. type: textblock
23311 #: ../fish/guestfish-actions.pod:115
23312 msgid ""
23313 "This forces the image format.  If you omit this (or use L</add-drive> or L</"
23314 "add-drive-ro>) then the format is automatically detected.  Possible formats "
23315 "include C<raw> and C<qcow2>."
23316 msgstr ""
23317
23318 # type: textblock
23319 #. type: textblock
23320 #: ../fish/guestfish-actions.pod:126
23321 msgid ""
23322 "This rarely-used option lets you emulate the behaviour of the deprecated L</"
23323 "add-drive-with-if> call (q.v.)"
23324 msgstr ""
23325
23326 # type: =head2
23327 #. type: =head2
23328 #: ../fish/guestfish-actions.pod:133
23329 msgid "add-drive-ro"
23330 msgstr ""
23331
23332 # type: =head2
23333 #. type: =head2
23334 #: ../fish/guestfish-actions.pod:135
23335 msgid "add-ro"
23336 msgstr ""
23337
23338 # type: verbatim
23339 #. type: verbatim
23340 #: ../fish/guestfish-actions.pod:137
23341 #, no-wrap
23342 msgid ""
23343 " add-drive-ro filename\n"
23344 "\n"
23345 msgstr ""
23346
23347 # type: textblock
23348 #. type: textblock
23349 #: ../fish/guestfish-actions.pod:139
23350 msgid ""
23351 "This function is the equivalent of calling L</add-drive-opts> with the "
23352 "optional parameter C<GUESTFS_ADD_DRIVE_OPTS_READONLY> set to 1, so the disk "
23353 "is added read-only, with the format being detected automatically."
23354 msgstr ""
23355
23356 # type: =head2
23357 #. type: =head2
23358 #: ../fish/guestfish-actions.pod:144
23359 msgid "add-drive-ro-with-if"
23360 msgstr ""
23361
23362 # type: verbatim
23363 #. type: verbatim
23364 #: ../fish/guestfish-actions.pod:146
23365 #, no-wrap
23366 msgid ""
23367 " add-drive-ro-with-if filename iface\n"
23368 "\n"
23369 msgstr ""
23370
23371 # type: textblock
23372 #. type: textblock
23373 #: ../fish/guestfish-actions.pod:148
23374 msgid ""
23375 "This is the same as L</add-drive-ro> but it allows you to specify the QEMU "
23376 "interface emulation to use at run time."
23377 msgstr ""
23378
23379 # type: =head2
23380 #. type: =head2
23381 #: ../fish/guestfish-actions.pod:158
23382 msgid "add-drive-with-if"
23383 msgstr ""
23384
23385 # type: verbatim
23386 #. type: verbatim
23387 #: ../fish/guestfish-actions.pod:160
23388 #, no-wrap
23389 msgid ""
23390 " add-drive-with-if filename iface\n"
23391 "\n"
23392 msgstr ""
23393
23394 # type: textblock
23395 #. type: textblock
23396 #: ../fish/guestfish-actions.pod:162
23397 msgid ""
23398 "This is the same as L</add-drive> but it allows you to specify the QEMU "
23399 "interface emulation to use at run time."
23400 msgstr ""
23401
23402 # type: =head2
23403 #. type: =head2
23404 #: ../fish/guestfish-actions.pod:172
23405 msgid "aug-clear"
23406 msgstr ""
23407
23408 # type: verbatim
23409 #. type: verbatim
23410 #: ../fish/guestfish-actions.pod:174
23411 #, no-wrap
23412 msgid ""
23413 " aug-clear augpath\n"
23414 "\n"
23415 msgstr ""
23416
23417 # type: =head2
23418 #. type: =head2
23419 #: ../fish/guestfish-actions.pod:179
23420 msgid "aug-close"
23421 msgstr ""
23422
23423 # type: verbatim
23424 #. type: verbatim
23425 #: ../fish/guestfish-actions.pod:181
23426 #, no-wrap
23427 msgid ""
23428 " aug-close\n"
23429 "\n"
23430 msgstr ""
23431
23432 # type: textblock
23433 #. type: textblock
23434 #: ../fish/guestfish-actions.pod:183
23435 msgid ""
23436 "Close the current Augeas handle and free up any resources used by it.  After "
23437 "calling this, you have to call L</aug-init> again before you can use any "
23438 "other Augeas functions."
23439 msgstr ""
23440
23441 # type: =head2
23442 #. type: =head2
23443 #: ../fish/guestfish-actions.pod:188
23444 msgid "aug-defnode"
23445 msgstr ""
23446
23447 # type: verbatim
23448 #. type: verbatim
23449 #: ../fish/guestfish-actions.pod:190
23450 #, no-wrap
23451 msgid ""
23452 " aug-defnode name expr val\n"
23453 "\n"
23454 msgstr ""
23455
23456 # type: textblock
23457 #. type: textblock
23458 #: ../fish/guestfish-actions.pod:195
23459 msgid ""
23460 "If C<expr> evaluates to an empty nodeset, a node is created, equivalent to "
23461 "calling L</aug-set> C<expr>, C<value>.  C<name> will be the nodeset "
23462 "containing that single node."
23463 msgstr ""
23464
23465 # type: =head2
23466 #. type: =head2
23467 #: ../fish/guestfish-actions.pod:203
23468 msgid "aug-defvar"
23469 msgstr ""
23470
23471 # type: verbatim
23472 #. type: verbatim
23473 #: ../fish/guestfish-actions.pod:205
23474 #, no-wrap
23475 msgid ""
23476 " aug-defvar name expr\n"
23477 "\n"
23478 msgstr ""
23479
23480 # type: =head2
23481 #. type: =head2
23482 #: ../fish/guestfish-actions.pod:214
23483 msgid "aug-get"
23484 msgstr ""
23485
23486 # type: verbatim
23487 #. type: verbatim
23488 #: ../fish/guestfish-actions.pod:216
23489 #, no-wrap
23490 msgid ""
23491 " aug-get augpath\n"
23492 "\n"
23493 msgstr ""
23494
23495 # type: =head2
23496 #. type: =head2
23497 #: ../fish/guestfish-actions.pod:221
23498 msgid "aug-init"
23499 msgstr ""
23500
23501 # type: verbatim
23502 #. type: verbatim
23503 #: ../fish/guestfish-actions.pod:223
23504 #, no-wrap
23505 msgid ""
23506 " aug-init root flags\n"
23507 "\n"
23508 msgstr ""
23509
23510 # type: textblock
23511 #. type: textblock
23512 #: ../fish/guestfish-actions.pod:229
23513 msgid "You must call this before using any other L</aug-*> commands."
23514 msgstr ""
23515
23516 #. type: textblock
23517 #: ../fish/guestfish-actions.pod:254
23518 msgid ""
23519 "This option is only useful when debugging Augeas lenses.  Use of this option "
23520 "may require additional memory for the libguestfs appliance.  You may need to "
23521 "set the C<LIBGUESTFS_MEMSIZE> environment variable or call L</set-memsize>."
23522 msgstr ""
23523
23524 # type: textblock
23525 #. type: textblock
23526 #: ../fish/guestfish-actions.pod:269
23527 msgid "Do not load the tree in L</aug-init>."
23528 msgstr ""
23529
23530 # type: textblock
23531 #. type: textblock
23532 #: ../fish/guestfish-actions.pod:273
23533 msgid "To close the handle, you can call L</aug-close>."
23534 msgstr ""
23535
23536 # type: =head2
23537 #. type: =head2
23538 #: ../fish/guestfish-actions.pod:277
23539 msgid "aug-insert"
23540 msgstr ""
23541
23542 # type: verbatim
23543 #. type: verbatim
23544 #: ../fish/guestfish-actions.pod:279
23545 #, no-wrap
23546 msgid ""
23547 " aug-insert augpath label true|false\n"
23548 "\n"
23549 msgstr ""
23550
23551 # type: =head2
23552 #. type: =head2
23553 #: ../fish/guestfish-actions.pod:289
23554 msgid "aug-load"
23555 msgstr ""
23556
23557 # type: verbatim
23558 #. type: verbatim
23559 #: ../fish/guestfish-actions.pod:291
23560 #, no-wrap
23561 msgid ""
23562 " aug-load\n"
23563 "\n"
23564 msgstr ""
23565
23566 # type: =head2
23567 #. type: =head2
23568 #: ../fish/guestfish-actions.pod:298
23569 msgid "aug-ls"
23570 msgstr ""
23571
23572 # type: verbatim
23573 #. type: verbatim
23574 #: ../fish/guestfish-actions.pod:300
23575 #, no-wrap
23576 msgid ""
23577 " aug-ls augpath\n"
23578 "\n"
23579 msgstr ""
23580
23581 # type: textblock
23582 #. type: textblock
23583 #: ../fish/guestfish-actions.pod:302
23584 msgid ""
23585 "This is just a shortcut for listing L</aug-match> C<path/*> and sorting the "
23586 "resulting nodes into alphabetical order."
23587 msgstr ""
23588
23589 # type: =head2
23590 #. type: =head2
23591 #: ../fish/guestfish-actions.pod:305
23592 msgid "aug-match"
23593 msgstr ""
23594
23595 # type: verbatim
23596 #. type: verbatim
23597 #: ../fish/guestfish-actions.pod:307
23598 #, no-wrap
23599 msgid ""
23600 " aug-match augpath\n"
23601 "\n"
23602 msgstr ""
23603
23604 # type: =head2
23605 #. type: =head2
23606 #: ../fish/guestfish-actions.pod:313
23607 msgid "aug-mv"
23608 msgstr ""
23609
23610 # type: verbatim
23611 #. type: verbatim
23612 #: ../fish/guestfish-actions.pod:315
23613 #, no-wrap
23614 msgid ""
23615 " aug-mv src dest\n"
23616 "\n"
23617 msgstr ""
23618
23619 # type: =head2
23620 #. type: =head2
23621 #: ../fish/guestfish-actions.pod:320
23622 msgid "aug-rm"
23623 msgstr ""
23624
23625 # type: verbatim
23626 #. type: verbatim
23627 #: ../fish/guestfish-actions.pod:322
23628 #, no-wrap
23629 msgid ""
23630 " aug-rm augpath\n"
23631 "\n"
23632 msgstr ""
23633
23634 # type: =head2
23635 #. type: =head2
23636 #: ../fish/guestfish-actions.pod:328
23637 msgid "aug-save"
23638 msgstr ""
23639
23640 # type: verbatim
23641 #. type: verbatim
23642 #: ../fish/guestfish-actions.pod:330
23643 #, no-wrap
23644 msgid ""
23645 " aug-save\n"
23646 "\n"
23647 msgstr ""
23648
23649 # type: textblock
23650 #. type: textblock
23651 #: ../fish/guestfish-actions.pod:334
23652 msgid ""
23653 "The flags which were passed to L</aug-init> affect exactly how files are "
23654 "saved."
23655 msgstr ""
23656
23657 # type: =head2
23658 #. type: =head2
23659 #: ../fish/guestfish-actions.pod:337
23660 msgid "aug-set"
23661 msgstr ""
23662
23663 # type: verbatim
23664 #. type: verbatim
23665 #: ../fish/guestfish-actions.pod:339
23666 #, no-wrap
23667 msgid ""
23668 " aug-set augpath val\n"
23669 "\n"
23670 msgstr ""
23671
23672 # type: textblock
23673 #. type: textblock
23674 #: ../fish/guestfish-actions.pod:343
23675 msgid ""
23676 "In the Augeas API, it is possible to clear a node by setting the value to "
23677 "NULL.  Due to an oversight in the libguestfs API you cannot do that with "
23678 "this call.  Instead you must use the L</aug-clear> call."
23679 msgstr ""
23680
23681 # type: =head2
23682 #. type: =head2
23683 #: ../fish/guestfish-actions.pod:348
23684 msgid "available"
23685 msgstr ""
23686
23687 # type: verbatim
23688 #. type: verbatim
23689 #: ../fish/guestfish-actions.pod:350
23690 #, no-wrap
23691 msgid ""
23692 " available 'groups ...'\n"
23693 "\n"
23694 msgstr ""
23695
23696 # type: textblock
23697 #. type: textblock
23698 #: ../fish/guestfish-actions.pod:356
23699 msgid ""
23700 "The libguestfs groups, and the functions that those groups correspond to, "
23701 "are listed in L<guestfs(3)/AVAILABILITY>.  You can also fetch this list at "
23702 "runtime by calling L</available-all-groups>."
23703 msgstr ""
23704
23705 # type: textblock
23706 #. type: textblock
23707 #: ../fish/guestfish-actions.pod:380
23708 msgid "You must call L</launch> before calling this function."
23709 msgstr ""
23710
23711 # type: textblock
23712 #. type: textblock
23713 #: ../fish/guestfish-actions.pod:402
23714 msgid ""
23715 "This call was added in version C<1.0.80>.  In previous versions of "
23716 "libguestfs all you could do would be to speculatively execute a command to "
23717 "find out if the daemon implemented it.  See also L</version>."
23718 msgstr ""
23719
23720 # type: =head2
23721 #. type: =head2
23722 #: ../fish/guestfish-actions.pod:409
23723 msgid "available-all-groups"
23724 msgstr ""
23725
23726 # type: verbatim
23727 #. type: verbatim
23728 #: ../fish/guestfish-actions.pod:411
23729 #, no-wrap
23730 msgid ""
23731 " available-all-groups\n"
23732 "\n"
23733 msgstr ""
23734
23735 # type: textblock
23736 #. type: textblock
23737 #: ../fish/guestfish-actions.pod:413
23738 msgid ""
23739 "This command returns a list of all optional groups that this daemon knows "
23740 "about.  Note this returns both supported and unsupported groups.  To find "
23741 "out which ones the daemon can actually support you have to call L</"
23742 "available> on each member of the returned list."
23743 msgstr ""
23744
23745 # type: textblock
23746 #. type: textblock
23747 #: ../fish/guestfish-actions.pod:419
23748 msgid "See also L</available> and L<guestfs(3)/AVAILABILITY>."
23749 msgstr ""
23750
23751 # type: =head2
23752 #. type: =head2
23753 #: ../fish/guestfish-actions.pod:421
23754 msgid "base64-in"
23755 msgstr ""
23756
23757 # type: verbatim
23758 #. type: verbatim
23759 #: ../fish/guestfish-actions.pod:423
23760 #, no-wrap
23761 msgid ""
23762 " base64-in (base64file|-) filename\n"
23763 "\n"
23764 msgstr ""
23765
23766 # type: textblock
23767 #. type: textblock
23768 #: ../fish/guestfish-actions.pod:428 ../fish/guestfish-actions.pod:437
23769 #: ../fish/guestfish-actions.pod:661 ../fish/guestfish-actions.pod:830
23770 #: ../fish/guestfish-actions.pod:849 ../fish/guestfish-actions.pod:1223
23771 #: ../fish/guestfish-actions.pod:4236 ../fish/guestfish-actions.pod:4248
23772 #: ../fish/guestfish-actions.pod:4259 ../fish/guestfish-actions.pod:4270
23773 #: ../fish/guestfish-actions.pod:4322 ../fish/guestfish-actions.pod:4331
23774 #: ../fish/guestfish-actions.pod:4385 ../fish/guestfish-actions.pod:4408
23775 msgid "Use C<-> instead of a filename to read/write from stdin/stdout."
23776 msgstr ""
23777
23778 # type: =head2
23779 #. type: =head2
23780 #: ../fish/guestfish-actions.pod:430
23781 msgid "base64-out"
23782 msgstr ""
23783
23784 # type: verbatim
23785 #. type: verbatim
23786 #: ../fish/guestfish-actions.pod:432
23787 #, no-wrap
23788 msgid ""
23789 " base64-out filename (base64file|-)\n"
23790 "\n"
23791 msgstr ""
23792
23793 # type: =head2
23794 #. type: =head2
23795 #: ../fish/guestfish-actions.pod:439
23796 msgid "blockdev-flushbufs"
23797 msgstr ""
23798
23799 # type: verbatim
23800 #. type: verbatim
23801 #: ../fish/guestfish-actions.pod:441
23802 #, no-wrap
23803 msgid ""
23804 " blockdev-flushbufs device\n"
23805 "\n"
23806 msgstr ""
23807
23808 # type: =head2
23809 #. type: =head2
23810 #: ../fish/guestfish-actions.pod:448
23811 msgid "blockdev-getbsz"
23812 msgstr ""
23813
23814 # type: verbatim
23815 #. type: verbatim
23816 #: ../fish/guestfish-actions.pod:450
23817 #, no-wrap
23818 msgid ""
23819 " blockdev-getbsz device\n"
23820 "\n"
23821 msgstr ""
23822
23823 # type: =head2
23824 #. type: =head2
23825 #: ../fish/guestfish-actions.pod:459
23826 msgid "blockdev-getro"
23827 msgstr ""
23828
23829 # type: verbatim
23830 #. type: verbatim
23831 #: ../fish/guestfish-actions.pod:461
23832 #, no-wrap
23833 msgid ""
23834 " blockdev-getro device\n"
23835 "\n"
23836 msgstr ""
23837
23838 # type: =head2
23839 #. type: =head2
23840 #: ../fish/guestfish-actions.pod:468
23841 msgid "blockdev-getsize64"
23842 msgstr ""
23843
23844 # type: verbatim
23845 #. type: verbatim
23846 #: ../fish/guestfish-actions.pod:470
23847 #, no-wrap
23848 msgid ""
23849 " blockdev-getsize64 device\n"
23850 "\n"
23851 msgstr ""
23852
23853 # type: textblock
23854 #. type: textblock
23855 #: ../fish/guestfish-actions.pod:474
23856 msgid "See also L</blockdev-getsz>."
23857 msgstr ""
23858
23859 # type: =head2
23860 #. type: =head2
23861 #: ../fish/guestfish-actions.pod:478
23862 msgid "blockdev-getss"
23863 msgstr ""
23864
23865 # type: verbatim
23866 #. type: verbatim
23867 #: ../fish/guestfish-actions.pod:480
23868 #, no-wrap
23869 msgid ""
23870 " blockdev-getss device\n"
23871 "\n"
23872 msgstr ""
23873
23874 # type: textblock
23875 #. type: textblock
23876 #: ../fish/guestfish-actions.pod:485
23877 msgid ""
23878 "(Note, this is not the size in sectors, use L</blockdev-getsz> for that)."
23879 msgstr ""
23880
23881 # type: =head2
23882 #. type: =head2
23883 #: ../fish/guestfish-actions.pod:490
23884 msgid "blockdev-getsz"
23885 msgstr ""
23886
23887 # type: verbatim
23888 #. type: verbatim
23889 #: ../fish/guestfish-actions.pod:492
23890 #, no-wrap
23891 msgid ""
23892 " blockdev-getsz device\n"
23893 "\n"
23894 msgstr ""
23895
23896 # type: textblock
23897 #. type: textblock
23898 #: ../fish/guestfish-actions.pod:497
23899 msgid ""
23900 "See also L</blockdev-getss> for the real sector size of the device, and L</"
23901 "blockdev-getsize64> for the more useful I<size in bytes>."
23902 msgstr ""
23903
23904 # type: =head2
23905 #. type: =head2
23906 #: ../fish/guestfish-actions.pod:503
23907 msgid "blockdev-rereadpt"
23908 msgstr ""
23909
23910 # type: verbatim
23911 #. type: verbatim
23912 #: ../fish/guestfish-actions.pod:505
23913 #, no-wrap
23914 msgid ""
23915 " blockdev-rereadpt device\n"
23916 "\n"
23917 msgstr ""
23918
23919 # type: =head2
23920 #. type: =head2
23921 #: ../fish/guestfish-actions.pod:511
23922 msgid "blockdev-setbsz"
23923 msgstr ""
23924
23925 # type: verbatim
23926 #. type: verbatim
23927 #: ../fish/guestfish-actions.pod:513
23928 #, no-wrap
23929 msgid ""
23930 " blockdev-setbsz device blocksize\n"
23931 "\n"
23932 msgstr ""
23933
23934 # type: =head2
23935 #. type: =head2
23936 #: ../fish/guestfish-actions.pod:522
23937 msgid "blockdev-setro"
23938 msgstr ""
23939
23940 # type: verbatim
23941 #. type: verbatim
23942 #: ../fish/guestfish-actions.pod:524
23943 #, no-wrap
23944 msgid ""
23945 " blockdev-setro device\n"
23946 "\n"
23947 msgstr ""
23948
23949 # type: =head2
23950 #. type: =head2
23951 #: ../fish/guestfish-actions.pod:530
23952 msgid "blockdev-setrw"
23953 msgstr ""
23954
23955 # type: verbatim
23956 #. type: verbatim
23957 #: ../fish/guestfish-actions.pod:532
23958 #, no-wrap
23959 msgid ""
23960 " blockdev-setrw device\n"
23961 "\n"
23962 msgstr ""
23963
23964 # type: =head2
23965 #. type: =head2
23966 #: ../fish/guestfish-actions.pod:538
23967 msgid "case-sensitive-path"
23968 msgstr ""
23969
23970 # type: verbatim
23971 #. type: verbatim
23972 #: ../fish/guestfish-actions.pod:540
23973 #, no-wrap
23974 msgid ""
23975 " case-sensitive-path path\n"
23976 "\n"
23977 msgstr ""
23978
23979 # type: textblock
23980 #. type: textblock
23981 #: ../fish/guestfish-actions.pod:564
23982 msgid ""
23983 "Thus L</case-sensitive-path> (\"/Windows/System32\")  might return C<\"/"
23984 "WINDOWS/system32\"> (the exact return value would depend on details of how "
23985 "the directories were originally created under Windows)."
23986 msgstr ""
23987
23988 # type: textblock
23989 #. type: textblock
23990 #: ../fish/guestfish-actions.pod:572
23991 msgid "See also L</realpath>."
23992 msgstr ""
23993
23994 # type: =head2
23995 #. type: =head2
23996 #: ../fish/guestfish-actions.pod:574
23997 msgid "cat"
23998 msgstr ""
23999
24000 # type: verbatim
24001 #. type: verbatim
24002 #: ../fish/guestfish-actions.pod:576
24003 #, no-wrap
24004 msgid ""
24005 " cat path\n"
24006 "\n"
24007 msgstr ""
24008
24009 # type: textblock
24010 #. type: textblock
24011 #: ../fish/guestfish-actions.pod:580
24012 msgid ""
24013 "Note that this function cannot correctly handle binary files (specifically, "
24014 "files containing C<\\0> character which is treated as end of string).  For "
24015 "those you need to use the L</read-file> or L</download> functions which have "
24016 "a more complex interface."
24017 msgstr ""
24018
24019 # type: =head2
24020 #. type: =head2
24021 #: ../fish/guestfish-actions.pod:588
24022 msgid "checksum"
24023 msgstr ""
24024
24025 # type: verbatim
24026 #. type: verbatim
24027 #: ../fish/guestfish-actions.pod:590
24028 #, no-wrap
24029 msgid ""
24030 " checksum csumtype path\n"
24031 "\n"
24032 msgstr ""
24033
24034 # type: textblock
24035 #. type: textblock
24036 #: ../fish/guestfish-actions.pod:633
24037 msgid "To get the checksum for a device, use L</checksum-device>."
24038 msgstr ""
24039
24040 # type: textblock
24041 #. type: textblock
24042 #: ../fish/guestfish-actions.pod:635
24043 msgid "To get the checksums for many files, use L</checksums-out>."
24044 msgstr ""
24045
24046 # type: =head2
24047 #. type: =head2
24048 #: ../fish/guestfish-actions.pod:637
24049 msgid "checksum-device"
24050 msgstr ""
24051
24052 # type: verbatim
24053 #. type: verbatim
24054 #: ../fish/guestfish-actions.pod:639
24055 #, no-wrap
24056 msgid ""
24057 " checksum-device csumtype device\n"
24058 "\n"
24059 msgstr ""
24060
24061 # type: textblock
24062 #. type: textblock
24063 #: ../fish/guestfish-actions.pod:641
24064 msgid ""
24065 "This call computes the MD5, SHAx or CRC checksum of the contents of the "
24066 "device named C<device>.  For the types of checksums supported see the L</"
24067 "checksum> command."
24068 msgstr ""
24069
24070 # type: =head2
24071 #. type: =head2
24072 #: ../fish/guestfish-actions.pod:645
24073 msgid "checksums-out"
24074 msgstr ""
24075
24076 # type: verbatim
24077 #. type: verbatim
24078 #: ../fish/guestfish-actions.pod:647
24079 #, no-wrap
24080 msgid ""
24081 " checksums-out csumtype directory (sumsfile|-)\n"
24082 "\n"
24083 msgstr ""
24084
24085 # type: =head2
24086 #. type: =head2
24087 #: ../fish/guestfish-actions.pod:663
24088 msgid "chmod"
24089 msgstr ""
24090
24091 # type: verbatim
24092 #. type: verbatim
24093 #: ../fish/guestfish-actions.pod:665
24094 #, no-wrap
24095 msgid ""
24096 " chmod mode path\n"
24097 "\n"
24098 msgstr ""
24099
24100 # type: =head2
24101 #. type: =head2
24102 #: ../fish/guestfish-actions.pod:676
24103 msgid "chown"
24104 msgstr ""
24105
24106 # type: verbatim
24107 #. type: verbatim
24108 #: ../fish/guestfish-actions.pod:678
24109 #, no-wrap
24110 msgid ""
24111 " chown owner group path\n"
24112 "\n"
24113 msgstr ""
24114
24115 # type: =head2
24116 #. type: =head2
24117 #: ../fish/guestfish-actions.pod:686
24118 msgid "command"
24119 msgstr ""
24120
24121 # type: verbatim
24122 #. type: verbatim
24123 #: ../fish/guestfish-actions.pod:688
24124 #, no-wrap
24125 msgid ""
24126 " command 'arguments ...'\n"
24127 "\n"
24128 msgstr ""
24129
24130 # type: textblock
24131 #. type: textblock
24132 #: ../fish/guestfish-actions.pod:695
24133 msgid ""
24134 "The single parameter is an argv-style list of arguments.  The first element "
24135 "is the name of the program to run.  Subsequent elements are parameters.  The "
24136 "list must be non-empty (ie. must contain a program name).  Note that the "
24137 "command runs directly, and is I<not> invoked via the shell (see L</sh>)."
24138 msgstr ""
24139
24140 # type: =head2
24141 #. type: =head2
24142 #: ../fish/guestfish-actions.pod:723
24143 msgid "command-lines"
24144 msgstr ""
24145
24146 # type: verbatim
24147 #. type: verbatim
24148 #: ../fish/guestfish-actions.pod:725
24149 #, no-wrap
24150 msgid ""
24151 " command-lines 'arguments ...'\n"
24152 "\n"
24153 msgstr ""
24154
24155 # type: textblock
24156 #. type: textblock
24157 #: ../fish/guestfish-actions.pod:727
24158 msgid ""
24159 "This is the same as L</command>, but splits the result into a list of lines."
24160 msgstr ""
24161
24162 # type: textblock
24163 #. type: textblock
24164 #: ../fish/guestfish-actions.pod:730
24165 msgid "See also: L</sh-lines>"
24166 msgstr ""
24167
24168 # type: =head2
24169 #. type: =head2
24170 #: ../fish/guestfish-actions.pod:735
24171 msgid "config"
24172 msgstr ""
24173
24174 # type: verbatim
24175 #. type: verbatim
24176 #: ../fish/guestfish-actions.pod:737
24177 #, no-wrap
24178 msgid ""
24179 " config qemuparam qemuvalue\n"
24180 "\n"
24181 msgstr ""
24182
24183 # type: =head2
24184 #. type: =head2
24185 #: ../fish/guestfish-actions.pod:748
24186 msgid "copy-size"
24187 msgstr ""
24188
24189 # type: verbatim
24190 #. type: verbatim
24191 #: ../fish/guestfish-actions.pod:750
24192 #, no-wrap
24193 msgid ""
24194 " copy-size src dest size\n"
24195 "\n"
24196 msgstr ""
24197
24198 # type: =head2
24199 #. type: =head2
24200 #: ../fish/guestfish-actions.pod:758
24201 msgid "cp"
24202 msgstr ""
24203
24204 # type: verbatim
24205 #. type: verbatim
24206 #: ../fish/guestfish-actions.pod:760
24207 #, no-wrap
24208 msgid ""
24209 " cp src dest\n"
24210 "\n"
24211 msgstr ""
24212
24213 # type: =head2
24214 #. type: =head2
24215 #: ../fish/guestfish-actions.pod:765
24216 msgid "cp-a"
24217 msgstr ""
24218
24219 # type: verbatim
24220 #. type: verbatim
24221 #: ../fish/guestfish-actions.pod:767
24222 #, no-wrap
24223 msgid ""
24224 " cp-a src dest\n"
24225 "\n"
24226 msgstr ""
24227
24228 # type: =head2
24229 #. type: =head2
24230 #: ../fish/guestfish-actions.pod:772
24231 msgid "dd"
24232 msgstr ""
24233
24234 # type: verbatim
24235 #. type: verbatim
24236 #: ../fish/guestfish-actions.pod:774
24237 #, no-wrap
24238 msgid ""
24239 " dd src dest\n"
24240 "\n"
24241 msgstr ""
24242
24243 # type: textblock
24244 #. type: textblock
24245 #: ../fish/guestfish-actions.pod:781
24246 msgid ""
24247 "If the destination is a device, it must be as large or larger than the "
24248 "source file or device, otherwise the copy will fail.  This command cannot do "
24249 "partial copies (see L</copy-size>)."
24250 msgstr ""
24251
24252 # type: =head2
24253 #. type: =head2
24254 #: ../fish/guestfish-actions.pod:785
24255 msgid "df"
24256 msgstr ""
24257
24258 # type: verbatim
24259 #. type: verbatim
24260 #: ../fish/guestfish-actions.pod:787
24261 #, no-wrap
24262 msgid ""
24263 " df\n"
24264 "\n"
24265 msgstr ""
24266
24267 # type: textblock
24268 #. type: textblock
24269 #: ../fish/guestfish-actions.pod:791 ../fish/guestfish-actions.pod:802
24270 msgid ""
24271 "This command is mostly useful for interactive sessions.  It is I<not> "
24272 "intended that you try to parse the output string.  Use L</statvfs> from "
24273 "programs."
24274 msgstr ""
24275
24276 # type: =head2
24277 #. type: =head2
24278 #: ../fish/guestfish-actions.pod:795
24279 msgid "df-h"
24280 msgstr ""
24281
24282 # type: verbatim
24283 #. type: verbatim
24284 #: ../fish/guestfish-actions.pod:797
24285 #, no-wrap
24286 msgid ""
24287 " df-h\n"
24288 "\n"
24289 msgstr ""
24290
24291 # type: =head2
24292 #. type: =head2
24293 #: ../fish/guestfish-actions.pod:806
24294 msgid "dmesg"
24295 msgstr ""
24296
24297 # type: verbatim
24298 #. type: verbatim
24299 #: ../fish/guestfish-actions.pod:808
24300 #, no-wrap
24301 msgid ""
24302 " dmesg\n"
24303 "\n"
24304 msgstr ""
24305
24306 # type: textblock
24307 #. type: textblock
24308 #: ../fish/guestfish-actions.pod:814
24309 msgid ""
24310 "Another way to get the same information is to enable verbose messages with "
24311 "L</set-verbose> or by setting the environment variable C<LIBGUESTFS_DEBUG=1> "
24312 "before running the program."
24313 msgstr ""
24314
24315 # type: =head2
24316 #. type: =head2
24317 #: ../fish/guestfish-actions.pod:819
24318 msgid "download"
24319 msgstr ""
24320
24321 # type: verbatim
24322 #. type: verbatim
24323 #: ../fish/guestfish-actions.pod:821
24324 #, no-wrap
24325 msgid ""
24326 " download remotefilename (filename|-)\n"
24327 "\n"
24328 msgstr ""
24329
24330 # type: textblock
24331 #. type: textblock
24332 #: ../fish/guestfish-actions.pod:828
24333 msgid "See also L</upload>, L</cat>."
24334 msgstr ""
24335
24336 # type: =head2
24337 #. type: =head2
24338 #: ../fish/guestfish-actions.pod:832
24339 msgid "download-offset"
24340 msgstr ""
24341
24342 # type: verbatim
24343 #. type: verbatim
24344 #: ../fish/guestfish-actions.pod:834
24345 #, no-wrap
24346 msgid ""
24347 " download-offset remotefilename (filename|-) offset size\n"
24348 "\n"
24349 msgstr ""
24350
24351 # type: textblock
24352 #. type: textblock
24353 #: ../fish/guestfish-actions.pod:842
24354 msgid ""
24355 "Note that there is no limit on the amount of data that can be downloaded "
24356 "with this call, unlike with L</pread>, and this call always reads the full "
24357 "amount unless an error occurs."
24358 msgstr ""
24359
24360 # type: textblock
24361 #. type: textblock
24362 #: ../fish/guestfish-actions.pod:847
24363 msgid "See also L</download>, L</pread>."
24364 msgstr ""
24365
24366 # type: =head2
24367 #. type: =head2
24368 #: ../fish/guestfish-actions.pod:851
24369 msgid "drop-caches"
24370 msgstr ""
24371
24372 # type: verbatim
24373 #. type: verbatim
24374 #: ../fish/guestfish-actions.pod:853
24375 #, no-wrap
24376 msgid ""
24377 " drop-caches whattodrop\n"
24378 "\n"
24379 msgstr ""
24380
24381 # type: =head2
24382 #. type: =head2
24383 #: ../fish/guestfish-actions.pod:865
24384 msgid "du"
24385 msgstr ""
24386
24387 # type: verbatim
24388 #. type: verbatim
24389 #: ../fish/guestfish-actions.pod:867
24390 #, no-wrap
24391 msgid ""
24392 " du path\n"
24393 "\n"
24394 msgstr ""
24395
24396 # type: =head2
24397 #. type: =head2
24398 #: ../fish/guestfish-actions.pod:879
24399 msgid "e2fsck-f"
24400 msgstr ""
24401
24402 # type: verbatim
24403 #. type: verbatim
24404 #: ../fish/guestfish-actions.pod:881
24405 #, no-wrap
24406 msgid ""
24407 " e2fsck-f device\n"
24408 "\n"
24409 msgstr ""
24410
24411 # type: textblock
24412 #. type: textblock
24413 #: ../fish/guestfish-actions.pod:887
24414 msgid ""
24415 "This command is only needed because of L</resize2fs> (q.v.).  Normally you "
24416 "should use L</fsck>."
24417 msgstr ""
24418
24419 # type: =head2
24420 #. type: =head2
24421 #: ../fish/guestfish-actions.pod:890
24422 msgid "echo-daemon"
24423 msgstr ""
24424
24425 # type: verbatim
24426 #. type: verbatim
24427 #: ../fish/guestfish-actions.pod:892
24428 #, no-wrap
24429 msgid ""
24430 " echo-daemon 'words ...'\n"
24431 "\n"
24432 msgstr ""
24433
24434 # type: textblock
24435 #. type: textblock
24436 #: ../fish/guestfish-actions.pod:899
24437 msgid "See also L</ping-daemon>."
24438 msgstr ""
24439
24440 # type: =head2
24441 #. type: =head2
24442 #: ../fish/guestfish-actions.pod:901
24443 msgid "egrep"
24444 msgstr ""
24445
24446 # type: verbatim
24447 #. type: verbatim
24448 #: ../fish/guestfish-actions.pod:903
24449 #, no-wrap
24450 msgid ""
24451 " egrep regex path\n"
24452 "\n"
24453 msgstr ""
24454
24455 # type: =head2
24456 #. type: =head2
24457 #: ../fish/guestfish-actions.pod:911
24458 msgid "egrepi"
24459 msgstr ""
24460
24461 # type: verbatim
24462 #. type: verbatim
24463 #: ../fish/guestfish-actions.pod:913
24464 #, no-wrap
24465 msgid ""
24466 " egrepi regex path\n"
24467 "\n"
24468 msgstr ""
24469
24470 # type: =head2
24471 #. type: =head2
24472 #: ../fish/guestfish-actions.pod:921
24473 msgid "equal"
24474 msgstr ""
24475
24476 # type: verbatim
24477 #. type: verbatim
24478 #: ../fish/guestfish-actions.pod:923
24479 #, no-wrap
24480 msgid ""
24481 " equal file1 file2\n"
24482 "\n"
24483 msgstr ""
24484
24485 # type: =head2
24486 #. type: =head2
24487 #: ../fish/guestfish-actions.pod:930
24488 msgid "exists"
24489 msgstr ""
24490
24491 # type: verbatim
24492 #. type: verbatim
24493 #: ../fish/guestfish-actions.pod:932
24494 #, no-wrap
24495 msgid ""
24496 " exists path\n"
24497 "\n"
24498 msgstr ""
24499
24500 # type: textblock
24501 #. type: textblock
24502 #: ../fish/guestfish-actions.pod:937
24503 msgid "See also L</is-file>, L</is-dir>, L</stat>."
24504 msgstr ""
24505
24506 # type: =head2
24507 #. type: =head2
24508 #: ../fish/guestfish-actions.pod:939
24509 msgid "fallocate"
24510 msgstr ""
24511
24512 # type: verbatim
24513 #. type: verbatim
24514 #: ../fish/guestfish-actions.pod:941
24515 #, no-wrap
24516 msgid ""
24517 " fallocate path len\n"
24518 "\n"
24519 msgstr ""
24520
24521 #. type: textblock
24522 #: ../fish/guestfish-actions.pod:951
24523 msgid ""
24524 "This function is deprecated.  In new code, use the L</fallocate64> call "
24525 "instead."
24526 msgstr ""
24527
24528 # type: =head2
24529 #. type: =head2
24530 #: ../fish/guestfish-actions.pod:958
24531 msgid "fallocate64"
24532 msgstr ""
24533
24534 # type: verbatim
24535 #. type: verbatim
24536 #: ../fish/guestfish-actions.pod:960
24537 #, no-wrap
24538 msgid ""
24539 " fallocate64 path len\n"
24540 "\n"
24541 msgstr ""
24542
24543 # type: textblock
24544 #. type: textblock
24545 #: ../fish/guestfish-actions.pod:966
24546 msgid ""
24547 "Note that this call allocates disk blocks for the file.  To create a sparse "
24548 "file use L</truncate-size> instead."
24549 msgstr ""
24550
24551 # type: textblock
24552 #. type: textblock
24553 #: ../fish/guestfish-actions.pod:969
24554 msgid ""
24555 "The deprecated call L</fallocate> does the same, but owing to an oversight "
24556 "it only allowed 30 bit lengths to be specified, effectively limiting the "
24557 "maximum size of files created through that call to 1GB."
24558 msgstr ""
24559
24560 # type: =head2
24561 #. type: =head2
24562 #: ../fish/guestfish-actions.pod:978
24563 msgid "fgrep"
24564 msgstr ""
24565
24566 # type: verbatim
24567 #. type: verbatim
24568 #: ../fish/guestfish-actions.pod:980
24569 #, no-wrap
24570 msgid ""
24571 " fgrep pattern path\n"
24572 "\n"
24573 msgstr ""
24574
24575 # type: =head2
24576 #. type: =head2
24577 #: ../fish/guestfish-actions.pod:988
24578 msgid "fgrepi"
24579 msgstr ""
24580
24581 # type: verbatim
24582 #. type: verbatim
24583 #: ../fish/guestfish-actions.pod:990
24584 #, no-wrap
24585 msgid ""
24586 " fgrepi pattern path\n"
24587 "\n"
24588 msgstr ""
24589
24590 # type: =head2
24591 #. type: =head2
24592 #: ../fish/guestfish-actions.pod:998
24593 msgid "file"
24594 msgstr ""
24595
24596 # type: verbatim
24597 #. type: verbatim
24598 #: ../fish/guestfish-actions.pod:1000
24599 #, no-wrap
24600 msgid ""
24601 " file path\n"
24602 "\n"
24603 msgstr ""
24604
24605 #. type: textblock
24606 #: ../fish/guestfish-actions.pod:1016
24607 msgid ""
24608 "See also: L<file(1)>, L</vfs-type>, L</lstat>, L</is-file>, L</is-blockdev> "
24609 "(etc)."
24610 msgstr ""
24611
24612 # type: =head2
24613 #. type: =head2
24614 #: ../fish/guestfish-actions.pod:1019
24615 msgid "file-architecture"
24616 msgstr ""
24617
24618 # type: verbatim
24619 #. type: verbatim
24620 #: ../fish/guestfish-actions.pod:1021
24621 #, no-wrap
24622 msgid ""
24623 " file-architecture filename\n"
24624 "\n"
24625 msgstr ""
24626
24627 # type: =head2
24628 #. type: =head2
24629 #: ../fish/guestfish-actions.pod:1124
24630 msgid "filesize"
24631 msgstr ""
24632
24633 # type: verbatim
24634 #. type: verbatim
24635 #: ../fish/guestfish-actions.pod:1126
24636 #, no-wrap
24637 msgid ""
24638 " filesize file\n"
24639 "\n"
24640 msgstr ""
24641
24642 # type: textblock
24643 #. type: textblock
24644 #: ../fish/guestfish-actions.pod:1130
24645 msgid ""
24646 "To get other stats about a file, use L</stat>, L</lstat>, L</is-dir>, L</is-"
24647 "file> etc.  To get the size of block devices, use L</blockdev-getsize64>."
24648 msgstr ""
24649
24650 # type: =head2
24651 #. type: =head2
24652 #: ../fish/guestfish-actions.pod:1134
24653 msgid "fill"
24654 msgstr ""
24655
24656 # type: verbatim
24657 #. type: verbatim
24658 #: ../fish/guestfish-actions.pod:1136
24659 #, no-wrap
24660 msgid ""
24661 " fill c len path\n"
24662 "\n"
24663 msgstr ""
24664
24665 # type: textblock
24666 #. type: textblock
24667 #: ../fish/guestfish-actions.pod:1142
24668 msgid ""
24669 "To fill a file with zero bytes (sparsely), it is much more efficient to use "
24670 "L</truncate-size>.  To create a file with a pattern of repeating bytes use "
24671 "L</fill-pattern>."
24672 msgstr ""
24673
24674 # type: =head2
24675 #. type: =head2
24676 #: ../fish/guestfish-actions.pod:1147
24677 msgid "fill-pattern"
24678 msgstr ""
24679
24680 # type: verbatim
24681 #. type: verbatim
24682 #: ../fish/guestfish-actions.pod:1149
24683 #, no-wrap
24684 msgid ""
24685 " fill-pattern pattern len path\n"
24686 "\n"
24687 msgstr ""
24688
24689 # type: textblock
24690 #. type: textblock
24691 #: ../fish/guestfish-actions.pod:1151
24692 msgid ""
24693 "This function is like L</fill> except that it creates a new file of length "
24694 "C<len> containing the repeating pattern of bytes in C<pattern>.  The pattern "
24695 "is truncated if necessary to ensure the length of the file is exactly C<len> "
24696 "bytes."
24697 msgstr ""
24698
24699 # type: =head2
24700 #. type: =head2
24701 #: ../fish/guestfish-actions.pod:1156
24702 msgid "find"
24703 msgstr ""
24704
24705 # type: verbatim
24706 #. type: verbatim
24707 #: ../fish/guestfish-actions.pod:1158
24708 #, no-wrap
24709 msgid ""
24710 " find directory\n"
24711 "\n"
24712 msgstr ""
24713
24714 # type: textblock
24715 #. type: textblock
24716 #: ../fish/guestfish-actions.pod:1172
24717 msgid "then the returned list from L</find> C</tmp> would be 4 elements:"
24718 msgstr ""
24719
24720 # type: textblock
24721 #. type: textblock
24722 #: ../fish/guestfish-actions.pod:1185
24723 msgid "See also L</find0>."
24724 msgstr ""
24725
24726 # type: =head2
24727 #. type: =head2
24728 #: ../fish/guestfish-actions.pod:1190
24729 msgid "find0"
24730 msgstr ""
24731
24732 # type: verbatim
24733 #. type: verbatim
24734 #: ../fish/guestfish-actions.pod:1192
24735 #, no-wrap
24736 msgid ""
24737 " find0 directory (files|-)\n"
24738 "\n"
24739 msgstr ""
24740
24741 # type: textblock
24742 #. type: textblock
24743 #: ../fish/guestfish-actions.pod:1198
24744 msgid ""
24745 "This command works the same way as L</find> with the following exceptions:"
24746 msgstr ""
24747
24748 # type: =head2
24749 #. type: =head2
24750 #: ../fish/guestfish-actions.pod:1225
24751 msgid "findfs-label"
24752 msgstr ""
24753
24754 # type: verbatim
24755 #. type: verbatim
24756 #: ../fish/guestfish-actions.pod:1227
24757 #, no-wrap
24758 msgid ""
24759 " findfs-label label\n"
24760 "\n"
24761 msgstr ""
24762
24763 # type: textblock
24764 #. type: textblock
24765 #: ../fish/guestfish-actions.pod:1233
24766 msgid "To find the label of a filesystem, use L</vfs-label>."
24767 msgstr ""
24768
24769 # type: =head2
24770 #. type: =head2
24771 #: ../fish/guestfish-actions.pod:1235
24772 msgid "findfs-uuid"
24773 msgstr ""
24774
24775 # type: verbatim
24776 #. type: verbatim
24777 #: ../fish/guestfish-actions.pod:1237
24778 #, no-wrap
24779 msgid ""
24780 " findfs-uuid uuid\n"
24781 "\n"
24782 msgstr ""
24783
24784 # type: textblock
24785 #. type: textblock
24786 #: ../fish/guestfish-actions.pod:1243
24787 msgid "To find the UUID of a filesystem, use L</vfs-uuid>."
24788 msgstr ""
24789
24790 # type: =head2
24791 #. type: =head2
24792 #: ../fish/guestfish-actions.pod:1245
24793 msgid "fsck"
24794 msgstr ""
24795
24796 # type: verbatim
24797 #. type: verbatim
24798 #: ../fish/guestfish-actions.pod:1247
24799 #, no-wrap
24800 msgid ""
24801 " fsck fstype device\n"
24802 "\n"
24803 msgstr ""
24804
24805 # type: =head2
24806 #. type: =head2
24807 #: ../fish/guestfish-actions.pod:1277
24808 msgid "get-append"
24809 msgstr ""
24810
24811 # type: verbatim
24812 #. type: verbatim
24813 #: ../fish/guestfish-actions.pod:1279
24814 #, no-wrap
24815 msgid ""
24816 " get-append\n"
24817 "\n"
24818 msgstr ""
24819
24820 # type: =head2
24821 #. type: =head2
24822 #: ../fish/guestfish-actions.pod:1286
24823 msgid "get-autosync"
24824 msgstr ""
24825
24826 # type: verbatim
24827 #. type: verbatim
24828 #: ../fish/guestfish-actions.pod:1288
24829 #, no-wrap
24830 msgid ""
24831 " get-autosync\n"
24832 "\n"
24833 msgstr ""
24834
24835 # type: =head2
24836 #. type: =head2
24837 #: ../fish/guestfish-actions.pod:1292
24838 msgid "get-direct"
24839 msgstr ""
24840
24841 # type: verbatim
24842 #. type: verbatim
24843 #: ../fish/guestfish-actions.pod:1294
24844 #, no-wrap
24845 msgid ""
24846 " get-direct\n"
24847 "\n"
24848 msgstr ""
24849
24850 # type: =head2
24851 #. type: =head2
24852 #: ../fish/guestfish-actions.pod:1298
24853 msgid "get-e2label"
24854 msgstr ""
24855
24856 # type: verbatim
24857 #. type: verbatim
24858 #: ../fish/guestfish-actions.pod:1300
24859 #, no-wrap
24860 msgid ""
24861 " get-e2label device\n"
24862 "\n"
24863 msgstr ""
24864
24865 #. type: textblock
24866 #: ../fish/guestfish-actions.pod:1305
24867 msgid ""
24868 "This function is deprecated.  In new code, use the L</vfs_label> call "
24869 "instead."
24870 msgstr ""
24871
24872 # type: =head2
24873 #. type: =head2
24874 #: ../fish/guestfish-actions.pod:1312
24875 msgid "get-e2uuid"
24876 msgstr ""
24877
24878 # type: verbatim
24879 #. type: verbatim
24880 #: ../fish/guestfish-actions.pod:1314
24881 #, no-wrap
24882 msgid ""
24883 " get-e2uuid device\n"
24884 "\n"
24885 msgstr ""
24886
24887 #. type: textblock
24888 #: ../fish/guestfish-actions.pod:1319
24889 msgid ""
24890 "This function is deprecated.  In new code, use the L</vfs_uuid> call instead."
24891 msgstr ""
24892
24893 # type: =head2
24894 #. type: =head2
24895 #: ../fish/guestfish-actions.pod:1326
24896 msgid "get-memsize"
24897 msgstr ""
24898
24899 # type: verbatim
24900 #. type: verbatim
24901 #: ../fish/guestfish-actions.pod:1328
24902 #, no-wrap
24903 msgid ""
24904 " get-memsize\n"
24905 "\n"
24906 msgstr ""
24907
24908 # type: textblock
24909 #. type: textblock
24910 #: ../fish/guestfish-actions.pod:1333
24911 msgid ""
24912 "If L</set-memsize> was not called on this handle, and if "
24913 "C<LIBGUESTFS_MEMSIZE> was not set, then this returns the compiled-in default "
24914 "value for memsize."
24915 msgstr ""
24916
24917 # type: =head2
24918 #. type: =head2
24919 #: ../fish/guestfish-actions.pod:1340
24920 msgid "get-network"
24921 msgstr ""
24922
24923 # type: verbatim
24924 #. type: verbatim
24925 #: ../fish/guestfish-actions.pod:1342
24926 #, no-wrap
24927 msgid ""
24928 " get-network\n"
24929 "\n"
24930 msgstr ""
24931
24932 # type: =head2
24933 #. type: =head2
24934 #: ../fish/guestfish-actions.pod:1346
24935 msgid "get-path"
24936 msgstr ""
24937
24938 # type: verbatim
24939 #. type: verbatim
24940 #: ../fish/guestfish-actions.pod:1348
24941 #, no-wrap
24942 msgid ""
24943 " get-path\n"
24944 "\n"
24945 msgstr ""
24946
24947 # type: =head2
24948 #. type: =head2
24949 #: ../fish/guestfish-actions.pod:1355
24950 msgid "get-pid"
24951 msgstr ""
24952
24953 # type: =head2
24954 #. type: =head2
24955 #: ../fish/guestfish-actions.pod:1357
24956 msgid "pid"
24957 msgstr ""
24958
24959 # type: verbatim
24960 #. type: verbatim
24961 #: ../fish/guestfish-actions.pod:1359
24962 #, no-wrap
24963 msgid ""
24964 " get-pid\n"
24965 "\n"
24966 msgstr ""
24967
24968 # type: =head2
24969 #. type: =head2
24970 #: ../fish/guestfish-actions.pod:1366
24971 msgid "get-qemu"
24972 msgstr ""
24973
24974 # type: verbatim
24975 #. type: verbatim
24976 #: ../fish/guestfish-actions.pod:1368
24977 #, no-wrap
24978 msgid ""
24979 " get-qemu\n"
24980 "\n"
24981 msgstr ""
24982
24983 # type: =head2
24984 #. type: =head2
24985 #: ../fish/guestfish-actions.pod:1375
24986 msgid "get-recovery-proc"
24987 msgstr ""
24988
24989 # type: verbatim
24990 #. type: verbatim
24991 #: ../fish/guestfish-actions.pod:1377
24992 #, no-wrap
24993 msgid ""
24994 " get-recovery-proc\n"
24995 "\n"
24996 msgstr ""
24997
24998 # type: =head2
24999 #. type: =head2
25000 #: ../fish/guestfish-actions.pod:1381
25001 msgid "get-selinux"
25002 msgstr ""
25003
25004 # type: verbatim
25005 #. type: verbatim
25006 #: ../fish/guestfish-actions.pod:1383
25007 #, no-wrap
25008 msgid ""
25009 " get-selinux\n"
25010 "\n"
25011 msgstr ""
25012
25013 # type: textblock
25014 #. type: textblock
25015 #: ../fish/guestfish-actions.pod:1385
25016 msgid ""
25017 "This returns the current setting of the selinux flag which is passed to the "
25018 "appliance at boot time.  See L</set-selinux>."
25019 msgstr ""
25020
25021 # type: =head2
25022 #. type: =head2
25023 #: ../fish/guestfish-actions.pod:1391
25024 msgid "get-state"
25025 msgstr ""
25026
25027 # type: verbatim
25028 #. type: verbatim
25029 #: ../fish/guestfish-actions.pod:1393
25030 #, no-wrap
25031 msgid ""
25032 " get-state\n"
25033 "\n"
25034 msgstr ""
25035
25036 # type: =head2
25037 #. type: =head2
25038 #: ../fish/guestfish-actions.pod:1400
25039 msgid "get-trace"
25040 msgstr ""
25041
25042 # type: verbatim
25043 #. type: verbatim
25044 #: ../fish/guestfish-actions.pod:1402
25045 #, no-wrap
25046 msgid ""
25047 " get-trace\n"
25048 "\n"
25049 msgstr ""
25050
25051 # type: =head2
25052 #. type: =head2
25053 #: ../fish/guestfish-actions.pod:1406
25054 msgid "get-umask"
25055 msgstr ""
25056
25057 # type: verbatim
25058 #. type: verbatim
25059 #: ../fish/guestfish-actions.pod:1408
25060 #, no-wrap
25061 msgid ""
25062 " get-umask\n"
25063 "\n"
25064 msgstr ""
25065
25066 # type: textblock
25067 #. type: textblock
25068 #: ../fish/guestfish-actions.pod:1410
25069 msgid ""
25070 "Return the current umask.  By default the umask is C<022> unless it has been "
25071 "set by calling L</umask>."
25072 msgstr ""
25073
25074 # type: =head2
25075 #. type: =head2
25076 #: ../fish/guestfish-actions.pod:1413
25077 msgid "get-verbose"
25078 msgstr ""
25079
25080 # type: verbatim
25081 #. type: verbatim
25082 #: ../fish/guestfish-actions.pod:1415
25083 #, no-wrap
25084 msgid ""
25085 " get-verbose\n"
25086 "\n"
25087 msgstr ""
25088
25089 # type: =head2
25090 #. type: =head2
25091 #: ../fish/guestfish-actions.pod:1419
25092 msgid "getcon"
25093 msgstr ""
25094
25095 # type: verbatim
25096 #. type: verbatim
25097 #: ../fish/guestfish-actions.pod:1421
25098 #, no-wrap
25099 msgid ""
25100 " getcon\n"
25101 "\n"
25102 msgstr ""
25103
25104 # type: textblock
25105 #. type: textblock
25106 #: ../fish/guestfish-actions.pod:1425
25107 msgid "See the documentation about SELINUX in L<guestfs(3)>, and L</setcon>"
25108 msgstr ""
25109
25110 # type: =head2
25111 #. type: =head2
25112 #: ../fish/guestfish-actions.pod:1428
25113 msgid "getxattr"
25114 msgstr ""
25115
25116 # type: verbatim
25117 #. type: verbatim
25118 #: ../fish/guestfish-actions.pod:1430
25119 #, no-wrap
25120 msgid ""
25121 " getxattr path name\n"
25122 "\n"
25123 msgstr ""
25124
25125 # type: textblock
25126 #. type: textblock
25127 #: ../fish/guestfish-actions.pod:1432
25128 msgid ""
25129 "Get a single extended attribute from file C<path> named C<name>.  This call "
25130 "follows symlinks.  If you want to lookup an extended attribute for the "
25131 "symlink itself, use L</lgetxattr>."
25132 msgstr ""
25133
25134 # type: textblock
25135 #. type: textblock
25136 #: ../fish/guestfish-actions.pod:1436 ../fish/guestfish-actions.pod:2289
25137 msgid ""
25138 "Normally it is better to get all extended attributes from a file in one go "
25139 "by calling L</getxattrs>.  However some Linux filesystem implementations are "
25140 "buggy and do not provide a way to list out attributes.  For these "
25141 "filesystems (notably ntfs-3g)  you have to know the names of the extended "
25142 "attributes you want in advance and call this function."
25143 msgstr ""
25144
25145 # type: textblock
25146 #. type: textblock
25147 #: ../fish/guestfish-actions.pod:1446
25148 msgid "See also: L</getxattrs>, L</lgetxattr>, L<attr(5)>."
25149 msgstr ""
25150
25151 # type: =head2
25152 #. type: =head2
25153 #: ../fish/guestfish-actions.pod:1448
25154 msgid "getxattrs"
25155 msgstr ""
25156
25157 # type: verbatim
25158 #. type: verbatim
25159 #: ../fish/guestfish-actions.pod:1450
25160 #, no-wrap
25161 msgid ""
25162 " getxattrs path\n"
25163 "\n"
25164 msgstr ""
25165
25166 # type: textblock
25167 #. type: textblock
25168 #: ../fish/guestfish-actions.pod:1458
25169 msgid "See also: L</lgetxattrs>, L<attr(5)>."
25170 msgstr ""
25171
25172 # type: =head2
25173 #. type: =head2
25174 #: ../fish/guestfish-actions.pod:1460
25175 msgid "glob-expand"
25176 msgstr ""
25177
25178 # type: verbatim
25179 #. type: verbatim
25180 #: ../fish/guestfish-actions.pod:1462
25181 #, no-wrap
25182 msgid ""
25183 " glob-expand pattern\n"
25184 "\n"
25185 msgstr ""
25186
25187 # type: =head2
25188 #. type: =head2
25189 #: ../fish/guestfish-actions.pod:1475
25190 msgid "grep"
25191 msgstr ""
25192
25193 # type: verbatim
25194 #. type: verbatim
25195 #: ../fish/guestfish-actions.pod:1477
25196 #, no-wrap
25197 msgid ""
25198 " grep regex path\n"
25199 "\n"
25200 msgstr ""
25201
25202 # type: =head2
25203 #. type: =head2
25204 #: ../fish/guestfish-actions.pod:1485
25205 msgid "grepi"
25206 msgstr ""
25207
25208 # type: verbatim
25209 #. type: verbatim
25210 #: ../fish/guestfish-actions.pod:1487
25211 #, no-wrap
25212 msgid ""
25213 " grepi regex path\n"
25214 "\n"
25215 msgstr ""
25216
25217 # type: =head2
25218 #. type: =head2
25219 #: ../fish/guestfish-actions.pod:1495
25220 msgid "grub-install"
25221 msgstr ""
25222
25223 # type: verbatim
25224 #. type: verbatim
25225 #: ../fish/guestfish-actions.pod:1497
25226 #, no-wrap
25227 msgid ""
25228 " grub-install root device\n"
25229 "\n"
25230 msgstr ""
25231
25232 # type: =head2
25233 #. type: =head2
25234 #: ../fish/guestfish-actions.pod:1535
25235 msgid "head"
25236 msgstr ""
25237
25238 # type: verbatim
25239 #. type: verbatim
25240 #: ../fish/guestfish-actions.pod:1537
25241 #, no-wrap
25242 msgid ""
25243 " head path\n"
25244 "\n"
25245 msgstr ""
25246
25247 # type: =head2
25248 #. type: =head2
25249 #: ../fish/guestfish-actions.pod:1545
25250 msgid "head-n"
25251 msgstr ""
25252
25253 # type: verbatim
25254 #. type: verbatim
25255 #: ../fish/guestfish-actions.pod:1547
25256 #, no-wrap
25257 msgid ""
25258 " head-n nrlines path\n"
25259 "\n"
25260 msgstr ""
25261
25262 # type: =head2
25263 #. type: =head2
25264 #: ../fish/guestfish-actions.pod:1560
25265 msgid "hexdump"
25266 msgstr ""
25267
25268 # type: verbatim
25269 #. type: verbatim
25270 #: ../fish/guestfish-actions.pod:1562
25271 #, no-wrap
25272 msgid ""
25273 " hexdump path\n"
25274 "\n"
25275 msgstr ""
25276
25277 # type: =head2
25278 #. type: =head2
25279 #: ../fish/guestfish-actions.pod:1570
25280 msgid "initrd-cat"
25281 msgstr ""
25282
25283 # type: verbatim
25284 #. type: verbatim
25285 #: ../fish/guestfish-actions.pod:1572
25286 #, no-wrap
25287 msgid ""
25288 " initrd-cat initrdpath filename\n"
25289 "\n"
25290 msgstr ""
25291
25292 # type: textblock
25293 #. type: textblock
25294 #: ../fish/guestfish-actions.pod:1584
25295 msgid "See also L</initrd-list>."
25296 msgstr ""
25297
25298 # type: =head2
25299 #. type: =head2
25300 #: ../fish/guestfish-actions.pod:1589
25301 msgid "initrd-list"
25302 msgstr ""
25303
25304 # type: verbatim
25305 #. type: verbatim
25306 #: ../fish/guestfish-actions.pod:1591
25307 #, no-wrap
25308 msgid ""
25309 " initrd-list path\n"
25310 "\n"
25311 msgstr ""
25312
25313 # type: =head2
25314 #. type: =head2
25315 #: ../fish/guestfish-actions.pod:1603
25316 msgid "inotify-add-watch"
25317 msgstr ""
25318
25319 # type: verbatim
25320 #. type: verbatim
25321 #: ../fish/guestfish-actions.pod:1605
25322 #, no-wrap
25323 msgid ""
25324 " inotify-add-watch path mask\n"
25325 "\n"
25326 msgstr ""
25327
25328 # type: =head2
25329 #. type: =head2
25330 #: ../fish/guestfish-actions.pod:1617
25331 msgid "inotify-close"
25332 msgstr ""
25333
25334 # type: verbatim
25335 #. type: verbatim
25336 #: ../fish/guestfish-actions.pod:1619
25337 #, no-wrap
25338 msgid ""
25339 " inotify-close\n"
25340 "\n"
25341 msgstr ""
25342
25343 # type: =head2
25344 #. type: =head2
25345 #: ../fish/guestfish-actions.pod:1625
25346 msgid "inotify-files"
25347 msgstr ""
25348
25349 # type: verbatim
25350 #. type: verbatim
25351 #: ../fish/guestfish-actions.pod:1627
25352 #, no-wrap
25353 msgid ""
25354 " inotify-files\n"
25355 "\n"
25356 msgstr ""
25357
25358 # type: textblock
25359 #. type: textblock
25360 #: ../fish/guestfish-actions.pod:1629
25361 msgid ""
25362 "This function is a helpful wrapper around L</inotify-read> which just "
25363 "returns a list of pathnames of objects that were touched.  The returned "
25364 "pathnames are sorted and deduplicated."
25365 msgstr ""
25366
25367 # type: =head2
25368 #. type: =head2
25369 #: ../fish/guestfish-actions.pod:1633
25370 msgid "inotify-init"
25371 msgstr ""
25372
25373 # type: verbatim
25374 #. type: verbatim
25375 #: ../fish/guestfish-actions.pod:1635
25376 #, no-wrap
25377 msgid ""
25378 " inotify-init maxevents\n"
25379 "\n"
25380 msgstr ""
25381
25382 # type: textblock
25383 #. type: textblock
25384 #: ../fish/guestfish-actions.pod:1641
25385 msgid ""
25386 "C<maxevents> is the maximum number of events which will be queued up between "
25387 "calls to L</inotify-read> or L</inotify-files>.  If this is passed as C<0>, "
25388 "then the kernel (or previously set)  default is used.  For Linux 2.6.29 the "
25389 "default was 16384 events.  Beyond this limit, the kernel throws away events, "
25390 "but records the fact that it threw them away by setting a flag "
25391 "C<IN_Q_OVERFLOW> in the returned structure list (see L</inotify-read>)."
25392 msgstr ""
25393
25394 # type: textblock
25395 #. type: textblock
25396 #: ../fish/guestfish-actions.pod:1651
25397 msgid ""
25398 "Before any events are generated, you have to add some watches to the "
25399 "internal watch list.  See: L</inotify-add-watch>, L</inotify-rm-watch> and "
25400 "L</inotify-watch-all>."
25401 msgstr ""
25402
25403 # type: textblock
25404 #. type: textblock
25405 #: ../fish/guestfish-actions.pod:1657
25406 msgid ""
25407 "Queued up events should be read periodically by calling L</inotify-read> (or "
25408 "L</inotify-files> which is just a helpful wrapper around L</inotify-read>).  "
25409 "If you don't read the events out often enough then you risk the internal "
25410 "queue overflowing."
25411 msgstr ""
25412
25413 # type: textblock
25414 #. type: textblock
25415 #: ../fish/guestfish-actions.pod:1664
25416 msgid ""
25417 "The handle should be closed after use by calling L</inotify-close>.  This "
25418 "also removes any watches automatically."
25419 msgstr ""
25420
25421 # type: =head2
25422 #. type: =head2
25423 #: ../fish/guestfish-actions.pod:1673
25424 msgid "inotify-read"
25425 msgstr ""
25426
25427 # type: verbatim
25428 #. type: verbatim
25429 #: ../fish/guestfish-actions.pod:1675
25430 #, no-wrap
25431 msgid ""
25432 " inotify-read\n"
25433 "\n"
25434 msgstr ""
25435
25436 # type: =head2
25437 #. type: =head2
25438 #: ../fish/guestfish-actions.pod:1688
25439 msgid "inotify-rm-watch"
25440 msgstr ""
25441
25442 # type: verbatim
25443 #. type: verbatim
25444 #: ../fish/guestfish-actions.pod:1690
25445 #, no-wrap
25446 msgid ""
25447 " inotify-rm-watch wd\n"
25448 "\n"
25449 msgstr ""
25450
25451 # type: textblock
25452 #. type: textblock
25453 #: ../fish/guestfish-actions.pod:1692
25454 msgid "Remove a previously defined inotify watch.  See L</inotify-add-watch>."
25455 msgstr ""
25456
25457 # type: =head2
25458 #. type: =head2
25459 #: ../fish/guestfish-actions.pod:1695
25460 msgid "inspect-get-arch"
25461 msgstr ""
25462
25463 # type: verbatim
25464 #. type: verbatim
25465 #: ../fish/guestfish-actions.pod:1697
25466 #, no-wrap
25467 msgid ""
25468 " inspect-get-arch root\n"
25469 "\n"
25470 msgstr ""
25471
25472 # type: textblock
25473 #. type: textblock
25474 #: ../fish/guestfish-actions.pod:1699 ../fish/guestfish-actions.pod:1715
25475 #: ../fish/guestfish-actions.pod:1789 ../fish/guestfish-actions.pod:1807
25476 #: ../fish/guestfish-actions.pod:1822 ../fish/guestfish-actions.pod:1843
25477 #: ../fish/guestfish-actions.pod:1858 ../fish/guestfish-actions.pod:1885
25478 #: ../fish/guestfish-actions.pod:1907 ../fish/guestfish-actions.pod:1931
25479 #: ../fish/guestfish-actions.pod:1961 ../fish/guestfish-actions.pod:1996
25480 #: ../fish/guestfish-actions.pod:2012
25481 msgid ""
25482 "This function should only be called with a root device string as returned by "
25483 "L</inspect-os>."
25484 msgstr ""
25485
25486 # type: textblock
25487 #. type: textblock
25488 #: ../fish/guestfish-actions.pod:1702
25489 msgid ""
25490 "This returns the architecture of the inspected operating system.  The "
25491 "possible return values are listed under L</file-architecture>."
25492 msgstr ""
25493
25494 # type: =head2
25495 #. type: =head2
25496 #: ../fish/guestfish-actions.pod:1711
25497 msgid "inspect-get-distro"
25498 msgstr ""
25499
25500 # type: verbatim
25501 #. type: verbatim
25502 #: ../fish/guestfish-actions.pod:1713
25503 #, no-wrap
25504 msgid ""
25505 " inspect-get-distro root\n"
25506 "\n"
25507 msgstr ""
25508
25509 # type: =head2
25510 #. type: =head2
25511 #: ../fish/guestfish-actions.pod:1785
25512 msgid "inspect-get-filesystems"
25513 msgstr ""
25514
25515 # type: verbatim
25516 #. type: verbatim
25517 #: ../fish/guestfish-actions.pod:1787
25518 #, no-wrap
25519 msgid ""
25520 " inspect-get-filesystems root\n"
25521 "\n"
25522 msgstr ""
25523
25524 # type: textblock
25525 #. type: textblock
25526 #: ../fish/guestfish-actions.pod:1800
25527 msgid ""
25528 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
25529 "get-mountpoints>."
25530 msgstr ""
25531
25532 # type: =head2
25533 #. type: =head2
25534 #: ../fish/guestfish-actions.pod:1803
25535 msgid "inspect-get-hostname"
25536 msgstr ""
25537
25538 # type: verbatim
25539 #. type: verbatim
25540 #: ../fish/guestfish-actions.pod:1805
25541 #, no-wrap
25542 msgid ""
25543 " inspect-get-hostname root\n"
25544 "\n"
25545 msgstr ""
25546
25547 # type: =head2
25548 #. type: =head2
25549 #: ../fish/guestfish-actions.pod:1818
25550 msgid "inspect-get-major-version"
25551 msgstr ""
25552
25553 # type: verbatim
25554 #. type: verbatim
25555 #: ../fish/guestfish-actions.pod:1820
25556 #, no-wrap
25557 msgid ""
25558 " inspect-get-major-version root\n"
25559 "\n"
25560 msgstr ""
25561
25562 # type: =head2
25563 #. type: =head2
25564 #: ../fish/guestfish-actions.pod:1839
25565 msgid "inspect-get-minor-version"
25566 msgstr ""
25567
25568 # type: verbatim
25569 #. type: verbatim
25570 #: ../fish/guestfish-actions.pod:1841
25571 #, no-wrap
25572 msgid ""
25573 " inspect-get-minor-version root\n"
25574 "\n"
25575 msgstr ""
25576
25577 # type: textblock
25578 #. type: textblock
25579 #: ../fish/guestfish-actions.pod:1851
25580 msgid ""
25581 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
25582 "get-major-version>."
25583 msgstr ""
25584
25585 # type: =head2
25586 #. type: =head2
25587 #: ../fish/guestfish-actions.pod:1854
25588 msgid "inspect-get-mountpoints"
25589 msgstr ""
25590
25591 # type: verbatim
25592 #. type: verbatim
25593 #: ../fish/guestfish-actions.pod:1856
25594 #, no-wrap
25595 msgid ""
25596 " inspect-get-mountpoints root\n"
25597 "\n"
25598 msgstr ""
25599
25600 # type: textblock
25601 #. type: textblock
25602 #: ../fish/guestfish-actions.pod:1878
25603 msgid ""
25604 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
25605 "get-filesystems>."
25606 msgstr ""
25607
25608 # type: =head2
25609 #. type: =head2
25610 #: ../fish/guestfish-actions.pod:1881
25611 msgid "inspect-get-package-format"
25612 msgstr ""
25613
25614 # type: verbatim
25615 #. type: verbatim
25616 #: ../fish/guestfish-actions.pod:1883
25617 #, no-wrap
25618 msgid ""
25619 " inspect-get-package-format root\n"
25620 "\n"
25621 msgstr ""
25622
25623 # type: textblock
25624 #. type: textblock
25625 #: ../fish/guestfish-actions.pod:1888
25626 msgid ""
25627 "This function and L</inspect-get-package-management> return the package "
25628 "format and package management tool used by the inspected operating system.  "
25629 "For example for Fedora these functions would return C<rpm> (package format) "
25630 "and C<yum> (package management)."
25631 msgstr ""
25632
25633 # type: =head2
25634 #. type: =head2
25635 #: ../fish/guestfish-actions.pod:1903
25636 msgid "inspect-get-package-management"
25637 msgstr ""
25638
25639 # type: verbatim
25640 #. type: verbatim
25641 #: ../fish/guestfish-actions.pod:1905
25642 #, no-wrap
25643 msgid ""
25644 " inspect-get-package-management root\n"
25645 "\n"
25646 msgstr ""
25647
25648 # type: textblock
25649 #. type: textblock
25650 #: ../fish/guestfish-actions.pod:1910
25651 msgid ""
25652 "L</inspect-get-package-format> and this function return the package format "
25653 "and package management tool used by the inspected operating system.  For "
25654 "example for Fedora these functions would return C<rpm> (package format) and "
25655 "C<yum> (package management)."
25656 msgstr ""
25657
25658 # type: =head2
25659 #. type: =head2
25660 #: ../fish/guestfish-actions.pod:1927
25661 msgid "inspect-get-product-name"
25662 msgstr ""
25663
25664 # type: verbatim
25665 #. type: verbatim
25666 #: ../fish/guestfish-actions.pod:1929
25667 #, no-wrap
25668 msgid ""
25669 " inspect-get-product-name root\n"
25670 "\n"
25671 msgstr ""
25672
25673 # type: =head2
25674 #. type: =head2
25675 #: ../fish/guestfish-actions.pod:1944
25676 msgid "inspect-get-roots"
25677 msgstr ""
25678
25679 # type: verbatim
25680 #. type: verbatim
25681 #: ../fish/guestfish-actions.pod:1946
25682 #, no-wrap
25683 msgid ""
25684 " inspect-get-roots\n"
25685 "\n"
25686 msgstr ""
25687
25688 # type: textblock
25689 #. type: textblock
25690 #: ../fish/guestfish-actions.pod:1948
25691 msgid ""
25692 "This function is a convenient way to get the list of root devices, as "
25693 "returned from a previous call to L</inspect-os>, but without redoing the "
25694 "whole inspection process."
25695 msgstr ""
25696
25697 # type: textblock
25698 #. type: textblock
25699 #: ../fish/guestfish-actions.pod:1952
25700 msgid ""
25701 "This returns an empty list if either no root devices were found or the "
25702 "caller has not called L</inspect-os>."
25703 msgstr ""
25704
25705 # type: =head2
25706 #. type: =head2
25707 #: ../fish/guestfish-actions.pod:1957
25708 msgid "inspect-get-type"
25709 msgstr ""
25710
25711 # type: verbatim
25712 #. type: verbatim
25713 #: ../fish/guestfish-actions.pod:1959
25714 #, no-wrap
25715 msgid ""
25716 " inspect-get-type root\n"
25717 "\n"
25718 msgstr ""
25719
25720 # type: =head2
25721 #. type: =head2
25722 #: ../fish/guestfish-actions.pod:1992
25723 msgid "inspect-get-windows-systemroot"
25724 msgstr ""
25725
25726 # type: verbatim
25727 #. type: verbatim
25728 #: ../fish/guestfish-actions.pod:1994
25729 #, no-wrap
25730 msgid ""
25731 " inspect-get-windows-systemroot root\n"
25732 "\n"
25733 msgstr ""
25734
25735 # type: =head2
25736 #. type: =head2
25737 #: ../fish/guestfish-actions.pod:2008
25738 msgid "inspect-list-applications"
25739 msgstr ""
25740
25741 # type: verbatim
25742 #. type: verbatim
25743 #: ../fish/guestfish-actions.pod:2010
25744 #, no-wrap
25745 msgid ""
25746 " inspect-list-applications root\n"
25747 "\n"
25748 msgstr ""
25749
25750 # type: textblock
25751 #. type: textblock
25752 #: ../fish/guestfish-actions.pod:2017
25753 msgid ""
25754 "I<Note:> This call works differently from other parts of the inspection "
25755 "API.  You have to call L</inspect-os>, then L</inspect-get-mountpoints>, "
25756 "then mount up the disks, before calling this.  Listing applications is a "
25757 "significantly more difficult operation which requires access to the full "
25758 "filesystem.  Also note that unlike the other L</inspect-get-*> calls which "
25759 "are just returning data cached in the libguestfs handle, this call actually "
25760 "reads parts of the mounted filesystems during the call."
25761 msgstr ""
25762
25763 # type: =head2
25764 #. type: =head2
25765 #: ../fish/guestfish-actions.pod:2107
25766 msgid "inspect-os"
25767 msgstr ""
25768
25769 # type: verbatim
25770 #. type: verbatim
25771 #: ../fish/guestfish-actions.pod:2109
25772 #, no-wrap
25773 msgid ""
25774 " inspect-os\n"
25775 "\n"
25776 msgstr ""
25777
25778 # type: textblock
25779 #. type: textblock
25780 #: ../fish/guestfish-actions.pod:2124
25781 msgid ""
25782 "You can pass the root string(s) returned to other L</inspect-get-*> "
25783 "functions in order to query further information about each operating system, "
25784 "such as the name and version."
25785 msgstr ""
25786
25787 # type: textblock
25788 #. type: textblock
25789 #: ../fish/guestfish-actions.pod:2129
25790 msgid ""
25791 "This function uses other libguestfs features such as L</mount-ro> and L</"
25792 "umount-all> in order to mount and unmount filesystems and look at the "
25793 "contents.  This should be called with no disks currently mounted.  The "
25794 "function may also use Augeas, so any existing Augeas handle will be closed."
25795 msgstr ""
25796
25797 # type: textblock
25798 #. type: textblock
25799 #: ../fish/guestfish-actions.pod:2141 ../fish/guestfish-actions.pod:2317
25800 #: ../fish/guestfish-actions.pod:2363
25801 msgid "See also L</list-filesystems>."
25802 msgstr ""
25803
25804 # type: =head2
25805 #. type: =head2
25806 #: ../fish/guestfish-actions.pod:2143
25807 msgid "is-blockdev"
25808 msgstr ""
25809
25810 # type: verbatim
25811 #. type: verbatim
25812 #: ../fish/guestfish-actions.pod:2145
25813 #, no-wrap
25814 msgid ""
25815 " is-blockdev path\n"
25816 "\n"
25817 msgstr ""
25818
25819 # type: textblock
25820 #. type: textblock
25821 #: ../fish/guestfish-actions.pod:2150 ../fish/guestfish-actions.pod:2168
25822 #: ../fish/guestfish-actions.pod:2187 ../fish/guestfish-actions.pod:2196
25823 #: ../fish/guestfish-actions.pod:2206 ../fish/guestfish-actions.pod:2240
25824 #: ../fish/guestfish-actions.pod:2249
25825 msgid "See also L</stat>."
25826 msgstr ""
25827
25828 # type: =head2
25829 #. type: =head2
25830 #: ../fish/guestfish-actions.pod:2152
25831 msgid "is-busy"
25832 msgstr ""
25833
25834 # type: verbatim
25835 #. type: verbatim
25836 #: ../fish/guestfish-actions.pod:2154
25837 #, no-wrap
25838 msgid ""
25839 " is-busy\n"
25840 "\n"
25841 msgstr ""
25842
25843 # type: =head2
25844 #. type: =head2
25845 #: ../fish/guestfish-actions.pod:2161
25846 msgid "is-chardev"
25847 msgstr ""
25848
25849 # type: verbatim
25850 #. type: verbatim
25851 #: ../fish/guestfish-actions.pod:2163
25852 #, no-wrap
25853 msgid ""
25854 " is-chardev path\n"
25855 "\n"
25856 msgstr ""
25857
25858 # type: =head2
25859 #. type: =head2
25860 #: ../fish/guestfish-actions.pod:2170
25861 msgid "is-config"
25862 msgstr ""
25863
25864 # type: verbatim
25865 #. type: verbatim
25866 #: ../fish/guestfish-actions.pod:2172
25867 #, no-wrap
25868 msgid ""
25869 " is-config\n"
25870 "\n"
25871 msgstr ""
25872
25873 # type: =head2
25874 #. type: =head2
25875 #: ../fish/guestfish-actions.pod:2179
25876 msgid "is-dir"
25877 msgstr ""
25878
25879 # type: verbatim
25880 #. type: verbatim
25881 #: ../fish/guestfish-actions.pod:2181
25882 #, no-wrap
25883 msgid ""
25884 " is-dir path\n"
25885 "\n"
25886 msgstr ""
25887
25888 # type: =head2
25889 #. type: =head2
25890 #: ../fish/guestfish-actions.pod:2189
25891 msgid "is-fifo"
25892 msgstr ""
25893
25894 # type: verbatim
25895 #. type: verbatim
25896 #: ../fish/guestfish-actions.pod:2191
25897 #, no-wrap
25898 msgid ""
25899 " is-fifo path\n"
25900 "\n"
25901 msgstr ""
25902
25903 # type: =head2
25904 #. type: =head2
25905 #: ../fish/guestfish-actions.pod:2198
25906 msgid "is-file"
25907 msgstr ""
25908
25909 # type: verbatim
25910 #. type: verbatim
25911 #: ../fish/guestfish-actions.pod:2200
25912 #, no-wrap
25913 msgid ""
25914 " is-file path\n"
25915 "\n"
25916 msgstr ""
25917
25918 # type: =head2
25919 #. type: =head2
25920 #: ../fish/guestfish-actions.pod:2208
25921 msgid "is-launching"
25922 msgstr ""
25923
25924 # type: verbatim
25925 #. type: verbatim
25926 #: ../fish/guestfish-actions.pod:2210
25927 #, no-wrap
25928 msgid ""
25929 " is-launching\n"
25930 "\n"
25931 msgstr ""
25932
25933 # type: =head2
25934 #. type: =head2
25935 #: ../fish/guestfish-actions.pod:2217
25936 msgid "is-lv"
25937 msgstr ""
25938
25939 # type: verbatim
25940 #. type: verbatim
25941 #: ../fish/guestfish-actions.pod:2219
25942 #, no-wrap
25943 msgid ""
25944 " is-lv device\n"
25945 "\n"
25946 msgstr ""
25947
25948 # type: =head2
25949 #. type: =head2
25950 #: ../fish/guestfish-actions.pod:2224
25951 msgid "is-ready"
25952 msgstr ""
25953
25954 # type: verbatim
25955 #. type: verbatim
25956 #: ../fish/guestfish-actions.pod:2226
25957 #, no-wrap
25958 msgid ""
25959 " is-ready\n"
25960 "\n"
25961 msgstr ""
25962
25963 # type: =head2
25964 #. type: =head2
25965 #: ../fish/guestfish-actions.pod:2233
25966 msgid "is-socket"
25967 msgstr ""
25968
25969 # type: verbatim
25970 #. type: verbatim
25971 #: ../fish/guestfish-actions.pod:2235
25972 #, no-wrap
25973 msgid ""
25974 " is-socket path\n"
25975 "\n"
25976 msgstr ""
25977
25978 # type: =head2
25979 #. type: =head2
25980 #: ../fish/guestfish-actions.pod:2242
25981 msgid "is-symlink"
25982 msgstr ""
25983
25984 # type: verbatim
25985 #. type: verbatim
25986 #: ../fish/guestfish-actions.pod:2244
25987 #, no-wrap
25988 msgid ""
25989 " is-symlink path\n"
25990 "\n"
25991 msgstr ""
25992
25993 # type: =head2
25994 #. type: =head2
25995 #: ../fish/guestfish-actions.pod:2251
25996 msgid "kill-subprocess"
25997 msgstr ""
25998
25999 # type: verbatim
26000 #. type: verbatim
26001 #: ../fish/guestfish-actions.pod:2253
26002 #, no-wrap
26003 msgid ""
26004 " kill-subprocess\n"
26005 "\n"
26006 msgstr ""
26007
26008 # type: =head2
26009 #. type: =head2
26010 #: ../fish/guestfish-actions.pod:2257
26011 msgid "launch"
26012 msgstr ""
26013
26014 # type: =head2
26015 #. type: =head2
26016 #: ../fish/guestfish-actions.pod:2259
26017 msgid "run"
26018 msgstr ""
26019
26020 # type: verbatim
26021 #. type: verbatim
26022 #: ../fish/guestfish-actions.pod:2261
26023 #, no-wrap
26024 msgid ""
26025 " launch\n"
26026 "\n"
26027 msgstr ""
26028
26029 # type: =head2
26030 #. type: =head2
26031 #: ../fish/guestfish-actions.pod:2269
26032 msgid "lchown"
26033 msgstr ""
26034
26035 # type: verbatim
26036 #. type: verbatim
26037 #: ../fish/guestfish-actions.pod:2271
26038 #, no-wrap
26039 msgid ""
26040 " lchown owner group path\n"
26041 "\n"
26042 msgstr ""
26043
26044 # type: textblock
26045 #. type: textblock
26046 #: ../fish/guestfish-actions.pod:2273
26047 msgid ""
26048 "Change the file owner to C<owner> and group to C<group>.  This is like L</"
26049 "chown> but if C<path> is a symlink then the link itself is changed, not the "
26050 "target."
26051 msgstr ""
26052
26053 # type: =head2
26054 #. type: =head2
26055 #: ../fish/guestfish-actions.pod:2281
26056 msgid "lgetxattr"
26057 msgstr ""
26058
26059 # type: verbatim
26060 #. type: verbatim
26061 #: ../fish/guestfish-actions.pod:2283
26062 #, no-wrap
26063 msgid ""
26064 " lgetxattr path name\n"
26065 "\n"
26066 msgstr ""
26067
26068 # type: textblock
26069 #. type: textblock
26070 #: ../fish/guestfish-actions.pod:2299
26071 msgid "See also: L</lgetxattrs>, L</getxattr>, L<attr(5)>."
26072 msgstr ""
26073
26074 # type: =head2
26075 #. type: =head2
26076 #: ../fish/guestfish-actions.pod:2301
26077 msgid "lgetxattrs"
26078 msgstr ""
26079
26080 # type: verbatim
26081 #. type: verbatim
26082 #: ../fish/guestfish-actions.pod:2303
26083 #, no-wrap
26084 msgid ""
26085 " lgetxattrs path\n"
26086 "\n"
26087 msgstr ""
26088
26089 # type: textblock
26090 #. type: textblock
26091 #: ../fish/guestfish-actions.pod:2305
26092 msgid ""
26093 "This is the same as L</getxattrs>, but if C<path> is a symbolic link, then "
26094 "it returns the extended attributes of the link itself."
26095 msgstr ""
26096
26097 # type: =head2
26098 #. type: =head2
26099 #: ../fish/guestfish-actions.pod:2309
26100 msgid "list-devices"
26101 msgstr ""
26102
26103 # type: verbatim
26104 #. type: verbatim
26105 #: ../fish/guestfish-actions.pod:2311
26106 #, no-wrap
26107 msgid ""
26108 " list-devices\n"
26109 "\n"
26110 msgstr ""
26111
26112 # type: =head2
26113 #. type: =head2
26114 #: ../fish/guestfish-actions.pod:2319
26115 msgid "list-filesystems"
26116 msgstr ""
26117
26118 # type: verbatim
26119 #. type: verbatim
26120 #: ../fish/guestfish-actions.pod:2321
26121 #, no-wrap
26122 msgid ""
26123 " list-filesystems\n"
26124 "\n"
26125 msgstr ""
26126
26127 # type: textblock
26128 #. type: textblock
26129 #: ../fish/guestfish-actions.pod:2340
26130 msgid ""
26131 "This command runs other libguestfs commands, which might include L</mount> "
26132 "and L</umount>, and therefore you should use this soon after launch and only "
26133 "when nothing is mounted."
26134 msgstr ""
26135
26136 # type: textblock
26137 #. type: textblock
26138 #: ../fish/guestfish-actions.pod:2344
26139 msgid ""
26140 "Not all of the filesystems returned will be mountable.  In particular, swap "
26141 "partitions are returned in the list.  Also this command does not check that "
26142 "each filesystem found is valid and mountable, and some filesystems might be "
26143 "mountable but require special options.  Filesystems may not all belong to a "
26144 "single logical operating system (use L</inspect-os> to look for OSes)."
26145 msgstr ""
26146
26147 # type: =head2
26148 #. type: =head2
26149 #: ../fish/guestfish-actions.pod:2352
26150 msgid "list-partitions"
26151 msgstr ""
26152
26153 # type: verbatim
26154 #. type: verbatim
26155 #: ../fish/guestfish-actions.pod:2354
26156 #, no-wrap
26157 msgid ""
26158 " list-partitions\n"
26159 "\n"
26160 msgstr ""
26161
26162 # type: textblock
26163 #. type: textblock
26164 #: ../fish/guestfish-actions.pod:2360
26165 msgid ""
26166 "This does not return logical volumes.  For that you will need to call L</"
26167 "lvs>."
26168 msgstr ""
26169
26170 # type: =head2
26171 #. type: =head2
26172 #: ../fish/guestfish-actions.pod:2365
26173 msgid "ll"
26174 msgstr ""
26175
26176 # type: verbatim
26177 #. type: verbatim
26178 #: ../fish/guestfish-actions.pod:2367
26179 #, no-wrap
26180 msgid ""
26181 " ll directory\n"
26182 "\n"
26183 msgstr ""
26184
26185 # type: =head2
26186 #. type: =head2
26187 #: ../fish/guestfish-actions.pod:2375
26188 msgid "ln"
26189 msgstr ""
26190
26191 # type: verbatim
26192 #. type: verbatim
26193 #: ../fish/guestfish-actions.pod:2377
26194 #, no-wrap
26195 msgid ""
26196 " ln target linkname\n"
26197 "\n"
26198 msgstr ""
26199
26200 # type: =head2
26201 #. type: =head2
26202 #: ../fish/guestfish-actions.pod:2381
26203 msgid "ln-f"
26204 msgstr ""
26205
26206 # type: verbatim
26207 #. type: verbatim
26208 #: ../fish/guestfish-actions.pod:2383
26209 #, no-wrap
26210 msgid ""
26211 " ln-f target linkname\n"
26212 "\n"
26213 msgstr ""
26214
26215 # type: =head2
26216 #. type: =head2
26217 #: ../fish/guestfish-actions.pod:2388
26218 msgid "ln-s"
26219 msgstr ""
26220
26221 # type: verbatim
26222 #. type: verbatim
26223 #: ../fish/guestfish-actions.pod:2390
26224 #, no-wrap
26225 msgid ""
26226 " ln-s target linkname\n"
26227 "\n"
26228 msgstr ""
26229
26230 # type: =head2
26231 #. type: =head2
26232 #: ../fish/guestfish-actions.pod:2394
26233 msgid "ln-sf"
26234 msgstr ""
26235
26236 # type: verbatim
26237 #. type: verbatim
26238 #: ../fish/guestfish-actions.pod:2396
26239 #, no-wrap
26240 msgid ""
26241 " ln-sf target linkname\n"
26242 "\n"
26243 msgstr ""
26244
26245 # type: =head2
26246 #. type: =head2
26247 #: ../fish/guestfish-actions.pod:2401
26248 msgid "lremovexattr"
26249 msgstr ""
26250
26251 # type: verbatim
26252 #. type: verbatim
26253 #: ../fish/guestfish-actions.pod:2403
26254 #, no-wrap
26255 msgid ""
26256 " lremovexattr xattr path\n"
26257 "\n"
26258 msgstr ""
26259
26260 # type: textblock
26261 #. type: textblock
26262 #: ../fish/guestfish-actions.pod:2405
26263 msgid ""
26264 "This is the same as L</removexattr>, but if C<path> is a symbolic link, then "
26265 "it removes an extended attribute of the link itself."
26266 msgstr ""
26267
26268 # type: =head2
26269 #. type: =head2
26270 #: ../fish/guestfish-actions.pod:2409
26271 msgid "ls"
26272 msgstr ""
26273
26274 # type: verbatim
26275 #. type: verbatim
26276 #: ../fish/guestfish-actions.pod:2411
26277 #, no-wrap
26278 msgid ""
26279 " ls directory\n"
26280 "\n"
26281 msgstr ""
26282
26283 # type: textblock
26284 #. type: textblock
26285 #: ../fish/guestfish-actions.pod:2417
26286 msgid ""
26287 "This command is mostly useful for interactive sessions.  Programs should "
26288 "probably use L</readdir> instead."
26289 msgstr ""
26290
26291 # type: =head2
26292 #. type: =head2
26293 #: ../fish/guestfish-actions.pod:2420
26294 msgid "lsetxattr"
26295 msgstr ""
26296
26297 # type: verbatim
26298 #. type: verbatim
26299 #: ../fish/guestfish-actions.pod:2422
26300 #, no-wrap
26301 msgid ""
26302 " lsetxattr xattr val vallen path\n"
26303 "\n"
26304 msgstr ""
26305
26306 # type: textblock
26307 #. type: textblock
26308 #: ../fish/guestfish-actions.pod:2424
26309 msgid ""
26310 "This is the same as L</setxattr>, but if C<path> is a symbolic link, then it "
26311 "sets an extended attribute of the link itself."
26312 msgstr ""
26313
26314 # type: =head2
26315 #. type: =head2
26316 #: ../fish/guestfish-actions.pod:2428
26317 msgid "lstat"
26318 msgstr ""
26319
26320 # type: verbatim
26321 #. type: verbatim
26322 #: ../fish/guestfish-actions.pod:2430
26323 #, no-wrap
26324 msgid ""
26325 " lstat path\n"
26326 "\n"
26327 msgstr ""
26328
26329 # type: textblock
26330 #. type: textblock
26331 #: ../fish/guestfish-actions.pod:2434
26332 msgid ""
26333 "This is the same as L</stat> except that if C<path> is a symbolic link, then "
26334 "the link is stat-ed, not the file it refers to."
26335 msgstr ""
26336
26337 # type: =head2
26338 #. type: =head2
26339 #: ../fish/guestfish-actions.pod:2440
26340 msgid "lstatlist"
26341 msgstr ""
26342
26343 # type: verbatim
26344 #. type: verbatim
26345 #: ../fish/guestfish-actions.pod:2442
26346 #, no-wrap
26347 msgid ""
26348 " lstatlist path 'names ...'\n"
26349 "\n"
26350 msgstr ""
26351
26352 # type: textblock
26353 #. type: textblock
26354 #: ../fish/guestfish-actions.pod:2444
26355 msgid ""
26356 "This call allows you to perform the L</lstat> operation on multiple files, "
26357 "where all files are in the directory C<path>.  C<names> is the list of files "
26358 "from this directory."
26359 msgstr ""
26360
26361 # type: textblock
26362 #. type: textblock
26363 #: ../fish/guestfish-actions.pod:2453
26364 msgid ""
26365 "This call is intended for programs that want to efficiently list a directory "
26366 "contents without making many round-trips.  See also L</lxattrlist> for a "
26367 "similarly efficient call for getting extended attributes.  Very long "
26368 "directory listings might cause the protocol message size to be exceeded, "
26369 "causing this call to fail.  The caller must split up such requests into "
26370 "smaller groups of names."
26371 msgstr ""
26372
26373 # type: =head2
26374 #. type: =head2
26375 #: ../fish/guestfish-actions.pod:2461
26376 msgid "luks-add-key"
26377 msgstr ""
26378
26379 # type: verbatim
26380 #. type: verbatim
26381 #: ../fish/guestfish-actions.pod:2463
26382 #, no-wrap
26383 msgid ""
26384 " luks-add-key device keyslot\n"
26385 "\n"
26386 msgstr ""
26387
26388 # type: textblock
26389 #. type: textblock
26390 #: ../fish/guestfish-actions.pod:2470
26391 msgid ""
26392 "Note that if C<keyslot> already contains a key, then this command will "
26393 "fail.  You have to use L</luks-kill-slot> first to remove that key."
26394 msgstr ""
26395
26396 # type: textblock
26397 #. type: textblock
26398 #: ../fish/guestfish-actions.pod:2474 ../fish/guestfish-actions.pod:2496
26399 #: ../fish/guestfish-actions.pod:2509 ../fish/guestfish-actions.pod:2523
26400 #: ../fish/guestfish-actions.pod:2546 ../fish/guestfish-actions.pod:2556
26401 msgid ""
26402 "This command has one or more key or passphrase parameters.  Guestfish will "
26403 "prompt for these separately."
26404 msgstr ""
26405
26406 # type: =head2
26407 #. type: =head2
26408 #: ../fish/guestfish-actions.pod:2477
26409 msgid "luks-close"
26410 msgstr ""
26411
26412 # type: verbatim
26413 #. type: verbatim
26414 #: ../fish/guestfish-actions.pod:2479
26415 #, no-wrap
26416 msgid ""
26417 " luks-close device\n"
26418 "\n"
26419 msgstr ""
26420
26421 # type: textblock
26422 #. type: textblock
26423 #: ../fish/guestfish-actions.pod:2481
26424 msgid ""
26425 "This closes a LUKS device that was created earlier by L</luks-open> or L</"
26426 "luks-open-ro>.  The C<device> parameter must be the name of the LUKS mapping "
26427 "device (ie. C</dev/mapper/mapname>) and I<not> the name of the underlying "
26428 "block device."
26429 msgstr ""
26430
26431 # type: =head2
26432 #. type: =head2
26433 #: ../fish/guestfish-actions.pod:2487
26434 msgid "luks-format"
26435 msgstr ""
26436
26437 # type: verbatim
26438 #. type: verbatim
26439 #: ../fish/guestfish-actions.pod:2489
26440 #, no-wrap
26441 msgid ""
26442 " luks-format device keyslot\n"
26443 "\n"
26444 msgstr ""
26445
26446 # type: =head2
26447 #. type: =head2
26448 #: ../fish/guestfish-actions.pod:2502
26449 msgid "luks-format-cipher"
26450 msgstr ""
26451
26452 # type: verbatim
26453 #. type: verbatim
26454 #: ../fish/guestfish-actions.pod:2504
26455 #, no-wrap
26456 msgid ""
26457 " luks-format-cipher device keyslot cipher\n"
26458 "\n"
26459 msgstr ""
26460
26461 # type: textblock
26462 #. type: textblock
26463 #: ../fish/guestfish-actions.pod:2506
26464 msgid ""
26465 "This command is the same as L</luks-format> but it also allows you to set "
26466 "the C<cipher> used."
26467 msgstr ""
26468
26469 # type: =head2
26470 #. type: =head2
26471 #: ../fish/guestfish-actions.pod:2515
26472 msgid "luks-kill-slot"
26473 msgstr ""
26474
26475 # type: verbatim
26476 #. type: verbatim
26477 #: ../fish/guestfish-actions.pod:2517
26478 #, no-wrap
26479 msgid ""
26480 " luks-kill-slot device keyslot\n"
26481 "\n"
26482 msgstr ""
26483
26484 # type: =head2
26485 #. type: =head2
26486 #: ../fish/guestfish-actions.pod:2526
26487 msgid "luks-open"
26488 msgstr ""
26489
26490 # type: verbatim
26491 #. type: verbatim
26492 #: ../fish/guestfish-actions.pod:2528
26493 #, no-wrap
26494 msgid ""
26495 " luks-open device mapname\n"
26496 "\n"
26497 msgstr ""
26498
26499 # type: textblock
26500 #. type: textblock
26501 #: ../fish/guestfish-actions.pod:2542
26502 msgid ""
26503 "If this block device contains LVM volume groups, then calling L</vgscan> "
26504 "followed by L</vg-activate-all> will make them visible."
26505 msgstr ""
26506
26507 # type: =head2
26508 #. type: =head2
26509 #: ../fish/guestfish-actions.pod:2549
26510 msgid "luks-open-ro"
26511 msgstr ""
26512
26513 # type: verbatim
26514 #. type: verbatim
26515 #: ../fish/guestfish-actions.pod:2551
26516 #, no-wrap
26517 msgid ""
26518 " luks-open-ro device mapname\n"
26519 "\n"
26520 msgstr ""
26521
26522 # type: textblock
26523 #. type: textblock
26524 #: ../fish/guestfish-actions.pod:2553
26525 msgid ""
26526 "This is the same as L</luks-open> except that a read-only mapping is created."
26527 msgstr ""
26528
26529 # type: =head2
26530 #. type: =head2
26531 #: ../fish/guestfish-actions.pod:2559
26532 msgid "lvcreate"
26533 msgstr ""
26534
26535 # type: verbatim
26536 #. type: verbatim
26537 #: ../fish/guestfish-actions.pod:2561
26538 #, no-wrap
26539 msgid ""
26540 " lvcreate logvol volgroup mbytes\n"
26541 "\n"
26542 msgstr ""
26543
26544 # type: =head2
26545 #. type: =head2
26546 #: ../fish/guestfish-actions.pod:2566
26547 msgid "lvm-canonical-lv-name"
26548 msgstr ""
26549
26550 # type: verbatim
26551 #. type: verbatim
26552 #: ../fish/guestfish-actions.pod:2568
26553 #, no-wrap
26554 msgid ""
26555 " lvm-canonical-lv-name lvname\n"
26556 "\n"
26557 msgstr ""
26558
26559 # type: textblock
26560 #. type: textblock
26561 #: ../fish/guestfish-actions.pod:2577
26562 msgid "See also L</is-lv>."
26563 msgstr ""
26564
26565 # type: =head2
26566 #. type: =head2
26567 #: ../fish/guestfish-actions.pod:2579
26568 msgid "lvm-clear-filter"
26569 msgstr ""
26570
26571 # type: verbatim
26572 #. type: verbatim
26573 #: ../fish/guestfish-actions.pod:2581
26574 #, no-wrap
26575 msgid ""
26576 " lvm-clear-filter\n"
26577 "\n"
26578 msgstr ""
26579
26580 # type: textblock
26581 #. type: textblock
26582 #: ../fish/guestfish-actions.pod:2583
26583 msgid ""
26584 "This undoes the effect of L</lvm-set-filter>.  LVM will be able to see every "
26585 "block device."
26586 msgstr ""
26587
26588 # type: =head2
26589 #. type: =head2
26590 #: ../fish/guestfish-actions.pod:2589
26591 msgid "lvm-remove-all"
26592 msgstr ""
26593
26594 # type: verbatim
26595 #. type: verbatim
26596 #: ../fish/guestfish-actions.pod:2591
26597 #, no-wrap
26598 msgid ""
26599 " lvm-remove-all\n"
26600 "\n"
26601 msgstr ""
26602
26603 # type: =head2
26604 #. type: =head2
26605 #: ../fish/guestfish-actions.pod:2599
26606 msgid "lvm-set-filter"
26607 msgstr ""
26608
26609 # type: verbatim
26610 #. type: verbatim
26611 #: ../fish/guestfish-actions.pod:2601
26612 #, no-wrap
26613 msgid ""
26614 " lvm-set-filter 'devices ...'\n"
26615 "\n"
26616 msgstr ""
26617
26618 # type: =head2
26619 #. type: =head2
26620 #: ../fish/guestfish-actions.pod:2626
26621 msgid "lvremove"
26622 msgstr ""
26623
26624 # type: verbatim
26625 #. type: verbatim
26626 #: ../fish/guestfish-actions.pod:2628
26627 #, no-wrap
26628 msgid ""
26629 " lvremove device\n"
26630 "\n"
26631 msgstr ""
26632
26633 # type: =head2
26634 #. type: =head2
26635 #: ../fish/guestfish-actions.pod:2636
26636 msgid "lvrename"
26637 msgstr ""
26638
26639 # type: verbatim
26640 #. type: verbatim
26641 #: ../fish/guestfish-actions.pod:2638
26642 #, no-wrap
26643 msgid ""
26644 " lvrename logvol newlogvol\n"
26645 "\n"
26646 msgstr ""
26647
26648 # type: =head2
26649 #. type: =head2
26650 #: ../fish/guestfish-actions.pod:2642
26651 msgid "lvresize"
26652 msgstr ""
26653
26654 # type: verbatim
26655 #. type: verbatim
26656 #: ../fish/guestfish-actions.pod:2644
26657 #, no-wrap
26658 msgid ""
26659 " lvresize device mbytes\n"
26660 "\n"
26661 msgstr ""
26662
26663 # type: =head2
26664 #. type: =head2
26665 #: ../fish/guestfish-actions.pod:2650
26666 msgid "lvresize-free"
26667 msgstr ""
26668
26669 # type: verbatim
26670 #. type: verbatim
26671 #: ../fish/guestfish-actions.pod:2652
26672 #, no-wrap
26673 msgid ""
26674 " lvresize-free lv percent\n"
26675 "\n"
26676 msgstr ""
26677
26678 # type: =head2
26679 #. type: =head2
26680 #: ../fish/guestfish-actions.pod:2660
26681 msgid "lvs"
26682 msgstr ""
26683
26684 # type: verbatim
26685 #. type: verbatim
26686 #: ../fish/guestfish-actions.pod:2662
26687 #, no-wrap
26688 msgid ""
26689 " lvs\n"
26690 "\n"
26691 msgstr ""
26692
26693 # type: textblock
26694 #. type: textblock
26695 #: ../fish/guestfish-actions.pod:2670
26696 msgid "See also L</lvs-full>, L</list-filesystems>."
26697 msgstr ""
26698
26699 # type: =head2
26700 #. type: =head2
26701 #: ../fish/guestfish-actions.pod:2672
26702 msgid "lvs-full"
26703 msgstr ""
26704
26705 # type: verbatim
26706 #. type: verbatim
26707 #: ../fish/guestfish-actions.pod:2674
26708 #, no-wrap
26709 msgid ""
26710 " lvs-full\n"
26711 "\n"
26712 msgstr ""
26713
26714 # type: =head2
26715 #. type: =head2
26716 #: ../fish/guestfish-actions.pod:2679
26717 msgid "lvuuid"
26718 msgstr ""
26719
26720 # type: verbatim
26721 #. type: verbatim
26722 #: ../fish/guestfish-actions.pod:2681
26723 #, no-wrap
26724 msgid ""
26725 " lvuuid device\n"
26726 "\n"
26727 msgstr ""
26728
26729 # type: =head2
26730 #. type: =head2
26731 #: ../fish/guestfish-actions.pod:2685
26732 msgid "lxattrlist"
26733 msgstr ""
26734
26735 # type: verbatim
26736 #. type: verbatim
26737 #: ../fish/guestfish-actions.pod:2687
26738 #, no-wrap
26739 msgid ""
26740 " lxattrlist path 'names ...'\n"
26741 "\n"
26742 msgstr ""
26743
26744 # type: textblock
26745 #. type: textblock
26746 #: ../fish/guestfish-actions.pod:2703
26747 msgid ""
26748 "This call is intended for programs that want to efficiently list a directory "
26749 "contents without making many round-trips.  See also L</lstatlist> for a "
26750 "similarly efficient call for getting standard stats.  Very long directory "
26751 "listings might cause the protocol message size to be exceeded, causing this "
26752 "call to fail.  The caller must split up such requests into smaller groups of "
26753 "names."
26754 msgstr ""
26755
26756 # type: =head2
26757 #. type: =head2
26758 #: ../fish/guestfish-actions.pod:2711
26759 msgid "mkdir"
26760 msgstr ""
26761
26762 # type: verbatim
26763 #. type: verbatim
26764 #: ../fish/guestfish-actions.pod:2713
26765 #, no-wrap
26766 msgid ""
26767 " mkdir path\n"
26768 "\n"
26769 msgstr ""
26770
26771 # type: =head2
26772 #. type: =head2
26773 #: ../fish/guestfish-actions.pod:2717
26774 msgid "mkdir-mode"
26775 msgstr ""
26776
26777 # type: verbatim
26778 #. type: verbatim
26779 #: ../fish/guestfish-actions.pod:2719
26780 #, no-wrap
26781 msgid ""
26782 " mkdir-mode path mode\n"
26783 "\n"
26784 msgstr ""
26785
26786 # type: textblock
26787 #. type: textblock
26788 #: ../fish/guestfish-actions.pod:2728
26789 msgid "See also L</mkdir>, L</umask>"
26790 msgstr ""
26791
26792 # type: =head2
26793 #. type: =head2
26794 #: ../fish/guestfish-actions.pod:2730
26795 msgid "mkdir-p"
26796 msgstr ""
26797
26798 # type: verbatim
26799 #. type: verbatim
26800 #: ../fish/guestfish-actions.pod:2732
26801 #, no-wrap
26802 msgid ""
26803 " mkdir-p path\n"
26804 "\n"
26805 msgstr ""
26806
26807 # type: =head2
26808 #. type: =head2
26809 #: ../fish/guestfish-actions.pod:2737
26810 msgid "mkdtemp"
26811 msgstr ""
26812
26813 # type: verbatim
26814 #. type: verbatim
26815 #: ../fish/guestfish-actions.pod:2739
26816 #, no-wrap
26817 msgid ""
26818 " mkdtemp template\n"
26819 "\n"
26820 msgstr ""
26821
26822 # type: =head2
26823 #. type: =head2
26824 #: ../fish/guestfish-actions.pod:2760
26825 msgid "mke2fs-J"
26826 msgstr ""
26827
26828 # type: verbatim
26829 #. type: verbatim
26830 #: ../fish/guestfish-actions.pod:2762
26831 #, no-wrap
26832 msgid ""
26833 " mke2fs-J fstype blocksize device journal\n"
26834 "\n"
26835 msgstr ""
26836
26837 # type: textblock
26838 #. type: textblock
26839 #: ../fish/guestfish-actions.pod:2770
26840 msgid "See also L</mke2journal>."
26841 msgstr ""
26842
26843 # type: =head2
26844 #. type: =head2
26845 #: ../fish/guestfish-actions.pod:2772
26846 msgid "mke2fs-JL"
26847 msgstr ""
26848
26849 # type: verbatim
26850 #. type: verbatim
26851 #: ../fish/guestfish-actions.pod:2774
26852 #, no-wrap
26853 msgid ""
26854 " mke2fs-JL fstype blocksize device label\n"
26855 "\n"
26856 msgstr ""
26857
26858 # type: textblock
26859 #. type: textblock
26860 #: ../fish/guestfish-actions.pod:2779
26861 msgid "See also L</mke2journal-L>."
26862 msgstr ""
26863
26864 # type: =head2
26865 #. type: =head2
26866 #: ../fish/guestfish-actions.pod:2781
26867 msgid "mke2fs-JU"
26868 msgstr ""
26869
26870 # type: verbatim
26871 #. type: verbatim
26872 #: ../fish/guestfish-actions.pod:2783
26873 #, no-wrap
26874 msgid ""
26875 " mke2fs-JU fstype blocksize device uuid\n"
26876 "\n"
26877 msgstr ""
26878
26879 # type: textblock
26880 #. type: textblock
26881 #: ../fish/guestfish-actions.pod:2788
26882 msgid "See also L</mke2journal-U>."
26883 msgstr ""
26884
26885 # type: =head2
26886 #. type: =head2
26887 #: ../fish/guestfish-actions.pod:2790
26888 msgid "mke2journal"
26889 msgstr ""
26890
26891 # type: verbatim
26892 #. type: verbatim
26893 #: ../fish/guestfish-actions.pod:2792
26894 #, no-wrap
26895 msgid ""
26896 " mke2journal blocksize device\n"
26897 "\n"
26898 msgstr ""
26899
26900 # type: =head2
26901 #. type: =head2
26902 #: ../fish/guestfish-actions.pod:2799
26903 msgid "mke2journal-L"
26904 msgstr ""
26905
26906 # type: verbatim
26907 #. type: verbatim
26908 #: ../fish/guestfish-actions.pod:2801
26909 #, no-wrap
26910 msgid ""
26911 " mke2journal-L blocksize label device\n"
26912 "\n"
26913 msgstr ""
26914
26915 # type: =head2
26916 #. type: =head2
26917 #: ../fish/guestfish-actions.pod:2805
26918 msgid "mke2journal-U"
26919 msgstr ""
26920
26921 # type: verbatim
26922 #. type: verbatim
26923 #: ../fish/guestfish-actions.pod:2807
26924 #, no-wrap
26925 msgid ""
26926 " mke2journal-U blocksize uuid device\n"
26927 "\n"
26928 msgstr ""
26929
26930 # type: =head2
26931 #. type: =head2
26932 #: ../fish/guestfish-actions.pod:2811
26933 msgid "mkfifo"
26934 msgstr ""
26935
26936 # type: verbatim
26937 #. type: verbatim
26938 #: ../fish/guestfish-actions.pod:2813
26939 #, no-wrap
26940 msgid ""
26941 " mkfifo mode path\n"
26942 "\n"
26943 msgstr ""
26944
26945 # type: textblock
26946 #. type: textblock
26947 #: ../fish/guestfish-actions.pod:2815
26948 msgid ""
26949 "This call creates a FIFO (named pipe) called C<path> with mode C<mode>.  It "
26950 "is just a convenient wrapper around L</mknod>."
26951 msgstr ""
26952
26953 # type: =head2
26954 #. type: =head2
26955 #: ../fish/guestfish-actions.pod:2821
26956 msgid "mkfs"
26957 msgstr ""
26958
26959 # type: verbatim
26960 #. type: verbatim
26961 #: ../fish/guestfish-actions.pod:2823
26962 #, no-wrap
26963 msgid ""
26964 " mkfs fstype device\n"
26965 "\n"
26966 msgstr ""
26967
26968 # type: =head2
26969 #. type: =head2
26970 #: ../fish/guestfish-actions.pod:2829
26971 msgid "mkfs-b"
26972 msgstr ""
26973
26974 # type: verbatim
26975 #. type: verbatim
26976 #: ../fish/guestfish-actions.pod:2831
26977 #, no-wrap
26978 msgid ""
26979 " mkfs-b fstype blocksize device\n"
26980 "\n"
26981 msgstr ""
26982
26983 # type: textblock
26984 #. type: textblock
26985 #: ../fish/guestfish-actions.pod:2833
26986 msgid ""
26987 "This call is similar to L</mkfs>, but it allows you to control the block "
26988 "size of the resulting filesystem.  Supported block sizes depend on the "
26989 "filesystem type, but typically they are C<1024>, C<2048> or C<4096> only."
26990 msgstr ""
26991
26992 #. type: textblock
26993 #: ../fish/guestfish-actions.pod:2841
26994 msgid ""
26995 "This function is deprecated.  In new code, use the L</mkfs_opts> call "
26996 "instead."
26997 msgstr ""
26998
26999 # type: =head2
27000 #. type: =head2
27001 #: ../fish/guestfish-actions.pod:2848
27002 msgid "mkfs-opts"
27003 msgstr ""
27004
27005 # type: verbatim
27006 #. type: verbatim
27007 #: ../fish/guestfish-actions.pod:2850
27008 #, no-wrap
27009 msgid ""
27010 " mkfs-opts fstype device [blocksize:..]\n"
27011 "\n"
27012 msgstr ""
27013
27014 # type: =head2
27015 #. type: =head2
27016 #: ../fish/guestfish-actions.pod:2874
27017 msgid "mkmountpoint"
27018 msgstr ""
27019
27020 # type: verbatim
27021 #. type: verbatim
27022 #: ../fish/guestfish-actions.pod:2876
27023 #, no-wrap
27024 msgid ""
27025 " mkmountpoint exemptpath\n"
27026 "\n"
27027 msgstr ""
27028
27029 # type: textblock
27030 #. type: textblock
27031 #: ../fish/guestfish-actions.pod:2878
27032 msgid ""
27033 "L</mkmountpoint> and L</rmmountpoint> are specialized calls that can be used "
27034 "to create extra mountpoints before mounting the first filesystem."
27035 msgstr ""
27036
27037 # type: textblock
27038 #. type: textblock
27039 #: ../fish/guestfish-actions.pod:2902
27040 msgid ""
27041 "L</mkmountpoint> is not compatible with L</umount-all>.  You may get "
27042 "unexpected errors if you try to mix these calls.  It is safest to manually "
27043 "unmount filesystems and remove mountpoints after use."
27044 msgstr ""
27045
27046 # type: textblock
27047 #. type: textblock
27048 #: ../fish/guestfish-actions.pod:2906
27049 msgid ""
27050 "L</umount-all> unmounts filesystems by sorting the paths longest first, so "
27051 "for this to work for manual mountpoints, you must ensure that the innermost "
27052 "mountpoints have the longest pathnames, as in the example code above."
27053 msgstr ""
27054
27055 # type: textblock
27056 #. type: textblock
27057 #: ../fish/guestfish-actions.pod:2913
27058 msgid ""
27059 "Autosync [see L</set-autosync>, this is set by default on handles] means "
27060 "that L</umount-all> is called when the handle is closed which can also "
27061 "trigger these issues."
27062 msgstr ""
27063
27064 # type: =head2
27065 #. type: =head2
27066 #: ../fish/guestfish-actions.pod:2917
27067 msgid "mknod"
27068 msgstr ""
27069
27070 # type: verbatim
27071 #. type: verbatim
27072 #: ../fish/guestfish-actions.pod:2919
27073 #, no-wrap
27074 msgid ""
27075 " mknod mode devmajor devminor path\n"
27076 "\n"
27077 msgstr ""
27078
27079 # type: textblock
27080 #. type: textblock
27081 #: ../fish/guestfish-actions.pod:2929
27082 msgid ""
27083 "Note that, just like L<mknod(2)>, the mode must be bitwise OR'd with "
27084 "S_IFBLK, S_IFCHR, S_IFIFO or S_IFSOCK (otherwise this call just creates a "
27085 "regular file).  These constants are available in the standard Linux header "
27086 "files, or you can use L</mknod-b>, L</mknod-c> or L</mkfifo> which are "
27087 "wrappers around this command which bitwise OR in the appropriate constant "
27088 "for you."
27089 msgstr ""
27090
27091 # type: =head2
27092 #. type: =head2
27093 #: ../fish/guestfish-actions.pod:2939
27094 msgid "mknod-b"
27095 msgstr ""
27096
27097 # type: verbatim
27098 #. type: verbatim
27099 #: ../fish/guestfish-actions.pod:2941
27100 #, no-wrap
27101 msgid ""
27102 " mknod-b mode devmajor devminor path\n"
27103 "\n"
27104 msgstr ""
27105
27106 # type: textblock
27107 #. type: textblock
27108 #: ../fish/guestfish-actions.pod:2943
27109 msgid ""
27110 "This call creates a block device node called C<path> with mode C<mode> and "
27111 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
27112 "wrapper around L</mknod>."
27113 msgstr ""
27114
27115 # type: =head2
27116 #. type: =head2
27117 #: ../fish/guestfish-actions.pod:2949
27118 msgid "mknod-c"
27119 msgstr ""
27120
27121 # type: verbatim
27122 #. type: verbatim
27123 #: ../fish/guestfish-actions.pod:2951
27124 #, no-wrap
27125 msgid ""
27126 " mknod-c mode devmajor devminor path\n"
27127 "\n"
27128 msgstr ""
27129
27130 # type: textblock
27131 #. type: textblock
27132 #: ../fish/guestfish-actions.pod:2953
27133 msgid ""
27134 "This call creates a char device node called C<path> with mode C<mode> and "
27135 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
27136 "wrapper around L</mknod>."
27137 msgstr ""
27138
27139 # type: =head2
27140 #. type: =head2
27141 #: ../fish/guestfish-actions.pod:2959
27142 msgid "mkswap"
27143 msgstr ""
27144
27145 # type: verbatim
27146 #. type: verbatim
27147 #: ../fish/guestfish-actions.pod:2961
27148 #, no-wrap
27149 msgid ""
27150 " mkswap device\n"
27151 "\n"
27152 msgstr ""
27153
27154 # type: =head2
27155 #. type: =head2
27156 #: ../fish/guestfish-actions.pod:2965
27157 msgid "mkswap-L"
27158 msgstr ""
27159
27160 # type: verbatim
27161 #. type: verbatim
27162 #: ../fish/guestfish-actions.pod:2967
27163 #, no-wrap
27164 msgid ""
27165 " mkswap-L label device\n"
27166 "\n"
27167 msgstr ""
27168
27169 # type: =head2
27170 #. type: =head2
27171 #: ../fish/guestfish-actions.pod:2975
27172 msgid "mkswap-U"
27173 msgstr ""
27174
27175 # type: verbatim
27176 #. type: verbatim
27177 #: ../fish/guestfish-actions.pod:2977
27178 #, no-wrap
27179 msgid ""
27180 " mkswap-U uuid device\n"
27181 "\n"
27182 msgstr ""
27183
27184 # type: =head2
27185 #. type: =head2
27186 #: ../fish/guestfish-actions.pod:2981
27187 msgid "mkswap-file"
27188 msgstr ""
27189
27190 # type: verbatim
27191 #. type: verbatim
27192 #: ../fish/guestfish-actions.pod:2983
27193 #, no-wrap
27194 msgid ""
27195 " mkswap-file path\n"
27196 "\n"
27197 msgstr ""
27198
27199 # type: textblock
27200 #. type: textblock
27201 #: ../fish/guestfish-actions.pod:2987
27202 msgid ""
27203 "This command just writes a swap file signature to an existing file.  To "
27204 "create the file itself, use something like L</fallocate>."
27205 msgstr ""
27206
27207 # type: =head2
27208 #. type: =head2
27209 #: ../fish/guestfish-actions.pod:2990
27210 msgid "modprobe"
27211 msgstr ""
27212
27213 # type: verbatim
27214 #. type: verbatim
27215 #: ../fish/guestfish-actions.pod:2992
27216 #, no-wrap
27217 msgid ""
27218 " modprobe modulename\n"
27219 "\n"
27220 msgstr ""
27221
27222 # type: =head2
27223 #. type: =head2
27224 #: ../fish/guestfish-actions.pod:2999
27225 msgid "mount"
27226 msgstr ""
27227
27228 # type: verbatim
27229 #. type: verbatim
27230 #: ../fish/guestfish-actions.pod:3001
27231 #, no-wrap
27232 msgid ""
27233 " mount device mountpoint\n"
27234 "\n"
27235 msgstr ""
27236
27237 # type: textblock
27238 #. type: textblock
27239 #: ../fish/guestfish-actions.pod:3017
27240 msgid ""
27241 "B<Important note:> When you use this call, the filesystem options C<sync> "
27242 "and C<noatime> are set implicitly.  This was originally done because we "
27243 "thought it would improve reliability, but it turns out that I<-o sync> has a "
27244 "very large negative performance impact and negligible effect on "
27245 "reliability.  Therefore we recommend that you avoid using L</mount> in any "
27246 "code that needs performance, and instead use L</mount-options> (use an empty "
27247 "string for the first parameter if you don't want any options)."
27248 msgstr ""
27249
27250 # type: =head2
27251 #. type: =head2
27252 #: ../fish/guestfish-actions.pod:3027
27253 msgid "mount-loop"
27254 msgstr ""
27255
27256 # type: verbatim
27257 #. type: verbatim
27258 #: ../fish/guestfish-actions.pod:3029
27259 #, no-wrap
27260 msgid ""
27261 " mount-loop file mountpoint\n"
27262 "\n"
27263 msgstr ""
27264
27265 # type: =head2
27266 #. type: =head2
27267 #: ../fish/guestfish-actions.pod:3035
27268 msgid "mount-options"
27269 msgstr ""
27270
27271 # type: verbatim
27272 #. type: verbatim
27273 #: ../fish/guestfish-actions.pod:3037
27274 #, no-wrap
27275 msgid ""
27276 " mount-options options device mountpoint\n"
27277 "\n"
27278 msgstr ""
27279
27280 # type: textblock
27281 #. type: textblock
27282 #: ../fish/guestfish-actions.pod:3039
27283 msgid ""
27284 "This is the same as the L</mount> command, but it allows you to set the "
27285 "mount options as for the L<mount(8)> I<-o> flag."
27286 msgstr ""
27287
27288 # type: =head2
27289 #. type: =head2
27290 #: ../fish/guestfish-actions.pod:3047
27291 msgid "mount-ro"
27292 msgstr ""
27293
27294 # type: verbatim
27295 #. type: verbatim
27296 #: ../fish/guestfish-actions.pod:3049
27297 #, no-wrap
27298 msgid ""
27299 " mount-ro device mountpoint\n"
27300 "\n"
27301 msgstr ""
27302
27303 # type: textblock
27304 #. type: textblock
27305 #: ../fish/guestfish-actions.pod:3051
27306 msgid ""
27307 "This is the same as the L</mount> command, but it mounts the filesystem with "
27308 "the read-only (I<-o ro>) flag."
27309 msgstr ""
27310
27311 # type: =head2
27312 #. type: =head2
27313 #: ../fish/guestfish-actions.pod:3054
27314 msgid "mount-vfs"
27315 msgstr ""
27316
27317 # type: verbatim
27318 #. type: verbatim
27319 #: ../fish/guestfish-actions.pod:3056
27320 #, no-wrap
27321 msgid ""
27322 " mount-vfs options vfstype device mountpoint\n"
27323 "\n"
27324 msgstr ""
27325
27326 # type: textblock
27327 #. type: textblock
27328 #: ../fish/guestfish-actions.pod:3058
27329 msgid ""
27330 "This is the same as the L</mount> command, but it allows you to set both the "
27331 "mount options and the vfstype as for the L<mount(8)> I<-o> and I<-t> flags."
27332 msgstr ""
27333
27334 # type: =head2
27335 #. type: =head2
27336 #: ../fish/guestfish-actions.pod:3062
27337 msgid "mountpoints"
27338 msgstr ""
27339
27340 # type: verbatim
27341 #. type: verbatim
27342 #: ../fish/guestfish-actions.pod:3064
27343 #, no-wrap
27344 msgid ""
27345 " mountpoints\n"
27346 "\n"
27347 msgstr ""
27348
27349 # type: textblock
27350 #. type: textblock
27351 #: ../fish/guestfish-actions.pod:3066
27352 msgid ""
27353 "This call is similar to L</mounts>.  That call returns a list of devices.  "
27354 "This one returns a hash table (map) of device name to directory where the "
27355 "device is mounted."
27356 msgstr ""
27357
27358 # type: =head2
27359 #. type: =head2
27360 #: ../fish/guestfish-actions.pod:3070
27361 msgid "mounts"
27362 msgstr ""
27363
27364 # type: verbatim
27365 #. type: verbatim
27366 #: ../fish/guestfish-actions.pod:3072
27367 #, no-wrap
27368 msgid ""
27369 " mounts\n"
27370 "\n"
27371 msgstr ""
27372
27373 # type: textblock
27374 #. type: textblock
27375 #: ../fish/guestfish-actions.pod:3079
27376 msgid "See also: L</mountpoints>"
27377 msgstr ""
27378
27379 # type: =head2
27380 #. type: =head2
27381 #: ../fish/guestfish-actions.pod:3081
27382 msgid "mv"
27383 msgstr ""
27384
27385 # type: verbatim
27386 #. type: verbatim
27387 #: ../fish/guestfish-actions.pod:3083
27388 #, no-wrap
27389 msgid ""
27390 " mv src dest\n"
27391 "\n"
27392 msgstr ""
27393
27394 # type: =head2
27395 #. type: =head2
27396 #: ../fish/guestfish-actions.pod:3088
27397 msgid "ntfs-3g-probe"
27398 msgstr ""
27399
27400 # type: verbatim
27401 #. type: verbatim
27402 #: ../fish/guestfish-actions.pod:3090
27403 #, no-wrap
27404 msgid ""
27405 " ntfs-3g-probe true|false device\n"
27406 "\n"
27407 msgstr ""
27408
27409 # type: =head2
27410 #. type: =head2
27411 #: ../fish/guestfish-actions.pod:3104
27412 msgid "ntfsresize"
27413 msgstr ""
27414
27415 # type: verbatim
27416 #. type: verbatim
27417 #: ../fish/guestfish-actions.pod:3106
27418 #, no-wrap
27419 msgid ""
27420 " ntfsresize device\n"
27421 "\n"
27422 msgstr ""
27423
27424 # type: =head2
27425 #. type: =head2
27426 #: ../fish/guestfish-actions.pod:3121
27427 msgid "ntfsresize-size"
27428 msgstr ""
27429
27430 # type: verbatim
27431 #. type: verbatim
27432 #: ../fish/guestfish-actions.pod:3123
27433 #, no-wrap
27434 msgid ""
27435 " ntfsresize-size device size\n"
27436 "\n"
27437 msgstr ""
27438
27439 # type: textblock
27440 #. type: textblock
27441 #: ../fish/guestfish-actions.pod:3125
27442 msgid ""
27443 "This command is the same as L</ntfsresize> except that it allows you to "
27444 "specify the new size (in bytes) explicitly."
27445 msgstr ""
27446
27447 # type: =head2
27448 #. type: =head2
27449 #: ../fish/guestfish-actions.pod:3128
27450 msgid "part-add"
27451 msgstr ""
27452
27453 # type: verbatim
27454 #. type: verbatim
27455 #: ../fish/guestfish-actions.pod:3130
27456 #, no-wrap
27457 msgid ""
27458 " part-add device prlogex startsect endsect\n"
27459 "\n"
27460 msgstr ""
27461
27462 # type: textblock
27463 #. type: textblock
27464 #: ../fish/guestfish-actions.pod:3132
27465 msgid ""
27466 "This command adds a partition to C<device>.  If there is no partition table "
27467 "on the device, call L</part-init> first."
27468 msgstr ""
27469
27470 # type: textblock
27471 #. type: textblock
27472 #: ../fish/guestfish-actions.pod:3144
27473 msgid ""
27474 "Creating a partition which covers the whole disk is not so easy.  Use L</"
27475 "part-disk> to do that."
27476 msgstr ""
27477
27478 # type: =head2
27479 #. type: =head2
27480 #: ../fish/guestfish-actions.pod:3147
27481 msgid "part-del"
27482 msgstr ""
27483
27484 # type: verbatim
27485 #. type: verbatim
27486 #: ../fish/guestfish-actions.pod:3149
27487 #, no-wrap
27488 msgid ""
27489 " part-del device partnum\n"
27490 "\n"
27491 msgstr ""
27492
27493 # type: =head2
27494 #. type: =head2
27495 #: ../fish/guestfish-actions.pod:3157
27496 msgid "part-disk"
27497 msgstr ""
27498
27499 # type: verbatim
27500 #. type: verbatim
27501 #: ../fish/guestfish-actions.pod:3159
27502 #, no-wrap
27503 msgid ""
27504 " part-disk device parttype\n"
27505 "\n"
27506 msgstr ""
27507
27508 # type: textblock
27509 #. type: textblock
27510 #: ../fish/guestfish-actions.pod:3161
27511 msgid ""
27512 "This command is simply a combination of L</part-init> followed by L</part-"
27513 "add> to create a single primary partition covering the whole disk."
27514 msgstr ""
27515
27516 # type: textblock
27517 #. type: textblock
27518 #: ../fish/guestfish-actions.pod:3165
27519 msgid ""
27520 "C<parttype> is the partition table type, usually C<mbr> or C<gpt>, but other "
27521 "possible values are described in L</part-init>."
27522 msgstr ""
27523
27524 # type: =head2
27525 #. type: =head2
27526 #: ../fish/guestfish-actions.pod:3171
27527 msgid "part-get-bootable"
27528 msgstr ""
27529
27530 # type: verbatim
27531 #. type: verbatim
27532 #: ../fish/guestfish-actions.pod:3173
27533 #, no-wrap
27534 msgid ""
27535 " part-get-bootable device partnum\n"
27536 "\n"
27537 msgstr ""
27538
27539 # type: textblock
27540 #. type: textblock
27541 #: ../fish/guestfish-actions.pod:3178
27542 msgid "See also L</part-set-bootable>."
27543 msgstr ""
27544
27545 # type: =head2
27546 #. type: =head2
27547 #: ../fish/guestfish-actions.pod:3180
27548 msgid "part-get-mbr-id"
27549 msgstr ""
27550
27551 # type: verbatim
27552 #. type: verbatim
27553 #: ../fish/guestfish-actions.pod:3182
27554 #, no-wrap
27555 msgid ""
27556 " part-get-mbr-id device partnum\n"
27557 "\n"
27558 msgstr ""
27559
27560 # type: textblock
27561 #. type: textblock
27562 #: ../fish/guestfish-actions.pod:3187 ../fish/guestfish-actions.pod:3325
27563 msgid ""
27564 "Note that only MBR (old DOS-style) partitions have type bytes.  You will get "
27565 "undefined results for other partition table types (see L</part-get-"
27566 "parttype>)."
27567 msgstr ""
27568
27569 # type: =head2
27570 #. type: =head2
27571 #: ../fish/guestfish-actions.pod:3191
27572 msgid "part-get-parttype"
27573 msgstr ""
27574
27575 # type: verbatim
27576 #. type: verbatim
27577 #: ../fish/guestfish-actions.pod:3193
27578 #, no-wrap
27579 msgid ""
27580 " part-get-parttype device\n"
27581 "\n"
27582 msgstr ""
27583
27584 # type: textblock
27585 #. type: textblock
27586 #: ../fish/guestfish-actions.pod:3198
27587 msgid ""
27588 "Common return values include: C<msdos> (a DOS/Windows style MBR partition "
27589 "table), C<gpt> (a GPT/EFI-style partition table).  Other values are "
27590 "possible, although unusual.  See L</part-init> for a full list."
27591 msgstr ""
27592
27593 # type: =head2
27594 #. type: =head2
27595 #: ../fish/guestfish-actions.pod:3203
27596 msgid "part-init"
27597 msgstr ""
27598
27599 # type: verbatim
27600 #. type: verbatim
27601 #: ../fish/guestfish-actions.pod:3205
27602 #, no-wrap
27603 msgid ""
27604 " part-init device parttype\n"
27605 "\n"
27606 msgstr ""
27607
27608 # type: textblock
27609 #. type: textblock
27610 #: ../fish/guestfish-actions.pod:3211
27611 msgid ""
27612 "Initially there are no partitions.  Following this, you should call L</part-"
27613 "add> for each partition required."
27614 msgstr ""
27615
27616 # type: =head2
27617 #. type: =head2
27618 #: ../fish/guestfish-actions.pod:3274
27619 msgid "part-list"
27620 msgstr ""
27621
27622 # type: verbatim
27623 #. type: verbatim
27624 #: ../fish/guestfish-actions.pod:3276
27625 #, no-wrap
27626 msgid ""
27627 " part-list device\n"
27628 "\n"
27629 msgstr ""
27630
27631 # type: textblock
27632 #. type: textblock
27633 #: ../fish/guestfish-actions.pod:3291
27634 msgid ""
27635 "Start of the partition I<in bytes>.  To get sectors you have to divide by "
27636 "the device's sector size, see L</blockdev-getss>."
27637 msgstr ""
27638
27639 # type: =head2
27640 #. type: =head2
27641 #: ../fish/guestfish-actions.pod:3304
27642 msgid "part-set-bootable"
27643 msgstr ""
27644
27645 # type: verbatim
27646 #. type: verbatim
27647 #: ../fish/guestfish-actions.pod:3306
27648 #, no-wrap
27649 msgid ""
27650 " part-set-bootable device partnum true|false\n"
27651 "\n"
27652 msgstr ""
27653
27654 # type: =head2
27655 #. type: =head2
27656 #: ../fish/guestfish-actions.pod:3315
27657 msgid "part-set-mbr-id"
27658 msgstr ""
27659
27660 # type: verbatim
27661 #. type: verbatim
27662 #: ../fish/guestfish-actions.pod:3317
27663 #, no-wrap
27664 msgid ""
27665 " part-set-mbr-id device partnum idbyte\n"
27666 "\n"
27667 msgstr ""
27668
27669 # type: =head2
27670 #. type: =head2
27671 #: ../fish/guestfish-actions.pod:3329
27672 msgid "part-set-name"
27673 msgstr ""
27674
27675 # type: verbatim
27676 #. type: verbatim
27677 #: ../fish/guestfish-actions.pod:3331
27678 #, no-wrap
27679 msgid ""
27680 " part-set-name device partnum name\n"
27681 "\n"
27682 msgstr ""
27683
27684 # type: =head2
27685 #. type: =head2
27686 #: ../fish/guestfish-actions.pod:3339
27687 msgid "part-to-dev"
27688 msgstr ""
27689
27690 # type: verbatim
27691 #. type: verbatim
27692 #: ../fish/guestfish-actions.pod:3341
27693 #, no-wrap
27694 msgid ""
27695 " part-to-dev partition\n"
27696 "\n"
27697 msgstr ""
27698
27699 # type: textblock
27700 #. type: textblock
27701 #: ../fish/guestfish-actions.pod:3347
27702 msgid ""
27703 "The named partition must exist, for example as a string returned from L</"
27704 "list-partitions>."
27705 msgstr ""
27706
27707 # type: =head2
27708 #. type: =head2
27709 #: ../fish/guestfish-actions.pod:3350
27710 msgid "ping-daemon"
27711 msgstr ""
27712
27713 # type: verbatim
27714 #. type: verbatim
27715 #: ../fish/guestfish-actions.pod:3352
27716 #, no-wrap
27717 msgid ""
27718 " ping-daemon\n"
27719 "\n"
27720 msgstr ""
27721
27722 # type: =head2
27723 #. type: =head2
27724 #: ../fish/guestfish-actions.pod:3359
27725 msgid "pread"
27726 msgstr ""
27727
27728 # type: verbatim
27729 #. type: verbatim
27730 #: ../fish/guestfish-actions.pod:3361
27731 #, no-wrap
27732 msgid ""
27733 " pread path count offset\n"
27734 "\n"
27735 msgstr ""
27736
27737 # type: textblock
27738 #. type: textblock
27739 #: ../fish/guestfish-actions.pod:3369
27740 msgid "See also L</pwrite>, L</pread-device>."
27741 msgstr ""
27742
27743 # type: =head2
27744 #. type: =head2
27745 #: ../fish/guestfish-actions.pod:3374
27746 msgid "pread-device"
27747 msgstr ""
27748
27749 # type: verbatim
27750 #. type: verbatim
27751 #: ../fish/guestfish-actions.pod:3376
27752 #, no-wrap
27753 msgid ""
27754 " pread-device device count offset\n"
27755 "\n"
27756 msgstr ""
27757
27758 # type: textblock
27759 #. type: textblock
27760 #: ../fish/guestfish-actions.pod:3384
27761 msgid "See also L</pread>."
27762 msgstr ""
27763
27764 # type: =head2
27765 #. type: =head2
27766 #: ../fish/guestfish-actions.pod:3389
27767 msgid "pvcreate"
27768 msgstr ""
27769
27770 # type: verbatim
27771 #. type: verbatim
27772 #: ../fish/guestfish-actions.pod:3391
27773 #, no-wrap
27774 msgid ""
27775 " pvcreate device\n"
27776 "\n"
27777 msgstr ""
27778
27779 # type: =head2
27780 #. type: =head2
27781 #: ../fish/guestfish-actions.pod:3397
27782 msgid "pvremove"
27783 msgstr ""
27784
27785 # type: verbatim
27786 #. type: verbatim
27787 #: ../fish/guestfish-actions.pod:3399
27788 #, no-wrap
27789 msgid ""
27790 " pvremove device\n"
27791 "\n"
27792 msgstr ""
27793
27794 # type: =head2
27795 #. type: =head2
27796 #: ../fish/guestfish-actions.pod:3408
27797 msgid "pvresize"
27798 msgstr ""
27799
27800 # type: verbatim
27801 #. type: verbatim
27802 #: ../fish/guestfish-actions.pod:3410
27803 #, no-wrap
27804 msgid ""
27805 " pvresize device\n"
27806 "\n"
27807 msgstr ""
27808
27809 # type: =head2
27810 #. type: =head2
27811 #: ../fish/guestfish-actions.pod:3415
27812 msgid "pvresize-size"
27813 msgstr ""
27814
27815 # type: verbatim
27816 #. type: verbatim
27817 #: ../fish/guestfish-actions.pod:3417
27818 #, no-wrap
27819 msgid ""
27820 " pvresize-size device size\n"
27821 "\n"
27822 msgstr ""
27823
27824 # type: textblock
27825 #. type: textblock
27826 #: ../fish/guestfish-actions.pod:3419
27827 msgid ""
27828 "This command is the same as L</pvresize> except that it allows you to "
27829 "specify the new size (in bytes) explicitly."
27830 msgstr ""
27831
27832 # type: =head2
27833 #. type: =head2
27834 #: ../fish/guestfish-actions.pod:3422
27835 msgid "pvs"
27836 msgstr ""
27837
27838 # type: verbatim
27839 #. type: verbatim
27840 #: ../fish/guestfish-actions.pod:3424
27841 #, no-wrap
27842 msgid ""
27843 " pvs\n"
27844 "\n"
27845 msgstr ""
27846
27847 # type: textblock
27848 #. type: textblock
27849 #: ../fish/guestfish-actions.pod:3432
27850 msgid "See also L</pvs-full>."
27851 msgstr ""
27852
27853 # type: =head2
27854 #. type: =head2
27855 #: ../fish/guestfish-actions.pod:3434
27856 msgid "pvs-full"
27857 msgstr ""
27858
27859 # type: verbatim
27860 #. type: verbatim
27861 #: ../fish/guestfish-actions.pod:3436
27862 #, no-wrap
27863 msgid ""
27864 " pvs-full\n"
27865 "\n"
27866 msgstr ""
27867
27868 # type: =head2
27869 #. type: =head2
27870 #: ../fish/guestfish-actions.pod:3441
27871 msgid "pvuuid"
27872 msgstr ""
27873
27874 # type: verbatim
27875 #. type: verbatim
27876 #: ../fish/guestfish-actions.pod:3443
27877 #, no-wrap
27878 msgid ""
27879 " pvuuid device\n"
27880 "\n"
27881 msgstr ""
27882
27883 # type: =head2
27884 #. type: =head2
27885 #: ../fish/guestfish-actions.pod:3447
27886 msgid "pwrite"
27887 msgstr ""
27888
27889 # type: verbatim
27890 #. type: verbatim
27891 #: ../fish/guestfish-actions.pod:3449
27892 #, no-wrap
27893 msgid ""
27894 " pwrite path content offset\n"
27895 "\n"
27896 msgstr ""
27897
27898 # type: textblock
27899 #. type: textblock
27900 #: ../fish/guestfish-actions.pod:3460
27901 msgid "See also L</pread>, L</pwrite-device>."
27902 msgstr ""
27903
27904 # type: =head2
27905 #. type: =head2
27906 #: ../fish/guestfish-actions.pod:3465
27907 msgid "pwrite-device"
27908 msgstr ""
27909
27910 # type: verbatim
27911 #. type: verbatim
27912 #: ../fish/guestfish-actions.pod:3467
27913 #, no-wrap
27914 msgid ""
27915 " pwrite-device device content offset\n"
27916 "\n"
27917 msgstr ""
27918
27919 # type: textblock
27920 #. type: textblock
27921 #: ../fish/guestfish-actions.pod:3477
27922 msgid "See also L</pwrite>."
27923 msgstr ""
27924
27925 # type: =head2
27926 #. type: =head2
27927 #: ../fish/guestfish-actions.pod:3482
27928 msgid "read-file"
27929 msgstr ""
27930
27931 # type: verbatim
27932 #. type: verbatim
27933 #: ../fish/guestfish-actions.pod:3484
27934 #, no-wrap
27935 msgid ""
27936 " read-file path\n"
27937 "\n"
27938 msgstr ""
27939
27940 # type: textblock
27941 #. type: textblock
27942 #: ../fish/guestfish-actions.pod:3489
27943 msgid ""
27944 "Unlike L</cat>, this function can correctly handle files that contain "
27945 "embedded ASCII NUL characters.  However unlike L</download>, this function "
27946 "is limited in the total size of file that can be handled."
27947 msgstr ""
27948
27949 # type: =head2
27950 #. type: =head2
27951 #: ../fish/guestfish-actions.pod:3497
27952 msgid "read-lines"
27953 msgstr ""
27954
27955 # type: verbatim
27956 #. type: verbatim
27957 #: ../fish/guestfish-actions.pod:3499
27958 #, no-wrap
27959 msgid ""
27960 " read-lines path\n"
27961 "\n"
27962 msgstr ""
27963
27964 # type: textblock
27965 #. type: textblock
27966 #: ../fish/guestfish-actions.pod:3506
27967 msgid ""
27968 "Note that this function cannot correctly handle binary files (specifically, "
27969 "files containing C<\\0> character which is treated as end of line).  For "
27970 "those you need to use the L</read-file> function which has a more complex "
27971 "interface."
27972 msgstr ""
27973
27974 # type: =head2
27975 #. type: =head2
27976 #: ../fish/guestfish-actions.pod:3511
27977 msgid "readdir"
27978 msgstr ""
27979
27980 # type: verbatim
27981 #. type: verbatim
27982 #: ../fish/guestfish-actions.pod:3513
27983 #, no-wrap
27984 msgid ""
27985 " readdir dir\n"
27986 "\n"
27987 msgstr ""
27988
27989 # type: textblock
27990 #. type: textblock
27991 #: ../fish/guestfish-actions.pod:3565
27992 msgid ""
27993 "This function is primarily intended for use by programs.  To get a simple "
27994 "list of names, use L</ls>.  To get a printable directory for human "
27995 "consumption, use L</ll>."
27996 msgstr ""
27997
27998 # type: =head2
27999 #. type: =head2
28000 #: ../fish/guestfish-actions.pod:3569
28001 msgid "readlink"
28002 msgstr ""
28003
28004 # type: verbatim
28005 #. type: verbatim
28006 #: ../fish/guestfish-actions.pod:3571
28007 #, no-wrap
28008 msgid ""
28009 " readlink path\n"
28010 "\n"
28011 msgstr ""
28012
28013 # type: =head2
28014 #. type: =head2
28015 #: ../fish/guestfish-actions.pod:3575
28016 msgid "readlinklist"
28017 msgstr ""
28018
28019 # type: verbatim
28020 #. type: verbatim
28021 #: ../fish/guestfish-actions.pod:3577
28022 #, no-wrap
28023 msgid ""
28024 " readlinklist path 'names ...'\n"
28025 "\n"
28026 msgstr ""
28027
28028 # type: =head2
28029 #. type: =head2
28030 #: ../fish/guestfish-actions.pod:3601
28031 msgid "realpath"
28032 msgstr ""
28033
28034 # type: verbatim
28035 #. type: verbatim
28036 #: ../fish/guestfish-actions.pod:3603
28037 #, no-wrap
28038 msgid ""
28039 " realpath path\n"
28040 "\n"
28041 msgstr ""
28042
28043 # type: =head2
28044 #. type: =head2
28045 #: ../fish/guestfish-actions.pod:3608
28046 msgid "removexattr"
28047 msgstr ""
28048
28049 # type: verbatim
28050 #. type: verbatim
28051 #: ../fish/guestfish-actions.pod:3610
28052 #, no-wrap
28053 msgid ""
28054 " removexattr xattr path\n"
28055 "\n"
28056 msgstr ""
28057
28058 # type: textblock
28059 #. type: textblock
28060 #: ../fish/guestfish-actions.pod:3615
28061 msgid "See also: L</lremovexattr>, L<attr(5)>."
28062 msgstr ""
28063
28064 # type: =head2
28065 #. type: =head2
28066 #: ../fish/guestfish-actions.pod:3617
28067 msgid "resize2fs"
28068 msgstr ""
28069
28070 # type: verbatim
28071 #. type: verbatim
28072 #: ../fish/guestfish-actions.pod:3619
28073 #, no-wrap
28074 msgid ""
28075 " resize2fs device\n"
28076 "\n"
28077 msgstr ""
28078
28079 # type: textblock
28080 #. type: textblock
28081 #: ../fish/guestfish-actions.pod:3624
28082 msgid ""
28083 "I<Note:> It is sometimes required that you run L</e2fsck-f> on the C<device> "
28084 "before calling this command.  For unknown reasons C<resize2fs> sometimes "
28085 "gives an error about this and sometimes not.  In any case, it is always safe "
28086 "to call L</e2fsck-f> before calling this function."
28087 msgstr ""
28088
28089 # type: =head2
28090 #. type: =head2
28091 #: ../fish/guestfish-actions.pod:3630
28092 msgid "resize2fs-size"
28093 msgstr ""
28094
28095 # type: verbatim
28096 #. type: verbatim
28097 #: ../fish/guestfish-actions.pod:3632
28098 #, no-wrap
28099 msgid ""
28100 " resize2fs-size device size\n"
28101 "\n"
28102 msgstr ""
28103
28104 # type: textblock
28105 #. type: textblock
28106 #: ../fish/guestfish-actions.pod:3634
28107 msgid ""
28108 "This command is the same as L</resize2fs> except that it allows you to "
28109 "specify the new size (in bytes) explicitly."
28110 msgstr ""
28111
28112 # type: =head2
28113 #. type: =head2
28114 #: ../fish/guestfish-actions.pod:3637
28115 msgid "rm"
28116 msgstr ""
28117
28118 # type: verbatim
28119 #. type: verbatim
28120 #: ../fish/guestfish-actions.pod:3639
28121 #, no-wrap
28122 msgid ""
28123 " rm path\n"
28124 "\n"
28125 msgstr ""
28126
28127 # type: =head2
28128 #. type: =head2
28129 #: ../fish/guestfish-actions.pod:3643
28130 msgid "rm-rf"
28131 msgstr ""
28132
28133 # type: verbatim
28134 #. type: verbatim
28135 #: ../fish/guestfish-actions.pod:3645
28136 #, no-wrap
28137 msgid ""
28138 " rm-rf path\n"
28139 "\n"
28140 msgstr ""
28141
28142 # type: =head2
28143 #. type: =head2
28144 #: ../fish/guestfish-actions.pod:3651
28145 msgid "rmdir"
28146 msgstr ""
28147
28148 # type: verbatim
28149 #. type: verbatim
28150 #: ../fish/guestfish-actions.pod:3653
28151 #, no-wrap
28152 msgid ""
28153 " rmdir path\n"
28154 "\n"
28155 msgstr ""
28156
28157 # type: =head2
28158 #. type: =head2
28159 #: ../fish/guestfish-actions.pod:3657
28160 msgid "rmmountpoint"
28161 msgstr ""
28162
28163 # type: verbatim
28164 #. type: verbatim
28165 #: ../fish/guestfish-actions.pod:3659
28166 #, no-wrap
28167 msgid ""
28168 " rmmountpoint exemptpath\n"
28169 "\n"
28170 msgstr ""
28171
28172 # type: textblock
28173 #. type: textblock
28174 #: ../fish/guestfish-actions.pod:3661
28175 msgid ""
28176 "This calls removes a mountpoint that was previously created with L</"
28177 "mkmountpoint>.  See L</mkmountpoint> for full details."
28178 msgstr ""
28179
28180 # type: =head2
28181 #. type: =head2
28182 #: ../fish/guestfish-actions.pod:3665
28183 msgid "scrub-device"
28184 msgstr ""
28185
28186 # type: verbatim
28187 #. type: verbatim
28188 #: ../fish/guestfish-actions.pod:3667
28189 #, no-wrap
28190 msgid ""
28191 " scrub-device device\n"
28192 "\n"
28193 msgstr ""
28194
28195 # type: =head2
28196 #. type: =head2
28197 #: ../fish/guestfish-actions.pod:3678
28198 msgid "scrub-file"
28199 msgstr ""
28200
28201 # type: verbatim
28202 #. type: verbatim
28203 #: ../fish/guestfish-actions.pod:3680
28204 #, no-wrap
28205 msgid ""
28206 " scrub-file file\n"
28207 "\n"
28208 msgstr ""
28209
28210 # type: =head2
28211 #. type: =head2
28212 #: ../fish/guestfish-actions.pod:3690
28213 msgid "scrub-freespace"
28214 msgstr ""
28215
28216 # type: verbatim
28217 #. type: verbatim
28218 #: ../fish/guestfish-actions.pod:3692
28219 #, no-wrap
28220 msgid ""
28221 " scrub-freespace dir\n"
28222 "\n"
28223 msgstr ""
28224
28225 # type: textblock
28226 #. type: textblock
28227 #: ../fish/guestfish-actions.pod:3694
28228 msgid ""
28229 "This command creates the directory C<dir> and then fills it with files until "
28230 "the filesystem is full, and scrubs the files as for L</scrub-file>, and "
28231 "deletes them.  The intention is to scrub any free space on the partition "
28232 "containing C<dir>."
28233 msgstr ""
28234
28235 # type: =head2
28236 #. type: =head2
28237 #: ../fish/guestfish-actions.pod:3703
28238 msgid "set-append"
28239 msgstr ""
28240
28241 # type: =head2
28242 #. type: =head2
28243 #: ../fish/guestfish-actions.pod:3705
28244 msgid "append"
28245 msgstr ""
28246
28247 # type: verbatim
28248 #. type: verbatim
28249 #: ../fish/guestfish-actions.pod:3707
28250 #, no-wrap
28251 msgid ""
28252 " set-append append\n"
28253 "\n"
28254 msgstr ""
28255
28256 # type: =head2
28257 #. type: =head2
28258 #: ../fish/guestfish-actions.pod:3718
28259 msgid "set-autosync"
28260 msgstr ""
28261
28262 # type: =head2
28263 #. type: =head2
28264 #: ../fish/guestfish-actions.pod:3720
28265 msgid "autosync"
28266 msgstr ""
28267
28268 # type: verbatim
28269 #. type: verbatim
28270 #: ../fish/guestfish-actions.pod:3722
28271 #, no-wrap
28272 msgid ""
28273 " set-autosync true|false\n"
28274 "\n"
28275 msgstr ""
28276
28277 # type: textblock
28278 #. type: textblock
28279 #: ../fish/guestfish-actions.pod:3724
28280 msgid ""
28281 "If C<autosync> is true, this enables autosync.  Libguestfs will make a best "
28282 "effort attempt to run L</umount-all> followed by L</sync> when the handle is "
28283 "closed (also if the program exits without closing handles)."
28284 msgstr ""
28285
28286 # type: =head2
28287 #. type: =head2
28288 #: ../fish/guestfish-actions.pod:3732
28289 msgid "set-direct"
28290 msgstr ""
28291
28292 # type: =head2
28293 #. type: =head2
28294 #: ../fish/guestfish-actions.pod:3734
28295 msgid "direct"
28296 msgstr ""
28297
28298 # type: verbatim
28299 #. type: verbatim
28300 #: ../fish/guestfish-actions.pod:3736
28301 #, no-wrap
28302 msgid ""
28303 " set-direct true|false\n"
28304 "\n"
28305 msgstr ""
28306
28307 # type: textblock
28308 #. type: textblock
28309 #: ../fish/guestfish-actions.pod:3742
28310 msgid ""
28311 "One consequence of this is that log messages aren't caught by the library "
28312 "and handled by L</set-log-message-callback>, but go straight to stdout."
28313 msgstr ""
28314
28315 # type: =head2
28316 #. type: =head2
28317 #: ../fish/guestfish-actions.pod:3751
28318 msgid "set-e2label"
28319 msgstr ""
28320
28321 # type: verbatim
28322 #. type: verbatim
28323 #: ../fish/guestfish-actions.pod:3753
28324 #, no-wrap
28325 msgid ""
28326 " set-e2label device label\n"
28327 "\n"
28328 msgstr ""
28329
28330 # type: textblock
28331 #. type: textblock
28332 #: ../fish/guestfish-actions.pod:3759
28333 msgid ""
28334 "You can use either L</tune2fs-l> or L</get-e2label> to return the existing "
28335 "label on a filesystem."
28336 msgstr ""
28337
28338 # type: =head2
28339 #. type: =head2
28340 #: ../fish/guestfish-actions.pod:3762
28341 msgid "set-e2uuid"
28342 msgstr ""
28343
28344 # type: verbatim
28345 #. type: verbatim
28346 #: ../fish/guestfish-actions.pod:3764
28347 #, no-wrap
28348 msgid ""
28349 " set-e2uuid device uuid\n"
28350 "\n"
28351 msgstr ""
28352
28353 # type: textblock
28354 #. type: textblock
28355 #: ../fish/guestfish-actions.pod:3771
28356 msgid ""
28357 "You can use either L</tune2fs-l> or L</get-e2uuid> to return the existing "
28358 "UUID of a filesystem."
28359 msgstr ""
28360
28361 # type: =head2
28362 #. type: =head2
28363 #: ../fish/guestfish-actions.pod:3774
28364 msgid "set-memsize"
28365 msgstr ""
28366
28367 # type: =head2
28368 #. type: =head2
28369 #: ../fish/guestfish-actions.pod:3776
28370 msgid "memsize"
28371 msgstr ""
28372
28373 # type: verbatim
28374 #. type: verbatim
28375 #: ../fish/guestfish-actions.pod:3778
28376 #, no-wrap
28377 msgid ""
28378 " set-memsize memsize\n"
28379 "\n"
28380 msgstr ""
28381
28382 # type: textblock
28383 #. type: textblock
28384 #: ../fish/guestfish-actions.pod:3780
28385 msgid ""
28386 "This sets the memory size in megabytes allocated to the qemu subprocess.  "
28387 "This only has any effect if called before L</launch>."
28388 msgstr ""
28389
28390 # type: =head2
28391 #. type: =head2
28392 #: ../fish/guestfish-actions.pod:3791
28393 msgid "set-network"
28394 msgstr ""
28395
28396 # type: =head2
28397 #. type: =head2
28398 #: ../fish/guestfish-actions.pod:3793
28399 msgid "network"
28400 msgstr ""
28401
28402 # type: verbatim
28403 #. type: verbatim
28404 #: ../fish/guestfish-actions.pod:3795
28405 #, no-wrap
28406 msgid ""
28407 " set-network true|false\n"
28408 "\n"
28409 msgstr ""
28410
28411 # type: textblock
28412 #. type: textblock
28413 #: ../fish/guestfish-actions.pod:3803
28414 msgid ""
28415 "You must call this before calling L</launch>, otherwise it has no effect."
28416 msgstr ""
28417
28418 # type: =head2
28419 #. type: =head2
28420 #: ../fish/guestfish-actions.pod:3806
28421 msgid "set-path"
28422 msgstr ""
28423
28424 # type: =head2
28425 #. type: =head2
28426 #: ../fish/guestfish-actions.pod:3808
28427 msgid "path"
28428 msgstr ""
28429
28430 # type: verbatim
28431 #. type: verbatim
28432 #: ../fish/guestfish-actions.pod:3810
28433 #, no-wrap
28434 msgid ""
28435 " set-path searchpath\n"
28436 "\n"
28437 msgstr ""
28438
28439 # type: =head2
28440 #. type: =head2
28441 #: ../fish/guestfish-actions.pod:3819
28442 msgid "set-qemu"
28443 msgstr ""
28444
28445 # type: =head2
28446 #. type: =head2
28447 #: ../fish/guestfish-actions.pod:3821
28448 msgid "qemu"
28449 msgstr ""
28450
28451 # type: verbatim
28452 #. type: verbatim
28453 #: ../fish/guestfish-actions.pod:3823
28454 #, no-wrap
28455 msgid ""
28456 " set-qemu qemu\n"
28457 "\n"
28458 msgstr ""
28459
28460 # type: =head2
28461 #. type: =head2
28462 #: ../fish/guestfish-actions.pod:3843
28463 msgid "set-recovery-proc"
28464 msgstr ""
28465
28466 # type: =head2
28467 #. type: =head2
28468 #: ../fish/guestfish-actions.pod:3845
28469 msgid "recovery-proc"
28470 msgstr ""
28471
28472 # type: verbatim
28473 #. type: verbatim
28474 #: ../fish/guestfish-actions.pod:3847
28475 #, no-wrap
28476 msgid ""
28477 " set-recovery-proc true|false\n"
28478 "\n"
28479 msgstr ""
28480
28481 # type: textblock
28482 #. type: textblock
28483 #: ../fish/guestfish-actions.pod:3849
28484 msgid ""
28485 "If this is called with the parameter C<false> then L</launch> does not "
28486 "create a recovery process.  The purpose of the recovery process is to stop "
28487 "runaway qemu processes in the case where the main program aborts abruptly."
28488 msgstr ""
28489
28490 # type: textblock
28491 #. type: textblock
28492 #: ../fish/guestfish-actions.pod:3854
28493 msgid ""
28494 "This only has any effect if called before L</launch>, and the default is "
28495 "true."
28496 msgstr ""
28497
28498 # type: =head2
28499 #. type: =head2
28500 #: ../fish/guestfish-actions.pod:3863
28501 msgid "set-selinux"
28502 msgstr ""
28503
28504 # type: =head2
28505 #. type: =head2
28506 #: ../fish/guestfish-actions.pod:3865
28507 msgid "selinux"
28508 msgstr ""
28509
28510 # type: verbatim
28511 #. type: verbatim
28512 #: ../fish/guestfish-actions.pod:3867
28513 #, no-wrap
28514 msgid ""
28515 " set-selinux true|false\n"
28516 "\n"
28517 msgstr ""
28518
28519 # type: =head2
28520 #. type: =head2
28521 #: ../fish/guestfish-actions.pod:3878
28522 msgid "set-trace"
28523 msgstr ""
28524
28525 # type: =head2
28526 #. type: =head2
28527 #: ../fish/guestfish-actions.pod:3880
28528 msgid "trace"
28529 msgstr ""
28530
28531 # type: verbatim
28532 #. type: verbatim
28533 #: ../fish/guestfish-actions.pod:3882
28534 #, no-wrap
28535 msgid ""
28536 " set-trace true|false\n"
28537 "\n"
28538 msgstr ""
28539
28540 # type: =head2
28541 #. type: =head2
28542 #: ../fish/guestfish-actions.pod:3898
28543 msgid "set-verbose"
28544 msgstr ""
28545
28546 # type: =head2
28547 #. type: =head2
28548 #: ../fish/guestfish-actions.pod:3900
28549 msgid "verbose"
28550 msgstr ""
28551
28552 # type: verbatim
28553 #. type: verbatim
28554 #: ../fish/guestfish-actions.pod:3902
28555 #, no-wrap
28556 msgid ""
28557 " set-verbose true|false\n"
28558 "\n"
28559 msgstr ""
28560
28561 # type: =head2
28562 #. type: =head2
28563 #: ../fish/guestfish-actions.pod:3909
28564 msgid "setcon"
28565 msgstr ""
28566
28567 # type: verbatim
28568 #. type: verbatim
28569 #: ../fish/guestfish-actions.pod:3911
28570 #, no-wrap
28571 msgid ""
28572 " setcon context\n"
28573 "\n"
28574 msgstr ""
28575
28576 # type: =head2
28577 #. type: =head2
28578 #: ../fish/guestfish-actions.pod:3918
28579 msgid "setxattr"
28580 msgstr ""
28581
28582 # type: verbatim
28583 #. type: verbatim
28584 #: ../fish/guestfish-actions.pod:3920
28585 #, no-wrap
28586 msgid ""
28587 " setxattr xattr val vallen path\n"
28588 "\n"
28589 msgstr ""
28590
28591 # type: textblock
28592 #. type: textblock
28593 #: ../fish/guestfish-actions.pod:3926
28594 msgid "See also: L</lsetxattr>, L<attr(5)>."
28595 msgstr ""
28596
28597 # type: =head2
28598 #. type: =head2
28599 #: ../fish/guestfish-actions.pod:3928
28600 msgid "sfdisk"
28601 msgstr ""
28602
28603 # type: verbatim
28604 #. type: verbatim
28605 #: ../fish/guestfish-actions.pod:3930
28606 #, no-wrap
28607 msgid ""
28608 " sfdisk device cyls heads sectors 'lines ...'\n"
28609 "\n"
28610 msgstr ""
28611
28612 # type: textblock
28613 #. type: textblock
28614 #: ../fish/guestfish-actions.pod:3952
28615 msgid "See also: L</sfdisk-l>, L</sfdisk-N>, L</part-init>"
28616 msgstr ""
28617
28618 # type: =head2
28619 #. type: =head2
28620 #: ../fish/guestfish-actions.pod:3958
28621 msgid "sfdiskM"
28622 msgstr ""
28623
28624 # type: verbatim
28625 #. type: verbatim
28626 #: ../fish/guestfish-actions.pod:3960
28627 #, no-wrap
28628 msgid ""
28629 " sfdiskM device 'lines ...'\n"
28630 "\n"
28631 msgstr ""
28632
28633 # type: textblock
28634 #. type: textblock
28635 #: ../fish/guestfish-actions.pod:3962
28636 msgid ""
28637 "This is a simplified interface to the L</sfdisk> command, where partition "
28638 "sizes are specified in megabytes only (rounded to the nearest cylinder) and "
28639 "you don't need to specify the cyls, heads and sectors parameters which were "
28640 "rarely if ever used anyway."
28641 msgstr ""
28642
28643 # type: textblock
28644 #. type: textblock
28645 #: ../fish/guestfish-actions.pod:3968
28646 msgid "See also: L</sfdisk>, the L<sfdisk(8)> manpage and L</part-disk>"
28647 msgstr ""
28648
28649 # type: =head2
28650 #. type: =head2
28651 #: ../fish/guestfish-actions.pod:3974
28652 msgid "sfdisk-N"
28653 msgstr ""
28654
28655 # type: verbatim
28656 #. type: verbatim
28657 #: ../fish/guestfish-actions.pod:3976
28658 #, no-wrap
28659 msgid ""
28660 " sfdisk-N device partnum cyls heads sectors line\n"
28661 "\n"
28662 msgstr ""
28663
28664 # type: textblock
28665 #. type: textblock
28666 #: ../fish/guestfish-actions.pod:3981
28667 msgid ""
28668 "For other parameters, see L</sfdisk>.  You should usually pass C<0> for the "
28669 "cyls/heads/sectors parameters."
28670 msgstr ""
28671
28672 # type: textblock
28673 #. type: textblock
28674 #: ../fish/guestfish-actions.pod:3984
28675 msgid "See also: L</part-add>"
28676 msgstr ""
28677
28678 # type: =head2
28679 #. type: =head2
28680 #: ../fish/guestfish-actions.pod:3989
28681 msgid "sfdisk-disk-geometry"
28682 msgstr ""
28683
28684 # type: verbatim
28685 #. type: verbatim
28686 #: ../fish/guestfish-actions.pod:3991
28687 #, no-wrap
28688 msgid ""
28689 " sfdisk-disk-geometry device\n"
28690 "\n"
28691 msgstr ""
28692
28693 # type: textblock
28694 #. type: textblock
28695 #: ../fish/guestfish-actions.pod:3993
28696 msgid ""
28697 "This displays the disk geometry of C<device> read from the partition table.  "
28698 "Especially in the case where the underlying block device has been resized, "
28699 "this can be different from the kernel's idea of the geometry (see L</sfdisk-"
28700 "kernel-geometry>)."
28701 msgstr ""
28702
28703 # type: =head2
28704 #. type: =head2
28705 #: ../fish/guestfish-actions.pod:4001
28706 msgid "sfdisk-kernel-geometry"
28707 msgstr ""
28708
28709 # type: verbatim
28710 #. type: verbatim
28711 #: ../fish/guestfish-actions.pod:4003
28712 #, no-wrap
28713 msgid ""
28714 " sfdisk-kernel-geometry device\n"
28715 "\n"
28716 msgstr ""
28717
28718 # type: =head2
28719 #. type: =head2
28720 #: ../fish/guestfish-actions.pod:4010
28721 msgid "sfdisk-l"
28722 msgstr ""
28723
28724 # type: verbatim
28725 #. type: verbatim
28726 #: ../fish/guestfish-actions.pod:4012
28727 #, no-wrap
28728 msgid ""
28729 " sfdisk-l device\n"
28730 "\n"
28731 msgstr ""
28732
28733 # type: textblock
28734 #. type: textblock
28735 #: ../fish/guestfish-actions.pod:4018
28736 msgid "See also: L</part-list>"
28737 msgstr ""
28738
28739 # type: =head2
28740 #. type: =head2
28741 #: ../fish/guestfish-actions.pod:4020
28742 msgid "sh"
28743 msgstr ""
28744
28745 # type: verbatim
28746 #. type: verbatim
28747 #: ../fish/guestfish-actions.pod:4022
28748 #, no-wrap
28749 msgid ""
28750 " sh command\n"
28751 "\n"
28752 msgstr ""
28753
28754 # type: textblock
28755 #. type: textblock
28756 #: ../fish/guestfish-actions.pod:4027
28757 msgid "This is like L</command>, but passes the command to:"
28758 msgstr ""
28759
28760 # type: textblock
28761 #. type: textblock
28762 #: ../fish/guestfish-actions.pod:4035
28763 msgid "All the provisos about L</command> apply to this call."
28764 msgstr ""
28765
28766 # type: =head2
28767 #. type: =head2
28768 #: ../fish/guestfish-actions.pod:4037
28769 msgid "sh-lines"
28770 msgstr ""
28771
28772 # type: verbatim
28773 #. type: verbatim
28774 #: ../fish/guestfish-actions.pod:4039
28775 #, no-wrap
28776 msgid ""
28777 " sh-lines command\n"
28778 "\n"
28779 msgstr ""
28780
28781 # type: textblock
28782 #. type: textblock
28783 #: ../fish/guestfish-actions.pod:4041
28784 msgid "This is the same as L</sh>, but splits the result into a list of lines."
28785 msgstr ""
28786
28787 # type: textblock
28788 #. type: textblock
28789 #: ../fish/guestfish-actions.pod:4044
28790 msgid "See also: L</command-lines>"
28791 msgstr ""
28792
28793 # type: =head2
28794 #. type: =head2
28795 #: ../fish/guestfish-actions.pod:4046
28796 msgid "sleep"
28797 msgstr ""
28798
28799 # type: verbatim
28800 #. type: verbatim
28801 #: ../fish/guestfish-actions.pod:4048
28802 #, no-wrap
28803 msgid ""
28804 " sleep secs\n"
28805 "\n"
28806 msgstr ""
28807
28808 # type: =head2
28809 #. type: =head2
28810 #: ../fish/guestfish-actions.pod:4052
28811 msgid "stat"
28812 msgstr ""
28813
28814 # type: verbatim
28815 #. type: verbatim
28816 #: ../fish/guestfish-actions.pod:4054
28817 #, no-wrap
28818 msgid ""
28819 " stat path\n"
28820 "\n"
28821 msgstr ""
28822
28823 # type: =head2
28824 #. type: =head2
28825 #: ../fish/guestfish-actions.pod:4060
28826 msgid "statvfs"
28827 msgstr ""
28828
28829 # type: verbatim
28830 #. type: verbatim
28831 #: ../fish/guestfish-actions.pod:4062
28832 #, no-wrap
28833 msgid ""
28834 " statvfs path\n"
28835 "\n"
28836 msgstr ""
28837
28838 # type: =head2
28839 #. type: =head2
28840 #: ../fish/guestfish-actions.pod:4070
28841 msgid "strings"
28842 msgstr ""
28843
28844 # type: verbatim
28845 #. type: verbatim
28846 #: ../fish/guestfish-actions.pod:4072
28847 #, no-wrap
28848 msgid ""
28849 " strings path\n"
28850 "\n"
28851 msgstr ""
28852
28853 # type: =head2
28854 #. type: =head2
28855 #: ../fish/guestfish-actions.pod:4080
28856 msgid "strings-e"
28857 msgstr ""
28858
28859 # type: verbatim
28860 #. type: verbatim
28861 #: ../fish/guestfish-actions.pod:4082
28862 #, no-wrap
28863 msgid ""
28864 " strings-e encoding path\n"
28865 "\n"
28866 msgstr ""
28867
28868 # type: textblock
28869 #. type: textblock
28870 #: ../fish/guestfish-actions.pod:4084
28871 msgid ""
28872 "This is like the L</strings> command, but allows you to specify the encoding "
28873 "of strings that are looked for in the source file C<path>."
28874 msgstr ""
28875
28876 # type: textblock
28877 #. type: textblock
28878 #: ../fish/guestfish-actions.pod:4094
28879 msgid ""
28880 "Single 7-bit-byte characters like ASCII and the ASCII-compatible parts of "
28881 "ISO-8859-X (this is what L</strings> uses)."
28882 msgstr ""
28883
28884 # type: =head2
28885 #. type: =head2
28886 #: ../fish/guestfish-actions.pod:4126
28887 msgid "swapoff-device"
28888 msgstr ""
28889
28890 # type: verbatim
28891 #. type: verbatim
28892 #: ../fish/guestfish-actions.pod:4128
28893 #, no-wrap
28894 msgid ""
28895 " swapoff-device device\n"
28896 "\n"
28897 msgstr ""
28898
28899 # type: textblock
28900 #. type: textblock
28901 #: ../fish/guestfish-actions.pod:4130
28902 msgid ""
28903 "This command disables the libguestfs appliance swap device or partition "
28904 "named C<device>.  See L</swapon-device>."
28905 msgstr ""
28906
28907 # type: =head2
28908 #. type: =head2
28909 #: ../fish/guestfish-actions.pod:4134
28910 msgid "swapoff-file"
28911 msgstr ""
28912
28913 # type: verbatim
28914 #. type: verbatim
28915 #: ../fish/guestfish-actions.pod:4136
28916 #, no-wrap
28917 msgid ""
28918 " swapoff-file file\n"
28919 "\n"
28920 msgstr ""
28921
28922 # type: =head2
28923 #. type: =head2
28924 #: ../fish/guestfish-actions.pod:4140
28925 msgid "swapoff-label"
28926 msgstr ""
28927
28928 # type: verbatim
28929 #. type: verbatim
28930 #: ../fish/guestfish-actions.pod:4142
28931 #, no-wrap
28932 msgid ""
28933 " swapoff-label label\n"
28934 "\n"
28935 msgstr ""
28936
28937 # type: =head2
28938 #. type: =head2
28939 #: ../fish/guestfish-actions.pod:4147
28940 msgid "swapoff-uuid"
28941 msgstr ""
28942
28943 # type: verbatim
28944 #. type: verbatim
28945 #: ../fish/guestfish-actions.pod:4149
28946 #, no-wrap
28947 msgid ""
28948 " swapoff-uuid uuid\n"
28949 "\n"
28950 msgstr ""
28951
28952 # type: =head2
28953 #. type: =head2
28954 #: ../fish/guestfish-actions.pod:4154
28955 msgid "swapon-device"
28956 msgstr ""
28957
28958 # type: verbatim
28959 #. type: verbatim
28960 #: ../fish/guestfish-actions.pod:4156
28961 #, no-wrap
28962 msgid ""
28963 " swapon-device device\n"
28964 "\n"
28965 msgstr ""
28966
28967 # type: textblock
28968 #. type: textblock
28969 #: ../fish/guestfish-actions.pod:4158
28970 msgid ""
28971 "This command enables the libguestfs appliance to use the swap device or "
28972 "partition named C<device>.  The increased memory is made available for all "
28973 "commands, for example those run using L</command> or L</sh>."
28974 msgstr ""
28975
28976 # type: =head2
28977 #. type: =head2
28978 #: ../fish/guestfish-actions.pod:4170
28979 msgid "swapon-file"
28980 msgstr ""
28981
28982 # type: verbatim
28983 #. type: verbatim
28984 #: ../fish/guestfish-actions.pod:4172
28985 #, no-wrap
28986 msgid ""
28987 " swapon-file file\n"
28988 "\n"
28989 msgstr ""
28990
28991 # type: textblock
28992 #. type: textblock
28993 #: ../fish/guestfish-actions.pod:4174
28994 msgid ""
28995 "This command enables swap to a file.  See L</swapon-device> for other notes."
28996 msgstr ""
28997
28998 # type: =head2
28999 #. type: =head2
29000 #: ../fish/guestfish-actions.pod:4177
29001 msgid "swapon-label"
29002 msgstr ""
29003
29004 # type: verbatim
29005 #. type: verbatim
29006 #: ../fish/guestfish-actions.pod:4179
29007 #, no-wrap
29008 msgid ""
29009 " swapon-label label\n"
29010 "\n"
29011 msgstr ""
29012
29013 # type: textblock
29014 #. type: textblock
29015 #: ../fish/guestfish-actions.pod:4181
29016 msgid ""
29017 "This command enables swap to a labeled swap partition.  See L</swapon-"
29018 "device> for other notes."
29019 msgstr ""
29020
29021 # type: =head2
29022 #. type: =head2
29023 #: ../fish/guestfish-actions.pod:4184
29024 msgid "swapon-uuid"
29025 msgstr ""
29026
29027 # type: verbatim
29028 #. type: verbatim
29029 #: ../fish/guestfish-actions.pod:4186
29030 #, no-wrap
29031 msgid ""
29032 " swapon-uuid uuid\n"
29033 "\n"
29034 msgstr ""
29035
29036 # type: textblock
29037 #. type: textblock
29038 #: ../fish/guestfish-actions.pod:4188
29039 msgid ""
29040 "This command enables swap to a swap partition with the given UUID.  See L</"
29041 "swapon-device> for other notes."
29042 msgstr ""
29043
29044 # type: =head2
29045 #. type: =head2
29046 #: ../fish/guestfish-actions.pod:4191
29047 msgid "sync"
29048 msgstr ""
29049
29050 # type: verbatim
29051 #. type: verbatim
29052 #: ../fish/guestfish-actions.pod:4193
29053 #, no-wrap
29054 msgid ""
29055 " sync\n"
29056 "\n"
29057 msgstr ""
29058
29059 # type: =head2
29060 #. type: =head2
29061 #: ../fish/guestfish-actions.pod:4201
29062 msgid "tail"
29063 msgstr ""
29064
29065 # type: verbatim
29066 #. type: verbatim
29067 #: ../fish/guestfish-actions.pod:4203
29068 #, no-wrap
29069 msgid ""
29070 " tail path\n"
29071 "\n"
29072 msgstr ""
29073
29074 # type: =head2
29075 #. type: =head2
29076 #: ../fish/guestfish-actions.pod:4211
29077 msgid "tail-n"
29078 msgstr ""
29079
29080 # type: verbatim
29081 #. type: verbatim
29082 #: ../fish/guestfish-actions.pod:4213
29083 #, no-wrap
29084 msgid ""
29085 " tail-n nrlines path\n"
29086 "\n"
29087 msgstr ""
29088
29089 # type: =head2
29090 #. type: =head2
29091 #: ../fish/guestfish-actions.pod:4226
29092 msgid "tar-in"
29093 msgstr ""
29094
29095 # type: verbatim
29096 #. type: verbatim
29097 #: ../fish/guestfish-actions.pod:4228
29098 #, no-wrap
29099 msgid ""
29100 " tar-in (tarfile|-) directory\n"
29101 "\n"
29102 msgstr ""
29103
29104 # type: textblock
29105 #. type: textblock
29106 #: ../fish/guestfish-actions.pod:4233
29107 msgid "To upload a compressed tarball, use L</tgz-in> or L</txz-in>."
29108 msgstr ""
29109
29110 # type: =head2
29111 #. type: =head2
29112 #: ../fish/guestfish-actions.pod:4238
29113 msgid "tar-out"
29114 msgstr ""
29115
29116 # type: verbatim
29117 #. type: verbatim
29118 #: ../fish/guestfish-actions.pod:4240
29119 #, no-wrap
29120 msgid ""
29121 " tar-out directory (tarfile|-)\n"
29122 "\n"
29123 msgstr ""
29124
29125 # type: textblock
29126 #. type: textblock
29127 #: ../fish/guestfish-actions.pod:4245
29128 msgid "To download a compressed tarball, use L</tgz-out> or L</txz-out>."
29129 msgstr ""
29130
29131 # type: =head2
29132 #. type: =head2
29133 #: ../fish/guestfish-actions.pod:4250
29134 msgid "tgz-in"
29135 msgstr ""
29136
29137 # type: verbatim
29138 #. type: verbatim
29139 #: ../fish/guestfish-actions.pod:4252
29140 #, no-wrap
29141 msgid ""
29142 " tgz-in (tarball|-) directory\n"
29143 "\n"
29144 msgstr ""
29145
29146 # type: textblock
29147 #. type: textblock
29148 #: ../fish/guestfish-actions.pod:4257
29149 msgid "To upload an uncompressed tarball, use L</tar-in>."
29150 msgstr ""
29151
29152 # type: =head2
29153 #. type: =head2
29154 #: ../fish/guestfish-actions.pod:4261
29155 msgid "tgz-out"
29156 msgstr ""
29157
29158 # type: verbatim
29159 #. type: verbatim
29160 #: ../fish/guestfish-actions.pod:4263
29161 #, no-wrap
29162 msgid ""
29163 " tgz-out directory (tarball|-)\n"
29164 "\n"
29165 msgstr ""
29166
29167 # type: textblock
29168 #. type: textblock
29169 #: ../fish/guestfish-actions.pod:4268
29170 msgid "To download an uncompressed tarball, use L</tar-out>."
29171 msgstr ""
29172
29173 # type: =head2
29174 #. type: =head2
29175 #: ../fish/guestfish-actions.pod:4272
29176 msgid "touch"
29177 msgstr ""
29178
29179 # type: verbatim
29180 #. type: verbatim
29181 #: ../fish/guestfish-actions.pod:4274
29182 #, no-wrap
29183 msgid ""
29184 " touch path\n"
29185 "\n"
29186 msgstr ""
29187
29188 # type: =head2
29189 #. type: =head2
29190 #: ../fish/guestfish-actions.pod:4283
29191 msgid "truncate"
29192 msgstr ""
29193
29194 # type: verbatim
29195 #. type: verbatim
29196 #: ../fish/guestfish-actions.pod:4285
29197 #, no-wrap
29198 msgid ""
29199 " truncate path\n"
29200 "\n"
29201 msgstr ""
29202
29203 # type: =head2
29204 #. type: =head2
29205 #: ../fish/guestfish-actions.pod:4290
29206 msgid "truncate-size"
29207 msgstr ""
29208
29209 # type: verbatim
29210 #. type: verbatim
29211 #: ../fish/guestfish-actions.pod:4292
29212 #, no-wrap
29213 msgid ""
29214 " truncate-size path size\n"
29215 "\n"
29216 msgstr ""
29217
29218 # type: textblock
29219 #. type: textblock
29220 #: ../fish/guestfish-actions.pod:4297
29221 msgid ""
29222 "If the current file size is less than C<size> then the file is extended to "
29223 "the required size with zero bytes.  This creates a sparse file (ie. disk "
29224 "blocks are not allocated for the file until you write to it).  To create a "
29225 "non-sparse file of zeroes, use L</fallocate64> instead."
29226 msgstr ""
29227
29228 # type: =head2
29229 #. type: =head2
29230 #: ../fish/guestfish-actions.pod:4303
29231 msgid "tune2fs-l"
29232 msgstr ""
29233
29234 # type: verbatim
29235 #. type: verbatim
29236 #: ../fish/guestfish-actions.pod:4305
29237 #, no-wrap
29238 msgid ""
29239 " tune2fs-l device\n"
29240 "\n"
29241 msgstr ""
29242
29243 # type: =head2
29244 #. type: =head2
29245 #: ../fish/guestfish-actions.pod:4315
29246 msgid "txz-in"
29247 msgstr ""
29248
29249 # type: verbatim
29250 #. type: verbatim
29251 #: ../fish/guestfish-actions.pod:4317
29252 #, no-wrap
29253 msgid ""
29254 " txz-in (tarball|-) directory\n"
29255 "\n"
29256 msgstr ""
29257
29258 # type: =head2
29259 #. type: =head2
29260 #: ../fish/guestfish-actions.pod:4324
29261 msgid "txz-out"
29262 msgstr ""
29263
29264 # type: verbatim
29265 #. type: verbatim
29266 #: ../fish/guestfish-actions.pod:4326
29267 #, no-wrap
29268 msgid ""
29269 " txz-out directory (tarball|-)\n"
29270 "\n"
29271 msgstr ""
29272
29273 # type: =head2
29274 #. type: =head2
29275 #: ../fish/guestfish-actions.pod:4333
29276 msgid "umask"
29277 msgstr ""
29278
29279 # type: verbatim
29280 #. type: verbatim
29281 #: ../fish/guestfish-actions.pod:4335
29282 #, no-wrap
29283 msgid ""
29284 " umask mask\n"
29285 "\n"
29286 msgstr ""
29287
29288 # type: textblock
29289 #. type: textblock
29290 #: ../fish/guestfish-actions.pod:4349
29291 msgid "See also L</get-umask>, L<umask(2)>, L</mknod>, L</mkdir>."
29292 msgstr ""
29293
29294 # type: =head2
29295 #. type: =head2
29296 #: ../fish/guestfish-actions.pod:4354
29297 msgid "umount"
29298 msgstr ""
29299
29300 # type: =head2
29301 #. type: =head2
29302 #: ../fish/guestfish-actions.pod:4356
29303 msgid "unmount"
29304 msgstr ""
29305
29306 # type: verbatim
29307 #. type: verbatim
29308 #: ../fish/guestfish-actions.pod:4358
29309 #, no-wrap
29310 msgid ""
29311 " umount pathordevice\n"
29312 "\n"
29313 msgstr ""
29314
29315 # type: =head2
29316 #. type: =head2
29317 #: ../fish/guestfish-actions.pod:4364
29318 msgid "umount-all"
29319 msgstr ""
29320
29321 # type: =head2
29322 #. type: =head2
29323 #: ../fish/guestfish-actions.pod:4366
29324 msgid "unmount-all"
29325 msgstr ""
29326
29327 # type: verbatim
29328 #. type: verbatim
29329 #: ../fish/guestfish-actions.pod:4368
29330 #, no-wrap
29331 msgid ""
29332 " umount-all\n"
29333 "\n"
29334 msgstr ""
29335
29336 # type: =head2
29337 #. type: =head2
29338 #: ../fish/guestfish-actions.pod:4374
29339 msgid "upload"
29340 msgstr ""
29341
29342 # type: verbatim
29343 #. type: verbatim
29344 #: ../fish/guestfish-actions.pod:4376
29345 #, no-wrap
29346 msgid ""
29347 " upload (filename|-) remotefilename\n"
29348 "\n"
29349 msgstr ""
29350
29351 # type: textblock
29352 #. type: textblock
29353 #: ../fish/guestfish-actions.pod:4383
29354 msgid "See also L</download>."
29355 msgstr ""
29356
29357 # type: =head2
29358 #. type: =head2
29359 #: ../fish/guestfish-actions.pod:4387
29360 msgid "upload-offset"
29361 msgstr ""
29362
29363 # type: verbatim
29364 #. type: verbatim
29365 #: ../fish/guestfish-actions.pod:4389
29366 #, no-wrap
29367 msgid ""
29368 " upload-offset (filename|-) remotefilename offset\n"
29369 "\n"
29370 msgstr ""
29371
29372 # type: textblock
29373 #. type: textblock
29374 #: ../fish/guestfish-actions.pod:4401
29375 msgid ""
29376 "Note that there is no limit on the amount of data that can be uploaded with "
29377 "this call, unlike with L</pwrite>, and this call always writes the full "
29378 "amount unless an error occurs."
29379 msgstr ""
29380
29381 # type: textblock
29382 #. type: textblock
29383 #: ../fish/guestfish-actions.pod:4406
29384 msgid "See also L</upload>, L</pwrite>."
29385 msgstr ""
29386
29387 # type: =head2
29388 #. type: =head2
29389 #: ../fish/guestfish-actions.pod:4410
29390 msgid "utimens"
29391 msgstr ""
29392
29393 # type: verbatim
29394 #. type: verbatim
29395 #: ../fish/guestfish-actions.pod:4412
29396 #, no-wrap
29397 msgid ""
29398 " utimens path atsecs atnsecs mtsecs mtnsecs\n"
29399 "\n"
29400 msgstr ""
29401
29402 # type: =head2
29403 #. type: =head2
29404 #: ../fish/guestfish-actions.pod:4431
29405 msgid "version"
29406 msgstr ""
29407
29408 # type: verbatim
29409 #. type: verbatim
29410 #: ../fish/guestfish-actions.pod:4433
29411 #, no-wrap
29412 msgid ""
29413 " version\n"
29414 "\n"
29415 msgstr ""
29416
29417 # type: textblock
29418 #. type: textblock
29419 #: ../fish/guestfish-actions.pod:4460
29420 msgid ""
29421 "I<Note:> Don't use this call to test for availability of features.  In "
29422 "enterprise distributions we backport features from later versions into "
29423 "earlier versions, making this an unreliable way to test for features.  Use "
29424 "L</available> instead."
29425 msgstr ""
29426
29427 # type: =head2
29428 #. type: =head2
29429 #: ../fish/guestfish-actions.pod:4466
29430 msgid "vfs-label"
29431 msgstr ""
29432
29433 # type: verbatim
29434 #. type: verbatim
29435 #: ../fish/guestfish-actions.pod:4468
29436 #, no-wrap
29437 msgid ""
29438 " vfs-label device\n"
29439 "\n"
29440 msgstr ""
29441
29442 # type: textblock
29443 #. type: textblock
29444 #: ../fish/guestfish-actions.pod:4475
29445 msgid "To find a filesystem from the label, use L</findfs-label>."
29446 msgstr ""
29447
29448 # type: =head2
29449 #. type: =head2
29450 #: ../fish/guestfish-actions.pod:4477
29451 msgid "vfs-type"
29452 msgstr ""
29453
29454 # type: verbatim
29455 #. type: verbatim
29456 #: ../fish/guestfish-actions.pod:4479
29457 #, no-wrap
29458 msgid ""
29459 " vfs-type device\n"
29460 "\n"
29461 msgstr ""
29462
29463 # type: =head2
29464 #. type: =head2
29465 #: ../fish/guestfish-actions.pod:4489
29466 msgid "vfs-uuid"
29467 msgstr ""
29468
29469 # type: verbatim
29470 #. type: verbatim
29471 #: ../fish/guestfish-actions.pod:4491
29472 #, no-wrap
29473 msgid ""
29474 " vfs-uuid device\n"
29475 "\n"
29476 msgstr ""
29477
29478 # type: textblock
29479 #. type: textblock
29480 #: ../fish/guestfish-actions.pod:4498
29481 msgid "To find a filesystem from the UUID, use L</findfs-uuid>."
29482 msgstr ""
29483
29484 # type: =head2
29485 #. type: =head2
29486 #: ../fish/guestfish-actions.pod:4500
29487 msgid "vg-activate"
29488 msgstr ""
29489
29490 # type: verbatim
29491 #. type: verbatim
29492 #: ../fish/guestfish-actions.pod:4502
29493 #, no-wrap
29494 msgid ""
29495 " vg-activate true|false 'volgroups ...'\n"
29496 "\n"
29497 msgstr ""
29498
29499 # type: =head2
29500 #. type: =head2
29501 #: ../fish/guestfish-actions.pod:4515
29502 msgid "vg-activate-all"
29503 msgstr ""
29504
29505 # type: verbatim
29506 #. type: verbatim
29507 #: ../fish/guestfish-actions.pod:4517
29508 #, no-wrap
29509 msgid ""
29510 " vg-activate-all true|false\n"
29511 "\n"
29512 msgstr ""
29513
29514 # type: =head2
29515 #. type: =head2
29516 #: ../fish/guestfish-actions.pod:4527
29517 msgid "vgcreate"
29518 msgstr ""
29519
29520 # type: verbatim
29521 #. type: verbatim
29522 #: ../fish/guestfish-actions.pod:4529
29523 #, no-wrap
29524 msgid ""
29525 " vgcreate volgroup 'physvols ...'\n"
29526 "\n"
29527 msgstr ""
29528
29529 # type: =head2
29530 #. type: =head2
29531 #: ../fish/guestfish-actions.pod:4534
29532 msgid "vglvuuids"
29533 msgstr ""
29534
29535 # type: verbatim
29536 #. type: verbatim
29537 #: ../fish/guestfish-actions.pod:4536
29538 #, no-wrap
29539 msgid ""
29540 " vglvuuids vgname\n"
29541 "\n"
29542 msgstr ""
29543
29544 # type: textblock
29545 #. type: textblock
29546 #: ../fish/guestfish-actions.pod:4541
29547 msgid ""
29548 "You can use this along with L</lvs> and L</lvuuid> calls to associate "
29549 "logical volumes and volume groups."
29550 msgstr ""
29551
29552 # type: textblock
29553 #. type: textblock
29554 #: ../fish/guestfish-actions.pod:4544
29555 msgid "See also L</vgpvuuids>."
29556 msgstr ""
29557
29558 # type: =head2
29559 #. type: =head2
29560 #: ../fish/guestfish-actions.pod:4546
29561 msgid "vgpvuuids"
29562 msgstr ""
29563
29564 # type: verbatim
29565 #. type: verbatim
29566 #: ../fish/guestfish-actions.pod:4548
29567 #, no-wrap
29568 msgid ""
29569 " vgpvuuids vgname\n"
29570 "\n"
29571 msgstr ""
29572
29573 # type: textblock
29574 #. type: textblock
29575 #: ../fish/guestfish-actions.pod:4553
29576 msgid ""
29577 "You can use this along with L</pvs> and L</pvuuid> calls to associate "
29578 "physical volumes and volume groups."
29579 msgstr ""
29580
29581 # type: textblock
29582 #. type: textblock
29583 #: ../fish/guestfish-actions.pod:4556
29584 msgid "See also L</vglvuuids>."
29585 msgstr ""
29586
29587 # type: =head2
29588 #. type: =head2
29589 #: ../fish/guestfish-actions.pod:4558
29590 msgid "vgremove"
29591 msgstr ""
29592
29593 # type: verbatim
29594 #. type: verbatim
29595 #: ../fish/guestfish-actions.pod:4560
29596 #, no-wrap
29597 msgid ""
29598 " vgremove vgname\n"
29599 "\n"
29600 msgstr ""
29601
29602 # type: =head2
29603 #. type: =head2
29604 #: ../fish/guestfish-actions.pod:4567
29605 msgid "vgrename"
29606 msgstr ""
29607
29608 # type: verbatim
29609 #. type: verbatim
29610 #: ../fish/guestfish-actions.pod:4569
29611 #, no-wrap
29612 msgid ""
29613 " vgrename volgroup newvolgroup\n"
29614 "\n"
29615 msgstr ""
29616
29617 # type: =head2
29618 #. type: =head2
29619 #: ../fish/guestfish-actions.pod:4573
29620 msgid "vgs"
29621 msgstr ""
29622
29623 # type: verbatim
29624 #. type: verbatim
29625 #: ../fish/guestfish-actions.pod:4575
29626 #, no-wrap
29627 msgid ""
29628 " vgs\n"
29629 "\n"
29630 msgstr ""
29631
29632 # type: textblock
29633 #. type: textblock
29634 #: ../fish/guestfish-actions.pod:4583
29635 msgid "See also L</vgs-full>."
29636 msgstr ""
29637
29638 # type: =head2
29639 #. type: =head2
29640 #: ../fish/guestfish-actions.pod:4585
29641 msgid "vgs-full"
29642 msgstr ""
29643
29644 # type: verbatim
29645 #. type: verbatim
29646 #: ../fish/guestfish-actions.pod:4587
29647 #, no-wrap
29648 msgid ""
29649 " vgs-full\n"
29650 "\n"
29651 msgstr ""
29652
29653 # type: =head2
29654 #. type: =head2
29655 #: ../fish/guestfish-actions.pod:4592
29656 msgid "vgscan"
29657 msgstr ""
29658
29659 # type: verbatim
29660 #. type: verbatim
29661 #: ../fish/guestfish-actions.pod:4594
29662 #, no-wrap
29663 msgid ""
29664 " vgscan\n"
29665 "\n"
29666 msgstr ""
29667
29668 # type: =head2
29669 #. type: =head2
29670 #: ../fish/guestfish-actions.pod:4599
29671 msgid "vguuid"
29672 msgstr ""
29673
29674 # type: verbatim
29675 #. type: verbatim
29676 #: ../fish/guestfish-actions.pod:4601
29677 #, no-wrap
29678 msgid ""
29679 " vguuid vgname\n"
29680 "\n"
29681 msgstr ""
29682
29683 # type: =head2
29684 #. type: =head2
29685 #: ../fish/guestfish-actions.pod:4605
29686 msgid "wc-c"
29687 msgstr ""
29688
29689 # type: verbatim
29690 #. type: verbatim
29691 #: ../fish/guestfish-actions.pod:4607
29692 #, no-wrap
29693 msgid ""
29694 " wc-c path\n"
29695 "\n"
29696 msgstr ""
29697
29698 # type: =head2
29699 #. type: =head2
29700 #: ../fish/guestfish-actions.pod:4612
29701 msgid "wc-l"
29702 msgstr ""
29703
29704 # type: verbatim
29705 #. type: verbatim
29706 #: ../fish/guestfish-actions.pod:4614
29707 #, no-wrap
29708 msgid ""
29709 " wc-l path\n"
29710 "\n"
29711 msgstr ""
29712
29713 # type: =head2
29714 #. type: =head2
29715 #: ../fish/guestfish-actions.pod:4619
29716 msgid "wc-w"
29717 msgstr ""
29718
29719 # type: verbatim
29720 #. type: verbatim
29721 #: ../fish/guestfish-actions.pod:4621
29722 #, no-wrap
29723 msgid ""
29724 " wc-w path\n"
29725 "\n"
29726 msgstr ""
29727
29728 # type: =head2
29729 #. type: =head2
29730 #: ../fish/guestfish-actions.pod:4626
29731 msgid "write"
29732 msgstr ""
29733
29734 # type: verbatim
29735 #. type: verbatim
29736 #: ../fish/guestfish-actions.pod:4628
29737 #, no-wrap
29738 msgid ""
29739 " write path content\n"
29740 "\n"
29741 msgstr ""
29742
29743 # type: =head2
29744 #. type: =head2
29745 #: ../fish/guestfish-actions.pod:4636
29746 msgid "write-file"
29747 msgstr ""
29748
29749 # type: verbatim
29750 #. type: verbatim
29751 #: ../fish/guestfish-actions.pod:4638
29752 #, no-wrap
29753 msgid ""
29754 " write-file path content size\n"
29755 "\n"
29756 msgstr ""
29757
29758 #. type: textblock
29759 #: ../fish/guestfish-actions.pod:4654
29760 msgid ""
29761 "This function is deprecated.  In new code, use the L</write> call instead."
29762 msgstr ""
29763
29764 # type: =head2
29765 #. type: =head2
29766 #: ../fish/guestfish-actions.pod:4661
29767 msgid "zegrep"
29768 msgstr ""
29769
29770 # type: verbatim
29771 #. type: verbatim
29772 #: ../fish/guestfish-actions.pod:4663
29773 #, no-wrap
29774 msgid ""
29775 " zegrep regex path\n"
29776 "\n"
29777 msgstr ""
29778
29779 # type: =head2
29780 #. type: =head2
29781 #: ../fish/guestfish-actions.pod:4671
29782 msgid "zegrepi"
29783 msgstr ""
29784
29785 # type: verbatim
29786 #. type: verbatim
29787 #: ../fish/guestfish-actions.pod:4673
29788 #, no-wrap
29789 msgid ""
29790 " zegrepi regex path\n"
29791 "\n"
29792 msgstr ""
29793
29794 # type: =head2
29795 #. type: =head2
29796 #: ../fish/guestfish-actions.pod:4681
29797 msgid "zero"
29798 msgstr ""
29799
29800 # type: verbatim
29801 #. type: verbatim
29802 #: ../fish/guestfish-actions.pod:4683
29803 #, no-wrap
29804 msgid ""
29805 " zero device\n"
29806 "\n"
29807 msgstr ""
29808
29809 # type: textblock
29810 #. type: textblock
29811 #: ../fish/guestfish-actions.pod:4691
29812 msgid "See also: L</zero-device>, L</scrub-device>."
29813 msgstr ""
29814
29815 # type: =head2
29816 #. type: =head2
29817 #: ../fish/guestfish-actions.pod:4693
29818 msgid "zero-device"
29819 msgstr ""
29820
29821 # type: verbatim
29822 #. type: verbatim
29823 #: ../fish/guestfish-actions.pod:4695
29824 #, no-wrap
29825 msgid ""
29826 " zero-device device\n"
29827 "\n"
29828 msgstr ""
29829
29830 # type: textblock
29831 #. type: textblock
29832 #: ../fish/guestfish-actions.pod:4697
29833 msgid ""
29834 "This command writes zeroes over the entire C<device>.  Compare with L</zero> "
29835 "which just zeroes the first few blocks of a device."
29836 msgstr ""
29837
29838 # type: =head2
29839 #. type: =head2
29840 #: ../fish/guestfish-actions.pod:4704
29841 msgid "zerofree"
29842 msgstr ""
29843
29844 # type: verbatim
29845 #. type: verbatim
29846 #: ../fish/guestfish-actions.pod:4706
29847 #, no-wrap
29848 msgid ""
29849 " zerofree device\n"
29850 "\n"
29851 msgstr ""
29852
29853 # type: =head2
29854 #. type: =head2
29855 #: ../fish/guestfish-actions.pod:4719
29856 msgid "zfgrep"
29857 msgstr ""
29858
29859 # type: verbatim
29860 #. type: verbatim
29861 #: ../fish/guestfish-actions.pod:4721
29862 #, no-wrap
29863 msgid ""
29864 " zfgrep pattern path\n"
29865 "\n"
29866 msgstr ""
29867
29868 # type: =head2
29869 #. type: =head2
29870 #: ../fish/guestfish-actions.pod:4729
29871 msgid "zfgrepi"
29872 msgstr ""
29873
29874 # type: verbatim
29875 #. type: verbatim
29876 #: ../fish/guestfish-actions.pod:4731
29877 #, no-wrap
29878 msgid ""
29879 " zfgrepi pattern path\n"
29880 "\n"
29881 msgstr ""
29882
29883 # type: =head2
29884 #. type: =head2
29885 #: ../fish/guestfish-actions.pod:4739
29886 msgid "zfile"
29887 msgstr ""
29888
29889 # type: verbatim
29890 #. type: verbatim
29891 #: ../fish/guestfish-actions.pod:4741
29892 #, no-wrap
29893 msgid ""
29894 " zfile meth path\n"
29895 "\n"
29896 msgstr ""
29897
29898 # type: textblock
29899 #. type: textblock
29900 #: ../fish/guestfish-actions.pod:4748
29901 msgid ""
29902 "Since 1.0.63, use L</file> instead which can now process compressed files."
29903 msgstr ""
29904
29905 #. type: textblock
29906 #: ../fish/guestfish-actions.pod:4751
29907 msgid ""
29908 "This function is deprecated.  In new code, use the L</file> call instead."
29909 msgstr ""
29910
29911 # type: =head2
29912 #. type: =head2
29913 #: ../fish/guestfish-actions.pod:4758
29914 msgid "zgrep"
29915 msgstr ""
29916
29917 # type: verbatim
29918 #. type: verbatim
29919 #: ../fish/guestfish-actions.pod:4760
29920 #, no-wrap
29921 msgid ""
29922 " zgrep regex path\n"
29923 "\n"
29924 msgstr ""
29925
29926 # type: =head2
29927 #. type: =head2
29928 #: ../fish/guestfish-actions.pod:4768
29929 msgid "zgrepi"
29930 msgstr ""
29931
29932 # type: verbatim
29933 #. type: verbatim
29934 #: ../fish/guestfish-actions.pod:4770
29935 #, no-wrap
29936 msgid ""
29937 " zgrepi regex path\n"
29938 "\n"
29939 msgstr ""
29940
29941 # type: =head2
29942 #. type: =head2
29943 #: ../fish/guestfish-commands.pod:1
29944 msgid "alloc"
29945 msgstr ""
29946
29947 # type: =head2
29948 #. type: =head2
29949 #: ../fish/guestfish-commands.pod:3
29950 msgid "allocate"
29951 msgstr ""
29952
29953 # type: verbatim
29954 #. type: verbatim
29955 #: ../fish/guestfish-commands.pod:5
29956 #, no-wrap
29957 msgid ""
29958 " alloc filename size\n"
29959 "\n"
29960 msgstr ""
29961
29962 # type: textblock
29963 #. type: textblock
29964 #: ../fish/guestfish-commands.pod:7
29965 msgid ""
29966 "This creates an empty (zeroed) file of the given size, and then adds so it "
29967 "can be further examined."
29968 msgstr ""
29969
29970 # type: textblock
29971 #. type: textblock
29972 #: ../fish/guestfish-commands.pod:10 ../fish/guestfish-commands.pod:168
29973 msgid "For more advanced image creation, see L<qemu-img(1)> utility."
29974 msgstr ""
29975
29976 # type: textblock
29977 #. type: textblock
29978 #: ../fish/guestfish-commands.pod:12 ../fish/guestfish-commands.pod:170
29979 msgid "Size can be specified using standard suffixes, eg. C<1M>."
29980 msgstr ""
29981
29982 # type: textblock
29983 #. type: textblock
29984 #: ../fish/guestfish-commands.pod:14
29985 msgid ""
29986 "To create a sparse file, use L</sparse> instead.  To create a prepared disk "
29987 "image, see L</PREPARED DISK IMAGES>."
29988 msgstr ""
29989
29990 # type: =head2
29991 #. type: =head2
29992 #: ../fish/guestfish-commands.pod:17
29993 msgid "copy-in"
29994 msgstr ""
29995
29996 # type: verbatim
29997 #. type: verbatim
29998 #: ../fish/guestfish-commands.pod:19
29999 #, no-wrap
30000 msgid ""
30001 " copy-in local [local ...] /remotedir\n"
30002 "\n"
30003 msgstr ""
30004
30005 # type: textblock
30006 #. type: textblock
30007 #: ../fish/guestfish-commands.pod:21
30008 msgid ""
30009 "C<copy-in> copies local files or directories recursively into the disk "
30010 "image, placing them in the directory called C</remotedir> (which must "
30011 "exist).  This guestfish meta-command turns into a sequence of L</tar-in> and "
30012 "other commands as necessary."
30013 msgstr ""
30014
30015 # type: textblock
30016 #. type: textblock
30017 #: ../fish/guestfish-commands.pod:26
30018 msgid ""
30019 "Multiple local files and directories can be specified, but the last "
30020 "parameter must always be a remote directory.  Wildcards cannot be used."
30021 msgstr ""
30022
30023 # type: =head2
30024 #. type: =head2
30025 #: ../fish/guestfish-commands.pod:30
30026 msgid "copy-out"
30027 msgstr ""
30028
30029 # type: verbatim
30030 #. type: verbatim
30031 #: ../fish/guestfish-commands.pod:32
30032 #, no-wrap
30033 msgid ""
30034 " copy-out remote [remote ...] localdir\n"
30035 "\n"
30036 msgstr ""
30037
30038 # type: textblock
30039 #. type: textblock
30040 #: ../fish/guestfish-commands.pod:34
30041 msgid ""
30042 "C<copy-out> copies remote files or directories recursively out of the disk "
30043 "image, placing them on the host disk in a local directory called C<localdir> "
30044 "(which must exist).  This guestfish meta-command turns into a sequence of L</"
30045 "download>, L</tar-out> and other commands as necessary."
30046 msgstr ""
30047
30048 # type: textblock
30049 #. type: textblock
30050 #: ../fish/guestfish-commands.pod:40
30051 msgid ""
30052 "Multiple remote files and directories can be specified, but the last "
30053 "parameter must always be a local directory.  To download to the current "
30054 "directory, use C<.> as in:"
30055 msgstr ""
30056
30057 # type: verbatim
30058 #. type: verbatim
30059 #: ../fish/guestfish-commands.pod:44
30060 #, no-wrap
30061 msgid ""
30062 " copy-out /home .\n"
30063 "\n"
30064 msgstr ""
30065
30066 # type: textblock
30067 #. type: textblock
30068 #: ../fish/guestfish-commands.pod:46
30069 msgid ""
30070 "Wildcards cannot be used in the ordinary command, but you can use them with "
30071 "the help of L</glob> like this:"
30072 msgstr ""
30073
30074 # type: verbatim
30075 #. type: verbatim
30076 #: ../fish/guestfish-commands.pod:49
30077 #, no-wrap
30078 msgid ""
30079 " glob copy-out /home/* .\n"
30080 "\n"
30081 msgstr ""
30082
30083 # type: =head2
30084 #. type: =head2
30085 #: ../fish/guestfish-commands.pod:51
30086 msgid "echo"
30087 msgstr ""
30088
30089 # type: verbatim
30090 #. type: verbatim
30091 #: ../fish/guestfish-commands.pod:53
30092 #, no-wrap
30093 msgid ""
30094 " echo [params ...]\n"
30095 "\n"
30096 msgstr ""
30097
30098 # type: textblock
30099 #. type: textblock
30100 #: ../fish/guestfish-commands.pod:55
30101 msgid "This echos the parameters to the terminal."
30102 msgstr ""
30103
30104 # type: =head2
30105 #. type: =head2
30106 #: ../fish/guestfish-commands.pod:57
30107 msgid "edit"
30108 msgstr ""
30109
30110 # type: =head2
30111 #. type: =head2
30112 #: ../fish/guestfish-commands.pod:59
30113 msgid "vi"
30114 msgstr ""
30115
30116 # type: =head2
30117 #. type: =head2
30118 #: ../fish/guestfish-commands.pod:61
30119 msgid "emacs"
30120 msgstr ""
30121
30122 # type: verbatim
30123 #. type: verbatim
30124 #: ../fish/guestfish-commands.pod:63
30125 #, no-wrap
30126 msgid ""
30127 " edit filename\n"
30128 "\n"
30129 msgstr ""
30130
30131 # type: textblock
30132 #. type: textblock
30133 #: ../fish/guestfish-commands.pod:65
30134 msgid ""
30135 "This is used to edit a file.  It downloads the file, edits it locally using "
30136 "your editor, then uploads the result."
30137 msgstr ""
30138
30139 # type: textblock
30140 #. type: textblock
30141 #: ../fish/guestfish-commands.pod:68
30142 msgid ""
30143 "The editor is C<$EDITOR>.  However if you use the alternate commands C<vi> "
30144 "or C<emacs> you will get those corresponding editors."
30145 msgstr ""
30146
30147 # type: =head2
30148 #. type: =head2
30149 #: ../fish/guestfish-commands.pod:72
30150 msgid "glob"
30151 msgstr ""
30152
30153 # type: verbatim
30154 #. type: verbatim
30155 #: ../fish/guestfish-commands.pod:74
30156 #, no-wrap
30157 msgid ""
30158 " glob command args...\n"
30159 "\n"
30160 msgstr ""
30161
30162 # type: textblock
30163 #. type: textblock
30164 #: ../fish/guestfish-commands.pod:76
30165 msgid ""
30166 "Expand wildcards in any paths in the args list, and run C<command> "
30167 "repeatedly on each matching path."
30168 msgstr ""
30169
30170 # type: textblock
30171 #. type: textblock
30172 #: ../fish/guestfish-commands.pod:79
30173 msgid "See L</WILDCARDS AND GLOBBING>."
30174 msgstr ""
30175
30176 # type: =head2
30177 #. type: =head2
30178 #: ../fish/guestfish-commands.pod:81
30179 msgid "hexedit"
30180 msgstr ""
30181
30182 # type: verbatim
30183 #. type: verbatim
30184 #: ../fish/guestfish-commands.pod:83
30185 #, no-wrap
30186 msgid ""
30187 " hexedit <filename|device>\n"
30188 " hexedit <filename|device> <max>\n"
30189 " hexedit <filename|device> <start> <max>\n"
30190 "\n"
30191 msgstr ""
30192
30193 # type: textblock
30194 #. type: textblock
30195 #: ../fish/guestfish-commands.pod:87
30196 msgid ""
30197 "Use hexedit (a hex editor) to edit all or part of a binary file or block "
30198 "device."
30199 msgstr ""
30200
30201 # type: textblock
30202 #. type: textblock
30203 #: ../fish/guestfish-commands.pod:90
30204 msgid ""
30205 "This command works by downloading potentially the whole file or device, "
30206 "editing it locally, then uploading it.  If the file or device is large, you "
30207 "have to specify which part you wish to edit by using C<max> and/or C<start> "
30208 "C<max> parameters.  C<start> and C<max> are specified in bytes, with the "
30209 "usual modifiers allowed such as C<1M> (1 megabyte)."
30210 msgstr ""
30211
30212 # type: textblock
30213 #. type: textblock
30214 #: ../fish/guestfish-commands.pod:97
30215 msgid "For example to edit the first few sectors of a disk you might do:"
30216 msgstr ""
30217
30218 # type: verbatim
30219 #. type: verbatim
30220 #: ../fish/guestfish-commands.pod:100
30221 #, no-wrap
30222 msgid ""
30223 " hexedit /dev/sda 1M\n"
30224 "\n"
30225 msgstr ""
30226
30227 # type: textblock
30228 #. type: textblock
30229 #: ../fish/guestfish-commands.pod:102
30230 msgid ""
30231 "which would allow you to edit anywhere within the first megabyte of the disk."
30232 msgstr ""
30233
30234 # type: textblock
30235 #. type: textblock
30236 #: ../fish/guestfish-commands.pod:105
30237 msgid "To edit the superblock of an ext2 filesystem on C</dev/sda1>, do:"
30238 msgstr ""
30239
30240 # type: verbatim
30241 #. type: verbatim
30242 #: ../fish/guestfish-commands.pod:107
30243 #, no-wrap
30244 msgid ""
30245 " hexedit /dev/sda1 0x400 0x400\n"
30246 "\n"
30247 msgstr ""
30248
30249 # type: textblock
30250 #. type: textblock
30251 #: ../fish/guestfish-commands.pod:109
30252 msgid "(assuming the superblock is in the standard location)."
30253 msgstr ""
30254
30255 # type: textblock
30256 #. type: textblock
30257 #: ../fish/guestfish-commands.pod:111
30258 msgid ""
30259 "This command requires the external L<hexedit(1)> program.  You can specify "
30260 "another program to use by setting the C<HEXEDITOR> environment variable."
30261 msgstr ""
30262
30263 # type: textblock
30264 #. type: textblock
30265 #: ../fish/guestfish-commands.pod:115
30266 msgid "See also L</hexdump>."
30267 msgstr ""
30268
30269 # type: =head2
30270 #. type: =head2
30271 #: ../fish/guestfish-commands.pod:117
30272 msgid "lcd"
30273 msgstr ""
30274
30275 # type: verbatim
30276 #. type: verbatim
30277 #: ../fish/guestfish-commands.pod:119
30278 #, no-wrap
30279 msgid ""
30280 " lcd directory\n"
30281 "\n"
30282 msgstr ""
30283
30284 # type: textblock
30285 #. type: textblock
30286 #: ../fish/guestfish-commands.pod:121
30287 msgid ""
30288 "Change the local directory, ie. the current directory of guestfish itself."
30289 msgstr ""
30290
30291 # type: textblock
30292 #. type: textblock
30293 #: ../fish/guestfish-commands.pod:124
30294 msgid "Note that C<!cd> won't do what you might expect."
30295 msgstr ""
30296
30297 # type: =head2
30298 #. type: =head2
30299 #: ../fish/guestfish-commands.pod:126
30300 msgid "man"
30301 msgstr ""
30302
30303 # type: =head2
30304 #. type: =head2
30305 #: ../fish/guestfish-commands.pod:128
30306 msgid "manual"
30307 msgstr ""
30308
30309 # type: verbatim
30310 #. type: verbatim
30311 #: ../fish/guestfish-commands.pod:130
30312 #, no-wrap
30313 msgid ""
30314 "  man\n"
30315 "\n"
30316 msgstr ""
30317
30318 # type: textblock
30319 #. type: textblock
30320 #: ../fish/guestfish-commands.pod:132
30321 msgid "Opens the manual page for guestfish."
30322 msgstr ""
30323
30324 # type: =head2
30325 #. type: =head2
30326 #: ../fish/guestfish-commands.pod:134
30327 msgid "more"
30328 msgstr ""
30329
30330 # type: =head2
30331 #. type: =head2
30332 #: ../fish/guestfish-commands.pod:136
30333 msgid "less"
30334 msgstr ""
30335
30336 # type: verbatim
30337 #. type: verbatim
30338 #: ../fish/guestfish-commands.pod:138
30339 #, no-wrap
30340 msgid ""
30341 " more filename\n"
30342 "\n"
30343 msgstr ""
30344
30345 # type: verbatim
30346 #. type: verbatim
30347 #: ../fish/guestfish-commands.pod:140
30348 #, no-wrap
30349 msgid ""
30350 " less filename\n"
30351 "\n"
30352 msgstr ""
30353
30354 # type: textblock
30355 #. type: textblock
30356 #: ../fish/guestfish-commands.pod:142
30357 msgid "This is used to view a file."
30358 msgstr ""
30359
30360 # type: textblock
30361 #. type: textblock
30362 #: ../fish/guestfish-commands.pod:144
30363 msgid ""
30364 "The default viewer is C<$PAGER>.  However if you use the alternate command "
30365 "C<less> you will get the C<less> command specifically."
30366 msgstr ""
30367
30368 # type: =head2
30369 #. type: =head2
30370 #: ../fish/guestfish-commands.pod:147
30371 msgid "reopen"
30372 msgstr ""
30373
30374 # type: verbatim
30375 #. type: verbatim
30376 #: ../fish/guestfish-commands.pod:149
30377 #, no-wrap
30378 msgid ""
30379 "  reopen\n"
30380 "\n"
30381 msgstr ""
30382
30383 # type: textblock
30384 #. type: textblock
30385 #: ../fish/guestfish-commands.pod:151
30386 msgid ""
30387 "Close and reopen the libguestfs handle.  It is not necessary to use this "
30388 "normally, because the handle is closed properly when guestfish exits.  "
30389 "However this is occasionally useful for testing."
30390 msgstr ""
30391
30392 # type: =head2
30393 #. type: =head2
30394 #: ../fish/guestfish-commands.pod:155
30395 msgid "sparse"
30396 msgstr ""
30397
30398 # type: verbatim
30399 #. type: verbatim
30400 #: ../fish/guestfish-commands.pod:157
30401 #, no-wrap
30402 msgid ""
30403 " sparse filename size\n"
30404 "\n"
30405 msgstr ""
30406
30407 # type: textblock
30408 #. type: textblock
30409 #: ../fish/guestfish-commands.pod:159
30410 msgid ""
30411 "This creates an empty sparse file of the given size, and then adds so it can "
30412 "be further examined."
30413 msgstr ""
30414
30415 # type: textblock
30416 #. type: textblock
30417 #: ../fish/guestfish-commands.pod:162
30418 msgid ""
30419 "In all respects it works the same as the L</alloc> command, except that the "
30420 "image file is allocated sparsely, which means that disk blocks are not "
30421 "assigned to the file until they are needed.  Sparse disk files only use "
30422 "space when written to, but they are slower and there is a danger you could "
30423 "run out of real disk space during a write operation."
30424 msgstr ""
30425
30426 # type: =head2
30427 #. type: =head2
30428 #: ../fish/guestfish-commands.pod:172
30429 msgid "supported"
30430 msgstr ""
30431
30432 # type: verbatim
30433 #. type: verbatim
30434 #: ../fish/guestfish-commands.pod:174
30435 #, no-wrap
30436 msgid ""
30437 " supported\n"
30438 "\n"
30439 msgstr ""
30440
30441 # type: textblock
30442 #. type: textblock
30443 #: ../fish/guestfish-commands.pod:176
30444 msgid ""
30445 "This command returns a list of the optional groups known to the daemon, and "
30446 "indicates which ones are supported by this build of the libguestfs appliance."
30447 msgstr ""
30448
30449 # type: textblock
30450 #. type: textblock
30451 #: ../fish/guestfish-commands.pod:180
30452 msgid "See also L<guestfs(3)/AVAILABILITY>."
30453 msgstr ""
30454
30455 # type: =head2
30456 #. type: =head2
30457 #: ../fish/guestfish-commands.pod:182
30458 msgid "time"
30459 msgstr ""
30460
30461 # type: verbatim
30462 #. type: verbatim
30463 #: ../fish/guestfish-commands.pod:184
30464 #, no-wrap
30465 msgid ""
30466 " time command args...\n"
30467 "\n"
30468 msgstr ""
30469
30470 # type: textblock
30471 #. type: textblock
30472 #: ../fish/guestfish-commands.pod:186
30473 msgid ""
30474 "Run the command as usual, but print the elapsed time afterwards.  This can "
30475 "be useful for benchmarking operations."
30476 msgstr ""
30477
30478 # type: textblock
30479 #. type: textblock
30480 #: ../test-tool/libguestfs-test-tool.pod:5
30481 msgid "libguestfs-test-tool - End user tests for libguestfs"
30482 msgstr ""
30483
30484 # type: verbatim
30485 #. type: verbatim
30486 #: ../test-tool/libguestfs-test-tool.pod:9
30487 #, no-wrap
30488 msgid ""
30489 " libguestfs-test-tool [--options]\n"
30490 "\n"
30491 msgstr ""
30492
30493 # type: textblock
30494 #. type: textblock
30495 #: ../test-tool/libguestfs-test-tool.pod:13
30496 msgid ""
30497 "libguestfs-test-tool is a test program shipped with libguestfs to end users "
30498 "and developers, to allow them to check basic libguestfs functionality is "
30499 "working.  This is needed because libguestfs occasionally breaks for reasons "
30500 "beyond our control: usually because of changes in the underlying qemu or "
30501 "kernel packages, or the host environment."
30502 msgstr ""
30503
30504 # type: textblock
30505 #. type: textblock
30506 #: ../test-tool/libguestfs-test-tool.pod:20
30507 msgid "If you suspect a problem in libguestfs, then just run:"
30508 msgstr ""
30509
30510 # type: verbatim
30511 #. type: verbatim
30512 #: ../test-tool/libguestfs-test-tool.pod:22
30513 #, no-wrap
30514 msgid ""
30515 " libguestfs-test-tool\n"
30516 "\n"
30517 msgstr ""
30518
30519 # type: textblock
30520 #. type: textblock
30521 #: ../test-tool/libguestfs-test-tool.pod:24
30522 msgid "It will print lots of diagnostic messages."
30523 msgstr ""
30524
30525 # type: textblock
30526 #. type: textblock
30527 #: ../test-tool/libguestfs-test-tool.pod:26
30528 msgid "If it runs to completion successfully, you will see this near the end:"
30529 msgstr ""
30530
30531 # type: verbatim
30532 #. type: verbatim
30533 #: ../test-tool/libguestfs-test-tool.pod:28
30534 #, no-wrap
30535 msgid ""
30536 " ===== TEST FINISHED OK =====\n"
30537 "\n"
30538 msgstr ""
30539
30540 # type: textblock
30541 #. type: textblock
30542 #: ../test-tool/libguestfs-test-tool.pod:30
30543 msgid "and the test tool will exit with code 0."
30544 msgstr ""
30545
30546 # type: textblock
30547 #. type: textblock
30548 #: ../test-tool/libguestfs-test-tool.pod:32
30549 msgid ""
30550 "If it fails (and/or exits with non-zero error code), please paste the "
30551 "B<complete, unedited> output of the test tool into a bug report.  More "
30552 "information about reporting bugs can be found on the L<http://libguestfs.org/"
30553 "> website."
30554 msgstr ""
30555
30556 # type: =item
30557 #. type: =item
30558 #: ../test-tool/libguestfs-test-tool.pod:41
30559 msgid "I<--help>"
30560 msgstr ""
30561
30562 # type: textblock
30563 #. type: textblock
30564 #: ../test-tool/libguestfs-test-tool.pod:43
30565 msgid "Display short usage information and exit."
30566 msgstr ""
30567
30568 # type: =item
30569 #. type: =item
30570 #: ../test-tool/libguestfs-test-tool.pod:45
30571 msgid "I<--helper /path/to/libguestfs-test-tool-helper>"
30572 msgstr ""
30573
30574 # type: textblock
30575 #. type: textblock
30576 #: ../test-tool/libguestfs-test-tool.pod:47
30577 msgid ""
30578 "Pass an alternate name for the helper program.  libguestfs-test-tool will "
30579 "normally look in the C<$libexec> directory that was configured when the tool "
30580 "was built."
30581 msgstr ""
30582
30583 # type: =item
30584 #. type: =item
30585 #: ../test-tool/libguestfs-test-tool.pod:51
30586 msgid "I<--qemu qemu_binary>"
30587 msgstr ""
30588
30589 # type: textblock
30590 #. type: textblock
30591 #: ../test-tool/libguestfs-test-tool.pod:53
30592 msgid ""
30593 "If you have downloaded another qemu binary, point this option at the full "
30594 "path of the binary to try it."
30595 msgstr ""
30596
30597 # type: =item
30598 #. type: =item
30599 #: ../test-tool/libguestfs-test-tool.pod:56
30600 msgid "I<--qemudir qemu_source_dir>"
30601 msgstr ""
30602
30603 # type: textblock
30604 #. type: textblock
30605 #: ../test-tool/libguestfs-test-tool.pod:58
30606 msgid ""
30607 "If you have compiled qemu from source, point this option at the source "
30608 "directory to try it."
30609 msgstr ""
30610
30611 # type: =item
30612 #. type: =item
30613 #: ../test-tool/libguestfs-test-tool.pod:61
30614 msgid "I<--timeout N>"
30615 msgstr ""
30616
30617 # type: textblock
30618 #. type: textblock
30619 #: ../test-tool/libguestfs-test-tool.pod:63
30620 msgid ""
30621 "Set the launch timeout to C<N> seconds.  The default is 120 seconds which "
30622 "does not usually need to be adjusted unless your machine is very slow."
30623 msgstr ""
30624
30625 # type: =head1
30626 #. type: =head1
30627 #: ../test-tool/libguestfs-test-tool.pod:69
30628 msgid "TRYING OUT A DIFFERENT VERSION OF QEMU"
30629 msgstr ""
30630
30631 # type: textblock
30632 #. type: textblock
30633 #: ../test-tool/libguestfs-test-tool.pod:71
30634 msgid ""
30635 "If you have compiled another version of qemu from source and would like to "
30636 "try that, then you can use the I<--qemudir> option to point to the qemu "
30637 "source directory."
30638 msgstr ""
30639
30640 # type: textblock
30641 #. type: textblock
30642 #: ../test-tool/libguestfs-test-tool.pod:75
30643 msgid ""
30644 "If you have downloaded a qemu binary from somewhere, use the I<--qemu> "
30645 "option to point to the binary."
30646 msgstr ""
30647
30648 # type: textblock
30649 #. type: textblock
30650 #: ../test-tool/libguestfs-test-tool.pod:78
30651 msgid ""
30652 "When using an alternate qemu with libguestfs, usually you would need to "
30653 "write a qemu wrapper script (see section I<QEMU WRAPPERS> in L<guestfs(3)"
30654 ">).  libguestfs-test-tool writes a temporary qemu wrapper script when you "
30655 "use either of the I<--qemudir> or I<--qemu> options."
30656 msgstr ""
30657
30658 # type: textblock
30659 #. type: textblock
30660 #: ../test-tool/libguestfs-test-tool.pod:85
30661 msgid ""
30662 "libguestfs-test-tool returns I<0> if the tests completed without error, or "
30663 "I<1> if there was an error."
30664 msgstr ""
30665
30666 # type: =item
30667 #. type: =item
30668 #: ../test-tool/libguestfs-test-tool.pod:92
30669 msgid "/usr/libexec/libguestfs-test-tool-helper"
30670 msgstr ""
30671
30672 # type: textblock
30673 #. type: textblock
30674 #: ../test-tool/libguestfs-test-tool.pod:94
30675 msgid ""
30676 "This helper program is run inside the appliance and provides additional "
30677 "tests."
30678 msgstr ""
30679
30680 # type: =item
30681 #. type: =item
30682 #: ../test-tool/libguestfs-test-tool.pod:97
30683 msgid "/usr/bin/mkisofs"
30684 msgstr ""
30685
30686 # type: textblock
30687 #. type: textblock
30688 #: ../test-tool/libguestfs-test-tool.pod:99
30689 msgid ""
30690 "The C<mkisofs> command is required in order to construct a CD-ROM ISO file "
30691 "which is used as part of the tests."
30692 msgstr ""
30693
30694 # type: textblock
30695 #. type: textblock
30696 #: ../test-tool/libguestfs-test-tool.pod:106
30697 msgid ""
30698 "For the full list of environment variables which may affect libguestfs, "
30699 "please see the L<guestfs(3)> manual page."
30700 msgstr ""
30701
30702 # type: textblock
30703 #. type: textblock
30704 #: ../test-tool/libguestfs-test-tool.pod:111
30705 msgid "L<guestfs(3)>, L<http://libguestfs.org/>, L<http://qemu.org/>."
30706 msgstr ""
30707
30708 # type: textblock
30709 #. type: textblock
30710 #: ../test-tool/libguestfs-test-tool.pod:121
30711 msgid "Copyright (C) 2009 Red Hat Inc.  L<http://libguestfs.org/>"
30712 msgstr ""
30713
30714 # type: textblock
30715 #. type: textblock
30716 #: ../fuse/guestmount.pod:5
30717 msgid ""
30718 "guestmount - Mount a guest filesystem on the host using FUSE and libguestfs"
30719 msgstr ""
30720
30721 # type: verbatim
30722 #. type: verbatim
30723 #: ../fuse/guestmount.pod:9
30724 #, no-wrap
30725 msgid ""
30726 " guestmount [--options] -a disk.img -m device [--ro] mountpoint\n"
30727 "\n"
30728 msgstr ""
30729
30730 # type: verbatim
30731 #. type: verbatim
30732 #: ../fuse/guestmount.pod:11
30733 #, no-wrap
30734 msgid ""
30735 " guestmount [--options] -a disk.img -i [--ro] mountpoint\n"
30736 "\n"
30737 msgstr ""
30738
30739 # type: verbatim
30740 #. type: verbatim
30741 #: ../fuse/guestmount.pod:13
30742 #, no-wrap
30743 msgid ""
30744 " guestmount [--options] -d Guest -i [--ro] mountpoint\n"
30745 "\n"
30746 msgstr ""
30747
30748 # type: textblock
30749 #. type: textblock
30750 #: ../fuse/guestmount.pod:17
30751 msgid ""
30752 "You must I<not> use C<guestmount> in read-write mode on live virtual "
30753 "machines.  If you do this, you risk disk corruption in the VM."
30754 msgstr ""
30755
30756 # type: textblock
30757 #. type: textblock
30758 #: ../fuse/guestmount.pod:22
30759 msgid ""
30760 "The guestmount program can be used to mount virtual machine filesystems and "
30761 "other disk images on the host.  It uses libguestfs for access to the guest "
30762 "filesystem, and FUSE (the \"filesystem in userspace\") to make it appear as "
30763 "a mountable device."
30764 msgstr ""
30765
30766 # type: textblock
30767 #. type: textblock
30768 #: ../fuse/guestmount.pod:27
30769 msgid ""
30770 "Along with other options, you have to give at least one device (I<-a> "
30771 "option) or libvirt domain (I<-d> option), and at least one mountpoint (I<-m> "
30772 "option) or use the I<-i> inspection option.  How this works is better "
30773 "explained in the L<guestfish(1)> manual page, or by looking at the examples "
30774 "below."
30775 msgstr ""
30776
30777 # type: textblock
30778 #. type: textblock
30779 #: ../fuse/guestmount.pod:33
30780 msgid ""
30781 "FUSE lets you mount filesystems as non-root.  The mountpoint must be owned "
30782 "by you, and the filesystem will not be visible to any other users unless you "
30783 "make certain global configuration changes to C</etc/fuse.conf>.  To unmount "
30784 "the filesystem, use the C<fusermount -u> command."
30785 msgstr ""
30786
30787 # type: textblock
30788 #. type: textblock
30789 #: ../fuse/guestmount.pod:41
30790 msgid ""
30791 "For a typical Windows guest which has its main filesystem on the first "
30792 "partition:"
30793 msgstr ""
30794
30795 # type: verbatim
30796 #. type: verbatim
30797 #: ../fuse/guestmount.pod:44
30798 #, no-wrap
30799 msgid ""
30800 " guestmount -a windows.img -m /dev/sda1 --ro /mnt\n"
30801 "\n"
30802 msgstr ""
30803
30804 # type: textblock
30805 #. type: textblock
30806 #: ../fuse/guestmount.pod:46
30807 msgid ""
30808 "For a typical Linux guest which has a /boot filesystem on the first "
30809 "partition, and the root filesystem on a logical volume:"
30810 msgstr ""
30811
30812 # type: verbatim
30813 #. type: verbatim
30814 #: ../fuse/guestmount.pod:49
30815 #, no-wrap
30816 msgid ""
30817 " guestmount -a linux.img -m /dev/VG/LV -m /dev/sda1:/boot --ro /mnt\n"
30818 "\n"
30819 msgstr ""
30820
30821 # type: textblock
30822 #. type: textblock
30823 #: ../fuse/guestmount.pod:51
30824 msgid "To get libguestfs to detect guest mountpoints for you:"
30825 msgstr ""
30826
30827 # type: verbatim
30828 #. type: verbatim
30829 #: ../fuse/guestmount.pod:53
30830 #, no-wrap
30831 msgid ""
30832 " guestmount -a guest.img -i --ro /mnt\n"
30833 "\n"
30834 msgstr ""
30835
30836 # type: textblock
30837 #. type: textblock
30838 #: ../fuse/guestmount.pod:55
30839 msgid "For a libvirt guest called \"Guest\" you could do:"
30840 msgstr ""
30841
30842 # type: verbatim
30843 #. type: verbatim
30844 #: ../fuse/guestmount.pod:57
30845 #, no-wrap
30846 msgid ""
30847 " guestmount -d Guest -i --ro /mnt\n"
30848 "\n"
30849 msgstr ""
30850
30851 # type: textblock
30852 #. type: textblock
30853 #: ../fuse/guestmount.pod:59
30854 msgid ""
30855 "If you don't know what filesystems are contained in a guest or disk image, "
30856 "use L<virt-filesystems(1)> first:"
30857 msgstr ""
30858
30859 # type: verbatim
30860 #. type: verbatim
30861 #: ../fuse/guestmount.pod:62
30862 #, no-wrap
30863 msgid ""
30864 " virt-filesystems MyGuest\n"
30865 "\n"
30866 msgstr ""
30867
30868 # type: textblock
30869 #. type: textblock
30870 #: ../fuse/guestmount.pod:64
30871 msgid ""
30872 "If you want to trace the libguestfs calls but without excessive debugging "
30873 "information, we recommend:"
30874 msgstr ""
30875
30876 # type: verbatim
30877 #. type: verbatim
30878 #: ../fuse/guestmount.pod:67
30879 #, no-wrap
30880 msgid ""
30881 " guestmount [...] --trace /mnt\n"
30882 "\n"
30883 msgstr ""
30884
30885 # type: textblock
30886 #. type: textblock
30887 #: ../fuse/guestmount.pod:69
30888 msgid "If you want to debug the program, we recommend:"
30889 msgstr ""
30890
30891 # type: verbatim
30892 #. type: verbatim
30893 #: ../fuse/guestmount.pod:71
30894 #, no-wrap
30895 msgid ""
30896 " guestmount [...] --trace --verbose /mnt\n"
30897 "\n"
30898 msgstr ""
30899
30900 # type: =item
30901 #. type: =item
30902 #: ../fuse/guestmount.pod:77
30903 msgid "B<-a image> | B<--add image>"
30904 msgstr ""
30905
30906 # type: textblock
30907 #. type: textblock
30908 #: ../fuse/guestmount.pod:79
30909 msgid "Add a block device or virtual machine image."
30910 msgstr ""
30911
30912 # type: =item
30913 #. type: =item
30914 #: ../fuse/guestmount.pod:84
30915 msgid "B<-c URI> | B<--connect URI>"
30916 msgstr ""
30917
30918 # type: =item
30919 #. type: =item
30920 #: ../fuse/guestmount.pod:90
30921 msgid "B<-d libvirt-domain> | B<--domain libvirt-domain>"
30922 msgstr ""
30923
30924 # type: =item
30925 #. type: =item
30926 #: ../fuse/guestmount.pod:96
30927 msgid "B<--dir-cache-timeout N>"
30928 msgstr ""
30929
30930 # type: textblock
30931 #. type: textblock
30932 #: ../fuse/guestmount.pod:98
30933 msgid ""
30934 "Set the readdir cache timeout to I<N> seconds, the default being 60 "
30935 "seconds.  The readdir cache [actually, there are several semi-independent "
30936 "caches] is populated after a readdir(2) call with the stat and extended "
30937 "attributes of the files in the directory, in anticipation that they will be "
30938 "requested soon after."
30939 msgstr ""
30940
30941 # type: textblock
30942 #. type: textblock
30943 #: ../fuse/guestmount.pod:104
30944 msgid ""
30945 "There is also a different attribute cache implemented by FUSE (see the FUSE "
30946 "option I<-o attr_timeout>), but the FUSE cache does not anticipate future "
30947 "requests, only cache existing ones."
30948 msgstr ""
30949
30950 # type: =item
30951 #. type: =item
30952 #: ../fuse/guestmount.pod:115
30953 msgid "B<--format=raw|qcow2|..> | B<--format>"
30954 msgstr ""
30955
30956 # type: textblock
30957 #. type: textblock
30958 #: ../fuse/guestmount.pod:122
30959 msgid ""
30960 "If you have untrusted raw-format guest disk images, you should use this "
30961 "option to specify the disk format.  This avoids a possible security problem "
30962 "with malicious guests (CVE-2010-3851).  See also L<guestfs(3)/"
30963 "guestfs_add_drive_opts>."
30964 msgstr ""
30965
30966 # type: =item
30967 #. type: =item
30968 #: ../fuse/guestmount.pod:127
30969 msgid "B<--fuse-help>"
30970 msgstr ""
30971
30972 # type: textblock
30973 #. type: textblock
30974 #: ../fuse/guestmount.pod:129
30975 msgid "Display help on special FUSE options (see I<-o> below)."
30976 msgstr ""
30977
30978 # type: textblock
30979 #. type: textblock
30980 #: ../fuse/guestmount.pod:133
30981 msgid "Display brief help and exit."
30982 msgstr ""
30983
30984 # type: =item
30985 #. type: =item
30986 #: ../fuse/guestmount.pod:135
30987 msgid "B<-i> | B<--inspector>"
30988 msgstr ""
30989
30990 # type: =item
30991 #. type: =item
30992 #: ../fuse/guestmount.pod:146
30993 msgid "B<-m dev[:mnt]> | B<--mount dev[:mnt]>"
30994 msgstr ""
30995
30996 # type: textblock
30997 #. type: textblock
30998 #: ../fuse/guestmount.pod:148
30999 msgid ""
31000 "Mount the named partition or logical volume on the given mountpoint B<in the "
31001 "guest> (this has nothing to do with mountpoints in the host)."
31002 msgstr ""
31003
31004 # type: textblock
31005 #. type: textblock
31006 #: ../fuse/guestmount.pod:151
31007 msgid ""
31008 "If the mountpoint is omitted, it defaults to C</>.  You have to mount "
31009 "something on C</>."
31010 msgstr ""
31011
31012 # type: =item
31013 #. type: =item
31014 #: ../fuse/guestmount.pod:154
31015 msgid "B<-n> | B<--no-sync>"
31016 msgstr ""
31017
31018 # type: textblock
31019 #. type: textblock
31020 #: ../fuse/guestmount.pod:156
31021 msgid ""
31022 "By default, we attempt to sync the guest disk when the FUSE mountpoint is "
31023 "unmounted.  If you specify this option, then we don't attempt to sync the "
31024 "disk.  See the discussion of autosync in the L<guestfs(3)> manpage."
31025 msgstr ""
31026
31027 # type: =item
31028 #. type: =item
31029 #: ../fuse/guestmount.pod:161
31030 msgid "B<-o option> | B<--option option>"
31031 msgstr ""
31032
31033 # type: textblock
31034 #. type: textblock
31035 #: ../fuse/guestmount.pod:163
31036 msgid "Pass extra options to FUSE."
31037 msgstr ""
31038
31039 # type: textblock
31040 #. type: textblock
31041 #: ../fuse/guestmount.pod:165
31042 msgid ""
31043 "To get a list of all the extra options supported by FUSE, use the command "
31044 "below.  Note that only the FUSE I<-o> options can be passed, and only some "
31045 "of them are a good idea."
31046 msgstr ""
31047
31048 # type: verbatim
31049 #. type: verbatim
31050 #: ../fuse/guestmount.pod:169
31051 #, no-wrap
31052 msgid ""
31053 " guestmount --fuse-help\n"
31054 "\n"
31055 msgstr ""
31056
31057 # type: textblock
31058 #. type: textblock
31059 #: ../fuse/guestmount.pod:171
31060 msgid "Some potentially useful FUSE options:"
31061 msgstr ""
31062
31063 # type: =item
31064 #. type: =item
31065 #: ../fuse/guestmount.pod:175
31066 msgid "B<-o allow_other>"
31067 msgstr ""
31068
31069 # type: textblock
31070 #. type: textblock
31071 #: ../fuse/guestmount.pod:177
31072 msgid "Allow other users to see the filesystem."
31073 msgstr ""
31074
31075 # type: =item
31076 #. type: =item
31077 #: ../fuse/guestmount.pod:179
31078 msgid "B<-o attr_timeout=N>"
31079 msgstr ""
31080
31081 # type: textblock
31082 #. type: textblock
31083 #: ../fuse/guestmount.pod:181
31084 msgid "Enable attribute caching by FUSE, and set the timeout to I<N> seconds."
31085 msgstr ""
31086
31087 # type: =item
31088 #. type: =item
31089 #: ../fuse/guestmount.pod:183
31090 msgid "B<-o kernel_cache>"
31091 msgstr ""
31092
31093 # type: textblock
31094 #. type: textblock
31095 #: ../fuse/guestmount.pod:185
31096 msgid ""
31097 "Allow the kernel to cache files (reduces the number of reads that have to go "
31098 "through the L<guestfs(3)> API).  This is generally a good idea if you can "
31099 "afford the extra memory usage."
31100 msgstr ""
31101
31102 # type: =item
31103 #. type: =item
31104 #: ../fuse/guestmount.pod:189
31105 msgid "B<-o uid=N> B<-o gid=N>"
31106 msgstr ""
31107
31108 # type: textblock
31109 #. type: textblock
31110 #: ../fuse/guestmount.pod:191
31111 msgid ""
31112 "Use these options to map all UIDs and GIDs inside the guest filesystem to "
31113 "the chosen values."
31114 msgstr ""
31115
31116 # type: =item
31117 #. type: =item
31118 #: ../fuse/guestmount.pod:196
31119 msgid "B<-r> | B<--ro>"
31120 msgstr ""
31121
31122 # type: textblock
31123 #. type: textblock
31124 #: ../fuse/guestmount.pod:198
31125 msgid ""
31126 "Add devices and mount everything read-only.  Also disallow writes and make "
31127 "the disk appear read-only to FUSE."
31128 msgstr ""
31129
31130 # type: textblock
31131 #. type: textblock
31132 #: ../fuse/guestmount.pod:201
31133 msgid ""
31134 "This is highly recommended if you are not going to edit the guest disk.  If "
31135 "the guest is running and this option is I<not> supplied, then there is a "
31136 "strong risk of disk corruption in the guest.  We try to prevent this from "
31137 "happening, but it is not always possible."
31138 msgstr ""
31139
31140 # type: textblock
31141 #. type: textblock
31142 #: ../fuse/guestmount.pod:206
31143 msgid "See also L<guestfish(1)/OPENING DISKS FOR READ AND WRITE>."
31144 msgstr ""
31145
31146 # type: textblock
31147 #. type: textblock
31148 #: ../fuse/guestmount.pod:210
31149 msgid "Enable SELinux support for the guest."
31150 msgstr ""
31151
31152 # type: =item
31153 #. type: =item
31154 #: ../fuse/guestmount.pod:212
31155 msgid "B<-v> | B<--verbose>"
31156 msgstr ""
31157
31158 # type: textblock
31159 #. type: textblock
31160 #: ../fuse/guestmount.pod:214
31161 msgid "Enable verbose messages from underlying libguestfs."
31162 msgstr ""
31163
31164 # type: =item
31165 #. type: =item
31166 #: ../fuse/guestmount.pod:216
31167 msgid "B<-V> | B<--version>"
31168 msgstr ""
31169
31170 # type: textblock
31171 #. type: textblock
31172 #: ../fuse/guestmount.pod:218
31173 msgid "Display the program version and exit."
31174 msgstr ""
31175
31176 # type: =item
31177 #. type: =item
31178 #: ../fuse/guestmount.pod:220
31179 msgid "B<-w> | B<--rw>"
31180 msgstr ""
31181
31182 # type: textblock
31183 #. type: textblock
31184 #: ../fuse/guestmount.pod:222
31185 msgid ""
31186 "This option does nothing at the moment.  See L<guestfish(1)/OPENING DISKS "
31187 "FOR READ AND WRITE>."
31188 msgstr ""
31189
31190 # type: =item
31191 #. type: =item
31192 #: ../fuse/guestmount.pod:225
31193 msgid "B<-x> | B<--trace>"
31194 msgstr ""
31195
31196 # type: textblock
31197 #. type: textblock
31198 #: ../fuse/guestmount.pod:227
31199 msgid "Trace libguestfs calls and entry into each FUSE function."
31200 msgstr ""
31201
31202 # type: textblock
31203 #. type: textblock
31204 #: ../fuse/guestmount.pod:229
31205 msgid "This also stops the daemon from forking into the background."
31206 msgstr ""
31207
31208 # type: textblock
31209 #. type: textblock
31210 #: ../fuse/guestmount.pod:235
31211 msgid ""
31212 "L<guestfish(1)>, L<virt-inspector(1)>, L<virt-cat(1)>, L<virt-edit(1)>, "
31213 "L<virt-tar(1)>, L<guestfs(3)>, L<http://libguestfs.org/>, L<http://fuse.sf."
31214 "net/>."
31215 msgstr ""
31216
31217 #. type: textblock
31218 #: ../tools/virt-edit.pl:34
31219 msgid "virt-edit - Edit a file in a virtual machine"
31220 msgstr ""
31221
31222 #. type: verbatim
31223 #: ../tools/virt-edit.pl:38
31224 #, no-wrap
31225 msgid ""
31226 " virt-edit [--options] domname file\n"
31227 "\n"
31228 msgstr ""
31229
31230 #. type: verbatim
31231 #: ../tools/virt-edit.pl:40
31232 #, no-wrap
31233 msgid ""
31234 " virt-edit [--options] disk.img [disk.img ...] file\n"
31235 "\n"
31236 msgstr ""
31237
31238 #. type: verbatim
31239 #: ../tools/virt-edit.pl:42
31240 #, no-wrap
31241 msgid ""
31242 " virt-edit [domname|disk.img] file -e 'expr'\n"
31243 "\n"
31244 msgstr ""
31245
31246 #. type: textblock
31247 #: ../tools/virt-edit.pl:46
31248 msgid ""
31249 "You must I<not> use C<virt-edit> on live virtual machines.  If you do this, "
31250 "you risk disk corruption in the VM.  C<virt-edit> tries to stop you from "
31251 "doing this, but doesn't catch all cases."
31252 msgstr ""
31253
31254 #. type: textblock
31255 #: ../tools/virt-edit.pl:52
31256 msgid ""
31257 "C<virt-edit> is a command line tool to edit C<file> where C<file> exists in "
31258 "the named virtual machine (or disk image)."
31259 msgstr ""
31260
31261 #. type: textblock
31262 #: ../tools/virt-edit.pl:55
31263 msgid "If you want to just view a file, use L<virt-cat(1)>."
31264 msgstr ""
31265
31266 #. type: textblock
31267 #: ../tools/virt-edit.pl:57
31268 msgid ""
31269 "For more complex cases you should look at the L<guestfish(1)> tool (see L</"
31270 "USING GUESTFISH> below)."
31271 msgstr ""
31272
31273 #. type: textblock
31274 #: ../tools/virt-edit.pl:60
31275 msgid ""
31276 "C<virt-edit> cannot be used to create a new file, nor to edit multiple "
31277 "files.  L<guestfish(1)> can do that and much more."
31278 msgstr ""
31279
31280 #. type: textblock
31281 #: ../tools/virt-edit.pl:65
31282 msgid "Edit the named files interactively:"
31283 msgstr ""
31284
31285 #. type: verbatim
31286 #: ../tools/virt-edit.pl:67
31287 #, no-wrap
31288 msgid ""
31289 " virt-edit mydomain /boot/grub/grub.conf\n"
31290 "\n"
31291 msgstr ""
31292
31293 #. type: verbatim
31294 #: ../tools/virt-edit.pl:69
31295 #, no-wrap
31296 msgid ""
31297 " virt-edit mydomain /etc/passwd\n"
31298 "\n"
31299 msgstr ""
31300
31301 #. type: textblock
31302 #: ../tools/virt-edit.pl:71
31303 msgid ""
31304 "You can also edit files non-interactively (see L</NON-INTERACTIVE EDITING> "
31305 "below).  To change the init default level to 5:"
31306 msgstr ""
31307
31308 #. type: verbatim
31309 #: ../tools/virt-edit.pl:75
31310 #, no-wrap
31311 msgid ""
31312 " virt-edit mydomain /etc/inittab -e 's/^id:.*/id:5:initdefault:/'\n"
31313 "\n"
31314 msgstr ""
31315
31316 #. type: textblock
31317 #: ../tools/virt-edit.pl:87 ../tools/virt-win-reg.pl:106
31318 #: ../tools/virt-list-filesystems.pl:63 ../tools/virt-tar.pl:108
31319 #: ../tools/virt-make-fs.pl:163 ../tools/virt-list-partitions.pl:64
31320 msgid "Display brief help."
31321 msgstr ""
31322
31323 #. type: textblock
31324 #: ../tools/virt-edit.pl:95 ../tools/virt-win-reg.pl:114
31325 #: ../tools/virt-resize.pl:272 ../tools/virt-list-filesystems.pl:71
31326 #: ../tools/virt-tar.pl:116 ../tools/virt-make-fs.pl:171
31327 #: ../tools/virt-list-partitions.pl:72
31328 msgid "Display version number and exit."
31329 msgstr ""
31330
31331 #. type: =item
31332 #: ../tools/virt-edit.pl:101
31333 msgid "B<--backup extension> | B<-b extension>"
31334 msgstr ""
31335
31336 #. type: textblock
31337 #: ../tools/virt-edit.pl:103
31338 msgid ""
31339 "Create a backup of the original file I<in the guest disk image>.  The backup "
31340 "has the original filename with C<extension> added."
31341 msgstr ""
31342
31343 #. type: textblock
31344 #: ../tools/virt-edit.pl:106
31345 msgid ""
31346 "Usually the first character of C<extension> would be a dot C<.> so you would "
31347 "write:"
31348 msgstr ""
31349
31350 #. type: verbatim
31351 #: ../tools/virt-edit.pl:109
31352 #, no-wrap
31353 msgid ""
31354 " virt-edit -b .orig [etc]\n"
31355 "\n"
31356 msgstr ""
31357
31358 #. type: textblock
31359 #: ../tools/virt-edit.pl:111
31360 msgid "By default, no backup file is made."
31361 msgstr ""
31362
31363 #. type: =item
31364 #: ../tools/virt-edit.pl:117 ../tools/virt-win-reg.pl:128
31365 #: ../tools/virt-list-filesystems.pl:77 ../tools/virt-tar.pl:122
31366 #: ../tools/virt-list-partitions.pl:78
31367 msgid "B<--connect URI> | B<-c URI>"
31368 msgstr ""
31369
31370 #. type: textblock
31371 #: ../tools/virt-edit.pl:119 ../tools/virt-win-reg.pl:130
31372 #: ../tools/virt-list-filesystems.pl:79 ../tools/virt-tar.pl:124
31373 #: ../tools/virt-list-partitions.pl:80
31374 msgid ""
31375 "If using libvirt, connect to the given I<URI>.  If omitted, then we connect "
31376 "to the default libvirt hypervisor."
31377 msgstr ""
31378
31379 #. type: textblock
31380 #: ../tools/virt-edit.pl:122 ../tools/virt-win-reg.pl:133
31381 #: ../tools/virt-list-filesystems.pl:82 ../tools/virt-tar.pl:127
31382 #: ../tools/virt-list-partitions.pl:83
31383 msgid ""
31384 "If you specify guest block devices directly, then libvirt is not used at all."
31385 msgstr ""
31386
31387 #. type: =item
31388 #: ../tools/virt-edit.pl:129 ../tools/virt-win-reg.pl:140
31389 #: ../tools/virt-resize.pl:520 ../tools/virt-list-filesystems.pl:89
31390 #: ../tools/virt-tar.pl:134 ../tools/virt-list-partitions.pl:90
31391 msgid "B<--format> raw"
31392 msgstr ""
31393
31394 #. type: textblock
31395 #: ../tools/virt-edit.pl:131 ../tools/virt-win-reg.pl:142
31396 #: ../tools/virt-list-filesystems.pl:91 ../tools/virt-tar.pl:136
31397 #: ../tools/virt-list-partitions.pl:92
31398 msgid ""
31399 "Specify the format of disk images given on the command line.  If this is "
31400 "omitted then the format is autodetected from the content of the disk image."
31401 msgstr ""
31402
31403 #. type: textblock
31404 #: ../tools/virt-edit.pl:135 ../tools/virt-win-reg.pl:146
31405 #: ../tools/virt-list-filesystems.pl:95 ../tools/virt-tar.pl:140
31406 #: ../tools/virt-list-partitions.pl:96
31407 msgid ""
31408 "If disk images are requested from libvirt, then this program asks libvirt "
31409 "for this information.  In this case, the value of the format parameter is "
31410 "ignored."
31411 msgstr ""
31412
31413 #. type: textblock
31414 #: ../tools/virt-edit.pl:139 ../tools/virt-win-reg.pl:150
31415 #: ../tools/virt-resize.pl:525 ../tools/virt-resize.pl:540
31416 #: ../tools/virt-list-filesystems.pl:99 ../tools/virt-tar.pl:144
31417 #: ../tools/virt-list-partitions.pl:100
31418 msgid ""
31419 "If working with untrusted raw-format guest disk images, you should ensure "
31420 "the format is always specified."
31421 msgstr ""
31422
31423 #. type: =item
31424 #: ../tools/virt-edit.pl:146
31425 msgid "B<--expr EXPR> | B<-e EXPR>"
31426 msgstr ""
31427
31428 #. type: textblock
31429 #: ../tools/virt-edit.pl:148
31430 msgid ""
31431 "Instead of launching the external editor, non-interactively apply the Perl "
31432 "expression C<EXPR> to each line in the file.  See L</NON-INTERACTIVE "
31433 "EDITING> below."
31434 msgstr ""
31435
31436 #. type: textblock
31437 #: ../tools/virt-edit.pl:152
31438 msgid ""
31439 "Be careful to properly quote the expression to prevent it from being altered "
31440 "by the shell."
31441 msgstr ""
31442
31443 #. type: =head1
31444 #: ../tools/virt-edit.pl:272
31445 msgid "NON-INTERACTIVE EDITING"
31446 msgstr ""
31447
31448 #. type: textblock
31449 #: ../tools/virt-edit.pl:274
31450 msgid ""
31451 "C<virt-edit> normally calls out to C<$EDITOR> (or vi) so the system "
31452 "administrator can interactively edit the file."
31453 msgstr ""
31454
31455 #. type: textblock
31456 #: ../tools/virt-edit.pl:277
31457 msgid ""
31458 "There are two ways also to use C<virt-edit> from scripts in order to make "
31459 "automated edits to files.  (Note that although you I<can> use C<virt-edit> "
31460 "like this, it's less error-prone to write scripts directly using the "
31461 "libguestfs API and Augeas for configuration file editing.)"
31462 msgstr ""
31463
31464 #. type: textblock
31465 #: ../tools/virt-edit.pl:283
31466 msgid ""
31467 "The first method is to temporarily set C<$EDITOR> to any script or program "
31468 "you want to run.  The script is invoked as C<$EDITOR tmpfile> and it should "
31469 "update C<tmpfile> in place however it likes."
31470 msgstr ""
31471
31472 #. type: textblock
31473 #: ../tools/virt-edit.pl:287
31474 msgid ""
31475 "The second method is to use the C<-e> parameter of C<virt-edit> to run a "
31476 "short Perl snippet in the style of L<sed(1)>.  For example to replace all "
31477 "instances of C<foo> with C<bar> in a file:"
31478 msgstr ""
31479
31480 #. type: verbatim
31481 #: ../tools/virt-edit.pl:291
31482 #, no-wrap
31483 msgid ""
31484 " virt-edit domname filename -e 's/foo/bar/'\n"
31485 "\n"
31486 msgstr ""
31487
31488 #. type: textblock
31489 #: ../tools/virt-edit.pl:293
31490 msgid ""
31491 "The full power of Perl regular expressions can be used (see L<perlre(1)>).  "
31492 "For example to delete root's password you could do:"
31493 msgstr ""
31494
31495 #. type: verbatim
31496 #: ../tools/virt-edit.pl:296
31497 #, no-wrap
31498 msgid ""
31499 " virt-edit domname /etc/passwd -e 's/^root:.*?:/root::/'\n"
31500 "\n"
31501 msgstr ""
31502
31503 #. type: textblock
31504 #: ../tools/virt-edit.pl:298
31505 msgid ""
31506 "What really happens is that the snippet is evaluated as a Perl expression "
31507 "for each line of the file.  The line, including the final C<\\n>, is passed "
31508 "in C<$_> and the expression should update C<$_> or leave it unchanged."
31509 msgstr ""
31510
31511 #. type: textblock
31512 #: ../tools/virt-edit.pl:303
31513 msgid ""
31514 "To delete a line, set C<$_> to the empty string.  For example, to delete the "
31515 "C<apache> user account from the password file you can do:"
31516 msgstr ""
31517
31518 #. type: verbatim
31519 #: ../tools/virt-edit.pl:306
31520 #, no-wrap
31521 msgid ""
31522 " virt-edit mydomain /etc/passwd -e '$_ = \"\" if /^apache:/'\n"
31523 "\n"
31524 msgstr ""
31525
31526 #. type: textblock
31527 #: ../tools/virt-edit.pl:308
31528 msgid ""
31529 "To insert a line, prepend or append it to C<$_>.  However appending lines to "
31530 "the end of the file is rather difficult this way since there is no concept "
31531 "of \"last line of the file\" - your expression just doesn't get called "
31532 "again.  You might want to use the first method (setting C<$EDITOR>) if you "
31533 "want to do this."
31534 msgstr ""
31535
31536 #. type: textblock
31537 #: ../tools/virt-edit.pl:314
31538 msgid ""
31539 "The variable C<$lineno> contains the current line number.  As is "
31540 "traditional, the first line in the file is number C<1>."
31541 msgstr ""
31542
31543 #. type: textblock
31544 #: ../tools/virt-edit.pl:317
31545 msgid ""
31546 "The return value from the expression is ignored, but the expression may call "
31547 "C<die> in order to abort the whole program, leaving the original file "
31548 "untouched."
31549 msgstr ""
31550
31551 #. type: textblock
31552 #: ../tools/virt-edit.pl:321
31553 msgid ""
31554 "Remember when matching the end of a line that C<$_> may contain the final C<"
31555 "\\n>, or (for DOS files) C<\\r\\n>, or if the file does not end with a "
31556 "newline then neither of these.  Thus to match or substitute some text at the "
31557 "end of a line, use this regular expression:"
31558 msgstr ""
31559
31560 #. type: verbatim
31561 #: ../tools/virt-edit.pl:326
31562 #, no-wrap
31563 msgid ""
31564 " /some text(\\r?\\n)?$/\n"
31565 "\n"
31566 msgstr ""
31567
31568 #. type: textblock
31569 #: ../tools/virt-edit.pl:328
31570 msgid ""
31571 "Alternately, use the perl C<chomp> function, being careful not to chomp C<"
31572 "$_> itself (since that would remove all newlines from the file):"
31573 msgstr ""
31574
31575 #. type: verbatim
31576 #: ../tools/virt-edit.pl:332
31577 #, no-wrap
31578 msgid ""
31579 " my $m = $_; chomp $m; $m =~ /some text$/\n"
31580 "\n"
31581 msgstr ""
31582
31583 #. type: =head1
31584 #: ../tools/virt-edit.pl:334
31585 msgid "USING GUESTFISH"
31586 msgstr ""
31587
31588 #. type: textblock
31589 #: ../tools/virt-edit.pl:336
31590 msgid ""
31591 "L<guestfish(1)> is a more powerful, lower level tool which you can use when "
31592 "C<virt-edit> doesn't work."
31593 msgstr ""
31594
31595 #. type: textblock
31596 #: ../tools/virt-edit.pl:339
31597 msgid "Using C<virt-edit> is approximately equivalent to doing:"
31598 msgstr ""
31599
31600 #. type: verbatim
31601 #: ../tools/virt-edit.pl:341
31602 #, no-wrap
31603 msgid ""
31604 " guestfish --rw -i -d domname edit /file\n"
31605 "\n"
31606 msgstr ""
31607
31608 #. type: textblock
31609 #: ../tools/virt-edit.pl:343
31610 msgid ""
31611 "where C<domname> is the name of the libvirt guest, and C</file> is the full "
31612 "path to the file."
31613 msgstr ""
31614
31615 #. type: textblock
31616 #: ../tools/virt-edit.pl:346
31617 msgid ""
31618 "The command above uses libguestfs's guest inspection feature and so does not "
31619 "work on guests that libguestfs cannot inspect, or on things like arbitrary "
31620 "disk images that don't contain guests.  To edit a file on a disk image "
31621 "directly, use:"
31622 msgstr ""
31623
31624 #. type: verbatim
31625 #: ../tools/virt-edit.pl:351
31626 #, no-wrap
31627 msgid ""
31628 " guestfish --rw -a disk.img -m /dev/sda1 edit /file\n"
31629 "\n"
31630 msgstr ""
31631
31632 #. type: textblock
31633 #: ../tools/virt-edit.pl:353
31634 msgid ""
31635 "where C<disk.img> is the disk image, C</dev/sda1> is the filesystem within "
31636 "the disk image to edit, and C</file> is the full path to the file."
31637 msgstr ""
31638
31639 #. type: textblock
31640 #: ../tools/virt-edit.pl:357
31641 msgid ""
31642 "C<virt-edit> cannot create new files.  Use the guestfish commands C<touch>, "
31643 "C<write> or C<upload> instead:"
31644 msgstr ""
31645
31646 #. type: verbatim
31647 #: ../tools/virt-edit.pl:360
31648 #, no-wrap
31649 msgid ""
31650 " guestfish --rw -i -d domname touch /newfile\n"
31651 "\n"
31652 msgstr ""
31653
31654 #. type: verbatim
31655 #: ../tools/virt-edit.pl:362
31656 #, no-wrap
31657 msgid ""
31658 " guestfish --rw -i -d domname write /newfile \"new content\"\n"
31659 "\n"
31660 msgstr ""
31661
31662 #. type: verbatim
31663 #: ../tools/virt-edit.pl:364
31664 #, no-wrap
31665 msgid ""
31666 " guestfish --rw -i -d domname upload localfile /newfile\n"
31667 "\n"
31668 msgstr ""
31669
31670 #. type: textblock
31671 #: ../tools/virt-edit.pl:366
31672 msgid ""
31673 "C<virt-edit> cannot edit multiple files, but guestfish can do it like this:"
31674 msgstr ""
31675
31676 #. type: verbatim
31677 #: ../tools/virt-edit.pl:369
31678 #, no-wrap
31679 msgid ""
31680 " guestfish --rw -i -d domname edit /file1 : edit /file2\n"
31681 "\n"
31682 msgstr ""
31683
31684 #. type: =item
31685 #: ../tools/virt-edit.pl:379
31686 msgid "C<EDITOR>"
31687 msgstr ""
31688
31689 #. type: textblock
31690 #: ../tools/virt-edit.pl:381
31691 msgid ""
31692 "If set, this string is used as the editor.  It may contain arguments, eg. C<"
31693 "\"emacs -nw\">"
31694 msgstr ""
31695
31696 #. type: textblock
31697 #: ../tools/virt-edit.pl:384
31698 msgid "If not set, C<vi> is used."
31699 msgstr ""
31700
31701 #. type: =head1
31702 #: ../tools/virt-edit.pl:388 ../tools/virt-win-reg.pl:559
31703 #: ../tools/virt-resize.pl:1476 ../tools/virt-list-filesystems.pl:182
31704 #: ../tools/virt-tar.pl:274 ../tools/virt-make-fs.pl:532
31705 #: ../tools/virt-list-partitions.pl:250
31706 msgid "SHELL QUOTING"
31707 msgstr ""
31708
31709 #. type: textblock
31710 #: ../tools/virt-edit.pl:390 ../tools/virt-win-reg.pl:567
31711 #: ../tools/virt-resize.pl:1478 ../tools/virt-list-filesystems.pl:184
31712 #: ../tools/virt-tar.pl:276 ../tools/virt-make-fs.pl:534
31713 #: ../tools/virt-list-partitions.pl:252
31714 msgid ""
31715 "Libvirt guest names can contain arbitrary characters, some of which have "
31716 "meaning to the shell such as C<#> and space.  You may need to quote or "
31717 "escape these characters on the command line.  See the shell manual page L<sh"
31718 "(1)> for details."
31719 msgstr ""
31720
31721 #. type: textblock
31722 #: ../tools/virt-edit.pl:397
31723 msgid ""
31724 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<Sys::Guestfs(3)>, L<Sys::"
31725 "Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>, L<perl(1)>, "
31726 "L<perlre(1)>."
31727 msgstr ""
31728
31729 #. type: =head1
31730 #: ../tools/virt-edit.pl:407 ../tools/virt-win-reg.pl:598
31731 #: ../tools/virt-resize.pl:1504 ../tools/virt-list-filesystems.pl:202
31732 #: ../tools/virt-tar.pl:292 ../tools/virt-make-fs.pl:564
31733 #: ../tools/virt-list-partitions.pl:269
31734 msgid "AUTHOR"
31735 msgstr ""
31736
31737 #. type: textblock
31738 #: ../tools/virt-edit.pl:409 ../tools/virt-win-reg.pl:600
31739 #: ../tools/virt-resize.pl:1506 ../tools/virt-list-filesystems.pl:204
31740 #: ../tools/virt-tar.pl:294 ../tools/virt-make-fs.pl:566
31741 #: ../tools/virt-list-partitions.pl:271
31742 msgid "Richard W.M. Jones L<http://people.redhat.com/~rjones/>"
31743 msgstr ""
31744
31745 #. type: textblock
31746 #: ../tools/virt-edit.pl:413
31747 msgid "Copyright (C) 2009-2011 Red Hat Inc."
31748 msgstr ""
31749
31750 #. type: textblock
31751 #: ../tools/virt-win-reg.pl:37
31752 msgid ""
31753 "virt-win-reg - Export and merge Windows Registry entries from a Windows guest"
31754 msgstr ""
31755
31756 #. type: verbatim
31757 #: ../tools/virt-win-reg.pl:41
31758 #, no-wrap
31759 msgid ""
31760 " virt-win-reg domname 'HKLM\\Path\\To\\Subkey'\n"
31761 "\n"
31762 msgstr ""
31763
31764 #. type: verbatim
31765 #: ../tools/virt-win-reg.pl:43
31766 #, no-wrap
31767 msgid ""
31768 " virt-win-reg domname 'HKLM\\Path\\To\\Subkey' name\n"
31769 "\n"
31770 msgstr ""
31771
31772 #. type: verbatim
31773 #: ../tools/virt-win-reg.pl:45
31774 #, no-wrap
31775 msgid ""
31776 " virt-win-reg domname 'HKLM\\Path\\To\\Subkey' @\n"
31777 "\n"
31778 msgstr ""
31779
31780 #. type: verbatim
31781 #: ../tools/virt-win-reg.pl:47
31782 #, no-wrap
31783 msgid ""
31784 " virt-win-reg --merge domname [input.reg ...]\n"
31785 "\n"
31786 msgstr ""
31787
31788 #. type: verbatim
31789 #: ../tools/virt-win-reg.pl:49
31790 #, no-wrap
31791 msgid ""
31792 " virt-win-reg [--options] disk.img ... # instead of domname\n"
31793 "\n"
31794 msgstr ""
31795
31796 #. type: textblock
31797 #: ../tools/virt-win-reg.pl:53
31798 msgid ""
31799 "You must I<not> use C<virt-win-reg> with the C<--merge> option on live "
31800 "virtual machines.  If you do this, you I<will> get irreversible disk "
31801 "corruption in the VM.  C<virt-win-reg> tries to stop you from doing this, "
31802 "but doesn't catch all cases."
31803 msgstr ""
31804
31805 #. type: textblock
31806 #: ../tools/virt-win-reg.pl:58
31807 msgid ""
31808 "Modifying the Windows Registry is an inherently risky operation.  The format "
31809 "is deliberately obscure and undocumented, and Registry changes can leave the "
31810 "system unbootable.  Therefore when using the C<--merge> option, make sure "
31811 "you have a reliable backup first."
31812 msgstr ""
31813
31814 #. type: textblock
31815 #: ../tools/virt-win-reg.pl:65
31816 msgid ""
31817 "This program can export and merge Windows Registry entries from a Windows "
31818 "guest."
31819 msgstr ""
31820
31821 #. type: textblock
31822 #: ../tools/virt-win-reg.pl:68
31823 msgid ""
31824 "The first parameter is the libvirt guest name or the raw disk image of a "
31825 "Windows guest."
31826 msgstr ""
31827
31828 #. type: textblock
31829 #: ../tools/virt-win-reg.pl:71
31830 msgid ""
31831 "If C<--merge> is I<not> specified, then the chosen registry key is displayed/"
31832 "exported (recursively).  For example:"
31833 msgstr ""
31834
31835 #. type: verbatim
31836 #: ../tools/virt-win-reg.pl:74
31837 #, no-wrap
31838 msgid ""
31839 " $ virt-win-reg Windows7 'HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft'\n"
31840 "\n"
31841 msgstr ""
31842
31843 #. type: textblock
31844 #: ../tools/virt-win-reg.pl:76
31845 msgid ""
31846 "You can also display single values from within registry keys, for example:"
31847 msgstr ""
31848
31849 #. type: verbatim
31850 #: ../tools/virt-win-reg.pl:79
31851 #, no-wrap
31852 msgid ""
31853 " $ cvkey='HKLM\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion'\n"
31854 " $ virt-win-reg Windows7 $cvkey ProductName\n"
31855 " Windows 7 Enterprise\n"
31856 "\n"
31857 msgstr ""
31858
31859 #. type: textblock
31860 #: ../tools/virt-win-reg.pl:83
31861 msgid ""
31862 "With C<--merge>, you can merge a textual regedit file into the Windows "
31863 "Registry:"
31864 msgstr ""
31865
31866 #. type: verbatim
31867 #: ../tools/virt-win-reg.pl:86
31868 #, no-wrap
31869 msgid ""
31870 " $ virt-win-reg --merge Windows7 changes.reg\n"
31871 "\n"
31872 msgstr ""
31873
31874 #. type: =head2
31875 #: ../tools/virt-win-reg.pl:88
31876 msgid "NOTE"
31877 msgstr ""
31878
31879 #. type: textblock
31880 #: ../tools/virt-win-reg.pl:90
31881 msgid ""
31882 "This program is only meant for simple access to the registry.  If you want "
31883 "to do complicated things with the registry, we suggest you download the "
31884 "Registry hive files from the guest using L<libguestfs(3)> or L<guestfish(1)> "
31885 "and access them locally, eg. using L<hivex(3)>, L<hivexsh(1)> or "
31886 "L<hivexregedit(1)>."
31887 msgstr ""
31888
31889 #. type: =item
31890 #: ../tools/virt-win-reg.pl:120 ../tools/virt-make-fs.pl:177
31891 msgid "B<--debug>"
31892 msgstr ""
31893
31894 #. type: textblock
31895 #: ../tools/virt-win-reg.pl:122 ../tools/virt-resize.pl:498
31896 msgid "Enable debugging messages."
31897 msgstr ""
31898
31899 #. type: =item
31900 #: ../tools/virt-win-reg.pl:157
31901 msgid "B<--merge>"
31902 msgstr ""
31903
31904 #. type: textblock
31905 #: ../tools/virt-win-reg.pl:159
31906 msgid ""
31907 "In merge mode, this merges a textual regedit file into the Windows Registry "
31908 "of the virtual machine.  If this flag is I<not> given then virt-win-reg "
31909 "displays or exports Registry entries instead."
31910 msgstr ""
31911
31912 #. type: textblock
31913 #: ../tools/virt-win-reg.pl:163
31914 msgid ""
31915 "Note that C<--merge> is I<unsafe> to use on live virtual machines, and will "
31916 "result in disk corruption.  However exporting (without this flag)  is always "
31917 "safe."
31918 msgstr ""
31919
31920 #. type: =item
31921 #: ../tools/virt-win-reg.pl:171
31922 msgid "B<--encoding> UTF-16LE|ASCII"
31923 msgstr ""
31924
31925 #. type: textblock
31926 #: ../tools/virt-win-reg.pl:173
31927 msgid ""
31928 "When merging (only), you may need to specify the encoding for strings to be "
31929 "used in the hive file.  This is explained in detail in L<Win::Hivex::Regedit"
31930 "(3)/ENCODING STRINGS>."
31931 msgstr ""
31932
31933 #. type: textblock
31934 #: ../tools/virt-win-reg.pl:177
31935 msgid ""
31936 "The default is to use UTF-16LE, which should work with recent versions of "
31937 "Windows."
31938 msgstr ""
31939
31940 #. type: =head1
31941 #: ../tools/virt-win-reg.pl:402
31942 msgid "SUPPORTED SYSTEMS"
31943 msgstr ""
31944
31945 #. type: textblock
31946 #: ../tools/virt-win-reg.pl:404
31947 msgid ""
31948 "The program currently supports Windows NT-derived guests starting with "
31949 "Windows XP through to at least Windows 7."
31950 msgstr ""
31951
31952 #. type: textblock
31953 #: ../tools/virt-win-reg.pl:407
31954 msgid ""
31955 "Registry support is done for C<HKEY_LOCAL_MACHINE\\SAM>, C<HKEY_LOCAL_MACHINE"
31956 "\\SECURITY>, C<HKEY_LOCAL_MACHINE\\SOFTWARE>, C<HKEY_LOCAL_MACHINE\\SYSTEM> "
31957 "and C<HKEY_USERS\\.DEFAULT>."
31958 msgstr ""
31959
31960 #. type: textblock
31961 #: ../tools/virt-win-reg.pl:411
31962 msgid ""
31963 "You can use C<HKLM> as a shorthand for C<HKEY_LOCAL_MACHINE>, and C<HKU> for "
31964 "C<HKEY_USERS>."
31965 msgstr ""
31966
31967 #. type: textblock
31968 #: ../tools/virt-win-reg.pl:414
31969 msgid ""
31970 "C<HKEY_USERS\\$SID> and C<HKEY_CURRENT_USER> are B<not> supported at this "
31971 "time."
31972 msgstr ""
31973
31974 #. type: =head1
31975 #: ../tools/virt-win-reg.pl:417
31976 msgid "ENCODING"
31977 msgstr ""
31978
31979 #. type: textblock
31980 #: ../tools/virt-win-reg.pl:419
31981 msgid ""
31982 "C<virt-win-reg> expects that regedit files have already been reencoded in "
31983 "the local encoding.  Usually on Linux hosts, this means UTF-8 with Unix-"
31984 "style line endings.  Since Windows regedit files are often in UTF-16LE with "
31985 "Windows-style line endings, you may need to reencode the whole file before "
31986 "or after processing."
31987 msgstr ""
31988
31989 #. type: textblock
31990 #: ../tools/virt-win-reg.pl:425
31991 msgid ""
31992 "To reencode a file from Windows format to Linux (before processing it with "
31993 "the C<--merge> option), you would do something like this:"
31994 msgstr ""
31995
31996 #. type: verbatim
31997 #: ../tools/virt-win-reg.pl:428
31998 #, no-wrap
31999 msgid ""
32000 " iconv -f utf-16le -t utf-8 < win.reg | dos2unix > linux.reg\n"
32001 "\n"
32002 msgstr ""
32003
32004 #. type: textblock
32005 #: ../tools/virt-win-reg.pl:430
32006 msgid ""
32007 "To go in the opposite direction, after exporting and before sending the file "
32008 "to a Windows user, do something like this:"
32009 msgstr ""
32010
32011 #. type: verbatim
32012 #: ../tools/virt-win-reg.pl:433
32013 #, no-wrap
32014 msgid ""
32015 " unix2dos linux.reg | iconv -f utf-8 -t utf-16le > win.reg\n"
32016 "\n"
32017 msgstr ""
32018
32019 #. type: textblock
32020 #: ../tools/virt-win-reg.pl:435
32021 msgid "For more information about encoding, see L<Win::Hivex::Regedit(3)>."
32022 msgstr ""
32023
32024 #. type: textblock
32025 #: ../tools/virt-win-reg.pl:437
32026 msgid ""
32027 "If you are unsure about the current encoding, use the L<file(1)> command.  "
32028 "Recent versions of Windows regedit.exe produce a UTF-16LE file with Windows-"
32029 "style (CRLF) line endings, like this:"
32030 msgstr ""
32031
32032 #. type: verbatim
32033 #: ../tools/virt-win-reg.pl:441
32034 #, no-wrap
32035 msgid ""
32036 " $ file software.reg\n"
32037 " software.reg: Little-endian UTF-16 Unicode text, with very long lines,\n"
32038 " with CRLF line terminators\n"
32039 "\n"
32040 msgstr ""
32041
32042 #. type: textblock
32043 #: ../tools/virt-win-reg.pl:445
32044 msgid "This file would need conversion before you could C<--merge> it."
32045 msgstr ""
32046
32047 #. type: =head1
32048 #: ../tools/virt-win-reg.pl:447
32049 msgid "CurrentControlSet etc."
32050 msgstr ""
32051
32052 #. type: textblock
32053 #: ../tools/virt-win-reg.pl:449
32054 msgid ""
32055 "Registry keys like C<CurrentControlSet> don't really exist in the Windows "
32056 "Registry at the level of the hive file, and therefore you cannot modify "
32057 "these."
32058 msgstr ""
32059
32060 #. type: textblock
32061 #: ../tools/virt-win-reg.pl:453
32062 msgid ""
32063 "C<CurrentControlSet> is usually an alias for C<ControlSet001>.  In some "
32064 "circumstances it might refer to another control set.  The way to find out is "
32065 "to look at the C<HKLM\\SYSTEM\\Select> key:"
32066 msgstr ""
32067
32068 #. type: verbatim
32069 #: ../tools/virt-win-reg.pl:457
32070 #, no-wrap
32071 msgid ""
32072 " # virt-win-reg WindowsGuest 'HKLM\\SYSTEM\\Select'\n"
32073 " [HKEY_LOCAL_MACHINE\\SYSTEM\\Select]\n"
32074 " \"Current\"=dword:00000001\n"
32075 " \"Default\"=dword:00000001\n"
32076 " \"Failed\"=dword:00000000\n"
32077 " \"LastKnownGood\"=dword:00000002\n"
32078 "\n"
32079 msgstr ""
32080
32081 #. type: textblock
32082 #: ../tools/virt-win-reg.pl:464
32083 msgid "\"Current\" is the one which Windows will choose when it boots."
32084 msgstr ""
32085
32086 #. type: textblock
32087 #: ../tools/virt-win-reg.pl:466
32088 msgid ""
32089 "Similarly, other C<Current...> keys in the path may need to be replaced."
32090 msgstr ""
32091
32092 #. type: =head1
32093 #: ../tools/virt-win-reg.pl:469
32094 msgid "WINDOWS TIPS"
32095 msgstr ""
32096
32097 #. type: textblock
32098 #: ../tools/virt-win-reg.pl:471
32099 msgid ""
32100 "Note that some of these tips modify the guest disk image.  The guest I<must> "
32101 "be shut off, else you will get disk corruption."
32102 msgstr ""
32103
32104 #. type: =head2
32105 #: ../tools/virt-win-reg.pl:474
32106 msgid "RUNNING A BATCH SCRIPT WHEN A USER LOGS IN"
32107 msgstr ""
32108
32109 #. type: textblock
32110 #: ../tools/virt-win-reg.pl:476
32111 msgid ""
32112 "Prepare a DOS batch script, VBScript or executable.  Upload this using "
32113 "L<guestfish(1)>.  For this example the script is called C<test.bat> and it "
32114 "is uploaded into C<C:\\>:"
32115 msgstr ""
32116
32117 #. type: verbatim
32118 #: ../tools/virt-win-reg.pl:480
32119 #, no-wrap
32120 msgid ""
32121 " guestfish -i -d WindowsGuest upload test.bat /test.bat\n"
32122 "\n"
32123 msgstr ""
32124
32125 #. type: textblock
32126 #: ../tools/virt-win-reg.pl:482
32127 msgid "Prepare a regedit file containing the registry change:"
32128 msgstr ""
32129
32130 #. type: verbatim
32131 #: ../tools/virt-win-reg.pl:484
32132 #, no-wrap
32133 msgid ""
32134 " cat > test.reg <<'EOF'\n"
32135 " [HKLM\\Software\\Microsoft\\Windows\\CurrentVersion\\RunOnce]\n"
32136 " \"Test\"=\"c:\\\\test.bat\"\n"
32137 " EOF\n"
32138 "\n"
32139 msgstr ""
32140
32141 #. type: textblock
32142 #: ../tools/virt-win-reg.pl:489
32143 msgid ""
32144 "In this example we use the key C<RunOnce> which means that the script will "
32145 "run precisely once when the first user logs in.  If you want it to run every "
32146 "time a user logs in, replace C<RunOnce> with C<Run>."
32147 msgstr ""
32148
32149 #. type: textblock
32150 #: ../tools/virt-win-reg.pl:493
32151 msgid "Now update the registry:"
32152 msgstr ""
32153
32154 #. type: verbatim
32155 #: ../tools/virt-win-reg.pl:495
32156 #, no-wrap
32157 msgid ""
32158 " virt-win-reg --merge WindowsGuest test.reg\n"
32159 "\n"
32160 msgstr ""
32161
32162 #. type: =head2
32163 #: ../tools/virt-win-reg.pl:497
32164 msgid "INSTALLING A SERVICE"
32165 msgstr ""
32166
32167 #. type: textblock
32168 #: ../tools/virt-win-reg.pl:499
32169 msgid ""
32170 "This section assumes you are familiar with Windows services, and you either "
32171 "have a program which handles the Windows Service Control Protocol directly "
32172 "or you want to run any program using a service wrapper like SrvAny or the "
32173 "free RHSrvAny."
32174 msgstr ""
32175
32176 #. type: textblock
32177 #: ../tools/virt-win-reg.pl:504
32178 msgid ""
32179 "First upload the program and optionally the service wrapper.  In this case "
32180 "the test program is called C<test.exe> and we are using the RHSrvAny wrapper:"
32181 msgstr ""
32182
32183 #. type: verbatim
32184 #: ../tools/virt-win-reg.pl:508
32185 #, no-wrap
32186 msgid ""
32187 " guestfish -i -d WindowsGuest <<EOF\n"
32188 "   upload rhsrvany.exe /rhsrvany.exe\n"
32189 "   upload test.exe /test.exe\n"
32190 " EOF\n"
32191 "\n"
32192 msgstr ""
32193
32194 #. type: textblock
32195 #: ../tools/virt-win-reg.pl:513
32196 msgid ""
32197 "Prepare a regedit file containing the registry changes.  In this example, "
32198 "the first registry change is needed for the service itself or the service "
32199 "wrapper (if used).  The second registry change is only needed because I am "
32200 "using the RHSrvAny service wrapper."
32201 msgstr ""
32202
32203 #. type: verbatim
32204 #: ../tools/virt-win-reg.pl:518
32205 #, no-wrap
32206 msgid ""
32207 " cat > service.reg <<'EOF'\n"
32208 " [HKLM\\SYSTEM\\ControlSet001\\services\\RHSrvAny]\n"
32209 " \"Type\"=dword:00000010\n"
32210 " \"Start\"=dword:00000002\n"
32211 " \"ErrorControl\"=dword:00000001\n"
32212 " \"ImagePath\"=\"c:\\\\rhsrvany.exe\"\n"
32213 " \"DisplayName\"=\"RHSrvAny\"\n"
32214 " \"ObjectName\"=\"NetworkService\"\n"
32215 " \n"
32216 msgstr ""
32217
32218 #. type: verbatim
32219 #: ../tools/virt-win-reg.pl:527
32220 #, no-wrap
32221 msgid ""
32222 " [HKLM\\SYSTEM\\ControlSet001\\services\\RHSrvAny\\Parameters]\n"
32223 " \"CommandLine\"=\"c:\\\\test.exe\"\n"
32224 " \"PWD\"=\"c:\\\\Temp\"\n"
32225 " EOF\n"
32226 "\n"
32227 msgstr ""
32228
32229 #. type: textblock
32230 #: ../tools/virt-win-reg.pl:538
32231 msgid ""
32232 "For use of C<ControlSet001> see the section above in this manual page.  You "
32233 "may need to adjust this according to the control set that is in use by the "
32234 "guest."
32235 msgstr ""
32236
32237 #. type: textblock
32238 #: ../tools/virt-win-reg.pl:544
32239 msgid ""
32240 "C<\"ObjectName\"> controls the privileges that the service will have.  An "
32241 "alternative is C<\"ObjectName\"=\"LocalSystem\"> which would be the most "
32242 "privileged account."
32243 msgstr ""
32244
32245 #. type: textblock
32246 #: ../tools/virt-win-reg.pl:550
32247 msgid ""
32248 "For the meaning of the magic numbers, see this Microsoft KB article: "
32249 "L<http://support.microsoft.com/kb/103000>."
32250 msgstr ""
32251
32252 #. type: textblock
32253 #: ../tools/virt-win-reg.pl:555
32254 msgid "Update the registry:"
32255 msgstr ""
32256
32257 #. type: verbatim
32258 #: ../tools/virt-win-reg.pl:557
32259 #, no-wrap
32260 msgid ""
32261 " virt-win-reg --merge WindowsGuest service.reg\n"
32262 "\n"
32263 msgstr ""
32264
32265 #. type: textblock
32266 #: ../tools/virt-win-reg.pl:561
32267 msgid ""
32268 "Be careful when passing parameters containing C<\\> (backslash) in the "
32269 "shell.  Usually you will have to use 'single quotes' or double backslashes "
32270 "(but not both) to protect them from the shell."
32271 msgstr ""
32272
32273 #. type: textblock
32274 #: ../tools/virt-win-reg.pl:565
32275 msgid "Paths and value names are case-insensitive."
32276 msgstr ""
32277
32278 #. type: textblock
32279 #: ../tools/virt-win-reg.pl:574
32280 msgid ""
32281 "L<hivex(3)>, L<hivexsh(1)>, L<hivexregedit(1)>, L<guestfs(3)>, L<guestfish(1)"
32282 ">, L<virt-cat(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Win::Hivex"
32283 "(3)>, L<Win::Hivex::Regedit(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
32284 msgstr ""
32285
32286 #. type: textblock
32287 #: ../tools/virt-win-reg.pl:589 ../tools/virt-make-fs.pl:555
32288 msgid ""
32289 "When reporting bugs, please enable debugging and capture the I<complete> "
32290 "output:"
32291 msgstr ""
32292
32293 #. type: verbatim
32294 #: ../tools/virt-win-reg.pl:592
32295 #, no-wrap
32296 msgid ""
32297 " export LIBGUESTFS_DEBUG=1\n"
32298 " virt-win-reg --debug [... rest ...] > /tmp/virt-win-reg.log 2>&1\n"
32299 "\n"
32300 msgstr ""
32301
32302 #. type: textblock
32303 #: ../tools/virt-win-reg.pl:595
32304 msgid ""
32305 "Attach /tmp/virt-win-reg.log to a new bug report at L<https://bugzilla."
32306 "redhat.com/>"
32307 msgstr ""
32308
32309 #. type: textblock
32310 #: ../tools/virt-win-reg.pl:604 ../tools/virt-resize.pl:1510
32311 #: ../tools/virt-make-fs.pl:570
32312 msgid "Copyright (C) 2010 Red Hat Inc."
32313 msgstr ""
32314
32315 #. type: textblock
32316 #: ../tools/virt-resize.pl:42
32317 msgid "virt-resize - Resize a virtual machine disk"
32318 msgstr ""
32319
32320 #. type: verbatim
32321 #: ../tools/virt-resize.pl:46
32322 #, no-wrap
32323 msgid ""
32324 " virt-resize [--resize /dev/sdaN=[+/-]<size>[%]]\n"
32325 "   [--expand /dev/sdaN] [--shrink /dev/sdaN]\n"
32326 "   [--ignore /dev/sdaN] [--delete /dev/sdaN] [...] indisk outdisk\n"
32327 "\n"
32328 msgstr ""
32329
32330 #. type: textblock
32331 #: ../tools/virt-resize.pl:52
32332 msgid ""
32333 "Virt-resize is a tool which can resize a virtual machine disk, making it "
32334 "larger or smaller overall, and resizing or deleting any partitions contained "
32335 "within."
32336 msgstr ""
32337
32338 #. type: textblock
32339 #: ../tools/virt-resize.pl:56
32340 msgid ""
32341 "Virt-resize B<cannot> resize disk images in-place.  Virt-resize B<should "
32342 "not> be used on live virtual machines - for consistent results, shut the "
32343 "virtual machine down before resizing it."
32344 msgstr ""
32345
32346 #. type: textblock
32347 #: ../tools/virt-resize.pl:60
32348 msgid ""
32349 "If you are not familiar with the associated tools: L<virt-filesystems(1)> "
32350 "and L<virt-df(1)>, we recommend you go and read those manual pages first."
32351 msgstr ""
32352
32353 #. type: textblock
32354 #: ../tools/virt-resize.pl:66
32355 msgid ""
32356 "Copy C<olddisk> to C<newdisk>, extending one of the guest's partitions to "
32357 "fill the extra 5GB of space."
32358 msgstr ""
32359
32360 #. type: verbatim
32361 #: ../tools/virt-resize.pl:69
32362 #, no-wrap
32363 msgid ""
32364 " truncate -r olddisk newdisk; truncate -s +5G newdisk\n"
32365 " virt-filesystems --long -h --all -a olddisk\n"
32366 " # Note \"/dev/sda2\" is a partition inside the \"olddisk\" file.\n"
32367 " virt-resize --expand /dev/sda2 olddisk newdisk\n"
32368 "\n"
32369 msgstr ""
32370
32371 #. type: textblock
32372 #: ../tools/virt-resize.pl:74
32373 msgid ""
32374 "As above, but make the /boot partition 200MB bigger, while giving the "
32375 "remaining space to /dev/sda2:"
32376 msgstr ""
32377
32378 #. type: verbatim
32379 #: ../tools/virt-resize.pl:77
32380 #, no-wrap
32381 msgid ""
32382 " virt-resize --resize /dev/sda1=+200M --expand /dev/sda2 olddisk newdisk\n"
32383 "\n"
32384 msgstr ""
32385
32386 #. type: textblock
32387 #: ../tools/virt-resize.pl:79
32388 msgid "As above, but the output format will be uncompressed qcow2:"
32389 msgstr ""
32390
32391 #. type: verbatim
32392 #: ../tools/virt-resize.pl:81
32393 #, no-wrap
32394 msgid ""
32395 " qemu-img create -f qcow2 newdisk.qcow2 15G\n"
32396 " virt-resize --expand /dev/sda2 olddisk newdisk.qcow2\n"
32397 "\n"
32398 msgstr ""
32399
32400 #. type: =head1
32401 #: ../tools/virt-resize.pl:84
32402 msgid "DETAILED USAGE"
32403 msgstr ""
32404
32405 #. type: =head2
32406 #: ../tools/virt-resize.pl:86
32407 msgid "EXPANDING A VIRTUAL MACHINE DISK"
32408 msgstr ""
32409
32410 #. type: =item
32411 #: ../tools/virt-resize.pl:90
32412 msgid "1. Shut down the virtual machine"
32413 msgstr ""
32414
32415 #. type: =item
32416 #: ../tools/virt-resize.pl:92
32417 msgid "2. Locate input disk image"
32418 msgstr ""
32419
32420 #. type: textblock
32421 #: ../tools/virt-resize.pl:94
32422 msgid ""
32423 "Locate the input disk image (ie. the file or device on the host containing "
32424 "the guest's disk).  If the guest is managed by libvirt, you can use C<virsh "
32425 "dumpxml> like this to find the disk image name:"
32426 msgstr ""
32427
32428 #. type: verbatim
32429 #: ../tools/virt-resize.pl:98
32430 #, no-wrap
32431 msgid ""
32432 " # virsh dumpxml guestname | xpath /domain/devices/disk/source\n"
32433 " Found 1 nodes:\n"
32434 " -- NODE --\n"
32435 " <source dev=\"/dev/vg/lv_guest\" />\n"
32436 "\n"
32437 msgstr ""
32438
32439 #. type: =item
32440 #: ../tools/virt-resize.pl:103
32441 msgid "3. Look at current sizing"
32442 msgstr ""
32443
32444 #. type: textblock
32445 #: ../tools/virt-resize.pl:105
32446 msgid "Use L<virt-filesystems(1)> to display the current partitions and sizes:"
32447 msgstr ""
32448
32449 #. type: verbatim
32450 #: ../tools/virt-resize.pl:108
32451 #, no-wrap
32452 msgid ""
32453 " # virt-filesystems --long --parts --blkdevs -h -a /dev/vg/lv_guest\n"
32454 " Name       Type       Size  Parent\n"
32455 " /dev/sda1  partition  101M  /dev/sda\n"
32456 " /dev/sda2  partition  7.9G  /dev/sda\n"
32457 " /dev/sda   device     8.0G  -\n"
32458 "\n"
32459 msgstr ""
32460
32461 #. type: textblock
32462 #: ../tools/virt-resize.pl:114
32463 msgid ""
32464 "(This example is a virtual machine with an 8 GB disk which we would like to "
32465 "expand up to 10 GB)."
32466 msgstr ""
32467
32468 #. type: =item
32469 #: ../tools/virt-resize.pl:117
32470 msgid "4. Create output disk"
32471 msgstr ""
32472
32473 #. type: textblock
32474 #: ../tools/virt-resize.pl:119
32475 msgid ""
32476 "Virt-resize cannot do in-place disk modifications.  You have to have space "
32477 "to store the resized output disk."
32478 msgstr ""
32479
32480 #. type: textblock
32481 #: ../tools/virt-resize.pl:122
32482 msgid ""
32483 "To store the resized disk image in a file, create a file of a suitable size:"
32484 msgstr ""
32485
32486 #. type: verbatim
32487 #: ../tools/virt-resize.pl:125
32488 #, no-wrap
32489 msgid ""
32490 " # rm -f outdisk\n"
32491 " # truncate -s 10G outdisk\n"
32492 "\n"
32493 msgstr ""
32494
32495 #. type: textblock
32496 #: ../tools/virt-resize.pl:128
32497 msgid "Or use L<lvcreate(1)> to create a logical volume:"
32498 msgstr ""
32499
32500 #. type: verbatim
32501 #: ../tools/virt-resize.pl:130
32502 #, no-wrap
32503 msgid ""
32504 " # lvcreate -L 10G -n lv_name vg_name\n"
32505 "\n"
32506 msgstr ""
32507
32508 #. type: textblock
32509 #: ../tools/virt-resize.pl:132
32510 msgid "Or use L<virsh(1)> vol-create-as to create a libvirt storage volume:"
32511 msgstr ""
32512
32513 #. type: verbatim
32514 #: ../tools/virt-resize.pl:134
32515 #, no-wrap
32516 msgid ""
32517 " # virsh pool-list\n"
32518 " # virsh vol-create-as poolname newvol 10G\n"
32519 "\n"
32520 msgstr ""
32521
32522 #. type: =item
32523 #: ../tools/virt-resize.pl:137
32524 msgid "5. Resize"
32525 msgstr ""
32526
32527 #. type: textblock
32528 #: ../tools/virt-resize.pl:139
32529 msgid ""
32530 "virt-resize takes two mandatory parameters, the input disk (eg. device or "
32531 "file) and the output disk.  The output disk is the one created in the "
32532 "previous step."
32533 msgstr ""
32534
32535 #. type: verbatim
32536 #: ../tools/virt-resize.pl:143
32537 #, no-wrap
32538 msgid ""
32539 " # virt-resize indisk outdisk\n"
32540 "\n"
32541 msgstr ""
32542
32543 #. type: textblock
32544 #: ../tools/virt-resize.pl:145
32545 msgid ""
32546 "This command just copies disk image C<indisk> to disk image C<outdisk> "
32547 "I<without> resizing or changing any existing partitions.  If C<outdisk> is "
32548 "larger, then an extra, empty partition is created at the end of the disk "
32549 "covering the extra space.  If C<outdisk> is smaller, then it will give an "
32550 "error."
32551 msgstr ""
32552
32553 #. type: textblock
32554 #: ../tools/virt-resize.pl:151
32555 msgid ""
32556 "More realistically you'd want to expand existing partitions in the disk "
32557 "image by passing extra options (for the full list see the L</OPTIONS> "
32558 "section below)."
32559 msgstr ""
32560
32561 #. type: textblock
32562 #: ../tools/virt-resize.pl:155
32563 msgid ""
32564 "L</--expand> is the most useful option.  It expands the named partition "
32565 "within the disk to fill any extra space:"
32566 msgstr ""
32567
32568 #. type: verbatim
32569 #: ../tools/virt-resize.pl:158
32570 #, no-wrap
32571 msgid ""
32572 " # virt-resize --expand /dev/sda2 indisk outdisk\n"
32573 "\n"
32574 msgstr ""
32575
32576 #. type: textblock
32577 #: ../tools/virt-resize.pl:160
32578 msgid ""
32579 "(In this case, an extra partition is I<not> created at the end of the disk, "
32580 "because there will be no unused space)."
32581 msgstr ""
32582
32583 #. type: textblock
32584 #: ../tools/virt-resize.pl:163
32585 msgid ""
32586 "L</--resize> is the other commonly used option.  The following would "
32587 "increase the size of /dev/sda1 by 200M, and expand /dev/sda2 to fill the "
32588 "rest of the available space:"
32589 msgstr ""
32590
32591 #. type: verbatim
32592 #: ../tools/virt-resize.pl:167
32593 #, no-wrap
32594 msgid ""
32595 " # virt-resize --resize /dev/sda1=+200M --expand /dev/sda2 \\\n"
32596 "     indisk outdisk\n"
32597 "\n"
32598 msgstr ""
32599
32600 #. type: textblock
32601 #: ../tools/virt-resize.pl:170
32602 msgid ""
32603 "If the expanded partition in the image contains a filesystem or LVM PV, then "
32604 "if virt-resize knows how, it will resize the contents, the equivalent of "
32605 "calling a command such as L<pvresize(8)>, L<resize2fs(8)> or L<ntfsresize(8)"
32606 ">.  However virt-resize does not know how to resize some filesystems, so you "
32607 "would have to online resize them after booting the guest."
32608 msgstr ""
32609
32610 #. type: textblock
32611 #: ../tools/virt-resize.pl:177
32612 msgid "Other options are covered below."
32613 msgstr ""
32614
32615 #. type: =item
32616 #: ../tools/virt-resize.pl:179
32617 msgid "6. Test"
32618 msgstr ""
32619
32620 #. type: textblock
32621 #: ../tools/virt-resize.pl:181
32622 msgid "Thoroughly test the new disk image I<before> discarding the old one."
32623 msgstr ""
32624
32625 #. type: textblock
32626 #: ../tools/virt-resize.pl:183
32627 msgid "If you are using libvirt, edit the XML to point at the new disk:"
32628 msgstr ""
32629
32630 #. type: verbatim
32631 #: ../tools/virt-resize.pl:185
32632 #, no-wrap
32633 msgid ""
32634 " # virsh edit guestname\n"
32635 "\n"
32636 msgstr ""
32637
32638 #. type: textblock
32639 #: ../tools/virt-resize.pl:187
32640 msgid ""
32641 "Change E<lt>source ...E<gt>, see L<http://libvirt.org/formatdomain."
32642 "html#elementsDisks>"
32643 msgstr ""
32644
32645 #. type: textblock
32646 #: ../tools/virt-resize.pl:190
32647 msgid "Then start up the domain with the new, resized disk:"
32648 msgstr ""
32649
32650 #. type: verbatim
32651 #: ../tools/virt-resize.pl:192
32652 #, no-wrap
32653 msgid ""
32654 " # virsh start guestname\n"
32655 "\n"
32656 msgstr ""
32657
32658 #. type: textblock
32659 #: ../tools/virt-resize.pl:194
32660 msgid ""
32661 "and check that it still works.  See also the L</NOTES> section below for "
32662 "additional information."
32663 msgstr ""
32664
32665 #. type: =item
32666 #: ../tools/virt-resize.pl:197
32667 msgid "7. Resize LVs etc inside the guest"
32668 msgstr ""
32669
32670 #. type: textblock
32671 #: ../tools/virt-resize.pl:199
32672 msgid "(This can also be done offline using L<guestfish(1)>)"
32673 msgstr ""
32674
32675 #. type: textblock
32676 #: ../tools/virt-resize.pl:201
32677 msgid ""
32678 "Once the guest has booted you should see the new space available, at least "
32679 "for filesystems that virt-resize knows how to resize, and for PVs.  The user "
32680 "may need to resize LVs inside PVs, and also resize filesystem types that "
32681 "virt-resize does not know how to expand."
32682 msgstr ""
32683
32684 #. type: =head2
32685 #: ../tools/virt-resize.pl:208
32686 msgid "SHRINKING A VIRTUAL MACHINE DISK"
32687 msgstr ""
32688
32689 #. type: textblock
32690 #: ../tools/virt-resize.pl:210
32691 msgid ""
32692 "Shrinking is somewhat more complex than expanding, and only an overview is "
32693 "given here."
32694 msgstr ""
32695
32696 #. type: textblock
32697 #: ../tools/virt-resize.pl:213
32698 msgid ""
32699 "Firstly virt-resize will not attempt to shrink any partition content (PVs, "
32700 "filesystems).  The user has to shrink content before passing the disk image "
32701 "to virt-resize, and virt-resize will check that the content has been shrunk "
32702 "properly."
32703 msgstr ""
32704
32705 #. type: textblock
32706 #: ../tools/virt-resize.pl:218
32707 msgid "(Shrinking can also be done offline using L<guestfish(1)>)"
32708 msgstr ""
32709
32710 #. type: textblock
32711 #: ../tools/virt-resize.pl:220
32712 msgid ""
32713 "After shrinking PVs and filesystems, shut down the guest, and proceed with "
32714 "steps 3 and 4 above to allocate a new disk image."
32715 msgstr ""
32716
32717 #. type: textblock
32718 #: ../tools/virt-resize.pl:223
32719 msgid ""
32720 "Then run virt-resize with any of the C<--shrink> and/or C<--resize> options."
32721 msgstr ""
32722
32723 #. type: =head2
32724 #: ../tools/virt-resize.pl:226
32725 msgid "IGNORING OR DELETING PARTITIONS"
32726 msgstr ""
32727
32728 #. type: textblock
32729 #: ../tools/virt-resize.pl:228
32730 msgid ""
32731 "virt-resize also gives a convenient way to ignore or delete partitions when "
32732 "copying from the input disk to the output disk.  Ignoring a partition speeds "
32733 "up the copy where you don't care about the existing contents of a "
32734 "partition.  Deleting a partition removes it completely, but note that it "
32735 "also renumbers any partitions after the one which is deleted, which can "
32736 "leave some guests unbootable."
32737 msgstr ""
32738
32739 #. type: =head2
32740 #: ../tools/virt-resize.pl:235
32741 msgid "QCOW2 AND NON-SPARSE RAW FORMATS"
32742 msgstr ""
32743
32744 #. type: textblock
32745 #: ../tools/virt-resize.pl:237
32746 msgid ""
32747 "If the input disk is in qcow2 format, then you may prefer that the output is "
32748 "in qcow2 format as well.  Alternately, virt-resize can convert the format on "
32749 "the fly.  The output format is simply determined by the format of the empty "
32750 "output container that you provide.  Thus to create qcow2 output, use:"
32751 msgstr ""
32752
32753 #. type: verbatim
32754 #: ../tools/virt-resize.pl:243
32755 #, no-wrap
32756 msgid ""
32757 " qemu-img create [-c] -f qcow2 outdisk [size]\n"
32758 "\n"
32759 msgstr ""
32760
32761 #. type: textblock
32762 #: ../tools/virt-resize.pl:245
32763 msgid "instead of the truncate command (use C<-c> for a compressed disk)."
32764 msgstr ""
32765
32766 #. type: textblock
32767 #: ../tools/virt-resize.pl:247
32768 msgid "Similarly, to get non-sparse raw output use:"
32769 msgstr ""
32770
32771 #. type: verbatim
32772 #: ../tools/virt-resize.pl:249
32773 #, no-wrap
32774 msgid ""
32775 " fallocate -l size outdisk\n"
32776 "\n"
32777 msgstr ""
32778
32779 #. type: textblock
32780 #: ../tools/virt-resize.pl:251
32781 msgid ""
32782 "(on older systems that don't have the L<fallocate(1)> command use C<dd if=/"
32783 "dev/zero of=outdisk bs=1M count=..>)"
32784 msgstr ""
32785
32786 #. type: textblock
32787 #: ../tools/virt-resize.pl:264
32788 msgid "Display help."
32789 msgstr ""
32790
32791 #. type: =item
32792 #: ../tools/virt-resize.pl:278
32793 msgid "B<--resize part=size>"
32794 msgstr ""
32795
32796 #. type: textblock
32797 #: ../tools/virt-resize.pl:280
32798 msgid ""
32799 "Resize the named partition (expanding or shrinking it) so that it has the "
32800 "given size."
32801 msgstr ""
32802
32803 #. type: textblock
32804 #: ../tools/virt-resize.pl:283
32805 msgid ""
32806 "C<size> can be expressed as an absolute number followed by b/K/M/G/T/P/E to "
32807 "mean bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, Petabytes or "
32808 "Exabytes; or as a percentage of the current size; or as a relative number or "
32809 "percentage.  For example:"
32810 msgstr ""
32811
32812 #. type: verbatim
32813 #: ../tools/virt-resize.pl:288
32814 #, no-wrap
32815 msgid ""
32816 " --resize /dev/sda2=10G\n"
32817 "\n"
32818 msgstr ""
32819
32820 #. type: verbatim
32821 #: ../tools/virt-resize.pl:290
32822 #, no-wrap
32823 msgid ""
32824 " --resize /dev/sda4=90%\n"
32825 "\n"
32826 msgstr ""
32827
32828 #. type: verbatim
32829 #: ../tools/virt-resize.pl:292
32830 #, no-wrap
32831 msgid ""
32832 " --resize /dev/sda2=+1G\n"
32833 "\n"
32834 msgstr ""
32835
32836 #. type: verbatim
32837 #: ../tools/virt-resize.pl:294
32838 #, no-wrap
32839 msgid ""
32840 " --resize /dev/sda2=-200M\n"
32841 "\n"
32842 msgstr ""
32843
32844 #. type: verbatim
32845 #: ../tools/virt-resize.pl:296
32846 #, no-wrap
32847 msgid ""
32848 " --resize /dev/sda1=+128K\n"
32849 "\n"
32850 msgstr ""
32851
32852 #. type: verbatim
32853 #: ../tools/virt-resize.pl:298
32854 #, no-wrap
32855 msgid ""
32856 " --resize /dev/sda1=+10%\n"
32857 "\n"
32858 msgstr ""
32859
32860 #. type: verbatim
32861 #: ../tools/virt-resize.pl:300
32862 #, no-wrap
32863 msgid ""
32864 " --resize /dev/sda1=-10%\n"
32865 "\n"
32866 msgstr ""
32867
32868 #. type: textblock
32869 #: ../tools/virt-resize.pl:302
32870 msgid ""
32871 "You can increase the size of any partition.  Virt-resize will expand the "
32872 "direct content of the partition if it knows how (see C<--expand> below)."
32873 msgstr ""
32874
32875 #. type: textblock
32876 #: ../tools/virt-resize.pl:306
32877 msgid ""
32878 "You can only I<decrease> the size of partitions that contain filesystems or "
32879 "PVs which have already been shrunk.  Virt-resize will check this has been "
32880 "done before proceeding, or else will print an error (see also C<--resize-"
32881 "force>)."
32882 msgstr ""
32883
32884 #. type: textblock
32885 #: ../tools/virt-resize.pl:311 ../tools/virt-resize.pl:403
32886 #: ../tools/virt-resize.pl:420
32887 msgid "You can give this option multiple times."
32888 msgstr ""
32889
32890 #. type: =item
32891 #: ../tools/virt-resize.pl:317
32892 msgid "B<--resize-force part=size>"
32893 msgstr ""
32894
32895 #. type: textblock
32896 #: ../tools/virt-resize.pl:319
32897 msgid ""
32898 "This is the same as C<--resize> except that it will let you decrease the "
32899 "size of any partition.  Generally this means you will lose any data which "
32900 "was at the end of the partition you shrink, but you may not care about that "
32901 "(eg. if shrinking an unused partition, or if you can easily recreate it such "
32902 "as a swap partition)."
32903 msgstr ""
32904
32905 #. type: textblock
32906 #: ../tools/virt-resize.pl:325
32907 msgid "See also the C<--ignore> option."
32908 msgstr ""
32909
32910 #. type: =item
32911 #: ../tools/virt-resize.pl:331
32912 msgid "B<--expand part>"
32913 msgstr ""
32914
32915 #. type: textblock
32916 #: ../tools/virt-resize.pl:333
32917 msgid ""
32918 "Expand the named partition so it uses up all extra space (space left over "
32919 "after any other resize changes that you request have been done)."
32920 msgstr ""
32921
32922 #. type: textblock
32923 #: ../tools/virt-resize.pl:336
32924 msgid ""
32925 "If virt-resize knows how, it will expand the direct content of the "
32926 "partition.  For example, if the partition is an LVM PV, it will expand the "
32927 "PV to fit (like calling L<pvresize(8)>).  Virt-resize leaves any other "
32928 "content it doesn't know about alone."
32929 msgstr ""
32930
32931 #. type: textblock
32932 #: ../tools/virt-resize.pl:341
32933 msgid "Currently virt-resize can resize:"
32934 msgstr ""
32935
32936 #. type: textblock
32937 #: ../tools/virt-resize.pl:347
32938 msgid ""
32939 "ext2, ext3 and ext4 filesystems when they are contained directly inside a "
32940 "partition."
32941 msgstr ""
32942
32943 #. type: textblock
32944 #: ../tools/virt-resize.pl:352
32945 msgid ""
32946 "NTFS filesystems contained directly in a partition, if libguestfs was "
32947 "compiled with support for NTFS."
32948 msgstr ""
32949
32950 #. type: textblock
32951 #: ../tools/virt-resize.pl:355
32952 msgid ""
32953 "The filesystem must have been shut down consistently last time it was used.  "
32954 "Additionally, L<ntfsresize(8)> marks the resized filesystem as requiring a "
32955 "consistency check, so at the first boot after resizing Windows will check "
32956 "the disk."
32957 msgstr ""
32958
32959 #. type: textblock
32960 #: ../tools/virt-resize.pl:362
32961 msgid ""
32962 "LVM PVs (physical volumes).  virt-resize does not usually resize anything "
32963 "inside the PV, but see the C<--LV-expand> option.  The user could also "
32964 "resize LVs as desired after boot."
32965 msgstr ""
32966
32967 #. type: textblock
32968 #: ../tools/virt-resize.pl:368 ../tools/virt-resize.pl:390
32969 msgid "Note that you cannot use C<--expand> and C<--shrink> together."
32970 msgstr ""
32971
32972 #. type: =item
32973 #: ../tools/virt-resize.pl:374
32974 msgid "B<--shrink part>"
32975 msgstr ""
32976
32977 #. type: textblock
32978 #: ../tools/virt-resize.pl:376
32979 msgid ""
32980 "Shrink the named partition until the overall disk image fits in the "
32981 "destination.  The named partition B<must> contain a filesystem or PV which "
32982 "has already been shrunk using another tool (eg. L<guestfish(1)> or other "
32983 "online tools).  Virt-resize will check this and give an error if it has not "
32984 "been done."
32985 msgstr ""
32986
32987 #. type: textblock
32988 #: ../tools/virt-resize.pl:382
32989 msgid ""
32990 "The amount by which the overall disk must be shrunk (after carrying out all "
32991 "other operations requested by the user) is called the \"deficit\".  For "
32992 "example, a straight copy (assume no other operations)  from a 5GB disk image "
32993 "to a 4GB disk image results in a 1GB deficit.  In this case, virt-resize "
32994 "would give an error unless the user specified a partition to shrink and that "
32995 "partition had more than a gigabyte of free space."
32996 msgstr ""
32997
32998 #. type: =item
32999 #: ../tools/virt-resize.pl:396
33000 msgid "B<--ignore part>"
33001 msgstr ""
33002
33003 #. type: textblock
33004 #: ../tools/virt-resize.pl:398
33005 msgid ""
33006 "Ignore the named partition.  Effectively this means the partition is "
33007 "allocated on the destination disk, but the content is not copied across from "
33008 "the source disk.  The content of the partition will be blank (all zero "
33009 "bytes)."
33010 msgstr ""
33011
33012 #. type: =item
33013 #: ../tools/virt-resize.pl:409
33014 msgid "B<--delete part>"
33015 msgstr ""
33016
33017 #. type: textblock
33018 #: ../tools/virt-resize.pl:411
33019 msgid ""
33020 "Delete the named partition.  It would be more accurate to describe this as "
33021 "\"don't copy it over\", since virt-resize doesn't do in-place changes and "
33022 "the original disk image is left intact."
33023 msgstr ""
33024
33025 #. type: textblock
33026 #: ../tools/virt-resize.pl:415
33027 msgid ""
33028 "Note that when you delete a partition, then anything contained in the "
33029 "partition is also deleted.  Furthermore, this causes any partitions that "
33030 "come after to be I<renumbered>, which can easily make your guest unbootable."
33031 msgstr ""
33032
33033 #. type: =item
33034 #: ../tools/virt-resize.pl:426
33035 msgid "B<--LV-expand logvol>"
33036 msgstr ""
33037
33038 #. type: textblock
33039 #: ../tools/virt-resize.pl:428
33040 msgid ""
33041 "This takes the logical volume and, as a final step, expands it to fill all "
33042 "the space available in its volume group.  A typical usage, assuming a Linux "
33043 "guest with a single PV C</dev/sda2> and a root device called C</dev/vg_guest/"
33044 "lv_root> would be:"
33045 msgstr ""
33046
33047 #. type: verbatim
33048 #: ../tools/virt-resize.pl:433
33049 #, no-wrap
33050 msgid ""
33051 " virt-resize indisk outdisk \\\n"
33052 "   --expand /dev/sda2 --LV-expand /dev/vg_guest/lv_root\n"
33053 "\n"
33054 msgstr ""
33055
33056 #. type: textblock
33057 #: ../tools/virt-resize.pl:436
33058 msgid ""
33059 "This would first expand the partition (and PV), and then expand the root "
33060 "device to fill the extra space in the PV."
33061 msgstr ""
33062
33063 #. type: textblock
33064 #: ../tools/virt-resize.pl:439
33065 msgid ""
33066 "The contents of the LV are also resized if virt-resize knows how to do "
33067 "that.  You can stop virt-resize from trying to expand the content by using "
33068 "the option C<--no-expand-content>."
33069 msgstr ""
33070
33071 #. type: textblock
33072 #: ../tools/virt-resize.pl:443
33073 msgid "Use L<virt-filesystems(1)> to list the filesystems in the guest."
33074 msgstr ""
33075
33076 #. type: textblock
33077 #: ../tools/virt-resize.pl:446
33078 msgid ""
33079 "You can give this option multiple times, I<but> it doesn't make sense to do "
33080 "this unless the logical volumes you specify are all in different volume "
33081 "groups."
33082 msgstr ""
33083
33084 #. type: =item
33085 #: ../tools/virt-resize.pl:454
33086 msgid "B<--no-copy-boot-loader>"
33087 msgstr ""
33088
33089 #. type: textblock
33090 #: ../tools/virt-resize.pl:456
33091 msgid ""
33092 "By default, virt-resize copies over some sectors at the start of the disk "
33093 "(up to the beginning of the first partition).  Commonly these sectors "
33094 "contain the Master Boot Record (MBR) and the boot loader, and are required "
33095 "in order for the guest to boot correctly."
33096 msgstr ""
33097
33098 #. type: textblock
33099 #: ../tools/virt-resize.pl:461
33100 msgid ""
33101 "If you specify this flag, then this initial copy is not done.  You may need "
33102 "to reinstall the boot loader in this case."
33103 msgstr ""
33104
33105 #. type: =item
33106 #: ../tools/virt-resize.pl:469
33107 msgid "B<--no-extra-partition>"
33108 msgstr ""
33109
33110 #. type: textblock
33111 #: ../tools/virt-resize.pl:471
33112 msgid ""
33113 "By default, virt-resize creates an extra partition if there is any extra, "
33114 "unused space after all resizing has happened.  Use this option to prevent "
33115 "the extra partition from being created.  If you do this then the extra space "
33116 "will be inaccessible until you run fdisk, parted, or some other partitioning "
33117 "tool in the guest."
33118 msgstr ""
33119
33120 #. type: textblock
33121 #: ../tools/virt-resize.pl:477
33122 msgid ""
33123 "Note that if the surplus space is smaller than 10 MB, no extra partition "
33124 "will be created."
33125 msgstr ""
33126
33127 #. type: =item
33128 #: ../tools/virt-resize.pl:484
33129 msgid "B<--no-expand-content>"
33130 msgstr ""
33131
33132 #. type: textblock
33133 #: ../tools/virt-resize.pl:486
33134 msgid ""
33135 "By default, virt-resize will try to expand the direct contents of "
33136 "partitions, if it knows how (see C<--expand> option above)."
33137 msgstr ""
33138
33139 #. type: textblock
33140 #: ../tools/virt-resize.pl:489
33141 msgid ""
33142 "If you give the C<--no-expand-content> option then virt-resize will not "
33143 "attempt this."
33144 msgstr ""
33145
33146 #. type: =item
33147 #: ../tools/virt-resize.pl:496
33148 msgid "B<-d> | B<--debug>"
33149 msgstr ""
33150
33151 #. type: =item
33152 #: ../tools/virt-resize.pl:504
33153 msgid "B<-n> | B<--dryrun>"
33154 msgstr ""
33155
33156 #. type: textblock
33157 #: ../tools/virt-resize.pl:506
33158 msgid "Print a summary of what would be done, but don't do anything."
33159 msgstr ""
33160
33161 #. type: =item
33162 #: ../tools/virt-resize.pl:512
33163 msgid "B<-q> | B<--quiet>"
33164 msgstr ""
33165
33166 #. type: textblock
33167 #: ../tools/virt-resize.pl:514
33168 msgid "Don't print the summary."
33169 msgstr ""
33170
33171 #. type: textblock
33172 #: ../tools/virt-resize.pl:522
33173 msgid ""
33174 "Specify the format of the input disk image.  If this flag is not given then "
33175 "it is auto-detected from the image itself."
33176 msgstr ""
33177
33178 #. type: textblock
33179 #: ../tools/virt-resize.pl:528
33180 msgid ""
33181 "Note that this option I<does not> affect the output format.  See L</QCOW2 "
33182 "AND NON-SPARSE RAW FORMATS>."
33183 msgstr ""
33184
33185 #. type: =item
33186 #: ../tools/virt-resize.pl:535
33187 msgid "B<--output-format> raw"
33188 msgstr ""
33189
33190 #. type: textblock
33191 #: ../tools/virt-resize.pl:537
33192 msgid ""
33193 "Specify the format of the output disk image.  If this flag is not given then "
33194 "it is auto-detected from the image itself."
33195 msgstr ""
33196
33197 #. type: textblock
33198 #: ../tools/virt-resize.pl:543
33199 msgid ""
33200 "Note that you still need to create the output disk with the right format.  "
33201 "See L</QCOW2 AND NON-SPARSE RAW FORMATS>."
33202 msgstr ""
33203
33204 #. type: =head1
33205 #: ../tools/virt-resize.pl:1419
33206 msgid "NOTES"
33207 msgstr ""
33208
33209 #. type: =head2
33210 #: ../tools/virt-resize.pl:1421
33211 msgid "\"Partition 1 does not end on cylinder boundary.\""
33212 msgstr ""
33213
33214 #. type: textblock
33215 #: ../tools/virt-resize.pl:1423
33216 msgid ""
33217 "Virt-resize aligns partitions to multiples of 64 sectors.  Usually this "
33218 "means the partitions will not be aligned to the ancient CHS geometry.  "
33219 "However CHS geometry is meaningless for disks manufactured since the early "
33220 "1990s, and doubly so for virtual hard drives.  Alignment of partitions to "
33221 "cylinders is not required by any modern operating system."
33222 msgstr ""
33223
33224 #. type: =head2
33225 #: ../tools/virt-resize.pl:1430
33226 msgid "RESIZING WINDOWS VIRTUAL MACHINES"
33227 msgstr ""
33228
33229 #. type: textblock
33230 #: ../tools/virt-resize.pl:1432
33231 msgid ""
33232 "In Windows Vista and later versions, Microsoft switched to using a separate "
33233 "boot partition.  In these VMs, typically C</dev/sda1> is the boot partition "
33234 "and C</dev/sda2> is the main (C:) drive.  We have not had any luck resizing "
33235 "the boot partition.  Doing so seems to break the guest completely.  However "
33236 "expanding the second partition (ie. C: drive) should work."
33237 msgstr ""
33238
33239 #. type: textblock
33240 #: ../tools/virt-resize.pl:1439
33241 msgid ""
33242 "Windows may initiate a lengthy \"chkdsk\" on first boot after a resize, if "
33243 "NTFS partitions have been expanded.  This is just a safety check and (unless "
33244 "it find errors) is nothing to worry about."
33245 msgstr ""
33246
33247 #. type: =head2
33248 #: ../tools/virt-resize.pl:1443
33249 msgid "GUEST BOOT STUCK AT \"GRUB\""
33250 msgstr ""
33251
33252 #. type: textblock
33253 #: ../tools/virt-resize.pl:1445
33254 msgid ""
33255 "If a Linux guest does not boot after resizing, and the boot is stuck after "
33256 "printing C<GRUB> on the console, try reinstalling grub.  This sometimes "
33257 "happens on older (RHEL 5-era) guests, for reasons we don't fully understand, "
33258 "although we think is to do with partition alignment."
33259 msgstr ""
33260
33261 #. type: verbatim
33262 #: ../tools/virt-resize.pl:1450
33263 #, no-wrap
33264 msgid ""
33265 " guestfish -i -a newdisk\n"
33266 " ><fs> cat /boot/grub/device.map\n"
33267 " # check the contents of this file are sensible or\n"
33268 " # edit the file if necessary\n"
33269 " ><fs> grub-install / /dev/vda\n"
33270 " ><fs> exit\n"
33271 "\n"
33272 msgstr ""
33273
33274 #. type: textblock
33275 #: ../tools/virt-resize.pl:1457
33276 msgid ""
33277 "For more flexible guest reconfiguration, including if you need to specify "
33278 "other parameters to grub-install, use L<virt-rescue(1)>."
33279 msgstr ""
33280
33281 #. type: =head1
33282 #: ../tools/virt-resize.pl:1460
33283 msgid "ALTERNATIVE TOOLS"
33284 msgstr ""
33285
33286 #. type: textblock
33287 #: ../tools/virt-resize.pl:1462
33288 msgid ""
33289 "There are several proprietary tools for resizing partitions.  We won't "
33290 "mention any here."
33291 msgstr ""
33292
33293 #. type: textblock
33294 #: ../tools/virt-resize.pl:1465
33295 msgid ""
33296 "L<parted(8)> and its graphical shell gparted can do some types of resizing "
33297 "operations on disk images.  They can resize and move partitions, but I don't "
33298 "think they can do anything with the contents, and they certainly don't "
33299 "understand LVM."
33300 msgstr ""
33301
33302 #. type: textblock
33303 #: ../tools/virt-resize.pl:1470
33304 msgid ""
33305 "L<guestfish(1)> can do everything that virt-resize can do and a lot more, "
33306 "but at a much lower level.  You will probably end up hand-calculating sector "
33307 "offsets, which is something that virt-resize was designed to avoid.  If you "
33308 "want to see the guestfish-equivalent commands that virt-resize runs, use the "
33309 "C<--debug> flag."
33310 msgstr ""
33311
33312 #. type: textblock
33313 #: ../tools/virt-resize.pl:1485
33314 msgid ""
33315 "L<virt-filesystems(1)>, L<virt-df(1)>, L<guestfs(3)>, L<guestfish(1)>, L<lvm"
33316 "(8)>, L<pvresize(8)>, L<lvresize(8)>, L<resize2fs(8)>, L<ntfsresize(8)>, "
33317 "L<virsh(1)>, L<parted(8)>, L<truncate(1)>, L<fallocate(1)>, L<grub(8)>, "
33318 "L<grub-install(8)>, L<virt-rescue(1)>, L<Sys::Guestfs(3)>, L<http://"
33319 "libguestfs.org/>."
33320 msgstr ""
33321
33322 #. type: textblock
33323 #: ../tools/virt-list-filesystems.pl:32
33324 msgid ""
33325 "virt-list-filesystems - List filesystems in a virtual machine or disk image"
33326 msgstr ""
33327
33328 #. type: verbatim
33329 #: ../tools/virt-list-filesystems.pl:36
33330 #, no-wrap
33331 msgid ""
33332 " virt-list-filesystems [--options] domname\n"
33333 "\n"
33334 msgstr ""
33335
33336 #. type: verbatim
33337 #: ../tools/virt-list-filesystems.pl:38
33338 #, no-wrap
33339 msgid ""
33340 " virt-list-filesystems [--options] disk.img [disk.img ...]\n"
33341 "\n"
33342 msgstr ""
33343
33344 #. type: textblock
33345 #: ../tools/virt-list-filesystems.pl:42 ../tools/virt-list-partitions.pl:42
33346 msgid ""
33347 "This tool is obsolete.  Use L<virt-filesystems(1)> as a more flexible "
33348 "replacement."
33349 msgstr ""
33350
33351 #. type: textblock
33352 #: ../tools/virt-list-filesystems.pl:45
33353 msgid ""
33354 "C<virt-list-filesystems> is a command line tool to list the filesystems that "
33355 "are contained in a virtual machine or disk image."
33356 msgstr ""
33357
33358 #. type: textblock
33359 #: ../tools/virt-list-filesystems.pl:49
33360 msgid ""
33361 "C<virt-list-filesystems> is just a simple wrapper around L<libguestfs(3)> "
33362 "functionality.  For more complex cases you should look at the L<guestfish(1)"
33363 "> tool."
33364 msgstr ""
33365
33366 #. type: =item
33367 #: ../tools/virt-list-filesystems.pl:106 ../tools/virt-list-partitions.pl:115
33368 msgid "B<-l> | B<--long>"
33369 msgstr ""
33370
33371 #. type: textblock
33372 #: ../tools/virt-list-filesystems.pl:108
33373 msgid ""
33374 "With this option, C<virt-list-filesystems> displays the type of each "
33375 "filesystem too (where \"type\" means C<ext3>, C<xfs> etc.)"
33376 msgstr ""
33377
33378 #. type: =item
33379 #: ../tools/virt-list-filesystems.pl:115
33380 msgid "B<-a> | B<--all>"
33381 msgstr ""
33382
33383 #. type: textblock
33384 #: ../tools/virt-list-filesystems.pl:117
33385 msgid ""
33386 "Normally we only show mountable filesystems.  If this option is given then "
33387 "swap devices are shown too."
33388 msgstr ""
33389
33390 #. type: textblock
33391 #: ../tools/virt-list-filesystems.pl:191
33392 msgid ""
33393 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-tar(1)>, L<virt-"
33394 "filesystems(1)>, L<virt-list-partitions(1)>, L<Sys::Guestfs(3)>, L<Sys::"
33395 "Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
33396 msgstr ""
33397
33398 #. type: textblock
33399 #: ../tools/virt-list-filesystems.pl:208 ../tools/virt-tar.pl:298
33400 msgid "Copyright (C) 2009 Red Hat Inc."
33401 msgstr ""
33402
33403 #. type: textblock
33404 #: ../tools/virt-tar.pl:33
33405 msgid "virt-tar - Extract or upload files to a virtual machine"
33406 msgstr ""
33407
33408 #. type: verbatim
33409 #: ../tools/virt-tar.pl:37
33410 #, no-wrap
33411 msgid ""
33412 " virt-tar [--options] -x domname directory tarball\n"
33413 "\n"
33414 msgstr ""
33415
33416 #. type: verbatim
33417 #: ../tools/virt-tar.pl:39
33418 #, no-wrap
33419 msgid ""
33420 " virt-tar [--options] -u domname tarball directory\n"
33421 "\n"
33422 msgstr ""
33423
33424 #. type: verbatim
33425 #: ../tools/virt-tar.pl:41
33426 #, no-wrap
33427 msgid ""
33428 " virt-tar [--options] disk.img [disk.img ...] -x directory tarball\n"
33429 "\n"
33430 msgstr ""
33431
33432 #. type: verbatim
33433 #: ../tools/virt-tar.pl:43
33434 #, no-wrap
33435 msgid ""
33436 " virt-tar [--options] disk.img [disk.img ...] -u tarball directory\n"
33437 "\n"
33438 msgstr ""
33439
33440 #. type: textblock
33441 #: ../tools/virt-tar.pl:47
33442 msgid "Download C</home> from the VM into a local tarball:"
33443 msgstr ""
33444
33445 #. type: verbatim
33446 #: ../tools/virt-tar.pl:49
33447 #, no-wrap
33448 msgid ""
33449 " virt-tar -x domname /home home.tar\n"
33450 "\n"
33451 msgstr ""
33452
33453 #. type: verbatim
33454 #: ../tools/virt-tar.pl:51
33455 #, no-wrap
33456 msgid ""
33457 " virt-tar -zx domname /home home.tar.gz\n"
33458 "\n"
33459 msgstr ""
33460
33461 #. type: textblock
33462 #: ../tools/virt-tar.pl:53
33463 msgid "Upload a local tarball and unpack it inside C</tmp> in the VM:"
33464 msgstr ""
33465
33466 #. type: verbatim
33467 #: ../tools/virt-tar.pl:55
33468 #, no-wrap
33469 msgid ""
33470 " virt-tar -u domname uploadstuff.tar /tmp\n"
33471 "\n"
33472 msgstr ""
33473
33474 #. type: verbatim
33475 #: ../tools/virt-tar.pl:57
33476 #, no-wrap
33477 msgid ""
33478 " virt-tar -zu domname uploadstuff.tar.gz /tmp\n"
33479 "\n"
33480 msgstr ""
33481
33482 #. type: textblock
33483 #: ../tools/virt-tar.pl:61
33484 msgid ""
33485 "You must I<not> use C<virt-tar> with the C<-u> option (upload) on live "
33486 "virtual machines.  If you do this, you risk disk corruption in the VM.  "
33487 "C<virt-tar> tries to stop you from doing this, but doesn't catch all cases."
33488 msgstr ""
33489
33490 #. type: textblock
33491 #: ../tools/virt-tar.pl:66
33492 msgid ""
33493 "You can use C<-x> (extract) on live virtual machines, but you might get "
33494 "inconsistent results or errors if there is filesystem activity inside the "
33495 "VM.  If the live VM is synched and quiescent, then C<virt-tar> will usually "
33496 "work, but the only way to guarantee consistent results is if the virtual "
33497 "machine is shut down."
33498 msgstr ""
33499
33500 #. type: textblock
33501 #: ../tools/virt-tar.pl:74
33502 msgid ""
33503 "C<virt-tar> is a general purpose archive tool for downloading and uploading "
33504 "parts of a guest filesystem.  There are many possibilities: making backups, "
33505 "uploading data files, snooping on guest activity, fixing or customizing "
33506 "guests, etc."
33507 msgstr ""
33508
33509 #. type: textblock
33510 #: ../tools/virt-tar.pl:79
33511 msgid ""
33512 "If you want to just view a single file, use L<virt-cat(1)>.  If you just "
33513 "want to edit a single file, use L<virt-edit(1)>.  For more complex cases you "
33514 "should look at the L<guestfish(1)> tool."
33515 msgstr ""
33516
33517 #. type: textblock
33518 #: ../tools/virt-tar.pl:83
33519 msgid ""
33520 "There are two modes of operation: C<-x> (eXtract) downloads a directory and "
33521 "its contents (recursively) from the virtual machine into a local tarball.  "
33522 "C<-u> uploads from a local tarball, unpacking it into a directory inside the "
33523 "virtual machine.  You cannot use these two options together."
33524 msgstr ""
33525
33526 #. type: textblock
33527 #: ../tools/virt-tar.pl:89
33528 msgid ""
33529 "In addition, you may need to use the C<-z> (gZip) option to enable "
33530 "compression.  When uploading, you have to specify C<-z> if the upload file "
33531 "is compressed because virt-tar won't detect this on its own."
33532 msgstr ""
33533
33534 #. type: textblock
33535 #: ../tools/virt-tar.pl:93
33536 msgid ""
33537 "C<virt-tar> can only handle tar (optionally gzipped) format tarballs.  For "
33538 "example it cannot do PKZip files or bzip2 compression.  If you want that "
33539 "then you'll have to rebuild the tarballs yourself.  (This is a limitation of "
33540 "the L<libguestfs(3)> API)."
33541 msgstr ""
33542
33543 #. type: =item
33544 #: ../tools/virt-tar.pl:151
33545 msgid "B<-x> | B<--extract> | B<--download>"
33546 msgstr ""
33547
33548 #. type: =item
33549 #: ../tools/virt-tar.pl:153
33550 msgid "B<-u> | B<--upload>"
33551 msgstr ""
33552
33553 #. type: textblock
33554 #: ../tools/virt-tar.pl:155
33555 msgid ""
33556 "Use C<-x> to extract (download) a directory from a virtual machine to a "
33557 "local tarball."
33558 msgstr ""
33559
33560 #. type: textblock
33561 #: ../tools/virt-tar.pl:158
33562 msgid ""
33563 "Use C<-u> to upload and unpack from a local tarball into a virtual machine.  "
33564 "Please read the L</WARNING> section above before using this option."
33565 msgstr ""
33566
33567 #. type: textblock
33568 #: ../tools/virt-tar.pl:162
33569 msgid "You must specify exactly one of these options."
33570 msgstr ""
33571
33572 #. type: =item
33573 #: ../tools/virt-tar.pl:168
33574 msgid "B<-z> | B<--gzip>"
33575 msgstr ""
33576
33577 #. type: textblock
33578 #: ../tools/virt-tar.pl:170
33579 msgid "Specify that the input or output tarball is gzip-compressed."
33580 msgstr ""
33581
33582 #. type: textblock
33583 #: ../tools/virt-tar.pl:283
33584 msgid ""
33585 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-edit(1)>, L<Sys::"
33586 "Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs."
33587 "org/>."
33588 msgstr ""
33589
33590 #. type: textblock
33591 #: ../tools/virt-make-fs.pl:37
33592 msgid "virt-make-fs - Make a filesystem from a tar archive or files"
33593 msgstr ""
33594
33595 #. type: verbatim
33596 #: ../tools/virt-make-fs.pl:41
33597 #, no-wrap
33598 msgid ""
33599 " virt-make-fs [--options] input.tar output.img\n"
33600 "\n"
33601 msgstr ""
33602
33603 #. type: verbatim
33604 #: ../tools/virt-make-fs.pl:43
33605 #, no-wrap
33606 msgid ""
33607 " virt-make-fs [--options] input.tar.gz output.img\n"
33608 "\n"
33609 msgstr ""
33610
33611 #. type: verbatim
33612 #: ../tools/virt-make-fs.pl:45
33613 #, no-wrap
33614 msgid ""
33615 " virt-make-fs [--options] directory output.img\n"
33616 "\n"
33617 msgstr ""
33618
33619 #. type: textblock
33620 #: ../tools/virt-make-fs.pl:49
33621 msgid ""
33622 "Virt-make-fs is a command line tool for creating a filesystem from a tar "
33623 "archive or some files in a directory.  It is similar to tools like L<mkisofs"
33624 "(1)>, L<genisoimage(1)> and L<mksquashfs(1)>.  Unlike those tools, it can "
33625 "create common filesystem types like ext2/3 or NTFS, which can be useful if "
33626 "you want to attach these filesystems to existing virtual machines (eg. to "
33627 "import large amounts of read-only data to a VM)."
33628 msgstr ""
33629
33630 #. type: textblock
33631 #: ../tools/virt-make-fs.pl:57
33632 msgid "Basic usage is:"
33633 msgstr ""
33634
33635 #. type: verbatim
33636 #: ../tools/virt-make-fs.pl:59
33637 #, no-wrap
33638 msgid ""
33639 " virt-make-fs input output\n"
33640 "\n"
33641 msgstr ""
33642
33643 #. type: textblock
33644 #: ../tools/virt-make-fs.pl:61
33645 msgid ""
33646 "where C<input> is either a directory containing files that you want to add, "
33647 "or a tar archive (either uncompressed tar or gzip-compressed tar); and "
33648 "C<output> is a disk image.  The input type is detected automatically.  The "
33649 "output disk image defaults to a raw ext2 image unless you specify extra "
33650 "flags (see L</OPTIONS> below)."
33651 msgstr ""
33652
33653 #. type: =head2
33654 #: ../tools/virt-make-fs.pl:67
33655 msgid "EXTRA SPACE"
33656 msgstr ""
33657
33658 #. type: textblock
33659 #: ../tools/virt-make-fs.pl:69
33660 msgid ""
33661 "Unlike formats such as tar and squashfs, a filesystem does not \"just fit\" "
33662 "the files that it contains, but might have extra space.  Depending on how "
33663 "you are going to use the output, you might think this extra space is wasted "
33664 "and want to minimize it, or you might want to leave space so that more files "
33665 "can be added later.  Virt-make-fs defaults to minimizing the extra space, "
33666 "but you can use the C<--size> flag to leave space in the filesystem if you "
33667 "want it."
33668 msgstr ""
33669
33670 #. type: textblock
33671 #: ../tools/virt-make-fs.pl:77
33672 msgid ""
33673 "An alternative way to leave extra space but not make the output image any "
33674 "bigger is to use an alternative disk image format (instead of the default "
33675 "\"raw\" format).  Using C<--format=qcow2> will use the native QEmu/KVM qcow2 "
33676 "image format (check your hypervisor supports this before using it).  This "
33677 "allows you to choose a large C<--size> but the extra space won't actually be "
33678 "allocated in the image until you try to store something in it."
33679 msgstr ""
33680
33681 #. type: textblock
33682 #: ../tools/virt-make-fs.pl:85
33683 msgid ""
33684 "Don't forget that you can also use local commands including L<resize2fs(8)> "
33685 "and L<virt-resize(1)> to resize existing filesystems, or rerun virt-make-fs "
33686 "to build another image from scratch."
33687 msgstr ""
33688
33689 #. type: =head3
33690 #: ../tools/virt-make-fs.pl:89 ../tools/virt-make-fs.pl:123
33691 #: ../tools/virt-make-fs.pl:142
33692 msgid "EXAMPLE"
33693 msgstr ""
33694
33695 #. type: verbatim
33696 #: ../tools/virt-make-fs.pl:91
33697 #, no-wrap
33698 msgid ""
33699 " virt-make-fs --format=qcow2 --size=+200M input output.img\n"
33700 "\n"
33701 msgstr ""
33702
33703 #. type: =head2
33704 #: ../tools/virt-make-fs.pl:93
33705 msgid "FILESYSTEM TYPE"
33706 msgstr ""
33707
33708 #. type: textblock
33709 #: ../tools/virt-make-fs.pl:95
33710 msgid ""
33711 "The default filesystem type is C<ext2>.  Just about any filesystem type that "
33712 "libguestfs supports can be used (but I<not> read-only formats like "
33713 "ISO9660).  Here are some of the more common choices:"
33714 msgstr ""
33715
33716 #. type: =item
33717 #: ../tools/virt-make-fs.pl:101
33718 msgid "I<ext3>"
33719 msgstr ""
33720
33721 #. type: textblock
33722 #: ../tools/virt-make-fs.pl:103
33723 msgid ""
33724 "Note that ext3 filesystems contain a journal, typically 1-32 MB in size.  If "
33725 "you are not going to use the filesystem in a way that requires the journal, "
33726 "then this is just wasted overhead."
33727 msgstr ""
33728
33729 #. type: =item
33730 #: ../tools/virt-make-fs.pl:107
33731 msgid "I<ntfs> or I<vfat>"
33732 msgstr ""
33733
33734 #. type: textblock
33735 #: ../tools/virt-make-fs.pl:109
33736 msgid "Useful if exporting data to a Windows guest."
33737 msgstr ""
33738
33739 #. type: textblock
33740 #: ../tools/virt-make-fs.pl:111
33741 msgid ""
33742 "I<Note for vfat>: The tar archive or local directory must only contain files "
33743 "which are owned by root (ie. UID:GID = 0:0).  The reason is that the tar "
33744 "program running within libguestfs is unable to change the ownership of non-"
33745 "root files, since vfat itself does not support this."
33746 msgstr ""
33747
33748 #. type: =item
33749 #: ../tools/virt-make-fs.pl:116
33750 msgid "I<minix>"
33751 msgstr ""
33752
33753 #. type: textblock
33754 #: ../tools/virt-make-fs.pl:118
33755 msgid ""
33756 "Lower overhead than C<ext2>, but certain limitations on filename length and "
33757 "total filesystem size."
33758 msgstr ""
33759
33760 #. type: verbatim
33761 #: ../tools/virt-make-fs.pl:125
33762 #, no-wrap
33763 msgid ""
33764 " virt-make-fs --type=minix input minixfs.img\n"
33765 "\n"
33766 msgstr ""
33767
33768 #. type: =head2
33769 #: ../tools/virt-make-fs.pl:127
33770 msgid "TO PARTITION OR NOT TO PARTITION"
33771 msgstr ""
33772
33773 #. type: textblock
33774 #: ../tools/virt-make-fs.pl:129
33775 msgid "Optionally virt-make-fs can add a partition table to the output disk."
33776 msgstr ""
33777
33778 #. type: textblock
33779 #: ../tools/virt-make-fs.pl:131
33780 msgid ""
33781 "Adding a partition can make the disk image more compatible with certain "
33782 "virtualized operating systems which don't expect to see a filesystem "
33783 "directly located on a block device (Linux doesn't care and will happily "
33784 "handle both types)."
33785 msgstr ""
33786
33787 #. type: textblock
33788 #: ../tools/virt-make-fs.pl:136
33789 msgid ""
33790 "On the other hand, if you have a partition table then the output image is no "
33791 "longer a straight filesystem.  For example you cannot run L<fsck(8)> "
33792 "directly on a partitioned disk image.  (However libguestfs tools such as "
33793 "L<guestfish(1)> and L<virt-resize(1)> can still be used)."
33794 msgstr ""
33795
33796 #. type: textblock
33797 #: ../tools/virt-make-fs.pl:144
33798 msgid "Add an MBR partition:"
33799 msgstr ""
33800
33801 #. type: verbatim
33802 #: ../tools/virt-make-fs.pl:146
33803 #, no-wrap
33804 msgid ""
33805 " virt-make-fs --partition -- input disk.img\n"
33806 "\n"
33807 msgstr ""
33808
33809 #. type: textblock
33810 #: ../tools/virt-make-fs.pl:148
33811 msgid ""
33812 "If the output disk image could be terabyte-sized or larger, it's better to "
33813 "use an EFI/GPT-compatible partition table:"
33814 msgstr ""
33815
33816 #. type: verbatim
33817 #: ../tools/virt-make-fs.pl:151
33818 #, no-wrap
33819 msgid ""
33820 " virt-make-fs --partition=gpt --size=+4T --format=qcow2 input disk.img\n"
33821 "\n"
33822 msgstr ""
33823
33824 #. type: textblock
33825 #: ../tools/virt-make-fs.pl:179
33826 msgid "Enable debugging information."
33827 msgstr ""
33828
33829 #. type: =item
33830 #: ../tools/virt-make-fs.pl:185
33831 msgid "B<--size=E<lt>NE<gt>>"
33832 msgstr ""
33833
33834 #. type: =item
33835 #: ../tools/virt-make-fs.pl:187
33836 msgid "B<--size=+E<lt>NE<gt>>"
33837 msgstr ""
33838
33839 #. type: =item
33840 #: ../tools/virt-make-fs.pl:189
33841 msgid "B<-s E<lt>NE<gt>>"
33842 msgstr ""
33843
33844 #. type: =item
33845 #: ../tools/virt-make-fs.pl:191
33846 msgid "B<-s +E<lt>NE<gt>>"
33847 msgstr ""
33848
33849 #. type: textblock
33850 #: ../tools/virt-make-fs.pl:193
33851 msgid ""
33852 "Use the C<--size> (or C<-s>) option to choose the size of the output image."
33853 msgstr ""
33854
33855 #. type: textblock
33856 #: ../tools/virt-make-fs.pl:196
33857 msgid ""
33858 "If this option is I<not> given, then the output image will be just large "
33859 "enough to contain all the files, with not much wasted space."
33860 msgstr ""
33861
33862 #. type: textblock
33863 #: ../tools/virt-make-fs.pl:199
33864 msgid ""
33865 "To choose a fixed size output disk, specify an absolute number followed by b/"
33866 "K/M/G/T/P/E to mean bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, "
33867 "Petabytes or Exabytes.  This must be large enough to contain all the input "
33868 "files, else you will get an error."
33869 msgstr ""
33870
33871 #. type: textblock
33872 #: ../tools/virt-make-fs.pl:204
33873 msgid ""
33874 "To leave extra space, specify C<+> (plus sign) and a number followed by b/K/"
33875 "M/G/T/P/E to mean bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, "
33876 "Petabytes or Exabytes.  For example: C<--size=+200M> means enough space for "
33877 "the input files, and (approximately) an extra 200 MB free space."
33878 msgstr ""
33879
33880 #. type: textblock
33881 #: ../tools/virt-make-fs.pl:210
33882 msgid ""
33883 "Note that virt-make-fs estimates free space, and therefore will not produce "
33884 "filesystems containing precisely the free space requested.  (It is much more "
33885 "expensive and time-consuming to produce a filesystem which has precisely the "
33886 "desired free space)."
33887 msgstr ""
33888
33889 #. type: =item
33890 #: ../tools/virt-make-fs.pl:219
33891 msgid "B<--format=E<lt>fmtE<gt>>"
33892 msgstr ""
33893
33894 #. type: =item
33895 #: ../tools/virt-make-fs.pl:221
33896 msgid "B<-F E<lt>fmtE<gt>>"
33897 msgstr ""
33898
33899 #. type: textblock
33900 #: ../tools/virt-make-fs.pl:223
33901 msgid "Choose the output disk image format."
33902 msgstr ""
33903
33904 #. type: textblock
33905 #: ../tools/virt-make-fs.pl:225
33906 msgid "The default is C<raw> (raw disk image)."
33907 msgstr ""
33908
33909 #. type: textblock
33910 #: ../tools/virt-make-fs.pl:227
33911 msgid ""
33912 "For other choices, see the L<qemu-img(1)> manpage.  The only other choice "
33913 "that would really make sense here is C<qcow2>."
33914 msgstr ""
33915
33916 #. type: =item
33917 #: ../tools/virt-make-fs.pl:234
33918 msgid "B<--type=E<lt>fsE<gt>>"
33919 msgstr ""
33920
33921 #. type: =item
33922 #: ../tools/virt-make-fs.pl:236
33923 msgid "B<-t E<lt>fsE<gt>>"
33924 msgstr ""
33925
33926 #. type: textblock
33927 #: ../tools/virt-make-fs.pl:238
33928 msgid "Choose the output filesystem type."
33929 msgstr ""
33930
33931 #. type: textblock
33932 #: ../tools/virt-make-fs.pl:240
33933 msgid "The default is C<ext2>."
33934 msgstr ""
33935
33936 #. type: textblock
33937 #: ../tools/virt-make-fs.pl:242
33938 msgid ""
33939 "Any filesystem which is supported read-write by libguestfs can be used here."
33940 msgstr ""
33941
33942 #. type: =item
33943 #: ../tools/virt-make-fs.pl:249
33944 msgid "B<--partition>"
33945 msgstr ""
33946
33947 #. type: =item
33948 #: ../tools/virt-make-fs.pl:251
33949 msgid "B<--partition=E<lt>parttypeE<gt>>"
33950 msgstr ""
33951
33952 #. type: textblock
33953 #: ../tools/virt-make-fs.pl:253
33954 msgid ""
33955 "If specified, this flag adds an MBR partition table to the output disk image."
33956 msgstr ""
33957
33958 #. type: textblock
33959 #: ../tools/virt-make-fs.pl:256
33960 msgid ""
33961 "You can change the partition table type, eg. C<--partition=gpt> for large "
33962 "disks."
33963 msgstr ""
33964
33965 #. type: textblock
33966 #: ../tools/virt-make-fs.pl:259
33967 msgid ""
33968 "Note that if you just use a lonesome C<--partition>, the Perl option parser "
33969 "might consider the next parameter to be the partition type.  For example:"
33970 msgstr ""
33971
33972 #. type: verbatim
33973 #: ../tools/virt-make-fs.pl:263
33974 #, no-wrap
33975 msgid ""
33976 " virt-make-fs --partition input.tar ...\n"
33977 "\n"
33978 msgstr ""
33979
33980 #. type: textblock
33981 #: ../tools/virt-make-fs.pl:265
33982 msgid ""
33983 "would cause virt-make-fs to think you wanted to use a partition type of "
33984 "C<input.tar> which is completely wrong.  To avoid this, use C<--> (a double "
33985 "dash) between options and the input file argument:"
33986 msgstr ""
33987
33988 #. type: verbatim
33989 #: ../tools/virt-make-fs.pl:269
33990 #, no-wrap
33991 msgid ""
33992 " virt-make-fs --partition -- input.tar ...\n"
33993 "\n"
33994 msgstr ""
33995
33996 #. type: textblock
33997 #: ../tools/virt-make-fs.pl:541
33998 msgid ""
33999 "L<guestfish(1)>, L<virt-resize(1)>, L<virt-tar(1)>, L<mkisofs(1)>, "
34000 "L<genisoimage(1)>, L<mksquashfs(1)>, L<mke2fs(8)>, L<resize2fs(8)>, L<guestfs"
34001 "(3)>, L<Sys::Guestfs(3)>, L<http://libguestfs.org/>."
34002 msgstr ""
34003
34004 #. type: verbatim
34005 #: ../tools/virt-make-fs.pl:558
34006 #, no-wrap
34007 msgid ""
34008 " export LIBGUESTFS_DEBUG=1\n"
34009 " virt-make-fs --debug [...] > /tmp/virt-make-fs.log 2>&1\n"
34010 "\n"
34011 msgstr ""
34012
34013 #. type: textblock
34014 #: ../tools/virt-make-fs.pl:561
34015 msgid ""
34016 "Attach /tmp/virt-make-fs.log to a new bug report at L<https://bugzilla."
34017 "redhat.com/>"
34018 msgstr ""
34019
34020 #. type: textblock
34021 #: ../tools/virt-list-partitions.pl:32
34022 msgid ""
34023 "virt-list-partitions - List partitions in a virtual machine or disk image"
34024 msgstr ""
34025
34026 #. type: verbatim
34027 #: ../tools/virt-list-partitions.pl:36
34028 #, no-wrap
34029 msgid ""
34030 " virt-list-partitions [--options] domname\n"
34031 "\n"
34032 msgstr ""
34033
34034 #. type: verbatim
34035 #: ../tools/virt-list-partitions.pl:38
34036 #, no-wrap
34037 msgid ""
34038 " virt-list-partitions [--options] disk.img [disk.img ...]\n"
34039 "\n"
34040 msgstr ""
34041
34042 #. type: textblock
34043 #: ../tools/virt-list-partitions.pl:45
34044 msgid ""
34045 "C<virt-list-partitions> is a command line tool to list the partitions that "
34046 "are contained in a virtual machine or disk image.  It is mainly useful as a "
34047 "first step to using L<virt-resize(1)>."
34048 msgstr ""
34049
34050 #. type: textblock
34051 #: ../tools/virt-list-partitions.pl:50
34052 msgid ""
34053 "C<virt-list-partitions> is just a simple wrapper around L<libguestfs(3)> "
34054 "functionality.  For more complex cases you should look at the L<guestfish(1)"
34055 "> tool."
34056 msgstr ""
34057
34058 #. type: =item
34059 #: ../tools/virt-list-partitions.pl:107
34060 msgid "B<-h> | B<--human-readable>"
34061 msgstr ""
34062
34063 #. type: textblock
34064 #: ../tools/virt-list-partitions.pl:109
34065 msgid "Show sizes in human-readable form (eg. \"1G\")."
34066 msgstr ""
34067
34068 #. type: textblock
34069 #: ../tools/virt-list-partitions.pl:117
34070 msgid ""
34071 "With this option, C<virt-list-partitions> displays the type and size of each "
34072 "partition too (where \"type\" means C<ext3>, C<pv> etc.)"
34073 msgstr ""
34074
34075 #. type: =item
34076 #: ../tools/virt-list-partitions.pl:124
34077 msgid "B<-t> | B<--total>"
34078 msgstr ""
34079
34080 #. type: textblock
34081 #: ../tools/virt-list-partitions.pl:126
34082 msgid ""
34083 "Display the total size of each block device (as a separate row or rows)."
34084 msgstr ""
34085
34086 #. type: textblock
34087 #: ../tools/virt-list-partitions.pl:259
34088 msgid ""
34089 "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
34090 "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib"
34091 "(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
34092 msgstr ""
34093
34094 #. type: textblock
34095 #: ../tools/virt-list-partitions.pl:275
34096 msgid "Copyright (C) 2009-2010 Red Hat Inc."
34097 msgstr ""