perl: Fix another place where qw() was used as parentheses.
[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-07-13 17:55+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-list-filesystems.pl:30 ../tools/virt-tar.pl:31
25 #: ../tools/virt-make-fs.pl:35 ../tools/virt-list-partitions.pl:30
26 msgid "NAME"
27 msgstr "名前"
28
29 # type: textblock
30 #. type: textblock
31 #: ../src/guestfs.pod:5
32 msgid "guestfs - Library for accessing and modifying virtual machine images"
33 msgstr ""
34
35 # type: =head1
36 #. type: =head1
37 #: ../src/guestfs.pod:7 ../fish/guestfish.pod:7
38 #: ../test-tool/libguestfs-test-tool.pod:7 ../fuse/guestmount.pod:7
39 #: ../tools/virt-edit.pl:36 ../tools/virt-win-reg.pl:39
40 #: ../tools/virt-list-filesystems.pl:34 ../tools/virt-tar.pl:35
41 #: ../tools/virt-make-fs.pl:39 ../tools/virt-list-partitions.pl:34
42 msgid "SYNOPSIS"
43 msgstr ""
44
45 # type: verbatim
46 #. type: verbatim
47 #: ../src/guestfs.pod:9
48 #, no-wrap
49 msgid ""
50 " #include <guestfs.h>\n"
51 " \n"
52 msgstr ""
53
54 # type: verbatim
55 #. type: verbatim
56 #: ../src/guestfs.pod:11
57 #, no-wrap
58 msgid ""
59 " guestfs_h *g = guestfs_create ();\n"
60 " guestfs_add_drive (g, \"guest.img\");\n"
61 " guestfs_launch (g);\n"
62 " guestfs_mount (g, \"/dev/sda1\", \"/\");\n"
63 " guestfs_touch (g, \"/hello\");\n"
64 " guestfs_umount (g, \"/\");\n"
65 " guestfs_close (g);\n"
66 "\n"
67 msgstr ""
68
69 # type: verbatim
70 #. type: verbatim
71 #: ../src/guestfs.pod:19
72 #, no-wrap
73 msgid ""
74 " cc prog.c -o prog -lguestfs\n"
75 "or:\n"
76 " cc prog.c -o prog `pkg-config libguestfs --cflags --libs`\n"
77 "\n"
78 msgstr ""
79
80 # type: =head1
81 #. type: =head1
82 #: ../src/guestfs.pod:23 ../fish/guestfish.pod:30
83 #: ../test-tool/libguestfs-test-tool.pod:11 ../fuse/guestmount.pod:20
84 #: ../tools/virt-edit.pl:50 ../tools/virt-win-reg.pl:63
85 #: ../tools/virt-list-filesystems.pl:40 ../tools/virt-tar.pl:77
86 #: ../tools/virt-make-fs.pl:47 ../tools/virt-list-partitions.pl:40
87 msgid "DESCRIPTION"
88 msgstr ""
89
90 # type: textblock
91 #. type: textblock
92 #: ../src/guestfs.pod:25
93 msgid ""
94 "Libguestfs is a library for accessing and modifying guest disk images.  "
95 "Amongst the things this is good for: making batch configuration changes to "
96 "guests, getting disk used/free statistics (see also: virt-df), migrating "
97 "between virtualization systems (see also: virt-p2v), performing partial "
98 "backups, performing partial guest clones, cloning guests and changing "
99 "registry/UUID/hostname info, and much else besides."
100 msgstr ""
101
102 # type: textblock
103 #. type: textblock
104 #: ../src/guestfs.pod:33
105 msgid ""
106 "Libguestfs uses Linux kernel and qemu code, and can access any type of guest "
107 "filesystem that Linux and qemu can, including but not limited to: ext2/3/4, "
108 "btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, "
109 "qcow2, vmdk."
110 msgstr ""
111
112 # type: textblock
113 #. type: textblock
114 #: ../src/guestfs.pod:38
115 msgid ""
116 "Libguestfs provides ways to enumerate guest storage (eg. partitions, LVs, "
117 "what filesystem is in each LV, etc.).  It can also run commands in the "
118 "context of the guest.  Also you can access filesystems over FUSE."
119 msgstr ""
120
121 # type: textblock
122 #. type: textblock
123 #: ../src/guestfs.pod:43
124 msgid ""
125 "Libguestfs is a library that can be linked with C and C++ management "
126 "programs (or management programs written in OCaml, Perl, Python, Ruby, Java, "
127 "PHP, Haskell or C#).  You can also use it from shell scripts or the command "
128 "line."
129 msgstr ""
130
131 # type: textblock
132 #. type: textblock
133 #: ../src/guestfs.pod:48
134 msgid ""
135 "You don't need to be root to use libguestfs, although obviously you do need "
136 "enough permissions to access the disk images."
137 msgstr ""
138
139 # type: textblock
140 #. type: textblock
141 #: ../src/guestfs.pod:51
142 msgid ""
143 "Libguestfs is a large API because it can do many things.  For a gentle "
144 "introduction, please read the L</API OVERVIEW> section next."
145 msgstr ""
146
147 # type: textblock
148 #. type: textblock
149 #: ../src/guestfs.pod:54
150 msgid ""
151 "There are also some example programs in the L<guestfs-examples(3)> manual "
152 "page."
153 msgstr ""
154
155 # type: =head1
156 #. type: =head1
157 #: ../src/guestfs.pod:57
158 msgid "API OVERVIEW"
159 msgstr ""
160
161 # type: textblock
162 #. type: textblock
163 #: ../src/guestfs.pod:59
164 msgid ""
165 "This section provides a gentler overview of the libguestfs API.  We also try "
166 "to group API calls together, where that may not be obvious from reading "
167 "about the individual calls in the main section of this manual."
168 msgstr ""
169
170 # type: =head2
171 #. type: =head2
172 #: ../src/guestfs.pod:64
173 msgid "HANDLES"
174 msgstr ""
175
176 # type: textblock
177 #. type: textblock
178 #: ../src/guestfs.pod:66
179 msgid ""
180 "Before you can use libguestfs calls, you have to create a handle.  Then you "
181 "must add at least one disk image to the handle, followed by launching the "
182 "handle, then performing whatever operations you want, and finally closing "
183 "the handle.  By convention we use the single letter C<g> for the name of the "
184 "handle variable, although of course you can use any name you want."
185 msgstr ""
186
187 # type: textblock
188 #. type: textblock
189 #: ../src/guestfs.pod:73
190 msgid "The general structure of all libguestfs-using programs looks like this:"
191 msgstr ""
192
193 # type: verbatim
194 #. type: verbatim
195 #: ../src/guestfs.pod:76
196 #, no-wrap
197 msgid ""
198 " guestfs_h *g = guestfs_create ();\n"
199 " \n"
200 msgstr ""
201
202 # type: verbatim
203 #. type: verbatim
204 #: ../src/guestfs.pod:78
205 #, no-wrap
206 msgid ""
207 " /* Call guestfs_add_drive additional times if there are\n"
208 "  * multiple disk images.\n"
209 "  */\n"
210 " guestfs_add_drive (g, \"guest.img\");\n"
211 " \n"
212 msgstr ""
213
214 # type: verbatim
215 #. type: verbatim
216 #: ../src/guestfs.pod:83
217 #, no-wrap
218 msgid ""
219 " /* Most manipulation calls won't work until you've launched\n"
220 "  * the handle 'g'.  You have to do this _after_ adding drives\n"
221 "  * and _before_ other commands.\n"
222 "  */\n"
223 " guestfs_launch (g);\n"
224 " \n"
225 msgstr ""
226
227 # type: verbatim
228 #. type: verbatim
229 #: ../src/guestfs.pod:89
230 #, no-wrap
231 msgid ""
232 " /* Now you can examine what partitions, LVs etc are available.\n"
233 "  */\n"
234 " char **partitions = guestfs_list_partitions (g);\n"
235 " char **logvols = guestfs_lvs (g);\n"
236 " \n"
237 msgstr ""
238
239 # type: verbatim
240 #. type: verbatim
241 #: ../src/guestfs.pod:94
242 #, no-wrap
243 msgid ""
244 " /* To access a filesystem in the image, you must mount it.\n"
245 "  */\n"
246 " guestfs_mount (g, \"/dev/sda1\", \"/\");\n"
247 " \n"
248 msgstr ""
249
250 #. type: verbatim
251 #: ../src/guestfs.pod:98
252 #, no-wrap
253 msgid ""
254 " /* Now you can perform filesystem actions on the guest\n"
255 "  * disk image.\n"
256 "  */\n"
257 " guestfs_touch (g, \"/hello\");\n"
258 " \n"
259 msgstr ""
260
261 # type: verbatim
262 #. type: verbatim
263 #: ../src/guestfs.pod:103
264 #, no-wrap
265 msgid ""
266 " /* This is only needed for libguestfs < 1.5.24.  Since then\n"
267 "  * it is done automatically when you close the handle.  See\n"
268 "  * discussion of autosync in this page.\n"
269 "  */\n"
270 " guestfs_sync (g);\n"
271 " \n"
272 msgstr ""
273
274 # type: verbatim
275 #. type: verbatim
276 #: ../src/guestfs.pod:109
277 #, no-wrap
278 msgid ""
279 " /* Close the handle 'g'. */\n"
280 " guestfs_close (g);\n"
281 "\n"
282 msgstr ""
283
284 # type: textblock
285 #. type: textblock
286 #: ../src/guestfs.pod:112
287 msgid ""
288 "The code above doesn't include any error checking.  In real code you should "
289 "check return values carefully for errors.  In general all functions that "
290 "return integers return C<-1> on error, and all functions that return "
291 "pointers return C<NULL> on error.  See section L</ERROR HANDLING> below for "
292 "how to handle errors, and consult the documentation for each function call "
293 "below to see precisely how they return error indications.  See L<guestfs-"
294 "examples(3)> for fully worked examples."
295 msgstr ""
296
297 # type: =head2
298 #. type: =head2
299 #: ../src/guestfs.pod:121
300 msgid "DISK IMAGES"
301 msgstr ""
302
303 # type: textblock
304 #. type: textblock
305 #: ../src/guestfs.pod:123
306 msgid ""
307 "The image filename (C<\"guest.img\"> in the example above) could be a disk "
308 "image from a virtual machine, a L<dd(1)> copy of a physical hard disk, an "
309 "actual block device, or simply an empty file of zeroes that you have created "
310 "through L<posix_fallocate(3)>.  Libguestfs lets you do useful things to all "
311 "of these."
312 msgstr ""
313
314 # type: textblock
315 #. type: textblock
316 #: ../src/guestfs.pod:129
317 msgid ""
318 "The call you should use in modern code for adding drives is L</"
319 "guestfs_add_drive_opts>.  To add a disk image, allowing writes, and "
320 "specifying that the format is raw, do:"
321 msgstr ""
322
323 # type: verbatim
324 #. type: verbatim
325 #: ../src/guestfs.pod:133
326 #, no-wrap
327 msgid ""
328 " guestfs_add_drive_opts (g, filename,\n"
329 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"raw\",\n"
330 "                         -1);\n"
331 "\n"
332 msgstr ""
333
334 # type: textblock
335 #. type: textblock
336 #: ../src/guestfs.pod:137
337 msgid "You can add a disk read-only using:"
338 msgstr ""
339
340 # type: verbatim
341 #. type: verbatim
342 #: ../src/guestfs.pod:139
343 #, no-wrap
344 msgid ""
345 " guestfs_add_drive_opts (g, filename,\n"
346 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"raw\",\n"
347 "                         GUESTFS_ADD_DRIVE_OPTS_READONLY, 1,\n"
348 "                         -1);\n"
349 "\n"
350 msgstr ""
351
352 # type: textblock
353 #. type: textblock
354 #: ../src/guestfs.pod:144
355 msgid ""
356 "or by calling the older function L</guestfs_add_drive_ro>.  In either case "
357 "libguestfs won't modify the file."
358 msgstr ""
359
360 # type: textblock
361 #. type: textblock
362 #: ../src/guestfs.pod:147
363 msgid ""
364 "Be extremely cautious if the disk image is in use, eg. if it is being used "
365 "by a virtual machine.  Adding it read-write will almost certainly cause disk "
366 "corruption, but adding it read-only is safe."
367 msgstr ""
368
369 # type: textblock
370 #. type: textblock
371 #: ../src/guestfs.pod:151
372 msgid ""
373 "You must add at least one disk image, and you may add multiple disk images.  "
374 "In the API, the disk images are usually referred to as C</dev/sda> (for the "
375 "first one you added), C</dev/sdb> (for the second one you added), etc."
376 msgstr ""
377
378 # type: textblock
379 #. type: textblock
380 #: ../src/guestfs.pod:156
381 msgid ""
382 "Once L</guestfs_launch> has been called you cannot add any more images.  You "
383 "can call L</guestfs_list_devices> to get a list of the device names, in the "
384 "order that you added them.  See also L</BLOCK DEVICE NAMING> below."
385 msgstr ""
386
387 # type: =head2
388 #. type: =head2
389 #: ../src/guestfs.pod:161
390 msgid "MOUNTING"
391 msgstr ""
392
393 #. type: textblock
394 #: ../src/guestfs.pod:163
395 msgid ""
396 "Before you can read or write files, create directories and so on in a disk "
397 "image that contains filesystems, you have to mount those filesystems using "
398 "L</guestfs_mount_options> or L</guestfs_mount_ro>.  If you already know that "
399 "a disk image contains (for example) one partition with a filesystem on that "
400 "partition, then you can mount it directly:"
401 msgstr ""
402
403 #. type: verbatim
404 #: ../src/guestfs.pod:170
405 #, no-wrap
406 msgid ""
407 " guestfs_mount_options (g, \"\", \"/dev/sda1\", \"/\");\n"
408 "\n"
409 msgstr ""
410
411 #. type: textblock
412 #: ../src/guestfs.pod:172
413 msgid ""
414 "where C</dev/sda1> means literally the first partition (C<1>) of the first "
415 "disk image that we added (C</dev/sda>).  If the disk contains Linux LVM2 "
416 "logical volumes you could refer to those instead (eg. C</dev/VG/LV>).  Note "
417 "that these are libguestfs virtual devices, and are nothing to do with host "
418 "devices."
419 msgstr ""
420
421 #. type: textblock
422 #: ../src/guestfs.pod:178
423 msgid ""
424 "If you are given a disk image and you don't know what it contains then you "
425 "have to find out.  Libguestfs can do that too: use L</"
426 "guestfs_list_partitions> and L</guestfs_lvs> to list possible partitions and "
427 "LVs, and either try mounting each to see what is mountable, or else examine "
428 "them with L</guestfs_vfs_type> or L</guestfs_file>.  To list just "
429 "filesystems, use L</guestfs_list_filesystems>."
430 msgstr ""
431
432 #. type: textblock
433 #: ../src/guestfs.pod:186
434 msgid ""
435 "Libguestfs also has a set of APIs for inspection of unknown disk images (see "
436 "L</INSPECTION> below).  But you might find it easier to look at higher level "
437 "programs built on top of libguestfs, in particular L<virt-inspector(1)>."
438 msgstr ""
439
440 #. type: textblock
441 #: ../src/guestfs.pod:191
442 msgid ""
443 "To mount a filesystem read-only, use L</guestfs_mount_ro>.  There are "
444 "several other variations of the C<guestfs_mount_*> call."
445 msgstr ""
446
447 # type: =head2
448 #. type: =head2
449 #: ../src/guestfs.pod:194
450 msgid "FILESYSTEM ACCESS AND MODIFICATION"
451 msgstr ""
452
453 # type: textblock
454 #. type: textblock
455 #: ../src/guestfs.pod:196
456 msgid ""
457 "The majority of the libguestfs API consists of fairly low-level calls for "
458 "accessing and modifying the files, directories, symlinks etc on mounted "
459 "filesystems.  There are over a hundred such calls which you can find listed "
460 "in detail below in this man page, and we don't even pretend to cover them "
461 "all in this overview."
462 msgstr ""
463
464 # type: textblock
465 #. type: textblock
466 #: ../src/guestfs.pod:202
467 msgid ""
468 "Specify filenames as full paths, starting with C<\"/\"> and including the "
469 "mount point."
470 msgstr ""
471
472 # type: textblock
473 #. type: textblock
474 #: ../src/guestfs.pod:205
475 msgid ""
476 "For example, if you mounted a filesystem at C<\"/\"> and you want to read "
477 "the file called C<\"etc/passwd\"> then you could do:"
478 msgstr ""
479
480 # type: verbatim
481 #. type: verbatim
482 #: ../src/guestfs.pod:208
483 #, no-wrap
484 msgid ""
485 " char *data = guestfs_cat (g, \"/etc/passwd\");\n"
486 "\n"
487 msgstr ""
488
489 # type: textblock
490 #. type: textblock
491 #: ../src/guestfs.pod:210
492 msgid ""
493 "This would return C<data> as a newly allocated buffer containing the full "
494 "content of that file (with some conditions: see also L</DOWNLOADING> below), "
495 "or C<NULL> if there was an error."
496 msgstr ""
497
498 # type: textblock
499 #. type: textblock
500 #: ../src/guestfs.pod:214
501 msgid ""
502 "As another example, to create a top-level directory on that filesystem "
503 "called C<\"var\"> you would do:"
504 msgstr ""
505
506 # type: verbatim
507 #. type: verbatim
508 #: ../src/guestfs.pod:217
509 #, no-wrap
510 msgid ""
511 " guestfs_mkdir (g, \"/var\");\n"
512 "\n"
513 msgstr ""
514
515 # type: textblock
516 #. type: textblock
517 #: ../src/guestfs.pod:219
518 msgid "To create a symlink you could do:"
519 msgstr ""
520
521 # type: verbatim
522 #. type: verbatim
523 #: ../src/guestfs.pod:221
524 #, no-wrap
525 msgid ""
526 " guestfs_ln_s (g, \"/etc/init.d/portmap\",\n"
527 "               \"/etc/rc3.d/S30portmap\");\n"
528 "\n"
529 msgstr ""
530
531 # type: textblock
532 #. type: textblock
533 #: ../src/guestfs.pod:224
534 msgid ""
535 "Libguestfs will reject attempts to use relative paths and there is no "
536 "concept of a current working directory."
537 msgstr ""
538
539 # type: textblock
540 #. type: textblock
541 #: ../src/guestfs.pod:227
542 msgid ""
543 "Libguestfs can return errors in many situations: for example if the "
544 "filesystem isn't writable, or if a file or directory that you requested "
545 "doesn't exist.  If you are using the C API (documented here)  you have to "
546 "check for those error conditions after each call.  (Other language bindings "
547 "turn these errors into exceptions)."
548 msgstr ""
549
550 # type: textblock
551 #. type: textblock
552 #: ../src/guestfs.pod:233
553 msgid ""
554 "File writes are affected by the per-handle umask, set by calling L</"
555 "guestfs_umask> and defaulting to 022.  See L</UMASK>."
556 msgstr ""
557
558 # type: =head2
559 #. type: =head2
560 #: ../src/guestfs.pod:236
561 msgid "PARTITIONING"
562 msgstr ""
563
564 # type: textblock
565 #. type: textblock
566 #: ../src/guestfs.pod:238
567 msgid ""
568 "Libguestfs contains API calls to read, create and modify partition tables on "
569 "disk images."
570 msgstr ""
571
572 # type: textblock
573 #. type: textblock
574 #: ../src/guestfs.pod:241
575 msgid ""
576 "In the common case where you want to create a single partition covering the "
577 "whole disk, you should use the L</guestfs_part_disk> call:"
578 msgstr ""
579
580 # type: verbatim
581 #. type: verbatim
582 #: ../src/guestfs.pod:245
583 #, no-wrap
584 msgid ""
585 " const char *parttype = \"mbr\";\n"
586 " if (disk_is_larger_than_2TB)\n"
587 "   parttype = \"gpt\";\n"
588 " guestfs_part_disk (g, \"/dev/sda\", parttype);\n"
589 "\n"
590 msgstr ""
591
592 # type: textblock
593 #. type: textblock
594 #: ../src/guestfs.pod:250
595 msgid ""
596 "Obviously this effectively wipes anything that was on that disk image before."
597 msgstr ""
598
599 # type: =head2
600 #. type: =head2
601 #: ../src/guestfs.pod:253
602 msgid "LVM2"
603 msgstr ""
604
605 # type: textblock
606 #. type: textblock
607 #: ../src/guestfs.pod:255
608 msgid ""
609 "Libguestfs provides access to a large part of the LVM2 API, such as L</"
610 "guestfs_lvcreate> and L</guestfs_vgremove>.  It won't make much sense unless "
611 "you familiarize yourself with the concepts of physical volumes, volume "
612 "groups and logical volumes."
613 msgstr ""
614
615 # type: textblock
616 #. type: textblock
617 #: ../src/guestfs.pod:260
618 msgid ""
619 "This author strongly recommends reading the LVM HOWTO, online at L<http://"
620 "tldp.org/HOWTO/LVM-HOWTO/>."
621 msgstr ""
622
623 # type: =head2
624 #. type: =head2
625 #: ../src/guestfs.pod:263
626 msgid "DOWNLOADING"
627 msgstr ""
628
629 #. type: textblock
630 #: ../src/guestfs.pod:265
631 msgid ""
632 "Use L</guestfs_cat> to download small, text only files.  This call is "
633 "limited to files which are less than 2 MB and which cannot contain any ASCII "
634 "NUL (C<\\0>) characters.  However the API is very simple to use."
635 msgstr ""
636
637 # type: textblock
638 #. type: textblock
639 #: ../src/guestfs.pod:269
640 msgid ""
641 "L</guestfs_read_file> can be used to read files which contain arbitrary 8 "
642 "bit data, since it returns a (pointer, size) pair.  However it is still "
643 "limited to \"small\" files, less than 2 MB."
644 msgstr ""
645
646 # type: textblock
647 #. type: textblock
648 #: ../src/guestfs.pod:273
649 msgid ""
650 "L</guestfs_download> can be used to download any file, with no limits on "
651 "content or size (even files larger than 4 GB)."
652 msgstr ""
653
654 # type: textblock
655 #. type: textblock
656 #: ../src/guestfs.pod:276
657 msgid ""
658 "To download multiple files, see L</guestfs_tar_out> and L</guestfs_tgz_out>."
659 msgstr ""
660
661 # type: =head2
662 #. type: =head2
663 #: ../src/guestfs.pod:279
664 msgid "UPLOADING"
665 msgstr ""
666
667 # type: textblock
668 #. type: textblock
669 #: ../src/guestfs.pod:281
670 msgid ""
671 "It's often the case that you want to write a file or files to the disk image."
672 msgstr ""
673
674 # type: textblock
675 #. type: textblock
676 #: ../src/guestfs.pod:284
677 msgid ""
678 "To write a small file with fixed content, use L</guestfs_write>.  To create "
679 "a file of all zeroes, use L</guestfs_truncate_size> (sparse) or L</"
680 "guestfs_fallocate64> (with all disk blocks allocated).  There are a variety "
681 "of other functions for creating test files, for example L</guestfs_fill> and "
682 "L</guestfs_fill_pattern>."
683 msgstr ""
684
685 # type: textblock
686 #. type: textblock
687 #: ../src/guestfs.pod:290
688 msgid ""
689 "To upload a single file, use L</guestfs_upload>.  This call has no limits on "
690 "file content or size (even files larger than 4 GB)."
691 msgstr ""
692
693 # type: textblock
694 #. type: textblock
695 #: ../src/guestfs.pod:293
696 msgid ""
697 "To upload multiple files, see L</guestfs_tar_in> and L</guestfs_tgz_in>."
698 msgstr ""
699
700 # type: textblock
701 #. type: textblock
702 #: ../src/guestfs.pod:295
703 msgid ""
704 "However the fastest way to upload I<large numbers of arbitrary files> is to "
705 "turn them into a squashfs or CD ISO (see L<mksquashfs(8)> and L<mkisofs(8)"
706 ">), then attach this using L</guestfs_add_drive_ro>.  If you add the drive "
707 "in a predictable way (eg. adding it last after all other drives) then you "
708 "can get the device name from L</guestfs_list_devices> and mount it directly "
709 "using L</guestfs_mount_ro>.  Note that squashfs images are sometimes non-"
710 "portable between kernel versions, and they don't support labels or UUIDs.  "
711 "If you want to pre-build an image or you need to mount it using a label or "
712 "UUID, use an ISO image instead."
713 msgstr ""
714
715 # type: =head2
716 #. type: =head2
717 #: ../src/guestfs.pod:306
718 msgid "COPYING"
719 msgstr ""
720
721 # type: textblock
722 #. type: textblock
723 #: ../src/guestfs.pod:308
724 msgid ""
725 "There are various different commands for copying between files and devices "
726 "and in and out of the guest filesystem.  These are summarised in the table "
727 "below."
728 msgstr ""
729
730 # type: =item
731 #. type: =item
732 #: ../src/guestfs.pod:314
733 msgid "B<file> to B<file>"
734 msgstr ""
735
736 # type: textblock
737 #. type: textblock
738 #: ../src/guestfs.pod:316
739 msgid ""
740 "Use L</guestfs_cp> to copy a single file, or L</guestfs_cp_a> to copy "
741 "directories recursively."
742 msgstr ""
743
744 # type: =item
745 #. type: =item
746 #: ../src/guestfs.pod:319
747 msgid "B<file or device> to B<file or device>"
748 msgstr ""
749
750 # type: textblock
751 #. type: textblock
752 #: ../src/guestfs.pod:321
753 msgid ""
754 "Use L</guestfs_dd> which efficiently uses L<dd(1)> to copy between files and "
755 "devices in the guest."
756 msgstr ""
757
758 # type: textblock
759 #. type: textblock
760 #: ../src/guestfs.pod:324
761 msgid "Example: duplicate the contents of an LV:"
762 msgstr ""
763
764 # type: verbatim
765 #. type: verbatim
766 #: ../src/guestfs.pod:326
767 #, no-wrap
768 msgid ""
769 " guestfs_dd (g, \"/dev/VG/Original\", \"/dev/VG/Copy\");\n"
770 "\n"
771 msgstr ""
772
773 # type: textblock
774 #. type: textblock
775 #: ../src/guestfs.pod:328
776 msgid ""
777 "The destination (C</dev/VG/Copy>) must be at least as large as the source "
778 "(C</dev/VG/Original>).  To copy less than the whole source device, use L</"
779 "guestfs_copy_size>."
780 msgstr ""
781
782 # type: =item
783 #. type: =item
784 #: ../src/guestfs.pod:332
785 msgid "B<file on the host> to B<file or device>"
786 msgstr ""
787
788 # type: textblock
789 #. type: textblock
790 #: ../src/guestfs.pod:334
791 msgid "Use L</guestfs_upload>.  See L</UPLOADING> above."
792 msgstr ""
793
794 # type: =item
795 #. type: =item
796 #: ../src/guestfs.pod:336
797 msgid "B<file or device> to B<file on the host>"
798 msgstr ""
799
800 # type: textblock
801 #. type: textblock
802 #: ../src/guestfs.pod:338
803 msgid "Use L</guestfs_download>.  See L</DOWNLOADING> above."
804 msgstr ""
805
806 # type: =head2
807 #. type: =head2
808 #: ../src/guestfs.pod:342
809 msgid "UPLOADING AND DOWNLOADING TO PIPES AND FILE DESCRIPTORS"
810 msgstr ""
811
812 # type: textblock
813 #. type: textblock
814 #: ../src/guestfs.pod:344
815 msgid ""
816 "Calls like L</guestfs_upload>, L</guestfs_download>, L</guestfs_tar_in>, L</"
817 "guestfs_tar_out> etc appear to only take filenames as arguments, so it "
818 "appears you can only upload and download to files.  However many Un*x-like "
819 "hosts let you use the special device files C</dev/stdin>, C</dev/stdout>, C</"
820 "dev/stderr> and C</dev/fd/N> to read and write from stdin, stdout, stderr, "
821 "and arbitrary file descriptor N."
822 msgstr ""
823
824 # type: textblock
825 #. type: textblock
826 #: ../src/guestfs.pod:352
827 msgid "For example, L<virt-cat(1)> writes its output to stdout by doing:"
828 msgstr ""
829
830 #. type: verbatim
831 #: ../src/guestfs.pod:355
832 #, no-wrap
833 msgid ""
834 " guestfs_download (g, filename, \"/dev/stdout\");\n"
835 "\n"
836 msgstr ""
837
838 #. type: textblock
839 #: ../src/guestfs.pod:357
840 msgid "and you can write tar output to a file descriptor C<fd> by doing:"
841 msgstr ""
842
843 #. type: verbatim
844 #: ../src/guestfs.pod:359
845 #, no-wrap
846 msgid ""
847 " char devfd[64];\n"
848 " snprintf (devfd, sizeof devfd, \"/dev/fd/%d\", fd);\n"
849 " guestfs_tar_out (g, \"/\", devfd);\n"
850 "\n"
851 msgstr ""
852
853 # type: =head2
854 #. type: =head2
855 #: ../src/guestfs.pod:363
856 msgid "LISTING FILES"
857 msgstr ""
858
859 # type: textblock
860 #. type: textblock
861 #: ../src/guestfs.pod:365
862 msgid ""
863 "L</guestfs_ll> is just designed for humans to read (mainly when using the "
864 "L<guestfish(1)>-equivalent command C<ll>)."
865 msgstr ""
866
867 # type: textblock
868 #. type: textblock
869 #: ../src/guestfs.pod:368
870 msgid ""
871 "L</guestfs_ls> is a quick way to get a list of files in a directory from "
872 "programs, as a flat list of strings."
873 msgstr ""
874
875 # type: textblock
876 #. type: textblock
877 #: ../src/guestfs.pod:371
878 msgid ""
879 "L</guestfs_readdir> is a programmatic way to get a list of files in a "
880 "directory, plus additional information about each one.  It is more "
881 "equivalent to using the L<readdir(3)> call on a local filesystem."
882 msgstr ""
883
884 # type: textblock
885 #. type: textblock
886 #: ../src/guestfs.pod:375
887 msgid ""
888 "L</guestfs_find> and L</guestfs_find0> can be used to recursively list files."
889 msgstr ""
890
891 # type: =head2
892 #. type: =head2
893 #: ../src/guestfs.pod:378
894 msgid "RUNNING COMMANDS"
895 msgstr ""
896
897 # type: textblock
898 #. type: textblock
899 #: ../src/guestfs.pod:380
900 msgid ""
901 "Although libguestfs is primarily an API for manipulating files inside guest "
902 "images, we also provide some limited facilities for running commands inside "
903 "guests."
904 msgstr ""
905
906 # type: textblock
907 #. type: textblock
908 #: ../src/guestfs.pod:384
909 msgid "There are many limitations to this:"
910 msgstr ""
911
912 # type: =item
913 #. type: =item
914 #: ../src/guestfs.pod:388 ../src/guestfs.pod:393 ../src/guestfs.pod:398
915 #: ../src/guestfs.pod:402 ../src/guestfs.pod:407 ../src/guestfs.pod:411
916 #: ../src/guestfs.pod:416 ../src/guestfs.pod:421 ../src/guestfs.pod:1064
917 #: ../src/guestfs.pod:1068 ../src/guestfs.pod:1072 ../src/guestfs.pod:1077
918 #: ../src/guestfs.pod:1085 ../src/guestfs.pod:1104 ../src/guestfs.pod:1112
919 #: ../src/guestfs.pod:1134 ../src/guestfs.pod:1138 ../src/guestfs.pod:1142
920 #: ../src/guestfs.pod:1146 ../src/guestfs.pod:1150 ../src/guestfs.pod:1154
921 #: ../src/guestfs.pod:1643 ../src/guestfs.pod:1648 ../src/guestfs.pod:1652
922 #: ../src/guestfs.pod:1753 ../src/guestfs.pod:1758 ../src/guestfs.pod:1762
923 #: ../src/guestfs.pod:1772 ../src/guestfs.pod:2007 ../src/guestfs.pod:2012
924 #: ../src/guestfs.pod:2018 ../src/guestfs.pod:2026 ../src/guestfs.pod:2380
925 #: ../src/guestfs.pod:2386 ../src/guestfs.pod:2391 ../src/guestfs.pod:2397
926 #: ../src/guestfs.pod:2967 ../src/guestfs.pod:2971 ../src/guestfs.pod:2975
927 #: ../src/guestfs.pod:2979 ../src/guestfs-actions.pod:15
928 #: ../src/guestfs-actions.pod:22 ../src/guestfs-actions.pod:577
929 #: ../src/guestfs-actions.pod:585 ../src/guestfs-actions.pod:592
930 #: ../src/guestfs-actions.pod:599 ../src/guestfs-actions.pod:1597
931 #: ../src/guestfs-actions.pod:1601 ../src/guestfs-actions.pod:1605
932 #: ../src/guestfs-actions.pod:1609 ../src/guestfs-actions.pod:1617
933 #: ../src/guestfs-actions.pod:1621 ../src/guestfs-actions.pod:1625
934 #: ../src/guestfs-actions.pod:1635 ../src/guestfs-actions.pod:1639
935 #: ../src/guestfs-actions.pod:1643 ../src/guestfs-actions.pod:1781
936 #: ../src/guestfs-actions.pod:1785 ../src/guestfs-actions.pod:1790
937 #: ../src/guestfs-actions.pod:1795 ../src/guestfs-actions.pod:1856
938 #: ../src/guestfs-actions.pod:1860 ../src/guestfs-actions.pod:1865
939 #: ../fish/guestfish.pod:443 ../fish/guestfish.pod:447
940 #: ../fish/guestfish.pod:451 ../fish/guestfish.pod:455
941 #: ../fish/guestfish-actions.pod:13 ../fish/guestfish-actions.pod:20
942 #: ../fish/guestfish-actions.pod:380 ../fish/guestfish-actions.pod:388
943 #: ../fish/guestfish-actions.pod:395 ../fish/guestfish-actions.pod:402
944 #: ../fish/guestfish-actions.pod:1069 ../fish/guestfish-actions.pod:1073
945 #: ../fish/guestfish-actions.pod:1077 ../fish/guestfish-actions.pod:1081
946 #: ../fish/guestfish-actions.pod:1089 ../fish/guestfish-actions.pod:1093
947 #: ../fish/guestfish-actions.pod:1097 ../fish/guestfish-actions.pod:1107
948 #: ../fish/guestfish-actions.pod:1111 ../fish/guestfish-actions.pod:1115
949 #: ../fish/guestfish-actions.pod:1205 ../fish/guestfish-actions.pod:1209
950 #: ../fish/guestfish-actions.pod:1214 ../fish/guestfish-actions.pod:1219
951 #: ../fish/guestfish-actions.pod:1261 ../fish/guestfish-actions.pod:1265
952 #: ../fish/guestfish-actions.pod:1270 ../tools/virt-edit.pl:351
953 #: ../tools/virt-edit.pl:356 ../tools/virt-edit.pl:361
954 #: ../tools/virt-edit.pl:372 ../tools/virt-edit.pl:376
955 #: ../tools/virt-win-reg.pl:536 ../tools/virt-win-reg.pl:542
956 #: ../tools/virt-win-reg.pl:548
957 msgid "*"
958 msgstr ""
959
960 # type: textblock
961 #. type: textblock
962 #: ../src/guestfs.pod:390
963 msgid ""
964 "The kernel version that the command runs under will be different from what "
965 "it expects."
966 msgstr ""
967
968 # type: textblock
969 #. type: textblock
970 #: ../src/guestfs.pod:395
971 msgid ""
972 "If the command needs to communicate with daemons, then most likely they "
973 "won't be running."
974 msgstr ""
975
976 # type: textblock
977 #. type: textblock
978 #: ../src/guestfs.pod:400
979 msgid "The command will be running in limited memory."
980 msgstr ""
981
982 # type: textblock
983 #. type: textblock
984 #: ../src/guestfs.pod:404
985 msgid ""
986 "The network may not be available unless you enable it (see L</"
987 "guestfs_set_network>)."
988 msgstr ""
989
990 # type: textblock
991 #. type: textblock
992 #: ../src/guestfs.pod:409
993 msgid "Only supports Linux guests (not Windows, BSD, etc)."
994 msgstr ""
995
996 # type: textblock
997 #. type: textblock
998 #: ../src/guestfs.pod:413
999 msgid ""
1000 "Architecture limitations (eg. won't work for a PPC guest on an X86 host)."
1001 msgstr ""
1002
1003 # type: textblock
1004 #. type: textblock
1005 #: ../src/guestfs.pod:418
1006 msgid ""
1007 "For SELinux guests, you may need to enable SELinux and load policy first.  "
1008 "See L</SELINUX> in this manpage."
1009 msgstr ""
1010
1011 # type: textblock
1012 #. type: textblock
1013 #: ../src/guestfs.pod:423
1014 msgid ""
1015 "I<Security:> It is not safe to run commands from untrusted, possibly "
1016 "malicious guests.  These commands may attempt to exploit your program by "
1017 "sending unexpected output.  They could also try to exploit the Linux kernel "
1018 "or qemu provided by the libguestfs appliance.  They could use the network "
1019 "provided by the libguestfs appliance to bypass ordinary network partitions "
1020 "and firewalls.  They could use the elevated privileges or different SELinux "
1021 "context of your program to their advantage."
1022 msgstr ""
1023
1024 # type: textblock
1025 #. type: textblock
1026 #: ../src/guestfs.pod:432
1027 msgid ""
1028 "A secure alternative is to use libguestfs to install a \"firstboot\" script "
1029 "(a script which runs when the guest next boots normally), and to have this "
1030 "script run the commands you want in the normal context of the running guest, "
1031 "network security and so on.  For information about other security issues, "
1032 "see L</SECURITY>."
1033 msgstr ""
1034
1035 # type: textblock
1036 #. type: textblock
1037 #: ../src/guestfs.pod:440
1038 msgid ""
1039 "The two main API calls to run commands are L</guestfs_command> and L</"
1040 "guestfs_sh> (there are also variations)."
1041 msgstr ""
1042
1043 # type: textblock
1044 #. type: textblock
1045 #: ../src/guestfs.pod:443
1046 msgid ""
1047 "The difference is that L</guestfs_sh> runs commands using the shell, so any "
1048 "shell globs, redirections, etc will work."
1049 msgstr ""
1050
1051 # type: =head2
1052 #. type: =head2
1053 #: ../src/guestfs.pod:446
1054 msgid "CONFIGURATION FILES"
1055 msgstr ""
1056
1057 # type: textblock
1058 #. type: textblock
1059 #: ../src/guestfs.pod:448
1060 msgid ""
1061 "To read and write configuration files in Linux guest filesystems, we "
1062 "strongly recommend using Augeas.  For example, Augeas understands how to "
1063 "read and write, say, a Linux shadow password file or X.org configuration "
1064 "file, and so avoids you having to write that code."
1065 msgstr ""
1066
1067 # type: textblock
1068 #. type: textblock
1069 #: ../src/guestfs.pod:453
1070 msgid ""
1071 "The main Augeas calls are bound through the C<guestfs_aug_*> APIs.  We don't "
1072 "document Augeas itself here because there is excellent documentation on the "
1073 "L<http://augeas.net/> website."
1074 msgstr ""
1075
1076 # type: textblock
1077 #. type: textblock
1078 #: ../src/guestfs.pod:457
1079 msgid ""
1080 "If you don't want to use Augeas (you fool!) then try calling L</"
1081 "guestfs_read_lines> to get the file as a list of lines which you can iterate "
1082 "over."
1083 msgstr ""
1084
1085 # type: =head2
1086 #. type: =head2
1087 #: ../src/guestfs.pod:461
1088 msgid "SELINUX"
1089 msgstr ""
1090
1091 # type: textblock
1092 #. type: textblock
1093 #: ../src/guestfs.pod:463
1094 msgid ""
1095 "We support SELinux guests.  To ensure that labeling happens correctly in "
1096 "SELinux guests, you need to enable SELinux and load the guest's policy:"
1097 msgstr ""
1098
1099 # type: =item
1100 #. type: =item
1101 #: ../src/guestfs.pod:469 ../src/guestfs.pod:1257 ../src/guestfs.pod:1395
1102 #: ../src/guestfs.pod:2425
1103 msgid "1."
1104 msgstr ""
1105
1106 # type: textblock
1107 #. type: textblock
1108 #: ../src/guestfs.pod:471
1109 msgid "Before launching, do:"
1110 msgstr ""
1111
1112 # type: verbatim
1113 #. type: verbatim
1114 #: ../src/guestfs.pod:473
1115 #, no-wrap
1116 msgid ""
1117 " guestfs_set_selinux (g, 1);\n"
1118 "\n"
1119 msgstr ""
1120
1121 # type: =item
1122 #. type: =item
1123 #: ../src/guestfs.pod:475 ../src/guestfs.pod:1261 ../src/guestfs.pod:1399
1124 #: ../src/guestfs.pod:2450
1125 msgid "2."
1126 msgstr ""
1127
1128 # type: textblock
1129 #. type: textblock
1130 #: ../src/guestfs.pod:477
1131 msgid ""
1132 "After mounting the guest's filesystem(s), load the policy.  This is best "
1133 "done by running the L<load_policy(8)> command in the guest itself:"
1134 msgstr ""
1135
1136 # type: verbatim
1137 #. type: verbatim
1138 #: ../src/guestfs.pod:481
1139 #, no-wrap
1140 msgid ""
1141 " guestfs_sh (g, \"/usr/sbin/load_policy\");\n"
1142 "\n"
1143 msgstr ""
1144
1145 # type: textblock
1146 #. type: textblock
1147 #: ../src/guestfs.pod:483
1148 msgid ""
1149 "(Older versions of C<load_policy> require you to specify the name of the "
1150 "policy file)."
1151 msgstr ""
1152
1153 # type: =item
1154 #. type: =item
1155 #: ../src/guestfs.pod:486 ../src/guestfs.pod:1405
1156 msgid "3."
1157 msgstr ""
1158
1159 # type: textblock
1160 #. type: textblock
1161 #: ../src/guestfs.pod:488
1162 msgid ""
1163 "Optionally, set the security context for the API.  The correct security "
1164 "context to use can only be known by inspecting the guest.  As an example:"
1165 msgstr ""
1166
1167 # type: verbatim
1168 #. type: verbatim
1169 #: ../src/guestfs.pod:492
1170 #, no-wrap
1171 msgid ""
1172 " guestfs_setcon (g, \"unconfined_u:unconfined_r:unconfined_t:s0\");\n"
1173 "\n"
1174 msgstr ""
1175
1176 # type: textblock
1177 #. type: textblock
1178 #: ../src/guestfs.pod:496
1179 msgid "This will work for running commands and editing existing files."
1180 msgstr ""
1181
1182 # type: textblock
1183 #. type: textblock
1184 #: ../src/guestfs.pod:498
1185 msgid ""
1186 "When new files are created, you may need to label them explicitly, for "
1187 "example by running the external command C<restorecon pathname>."
1188 msgstr ""
1189
1190 # type: =head2
1191 #. type: =head2
1192 #: ../src/guestfs.pod:502
1193 msgid "UMASK"
1194 msgstr ""
1195
1196 # type: textblock
1197 #. type: textblock
1198 #: ../src/guestfs.pod:504
1199 msgid ""
1200 "Certain calls are affected by the current file mode creation mask (the "
1201 "\"umask\").  In particular ones which create files or directories, such as "
1202 "L</guestfs_touch>, L</guestfs_mknod> or L</guestfs_mkdir>.  This affects "
1203 "either the default mode that the file is created with or modifies the mode "
1204 "that you supply."
1205 msgstr ""
1206
1207 # type: textblock
1208 #. type: textblock
1209 #: ../src/guestfs.pod:510
1210 msgid ""
1211 "The default umask is C<022>, so files are created with modes such as C<0644> "
1212 "and directories with C<0755>."
1213 msgstr ""
1214
1215 # type: textblock
1216 #. type: textblock
1217 #: ../src/guestfs.pod:513
1218 msgid ""
1219 "There are two ways to avoid being affected by umask.  Either set umask to 0 "
1220 "(call C<guestfs_umask (g, 0)> early after launching).  Or call L</"
1221 "guestfs_chmod> after creating each file or directory."
1222 msgstr ""
1223
1224 # type: textblock
1225 #. type: textblock
1226 #: ../src/guestfs.pod:517
1227 msgid "For more information about umask, see L<umask(2)>."
1228 msgstr ""
1229
1230 # type: =head1
1231 #. type: =head1
1232 #: ../src/guestfs.pod:519 ../fish/guestfish.pod:765
1233 msgid "ENCRYPTED DISKS"
1234 msgstr ""
1235
1236 # type: textblock
1237 #. type: textblock
1238 #: ../src/guestfs.pod:521
1239 msgid ""
1240 "Libguestfs allows you to access Linux guests which have been encrypted using "
1241 "whole disk encryption that conforms to the Linux Unified Key Setup (LUKS) "
1242 "standard.  This includes nearly all whole disk encryption systems used by "
1243 "modern Linux guests."
1244 msgstr ""
1245
1246 # type: textblock
1247 #. type: textblock
1248 #: ../src/guestfs.pod:527
1249 msgid ""
1250 "Use L</guestfs_vfs_type> to identify LUKS-encrypted block devices (it "
1251 "returns the string C<crypto_LUKS>)."
1252 msgstr ""
1253
1254 # type: textblock
1255 #. type: textblock
1256 #: ../src/guestfs.pod:530
1257 msgid ""
1258 "Then open these devices by calling L</guestfs_luks_open>.  Obviously you "
1259 "will require the passphrase!"
1260 msgstr ""
1261
1262 # type: textblock
1263 #. type: textblock
1264 #: ../src/guestfs.pod:533
1265 msgid ""
1266 "Opening a LUKS device creates a new device mapper device called C</dev/"
1267 "mapper/mapname> (where C<mapname> is the string you supply to L</"
1268 "guestfs_luks_open>).  Reads and writes to this mapper device are decrypted "
1269 "from and encrypted to the underlying block device respectively."
1270 msgstr ""
1271
1272 # type: textblock
1273 #. type: textblock
1274 #: ../src/guestfs.pod:539
1275 msgid ""
1276 "LVM volume groups on the device can be made visible by calling L</"
1277 "guestfs_vgscan> followed by L</guestfs_vg_activate_all>.  The logical volume"
1278 "(s) can now be mounted in the usual way."
1279 msgstr ""
1280
1281 # type: textblock
1282 #. type: textblock
1283 #: ../src/guestfs.pod:543
1284 msgid ""
1285 "Use the reverse process to close a LUKS device.  Unmount any logical volumes "
1286 "on it, deactivate the volume groups by caling C<guestfs_vg_activate (g, 0, "
1287 "[\"/dev/VG\"])>.  Then close the mapper device by calling L</"
1288 "guestfs_luks_close> on the C</dev/mapper/mapname> device (I<not> the "
1289 "underlying encrypted block device)."
1290 msgstr ""
1291
1292 # type: =head2
1293 #. type: =head2
1294 #: ../src/guestfs.pod:550
1295 msgid "INSPECTION"
1296 msgstr ""
1297
1298 #. type: textblock
1299 #: ../src/guestfs.pod:552
1300 msgid ""
1301 "Libguestfs has APIs for inspecting an unknown disk image to find out if it "
1302 "contains operating systems, an install CD or a live CD.  (These APIs used to "
1303 "be in a separate Perl-only library called L<Sys::Guestfs::Lib(3)> but since "
1304 "version 1.5.3 the most frequently used part of this library has been "
1305 "rewritten in C and moved into the core code)."
1306 msgstr ""
1307
1308 # type: textblock
1309 #. type: textblock
1310 #: ../src/guestfs.pod:559
1311 msgid ""
1312 "Add all disks belonging to the unknown virtual machine and call L</"
1313 "guestfs_launch> in the usual way."
1314 msgstr ""
1315
1316 # type: textblock
1317 #. type: textblock
1318 #: ../src/guestfs.pod:562
1319 msgid ""
1320 "Then call L</guestfs_inspect_os>.  This function uses other libguestfs calls "
1321 "and certain heuristics, and returns a list of operating systems that were "
1322 "found.  An empty list means none were found.  A single element is the root "
1323 "filesystem of the operating system.  For dual- or multi-boot guests, "
1324 "multiple roots can be returned, each one corresponding to a separate "
1325 "operating system.  (Multi-boot virtual machines are extremely rare in the "
1326 "world of virtualization, but since this scenario can happen, we have built "
1327 "libguestfs to deal with it.)"
1328 msgstr ""
1329
1330 # type: textblock
1331 #. type: textblock
1332 #: ../src/guestfs.pod:571
1333 msgid ""
1334 "For each root, you can then call various C<guestfs_inspect_get_*> functions "
1335 "to get additional details about that operating system.  For example, call L</"
1336 "guestfs_inspect_get_type> to return the string C<windows> or C<linux> for "
1337 "Windows and Linux-based operating systems respectively."
1338 msgstr ""
1339
1340 # type: textblock
1341 #. type: textblock
1342 #: ../src/guestfs.pod:577
1343 msgid ""
1344 "Un*x-like and Linux-based operating systems usually consist of several "
1345 "filesystems which are mounted at boot time (for example, a separate boot "
1346 "partition mounted on C</boot>).  The inspection rules are able to detect how "
1347 "filesystems correspond to mount points.  Call "
1348 "C<guestfs_inspect_get_mountpoints> to get this mapping.  It might return a "
1349 "hash table like this example:"
1350 msgstr ""
1351
1352 # type: verbatim
1353 #. type: verbatim
1354 #: ../src/guestfs.pod:584
1355 #, no-wrap
1356 msgid ""
1357 " /boot => /dev/sda1\n"
1358 " /     => /dev/vg_guest/lv_root\n"
1359 " /usr  => /dev/vg_guest/lv_usr\n"
1360 "\n"
1361 msgstr ""
1362
1363 # type: textblock
1364 #. type: textblock
1365 #: ../src/guestfs.pod:588
1366 msgid ""
1367 "The caller can then make calls to L</guestfs_mount_options> to mount the "
1368 "filesystems as suggested."
1369 msgstr ""
1370
1371 # type: textblock
1372 #. type: textblock
1373 #: ../src/guestfs.pod:591
1374 msgid ""
1375 "Be careful to mount filesystems in the right order (eg. C</> before C</"
1376 "usr>).  Sorting the keys of the hash by length, shortest first, should work."
1377 msgstr ""
1378
1379 # type: textblock
1380 #. type: textblock
1381 #: ../src/guestfs.pod:595
1382 msgid ""
1383 "Inspection currently only works for some common operating systems.  "
1384 "Contributors are welcome to send patches for other operating systems that we "
1385 "currently cannot detect."
1386 msgstr ""
1387
1388 # type: textblock
1389 #. type: textblock
1390 #: ../src/guestfs.pod:599
1391 msgid ""
1392 "Encrypted disks must be opened before inspection.  See L</ENCRYPTED DISKS> "
1393 "for more details.  The L</guestfs_inspect_os> function just ignores any "
1394 "encrypted devices."
1395 msgstr ""
1396
1397 # type: textblock
1398 #. type: textblock
1399 #: ../src/guestfs.pod:603
1400 msgid ""
1401 "A note on the implementation: The call L</guestfs_inspect_os> performs "
1402 "inspection and caches the results in the guest handle.  Subsequent calls to "
1403 "C<guestfs_inspect_get_*> return this cached information, but I<do not> re-"
1404 "read the disks.  If you change the content of the guest disks, you can redo "
1405 "inspection by calling L</guestfs_inspect_os> again.  (L</"
1406 "guestfs_inspect_list_applications> works a little differently from the other "
1407 "calls and does read the disks.  See documentation for that function for "
1408 "details)."
1409 msgstr ""
1410
1411 #. type: =head3
1412 #: ../src/guestfs.pod:612
1413 msgid "INSPECTING INSTALL DISKS"
1414 msgstr ""
1415
1416 #. type: textblock
1417 #: ../src/guestfs.pod:614
1418 msgid ""
1419 "Libguestfs (since 1.9.4) can detect some install disks, install CDs, live "
1420 "CDs and more."
1421 msgstr ""
1422
1423 #. type: textblock
1424 #: ../src/guestfs.pod:617
1425 msgid ""
1426 "Call L</guestfs_inspect_get_format> to return the format of the operating "
1427 "system, which currently can be C<installed> (a regular operating system) or "
1428 "C<installer> (some sort of install disk)."
1429 msgstr ""
1430
1431 #. type: textblock
1432 #: ../src/guestfs.pod:621
1433 msgid ""
1434 "Further information is available about the operating system that can be "
1435 "installed using the regular inspection APIs like L</"
1436 "guestfs_inspect_get_product_name>, L</guestfs_inspect_get_major_version> etc."
1437 msgstr ""
1438
1439 #. type: textblock
1440 #: ../src/guestfs.pod:626
1441 msgid ""
1442 "Some additional information specific to installer disks is also available "
1443 "from the L</guestfs_inspect_is_live>, L</guestfs_inspect_is_netinst> and L</"
1444 "guestfs_inspect_is_multipart> calls."
1445 msgstr ""
1446
1447 # type: =head2
1448 #. type: =head2
1449 #: ../src/guestfs.pod:631
1450 msgid "SPECIAL CONSIDERATIONS FOR WINDOWS GUESTS"
1451 msgstr ""
1452
1453 # type: textblock
1454 #. type: textblock
1455 #: ../src/guestfs.pod:633
1456 msgid ""
1457 "Libguestfs can mount NTFS partitions.  It does this using the L<http://www."
1458 "ntfs-3g.org/> driver."
1459 msgstr ""
1460
1461 # type: =head3
1462 #. type: =head3
1463 #: ../src/guestfs.pod:636
1464 msgid "DRIVE LETTERS AND PATHS"
1465 msgstr ""
1466
1467 # type: textblock
1468 #. type: textblock
1469 #: ../src/guestfs.pod:638
1470 msgid ""
1471 "DOS and Windows still use drive letters, and the filesystems are always "
1472 "treated as case insensitive by Windows itself, and therefore you might find "
1473 "a Windows configuration file referring to a path like C<c:\\windows"
1474 "\\system32>.  When the filesystem is mounted in libguestfs, that directory "
1475 "might be referred to as C</WINDOWS/System32>."
1476 msgstr ""
1477
1478 #. type: textblock
1479 #: ../src/guestfs.pod:644
1480 msgid ""
1481 "Drive letter mappings can be found using inspection (see L</INSPECTION> and "
1482 "L</guestfs_inspect_get_drive_mappings>)"
1483 msgstr ""
1484
1485 #. type: textblock
1486 #: ../src/guestfs.pod:647
1487 msgid ""
1488 "Dealing with separator characters (backslash vs forward slash) is outside "
1489 "the scope of libguestfs, but usually a simple character replacement will "
1490 "work."
1491 msgstr ""
1492
1493 #. type: textblock
1494 #: ../src/guestfs.pod:651
1495 msgid ""
1496 "To resolve the case insensitivity of paths, call L</"
1497 "guestfs_case_sensitive_path>."
1498 msgstr ""
1499
1500 # type: =head3
1501 #. type: =head3
1502 #: ../src/guestfs.pod:654
1503 msgid "ACCESSING THE WINDOWS REGISTRY"
1504 msgstr ""
1505
1506 # type: textblock
1507 #. type: textblock
1508 #: ../src/guestfs.pod:656
1509 msgid ""
1510 "Libguestfs also provides some help for decoding Windows Registry \"hive\" "
1511 "files, through the library C<hivex> which is part of the libguestfs project "
1512 "although ships as a separate tarball.  You have to locate and download the "
1513 "hive file(s) yourself, and then pass them to C<hivex> functions.  See also "
1514 "the programs L<hivexml(1)>, L<hivexsh(1)>, L<hivexregedit(1)> and L<virt-win-"
1515 "reg(1)> for more help on this issue."
1516 msgstr ""
1517
1518 # type: =head3
1519 #. type: =head3
1520 #: ../src/guestfs.pod:664
1521 msgid "SYMLINKS ON NTFS-3G FILESYSTEMS"
1522 msgstr ""
1523
1524 # type: textblock
1525 #. type: textblock
1526 #: ../src/guestfs.pod:666
1527 msgid ""
1528 "Ntfs-3g tries to rewrite \"Junction Points\" and NTFS \"symbolic links\" to "
1529 "provide something which looks like a Linux symlink.  The way it tries to do "
1530 "the rewriting is described here:"
1531 msgstr ""
1532
1533 # type: textblock
1534 #. type: textblock
1535 #: ../src/guestfs.pod:670
1536 msgid ""
1537 "L<http://www.tuxera.com/community/ntfs-3g-advanced/junction-points-and-"
1538 "symbolic-links/>"
1539 msgstr ""
1540
1541 # type: textblock
1542 #. type: textblock
1543 #: ../src/guestfs.pod:672
1544 msgid ""
1545 "The essential problem is that ntfs-3g simply does not have enough "
1546 "information to do a correct job.  NTFS links can contain drive letters and "
1547 "references to external device GUIDs that ntfs-3g has no way of resolving.  "
1548 "It is almost certainly the case that libguestfs callers should ignore what "
1549 "ntfs-3g does (ie. don't use L</guestfs_readlink> on NTFS volumes)."
1550 msgstr ""
1551
1552 # type: textblock
1553 #. type: textblock
1554 #: ../src/guestfs.pod:679
1555 msgid ""
1556 "Instead if you encounter a symbolic link on an ntfs-3g filesystem, use L</"
1557 "guestfs_lgetxattr> to read the C<system.ntfs_reparse_data> extended "
1558 "attribute, and read the raw reparse data from that (you can find the format "
1559 "documented in various places around the web)."
1560 msgstr ""
1561
1562 # type: =head3
1563 #. type: =head3
1564 #: ../src/guestfs.pod:684
1565 msgid "EXTENDED ATTRIBUTES ON NTFS-3G FILESYSTEMS"
1566 msgstr ""
1567
1568 # type: textblock
1569 #. type: textblock
1570 #: ../src/guestfs.pod:686
1571 msgid ""
1572 "There are other useful extended attributes that can be read from ntfs-3g "
1573 "filesystems (using L</guestfs_getxattr>).  See:"
1574 msgstr ""
1575
1576 # type: textblock
1577 #. type: textblock
1578 #: ../src/guestfs.pod:689
1579 msgid ""
1580 "L<http://www.tuxera.com/community/ntfs-3g-advanced/extended-attributes/>"
1581 msgstr ""
1582
1583 # type: =head2
1584 #. type: =head2
1585 #: ../src/guestfs.pod:691
1586 msgid "USING LIBGUESTFS WITH OTHER PROGRAMMING LANGUAGES"
1587 msgstr ""
1588
1589 # type: textblock
1590 #. type: textblock
1591 #: ../src/guestfs.pod:693
1592 msgid ""
1593 "Although we don't want to discourage you from using the C API, we will "
1594 "mention here that the same API is also available in other languages."
1595 msgstr ""
1596
1597 #. type: textblock
1598 #: ../src/guestfs.pod:696
1599 msgid ""
1600 "The API is broadly identical in all supported languages.  This means that "
1601 "the C call C<guestfs_add_drive_ro(g,file)> is C<$g-E<gt>add_drive_ro($file)> "
1602 "in Perl, C<g.add_drive_ro(file)> in Python, and C<g#add_drive_ro file> in "
1603 "OCaml.  In other words, a straightforward, predictable isomorphism between "
1604 "each language."
1605 msgstr ""
1606
1607 # type: textblock
1608 #. type: textblock
1609 #: ../src/guestfs.pod:702
1610 msgid ""
1611 "Error messages are automatically transformed into exceptions if the language "
1612 "supports it."
1613 msgstr ""
1614
1615 # type: textblock
1616 #. type: textblock
1617 #: ../src/guestfs.pod:705
1618 msgid ""
1619 "We don't try to \"object orientify\" parts of the API in OO languages, "
1620 "although contributors are welcome to write higher level APIs above what we "
1621 "provide in their favourite languages if they wish."
1622 msgstr ""
1623
1624 # type: =item
1625 #. type: =item
1626 #: ../src/guestfs.pod:711
1627 msgid "B<C++>"
1628 msgstr ""
1629
1630 # type: textblock
1631 #. type: textblock
1632 #: ../src/guestfs.pod:713
1633 msgid ""
1634 "You can use the I<guestfs.h> header file from C++ programs.  The C++ API is "
1635 "identical to the C API.  C++ classes and exceptions are not used."
1636 msgstr ""
1637
1638 # type: =item
1639 #. type: =item
1640 #: ../src/guestfs.pod:717
1641 msgid "B<C#>"
1642 msgstr ""
1643
1644 # type: textblock
1645 #. type: textblock
1646 #: ../src/guestfs.pod:719
1647 msgid ""
1648 "The C# bindings are highly experimental.  Please read the warnings at the "
1649 "top of C<csharp/Libguestfs.cs>."
1650 msgstr ""
1651
1652 # type: =item
1653 #. type: =item
1654 #: ../src/guestfs.pod:722
1655 msgid "B<Haskell>"
1656 msgstr ""
1657
1658 # type: textblock
1659 #. type: textblock
1660 #: ../src/guestfs.pod:724
1661 msgid ""
1662 "This is the only language binding that is working but incomplete.  Only "
1663 "calls which return simple integers have been bound in Haskell, and we are "
1664 "looking for help to complete this binding."
1665 msgstr ""
1666
1667 # type: =item
1668 #. type: =item
1669 #: ../src/guestfs.pod:728
1670 msgid "B<Java>"
1671 msgstr ""
1672
1673 # type: textblock
1674 #. type: textblock
1675 #: ../src/guestfs.pod:730
1676 msgid ""
1677 "Full documentation is contained in the Javadoc which is distributed with "
1678 "libguestfs."
1679 msgstr ""
1680
1681 # type: =item
1682 #. type: =item
1683 #: ../src/guestfs.pod:733
1684 msgid "B<OCaml>"
1685 msgstr ""
1686
1687 #. type: textblock
1688 #: ../src/guestfs.pod:735
1689 msgid "See L<guestfs-ocaml(3)>."
1690 msgstr ""
1691
1692 # type: =item
1693 #. type: =item
1694 #: ../src/guestfs.pod:737
1695 msgid "B<Perl>"
1696 msgstr ""
1697
1698 #. type: textblock
1699 #: ../src/guestfs.pod:739
1700 msgid "See L<guestfs-perl(3)> and L<Sys::Guestfs(3)>."
1701 msgstr ""
1702
1703 # type: =item
1704 #. type: =item
1705 #: ../src/guestfs.pod:741
1706 msgid "B<PHP>"
1707 msgstr ""
1708
1709 # type: textblock
1710 #. type: textblock
1711 #: ../src/guestfs.pod:743
1712 msgid ""
1713 "For documentation see C<README-PHP> supplied with libguestfs sources or in "
1714 "the php-libguestfs package for your distribution."
1715 msgstr ""
1716
1717 # type: textblock
1718 #. type: textblock
1719 #: ../src/guestfs.pod:746
1720 msgid "The PHP binding only works correctly on 64 bit machines."
1721 msgstr ""
1722
1723 # type: =item
1724 #. type: =item
1725 #: ../src/guestfs.pod:748
1726 msgid "B<Python>"
1727 msgstr ""
1728
1729 #. type: textblock
1730 #: ../src/guestfs.pod:750
1731 msgid "See L<guestfs-python(3)>."
1732 msgstr ""
1733
1734 # type: =item
1735 #. type: =item
1736 #: ../src/guestfs.pod:752
1737 msgid "B<Ruby>"
1738 msgstr ""
1739
1740 #. type: textblock
1741 #: ../src/guestfs.pod:754
1742 msgid "See L<guestfs-ruby(3)>."
1743 msgstr ""
1744
1745 # type: =item
1746 #. type: =item
1747 #: ../src/guestfs.pod:756
1748 msgid "B<shell scripts>"
1749 msgstr ""
1750
1751 #. type: textblock
1752 #: ../src/guestfs.pod:758
1753 msgid "See L<guestfish(1)>."
1754 msgstr ""
1755
1756 # type: =head2
1757 #. type: =head2
1758 #: ../src/guestfs.pod:762
1759 msgid "LIBGUESTFS GOTCHAS"
1760 msgstr ""
1761
1762 # type: textblock
1763 #. type: textblock
1764 #: ../src/guestfs.pod:764
1765 msgid ""
1766 "L<http://en.wikipedia.org/wiki/Gotcha_(programming)>: \"A feature of a "
1767 "system [...] that works in the way it is documented but is counterintuitive "
1768 "and almost invites mistakes.\""
1769 msgstr ""
1770
1771 # type: textblock
1772 #. type: textblock
1773 #: ../src/guestfs.pod:768
1774 msgid ""
1775 "Since we developed libguestfs and the associated tools, there are several "
1776 "things we would have designed differently, but are now stuck with for "
1777 "backwards compatibility or other reasons.  If there is ever a libguestfs 2.0 "
1778 "release, you can expect these to change.  Beware of them."
1779 msgstr ""
1780
1781 # type: =item
1782 #. type: =item
1783 #: ../src/guestfs.pod:776
1784 msgid "Autosync / forgetting to sync."
1785 msgstr ""
1786
1787 #. type: textblock
1788 #: ../src/guestfs.pod:778
1789 msgid ""
1790 "I<Update:> Autosync is enabled by default for all API users starting from "
1791 "libguestfs 1.5.24.  This section only applies to older versions."
1792 msgstr ""
1793
1794 # type: textblock
1795 #. type: textblock
1796 #: ../src/guestfs.pod:781
1797 msgid ""
1798 "When modifying a filesystem from C or another language, you B<must> unmount "
1799 "all filesystems and call L</guestfs_sync> explicitly before you close the "
1800 "libguestfs handle.  You can also call:"
1801 msgstr ""
1802
1803 # type: verbatim
1804 #. type: verbatim
1805 #: ../src/guestfs.pod:785
1806 #, no-wrap
1807 msgid ""
1808 " guestfs_set_autosync (g, 1);\n"
1809 "\n"
1810 msgstr ""
1811
1812 # type: textblock
1813 #. type: textblock
1814 #: ../src/guestfs.pod:787
1815 msgid ""
1816 "to have the unmount/sync done automatically for you when the handle 'g' is "
1817 "closed.  (This feature is called \"autosync\", L</guestfs_set_autosync> q.v.)"
1818 msgstr ""
1819
1820 # type: textblock
1821 #. type: textblock
1822 #: ../src/guestfs.pod:791
1823 msgid ""
1824 "If you forget to do this, then it is entirely possible that your changes "
1825 "won't be written out, or will be partially written, or (very rarely) that "
1826 "you'll get disk corruption."
1827 msgstr ""
1828
1829 # type: textblock
1830 #. type: textblock
1831 #: ../src/guestfs.pod:795
1832 msgid ""
1833 "Note that in L<guestfish(3)> autosync is the default.  So quick and dirty "
1834 "guestfish scripts that forget to sync will work just fine, which can make "
1835 "this very puzzling if you are trying to debug a problem."
1836 msgstr ""
1837
1838 # type: =item
1839 #. type: =item
1840 #: ../src/guestfs.pod:799
1841 msgid "Mount option C<-o sync> should not be the default."
1842 msgstr ""
1843
1844 # type: textblock
1845 #. type: textblock
1846 #: ../src/guestfs.pod:801
1847 msgid ""
1848 "If you use L</guestfs_mount>, then C<-o sync,noatime> are added implicitly.  "
1849 "However C<-o sync> does not add any reliability benefit, but does have a "
1850 "very large performance impact."
1851 msgstr ""
1852
1853 # type: textblock
1854 #. type: textblock
1855 #: ../src/guestfs.pod:805
1856 msgid ""
1857 "The work around is to use L</guestfs_mount_options> and set the mount "
1858 "options that you actually want to use."
1859 msgstr ""
1860
1861 # type: =item
1862 #. type: =item
1863 #: ../src/guestfs.pod:808
1864 msgid "Read-only should be the default."
1865 msgstr ""
1866
1867 # type: textblock
1868 #. type: textblock
1869 #: ../src/guestfs.pod:810
1870 msgid ""
1871 "In L<guestfish(3)>, I<--ro> should be the default, and you should have to "
1872 "specify I<--rw> if you want to make changes to the image."
1873 msgstr ""
1874
1875 # type: textblock
1876 #. type: textblock
1877 #: ../src/guestfs.pod:813
1878 msgid "This would reduce the potential to corrupt live VM images."
1879 msgstr ""
1880
1881 # type: textblock
1882 #. type: textblock
1883 #: ../src/guestfs.pod:815
1884 msgid ""
1885 "Note that many filesystems change the disk when you just mount and unmount, "
1886 "even if you didn't perform any writes.  You need to use L</"
1887 "guestfs_add_drive_ro> to guarantee that the disk is not changed."
1888 msgstr ""
1889
1890 # type: =item
1891 #. type: =item
1892 #: ../src/guestfs.pod:819
1893 msgid "guestfish command line is hard to use."
1894 msgstr ""
1895
1896 # type: textblock
1897 #. type: textblock
1898 #: ../src/guestfs.pod:821
1899 msgid ""
1900 "C<guestfish disk.img> doesn't do what people expect (open C<disk.img> for "
1901 "examination).  It tries to run a guestfish command C<disk.img> which doesn't "
1902 "exist, so it fails.  In earlier versions of guestfish the error message was "
1903 "also unintuitive, but we have corrected this since.  Like the Bourne shell, "
1904 "we should have used C<guestfish -c command> to run commands."
1905 msgstr ""
1906
1907 # type: =item
1908 #. type: =item
1909 #: ../src/guestfs.pod:828
1910 msgid "guestfish megabyte modifiers don't work right on all commands"
1911 msgstr ""
1912
1913 # type: textblock
1914 #. type: textblock
1915 #: ../src/guestfs.pod:830
1916 msgid ""
1917 "In recent guestfish you can use C<1M> to mean 1 megabyte (and similarly for "
1918 "other modifiers).  What guestfish actually does is to multiply the number "
1919 "part by the modifier part and pass the result to the C API.  However this "
1920 "doesn't work for a few APIs which aren't expecting bytes, but are already "
1921 "expecting some other unit (eg. megabytes)."
1922 msgstr ""
1923
1924 # type: textblock
1925 #. type: textblock
1926 #: ../src/guestfs.pod:837
1927 msgid "The most common is L</guestfs_lvcreate>.  The guestfish command:"
1928 msgstr ""
1929
1930 # type: verbatim
1931 #. type: verbatim
1932 #: ../src/guestfs.pod:839
1933 #, no-wrap
1934 msgid ""
1935 " lvcreate LV VG 100M\n"
1936 "\n"
1937 msgstr ""
1938
1939 # type: textblock
1940 #. type: textblock
1941 #: ../src/guestfs.pod:841
1942 msgid ""
1943 "does not do what you might expect.  Instead because L</guestfs_lvcreate> is "
1944 "already expecting megabytes, this tries to create a 100 I<terabyte> (100 "
1945 "megabytes * megabytes) logical volume.  The error message you get from this "
1946 "is also a little obscure."
1947 msgstr ""
1948
1949 # type: textblock
1950 #. type: textblock
1951 #: ../src/guestfs.pod:846
1952 msgid ""
1953 "This could be fixed in the generator by specially marking parameters and "
1954 "return values which take bytes or other units."
1955 msgstr ""
1956
1957 # type: =item
1958 #. type: =item
1959 #: ../src/guestfs.pod:849
1960 msgid "Ambiguity between devices and paths"
1961 msgstr ""
1962
1963 # type: textblock
1964 #. type: textblock
1965 #: ../src/guestfs.pod:851
1966 msgid ""
1967 "There is a subtle ambiguity in the API between a device name (eg. C</dev/"
1968 "sdb2>) and a similar pathname.  A file might just happen to be called "
1969 "C<sdb2> in the directory C</dev> (consider some non-Unix VM image)."
1970 msgstr ""
1971
1972 # type: textblock
1973 #. type: textblock
1974 #: ../src/guestfs.pod:856
1975 msgid ""
1976 "In the current API we usually resolve this ambiguity by having two separate "
1977 "calls, for example L</guestfs_checksum> and L</guestfs_checksum_device>.  "
1978 "Some API calls are ambiguous and (incorrectly) resolve the problem by "
1979 "detecting if the path supplied begins with C</dev/>."
1980 msgstr ""
1981
1982 # type: textblock
1983 #. type: textblock
1984 #: ../src/guestfs.pod:862
1985 msgid ""
1986 "To avoid both the ambiguity and the need to duplicate some calls, we could "
1987 "make paths/devices into structured names.  One way to do this would be to "
1988 "use a notation like grub (C<hd(0,0)>), although nobody really likes this "
1989 "aspect of grub.  Another way would be to use a structured type, equivalent "
1990 "to this OCaml type:"
1991 msgstr ""
1992
1993 # type: verbatim
1994 #. type: verbatim
1995 #: ../src/guestfs.pod:868
1996 #, no-wrap
1997 msgid ""
1998 " type path = Path of string | Device of int | Partition of int * int\n"
1999 "\n"
2000 msgstr ""
2001
2002 # type: textblock
2003 #. type: textblock
2004 #: ../src/guestfs.pod:870
2005 msgid "which would allow you to pass arguments like:"
2006 msgstr ""
2007
2008 # type: verbatim
2009 #. type: verbatim
2010 #: ../src/guestfs.pod:872
2011 #, no-wrap
2012 msgid ""
2013 " Path \"/foo/bar\"\n"
2014 " Device 1            (* /dev/sdb, or perhaps /dev/sda *)\n"
2015 " Partition (1, 2)    (* /dev/sdb2 (or is it /dev/sda2 or /dev/sdb3?) *)\n"
2016 " Path \"/dev/sdb2\"    (* not a device *)\n"
2017 "\n"
2018 msgstr ""
2019
2020 # type: textblock
2021 #. type: textblock
2022 #: ../src/guestfs.pod:877
2023 msgid ""
2024 "As you can see there are still problems to resolve even with this "
2025 "representation.  Also consider how it might work in guestfish."
2026 msgstr ""
2027
2028 # type: =head2
2029 #. type: =head2
2030 #: ../src/guestfs.pod:882
2031 msgid "KEYS AND PASSPHRASES"
2032 msgstr ""
2033
2034 # type: textblock
2035 #. type: textblock
2036 #: ../src/guestfs.pod:884
2037 msgid ""
2038 "Certain libguestfs calls take a parameter that contains sensitive key "
2039 "material, passed in as a C string."
2040 msgstr ""
2041
2042 # type: textblock
2043 #. type: textblock
2044 #: ../src/guestfs.pod:887
2045 msgid ""
2046 "In the future we would hope to change the libguestfs implementation so that "
2047 "keys are L<mlock(2)>-ed into physical RAM, and thus can never end up in "
2048 "swap.  However this is I<not> done at the moment, because of the complexity "
2049 "of such an implementation."
2050 msgstr ""
2051
2052 # type: textblock
2053 #. type: textblock
2054 #: ../src/guestfs.pod:892
2055 msgid ""
2056 "Therefore you should be aware that any key parameter you pass to libguestfs "
2057 "might end up being written out to the swap partition.  If this is a concern, "
2058 "scrub the swap partition or don't use libguestfs on encrypted devices."
2059 msgstr ""
2060
2061 # type: =head1
2062 #. type: =head2
2063 #: ../src/guestfs.pod:897
2064 msgid "MULTIPLE HANDLES AND MULTIPLE THREADS"
2065 msgstr ""
2066
2067 # type: textblock
2068 #. type: textblock
2069 #: ../src/guestfs.pod:899
2070 msgid ""
2071 "All high-level libguestfs actions are synchronous.  If you want to use "
2072 "libguestfs asynchronously then you must create a thread."
2073 msgstr ""
2074
2075 # type: textblock
2076 #. type: textblock
2077 #: ../src/guestfs.pod:902
2078 msgid ""
2079 "Only use the handle from a single thread.  Either use the handle exclusively "
2080 "from one thread, or provide your own mutex so that two threads cannot issue "
2081 "calls on the same handle at the same time."
2082 msgstr ""
2083
2084 # type: textblock
2085 #. type: textblock
2086 #: ../src/guestfs.pod:906
2087 msgid ""
2088 "See the graphical program guestfs-browser for one possible architecture for "
2089 "multithreaded programs using libvirt and libguestfs."
2090 msgstr ""
2091
2092 # type: =head1
2093 #. type: =head2
2094 #: ../src/guestfs.pod:909
2095 msgid "PATH"
2096 msgstr ""
2097
2098 #. type: textblock
2099 #: ../src/guestfs.pod:911
2100 msgid ""
2101 "Libguestfs needs a supermin appliance, which it finds by looking along an "
2102 "internal path."
2103 msgstr ""
2104
2105 # type: textblock
2106 #. type: textblock
2107 #: ../src/guestfs.pod:914
2108 msgid ""
2109 "By default it looks for these in the directory C<$libdir/guestfs> (eg. C</"
2110 "usr/local/lib/guestfs> or C</usr/lib64/guestfs>)."
2111 msgstr ""
2112
2113 # type: textblock
2114 #. type: textblock
2115 #: ../src/guestfs.pod:917
2116 msgid ""
2117 "Use L</guestfs_set_path> or set the environment variable L</LIBGUESTFS_PATH> "
2118 "to change the directories that libguestfs will search in.  The value is a "
2119 "colon-separated list of paths.  The current directory is I<not> searched "
2120 "unless the path contains an empty element or C<.>.  For example "
2121 "C<LIBGUESTFS_PATH=:/usr/lib/guestfs> would search the current directory and "
2122 "then C</usr/lib/guestfs>."
2123 msgstr ""
2124
2125 # type: =head1
2126 #. type: =head2
2127 #: ../src/guestfs.pod:924
2128 msgid "QEMU WRAPPERS"
2129 msgstr ""
2130
2131 # type: textblock
2132 #. type: textblock
2133 #: ../src/guestfs.pod:926
2134 msgid ""
2135 "If you want to compile your own qemu, run qemu from a non-standard location, "
2136 "or pass extra arguments to qemu, then you can write a shell-script wrapper "
2137 "around qemu."
2138 msgstr ""
2139
2140 # type: textblock
2141 #. type: textblock
2142 #: ../src/guestfs.pod:930
2143 msgid ""
2144 "There is one important rule to remember: you I<must C<exec qemu>> as the "
2145 "last command in the shell script (so that qemu replaces the shell and "
2146 "becomes the direct child of the libguestfs-using program).  If you don't do "
2147 "this, then the qemu process won't be cleaned up correctly."
2148 msgstr ""
2149
2150 # type: textblock
2151 #. type: textblock
2152 #: ../src/guestfs.pod:935
2153 msgid ""
2154 "Here is an example of a wrapper, where I have built my own copy of qemu from "
2155 "source:"
2156 msgstr ""
2157
2158 # type: verbatim
2159 #. type: verbatim
2160 #: ../src/guestfs.pod:938
2161 #, no-wrap
2162 msgid ""
2163 " #!/bin/sh -\n"
2164 " qemudir=/home/rjones/d/qemu\n"
2165 " exec $qemudir/x86_64-softmmu/qemu-system-x86_64 -L $qemudir/pc-bios \"$@\"\n"
2166 "\n"
2167 msgstr ""
2168
2169 # type: textblock
2170 #. type: textblock
2171 #: ../src/guestfs.pod:942
2172 msgid ""
2173 "Save this script as C</tmp/qemu.wrapper> (or wherever), C<chmod +x>, and "
2174 "then use it by setting the LIBGUESTFS_QEMU environment variable.  For "
2175 "example:"
2176 msgstr ""
2177
2178 # type: verbatim
2179 #. type: verbatim
2180 #: ../src/guestfs.pod:946
2181 #, no-wrap
2182 msgid ""
2183 " LIBGUESTFS_QEMU=/tmp/qemu.wrapper guestfish\n"
2184 "\n"
2185 msgstr ""
2186
2187 # type: textblock
2188 #. type: textblock
2189 #: ../src/guestfs.pod:948
2190 msgid ""
2191 "Note that libguestfs also calls qemu with the -help and -version options in "
2192 "order to determine features."
2193 msgstr ""
2194
2195 #. type: =head2
2196 #: ../src/guestfs.pod:951
2197 msgid "ATTACHING TO RUNNING DAEMONS"
2198 msgstr ""
2199
2200 #. type: textblock
2201 #: ../src/guestfs.pod:953
2202 msgid ""
2203 "I<Note (1):> This is B<highly experimental> and has a tendency to eat "
2204 "babies.  Use with caution."
2205 msgstr ""
2206
2207 #. type: textblock
2208 #: ../src/guestfs.pod:956
2209 msgid ""
2210 "I<Note (2):> This section explains how to attach to a running daemon from a "
2211 "low level perspective.  For most users, simply using virt tools such as "
2212 "L<guestfish(1)> with the I<--live> option will \"just work\"."
2213 msgstr ""
2214
2215 #. type: =head3
2216 #: ../src/guestfs.pod:960
2217 msgid "Using guestfs_set_attach_method"
2218 msgstr ""
2219
2220 #. type: textblock
2221 #: ../src/guestfs.pod:962
2222 msgid ""
2223 "By calling L</guestfs_set_attach_method> you can change how the library "
2224 "connects to the C<guestfsd> daemon in L</guestfs_launch> (read L</"
2225 "ARCHITECTURE> for some background)."
2226 msgstr ""
2227
2228 #. type: textblock
2229 #: ../src/guestfs.pod:966
2230 msgid ""
2231 "The normal attach method is C<appliance>, where a small appliance is created "
2232 "containing the daemon, and then the library connects to this."
2233 msgstr ""
2234
2235 #. type: textblock
2236 #: ../src/guestfs.pod:969
2237 msgid ""
2238 "Setting attach method to C<unix:I<path>> (where I<path> is the path of a "
2239 "Unix domain socket) causes L</guestfs_launch> to connect to an existing "
2240 "daemon over the Unix domain socket."
2241 msgstr ""
2242
2243 #. type: textblock
2244 #: ../src/guestfs.pod:973
2245 msgid ""
2246 "The normal use for this is to connect to a running virtual machine that "
2247 "contains a C<guestfsd> daemon, and send commands so you can read and write "
2248 "files inside the live virtual machine."
2249 msgstr ""
2250
2251 #. type: =head3
2252 #: ../src/guestfs.pod:977
2253 msgid "Using guestfs_add_domain with live flag"
2254 msgstr ""
2255
2256 #. type: textblock
2257 #: ../src/guestfs.pod:979
2258 msgid ""
2259 "L</guestfs_add_domain> provides some help for getting the correct attach "
2260 "method.  If you pass the C<live> option to this function, then (if the "
2261 "virtual machine is running) it will examine the libvirt XML looking for a "
2262 "virtio-serial channel to connect to:"
2263 msgstr ""
2264
2265 #. type: verbatim
2266 #: ../src/guestfs.pod:985
2267 #, no-wrap
2268 msgid ""
2269 " <domain>\n"
2270 "   ...\n"
2271 "   <devices>\n"
2272 "     ...\n"
2273 "     <channel type='unix'>\n"
2274 "       <source mode='bind' path='/path/to/socket'/>\n"
2275 "       <target type='virtio' name='org.libguestfs.channel.0'/>\n"
2276 "     </channel>\n"
2277 "     ...\n"
2278 "   </devices>\n"
2279 " </domain>\n"
2280 "\n"
2281 msgstr ""
2282
2283 #. type: textblock
2284 #: ../src/guestfs.pod:997
2285 msgid ""
2286 "L</guestfs_add_domain> extracts C</path/to/socket> and sets the attach "
2287 "method to C<unix:/path/to/socket>."
2288 msgstr ""
2289
2290 #. type: textblock
2291 #: ../src/guestfs.pod:1000
2292 msgid ""
2293 "Some of the libguestfs tools (including guestfish) support a I<--live> "
2294 "option which is passed through to L</guestfs_add_domain> thus allowing you "
2295 "to attach to and modify live virtual machines."
2296 msgstr ""
2297
2298 #. type: textblock
2299 #: ../src/guestfs.pod:1004
2300 msgid ""
2301 "The virtual machine needs to have been set up beforehand so that it has the "
2302 "virtio-serial channel and so that guestfsd is running inside it."
2303 msgstr ""
2304
2305 # type: =head2
2306 #. type: =head2
2307 #: ../src/guestfs.pod:1008
2308 msgid "ABI GUARANTEE"
2309 msgstr ""
2310
2311 # type: textblock
2312 #. type: textblock
2313 #: ../src/guestfs.pod:1010
2314 msgid ""
2315 "We guarantee the libguestfs ABI (binary interface), for public, high-level "
2316 "actions as outlined in this section.  Although we will deprecate some "
2317 "actions, for example if they get replaced by newer calls, we will keep the "
2318 "old actions forever.  This allows you the developer to program in confidence "
2319 "against the libguestfs API."
2320 msgstr ""
2321
2322 # type: =head1
2323 #. type: =head2
2324 #: ../src/guestfs.pod:1016
2325 msgid "BLOCK DEVICE NAMING"
2326 msgstr ""
2327
2328 # type: textblock
2329 #. type: textblock
2330 #: ../src/guestfs.pod:1018
2331 msgid ""
2332 "In the kernel there is now quite a profusion of schemata for naming block "
2333 "devices (in this context, by I<block device> I mean a physical or virtual "
2334 "hard drive).  The original Linux IDE driver used names starting with C</dev/"
2335 "hd*>.  SCSI devices have historically used a different naming scheme, C</dev/"
2336 "sd*>.  When the Linux kernel I<libata> driver became a popular replacement "
2337 "for the old IDE driver (particularly for SATA devices) those devices also "
2338 "used the C</dev/sd*> scheme.  Additionally we now have virtual machines with "
2339 "paravirtualized drivers.  This has created several different naming systems, "
2340 "such as C</dev/vd*> for virtio disks and C</dev/xvd*> for Xen PV disks."
2341 msgstr ""
2342
2343 # type: textblock
2344 #. type: textblock
2345 #: ../src/guestfs.pod:1030
2346 msgid ""
2347 "As discussed above, libguestfs uses a qemu appliance running an embedded "
2348 "Linux kernel to access block devices.  We can run a variety of appliances "
2349 "based on a variety of Linux kernels."
2350 msgstr ""
2351
2352 # type: textblock
2353 #. type: textblock
2354 #: ../src/guestfs.pod:1034
2355 msgid ""
2356 "This causes a problem for libguestfs because many API calls use device or "
2357 "partition names.  Working scripts and the recipe (example) scripts that we "
2358 "make available over the internet could fail if the naming scheme changes."
2359 msgstr ""
2360
2361 # type: textblock
2362 #. type: textblock
2363 #: ../src/guestfs.pod:1039
2364 msgid ""
2365 "Therefore libguestfs defines C</dev/sd*> as the I<standard naming scheme>.  "
2366 "Internally C</dev/sd*> names are translated, if necessary, to other names as "
2367 "required.  For example, under RHEL 5 which uses the C</dev/hd*> scheme, any "
2368 "device parameter C</dev/sda2> is translated to C</dev/hda2> transparently."
2369 msgstr ""
2370
2371 # type: textblock
2372 #. type: textblock
2373 #: ../src/guestfs.pod:1045
2374 msgid ""
2375 "Note that this I<only> applies to parameters.  The L</guestfs_list_devices>, "
2376 "L</guestfs_list_partitions> and similar calls return the true names of the "
2377 "devices and partitions as known to the appliance."
2378 msgstr ""
2379
2380 # type: =head2
2381 #. type: =head3
2382 #: ../src/guestfs.pod:1050
2383 msgid "ALGORITHM FOR BLOCK DEVICE NAME TRANSLATION"
2384 msgstr ""
2385
2386 # type: textblock
2387 #. type: textblock
2388 #: ../src/guestfs.pod:1052
2389 msgid ""
2390 "Usually this translation is transparent.  However in some (very rare)  cases "
2391 "you may need to know the exact algorithm.  Such cases include where you use "
2392 "L</guestfs_config> to add a mixture of virtio and IDE devices to the qemu-"
2393 "based appliance, so have a mixture of C</dev/sd*> and C</dev/vd*> devices."
2394 msgstr ""
2395
2396 # type: textblock
2397 #. type: textblock
2398 #: ../src/guestfs.pod:1058
2399 msgid ""
2400 "The algorithm is applied only to I<parameters> which are known to be either "
2401 "device or partition names.  Return values from functions such as L</"
2402 "guestfs_list_devices> are never changed."
2403 msgstr ""
2404
2405 # type: textblock
2406 #. type: textblock
2407 #: ../src/guestfs.pod:1066
2408 msgid "Is the string a parameter which is a device or partition name?"
2409 msgstr ""
2410
2411 # type: textblock
2412 #. type: textblock
2413 #: ../src/guestfs.pod:1070
2414 msgid "Does the string begin with C</dev/sd>?"
2415 msgstr ""
2416
2417 # type: textblock
2418 #. type: textblock
2419 #: ../src/guestfs.pod:1074
2420 msgid ""
2421 "Does the named device exist? If so, we use that device.  However if I<not> "
2422 "then we continue with this algorithm."
2423 msgstr ""
2424
2425 # type: textblock
2426 #. type: textblock
2427 #: ../src/guestfs.pod:1079
2428 msgid "Replace initial C</dev/sd> string with C</dev/hd>."
2429 msgstr ""
2430
2431 # type: textblock
2432 #. type: textblock
2433 #: ../src/guestfs.pod:1081
2434 msgid "For example, change C</dev/sda2> to C</dev/hda2>."
2435 msgstr ""
2436
2437 # type: textblock
2438 #. type: textblock
2439 #: ../src/guestfs.pod:1083
2440 msgid "If that named device exists, use it.  If not, continue."
2441 msgstr ""
2442
2443 # type: textblock
2444 #. type: textblock
2445 #: ../src/guestfs.pod:1087
2446 msgid "Replace initial C</dev/sd> string with C</dev/vd>."
2447 msgstr ""
2448
2449 # type: textblock
2450 #. type: textblock
2451 #: ../src/guestfs.pod:1089
2452 msgid "If that named device exists, use it.  If not, return an error."
2453 msgstr ""
2454
2455 # type: =head3
2456 #. type: =head3
2457 #: ../src/guestfs.pod:1093
2458 msgid "PORTABILITY CONCERNS WITH BLOCK DEVICE NAMING"
2459 msgstr ""
2460
2461 # type: textblock
2462 #. type: textblock
2463 #: ../src/guestfs.pod:1095
2464 msgid ""
2465 "Although the standard naming scheme and automatic translation is useful for "
2466 "simple programs and guestfish scripts, for larger programs it is best not to "
2467 "rely on this mechanism."
2468 msgstr ""
2469
2470 # type: textblock
2471 #. type: textblock
2472 #: ../src/guestfs.pod:1099
2473 msgid ""
2474 "Where possible for maximum future portability programs using libguestfs "
2475 "should use these future-proof techniques:"
2476 msgstr ""
2477
2478 # type: textblock
2479 #. type: textblock
2480 #: ../src/guestfs.pod:1106
2481 msgid ""
2482 "Use L</guestfs_list_devices> or L</guestfs_list_partitions> to list actual "
2483 "device names, and then use those names directly."
2484 msgstr ""
2485
2486 # type: textblock
2487 #. type: textblock
2488 #: ../src/guestfs.pod:1109
2489 msgid ""
2490 "Since those device names exist by definition, they will never be translated."
2491 msgstr ""
2492
2493 # type: textblock
2494 #. type: textblock
2495 #: ../src/guestfs.pod:1114
2496 msgid ""
2497 "Use higher level ways to identify filesystems, such as LVM names, UUIDs and "
2498 "filesystem labels."
2499 msgstr ""
2500
2501 # type: =head1
2502 #. type: =head1
2503 #: ../src/guestfs.pod:1119
2504 msgid "SECURITY"
2505 msgstr ""
2506
2507 # type: textblock
2508 #. type: textblock
2509 #: ../src/guestfs.pod:1121
2510 msgid ""
2511 "This section discusses security implications of using libguestfs, "
2512 "particularly with untrusted or malicious guests or disk images."
2513 msgstr ""
2514
2515 # type: =head2
2516 #. type: =head2
2517 #: ../src/guestfs.pod:1124
2518 msgid "GENERAL SECURITY CONSIDERATIONS"
2519 msgstr ""
2520
2521 # type: textblock
2522 #. type: textblock
2523 #: ../src/guestfs.pod:1126
2524 msgid ""
2525 "Be careful with any files or data that you download from a guest (by "
2526 "\"download\" we mean not just the L</guestfs_download> command but any "
2527 "command that reads files, filenames, directories or anything else from a "
2528 "disk image).  An attacker could manipulate the data to fool your program "
2529 "into doing the wrong thing.  Consider cases such as:"
2530 msgstr ""
2531
2532 # type: textblock
2533 #. type: textblock
2534 #: ../src/guestfs.pod:1136
2535 msgid "the data (file etc) not being present"
2536 msgstr ""
2537
2538 # type: textblock
2539 #. type: textblock
2540 #: ../src/guestfs.pod:1140
2541 msgid "being present but empty"
2542 msgstr ""
2543
2544 # type: textblock
2545 #. type: textblock
2546 #: ../src/guestfs.pod:1144
2547 msgid "being much larger than normal"
2548 msgstr ""
2549
2550 # type: textblock
2551 #. type: textblock
2552 #: ../src/guestfs.pod:1148
2553 msgid "containing arbitrary 8 bit data"
2554 msgstr ""
2555
2556 # type: textblock
2557 #. type: textblock
2558 #: ../src/guestfs.pod:1152
2559 msgid "being in an unexpected character encoding"
2560 msgstr ""
2561
2562 # type: textblock
2563 #. type: textblock
2564 #: ../src/guestfs.pod:1156
2565 msgid "containing homoglyphs."
2566 msgstr ""
2567
2568 # type: =head2
2569 #. type: =head2
2570 #: ../src/guestfs.pod:1160
2571 msgid "SECURITY OF MOUNTING FILESYSTEMS"
2572 msgstr ""
2573
2574 # type: textblock
2575 #. type: textblock
2576 #: ../src/guestfs.pod:1162
2577 msgid ""
2578 "When you mount a filesystem under Linux, mistakes in the kernel filesystem "
2579 "(VFS) module can sometimes be escalated into exploits by deliberately "
2580 "creating a malicious, malformed filesystem.  These exploits are very severe "
2581 "for two reasons.  Firstly there are very many filesystem drivers in the "
2582 "kernel, and many of them are infrequently used and not much developer "
2583 "attention has been paid to the code.  Linux userspace helps potential "
2584 "crackers by detecting the filesystem type and automatically choosing the "
2585 "right VFS driver, even if that filesystem type is obscure or unexpected for "
2586 "the administrator.  Secondly, a kernel-level exploit is like a local root "
2587 "exploit (worse in some ways), giving immediate and total access to the "
2588 "system right down to the hardware level."
2589 msgstr ""
2590
2591 # type: textblock
2592 #. type: textblock
2593 #: ../src/guestfs.pod:1175
2594 msgid ""
2595 "That explains why you should never mount a filesystem from an untrusted "
2596 "guest on your host kernel.  How about libguestfs? We run a Linux kernel "
2597 "inside a qemu virtual machine, usually running as a non-root user.  The "
2598 "attacker would need to write a filesystem which first exploited the kernel, "
2599 "and then exploited either qemu virtualization (eg. a faulty qemu driver) or "
2600 "the libguestfs protocol, and finally to be as serious as the host kernel "
2601 "exploit it would need to escalate its privileges to root.  This multi-step "
2602 "escalation, performed by a static piece of data, is thought to be extremely "
2603 "hard to do, although we never say 'never' about security issues."
2604 msgstr ""
2605
2606 # type: textblock
2607 #. type: textblock
2608 #: ../src/guestfs.pod:1186
2609 msgid ""
2610 "In any case callers can reduce the attack surface by forcing the filesystem "
2611 "type when mounting (use L</guestfs_mount_vfs>)."
2612 msgstr ""
2613
2614 # type: =head2
2615 #. type: =head2
2616 #: ../src/guestfs.pod:1189
2617 msgid "PROTOCOL SECURITY"
2618 msgstr ""
2619
2620 # type: textblock
2621 #. type: textblock
2622 #: ../src/guestfs.pod:1191
2623 msgid ""
2624 "The protocol is designed to be secure, being based on RFC 4506 (XDR)  with a "
2625 "defined upper message size.  However a program that uses libguestfs must "
2626 "also take care - for example you can write a program that downloads a binary "
2627 "from a disk image and executes it locally, and no amount of protocol "
2628 "security will save you from the consequences."
2629 msgstr ""
2630
2631 # type: =head2
2632 #. type: =head2
2633 #: ../src/guestfs.pod:1197
2634 msgid "INSPECTION SECURITY"
2635 msgstr ""
2636
2637 # type: textblock
2638 #. type: textblock
2639 #: ../src/guestfs.pod:1199
2640 msgid ""
2641 "Parts of the inspection API (see L</INSPECTION>) return untrusted strings "
2642 "directly from the guest, and these could contain any 8 bit data.  Callers "
2643 "should be careful to escape these before printing them to a structured file "
2644 "(for example, use HTML escaping if creating a web page)."
2645 msgstr ""
2646
2647 # type: textblock
2648 #. type: textblock
2649 #: ../src/guestfs.pod:1205
2650 msgid ""
2651 "Guest configuration may be altered in unusual ways by the administrator of "
2652 "the virtual machine, and may not reflect reality (particularly for untrusted "
2653 "or actively malicious guests).  For example we parse the hostname from "
2654 "configuration files like C</etc/sysconfig/network> that we find in the "
2655 "guest, but the guest administrator can easily manipulate these files to "
2656 "provide the wrong hostname."
2657 msgstr ""
2658
2659 # type: textblock
2660 #. type: textblock
2661 #: ../src/guestfs.pod:1213
2662 msgid ""
2663 "The inspection API parses guest configuration using two external libraries: "
2664 "Augeas (Linux configuration) and hivex (Windows Registry).  Both are "
2665 "designed to be robust in the face of malicious data, although denial of "
2666 "service attacks are still possible, for example with oversized configuration "
2667 "files."
2668 msgstr ""
2669
2670 # type: =head2
2671 #. type: =head2
2672 #: ../src/guestfs.pod:1219
2673 msgid "RUNNING UNTRUSTED GUEST COMMANDS"
2674 msgstr ""
2675
2676 # type: textblock
2677 #. type: textblock
2678 #: ../src/guestfs.pod:1221
2679 msgid ""
2680 "Be very cautious about running commands from the guest.  By running a "
2681 "command in the guest, you are giving CPU time to a binary that you do not "
2682 "control, under the same user account as the library, albeit wrapped in qemu "
2683 "virtualization.  More information and alternatives can be found in the "
2684 "section L</RUNNING COMMANDS>."
2685 msgstr ""
2686
2687 # type: =head2
2688 #. type: =head2
2689 #: ../src/guestfs.pod:1227
2690 msgid "CVE-2010-3851"
2691 msgstr ""
2692
2693 # type: textblock
2694 #. type: textblock
2695 #: ../src/guestfs.pod:1229
2696 msgid "https://bugzilla.redhat.com/642934"
2697 msgstr ""
2698
2699 # type: textblock
2700 #. type: textblock
2701 #: ../src/guestfs.pod:1231
2702 msgid ""
2703 "This security bug concerns the automatic disk format detection that qemu "
2704 "does on disk images."
2705 msgstr ""
2706
2707 # type: textblock
2708 #. type: textblock
2709 #: ../src/guestfs.pod:1234
2710 msgid ""
2711 "A raw disk image is just the raw bytes, there is no header.  Other disk "
2712 "images like qcow2 contain a special header.  Qemu deals with this by looking "
2713 "for one of the known headers, and if none is found then assuming the disk "
2714 "image must be raw."
2715 msgstr ""
2716
2717 # type: textblock
2718 #. type: textblock
2719 #: ../src/guestfs.pod:1239
2720 msgid ""
2721 "This allows a guest which has been given a raw disk image to write some "
2722 "other header.  At next boot (or when the disk image is accessed by "
2723 "libguestfs) qemu would do autodetection and think the disk image format was, "
2724 "say, qcow2 based on the header written by the guest."
2725 msgstr ""
2726
2727 # type: textblock
2728 #. type: textblock
2729 #: ../src/guestfs.pod:1244
2730 msgid ""
2731 "This in itself would not be a problem, but qcow2 offers many features, one "
2732 "of which is to allow a disk image to refer to another image (called the "
2733 "\"backing disk\").  It does this by placing the path to the backing disk "
2734 "into the qcow2 header.  This path is not validated and could point to any "
2735 "host file (eg. \"/etc/passwd\").  The backing disk is then exposed through "
2736 "\"holes\" in the qcow2 disk image, which of course is completely under the "
2737 "control of the attacker."
2738 msgstr ""
2739
2740 # type: textblock
2741 #. type: textblock
2742 #: ../src/guestfs.pod:1252
2743 msgid ""
2744 "In libguestfs this is rather hard to exploit except under two circumstances:"
2745 msgstr ""
2746
2747 # type: textblock
2748 #. type: textblock
2749 #: ../src/guestfs.pod:1259
2750 msgid "You have enabled the network or have opened the disk in write mode."
2751 msgstr ""
2752
2753 # type: textblock
2754 #. type: textblock
2755 #: ../src/guestfs.pod:1263
2756 msgid ""
2757 "You are also running untrusted code from the guest (see L</RUNNING "
2758 "COMMANDS>)."
2759 msgstr ""
2760
2761 # type: textblock
2762 #. type: textblock
2763 #: ../src/guestfs.pod:1268
2764 msgid ""
2765 "The way to avoid this is to specify the expected disk format when adding "
2766 "disks (the optional C<format> option to L</guestfs_add_drive_opts>).  You "
2767 "should always do this if the disk is raw format, and it's a good idea for "
2768 "other cases too."
2769 msgstr ""
2770
2771 # type: textblock
2772 #. type: textblock
2773 #: ../src/guestfs.pod:1273
2774 msgid ""
2775 "For disks added from libvirt using calls like L</guestfs_add_domain>, the "
2776 "format is fetched from libvirt and passed through."
2777 msgstr ""
2778
2779 # type: textblock
2780 #. type: textblock
2781 #: ../src/guestfs.pod:1276
2782 msgid ""
2783 "For libguestfs tools, use the I<--format> command line parameter as "
2784 "appropriate."
2785 msgstr ""
2786
2787 # type: =head1
2788 #. type: =head1
2789 #: ../src/guestfs.pod:1279
2790 msgid "CONNECTION MANAGEMENT"
2791 msgstr ""
2792
2793 # type: =head2
2794 #. type: =head2
2795 #: ../src/guestfs.pod:1281
2796 msgid "guestfs_h *"
2797 msgstr ""
2798
2799 # type: textblock
2800 #. type: textblock
2801 #: ../src/guestfs.pod:1283
2802 msgid ""
2803 "C<guestfs_h> is the opaque type representing a connection handle.  Create a "
2804 "handle by calling L</guestfs_create>.  Call L</guestfs_close> to free the "
2805 "handle and release all resources used."
2806 msgstr ""
2807
2808 #. type: textblock
2809 #: ../src/guestfs.pod:1287
2810 msgid ""
2811 "For information on using multiple handles and threads, see the section L</"
2812 "MULTIPLE HANDLES AND MULTIPLE THREADS> above."
2813 msgstr ""
2814
2815 # type: =head2
2816 #. type: =head2
2817 #: ../src/guestfs.pod:1290
2818 msgid "guestfs_create"
2819 msgstr ""
2820
2821 # type: verbatim
2822 #. type: verbatim
2823 #: ../src/guestfs.pod:1292
2824 #, no-wrap
2825 msgid ""
2826 " guestfs_h *guestfs_create (void);\n"
2827 "\n"
2828 msgstr ""
2829
2830 # type: textblock
2831 #. type: textblock
2832 #: ../src/guestfs.pod:1294
2833 msgid "Create a connection handle."
2834 msgstr ""
2835
2836 #. type: textblock
2837 #: ../src/guestfs.pod:1296
2838 msgid ""
2839 "On success this returns a non-NULL pointer to a handle.  On error it returns "
2840 "NULL."
2841 msgstr ""
2842
2843 #. type: textblock
2844 #: ../src/guestfs.pod:1299
2845 msgid ""
2846 "You have to \"configure\" the handle after creating it.  This includes "
2847 "calling L</guestfs_add_drive_opts> (or one of the equivalent calls) on the "
2848 "handle at least once."
2849 msgstr ""
2850
2851 # type: textblock
2852 #. type: textblock
2853 #: ../src/guestfs.pod:1303
2854 msgid "After configuring the handle, you have to call L</guestfs_launch>."
2855 msgstr ""
2856
2857 #. type: textblock
2858 #: ../src/guestfs.pod:1305
2859 msgid ""
2860 "You may also want to configure error handling for the handle.  See the L</"
2861 "ERROR HANDLING> section below."
2862 msgstr ""
2863
2864 # type: =head2
2865 #. type: =head2
2866 #: ../src/guestfs.pod:1308
2867 msgid "guestfs_close"
2868 msgstr ""
2869
2870 # type: verbatim
2871 #. type: verbatim
2872 #: ../src/guestfs.pod:1310
2873 #, no-wrap
2874 msgid ""
2875 " void guestfs_close (guestfs_h *g);\n"
2876 "\n"
2877 msgstr ""
2878
2879 # type: textblock
2880 #. type: textblock
2881 #: ../src/guestfs.pod:1312
2882 msgid "This closes the connection handle and frees up all resources used."
2883 msgstr ""
2884
2885 #. type: textblock
2886 #: ../src/guestfs.pod:1314
2887 msgid ""
2888 "If autosync was set on the handle and the handle was launched, then this "
2889 "implicitly calls various functions to unmount filesystems and sync the "
2890 "disk.  See L</guestfs_set_autosync> for more details."
2891 msgstr ""
2892
2893 #. type: textblock
2894 #: ../src/guestfs.pod:1318
2895 msgid "If a close callback was set on the handle, then it is called."
2896 msgstr ""
2897
2898 # type: =head1
2899 #. type: =head1
2900 #: ../src/guestfs.pod:1320
2901 msgid "ERROR HANDLING"
2902 msgstr ""
2903
2904 # type: textblock
2905 #. type: textblock
2906 #: ../src/guestfs.pod:1322
2907 msgid ""
2908 "API functions can return errors.  For example, almost all functions that "
2909 "return C<int> will return C<-1> to indicate an error."
2910 msgstr ""
2911
2912 # type: textblock
2913 #. type: textblock
2914 #: ../src/guestfs.pod:1325
2915 msgid ""
2916 "Additional information is available for errors: an error message string and "
2917 "optionally an error number (errno) if the thing that failed was a system "
2918 "call."
2919 msgstr ""
2920
2921 # type: textblock
2922 #. type: textblock
2923 #: ../src/guestfs.pod:1329
2924 msgid ""
2925 "You can get at the additional information about the last error on the handle "
2926 "by calling L</guestfs_last_error>, L</guestfs_last_errno>, and/or by setting "
2927 "up an error handler with L</guestfs_set_error_handler>."
2928 msgstr ""
2929
2930 # type: textblock
2931 #. type: textblock
2932 #: ../src/guestfs.pod:1334
2933 msgid ""
2934 "When the handle is created, a default error handler is installed which "
2935 "prints the error message string to C<stderr>.  For small short-running "
2936 "command line programs it is sufficient to do:"
2937 msgstr ""
2938
2939 # type: verbatim
2940 #. type: verbatim
2941 #: ../src/guestfs.pod:1338
2942 #, no-wrap
2943 msgid ""
2944 " if (guestfs_launch (g) == -1)\n"
2945 "   exit (EXIT_FAILURE);\n"
2946 "\n"
2947 msgstr ""
2948
2949 # type: textblock
2950 #. type: textblock
2951 #: ../src/guestfs.pod:1341
2952 msgid ""
2953 "since the default error handler will ensure that an error message has been "
2954 "printed to C<stderr> before the program exits."
2955 msgstr ""
2956
2957 # type: textblock
2958 #. type: textblock
2959 #: ../src/guestfs.pod:1344
2960 msgid ""
2961 "For other programs the caller will almost certainly want to install an "
2962 "alternate error handler or do error handling in-line like this:"
2963 msgstr ""
2964
2965 # type: verbatim
2966 #. type: verbatim
2967 #: ../src/guestfs.pod:1347
2968 #, no-wrap
2969 msgid ""
2970 " g = guestfs_create ();\n"
2971 " \n"
2972 msgstr ""
2973
2974 # type: verbatim
2975 #. type: verbatim
2976 #: ../src/guestfs.pod:1349
2977 #, no-wrap
2978 msgid ""
2979 " /* This disables the default behaviour of printing errors\n"
2980 "    on stderr. */\n"
2981 " guestfs_set_error_handler (g, NULL, NULL);\n"
2982 " \n"
2983 msgstr ""
2984
2985 # type: verbatim
2986 #. type: verbatim
2987 #: ../src/guestfs.pod:1353
2988 #, no-wrap
2989 msgid ""
2990 " if (guestfs_launch (g) == -1) {\n"
2991 "   /* Examine the error message and print it etc. */\n"
2992 "   char *msg = guestfs_last_error (g);\n"
2993 "   int errnum = guestfs_last_errno (g);\n"
2994 "   fprintf (stderr, \"%s\\n\", msg);\n"
2995 "   /* ... */\n"
2996 "  }\n"
2997 "\n"
2998 msgstr ""
2999
3000 # type: textblock
3001 #. type: textblock
3002 #: ../src/guestfs.pod:1361
3003 msgid ""
3004 "Out of memory errors are handled differently.  The default action is to call "
3005 "L<abort(3)>.  If this is undesirable, then you can set a handler using L</"
3006 "guestfs_set_out_of_memory_handler>."
3007 msgstr ""
3008
3009 # type: textblock
3010 #. type: textblock
3011 #: ../src/guestfs.pod:1365
3012 msgid ""
3013 "L</guestfs_create> returns C<NULL> if the handle cannot be created, and "
3014 "because there is no handle if this happens there is no way to get additional "
3015 "error information.  However L</guestfs_create> is supposed to be a "
3016 "lightweight operation which can only fail because of insufficient memory (it "
3017 "returns NULL in this case)."
3018 msgstr ""
3019
3020 # type: =head2
3021 #. type: =head2
3022 #: ../src/guestfs.pod:1371
3023 msgid "guestfs_last_error"
3024 msgstr ""
3025
3026 # type: verbatim
3027 #. type: verbatim
3028 #: ../src/guestfs.pod:1373
3029 #, no-wrap
3030 msgid ""
3031 " const char *guestfs_last_error (guestfs_h *g);\n"
3032 "\n"
3033 msgstr ""
3034
3035 # type: textblock
3036 #. type: textblock
3037 #: ../src/guestfs.pod:1375
3038 msgid ""
3039 "This returns the last error message that happened on C<g>.  If there has not "
3040 "been an error since the handle was created, then this returns C<NULL>."
3041 msgstr ""
3042
3043 # type: textblock
3044 #. type: textblock
3045 #: ../src/guestfs.pod:1379
3046 msgid ""
3047 "The lifetime of the returned string is until the next error occurs, or L</"
3048 "guestfs_close> is called."
3049 msgstr ""
3050
3051 # type: =head2
3052 #. type: =head2
3053 #: ../src/guestfs.pod:1382
3054 msgid "guestfs_last_errno"
3055 msgstr ""
3056
3057 # type: verbatim
3058 #. type: verbatim
3059 #: ../src/guestfs.pod:1384
3060 #, no-wrap
3061 msgid ""
3062 " int guestfs_last_errno (guestfs_h *g);\n"
3063 "\n"
3064 msgstr ""
3065
3066 # type: textblock
3067 #. type: textblock
3068 #: ../src/guestfs.pod:1386
3069 msgid "This returns the last error number (errno) that happened on C<g>."
3070 msgstr ""
3071
3072 # type: textblock
3073 #. type: textblock
3074 #: ../src/guestfs.pod:1388
3075 msgid "If successful, an errno integer not equal to zero is returned."
3076 msgstr ""
3077
3078 # type: textblock
3079 #. type: textblock
3080 #: ../src/guestfs.pod:1390
3081 msgid ""
3082 "If no error, this returns 0.  This call can return 0 in three situations:"
3083 msgstr ""
3084
3085 # type: textblock
3086 #. type: textblock
3087 #: ../src/guestfs.pod:1397
3088 msgid "There has not been any error on the handle."
3089 msgstr ""
3090
3091 # type: textblock
3092 #. type: textblock
3093 #: ../src/guestfs.pod:1401
3094 msgid ""
3095 "There has been an error but the errno was meaningless.  This corresponds to "
3096 "the case where the error did not come from a failed system call, but for "
3097 "some other reason."
3098 msgstr ""
3099
3100 # type: textblock
3101 #. type: textblock
3102 #: ../src/guestfs.pod:1407
3103 msgid ""
3104 "There was an error from a failed system call, but for some reason the errno "
3105 "was not captured and returned.  This usually indicates a bug in libguestfs."
3106 msgstr ""
3107
3108 # type: textblock
3109 #. type: textblock
3110 #: ../src/guestfs.pod:1413
3111 msgid ""
3112 "Libguestfs tries to convert the errno from inside the applicance into a "
3113 "corresponding errno for the caller (not entirely trivial: the appliance "
3114 "might be running a completely different operating system from the library "
3115 "and error numbers are not standardized across Un*xen).  If this could not be "
3116 "done, then the error is translated to C<EINVAL>.  In practice this should "
3117 "only happen in very rare circumstances."
3118 msgstr ""
3119
3120 # type: =head2
3121 #. type: =head2
3122 #: ../src/guestfs.pod:1421
3123 msgid "guestfs_set_error_handler"
3124 msgstr ""
3125
3126 # type: verbatim
3127 #. type: verbatim
3128 #: ../src/guestfs.pod:1423
3129 #, no-wrap
3130 msgid ""
3131 " typedef void (*guestfs_error_handler_cb) (guestfs_h *g,\n"
3132 "                                           void *opaque,\n"
3133 "                                           const char *msg);\n"
3134 " void guestfs_set_error_handler (guestfs_h *g,\n"
3135 "                                 guestfs_error_handler_cb cb,\n"
3136 "                                 void *opaque);\n"
3137 "\n"
3138 msgstr ""
3139
3140 # type: textblock
3141 #. type: textblock
3142 #: ../src/guestfs.pod:1430
3143 msgid ""
3144 "The callback C<cb> will be called if there is an error.  The parameters "
3145 "passed to the callback are an opaque data pointer and the error message "
3146 "string."
3147 msgstr ""
3148
3149 # type: textblock
3150 #. type: textblock
3151 #: ../src/guestfs.pod:1434
3152 msgid ""
3153 "C<errno> is not passed to the callback.  To get that the callback must call "
3154 "L</guestfs_last_errno>."
3155 msgstr ""
3156
3157 # type: textblock
3158 #. type: textblock
3159 #: ../src/guestfs.pod:1437
3160 msgid ""
3161 "Note that the message string C<msg> is freed as soon as the callback "
3162 "function returns, so if you want to stash it somewhere you must make your "
3163 "own copy."
3164 msgstr ""
3165
3166 # type: textblock
3167 #. type: textblock
3168 #: ../src/guestfs.pod:1441
3169 msgid "The default handler prints messages on C<stderr>."
3170 msgstr ""
3171
3172 # type: textblock
3173 #. type: textblock
3174 #: ../src/guestfs.pod:1443
3175 msgid "If you set C<cb> to C<NULL> then I<no> handler is called."
3176 msgstr ""
3177
3178 # type: =head2
3179 #. type: =head2
3180 #: ../src/guestfs.pod:1445
3181 msgid "guestfs_get_error_handler"
3182 msgstr ""
3183
3184 # type: verbatim
3185 #. type: verbatim
3186 #: ../src/guestfs.pod:1447
3187 #, no-wrap
3188 msgid ""
3189 " guestfs_error_handler_cb guestfs_get_error_handler (guestfs_h *g,\n"
3190 "                                                     void **opaque_rtn);\n"
3191 "\n"
3192 msgstr ""
3193
3194 # type: textblock
3195 #. type: textblock
3196 #: ../src/guestfs.pod:1450
3197 msgid "Returns the current error handler callback."
3198 msgstr ""
3199
3200 # type: =head2
3201 #. type: =head2
3202 #: ../src/guestfs.pod:1452
3203 msgid "guestfs_set_out_of_memory_handler"
3204 msgstr ""
3205
3206 # type: verbatim
3207 #. type: verbatim
3208 #: ../src/guestfs.pod:1454
3209 #, no-wrap
3210 msgid ""
3211 " typedef void (*guestfs_abort_cb) (void);\n"
3212 " int guestfs_set_out_of_memory_handler (guestfs_h *g,\n"
3213 "                                        guestfs_abort_cb);\n"
3214 "\n"
3215 msgstr ""
3216
3217 # type: textblock
3218 #. type: textblock
3219 #: ../src/guestfs.pod:1458
3220 msgid ""
3221 "The callback C<cb> will be called if there is an out of memory situation.  "
3222 "I<Note this callback must not return>."
3223 msgstr ""
3224
3225 # type: textblock
3226 #. type: textblock
3227 #: ../src/guestfs.pod:1461
3228 msgid "The default is to call L<abort(3)>."
3229 msgstr ""
3230
3231 # type: textblock
3232 #. type: textblock
3233 #: ../src/guestfs.pod:1463
3234 msgid ""
3235 "You cannot set C<cb> to C<NULL>.  You can't ignore out of memory situations."
3236 msgstr ""
3237
3238 # type: =head2
3239 #. type: =head2
3240 #: ../src/guestfs.pod:1466
3241 msgid "guestfs_get_out_of_memory_handler"
3242 msgstr ""
3243
3244 # type: verbatim
3245 #. type: verbatim
3246 #: ../src/guestfs.pod:1468
3247 #, no-wrap
3248 msgid ""
3249 " guestfs_abort_fn guestfs_get_out_of_memory_handler (guestfs_h *g);\n"
3250 "\n"
3251 msgstr ""
3252
3253 # type: textblock
3254 #. type: textblock
3255 #: ../src/guestfs.pod:1470
3256 msgid "This returns the current out of memory handler."
3257 msgstr ""
3258
3259 # type: =head1
3260 #. type: =head1
3261 #: ../src/guestfs.pod:1472
3262 msgid "API CALLS"
3263 msgstr ""
3264
3265 # type: textblock
3266 #. type: textblock
3267 #: ../src/guestfs.pod:1474 ../fish/guestfish.pod:1008
3268 msgid "@ACTIONS@"
3269 msgstr ""
3270
3271 # type: =head1
3272 #. type: =head1
3273 #: ../src/guestfs.pod:1476
3274 msgid "STRUCTURES"
3275 msgstr ""
3276
3277 # type: textblock
3278 #. type: textblock
3279 #: ../src/guestfs.pod:1478
3280 msgid "@STRUCTS@"
3281 msgstr ""
3282
3283 # type: =head1
3284 #. type: =head1
3285 #: ../src/guestfs.pod:1480
3286 msgid "AVAILABILITY"
3287 msgstr ""
3288
3289 # type: =head2
3290 #. type: =head2
3291 #: ../src/guestfs.pod:1482
3292 msgid "GROUPS OF FUNCTIONALITY IN THE APPLIANCE"
3293 msgstr ""
3294
3295 # type: textblock
3296 #. type: textblock
3297 #: ../src/guestfs.pod:1484
3298 msgid ""
3299 "Using L</guestfs_available> you can test availability of the following "
3300 "groups of functions.  This test queries the appliance to see if the "
3301 "appliance you are currently using supports the functionality."
3302 msgstr ""
3303
3304 # type: textblock
3305 #. type: textblock
3306 #: ../src/guestfs.pod:1489
3307 msgid "@AVAILABILITY@"
3308 msgstr ""
3309
3310 # type: =head2
3311 #. type: =head2
3312 #: ../src/guestfs.pod:1491
3313 msgid "GUESTFISH supported COMMAND"
3314 msgstr ""
3315
3316 # type: textblock
3317 #. type: textblock
3318 #: ../src/guestfs.pod:1493
3319 msgid ""
3320 "In L<guestfish(3)> there is a handy interactive command C<supported> which "
3321 "prints out the available groups and whether they are supported by this build "
3322 "of libguestfs.  Note however that you have to do C<run> first."
3323 msgstr ""
3324
3325 # type: =head2
3326 #. type: =head2
3327 #: ../src/guestfs.pod:1498
3328 msgid "SINGLE CALLS AT COMPILE TIME"
3329 msgstr ""
3330
3331 # type: textblock
3332 #. type: textblock
3333 #: ../src/guestfs.pod:1500
3334 msgid ""
3335 "Since version 1.5.8, C<E<lt>guestfs.hE<gt>> defines symbols for each C API "
3336 "function, such as:"
3337 msgstr ""
3338
3339 # type: verbatim
3340 #. type: verbatim
3341 #: ../src/guestfs.pod:1503
3342 #, no-wrap
3343 msgid ""
3344 " #define LIBGUESTFS_HAVE_DD 1\n"
3345 "\n"
3346 msgstr ""
3347
3348 # type: textblock
3349 #. type: textblock
3350 #: ../src/guestfs.pod:1505
3351 msgid "if L</guestfs_dd> is available."
3352 msgstr ""
3353
3354 # type: textblock
3355 #. type: textblock
3356 #: ../src/guestfs.pod:1507
3357 msgid ""
3358 "Before version 1.5.8, if you needed to test whether a single libguestfs "
3359 "function is available at compile time, we recommended using build tools such "
3360 "as autoconf or cmake.  For example in autotools you could use:"
3361 msgstr ""
3362
3363 # type: verbatim
3364 #. type: verbatim
3365 #: ../src/guestfs.pod:1512
3366 #, no-wrap
3367 msgid ""
3368 " AC_CHECK_LIB([guestfs],[guestfs_create])\n"
3369 " AC_CHECK_FUNCS([guestfs_dd])\n"
3370 "\n"
3371 msgstr ""
3372
3373 # type: textblock
3374 #. type: textblock
3375 #: ../src/guestfs.pod:1515
3376 msgid ""
3377 "which would result in C<HAVE_GUESTFS_DD> being either defined or not defined "
3378 "in your program."
3379 msgstr ""
3380
3381 # type: =head2
3382 #. type: =head2
3383 #: ../src/guestfs.pod:1518
3384 msgid "SINGLE CALLS AT RUN TIME"
3385 msgstr ""
3386
3387 # type: textblock
3388 #. type: textblock
3389 #: ../src/guestfs.pod:1520
3390 msgid ""
3391 "Testing at compile time doesn't guarantee that a function really exists in "
3392 "the library.  The reason is that you might be dynamically linked against a "
3393 "previous I<libguestfs.so> (dynamic library)  which doesn't have the call.  "
3394 "This situation unfortunately results in a segmentation fault, which is a "
3395 "shortcoming of the C dynamic linking system itself."
3396 msgstr ""
3397
3398 # type: textblock
3399 #. type: textblock
3400 #: ../src/guestfs.pod:1527
3401 msgid ""
3402 "You can use L<dlopen(3)> to test if a function is available at run time, as "
3403 "in this example program (note that you still need the compile time check as "
3404 "well):"
3405 msgstr ""
3406
3407 # type: verbatim
3408 #. type: verbatim
3409 #: ../src/guestfs.pod:1531
3410 #, no-wrap
3411 msgid ""
3412 " #include <stdio.h>\n"
3413 " #include <stdlib.h>\n"
3414 " #include <unistd.h>\n"
3415 " #include <dlfcn.h>\n"
3416 " #include <guestfs.h>\n"
3417 " \n"
3418 msgstr ""
3419
3420 # type: verbatim
3421 #. type: verbatim
3422 #: ../src/guestfs.pod:1537
3423 #, no-wrap
3424 msgid ""
3425 " main ()\n"
3426 " {\n"
3427 " #ifdef LIBGUESTFS_HAVE_DD\n"
3428 "   void *dl;\n"
3429 "   int has_function;\n"
3430 " \n"
3431 msgstr ""
3432
3433 # type: verbatim
3434 #. type: verbatim
3435 #: ../src/guestfs.pod:1543
3436 #, no-wrap
3437 msgid ""
3438 "   /* Test if the function guestfs_dd is really available. */\n"
3439 "   dl = dlopen (NULL, RTLD_LAZY);\n"
3440 "   if (!dl) {\n"
3441 "     fprintf (stderr, \"dlopen: %s\\n\", dlerror ());\n"
3442 "     exit (EXIT_FAILURE);\n"
3443 "   }\n"
3444 "   has_function = dlsym (dl, \"guestfs_dd\") != NULL;\n"
3445 "   dlclose (dl);\n"
3446 " \n"
3447 msgstr ""
3448
3449 # type: verbatim
3450 #. type: verbatim
3451 #: ../src/guestfs.pod:1552
3452 #, no-wrap
3453 msgid ""
3454 "   if (!has_function)\n"
3455 "     printf (\"this libguestfs.so does NOT have guestfs_dd function\\n\");\n"
3456 "   else {\n"
3457 "     printf (\"this libguestfs.so has guestfs_dd function\\n\");\n"
3458 "     /* Now it's safe to call\n"
3459 "     guestfs_dd (g, \"foo\", \"bar\");\n"
3460 "     */\n"
3461 "   }\n"
3462 " #else\n"
3463 "   printf (\"guestfs_dd function was not found at compile time\\n\");\n"
3464 " #endif\n"
3465 "  }\n"
3466 "\n"
3467 msgstr ""
3468
3469 # type: textblock
3470 #. type: textblock
3471 #: ../src/guestfs.pod:1565
3472 msgid ""
3473 "You may think the above is an awful lot of hassle, and it is.  There are "
3474 "other ways outside of the C linking system to ensure that this kind of "
3475 "incompatibility never arises, such as using package versioning:"
3476 msgstr ""
3477
3478 # type: verbatim
3479 #. type: verbatim
3480 #: ../src/guestfs.pod:1570
3481 #, no-wrap
3482 msgid ""
3483 " Requires: libguestfs >= 1.0.80\n"
3484 "\n"
3485 msgstr ""
3486
3487 # type: =head1
3488 #. type: =head1
3489 #: ../src/guestfs.pod:1572
3490 msgid "CALLS WITH OPTIONAL ARGUMENTS"
3491 msgstr ""
3492
3493 # type: textblock
3494 #. type: textblock
3495 #: ../src/guestfs.pod:1574
3496 msgid ""
3497 "A recent feature of the API is the introduction of calls which take optional "
3498 "arguments.  In C these are declared 3 ways.  The main way is as a call which "
3499 "takes variable arguments (ie. C<...>), as in this example:"
3500 msgstr ""
3501
3502 # type: verbatim
3503 #. type: verbatim
3504 #: ../src/guestfs.pod:1579
3505 #, no-wrap
3506 msgid ""
3507 " int guestfs_add_drive_opts (guestfs_h *g, const char *filename, ...);\n"
3508 "\n"
3509 msgstr ""
3510
3511 # type: textblock
3512 #. type: textblock
3513 #: ../src/guestfs.pod:1581
3514 msgid ""
3515 "Call this with a list of optional arguments, terminated by C<-1>.  So to "
3516 "call with no optional arguments specified:"
3517 msgstr ""
3518
3519 # type: verbatim
3520 #. type: verbatim
3521 #: ../src/guestfs.pod:1584
3522 #, no-wrap
3523 msgid ""
3524 " guestfs_add_drive_opts (g, filename, -1);\n"
3525 "\n"
3526 msgstr ""
3527
3528 # type: textblock
3529 #. type: textblock
3530 #: ../src/guestfs.pod:1586
3531 msgid "With a single optional argument:"
3532 msgstr ""
3533
3534 # type: verbatim
3535 #. type: verbatim
3536 #: ../src/guestfs.pod:1588
3537 #, no-wrap
3538 msgid ""
3539 " guestfs_add_drive_opts (g, filename,\n"
3540 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"qcow2\",\n"
3541 "                         -1);\n"
3542 "\n"
3543 msgstr ""
3544
3545 # type: textblock
3546 #. type: textblock
3547 #: ../src/guestfs.pod:1592
3548 msgid "With two:"
3549 msgstr ""
3550
3551 # type: verbatim
3552 #. type: verbatim
3553 #: ../src/guestfs.pod:1594
3554 #, no-wrap
3555 msgid ""
3556 " guestfs_add_drive_opts (g, filename,\n"
3557 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"qcow2\",\n"
3558 "                         GUESTFS_ADD_DRIVE_OPTS_READONLY, 1,\n"
3559 "                         -1);\n"
3560 "\n"
3561 msgstr ""
3562
3563 # type: textblock
3564 #. type: textblock
3565 #: ../src/guestfs.pod:1599
3566 msgid ""
3567 "and so forth.  Don't forget the terminating C<-1> otherwise Bad Things will "
3568 "happen!"
3569 msgstr ""
3570
3571 # type: =head2
3572 #. type: =head2
3573 #: ../src/guestfs.pod:1602
3574 msgid "USING va_list FOR OPTIONAL ARGUMENTS"
3575 msgstr ""
3576
3577 # type: textblock
3578 #. type: textblock
3579 #: ../src/guestfs.pod:1604
3580 msgid ""
3581 "The second variant has the same name with the suffix C<_va>, which works the "
3582 "same way but takes a C<va_list>.  See the C manual for details.  For the "
3583 "example function, this is declared:"
3584 msgstr ""
3585
3586 # type: verbatim
3587 #. type: verbatim
3588 #: ../src/guestfs.pod:1608
3589 #, no-wrap
3590 msgid ""
3591 " int guestfs_add_drive_opts_va (guestfs_h *g, const char *filename,\n"
3592 "                                va_list args);\n"
3593 "\n"
3594 msgstr ""
3595
3596 # type: =head2
3597 #. type: =head2
3598 #: ../src/guestfs.pod:1611
3599 msgid "CONSTRUCTING OPTIONAL ARGUMENTS"
3600 msgstr ""
3601
3602 # type: textblock
3603 #. type: textblock
3604 #: ../src/guestfs.pod:1613
3605 msgid ""
3606 "The third variant is useful where you need to construct these calls.  You "
3607 "pass in a structure where you fill in the optional fields.  The structure "
3608 "has a bitmask as the first element which you must set to indicate which "
3609 "fields you have filled in.  For our example function the structure and call "
3610 "are declared:"
3611 msgstr ""
3612
3613 # type: verbatim
3614 #. type: verbatim
3615 #: ../src/guestfs.pod:1619
3616 #, no-wrap
3617 msgid ""
3618 " struct guestfs_add_drive_opts_argv {\n"
3619 "   uint64_t bitmask;\n"
3620 "   int readonly;\n"
3621 "   const char *format;\n"
3622 "   /* ... */\n"
3623 " };\n"
3624 " int guestfs_add_drive_opts_argv (guestfs_h *g, const char *filename,\n"
3625 "              const struct guestfs_add_drive_opts_argv *optargs);\n"
3626 "\n"
3627 msgstr ""
3628
3629 # type: textblock
3630 #. type: textblock
3631 #: ../src/guestfs.pod:1628
3632 msgid "You could call it like this:"
3633 msgstr ""
3634
3635 # type: verbatim
3636 #. type: verbatim
3637 #: ../src/guestfs.pod:1630
3638 #, no-wrap
3639 msgid ""
3640 " struct guestfs_add_drive_opts_argv optargs = {\n"
3641 "   .bitmask = GUESTFS_ADD_DRIVE_OPTS_READONLY_BITMASK |\n"
3642 "              GUESTFS_ADD_DRIVE_OPTS_FORMAT_BITMASK,\n"
3643 "   .readonly = 1,\n"
3644 "   .format = \"qcow2\"\n"
3645 " };\n"
3646 " \n"
3647 msgstr ""
3648
3649 # type: verbatim
3650 #. type: verbatim
3651 #: ../src/guestfs.pod:1637
3652 #, no-wrap
3653 msgid ""
3654 " guestfs_add_drive_opts_argv (g, filename, &optargs);\n"
3655 "\n"
3656 msgstr ""
3657
3658 # type: textblock
3659 #. type: textblock
3660 #: ../src/guestfs.pod:1639 ../src/guestfs-actions.pod:11
3661 #: ../src/guestfs-actions.pod:1852 ../fish/guestfish-actions.pod:9
3662 #: ../fish/guestfish-actions.pod:1257 ../tools/virt-win-reg.pl:532
3663 msgid "Notes:"
3664 msgstr ""
3665
3666 # type: textblock
3667 #. type: textblock
3668 #: ../src/guestfs.pod:1645
3669 msgid "The C<_BITMASK> suffix on each option name when specifying the bitmask."
3670 msgstr ""
3671
3672 # type: textblock
3673 #. type: textblock
3674 #: ../src/guestfs.pod:1650
3675 msgid "You do not need to fill in all fields of the structure."
3676 msgstr ""
3677
3678 # type: textblock
3679 #. type: textblock
3680 #: ../src/guestfs.pod:1654
3681 msgid ""
3682 "There must be a one-to-one correspondence between fields of the structure "
3683 "that are filled in, and bits set in the bitmask."
3684 msgstr ""
3685
3686 # type: =head2
3687 #. type: =head2
3688 #: ../src/guestfs.pod:1659
3689 msgid "OPTIONAL ARGUMENTS IN OTHER LANGUAGES"
3690 msgstr ""
3691
3692 # type: textblock
3693 #. type: textblock
3694 #: ../src/guestfs.pod:1661
3695 msgid ""
3696 "In other languages, optional arguments are expressed in the way that is "
3697 "natural for that language.  We refer you to the language-specific "
3698 "documentation for more details on that."
3699 msgstr ""
3700
3701 # type: textblock
3702 #. type: textblock
3703 #: ../src/guestfs.pod:1665
3704 msgid "For guestfish, see L<guestfish(1)/OPTIONAL ARGUMENTS>."
3705 msgstr ""
3706
3707 # type: =head2
3708 #. type: =head2
3709 #: ../src/guestfs.pod:1667
3710 msgid "SETTING CALLBACKS TO HANDLE EVENTS"
3711 msgstr ""
3712
3713 #. type: textblock
3714 #: ../src/guestfs.pod:1669
3715 msgid ""
3716 "B<Note:> This section documents the generic event mechanism introduced in "
3717 "libguestfs 1.10, which you should use in new code if possible.  The old "
3718 "functions C<guestfs_set_log_message_callback>, "
3719 "C<guestfs_set_subprocess_quit_callback>, "
3720 "C<guestfs_set_launch_done_callback>, C<guestfs_set_close_callback> and "
3721 "C<guestfs_set_progress_callback> are no longer documented in this manual "
3722 "page."
3723 msgstr ""
3724
3725 #. type: textblock
3726 #: ../src/guestfs.pod:1677
3727 msgid ""
3728 "Handles generate events when certain things happen, such as log messages "
3729 "being generated, progress messages during long-running operations, or the "
3730 "handle being closed.  The API calls described below let you register a "
3731 "callback to be called when events happen.  You can register multiple "
3732 "callbacks (for the same, different or overlapping sets of events), and "
3733 "individually remove callbacks.  If callbacks are not removed, then they "
3734 "remain in force until the handle is closed."
3735 msgstr ""
3736
3737 #. type: textblock
3738 #: ../src/guestfs.pod:1685
3739 msgid ""
3740 "In the current implementation, events are only generated synchronously: that "
3741 "means that events (and hence callbacks) can only happen while you are in the "
3742 "middle of making another libguestfs call.  The callback is called in the "
3743 "same thread."
3744 msgstr ""
3745
3746 #. type: textblock
3747 #: ../src/guestfs.pod:1690
3748 msgid ""
3749 "Events may contain a payload, usually nothing (void), an array of 64 bit "
3750 "unsigned integers, or a message buffer.  Payloads are discussed later on."
3751 msgstr ""
3752
3753 #. type: =head3
3754 #: ../src/guestfs.pod:1694
3755 msgid "CLASSES OF EVENTS"
3756 msgstr ""
3757
3758 #. type: =item
3759 #: ../src/guestfs.pod:1698
3760 msgid "GUESTFS_EVENT_CLOSE (payload type: void)"
3761 msgstr ""
3762
3763 #. type: textblock
3764 #: ../src/guestfs.pod:1701
3765 msgid ""
3766 "The callback function will be called while the handle is being closed "
3767 "(synchronously from L</guestfs_close>)."
3768 msgstr ""
3769
3770 # type: textblock
3771 #. type: textblock
3772 #: ../src/guestfs.pod:1704
3773 msgid ""
3774 "Note that libguestfs installs an L<atexit(3)> handler to try to clean up "
3775 "handles that are open when the program exits.  This means that this callback "
3776 "might be called indirectly from L<exit(3)>, which can cause unexpected "
3777 "problems in higher-level languages (eg. if your HLL interpreter has already "
3778 "been cleaned up by the time this is called, and if your callback then jumps "
3779 "into some HLL function)."
3780 msgstr ""
3781
3782 #. type: textblock
3783 #: ../src/guestfs.pod:1711
3784 msgid ""
3785 "If no callback is registered: the handle is closed without any callback "
3786 "being invoked."
3787 msgstr ""
3788
3789 #. type: =item
3790 #: ../src/guestfs.pod:1714
3791 msgid "GUESTFS_EVENT_SUBPROCESS_QUIT (payload type: void)"
3792 msgstr ""
3793
3794 #. type: textblock
3795 #: ../src/guestfs.pod:1717
3796 msgid ""
3797 "The callback function will be called when the child process quits, either "
3798 "asynchronously or if killed by L</guestfs_kill_subprocess>.  (This "
3799 "corresponds to a transition from any state to the CONFIG state)."
3800 msgstr ""
3801
3802 #. type: textblock
3803 #: ../src/guestfs.pod:1721 ../src/guestfs.pod:1730
3804 msgid "If no callback is registered: the event is ignored."
3805 msgstr ""
3806
3807 #. type: =item
3808 #: ../src/guestfs.pod:1723
3809 msgid "GUESTFS_EVENT_LAUNCH_DONE (payload type: void)"
3810 msgstr ""
3811
3812 #. type: textblock
3813 #: ../src/guestfs.pod:1726
3814 msgid ""
3815 "The callback function will be called when the child process becomes ready "
3816 "first time after it has been launched.  (This corresponds to a transition "
3817 "from LAUNCHING to the READY state)."
3818 msgstr ""
3819
3820 #. type: =item
3821 #: ../src/guestfs.pod:1732
3822 msgid "GUESTFS_EVENT_PROGRESS (payload type: array of 4 x uint64_t)"
3823 msgstr ""
3824
3825 # type: textblock
3826 #. type: textblock
3827 #: ../src/guestfs.pod:1735
3828 msgid ""
3829 "Some long-running operations can generate progress messages.  If this "
3830 "callback is registered, then it will be called each time a progress message "
3831 "is generated (usually two seconds after the operation started, and three "
3832 "times per second thereafter until it completes, although the frequency may "
3833 "change in future versions)."
3834 msgstr ""
3835
3836 #. type: textblock
3837 #: ../src/guestfs.pod:1741
3838 msgid ""
3839 "The callback receives in the payload four unsigned 64 bit numbers which are "
3840 "(in order): C<proc_nr>, C<serial>, C<position>, C<total>."
3841 msgstr ""
3842
3843 #. type: textblock
3844 #: ../src/guestfs.pod:1744
3845 msgid ""
3846 "The units of C<total> are not defined, although for some operations C<total> "
3847 "may relate in some way to the amount of data to be transferred (eg. in bytes "
3848 "or megabytes), and C<position> may be the portion which has been transferred."
3849 msgstr ""
3850
3851 # type: textblock
3852 #. type: textblock
3853 #: ../src/guestfs.pod:1749
3854 msgid "The only defined and stable parts of the API are:"
3855 msgstr ""
3856
3857 # type: textblock
3858 #. type: textblock
3859 #: ../src/guestfs.pod:1755
3860 msgid ""
3861 "The callback can display to the user some type of progress bar or indicator "
3862 "which shows the ratio of C<position>:C<total>."
3863 msgstr ""
3864
3865 # type: textblock
3866 #. type: textblock
3867 #: ../src/guestfs.pod:1760
3868 msgid "0 E<lt>= C<position> E<lt>= C<total>"
3869 msgstr ""
3870
3871 #. type: textblock
3872 #: ../src/guestfs.pod:1764
3873 msgid ""
3874 "If any progress notification is sent during a call, then a final progress "
3875 "notification is always sent when C<position> = C<total> (I<unless> the call "
3876 "fails with an error)."
3877 msgstr ""
3878
3879 # type: textblock
3880 #. type: textblock
3881 #: ../src/guestfs.pod:1768
3882 msgid ""
3883 "This is to simplify caller code, so callers can easily set the progress "
3884 "indicator to \"100%\" at the end of the operation, without requiring special "
3885 "code to detect this case."
3886 msgstr ""
3887
3888 #. type: textblock
3889 #: ../src/guestfs.pod:1774
3890 msgid ""
3891 "For some calls we are unable to estimate the progress of the call, but we "
3892 "can still generate progress messages to indicate activity.  This is known as "
3893 "\"pulse mode\", and is directly supported by certain progress bar "
3894 "implementations (eg. GtkProgressBar)."
3895 msgstr ""
3896
3897 #. type: textblock
3898 #: ../src/guestfs.pod:1779
3899 msgid ""
3900 "For these calls, zero or more progress messages are generated with "
3901 "C<position = 0> and C<total = 1>, followed by a final message with "
3902 "C<position = total = 1>."
3903 msgstr ""
3904
3905 #. type: textblock
3906 #: ../src/guestfs.pod:1783
3907 msgid ""
3908 "As noted above, if the call fails with an error then the final message may "
3909 "not be generated."
3910 msgstr ""
3911
3912 #. type: textblock
3913 #: ../src/guestfs.pod:1788
3914 msgid ""
3915 "The callback also receives the procedure number (C<proc_nr>) and serial "
3916 "number (C<serial>) of the call.  These are only useful for debugging "
3917 "protocol issues, and the callback can normally ignore them.  The callback "
3918 "may want to print these numbers in error messages or debugging messages."
3919 msgstr ""
3920
3921 #. type: textblock
3922 #: ../src/guestfs.pod:1794
3923 msgid "If no callback is registered: progress messages are discarded."
3924 msgstr ""
3925
3926 #. type: =item
3927 #: ../src/guestfs.pod:1796
3928 msgid "GUESTFS_EVENT_APPLIANCE (payload type: message buffer)"
3929 msgstr ""
3930
3931 #. type: textblock
3932 #: ../src/guestfs.pod:1799
3933 msgid ""
3934 "The callback function is called whenever a log message is generated by qemu, "
3935 "the appliance kernel, guestfsd (daemon), or utility programs."
3936 msgstr ""
3937
3938 #. type: textblock
3939 #: ../src/guestfs.pod:1802
3940 msgid ""
3941 "If the verbose flag (L</guestfs_set_verbose>) is set before launch (L</"
3942 "guestfs_launch>) then additional debug messages are generated."
3943 msgstr ""
3944
3945 #. type: textblock
3946 #: ../src/guestfs.pod:1805 ../src/guestfs.pod:1819
3947 msgid ""
3948 "If no callback is registered: the messages are discarded unless the verbose "
3949 "flag is set in which case they are sent to stderr.  You can override the "
3950 "printing of verbose messages to stderr by setting up a callback."
3951 msgstr ""
3952
3953 #. type: =item
3954 #: ../src/guestfs.pod:1810
3955 msgid "GUESTFS_EVENT_LIBRARY (payload type: message buffer)"
3956 msgstr ""
3957
3958 #. type: textblock
3959 #: ../src/guestfs.pod:1813
3960 msgid ""
3961 "The callback function is called whenever a log message is generated by the "
3962 "library part of libguestfs."
3963 msgstr ""
3964
3965 #. type: textblock
3966 #: ../src/guestfs.pod:1816
3967 msgid ""
3968 "If the verbose flag (L</guestfs_set_verbose>) is set then additional debug "
3969 "messages are generated."
3970 msgstr ""
3971
3972 #. type: =item
3973 #: ../src/guestfs.pod:1824
3974 msgid "GUESTFS_EVENT_TRACE (payload type: message buffer)"
3975 msgstr ""
3976
3977 #. type: textblock
3978 #: ../src/guestfs.pod:1827
3979 msgid ""
3980 "The callback function is called whenever a trace message is generated.  This "
3981 "only applies if the trace flag (L</guestfs_set_trace>) is set."
3982 msgstr ""
3983
3984 #. type: textblock
3985 #: ../src/guestfs.pod:1830
3986 msgid ""
3987 "If no callback is registered: the messages are sent to stderr.  You can "
3988 "override the printing of trace messages to stderr by setting up a callback."
3989 msgstr ""
3990
3991 #. type: =head3
3992 #: ../src/guestfs.pod:1836
3993 msgid "guestfs_set_event_callback"
3994 msgstr ""
3995
3996 #. type: verbatim
3997 #: ../src/guestfs.pod:1838
3998 #, no-wrap
3999 msgid ""
4000 " int guestfs_set_event_callback (guestfs_h *g,\n"
4001 "                                 guestfs_event_callback cb,\n"
4002 "                                 uint64_t event_bitmask,\n"
4003 "                                 int flags,\n"
4004 "                                 void *opaque);\n"
4005 "\n"
4006 msgstr ""
4007
4008 #. type: textblock
4009 #: ../src/guestfs.pod:1844
4010 msgid ""
4011 "This function registers a callback (C<cb>) for all event classes in the "
4012 "C<event_bitmask>."
4013 msgstr ""
4014
4015 #. type: textblock
4016 #: ../src/guestfs.pod:1847
4017 msgid ""
4018 "For example, to register for all log message events, you could call this "
4019 "function with the bitmask C<GUESTFS_EVENT_APPLIANCE|GUESTFS_EVENT_LIBRARY>.  "
4020 "To register a single callback for all possible classes of events, use "
4021 "C<GUESTFS_EVENT_ALL>."
4022 msgstr ""
4023
4024 #. type: textblock
4025 #: ../src/guestfs.pod:1853
4026 msgid "C<flags> should always be passed as 0."
4027 msgstr ""
4028
4029 #. type: textblock
4030 #: ../src/guestfs.pod:1855
4031 msgid ""
4032 "C<opaque> is an opaque pointer which is passed to the callback.  You can use "
4033 "it for any purpose."
4034 msgstr ""
4035
4036 #. type: textblock
4037 #: ../src/guestfs.pod:1858
4038 msgid ""
4039 "The return value is the event handle (an integer) which you can use to "
4040 "delete the callback (see below)."
4041 msgstr ""
4042
4043 #. type: textblock
4044 #: ../src/guestfs.pod:1861
4045 msgid ""
4046 "If there is an error, this function returns C<-1>, and sets the error in the "
4047 "handle in the usual way (see L</guestfs_last_error> etc.)"
4048 msgstr ""
4049
4050 #. type: textblock
4051 #: ../src/guestfs.pod:1864
4052 msgid ""
4053 "Callbacks remain in effect until they are deleted, or until the handle is "
4054 "closed."
4055 msgstr ""
4056
4057 #. type: textblock
4058 #: ../src/guestfs.pod:1867
4059 msgid ""
4060 "In the case where multiple callbacks are registered for a particular event "
4061 "class, all of the callbacks are called.  The order in which multiple "
4062 "callbacks are called is not defined."
4063 msgstr ""
4064
4065 #. type: =head3
4066 #: ../src/guestfs.pod:1871
4067 msgid "guestfs_delete_event_callback"
4068 msgstr ""
4069
4070 #. type: verbatim
4071 #: ../src/guestfs.pod:1873
4072 #, no-wrap
4073 msgid ""
4074 " void guestfs_delete_event_callback (guestfs_h *g, int event_handle);\n"
4075 "\n"
4076 msgstr ""
4077
4078 #. type: textblock
4079 #: ../src/guestfs.pod:1875
4080 msgid ""
4081 "Delete a callback that was previously registered.  C<event_handle> should be "
4082 "the integer that was returned by a previous call to "
4083 "C<guestfs_set_event_callback> on the same handle."
4084 msgstr ""
4085
4086 #. type: =head3
4087 #: ../src/guestfs.pod:1879
4088 msgid "guestfs_event_callback"
4089 msgstr ""
4090
4091 #. type: verbatim
4092 #: ../src/guestfs.pod:1881
4093 #, no-wrap
4094 msgid ""
4095 " typedef void (*guestfs_event_callback) (\n"
4096 "                  guestfs_h *g,\n"
4097 "                  void *opaque,\n"
4098 "                  uint64_t event,\n"
4099 "                  int event_handle,\n"
4100 "                  int flags,\n"
4101 "                  const char *buf, size_t buf_len,\n"
4102 "                  const uint64_t *array, size_t array_len);\n"
4103 "\n"
4104 msgstr ""
4105
4106 #. type: textblock
4107 #: ../src/guestfs.pod:1890
4108 msgid ""
4109 "This is the type of the event callback function that you have to provide."
4110 msgstr ""
4111
4112 #. type: textblock
4113 #: ../src/guestfs.pod:1893
4114 msgid ""
4115 "The basic parameters are: the handle (C<g>), the opaque user pointer "
4116 "(C<opaque>), the event class (eg. C<GUESTFS_EVENT_PROGRESS>), the event "
4117 "handle, and C<flags> which in the current API you should ignore."
4118 msgstr ""
4119
4120 #. type: textblock
4121 #: ../src/guestfs.pod:1897
4122 msgid ""
4123 "The remaining parameters contain the event payload (if any).  Each event may "
4124 "contain a payload, which usually relates to the event class, but for future "
4125 "proofing your code should be written to handle any payload for any event "
4126 "class."
4127 msgstr ""
4128
4129 #. type: textblock
4130 #: ../src/guestfs.pod:1902
4131 msgid ""
4132 "C<buf> and C<buf_len> contain a message buffer (if C<buf_len == 0>, then "
4133 "there is no message buffer).  Note that this message buffer can contain "
4134 "arbitrary 8 bit data, including NUL bytes."
4135 msgstr ""
4136
4137 #. type: textblock
4138 #: ../src/guestfs.pod:1906
4139 msgid ""
4140 "C<array> and C<array_len> is an array of 64 bit unsigned integers.  At the "
4141 "moment this is only used for progress messages."
4142 msgstr ""
4143
4144 #. type: =head3
4145 #: ../src/guestfs.pod:1909
4146 msgid "EXAMPLE: CAPTURING LOG MESSAGES"
4147 msgstr ""
4148
4149 #. type: textblock
4150 #: ../src/guestfs.pod:1911
4151 msgid ""
4152 "One motivation for the generic event API was to allow GUI programs to "
4153 "capture debug and other messages.  In libguestfs E<le> 1.8 these were sent "
4154 "unconditionally to C<stderr>."
4155 msgstr ""
4156
4157 #. type: textblock
4158 #: ../src/guestfs.pod:1915
4159 msgid ""
4160 "Events associated with log messages are: C<GUESTFS_EVENT_LIBRARY>, "
4161 "C<GUESTFS_EVENT_APPLIANCE> and C<GUESTFS_EVENT_TRACE>.  (Note that error "
4162 "messages are not events; you must capture error messages separately)."
4163 msgstr ""
4164
4165 #. type: textblock
4166 #: ../src/guestfs.pod:1920
4167 msgid ""
4168 "Programs have to set up a callback to capture the classes of events of "
4169 "interest:"
4170 msgstr ""
4171
4172 #. type: verbatim
4173 #: ../src/guestfs.pod:1923
4174 #, no-wrap
4175 msgid ""
4176 " int eh =\n"
4177 "   guestfs_set_event_callback\n"
4178 "     (g, message_callback,\n"
4179 "      GUESTFS_EVENT_LIBRARY|GUESTFS_EVENT_APPLIANCE|\n"
4180 "      GUESTFS_EVENT_TRACE,\n"
4181 "      0, NULL) == -1)\n"
4182 " if (eh == -1) {\n"
4183 "   // handle error in the usual way\n"
4184 " }\n"
4185 "\n"
4186 msgstr ""
4187
4188 #. type: textblock
4189 #: ../src/guestfs.pod:1933
4190 msgid ""
4191 "The callback can then direct messages to the appropriate place.  In this "
4192 "example, messages are directed to syslog:"
4193 msgstr ""
4194
4195 #. type: verbatim
4196 #: ../src/guestfs.pod:1936
4197 #, no-wrap
4198 msgid ""
4199 " static void\n"
4200 " message_callback (\n"
4201 "         guestfs_h *g,\n"
4202 "         void *opaque,\n"
4203 "         uint64_t event,\n"
4204 "         int event_handle,\n"
4205 "         int flags,\n"
4206 "         const char *buf, size_t buf_len,\n"
4207 "         const uint64_t *array, size_t array_len)\n"
4208 " {\n"
4209 "   const int priority = LOG_USER|LOG_INFO;\n"
4210 "   if (buf_len > 0)\n"
4211 "     syslog (priority, \"event 0x%lx: %s\", event, buf);\n"
4212 " }\n"
4213 "\n"
4214 msgstr ""
4215
4216 # type: =head1
4217 #. type: =head1
4218 #: ../src/guestfs.pod:1951
4219 msgid "PRIVATE DATA AREA"
4220 msgstr ""
4221
4222 #. type: textblock
4223 #: ../src/guestfs.pod:1953
4224 msgid ""
4225 "You can attach named pieces of private data to the libguestfs handle, fetch "
4226 "them by name, and walk over them, for the lifetime of the handle.  This is "
4227 "called the private data area and is only available from the C API."
4228 msgstr ""
4229
4230 # type: textblock
4231 #. type: textblock
4232 #: ../src/guestfs.pod:1958
4233 msgid "To attach a named piece of data, use the following call:"
4234 msgstr ""
4235
4236 # type: verbatim
4237 #. type: verbatim
4238 #: ../src/guestfs.pod:1960
4239 #, no-wrap
4240 msgid ""
4241 " void guestfs_set_private (guestfs_h *g, const char *key, void *data);\n"
4242 "\n"
4243 msgstr ""
4244
4245 #. type: textblock
4246 #: ../src/guestfs.pod:1962
4247 msgid ""
4248 "C<key> is the name to associate with this data, and C<data> is an arbitrary "
4249 "pointer (which can be C<NULL>).  Any previous item with the same key is "
4250 "overwritten."
4251 msgstr ""
4252
4253 #. type: textblock
4254 #: ../src/guestfs.pod:1966
4255 msgid ""
4256 "You can use any C<key> you want, but your key should I<not> start with an "
4257 "underscore character.  Keys beginning with an underscore character are "
4258 "reserved for internal libguestfs purposes (eg. for implementing language "
4259 "bindings).  It is recommended that you prefix the key with some unique "
4260 "string to avoid collisions with other users."
4261 msgstr ""
4262
4263 # type: textblock
4264 #. type: textblock
4265 #: ../src/guestfs.pod:1972
4266 msgid "To retrieve the pointer, use:"
4267 msgstr ""
4268
4269 # type: verbatim
4270 #. type: verbatim
4271 #: ../src/guestfs.pod:1974
4272 #, no-wrap
4273 msgid ""
4274 " void *guestfs_get_private (guestfs_h *g, const char *key);\n"
4275 "\n"
4276 msgstr ""
4277
4278 # type: textblock
4279 #. type: textblock
4280 #: ../src/guestfs.pod:1976
4281 msgid ""
4282 "This function returns C<NULL> if either no data is found associated with "
4283 "C<key>, or if the user previously set the C<key>'s C<data> pointer to "
4284 "C<NULL>."
4285 msgstr ""
4286
4287 #. type: textblock
4288 #: ../src/guestfs.pod:1980
4289 msgid ""
4290 "Libguestfs does not try to look at or interpret the C<data> pointer in any "
4291 "way.  As far as libguestfs is concerned, it need not be a valid pointer at "
4292 "all.  In particular, libguestfs does I<not> try to free the data when the "
4293 "handle is closed.  If the data must be freed, then the caller must either "
4294 "free it before calling L</guestfs_close> or must set up a close callback to "
4295 "do it (see L</GUESTFS_EVENT_CLOSE>)."
4296 msgstr ""
4297
4298 #. type: textblock
4299 #: ../src/guestfs.pod:1987
4300 msgid "To walk over all entries, use these two functions:"
4301 msgstr ""
4302
4303 #. type: verbatim
4304 #: ../src/guestfs.pod:1989
4305 #, no-wrap
4306 msgid ""
4307 " void *guestfs_first_private (guestfs_h *g, const char **key_rtn);\n"
4308 "\n"
4309 msgstr ""
4310
4311 #. type: verbatim
4312 #: ../src/guestfs.pod:1991
4313 #, no-wrap
4314 msgid ""
4315 " void *guestfs_next_private (guestfs_h *g, const char **key_rtn);\n"
4316 "\n"
4317 msgstr ""
4318
4319 #. type: textblock
4320 #: ../src/guestfs.pod:1993
4321 msgid ""
4322 "C<guestfs_first_private> returns the first key, pointer pair (\"first\" does "
4323 "not have any particular meaning -- keys are not returned in any defined "
4324 "order).  A pointer to the key is returned in C<*key_rtn> and the "
4325 "corresponding data pointer is returned from the function.  C<NULL> is "
4326 "returned if there are no keys stored in the handle."
4327 msgstr ""
4328
4329 #. type: textblock
4330 #: ../src/guestfs.pod:1999
4331 msgid ""
4332 "C<guestfs_next_private> returns the next key, pointer pair.  The return "
4333 "value of this function is also C<NULL> is there are no further entries to "
4334 "return."
4335 msgstr ""
4336
4337 #. type: textblock
4338 #: ../src/guestfs.pod:2003
4339 msgid "Notes about walking over entries:"
4340 msgstr ""
4341
4342 #. type: textblock
4343 #: ../src/guestfs.pod:2009
4344 msgid ""
4345 "You must not call C<guestfs_set_private> while walking over the entries."
4346 msgstr ""
4347
4348 #. type: textblock
4349 #: ../src/guestfs.pod:2014
4350 msgid ""
4351 "The handle maintains an internal iterator which is reset when you call "
4352 "C<guestfs_first_private>.  This internal iterator is invalidated when you "
4353 "call C<guestfs_set_private>."
4354 msgstr ""
4355
4356 #. type: textblock
4357 #: ../src/guestfs.pod:2020
4358 msgid "If you have set the data pointer associated with a key to C<NULL>, ie:"
4359 msgstr ""
4360
4361 #. type: verbatim
4362 #: ../src/guestfs.pod:2022
4363 #, no-wrap
4364 msgid ""
4365 " guestfs_set_private (g, key, NULL);\n"
4366 "\n"
4367 msgstr ""
4368
4369 #. type: textblock
4370 #: ../src/guestfs.pod:2024
4371 msgid "then that C<key> is not returned when walking."
4372 msgstr ""
4373
4374 #. type: textblock
4375 #: ../src/guestfs.pod:2028
4376 msgid ""
4377 "C<*key_rtn> is only valid until the next call to C<guestfs_first_private>, "
4378 "C<guestfs_next_private> or C<guestfs_set_private>."
4379 msgstr ""
4380
4381 #. type: textblock
4382 #: ../src/guestfs.pod:2034
4383 msgid ""
4384 "The following example code shows how to print all keys and data pointers "
4385 "that are associated with the handle C<g>:"
4386 msgstr ""
4387
4388 #. type: verbatim
4389 #: ../src/guestfs.pod:2037
4390 #, no-wrap
4391 msgid ""
4392 " const char *key;\n"
4393 " void *data = guestfs_first_private (g, &key);\n"
4394 " while (data != NULL)\n"
4395 "   {\n"
4396 "     printf (\"key = %s, data = %p\\n\", key, data);\n"
4397 "     data = guestfs_next_private (g, &key);\n"
4398 "   }\n"
4399 "\n"
4400 msgstr ""
4401
4402 #. type: textblock
4403 #: ../src/guestfs.pod:2045
4404 msgid ""
4405 "More commonly you are only interested in keys that begin with an application-"
4406 "specific prefix C<foo_>.  Modify the loop like so:"
4407 msgstr ""
4408
4409 #. type: verbatim
4410 #: ../src/guestfs.pod:2048
4411 #, no-wrap
4412 msgid ""
4413 " const char *key;\n"
4414 " void *data = guestfs_first_private (g, &key);\n"
4415 " while (data != NULL)\n"
4416 "   {\n"
4417 "     if (strncmp (key, \"foo_\", strlen (\"foo_\")) == 0)\n"
4418 "       printf (\"key = %s, data = %p\\n\", key, data);\n"
4419 "     data = guestfs_next_private (g, &key);\n"
4420 "   }\n"
4421 "\n"
4422 msgstr ""
4423
4424 #. type: textblock
4425 #: ../src/guestfs.pod:2057
4426 msgid ""
4427 "If you need to modify keys while walking, then you have to jump back to the "
4428 "beginning of the loop.  For example, to delete all keys prefixed with "
4429 "C<foo_>:"
4430 msgstr ""
4431
4432 #. type: verbatim
4433 #: ../src/guestfs.pod:2061
4434 #, no-wrap
4435 msgid ""
4436 "  const char *key;\n"
4437 "  void *data;\n"
4438 " again:\n"
4439 "  data = guestfs_first_private (g, &key);\n"
4440 "  while (data != NULL)\n"
4441 "    {\n"
4442 "      if (strncmp (key, \"foo_\", strlen (\"foo_\")) == 0)\n"
4443 "        {\n"
4444 "          guestfs_set_private (g, key, NULL);\n"
4445 "          /* note that 'key' pointer is now invalid, and so is\n"
4446 "             the internal iterator */\n"
4447 "          goto again;\n"
4448 "        }\n"
4449 "      data = guestfs_next_private (g, &key);\n"
4450 "    }\n"
4451 "\n"
4452 msgstr ""
4453
4454 #. type: textblock
4455 #: ../src/guestfs.pod:2077
4456 msgid ""
4457 "Note that the above loop is guaranteed to terminate because the keys are "
4458 "being deleted, but other manipulations of keys within the loop might not "
4459 "terminate unless you also maintain an indication of which keys have been "
4460 "visited."
4461 msgstr ""
4462
4463 # type: =end
4464 #. type: =end
4465 #: ../src/guestfs.pod:2082 ../src/guestfs.pod:2087
4466 msgid "html"
4467 msgstr ""
4468
4469 # type: textblock
4470 #. type: textblock
4471 #: ../src/guestfs.pod:2084
4472 msgid ""
4473 "<!-- old anchor for the next section --> <a name="
4474 "\"state_machine_and_low_level_event_api\"/>"
4475 msgstr ""
4476
4477 # type: =head1
4478 #. type: =head1
4479 #: ../src/guestfs.pod:2089
4480 msgid "ARCHITECTURE"
4481 msgstr ""
4482
4483 # type: textblock
4484 #. type: textblock
4485 #: ../src/guestfs.pod:2091
4486 msgid ""
4487 "Internally, libguestfs is implemented by running an appliance (a special "
4488 "type of small virtual machine) using L<qemu(1)>.  Qemu runs as a child "
4489 "process of the main program."
4490 msgstr ""
4491
4492 # type: verbatim
4493 #. type: verbatim
4494 #: ../src/guestfs.pod:2095
4495 #, no-wrap
4496 msgid ""
4497 "  ___________________\n"
4498 " /                   \\\n"
4499 " | main program      |\n"
4500 " |                   |\n"
4501 " |                   |           child process / appliance\n"
4502 " |                   |           __________________________\n"
4503 " |                   |          / qemu                     \\\n"
4504 " +-------------------+   RPC    |      +-----------------+ |\n"
4505 " | libguestfs     <--------------------> guestfsd        | |\n"
4506 " |                   |          |      +-----------------+ |\n"
4507 " \\___________________/          |      | Linux kernel    | |\n"
4508 "                                |      +--^--------------+ |\n"
4509 "                                \\_________|________________/\n"
4510 "                                          |\n"
4511 "                                   _______v______\n"
4512 "                                  /              \\\n"
4513 "                                  | Device or    |\n"
4514 "                                  | disk image   |\n"
4515 "                                  \\______________/\n"
4516 "\n"
4517 msgstr ""
4518
4519 # type: textblock
4520 #. type: textblock
4521 #: ../src/guestfs.pod:2115
4522 msgid ""
4523 "The library, linked to the main program, creates the child process and hence "
4524 "the appliance in the L</guestfs_launch> function."
4525 msgstr ""
4526
4527 # type: textblock
4528 #. type: textblock
4529 #: ../src/guestfs.pod:2118
4530 msgid ""
4531 "Inside the appliance is a Linux kernel and a complete stack of userspace "
4532 "tools (such as LVM and ext2 programs) and a small controlling daemon called "
4533 "L</guestfsd>.  The library talks to L</guestfsd> using remote procedure "
4534 "calls (RPC).  There is a mostly one-to-one correspondence between libguestfs "
4535 "API calls and RPC calls to the daemon.  Lastly the disk image(s) are "
4536 "attached to the qemu process which translates device access by the "
4537 "appliance's Linux kernel into accesses to the image."
4538 msgstr ""
4539
4540 # type: textblock
4541 #. type: textblock
4542 #: ../src/guestfs.pod:2127
4543 msgid ""
4544 "A common misunderstanding is that the appliance \"is\" the virtual machine.  "
4545 "Although the disk image you are attached to might also be used by some "
4546 "virtual machine, libguestfs doesn't know or care about this.  (But you will "
4547 "care if both libguestfs's qemu process and your virtual machine are trying "
4548 "to update the disk image at the same time, since these usually results in "
4549 "massive disk corruption)."
4550 msgstr ""
4551
4552 # type: =head1
4553 #. type: =head1
4554 #: ../src/guestfs.pod:2134
4555 msgid "STATE MACHINE"
4556 msgstr ""
4557
4558 # type: textblock
4559 #. type: textblock
4560 #: ../src/guestfs.pod:2136
4561 msgid "libguestfs uses a state machine to model the child process:"
4562 msgstr ""
4563
4564 # type: verbatim
4565 #. type: verbatim
4566 #: ../src/guestfs.pod:2138
4567 #, no-wrap
4568 msgid ""
4569 "                         |\n"
4570 "                    guestfs_create\n"
4571 "                         |\n"
4572 "                         |\n"
4573 "                     ____V_____\n"
4574 "                    /          \\\n"
4575 "                    |  CONFIG  |\n"
4576 "                    \\__________/\n"
4577 "                     ^ ^   ^  \\\n"
4578 "                    /  |    \\  \\ guestfs_launch\n"
4579 "                   /   |    _\\__V______\n"
4580 "                  /    |   /           \\\n"
4581 "                 /     |   | LAUNCHING |\n"
4582 "                /      |   \\___________/\n"
4583 "               /       |       /\n"
4584 "              /        |  guestfs_launch\n"
4585 "             /         |     /\n"
4586 "    ______  /        __|____V\n"
4587 "   /      \\ ------> /        \\\n"
4588 "   | BUSY |         | READY  |\n"
4589 "   \\______/ <------ \\________/\n"
4590 "\n"
4591 msgstr ""
4592
4593 # type: textblock
4594 #. type: textblock
4595 #: ../src/guestfs.pod:2160
4596 msgid ""
4597 "The normal transitions are (1) CONFIG (when the handle is created, but there "
4598 "is no child process), (2) LAUNCHING (when the child process is booting up), "
4599 "(3) alternating between READY and BUSY as commands are issued to, and "
4600 "carried out by, the child process."
4601 msgstr ""
4602
4603 # type: textblock
4604 #. type: textblock
4605 #: ../src/guestfs.pod:2165
4606 msgid ""
4607 "The guest may be killed by L</guestfs_kill_subprocess>, or may die "
4608 "asynchronously at any time (eg. due to some internal error), and that causes "
4609 "the state to transition back to CONFIG."
4610 msgstr ""
4611
4612 # type: textblock
4613 #. type: textblock
4614 #: ../src/guestfs.pod:2169
4615 msgid ""
4616 "Configuration commands for qemu such as L</guestfs_add_drive> can only be "
4617 "issued when in the CONFIG state."
4618 msgstr ""
4619
4620 # type: textblock
4621 #. type: textblock
4622 #: ../src/guestfs.pod:2172
4623 msgid ""
4624 "The API offers one call that goes from CONFIG through LAUNCHING to READY.  "
4625 "L</guestfs_launch> blocks until the child process is READY to accept "
4626 "commands (or until some failure or timeout).  L</guestfs_launch> internally "
4627 "moves the state from CONFIG to LAUNCHING while it is running."
4628 msgstr ""
4629
4630 # type: textblock
4631 #. type: textblock
4632 #: ../src/guestfs.pod:2178
4633 msgid ""
4634 "API actions such as L</guestfs_mount> can only be issued when in the READY "
4635 "state.  These API calls block waiting for the command to be carried out (ie. "
4636 "the state to transition to BUSY and then back to READY).  There are no non-"
4637 "blocking versions, and no way to issue more than one command per handle at "
4638 "the same time."
4639 msgstr ""
4640
4641 # type: textblock
4642 #. type: textblock
4643 #: ../src/guestfs.pod:2184
4644 msgid ""
4645 "Finally, the child process sends asynchronous messages back to the main "
4646 "program, such as kernel log messages.  You can register a callback to "
4647 "receive these messages."
4648 msgstr ""
4649
4650 # type: =head1
4651 #. type: =head1
4652 #: ../src/guestfs.pod:2188
4653 msgid "INTERNALS"
4654 msgstr ""
4655
4656 # type: =head2
4657 #. type: =head2
4658 #: ../src/guestfs.pod:2190
4659 msgid "COMMUNICATION PROTOCOL"
4660 msgstr ""
4661
4662 # type: textblock
4663 #. type: textblock
4664 #: ../src/guestfs.pod:2192
4665 msgid ""
4666 "Don't rely on using this protocol directly.  This section documents how it "
4667 "currently works, but it may change at any time."
4668 msgstr ""
4669
4670 # type: textblock
4671 #. type: textblock
4672 #: ../src/guestfs.pod:2195
4673 msgid ""
4674 "The protocol used to talk between the library and the daemon running inside "
4675 "the qemu virtual machine is a simple RPC mechanism built on top of XDR (RFC "
4676 "1014, RFC 1832, RFC 4506)."
4677 msgstr ""
4678
4679 # type: textblock
4680 #. type: textblock
4681 #: ../src/guestfs.pod:2199
4682 msgid ""
4683 "The detailed format of structures is in C<src/guestfs_protocol.x> (note: "
4684 "this file is automatically generated)."
4685 msgstr ""
4686
4687 # type: textblock
4688 #. type: textblock
4689 #: ../src/guestfs.pod:2202
4690 msgid ""
4691 "There are two broad cases, ordinary functions that don't have any C<FileIn> "
4692 "and C<FileOut> parameters, which are handled with very simple request/reply "
4693 "messages.  Then there are functions that have any C<FileIn> or C<FileOut> "
4694 "parameters, which use the same request and reply messages, but they may also "
4695 "be followed by files sent using a chunked encoding."
4696 msgstr ""
4697
4698 # type: =head3
4699 #. type: =head3
4700 #: ../src/guestfs.pod:2209
4701 msgid "ORDINARY FUNCTIONS (NO FILEIN/FILEOUT PARAMS)"
4702 msgstr ""
4703
4704 # type: textblock
4705 #. type: textblock
4706 #: ../src/guestfs.pod:2211
4707 msgid "For ordinary functions, the request message is:"
4708 msgstr ""
4709
4710 # type: verbatim
4711 #. type: verbatim
4712 #: ../src/guestfs.pod:2213
4713 #, no-wrap
4714 msgid ""
4715 " total length (header + arguments,\n"
4716 "      but not including the length word itself)\n"
4717 " struct guestfs_message_header (encoded as XDR)\n"
4718 " struct guestfs_<foo>_args (encoded as XDR)\n"
4719 "\n"
4720 msgstr ""
4721
4722 # type: textblock
4723 #. type: textblock
4724 #: ../src/guestfs.pod:2218
4725 msgid ""
4726 "The total length field allows the daemon to allocate a fixed size buffer "
4727 "into which it slurps the rest of the message.  As a result, the total length "
4728 "is limited to C<GUESTFS_MESSAGE_MAX> bytes (currently 4MB), which means the "
4729 "effective size of any request is limited to somewhere under this size."
4730 msgstr ""
4731
4732 # type: textblock
4733 #. type: textblock
4734 #: ../src/guestfs.pod:2224
4735 msgid ""
4736 "Note also that many functions don't take any arguments, in which case the "
4737 "C<guestfs_I<foo>_args> is completely omitted."
4738 msgstr ""
4739
4740 # type: textblock
4741 #. type: textblock
4742 #: ../src/guestfs.pod:2227
4743 msgid ""
4744 "The header contains the procedure number (C<guestfs_proc>) which is how the "
4745 "receiver knows what type of args structure to expect, or none at all."
4746 msgstr ""
4747
4748 # type: textblock
4749 #. type: textblock
4750 #: ../src/guestfs.pod:2231
4751 msgid ""
4752 "For functions that take optional arguments, the optional arguments are "
4753 "encoded in the C<guestfs_I<foo>_args> structure in the same way as ordinary "
4754 "arguments.  A bitmask in the header indicates which optional arguments are "
4755 "meaningful.  The bitmask is also checked to see if it contains bits set "
4756 "which the daemon does not know about (eg. if more optional arguments were "
4757 "added in a later version of the library), and this causes the call to be "
4758 "rejected."
4759 msgstr ""
4760
4761 # type: textblock
4762 #. type: textblock
4763 #: ../src/guestfs.pod:2239
4764 msgid "The reply message for ordinary functions is:"
4765 msgstr ""
4766
4767 # type: verbatim
4768 #. type: verbatim
4769 #: ../src/guestfs.pod:2241
4770 #, no-wrap
4771 msgid ""
4772 " total length (header + ret,\n"
4773 "      but not including the length word itself)\n"
4774 " struct guestfs_message_header (encoded as XDR)\n"
4775 " struct guestfs_<foo>_ret (encoded as XDR)\n"
4776 "\n"
4777 msgstr ""
4778
4779 # type: textblock
4780 #. type: textblock
4781 #: ../src/guestfs.pod:2246
4782 msgid ""
4783 "As above the C<guestfs_I<foo>_ret> structure may be completely omitted for "
4784 "functions that return no formal return values."
4785 msgstr ""
4786
4787 # type: textblock
4788 #. type: textblock
4789 #: ../src/guestfs.pod:2249
4790 msgid ""
4791 "As above the total length of the reply is limited to C<GUESTFS_MESSAGE_MAX>."
4792 msgstr ""
4793
4794 # type: textblock
4795 #. type: textblock
4796 #: ../src/guestfs.pod:2252
4797 msgid ""
4798 "In the case of an error, a flag is set in the header, and the reply message "
4799 "is slightly changed:"
4800 msgstr ""
4801
4802 # type: verbatim
4803 #. type: verbatim
4804 #: ../src/guestfs.pod:2255
4805 #, no-wrap
4806 msgid ""
4807 " total length (header + error,\n"
4808 "      but not including the length word itself)\n"
4809 " struct guestfs_message_header (encoded as XDR)\n"
4810 " struct guestfs_message_error (encoded as XDR)\n"
4811 "\n"
4812 msgstr ""
4813
4814 # type: textblock
4815 #. type: textblock
4816 #: ../src/guestfs.pod:2260
4817 msgid ""
4818 "The C<guestfs_message_error> structure contains the error message as a "
4819 "string."
4820 msgstr ""
4821
4822 # type: =head3
4823 #. type: =head3
4824 #: ../src/guestfs.pod:2263
4825 msgid "FUNCTIONS THAT HAVE FILEIN PARAMETERS"
4826 msgstr ""
4827
4828 # type: textblock
4829 #. type: textblock
4830 #: ../src/guestfs.pod:2265
4831 msgid ""
4832 "A C<FileIn> parameter indicates that we transfer a file I<into> the guest.  "
4833 "The normal request message is sent (see above).  However this is followed by "
4834 "a sequence of file chunks."
4835 msgstr ""
4836
4837 # type: verbatim
4838 #. type: verbatim
4839 #: ../src/guestfs.pod:2269
4840 #, no-wrap
4841 msgid ""
4842 " total length (header + arguments,\n"
4843 "      but not including the length word itself,\n"
4844 "      and not including the chunks)\n"
4845 " struct guestfs_message_header (encoded as XDR)\n"
4846 " struct guestfs_<foo>_args (encoded as XDR)\n"
4847 " sequence of chunks for FileIn param #0\n"
4848 " sequence of chunks for FileIn param #1 etc.\n"
4849 "\n"
4850 msgstr ""
4851
4852 # type: textblock
4853 #. type: textblock
4854 #: ../src/guestfs.pod:2277
4855 msgid "The \"sequence of chunks\" is:"
4856 msgstr ""
4857
4858 # type: verbatim
4859 #. type: verbatim
4860 #: ../src/guestfs.pod:2279
4861 #, no-wrap
4862 msgid ""
4863 " length of chunk (not including length word itself)\n"
4864 " struct guestfs_chunk (encoded as XDR)\n"
4865 " length of chunk\n"
4866 " struct guestfs_chunk (encoded as XDR)\n"
4867 "   ...\n"
4868 " length of chunk\n"
4869 " struct guestfs_chunk (with data.data_len == 0)\n"
4870 "\n"
4871 msgstr ""
4872
4873 # type: textblock
4874 #. type: textblock
4875 #: ../src/guestfs.pod:2287
4876 msgid ""
4877 "The final chunk has the C<data_len> field set to zero.  Additionally a flag "
4878 "is set in the final chunk to indicate either successful completion or early "
4879 "cancellation."
4880 msgstr ""
4881
4882 # type: textblock
4883 #. type: textblock
4884 #: ../src/guestfs.pod:2291
4885 msgid ""
4886 "At time of writing there are no functions that have more than one FileIn "
4887 "parameter.  However this is (theoretically) supported, by sending the "
4888 "sequence of chunks for each FileIn parameter one after another (from left to "
4889 "right)."
4890 msgstr ""
4891
4892 # type: textblock
4893 #. type: textblock
4894 #: ../src/guestfs.pod:2296
4895 msgid ""
4896 "Both the library (sender) I<and> the daemon (receiver) may cancel the "
4897 "transfer.  The library does this by sending a chunk with a special flag set "
4898 "to indicate cancellation.  When the daemon sees this, it cancels the whole "
4899 "RPC, does I<not> send any reply, and goes back to reading the next request."
4900 msgstr ""
4901
4902 # type: textblock
4903 #. type: textblock
4904 #: ../src/guestfs.pod:2302
4905 msgid ""
4906 "The daemon may also cancel.  It does this by writing a special word "
4907 "C<GUESTFS_CANCEL_FLAG> to the socket.  The library listens for this during "
4908 "the transfer, and if it gets it, it will cancel the transfer (it sends a "
4909 "cancel chunk).  The special word is chosen so that even if cancellation "
4910 "happens right at the end of the transfer (after the library has finished "
4911 "writing and has started listening for the reply), the \"spurious\" cancel "
4912 "flag will not be confused with the reply message."
4913 msgstr ""
4914
4915 # type: textblock
4916 #. type: textblock
4917 #: ../src/guestfs.pod:2311
4918 msgid ""
4919 "This protocol allows the transfer of arbitrary sized files (no 32 bit "
4920 "limit), and also files where the size is not known in advance (eg. from "
4921 "pipes or sockets).  However the chunks are rather small "
4922 "(C<GUESTFS_MAX_CHUNK_SIZE>), so that neither the library nor the daemon need "
4923 "to keep much in memory."
4924 msgstr ""
4925
4926 # type: =head3
4927 #. type: =head3
4928 #: ../src/guestfs.pod:2317
4929 msgid "FUNCTIONS THAT HAVE FILEOUT PARAMETERS"
4930 msgstr ""
4931
4932 # type: textblock
4933 #. type: textblock
4934 #: ../src/guestfs.pod:2319
4935 msgid ""
4936 "The protocol for FileOut parameters is exactly the same as for FileIn "
4937 "parameters, but with the roles of daemon and library reversed."
4938 msgstr ""
4939
4940 # type: verbatim
4941 #. type: verbatim
4942 #: ../src/guestfs.pod:2322
4943 #, no-wrap
4944 msgid ""
4945 " total length (header + ret,\n"
4946 "      but not including the length word itself,\n"
4947 "      and not including the chunks)\n"
4948 " struct guestfs_message_header (encoded as XDR)\n"
4949 " struct guestfs_<foo>_ret (encoded as XDR)\n"
4950 " sequence of chunks for FileOut param #0\n"
4951 " sequence of chunks for FileOut param #1 etc.\n"
4952 "\n"
4953 msgstr ""
4954
4955 # type: =head3
4956 #. type: =head3
4957 #: ../src/guestfs.pod:2330
4958 msgid "INITIAL MESSAGE"
4959 msgstr ""
4960
4961 # type: textblock
4962 #. type: textblock
4963 #: ../src/guestfs.pod:2332
4964 msgid ""
4965 "When the daemon launches it sends an initial word (C<GUESTFS_LAUNCH_FLAG>) "
4966 "which indicates that the guest and daemon is alive.  This is what L</"
4967 "guestfs_launch> waits for."
4968 msgstr ""
4969
4970 # type: =head3
4971 #. type: =head3
4972 #: ../src/guestfs.pod:2336
4973 msgid "PROGRESS NOTIFICATION MESSAGES"
4974 msgstr ""
4975
4976 # type: textblock
4977 #. type: textblock
4978 #: ../src/guestfs.pod:2338
4979 msgid ""
4980 "The daemon may send progress notification messages at any time.  These are "
4981 "distinguished by the normal length word being replaced by "
4982 "C<GUESTFS_PROGRESS_FLAG>, followed by a fixed size progress message."
4983 msgstr ""
4984
4985 #. type: textblock
4986 #: ../src/guestfs.pod:2342
4987 msgid ""
4988 "The library turns them into progress callbacks (see L</"
4989 "GUESTFS_EVENT_PROGRESS>) if there is a callback registered, or discards them "
4990 "if not."
4991 msgstr ""
4992
4993 # type: textblock
4994 #. type: textblock
4995 #: ../src/guestfs.pod:2346
4996 msgid ""
4997 "The daemon self-limits the frequency of progress messages it sends (see "
4998 "C<daemon/proto.c:notify_progress>).  Not all calls generate progress "
4999 "messages."
5000 msgstr ""
5001
5002 # type: =head1
5003 #. type: =head1
5004 #: ../src/guestfs.pod:2350
5005 msgid "LIBGUESTFS VERSION NUMBERS"
5006 msgstr ""
5007
5008 # type: textblock
5009 #. type: textblock
5010 #: ../src/guestfs.pod:2352
5011 msgid ""
5012 "Since April 2010, libguestfs has started to make separate development and "
5013 "stable releases, along with corresponding branches in our git repository.  "
5014 "These separate releases can be identified by version number:"
5015 msgstr ""
5016
5017 # type: verbatim
5018 #. type: verbatim
5019 #: ../src/guestfs.pod:2357
5020 #, no-wrap
5021 msgid ""
5022 "                 even numbers for stable: 1.2.x, 1.4.x, ...\n"
5023 "       .-------- odd numbers for development: 1.3.x, 1.5.x, ...\n"
5024 "       |\n"
5025 "       v\n"
5026 " 1  .  3  .  5\n"
5027 " ^           ^\n"
5028 " |           |\n"
5029 " |           `-------- sub-version\n"
5030 " |\n"
5031 " `------ always '1' because we don't change the ABI\n"
5032 "\n"
5033 msgstr ""
5034
5035 # type: textblock
5036 #. type: textblock
5037 #: ../src/guestfs.pod:2368
5038 msgid "Thus \"1.3.5\" is the 5th update to the development branch \"1.3\"."
5039 msgstr ""
5040
5041 # type: textblock
5042 #. type: textblock
5043 #: ../src/guestfs.pod:2370
5044 msgid ""
5045 "As time passes we cherry pick fixes from the development branch and backport "
5046 "those into the stable branch, the effect being that the stable branch should "
5047 "get more stable and less buggy over time.  So the stable releases are ideal "
5048 "for people who don't need new features but would just like the software to "
5049 "work."
5050 msgstr ""
5051
5052 # type: textblock
5053 #. type: textblock
5054 #: ../src/guestfs.pod:2376
5055 msgid "Our criteria for backporting changes are:"
5056 msgstr ""
5057
5058 # type: textblock
5059 #. type: textblock
5060 #: ../src/guestfs.pod:2382
5061 msgid ""
5062 "Documentation changes which don't affect any code are backported unless the "
5063 "documentation refers to a future feature which is not in stable."
5064 msgstr ""
5065
5066 # type: textblock
5067 #. type: textblock
5068 #: ../src/guestfs.pod:2388
5069 msgid ""
5070 "Bug fixes which are not controversial, fix obvious problems, and have been "
5071 "well tested are backported."
5072 msgstr ""
5073
5074 # type: textblock
5075 #. type: textblock
5076 #: ../src/guestfs.pod:2393
5077 msgid ""
5078 "Simple rearrangements of code which shouldn't affect how it works get "
5079 "backported.  This is so that the code in the two branches doesn't get too "
5080 "far out of step, allowing us to backport future fixes more easily."
5081 msgstr ""
5082
5083 # type: textblock
5084 #. type: textblock
5085 #: ../src/guestfs.pod:2399
5086 msgid ""
5087 "We I<don't> backport new features, new APIs, new tools etc, except in one "
5088 "exceptional case: the new feature is required in order to implement an "
5089 "important bug fix."
5090 msgstr ""
5091
5092 # type: textblock
5093 #. type: textblock
5094 #: ../src/guestfs.pod:2405
5095 msgid ""
5096 "A new stable branch starts when we think the new features in development are "
5097 "substantial and compelling enough over the current stable branch to warrant "
5098 "it.  When that happens we create new stable and development versions 1.N.0 "
5099 "and 1.(N+1).0 [N is even].  The new dot-oh release won't necessarily be so "
5100 "stable at this point, but by backporting fixes from development, that branch "
5101 "will stabilize over time."
5102 msgstr ""
5103
5104 #. type: =head1
5105 #: ../src/guestfs.pod:2413
5106 msgid "EXTENDING LIBGUESTFS"
5107 msgstr ""
5108
5109 #. type: =head2
5110 #: ../src/guestfs.pod:2415
5111 msgid "ADDING A NEW API ACTION"
5112 msgstr ""
5113
5114 #. type: textblock
5115 #: ../src/guestfs.pod:2417
5116 msgid ""
5117 "Large amounts of boilerplate code in libguestfs (RPC, bindings, "
5118 "documentation) are generated, and this makes it easy to extend the "
5119 "libguestfs API."
5120 msgstr ""
5121
5122 #. type: textblock
5123 #: ../src/guestfs.pod:2421
5124 msgid "To add a new API action there are two changes:"
5125 msgstr ""
5126
5127 #. type: textblock
5128 #: ../src/guestfs.pod:2427
5129 msgid ""
5130 "You need to add a description of the call (name, parameters, return type, "
5131 "tests, documentation) to C<generator/generator_actions.ml>."
5132 msgstr ""
5133
5134 #. type: textblock
5135 #: ../src/guestfs.pod:2430
5136 msgid ""
5137 "There are two sorts of API action, depending on whether the call goes "
5138 "through to the daemon in the appliance, or is serviced entirely by the "
5139 "library (see L</ARCHITECTURE> above).  L</guestfs_sync> is an example of the "
5140 "former, since the sync is done in the appliance.  L</guestfs_set_trace> is "
5141 "an example of the latter, since a trace flag is maintained in the handle and "
5142 "all tracing is done on the library side."
5143 msgstr ""
5144
5145 #. type: textblock
5146 #: ../src/guestfs.pod:2438
5147 msgid ""
5148 "Most new actions are of the first type, and get added to the "
5149 "C<daemon_functions> list.  Each function has a unique procedure number used "
5150 "in the RPC protocol which is assigned to that action when we publish "
5151 "libguestfs and cannot be reused.  Take the latest procedure number and "
5152 "increment it."
5153 msgstr ""
5154
5155 #. type: textblock
5156 #: ../src/guestfs.pod:2444
5157 msgid ""
5158 "For library-only actions of the second type, add to the "
5159 "C<non_daemon_functions> list.  Since these functions are serviced by the "
5160 "library and do not travel over the RPC mechanism to the daemon, these "
5161 "functions do not need a procedure number, and so the procedure number is set "
5162 "to C<-1>."
5163 msgstr ""
5164
5165 #. type: textblock
5166 #: ../src/guestfs.pod:2452
5167 msgid "Implement the action (in C):"
5168 msgstr ""
5169
5170 #. type: textblock
5171 #: ../src/guestfs.pod:2454
5172 msgid ""
5173 "For daemon actions, implement the function C<do_E<lt>nameE<gt>> in the "
5174 "C<daemon/> directory."
5175 msgstr ""
5176
5177 #. type: textblock
5178 #: ../src/guestfs.pod:2457
5179 msgid ""
5180 "For library actions, implement the function C<guestfs__E<lt>nameE<gt>> "
5181 "(note: double underscore) in the C<src/> directory."
5182 msgstr ""
5183
5184 #. type: textblock
5185 #: ../src/guestfs.pod:2460
5186 msgid "In either case, use another function as an example of what to do."
5187 msgstr ""
5188
5189 #. type: textblock
5190 #: ../src/guestfs.pod:2464
5191 msgid "After making these changes, use C<make> to compile."
5192 msgstr ""
5193
5194 #. type: textblock
5195 #: ../src/guestfs.pod:2466
5196 msgid ""
5197 "Note that you don't need to implement the RPC, language bindings, manual "
5198 "pages or anything else.  It's all automatically generated from the OCaml "
5199 "description."
5200 msgstr ""
5201
5202 #. type: =head2
5203 #: ../src/guestfs.pod:2470
5204 msgid "ADDING TESTS FOR AN API ACTION"
5205 msgstr ""
5206
5207 #. type: textblock
5208 #: ../src/guestfs.pod:2472
5209 msgid ""
5210 "You can supply zero or as many tests as you want per API call.  The tests "
5211 "can either be added as part of the API description (C<generator/"
5212 "generator_actions.ml>), or in some rarer cases you may want to drop a script "
5213 "into C<regressions/>.  Note that adding a script to C<regressions/> is "
5214 "slower, so if possible use the first method."
5215 msgstr ""
5216
5217 #. type: textblock
5218 #: ../src/guestfs.pod:2478
5219 msgid ""
5220 "The following describes the test environment used when you add an API test "
5221 "in C<generator_actions.ml>."
5222 msgstr ""
5223
5224 #. type: textblock
5225 #: ../src/guestfs.pod:2481
5226 msgid "The test environment has 4 block devices:"
5227 msgstr ""
5228
5229 #. type: =item
5230 #: ../src/guestfs.pod:2485
5231 msgid "C</dev/sda> 500MB"
5232 msgstr ""
5233
5234 #. type: textblock
5235 #: ../src/guestfs.pod:2487
5236 msgid "General block device for testing."
5237 msgstr ""
5238
5239 #. type: =item
5240 #: ../src/guestfs.pod:2489
5241 msgid "C</dev/sdb> 50MB"
5242 msgstr ""
5243
5244 #. type: textblock
5245 #: ../src/guestfs.pod:2491
5246 msgid ""
5247 "C</dev/sdb1> is an ext2 filesystem used for testing filesystem write "
5248 "operations."
5249 msgstr ""
5250
5251 #. type: =item
5252 #: ../src/guestfs.pod:2494
5253 msgid "C</dev/sdc> 10MB"
5254 msgstr ""
5255
5256 #. type: textblock
5257 #: ../src/guestfs.pod:2496
5258 msgid "Used in a few tests where two block devices are needed."
5259 msgstr ""
5260
5261 #. type: =item
5262 #: ../src/guestfs.pod:2498
5263 msgid "C</dev/sdd>"
5264 msgstr ""
5265
5266 #. type: textblock
5267 #: ../src/guestfs.pod:2500
5268 msgid "ISO with fixed content (see C<images/test.iso>)."
5269 msgstr ""
5270
5271 #. type: textblock
5272 #: ../src/guestfs.pod:2504
5273 msgid ""
5274 "To be able to run the tests in a reasonable amount of time, the libguestfs "
5275 "appliance and block devices are reused between tests.  So don't try testing "
5276 "L</guestfs_kill_subprocess> :-x"
5277 msgstr ""
5278
5279 #. type: textblock
5280 #: ../src/guestfs.pod:2508
5281 msgid ""
5282 "Each test starts with an initial scenario, selected using one of the "
5283 "C<Init*> expressions, described in C<generator/generator_types.ml>.  These "
5284 "initialize the disks mentioned above in a particular way as documented in "
5285 "C<generator_types.ml>.  You should not assume anything about the previous "
5286 "contents of other disks that are not initialized."
5287 msgstr ""
5288
5289 #. type: textblock
5290 #: ../src/guestfs.pod:2514
5291 msgid ""
5292 "You can add a prerequisite clause to any individual test.  This is a run-"
5293 "time check, which, if it fails, causes the test to be skipped.  Useful if "
5294 "testing a command which might not work on all variations of libguestfs "
5295 "builds.  A test that has prerequisite of C<Always> means to run "
5296 "unconditionally."
5297 msgstr ""
5298
5299 #. type: textblock
5300 #: ../src/guestfs.pod:2520
5301 msgid ""
5302 "In addition, packagers can skip individual tests by setting environment "
5303 "variables before running C<make check>."
5304 msgstr ""
5305
5306 #. type: verbatim
5307 #: ../src/guestfs.pod:2523
5308 #, no-wrap
5309 msgid ""
5310 " SKIP_TEST_<CMD>_<NUM>=1\n"
5311 "\n"
5312 msgstr ""
5313
5314 #. type: textblock
5315 #: ../src/guestfs.pod:2525
5316 msgid "eg: C<SKIP_TEST_COMMAND_3=1> skips test #3 of L</guestfs_command>."
5317 msgstr ""
5318
5319 #. type: textblock
5320 #: ../src/guestfs.pod:2527
5321 msgid "or:"
5322 msgstr ""
5323
5324 #. type: verbatim
5325 #: ../src/guestfs.pod:2529
5326 #, no-wrap
5327 msgid ""
5328 " SKIP_TEST_<CMD>=1\n"
5329 "\n"
5330 msgstr ""
5331
5332 #. type: textblock
5333 #: ../src/guestfs.pod:2531
5334 msgid "eg: C<SKIP_TEST_ZEROFREE=1> skips all L</guestfs_zerofree> tests."
5335 msgstr ""
5336
5337 #. type: textblock
5338 #: ../src/guestfs.pod:2533
5339 msgid "Packagers can run only certain tests by setting for example:"
5340 msgstr ""
5341
5342 #. type: verbatim
5343 #: ../src/guestfs.pod:2535
5344 #, no-wrap
5345 msgid ""
5346 " TEST_ONLY=\"vfs_type zerofree\"\n"
5347 "\n"
5348 msgstr ""
5349
5350 #. type: textblock
5351 #: ../src/guestfs.pod:2537
5352 msgid ""
5353 "See C<capitests/tests.c> for more details of how these environment variables "
5354 "work."
5355 msgstr ""
5356
5357 #. type: =head2
5358 #: ../src/guestfs.pod:2540
5359 msgid "DEBUGGING NEW API ACTIONS"
5360 msgstr ""
5361
5362 #. type: textblock
5363 #: ../src/guestfs.pod:2542
5364 msgid "Test new actions work before submitting them."
5365 msgstr ""
5366
5367 #. type: textblock
5368 #: ../src/guestfs.pod:2544
5369 msgid "You can use guestfish to try out new commands."
5370 msgstr ""
5371
5372 #. type: textblock
5373 #: ../src/guestfs.pod:2546
5374 msgid ""
5375 "Debugging the daemon is a problem because it runs inside a minimal "
5376 "environment.  However you can fprintf messages in the daemon to stderr, and "
5377 "they will show up if you use C<guestfish -v>."
5378 msgstr ""
5379
5380 #. type: =head2
5381 #: ../src/guestfs.pod:2550
5382 msgid "FORMATTING CODE AND OTHER CONVENTIONS"
5383 msgstr ""
5384
5385 #. type: textblock
5386 #: ../src/guestfs.pod:2552
5387 msgid ""
5388 "Our C source code generally adheres to some basic code-formatting "
5389 "conventions.  The existing code base is not totally consistent on this "
5390 "front, but we do prefer that contributed code be formatted similarly.  In "
5391 "short, use spaces-not-TABs for indentation, use 2 spaces for each "
5392 "indentation level, and other than that, follow the K&R style."
5393 msgstr ""
5394
5395 #. type: textblock
5396 #: ../src/guestfs.pod:2558
5397 msgid ""
5398 "If you use Emacs, add the following to one of one of your start-up files (e."
5399 "g., ~/.emacs), to help ensure that you get indentation right:"
5400 msgstr ""
5401
5402 #. type: verbatim
5403 #: ../src/guestfs.pod:2561
5404 #, no-wrap
5405 msgid ""
5406 " ;;; In libguestfs, indent with spaces everywhere (not TABs).\n"
5407 " ;;; Exceptions: Makefile and ChangeLog modes.\n"
5408 " (add-hook 'find-file-hook\n"
5409 "     '(lambda () (if (and buffer-file-name\n"
5410 "                          (string-match \"/libguestfs\\\\>\"\n"
5411 "                              (buffer-file-name))\n"
5412 "                          (not (string-equal mode-name \"Change Log\"))\n"
5413 "                          (not (string-equal mode-name \"Makefile\")))\n"
5414 "                     (setq indent-tabs-mode nil))))\n"
5415 " \n"
5416 msgstr ""
5417
5418 #. type: verbatim
5419 #: ../src/guestfs.pod:2571
5420 #, no-wrap
5421 msgid ""
5422 " ;;; When editing C sources in libguestfs, use this style.\n"
5423 " (defun libguestfs-c-mode ()\n"
5424 "   \"C mode with adjusted defaults for use with libguestfs.\"\n"
5425 "   (interactive)\n"
5426 "   (c-set-style \"K&R\")\n"
5427 "   (setq c-indent-level 2)\n"
5428 "   (setq c-basic-offset 2))\n"
5429 " (add-hook 'c-mode-hook\n"
5430 "           '(lambda () (if (string-match \"/libguestfs\\\\>\"\n"
5431 "                               (buffer-file-name))\n"
5432 "                           (libguestfs-c-mode))))\n"
5433 "\n"
5434 msgstr ""
5435
5436 #. type: textblock
5437 #: ../src/guestfs.pod:2583
5438 msgid "Enable warnings when compiling (and fix any problems this finds):"
5439 msgstr ""
5440
5441 #. type: verbatim
5442 #: ../src/guestfs.pod:2586
5443 #, no-wrap
5444 msgid ""
5445 " ./configure --enable-gcc-warnings\n"
5446 "\n"
5447 msgstr ""
5448
5449 #. type: textblock
5450 #: ../src/guestfs.pod:2588
5451 msgid "Useful targets are:"
5452 msgstr ""
5453
5454 #. type: verbatim
5455 #: ../src/guestfs.pod:2590
5456 #, no-wrap
5457 msgid ""
5458 " make syntax-check  # checks the syntax of the C code\n"
5459 " make check         # runs the test suite\n"
5460 "\n"
5461 msgstr ""
5462
5463 #. type: =head2
5464 #: ../src/guestfs.pod:2593
5465 msgid "DAEMON CUSTOM PRINTF FORMATTERS"
5466 msgstr ""
5467
5468 #. type: textblock
5469 #: ../src/guestfs.pod:2595
5470 msgid ""
5471 "In the daemon code we have created custom printf formatters C<%Q> and C<%R>, "
5472 "which are used to do shell quoting."
5473 msgstr ""
5474
5475 #. type: =item
5476 #: ../src/guestfs.pod:2600
5477 msgid "%Q"
5478 msgstr ""
5479
5480 #. type: textblock
5481 #: ../src/guestfs.pod:2602
5482 msgid ""
5483 "Simple shell quoted string.  Any spaces or other shell characters are "
5484 "escaped for you."
5485 msgstr ""
5486
5487 #. type: =item
5488 #: ../src/guestfs.pod:2605
5489 msgid "%R"
5490 msgstr ""
5491
5492 #. type: textblock
5493 #: ../src/guestfs.pod:2607
5494 msgid ""
5495 "Same as C<%Q> except the string is treated as a path which is prefixed by "
5496 "the sysroot."
5497 msgstr ""
5498
5499 # type: textblock
5500 #. type: textblock
5501 #: ../src/guestfs.pod:2612 ../fish/guestfish.pod:240 ../fish/guestfish.pod:613
5502 msgid "For example:"
5503 msgstr ""
5504
5505 #. type: verbatim
5506 #: ../src/guestfs.pod:2614
5507 #, no-wrap
5508 msgid ""
5509 " asprintf (&cmd, \"cat %R\", path);\n"
5510 "\n"
5511 msgstr ""
5512
5513 #. type: textblock
5514 #: ../src/guestfs.pod:2616
5515 msgid "would produce C<cat /sysroot/some\\ path\\ with\\ spaces>"
5516 msgstr ""
5517
5518 #. type: textblock
5519 #: ../src/guestfs.pod:2618
5520 msgid ""
5521 "I<Note:> Do I<not> use these when you are passing parameters to the C<command"
5522 "{,r,v,rv}()> functions.  These parameters do NOT need to be quoted because "
5523 "they are not passed via the shell (instead, straight to exec).  You probably "
5524 "want to use the C<sysroot_path()> function however."
5525 msgstr ""
5526
5527 #. type: =head2
5528 #: ../src/guestfs.pod:2624
5529 msgid "SUBMITTING YOUR NEW API ACTIONS"
5530 msgstr ""
5531
5532 #. type: textblock
5533 #: ../src/guestfs.pod:2626
5534 msgid ""
5535 "Submit patches to the mailing list: L<http://www.redhat.com/mailman/listinfo/"
5536 "libguestfs> and CC to L<rjones@redhat.com>."
5537 msgstr ""
5538
5539 #. type: =head2
5540 #: ../src/guestfs.pod:2630
5541 msgid "INTERNATIONALIZATION (I18N) SUPPORT"
5542 msgstr ""
5543
5544 #. type: textblock
5545 #: ../src/guestfs.pod:2632
5546 msgid "We support i18n (gettext anyhow) in the library."
5547 msgstr ""
5548
5549 #. type: textblock
5550 #: ../src/guestfs.pod:2634
5551 msgid ""
5552 "However many messages come from the daemon, and we don't translate those at "
5553 "the moment.  One reason is that the appliance generally has all locale files "
5554 "removed from it, because they take up a lot of space.  So we'd have to readd "
5555 "some of those, as well as copying our PO files into the appliance."
5556 msgstr ""
5557
5558 #. type: textblock
5559 #: ../src/guestfs.pod:2640
5560 msgid ""
5561 "Debugging messages are never translated, since they are intended for the "
5562 "programmers."
5563 msgstr ""
5564
5565 #. type: =head2
5566 #: ../src/guestfs.pod:2643
5567 msgid "SOURCE CODE SUBDIRECTORIES"
5568 msgstr ""
5569
5570 #. type: =item
5571 #: ../src/guestfs.pod:2647 ../src/guestfs-actions.pod:5827
5572 #: ../fish/guestfish-actions.pod:3921
5573 msgid "C<appliance>"
5574 msgstr ""
5575
5576 #. type: textblock
5577 #: ../src/guestfs.pod:2649
5578 msgid "The libguestfs appliance, build scripts and so on."
5579 msgstr ""
5580
5581 #. type: =item
5582 #: ../src/guestfs.pod:2651
5583 msgid "C<capitests>"
5584 msgstr ""
5585
5586 #. type: textblock
5587 #: ../src/guestfs.pod:2653
5588 msgid "Automated tests of the C API."
5589 msgstr ""
5590
5591 #. type: =item
5592 #: ../src/guestfs.pod:2655
5593 msgid "C<cat>"
5594 msgstr ""
5595
5596 #. type: textblock
5597 #: ../src/guestfs.pod:2657
5598 msgid ""
5599 "The L<virt-cat(1)>, L<virt-filesystems(1)> and L<virt-ls(1)> commands and "
5600 "documentation."
5601 msgstr ""
5602
5603 #. type: =item
5604 #: ../src/guestfs.pod:2660
5605 msgid "C<caution>"
5606 msgstr ""
5607
5608 #. type: textblock
5609 #: ../src/guestfs.pod:2662
5610 msgid ""
5611 "Safety and liveness tests of components that libguestfs depends upon (not of "
5612 "libguestfs itself).  Mainly this is for qemu and the kernel."
5613 msgstr ""
5614
5615 #. type: =item
5616 #: ../src/guestfs.pod:2665
5617 msgid "C<contrib>"
5618 msgstr ""
5619
5620 #. type: textblock
5621 #: ../src/guestfs.pod:2667
5622 msgid "Outside contributions, experimental parts."
5623 msgstr ""
5624
5625 #. type: =item
5626 #: ../src/guestfs.pod:2669
5627 msgid "C<daemon>"
5628 msgstr ""
5629
5630 #. type: textblock
5631 #: ../src/guestfs.pod:2671
5632 msgid ""
5633 "The daemon that runs inside the libguestfs appliance and carries out actions."
5634 msgstr ""
5635
5636 #. type: =item
5637 #: ../src/guestfs.pod:2674
5638 msgid "C<df>"
5639 msgstr ""
5640
5641 #. type: textblock
5642 #: ../src/guestfs.pod:2676
5643 msgid "L<virt-df(1)> command and documentation."
5644 msgstr ""
5645
5646 #. type: =item
5647 #: ../src/guestfs.pod:2678
5648 msgid "C<examples>"
5649 msgstr ""
5650
5651 #. type: textblock
5652 #: ../src/guestfs.pod:2680
5653 msgid "C API example code."
5654 msgstr ""
5655
5656 #. type: =item
5657 #: ../src/guestfs.pod:2682
5658 msgid "C<fish>"
5659 msgstr ""
5660
5661 #. type: textblock
5662 #: ../src/guestfs.pod:2684
5663 msgid ""
5664 "L<guestfish(1)>, the command-line shell, and various shell scripts built on "
5665 "top such as L<virt-copy-in(1)>, L<virt-copy-out(1)>, L<virt-tar-in(1)>, "
5666 "L<virt-tar-out(1)>."
5667 msgstr ""
5668
5669 #. type: =item
5670 #: ../src/guestfs.pod:2688
5671 msgid "C<fuse>"
5672 msgstr ""
5673
5674 #. type: textblock
5675 #: ../src/guestfs.pod:2690
5676 msgid ""
5677 "L<guestmount(1)>, FUSE (userspace filesystem) built on top of libguestfs."
5678 msgstr ""
5679
5680 #. type: =item
5681 #: ../src/guestfs.pod:2692
5682 msgid "C<generator>"
5683 msgstr ""
5684
5685 #. type: textblock
5686 #: ../src/guestfs.pod:2694
5687 msgid ""
5688 "The crucially important generator, used to automatically generate large "
5689 "amounts of boilerplate C code for things like RPC and bindings."
5690 msgstr ""
5691
5692 #. type: =item
5693 #: ../src/guestfs.pod:2697
5694 msgid "C<images>"
5695 msgstr ""
5696
5697 #. type: textblock
5698 #: ../src/guestfs.pod:2699
5699 msgid "Files used by the test suite."
5700 msgstr ""
5701
5702 #. type: textblock
5703 #: ../src/guestfs.pod:2701
5704 msgid "Some \"phony\" guest images which we test against."
5705 msgstr ""
5706
5707 #. type: =item
5708 #: ../src/guestfs.pod:2703
5709 msgid "C<inspector>"
5710 msgstr ""
5711
5712 #. type: textblock
5713 #: ../src/guestfs.pod:2705
5714 msgid "L<virt-inspector(1)>, the virtual machine image inspector."
5715 msgstr ""
5716
5717 #. type: =item
5718 #: ../src/guestfs.pod:2707
5719 msgid "C<logo>"
5720 msgstr ""
5721
5722 #. type: textblock
5723 #: ../src/guestfs.pod:2709
5724 msgid "Logo used on the website.  The fish is called Arthur by the way."
5725 msgstr ""
5726
5727 #. type: =item
5728 #: ../src/guestfs.pod:2711
5729 msgid "C<m4>"
5730 msgstr ""
5731
5732 #. type: textblock
5733 #: ../src/guestfs.pod:2713
5734 msgid "M4 macros used by autoconf."
5735 msgstr ""
5736
5737 #. type: =item
5738 #: ../src/guestfs.pod:2715
5739 msgid "C<po>"
5740 msgstr ""
5741
5742 #. type: textblock
5743 #: ../src/guestfs.pod:2717
5744 msgid "Translations of simple gettext strings."
5745 msgstr ""
5746
5747 #. type: =item
5748 #: ../src/guestfs.pod:2719
5749 msgid "C<po-docs>"
5750 msgstr ""
5751
5752 #. type: textblock
5753 #: ../src/guestfs.pod:2721
5754 msgid ""
5755 "The build infrastructure and PO files for translations of manpages and POD "
5756 "files.  Eventually this will be combined with the C<po> directory, but that "
5757 "is rather complicated."
5758 msgstr ""
5759
5760 #. type: =item
5761 #: ../src/guestfs.pod:2725
5762 msgid "C<regressions>"
5763 msgstr ""
5764
5765 #. type: textblock
5766 #: ../src/guestfs.pod:2727
5767 msgid "Regression tests."
5768 msgstr ""
5769
5770 #. type: =item
5771 #: ../src/guestfs.pod:2729
5772 msgid "C<rescue>"
5773 msgstr ""
5774
5775 #. type: textblock
5776 #: ../src/guestfs.pod:2731
5777 msgid "L<virt-rescue(1)> command and documentation."
5778 msgstr ""
5779
5780 #. type: =item
5781 #: ../src/guestfs.pod:2733
5782 msgid "C<src>"
5783 msgstr ""
5784
5785 #. type: textblock
5786 #: ../src/guestfs.pod:2735
5787 msgid "Source code to the C library."
5788 msgstr ""
5789
5790 #. type: =item
5791 #: ../src/guestfs.pod:2737
5792 msgid "C<tools>"
5793 msgstr ""
5794
5795 #. type: textblock
5796 #: ../src/guestfs.pod:2739
5797 msgid "Command line tools written in Perl (L<virt-resize(1)> and many others)."
5798 msgstr ""
5799
5800 #. type: =item
5801 #: ../src/guestfs.pod:2741
5802 msgid "C<test-tool>"
5803 msgstr ""
5804
5805 #. type: textblock
5806 #: ../src/guestfs.pod:2743
5807 msgid ""
5808 "Test tool for end users to test if their qemu/kernel combination will work "
5809 "with libguestfs."
5810 msgstr ""
5811
5812 #. type: =item
5813 #: ../src/guestfs.pod:2746
5814 msgid "C<csharp>"
5815 msgstr ""
5816
5817 #. type: =item
5818 #: ../src/guestfs.pod:2748
5819 msgid "C<haskell>"
5820 msgstr ""
5821
5822 #. type: =item
5823 #: ../src/guestfs.pod:2750
5824 msgid "C<java>"
5825 msgstr ""
5826
5827 #. type: =item
5828 #: ../src/guestfs.pod:2752
5829 msgid "C<ocaml>"
5830 msgstr ""
5831
5832 #. type: =item
5833 #: ../src/guestfs.pod:2754
5834 msgid "C<php>"
5835 msgstr ""
5836
5837 #. type: =item
5838 #: ../src/guestfs.pod:2756
5839 msgid "C<perl>"
5840 msgstr ""
5841
5842 #. type: =item
5843 #: ../src/guestfs.pod:2758
5844 msgid "C<python>"
5845 msgstr ""
5846
5847 #. type: =item
5848 #: ../src/guestfs.pod:2760
5849 msgid "C<ruby>"
5850 msgstr ""
5851
5852 #. type: textblock
5853 #: ../src/guestfs.pod:2762
5854 msgid "Language bindings."
5855 msgstr ""
5856
5857 #. type: =head1
5858 #: ../src/guestfs.pod:2766
5859 msgid "LIMITS"
5860 msgstr ""
5861
5862 # type: =head2
5863 #. type: =head2
5864 #: ../src/guestfs.pod:2768
5865 msgid "PROTOCOL LIMITS"
5866 msgstr ""
5867
5868 # type: textblock
5869 #. type: textblock
5870 #: ../src/guestfs.pod:2770
5871 msgid ""
5872 "Internally libguestfs uses a message-based protocol to pass API calls and "
5873 "their responses to and from a small \"appliance\" (see L</INTERNALS> for "
5874 "plenty more detail about this).  The maximum message size used by the "
5875 "protocol is slightly less than 4 MB.  For some API calls you may need to be "
5876 "aware of this limit.  The API calls which may be affected are individually "
5877 "documented, with a link back to this section of the documentation."
5878 msgstr ""
5879
5880 # type: textblock
5881 #. type: textblock
5882 #: ../src/guestfs.pod:2778
5883 msgid ""
5884 "A simple call such as L</guestfs_cat> returns its result (the file data) in "
5885 "a simple string.  Because this string is at some point internally encoded as "
5886 "a message, the maximum size that it can return is slightly under 4 MB.  If "
5887 "the requested file is larger than this then you will get an error."
5888 msgstr ""
5889
5890 # type: textblock
5891 #. type: textblock
5892 #: ../src/guestfs.pod:2784
5893 msgid ""
5894 "In order to transfer large files into and out of the guest filesystem, you "
5895 "need to use particular calls that support this.  The sections L</UPLOADING> "
5896 "and L</DOWNLOADING> document how to do this."
5897 msgstr ""
5898
5899 # type: textblock
5900 #. type: textblock
5901 #: ../src/guestfs.pod:2788
5902 msgid ""
5903 "You might also consider mounting the disk image using our FUSE filesystem "
5904 "support (L<guestmount(1)>)."
5905 msgstr ""
5906
5907 #. type: =head2
5908 #: ../src/guestfs.pod:2791
5909 msgid "MAXIMUM NUMBER OF DISKS"
5910 msgstr ""
5911
5912 #. type: textblock
5913 #: ../src/guestfs.pod:2793
5914 msgid "When using virtio disks (the default) the current limit is B<25> disks."
5915 msgstr ""
5916
5917 #. type: textblock
5918 #: ../src/guestfs.pod:2796
5919 msgid ""
5920 "Virtio itself consumes 1 virtual PCI slot per disk, and PCI is limited to 31 "
5921 "slots.  However febootstrap only understands disks with names C</dev/vda> "
5922 "through C</dev/vdz> (26 letters) and it reserves one disk for its own "
5923 "purposes."
5924 msgstr ""
5925
5926 #. type: textblock
5927 #: ../src/guestfs.pod:2801
5928 msgid ""
5929 "We are working to substantially raise this limit in future versions but it "
5930 "requires complex changes to qemu."
5931 msgstr ""
5932
5933 #. type: textblock
5934 #: ../src/guestfs.pod:2804
5935 msgid ""
5936 "In future versions of libguestfs it should also be possible to \"hot plug\" "
5937 "disks (add and remove disks after calling L</guestfs_launch>).  This also "
5938 "requires changes to qemu."
5939 msgstr ""
5940
5941 #. type: =head2
5942 #: ../src/guestfs.pod:2808
5943 msgid "MAXIMUM NUMBER OF PARTITIONS PER DISK"
5944 msgstr ""
5945
5946 #. type: textblock
5947 #: ../src/guestfs.pod:2810
5948 msgid "Virtio limits the maximum number of partitions per disk to B<15>."
5949 msgstr ""
5950
5951 #. type: textblock
5952 #: ../src/guestfs.pod:2812
5953 msgid ""
5954 "This is because it reserves 4 bits for the minor device number (thus C</dev/"
5955 "vda>, and C</dev/vda1> through C</dev/vda15>)."
5956 msgstr ""
5957
5958 #. type: textblock
5959 #: ../src/guestfs.pod:2815
5960 msgid ""
5961 "If you attach a disk with more than 15 partitions, the extra partitions are "
5962 "ignored by libguestfs."
5963 msgstr ""
5964
5965 #. type: =head2
5966 #: ../src/guestfs.pod:2818
5967 msgid "MAXIMUM SIZE OF A DISK"
5968 msgstr ""
5969
5970 #. type: textblock
5971 #: ../src/guestfs.pod:2820
5972 msgid "Probably the limit is between 2**63-1 and 2**64-1 bytes."
5973 msgstr ""
5974
5975 #. type: textblock
5976 #: ../src/guestfs.pod:2822
5977 msgid ""
5978 "We have tested block devices up to 1 exabyte (2**60 or "
5979 "1,152,921,504,606,846,976 bytes) using sparse files backed by an XFS host "
5980 "filesystem."
5981 msgstr ""
5982
5983 #. type: textblock
5984 #: ../src/guestfs.pod:2826
5985 msgid ""
5986 "Although libguestfs probably does not impose any limit, the underlying host "
5987 "storage will.  If you store disk images on a host ext4 filesystem, then the "
5988 "maximum size will be limited by the maximum ext4 file size (currently 16 "
5989 "TB).  If you store disk images as host logical volumes then you are limited "
5990 "by the maximum size of an LV."
5991 msgstr ""
5992
5993 #. type: textblock
5994 #: ../src/guestfs.pod:2832
5995 msgid ""
5996 "For the hugest disk image files, we recommend using XFS on the host for "
5997 "storage."
5998 msgstr ""
5999
6000 #. type: =head2
6001 #: ../src/guestfs.pod:2835
6002 msgid "MAXIMUM SIZE OF A PARTITION"
6003 msgstr ""
6004
6005 #. type: textblock
6006 #: ../src/guestfs.pod:2837
6007 msgid ""
6008 "The MBR (ie. classic MS-DOS) partitioning scheme uses 32 bit sector "
6009 "numbers.  Assuming a 512 byte sector size, this means that MBR cannot "
6010 "address a partition located beyond 2 TB on the disk."
6011 msgstr ""
6012
6013 #. type: textblock
6014 #: ../src/guestfs.pod:2841
6015 msgid ""
6016 "It is recommended that you use GPT partitions on disks which are larger than "
6017 "this size.  GPT uses 64 bit sector numbers and so can address partitions "
6018 "which are theoretically larger than the largest disk we could support."
6019 msgstr ""
6020
6021 #. type: =head2
6022 #: ../src/guestfs.pod:2846
6023 msgid "MAXIMUM SIZE OF A FILESYSTEM, FILES, DIRECTORIES"
6024 msgstr ""
6025
6026 #. type: textblock
6027 #: ../src/guestfs.pod:2848
6028 msgid ""
6029 "This depends on the filesystem type.  libguestfs itself does not impose any "
6030 "known limit.  Consult Wikipedia or the filesystem documentation to find out "
6031 "what these limits are."
6032 msgstr ""
6033
6034 #. type: =head2
6035 #: ../src/guestfs.pod:2852
6036 msgid "MAXIMUM UPLOAD AND DOWNLOAD"
6037 msgstr ""
6038
6039 #. type: textblock
6040 #: ../src/guestfs.pod:2854
6041 msgid ""
6042 "The API functions L</guestfs_upload>, L</guestfs_download>, L</"
6043 "guestfs_tar_in>, L</guestfs_tar_out> and the like allow unlimited sized "
6044 "uploads and downloads."
6045 msgstr ""
6046
6047 #. type: =head2
6048 #: ../src/guestfs.pod:2858
6049 msgid "INSPECTION LIMITS"
6050 msgstr ""
6051
6052 #. type: textblock
6053 #: ../src/guestfs.pod:2860
6054 msgid ""
6055 "The inspection code has several arbitrary limits on things like the size of "
6056 "Windows Registry hive it will read, and the length of product name.  These "
6057 "are intended to stop a malicious guest from consuming arbitrary amounts of "
6058 "memory and disk space on the host, and should not be reached in practice.  "
6059 "See the source code for more information."
6060 msgstr ""
6061
6062 # type: =head1
6063 #. type: =head1
6064 #: ../src/guestfs.pod:2866 ../fish/guestfish.pod:1015
6065 #: ../test-tool/libguestfs-test-tool.pod:82 ../tools/virt-edit.pl:476
6066 msgid "ENVIRONMENT VARIABLES"
6067 msgstr ""
6068
6069 # type: =item
6070 #. type: =item
6071 #: ../src/guestfs.pod:2870 ../fish/guestfish.pod:1041
6072 msgid "LIBGUESTFS_APPEND"
6073 msgstr ""
6074
6075 # type: textblock
6076 #. type: textblock
6077 #: ../src/guestfs.pod:2872 ../fish/guestfish.pod:1043
6078 msgid "Pass additional options to the guest kernel."
6079 msgstr ""
6080
6081 # type: =item
6082 #. type: =item
6083 #: ../src/guestfs.pod:2874 ../fish/guestfish.pod:1045
6084 msgid "LIBGUESTFS_DEBUG"
6085 msgstr ""
6086
6087 # type: textblock
6088 #. type: textblock
6089 #: ../src/guestfs.pod:2876
6090 msgid ""
6091 "Set C<LIBGUESTFS_DEBUG=1> to enable verbose messages.  This has the same "
6092 "effect as calling C<guestfs_set_verbose (g, 1)>."
6093 msgstr ""
6094
6095 # type: =item
6096 #. type: =item
6097 #: ../src/guestfs.pod:2879 ../fish/guestfish.pod:1050
6098 msgid "LIBGUESTFS_MEMSIZE"
6099 msgstr ""
6100
6101 # type: textblock
6102 #. type: textblock
6103 #: ../src/guestfs.pod:2881 ../fish/guestfish.pod:1052
6104 msgid ""
6105 "Set the memory allocated to the qemu process, in megabytes.  For example:"
6106 msgstr ""
6107
6108 # type: verbatim
6109 #. type: verbatim
6110 #: ../src/guestfs.pod:2884 ../fish/guestfish.pod:1055
6111 #, no-wrap
6112 msgid ""
6113 " LIBGUESTFS_MEMSIZE=700\n"
6114 "\n"
6115 msgstr ""
6116
6117 # type: =item
6118 #. type: =item
6119 #: ../src/guestfs.pod:2886 ../fish/guestfish.pod:1057
6120 msgid "LIBGUESTFS_PATH"
6121 msgstr ""
6122
6123 #. type: textblock
6124 #: ../src/guestfs.pod:2888
6125 msgid ""
6126 "Set the path that libguestfs uses to search for a supermin appliance.  See "
6127 "the discussion of paths in section L</PATH> above."
6128 msgstr ""
6129
6130 # type: =item
6131 #. type: =item
6132 #: ../src/guestfs.pod:2891 ../fish/guestfish.pod:1062
6133 msgid "LIBGUESTFS_QEMU"
6134 msgstr ""
6135
6136 # type: textblock
6137 #. type: textblock
6138 #: ../src/guestfs.pod:2893 ../fish/guestfish.pod:1064
6139 msgid ""
6140 "Set the default qemu binary that libguestfs uses.  If not set, then the qemu "
6141 "which was found at compile time by the configure script is used."
6142 msgstr ""
6143
6144 # type: textblock
6145 #. type: textblock
6146 #: ../src/guestfs.pod:2897
6147 msgid "See also L</QEMU WRAPPERS> above."
6148 msgstr ""
6149
6150 # type: =item
6151 #. type: =item
6152 #: ../src/guestfs.pod:2899 ../fish/guestfish.pod:1068
6153 msgid "LIBGUESTFS_TRACE"
6154 msgstr ""
6155
6156 # type: textblock
6157 #. type: textblock
6158 #: ../src/guestfs.pod:2901
6159 msgid ""
6160 "Set C<LIBGUESTFS_TRACE=1> to enable command traces.  This has the same "
6161 "effect as calling C<guestfs_set_trace (g, 1)>."
6162 msgstr ""
6163
6164 # type: =item
6165 #. type: =item
6166 #: ../src/guestfs.pod:2904 ../fish/guestfish.pod:1077
6167 msgid "TMPDIR"
6168 msgstr ""
6169
6170 #. type: textblock
6171 #: ../src/guestfs.pod:2906 ../fish/guestfish.pod:1079
6172 msgid ""
6173 "Location of temporary directory, defaults to C</tmp> except for the cached "
6174 "supermin appliance which defaults to C</var/tmp>."
6175 msgstr ""
6176
6177 #. type: textblock
6178 #: ../src/guestfs.pod:2909 ../fish/guestfish.pod:1082
6179 msgid ""
6180 "If libguestfs was compiled to use the supermin appliance then the real "
6181 "appliance is cached in this directory, shared between all handles belonging "
6182 "to the same EUID.  You can use C<$TMPDIR> to configure another directory to "
6183 "use in case C</var/tmp> is not large enough."
6184 msgstr ""
6185
6186 # type: =head1
6187 #. type: =head1
6188 #: ../src/guestfs.pod:2917 ../fish/guestfish.pod:1149
6189 #: ../test-tool/libguestfs-test-tool.pod:87 ../fuse/guestmount.pod:277
6190 #: ../tools/virt-edit.pl:496 ../tools/virt-win-reg.pl:572
6191 #: ../tools/virt-list-filesystems.pl:189 ../tools/virt-tar.pl:286
6192 #: ../tools/virt-make-fs.pl:539 ../tools/virt-list-partitions.pl:257
6193 msgid "SEE ALSO"
6194 msgstr ""
6195
6196 #. type: textblock
6197 #: ../src/guestfs.pod:2919
6198 msgid ""
6199 "L<guestfs-examples(3)>, L<guestfs-ocaml(3)>, L<guestfs-python(3)>, L<guestfs-"
6200 "ruby(3)>, L<guestfish(1)>, L<guestmount(1)>, L<virt-cat(1)>, L<virt-copy-in"
6201 "(1)>, L<virt-copy-out(1)>, L<virt-df(1)>, L<virt-edit(1)>, L<virt-filesystems"
6202 "(1)>, L<virt-inspector(1)>, L<virt-list-filesystems(1)>, L<virt-list-"
6203 "partitions(1)>, L<virt-ls(1)>, L<virt-make-fs(1)>, L<virt-rescue(1)>, L<virt-"
6204 "tar(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>, L<virt-win-reg(1)>, L<qemu(1)"
6205 ">, L<febootstrap(1)>, L<hivex(3)>, L<http://libguestfs.org/>."
6206 msgstr ""
6207
6208 # type: textblock
6209 #. type: textblock
6210 #: ../src/guestfs.pod:2946
6211 msgid ""
6212 "Tools with a similar purpose: L<fdisk(8)>, L<parted(8)>, L<kpartx(8)>, L<lvm"
6213 "(8)>, L<disktype(1)>."
6214 msgstr ""
6215
6216 # type: =head1
6217 #. type: =head1
6218 #: ../src/guestfs.pod:2953 ../tools/virt-win-reg.pl:587
6219 #: ../tools/virt-make-fs.pl:553
6220 msgid "BUGS"
6221 msgstr ""
6222
6223 # type: textblock
6224 #. type: textblock
6225 #: ../src/guestfs.pod:2955
6226 msgid "To get a list of bugs against libguestfs use this link:"
6227 msgstr ""
6228
6229 # type: textblock
6230 #. type: textblock
6231 #: ../src/guestfs.pod:2957
6232 msgid ""
6233 "L<https://bugzilla.redhat.com/buglist.cgi?"
6234 "component=libguestfs&product=Virtualization+Tools>"
6235 msgstr ""
6236
6237 # type: textblock
6238 #. type: textblock
6239 #: ../src/guestfs.pod:2959
6240 msgid "To report a new bug against libguestfs use this link:"
6241 msgstr ""
6242
6243 # type: textblock
6244 #. type: textblock
6245 #: ../src/guestfs.pod:2961
6246 msgid ""
6247 "L<https://bugzilla.redhat.com/enter_bug.cgi?"
6248 "component=libguestfs&product=Virtualization+Tools>"
6249 msgstr ""
6250
6251 # type: textblock
6252 #. type: textblock
6253 #: ../src/guestfs.pod:2963
6254 msgid "When reporting a bug, please check:"
6255 msgstr ""
6256
6257 # type: textblock
6258 #. type: textblock
6259 #: ../src/guestfs.pod:2969
6260 msgid "That the bug hasn't been reported already."
6261 msgstr ""
6262
6263 # type: textblock
6264 #. type: textblock
6265 #: ../src/guestfs.pod:2973
6266 msgid "That you are testing a recent version."
6267 msgstr ""
6268
6269 # type: textblock
6270 #. type: textblock
6271 #: ../src/guestfs.pod:2977
6272 msgid "Describe the bug accurately, and give a way to reproduce it."
6273 msgstr ""
6274
6275 # type: textblock
6276 #. type: textblock
6277 #: ../src/guestfs.pod:2981
6278 msgid ""
6279 "Run libguestfs-test-tool and paste the B<complete, unedited> output into the "
6280 "bug report."
6281 msgstr ""
6282
6283 # type: =head1
6284 #. type: =head1
6285 #: ../src/guestfs.pod:2986 ../fish/guestfish.pod:1172
6286 #: ../test-tool/libguestfs-test-tool.pod:93 ../fuse/guestmount.pod:288
6287 msgid "AUTHORS"
6288 msgstr ""
6289
6290 # type: textblock
6291 #. type: textblock
6292 #: ../src/guestfs.pod:2988 ../fish/guestfish.pod:1174
6293 #: ../test-tool/libguestfs-test-tool.pod:95 ../fuse/guestmount.pod:290
6294 msgid "Richard W.M. Jones (C<rjones at redhat dot com>)"
6295 msgstr ""
6296
6297 # type: =head1
6298 #. type: =head1
6299 #: ../src/guestfs.pod:2990 ../fish/guestfish.pod:1176
6300 #: ../test-tool/libguestfs-test-tool.pod:97 ../fuse/guestmount.pod:292
6301 #: ../tools/virt-edit.pl:514 ../tools/virt-win-reg.pl:602
6302 #: ../tools/virt-list-filesystems.pl:206 ../tools/virt-tar.pl:305
6303 #: ../tools/virt-make-fs.pl:568 ../tools/virt-list-partitions.pl:273
6304 msgid "COPYRIGHT"
6305 msgstr ""
6306
6307 #. type: textblock
6308 #: ../src/guestfs.pod:2992 ../fish/guestfish.pod:1178
6309 #: ../test-tool/libguestfs-test-tool.pod:99
6310 msgid "Copyright (C) 2009-2011 Red Hat Inc.  L<http://libguestfs.org/>"
6311 msgstr ""
6312
6313 # type: textblock
6314 #. type: textblock
6315 #: ../src/guestfs.pod:2995
6316 msgid ""
6317 "This library is free software; you can redistribute it and/or modify it "
6318 "under the terms of the GNU Lesser General Public License as published by the "
6319 "Free Software Foundation; either version 2 of the License, or (at your "
6320 "option) any later version."
6321 msgstr ""
6322
6323 # type: textblock
6324 #. type: textblock
6325 #: ../src/guestfs.pod:3000
6326 msgid ""
6327 "This library is distributed in the hope that it will be useful, but WITHOUT "
6328 "ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or "
6329 "FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public License "
6330 "for more details."
6331 msgstr ""
6332
6333 # type: textblock
6334 #. type: textblock
6335 #: ../src/guestfs.pod:3005
6336 msgid ""
6337 "You should have received a copy of the GNU Lesser General Public License "
6338 "along with this library; if not, write to the Free Software Foundation, "
6339 "Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA"
6340 msgstr ""
6341
6342 # type: =head2
6343 #. type: =head2
6344 #: ../src/guestfs-actions.pod:1
6345 msgid "guestfs_add_cdrom"
6346 msgstr ""
6347
6348 # type: verbatim
6349 #. type: verbatim
6350 #: ../src/guestfs-actions.pod:3
6351 #, no-wrap
6352 msgid ""
6353 " int\n"
6354 " guestfs_add_cdrom (guestfs_h *g,\n"
6355 "                    const char *filename);\n"
6356 "\n"
6357 msgstr ""
6358
6359 # type: textblock
6360 #. type: textblock
6361 #: ../src/guestfs-actions.pod:7 ../fish/guestfish-actions.pod:5
6362 msgid "This function adds a virtual CD-ROM disk image to the guest."
6363 msgstr ""
6364
6365 #. type: textblock
6366 #: ../src/guestfs-actions.pod:9 ../fish/guestfish-actions.pod:7
6367 msgid "This is equivalent to the qemu parameter I<-cdrom filename>."
6368 msgstr ""
6369
6370 # type: textblock
6371 #. type: textblock
6372 #: ../src/guestfs-actions.pod:17
6373 msgid ""
6374 "This call checks for the existence of C<filename>.  This stops you from "
6375 "specifying other types of drive which are supported by qemu such as C<nbd:> "
6376 "and C<http:> URLs.  To specify those, use the general C<guestfs_config> call "
6377 "instead."
6378 msgstr ""
6379
6380 # type: textblock
6381 #. type: textblock
6382 #: ../src/guestfs-actions.pod:24
6383 msgid ""
6384 "If you just want to add an ISO file (often you use this as an efficient way "
6385 "to transfer large files into the guest), then you should probably use "
6386 "C<guestfs_add_drive_ro> instead."
6387 msgstr ""
6388
6389 # type: textblock
6390 #. type: textblock
6391 #: ../src/guestfs-actions.pod:30 ../src/guestfs-actions.pod:134
6392 #: ../src/guestfs-actions.pod:195 ../src/guestfs-actions.pod:232
6393 #: ../src/guestfs-actions.pod:246 ../src/guestfs-actions.pod:267
6394 #: ../src/guestfs-actions.pod:287 ../src/guestfs-actions.pod:301
6395 #: ../src/guestfs-actions.pod:416 ../src/guestfs-actions.pod:436
6396 #: ../src/guestfs-actions.pod:450 ../src/guestfs-actions.pod:495
6397 #: ../src/guestfs-actions.pod:523 ../src/guestfs-actions.pod:541
6398 #: ../src/guestfs-actions.pod:608 ../src/guestfs-actions.pod:641
6399 #: ../src/guestfs-actions.pod:655 ../src/guestfs-actions.pod:670
6400 #: ../src/guestfs-actions.pod:769 ../src/guestfs-actions.pod:787
6401 #: ../src/guestfs-actions.pod:801 ../src/guestfs-actions.pod:815
6402 #: ../src/guestfs-actions.pod:976 ../src/guestfs-actions.pod:996
6403 #: ../src/guestfs-actions.pod:1014 ../src/guestfs-actions.pod:1098
6404 #: ../src/guestfs-actions.pod:1116 ../src/guestfs-actions.pod:1135
6405 #: ../src/guestfs-actions.pod:1149 ../src/guestfs-actions.pod:1169
6406 #: ../src/guestfs-actions.pod:1239 ../src/guestfs-actions.pod:1270
6407 #: ../src/guestfs-actions.pod:1295 ../src/guestfs-actions.pod:1337
6408 #: ../src/guestfs-actions.pod:1443 ../src/guestfs-actions.pod:1477
6409 #: ../src/guestfs-actions.pod:1692 ../src/guestfs-actions.pod:1714
6410 #: ../src/guestfs-actions.pod:1801 ../src/guestfs-actions.pod:2263
6411 #: ../src/guestfs-actions.pod:2407 ../src/guestfs-actions.pod:2468
6412 #: ../src/guestfs-actions.pod:2503 ../src/guestfs-actions.pod:3456
6413 #: ../src/guestfs-actions.pod:3471 ../src/guestfs-actions.pod:3496
6414 #: ../src/guestfs-actions.pod:3651 ../src/guestfs-actions.pod:3665
6415 #: ../src/guestfs-actions.pod:3678 ../src/guestfs-actions.pod:3692
6416 #: ../src/guestfs-actions.pod:3707 ../src/guestfs-actions.pod:3743
6417 #: ../src/guestfs-actions.pod:3815 ../src/guestfs-actions.pod:3835
6418 #: ../src/guestfs-actions.pod:3852 ../src/guestfs-actions.pod:3875
6419 #: ../src/guestfs-actions.pod:3898 ../src/guestfs-actions.pod:3930
6420 #: ../src/guestfs-actions.pod:3949 ../src/guestfs-actions.pod:3968
6421 #: ../src/guestfs-actions.pod:4003 ../src/guestfs-actions.pod:4015
6422 #: ../src/guestfs-actions.pod:4051 ../src/guestfs-actions.pod:4067
6423 #: ../src/guestfs-actions.pod:4080 ../src/guestfs-actions.pod:4095
6424 #: ../src/guestfs-actions.pod:4112 ../src/guestfs-actions.pod:4205
6425 #: ../src/guestfs-actions.pod:4225 ../src/guestfs-actions.pod:4238
6426 #: ../src/guestfs-actions.pod:4289 ../src/guestfs-actions.pod:4307
6427 #: ../src/guestfs-actions.pod:4325 ../src/guestfs-actions.pod:4341
6428 #: ../src/guestfs-actions.pod:4355 ../src/guestfs-actions.pod:4369
6429 #: ../src/guestfs-actions.pod:4386 ../src/guestfs-actions.pod:4401
6430 #: ../src/guestfs-actions.pod:4421 ../src/guestfs-actions.pod:4479
6431 #: ../src/guestfs-actions.pod:4552 ../src/guestfs-actions.pod:4583
6432 #: ../src/guestfs-actions.pod:4602 ../src/guestfs-actions.pod:4621
6433 #: ../src/guestfs-actions.pod:4633 ../src/guestfs-actions.pod:4650
6434 #: ../src/guestfs-actions.pod:4663 ../src/guestfs-actions.pod:4678
6435 #: ../src/guestfs-actions.pod:4693 ../src/guestfs-actions.pod:4728
6436 #: ../src/guestfs-actions.pod:4750 ../src/guestfs-actions.pod:4770
6437 #: ../src/guestfs-actions.pod:4784 ../src/guestfs-actions.pod:4801
6438 #: ../src/guestfs-actions.pod:4850 ../src/guestfs-actions.pod:4896
6439 #: ../src/guestfs-actions.pod:4910 ../src/guestfs-actions.pod:4938
6440 #: ../src/guestfs-actions.pod:4955 ../src/guestfs-actions.pod:4973
6441 #: ../src/guestfs-actions.pod:5107 ../src/guestfs-actions.pod:5164
6442 #: ../src/guestfs-actions.pod:5186 ../src/guestfs-actions.pod:5204
6443 #: ../src/guestfs-actions.pod:5236 ../src/guestfs-actions.pod:5302
6444 #: ../src/guestfs-actions.pod:5319 ../src/guestfs-actions.pod:5332
6445 #: ../src/guestfs-actions.pod:5346 ../src/guestfs-actions.pod:5635
6446 #: ../src/guestfs-actions.pod:5654 ../src/guestfs-actions.pod:5673
6447 #: ../src/guestfs-actions.pod:5685 ../src/guestfs-actions.pod:5697
6448 #: ../src/guestfs-actions.pod:5711 ../src/guestfs-actions.pod:5723
6449 #: ../src/guestfs-actions.pod:5737 ../src/guestfs-actions.pod:5753
6450 #: ../src/guestfs-actions.pod:5774 ../src/guestfs-actions.pod:5793
6451 #: ../src/guestfs-actions.pod:5812 ../src/guestfs-actions.pod:5842
6452 #: ../src/guestfs-actions.pod:5858 ../src/guestfs-actions.pod:5881
6453 #: ../src/guestfs-actions.pod:5899 ../src/guestfs-actions.pod:5918
6454 #: ../src/guestfs-actions.pod:5939 ../src/guestfs-actions.pod:5958
6455 #: ../src/guestfs-actions.pod:5975 ../src/guestfs-actions.pod:6003
6456 #: ../src/guestfs-actions.pod:6027 ../src/guestfs-actions.pod:6046
6457 #: ../src/guestfs-actions.pod:6070 ../src/guestfs-actions.pod:6089
6458 #: ../src/guestfs-actions.pod:6104 ../src/guestfs-actions.pod:6123
6459 #: ../src/guestfs-actions.pod:6160 ../src/guestfs-actions.pod:6190
6460 #: ../src/guestfs-actions.pod:6223 ../src/guestfs-actions.pod:6345
6461 #: ../src/guestfs-actions.pod:6466 ../src/guestfs-actions.pod:6478
6462 #: ../src/guestfs-actions.pod:6491 ../src/guestfs-actions.pod:6504
6463 #: ../src/guestfs-actions.pod:6526 ../src/guestfs-actions.pod:6539
6464 #: ../src/guestfs-actions.pod:6552 ../src/guestfs-actions.pod:6565
6465 #: ../src/guestfs-actions.pod:6580 ../src/guestfs-actions.pod:6639
6466 #: ../src/guestfs-actions.pod:6656 ../src/guestfs-actions.pod:6672
6467 #: ../src/guestfs-actions.pod:6688 ../src/guestfs-actions.pod:6705
6468 #: ../src/guestfs-actions.pod:6718 ../src/guestfs-actions.pod:6738
6469 #: ../src/guestfs-actions.pod:6774 ../src/guestfs-actions.pod:6788
6470 #: ../src/guestfs-actions.pod:6829 ../src/guestfs-actions.pod:6842
6471 #: ../src/guestfs-actions.pod:6860 ../src/guestfs-actions.pod:6894
6472 #: ../src/guestfs-actions.pod:6930 ../src/guestfs-actions.pod:7049
6473 #: ../src/guestfs-actions.pod:7067 ../src/guestfs-actions.pod:7081
6474 #: ../src/guestfs-actions.pod:7136 ../src/guestfs-actions.pod:7149
6475 #: ../src/guestfs-actions.pod:7194 ../src/guestfs-actions.pod:7227
6476 #: ../src/guestfs-actions.pod:7288 ../src/guestfs-actions.pod:7314
6477 #: ../src/guestfs-actions.pod:7380 ../src/guestfs-actions.pod:7399
6478 #: ../src/guestfs-actions.pod:7428
6479 msgid "This function returns 0 on success or -1 on error."
6480 msgstr ""
6481
6482 # type: textblock
6483 #. type: textblock
6484 #: ../src/guestfs-actions.pod:32 ../src/guestfs-actions.pod:248
6485 #: ../src/guestfs-actions.pod:269 ../fish/guestfish-actions.pod:28
6486 #: ../fish/guestfish-actions.pod:158 ../fish/guestfish-actions.pod:172
6487 msgid ""
6488 "This function is deprecated.  In new code, use the C<add_drive_opts> call "
6489 "instead."
6490 msgstr ""
6491
6492 # type: textblock
6493 #. type: textblock
6494 #: ../src/guestfs-actions.pod:35 ../src/guestfs-actions.pod:251
6495 #: ../src/guestfs-actions.pod:272 ../src/guestfs-actions.pod:1448
6496 #: ../src/guestfs-actions.pod:1941 ../src/guestfs-actions.pod:1962
6497 #: ../src/guestfs-actions.pod:4426 ../src/guestfs-actions.pod:4733
6498 #: ../src/guestfs-actions.pod:6168 ../src/guestfs-actions.pod:6198
6499 #: ../src/guestfs-actions.pod:6231 ../src/guestfs-actions.pod:6290
6500 #: ../src/guestfs-actions.pod:7232 ../src/guestfs-actions.pod:7322
6501 #: ../src/guestfs-actions.pod:7491 ../fish/guestfish-actions.pod:31
6502 #: ../fish/guestfish-actions.pod:161 ../fish/guestfish-actions.pod:175
6503 #: ../fish/guestfish-actions.pod:956 ../fish/guestfish-actions.pod:1316
6504 #: ../fish/guestfish-actions.pod:1330 ../fish/guestfish-actions.pod:3005
6505 #: ../fish/guestfish-actions.pod:3202 ../fish/guestfish-actions.pod:4183
6506 #: ../fish/guestfish-actions.pod:4206 ../fish/guestfish-actions.pod:4228
6507 #: ../fish/guestfish-actions.pod:4266 ../fish/guestfish-actions.pod:4907
6508 #: ../fish/guestfish-actions.pod:5004
6509 msgid ""
6510 "Deprecated functions will not be removed from the API, but the fact that "
6511 "they are deprecated indicates that there are problems with correct use of "
6512 "these functions."
6513 msgstr ""
6514
6515 # type: textblock
6516 #. type: textblock
6517 #: ../src/guestfs-actions.pod:39 ../src/guestfs-actions.pod:136
6518 #: ../src/guestfs-actions.pod:1100 ../src/guestfs-actions.pod:1913
6519 #: ../src/guestfs-actions.pod:2011 ../src/guestfs-actions.pod:2114
6520 #: ../src/guestfs-actions.pod:3458 ../src/guestfs-actions.pod:3478
6521 #: ../src/guestfs-actions.pod:4737 ../src/guestfs-actions.pod:5860
6522 #: ../src/guestfs-actions.pod:5977 ../src/guestfs-actions.pod:6091
6523 #: ../src/guestfs-actions.pod:6582 ../src/guestfs-actions.pod:6707
6524 #: ../src/guestfs-actions.pod:7236
6525 msgid "(Added in 0.3)"
6526 msgstr ""
6527
6528 # type: =head2
6529 #. type: =head2
6530 #: ../src/guestfs-actions.pod:41
6531 msgid "guestfs_add_domain"
6532 msgstr ""
6533
6534 # type: verbatim
6535 #. type: verbatim
6536 #: ../src/guestfs-actions.pod:43
6537 #, no-wrap
6538 msgid ""
6539 " int\n"
6540 " guestfs_add_domain (guestfs_h *g,\n"
6541 "                     const char *dom,\n"
6542 "                     ...);\n"
6543 "\n"
6544 msgstr ""
6545
6546 # type: textblock
6547 #. type: textblock
6548 #: ../src/guestfs-actions.pod:48 ../src/guestfs-actions.pod:145
6549 #: ../src/guestfs-actions.pod:4440
6550 msgid ""
6551 "You may supply a list of optional arguments to this call.  Use zero or more "
6552 "of the following pairs of parameters, and terminate the list with C<-1> on "
6553 "its own.  See L</CALLS WITH OPTIONAL ARGUMENTS>."
6554 msgstr ""
6555
6556 #. type: verbatim
6557 #: ../src/guestfs-actions.pod:53
6558 #, no-wrap
6559 msgid ""
6560 " GUESTFS_ADD_DOMAIN_LIBVIRTURI, const char *libvirturi,\n"
6561 " GUESTFS_ADD_DOMAIN_READONLY, int readonly,\n"
6562 " GUESTFS_ADD_DOMAIN_IFACE, const char *iface,\n"
6563 " GUESTFS_ADD_DOMAIN_LIVE, int live,\n"
6564 "\n"
6565 msgstr ""
6566
6567 # type: textblock
6568 #. type: textblock
6569 #: ../src/guestfs-actions.pod:58
6570 msgid ""
6571 "This function adds the disk(s) attached to the named libvirt domain C<dom>.  "
6572 "It works by connecting to libvirt, requesting the domain and domain XML from "
6573 "libvirt, parsing it for disks, and calling C<guestfs_add_drive_opts> on each "
6574 "one."
6575 msgstr ""
6576
6577 # type: textblock
6578 #. type: textblock
6579 #: ../src/guestfs-actions.pod:63 ../fish/guestfish-actions.pod:46
6580 msgid ""
6581 "The number of disks added is returned.  This operation is atomic: if an "
6582 "error is returned, then no disks are added."
6583 msgstr ""
6584
6585 # type: textblock
6586 #. type: textblock
6587 #: ../src/guestfs-actions.pod:66 ../fish/guestfish-actions.pod:49
6588 msgid ""
6589 "This function does some minimal checks to make sure the libvirt domain is "
6590 "not running (unless C<readonly> is true).  In a future version we will try "
6591 "to acquire the libvirt lock on each disk."
6592 msgstr ""
6593
6594 # type: textblock
6595 #. type: textblock
6596 #: ../src/guestfs-actions.pod:70 ../fish/guestfish-actions.pod:53
6597 msgid ""
6598 "Disks must be accessible locally.  This often means that adding disks from a "
6599 "remote libvirt connection (see L<http://libvirt.org/remote.html>)  will fail "
6600 "unless those disks are accessible via the same device path locally too."
6601 msgstr ""
6602
6603 #. type: textblock
6604 #: ../src/guestfs-actions.pod:75 ../fish/guestfish-actions.pod:58
6605 msgid ""
6606 "The optional C<libvirturi> parameter sets the libvirt URI (see L<http://"
6607 "libvirt.org/uri.html>).  If this is not set then we connect to the default "
6608 "libvirt URI (or one set through an environment variable, see the libvirt "
6609 "documentation for full details)."
6610 msgstr ""
6611
6612 #. type: textblock
6613 #: ../src/guestfs-actions.pod:81 ../fish/guestfish-actions.pod:64
6614 msgid ""
6615 "The optional C<live> flag controls whether this call will try to connect to "
6616 "a running virtual machine C<guestfsd> process if it sees a suitable "
6617 "E<lt>channelE<gt> element in the libvirt XML definition.  The default (if "
6618 "the flag is omitted) is never to try.  See L<guestfs(3)/ATTACHING TO RUNNING "
6619 "DAEMONS> for more information."
6620 msgstr ""
6621
6622 # type: textblock
6623 #. type: textblock
6624 #: ../src/guestfs-actions.pod:88
6625 msgid ""
6626 "The other optional parameters are passed directly through to "
6627 "C<guestfs_add_drive_opts>."
6628 msgstr ""
6629
6630 # type: textblock
6631 #. type: textblock
6632 #: ../src/guestfs-actions.pod:91 ../src/guestfs-actions.pod:344
6633 #: ../src/guestfs-actions.pod:509 ../src/guestfs-actions.pod:687
6634 #: ../src/guestfs-actions.pod:718 ../src/guestfs-actions.pod:736
6635 #: ../src/guestfs-actions.pod:755 ../src/guestfs-actions.pod:1315
6636 #: ../src/guestfs-actions.pod:1671 ../src/guestfs-actions.pod:1874
6637 #: ../src/guestfs-actions.pod:1983 ../src/guestfs-actions.pod:2023
6638 #: ../src/guestfs-actions.pod:2078 ../src/guestfs-actions.pod:2101
6639 #: ../src/guestfs-actions.pod:2394 ../src/guestfs-actions.pod:2777
6640 #: ../src/guestfs-actions.pod:2798 ../src/guestfs-actions.pod:4873
6641 #: ../src/guestfs-actions.pod:5010 ../src/guestfs-actions.pod:5416
6642 #: ../src/guestfs-actions.pod:5442 ../src/guestfs-actions.pod:6815
6643 #: ../src/guestfs-actions.pod:7247 ../src/guestfs-actions.pod:7260
6644 #: ../src/guestfs-actions.pod:7273
6645 msgid "On error this function returns -1."
6646 msgstr ""
6647
6648 # type: textblock
6649 #. type: textblock
6650 #: ../src/guestfs-actions.pod:93
6651 msgid "(Added in 1.7.4)"
6652 msgstr ""
6653
6654 # type: =head2
6655 #. type: =head2
6656 #: ../src/guestfs-actions.pod:95
6657 msgid "guestfs_add_domain_va"
6658 msgstr ""
6659
6660 # type: verbatim
6661 #. type: verbatim
6662 #: ../src/guestfs-actions.pod:97
6663 #, no-wrap
6664 msgid ""
6665 " int\n"
6666 " guestfs_add_domain_va (guestfs_h *g,\n"
6667 "                        const char *dom,\n"
6668 "                        va_list args);\n"
6669 "\n"
6670 msgstr ""
6671
6672 # type: textblock
6673 #. type: textblock
6674 #: ../src/guestfs-actions.pod:102
6675 msgid "This is the \"va_list variant\" of L</guestfs_add_domain>."
6676 msgstr ""
6677
6678 # type: textblock
6679 #. type: textblock
6680 #: ../src/guestfs-actions.pod:104 ../src/guestfs-actions.pod:115
6681 #: ../src/guestfs-actions.pod:208 ../src/guestfs-actions.pod:219
6682 #: ../src/guestfs-actions.pod:4493 ../src/guestfs-actions.pod:4505
6683 msgid "See L</CALLS WITH OPTIONAL ARGUMENTS>."
6684 msgstr ""
6685
6686 # type: =head2
6687 #. type: =head2
6688 #: ../src/guestfs-actions.pod:106
6689 msgid "guestfs_add_domain_argv"
6690 msgstr ""
6691
6692 # type: verbatim
6693 #. type: verbatim
6694 #: ../src/guestfs-actions.pod:108
6695 #, no-wrap
6696 msgid ""
6697 " int\n"
6698 " guestfs_add_domain_argv (guestfs_h *g,\n"
6699 "                          const char *dom,\n"
6700 "                          const struct guestfs_add_domain_argv *optargs);\n"
6701 "\n"
6702 msgstr ""
6703
6704 # type: textblock
6705 #. type: textblock
6706 #: ../src/guestfs-actions.pod:113
6707 msgid "This is the \"argv variant\" of L</guestfs_add_domain>."
6708 msgstr ""
6709
6710 # type: =head2
6711 #. type: =head2
6712 #: ../src/guestfs-actions.pod:117
6713 msgid "guestfs_add_drive"
6714 msgstr ""
6715
6716 # type: verbatim
6717 #. type: verbatim
6718 #: ../src/guestfs-actions.pod:119
6719 #, no-wrap
6720 msgid ""
6721 " int\n"
6722 " guestfs_add_drive (guestfs_h *g,\n"
6723 "                    const char *filename);\n"
6724 "\n"
6725 msgstr ""
6726
6727 # type: textblock
6728 #. type: textblock
6729 #: ../src/guestfs-actions.pod:123
6730 msgid ""
6731 "This function is the equivalent of calling C<guestfs_add_drive_opts> with no "
6732 "optional parameters, so the disk is added writable, with the format being "
6733 "detected automatically."
6734 msgstr ""
6735
6736 # type: textblock
6737 #. type: textblock
6738 #: ../src/guestfs-actions.pod:127
6739 msgid ""
6740 "Automatic detection of the format opens you up to a potential security hole "
6741 "when dealing with untrusted raw-format images.  See CVE-2010-3851 and "
6742 "RHBZ#642934.  Specifying the format closes this security hole.  Therefore "
6743 "you should think about replacing calls to this function with calls to "
6744 "C<guestfs_add_drive_opts>, and specifying the format."
6745 msgstr ""
6746
6747 # type: =head2
6748 #. type: =head2
6749 #: ../src/guestfs-actions.pod:138
6750 msgid "guestfs_add_drive_opts"
6751 msgstr ""
6752
6753 # type: verbatim
6754 #. type: verbatim
6755 #: ../src/guestfs-actions.pod:140
6756 #, no-wrap
6757 msgid ""
6758 " int\n"
6759 " guestfs_add_drive_opts (guestfs_h *g,\n"
6760 "                         const char *filename,\n"
6761 "                         ...);\n"
6762 "\n"
6763 msgstr ""
6764
6765 # type: verbatim
6766 #. type: verbatim
6767 #: ../src/guestfs-actions.pod:150
6768 #, no-wrap
6769 msgid ""
6770 " GUESTFS_ADD_DRIVE_OPTS_READONLY, int readonly,\n"
6771 " GUESTFS_ADD_DRIVE_OPTS_FORMAT, const char *format,\n"
6772 " GUESTFS_ADD_DRIVE_OPTS_IFACE, const char *iface,\n"
6773 "\n"
6774 msgstr ""
6775
6776 # type: textblock
6777 #. type: textblock
6778 #: ../src/guestfs-actions.pod:154 ../fish/guestfish-actions.pod:97
6779 msgid ""
6780 "This function adds a virtual machine disk image C<filename> to libguestfs.  "
6781 "The first time you call this function, the disk appears as C</dev/sda>, the "
6782 "second time as C</dev/sdb>, and so on."
6783 msgstr ""
6784
6785 # type: textblock
6786 #. type: textblock
6787 #: ../src/guestfs-actions.pod:159 ../fish/guestfish-actions.pod:102
6788 msgid ""
6789 "You don't necessarily need to be root when using libguestfs.  However you "
6790 "obviously do need sufficient permissions to access the filename for whatever "
6791 "operations you want to perform (ie. read access if you just want to read the "
6792 "image or write access if you want to modify the image)."
6793 msgstr ""
6794
6795 # type: textblock
6796 #. type: textblock
6797 #: ../src/guestfs-actions.pod:165 ../fish/guestfish-actions.pod:108
6798 msgid "This call checks that C<filename> exists."
6799 msgstr ""
6800
6801 # type: textblock
6802 #. type: textblock
6803 #: ../src/guestfs-actions.pod:167 ../src/guestfs-actions.pod:4451
6804 #: ../fish/guestfish-actions.pod:110 ../fish/guestfish-actions.pod:3016
6805 msgid "The optional arguments are:"
6806 msgstr ""
6807
6808 # type: =item
6809 #. type: =item
6810 #: ../src/guestfs-actions.pod:171 ../fish/guestfish-actions.pod:114
6811 msgid "C<readonly>"
6812 msgstr ""
6813
6814 # type: textblock
6815 #. type: textblock
6816 #: ../src/guestfs-actions.pod:173 ../fish/guestfish-actions.pod:116
6817 msgid ""
6818 "If true then the image is treated as read-only.  Writes are still allowed, "
6819 "but they are stored in a temporary snapshot overlay which is discarded at "
6820 "the end.  The disk that you add is not modified."
6821 msgstr ""
6822
6823 # type: =item
6824 #. type: =item
6825 #: ../src/guestfs-actions.pod:177 ../fish/guestfish-actions.pod:120
6826 msgid "C<format>"
6827 msgstr ""
6828
6829 # type: textblock
6830 #. type: textblock
6831 #: ../src/guestfs-actions.pod:179
6832 msgid ""
6833 "This forces the image format.  If you omit this (or use C<guestfs_add_drive> "
6834 "or C<guestfs_add_drive_ro>) then the format is automatically detected.  "
6835 "Possible formats include C<raw> and C<qcow2>."
6836 msgstr ""
6837
6838 # type: textblock
6839 #. type: textblock
6840 #: ../src/guestfs-actions.pod:183 ../fish/guestfish-actions.pod:126
6841 msgid ""
6842 "Automatic detection of the format opens you up to a potential security hole "
6843 "when dealing with untrusted raw-format images.  See CVE-2010-3851 and "
6844 "RHBZ#642934.  Specifying the format closes this security hole."
6845 msgstr ""
6846
6847 # type: =item
6848 #. type: =item
6849 #: ../src/guestfs-actions.pod:188 ../fish/guestfish-actions.pod:131
6850 msgid "C<iface>"
6851 msgstr ""
6852
6853 # type: textblock
6854 #. type: textblock
6855 #: ../src/guestfs-actions.pod:190
6856 msgid ""
6857 "This rarely-used option lets you emulate the behaviour of the deprecated "
6858 "C<guestfs_add_drive_with_if> call (q.v.)"
6859 msgstr ""
6860
6861 # type: textblock
6862 #. type: textblock
6863 #: ../src/guestfs-actions.pod:197
6864 msgid "(Added in 1.5.23)"
6865 msgstr ""
6866
6867 # type: =head2
6868 #. type: =head2
6869 #: ../src/guestfs-actions.pod:199
6870 msgid "guestfs_add_drive_opts_va"
6871 msgstr ""
6872
6873 # type: verbatim
6874 #. type: verbatim
6875 #: ../src/guestfs-actions.pod:201
6876 #, no-wrap
6877 msgid ""
6878 " int\n"
6879 " guestfs_add_drive_opts_va (guestfs_h *g,\n"
6880 "                            const char *filename,\n"
6881 "                            va_list args);\n"
6882 "\n"
6883 msgstr ""
6884
6885 # type: textblock
6886 #. type: textblock
6887 #: ../src/guestfs-actions.pod:206
6888 msgid "This is the \"va_list variant\" of L</guestfs_add_drive_opts>."
6889 msgstr ""
6890
6891 # type: =head2
6892 #. type: =head2
6893 #: ../src/guestfs-actions.pod:210
6894 msgid "guestfs_add_drive_opts_argv"
6895 msgstr ""
6896
6897 # type: verbatim
6898 #. type: verbatim
6899 #: ../src/guestfs-actions.pod:212
6900 #, no-wrap
6901 msgid ""
6902 " int\n"
6903 " guestfs_add_drive_opts_argv (guestfs_h *g,\n"
6904 "                              const char *filename,\n"
6905 "                              const struct guestfs_add_drive_opts_argv *optargs);\n"
6906 "\n"
6907 msgstr ""
6908
6909 # type: textblock
6910 #. type: textblock
6911 #: ../src/guestfs-actions.pod:217
6912 msgid "This is the \"argv variant\" of L</guestfs_add_drive_opts>."
6913 msgstr ""
6914
6915 # type: =head2
6916 #. type: =head2
6917 #: ../src/guestfs-actions.pod:221
6918 msgid "guestfs_add_drive_ro"
6919 msgstr ""
6920
6921 # type: verbatim
6922 #. type: verbatim
6923 #: ../src/guestfs-actions.pod:223
6924 #, no-wrap
6925 msgid ""
6926 " int\n"
6927 " guestfs_add_drive_ro (guestfs_h *g,\n"
6928 "                       const char *filename);\n"
6929 "\n"
6930 msgstr ""
6931
6932 # type: textblock
6933 #. type: textblock
6934 #: ../src/guestfs-actions.pod:227
6935 msgid ""
6936 "This function is the equivalent of calling C<guestfs_add_drive_opts> with "
6937 "the optional parameter C<GUESTFS_ADD_DRIVE_OPTS_READONLY> set to 1, so the "
6938 "disk is added read-only, with the format being detected automatically."
6939 msgstr ""
6940
6941 # type: textblock
6942 #. type: textblock
6943 #: ../src/guestfs-actions.pod:234
6944 msgid "(Added in 1.0.38)"
6945 msgstr ""
6946
6947 # type: =head2
6948 #. type: =head2
6949 #: ../src/guestfs-actions.pod:236
6950 msgid "guestfs_add_drive_ro_with_if"
6951 msgstr ""
6952
6953 # type: verbatim
6954 #. type: verbatim
6955 #: ../src/guestfs-actions.pod:238
6956 #, no-wrap
6957 msgid ""
6958 " int\n"
6959 " guestfs_add_drive_ro_with_if (guestfs_h *g,\n"
6960 "                               const char *filename,\n"
6961 "                               const char *iface);\n"
6962 "\n"
6963 msgstr ""
6964
6965 # type: textblock
6966 #. type: textblock
6967 #: ../src/guestfs-actions.pod:243
6968 msgid ""
6969 "This is the same as C<guestfs_add_drive_ro> but it allows you to specify the "
6970 "QEMU interface emulation to use at run time."
6971 msgstr ""
6972
6973 # type: textblock
6974 #. type: textblock
6975 #: ../src/guestfs-actions.pod:255 ../src/guestfs-actions.pod:276
6976 #: ../src/guestfs-actions.pod:2353
6977 msgid "(Added in 1.0.84)"
6978 msgstr ""
6979
6980 # type: =head2
6981 #. type: =head2
6982 #: ../src/guestfs-actions.pod:257
6983 msgid "guestfs_add_drive_with_if"
6984 msgstr ""
6985
6986 # type: verbatim
6987 #. type: verbatim
6988 #: ../src/guestfs-actions.pod:259
6989 #, no-wrap
6990 msgid ""
6991 " int\n"
6992 " guestfs_add_drive_with_if (guestfs_h *g,\n"
6993 "                            const char *filename,\n"
6994 "                            const char *iface);\n"
6995 "\n"
6996 msgstr ""
6997
6998 # type: textblock
6999 #. type: textblock
7000 #: ../src/guestfs-actions.pod:264
7001 msgid ""
7002 "This is the same as C<guestfs_add_drive> but it allows you to specify the "
7003 "QEMU interface emulation to use at run time."
7004 msgstr ""
7005
7006 # type: =head2
7007 #. type: =head2
7008 #: ../src/guestfs-actions.pod:278
7009 msgid "guestfs_aug_clear"
7010 msgstr ""
7011
7012 # type: verbatim
7013 #. type: verbatim
7014 #: ../src/guestfs-actions.pod:280
7015 #, no-wrap
7016 msgid ""
7017 " int\n"
7018 " guestfs_aug_clear (guestfs_h *g,\n"
7019 "                    const char *augpath);\n"
7020 "\n"
7021 msgstr ""
7022
7023 # type: textblock
7024 #. type: textblock
7025 #: ../src/guestfs-actions.pod:284 ../fish/guestfish-actions.pod:183
7026 msgid ""
7027 "Set the value associated with C<path> to C<NULL>.  This is the same as the "
7028 "L<augtool(1)> C<clear> command."
7029 msgstr ""
7030
7031 # type: textblock
7032 #. type: textblock
7033 #: ../src/guestfs-actions.pod:289 ../src/guestfs-actions.pod:2103
7034 msgid "(Added in 1.3.4)"
7035 msgstr ""
7036
7037 # type: =head2
7038 #. type: =head2
7039 #: ../src/guestfs-actions.pod:291
7040 msgid "guestfs_aug_close"
7041 msgstr ""
7042
7043 # type: verbatim
7044 #. type: verbatim
7045 #: ../src/guestfs-actions.pod:293
7046 #, no-wrap
7047 msgid ""
7048 " int\n"
7049 " guestfs_aug_close (guestfs_h *g);\n"
7050 "\n"
7051 msgstr ""
7052
7053 # type: textblock
7054 #. type: textblock
7055 #: ../src/guestfs-actions.pod:296
7056 msgid ""
7057 "Close the current Augeas handle and free up any resources used by it.  After "
7058 "calling this, you have to call C<guestfs_aug_init> again before you can use "
7059 "any other Augeas functions."
7060 msgstr ""
7061
7062 # type: textblock
7063 #. type: textblock
7064 #: ../src/guestfs-actions.pod:303 ../src/guestfs-actions.pod:328
7065 #: ../src/guestfs-actions.pod:346 ../src/guestfs-actions.pod:360
7066 #: ../src/guestfs-actions.pod:418 ../src/guestfs-actions.pod:438
7067 #: ../src/guestfs-actions.pod:452 ../src/guestfs-actions.pod:483
7068 #: ../src/guestfs-actions.pod:497 ../src/guestfs-actions.pod:511
7069 #: ../src/guestfs-actions.pod:525 ../src/guestfs-actions.pod:543
7070 #: ../src/guestfs-actions.pod:5493
7071 msgid "(Added in 0.7)"
7072 msgstr ""
7073
7074 # type: =head2
7075 #. type: =head2
7076 #: ../src/guestfs-actions.pod:305
7077 msgid "guestfs_aug_defnode"
7078 msgstr ""
7079
7080 # type: verbatim
7081 #. type: verbatim
7082 #: ../src/guestfs-actions.pod:307
7083 #, no-wrap
7084 msgid ""
7085 " struct guestfs_int_bool *\n"
7086 " guestfs_aug_defnode (guestfs_h *g,\n"
7087 "                      const char *name,\n"
7088 "                      const char *expr,\n"
7089 "                      const char *val);\n"
7090 "\n"
7091 msgstr ""
7092
7093 # type: textblock
7094 #. type: textblock
7095 #: ../src/guestfs-actions.pod:313 ../fish/guestfish-actions.pod:199
7096 msgid ""
7097 "Defines a variable C<name> whose value is the result of evaluating C<expr>."
7098 msgstr ""
7099
7100 # type: textblock
7101 #. type: textblock
7102 #: ../src/guestfs-actions.pod:316
7103 msgid ""
7104 "If C<expr> evaluates to an empty nodeset, a node is created, equivalent to "
7105 "calling C<guestfs_aug_set> C<expr>, C<value>.  C<name> will be the nodeset "
7106 "containing that single node."
7107 msgstr ""
7108
7109 # type: textblock
7110 #. type: textblock
7111 #: ../src/guestfs-actions.pod:320 ../fish/guestfish-actions.pod:206
7112 msgid ""
7113 "On success this returns a pair containing the number of nodes in the "
7114 "nodeset, and a boolean flag if a node was created."
7115 msgstr ""
7116
7117 # type: textblock
7118 #. type: textblock
7119 #: ../src/guestfs-actions.pod:324
7120 msgid ""
7121 "This function returns a C<struct guestfs_int_bool *>, or NULL if there was "
7122 "an error.  I<The caller must call C<guestfs_free_int_bool> after use>."
7123 msgstr ""
7124
7125 # type: =head2
7126 #. type: =head2
7127 #: ../src/guestfs-actions.pod:330
7128 msgid "guestfs_aug_defvar"
7129 msgstr ""
7130
7131 # type: verbatim
7132 #. type: verbatim
7133 #: ../src/guestfs-actions.pod:332
7134 #, no-wrap
7135 msgid ""
7136 " int\n"
7137 " guestfs_aug_defvar (guestfs_h *g,\n"
7138 "                     const char *name,\n"
7139 "                     const char *expr);\n"
7140 "\n"
7141 msgstr ""
7142
7143 # type: textblock
7144 #. type: textblock
7145 #: ../src/guestfs-actions.pod:337 ../fish/guestfish-actions.pod:214
7146 msgid ""
7147 "Defines an Augeas variable C<name> whose value is the result of evaluating "
7148 "C<expr>.  If C<expr> is NULL, then C<name> is undefined."
7149 msgstr ""
7150
7151 # type: textblock
7152 #. type: textblock
7153 #: ../src/guestfs-actions.pod:341 ../fish/guestfish-actions.pod:218
7154 msgid ""
7155 "On success this returns the number of nodes in C<expr>, or C<0> if C<expr> "
7156 "evaluates to something which is not a nodeset."
7157 msgstr ""
7158
7159 # type: =head2
7160 #. type: =head2
7161 #: ../src/guestfs-actions.pod:348
7162 msgid "guestfs_aug_get"
7163 msgstr ""
7164
7165 # type: verbatim
7166 #. type: verbatim
7167 #: ../src/guestfs-actions.pod:350
7168 #, no-wrap
7169 msgid ""
7170 " char *\n"
7171 " guestfs_aug_get (guestfs_h *g,\n"
7172 "                  const char *augpath);\n"
7173 "\n"
7174 msgstr ""
7175
7176 # type: textblock
7177 #. type: textblock
7178 #: ../src/guestfs-actions.pod:354 ../fish/guestfish-actions.pod:225
7179 msgid ""
7180 "Look up the value associated with C<path>.  If C<path> matches exactly one "
7181 "node, the C<value> is returned."
7182 msgstr ""
7183
7184 # type: textblock
7185 #. type: textblock
7186 #: ../src/guestfs-actions.pod:357 ../src/guestfs-actions.pod:857
7187 #: ../src/guestfs-actions.pod:875 ../src/guestfs-actions.pod:935
7188 #: ../src/guestfs-actions.pod:951 ../src/guestfs-actions.pod:1054
7189 #: ../src/guestfs-actions.pod:1184 ../src/guestfs-actions.pod:1201
7190 #: ../src/guestfs-actions.pod:1220 ../src/guestfs-actions.pod:1354
7191 #: ../src/guestfs-actions.pod:1542 ../src/guestfs-actions.pod:1654
7192 #: ../src/guestfs-actions.pod:1817 ../src/guestfs-actions.pod:1834
7193 #: ../src/guestfs-actions.pod:1901 ../src/guestfs-actions.pod:1935
7194 #: ../src/guestfs-actions.pod:1956 ../src/guestfs-actions.pod:2126
7195 #: ../src/guestfs-actions.pod:2318 ../src/guestfs-actions.pod:2525
7196 #: ../src/guestfs-actions.pod:2618 ../src/guestfs-actions.pod:2729
7197 #: ../src/guestfs-actions.pod:2749 ../src/guestfs-actions.pod:2869
7198 #: ../src/guestfs-actions.pod:2900 ../src/guestfs-actions.pod:2924
7199 #: ../src/guestfs-actions.pod:2961 ../src/guestfs-actions.pod:3021
7200 #: ../src/guestfs-actions.pod:3044 ../src/guestfs-actions.pod:3065
7201 #: ../src/guestfs-actions.pod:3637 ../src/guestfs-actions.pod:3987
7202 #: ../src/guestfs-actions.pod:4157 ../src/guestfs-actions.pod:4267
7203 #: ../src/guestfs-actions.pod:5028 ../src/guestfs-actions.pod:5221
7204 #: ../src/guestfs-actions.pod:5391 ../src/guestfs-actions.pod:5569
7205 #: ../src/guestfs-actions.pod:5618 ../src/guestfs-actions.pod:6251
7206 #: ../src/guestfs-actions.pod:6267 ../src/guestfs-actions.pod:6284
7207 #: ../src/guestfs-actions.pod:6315 ../src/guestfs-actions.pod:6989
7208 #: ../src/guestfs-actions.pod:7008 ../src/guestfs-actions.pod:7026
7209 #: ../src/guestfs-actions.pod:7206 ../src/guestfs-actions.pod:7485
7210 msgid ""
7211 "This function returns a string, or NULL on error.  I<The caller must free "
7212 "the returned string after use>."
7213 msgstr ""
7214
7215 # type: =head2
7216 #. type: =head2
7217 #: ../src/guestfs-actions.pod:362
7218 msgid "guestfs_aug_init"
7219 msgstr ""
7220
7221 # type: verbatim
7222 #. type: verbatim
7223 #: ../src/guestfs-actions.pod:364
7224 #, no-wrap
7225 msgid ""
7226 " int\n"
7227 " guestfs_aug_init (guestfs_h *g,\n"
7228 "                   const char *root,\n"
7229 "                   int flags);\n"
7230 "\n"
7231 msgstr ""
7232
7233 # type: textblock
7234 #. type: textblock
7235 #: ../src/guestfs-actions.pod:369 ../fish/guestfish-actions.pod:232
7236 msgid ""
7237 "Create a new Augeas handle for editing configuration files.  If there was "
7238 "any previous Augeas handle associated with this guestfs session, then it is "
7239 "closed."
7240 msgstr ""
7241
7242 # type: textblock
7243 #. type: textblock
7244 #: ../src/guestfs-actions.pod:373
7245 msgid "You must call this before using any other C<guestfs_aug_*> commands."
7246 msgstr ""
7247
7248 # type: textblock
7249 #. type: textblock
7250 #: ../src/guestfs-actions.pod:376 ../fish/guestfish-actions.pod:239
7251 msgid ""
7252 "C<root> is the filesystem root.  C<root> must not be NULL, use C</> instead."
7253 msgstr ""
7254
7255 # type: textblock
7256 #. type: textblock
7257 #: ../src/guestfs-actions.pod:379 ../fish/guestfish-actions.pod:242
7258 msgid ""
7259 "The flags are the same as the flags defined in E<lt>augeas.hE<gt>, the "
7260 "logical I<or> of the following integers:"
7261 msgstr ""
7262
7263 # type: =item
7264 #. type: =item
7265 #: ../src/guestfs-actions.pod:385 ../fish/guestfish-actions.pod:248
7266 msgid "C<AUG_SAVE_BACKUP> = 1"
7267 msgstr ""
7268
7269 # type: textblock
7270 #. type: textblock
7271 #: ../src/guestfs-actions.pod:387 ../fish/guestfish-actions.pod:250
7272 msgid "Keep the original file with a C<.augsave> extension."
7273 msgstr ""
7274
7275 # type: =item
7276 #. type: =item
7277 #: ../src/guestfs-actions.pod:389 ../fish/guestfish-actions.pod:252
7278 msgid "C<AUG_SAVE_NEWFILE> = 2"
7279 msgstr ""
7280
7281 # type: textblock
7282 #. type: textblock
7283 #: ../src/guestfs-actions.pod:391 ../fish/guestfish-actions.pod:254
7284 msgid ""
7285 "Save changes into a file with extension C<.augnew>, and do not overwrite "
7286 "original.  Overrides C<AUG_SAVE_BACKUP>."
7287 msgstr ""
7288
7289 # type: =item
7290 #. type: =item
7291 #: ../src/guestfs-actions.pod:394 ../fish/guestfish-actions.pod:257
7292 msgid "C<AUG_TYPE_CHECK> = 4"
7293 msgstr ""
7294
7295 # type: textblock
7296 #. type: textblock
7297 #: ../src/guestfs-actions.pod:396 ../fish/guestfish-actions.pod:259
7298 msgid "Typecheck lenses (can be expensive)."
7299 msgstr ""
7300
7301 # type: =item
7302 #. type: =item
7303 #: ../src/guestfs-actions.pod:398 ../fish/guestfish-actions.pod:261
7304 msgid "C<AUG_NO_STDINC> = 8"
7305 msgstr ""
7306
7307 # type: textblock
7308 #. type: textblock
7309 #: ../src/guestfs-actions.pod:400 ../fish/guestfish-actions.pod:263
7310 msgid "Do not use standard load path for modules."
7311 msgstr ""
7312
7313 # type: =item
7314 #. type: =item
7315 #: ../src/guestfs-actions.pod:402 ../fish/guestfish-actions.pod:265
7316 msgid "C<AUG_SAVE_NOOP> = 16"
7317 msgstr ""
7318
7319 # type: textblock
7320 #. type: textblock
7321 #: ../src/guestfs-actions.pod:404 ../fish/guestfish-actions.pod:267
7322 msgid "Make save a no-op, just record what would have been changed."
7323 msgstr ""
7324
7325 # type: =item
7326 #. type: =item
7327 #: ../src/guestfs-actions.pod:406 ../fish/guestfish-actions.pod:269
7328 msgid "C<AUG_NO_LOAD> = 32"
7329 msgstr ""
7330
7331 # type: textblock
7332 #. type: textblock
7333 #: ../src/guestfs-actions.pod:408
7334 msgid "Do not load the tree in C<guestfs_aug_init>."
7335 msgstr ""
7336
7337 # type: textblock
7338 #. type: textblock
7339 #: ../src/guestfs-actions.pod:412
7340 msgid "To close the handle, you can call C<guestfs_aug_close>."
7341 msgstr ""
7342
7343 # type: textblock
7344 #. type: textblock
7345 #: ../src/guestfs-actions.pod:414 ../fish/guestfish-actions.pod:277
7346 msgid "To find out more about Augeas, see L<http://augeas.net/>."
7347 msgstr ""
7348
7349 # type: =head2
7350 #. type: =head2
7351 #: ../src/guestfs-actions.pod:420
7352 msgid "guestfs_aug_insert"
7353 msgstr ""
7354
7355 # type: verbatim
7356 #. type: verbatim
7357 #: ../src/guestfs-actions.pod:422
7358 #, no-wrap
7359 msgid ""
7360 " int\n"
7361 " guestfs_aug_insert (guestfs_h *g,\n"
7362 "                     const char *augpath,\n"
7363 "                     const char *label,\n"
7364 "                     int before);\n"
7365 "\n"
7366 msgstr ""
7367
7368 # type: textblock
7369 #. type: textblock
7370 #: ../src/guestfs-actions.pod:428 ../fish/guestfish-actions.pod:283
7371 msgid ""
7372 "Create a new sibling C<label> for C<path>, inserting it into the tree before "
7373 "or after C<path> (depending on the boolean flag C<before>)."
7374 msgstr ""
7375
7376 # type: textblock
7377 #. type: textblock
7378 #: ../src/guestfs-actions.pod:432 ../fish/guestfish-actions.pod:287
7379 msgid ""
7380 "C<path> must match exactly one existing node in the tree, and C<label> must "
7381 "be a label, ie. not contain C</>, C<*> or end with a bracketed index C<[N]>."
7382 msgstr ""
7383
7384 # type: =head2
7385 #. type: =head2
7386 #: ../src/guestfs-actions.pod:440
7387 msgid "guestfs_aug_load"
7388 msgstr ""
7389
7390 # type: verbatim
7391 #. type: verbatim
7392 #: ../src/guestfs-actions.pod:442
7393 #, no-wrap
7394 msgid ""
7395 " int\n"
7396 " guestfs_aug_load (guestfs_h *g);\n"
7397 "\n"
7398 msgstr ""
7399
7400 # type: textblock
7401 #. type: textblock
7402 #: ../src/guestfs-actions.pod:445 ../fish/guestfish-actions.pod:295
7403 msgid "Load files into the tree."
7404 msgstr ""
7405
7406 # type: textblock
7407 #. type: textblock
7408 #: ../src/guestfs-actions.pod:447 ../fish/guestfish-actions.pod:297
7409 msgid "See C<aug_load> in the Augeas documentation for the full gory details."
7410 msgstr ""
7411
7412 # type: =head2
7413 #. type: =head2
7414 #: ../src/guestfs-actions.pod:454
7415 msgid "guestfs_aug_ls"
7416 msgstr ""
7417
7418 # type: verbatim
7419 #. type: verbatim
7420 #: ../src/guestfs-actions.pod:456
7421 #, no-wrap
7422 msgid ""
7423 " char **\n"
7424 " guestfs_aug_ls (guestfs_h *g,\n"
7425 "                 const char *augpath);\n"
7426 "\n"
7427 msgstr ""
7428
7429 # type: textblock
7430 #. type: textblock
7431 #: ../src/guestfs-actions.pod:460
7432 msgid ""
7433 "This is just a shortcut for listing C<guestfs_aug_match> C<path/*> and "
7434 "sorting the resulting nodes into alphabetical order."
7435 msgstr ""
7436
7437 # type: textblock
7438 #. type: textblock
7439 #: ../src/guestfs-actions.pod:463 ../src/guestfs-actions.pod:479
7440 #: ../src/guestfs-actions.pod:625 ../src/guestfs-actions.pod:1073
7441 #: ../src/guestfs-actions.pod:1369 ../src/guestfs-actions.pod:1388
7442 #: ../src/guestfs-actions.pod:1491 ../src/guestfs-actions.pod:1510
7443 #: ../src/guestfs-actions.pod:1756 ../src/guestfs-actions.pod:2198
7444 #: ../src/guestfs-actions.pod:2214 ../src/guestfs-actions.pod:2233
7445 #: ../src/guestfs-actions.pod:2276 ../src/guestfs-actions.pod:2300
7446 #: ../src/guestfs-actions.pod:2371 ../src/guestfs-actions.pod:2420
7447 #: ../src/guestfs-actions.pod:2687 ../src/guestfs-actions.pod:2978
7448 #: ../src/guestfs-actions.pod:3267 ../src/guestfs-actions.pod:3557
7449 #: ../src/guestfs-actions.pod:3619 ../src/guestfs-actions.pod:3724
7450 #: ../src/guestfs-actions.pod:4129 ../src/guestfs-actions.pod:4834
7451 #: ../src/guestfs-actions.pod:5363 ../src/guestfs-actions.pod:5489
7452 #: ../src/guestfs-actions.pod:5603 ../src/guestfs-actions.pod:6331
7453 #: ../src/guestfs-actions.pod:6392 ../src/guestfs-actions.pod:6447
7454 #: ../src/guestfs-actions.pod:6593 ../src/guestfs-actions.pod:6617
7455 #: ../src/guestfs-actions.pod:7099 ../src/guestfs-actions.pod:7119
7456 #: ../src/guestfs-actions.pod:7166 ../src/guestfs-actions.pod:7338
7457 #: ../src/guestfs-actions.pod:7357 ../src/guestfs-actions.pod:7442
7458 #: ../src/guestfs-actions.pod:7461 ../src/guestfs-actions.pod:7507
7459 #: ../src/guestfs-actions.pod:7526
7460 msgid ""
7461 "This function returns a NULL-terminated array of strings (like L<environ(3)"
7462 ">), or NULL if there was an error.  I<The caller must free the strings and "
7463 "the array after use>."
7464 msgstr ""
7465
7466 # type: textblock
7467 #. type: textblock
7468 #: ../src/guestfs-actions.pod:467 ../src/guestfs-actions.pod:998
7469 #: ../src/guestfs-actions.pod:1016 ../src/guestfs-actions.pod:1426
7470 #: ../src/guestfs-actions.pod:3345 ../src/guestfs-actions.pod:3376
7471 #: ../src/guestfs-actions.pod:3970 ../src/guestfs-actions.pod:4020
7472 #: ../src/guestfs-actions.pod:4207 ../src/guestfs-actions.pod:4240
7473 #: ../src/guestfs-actions.pod:4403 ../src/guestfs-actions.pod:4838
7474 #: ../src/guestfs-actions.pod:5304 ../src/guestfs-actions.pod:5699
7475 #: ../src/guestfs-actions.pod:5713 ../src/guestfs-actions.pod:5725
7476 #: ../src/guestfs-actions.pod:6172 ../src/guestfs-actions.pod:6831
7477 #: ../src/guestfs-actions.pod:6844 ../src/guestfs-actions.pod:7083
7478 #: ../src/guestfs-actions.pod:7326
7479 msgid "(Added in 0.8)"
7480 msgstr ""
7481
7482 # type: =head2
7483 #. type: =head2
7484 #: ../src/guestfs-actions.pod:469
7485 msgid "guestfs_aug_match"
7486 msgstr ""
7487
7488 # type: verbatim
7489 #. type: verbatim
7490 #: ../src/guestfs-actions.pod:471
7491 #, no-wrap
7492 msgid ""
7493 " char **\n"
7494 " guestfs_aug_match (guestfs_h *g,\n"
7495 "                    const char *augpath);\n"
7496 "\n"
7497 msgstr ""
7498
7499 # type: textblock
7500 #. type: textblock
7501 #: ../src/guestfs-actions.pod:475 ../fish/guestfish-actions.pod:311
7502 msgid ""
7503 "Returns a list of paths which match the path expression C<path>.  The "
7504 "returned paths are sufficiently qualified so that they match exactly one "
7505 "node in the current tree."
7506 msgstr ""
7507
7508 # type: =head2
7509 #. type: =head2
7510 #: ../src/guestfs-actions.pod:485
7511 msgid "guestfs_aug_mv"
7512 msgstr ""
7513
7514 # type: verbatim
7515 #. type: verbatim
7516 #: ../src/guestfs-actions.pod:487
7517 #, no-wrap
7518 msgid ""
7519 " int\n"
7520 " guestfs_aug_mv (guestfs_h *g,\n"
7521 "                 const char *src,\n"
7522 "                 const char *dest);\n"
7523 "\n"
7524 msgstr ""
7525
7526 # type: textblock
7527 #. type: textblock
7528 #: ../src/guestfs-actions.pod:492 ../fish/guestfish-actions.pod:319
7529 msgid ""
7530 "Move the node C<src> to C<dest>.  C<src> must match exactly one node.  "
7531 "C<dest> is overwritten if it exists."
7532 msgstr ""
7533
7534 # type: =head2
7535 #. type: =head2
7536 #: ../src/guestfs-actions.pod:499
7537 msgid "guestfs_aug_rm"
7538 msgstr ""
7539
7540 # type: verbatim
7541 #. type: verbatim
7542 #: ../src/guestfs-actions.pod:501
7543 #, no-wrap
7544 msgid ""
7545 " int\n"
7546 " guestfs_aug_rm (guestfs_h *g,\n"
7547 "                 const char *augpath);\n"
7548 "\n"
7549 msgstr ""
7550
7551 # type: textblock
7552 #. type: textblock
7553 #: ../src/guestfs-actions.pod:505 ../fish/guestfish-actions.pod:326
7554 msgid "Remove C<path> and all of its children."
7555 msgstr ""
7556
7557 # type: textblock
7558 #. type: textblock
7559 #: ../src/guestfs-actions.pod:507 ../fish/guestfish-actions.pod:328
7560 msgid "On success this returns the number of entries which were removed."
7561 msgstr ""
7562
7563 # type: =head2
7564 #. type: =head2
7565 #: ../src/guestfs-actions.pod:513
7566 msgid "guestfs_aug_save"
7567 msgstr ""
7568
7569 # type: verbatim
7570 #. type: verbatim
7571 #: ../src/guestfs-actions.pod:515
7572 #, no-wrap
7573 msgid ""
7574 " int\n"
7575 " guestfs_aug_save (guestfs_h *g);\n"
7576 "\n"
7577 msgstr ""
7578
7579 # type: textblock
7580 #. type: textblock
7581 #: ../src/guestfs-actions.pod:518 ../fish/guestfish-actions.pod:334
7582 msgid "This writes all pending changes to disk."
7583 msgstr ""
7584
7585 # type: textblock
7586 #. type: textblock
7587 #: ../src/guestfs-actions.pod:520
7588 msgid ""
7589 "The flags which were passed to C<guestfs_aug_init> affect exactly how files "
7590 "are saved."
7591 msgstr ""
7592
7593 # type: =head2
7594 #. type: =head2
7595 #: ../src/guestfs-actions.pod:527
7596 msgid "guestfs_aug_set"
7597 msgstr ""
7598
7599 # type: verbatim
7600 #. type: verbatim
7601 #: ../src/guestfs-actions.pod:529
7602 #, no-wrap
7603 msgid ""
7604 " int\n"
7605 " guestfs_aug_set (guestfs_h *g,\n"
7606 "                  const char *augpath,\n"
7607 "                  const char *val);\n"
7608 "\n"
7609 msgstr ""
7610
7611 # type: textblock
7612 #. type: textblock
7613 #: ../src/guestfs-actions.pod:534 ../fish/guestfish-actions.pod:343
7614 msgid "Set the value associated with C<path> to C<val>."
7615 msgstr ""
7616
7617 # type: textblock
7618 #. type: textblock
7619 #: ../src/guestfs-actions.pod:536
7620 msgid ""
7621 "In the Augeas API, it is possible to clear a node by setting the value to "
7622 "NULL.  Due to an oversight in the libguestfs API you cannot do that with "
7623 "this call.  Instead you must use the C<guestfs_aug_clear> call."
7624 msgstr ""
7625
7626 # type: =head2
7627 #. type: =head2
7628 #: ../src/guestfs-actions.pod:545
7629 msgid "guestfs_available"
7630 msgstr ""
7631
7632 # type: verbatim
7633 #. type: verbatim
7634 #: ../src/guestfs-actions.pod:547
7635 #, no-wrap
7636 msgid ""
7637 " int\n"
7638 " guestfs_available (guestfs_h *g,\n"
7639 "                    char *const *groups);\n"
7640 "\n"
7641 msgstr ""
7642
7643 # type: textblock
7644 #. type: textblock
7645 #: ../src/guestfs-actions.pod:551 ../fish/guestfish-actions.pod:354
7646 msgid ""
7647 "This command is used to check the availability of some groups of "
7648 "functionality in the appliance, which not all builds of the libguestfs "
7649 "appliance will be able to provide."
7650 msgstr ""
7651
7652 # type: textblock
7653 #. type: textblock
7654 #: ../src/guestfs-actions.pod:555
7655 msgid ""
7656 "The libguestfs groups, and the functions that those groups correspond to, "
7657 "are listed in L<guestfs(3)/AVAILABILITY>.  You can also fetch this list at "
7658 "runtime by calling C<guestfs_available_all_groups>."
7659 msgstr ""
7660
7661 # type: textblock
7662 #. type: textblock
7663 #: ../src/guestfs-actions.pod:560 ../fish/guestfish-actions.pod:363
7664 msgid ""
7665 "The argument C<groups> is a list of group names, eg: C<[\"inotify\", \"augeas"
7666 "\"]> would check for the availability of the Linux inotify functions and "
7667 "Augeas (configuration file editing) functions."
7668 msgstr ""
7669
7670 # type: textblock
7671 #. type: textblock
7672 #: ../src/guestfs-actions.pod:565 ../fish/guestfish-actions.pod:368
7673 msgid "The command returns no error if I<all> requested groups are available."
7674 msgstr ""
7675
7676 # type: textblock
7677 #. type: textblock
7678 #: ../src/guestfs-actions.pod:567 ../fish/guestfish-actions.pod:370
7679 msgid ""
7680 "It fails with an error if one or more of the requested groups is unavailable "
7681 "in the appliance."
7682 msgstr ""
7683
7684 # type: textblock
7685 #. type: textblock
7686 #: ../src/guestfs-actions.pod:570 ../fish/guestfish-actions.pod:373
7687 msgid ""
7688 "If an unknown group name is included in the list of groups then an error is "
7689 "always returned."
7690 msgstr ""
7691
7692 # type: textblock
7693 #. type: textblock
7694 #: ../src/guestfs-actions.pod:573 ../fish/guestfish-actions.pod:376
7695 msgid "I<Notes:>"
7696 msgstr ""
7697
7698 # type: textblock
7699 #. type: textblock
7700 #: ../src/guestfs-actions.pod:579
7701 msgid "You must call C<guestfs_launch> before calling this function."
7702 msgstr ""
7703
7704 # type: textblock
7705 #. type: textblock
7706 #: ../src/guestfs-actions.pod:581 ../fish/guestfish-actions.pod:384
7707 msgid ""
7708 "The reason is because we don't know what groups are supported by the "
7709 "appliance/daemon until it is running and can be queried."
7710 msgstr ""
7711
7712 # type: textblock
7713 #. type: textblock
7714 #: ../src/guestfs-actions.pod:587 ../fish/guestfish-actions.pod:390
7715 msgid ""
7716 "If a group of functions is available, this does not necessarily mean that "
7717 "they will work.  You still have to check for errors when calling individual "
7718 "API functions even if they are available."
7719 msgstr ""
7720
7721 # type: textblock
7722 #. type: textblock
7723 #: ../src/guestfs-actions.pod:594 ../fish/guestfish-actions.pod:397
7724 msgid ""
7725 "It is usually the job of distro packagers to build complete functionality "
7726 "into the libguestfs appliance.  Upstream libguestfs, if built from source "
7727 "with all requirements satisfied, will support everything."
7728 msgstr ""
7729
7730 # type: textblock
7731 #. type: textblock
7732 #: ../src/guestfs-actions.pod:601
7733 msgid ""
7734 "This call was added in version C<1.0.80>.  In previous versions of "
7735 "libguestfs all you could do would be to speculatively execute a command to "
7736 "find out if the daemon implemented it.  See also C<guestfs_version>."
7737 msgstr ""
7738
7739 # type: textblock
7740 #. type: textblock
7741 #: ../src/guestfs-actions.pod:610 ../src/guestfs-actions.pod:1171
7742 msgid "(Added in 1.0.80)"
7743 msgstr ""
7744
7745 # type: =head2
7746 #. type: =head2
7747 #: ../src/guestfs-actions.pod:612
7748 msgid "guestfs_available_all_groups"
7749 msgstr ""
7750
7751 # type: verbatim
7752 #. type: verbatim
7753 #: ../src/guestfs-actions.pod:614
7754 #, no-wrap
7755 msgid ""
7756 " char **\n"
7757 " guestfs_available_all_groups (guestfs_h *g);\n"
7758 "\n"
7759 msgstr ""
7760
7761 # type: textblock
7762 #. type: textblock
7763 #: ../src/guestfs-actions.pod:617
7764 msgid ""
7765 "This command returns a list of all optional groups that this daemon knows "
7766 "about.  Note this returns both supported and unsupported groups.  To find "
7767 "out which ones the daemon can actually support you have to call "
7768 "C<guestfs_available> on each member of the returned list."
7769 msgstr ""
7770
7771 # type: textblock
7772 #. type: textblock
7773 #: ../src/guestfs-actions.pod:623
7774 msgid "See also C<guestfs_available> and L<guestfs(3)/AVAILABILITY>."
7775 msgstr ""
7776
7777 # type: textblock
7778 #. type: textblock
7779 #: ../src/guestfs-actions.pod:629
7780 msgid "(Added in 1.3.15)"
7781 msgstr ""
7782
7783 # type: =head2
7784 #. type: =head2
7785 #: ../src/guestfs-actions.pod:631
7786 msgid "guestfs_base64_in"
7787 msgstr ""
7788
7789 # type: verbatim
7790 #. type: verbatim
7791 #: ../src/guestfs-actions.pod:633
7792 #, no-wrap
7793 msgid ""
7794 " int\n"
7795 " guestfs_base64_in (guestfs_h *g,\n"
7796 "                    const char *base64file,\n"
7797 "                    const char *filename);\n"
7798 "\n"
7799 msgstr ""
7800
7801 # type: textblock
7802 #. type: textblock
7803 #: ../src/guestfs-actions.pod:638 ../fish/guestfish-actions.pod:427
7804 msgid ""
7805 "This command uploads base64-encoded data from C<base64file> to C<filename>."
7806 msgstr ""
7807
7808 # type: textblock
7809 #. type: textblock
7810 #: ../src/guestfs-actions.pod:643 ../src/guestfs-actions.pod:657
7811 msgid "(Added in 1.3.5)"
7812 msgstr ""
7813
7814 # type: =head2
7815 #. type: =head2
7816 #: ../src/guestfs-actions.pod:645
7817 msgid "guestfs_base64_out"
7818 msgstr ""
7819
7820 # type: verbatim
7821 #. type: verbatim
7822 #: ../src/guestfs-actions.pod:647
7823 #, no-wrap
7824 msgid ""
7825 " int\n"
7826 " guestfs_base64_out (guestfs_h *g,\n"
7827 "                     const char *filename,\n"
7828 "                     const char *base64file);\n"
7829 "\n"
7830 msgstr ""
7831
7832 # type: textblock
7833 #. type: textblock
7834 #: ../src/guestfs-actions.pod:652 ../fish/guestfish-actions.pod:436
7835 msgid ""
7836 "This command downloads the contents of C<filename>, writing it out to local "
7837 "file C<base64file> encoded as base64."
7838 msgstr ""
7839
7840 # type: =head2
7841 #. type: =head2
7842 #: ../src/guestfs-actions.pod:659
7843 msgid "guestfs_blockdev_flushbufs"
7844 msgstr ""
7845
7846 # type: verbatim
7847 #. type: verbatim
7848 #: ../src/guestfs-actions.pod:661
7849 #, no-wrap
7850 msgid ""
7851 " int\n"
7852 " guestfs_blockdev_flushbufs (guestfs_h *g,\n"
7853 "                             const char *device);\n"
7854 "\n"
7855 msgstr ""
7856
7857 # type: textblock
7858 #. type: textblock
7859 #: ../src/guestfs-actions.pod:665 ../fish/guestfish-actions.pod:445
7860 msgid ""
7861 "This tells the kernel to flush internal buffers associated with C<device>."
7862 msgstr ""
7863
7864 # type: textblock
7865 #. type: textblock
7866 #: ../src/guestfs-actions.pod:668 ../src/guestfs-actions.pod:685
7867 #: ../src/guestfs-actions.pod:700 ../src/guestfs-actions.pod:716
7868 #: ../src/guestfs-actions.pod:734 ../src/guestfs-actions.pod:753
7869 #: ../src/guestfs-actions.pod:767 ../src/guestfs-actions.pod:785
7870 #: ../src/guestfs-actions.pod:799 ../src/guestfs-actions.pod:813
7871 #: ../fish/guestfish-actions.pod:448 ../fish/guestfish-actions.pod:459
7872 #: ../fish/guestfish-actions.pod:468 ../fish/guestfish-actions.pod:478
7873 #: ../fish/guestfish-actions.pod:490 ../fish/guestfish-actions.pod:503
7874 #: ../fish/guestfish-actions.pod:511 ../fish/guestfish-actions.pod:522
7875 #: ../fish/guestfish-actions.pod:530 ../fish/guestfish-actions.pod:538
7876 msgid "This uses the L<blockdev(8)> command."
7877 msgstr ""
7878
7879 # type: textblock
7880 #. type: textblock
7881 #: ../src/guestfs-actions.pod:672 ../src/guestfs-actions.pod:689
7882 #: ../src/guestfs-actions.pod:704 ../src/guestfs-actions.pod:720
7883 #: ../src/guestfs-actions.pod:738 ../src/guestfs-actions.pod:757
7884 #: ../src/guestfs-actions.pod:771 ../src/guestfs-actions.pod:789
7885 #: ../src/guestfs-actions.pod:803 ../src/guestfs-actions.pod:817
7886 msgid "(Added in 0.9.3)"
7887 msgstr ""
7888
7889 # type: =head2
7890 #. type: =head2
7891 #: ../src/guestfs-actions.pod:674
7892 msgid "guestfs_blockdev_getbsz"
7893 msgstr ""
7894
7895 # type: verbatim
7896 #. type: verbatim
7897 #: ../src/guestfs-actions.pod:676
7898 #, no-wrap
7899 msgid ""
7900 " int\n"
7901 " guestfs_blockdev_getbsz (guestfs_h *g,\n"
7902 "                          const char *device);\n"
7903 "\n"
7904 msgstr ""
7905
7906 # type: textblock
7907 #. type: textblock
7908 #: ../src/guestfs-actions.pod:680 ../fish/guestfish-actions.pod:454
7909 msgid "This returns the block size of a device."
7910 msgstr ""
7911
7912 # type: textblock
7913 #. type: textblock
7914 #: ../src/guestfs-actions.pod:682 ../src/guestfs-actions.pod:782
7915 #: ../fish/guestfish-actions.pod:456 ../fish/guestfish-actions.pod:519
7916 msgid ""
7917 "(Note this is different from both I<size in blocks> and I<filesystem block "
7918 "size>)."
7919 msgstr ""
7920
7921 # type: =head2
7922 #. type: =head2
7923 #: ../src/guestfs-actions.pod:691
7924 msgid "guestfs_blockdev_getro"
7925 msgstr ""
7926
7927 # type: verbatim
7928 #. type: verbatim
7929 #: ../src/guestfs-actions.pod:693
7930 #, no-wrap
7931 msgid ""
7932 " int\n"
7933 " guestfs_blockdev_getro (guestfs_h *g,\n"
7934 "                         const char *device);\n"
7935 "\n"
7936 msgstr ""
7937
7938 # type: textblock
7939 #. type: textblock
7940 #: ../src/guestfs-actions.pod:697 ../fish/guestfish-actions.pod:465
7941 msgid ""
7942 "Returns a boolean indicating if the block device is read-only (true if read-"
7943 "only, false if not)."
7944 msgstr ""
7945
7946 # type: textblock
7947 #. type: textblock
7948 #: ../src/guestfs-actions.pod:702 ../src/guestfs-actions.pod:1409
7949 #: ../src/guestfs-actions.pod:1424 ../src/guestfs-actions.pod:1911
7950 #: ../src/guestfs-actions.pod:1922 ../src/guestfs-actions.pod:1994
7951 #: ../src/guestfs-actions.pod:2049 ../src/guestfs-actions.pod:2064
7952 #: ../src/guestfs-actions.pod:2089 ../src/guestfs-actions.pod:2112
7953 #: ../src/guestfs-actions.pod:3085 ../src/guestfs-actions.pod:3102
7954 #: ../src/guestfs-actions.pod:3121 ../src/guestfs-actions.pod:3284
7955 #: ../src/guestfs-actions.pod:3298 ../src/guestfs-actions.pod:3313
7956 #: ../src/guestfs-actions.pod:3327 ../src/guestfs-actions.pod:3343
7957 #: ../src/guestfs-actions.pod:3358 ../src/guestfs-actions.pod:3374
7958 #: ../src/guestfs-actions.pod:3388 ../src/guestfs-actions.pod:3401
7959 #: ../src/guestfs-actions.pod:3415 ../src/guestfs-actions.pod:3430
7960 #: ../src/guestfs-actions.pod:3445 ../src/guestfs-actions.pod:4992
7961 msgid "This function returns a C truth value on success or -1 on error."
7962 msgstr ""
7963
7964 # type: =head2
7965 #. type: =head2
7966 #: ../src/guestfs-actions.pod:706
7967 msgid "guestfs_blockdev_getsize64"
7968 msgstr ""
7969
7970 # type: verbatim
7971 #. type: verbatim
7972 #: ../src/guestfs-actions.pod:708
7973 #, no-wrap
7974 msgid ""
7975 " int64_t\n"
7976 " guestfs_blockdev_getsize64 (guestfs_h *g,\n"
7977 "                             const char *device);\n"
7978 "\n"
7979 msgstr ""
7980
7981 # type: textblock
7982 #. type: textblock
7983 #: ../src/guestfs-actions.pod:712 ../fish/guestfish-actions.pod:474
7984 msgid "This returns the size of the device in bytes."
7985 msgstr ""
7986
7987 # type: textblock
7988 #. type: textblock
7989 #: ../src/guestfs-actions.pod:714
7990 msgid "See also C<guestfs_blockdev_getsz>."
7991 msgstr ""
7992
7993 # type: =head2
7994 #. type: =head2
7995 #: ../src/guestfs-actions.pod:722
7996 msgid "guestfs_blockdev_getss"
7997 msgstr ""
7998
7999 # type: verbatim
8000 #. type: verbatim
8001 #: ../src/guestfs-actions.pod:724
8002 #, no-wrap
8003 msgid ""
8004 " int\n"
8005 " guestfs_blockdev_getss (guestfs_h *g,\n"
8006 "                         const char *device);\n"
8007 "\n"
8008 msgstr ""
8009
8010 # type: textblock
8011 #. type: textblock
8012 #: ../src/guestfs-actions.pod:728 ../fish/guestfish-actions.pod:484
8013 msgid ""
8014 "This returns the size of sectors on a block device.  Usually 512, but can be "
8015 "larger for modern devices."
8016 msgstr ""
8017
8018 # type: textblock
8019 #. type: textblock
8020 #: ../src/guestfs-actions.pod:731
8021 msgid ""
8022 "(Note, this is not the size in sectors, use C<guestfs_blockdev_getsz> for "
8023 "that)."
8024 msgstr ""
8025
8026 # type: =head2
8027 #. type: =head2
8028 #: ../src/guestfs-actions.pod:740
8029 msgid "guestfs_blockdev_getsz"
8030 msgstr ""
8031
8032 # type: verbatim
8033 #. type: verbatim
8034 #: ../src/guestfs-actions.pod:742
8035 #, no-wrap
8036 msgid ""
8037 " int64_t\n"
8038 " guestfs_blockdev_getsz (guestfs_h *g,\n"
8039 "                         const char *device);\n"
8040 "\n"
8041 msgstr ""
8042
8043 # type: textblock
8044 #. type: textblock
8045 #: ../src/guestfs-actions.pod:746 ../fish/guestfish-actions.pod:496
8046 msgid ""
8047 "This returns the size of the device in units of 512-byte sectors (even if "
8048 "the sectorsize isn't 512 bytes ... weird)."
8049 msgstr ""
8050
8051 # type: textblock
8052 #. type: textblock
8053 #: ../src/guestfs-actions.pod:749
8054 msgid ""
8055 "See also C<guestfs_blockdev_getss> for the real sector size of the device, "
8056 "and C<guestfs_blockdev_getsize64> for the more useful I<size in bytes>."
8057 msgstr ""
8058
8059 # type: =head2
8060 #. type: =head2
8061 #: ../src/guestfs-actions.pod:759
8062 msgid "guestfs_blockdev_rereadpt"
8063 msgstr ""
8064
8065 # type: verbatim
8066 #. type: verbatim
8067 #: ../src/guestfs-actions.pod:761
8068 #, no-wrap
8069 msgid ""
8070 " int\n"
8071 " guestfs_blockdev_rereadpt (guestfs_h *g,\n"
8072 "                            const char *device);\n"
8073 "\n"
8074 msgstr ""
8075
8076 # type: textblock
8077 #. type: textblock
8078 #: ../src/guestfs-actions.pod:765 ../fish/guestfish-actions.pod:509
8079 msgid "Reread the partition table on C<device>."
8080 msgstr ""
8081
8082 # type: =head2
8083 #. type: =head2
8084 #: ../src/guestfs-actions.pod:773
8085 msgid "guestfs_blockdev_setbsz"
8086 msgstr ""
8087
8088 # type: verbatim
8089 #. type: verbatim
8090 #: ../src/guestfs-actions.pod:775
8091 #, no-wrap
8092 msgid ""
8093 " int\n"
8094 " guestfs_blockdev_setbsz (guestfs_h *g,\n"
8095 "                          const char *device,\n"
8096 "                          int blocksize);\n"
8097 "\n"
8098 msgstr ""
8099
8100 # type: textblock
8101 #. type: textblock
8102 #: ../src/guestfs-actions.pod:780 ../fish/guestfish-actions.pod:517
8103 msgid "This sets the block size of a device."
8104 msgstr ""
8105
8106 # type: =head2
8107 #. type: =head2
8108 #: ../src/guestfs-actions.pod:791
8109 msgid "guestfs_blockdev_setro"
8110 msgstr ""
8111
8112 # type: verbatim
8113 #. type: verbatim
8114 #: ../src/guestfs-actions.pod:793
8115 #, no-wrap
8116 msgid ""
8117 " int\n"
8118 " guestfs_blockdev_setro (guestfs_h *g,\n"
8119 "                         const char *device);\n"
8120 "\n"
8121 msgstr ""
8122
8123 # type: textblock
8124 #. type: textblock
8125 #: ../src/guestfs-actions.pod:797 ../fish/guestfish-actions.pod:528
8126 msgid "Sets the block device named C<device> to read-only."
8127 msgstr ""
8128
8129 # type: =head2
8130 #. type: =head2
8131 #: ../src/guestfs-actions.pod:805
8132 msgid "guestfs_blockdev_setrw"
8133 msgstr ""
8134
8135 # type: verbatim
8136 #. type: verbatim
8137 #: ../src/guestfs-actions.pod:807
8138 #, no-wrap
8139 msgid ""
8140 " int\n"
8141 " guestfs_blockdev_setrw (guestfs_h *g,\n"
8142 "                         const char *device);\n"
8143 "\n"
8144 msgstr ""
8145
8146 # type: textblock
8147 #. type: textblock
8148 #: ../src/guestfs-actions.pod:811 ../fish/guestfish-actions.pod:536
8149 msgid "Sets the block device named C<device> to read-write."
8150 msgstr ""
8151
8152 # type: =head2
8153 #. type: =head2
8154 #: ../src/guestfs-actions.pod:819
8155 msgid "guestfs_case_sensitive_path"
8156 msgstr ""
8157
8158 # type: verbatim
8159 #. type: verbatim
8160 #: ../src/guestfs-actions.pod:821
8161 #, no-wrap
8162 msgid ""
8163 " char *\n"
8164 " guestfs_case_sensitive_path (guestfs_h *g,\n"
8165 "                              const char *path);\n"
8166 "\n"
8167 msgstr ""
8168
8169 # type: textblock
8170 #. type: textblock
8171 #: ../src/guestfs-actions.pod:825 ../fish/guestfish-actions.pod:544
8172 msgid ""
8173 "This can be used to resolve case insensitive paths on a filesystem which is "
8174 "case sensitive.  The use case is to resolve paths which you have read from "
8175 "Windows configuration files or the Windows Registry, to the true path."
8176 msgstr ""
8177
8178 # type: textblock
8179 #. type: textblock
8180 #: ../src/guestfs-actions.pod:830 ../fish/guestfish-actions.pod:549
8181 msgid ""
8182 "The command handles a peculiarity of the Linux ntfs-3g filesystem driver "
8183 "(and probably others), which is that although the underlying filesystem is "
8184 "case-insensitive, the driver exports the filesystem to Linux as case-"
8185 "sensitive."
8186 msgstr ""
8187
8188 # type: textblock
8189 #. type: textblock
8190 #: ../src/guestfs-actions.pod:835 ../fish/guestfish-actions.pod:554
8191 msgid ""
8192 "One consequence of this is that special directories such as C<c:\\windows> "
8193 "may appear as C</WINDOWS> or C</windows> (or other things) depending on the "
8194 "precise details of how they were created.  In Windows itself this would not "
8195 "be a problem."
8196 msgstr ""
8197
8198 # type: textblock
8199 #. type: textblock
8200 #: ../src/guestfs-actions.pod:841 ../fish/guestfish-actions.pod:560
8201 msgid ""
8202 "Bug or feature? You decide: L<http://www.tuxera.com/community/ntfs-3g-faq/"
8203 "#posixfilenames1>"
8204 msgstr ""
8205
8206 # type: textblock
8207 #. type: textblock
8208 #: ../src/guestfs-actions.pod:844 ../fish/guestfish-actions.pod:563
8209 msgid ""
8210 "This function resolves the true case of each element in the path and returns "
8211 "the case-sensitive path."
8212 msgstr ""
8213
8214 # type: textblock
8215 #. type: textblock
8216 #: ../src/guestfs-actions.pod:847
8217 msgid ""
8218 "Thus C<guestfs_case_sensitive_path> (\"/Windows/System32\")  might return C<"
8219 "\"/WINDOWS/system32\"> (the exact return value would depend on details of "
8220 "how the directories were originally created under Windows)."
8221 msgstr ""
8222
8223 # type: textblock
8224 #. type: textblock
8225 #: ../src/guestfs-actions.pod:852 ../fish/guestfish-actions.pod:571
8226 msgid "I<Note>: This function does not handle drive names, backslashes etc."
8227 msgstr ""
8228
8229 # type: textblock
8230 #. type: textblock
8231 #: ../src/guestfs-actions.pod:855
8232 msgid "See also C<guestfs_realpath>."
8233 msgstr ""
8234
8235 # type: textblock
8236 #. type: textblock
8237 #: ../src/guestfs-actions.pod:860 ../src/guestfs-actions.pod:7011
8238 msgid "(Added in 1.0.75)"
8239 msgstr ""
8240
8241 # type: =head2
8242 #. type: =head2
8243 #: ../src/guestfs-actions.pod:862
8244 msgid "guestfs_cat"
8245 msgstr ""
8246
8247 # type: verbatim
8248 #. type: verbatim
8249 #: ../src/guestfs-actions.pod:864
8250 #, no-wrap
8251 msgid ""
8252 " char *\n"
8253 " guestfs_cat (guestfs_h *g,\n"
8254 "              const char *path);\n"
8255 "\n"
8256 msgstr ""
8257
8258 # type: textblock
8259 #. type: textblock
8260 #: ../src/guestfs-actions.pod:868 ../src/guestfs-actions.pod:5479
8261 #: ../fish/guestfish-actions.pod:580 ../fish/guestfish-actions.pod:3680
8262 msgid "Return the contents of the file named C<path>."
8263 msgstr ""
8264
8265 # type: textblock
8266 #. type: textblock
8267 #: ../src/guestfs-actions.pod:870
8268 msgid ""
8269 "Note that this function cannot correctly handle binary files (specifically, "
8270 "files containing C<\\0> character which is treated as end of string).  For "
8271 "those you need to use the C<guestfs_read_file> or C<guestfs_download> "
8272 "functions which have a more complex interface."
8273 msgstr ""
8274
8275 # type: textblock
8276 #. type: textblock
8277 #: ../src/guestfs-actions.pod:878 ../src/guestfs-actions.pod:1057
8278 #: ../src/guestfs-actions.pod:1077 ../src/guestfs-actions.pod:1373
8279 #: ../src/guestfs-actions.pod:1392 ../src/guestfs-actions.pod:1495
8280 #: ../src/guestfs-actions.pod:1514 ../src/guestfs-actions.pod:1760
8281 #: ../src/guestfs-actions.pod:2218 ../src/guestfs-actions.pod:2237
8282 #: ../src/guestfs-actions.pod:2280 ../src/guestfs-actions.pod:2304
8283 #: ../src/guestfs-actions.pod:2321 ../src/guestfs-actions.pod:2350
8284 #: ../src/guestfs-actions.pod:5261 ../src/guestfs-actions.pod:5287
8285 #: ../src/guestfs-actions.pod:5418 ../src/guestfs-actions.pod:5444
8286 #: ../src/guestfs-actions.pod:5468 ../src/guestfs-actions.pod:6396
8287 #: ../src/guestfs-actions.pod:6451 ../src/guestfs-actions.pod:6597
8288 #: ../src/guestfs-actions.pod:6621 ../src/guestfs-actions.pod:7290
8289 #: ../src/guestfs-actions.pod:7316 ../src/guestfs-actions.pod:7342
8290 #: ../src/guestfs-actions.pod:7361 ../src/guestfs-actions.pod:7446
8291 #: ../src/guestfs-actions.pod:7465 ../src/guestfs-actions.pod:7511
8292 #: ../src/guestfs-actions.pod:7530 ../fish/guestfish-actions.pod:587
8293 #: ../fish/guestfish-actions.pod:722 ../fish/guestfish-actions.pod:734
8294 #: ../fish/guestfish-actions.pod:910 ../fish/guestfish-actions.pod:920
8295 #: ../fish/guestfish-actions.pod:987 ../fish/guestfish-actions.pod:997
8296 #: ../fish/guestfish-actions.pod:1189 ../fish/guestfish-actions.pod:1490
8297 #: ../fish/guestfish-actions.pod:1500 ../fish/guestfish-actions.pod:1528
8298 #: ../fish/guestfish-actions.pod:1543 ../fish/guestfish-actions.pod:1553
8299 #: ../fish/guestfish-actions.pod:1572 ../fish/guestfish-actions.pod:3550
8300 #: ../fish/guestfish-actions.pod:3565 ../fish/guestfish-actions.pod:3641
8301 #: ../fish/guestfish-actions.pod:3658 ../fish/guestfish-actions.pod:3673
8302 #: ../fish/guestfish-actions.pod:4327 ../fish/guestfish-actions.pod:4373
8303 #: ../fish/guestfish-actions.pod:4458 ../fish/guestfish-actions.pod:4473
8304 #: ../fish/guestfish-actions.pod:4883 ../fish/guestfish-actions.pod:4901
8305 #: ../fish/guestfish-actions.pod:4918 ../fish/guestfish-actions.pod:4928
8306 #: ../fish/guestfish-actions.pod:4976 ../fish/guestfish-actions.pod:4986
8307 #: ../fish/guestfish-actions.pod:5015 ../fish/guestfish-actions.pod:5025
8308 msgid ""
8309 "Because of the message protocol, there is a transfer limit of somewhere "
8310 "between 2MB and 4MB.  See L<guestfs(3)/PROTOCOL LIMITS>."
8311 msgstr ""
8312
8313 # type: textblock
8314 #. type: textblock
8315 #: ../src/guestfs-actions.pod:881 ../src/guestfs-actions.pod:3561
8316 #: ../src/guestfs-actions.pod:3623 ../src/guestfs-actions.pod:3640
8317 #: ../src/guestfs-actions.pod:3728 ../src/guestfs-actions.pod:4133
8318 #: ../src/guestfs-actions.pod:4147 ../src/guestfs-actions.pod:5367
8319 #: ../src/guestfs-actions.pod:5381 ../src/guestfs-actions.pod:7170
8320 #: ../src/guestfs-actions.pod:7184
8321 msgid "(Added in 0.4)"
8322 msgstr ""
8323
8324 # type: =head2
8325 #. type: =head2
8326 #: ../src/guestfs-actions.pod:883
8327 msgid "guestfs_checksum"
8328 msgstr ""
8329
8330 # type: verbatim
8331 #. type: verbatim
8332 #: ../src/guestfs-actions.pod:885
8333 #, no-wrap
8334 msgid ""
8335 " char *\n"
8336 " guestfs_checksum (guestfs_h *g,\n"
8337 "                   const char *csumtype,\n"
8338 "                   const char *path);\n"
8339 "\n"
8340 msgstr ""
8341
8342 # type: textblock
8343 #. type: textblock
8344 #: ../src/guestfs-actions.pod:890 ../fish/guestfish-actions.pod:594
8345 msgid ""
8346 "This call computes the MD5, SHAx or CRC checksum of the file named C<path>."
8347 msgstr ""
8348
8349 # type: textblock
8350 #. type: textblock
8351 #: ../src/guestfs-actions.pod:893 ../fish/guestfish-actions.pod:597
8352 msgid ""
8353 "The type of checksum to compute is given by the C<csumtype> parameter which "
8354 "must have one of the following values:"
8355 msgstr ""
8356
8357 # type: =item
8358 #. type: =item
8359 #: ../src/guestfs-actions.pod:898 ../fish/guestfish-actions.pod:602
8360 msgid "C<crc>"
8361 msgstr ""
8362
8363 # type: textblock
8364 #. type: textblock
8365 #: ../src/guestfs-actions.pod:900 ../fish/guestfish-actions.pod:604
8366 msgid ""
8367 "Compute the cyclic redundancy check (CRC) specified by POSIX for the "
8368 "C<cksum> command."
8369 msgstr ""
8370
8371 # type: =item
8372 #. type: =item
8373 #: ../src/guestfs-actions.pod:903 ../fish/guestfish-actions.pod:607
8374 msgid "C<md5>"
8375 msgstr ""
8376
8377 # type: textblock
8378 #. type: textblock
8379 #: ../src/guestfs-actions.pod:905 ../fish/guestfish-actions.pod:609
8380 msgid "Compute the MD5 hash (using the C<md5sum> program)."
8381 msgstr ""
8382
8383 # type: =item
8384 #. type: =item
8385 #: ../src/guestfs-actions.pod:907 ../fish/guestfish-actions.pod:611
8386 msgid "C<sha1>"
8387 msgstr ""
8388
8389 # type: textblock
8390 #. type: textblock
8391 #: ../src/guestfs-actions.pod:909 ../fish/guestfish-actions.pod:613
8392 msgid "Compute the SHA1 hash (using the C<sha1sum> program)."
8393 msgstr ""
8394
8395 # type: =item
8396 #. type: =item
8397 #: ../src/guestfs-actions.pod:911 ../fish/guestfish-actions.pod:615
8398 msgid "C<sha224>"
8399 msgstr ""
8400
8401 # type: textblock
8402 #. type: textblock
8403 #: ../src/guestfs-actions.pod:913 ../fish/guestfish-actions.pod:617
8404 msgid "Compute the SHA224 hash (using the C<sha224sum> program)."
8405 msgstr ""
8406
8407 # type: =item
8408 #. type: =item
8409 #: ../src/guestfs-actions.pod:915 ../fish/guestfish-actions.pod:619
8410 msgid "C<sha256>"
8411 msgstr ""
8412
8413 # type: textblock
8414 #. type: textblock
8415 #: ../src/guestfs-actions.pod:917 ../fish/guestfish-actions.pod:621
8416 msgid "Compute the SHA256 hash (using the C<sha256sum> program)."
8417 msgstr ""
8418
8419 # type: =item
8420 #. type: =item
8421 #: ../src/guestfs-actions.pod:919 ../fish/guestfish-actions.pod:623
8422 msgid "C<sha384>"
8423 msgstr ""
8424
8425 # type: textblock
8426 #. type: textblock
8427 #: ../src/guestfs-actions.pod:921 ../fish/guestfish-actions.pod:625
8428 msgid "Compute the SHA384 hash (using the C<sha384sum> program)."
8429 msgstr ""
8430
8431 # type: =item
8432 #. type: =item
8433 #: ../src/guestfs-actions.pod:923 ../fish/guestfish-actions.pod:627
8434 msgid "C<sha512>"
8435 msgstr ""
8436
8437 # type: textblock
8438 #. type: textblock
8439 #: ../src/guestfs-actions.pod:925 ../fish/guestfish-actions.pod:629
8440 msgid "Compute the SHA512 hash (using the C<sha512sum> program)."
8441 msgstr ""
8442
8443 # type: textblock
8444 #. type: textblock
8445 #: ../src/guestfs-actions.pod:929 ../fish/guestfish-actions.pod:633
8446 msgid "The checksum is returned as a printable string."
8447 msgstr ""
8448
8449 # type: textblock
8450 #. type: textblock
8451 #: ../src/guestfs-actions.pod:931
8452 msgid "To get the checksum for a device, use C<guestfs_checksum_device>."
8453 msgstr ""
8454
8455 # type: textblock
8456 #. type: textblock
8457 #: ../src/guestfs-actions.pod:933
8458 msgid "To get the checksums for many files, use C<guestfs_checksums_out>."
8459 msgstr ""
8460
8461 # type: textblock
8462 #. type: textblock
8463 #: ../src/guestfs-actions.pod:938 ../src/guestfs-actions.pod:1246
8464 #: ../src/guestfs-actions.pod:2080 ../src/guestfs-actions.pod:3300
8465 #: ../src/guestfs-actions.pod:3329 ../src/guestfs-actions.pod:3390
8466 #: ../src/guestfs-actions.pod:3417 ../src/guestfs-actions.pod:6867
8467 msgid "(Added in 1.0.2)"
8468 msgstr ""
8469
8470 # type: =head2
8471 #. type: =head2
8472 #: ../src/guestfs-actions.pod:940
8473 msgid "guestfs_checksum_device"
8474 msgstr ""
8475
8476 # type: verbatim
8477 #. type: verbatim
8478 #: ../src/guestfs-actions.pod:942
8479 #, no-wrap
8480 msgid ""
8481 " char *\n"
8482 " guestfs_checksum_device (guestfs_h *g,\n"
8483 "                          const char *csumtype,\n"
8484 "                          const char *device);\n"
8485 "\n"
8486 msgstr ""
8487
8488 # type: textblock
8489 #. type: textblock
8490 #: ../src/guestfs-actions.pod:947
8491 msgid ""
8492 "This call computes the MD5, SHAx or CRC checksum of the contents of the "
8493 "device named C<device>.  For the types of checksums supported see the "
8494 "C<guestfs_checksum> command."
8495 msgstr ""
8496
8497 # type: textblock
8498 #. type: textblock
8499 #: ../src/guestfs-actions.pod:954 ../src/guestfs-actions.pod:4898
8500 #: ../src/guestfs-actions.pod:4957 ../src/guestfs-actions.pod:4994
8501 #: ../src/guestfs-actions.pod:5012 ../src/guestfs-actions.pod:5188
8502 #: ../src/guestfs-actions.pod:6776 ../src/guestfs-actions.pod:6790
8503 #: ../src/guestfs-actions.pod:7196
8504 msgid "(Added in 1.3.2)"
8505 msgstr ""
8506
8507 # type: =head2
8508 #. type: =head2
8509 #: ../src/guestfs-actions.pod:956
8510 msgid "guestfs_checksums_out"
8511 msgstr ""
8512
8513 # type: verbatim
8514 #. type: verbatim
8515 #: ../src/guestfs-actions.pod:958
8516 #, no-wrap
8517 msgid ""
8518 " int\n"
8519 " guestfs_checksums_out (guestfs_h *g,\n"
8520 "                        const char *csumtype,\n"
8521 "                        const char *directory,\n"
8522 "                        const char *sumsfile);\n"
8523 "\n"
8524 msgstr ""
8525
8526 # type: textblock
8527 #. type: textblock
8528 #: ../src/guestfs-actions.pod:964 ../fish/guestfish-actions.pod:651
8529 msgid ""
8530 "This command computes the checksums of all regular files in C<directory> and "
8531 "then emits a list of those checksums to the local output file C<sumsfile>."
8532 msgstr ""
8533
8534 # type: textblock
8535 #. type: textblock
8536 #: ../src/guestfs-actions.pod:968 ../fish/guestfish-actions.pod:655
8537 msgid ""
8538 "This can be used for verifying the integrity of a virtual machine.  However "
8539 "to be properly secure you should pay attention to the output of the checksum "
8540 "command (it uses the ones from GNU coreutils).  In particular when the "
8541 "filename is not printable, coreutils uses a special backslash syntax.  For "
8542 "more information, see the GNU coreutils info file."
8543 msgstr ""
8544
8545 # type: textblock
8546 #. type: textblock
8547 #: ../src/guestfs-actions.pod:978
8548 msgid "(Added in 1.3.7)"
8549 msgstr ""
8550
8551 # type: =head2
8552 #. type: =head2
8553 #: ../src/guestfs-actions.pod:980
8554 msgid "guestfs_chmod"
8555 msgstr ""
8556
8557 # type: verbatim
8558 #. type: verbatim
8559 #: ../src/guestfs-actions.pod:982
8560 #, no-wrap
8561 msgid ""
8562 " int\n"
8563 " guestfs_chmod (guestfs_h *g,\n"
8564 "                int mode,\n"
8565 "                const char *path);\n"
8566 "\n"
8567 msgstr ""
8568
8569 # type: textblock
8570 #. type: textblock
8571 #: ../src/guestfs-actions.pod:987 ../fish/guestfish-actions.pod:669
8572 msgid ""
8573 "Change the mode (permissions) of C<path> to C<mode>.  Only numeric modes are "
8574 "supported."
8575 msgstr ""
8576
8577 # type: textblock
8578 #. type: textblock
8579 #: ../src/guestfs-actions.pod:990 ../fish/guestfish-actions.pod:672
8580 msgid ""
8581 "I<Note>: When using this command from guestfish, C<mode> by default would be "
8582 "decimal, unless you prefix it with C<0> to get octal, ie. use C<0700> not "
8583 "C<700>."
8584 msgstr ""
8585
8586 # type: textblock
8587 #. type: textblock
8588 #: ../src/guestfs-actions.pod:994 ../src/guestfs-actions.pod:4384
8589 #: ../src/guestfs-actions.pod:4581 ../src/guestfs-actions.pod:4600
8590 #: ../src/guestfs-actions.pod:4619 ../fish/guestfish-actions.pod:676
8591 #: ../fish/guestfish-actions.pod:2980 ../fish/guestfish-actions.pod:3109
8592 #: ../fish/guestfish-actions.pod:3119 ../fish/guestfish-actions.pod:3129
8593 msgid "The mode actually set is affected by the umask."
8594 msgstr ""
8595
8596 # type: =head2
8597 #. type: =head2
8598 #: ../src/guestfs-actions.pod:1000
8599 msgid "guestfs_chown"
8600 msgstr ""
8601
8602 # type: verbatim
8603 #. type: verbatim
8604 #: ../src/guestfs-actions.pod:1002
8605 #, no-wrap
8606 msgid ""
8607 " int\n"
8608 " guestfs_chown (guestfs_h *g,\n"
8609 "                int owner,\n"
8610 "                int group,\n"
8611 "                const char *path);\n"
8612 "\n"
8613 msgstr ""
8614
8615 # type: textblock
8616 #. type: textblock
8617 #: ../src/guestfs-actions.pod:1008 ../fish/guestfish-actions.pod:682
8618 msgid "Change the file owner to C<owner> and group to C<group>."
8619 msgstr ""
8620
8621 # type: textblock
8622 #. type: textblock
8623 #: ../src/guestfs-actions.pod:1010 ../src/guestfs-actions.pod:3492
8624 #: ../fish/guestfish-actions.pod:684 ../fish/guestfish-actions.pod:2438
8625 msgid ""
8626 "Only numeric uid and gid are supported.  If you want to use names, you will "
8627 "need to locate and parse the password file yourself (Augeas support makes "
8628 "this relatively easy)."
8629 msgstr ""
8630
8631 # type: =head2
8632 #. type: =head2
8633 #: ../src/guestfs-actions.pod:1018
8634 msgid "guestfs_command"
8635 msgstr ""
8636
8637 # type: verbatim
8638 #. type: verbatim
8639 #: ../src/guestfs-actions.pod:1020
8640 #, no-wrap
8641 msgid ""
8642 " char *\n"
8643 " guestfs_command (guestfs_h *g,\n"
8644 "                  char *const *arguments);\n"
8645 "\n"
8646 msgstr ""
8647
8648 # type: textblock
8649 #. type: textblock
8650 #: ../src/guestfs-actions.pod:1024 ../fish/guestfish-actions.pod:692
8651 msgid ""
8652 "This call runs a command from the guest filesystem.  The filesystem must be "
8653 "mounted, and must contain a compatible operating system (ie. something "
8654 "Linux, with the same or compatible processor architecture)."
8655 msgstr ""
8656
8657 # type: textblock
8658 #. type: textblock
8659 #: ../src/guestfs-actions.pod:1029
8660 msgid ""
8661 "The single parameter is an argv-style list of arguments.  The first element "
8662 "is the name of the program to run.  Subsequent elements are parameters.  The "
8663 "list must be non-empty (ie. must contain a program name).  Note that the "
8664 "command runs directly, and is I<not> invoked via the shell (see "
8665 "C<guestfs_sh>)."
8666 msgstr ""
8667
8668 # type: textblock
8669 #. type: textblock
8670 #: ../src/guestfs-actions.pod:1036 ../fish/guestfish-actions.pod:704
8671 msgid "The return value is anything printed to I<stdout> by the command."
8672 msgstr ""
8673
8674 # type: textblock
8675 #. type: textblock
8676 #: ../src/guestfs-actions.pod:1039 ../fish/guestfish-actions.pod:707
8677 msgid ""
8678 "If the command returns a non-zero exit status, then this function returns an "
8679 "error message.  The error message string is the content of I<stderr> from "
8680 "the command."
8681 msgstr ""
8682
8683 # type: textblock
8684 #. type: textblock
8685 #: ../src/guestfs-actions.pod:1043 ../fish/guestfish-actions.pod:711
8686 msgid ""
8687 "The C<$PATH> environment variable will contain at least C</usr/bin> and C</"
8688 "bin>.  If you require a program from another location, you should provide "
8689 "the full path in the first parameter."
8690 msgstr ""
8691
8692 # type: textblock
8693 #. type: textblock
8694 #: ../src/guestfs-actions.pod:1048 ../fish/guestfish-actions.pod:716
8695 msgid ""
8696 "Shared libraries and data files required by the program must be available on "
8697 "filesystems which are mounted in the correct places.  It is the caller's "
8698 "responsibility to ensure all filesystems that are needed are mounted at the "
8699 "right locations."
8700 msgstr ""
8701
8702 # type: textblock
8703 #. type: textblock
8704 #: ../src/guestfs-actions.pod:1060 ../src/guestfs-actions.pod:1080
8705 #: ../src/guestfs-actions.pod:1545
8706 msgid "(Added in 0.9.1)"
8707 msgstr ""
8708
8709 # type: =head2
8710 #. type: =head2
8711 #: ../src/guestfs-actions.pod:1062
8712 msgid "guestfs_command_lines"
8713 msgstr ""
8714
8715 # type: verbatim
8716 #. type: verbatim
8717 #: ../src/guestfs-actions.pod:1064
8718 #, no-wrap
8719 msgid ""
8720 " char **\n"
8721 " guestfs_command_lines (guestfs_h *g,\n"
8722 "                        char *const *arguments);\n"
8723 "\n"
8724 msgstr ""
8725
8726 # type: textblock
8727 #. type: textblock
8728 #: ../src/guestfs-actions.pod:1068
8729 msgid ""
8730 "This is the same as C<guestfs_command>, but splits the result into a list of "
8731 "lines."
8732 msgstr ""
8733
8734 # type: textblock
8735 #. type: textblock
8736 #: ../src/guestfs-actions.pod:1071
8737 msgid "See also: C<guestfs_sh_lines>"
8738 msgstr ""
8739
8740 # type: =head2
8741 #. type: =head2
8742 #: ../src/guestfs-actions.pod:1082
8743 msgid "guestfs_config"
8744 msgstr ""
8745
8746 # type: verbatim
8747 #. type: verbatim
8748 #: ../src/guestfs-actions.pod:1084
8749 #, no-wrap
8750 msgid ""
8751 " int\n"
8752 " guestfs_config (guestfs_h *g,\n"
8753 "                 const char *qemuparam,\n"
8754 "                 const char *qemuvalue);\n"
8755 "\n"
8756 msgstr ""
8757
8758 #. type: textblock
8759 #: ../src/guestfs-actions.pod:1089 ../fish/guestfish-actions.pod:741
8760 msgid ""
8761 "This can be used to add arbitrary qemu command line parameters of the form "
8762 "I<-param value>.  Actually it's not quite arbitrary - we prevent you from "
8763 "setting some parameters which would interfere with parameters that we use."
8764 msgstr ""
8765
8766 # type: textblock
8767 #. type: textblock
8768 #: ../src/guestfs-actions.pod:1094 ../fish/guestfish-actions.pod:746
8769 msgid "The first character of C<param> string must be a C<-> (dash)."
8770 msgstr ""
8771
8772 # type: textblock
8773 #. type: textblock
8774 #: ../src/guestfs-actions.pod:1096 ../fish/guestfish-actions.pod:748
8775 msgid "C<value> can be NULL."
8776 msgstr ""
8777
8778 # type: =head2
8779 #. type: =head2
8780 #: ../src/guestfs-actions.pod:1102
8781 msgid "guestfs_copy_size"
8782 msgstr ""
8783
8784 # type: verbatim
8785 #. type: verbatim
8786 #: ../src/guestfs-actions.pod:1104
8787 #, no-wrap
8788 msgid ""
8789 " int\n"
8790 " guestfs_copy_size (guestfs_h *g,\n"
8791 "                    const char *src,\n"
8792 "                    const char *dest,\n"
8793 "                    int64_t size);\n"
8794 "\n"
8795 msgstr ""
8796
8797 # type: textblock
8798 #. type: textblock
8799 #: ../src/guestfs-actions.pod:1110 ../fish/guestfish-actions.pod:754
8800 msgid ""
8801 "This command copies exactly C<size> bytes from one source device or file "
8802 "C<src> to another destination device or file C<dest>."
8803 msgstr ""
8804
8805 # type: textblock
8806 #. type: textblock
8807 #: ../src/guestfs-actions.pod:1113 ../fish/guestfish-actions.pod:757
8808 msgid ""
8809 "Note this will fail if the source is too short or if the destination is not "
8810 "large enough."
8811 msgstr ""
8812
8813 #. type: textblock
8814 #: ../src/guestfs-actions.pod:1118 ../src/guestfs-actions.pod:1241
8815 #: ../src/guestfs-actions.pod:1272 ../src/guestfs-actions.pod:1317
8816 #: ../src/guestfs-actions.pod:1694 ../src/guestfs-actions.pod:1716
8817 #: ../src/guestfs-actions.pod:3473 ../src/guestfs-actions.pod:6862
8818 #: ../src/guestfs-actions.pod:6896 ../src/guestfs-actions.pod:7382
8819 #: ../src/guestfs-actions.pod:7401
8820 msgid ""
8821 "This long-running command can generate progress notification messages so "
8822 "that the caller can display a progress bar or indicator.  To receive these "
8823 "messages, the caller must register a progress event callback.  See L<guestfs"
8824 "(3)/GUESTFS_EVENT_PROGRESS>."
8825 msgstr ""
8826
8827 # type: textblock
8828 #. type: textblock
8829 #: ../src/guestfs-actions.pod:1123 ../src/guestfs-actions.pod:4160
8830 #: ../src/guestfs-actions.pod:5394 ../src/guestfs-actions.pod:7103
8831 #: ../src/guestfs-actions.pod:7123 ../src/guestfs-actions.pod:7209
8832 msgid "(Added in 1.0.87)"
8833 msgstr ""
8834
8835 # type: =head2
8836 #. type: =head2
8837 #: ../src/guestfs-actions.pod:1125
8838 msgid "guestfs_cp"
8839 msgstr ""
8840
8841 # type: verbatim
8842 #. type: verbatim
8843 #: ../src/guestfs-actions.pod:1127
8844 #, no-wrap
8845 msgid ""
8846 " int\n"
8847 " guestfs_cp (guestfs_h *g,\n"
8848 "             const char *src,\n"
8849 "             const char *dest);\n"
8850 "\n"
8851 msgstr ""
8852
8853 # type: textblock
8854 #. type: textblock
8855 #: ../src/guestfs-actions.pod:1132 ../fish/guestfish-actions.pod:764
8856 msgid ""
8857 "This copies a file from C<src> to C<dest> where C<dest> is either a "
8858 "destination filename or destination directory."
8859 msgstr ""
8860
8861 # type: textblock
8862 #. type: textblock
8863 #: ../src/guestfs-actions.pod:1137 ../src/guestfs-actions.pod:1151
8864 #: ../src/guestfs-actions.pod:1223 ../src/guestfs-actions.pod:1297
8865 #: ../src/guestfs-actions.pod:1411 ../src/guestfs-actions.pod:4852
8866 #: ../src/guestfs-actions.pod:5238
8867 msgid "(Added in 1.0.18)"
8868 msgstr ""
8869
8870 # type: =head2
8871 #. type: =head2
8872 #: ../src/guestfs-actions.pod:1139
8873 msgid "guestfs_cp_a"
8874 msgstr ""
8875
8876 # type: verbatim
8877 #. type: verbatim
8878 #: ../src/guestfs-actions.pod:1141
8879 #, no-wrap
8880 msgid ""
8881 " int\n"
8882 " guestfs_cp_a (guestfs_h *g,\n"
8883 "               const char *src,\n"
8884 "               const char *dest);\n"
8885 "\n"
8886 msgstr ""
8887
8888 # type: textblock
8889 #. type: textblock
8890 #: ../src/guestfs-actions.pod:1146 ../fish/guestfish-actions.pod:771
8891 msgid ""
8892 "This copies a file or directory from C<src> to C<dest> recursively using the "
8893 "C<cp -a> command."
8894 msgstr ""
8895
8896 # type: =head2
8897 #. type: =head2
8898 #: ../src/guestfs-actions.pod:1153
8899 msgid "guestfs_dd"
8900 msgstr ""
8901
8902 # type: verbatim
8903 #. type: verbatim
8904 #: ../src/guestfs-actions.pod:1155
8905 #, no-wrap
8906 msgid ""
8907 " int\n"
8908 " guestfs_dd (guestfs_h *g,\n"
8909 "             const char *src,\n"
8910 "             const char *dest);\n"
8911 "\n"
8912 msgstr ""
8913
8914 # type: textblock
8915 #. type: textblock
8916 #: ../src/guestfs-actions.pod:1160 ../fish/guestfish-actions.pod:778
8917 msgid ""
8918 "This command copies from one source device or file C<src> to another "
8919 "destination device or file C<dest>.  Normally you would use this to copy to "
8920 "or from a device or partition, for example to duplicate a filesystem."
8921 msgstr ""
8922
8923 # type: textblock
8924 #. type: textblock
8925 #: ../src/guestfs-actions.pod:1165
8926 msgid ""
8927 "If the destination is a device, it must be as large or larger than the "
8928 "source file or device, otherwise the copy will fail.  This command cannot do "
8929 "partial copies (see C<guestfs_copy_size>)."
8930 msgstr ""
8931
8932 # type: =head2
8933 #. type: =head2
8934 #: ../src/guestfs-actions.pod:1173
8935 msgid "guestfs_df"
8936 msgstr ""
8937
8938 # type: verbatim
8939 #. type: verbatim
8940 #: ../src/guestfs-actions.pod:1175
8941 #, no-wrap
8942 msgid ""
8943 " char *\n"
8944 " guestfs_df (guestfs_h *g);\n"
8945 "\n"
8946 msgstr ""
8947
8948 # type: textblock
8949 #. type: textblock
8950 #: ../src/guestfs-actions.pod:1178 ../fish/guestfish-actions.pod:791
8951 msgid "This command runs the C<df> command to report disk space used."
8952 msgstr ""
8953
8954 # type: textblock
8955 #. type: textblock
8956 #: ../src/guestfs-actions.pod:1180 ../src/guestfs-actions.pod:1197
8957 msgid ""
8958 "This command is mostly useful for interactive sessions.  It is I<not> "
8959 "intended that you try to parse the output string.  Use C<guestfs_statvfs> "
8960 "from programs."
8961 msgstr ""
8962
8963 # type: textblock
8964 #. type: textblock
8965 #: ../src/guestfs-actions.pod:1187 ../src/guestfs-actions.pod:1204
8966 #: ../src/guestfs-actions.pod:1322 ../src/guestfs-actions.pod:2283
8967 #: ../src/guestfs-actions.pod:2307 ../src/guestfs-actions.pod:2375
8968 #: ../src/guestfs-actions.pod:4270 ../src/guestfs-actions.pod:4752
8969 #: ../src/guestfs-actions.pod:6600 ../src/guestfs-actions.pod:6624
8970 #: ../src/guestfs-actions.pod:7249 ../src/guestfs-actions.pod:7262
8971 #: ../src/guestfs-actions.pod:7275
8972 msgid "(Added in 1.0.54)"
8973 msgstr ""
8974
8975 # type: =head2
8976 #. type: =head2
8977 #: ../src/guestfs-actions.pod:1189
8978 msgid "guestfs_df_h"
8979 msgstr ""
8980
8981 # type: verbatim
8982 #. type: verbatim
8983 #: ../src/guestfs-actions.pod:1191
8984 #, no-wrap
8985 msgid ""
8986 " char *\n"
8987 " guestfs_df_h (guestfs_h *g);\n"
8988 "\n"
8989 msgstr ""
8990
8991 # type: textblock
8992 #. type: textblock
8993 #: ../src/guestfs-actions.pod:1194 ../fish/guestfish-actions.pod:801
8994 msgid ""
8995 "This command runs the C<df -h> command to report disk space used in human-"
8996 "readable format."
8997 msgstr ""
8998
8999 # type: =head2
9000 #. type: =head2
9001 #: ../src/guestfs-actions.pod:1206
9002 msgid "guestfs_dmesg"
9003 msgstr ""
9004
9005 # type: verbatim
9006 #. type: verbatim
9007 #: ../src/guestfs-actions.pod:1208
9008 #, no-wrap
9009 msgid ""
9010 " char *\n"
9011 " guestfs_dmesg (guestfs_h *g);\n"
9012 "\n"
9013 msgstr ""
9014
9015 # type: textblock
9016 #. type: textblock
9017 #: ../src/guestfs-actions.pod:1211 ../fish/guestfish-actions.pod:812
9018 msgid ""
9019 "This returns the kernel messages (C<dmesg> output) from the guest kernel.  "
9020 "This is sometimes useful for extended debugging of problems."
9021 msgstr ""
9022
9023 # type: textblock
9024 #. type: textblock
9025 #: ../src/guestfs-actions.pod:1215
9026 msgid ""
9027 "Another way to get the same information is to enable verbose messages with "
9028 "C<guestfs_set_verbose> or by setting the environment variable "
9029 "C<LIBGUESTFS_DEBUG=1> before running the program."
9030 msgstr ""
9031
9032 # type: =head2
9033 #. type: =head2
9034 #: ../src/guestfs-actions.pod:1225
9035 msgid "guestfs_download"
9036 msgstr ""
9037
9038 # type: verbatim
9039 #. type: verbatim
9040 #: ../src/guestfs-actions.pod:1227
9041 #, no-wrap
9042 msgid ""
9043 " int\n"
9044 " guestfs_download (guestfs_h *g,\n"
9045 "                   const char *remotefilename,\n"
9046 "                   const char *filename);\n"
9047 "\n"
9048 msgstr ""
9049
9050 # type: textblock
9051 #. type: textblock
9052 #: ../src/guestfs-actions.pod:1232 ../src/guestfs-actions.pod:1257
9053 #: ../fish/guestfish-actions.pod:825 ../fish/guestfish-actions.pod:838
9054 msgid ""
9055 "Download file C<remotefilename> and save it as C<filename> on the local "
9056 "machine."
9057 msgstr ""
9058
9059 # type: textblock
9060 #. type: textblock
9061 #: ../src/guestfs-actions.pod:1235 ../src/guestfs-actions.pod:6856
9062 #: ../fish/guestfish-actions.pod:828 ../fish/guestfish-actions.pod:4631
9063 msgid "C<filename> can also be a named pipe."
9064 msgstr ""
9065
9066 # type: textblock
9067 #. type: textblock
9068 #: ../src/guestfs-actions.pod:1237
9069 msgid "See also C<guestfs_upload>, C<guestfs_cat>."
9070 msgstr ""
9071
9072 # type: =head2
9073 #. type: =head2
9074 #: ../src/guestfs-actions.pod:1248
9075 msgid "guestfs_download_offset"
9076 msgstr ""
9077
9078 # type: verbatim
9079 #. type: verbatim
9080 #: ../src/guestfs-actions.pod:1250
9081 #, no-wrap
9082 msgid ""
9083 " int\n"
9084 " guestfs_download_offset (guestfs_h *g,\n"
9085 "                          const char *remotefilename,\n"
9086 "                          const char *filename,\n"
9087 "                          int64_t offset,\n"
9088 "                          int64_t size);\n"
9089 "\n"
9090 msgstr ""
9091
9092 # type: textblock
9093 #. type: textblock
9094 #: ../src/guestfs-actions.pod:1260 ../fish/guestfish-actions.pod:841
9095 msgid ""
9096 "C<remotefilename> is read for C<size> bytes starting at C<offset> (this "
9097 "region must be within the file or device)."
9098 msgstr ""
9099
9100 # type: textblock
9101 #. type: textblock
9102 #: ../src/guestfs-actions.pod:1263
9103 msgid ""
9104 "Note that there is no limit on the amount of data that can be downloaded "
9105 "with this call, unlike with C<guestfs_pread>, and this call always reads the "
9106 "full amount unless an error occurs."
9107 msgstr ""
9108
9109 # type: textblock
9110 #. type: textblock
9111 #: ../src/guestfs-actions.pod:1268
9112 msgid "See also C<guestfs_download>, C<guestfs_pread>."
9113 msgstr ""
9114
9115 # type: textblock
9116 #. type: textblock
9117 #: ../src/guestfs-actions.pod:1277 ../src/guestfs-actions.pod:6901
9118 msgid "(Added in 1.5.17)"
9119 msgstr ""
9120
9121 # type: =head2
9122 #. type: =head2
9123 #: ../src/guestfs-actions.pod:1279
9124 msgid "guestfs_drop_caches"
9125 msgstr ""
9126
9127 # type: verbatim
9128 #. type: verbatim
9129 #: ../src/guestfs-actions.pod:1281
9130 #, no-wrap
9131 msgid ""
9132 " int\n"
9133 " guestfs_drop_caches (guestfs_h *g,\n"
9134 "                      int whattodrop);\n"
9135 "\n"
9136 msgstr ""
9137
9138 # type: textblock
9139 #. type: textblock
9140 #: ../src/guestfs-actions.pod:1285 ../fish/guestfish-actions.pod:857
9141 msgid ""
9142 "This instructs the guest kernel to drop its page cache, and/or dentries and "
9143 "inode caches.  The parameter C<whattodrop> tells the kernel what precisely "
9144 "to drop, see L<http://linux-mm.org/Drop_Caches>"
9145 msgstr ""
9146
9147 # type: textblock
9148 #. type: textblock
9149 #: ../src/guestfs-actions.pod:1290 ../fish/guestfish-actions.pod:862
9150 msgid "Setting C<whattodrop> to 3 should drop everything."
9151 msgstr ""
9152
9153 # type: textblock
9154 #. type: textblock
9155 #: ../src/guestfs-actions.pod:1292 ../fish/guestfish-actions.pod:864
9156 msgid ""
9157 "This automatically calls L<sync(2)> before the operation, so that the "
9158 "maximum guest memory is freed."
9159 msgstr ""
9160
9161 # type: =head2
9162 #. type: =head2
9163 #: ../src/guestfs-actions.pod:1299
9164 msgid "guestfs_du"
9165 msgstr ""
9166
9167 # type: verbatim
9168 #. type: verbatim
9169 #: ../src/guestfs-actions.pod:1301
9170 #, no-wrap
9171 msgid ""
9172 " int64_t\n"
9173 " guestfs_du (guestfs_h *g,\n"
9174 "             const char *path);\n"
9175 "\n"
9176 msgstr ""
9177
9178 # type: textblock
9179 #. type: textblock
9180 #: ../src/guestfs-actions.pod:1305 ../fish/guestfish-actions.pod:871
9181 msgid ""
9182 "This command runs the C<du -s> command to estimate file space usage for "
9183 "C<path>."
9184 msgstr ""
9185
9186 # type: textblock
9187 #. type: textblock
9188 #: ../src/guestfs-actions.pod:1308 ../fish/guestfish-actions.pod:874
9189 msgid ""
9190 "C<path> can be a file or a directory.  If C<path> is a directory then the "
9191 "estimate includes the contents of the directory and all subdirectories "
9192 "(recursively)."
9193 msgstr ""
9194
9195 # type: textblock
9196 #. type: textblock
9197 #: ../src/guestfs-actions.pod:1312 ../fish/guestfish-actions.pod:878
9198 msgid ""
9199 "The result is the estimated size in I<kilobytes> (ie. units of 1024 bytes)."
9200 msgstr ""
9201
9202 # type: =head2
9203 #. type: =head2
9204 #: ../src/guestfs-actions.pod:1324
9205 msgid "guestfs_e2fsck_f"
9206 msgstr ""
9207
9208 # type: verbatim
9209 #. type: verbatim
9210 #: ../src/guestfs-actions.pod:1326
9211 #, no-wrap
9212 msgid ""
9213 " int\n"
9214 " guestfs_e2fsck_f (guestfs_h *g,\n"
9215 "                   const char *device);\n"
9216 "\n"
9217 msgstr ""
9218
9219 #. type: textblock
9220 #: ../src/guestfs-actions.pod:1330 ../fish/guestfish-actions.pod:885
9221 msgid ""
9222 "This runs C<e2fsck -p -f device>, ie. runs the ext2/ext3 filesystem checker "
9223 "on C<device>, noninteractively (I<-p>), even if the filesystem appears to be "
9224 "clean (I<-f>)."
9225 msgstr ""
9226
9227 # type: textblock
9228 #. type: textblock
9229 #: ../src/guestfs-actions.pod:1334
9230 msgid ""
9231 "This command is only needed because of C<guestfs_resize2fs> (q.v.).  "
9232 "Normally you should use C<guestfs_fsck>."
9233 msgstr ""
9234
9235 # type: textblock
9236 #. type: textblock
9237 #: ../src/guestfs-actions.pod:1339
9238 msgid "(Added in 1.0.29)"
9239 msgstr ""
9240
9241 # type: =head2
9242 #. type: =head2
9243 #: ../src/guestfs-actions.pod:1341
9244 msgid "guestfs_echo_daemon"
9245 msgstr ""
9246
9247 # type: verbatim
9248 #. type: verbatim
9249 #: ../src/guestfs-actions.pod:1343
9250 #, no-wrap
9251 msgid ""
9252 " char *\n"
9253 " guestfs_echo_daemon (guestfs_h *g,\n"
9254 "                      char *const *words);\n"
9255 "\n"
9256 msgstr ""
9257
9258 # type: textblock
9259 #. type: textblock
9260 #: ../src/guestfs-actions.pod:1347 ../fish/guestfish-actions.pod:896
9261 msgid ""
9262 "This command concatenates the list of C<words> passed with single spaces "
9263 "between them and returns the resulting string."
9264 msgstr ""
9265
9266 # type: textblock
9267 #. type: textblock
9268 #: ../src/guestfs-actions.pod:1350 ../fish/guestfish-actions.pod:899
9269 msgid "You can use this command to test the connection through to the daemon."
9270 msgstr ""
9271
9272 # type: textblock
9273 #. type: textblock
9274 #: ../src/guestfs-actions.pod:1352
9275 msgid "See also C<guestfs_ping_daemon>."
9276 msgstr ""
9277
9278 # type: textblock
9279 #. type: textblock
9280 #: ../src/guestfs-actions.pod:1357 ../src/guestfs-actions.pod:2091
9281 #: ../src/guestfs-actions.pod:6072
9282 msgid "(Added in 1.0.69)"
9283 msgstr ""
9284
9285 # type: =head2
9286 #. type: =head2
9287 #: ../src/guestfs-actions.pod:1359
9288 msgid "guestfs_egrep"
9289 msgstr ""
9290
9291 # type: verbatim
9292 #. type: verbatim
9293 #: ../src/guestfs-actions.pod:1361
9294 #, no-wrap
9295 msgid ""
9296 " char **\n"
9297 " guestfs_egrep (guestfs_h *g,\n"
9298 "                const char *regex,\n"
9299 "                const char *path);\n"
9300 "\n"
9301 msgstr ""
9302
9303 # type: textblock
9304 #. type: textblock
9305 #: ../src/guestfs-actions.pod:1366 ../fish/guestfish-actions.pod:907
9306 msgid ""
9307 "This calls the external C<egrep> program and returns the matching lines."
9308 msgstr ""
9309
9310 # type: textblock
9311 #. type: textblock
9312 #: ../src/guestfs-actions.pod:1376 ../src/guestfs-actions.pod:1395
9313 #: ../src/guestfs-actions.pod:1452 ../src/guestfs-actions.pod:1498
9314 #: ../src/guestfs-actions.pod:1517 ../src/guestfs-actions.pod:2221
9315 #: ../src/guestfs-actions.pod:2240 ../src/guestfs-actions.pod:2396
9316 #: ../src/guestfs-actions.pod:2409 ../src/guestfs-actions.pod:2424
9317 #: ../src/guestfs-actions.pod:2470 ../src/guestfs-actions.pod:2492
9318 #: ../src/guestfs-actions.pod:2505 ../src/guestfs-actions.pod:3653
9319 #: ../src/guestfs-actions.pod:3667 ../src/guestfs-actions.pod:3680
9320 #: ../src/guestfs-actions.pod:3694 ../src/guestfs-actions.pod:4680
9321 #: ../src/guestfs-actions.pod:5572 ../src/guestfs-actions.pod:5621
9322 #: ../src/guestfs-actions.pod:6468 ../src/guestfs-actions.pod:6480
9323 #: ../src/guestfs-actions.pod:6493 ../src/guestfs-actions.pod:6506
9324 #: ../src/guestfs-actions.pod:6528 ../src/guestfs-actions.pod:6541
9325 #: ../src/guestfs-actions.pod:6554 ../src/guestfs-actions.pod:6567
9326 #: ../src/guestfs-actions.pod:7345 ../src/guestfs-actions.pod:7364
9327 #: ../src/guestfs-actions.pod:7449 ../src/guestfs-actions.pod:7468
9328 #: ../src/guestfs-actions.pod:7514 ../src/guestfs-actions.pod:7533
9329 msgid "(Added in 1.0.66)"
9330 msgstr ""
9331
9332 # type: =head2
9333 #. type: =head2
9334 #: ../src/guestfs-actions.pod:1378
9335 msgid "guestfs_egrepi"
9336 msgstr ""
9337
9338 # type: verbatim
9339 #. type: verbatim
9340 #: ../src/guestfs-actions.pod:1380
9341 #, no-wrap
9342 msgid ""
9343 " char **\n"
9344 " guestfs_egrepi (guestfs_h *g,\n"
9345 "                 const char *regex,\n"
9346 "                 const char *path);\n"
9347 "\n"
9348 msgstr ""
9349
9350 # type: textblock
9351 #. type: textblock
9352 #: ../src/guestfs-actions.pod:1385 ../fish/guestfish-actions.pod:917
9353 msgid ""
9354 "This calls the external C<egrep -i> program and returns the matching lines."
9355 msgstr ""
9356
9357 # type: =head2
9358 #. type: =head2
9359 #: ../src/guestfs-actions.pod:1397
9360 msgid "guestfs_equal"
9361 msgstr ""
9362
9363 # type: verbatim
9364 #. type: verbatim
9365 #: ../src/guestfs-actions.pod:1399
9366 #, no-wrap
9367 msgid ""
9368 " int\n"
9369 " guestfs_equal (guestfs_h *g,\n"
9370 "                const char *file1,\n"
9371 "                const char *file2);\n"
9372 "\n"
9373 msgstr ""
9374
9375 # type: textblock
9376 #. type: textblock
9377 #: ../src/guestfs-actions.pod:1404 ../fish/guestfish-actions.pod:927
9378 msgid ""
9379 "This compares the two files C<file1> and C<file2> and returns true if their "
9380 "content is exactly equal, or false otherwise."
9381 msgstr ""
9382
9383 # type: textblock
9384 #. type: textblock
9385 #: ../src/guestfs-actions.pod:1407 ../fish/guestfish-actions.pod:930
9386 msgid "The external L<cmp(1)> program is used for the comparison."
9387 msgstr ""
9388
9389 # type: =head2
9390 #. type: =head2
9391 #: ../src/guestfs-actions.pod:1413
9392 msgid "guestfs_exists"
9393 msgstr ""
9394
9395 # type: verbatim
9396 #. type: verbatim
9397 #: ../src/guestfs-actions.pod:1415
9398 #, no-wrap
9399 msgid ""
9400 " int\n"
9401 " guestfs_exists (guestfs_h *g,\n"
9402 "                 const char *path);\n"
9403 "\n"
9404 msgstr ""
9405
9406 # type: textblock
9407 #. type: textblock
9408 #: ../src/guestfs-actions.pod:1419 ../fish/guestfish-actions.pod:936
9409 msgid ""
9410 "This returns C<true> if and only if there is a file, directory (or anything) "
9411 "with the given C<path> name."
9412 msgstr ""
9413
9414 # type: textblock
9415 #. type: textblock
9416 #: ../src/guestfs-actions.pod:1422
9417 msgid "See also C<guestfs_is_file>, C<guestfs_is_dir>, C<guestfs_stat>."
9418 msgstr ""
9419
9420 # type: =head2
9421 #. type: =head2
9422 #: ../src/guestfs-actions.pod:1428
9423 msgid "guestfs_fallocate"
9424 msgstr ""
9425
9426 # type: verbatim
9427 #. type: verbatim
9428 #: ../src/guestfs-actions.pod:1430
9429 #, no-wrap
9430 msgid ""
9431 " int\n"
9432 " guestfs_fallocate (guestfs_h *g,\n"
9433 "                    const char *path,\n"
9434 "                    int len);\n"
9435 "\n"
9436 msgstr ""
9437
9438 # type: textblock
9439 #. type: textblock
9440 #: ../src/guestfs-actions.pod:1435 ../src/guestfs-actions.pod:1461
9441 #: ../fish/guestfish-actions.pod:945 ../fish/guestfish-actions.pod:964
9442 msgid ""
9443 "This command preallocates a file (containing zero bytes) named C<path> of "
9444 "size C<len> bytes.  If the file exists already, it is overwritten."
9445 msgstr ""
9446
9447 # type: textblock
9448 #. type: textblock
9449 #: ../src/guestfs-actions.pod:1439 ../fish/guestfish-actions.pod:949
9450 msgid ""
9451 "Do not confuse this with the guestfish-specific C<alloc> command which "
9452 "allocates a file in the host and attaches it as a device."
9453 msgstr ""
9454
9455 # type: textblock
9456 #. type: textblock
9457 #: ../src/guestfs-actions.pod:1445 ../fish/guestfish-actions.pod:953
9458 msgid ""
9459 "This function is deprecated.  In new code, use the C<fallocate64> call "
9460 "instead."
9461 msgstr ""
9462
9463 # type: =head2
9464 #. type: =head2
9465 #: ../src/guestfs-actions.pod:1454
9466 msgid "guestfs_fallocate64"
9467 msgstr ""
9468
9469 # type: verbatim
9470 #. type: verbatim
9471 #: ../src/guestfs-actions.pod:1456
9472 #, no-wrap
9473 msgid ""
9474 " int\n"
9475 " guestfs_fallocate64 (guestfs_h *g,\n"
9476 "                      const char *path,\n"
9477 "                      int64_t len);\n"
9478 "\n"
9479 msgstr ""
9480
9481 # type: textblock
9482 #. type: textblock
9483 #: ../src/guestfs-actions.pod:1465
9484 msgid ""
9485 "Note that this call allocates disk blocks for the file.  To create a sparse "
9486 "file use C<guestfs_truncate_size> instead."
9487 msgstr ""
9488
9489 # type: textblock
9490 #. type: textblock
9491 #: ../src/guestfs-actions.pod:1468
9492 msgid ""
9493 "The deprecated call C<guestfs_fallocate> does the same, but owing to an "
9494 "oversight it only allowed 30 bit lengths to be specified, effectively "
9495 "limiting the maximum size of files created through that call to 1GB."
9496 msgstr ""
9497
9498 # type: textblock
9499 #. type: textblock
9500 #: ../src/guestfs-actions.pod:1473 ../fish/guestfish-actions.pod:976
9501 msgid ""
9502 "Do not confuse this with the guestfish-specific C<alloc> and C<sparse> "
9503 "commands which create a file in the host and attach it as a device."
9504 msgstr ""
9505
9506 # type: textblock
9507 #. type: textblock
9508 #: ../src/guestfs-actions.pod:1479
9509 msgid "(Added in 1.3.17)"
9510 msgstr ""
9511
9512 # type: =head2
9513 #. type: =head2
9514 #: ../src/guestfs-actions.pod:1481
9515 msgid "guestfs_fgrep"
9516 msgstr ""
9517
9518 # type: verbatim
9519 #. type: verbatim
9520 #: ../src/guestfs-actions.pod:1483
9521 #, no-wrap
9522 msgid ""
9523 " char **\n"
9524 " guestfs_fgrep (guestfs_h *g,\n"
9525 "                const char *pattern,\n"
9526 "                const char *path);\n"
9527 "\n"
9528 msgstr ""
9529
9530 # type: textblock
9531 #. type: textblock
9532 #: ../src/guestfs-actions.pod:1488 ../fish/guestfish-actions.pod:984
9533 msgid ""
9534 "This calls the external C<fgrep> program and returns the matching lines."
9535 msgstr ""
9536
9537 # type: =head2
9538 #. type: =head2
9539 #: ../src/guestfs-actions.pod:1500
9540 msgid "guestfs_fgrepi"
9541 msgstr ""
9542
9543 # type: verbatim
9544 #. type: verbatim
9545 #: ../src/guestfs-actions.pod:1502
9546 #, no-wrap
9547 msgid ""
9548 " char **\n"
9549 " guestfs_fgrepi (guestfs_h *g,\n"
9550 "                 const char *pattern,\n"
9551 "                 const char *path);\n"
9552 "\n"
9553 msgstr ""
9554
9555 # type: textblock
9556 #. type: textblock
9557 #: ../src/guestfs-actions.pod:1507 ../fish/guestfish-actions.pod:994
9558 msgid ""
9559 "This calls the external C<fgrep -i> program and returns the matching lines."
9560 msgstr ""
9561
9562 # type: =head2
9563 #. type: =head2
9564 #: ../src/guestfs-actions.pod:1519
9565 msgid "guestfs_file"
9566 msgstr ""
9567
9568 # type: verbatim
9569 #. type: verbatim
9570 #: ../src/guestfs-actions.pod:1521
9571 #, no-wrap
9572 msgid ""
9573 " char *\n"
9574 " guestfs_file (guestfs_h *g,\n"
9575 "               const char *path);\n"
9576 "\n"
9577 msgstr ""
9578
9579 # type: textblock
9580 #. type: textblock
9581 #: ../src/guestfs-actions.pod:1525 ../fish/guestfish-actions.pod:1004
9582 msgid ""
9583 "This call uses the standard L<file(1)> command to determine the type or "
9584 "contents of the file."
9585 msgstr ""
9586
9587 # type: textblock
9588 #. type: textblock
9589 #: ../src/guestfs-actions.pod:1528 ../fish/guestfish-actions.pod:1007
9590 msgid ""
9591 "This call will also transparently look inside various types of compressed "
9592 "file."
9593 msgstr ""
9594
9595 #. type: textblock
9596 #: ../src/guestfs-actions.pod:1531 ../fish/guestfish-actions.pod:1010
9597 msgid ""
9598 "The exact command which runs is C<file -zb path>.  Note in particular that "
9599 "the filename is not prepended to the output (the I<-b> option)."
9600 msgstr ""
9601
9602 #. type: textblock
9603 #: ../src/guestfs-actions.pod:1535 ../fish/guestfish-actions.pod:1014
9604 msgid ""
9605 "The output depends on the output of the underlying L<file(1)> command and it "
9606 "can change in future in ways beyond our control.  In other words, the output "
9607 "is not guaranteed by the ABI."
9608 msgstr ""
9609
9610 #. type: textblock
9611 #: ../src/guestfs-actions.pod:1539
9612 msgid ""
9613 "See also: L<file(1)>, C<guestfs_vfs_type>, C<guestfs_lstat>, "
9614 "C<guestfs_is_file>, C<guestfs_is_blockdev> (etc)."
9615 msgstr ""
9616
9617 # type: =head2
9618 #. type: =head2
9619 #: ../src/guestfs-actions.pod:1547
9620 msgid "guestfs_file_architecture"
9621 msgstr ""
9622
9623 # type: verbatim
9624 #. type: verbatim
9625 #: ../src/guestfs-actions.pod:1549
9626 #, no-wrap
9627 msgid ""
9628 " char *\n"
9629 " guestfs_file_architecture (guestfs_h *g,\n"
9630 "                            const char *filename);\n"
9631 "\n"
9632 msgstr ""
9633
9634 # type: textblock
9635 #. type: textblock
9636 #: ../src/guestfs-actions.pod:1553 ../fish/guestfish-actions.pod:1025
9637 msgid ""
9638 "This detects the architecture of the binary C<filename>, and returns it if "
9639 "known."
9640 msgstr ""
9641
9642 # type: textblock
9643 #. type: textblock
9644 #: ../src/guestfs-actions.pod:1556 ../fish/guestfish-actions.pod:1028
9645 msgid "Currently defined architectures are:"
9646 msgstr ""
9647
9648 # type: =item
9649 #. type: =item
9650 #: ../src/guestfs-actions.pod:1560 ../fish/guestfish-actions.pod:1032
9651 msgid "\"i386\""
9652 msgstr ""
9653
9654 # type: textblock
9655 #. type: textblock
9656 #: ../src/guestfs-actions.pod:1562 ../fish/guestfish-actions.pod:1034
9657 msgid ""
9658 "This string is returned for all 32 bit i386, i486, i586, i686 binaries "
9659 "irrespective of the precise processor requirements of the binary."
9660 msgstr ""
9661
9662 # type: =item
9663 #. type: =item
9664 #: ../src/guestfs-actions.pod:1565 ../fish/guestfish-actions.pod:1037
9665 msgid "\"x86_64\""
9666 msgstr ""
9667
9668 # type: textblock
9669 #. type: textblock
9670 #: ../src/guestfs-actions.pod:1567 ../fish/guestfish-actions.pod:1039
9671 msgid "64 bit x86-64."
9672 msgstr ""
9673
9674 # type: =item
9675 #. type: =item
9676 #: ../src/guestfs-actions.pod:1569 ../fish/guestfish-actions.pod:1041
9677 msgid "\"sparc\""
9678 msgstr ""
9679
9680 # type: textblock
9681 #. type: textblock
9682 #: ../src/guestfs-actions.pod:1571 ../fish/guestfish-actions.pod:1043
9683 msgid "32 bit SPARC."
9684 msgstr ""
9685
9686 # type: =item
9687 #. type: =item
9688 #: ../src/guestfs-actions.pod:1573 ../fish/guestfish-actions.pod:1045
9689 msgid "\"sparc64\""
9690 msgstr ""
9691
9692 # type: textblock
9693 #. type: textblock
9694 #: ../src/guestfs-actions.pod:1575 ../fish/guestfish-actions.pod:1047
9695 msgid "64 bit SPARC V9 and above."
9696 msgstr ""
9697
9698 # type: =item
9699 #. type: =item
9700 #: ../src/guestfs-actions.pod:1577 ../fish/guestfish-actions.pod:1049
9701 msgid "\"ia64\""
9702 msgstr ""
9703
9704 # type: textblock
9705 #. type: textblock
9706 #: ../src/guestfs-actions.pod:1579 ../fish/guestfish-actions.pod:1051
9707 msgid "Intel Itanium."
9708 msgstr ""
9709
9710 # type: =item
9711 #. type: =item
9712 #: ../src/guestfs-actions.pod:1581 ../fish/guestfish-actions.pod:1053
9713 msgid "\"ppc\""
9714 msgstr ""
9715
9716 # type: textblock
9717 #. type: textblock
9718 #: ../src/guestfs-actions.pod:1583 ../fish/guestfish-actions.pod:1055
9719 msgid "32 bit Power PC."
9720 msgstr ""
9721
9722 # type: =item
9723 #. type: =item
9724 #: ../src/guestfs-actions.pod:1585 ../fish/guestfish-actions.pod:1057
9725 msgid "\"ppc64\""
9726 msgstr ""
9727
9728 # type: textblock
9729 #. type: textblock
9730 #: ../src/guestfs-actions.pod:1587 ../fish/guestfish-actions.pod:1059
9731 msgid "64 bit Power PC."
9732 msgstr ""
9733
9734 # type: textblock
9735 #. type: textblock
9736 #: ../src/guestfs-actions.pod:1591 ../fish/guestfish-actions.pod:1063
9737 msgid "Libguestfs may return other architecture strings in future."
9738 msgstr ""
9739
9740 # type: textblock
9741 #. type: textblock
9742 #: ../src/guestfs-actions.pod:1593 ../fish/guestfish-actions.pod:1065
9743 msgid "The function works on at least the following types of files:"
9744 msgstr ""
9745
9746 # type: textblock
9747 #. type: textblock
9748 #: ../src/guestfs-actions.pod:1599 ../fish/guestfish-actions.pod:1071
9749 msgid "many types of Un*x and Linux binary"
9750 msgstr ""
9751
9752 # type: textblock
9753 #. type: textblock
9754 #: ../src/guestfs-actions.pod:1603 ../fish/guestfish-actions.pod:1075
9755 msgid "many types of Un*x and Linux shared library"
9756 msgstr ""
9757
9758 # type: textblock
9759 #. type: textblock
9760 #: ../src/guestfs-actions.pod:1607 ../fish/guestfish-actions.pod:1079
9761 msgid "Windows Win32 and Win64 binaries"
9762 msgstr ""
9763
9764 # type: textblock
9765 #. type: textblock
9766 #: ../src/guestfs-actions.pod:1611 ../fish/guestfish-actions.pod:1083
9767 msgid "Windows Win32 and Win64 DLLs"
9768 msgstr ""
9769
9770 # type: textblock
9771 #. type: textblock
9772 #: ../src/guestfs-actions.pod:1613 ../fish/guestfish-actions.pod:1085
9773 msgid "Win32 binaries and DLLs return C<i386>."
9774 msgstr ""
9775
9776 # type: textblock
9777 #. type: textblock
9778 #: ../src/guestfs-actions.pod:1615 ../fish/guestfish-actions.pod:1087
9779 msgid "Win64 binaries and DLLs return C<x86_64>."
9780 msgstr ""
9781
9782 # type: textblock
9783 #. type: textblock
9784 #: ../src/guestfs-actions.pod:1619 ../fish/guestfish-actions.pod:1091
9785 msgid "Linux kernel modules"
9786 msgstr ""
9787
9788 # type: textblock
9789 #. type: textblock
9790 #: ../src/guestfs-actions.pod:1623 ../fish/guestfish-actions.pod:1095
9791 msgid "Linux new-style initrd images"
9792 msgstr ""
9793
9794 # type: textblock
9795 #. type: textblock
9796 #: ../src/guestfs-actions.pod:1627 ../fish/guestfish-actions.pod:1099
9797 msgid "some non-x86 Linux vmlinuz kernels"
9798 msgstr ""
9799
9800 # type: textblock
9801 #. type: textblock
9802 #: ../src/guestfs-actions.pod:1631 ../fish/guestfish-actions.pod:1103
9803 msgid "What it can't do currently:"
9804 msgstr ""
9805
9806 # type: textblock
9807 #. type: textblock
9808 #: ../src/guestfs-actions.pod:1637 ../fish/guestfish-actions.pod:1109
9809 msgid "static libraries (libfoo.a)"
9810 msgstr ""
9811
9812 # type: textblock
9813 #. type: textblock
9814 #: ../src/guestfs-actions.pod:1641 ../fish/guestfish-actions.pod:1113
9815 msgid "Linux old-style initrd as compressed ext2 filesystem (RHEL 3)"
9816 msgstr ""
9817
9818 # type: textblock
9819 #. type: textblock
9820 #: ../src/guestfs-actions.pod:1645 ../fish/guestfish-actions.pod:1117
9821 msgid "x86 Linux vmlinuz kernels"
9822 msgstr ""
9823
9824 # type: textblock
9825 #. type: textblock
9826 #: ../src/guestfs-actions.pod:1647 ../fish/guestfish-actions.pod:1119
9827 msgid ""
9828 "x86 vmlinuz images (bzImage format) consist of a mix of 16-, 32- and "
9829 "compressed code, and are horribly hard to unpack.  If you want to find the "
9830 "architecture of a kernel, use the architecture of the associated initrd or "
9831 "kernel module(s) instead."
9832 msgstr ""
9833
9834 # type: textblock
9835 #. type: textblock
9836 #: ../src/guestfs-actions.pod:1657 ../src/guestfs-actions.pod:1820
9837 #: ../src/guestfs-actions.pod:1837 ../src/guestfs-actions.pod:2528
9838 #: ../src/guestfs-actions.pod:2621 ../src/guestfs-actions.pod:2691
9839 #: ../src/guestfs-actions.pod:2779 ../src/guestfs-actions.pod:2800
9840 #: ../src/guestfs-actions.pod:2843 ../src/guestfs-actions.pod:2927
9841 #: ../src/guestfs-actions.pod:3024 ../src/guestfs-actions.pod:3271
9842 #: ../src/guestfs-actions.pod:3403
9843 msgid "(Added in 1.5.3)"
9844 msgstr ""
9845
9846 # type: =head2
9847 #. type: =head2
9848 #: ../src/guestfs-actions.pod:1659
9849 msgid "guestfs_filesize"
9850 msgstr ""
9851
9852 # type: verbatim
9853 #. type: verbatim
9854 #: ../src/guestfs-actions.pod:1661
9855 #, no-wrap
9856 msgid ""
9857 " int64_t\n"
9858 " guestfs_filesize (guestfs_h *g,\n"
9859 "                   const char *file);\n"
9860 "\n"
9861 msgstr ""
9862
9863 # type: textblock
9864 #. type: textblock
9865 #: ../src/guestfs-actions.pod:1665 ../fish/guestfish-actions.pod:1130
9866 msgid "This command returns the size of C<file> in bytes."
9867 msgstr ""
9868
9869 # type: textblock
9870 #. type: textblock
9871 #: ../src/guestfs-actions.pod:1667
9872 msgid ""
9873 "To get other stats about a file, use C<guestfs_stat>, C<guestfs_lstat>, "
9874 "C<guestfs_is_dir>, C<guestfs_is_file> etc.  To get the size of block "
9875 "devices, use C<guestfs_blockdev_getsize64>."
9876 msgstr ""
9877
9878 # type: textblock
9879 #. type: textblock
9880 #: ../src/guestfs-actions.pod:1673
9881 msgid "(Added in 1.0.82)"
9882 msgstr ""
9883
9884 # type: =head2
9885 #. type: =head2
9886 #: ../src/guestfs-actions.pod:1675
9887 msgid "guestfs_fill"
9888 msgstr ""
9889
9890 # type: verbatim
9891 #. type: verbatim
9892 #: ../src/guestfs-actions.pod:1677
9893 #, no-wrap
9894 msgid ""
9895 " int\n"
9896 " guestfs_fill (guestfs_h *g,\n"
9897 "               int c,\n"
9898 "               int len,\n"
9899 "               const char *path);\n"
9900 "\n"
9901 msgstr ""
9902
9903 # type: textblock
9904 #. type: textblock
9905 #: ../src/guestfs-actions.pod:1683 ../fish/guestfish-actions.pod:1140
9906 msgid ""
9907 "This command creates a new file called C<path>.  The initial content of the "
9908 "file is C<len> octets of C<c>, where C<c> must be a number in the range C<"
9909 "[0..255]>."
9910 msgstr ""
9911
9912 # type: textblock
9913 #. type: textblock
9914 #: ../src/guestfs-actions.pod:1687
9915 msgid ""
9916 "To fill a file with zero bytes (sparsely), it is much more efficient to use "
9917 "C<guestfs_truncate_size>.  To create a file with a pattern of repeating "
9918 "bytes use C<guestfs_fill_pattern>."
9919 msgstr ""
9920
9921 # type: textblock
9922 #. type: textblock
9923 #: ../src/guestfs-actions.pod:1699
9924 msgid "(Added in 1.0.79)"
9925 msgstr ""
9926
9927 # type: =head2
9928 #. type: =head2
9929 #: ../src/guestfs-actions.pod:1701
9930 msgid "guestfs_fill_pattern"
9931 msgstr ""
9932
9933 # type: verbatim
9934 #. type: verbatim
9935 #: ../src/guestfs-actions.pod:1703
9936 #, no-wrap
9937 msgid ""
9938 " int\n"
9939 " guestfs_fill_pattern (guestfs_h *g,\n"
9940 "                       const char *pattern,\n"
9941 "                       int len,\n"
9942 "                       const char *path);\n"
9943 "\n"
9944 msgstr ""
9945
9946 # type: textblock
9947 #. type: textblock
9948 #: ../src/guestfs-actions.pod:1709
9949 msgid ""
9950 "This function is like C<guestfs_fill> except that it creates a new file of "
9951 "length C<len> containing the repeating pattern of bytes in C<pattern>.  The "
9952 "pattern is truncated if necessary to ensure the length of the file is "
9953 "exactly C<len> bytes."
9954 msgstr ""
9955
9956 # type: textblock
9957 #. type: textblock
9958 #: ../src/guestfs-actions.pod:1721
9959 msgid "(Added in 1.3.12)"
9960 msgstr ""
9961
9962 # type: =head2
9963 #. type: =head2
9964 #: ../src/guestfs-actions.pod:1723
9965 msgid "guestfs_find"
9966 msgstr ""
9967
9968 # type: verbatim
9969 #. type: verbatim
9970 #: ../src/guestfs-actions.pod:1725
9971 #, no-wrap
9972 msgid ""
9973 " char **\n"
9974 " guestfs_find (guestfs_h *g,\n"
9975 "               const char *directory);\n"
9976 "\n"
9977 msgstr ""
9978
9979 # type: textblock
9980 #. type: textblock
9981 #: ../src/guestfs-actions.pod:1729 ../fish/guestfish-actions.pod:1162
9982 msgid ""
9983 "This command lists out all files and directories, recursively, starting at "
9984 "C<directory>.  It is essentially equivalent to running the shell command "
9985 "C<find directory -print> but some post-processing happens on the output, "
9986 "described below."
9987 msgstr ""
9988
9989 # type: textblock
9990 #. type: textblock
9991 #: ../src/guestfs-actions.pod:1734 ../fish/guestfish-actions.pod:1167
9992 msgid ""
9993 "This returns a list of strings I<without any prefix>.  Thus if the directory "
9994 "structure was:"
9995 msgstr ""
9996
9997 # type: verbatim
9998 #. type: verbatim
9999 #: ../src/guestfs-actions.pod:1737 ../fish/guestfish-actions.pod:1170
10000 #, no-wrap
10001 msgid ""
10002 " /tmp/a\n"
10003 " /tmp/b\n"
10004 " /tmp/c/d\n"
10005 "\n"
10006 msgstr ""
10007
10008 # type: textblock
10009 #. type: textblock
10010 #: ../src/guestfs-actions.pod:1741
10011 msgid ""
10012 "then the returned list from C<guestfs_find> C</tmp> would be 4 elements:"
10013 msgstr ""
10014
10015 # type: verbatim
10016 #. type: verbatim
10017 #: ../src/guestfs-actions.pod:1744 ../fish/guestfish-actions.pod:1177
10018 #, no-wrap
10019 msgid ""
10020 " a\n"
10021 " b\n"
10022 " c\n"
10023 " c/d\n"
10024 "\n"
10025 msgstr ""
10026
10027 # type: textblock
10028 #. type: textblock
10029 #: ../src/guestfs-actions.pod:1749 ../fish/guestfish-actions.pod:1182
10030 msgid "If C<directory> is not a directory, then this command returns an error."
10031 msgstr ""
10032
10033 # type: textblock
10034 #. type: textblock
10035 #: ../src/guestfs-actions.pod:1752 ../fish/guestfish-actions.pod:1185
10036 msgid "The returned list is sorted."
10037 msgstr ""
10038
10039 # type: textblock
10040 #. type: textblock
10041 #: ../src/guestfs-actions.pod:1754
10042 msgid "See also C<guestfs_find0>."
10043 msgstr ""
10044
10045 # type: textblock
10046 #. type: textblock
10047 #: ../src/guestfs-actions.pod:1763 ../src/guestfs-actions.pod:4097
10048 #: ../src/guestfs-actions.pod:5656
10049 msgid "(Added in 1.0.27)"
10050 msgstr ""
10051
10052 # type: =head2
10053 #. type: =head2
10054 #: ../src/guestfs-actions.pod:1765
10055 msgid "guestfs_find0"
10056 msgstr ""
10057
10058 # type: verbatim
10059 #. type: verbatim
10060 #: ../src/guestfs-actions.pod:1767
10061 #, no-wrap
10062 msgid ""
10063 " int\n"
10064 " guestfs_find0 (guestfs_h *g,\n"
10065 "                const char *directory,\n"
10066 "                const char *files);\n"
10067 "\n"
10068 msgstr ""
10069
10070 # type: textblock
10071 #. type: textblock
10072 #: ../src/guestfs-actions.pod:1772 ../fish/guestfish-actions.pod:1196
10073 msgid ""
10074 "This command lists out all files and directories, recursively, starting at "
10075 "C<directory>, placing the resulting list in the external file called "
10076 "C<files>."
10077 msgstr ""
10078
10079 # type: textblock
10080 #. type: textblock
10081 #: ../src/guestfs-actions.pod:1776
10082 msgid ""
10083 "This command works the same way as C<guestfs_find> with the following "
10084 "exceptions:"
10085 msgstr ""
10086
10087 # type: textblock
10088 #. type: textblock
10089 #: ../src/guestfs-actions.pod:1783 ../fish/guestfish-actions.pod:1207
10090 msgid "The resulting list is written to an external file."
10091 msgstr ""
10092
10093 # type: textblock
10094 #. type: textblock
10095 #: ../src/guestfs-actions.pod:1787 ../fish/guestfish-actions.pod:1211
10096 msgid ""
10097 "Items (filenames) in the result are separated by C<\\0> characters.  See "
10098 "L<find(1)> option I<-print0>."
10099 msgstr ""
10100
10101 # type: textblock
10102 #. type: textblock
10103 #: ../src/guestfs-actions.pod:1792 ../fish/guestfish-actions.pod:1216
10104 msgid "This command is not limited in the number of names that it can return."
10105 msgstr ""
10106
10107 # type: textblock
10108 #. type: textblock
10109 #: ../src/guestfs-actions.pod:1797 ../fish/guestfish-actions.pod:1221
10110 msgid "The result list is not sorted."
10111 msgstr ""
10112
10113 # type: textblock
10114 #. type: textblock
10115 #: ../src/guestfs-actions.pod:1803
10116 msgid "(Added in 1.0.74)"
10117 msgstr ""
10118
10119 # type: =head2
10120 #. type: =head2
10121 #: ../src/guestfs-actions.pod:1805
10122 msgid "guestfs_findfs_label"
10123 msgstr ""
10124
10125 # type: verbatim
10126 #. type: verbatim
10127 #: ../src/guestfs-actions.pod:1807
10128 #, no-wrap
10129 msgid ""
10130 " char *\n"
10131 " guestfs_findfs_label (guestfs_h *g,\n"
10132 "                       const char *label);\n"
10133 "\n"
10134 msgstr ""
10135
10136 # type: textblock
10137 #. type: textblock
10138 #: ../src/guestfs-actions.pod:1811 ../fish/guestfish-actions.pod:1231
10139 msgid ""
10140 "This command searches the filesystems and returns the one which has the "
10141 "given label.  An error is returned if no such filesystem can be found."
10142 msgstr ""
10143
10144 # type: textblock
10145 #. type: textblock
10146 #: ../src/guestfs-actions.pod:1815
10147 msgid "To find the label of a filesystem, use C<guestfs_vfs_label>."
10148 msgstr ""
10149
10150 # type: =head2
10151 #. type: =head2
10152 #: ../src/guestfs-actions.pod:1822
10153 msgid "guestfs_findfs_uuid"
10154 msgstr ""
10155
10156 # type: verbatim
10157 #. type: verbatim
10158 #: ../src/guestfs-actions.pod:1824
10159 #, no-wrap
10160 msgid ""
10161 " char *\n"
10162 " guestfs_findfs_uuid (guestfs_h *g,\n"
10163 "                      const char *uuid);\n"
10164 "\n"
10165 msgstr ""
10166
10167 # type: textblock
10168 #. type: textblock
10169 #: ../src/guestfs-actions.pod:1828 ../fish/guestfish-actions.pod:1241
10170 msgid ""
10171 "This command searches the filesystems and returns the one which has the "
10172 "given UUID.  An error is returned if no such filesystem can be found."
10173 msgstr ""
10174
10175 # type: textblock
10176 #. type: textblock
10177 #: ../src/guestfs-actions.pod:1832
10178 msgid "To find the UUID of a filesystem, use C<guestfs_vfs_uuid>."
10179 msgstr ""
10180
10181 # type: =head2
10182 #. type: =head2
10183 #: ../src/guestfs-actions.pod:1839
10184 msgid "guestfs_fsck"
10185 msgstr ""
10186
10187 # type: verbatim
10188 #. type: verbatim
10189 #: ../src/guestfs-actions.pod:1841
10190 #, no-wrap
10191 msgid ""
10192 " int\n"
10193 " guestfs_fsck (guestfs_h *g,\n"
10194 "               const char *fstype,\n"
10195 "               const char *device);\n"
10196 "\n"
10197 msgstr ""
10198
10199 # type: textblock
10200 #. type: textblock
10201 #: ../src/guestfs-actions.pod:1846 ../fish/guestfish-actions.pod:1251
10202 msgid ""
10203 "This runs the filesystem checker (fsck) on C<device> which should have "
10204 "filesystem type C<fstype>."
10205 msgstr ""
10206
10207 # type: textblock
10208 #. type: textblock
10209 #: ../src/guestfs-actions.pod:1849 ../fish/guestfish-actions.pod:1254
10210 msgid ""
10211 "The returned integer is the status.  See L<fsck(8)> for the list of status "
10212 "codes from C<fsck>."
10213 msgstr ""
10214
10215 # type: textblock
10216 #. type: textblock
10217 #: ../src/guestfs-actions.pod:1858 ../fish/guestfish-actions.pod:1263
10218 msgid "Multiple status codes can be summed together."
10219 msgstr ""
10220
10221 # type: textblock
10222 #. type: textblock
10223 #: ../src/guestfs-actions.pod:1862 ../fish/guestfish-actions.pod:1267
10224 msgid ""
10225 "A non-zero return code can mean \"success\", for example if errors have been "
10226 "corrected on the filesystem."
10227 msgstr ""
10228
10229 # type: textblock
10230 #. type: textblock
10231 #: ../src/guestfs-actions.pod:1867 ../fish/guestfish-actions.pod:1272
10232 msgid "Checking or repairing NTFS volumes is not supported (by linux-ntfs)."
10233 msgstr ""
10234
10235 # type: textblock
10236 #. type: textblock
10237 #: ../src/guestfs-actions.pod:1872 ../fish/guestfish-actions.pod:1277
10238 msgid ""
10239 "This command is entirely equivalent to running C<fsck -a -t fstype device>."
10240 msgstr ""
10241
10242 # type: textblock
10243 #. type: textblock
10244 #: ../src/guestfs-actions.pod:1876 ../src/guestfs-actions.pod:7387
10245 msgid "(Added in 1.0.16)"
10246 msgstr ""
10247
10248 # type: =head2
10249 #. type: =head2
10250 #: ../src/guestfs-actions.pod:1878
10251 msgid "guestfs_get_append"
10252 msgstr ""
10253
10254 # type: verbatim
10255 #. type: verbatim
10256 #: ../src/guestfs-actions.pod:1880
10257 #, no-wrap
10258 msgid ""
10259 " const char *\n"
10260 " guestfs_get_append (guestfs_h *g);\n"
10261 "\n"
10262 msgstr ""
10263
10264 # type: textblock
10265 #. type: textblock
10266 #: ../src/guestfs-actions.pod:1883 ../fish/guestfish-actions.pod:1283
10267 msgid ""
10268 "Return the additional kernel options which are added to the guest kernel "
10269 "command line."
10270 msgstr ""
10271
10272 # type: textblock
10273 #. type: textblock
10274 #: ../src/guestfs-actions.pod:1886 ../fish/guestfish-actions.pod:1286
10275 msgid "If C<NULL> then no options are added."
10276 msgstr ""
10277
10278 # type: textblock
10279 #. type: textblock
10280 #: ../src/guestfs-actions.pod:1888
10281 msgid ""
10282 "This function returns a string which may be NULL.  There is no way to return "
10283 "an error from this function.  The string is owned by the guest handle and "
10284 "must I<not> be freed."
10285 msgstr ""
10286
10287 # type: textblock
10288 #. type: textblock
10289 #: ../src/guestfs-actions.pod:1892 ../src/guestfs-actions.pod:5334
10290 #: ../src/guestfs-actions.pod:5814 ../src/guestfs-actions.pod:6235
10291 #: ../src/guestfs-actions.pod:6254 ../src/guestfs-actions.pod:6270
10292 #: ../src/guestfs-actions.pod:6294 ../src/guestfs-actions.pod:7051
10293 #: ../src/guestfs-actions.pod:7069 ../src/guestfs-actions.pod:7430
10294 msgid "(Added in 1.0.26)"
10295 msgstr ""
10296
10297 #. type: =head2
10298 #: ../src/guestfs-actions.pod:1894
10299 msgid "guestfs_get_attach_method"
10300 msgstr ""
10301
10302 #. type: verbatim
10303 #: ../src/guestfs-actions.pod:1896
10304 #, no-wrap
10305 msgid ""
10306 " char *\n"
10307 " guestfs_get_attach_method (guestfs_h *g);\n"
10308 "\n"
10309 msgstr ""
10310
10311 #. type: textblock
10312 #: ../src/guestfs-actions.pod:1899
10313 msgid "Return the current attach method.  See C<guestfs_set_attach_method>."
10314 msgstr ""
10315
10316 # type: =head2
10317 #. type: =head2
10318 #: ../src/guestfs-actions.pod:1904
10319 msgid "guestfs_get_autosync"
10320 msgstr ""
10321
10322 # type: verbatim
10323 #. type: verbatim
10324 #: ../src/guestfs-actions.pod:1906
10325 #, no-wrap
10326 msgid ""
10327 " int\n"
10328 " guestfs_get_autosync (guestfs_h *g);\n"
10329 "\n"
10330 msgstr ""
10331
10332 # type: textblock
10333 #. type: textblock
10334 #: ../src/guestfs-actions.pod:1909 ../fish/guestfish-actions.pod:1298
10335 msgid "Get the autosync flag."
10336 msgstr ""
10337
10338 # type: =head2
10339 #. type: =head2
10340 #: ../src/guestfs-actions.pod:1915
10341 msgid "guestfs_get_direct"
10342 msgstr ""
10343
10344 # type: verbatim
10345 #. type: verbatim
10346 #: ../src/guestfs-actions.pod:1917
10347 #, no-wrap
10348 msgid ""
10349 " int\n"
10350 " guestfs_get_direct (guestfs_h *g);\n"
10351 "\n"
10352 msgstr ""
10353
10354 # type: textblock
10355 #. type: textblock
10356 #: ../src/guestfs-actions.pod:1920 ../fish/guestfish-actions.pod:1304
10357 msgid "Return the direct appliance mode flag."
10358 msgstr ""
10359
10360 # type: textblock
10361 #. type: textblock
10362 #: ../src/guestfs-actions.pod:1924 ../src/guestfs-actions.pod:5883
10363 msgid "(Added in 1.0.72)"
10364 msgstr ""
10365
10366 # type: =head2
10367 #. type: =head2
10368 #: ../src/guestfs-actions.pod:1926
10369 msgid "guestfs_get_e2label"
10370 msgstr ""
10371
10372 # type: verbatim
10373 #. type: verbatim
10374 #: ../src/guestfs-actions.pod:1928
10375 #, no-wrap
10376 msgid ""
10377 " char *\n"
10378 " guestfs_get_e2label (guestfs_h *g,\n"
10379 "                      const char *device);\n"
10380 "\n"
10381 msgstr ""
10382
10383 # type: textblock
10384 #. type: textblock
10385 #: ../src/guestfs-actions.pod:1932 ../fish/guestfish-actions.pod:1310
10386 msgid ""
10387 "This returns the ext2/3/4 filesystem label of the filesystem on C<device>."
10388 msgstr ""
10389
10390 # type: textblock
10391 #. type: textblock
10392 #: ../src/guestfs-actions.pod:1938 ../fish/guestfish-actions.pod:1313
10393 msgid ""
10394 "This function is deprecated.  In new code, use the C<vfs_label> call instead."
10395 msgstr ""
10396
10397 # type: textblock
10398 #. type: textblock
10399 #: ../src/guestfs-actions.pod:1945 ../src/guestfs-actions.pod:1966
10400 #: ../src/guestfs-actions.pod:5901 ../src/guestfs-actions.pod:5920
10401 msgid "(Added in 1.0.15)"
10402 msgstr ""
10403
10404 # type: =head2
10405 #. type: =head2
10406 #: ../src/guestfs-actions.pod:1947
10407 msgid "guestfs_get_e2uuid"
10408 msgstr ""
10409
10410 # type: verbatim
10411 #. type: verbatim
10412 #: ../src/guestfs-actions.pod:1949
10413 #, no-wrap
10414 msgid ""
10415 " char *\n"
10416 " guestfs_get_e2uuid (guestfs_h *g,\n"
10417 "                     const char *device);\n"
10418 "\n"
10419 msgstr ""
10420
10421 # type: textblock
10422 #. type: textblock
10423 #: ../src/guestfs-actions.pod:1953 ../fish/guestfish-actions.pod:1324
10424 msgid ""
10425 "This returns the ext2/3/4 filesystem UUID of the filesystem on C<device>."
10426 msgstr ""
10427
10428 # type: textblock
10429 #. type: textblock
10430 #: ../src/guestfs-actions.pod:1959 ../fish/guestfish-actions.pod:1327
10431 msgid ""
10432 "This function is deprecated.  In new code, use the C<vfs_uuid> call instead."
10433 msgstr ""
10434
10435 # type: =head2
10436 #. type: =head2
10437 #: ../src/guestfs-actions.pod:1968
10438 msgid "guestfs_get_memsize"
10439 msgstr ""
10440
10441 # type: verbatim
10442 #. type: verbatim
10443 #: ../src/guestfs-actions.pod:1970
10444 #, no-wrap
10445 msgid ""
10446 " int\n"
10447 " guestfs_get_memsize (guestfs_h *g);\n"
10448 "\n"
10449 msgstr ""
10450
10451 # type: textblock
10452 #. type: textblock
10453 #: ../src/guestfs-actions.pod:1973 ../fish/guestfish-actions.pod:1338
10454 msgid ""
10455 "This gets the memory size in megabytes allocated to the qemu subprocess."
10456 msgstr ""
10457
10458 # type: textblock
10459 #. type: textblock
10460 #: ../src/guestfs-actions.pod:1976
10461 msgid ""
10462 "If C<guestfs_set_memsize> was not called on this handle, and if "
10463 "C<LIBGUESTFS_MEMSIZE> was not set, then this returns the compiled-in default "
10464 "value for memsize."
10465 msgstr ""
10466
10467 # type: textblock
10468 #. type: textblock
10469 #: ../src/guestfs-actions.pod:1980 ../src/guestfs-actions.pod:2061
10470 #: ../src/guestfs-actions.pod:5936 ../src/guestfs-actions.pod:6043
10471 #: ../fish/guestfish-actions.pod:1345 ../fish/guestfish-actions.pod:1396
10472 #: ../fish/guestfish-actions.pod:4006 ../fish/guestfish-actions.pod:4093
10473 msgid ""
10474 "For more information on the architecture of libguestfs, see L<guestfs(3)>."
10475 msgstr ""
10476
10477 # type: textblock
10478 #. type: textblock
10479 #: ../src/guestfs-actions.pod:1985 ../src/guestfs-actions.pod:4388
10480 #: ../src/guestfs-actions.pod:4585 ../src/guestfs-actions.pod:4604
10481 #: ../src/guestfs-actions.pod:4623 ../src/guestfs-actions.pod:4635
10482 #: ../src/guestfs-actions.pod:4652 ../src/guestfs-actions.pod:4665
10483 #: ../src/guestfs-actions.pod:5559 ../src/guestfs-actions.pod:5941
10484 #: ../src/guestfs-actions.pod:6202 ../src/guestfs-actions.pod:6817
10485 msgid "(Added in 1.0.55)"
10486 msgstr ""
10487
10488 # type: =head2
10489 #. type: =head2
10490 #: ../src/guestfs-actions.pod:1987
10491 msgid "guestfs_get_network"
10492 msgstr ""
10493
10494 # type: verbatim
10495 #. type: verbatim
10496 #: ../src/guestfs-actions.pod:1989
10497 #, no-wrap
10498 msgid ""
10499 " int\n"
10500 " guestfs_get_network (guestfs_h *g);\n"
10501 "\n"
10502 msgstr ""
10503
10504 # type: textblock
10505 #. type: textblock
10506 #: ../src/guestfs-actions.pod:1992 ../fish/guestfish-actions.pod:1352
10507 msgid "This returns the enable network flag."
10508 msgstr ""
10509
10510 # type: textblock
10511 #. type: textblock
10512 #: ../src/guestfs-actions.pod:1996 ../src/guestfs-actions.pod:5960
10513 msgid "(Added in 1.5.4)"
10514 msgstr ""
10515
10516 # type: =head2
10517 #. type: =head2
10518 #: ../src/guestfs-actions.pod:1998
10519 msgid "guestfs_get_path"
10520 msgstr ""
10521
10522 # type: verbatim
10523 #. type: verbatim
10524 #: ../src/guestfs-actions.pod:2000
10525 #, no-wrap
10526 msgid ""
10527 " const char *\n"
10528 " guestfs_get_path (guestfs_h *g);\n"
10529 "\n"
10530 msgstr ""
10531
10532 # type: textblock
10533 #. type: textblock
10534 #: ../src/guestfs-actions.pod:2003 ../fish/guestfish-actions.pod:1358
10535 msgid "Return the current search path."
10536 msgstr ""
10537
10538 # type: textblock
10539 #. type: textblock
10540 #: ../src/guestfs-actions.pod:2005 ../fish/guestfish-actions.pod:1360
10541 msgid ""
10542 "This is always non-NULL.  If it wasn't set already, then this will return "
10543 "the default path."
10544 msgstr ""
10545
10546 # type: textblock
10547 #. type: textblock
10548 #: ../src/guestfs-actions.pod:2008 ../src/guestfs-actions.pod:2037
10549 msgid ""
10550 "This function returns a string, or NULL on error.  The string is owned by "
10551 "the guest handle and must I<not> be freed."
10552 msgstr ""
10553
10554 # type: =head2
10555 #. type: =head2
10556 #: ../src/guestfs-actions.pod:2013
10557 msgid "guestfs_get_pid"
10558 msgstr ""
10559
10560 # type: verbatim
10561 #. type: verbatim
10562 #: ../src/guestfs-actions.pod:2015
10563 #, no-wrap
10564 msgid ""
10565 " int\n"
10566 " guestfs_get_pid (guestfs_h *g);\n"
10567 "\n"
10568 msgstr ""
10569
10570 # type: textblock
10571 #. type: textblock
10572 #: ../src/guestfs-actions.pod:2018 ../fish/guestfish-actions.pod:1369
10573 msgid ""
10574 "Return the process ID of the qemu subprocess.  If there is no qemu "
10575 "subprocess, then this will return an error."
10576 msgstr ""
10577
10578 # type: textblock
10579 #. type: textblock
10580 #: ../src/guestfs-actions.pod:2021 ../fish/guestfish-actions.pod:1372
10581 msgid "This is an internal call used for debugging and testing."
10582 msgstr ""
10583
10584 # type: textblock
10585 #. type: textblock
10586 #: ../src/guestfs-actions.pod:2025
10587 msgid "(Added in 1.0.56)"
10588 msgstr ""
10589
10590 # type: =head2
10591 #. type: =head2
10592 #: ../src/guestfs-actions.pod:2027
10593 msgid "guestfs_get_qemu"
10594 msgstr ""
10595
10596 # type: verbatim
10597 #. type: verbatim
10598 #: ../src/guestfs-actions.pod:2029
10599 #, no-wrap
10600 msgid ""
10601 " const char *\n"
10602 " guestfs_get_qemu (guestfs_h *g);\n"
10603 "\n"
10604 msgstr ""
10605
10606 # type: textblock
10607 #. type: textblock
10608 #: ../src/guestfs-actions.pod:2032 ../fish/guestfish-actions.pod:1378
10609 msgid "Return the current qemu binary."
10610 msgstr ""
10611
10612 # type: textblock
10613 #. type: textblock
10614 #: ../src/guestfs-actions.pod:2034 ../fish/guestfish-actions.pod:1380
10615 msgid ""
10616 "This is always non-NULL.  If it wasn't set already, then this will return "
10617 "the default qemu binary name."
10618 msgstr ""
10619
10620 # type: textblock
10621 #. type: textblock
10622 #: ../src/guestfs-actions.pod:2040 ../src/guestfs-actions.pod:6005
10623 msgid "(Added in 1.0.6)"
10624 msgstr ""
10625
10626 # type: =head2
10627 #. type: =head2
10628 #: ../src/guestfs-actions.pod:2042
10629 msgid "guestfs_get_recovery_proc"
10630 msgstr ""
10631
10632 # type: verbatim
10633 #. type: verbatim
10634 #: ../src/guestfs-actions.pod:2044
10635 #, no-wrap
10636 msgid ""
10637 " int\n"
10638 " guestfs_get_recovery_proc (guestfs_h *g);\n"
10639 "\n"
10640 msgstr ""
10641
10642 # type: textblock
10643 #. type: textblock
10644 #: ../src/guestfs-actions.pod:2047 ../fish/guestfish-actions.pod:1387
10645 msgid "Return the recovery process enabled flag."
10646 msgstr ""
10647
10648 # type: textblock
10649 #. type: textblock
10650 #: ../src/guestfs-actions.pod:2051 ../src/guestfs-actions.pod:3498
10651 #: ../src/guestfs-actions.pod:3795 ../src/guestfs-actions.pod:4195
10652 #: ../src/guestfs-actions.pod:4227 ../src/guestfs-actions.pod:5264
10653 #: ../src/guestfs-actions.pod:5607 ../src/guestfs-actions.pod:6029
10654 #: ../src/guestfs-actions.pod:6720 ../src/guestfs-actions.pod:6740
10655 #: ../src/guestfs-actions.pod:6932
10656 msgid "(Added in 1.0.77)"
10657 msgstr ""
10658
10659 # type: =head2
10660 #. type: =head2
10661 #: ../src/guestfs-actions.pod:2053
10662 msgid "guestfs_get_selinux"
10663 msgstr ""
10664
10665 # type: verbatim
10666 #. type: verbatim
10667 #: ../src/guestfs-actions.pod:2055
10668 #, no-wrap
10669 msgid ""
10670 " int\n"
10671 " guestfs_get_selinux (guestfs_h *g);\n"
10672 "\n"
10673 msgstr ""
10674
10675 # type: textblock
10676 #. type: textblock
10677 #: ../src/guestfs-actions.pod:2058
10678 msgid ""
10679 "This returns the current setting of the selinux flag which is passed to the "
10680 "appliance at boot time.  See C<guestfs_set_selinux>."
10681 msgstr ""
10682
10683 # type: textblock
10684 #. type: textblock
10685 #: ../src/guestfs-actions.pod:2066 ../src/guestfs-actions.pod:2129
10686 #: ../src/guestfs-actions.pod:6048 ../src/guestfs-actions.pod:6106
10687 msgid "(Added in 1.0.67)"
10688 msgstr ""
10689
10690 # type: =head2
10691 #. type: =head2
10692 #: ../src/guestfs-actions.pod:2068
10693 msgid "guestfs_get_state"
10694 msgstr ""
10695
10696 # type: verbatim
10697 #. type: verbatim
10698 #: ../src/guestfs-actions.pod:2070
10699 #, no-wrap
10700 msgid ""
10701 " int\n"
10702 " guestfs_get_state (guestfs_h *g);\n"
10703 "\n"
10704 msgstr ""
10705
10706 # type: textblock
10707 #. type: textblock
10708 #: ../src/guestfs-actions.pod:2073 ../fish/guestfish-actions.pod:1403
10709 msgid ""
10710 "This returns the current state as an opaque integer.  This is only useful "
10711 "for printing debug and internal error messages."
10712 msgstr ""
10713
10714 # type: textblock
10715 #. type: textblock
10716 #: ../src/guestfs-actions.pod:2076 ../src/guestfs-actions.pod:3296
10717 #: ../src/guestfs-actions.pod:3325 ../src/guestfs-actions.pod:3386
10718 #: ../src/guestfs-actions.pod:3413 ../fish/guestfish-actions.pod:1406
10719 #: ../fish/guestfish-actions.pod:2320 ../fish/guestfish-actions.pod:2338
10720 #: ../fish/guestfish-actions.pod:2376 ../fish/guestfish-actions.pod:2392
10721 msgid "For more information on states, see L<guestfs(3)>."
10722 msgstr ""
10723
10724 # type: =head2
10725 #. type: =head2
10726 #: ../src/guestfs-actions.pod:2082
10727 msgid "guestfs_get_trace"
10728 msgstr ""
10729
10730 # type: verbatim
10731 #. type: verbatim
10732 #: ../src/guestfs-actions.pod:2084
10733 #, no-wrap
10734 msgid ""
10735 " int\n"
10736 " guestfs_get_trace (guestfs_h *g);\n"
10737 "\n"
10738 msgstr ""
10739
10740 # type: textblock
10741 #. type: textblock
10742 #: ../src/guestfs-actions.pod:2087 ../fish/guestfish-actions.pod:1412
10743 msgid "Return the command trace flag."
10744 msgstr ""
10745
10746 # type: =head2
10747 #. type: =head2
10748 #: ../src/guestfs-actions.pod:2093
10749 msgid "guestfs_get_umask"
10750 msgstr ""
10751
10752 # type: verbatim
10753 #. type: verbatim
10754 #: ../src/guestfs-actions.pod:2095
10755 #, no-wrap
10756 msgid ""
10757 " int\n"
10758 " guestfs_get_umask (guestfs_h *g);\n"
10759 "\n"
10760 msgstr ""
10761
10762 # type: textblock
10763 #. type: textblock
10764 #: ../src/guestfs-actions.pod:2098
10765 msgid ""
10766 "Return the current umask.  By default the umask is C<022> unless it has been "
10767 "set by calling C<guestfs_umask>."
10768 msgstr ""
10769
10770 # type: =head2
10771 #. type: =head2
10772 #: ../src/guestfs-actions.pod:2105
10773 msgid "guestfs_get_verbose"
10774 msgstr ""
10775
10776 # type: verbatim
10777 #. type: verbatim
10778 #: ../src/guestfs-actions.pod:2107
10779 #, no-wrap
10780 msgid ""
10781 " int\n"
10782 " guestfs_get_verbose (guestfs_h *g);\n"
10783 "\n"
10784 msgstr ""
10785
10786 # type: textblock
10787 #. type: textblock
10788 #: ../src/guestfs-actions.pod:2110 ../fish/guestfish-actions.pod:1425
10789 msgid "This returns the verbose messages flag."
10790 msgstr ""
10791
10792 # type: =head2
10793 #. type: =head2
10794 #: ../src/guestfs-actions.pod:2116
10795 msgid "guestfs_getcon"
10796 msgstr ""
10797
10798 # type: verbatim
10799 #. type: verbatim
10800 #: ../src/guestfs-actions.pod:2118
10801 #, no-wrap
10802 msgid ""
10803 " char *\n"
10804 " guestfs_getcon (guestfs_h *g);\n"
10805 "\n"
10806 msgstr ""
10807
10808 # type: textblock
10809 #. type: textblock
10810 #: ../src/guestfs-actions.pod:2121 ../fish/guestfish-actions.pod:1431
10811 msgid "This gets the SELinux security context of the daemon."
10812 msgstr ""
10813
10814 # type: textblock
10815 #. type: textblock
10816 #: ../src/guestfs-actions.pod:2123
10817 msgid ""
10818 "See the documentation about SELINUX in L<guestfs(3)>, and C<guestfs_setcon>"
10819 msgstr ""
10820
10821 # type: =head2
10822 #. type: =head2
10823 #: ../src/guestfs-actions.pod:2131
10824 msgid "guestfs_getxattr"
10825 msgstr ""
10826
10827 # type: verbatim
10828 #. type: verbatim
10829 #: ../src/guestfs-actions.pod:2133
10830 #, no-wrap
10831 msgid ""
10832 " char *\n"
10833 " guestfs_getxattr (guestfs_h *g,\n"
10834 "                   const char *path,\n"
10835 "                   const char *name,\n"
10836 "                   size_t *size_r);\n"
10837 "\n"
10838 msgstr ""
10839
10840 # type: textblock
10841 #. type: textblock
10842 #: ../src/guestfs-actions.pod:2139
10843 msgid ""
10844 "Get a single extended attribute from file C<path> named C<name>.  This call "
10845 "follows symlinks.  If you want to lookup an extended attribute for the "
10846 "symlink itself, use C<guestfs_lgetxattr>."
10847 msgstr ""
10848
10849 # type: textblock
10850 #. type: textblock
10851 #: ../src/guestfs-actions.pod:2143 ../src/guestfs-actions.pod:3512
10852 msgid ""
10853 "Normally it is better to get all extended attributes from a file in one go "
10854 "by calling C<guestfs_getxattrs>.  However some Linux filesystem "
10855 "implementations are buggy and do not provide a way to list out attributes.  "
10856 "For these filesystems (notably ntfs-3g)  you have to know the names of the "
10857 "extended attributes you want in advance and call this function."
10858 msgstr ""
10859
10860 # type: textblock
10861 #. type: textblock
10862 #: ../src/guestfs-actions.pod:2150 ../src/guestfs-actions.pod:3519
10863 #: ../fish/guestfish-actions.pod:1451 ../fish/guestfish-actions.pod:2457
10864 msgid ""
10865 "Extended attribute values are blobs of binary data.  If there is no extended "
10866 "attribute named C<name>, this returns an error."
10867 msgstr ""
10868
10869 # type: textblock
10870 #. type: textblock
10871 #: ../src/guestfs-actions.pod:2153
10872 msgid "See also: C<guestfs_getxattrs>, C<guestfs_lgetxattr>, L<attr(5)>."
10873 msgstr ""
10874
10875 # type: textblock
10876 #. type: textblock
10877 #: ../src/guestfs-actions.pod:2155 ../src/guestfs-actions.pod:2346
10878 #: ../src/guestfs-actions.pod:3524 ../src/guestfs-actions.pod:5257
10879 #: ../src/guestfs-actions.pod:5283 ../src/guestfs-actions.pod:5464
10880 msgid ""
10881 "This function returns a buffer, or NULL on error.  The size of the returned "
10882 "buffer is written to C<*size_r>.  I<The caller must free the returned buffer "
10883 "after use>."
10884 msgstr ""
10885
10886 #. type: textblock
10887 #: ../src/guestfs-actions.pod:2159 ../src/guestfs-actions.pod:3528
10888 msgid "(Added in 1.7.24)"
10889 msgstr ""
10890
10891 # type: =head2
10892 #. type: =head2
10893 #: ../src/guestfs-actions.pod:2161
10894 msgid "guestfs_getxattrs"
10895 msgstr ""
10896
10897 # type: verbatim
10898 #. type: verbatim
10899 #: ../src/guestfs-actions.pod:2163
10900 #, no-wrap
10901 msgid ""
10902 " struct guestfs_xattr_list *\n"
10903 " guestfs_getxattrs (guestfs_h *g,\n"
10904 "                    const char *path);\n"
10905 "\n"
10906 msgstr ""
10907
10908 # type: textblock
10909 #. type: textblock
10910 #: ../src/guestfs-actions.pod:2167 ../fish/guestfish-actions.pod:1460
10911 msgid ""
10912 "This call lists the extended attributes of the file or directory C<path>."
10913 msgstr ""
10914
10915 # type: textblock
10916 #. type: textblock
10917 #: ../src/guestfs-actions.pod:2170 ../fish/guestfish-actions.pod:1463
10918 msgid ""
10919 "At the system call level, this is a combination of the L<listxattr(2)> and "
10920 "L<getxattr(2)> calls."
10921 msgstr ""
10922
10923 # type: textblock
10924 #. type: textblock
10925 #: ../src/guestfs-actions.pod:2173
10926 msgid "See also: C<guestfs_lgetxattrs>, L<attr(5)>."
10927 msgstr ""
10928
10929 # type: textblock
10930 #. type: textblock
10931 #: ../src/guestfs-actions.pod:2175 ../src/guestfs-actions.pod:3540
10932 #: ../src/guestfs-actions.pod:4191
10933 msgid ""
10934 "This function returns a C<struct guestfs_xattr_list *>, or NULL if there was "
10935 "an error.  I<The caller must call C<guestfs_free_xattr_list> after use>."
10936 msgstr ""
10937
10938 # type: textblock
10939 #. type: textblock
10940 #: ../src/guestfs-actions.pod:2179 ../src/guestfs-actions.pod:3544
10941 #: ../src/guestfs-actions.pod:3709 ../src/guestfs-actions.pod:3745
10942 #: ../src/guestfs-actions.pod:5637 ../src/guestfs-actions.pod:6125
10943 #: ../src/guestfs-actions.pod:7495
10944 msgid "(Added in 1.0.59)"
10945 msgstr ""
10946
10947 # type: =head2
10948 #. type: =head2
10949 #: ../src/guestfs-actions.pod:2181
10950 msgid "guestfs_glob_expand"
10951 msgstr ""
10952
10953 # type: verbatim
10954 #. type: verbatim
10955 #: ../src/guestfs-actions.pod:2183
10956 #, no-wrap
10957 msgid ""
10958 " char **\n"
10959 " guestfs_glob_expand (guestfs_h *g,\n"
10960 "                      const char *pattern);\n"
10961 "\n"
10962 msgstr ""
10963
10964 # type: textblock
10965 #. type: textblock
10966 #: ../src/guestfs-actions.pod:2187 ../fish/guestfish-actions.pod:1472
10967 msgid ""
10968 "This command searches for all the pathnames matching C<pattern> according to "
10969 "the wildcard expansion rules used by the shell."
10970 msgstr ""
10971
10972 # type: textblock
10973 #. type: textblock
10974 #: ../src/guestfs-actions.pod:2191 ../fish/guestfish-actions.pod:1476
10975 msgid ""
10976 "If no paths match, then this returns an empty list (note: not an error)."
10977 msgstr ""
10978
10979 # type: textblock
10980 #. type: textblock
10981 #: ../src/guestfs-actions.pod:2194 ../fish/guestfish-actions.pod:1479
10982 msgid ""
10983 "It is just a wrapper around the C L<glob(3)> function with flags C<GLOB_MARK|"
10984 "GLOB_BRACE>.  See that manual page for more details."
10985 msgstr ""
10986
10987 # type: textblock
10988 #. type: textblock
10989 #: ../src/guestfs-actions.pod:2202 ../src/guestfs-actions.pod:6318
10990 #: ../src/guestfs-actions.pod:6335
10991 msgid "(Added in 1.0.50)"
10992 msgstr ""
10993
10994 # type: =head2
10995 #. type: =head2
10996 #: ../src/guestfs-actions.pod:2204
10997 msgid "guestfs_grep"
10998 msgstr ""
10999
11000 # type: verbatim
11001 #. type: verbatim
11002 #: ../src/guestfs-actions.pod:2206
11003 #, no-wrap
11004 msgid ""
11005 " char **\n"
11006 " guestfs_grep (guestfs_h *g,\n"
11007 "               const char *regex,\n"
11008 "               const char *path);\n"
11009 "\n"
11010 msgstr ""
11011
11012 # type: textblock
11013 #. type: textblock
11014 #: ../src/guestfs-actions.pod:2211 ../fish/guestfish-actions.pod:1487
11015 msgid "This calls the external C<grep> program and returns the matching lines."
11016 msgstr ""
11017
11018 # type: =head2
11019 #. type: =head2
11020 #: ../src/guestfs-actions.pod:2223
11021 msgid "guestfs_grepi"
11022 msgstr ""
11023
11024 # type: verbatim
11025 #. type: verbatim
11026 #: ../src/guestfs-actions.pod:2225
11027 #, no-wrap
11028 msgid ""
11029 " char **\n"
11030 " guestfs_grepi (guestfs_h *g,\n"
11031 "                const char *regex,\n"
11032 "                const char *path);\n"
11033 "\n"
11034 msgstr ""
11035
11036 # type: textblock
11037 #. type: textblock
11038 #: ../src/guestfs-actions.pod:2230 ../fish/guestfish-actions.pod:1497
11039 msgid ""
11040 "This calls the external C<grep -i> program and returns the matching lines."
11041 msgstr ""
11042
11043 # type: =head2
11044 #. type: =head2
11045 #: ../src/guestfs-actions.pod:2242
11046 msgid "guestfs_grub_install"
11047 msgstr ""
11048
11049 # type: verbatim
11050 #. type: verbatim
11051 #: ../src/guestfs-actions.pod:2244
11052 #, no-wrap
11053 msgid ""
11054 " int\n"
11055 " guestfs_grub_install (guestfs_h *g,\n"
11056 "                       const char *root,\n"
11057 "                       const char *device);\n"
11058 "\n"
11059 msgstr ""
11060
11061 # type: textblock
11062 #. type: textblock
11063 #: ../src/guestfs-actions.pod:2249 ../fish/guestfish-actions.pod:1507
11064 msgid ""
11065 "This command installs GRUB (the Grand Unified Bootloader) on C<device>, with "
11066 "the root directory being C<root>."
11067 msgstr ""
11068
11069 # type: textblock
11070 #. type: textblock
11071 #: ../src/guestfs-actions.pod:2252 ../fish/guestfish-actions.pod:1510
11072 msgid ""
11073 "Note: If grub-install reports the error \"No suitable drive was found in the "
11074 "generated device map.\" it may be that you need to create a C</boot/grub/"
11075 "device.map> file first that contains the mapping between grub device names "
11076 "and Linux device names.  It is usually sufficient to create a file "
11077 "containing:"
11078 msgstr ""
11079
11080 # type: verbatim
11081 #. type: verbatim
11082 #: ../src/guestfs-actions.pod:2259 ../fish/guestfish-actions.pod:1517
11083 #, no-wrap
11084 msgid ""
11085 " (hd0) /dev/vda\n"
11086 "\n"
11087 msgstr ""
11088
11089 # type: textblock
11090 #. type: textblock
11091 #: ../src/guestfs-actions.pod:2261 ../fish/guestfish-actions.pod:1519
11092 msgid "replacing C</dev/vda> with the name of the installation device."
11093 msgstr ""
11094
11095 # type: textblock
11096 #. type: textblock
11097 #: ../src/guestfs-actions.pod:2265
11098 msgid "(Added in 1.0.17)"
11099 msgstr ""
11100
11101 # type: =head2
11102 #. type: =head2
11103 #: ../src/guestfs-actions.pod:2267
11104 msgid "guestfs_head"
11105 msgstr ""
11106
11107 # type: verbatim
11108 #. type: verbatim
11109 #: ../src/guestfs-actions.pod:2269
11110 #, no-wrap
11111 msgid ""
11112 " char **\n"
11113 " guestfs_head (guestfs_h *g,\n"
11114 "               const char *path);\n"
11115 "\n"
11116 msgstr ""
11117
11118 # type: textblock
11119 #. type: textblock
11120 #: ../src/guestfs-actions.pod:2273 ../fish/guestfish-actions.pod:1525
11121 msgid ""
11122 "This command returns up to the first 10 lines of a file as a list of strings."
11123 msgstr ""
11124
11125 # type: =head2
11126 #. type: =head2
11127 #: ../src/guestfs-actions.pod:2285
11128 msgid "guestfs_head_n"
11129 msgstr ""
11130
11131 # type: verbatim
11132 #. type: verbatim
11133 #: ../src/guestfs-actions.pod:2287
11134 #, no-wrap
11135 msgid ""
11136 " char **\n"
11137 " guestfs_head_n (guestfs_h *g,\n"
11138 "                 int nrlines,\n"
11139 "                 const char *path);\n"
11140 "\n"
11141 msgstr ""
11142
11143 # type: textblock
11144 #. type: textblock
11145 #: ../src/guestfs-actions.pod:2292 ../fish/guestfish-actions.pod:1535
11146 msgid ""
11147 "If the parameter C<nrlines> is a positive number, this returns the first "
11148 "C<nrlines> lines of the file C<path>."
11149 msgstr ""
11150
11151 # type: textblock
11152 #. type: textblock
11153 #: ../src/guestfs-actions.pod:2295 ../fish/guestfish-actions.pod:1538
11154 msgid ""
11155 "If the parameter C<nrlines> is a negative number, this returns lines from "
11156 "the file C<path>, excluding the last C<nrlines> lines."
11157 msgstr ""
11158
11159 # type: textblock
11160 #. type: textblock
11161 #: ../src/guestfs-actions.pod:2298 ../src/guestfs-actions.pod:6615
11162 #: ../fish/guestfish-actions.pod:1541 ../fish/guestfish-actions.pod:4471
11163 msgid "If the parameter C<nrlines> is zero, this returns an empty list."
11164 msgstr ""
11165
11166 # type: =head2
11167 #. type: =head2
11168 #: ../src/guestfs-actions.pod:2309
11169 msgid "guestfs_hexdump"
11170 msgstr ""
11171
11172 # type: verbatim
11173 #. type: verbatim
11174 #: ../src/guestfs-actions.pod:2311
11175 #, no-wrap
11176 msgid ""
11177 " char *\n"
11178 " guestfs_hexdump (guestfs_h *g,\n"
11179 "                  const char *path);\n"
11180 "\n"
11181 msgstr ""
11182
11183 # type: textblock
11184 #. type: textblock
11185 #: ../src/guestfs-actions.pod:2315 ../fish/guestfish-actions.pod:1550
11186 msgid ""
11187 "This runs C<hexdump -C> on the given C<path>.  The result is the human-"
11188 "readable, canonical hex dump of the file."
11189 msgstr ""
11190
11191 # type: textblock
11192 #. type: textblock
11193 #: ../src/guestfs-actions.pod:2324 ../src/guestfs-actions.pod:6399
11194 #: ../src/guestfs-actions.pod:6454
11195 msgid "(Added in 1.0.22)"
11196 msgstr ""
11197
11198 # type: =head2
11199 #. type: =head2
11200 #: ../src/guestfs-actions.pod:2326
11201 msgid "guestfs_initrd_cat"
11202 msgstr ""
11203
11204 # type: verbatim
11205 #. type: verbatim
11206 #: ../src/guestfs-actions.pod:2328
11207 #, no-wrap
11208 msgid ""
11209 " char *\n"
11210 " guestfs_initrd_cat (guestfs_h *g,\n"
11211 "                     const char *initrdpath,\n"
11212 "                     const char *filename,\n"
11213 "                     size_t *size_r);\n"
11214 "\n"
11215 msgstr ""
11216
11217 # type: textblock
11218 #. type: textblock
11219 #: ../src/guestfs-actions.pod:2334 ../fish/guestfish-actions.pod:1560
11220 msgid ""
11221 "This command unpacks the file C<filename> from the initrd file called "
11222 "C<initrdpath>.  The filename must be given I<without> the initial C</> "
11223 "character."
11224 msgstr ""
11225
11226 # type: textblock
11227 #. type: textblock
11228 #: ../src/guestfs-actions.pod:2338 ../fish/guestfish-actions.pod:1564
11229 msgid ""
11230 "For example, in guestfish you could use the following command to examine the "
11231 "boot script (usually called C</init>)  contained in a Linux initrd or "
11232 "initramfs image:"
11233 msgstr ""
11234
11235 # type: verbatim
11236 #. type: verbatim
11237 #: ../src/guestfs-actions.pod:2342 ../fish/guestfish-actions.pod:1568
11238 #, no-wrap
11239 msgid ""
11240 " initrd-cat /boot/initrd-<version>.img init\n"
11241 "\n"
11242 msgstr ""
11243
11244 # type: textblock
11245 #. type: textblock
11246 #: ../src/guestfs-actions.pod:2344
11247 msgid "See also C<guestfs_initrd_list>."
11248 msgstr ""
11249
11250 # type: =head2
11251 #. type: =head2
11252 #: ../src/guestfs-actions.pod:2355
11253 msgid "guestfs_initrd_list"
11254 msgstr ""
11255
11256 # type: verbatim
11257 #. type: verbatim
11258 #: ../src/guestfs-actions.pod:2357
11259 #, no-wrap
11260 msgid ""
11261 " char **\n"
11262 " guestfs_initrd_list (guestfs_h *g,\n"
11263 "                      const char *path);\n"
11264 "\n"
11265 msgstr ""
11266
11267 # type: textblock
11268 #. type: textblock
11269 #: ../src/guestfs-actions.pod:2361 ../fish/guestfish-actions.pod:1579
11270 msgid "This command lists out files contained in an initrd."
11271 msgstr ""
11272
11273 # type: textblock
11274 #. type: textblock
11275 #: ../src/guestfs-actions.pod:2363 ../fish/guestfish-actions.pod:1581
11276 msgid ""
11277 "The files are listed without any initial C</> character.  The files are "
11278 "listed in the order they appear (not necessarily alphabetical).  Directory "
11279 "names are listed as separate items."
11280 msgstr ""
11281
11282 # type: textblock
11283 #. type: textblock
11284 #: ../src/guestfs-actions.pod:2367 ../fish/guestfish-actions.pod:1585
11285 msgid ""
11286 "Old Linux kernels (2.4 and earlier) used a compressed ext2 filesystem as "
11287 "initrd.  We I<only> support the newer initramfs format (compressed cpio "
11288 "files)."
11289 msgstr ""
11290
11291 # type: =head2
11292 #. type: =head2
11293 #: ../src/guestfs-actions.pod:2377
11294 msgid "guestfs_inotify_add_watch"
11295 msgstr ""
11296
11297 # type: verbatim
11298 #. type: verbatim
11299 #: ../src/guestfs-actions.pod:2379
11300 #, no-wrap
11301 msgid ""
11302 " int64_t\n"
11303 " guestfs_inotify_add_watch (guestfs_h *g,\n"
11304 "                            const char *path,\n"
11305 "                            int mask);\n"
11306 "\n"
11307 msgstr ""
11308
11309 # type: textblock
11310 #. type: textblock
11311 #: ../src/guestfs-actions.pod:2384 ../fish/guestfish-actions.pod:1593
11312 msgid "Watch C<path> for the events listed in C<mask>."
11313 msgstr ""
11314
11315 # type: textblock
11316 #. type: textblock
11317 #: ../src/guestfs-actions.pod:2386 ../fish/guestfish-actions.pod:1595
11318 msgid ""
11319 "Note that if C<path> is a directory then events within that directory are "
11320 "watched, but this does I<not> happen recursively (in subdirectories)."
11321 msgstr ""
11322
11323 # type: textblock
11324 #. type: textblock
11325 #: ../src/guestfs-actions.pod:2390 ../fish/guestfish-actions.pod:1599
11326 msgid ""
11327 "Note for non-C or non-Linux callers: the inotify events are defined by the "
11328 "Linux kernel ABI and are listed in C</usr/include/sys/inotify.h>."
11329 msgstr ""
11330
11331 # type: =head2
11332 #. type: =head2
11333 #: ../src/guestfs-actions.pod:2398
11334 msgid "guestfs_inotify_close"
11335 msgstr ""
11336
11337 # type: verbatim
11338 #. type: verbatim
11339 #: ../src/guestfs-actions.pod:2400
11340 #, no-wrap
11341 msgid ""
11342 " int\n"
11343 " guestfs_inotify_close (guestfs_h *g);\n"
11344 "\n"
11345 msgstr ""
11346
11347 # type: textblock
11348 #. type: textblock
11349 #: ../src/guestfs-actions.pod:2403 ../fish/guestfish-actions.pod:1607
11350 msgid ""
11351 "This closes the inotify handle which was previously opened by inotify_init.  "
11352 "It removes all watches, throws away any pending events, and deallocates all "
11353 "resources."
11354 msgstr ""
11355
11356 # type: =head2
11357 #. type: =head2
11358 #: ../src/guestfs-actions.pod:2411
11359 msgid "guestfs_inotify_files"
11360 msgstr ""
11361
11362 # type: verbatim
11363 #. type: verbatim
11364 #: ../src/guestfs-actions.pod:2413
11365 #, no-wrap
11366 msgid ""
11367 " char **\n"
11368 " guestfs_inotify_files (guestfs_h *g);\n"
11369 "\n"
11370 msgstr ""
11371
11372 # type: textblock
11373 #. type: textblock
11374 #: ../src/guestfs-actions.pod:2416
11375 msgid ""
11376 "This function is a helpful wrapper around C<guestfs_inotify_read> which just "
11377 "returns a list of pathnames of objects that were touched.  The returned "
11378 "pathnames are sorted and deduplicated."
11379 msgstr ""
11380
11381 # type: =head2
11382 #. type: =head2
11383 #: ../src/guestfs-actions.pod:2426
11384 msgid "guestfs_inotify_init"
11385 msgstr ""
11386
11387 # type: verbatim
11388 #. type: verbatim
11389 #: ../src/guestfs-actions.pod:2428
11390 #, no-wrap
11391 msgid ""
11392 " int\n"
11393 " guestfs_inotify_init (guestfs_h *g,\n"
11394 "                       int maxevents);\n"
11395 "\n"
11396 msgstr ""
11397
11398 # type: textblock
11399 #. type: textblock
11400 #: ../src/guestfs-actions.pod:2432 ../fish/guestfish-actions.pod:1623
11401 msgid ""
11402 "This command creates a new inotify handle.  The inotify subsystem can be "
11403 "used to notify events which happen to objects in the guest filesystem."
11404 msgstr ""
11405
11406 # type: textblock
11407 #. type: textblock
11408 #: ../src/guestfs-actions.pod:2436
11409 msgid ""
11410 "C<maxevents> is the maximum number of events which will be queued up between "
11411 "calls to C<guestfs_inotify_read> or C<guestfs_inotify_files>.  If this is "
11412 "passed as C<0>, then the kernel (or previously set)  default is used.  For "
11413 "Linux 2.6.29 the default was 16384 events.  Beyond this limit, the kernel "
11414 "throws away events, but records the fact that it threw them away by setting "
11415 "a flag C<IN_Q_OVERFLOW> in the returned structure list (see "
11416 "C<guestfs_inotify_read>)."
11417 msgstr ""
11418
11419 # type: textblock
11420 #. type: textblock
11421 #: ../src/guestfs-actions.pod:2446
11422 msgid ""
11423 "Before any events are generated, you have to add some watches to the "
11424 "internal watch list.  See: C<guestfs_inotify_add_watch>, "
11425 "C<guestfs_inotify_rm_watch> and C<guestfs_inotify_watch_all>."
11426 msgstr ""
11427
11428 # type: textblock
11429 #. type: textblock
11430 #: ../src/guestfs-actions.pod:2452
11431 msgid ""
11432 "Queued up events should be read periodically by calling "
11433 "C<guestfs_inotify_read> (or C<guestfs_inotify_files> which is just a helpful "
11434 "wrapper around C<guestfs_inotify_read>).  If you don't read the events out "
11435 "often enough then you risk the internal queue overflowing."
11436 msgstr ""
11437
11438 # type: textblock
11439 #. type: textblock
11440 #: ../src/guestfs-actions.pod:2459
11441 msgid ""
11442 "The handle should be closed after use by calling C<guestfs_inotify_close>.  "
11443 "This also removes any watches automatically."
11444 msgstr ""
11445
11446 # type: textblock
11447 #. type: textblock
11448 #: ../src/guestfs-actions.pod:2463 ../fish/guestfish-actions.pod:1654
11449 msgid ""
11450 "See also L<inotify(7)> for an overview of the inotify interface as exposed "
11451 "by the Linux kernel, which is roughly what we expose via libguestfs.  Note "
11452 "that there is one global inotify handle per libguestfs instance."
11453 msgstr ""
11454
11455 # type: =head2
11456 #. type: =head2
11457 #: ../src/guestfs-actions.pod:2472
11458 msgid "guestfs_inotify_read"
11459 msgstr ""
11460
11461 # type: verbatim
11462 #. type: verbatim
11463 #: ../src/guestfs-actions.pod:2474
11464 #, no-wrap
11465 msgid ""
11466 " struct guestfs_inotify_event_list *\n"
11467 " guestfs_inotify_read (guestfs_h *g);\n"
11468 "\n"
11469 msgstr ""
11470
11471 # type: textblock
11472 #. type: textblock
11473 #: ../src/guestfs-actions.pod:2477 ../fish/guestfish-actions.pod:1663
11474 msgid ""
11475 "Return the complete queue of events that have happened since the previous "
11476 "read call."
11477 msgstr ""
11478
11479 # type: textblock
11480 #. type: textblock
11481 #: ../src/guestfs-actions.pod:2480 ../fish/guestfish-actions.pod:1666
11482 msgid "If no events have happened, this returns an empty list."
11483 msgstr ""
11484
11485 # type: textblock
11486 #. type: textblock
11487 #: ../src/guestfs-actions.pod:2482 ../fish/guestfish-actions.pod:1668
11488 msgid ""
11489 "I<Note>: In order to make sure that all events have been read, you must call "
11490 "this function repeatedly until it returns an empty list.  The reason is that "
11491 "the call will read events up to the maximum appliance-to-host message size "
11492 "and leave remaining events in the queue."
11493 msgstr ""
11494
11495 # type: textblock
11496 #. type: textblock
11497 #: ../src/guestfs-actions.pod:2488
11498 msgid ""
11499 "This function returns a C<struct guestfs_inotify_event_list *>, or NULL if "
11500 "there was an error.  I<The caller must call "
11501 "C<guestfs_free_inotify_event_list> after use>."
11502 msgstr ""
11503
11504 # type: =head2
11505 #. type: =head2
11506 #: ../src/guestfs-actions.pod:2494
11507 msgid "guestfs_inotify_rm_watch"
11508 msgstr ""
11509
11510 # type: verbatim
11511 #. type: verbatim
11512 #: ../src/guestfs-actions.pod:2496
11513 #, no-wrap
11514 msgid ""
11515 " int\n"
11516 " guestfs_inotify_rm_watch (guestfs_h *g,\n"
11517 "                           int wd);\n"
11518 "\n"
11519 msgstr ""
11520
11521 # type: textblock
11522 #. type: textblock
11523 #: ../src/guestfs-actions.pod:2500
11524 msgid ""
11525 "Remove a previously defined inotify watch.  See C<guestfs_inotify_add_watch>."
11526 msgstr ""
11527
11528 # type: =head2
11529 #. type: =head2
11530 #: ../src/guestfs-actions.pod:2507
11531 msgid "guestfs_inspect_get_arch"
11532 msgstr ""
11533
11534 # type: verbatim
11535 #. type: verbatim
11536 #: ../src/guestfs-actions.pod:2509
11537 #, no-wrap
11538 msgid ""
11539 " char *\n"
11540 " guestfs_inspect_get_arch (guestfs_h *g,\n"
11541 "                           const char *root);\n"
11542 "\n"
11543 msgstr ""
11544
11545 # type: textblock
11546 #. type: textblock
11547 #: ../src/guestfs-actions.pod:2513 ../src/guestfs-actions.pod:2536
11548 #: ../src/guestfs-actions.pod:2629 ../src/guestfs-actions.pod:2673
11549 #: ../src/guestfs-actions.pod:2699 ../src/guestfs-actions.pod:2738
11550 #: ../src/guestfs-actions.pod:2760 ../src/guestfs-actions.pod:2787
11551 #: ../src/guestfs-actions.pod:2808 ../src/guestfs-actions.pod:2851
11552 #: ../src/guestfs-actions.pod:2880 ../src/guestfs-actions.pod:2911
11553 #: ../src/guestfs-actions.pod:2935 ../src/guestfs-actions.pod:2990
11554 #: ../src/guestfs-actions.pod:3032 ../src/guestfs-actions.pod:3053
11555 #: ../src/guestfs-actions.pod:3076 ../src/guestfs-actions.pod:3093
11556 #: ../src/guestfs-actions.pod:3110 ../src/guestfs-actions.pod:3129
11557 msgid ""
11558 "This function should only be called with a root device string as returned by "
11559 "C<guestfs_inspect_os>."
11560 msgstr ""
11561
11562 # type: textblock
11563 #. type: textblock
11564 #: ../src/guestfs-actions.pod:2516
11565 msgid ""
11566 "This returns the architecture of the inspected operating system.  The "
11567 "possible return values are listed under C<guestfs_file_architecture>."
11568 msgstr ""
11569
11570 # type: textblock
11571 #. type: textblock
11572 #: ../src/guestfs-actions.pod:2520 ../fish/guestfish-actions.pod:1692
11573 msgid ""
11574 "If the architecture could not be determined, then the string C<unknown> is "
11575 "returned."
11576 msgstr ""
11577
11578 # type: textblock
11579 #. type: textblock
11580 #: ../src/guestfs-actions.pod:2523 ../src/guestfs-actions.pod:2616
11581 #: ../src/guestfs-actions.pod:2727 ../src/guestfs-actions.pod:2747
11582 #: ../src/guestfs-actions.pod:2775 ../src/guestfs-actions.pod:2867
11583 #: ../src/guestfs-actions.pod:2898 ../src/guestfs-actions.pod:2922
11584 #: ../src/guestfs-actions.pod:2976 ../src/guestfs-actions.pod:3019
11585 #: ../src/guestfs-actions.pod:3042 ../src/guestfs-actions.pod:3063
11586 #: ../src/guestfs-actions.pod:3083 ../src/guestfs-actions.pod:3100
11587 #: ../src/guestfs-actions.pod:3119 ../src/guestfs-actions.pod:3222
11588 #: ../src/guestfs-actions.pod:3263 ../fish/guestfish-actions.pod:1695
11589 #: ../fish/guestfish-actions.pod:1781 ../fish/guestfish-actions.pod:1869
11590 #: ../fish/guestfish-actions.pod:1884 ../fish/guestfish-actions.pod:1905
11591 #: ../fish/guestfish-actions.pod:1975 ../fish/guestfish-actions.pod:1999
11592 #: ../fish/guestfish-actions.pod:2016 ../fish/guestfish-actions.pod:2059
11593 #: ../fish/guestfish-actions.pod:2094 ../fish/guestfish-actions.pod:2110
11594 #: ../fish/guestfish-actions.pod:2126 ../fish/guestfish-actions.pod:2139
11595 #: ../fish/guestfish-actions.pod:2152 ../fish/guestfish-actions.pod:2167
11596 #: ../fish/guestfish-actions.pod:2266 ../fish/guestfish-actions.pod:2300
11597 msgid "Please read L<guestfs(3)/INSPECTION> for more details."
11598 msgstr ""
11599
11600 # type: =head2
11601 #. type: =head2
11602 #: ../src/guestfs-actions.pod:2530
11603 msgid "guestfs_inspect_get_distro"
11604 msgstr ""
11605
11606 # type: verbatim
11607 #. type: verbatim
11608 #: ../src/guestfs-actions.pod:2532
11609 #, no-wrap
11610 msgid ""
11611 " char *\n"
11612 " guestfs_inspect_get_distro (guestfs_h *g,\n"
11613 "                             const char *root);\n"
11614 "\n"
11615 msgstr ""
11616
11617 # type: textblock
11618 #. type: textblock
11619 #: ../src/guestfs-actions.pod:2539 ../fish/guestfish-actions.pod:1704
11620 msgid ""
11621 "This returns the distro (distribution) of the inspected operating system."
11622 msgstr ""
11623
11624 # type: textblock
11625 #. type: textblock
11626 #: ../src/guestfs-actions.pod:2542 ../fish/guestfish-actions.pod:1707
11627 msgid "Currently defined distros are:"
11628 msgstr ""
11629
11630 # type: =item
11631 #. type: =item
11632 #: ../src/guestfs-actions.pod:2546 ../fish/guestfish-actions.pod:1711
11633 msgid "\"archlinux\""
11634 msgstr ""
11635
11636 # type: textblock
11637 #. type: textblock
11638 #: ../src/guestfs-actions.pod:2548 ../fish/guestfish-actions.pod:1713
11639 msgid "Arch Linux."
11640 msgstr ""
11641
11642 #. type: =item
11643 #: ../src/guestfs-actions.pod:2550 ../fish/guestfish-actions.pod:1715
11644 msgid "\"centos\""
11645 msgstr ""
11646
11647 #. type: textblock
11648 #: ../src/guestfs-actions.pod:2552 ../fish/guestfish-actions.pod:1717
11649 msgid "CentOS."
11650 msgstr ""
11651
11652 # type: =item
11653 #. type: =item
11654 #: ../src/guestfs-actions.pod:2554 ../fish/guestfish-actions.pod:1719
11655 msgid "\"debian\""
11656 msgstr ""
11657
11658 # type: textblock
11659 #. type: textblock
11660 #: ../src/guestfs-actions.pod:2556 ../fish/guestfish-actions.pod:1721
11661 msgid "Debian."
11662 msgstr ""
11663
11664 # type: =item
11665 #. type: =item
11666 #: ../src/guestfs-actions.pod:2558 ../fish/guestfish-actions.pod:1723
11667 msgid "\"fedora\""
11668 msgstr ""
11669
11670 # type: textblock
11671 #. type: textblock
11672 #: ../src/guestfs-actions.pod:2560 ../fish/guestfish-actions.pod:1725
11673 msgid "Fedora."
11674 msgstr ""
11675
11676 # type: =item
11677 #. type: =item
11678 #: ../src/guestfs-actions.pod:2562 ../fish/guestfish-actions.pod:1727
11679 msgid "\"gentoo\""
11680 msgstr ""
11681
11682 # type: textblock
11683 #. type: textblock
11684 #: ../src/guestfs-actions.pod:2564 ../fish/guestfish-actions.pod:1729
11685 msgid "Gentoo."
11686 msgstr ""
11687
11688 # type: =item
11689 #. type: =item
11690 #: ../src/guestfs-actions.pod:2566 ../fish/guestfish-actions.pod:1731
11691 msgid "\"linuxmint\""
11692 msgstr ""
11693
11694 # type: textblock
11695 #. type: textblock
11696 #: ../src/guestfs-actions.pod:2568 ../fish/guestfish-actions.pod:1733
11697 msgid "Linux Mint."
11698 msgstr ""
11699
11700 # type: =item
11701 #. type: =item
11702 #: ../src/guestfs-actions.pod:2570 ../fish/guestfish-actions.pod:1735
11703 msgid "\"mandriva\""
11704 msgstr ""
11705
11706 # type: textblock
11707 #. type: textblock
11708 #: ../src/guestfs-actions.pod:2572 ../fish/guestfish-actions.pod:1737
11709 msgid "Mandriva."
11710 msgstr ""
11711
11712 # type: =item
11713 #. type: =item
11714 #: ../src/guestfs-actions.pod:2574 ../fish/guestfish-actions.pod:1739
11715 msgid "\"meego\""
11716 msgstr ""
11717
11718 # type: textblock
11719 #. type: textblock
11720 #: ../src/guestfs-actions.pod:2576 ../fish/guestfish-actions.pod:1741
11721 msgid "MeeGo."
11722 msgstr ""
11723
11724 # type: =item
11725 #. type: =item
11726 #: ../src/guestfs-actions.pod:2578 ../fish/guestfish-actions.pod:1743
11727 msgid "\"pardus\""
11728 msgstr ""
11729
11730 # type: textblock
11731 #. type: textblock
11732 #: ../src/guestfs-actions.pod:2580 ../fish/guestfish-actions.pod:1745
11733 msgid "Pardus."
11734 msgstr ""
11735
11736 # type: =item
11737 #. type: =item
11738 #: ../src/guestfs-actions.pod:2582 ../fish/guestfish-actions.pod:1747
11739 msgid "\"redhat-based\""
11740 msgstr ""
11741
11742 # type: textblock
11743 #. type: textblock
11744 #: ../src/guestfs-actions.pod:2584 ../fish/guestfish-actions.pod:1749
11745 msgid "Some Red Hat-derived distro."
11746 msgstr ""
11747
11748 # type: =item
11749 #. type: =item
11750 #: ../src/guestfs-actions.pod:2586 ../fish/guestfish-actions.pod:1751
11751 msgid "\"rhel\""
11752 msgstr ""
11753
11754 #. type: textblock
11755 #: ../src/guestfs-actions.pod:2588 ../fish/guestfish-actions.pod:1753
11756 msgid "Red Hat Enterprise Linux."
11757 msgstr ""
11758
11759 #. type: =item
11760 #: ../src/guestfs-actions.pod:2590 ../fish/guestfish-actions.pod:1755
11761 msgid "\"scientificlinux\""
11762 msgstr ""
11763
11764 #. type: textblock
11765 #: ../src/guestfs-actions.pod:2592 ../fish/guestfish-actions.pod:1757
11766 msgid "Scientific Linux."
11767 msgstr ""
11768
11769 #. type: =item
11770 #: ../src/guestfs-actions.pod:2594 ../fish/guestfish-actions.pod:1759
11771 msgid "\"slackware\""
11772 msgstr ""
11773
11774 #. type: textblock
11775 #: ../src/guestfs-actions.pod:2596 ../fish/guestfish-actions.pod:1761
11776 msgid "Slackware."
11777 msgstr ""
11778
11779 # type: =item
11780 #. type: =item
11781 #: ../src/guestfs-actions.pod:2598 ../fish/guestfish-actions.pod:1763
11782 msgid "\"ubuntu\""
11783 msgstr ""
11784
11785 # type: textblock
11786 #. type: textblock
11787 #: ../src/guestfs-actions.pod:2600 ../fish/guestfish-actions.pod:1765
11788 msgid "Ubuntu."
11789 msgstr ""
11790
11791 # type: =item
11792 #. type: =item
11793 #: ../src/guestfs-actions.pod:2602 ../src/guestfs-actions.pod:2718
11794 #: ../src/guestfs-actions.pod:3010 ../fish/guestfish-actions.pod:1767
11795 #: ../fish/guestfish-actions.pod:1860 ../fish/guestfish-actions.pod:2085
11796 msgid "\"unknown\""
11797 msgstr ""
11798
11799 # type: textblock
11800 #. type: textblock
11801 #: ../src/guestfs-actions.pod:2604 ../fish/guestfish-actions.pod:1769
11802 msgid "The distro could not be determined."
11803 msgstr ""
11804
11805 # type: =item
11806 #. type: =item
11807 #: ../src/guestfs-actions.pod:2606 ../src/guestfs-actions.pod:3002
11808 #: ../fish/guestfish-actions.pod:1771 ../fish/guestfish-actions.pod:2077
11809 msgid "\"windows\""
11810 msgstr ""
11811
11812 # type: textblock
11813 #. type: textblock
11814 #: ../src/guestfs-actions.pod:2608 ../fish/guestfish-actions.pod:1773
11815 msgid ""
11816 "Windows does not have distributions.  This string is returned if the OS type "
11817 "is Windows."
11818 msgstr ""
11819
11820 # type: textblock
11821 #. type: textblock
11822 #: ../src/guestfs-actions.pod:2613 ../src/guestfs-actions.pod:2724
11823 #: ../src/guestfs-actions.pod:3016 ../fish/guestfish-actions.pod:1778
11824 #: ../fish/guestfish-actions.pod:1866 ../fish/guestfish-actions.pod:2091
11825 msgid ""
11826 "Future versions of libguestfs may return other strings here.  The caller "
11827 "should be prepared to handle any string."
11828 msgstr ""
11829
11830 #. type: =head2
11831 #: ../src/guestfs-actions.pod:2623
11832 msgid "guestfs_inspect_get_drive_mappings"
11833 msgstr ""
11834
11835 #. type: verbatim
11836 #: ../src/guestfs-actions.pod:2625
11837 #, no-wrap
11838 msgid ""
11839 " char **\n"
11840 " guestfs_inspect_get_drive_mappings (guestfs_h *g,\n"
11841 "                                     const char *root);\n"
11842 "\n"
11843 msgstr ""
11844
11845 #. type: textblock
11846 #: ../src/guestfs-actions.pod:2632 ../fish/guestfish-actions.pod:1790
11847 msgid ""
11848 "This call is useful for Windows which uses a primitive system of assigning "
11849 "drive letters (like \"C:\") to partitions.  This inspection API examines the "
11850 "Windows Registry to find out how disks/partitions are mapped to drive "
11851 "letters, and returns a hash table as in the example below:"
11852 msgstr ""
11853
11854 #. type: verbatim
11855 #: ../src/guestfs-actions.pod:2638 ../fish/guestfish-actions.pod:1796
11856 #, no-wrap
11857 msgid ""
11858 " C      =>     /dev/vda2\n"
11859 " E      =>     /dev/vdb1\n"
11860 " F      =>     /dev/vdc1\n"
11861 "\n"
11862 msgstr ""
11863
11864 #. type: textblock
11865 #: ../src/guestfs-actions.pod:2642 ../fish/guestfish-actions.pod:1800
11866 msgid ""
11867 "Note that keys are drive letters.  For Windows, the key is case insensitive "
11868 "and just contains the drive letter, without the customary colon separator "
11869 "character."
11870 msgstr ""
11871
11872 #. type: textblock
11873 #: ../src/guestfs-actions.pod:2646 ../fish/guestfish-actions.pod:1804
11874 msgid ""
11875 "In future we may support other operating systems that also used drive "
11876 "letters, but the keys for those might not be case insensitive and might be "
11877 "longer than 1 character.  For example in OS-9, hard drives were named C<h0>, "
11878 "C<h1> etc."
11879 msgstr ""
11880
11881 #. type: textblock
11882 #: ../src/guestfs-actions.pod:2651 ../fish/guestfish-actions.pod:1809
11883 msgid ""
11884 "For Windows guests, currently only hard drive mappings are returned.  "
11885 "Removable disks (eg. DVD-ROMs) are ignored."
11886 msgstr ""
11887
11888 #. type: textblock
11889 #: ../src/guestfs-actions.pod:2654 ../fish/guestfish-actions.pod:1812
11890 msgid ""
11891 "For guests that do not use drive mappings, or if the drive mappings could "
11892 "not be determined, this returns an empty hash table."
11893 msgstr ""
11894
11895 #. type: textblock
11896 #: ../src/guestfs-actions.pod:2657
11897 msgid ""
11898 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
11899 "C<guestfs_inspect_get_mountpoints>, C<guestfs_inspect_get_filesystems>."
11900 msgstr ""
11901
11902 # type: textblock
11903 #. type: textblock
11904 #: ../src/guestfs-actions.pod:2661 ../src/guestfs-actions.pod:2837
11905 #: ../src/guestfs-actions.pod:3597 ../src/guestfs-actions.pod:4814
11906 #: ../src/guestfs-actions.pod:6756
11907 msgid ""
11908 "This function returns a NULL-terminated array of strings, or NULL if there "
11909 "was an error.  The array of strings will always have length C<2n+1>, where "
11910 "C<n> keys and values alternate, followed by the trailing NULL entry.  I<The "
11911 "caller must free the strings and the array after use>."
11912 msgstr ""
11913
11914 # type: =head2
11915 #. type: =head2
11916 #: ../src/guestfs-actions.pod:2667
11917 msgid "guestfs_inspect_get_filesystems"
11918 msgstr ""
11919
11920 # type: verbatim
11921 #. type: verbatim
11922 #: ../src/guestfs-actions.pod:2669
11923 #, no-wrap
11924 msgid ""
11925 " char **\n"
11926 " guestfs_inspect_get_filesystems (guestfs_h *g,\n"
11927 "                                  const char *root);\n"
11928 "\n"
11929 msgstr ""
11930
11931 # type: textblock
11932 #. type: textblock
11933 #: ../src/guestfs-actions.pod:2676 ../fish/guestfish-actions.pod:1826
11934 msgid ""
11935 "This returns a list of all the filesystems that we think are associated with "
11936 "this operating system.  This includes the root filesystem, other ordinary "
11937 "filesystems, and non-mounted devices like swap partitions."
11938 msgstr ""
11939
11940 # type: textblock
11941 #. type: textblock
11942 #: ../src/guestfs-actions.pod:2681 ../fish/guestfish-actions.pod:1831
11943 msgid ""
11944 "In the case of a multi-boot virtual machine, it is possible for a filesystem "
11945 "to be shared between operating systems."
11946 msgstr ""
11947
11948 # type: textblock
11949 #. type: textblock
11950 #: ../src/guestfs-actions.pod:2684
11951 msgid ""
11952 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
11953 "C<guestfs_inspect_get_mountpoints>."
11954 msgstr ""
11955
11956 #. type: =head2
11957 #: ../src/guestfs-actions.pod:2693
11958 msgid "guestfs_inspect_get_format"
11959 msgstr ""
11960
11961 #. type: verbatim
11962 #: ../src/guestfs-actions.pod:2695
11963 #, no-wrap
11964 msgid ""
11965 " char *\n"
11966 " guestfs_inspect_get_format (guestfs_h *g,\n"
11967 "                             const char *root);\n"
11968 "\n"
11969 msgstr ""
11970
11971 #. type: textblock
11972 #: ../src/guestfs-actions.pod:2702 ../fish/guestfish-actions.pod:1844
11973 msgid ""
11974 "This returns the format of the inspected operating system.  You can use it "
11975 "to detect install images, live CDs and similar."
11976 msgstr ""
11977
11978 #. type: textblock
11979 #: ../src/guestfs-actions.pod:2705 ../fish/guestfish-actions.pod:1847
11980 msgid "Currently defined formats are:"
11981 msgstr ""
11982
11983 #. type: =item
11984 #: ../src/guestfs-actions.pod:2709 ../fish/guestfish-actions.pod:1851
11985 msgid "\"installed\""
11986 msgstr ""
11987
11988 #. type: textblock
11989 #: ../src/guestfs-actions.pod:2711 ../fish/guestfish-actions.pod:1853
11990 msgid "This is an installed operating system."
11991 msgstr ""
11992
11993 #. type: =item
11994 #: ../src/guestfs-actions.pod:2713 ../fish/guestfish-actions.pod:1855
11995 msgid "\"installer\""
11996 msgstr ""
11997
11998 #. type: textblock
11999 #: ../src/guestfs-actions.pod:2715 ../fish/guestfish-actions.pod:1857
12000 msgid ""
12001 "The disk image being inspected is not an installed operating system, but a "
12002 "I<bootable> install disk, live CD, or similar."
12003 msgstr ""
12004
12005 #. type: textblock
12006 #: ../src/guestfs-actions.pod:2720 ../fish/guestfish-actions.pod:1862
12007 msgid "The format of this disk image is not known."
12008 msgstr ""
12009
12010 # type: =head2
12011 #. type: =head2
12012 #: ../src/guestfs-actions.pod:2732
12013 msgid "guestfs_inspect_get_hostname"
12014 msgstr ""
12015
12016 # type: verbatim
12017 #. type: verbatim
12018 #: ../src/guestfs-actions.pod:2734
12019 #, no-wrap
12020 msgid ""
12021 " char *\n"
12022 " guestfs_inspect_get_hostname (guestfs_h *g,\n"
12023 "                               const char *root);\n"
12024 "\n"
12025 msgstr ""
12026
12027 # type: textblock
12028 #. type: textblock
12029 #: ../src/guestfs-actions.pod:2741 ../fish/guestfish-actions.pod:1878
12030 msgid ""
12031 "This function returns the hostname of the operating system as found by "
12032 "inspection of the guest's configuration files."
12033 msgstr ""
12034
12035 # type: textblock
12036 #. type: textblock
12037 #: ../src/guestfs-actions.pod:2744 ../fish/guestfish-actions.pod:1881
12038 msgid ""
12039 "If the hostname could not be determined, then the string C<unknown> is "
12040 "returned."
12041 msgstr ""
12042
12043 # type: textblock
12044 #. type: textblock
12045 #: ../src/guestfs-actions.pod:2752
12046 msgid "(Added in 1.7.9)"
12047 msgstr ""
12048
12049 # type: =head2
12050 #. type: =head2
12051 #: ../src/guestfs-actions.pod:2754
12052 msgid "guestfs_inspect_get_major_version"
12053 msgstr ""
12054
12055 # type: verbatim
12056 #. type: verbatim
12057 #: ../src/guestfs-actions.pod:2756
12058 #, no-wrap
12059 msgid ""
12060 " int\n"
12061 " guestfs_inspect_get_major_version (guestfs_h *g,\n"
12062 "                                    const char *root);\n"
12063 "\n"
12064 msgstr ""
12065
12066 # type: textblock
12067 #. type: textblock
12068 #: ../src/guestfs-actions.pod:2763 ../fish/guestfish-actions.pod:1893
12069 msgid ""
12070 "This returns the major version number of the inspected operating system."
12071 msgstr ""
12072
12073 # type: textblock
12074 #. type: textblock
12075 #: ../src/guestfs-actions.pod:2766 ../fish/guestfish-actions.pod:1896
12076 msgid ""
12077 "Windows uses a consistent versioning scheme which is I<not> reflected in the "
12078 "popular public names used by the operating system.  Notably the operating "
12079 "system known as \"Windows 7\" is really version 6.1 (ie. major = 6, minor = "
12080 "1).  You can find out the real versions corresponding to releases of Windows "
12081 "by consulting Wikipedia or MSDN."
12082 msgstr ""
12083
12084 # type: textblock
12085 #. type: textblock
12086 #: ../src/guestfs-actions.pod:2773 ../src/guestfs-actions.pod:2793
12087 #: ../fish/guestfish-actions.pod:1903 ../fish/guestfish-actions.pod:1917
12088 msgid "If the version could not be determined, then C<0> is returned."
12089 msgstr ""
12090
12091 # type: =head2
12092 #. type: =head2
12093 #: ../src/guestfs-actions.pod:2781
12094 msgid "guestfs_inspect_get_minor_version"
12095 msgstr ""
12096
12097 # type: verbatim
12098 #. type: verbatim
12099 #: ../src/guestfs-actions.pod:2783
12100 #, no-wrap
12101 msgid ""
12102 " int\n"
12103 " guestfs_inspect_get_minor_version (guestfs_h *g,\n"
12104 "                                    const char *root);\n"
12105 "\n"
12106 msgstr ""
12107
12108 # type: textblock
12109 #. type: textblock
12110 #: ../src/guestfs-actions.pod:2790 ../fish/guestfish-actions.pod:1914
12111 msgid ""
12112 "This returns the minor version number of the inspected operating system."
12113 msgstr ""
12114
12115 # type: textblock
12116 #. type: textblock
12117 #: ../src/guestfs-actions.pod:2795
12118 msgid ""
12119 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
12120 "C<guestfs_inspect_get_major_version>."
12121 msgstr ""
12122
12123 # type: =head2
12124 #. type: =head2
12125 #: ../src/guestfs-actions.pod:2802
12126 msgid "guestfs_inspect_get_mountpoints"
12127 msgstr ""
12128
12129 # type: verbatim
12130 #. type: verbatim
12131 #: ../src/guestfs-actions.pod:2804
12132 #, no-wrap
12133 msgid ""
12134 " char **\n"
12135 " guestfs_inspect_get_mountpoints (guestfs_h *g,\n"
12136 "                                  const char *root);\n"
12137 "\n"
12138 msgstr ""
12139
12140 #. type: textblock
12141 #: ../src/guestfs-actions.pod:2811 ../fish/guestfish-actions.pod:1929
12142 msgid ""
12143 "This returns a hash of where we think the filesystems associated with this "
12144 "operating system should be mounted.  Callers should note that this is at "
12145 "best an educated guess made by reading configuration files such as C</etc/"
12146 "fstab>.  I<In particular note> that this may return filesystems which are "
12147 "non-existent or not mountable and callers should be prepared to handle or "
12148 "ignore failures if they try to mount them."
12149 msgstr ""
12150
12151 # type: textblock
12152 #. type: textblock
12153 #: ../src/guestfs-actions.pod:2820 ../fish/guestfish-actions.pod:1938
12154 msgid ""
12155 "Each element in the returned hashtable has a key which is the path of the "
12156 "mountpoint (eg. C</boot>) and a value which is the filesystem that would be "
12157 "mounted there (eg. C</dev/sda1>)."
12158 msgstr ""
12159
12160 # type: textblock
12161 #. type: textblock
12162 #: ../src/guestfs-actions.pod:2825 ../fish/guestfish-actions.pod:1943
12163 msgid ""
12164 "Non-mounted devices such as swap devices are I<not> returned in this list."
12165 msgstr ""
12166
12167 #. type: textblock
12168 #: ../src/guestfs-actions.pod:2828
12169 msgid ""
12170 "For operating systems like Windows which still use drive letters, this call "
12171 "will only return an entry for the first drive \"mounted on\" C</>.  For "
12172 "information about the mapping of drive letters to partitions, see "
12173 "C<guestfs_inspect_get_drive_mappings>."
12174 msgstr ""
12175
12176 # type: textblock
12177 #. type: textblock
12178 #: ../src/guestfs-actions.pod:2834
12179 msgid ""
12180 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
12181 "C<guestfs_inspect_get_filesystems>."
12182 msgstr ""
12183
12184 # type: =head2
12185 #. type: =head2
12186 #: ../src/guestfs-actions.pod:2845
12187 msgid "guestfs_inspect_get_package_format"
12188 msgstr ""
12189
12190 # type: verbatim
12191 #. type: verbatim
12192 #: ../src/guestfs-actions.pod:2847
12193 #, no-wrap
12194 msgid ""
12195 " char *\n"
12196 " guestfs_inspect_get_package_format (guestfs_h *g,\n"
12197 "                                     const char *root);\n"
12198 "\n"
12199 msgstr ""
12200
12201 # type: textblock
12202 #. type: textblock
12203 #: ../src/guestfs-actions.pod:2854
12204 msgid ""
12205 "This function and C<guestfs_inspect_get_package_management> return the "
12206 "package format and package management tool used by the inspected operating "
12207 "system.  For example for Fedora these functions would return C<rpm> (package "
12208 "format) and C<yum> (package management)."
12209 msgstr ""
12210
12211 # type: textblock
12212 #. type: textblock
12213 #: ../src/guestfs-actions.pod:2860 ../fish/guestfish-actions.pod:1968
12214 msgid ""
12215 "This returns the string C<unknown> if we could not determine the package "
12216 "format I<or> if the operating system does not have a real packaging system "
12217 "(eg. Windows)."
12218 msgstr ""
12219
12220 # type: textblock
12221 #. type: textblock
12222 #: ../src/guestfs-actions.pod:2864 ../fish/guestfish-actions.pod:1972
12223 msgid ""
12224 "Possible strings include: C<rpm>, C<deb>, C<ebuild>, C<pisi>, C<pacman>.  "
12225 "Future versions of libguestfs may return other strings."
12226 msgstr ""
12227
12228 # type: textblock
12229 #. type: textblock
12230 #: ../src/guestfs-actions.pod:2872 ../src/guestfs-actions.pod:2903
12231 msgid "(Added in 1.7.5)"
12232 msgstr ""
12233
12234 # type: =head2
12235 #. type: =head2
12236 #: ../src/guestfs-actions.pod:2874
12237 msgid "guestfs_inspect_get_package_management"
12238 msgstr ""
12239
12240 # type: verbatim
12241 #. type: verbatim
12242 #: ../src/guestfs-actions.pod:2876
12243 #, no-wrap
12244 msgid ""
12245 " char *\n"
12246 " guestfs_inspect_get_package_management (guestfs_h *g,\n"
12247 "                                         const char *root);\n"
12248 "\n"
12249 msgstr ""
12250
12251 # type: textblock
12252 #. type: textblock
12253 #: ../src/guestfs-actions.pod:2883
12254 msgid ""
12255 "C<guestfs_inspect_get_package_format> and this function return the package "
12256 "format and package management tool used by the inspected operating system.  "
12257 "For example for Fedora these functions would return C<rpm> (package format) "
12258 "and C<yum> (package management)."
12259 msgstr ""
12260
12261 # type: textblock
12262 #. type: textblock
12263 #: ../src/guestfs-actions.pod:2889 ../fish/guestfish-actions.pod:1990
12264 msgid ""
12265 "This returns the string C<unknown> if we could not determine the package "
12266 "management tool I<or> if the operating system does not have a real packaging "
12267 "system (eg. Windows)."
12268 msgstr ""
12269
12270 # type: textblock
12271 #. type: textblock
12272 #: ../src/guestfs-actions.pod:2893 ../fish/guestfish-actions.pod:1994
12273 msgid ""
12274 "Possible strings include: C<yum>, C<up2date>, C<apt> (for all Debian "
12275 "derivatives), C<portage>, C<pisi>, C<pacman>, C<urpmi>.  Future versions of "
12276 "libguestfs may return other strings."
12277 msgstr ""
12278
12279 # type: =head2
12280 #. type: =head2
12281 #: ../src/guestfs-actions.pod:2905
12282 msgid "guestfs_inspect_get_product_name"
12283 msgstr ""
12284
12285 # type: verbatim
12286 #. type: verbatim
12287 #: ../src/guestfs-actions.pod:2907
12288 #, no-wrap
12289 msgid ""
12290 " char *\n"
12291 " guestfs_inspect_get_product_name (guestfs_h *g,\n"
12292 "                                   const char *root);\n"
12293 "\n"
12294 msgstr ""
12295
12296 # type: textblock
12297 #. type: textblock
12298 #: ../src/guestfs-actions.pod:2914 ../fish/guestfish-actions.pod:2008
12299 msgid ""
12300 "This returns the product name of the inspected operating system.  The "
12301 "product name is generally some freeform string which can be displayed to the "
12302 "user, but should not be parsed by programs."
12303 msgstr ""
12304
12305 # type: textblock
12306 #. type: textblock
12307 #: ../src/guestfs-actions.pod:2919 ../fish/guestfish-actions.pod:2013
12308 msgid ""
12309 "If the product name could not be determined, then the string C<unknown> is "
12310 "returned."
12311 msgstr ""
12312
12313 #. type: =head2
12314 #: ../src/guestfs-actions.pod:2929
12315 msgid "guestfs_inspect_get_product_variant"
12316 msgstr ""
12317
12318 #. type: verbatim
12319 #: ../src/guestfs-actions.pod:2931
12320 #, no-wrap
12321 msgid ""
12322 " char *\n"
12323 " guestfs_inspect_get_product_variant (guestfs_h *g,\n"
12324 "                                      const char *root);\n"
12325 "\n"
12326 msgstr ""
12327
12328 #. type: textblock
12329 #: ../src/guestfs-actions.pod:2938 ../fish/guestfish-actions.pod:2025
12330 msgid "This returns the product variant of the inspected operating system."
12331 msgstr ""
12332
12333 #. type: textblock
12334 #: ../src/guestfs-actions.pod:2941 ../fish/guestfish-actions.pod:2028
12335 msgid ""
12336 "For Windows guests, this returns the contents of the Registry key C<HKLM"
12337 "\\Software\\Microsoft\\Windows NT\\CurrentVersion> C<InstallationType> which "
12338 "is usually a string such as C<Client> or C<Server> (other values are "
12339 "possible).  This can be used to distinguish consumer and enterprise versions "
12340 "of Windows that have the same version number (for example, Windows 7 and "
12341 "Windows 2008 Server are both version 6.1, but the former is C<Client> and "
12342 "the latter is C<Server>)."
12343 msgstr ""
12344
12345 #. type: textblock
12346 #: ../src/guestfs-actions.pod:2950 ../fish/guestfish-actions.pod:2037
12347 msgid ""
12348 "For enterprise Linux guests, in future we intend this to return the product "
12349 "variant such as C<Desktop>, C<Server> and so on.  But this is not "
12350 "implemented at present."
12351 msgstr ""
12352
12353 #. type: textblock
12354 #: ../src/guestfs-actions.pod:2954 ../fish/guestfish-actions.pod:2041
12355 msgid ""
12356 "If the product variant could not be determined, then the string C<unknown> "
12357 "is returned."
12358 msgstr ""
12359
12360 #. type: textblock
12361 #: ../src/guestfs-actions.pod:2957
12362 msgid ""
12363 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
12364 "C<guestfs_inspect_get_product_name>, C<guestfs_inspect_get_major_version>."
12365 msgstr ""
12366
12367 # type: =head2
12368 #. type: =head2
12369 #: ../src/guestfs-actions.pod:2964
12370 msgid "guestfs_inspect_get_roots"
12371 msgstr ""
12372
12373 # type: verbatim
12374 #. type: verbatim
12375 #: ../src/guestfs-actions.pod:2966
12376 #, no-wrap
12377 msgid ""
12378 " char **\n"
12379 " guestfs_inspect_get_roots (guestfs_h *g);\n"
12380 "\n"
12381 msgstr ""
12382
12383 # type: textblock
12384 #. type: textblock
12385 #: ../src/guestfs-actions.pod:2969
12386 msgid ""
12387 "This function is a convenient way to get the list of root devices, as "
12388 "returned from a previous call to C<guestfs_inspect_os>, but without redoing "
12389 "the whole inspection process."
12390 msgstr ""
12391
12392 # type: textblock
12393 #. type: textblock
12394 #: ../src/guestfs-actions.pod:2973
12395 msgid ""
12396 "This returns an empty list if either no root devices were found or the "
12397 "caller has not called C<guestfs_inspect_os>."
12398 msgstr ""
12399
12400 # type: textblock
12401 #. type: textblock
12402 #: ../src/guestfs-actions.pod:2982
12403 msgid "(Added in 1.7.3)"
12404 msgstr ""
12405
12406 # type: =head2
12407 #. type: =head2
12408 #: ../src/guestfs-actions.pod:2984
12409 msgid "guestfs_inspect_get_type"
12410 msgstr ""
12411
12412 # type: verbatim
12413 #. type: verbatim
12414 #: ../src/guestfs-actions.pod:2986
12415 #, no-wrap
12416 msgid ""
12417 " char *\n"
12418 " guestfs_inspect_get_type (guestfs_h *g,\n"
12419 "                           const char *root);\n"
12420 "\n"
12421 msgstr ""
12422
12423 # type: textblock
12424 #. type: textblock
12425 #: ../src/guestfs-actions.pod:2993 ../fish/guestfish-actions.pod:2068
12426 msgid ""
12427 "This returns the type of the inspected operating system.  Currently defined "
12428 "types are:"
12429 msgstr ""
12430
12431 # type: =item
12432 #. type: =item
12433 #: ../src/guestfs-actions.pod:2998 ../fish/guestfish-actions.pod:2073
12434 msgid "\"linux\""
12435 msgstr ""
12436
12437 # type: textblock
12438 #. type: textblock
12439 #: ../src/guestfs-actions.pod:3000 ../fish/guestfish-actions.pod:2075
12440 msgid "Any Linux-based operating system."
12441 msgstr ""
12442
12443 # type: textblock
12444 #. type: textblock
12445 #: ../src/guestfs-actions.pod:3004 ../fish/guestfish-actions.pod:2079
12446 msgid "Any Microsoft Windows operating system."
12447 msgstr ""
12448
12449 # type: =item
12450 #. type: =item
12451 #: ../src/guestfs-actions.pod:3006 ../fish/guestfish-actions.pod:2081
12452 msgid "\"freebsd\""
12453 msgstr ""
12454
12455 # type: textblock
12456 #. type: textblock
12457 #: ../src/guestfs-actions.pod:3008 ../fish/guestfish-actions.pod:2083
12458 msgid "FreeBSD."
12459 msgstr ""
12460
12461 # type: textblock
12462 #. type: textblock
12463 #: ../src/guestfs-actions.pod:3012 ../fish/guestfish-actions.pod:2087
12464 msgid "The operating system type could not be determined."
12465 msgstr ""
12466
12467 #. type: =head2
12468 #: ../src/guestfs-actions.pod:3026
12469 msgid "guestfs_inspect_get_windows_current_control_set"
12470 msgstr ""
12471
12472 #. type: verbatim
12473 #: ../src/guestfs-actions.pod:3028
12474 #, no-wrap
12475 msgid ""
12476 " char *\n"
12477 " guestfs_inspect_get_windows_current_control_set (guestfs_h *g,\n"
12478 "                                                  const char *root);\n"
12479 "\n"
12480 msgstr ""
12481
12482 #. type: textblock
12483 #: ../src/guestfs-actions.pod:3035 ../fish/guestfish-actions.pod:2103
12484 msgid ""
12485 "This returns the Windows CurrentControlSet of the inspected guest.  The "
12486 "CurrentControlSet is a registry key name such as C<ControlSet001>."
12487 msgstr ""
12488
12489 #. type: textblock
12490 #: ../src/guestfs-actions.pod:3038 ../fish/guestfish-actions.pod:2106
12491 msgid ""
12492 "This call assumes that the guest is Windows and that the Registry could be "
12493 "examined by inspection.  If this is not the case then an error is returned."
12494 msgstr ""
12495
12496 # type: =head2
12497 #. type: =head2
12498 #: ../src/guestfs-actions.pod:3047
12499 msgid "guestfs_inspect_get_windows_systemroot"
12500 msgstr ""
12501
12502 # type: verbatim
12503 #. type: verbatim
12504 #: ../src/guestfs-actions.pod:3049
12505 #, no-wrap
12506 msgid ""
12507 " char *\n"
12508 " guestfs_inspect_get_windows_systemroot (guestfs_h *g,\n"
12509 "                                         const char *root);\n"
12510 "\n"
12511 msgstr ""
12512
12513 # type: textblock
12514 #. type: textblock
12515 #: ../src/guestfs-actions.pod:3056 ../fish/guestfish-actions.pod:2119
12516 msgid ""
12517 "This returns the Windows systemroot of the inspected guest.  The systemroot "
12518 "is a directory path such as C</WINDOWS>."
12519 msgstr ""
12520
12521 # type: textblock
12522 #. type: textblock
12523 #: ../src/guestfs-actions.pod:3059 ../fish/guestfish-actions.pod:2122
12524 msgid ""
12525 "This call assumes that the guest is Windows and that the systemroot could be "
12526 "determined by inspection.  If this is not the case then an error is returned."
12527 msgstr ""
12528
12529 # type: textblock
12530 #. type: textblock
12531 #: ../src/guestfs-actions.pod:3068
12532 msgid "(Added in 1.5.25)"
12533 msgstr ""
12534
12535 #. type: =head2
12536 #: ../src/guestfs-actions.pod:3070
12537 msgid "guestfs_inspect_is_live"
12538 msgstr ""
12539
12540 #. type: verbatim
12541 #: ../src/guestfs-actions.pod:3072
12542 #, no-wrap
12543 msgid ""
12544 " int\n"
12545 " guestfs_inspect_is_live (guestfs_h *g,\n"
12546 "                          const char *root);\n"
12547 "\n"
12548 msgstr ""
12549
12550 #. type: textblock
12551 #: ../src/guestfs-actions.pod:3079
12552 msgid ""
12553 "If C<guestfs_inspect_get_format> returns C<installer> (this is an install "
12554 "disk), then this returns true if a live image was detected on the disk."
12555 msgstr ""
12556
12557 #. type: =head2
12558 #: ../src/guestfs-actions.pod:3087
12559 msgid "guestfs_inspect_is_multipart"
12560 msgstr ""
12561
12562 #. type: verbatim
12563 #: ../src/guestfs-actions.pod:3089
12564 #, no-wrap
12565 msgid ""
12566 " int\n"
12567 " guestfs_inspect_is_multipart (guestfs_h *g,\n"
12568 "                               const char *root);\n"
12569 "\n"
12570 msgstr ""
12571
12572 #. type: textblock
12573 #: ../src/guestfs-actions.pod:3096
12574 msgid ""
12575 "If C<guestfs_inspect_get_format> returns C<installer> (this is an install "
12576 "disk), then this returns true if the disk is part of a set."
12577 msgstr ""
12578
12579 #. type: =head2
12580 #: ../src/guestfs-actions.pod:3104
12581 msgid "guestfs_inspect_is_netinst"
12582 msgstr ""
12583
12584 #. type: verbatim
12585 #: ../src/guestfs-actions.pod:3106
12586 #, no-wrap
12587 msgid ""
12588 " int\n"
12589 " guestfs_inspect_is_netinst (guestfs_h *g,\n"
12590 "                             const char *root);\n"
12591 "\n"
12592 msgstr ""
12593
12594 #. type: textblock
12595 #: ../src/guestfs-actions.pod:3113
12596 msgid ""
12597 "If C<guestfs_inspect_get_format> returns C<installer> (this is an install "
12598 "disk), then this returns true if the disk is a network installer, ie. not a "
12599 "self-contained install CD but one which is likely to require network access "
12600 "to complete the install."
12601 msgstr ""
12602
12603 # type: =head2
12604 #. type: =head2
12605 #: ../src/guestfs-actions.pod:3123
12606 msgid "guestfs_inspect_list_applications"
12607 msgstr ""
12608
12609 # type: verbatim
12610 #. type: verbatim
12611 #: ../src/guestfs-actions.pod:3125
12612 #, no-wrap
12613 msgid ""
12614 " struct guestfs_application_list *\n"
12615 " guestfs_inspect_list_applications (guestfs_h *g,\n"
12616 "                                    const char *root);\n"
12617 "\n"
12618 msgstr ""
12619
12620 # type: textblock
12621 #. type: textblock
12622 #: ../src/guestfs-actions.pod:3132 ../fish/guestfish-actions.pod:2176
12623 msgid "Return the list of applications installed in the operating system."
12624 msgstr ""
12625
12626 # type: textblock
12627 #. type: textblock
12628 #: ../src/guestfs-actions.pod:3134
12629 msgid ""
12630 "I<Note:> This call works differently from other parts of the inspection "
12631 "API.  You have to call C<guestfs_inspect_os>, then "
12632 "C<guestfs_inspect_get_mountpoints>, then mount up the disks, before calling "
12633 "this.  Listing applications is a significantly more difficult operation "
12634 "which requires access to the full filesystem.  Also note that unlike the "
12635 "other C<guestfs_inspect_get_*> calls which are just returning data cached in "
12636 "the libguestfs handle, this call actually reads parts of the mounted "
12637 "filesystems during the call."
12638 msgstr ""
12639
12640 # type: textblock
12641 #. type: textblock
12642 #: ../src/guestfs-actions.pod:3144 ../fish/guestfish-actions.pod:2188
12643 msgid ""
12644 "This returns an empty list if the inspection code was not able to determine "
12645 "the list of applications."
12646 msgstr ""
12647
12648 # type: textblock
12649 #. type: textblock
12650 #: ../src/guestfs-actions.pod:3147 ../fish/guestfish-actions.pod:2191
12651 msgid "The application structure contains the following fields:"
12652 msgstr ""
12653
12654 # type: =item
12655 #. type: =item
12656 #: ../src/guestfs-actions.pod:3151 ../fish/guestfish-actions.pod:2195
12657 msgid "C<app_name>"
12658 msgstr ""
12659
12660 # type: textblock
12661 #. type: textblock
12662 #: ../src/guestfs-actions.pod:3153 ../fish/guestfish-actions.pod:2197
12663 msgid ""
12664 "The name of the application.  For Red Hat-derived and Debian-derived Linux "
12665 "guests, this is the package name."
12666 msgstr ""
12667
12668 # type: =item
12669 #. type: =item
12670 #: ../src/guestfs-actions.pod:3156 ../fish/guestfish-actions.pod:2200
12671 msgid "C<app_display_name>"
12672 msgstr ""
12673
12674 # type: textblock
12675 #. type: textblock
12676 #: ../src/guestfs-actions.pod:3158 ../fish/guestfish-actions.pod:2202
12677 msgid ""
12678 "The display name of the application, sometimes localized to the install "
12679 "language of the guest operating system."
12680 msgstr ""
12681
12682 # type: textblock
12683 #. type: textblock
12684 #: ../src/guestfs-actions.pod:3161 ../fish/guestfish-actions.pod:2205
12685 msgid ""
12686 "If unavailable this is returned as an empty string C<\"\">.  Callers needing "
12687 "to display something can use C<app_name> instead."
12688 msgstr ""
12689
12690 # type: =item
12691 #. type: =item
12692 #: ../src/guestfs-actions.pod:3164 ../fish/guestfish-actions.pod:2208
12693 msgid "C<app_epoch>"
12694 msgstr ""
12695
12696 # type: textblock
12697 #. type: textblock
12698 #: ../src/guestfs-actions.pod:3166 ../fish/guestfish-actions.pod:2210
12699 msgid ""
12700 "For package managers which use epochs, this contains the epoch of the "
12701 "package (an integer).  If unavailable, this is returned as C<0>."
12702 msgstr ""
12703
12704 # type: =item
12705 #. type: =item
12706 #: ../src/guestfs-actions.pod:3169 ../fish/guestfish-actions.pod:2213
12707 msgid "C<app_version>"
12708 msgstr ""
12709
12710 # type: textblock
12711 #. type: textblock
12712 #: ../src/guestfs-actions.pod:3171 ../fish/guestfish-actions.pod:2215
12713 msgid ""
12714 "The version string of the application or package.  If unavailable this is "
12715 "returned as an empty string C<\"\">."
12716 msgstr ""
12717
12718 # type: =item
12719 #. type: =item
12720 #: ../src/guestfs-actions.pod:3174 ../fish/guestfish-actions.pod:2218
12721 msgid "C<app_release>"
12722 msgstr ""
12723
12724 # type: textblock
12725 #. type: textblock
12726 #: ../src/guestfs-actions.pod:3176 ../fish/guestfish-actions.pod:2220
12727 msgid ""
12728 "The release string of the application or package, for package managers that "
12729 "use this.  If unavailable this is returned as an empty string C<\"\">."
12730 msgstr ""
12731
12732 # type: =item
12733 #. type: =item
12734 #: ../src/guestfs-actions.pod:3180 ../fish/guestfish-actions.pod:2224
12735 msgid "C<app_install_path>"
12736 msgstr ""
12737
12738 # type: textblock
12739 #. type: textblock
12740 #: ../src/guestfs-actions.pod:3182 ../fish/guestfish-actions.pod:2226
12741 msgid ""
12742 "The installation path of the application (on operating systems such as "
12743 "Windows which use installation paths).  This path is in the format used by "
12744 "the guest operating system, it is not a libguestfs path."
12745 msgstr ""
12746
12747 # type: textblock
12748 #. type: textblock
12749 #: ../src/guestfs-actions.pod:3187 ../fish/guestfish-actions.pod:2231
12750 msgid "If unavailable this is returned as an empty string C<\"\">."
12751 msgstr ""
12752
12753 # type: =item
12754 #. type: =item
12755 #: ../src/guestfs-actions.pod:3189 ../fish/guestfish-actions.pod:2233
12756 msgid "C<app_trans_path>"
12757 msgstr ""
12758
12759 # type: textblock
12760 #. type: textblock
12761 #: ../src/guestfs-actions.pod:3191 ../fish/guestfish-actions.pod:2235
12762 msgid ""
12763 "The install path translated into a libguestfs path.  If unavailable this is "
12764 "returned as an empty string C<\"\">."
12765 msgstr ""
12766
12767 # type: =item
12768 #. type: =item
12769 #: ../src/guestfs-actions.pod:3194 ../fish/guestfish-actions.pod:2238
12770 msgid "C<app_publisher>"
12771 msgstr ""
12772
12773 # type: textblock
12774 #. type: textblock
12775 #: ../src/guestfs-actions.pod:3196 ../fish/guestfish-actions.pod:2240
12776 msgid ""
12777 "The name of the publisher of the application, for package managers that use "
12778 "this.  If unavailable this is returned as an empty string C<\"\">."
12779 msgstr ""
12780
12781 # type: =item
12782 #. type: =item
12783 #: ../src/guestfs-actions.pod:3200 ../fish/guestfish-actions.pod:2244
12784 msgid "C<app_url>"
12785 msgstr ""
12786
12787 # type: textblock
12788 #. type: textblock
12789 #: ../src/guestfs-actions.pod:3202 ../fish/guestfish-actions.pod:2246
12790 msgid ""
12791 "The URL (eg. upstream URL) of the application.  If unavailable this is "
12792 "returned as an empty string C<\"\">."
12793 msgstr ""
12794
12795 # type: =item
12796 #. type: =item
12797 #: ../src/guestfs-actions.pod:3205 ../fish/guestfish-actions.pod:2249
12798 msgid "C<app_source_package>"
12799 msgstr ""
12800
12801 # type: textblock
12802 #. type: textblock
12803 #: ../src/guestfs-actions.pod:3207 ../fish/guestfish-actions.pod:2251
12804 msgid ""
12805 "For packaging systems which support this, the name of the source package.  "
12806 "If unavailable this is returned as an empty string C<\"\">."
12807 msgstr ""
12808
12809 # type: =item
12810 #. type: =item
12811 #: ../src/guestfs-actions.pod:3210 ../fish/guestfish-actions.pod:2254
12812 msgid "C<app_summary>"
12813 msgstr ""
12814
12815 # type: textblock
12816 #. type: textblock
12817 #: ../src/guestfs-actions.pod:3212 ../fish/guestfish-actions.pod:2256
12818 msgid ""
12819 "A short (usually one line) description of the application or package.  If "
12820 "unavailable this is returned as an empty string C<\"\">."
12821 msgstr ""
12822
12823 # type: =item
12824 #. type: =item
12825 #: ../src/guestfs-actions.pod:3215 ../fish/guestfish-actions.pod:2259
12826 msgid "C<app_description>"
12827 msgstr ""
12828
12829 # type: textblock
12830 #. type: textblock
12831 #: ../src/guestfs-actions.pod:3217 ../fish/guestfish-actions.pod:2261
12832 msgid ""
12833 "A longer description of the application or package.  If unavailable this is "
12834 "returned as an empty string C<\"\">."
12835 msgstr ""
12836
12837 # type: textblock
12838 #. type: textblock
12839 #: ../src/guestfs-actions.pod:3224
12840 msgid ""
12841 "This function returns a C<struct guestfs_application_list *>, or NULL if "
12842 "there was an error.  I<The caller must call C<guestfs_free_application_list> "
12843 "after use>."
12844 msgstr ""
12845
12846 # type: textblock
12847 #. type: textblock
12848 #: ../src/guestfs-actions.pod:3228
12849 msgid "(Added in 1.7.8)"
12850 msgstr ""
12851
12852 # type: =head2
12853 #. type: =head2
12854 #: ../src/guestfs-actions.pod:3230
12855 msgid "guestfs_inspect_os"
12856 msgstr ""
12857
12858 # type: verbatim
12859 #. type: verbatim
12860 #: ../src/guestfs-actions.pod:3232
12861 #, no-wrap
12862 msgid ""
12863 " char **\n"
12864 " guestfs_inspect_os (guestfs_h *g);\n"
12865 "\n"
12866 msgstr ""
12867
12868 # type: textblock
12869 #. type: textblock
12870 #: ../src/guestfs-actions.pod:3235 ../fish/guestfish-actions.pod:2272
12871 msgid ""
12872 "This function uses other libguestfs functions and certain heuristics to "
12873 "inspect the disk(s) (usually disks belonging to a virtual machine), looking "
12874 "for operating systems."
12875 msgstr ""
12876
12877 # type: textblock
12878 #. type: textblock
12879 #: ../src/guestfs-actions.pod:3239 ../fish/guestfish-actions.pod:2276
12880 msgid "The list returned is empty if no operating systems were found."
12881 msgstr ""
12882
12883 # type: textblock
12884 #. type: textblock
12885 #: ../src/guestfs-actions.pod:3241 ../fish/guestfish-actions.pod:2278
12886 msgid ""
12887 "If one operating system was found, then this returns a list with a single "
12888 "element, which is the name of the root filesystem of this operating system.  "
12889 "It is also possible for this function to return a list containing more than "
12890 "one element, indicating a dual-boot or multi-boot virtual machine, with each "
12891 "element being the root filesystem of one of the operating systems."
12892 msgstr ""
12893
12894 # type: textblock
12895 #. type: textblock
12896 #: ../src/guestfs-actions.pod:3248
12897 msgid ""
12898 "You can pass the root string(s) returned to other C<guestfs_inspect_get_*> "
12899 "functions in order to query further information about each operating system, "
12900 "such as the name and version."
12901 msgstr ""
12902
12903 # type: textblock
12904 #. type: textblock
12905 #: ../src/guestfs-actions.pod:3253
12906 msgid ""
12907 "This function uses other libguestfs features such as C<guestfs_mount_ro> and "
12908 "C<guestfs_umount_all> in order to mount and unmount filesystems and look at "
12909 "the contents.  This should be called with no disks currently mounted.  The "
12910 "function may also use Augeas, so any existing Augeas handle will be closed."
12911 msgstr ""
12912
12913 # type: textblock
12914 #. type: textblock
12915 #: ../src/guestfs-actions.pod:3259 ../fish/guestfish-actions.pod:2296
12916 msgid ""
12917 "This function cannot decrypt encrypted disks.  The caller must do that first "
12918 "(supplying the necessary keys) if the disk is encrypted."
12919 msgstr ""
12920
12921 # type: textblock
12922 #. type: textblock
12923 #: ../src/guestfs-actions.pod:3265 ../src/guestfs-actions.pod:3555
12924 #: ../src/guestfs-actions.pod:3617
12925 msgid "See also C<guestfs_list_filesystems>."
12926 msgstr ""
12927
12928 # type: =head2
12929 #. type: =head2
12930 #: ../src/guestfs-actions.pod:3273
12931 msgid "guestfs_is_blockdev"
12932 msgstr ""
12933
12934 # type: verbatim
12935 #. type: verbatim
12936 #: ../src/guestfs-actions.pod:3275
12937 #, no-wrap
12938 msgid ""
12939 " int\n"
12940 " guestfs_is_blockdev (guestfs_h *g,\n"
12941 "                      const char *path);\n"
12942 "\n"
12943 msgstr ""
12944
12945 # type: textblock
12946 #. type: textblock
12947 #: ../src/guestfs-actions.pod:3279 ../fish/guestfish-actions.pod:2308
12948 msgid ""
12949 "This returns C<true> if and only if there is a block device with the given "
12950 "C<path> name."
12951 msgstr ""
12952
12953 # type: textblock
12954 #. type: textblock
12955 #: ../src/guestfs-actions.pod:3282 ../src/guestfs-actions.pod:3311
12956 #: ../src/guestfs-actions.pod:3341 ../src/guestfs-actions.pod:3356
12957 #: ../src/guestfs-actions.pod:3372 ../src/guestfs-actions.pod:3428
12958 #: ../src/guestfs-actions.pod:3443
12959 msgid "See also C<guestfs_stat>."
12960 msgstr ""
12961
12962 # type: textblock
12963 #. type: textblock
12964 #: ../src/guestfs-actions.pod:3286 ../src/guestfs-actions.pod:3315
12965 #: ../src/guestfs-actions.pod:3360 ../src/guestfs-actions.pod:3432
12966 #: ../src/guestfs-actions.pod:3447
12967 msgid "(Added in 1.5.10)"
12968 msgstr ""
12969
12970 # type: =head2
12971 #. type: =head2
12972 #: ../src/guestfs-actions.pod:3288
12973 msgid "guestfs_is_busy"
12974 msgstr ""
12975
12976 # type: verbatim
12977 #. type: verbatim
12978 #: ../src/guestfs-actions.pod:3290
12979 #, no-wrap
12980 msgid ""
12981 " int\n"
12982 " guestfs_is_busy (guestfs_h *g);\n"
12983 "\n"
12984 msgstr ""
12985
12986 # type: textblock
12987 #. type: textblock
12988 #: ../src/guestfs-actions.pod:3293 ../fish/guestfish-actions.pod:2317
12989 msgid ""
12990 "This returns true iff this handle is busy processing a command (in the "
12991 "C<BUSY> state)."
12992 msgstr ""
12993
12994 # type: =head2
12995 #. type: =head2
12996 #: ../src/guestfs-actions.pod:3302
12997 msgid "guestfs_is_chardev"
12998 msgstr ""
12999
13000 # type: verbatim
13001 #. type: verbatim
13002 #: ../src/guestfs-actions.pod:3304
13003 #, no-wrap
13004 msgid ""
13005 " int\n"
13006 " guestfs_is_chardev (guestfs_h *g,\n"
13007 "                     const char *path);\n"
13008 "\n"
13009 msgstr ""
13010
13011 # type: textblock
13012 #. type: textblock
13013 #: ../src/guestfs-actions.pod:3308 ../fish/guestfish-actions.pod:2326
13014 msgid ""
13015 "This returns C<true> if and only if there is a character device with the "
13016 "given C<path> name."
13017 msgstr ""
13018
13019 # type: =head2
13020 #. type: =head2
13021 #: ../src/guestfs-actions.pod:3317
13022 msgid "guestfs_is_config"
13023 msgstr ""
13024
13025 # type: verbatim
13026 #. type: verbatim
13027 #: ../src/guestfs-actions.pod:3319
13028 #, no-wrap
13029 msgid ""
13030 " int\n"
13031 " guestfs_is_config (guestfs_h *g);\n"
13032 "\n"
13033 msgstr ""
13034
13035 # type: textblock
13036 #. type: textblock
13037 #: ../src/guestfs-actions.pod:3322 ../fish/guestfish-actions.pod:2335
13038 msgid ""
13039 "This returns true iff this handle is being configured (in the C<CONFIG> "
13040 "state)."
13041 msgstr ""
13042
13043 # type: =head2
13044 #. type: =head2
13045 #: ../src/guestfs-actions.pod:3331
13046 msgid "guestfs_is_dir"
13047 msgstr ""
13048
13049 # type: verbatim
13050 #. type: verbatim
13051 #: ../src/guestfs-actions.pod:3333
13052 #, no-wrap
13053 msgid ""
13054 " int\n"
13055 " guestfs_is_dir (guestfs_h *g,\n"
13056 "                 const char *path);\n"
13057 "\n"
13058 msgstr ""
13059
13060 # type: textblock
13061 #. type: textblock
13062 #: ../src/guestfs-actions.pod:3337 ../fish/guestfish-actions.pod:2344
13063 msgid ""
13064 "This returns C<true> if and only if there is a directory with the given "
13065 "C<path> name.  Note that it returns false for other objects like files."
13066 msgstr ""
13067
13068 # type: =head2
13069 #. type: =head2
13070 #: ../src/guestfs-actions.pod:3347
13071 msgid "guestfs_is_fifo"
13072 msgstr ""
13073
13074 # type: verbatim
13075 #. type: verbatim
13076 #: ../src/guestfs-actions.pod:3349
13077 #, no-wrap
13078 msgid ""
13079 " int\n"
13080 " guestfs_is_fifo (guestfs_h *g,\n"
13081 "                  const char *path);\n"
13082 "\n"
13083 msgstr ""
13084
13085 # type: textblock
13086 #. type: textblock
13087 #: ../src/guestfs-actions.pod:3353 ../fish/guestfish-actions.pod:2354
13088 msgid ""
13089 "This returns C<true> if and only if there is a FIFO (named pipe)  with the "
13090 "given C<path> name."
13091 msgstr ""
13092
13093 # type: =head2
13094 #. type: =head2
13095 #: ../src/guestfs-actions.pod:3362
13096 msgid "guestfs_is_file"
13097 msgstr ""
13098
13099 # type: verbatim
13100 #. type: verbatim
13101 #: ../src/guestfs-actions.pod:3364
13102 #, no-wrap
13103 msgid ""
13104 " int\n"
13105 " guestfs_is_file (guestfs_h *g,\n"
13106 "                  const char *path);\n"
13107 "\n"
13108 msgstr ""
13109
13110 # type: textblock
13111 #. type: textblock
13112 #: ../src/guestfs-actions.pod:3368 ../fish/guestfish-actions.pod:2363
13113 msgid ""
13114 "This returns C<true> if and only if there is a regular file with the given "
13115 "C<path> name.  Note that it returns false for other objects like directories."
13116 msgstr ""
13117
13118 # type: =head2
13119 #. type: =head2
13120 #: ../src/guestfs-actions.pod:3378
13121 msgid "guestfs_is_launching"
13122 msgstr ""
13123
13124 # type: verbatim
13125 #. type: verbatim
13126 #: ../src/guestfs-actions.pod:3380
13127 #, no-wrap
13128 msgid ""
13129 " int\n"
13130 " guestfs_is_launching (guestfs_h *g);\n"
13131 "\n"
13132 msgstr ""
13133
13134 # type: textblock
13135 #. type: textblock
13136 #: ../src/guestfs-actions.pod:3383 ../fish/guestfish-actions.pod:2373
13137 msgid ""
13138 "This returns true iff this handle is launching the subprocess (in the "
13139 "C<LAUNCHING> state)."
13140 msgstr ""
13141
13142 # type: =head2
13143 #. type: =head2
13144 #: ../src/guestfs-actions.pod:3392
13145 msgid "guestfs_is_lv"
13146 msgstr ""
13147
13148 # type: verbatim
13149 #. type: verbatim
13150 #: ../src/guestfs-actions.pod:3394
13151 #, no-wrap
13152 msgid ""
13153 " int\n"
13154 " guestfs_is_lv (guestfs_h *g,\n"
13155 "                const char *device);\n"
13156 "\n"
13157 msgstr ""
13158
13159 # type: textblock
13160 #. type: textblock
13161 #: ../src/guestfs-actions.pod:3398 ../fish/guestfish-actions.pod:2382
13162 msgid ""
13163 "This command tests whether C<device> is a logical volume, and returns true "
13164 "iff this is the case."
13165 msgstr ""
13166
13167 # type: =head2
13168 #. type: =head2
13169 #: ../src/guestfs-actions.pod:3405
13170 msgid "guestfs_is_ready"
13171 msgstr ""
13172
13173 # type: verbatim
13174 #. type: verbatim
13175 #: ../src/guestfs-actions.pod:3407
13176 #, no-wrap
13177 msgid ""
13178 " int\n"
13179 " guestfs_is_ready (guestfs_h *g);\n"
13180 "\n"
13181 msgstr ""
13182
13183 # type: textblock
13184 #. type: textblock
13185 #: ../src/guestfs-actions.pod:3410 ../fish/guestfish-actions.pod:2389
13186 msgid ""
13187 "This returns true iff this handle is ready to accept commands (in the "
13188 "C<READY> state)."
13189 msgstr ""
13190
13191 # type: =head2
13192 #. type: =head2
13193 #: ../src/guestfs-actions.pod:3419
13194 msgid "guestfs_is_socket"
13195 msgstr ""
13196
13197 # type: verbatim
13198 #. type: verbatim
13199 #: ../src/guestfs-actions.pod:3421
13200 #, no-wrap
13201 msgid ""
13202 " int\n"
13203 " guestfs_is_socket (guestfs_h *g,\n"
13204 "                    const char *path);\n"
13205 "\n"
13206 msgstr ""
13207
13208 # type: textblock
13209 #. type: textblock
13210 #: ../src/guestfs-actions.pod:3425 ../fish/guestfish-actions.pod:2398
13211 msgid ""
13212 "This returns C<true> if and only if there is a Unix domain socket with the "
13213 "given C<path> name."
13214 msgstr ""
13215
13216 # type: =head2
13217 #. type: =head2
13218 #: ../src/guestfs-actions.pod:3434
13219 msgid "guestfs_is_symlink"
13220 msgstr ""
13221
13222 # type: verbatim
13223 #. type: verbatim
13224 #: ../src/guestfs-actions.pod:3436
13225 #, no-wrap
13226 msgid ""
13227 " int\n"
13228 " guestfs_is_symlink (guestfs_h *g,\n"
13229 "                     const char *path);\n"
13230 "\n"
13231 msgstr ""
13232
13233 # type: textblock
13234 #. type: textblock
13235 #: ../src/guestfs-actions.pod:3440 ../fish/guestfish-actions.pod:2407
13236 msgid ""
13237 "This returns C<true> if and only if there is a symbolic link with the given "
13238 "C<path> name."
13239 msgstr ""
13240
13241 # type: =head2
13242 #. type: =head2
13243 #: ../src/guestfs-actions.pod:3449
13244 msgid "guestfs_kill_subprocess"
13245 msgstr ""
13246
13247 # type: verbatim
13248 #. type: verbatim
13249 #: ../src/guestfs-actions.pod:3451
13250 #, no-wrap
13251 msgid ""
13252 " int\n"
13253 " guestfs_kill_subprocess (guestfs_h *g);\n"
13254 "\n"
13255 msgstr ""
13256
13257 # type: textblock
13258 #. type: textblock
13259 #: ../src/guestfs-actions.pod:3454 ../fish/guestfish-actions.pod:2416
13260 msgid "This kills the qemu subprocess.  You should never need to call this."
13261 msgstr ""
13262
13263 # type: =head2
13264 #. type: =head2
13265 #: ../src/guestfs-actions.pod:3460
13266 msgid "guestfs_launch"
13267 msgstr ""
13268
13269 # type: verbatim
13270 #. type: verbatim
13271 #: ../src/guestfs-actions.pod:3462
13272 #, no-wrap
13273 msgid ""
13274 " int\n"
13275 " guestfs_launch (guestfs_h *g);\n"
13276 "\n"
13277 msgstr ""
13278
13279 # type: textblock
13280 #. type: textblock
13281 #: ../src/guestfs-actions.pod:3465 ../fish/guestfish-actions.pod:2424
13282 msgid ""
13283 "Internally libguestfs is implemented by running a virtual machine using "
13284 "L<qemu(1)>."
13285 msgstr ""
13286
13287 # type: textblock
13288 #. type: textblock
13289 #: ../src/guestfs-actions.pod:3468 ../fish/guestfish-actions.pod:2427
13290 msgid ""
13291 "You should call this after configuring the handle (eg. adding drives) but "
13292 "before performing any actions."
13293 msgstr ""
13294
13295 # type: =head2
13296 #. type: =head2
13297 #: ../src/guestfs-actions.pod:3480
13298 msgid "guestfs_lchown"
13299 msgstr ""
13300
13301 # type: verbatim
13302 #. type: verbatim
13303 #: ../src/guestfs-actions.pod:3482
13304 #, no-wrap
13305 msgid ""
13306 " int\n"
13307 " guestfs_lchown (guestfs_h *g,\n"
13308 "                 int owner,\n"
13309 "                 int group,\n"
13310 "                 const char *path);\n"
13311 "\n"
13312 msgstr ""
13313
13314 # type: textblock
13315 #. type: textblock
13316 #: ../src/guestfs-actions.pod:3488
13317 msgid ""
13318 "Change the file owner to C<owner> and group to C<group>.  This is like "
13319 "C<guestfs_chown> but if C<path> is a symlink then the link itself is "
13320 "changed, not the target."
13321 msgstr ""
13322
13323 # type: =head2
13324 #. type: =head2
13325 #: ../src/guestfs-actions.pod:3500
13326 msgid "guestfs_lgetxattr"
13327 msgstr ""
13328
13329 # type: verbatim
13330 #. type: verbatim
13331 #: ../src/guestfs-actions.pod:3502
13332 #, no-wrap
13333 msgid ""
13334 " char *\n"
13335 " guestfs_lgetxattr (guestfs_h *g,\n"
13336 "                    const char *path,\n"
13337 "                    const char *name,\n"
13338 "                    size_t *size_r);\n"
13339 "\n"
13340 msgstr ""
13341
13342 # type: textblock
13343 #. type: textblock
13344 #: ../src/guestfs-actions.pod:3508 ../fish/guestfish-actions.pod:2446
13345 msgid ""
13346 "Get a single extended attribute from file C<path> named C<name>.  If C<path> "
13347 "is a symlink, then this call returns an extended attribute from the symlink."
13348 msgstr ""
13349
13350 # type: textblock
13351 #. type: textblock
13352 #: ../src/guestfs-actions.pod:3522
13353 msgid "See also: C<guestfs_lgetxattrs>, C<guestfs_getxattr>, L<attr(5)>."
13354 msgstr ""
13355
13356 # type: =head2
13357 #. type: =head2
13358 #: ../src/guestfs-actions.pod:3530
13359 msgid "guestfs_lgetxattrs"
13360 msgstr ""
13361
13362 # type: verbatim
13363 #. type: verbatim
13364 #: ../src/guestfs-actions.pod:3532
13365 #, no-wrap
13366 msgid ""
13367 " struct guestfs_xattr_list *\n"
13368 " guestfs_lgetxattrs (guestfs_h *g,\n"
13369 "                     const char *path);\n"
13370 "\n"
13371 msgstr ""
13372
13373 # type: textblock
13374 #. type: textblock
13375 #: ../src/guestfs-actions.pod:3536
13376 msgid ""
13377 "This is the same as C<guestfs_getxattrs>, but if C<path> is a symbolic link, "
13378 "then it returns the extended attributes of the link itself."
13379 msgstr ""
13380
13381 # type: =head2
13382 #. type: =head2
13383 #: ../src/guestfs-actions.pod:3546
13384 msgid "guestfs_list_devices"
13385 msgstr ""
13386
13387 # type: verbatim
13388 #. type: verbatim
13389 #: ../src/guestfs-actions.pod:3548
13390 #, no-wrap
13391 msgid ""
13392 " char **\n"
13393 " guestfs_list_devices (guestfs_h *g);\n"
13394 "\n"
13395 msgstr ""
13396
13397 # type: textblock
13398 #. type: textblock
13399 #: ../src/guestfs-actions.pod:3551 ../fish/guestfish-actions.pod:2474
13400 msgid "List all the block devices."
13401 msgstr ""
13402
13403 # type: textblock
13404 #. type: textblock
13405 #: ../src/guestfs-actions.pod:3553 ../fish/guestfish-actions.pod:2476
13406 msgid "The full block device names are returned, eg. C</dev/sda>."
13407 msgstr ""
13408
13409 # type: =head2
13410 #. type: =head2
13411 #: ../src/guestfs-actions.pod:3563
13412 msgid "guestfs_list_filesystems"
13413 msgstr ""
13414
13415 # type: verbatim
13416 #. type: verbatim
13417 #: ../src/guestfs-actions.pod:3565
13418 #, no-wrap
13419 msgid ""
13420 " char **\n"
13421 " guestfs_list_filesystems (guestfs_h *g);\n"
13422 "\n"
13423 msgstr ""
13424
13425 # type: textblock
13426 #. type: textblock
13427 #: ../src/guestfs-actions.pod:3568 ../fish/guestfish-actions.pod:2484
13428 msgid ""
13429 "This inspection command looks for filesystems on partitions, block devices "
13430 "and logical volumes, returning a list of devices containing filesystems and "
13431 "their type."
13432 msgstr ""
13433
13434 # type: textblock
13435 #. type: textblock
13436 #: ../src/guestfs-actions.pod:3572 ../fish/guestfish-actions.pod:2488
13437 msgid ""
13438 "The return value is a hash, where the keys are the devices containing "
13439 "filesystems, and the values are the filesystem types.  For example:"
13440 msgstr ""
13441
13442 # type: verbatim
13443 #. type: verbatim
13444 #: ../src/guestfs-actions.pod:3576 ../fish/guestfish-actions.pod:2492
13445 #, no-wrap
13446 msgid ""
13447 " \"/dev/sda1\" => \"ntfs\"\n"
13448 " \"/dev/sda2\" => \"ext2\"\n"
13449 " \"/dev/vg_guest/lv_root\" => \"ext4\"\n"
13450 " \"/dev/vg_guest/lv_swap\" => \"swap\"\n"
13451 "\n"
13452 msgstr ""
13453
13454 # type: textblock
13455 #. type: textblock
13456 #: ../src/guestfs-actions.pod:3581 ../fish/guestfish-actions.pod:2497
13457 msgid ""
13458 "The value can have the special value \"unknown\", meaning the content of the "
13459 "device is undetermined or empty.  \"swap\" means a Linux swap partition."
13460 msgstr ""
13461
13462 # type: textblock
13463 #. type: textblock
13464 #: ../src/guestfs-actions.pod:3585
13465 msgid ""
13466 "This command runs other libguestfs commands, which might include "
13467 "C<guestfs_mount> and C<guestfs_umount>, and therefore you should use this "
13468 "soon after launch and only when nothing is mounted."
13469 msgstr ""
13470
13471 # type: textblock
13472 #. type: textblock
13473 #: ../src/guestfs-actions.pod:3589
13474 msgid ""
13475 "Not all of the filesystems returned will be mountable.  In particular, swap "
13476 "partitions are returned in the list.  Also this command does not check that "
13477 "each filesystem found is valid and mountable, and some filesystems might be "
13478 "mountable but require special options.  Filesystems may not all belong to a "
13479 "single logical operating system (use C<guestfs_inspect_os> to look for OSes)."
13480 msgstr ""
13481
13482 # type: textblock
13483 #. type: textblock
13484 #: ../src/guestfs-actions.pod:3603 ../src/guestfs-actions.pod:5224
13485 msgid "(Added in 1.5.15)"
13486 msgstr ""
13487
13488 # type: =head2
13489 #. type: =head2
13490 #: ../src/guestfs-actions.pod:3605
13491 msgid "guestfs_list_partitions"
13492 msgstr ""
13493
13494 # type: verbatim
13495 #. type: verbatim
13496 #: ../src/guestfs-actions.pod:3607
13497 #, no-wrap
13498 msgid ""
13499 " char **\n"
13500 " guestfs_list_partitions (guestfs_h *g);\n"
13501 "\n"
13502 msgstr ""
13503
13504 # type: textblock
13505 #. type: textblock
13506 #: ../src/guestfs-actions.pod:3610 ../fish/guestfish-actions.pod:2517
13507 msgid "List all the partitions detected on all block devices."
13508 msgstr ""
13509
13510 # type: textblock
13511 #. type: textblock
13512 #: ../src/guestfs-actions.pod:3612 ../fish/guestfish-actions.pod:2519
13513 msgid "The full partition device names are returned, eg. C</dev/sda1>"
13514 msgstr ""
13515
13516 # type: textblock
13517 #. type: textblock
13518 #: ../src/guestfs-actions.pod:3614
13519 msgid ""
13520 "This does not return logical volumes.  For that you will need to call "
13521 "C<guestfs_lvs>."
13522 msgstr ""
13523
13524 # type: =head2
13525 #. type: =head2
13526 #: ../src/guestfs-actions.pod:3625
13527 msgid "guestfs_ll"
13528 msgstr ""
13529
13530 # type: verbatim
13531 #. type: verbatim
13532 #: ../src/guestfs-actions.pod:3627
13533 #, no-wrap
13534 msgid ""
13535 " char *\n"
13536 " guestfs_ll (guestfs_h *g,\n"
13537 "             const char *directory);\n"
13538 "\n"
13539 msgstr ""
13540
13541 # type: textblock
13542 #. type: textblock
13543 #: ../src/guestfs-actions.pod:3631 ../fish/guestfish-actions.pod:2530
13544 msgid ""
13545 "List the files in C<directory> (relative to the root directory, there is no "
13546 "cwd) in the format of 'ls -la'."
13547 msgstr ""
13548
13549 # type: textblock
13550 #. type: textblock
13551 #: ../src/guestfs-actions.pod:3634 ../fish/guestfish-actions.pod:2533
13552 msgid ""
13553 "This command is mostly useful for interactive sessions.  It is I<not> "
13554 "intended that you try to parse the output string."
13555 msgstr ""
13556
13557 # type: =head2
13558 #. type: =head2
13559 #: ../src/guestfs-actions.pod:3642
13560 msgid "guestfs_ln"
13561 msgstr ""
13562
13563 # type: verbatim
13564 #. type: verbatim
13565 #: ../src/guestfs-actions.pod:3644
13566 #, no-wrap
13567 msgid ""
13568 " int\n"
13569 " guestfs_ln (guestfs_h *g,\n"
13570 "             const char *target,\n"
13571 "             const char *linkname);\n"
13572 "\n"
13573 msgstr ""
13574
13575 # type: textblock
13576 #. type: textblock
13577 #: ../src/guestfs-actions.pod:3649 ../fish/guestfish-actions.pod:2540
13578 msgid "This command creates a hard link using the C<ln> command."
13579 msgstr ""
13580
13581 # type: =head2
13582 #. type: =head2
13583 #: ../src/guestfs-actions.pod:3655
13584 msgid "guestfs_ln_f"
13585 msgstr ""
13586
13587 # type: verbatim
13588 #. type: verbatim
13589 #: ../src/guestfs-actions.pod:3657
13590 #, no-wrap
13591 msgid ""
13592 " int\n"
13593 " guestfs_ln_f (guestfs_h *g,\n"
13594 "               const char *target,\n"
13595 "               const char *linkname);\n"
13596 "\n"
13597 msgstr ""
13598
13599 #. type: textblock
13600 #: ../src/guestfs-actions.pod:3662 ../fish/guestfish-actions.pod:2546
13601 msgid ""
13602 "This command creates a hard link using the C<ln -f> command.  The I<-f> "
13603 "option removes the link (C<linkname>) if it exists already."
13604 msgstr ""
13605
13606 # type: =head2
13607 #. type: =head2
13608 #: ../src/guestfs-actions.pod:3669
13609 msgid "guestfs_ln_s"
13610 msgstr ""
13611
13612 # type: verbatim
13613 #. type: verbatim
13614 #: ../src/guestfs-actions.pod:3671
13615 #, no-wrap
13616 msgid ""
13617 " int\n"
13618 " guestfs_ln_s (guestfs_h *g,\n"
13619 "               const char *target,\n"
13620 "               const char *linkname);\n"
13621 "\n"
13622 msgstr ""
13623
13624 # type: textblock
13625 #. type: textblock
13626 #: ../src/guestfs-actions.pod:3676 ../fish/guestfish-actions.pod:2553
13627 msgid "This command creates a symbolic link using the C<ln -s> command."
13628 msgstr ""
13629
13630 # type: =head2
13631 #. type: =head2
13632 #: ../src/guestfs-actions.pod:3682
13633 msgid "guestfs_ln_sf"
13634 msgstr ""
13635
13636 # type: verbatim
13637 #. type: verbatim
13638 #: ../src/guestfs-actions.pod:3684
13639 #, no-wrap
13640 msgid ""
13641 " int\n"
13642 " guestfs_ln_sf (guestfs_h *g,\n"
13643 "                const char *target,\n"
13644 "                const char *linkname);\n"
13645 "\n"
13646 msgstr ""
13647
13648 #. type: textblock
13649 #: ../src/guestfs-actions.pod:3689 ../fish/guestfish-actions.pod:2559
13650 msgid ""
13651 "This command creates a symbolic link using the C<ln -sf> command, The I<-f> "
13652 "option removes the link (C<linkname>) if it exists already."
13653 msgstr ""
13654
13655 # type: =head2
13656 #. type: =head2
13657 #: ../src/guestfs-actions.pod:3696
13658 msgid "guestfs_lremovexattr"
13659 msgstr ""
13660
13661 # type: verbatim
13662 #. type: verbatim
13663 #: ../src/guestfs-actions.pod:3698
13664 #, no-wrap
13665 msgid ""
13666 " int\n"
13667 " guestfs_lremovexattr (guestfs_h *g,\n"
13668 "                       const char *xattr,\n"
13669 "                       const char *path);\n"
13670 "\n"
13671 msgstr ""
13672
13673 # type: textblock
13674 #. type: textblock
13675 #: ../src/guestfs-actions.pod:3703
13676 msgid ""
13677 "This is the same as C<guestfs_removexattr>, but if C<path> is a symbolic "
13678 "link, then it removes an extended attribute of the link itself."
13679 msgstr ""
13680
13681 # type: =head2
13682 #. type: =head2
13683 #: ../src/guestfs-actions.pod:3711
13684 msgid "guestfs_ls"
13685 msgstr ""
13686
13687 # type: verbatim
13688 #. type: verbatim
13689 #: ../src/guestfs-actions.pod:3713
13690 #, no-wrap
13691 msgid ""
13692 " char **\n"
13693 " guestfs_ls (guestfs_h *g,\n"
13694 "             const char *directory);\n"
13695 "\n"
13696 msgstr ""
13697
13698 # type: textblock
13699 #. type: textblock
13700 #: ../src/guestfs-actions.pod:3717 ../fish/guestfish-actions.pod:2574
13701 msgid ""
13702 "List the files in C<directory> (relative to the root directory, there is no "
13703 "cwd).  The '.' and '..' entries are not returned, but hidden files are shown."
13704 msgstr ""
13705
13706 # type: textblock
13707 #. type: textblock
13708 #: ../src/guestfs-actions.pod:3721
13709 msgid ""
13710 "This command is mostly useful for interactive sessions.  Programs should "
13711 "probably use C<guestfs_readdir> instead."
13712 msgstr ""
13713
13714 # type: =head2
13715 #. type: =head2
13716 #: ../src/guestfs-actions.pod:3730
13717 msgid "guestfs_lsetxattr"
13718 msgstr ""
13719
13720 # type: verbatim
13721 #. type: verbatim
13722 #: ../src/guestfs-actions.pod:3732
13723 #, no-wrap
13724 msgid ""
13725 " int\n"
13726 " guestfs_lsetxattr (guestfs_h *g,\n"
13727 "                    const char *xattr,\n"
13728 "                    const char *val,\n"
13729 "                    int vallen,\n"
13730 "                    const char *path);\n"
13731 "\n"
13732 msgstr ""
13733
13734 # type: textblock
13735 #. type: textblock
13736 #: ../src/guestfs-actions.pod:3739
13737 msgid ""
13738 "This is the same as C<guestfs_setxattr>, but if C<path> is a symbolic link, "
13739 "then it sets an extended attribute of the link itself."
13740 msgstr ""
13741
13742 # type: =head2
13743 #. type: =head2
13744 #: ../src/guestfs-actions.pod:3747
13745 msgid "guestfs_lstat"
13746 msgstr ""
13747
13748 # type: verbatim
13749 #. type: verbatim
13750 #: ../src/guestfs-actions.pod:3749
13751 #, no-wrap
13752 msgid ""
13753 " struct guestfs_stat *\n"
13754 " guestfs_lstat (guestfs_h *g,\n"
13755 "                const char *path);\n"
13756 "\n"
13757 msgstr ""
13758
13759 # type: textblock
13760 #. type: textblock
13761 #: ../src/guestfs-actions.pod:3753 ../src/guestfs-actions.pod:6355
13762 #: ../fish/guestfish-actions.pod:2593 ../fish/guestfish-actions.pod:4306
13763 msgid "Returns file information for the given C<path>."
13764 msgstr ""
13765
13766 # type: textblock
13767 #. type: textblock
13768 #: ../src/guestfs-actions.pod:3755
13769 msgid ""
13770 "This is the same as C<guestfs_stat> except that if C<path> is a symbolic "
13771 "link, then the link is stat-ed, not the file it refers to."
13772 msgstr ""
13773
13774 # type: textblock
13775 #. type: textblock
13776 #: ../src/guestfs-actions.pod:3759 ../fish/guestfish-actions.pod:2599
13777 msgid "This is the same as the C<lstat(2)> system call."
13778 msgstr ""
13779
13780 # type: textblock
13781 #. type: textblock
13782 #: ../src/guestfs-actions.pod:3761 ../src/guestfs-actions.pod:6359
13783 msgid ""
13784 "This function returns a C<struct guestfs_stat *>, or NULL if there was an "
13785 "error.  I<The caller must call C<guestfs_free_stat> after use>."
13786 msgstr ""
13787
13788 # type: textblock
13789 #. type: textblock
13790 #: ../src/guestfs-actions.pod:3765 ../src/guestfs-actions.pod:6363
13791 #: ../src/guestfs-actions.pod:6381 ../src/guestfs-actions.pod:6762
13792 msgid "(Added in 0.9.2)"
13793 msgstr ""
13794
13795 # type: =head2
13796 #. type: =head2
13797 #: ../src/guestfs-actions.pod:3767
13798 msgid "guestfs_lstatlist"
13799 msgstr ""
13800
13801 # type: verbatim
13802 #. type: verbatim
13803 #: ../src/guestfs-actions.pod:3769
13804 #, no-wrap
13805 msgid ""
13806 " struct guestfs_stat_list *\n"
13807 " guestfs_lstatlist (guestfs_h *g,\n"
13808 "                    const char *path,\n"
13809 "                    char *const *names);\n"
13810 "\n"
13811 msgstr ""
13812
13813 # type: textblock
13814 #. type: textblock
13815 #: ../src/guestfs-actions.pod:3774
13816 msgid ""
13817 "This call allows you to perform the C<guestfs_lstat> operation on multiple "
13818 "files, where all files are in the directory C<path>.  C<names> is the list "
13819 "of files from this directory."
13820 msgstr ""
13821
13822 # type: textblock
13823 #. type: textblock
13824 #: ../src/guestfs-actions.pod:3778 ../fish/guestfish-actions.pod:2609
13825 msgid ""
13826 "On return you get a list of stat structs, with a one-to-one correspondence "
13827 "to the C<names> list.  If any name did not exist or could not be lstat'd, "
13828 "then the C<ino> field of that structure is set to C<-1>."
13829 msgstr ""
13830
13831 # type: textblock
13832 #. type: textblock
13833 #: ../src/guestfs-actions.pod:3783
13834 msgid ""
13835 "This call is intended for programs that want to efficiently list a directory "
13836 "contents without making many round-trips.  See also C<guestfs_lxattrlist> "
13837 "for a similarly efficient call for getting extended attributes.  Very long "
13838 "directory listings might cause the protocol message size to be exceeded, "
13839 "causing this call to fail.  The caller must split up such requests into "
13840 "smaller groups of names."
13841 msgstr ""
13842
13843 # type: textblock
13844 #. type: textblock
13845 #: ../src/guestfs-actions.pod:3791
13846 msgid ""
13847 "This function returns a C<struct guestfs_stat_list *>, or NULL if there was "
13848 "an error.  I<The caller must call C<guestfs_free_stat_list> after use>."
13849 msgstr ""
13850
13851 # type: =head2
13852 #. type: =head2
13853 #: ../src/guestfs-actions.pod:3797
13854 msgid "guestfs_luks_add_key"
13855 msgstr ""
13856
13857 # type: verbatim
13858 #. type: verbatim
13859 #: ../src/guestfs-actions.pod:3799
13860 #, no-wrap
13861 msgid ""
13862 " int\n"
13863 " guestfs_luks_add_key (guestfs_h *g,\n"
13864 "                       const char *device,\n"
13865 "                       const char *key,\n"
13866 "                       const char *newkey,\n"
13867 "                       int keyslot);\n"
13868 "\n"
13869 msgstr ""
13870
13871 # type: textblock
13872 #. type: textblock
13873 #: ../src/guestfs-actions.pod:3806 ../fish/guestfish-actions.pod:2626
13874 msgid ""
13875 "This command adds a new key on LUKS device C<device>.  C<key> is any "
13876 "existing key, and is used to access the device.  C<newkey> is the new key to "
13877 "add.  C<keyslot> is the key slot that will be replaced."
13878 msgstr ""
13879
13880 # type: textblock
13881 #. type: textblock
13882 #: ../src/guestfs-actions.pod:3811
13883 msgid ""
13884 "Note that if C<keyslot> already contains a key, then this command will "
13885 "fail.  You have to use C<guestfs_luks_kill_slot> first to remove that key."
13886 msgstr ""
13887
13888 # type: textblock
13889 #. type: textblock
13890 #: ../src/guestfs-actions.pod:3817 ../src/guestfs-actions.pod:3857
13891 #: ../src/guestfs-actions.pod:3880 ../src/guestfs-actions.pod:3900
13892 #: ../src/guestfs-actions.pod:3932 ../src/guestfs-actions.pod:3951
13893 msgid ""
13894 "This function takes a key or passphrase parameter which could contain "
13895 "sensitive material.  Read the section L</KEYS AND PASSPHRASES> for more "
13896 "information."
13897 msgstr ""
13898
13899 # type: textblock
13900 #. type: textblock
13901 #: ../src/guestfs-actions.pod:3821 ../src/guestfs-actions.pod:3861
13902 #: ../src/guestfs-actions.pod:3884 ../src/guestfs-actions.pod:3904
13903 msgid "(Added in 1.5.2)"
13904 msgstr ""
13905
13906 # type: =head2
13907 #. type: =head2
13908 #: ../src/guestfs-actions.pod:3823
13909 msgid "guestfs_luks_close"
13910 msgstr ""
13911
13912 # type: verbatim
13913 #. type: verbatim
13914 #: ../src/guestfs-actions.pod:3825
13915 #, no-wrap
13916 msgid ""
13917 " int\n"
13918 " guestfs_luks_close (guestfs_h *g,\n"
13919 "                     const char *device);\n"
13920 "\n"
13921 msgstr ""
13922
13923 # type: textblock
13924 #. type: textblock
13925 #: ../src/guestfs-actions.pod:3829
13926 msgid ""
13927 "This closes a LUKS device that was created earlier by C<guestfs_luks_open> "
13928 "or C<guestfs_luks_open_ro>.  The C<device> parameter must be the name of the "
13929 "LUKS mapping device (ie. C</dev/mapper/mapname>) and I<not> the name of the "
13930 "underlying block device."
13931 msgstr ""
13932
13933 # type: textblock
13934 #. type: textblock
13935 #: ../src/guestfs-actions.pod:3837 ../src/guestfs-actions.pod:3936
13936 #: ../src/guestfs-actions.pod:3955 ../src/guestfs-actions.pod:4005
13937 #: ../src/guestfs-actions.pod:4053
13938 msgid "(Added in 1.5.1)"
13939 msgstr ""
13940
13941 # type: =head2
13942 #. type: =head2
13943 #: ../src/guestfs-actions.pod:3839
13944 msgid "guestfs_luks_format"
13945 msgstr ""
13946
13947 # type: verbatim
13948 #. type: verbatim
13949 #: ../src/guestfs-actions.pod:3841
13950 #, no-wrap
13951 msgid ""
13952 " int\n"
13953 " guestfs_luks_format (guestfs_h *g,\n"
13954 "                      const char *device,\n"
13955 "                      const char *key,\n"
13956 "                      int keyslot);\n"
13957 "\n"
13958 msgstr ""
13959
13960 # type: textblock
13961 #. type: textblock
13962 #: ../src/guestfs-actions.pod:3847 ../fish/guestfish-actions.pod:2652
13963 msgid ""
13964 "This command erases existing data on C<device> and formats the device as a "
13965 "LUKS encrypted device.  C<key> is the initial key, which is added to key "
13966 "slot C<slot>.  (LUKS supports 8 key slots, numbered 0-7)."
13967 msgstr ""
13968
13969 # type: textblock
13970 #. type: textblock
13971 #: ../src/guestfs-actions.pod:3854 ../src/guestfs-actions.pod:3877
13972 #: ../src/guestfs-actions.pod:4017 ../src/guestfs-actions.pod:4975
13973 #: ../src/guestfs-actions.pod:5755 ../src/guestfs-actions.pod:6162
13974 #: ../src/guestfs-actions.pod:6192 ../src/guestfs-actions.pod:6225
13975 #: ../src/guestfs-actions.pod:7406 ../fish/guestfish-actions.pod:2660
13976 #: ../fish/guestfish-actions.pod:2673 ../fish/guestfish-actions.pod:2757
13977 #: ../fish/guestfish-actions.pod:3347 ../fish/guestfish-actions.pod:3867
13978 #: ../fish/guestfish-actions.pod:4177 ../fish/guestfish-actions.pod:4200
13979 #: ../fish/guestfish-actions.pod:4222 ../fish/guestfish-actions.pod:4951
13980 msgid ""
13981 "B<This command is dangerous.  Without careful use you can easily destroy all "
13982 "your data>."
13983 msgstr ""
13984
13985 # type: =head2
13986 #. type: =head2
13987 #: ../src/guestfs-actions.pod:3863
13988 msgid "guestfs_luks_format_cipher"
13989 msgstr ""
13990
13991 # type: verbatim
13992 #. type: verbatim
13993 #: ../src/guestfs-actions.pod:3865
13994 #, no-wrap
13995 msgid ""
13996 " int\n"
13997 " guestfs_luks_format_cipher (guestfs_h *g,\n"
13998 "                             const char *device,\n"
13999 "                             const char *key,\n"
14000 "                             int keyslot,\n"
14001 "                             const char *cipher);\n"
14002 "\n"
14003 msgstr ""
14004
14005 # type: textblock
14006 #. type: textblock
14007 #: ../src/guestfs-actions.pod:3872
14008 msgid ""
14009 "This command is the same as C<guestfs_luks_format> but it also allows you to "
14010 "set the C<cipher> used."
14011 msgstr ""
14012
14013 # type: =head2
14014 #. type: =head2
14015 #: ../src/guestfs-actions.pod:3886
14016 msgid "guestfs_luks_kill_slot"
14017 msgstr ""
14018
14019 # type: verbatim
14020 #. type: verbatim
14021 #: ../src/guestfs-actions.pod:3888
14022 #, no-wrap
14023 msgid ""
14024 " int\n"
14025 " guestfs_luks_kill_slot (guestfs_h *g,\n"
14026 "                         const char *device,\n"
14027 "                         const char *key,\n"
14028 "                         int keyslot);\n"
14029 "\n"
14030 msgstr ""
14031
14032 # type: textblock
14033 #. type: textblock
14034 #: ../src/guestfs-actions.pod:3894 ../fish/guestfish-actions.pod:2680
14035 msgid ""
14036 "This command deletes the key in key slot C<keyslot> from the encrypted LUKS "
14037 "device C<device>.  C<key> must be one of the I<other> keys."
14038 msgstr ""
14039
14040 # type: =head2
14041 #. type: =head2
14042 #: ../src/guestfs-actions.pod:3906
14043 msgid "guestfs_luks_open"
14044 msgstr ""
14045
14046 # type: verbatim
14047 #. type: verbatim
14048 #: ../src/guestfs-actions.pod:3908
14049 #, no-wrap
14050 msgid ""
14051 " int\n"
14052 " guestfs_luks_open (guestfs_h *g,\n"
14053 "                    const char *device,\n"
14054 "                    const char *key,\n"
14055 "                    const char *mapname);\n"
14056 "\n"
14057 msgstr ""
14058
14059 # type: textblock
14060 #. type: textblock
14061 #: ../src/guestfs-actions.pod:3914 ../fish/guestfish-actions.pod:2691
14062 msgid ""
14063 "This command opens a block device which has been encrypted according to the "
14064 "Linux Unified Key Setup (LUKS) standard."
14065 msgstr ""
14066
14067 # type: textblock
14068 #. type: textblock
14069 #: ../src/guestfs-actions.pod:3917 ../fish/guestfish-actions.pod:2694
14070 msgid "C<device> is the encrypted block device or partition."
14071 msgstr ""
14072
14073 # type: textblock
14074 #. type: textblock
14075 #: ../src/guestfs-actions.pod:3919 ../fish/guestfish-actions.pod:2696
14076 msgid ""
14077 "The caller must supply one of the keys associated with the LUKS block "
14078 "device, in the C<key> parameter."
14079 msgstr ""
14080
14081 # type: textblock
14082 #. type: textblock
14083 #: ../src/guestfs-actions.pod:3922 ../fish/guestfish-actions.pod:2699
14084 msgid ""
14085 "This creates a new block device called C</dev/mapper/mapname>.  Reads and "
14086 "writes to this block device are decrypted from and encrypted to the "
14087 "underlying C<device> respectively."
14088 msgstr ""
14089
14090 # type: textblock
14091 #. type: textblock
14092 #: ../src/guestfs-actions.pod:3926
14093 msgid ""
14094 "If this block device contains LVM volume groups, then calling "
14095 "C<guestfs_vgscan> followed by C<guestfs_vg_activate_all> will make them "
14096 "visible."
14097 msgstr ""
14098
14099 # type: =head2
14100 #. type: =head2
14101 #: ../src/guestfs-actions.pod:3938
14102 msgid "guestfs_luks_open_ro"
14103 msgstr ""
14104
14105 # type: verbatim
14106 #. type: verbatim
14107 #: ../src/guestfs-actions.pod:3940
14108 #, no-wrap
14109 msgid ""
14110 " int\n"
14111 " guestfs_luks_open_ro (guestfs_h *g,\n"
14112 "                       const char *device,\n"
14113 "                       const char *key,\n"
14114 "                       const char *mapname);\n"
14115 "\n"
14116 msgstr ""
14117
14118 # type: textblock
14119 #. type: textblock
14120 #: ../src/guestfs-actions.pod:3946
14121 msgid ""
14122 "This is the same as C<guestfs_luks_open> except that a read-only mapping is "
14123 "created."
14124 msgstr ""
14125
14126 # type: =head2
14127 #. type: =head2
14128 #: ../src/guestfs-actions.pod:3957
14129 msgid "guestfs_lvcreate"
14130 msgstr ""
14131
14132 # type: verbatim
14133 #. type: verbatim
14134 #: ../src/guestfs-actions.pod:3959
14135 #, no-wrap
14136 msgid ""
14137 " int\n"
14138 " guestfs_lvcreate (guestfs_h *g,\n"
14139 "                   const char *logvol,\n"
14140 "                   const char *volgroup,\n"
14141 "                   int mbytes);\n"
14142 "\n"
14143 msgstr ""
14144
14145 # type: textblock
14146 #. type: textblock
14147 #: ../src/guestfs-actions.pod:3965 ../fish/guestfish-actions.pod:2724
14148 msgid ""
14149 "This creates an LVM logical volume called C<logvol> on the volume group "
14150 "C<volgroup>, with C<size> megabytes."
14151 msgstr ""
14152
14153 # type: =head2
14154 #. type: =head2
14155 #: ../src/guestfs-actions.pod:3972
14156 msgid "guestfs_lvm_canonical_lv_name"
14157 msgstr ""
14158
14159 # type: verbatim
14160 #. type: verbatim
14161 #: ../src/guestfs-actions.pod:3974
14162 #, no-wrap
14163 msgid ""
14164 " char *\n"
14165 " guestfs_lvm_canonical_lv_name (guestfs_h *g,\n"
14166 "                                const char *lvname);\n"
14167 "\n"
14168 msgstr ""
14169
14170 # type: textblock
14171 #. type: textblock
14172 #: ../src/guestfs-actions.pod:3978 ../fish/guestfish-actions.pod:2731
14173 msgid ""
14174 "This converts alternative naming schemes for LVs that you might find to the "
14175 "canonical name.  For example, C</dev/mapper/VG-LV> is converted to C</dev/VG/"
14176 "LV>."
14177 msgstr ""
14178
14179 # type: textblock
14180 #. type: textblock
14181 #: ../src/guestfs-actions.pod:3982 ../fish/guestfish-actions.pod:2735
14182 msgid ""
14183 "This command returns an error if the C<lvname> parameter does not refer to a "
14184 "logical volume."
14185 msgstr ""
14186
14187 # type: textblock
14188 #. type: textblock
14189 #: ../src/guestfs-actions.pod:3985
14190 msgid "See also C<guestfs_is_lv>."
14191 msgstr ""
14192
14193 # type: textblock
14194 #. type: textblock
14195 #: ../src/guestfs-actions.pod:3990
14196 msgid "(Added in 1.5.24)"
14197 msgstr ""
14198
14199 # type: =head2
14200 #. type: =head2
14201 #: ../src/guestfs-actions.pod:3992
14202 msgid "guestfs_lvm_clear_filter"
14203 msgstr ""
14204
14205 # type: verbatim
14206 #. type: verbatim
14207 #: ../src/guestfs-actions.pod:3994
14208 #, no-wrap
14209 msgid ""
14210 " int\n"
14211 " guestfs_lvm_clear_filter (guestfs_h *g);\n"
14212 "\n"
14213 msgstr ""
14214
14215 # type: textblock
14216 #. type: textblock
14217 #: ../src/guestfs-actions.pod:3997
14218 msgid ""
14219 "This undoes the effect of C<guestfs_lvm_set_filter>.  LVM will be able to "
14220 "see every block device."
14221 msgstr ""
14222
14223 # type: textblock
14224 #. type: textblock
14225 #: ../src/guestfs-actions.pod:4000 ../src/guestfs-actions.pod:4042
14226 #: ../fish/guestfish-actions.pod:2747 ../fish/guestfish-actions.pod:2778
14227 msgid ""
14228 "This command also clears the LVM cache and performs a volume group scan."
14229 msgstr ""
14230
14231 # type: =head2
14232 #. type: =head2
14233 #: ../src/guestfs-actions.pod:4007
14234 msgid "guestfs_lvm_remove_all"
14235 msgstr ""
14236
14237 # type: verbatim
14238 #. type: verbatim
14239 #: ../src/guestfs-actions.pod:4009
14240 #, no-wrap
14241 msgid ""
14242 " int\n"
14243 " guestfs_lvm_remove_all (guestfs_h *g);\n"
14244 "\n"
14245 msgstr ""
14246
14247 # type: textblock
14248 #. type: textblock
14249 #: ../src/guestfs-actions.pod:4012 ../fish/guestfish-actions.pod:2754
14250 msgid ""
14251 "This command removes all LVM logical volumes, volume groups and physical "
14252 "volumes."
14253 msgstr ""
14254
14255 # type: =head2
14256 #. type: =head2
14257 #: ../src/guestfs-actions.pod:4022
14258 msgid "guestfs_lvm_set_filter"
14259 msgstr ""
14260
14261 # type: verbatim
14262 #. type: verbatim
14263 #: ../src/guestfs-actions.pod:4024
14264 #, no-wrap
14265 msgid ""
14266 " int\n"
14267 " guestfs_lvm_set_filter (guestfs_h *g,\n"
14268 "                         char *const *devices);\n"
14269 "\n"
14270 msgstr ""
14271
14272 # type: textblock
14273 #. type: textblock
14274 #: ../src/guestfs-actions.pod:4028 ../fish/guestfish-actions.pod:2764
14275 msgid ""
14276 "This sets the LVM device filter so that LVM will only be able to \"see\" the "
14277 "block devices in the list C<devices>, and will ignore all other attached "
14278 "block devices."
14279 msgstr ""
14280
14281 # type: textblock
14282 #. type: textblock
14283 #: ../src/guestfs-actions.pod:4032 ../fish/guestfish-actions.pod:2768
14284 msgid ""
14285 "Where disk image(s) contain duplicate PVs or VGs, this command is useful to "
14286 "get LVM to ignore the duplicates, otherwise LVM can get confused.  Note also "
14287 "there are two types of duplication possible: either cloned PVs/VGs which "
14288 "have identical UUIDs; or VGs that are not cloned but just happen to have the "
14289 "same name.  In normal operation you cannot create this situation, but you "
14290 "can do it outside LVM, eg.  by cloning disk images or by bit twiddling "
14291 "inside the LVM metadata."
14292 msgstr ""
14293
14294 # type: textblock
14295 #. type: textblock
14296 #: ../src/guestfs-actions.pod:4045 ../fish/guestfish-actions.pod:2781
14297 msgid "You can filter whole block devices or individual partitions."
14298 msgstr ""
14299
14300 # type: textblock
14301 #. type: textblock
14302 #: ../src/guestfs-actions.pod:4047 ../fish/guestfish-actions.pod:2783
14303 msgid ""
14304 "You cannot use this if any VG is currently in use (eg.  contains a mounted "
14305 "filesystem), even if you are not filtering out that VG."
14306 msgstr ""
14307
14308 # type: =head2
14309 #. type: =head2
14310 #: ../src/guestfs-actions.pod:4055
14311 msgid "guestfs_lvremove"
14312 msgstr ""
14313
14314 # type: verbatim
14315 #. type: verbatim
14316 #: ../src/guestfs-actions.pod:4057
14317 #, no-wrap
14318 msgid ""
14319 " int\n"
14320 " guestfs_lvremove (guestfs_h *g,\n"
14321 "                   const char *device);\n"
14322 "\n"
14323 msgstr ""
14324
14325 # type: textblock
14326 #. type: textblock
14327 #: ../src/guestfs-actions.pod:4061 ../fish/guestfish-actions.pod:2791
14328 msgid ""
14329 "Remove an LVM logical volume C<device>, where C<device> is the path to the "
14330 "LV, such as C</dev/VG/LV>."
14331 msgstr ""
14332
14333 # type: textblock
14334 #. type: textblock
14335 #: ../src/guestfs-actions.pod:4064 ../fish/guestfish-actions.pod:2794
14336 msgid ""
14337 "You can also remove all LVs in a volume group by specifying the VG name, C</"
14338 "dev/VG>."
14339 msgstr ""
14340
14341 # type: textblock
14342 #. type: textblock
14343 #: ../src/guestfs-actions.pod:4069 ../src/guestfs-actions.pod:5321
14344 #: ../src/guestfs-actions.pod:7138
14345 msgid "(Added in 1.0.13)"
14346 msgstr ""
14347
14348 # type: =head2
14349 #. type: =head2
14350 #: ../src/guestfs-actions.pod:4071
14351 msgid "guestfs_lvrename"
14352 msgstr ""
14353
14354 # type: verbatim
14355 #. type: verbatim
14356 #: ../src/guestfs-actions.pod:4073
14357 #, no-wrap
14358 msgid ""
14359 " int\n"
14360 " guestfs_lvrename (guestfs_h *g,\n"
14361 "                   const char *logvol,\n"
14362 "                   const char *newlogvol);\n"
14363 "\n"
14364 msgstr ""
14365
14366 # type: textblock
14367 #. type: textblock
14368 #: ../src/guestfs-actions.pod:4078 ../fish/guestfish-actions.pod:2801
14369 msgid "Rename a logical volume C<logvol> with the new name C<newlogvol>."
14370 msgstr ""
14371
14372 # type: textblock
14373 #. type: textblock
14374 #: ../src/guestfs-actions.pod:4082 ../src/guestfs-actions.pod:7151
14375 msgid "(Added in 1.0.83)"
14376 msgstr ""
14377
14378 # type: =head2
14379 #. type: =head2
14380 #: ../src/guestfs-actions.pod:4084
14381 msgid "guestfs_lvresize"
14382 msgstr ""
14383
14384 # type: verbatim
14385 #. type: verbatim
14386 #: ../src/guestfs-actions.pod:4086
14387 #, no-wrap
14388 msgid ""
14389 " int\n"
14390 " guestfs_lvresize (guestfs_h *g,\n"
14391 "                   const char *device,\n"
14392 "                   int mbytes);\n"
14393 "\n"
14394 msgstr ""
14395
14396 # type: textblock
14397 #. type: textblock
14398 #: ../src/guestfs-actions.pod:4091 ../fish/guestfish-actions.pod:2807
14399 msgid ""
14400 "This resizes (expands or shrinks) an existing LVM logical volume to "
14401 "C<mbytes>.  When reducing, data in the reduced part is lost."
14402 msgstr ""
14403
14404 # type: =head2
14405 #. type: =head2
14406 #: ../src/guestfs-actions.pod:4099
14407 msgid "guestfs_lvresize_free"
14408 msgstr ""
14409
14410 # type: verbatim
14411 #. type: verbatim
14412 #: ../src/guestfs-actions.pod:4101
14413 #, no-wrap
14414 msgid ""
14415 " int\n"
14416 " guestfs_lvresize_free (guestfs_h *g,\n"
14417 "                        const char *lv,\n"
14418 "                        int percent);\n"
14419 "\n"
14420 msgstr ""
14421
14422 # type: textblock
14423 #. type: textblock
14424 #: ../src/guestfs-actions.pod:4106 ../fish/guestfish-actions.pod:2815
14425 msgid ""
14426 "This expands an existing logical volume C<lv> so that it fills C<pc>% of the "
14427 "remaining free space in the volume group.  Commonly you would call this with "
14428 "pc = 100 which expands the logical volume as much as possible, using all "
14429 "remaining free space in the volume group."
14430 msgstr ""
14431
14432 # type: textblock
14433 #. type: textblock
14434 #: ../src/guestfs-actions.pod:4114
14435 msgid "(Added in 1.3.3)"
14436 msgstr ""
14437
14438 # type: =head2
14439 #. type: =head2
14440 #: ../src/guestfs-actions.pod:4116
14441 msgid "guestfs_lvs"
14442 msgstr ""
14443
14444 # type: verbatim
14445 #. type: verbatim
14446 #: ../src/guestfs-actions.pod:4118
14447 #, no-wrap
14448 msgid ""
14449 " char **\n"
14450 " guestfs_lvs (guestfs_h *g);\n"
14451 "\n"
14452 msgstr ""
14453
14454 # type: textblock
14455 #. type: textblock
14456 #: ../src/guestfs-actions.pod:4121 ../fish/guestfish-actions.pod:2825
14457 msgid ""
14458 "List all the logical volumes detected.  This is the equivalent of the L<lvs"
14459 "(8)> command."
14460 msgstr ""
14461
14462 # type: textblock
14463 #. type: textblock
14464 #: ../src/guestfs-actions.pod:4124 ../fish/guestfish-actions.pod:2828
14465 msgid ""
14466 "This returns a list of the logical volume device names (eg. C</dev/"
14467 "VolGroup00/LogVol00>)."
14468 msgstr ""
14469
14470 # type: textblock
14471 #. type: textblock
14472 #: ../src/guestfs-actions.pod:4127
14473 msgid "See also C<guestfs_lvs_full>, C<guestfs_list_filesystems>."
14474 msgstr ""
14475
14476 # type: =head2
14477 #. type: =head2
14478 #: ../src/guestfs-actions.pod:4135
14479 msgid "guestfs_lvs_full"
14480 msgstr ""
14481
14482 # type: verbatim
14483 #. type: verbatim
14484 #: ../src/guestfs-actions.pod:4137
14485 #, no-wrap
14486 msgid ""
14487 " struct guestfs_lvm_lv_list *\n"
14488 " guestfs_lvs_full (guestfs_h *g);\n"
14489 "\n"
14490 msgstr ""
14491
14492 # type: textblock
14493 #. type: textblock
14494 #: ../src/guestfs-actions.pod:4140 ../fish/guestfish-actions.pod:2837
14495 msgid ""
14496 "List all the logical volumes detected.  This is the equivalent of the L<lvs"
14497 "(8)> command.  The \"full\" version includes all fields."
14498 msgstr ""
14499
14500 # type: textblock
14501 #. type: textblock
14502 #: ../src/guestfs-actions.pod:4143
14503 msgid ""
14504 "This function returns a C<struct guestfs_lvm_lv_list *>, or NULL if there "
14505 "was an error.  I<The caller must call C<guestfs_free_lvm_lv_list> after use>."
14506 msgstr ""
14507
14508 # type: =head2
14509 #. type: =head2
14510 #: ../src/guestfs-actions.pod:4149
14511 msgid "guestfs_lvuuid"
14512 msgstr ""
14513
14514 # type: verbatim
14515 #. type: verbatim
14516 #: ../src/guestfs-actions.pod:4151
14517 #, no-wrap
14518 msgid ""
14519 " char *\n"
14520 " guestfs_lvuuid (guestfs_h *g,\n"
14521 "                 const char *device);\n"
14522 "\n"
14523 msgstr ""
14524
14525 # type: textblock
14526 #. type: textblock
14527 #: ../src/guestfs-actions.pod:4155 ../fish/guestfish-actions.pod:2844
14528 msgid "This command returns the UUID of the LVM LV C<device>."
14529 msgstr ""
14530
14531 # type: =head2
14532 #. type: =head2
14533 #: ../src/guestfs-actions.pod:4162
14534 msgid "guestfs_lxattrlist"
14535 msgstr ""
14536
14537 # type: verbatim
14538 #. type: verbatim
14539 #: ../src/guestfs-actions.pod:4164
14540 #, no-wrap
14541 msgid ""
14542 " struct guestfs_xattr_list *\n"
14543 " guestfs_lxattrlist (guestfs_h *g,\n"
14544 "                     const char *path,\n"
14545 "                     char *const *names);\n"
14546 "\n"
14547 msgstr ""
14548
14549 # type: textblock
14550 #. type: textblock
14551 #: ../src/guestfs-actions.pod:4169 ../fish/guestfish-actions.pod:2850
14552 msgid ""
14553 "This call allows you to get the extended attributes of multiple files, where "
14554 "all files are in the directory C<path>.  C<names> is the list of files from "
14555 "this directory."
14556 msgstr ""
14557
14558 # type: textblock
14559 #. type: textblock
14560 #: ../src/guestfs-actions.pod:4173 ../fish/guestfish-actions.pod:2854
14561 msgid ""
14562 "On return you get a flat list of xattr structs which must be interpreted "
14563 "sequentially.  The first xattr struct always has a zero-length C<attrname>.  "
14564 "C<attrval> in this struct is zero-length to indicate there was an error "
14565 "doing C<lgetxattr> for this file, I<or> is a C string which is a decimal "
14566 "number (the number of following attributes for this file, which could be C<"
14567 "\"0\">).  Then after the first xattr struct are the zero or more attributes "
14568 "for the first named file.  This repeats for the second and subsequent files."
14569 msgstr ""
14570
14571 # type: textblock
14572 #. type: textblock
14573 #: ../src/guestfs-actions.pod:4183
14574 msgid ""
14575 "This call is intended for programs that want to efficiently list a directory "
14576 "contents without making many round-trips.  See also C<guestfs_lstatlist> for "
14577 "a similarly efficient call for getting standard stats.  Very long directory "
14578 "listings might cause the protocol message size to be exceeded, causing this "
14579 "call to fail.  The caller must split up such requests into smaller groups of "
14580 "names."
14581 msgstr ""
14582
14583 # type: =head2
14584 #. type: =head2
14585 #: ../src/guestfs-actions.pod:4197
14586 msgid "guestfs_mkdir"
14587 msgstr ""
14588
14589 # type: verbatim
14590 #. type: verbatim
14591 #: ../src/guestfs-actions.pod:4199
14592 #, no-wrap
14593 msgid ""
14594 " int\n"
14595 " guestfs_mkdir (guestfs_h *g,\n"
14596 "                const char *path);\n"
14597 "\n"
14598 msgstr ""
14599
14600 # type: textblock
14601 #. type: textblock
14602 #: ../src/guestfs-actions.pod:4203 ../fish/guestfish-actions.pod:2876
14603 msgid "Create a directory named C<path>."
14604 msgstr ""
14605
14606 # type: =head2
14607 #. type: =head2
14608 #: ../src/guestfs-actions.pod:4209
14609 msgid "guestfs_mkdir_mode"
14610 msgstr ""
14611
14612 # type: verbatim
14613 #. type: verbatim
14614 #: ../src/guestfs-actions.pod:4211
14615 #, no-wrap
14616 msgid ""
14617 " int\n"
14618 " guestfs_mkdir_mode (guestfs_h *g,\n"
14619 "                     const char *path,\n"
14620 "                     int mode);\n"
14621 "\n"
14622 msgstr ""
14623
14624 # type: textblock
14625 #. type: textblock
14626 #: ../src/guestfs-actions.pod:4216 ../fish/guestfish-actions.pod:2882
14627 msgid ""
14628 "This command creates a directory, setting the initial permissions of the "
14629 "directory to C<mode>."
14630 msgstr ""
14631
14632 # type: textblock
14633 #. type: textblock
14634 #: ../src/guestfs-actions.pod:4219 ../fish/guestfish-actions.pod:2885
14635 msgid ""
14636 "For common Linux filesystems, the actual mode which is set will be C<mode & "
14637 "~umask & 01777>.  Non-native-Linux filesystems may interpret the mode in "
14638 "other ways."
14639 msgstr ""
14640
14641 # type: textblock
14642 #. type: textblock
14643 #: ../src/guestfs-actions.pod:4223
14644 msgid "See also C<guestfs_mkdir>, C<guestfs_umask>"
14645 msgstr ""
14646
14647 # type: =head2
14648 #. type: =head2
14649 #: ../src/guestfs-actions.pod:4229
14650 msgid "guestfs_mkdir_p"
14651 msgstr ""
14652
14653 # type: verbatim
14654 #. type: verbatim
14655 #: ../src/guestfs-actions.pod:4231
14656 #, no-wrap
14657 msgid ""
14658 " int\n"
14659 " guestfs_mkdir_p (guestfs_h *g,\n"
14660 "                  const char *path);\n"
14661 "\n"
14662 msgstr ""
14663
14664 # type: textblock
14665 #. type: textblock
14666 #: ../src/guestfs-actions.pod:4235 ../fish/guestfish-actions.pod:2895
14667 msgid ""
14668 "Create a directory named C<path>, creating any parent directories as "
14669 "necessary.  This is like the C<mkdir -p> shell command."
14670 msgstr ""
14671
14672 # type: =head2
14673 #. type: =head2
14674 #: ../src/guestfs-actions.pod:4242
14675 msgid "guestfs_mkdtemp"
14676 msgstr ""
14677
14678 # type: verbatim
14679 #. type: verbatim
14680 #: ../src/guestfs-actions.pod:4244
14681 #, no-wrap
14682 msgid ""
14683 " char *\n"
14684 " guestfs_mkdtemp (guestfs_h *g,\n"
14685 "                  const char *template);\n"
14686 "\n"
14687 msgstr ""
14688
14689 # type: textblock
14690 #. type: textblock
14691 #: ../src/guestfs-actions.pod:4248 ../fish/guestfish-actions.pod:2902
14692 msgid ""
14693 "This command creates a temporary directory.  The C<template> parameter "
14694 "should be a full pathname for the temporary directory name with the final "
14695 "six characters being \"XXXXXX\"."
14696 msgstr ""
14697
14698 # type: textblock
14699 #. type: textblock
14700 #: ../src/guestfs-actions.pod:4253 ../fish/guestfish-actions.pod:2907
14701 msgid ""
14702 "For example: \"/tmp/myprogXXXXXX\" or \"/Temp/myprogXXXXXX\", the second one "
14703 "being suitable for Windows filesystems."
14704 msgstr ""
14705
14706 # type: textblock
14707 #. type: textblock
14708 #: ../src/guestfs-actions.pod:4256 ../fish/guestfish-actions.pod:2910
14709 msgid "The name of the temporary directory that was created is returned."
14710 msgstr ""
14711
14712 # type: textblock
14713 #. type: textblock
14714 #: ../src/guestfs-actions.pod:4259 ../fish/guestfish-actions.pod:2913
14715 msgid "The temporary directory is created with mode 0700 and is owned by root."
14716 msgstr ""
14717
14718 # type: textblock
14719 #. type: textblock
14720 #: ../src/guestfs-actions.pod:4262 ../fish/guestfish-actions.pod:2916
14721 msgid ""
14722 "The caller is responsible for deleting the temporary directory and its "
14723 "contents after use."
14724 msgstr ""
14725
14726 # type: textblock
14727 #. type: textblock
14728 #: ../src/guestfs-actions.pod:4265 ../fish/guestfish-actions.pod:2919
14729 msgid "See also: L<mkdtemp(3)>"
14730 msgstr ""
14731
14732 # type: =head2
14733 #. type: =head2
14734 #: ../src/guestfs-actions.pod:4272
14735 msgid "guestfs_mke2fs_J"
14736 msgstr ""
14737
14738 # type: verbatim
14739 #. type: verbatim
14740 #: ../src/guestfs-actions.pod:4274
14741 #, no-wrap
14742 msgid ""
14743 " int\n"
14744 " guestfs_mke2fs_J (guestfs_h *g,\n"
14745 "                   const char *fstype,\n"
14746 "                   int blocksize,\n"
14747 "                   const char *device,\n"
14748 "                   const char *journal);\n"
14749 "\n"
14750 msgstr ""
14751
14752 # type: textblock
14753 #. type: textblock
14754 #: ../src/guestfs-actions.pod:4281 ../fish/guestfish-actions.pod:2925
14755 msgid ""
14756 "This creates an ext2/3/4 filesystem on C<device> with an external journal on "
14757 "C<journal>.  It is equivalent to the command:"
14758 msgstr ""
14759
14760 # type: verbatim
14761 #. type: verbatim
14762 #: ../src/guestfs-actions.pod:4285 ../fish/guestfish-actions.pod:2929
14763 #, no-wrap
14764 msgid ""
14765 " mke2fs -t fstype -b blocksize -J device=<journal> <device>\n"
14766 "\n"
14767 msgstr ""
14768
14769 # type: textblock
14770 #. type: textblock
14771 #: ../src/guestfs-actions.pod:4287
14772 msgid "See also C<guestfs_mke2journal>."
14773 msgstr ""
14774
14775 # type: textblock
14776 #. type: textblock
14777 #: ../src/guestfs-actions.pod:4291 ../src/guestfs-actions.pod:4309
14778 #: ../src/guestfs-actions.pod:4327 ../src/guestfs-actions.pod:4343
14779 #: ../src/guestfs-actions.pod:4357 ../src/guestfs-actions.pod:4371
14780 #: ../src/guestfs-actions.pod:4430 ../src/guestfs-actions.pod:4695
14781 msgid "(Added in 1.0.68)"
14782 msgstr ""
14783
14784 # type: =head2
14785 #. type: =head2
14786 #: ../src/guestfs-actions.pod:4293
14787 msgid "guestfs_mke2fs_JL"
14788 msgstr ""
14789
14790 # type: verbatim
14791 #. type: verbatim
14792 #: ../src/guestfs-actions.pod:4295
14793 #, no-wrap
14794 msgid ""
14795 " int\n"
14796 " guestfs_mke2fs_JL (guestfs_h *g,\n"
14797 "                    const char *fstype,\n"
14798 "                    int blocksize,\n"
14799 "                    const char *device,\n"
14800 "                    const char *label);\n"
14801 "\n"
14802 msgstr ""
14803
14804 # type: textblock
14805 #. type: textblock
14806 #: ../src/guestfs-actions.pod:4302 ../fish/guestfish-actions.pod:2937
14807 msgid ""
14808 "This creates an ext2/3/4 filesystem on C<device> with an external journal on "
14809 "the journal labeled C<label>."
14810 msgstr ""
14811
14812 # type: textblock
14813 #. type: textblock
14814 #: ../src/guestfs-actions.pod:4305
14815 msgid "See also C<guestfs_mke2journal_L>."
14816 msgstr ""
14817
14818 # type: =head2
14819 #. type: =head2
14820 #: ../src/guestfs-actions.pod:4311
14821 msgid "guestfs_mke2fs_JU"
14822 msgstr ""
14823
14824 # type: verbatim
14825 #. type: verbatim
14826 #: ../src/guestfs-actions.pod:4313
14827 #, no-wrap
14828 msgid ""
14829 " int\n"
14830 " guestfs_mke2fs_JU (guestfs_h *g,\n"
14831 "                    const char *fstype,\n"
14832 "                    int blocksize,\n"
14833 "                    const char *device,\n"
14834 "                    const char *uuid);\n"
14835 "\n"
14836 msgstr ""
14837
14838 # type: textblock
14839 #. type: textblock
14840 #: ../src/guestfs-actions.pod:4320 ../fish/guestfish-actions.pod:2946
14841 msgid ""
14842 "This creates an ext2/3/4 filesystem on C<device> with an external journal on "
14843 "the journal with UUID C<uuid>."
14844 msgstr ""
14845
14846 # type: textblock
14847 #. type: textblock
14848 #: ../src/guestfs-actions.pod:4323
14849 msgid "See also C<guestfs_mke2journal_U>."
14850 msgstr ""
14851
14852 # type: =head2
14853 #. type: =head2
14854 #: ../src/guestfs-actions.pod:4329
14855 msgid "guestfs_mke2journal"
14856 msgstr ""
14857
14858 # type: verbatim
14859 #. type: verbatim
14860 #: ../src/guestfs-actions.pod:4331
14861 #, no-wrap
14862 msgid ""
14863 " int\n"
14864 " guestfs_mke2journal (guestfs_h *g,\n"
14865 "                      int blocksize,\n"
14866 "                      const char *device);\n"
14867 "\n"
14868 msgstr ""
14869
14870 # type: textblock
14871 #. type: textblock
14872 #: ../src/guestfs-actions.pod:4336 ../fish/guestfish-actions.pod:2955
14873 msgid ""
14874 "This creates an ext2 external journal on C<device>.  It is equivalent to the "
14875 "command:"
14876 msgstr ""
14877
14878 # type: verbatim
14879 #. type: verbatim
14880 #: ../src/guestfs-actions.pod:4339 ../fish/guestfish-actions.pod:2958
14881 #, no-wrap
14882 msgid ""
14883 " mke2fs -O journal_dev -b blocksize device\n"
14884 "\n"
14885 msgstr ""
14886
14887 # type: =head2
14888 #. type: =head2
14889 #: ../src/guestfs-actions.pod:4345
14890 msgid "guestfs_mke2journal_L"
14891 msgstr ""
14892
14893 # type: verbatim
14894 #. type: verbatim
14895 #: ../src/guestfs-actions.pod:4347
14896 #, no-wrap
14897 msgid ""
14898 " int\n"
14899 " guestfs_mke2journal_L (guestfs_h *g,\n"
14900 "                        int blocksize,\n"
14901 "                        const char *label,\n"
14902 "                        const char *device);\n"
14903 "\n"
14904 msgstr ""
14905
14906 # type: textblock
14907 #. type: textblock
14908 #: ../src/guestfs-actions.pod:4353 ../fish/guestfish-actions.pod:2964
14909 msgid "This creates an ext2 external journal on C<device> with label C<label>."
14910 msgstr ""
14911
14912 # type: =head2
14913 #. type: =head2
14914 #: ../src/guestfs-actions.pod:4359
14915 msgid "guestfs_mke2journal_U"
14916 msgstr ""
14917
14918 # type: verbatim
14919 #. type: verbatim
14920 #: ../src/guestfs-actions.pod:4361
14921 #, no-wrap
14922 msgid ""
14923 " int\n"
14924 " guestfs_mke2journal_U (guestfs_h *g,\n"
14925 "                        int blocksize,\n"
14926 "                        const char *uuid,\n"
14927 "                        const char *device);\n"
14928 "\n"
14929 msgstr ""
14930
14931 # type: textblock
14932 #. type: textblock
14933 #: ../src/guestfs-actions.pod:4367 ../fish/guestfish-actions.pod:2970
14934 msgid "This creates an ext2 external journal on C<device> with UUID C<uuid>."
14935 msgstr ""
14936
14937 # type: =head2
14938 #. type: =head2
14939 #: ../src/guestfs-actions.pod:4373
14940 msgid "guestfs_mkfifo"
14941 msgstr ""
14942
14943 # type: verbatim
14944 #. type: verbatim
14945 #: ../src/guestfs-actions.pod:4375
14946 #, no-wrap
14947 msgid ""
14948 " int\n"
14949 " guestfs_mkfifo (guestfs_h *g,\n"
14950 "                 int mode,\n"
14951 "                 const char *path);\n"
14952 "\n"
14953 msgstr ""
14954
14955 # type: textblock
14956 #. type: textblock
14957 #: ../src/guestfs-actions.pod:4380
14958 msgid ""
14959 "This call creates a FIFO (named pipe) called C<path> with mode C<mode>.  It "
14960 "is just a convenient wrapper around C<guestfs_mknod>."
14961 msgstr ""
14962
14963 # type: =head2
14964 #. type: =head2
14965 #: ../src/guestfs-actions.pod:4390
14966 msgid "guestfs_mkfs"
14967 msgstr ""
14968
14969 # type: verbatim
14970 #. type: verbatim
14971 #: ../src/guestfs-actions.pod:4392
14972 #, no-wrap
14973 msgid ""
14974 " int\n"
14975 " guestfs_mkfs (guestfs_h *g,\n"
14976 "               const char *fstype,\n"
14977 "               const char *device);\n"
14978 "\n"
14979 msgstr ""
14980
14981 # type: textblock
14982 #. type: textblock
14983 #: ../src/guestfs-actions.pod:4397 ../fish/guestfish-actions.pod:2986
14984 msgid ""
14985 "This creates a filesystem on C<device> (usually a partition or LVM logical "
14986 "volume).  The filesystem type is C<fstype>, for example C<ext3>."
14987 msgstr ""
14988
14989 # type: =head2
14990 #. type: =head2
14991 #: ../src/guestfs-actions.pod:4405
14992 msgid "guestfs_mkfs_b"
14993 msgstr ""
14994
14995 # type: verbatim
14996 #. type: verbatim
14997 #: ../src/guestfs-actions.pod:4407
14998 #, no-wrap
14999 msgid ""
15000 " int\n"
15001 " guestfs_mkfs_b (guestfs_h *g,\n"
15002 "                 const char *fstype,\n"
15003 "                 int blocksize,\n"
15004 "                 const char *device);\n"
15005 "\n"
15006 msgstr ""
15007
15008 # type: textblock
15009 #. type: textblock
15010 #: ../src/guestfs-actions.pod:4413
15011 msgid ""
15012 "This call is similar to C<guestfs_mkfs>, but it allows you to control the "
15013 "block size of the resulting filesystem.  Supported block sizes depend on the "
15014 "filesystem type, but typically they are C<1024>, C<2048> or C<4096> only."
15015 msgstr ""
15016
15017 # type: textblock
15018 #. type: textblock
15019 #: ../src/guestfs-actions.pod:4418 ../src/guestfs-actions.pod:4461
15020 #: ../fish/guestfish-actions.pod:2999 ../fish/guestfish-actions.pod:3026
15021 msgid ""
15022 "For VFAT and NTFS the C<blocksize> parameter is treated as the requested "
15023 "cluster size."
15024 msgstr ""
15025
15026 # type: textblock
15027 #. type: textblock
15028 #: ../src/guestfs-actions.pod:4423 ../fish/guestfish-actions.pod:3002
15029 msgid ""
15030 "This function is deprecated.  In new code, use the C<mkfs_opts> call instead."
15031 msgstr ""
15032
15033 # type: =head2
15034 #. type: =head2
15035 #: ../src/guestfs-actions.pod:4432
15036 msgid "guestfs_mkfs_opts"
15037 msgstr ""
15038
15039 # type: verbatim
15040 #. type: verbatim
15041 #: ../src/guestfs-actions.pod:4434
15042 #, no-wrap
15043 msgid ""
15044 " int\n"
15045 " guestfs_mkfs_opts (guestfs_h *g,\n"
15046 "                    const char *fstype,\n"
15047 "                    const char *device,\n"
15048 "                    ...);\n"
15049 "\n"
15050 msgstr ""
15051
15052 #. type: verbatim
15053 #: ../src/guestfs-actions.pod:4445
15054 #, no-wrap
15055 msgid ""
15056 " GUESTFS_MKFS_OPTS_BLOCKSIZE, int blocksize,\n"
15057 " GUESTFS_MKFS_OPTS_FEATURES, const char *features,\n"
15058 "\n"
15059 msgstr ""
15060
15061 # type: textblock
15062 #. type: textblock
15063 #: ../src/guestfs-actions.pod:4448 ../fish/guestfish-actions.pod:3013
15064 msgid ""
15065 "This function creates a filesystem on C<device>.  The filesystem type is "
15066 "C<fstype>, for example C<ext3>."
15067 msgstr ""
15068
15069 # type: =item
15070 #. type: =item
15071 #: ../src/guestfs-actions.pod:4455 ../fish/guestfish-actions.pod:3020
15072 msgid "C<blocksize>"
15073 msgstr ""
15074
15075 # type: textblock
15076 #. type: textblock
15077 #: ../src/guestfs-actions.pod:4457 ../fish/guestfish-actions.pod:3022
15078 msgid ""
15079 "The filesystem block size.  Supported block sizes depend on the filesystem "
15080 "type, but typically they are C<1024>, C<2048> or C<4096> for Linux ext2/3 "
15081 "filesystems."
15082 msgstr ""
15083
15084 #. type: textblock
15085 #: ../src/guestfs-actions.pod:4464 ../fish/guestfish-actions.pod:3029
15086 msgid "For UFS block sizes, please see L<mkfs.ufs(8)>."
15087 msgstr ""
15088
15089 #. type: =item
15090 #: ../src/guestfs-actions.pod:4466 ../fish/guestfish-actions.pod:3031
15091 msgid "C<features>"
15092 msgstr ""
15093
15094 #. type: textblock
15095 #: ../src/guestfs-actions.pod:4468 ../fish/guestfish-actions.pod:3033
15096 msgid "This passes the I<-O> parameter to the external mkfs program."
15097 msgstr ""
15098
15099 #. type: textblock
15100 #: ../src/guestfs-actions.pod:4470 ../fish/guestfish-actions.pod:3035
15101 msgid ""
15102 "For certain filesystem types, this allows extra filesystem features to be "
15103 "selected.  See L<mke2fs(8)> and L<mkfs.ufs(8)> for more details."
15104 msgstr ""
15105
15106 #. type: textblock
15107 #: ../src/guestfs-actions.pod:4474 ../fish/guestfish-actions.pod:3039
15108 msgid ""
15109 "You cannot use this optional parameter with the C<gfs> or C<gfs2> filesystem "
15110 "type."
15111 msgstr ""
15112
15113 #. type: textblock
15114 #: ../src/guestfs-actions.pod:4481
15115 msgid "(Added in 1.7.19)"
15116 msgstr ""
15117
15118 # type: =head2
15119 #. type: =head2
15120 #: ../src/guestfs-actions.pod:4483
15121 msgid "guestfs_mkfs_opts_va"
15122 msgstr ""
15123
15124 # type: verbatim
15125 #. type: verbatim
15126 #: ../src/guestfs-actions.pod:4485
15127 #, no-wrap
15128 msgid ""
15129 " int\n"
15130 " guestfs_mkfs_opts_va (guestfs_h *g,\n"
15131 "                       const char *fstype,\n"
15132 "                       const char *device,\n"
15133 "                       va_list args);\n"
15134 "\n"
15135 msgstr ""
15136
15137 # type: textblock
15138 #. type: textblock
15139 #: ../src/guestfs-actions.pod:4491
15140 msgid "This is the \"va_list variant\" of L</guestfs_mkfs_opts>."
15141 msgstr ""
15142
15143 # type: =head2
15144 #. type: =head2
15145 #: ../src/guestfs-actions.pod:4495
15146 msgid "guestfs_mkfs_opts_argv"
15147 msgstr ""
15148
15149 # type: verbatim
15150 #. type: verbatim
15151 #: ../src/guestfs-actions.pod:4497
15152 #, no-wrap
15153 msgid ""
15154 " int\n"
15155 " guestfs_mkfs_opts_argv (guestfs_h *g,\n"
15156 "                         const char *fstype,\n"
15157 "                         const char *device,\n"
15158 "                         const struct guestfs_mkfs_opts_argv *optargs);\n"
15159 "\n"
15160 msgstr ""
15161
15162 # type: textblock
15163 #. type: textblock
15164 #: ../src/guestfs-actions.pod:4503
15165 msgid "This is the \"argv variant\" of L</guestfs_mkfs_opts>."
15166 msgstr ""
15167
15168 # type: =head2
15169 #. type: =head2
15170 #: ../src/guestfs-actions.pod:4507
15171 msgid "guestfs_mkmountpoint"
15172 msgstr ""
15173
15174 # type: verbatim
15175 #. type: verbatim
15176 #: ../src/guestfs-actions.pod:4509
15177 #, no-wrap
15178 msgid ""
15179 " int\n"
15180 " guestfs_mkmountpoint (guestfs_h *g,\n"
15181 "                       const char *exemptpath);\n"
15182 "\n"
15183 msgstr ""
15184
15185 # type: textblock
15186 #. type: textblock
15187 #: ../src/guestfs-actions.pod:4513
15188 msgid ""
15189 "C<guestfs_mkmountpoint> and C<guestfs_rmmountpoint> are specialized calls "
15190 "that can be used to create extra mountpoints before mounting the first "
15191 "filesystem."
15192 msgstr ""
15193
15194 # type: textblock
15195 #. type: textblock
15196 #: ../src/guestfs-actions.pod:4517 ../fish/guestfish-actions.pod:3054
15197 msgid ""
15198 "These calls are I<only> necessary in some very limited circumstances, mainly "
15199 "the case where you want to mount a mix of unrelated and/or read-only "
15200 "filesystems together."
15201 msgstr ""
15202
15203 # type: textblock
15204 #. type: textblock
15205 #: ../src/guestfs-actions.pod:4521 ../fish/guestfish-actions.pod:3058
15206 msgid ""
15207 "For example, live CDs often contain a \"Russian doll\" nest of filesystems, "
15208 "an ISO outer layer, with a squashfs image inside, with an ext2/3 image "
15209 "inside that.  You can unpack this as follows in guestfish:"
15210 msgstr ""
15211
15212 # type: verbatim
15213 #. type: verbatim
15214 #: ../src/guestfs-actions.pod:4526 ../fish/guestfish-actions.pod:3063
15215 #, no-wrap
15216 msgid ""
15217 " add-ro Fedora-11-i686-Live.iso\n"
15218 " run\n"
15219 " mkmountpoint /cd\n"
15220 " mkmountpoint /sqsh\n"
15221 " mkmountpoint /ext3fs\n"
15222 " mount /dev/sda /cd\n"
15223 " mount-loop /cd/LiveOS/squashfs.img /sqsh\n"
15224 " mount-loop /sqsh/LiveOS/ext3fs.img /ext3fs\n"
15225 "\n"
15226 msgstr ""
15227
15228 # type: textblock
15229 #. type: textblock
15230 #: ../src/guestfs-actions.pod:4535 ../fish/guestfish-actions.pod:3072
15231 msgid "The inner filesystem is now unpacked under the /ext3fs mountpoint."
15232 msgstr ""
15233
15234 # type: textblock
15235 #. type: textblock
15236 #: ../src/guestfs-actions.pod:4537
15237 msgid ""
15238 "C<guestfs_mkmountpoint> is not compatible with C<guestfs_umount_all>.  You "
15239 "may get unexpected errors if you try to mix these calls.  It is safest to "
15240 "manually unmount filesystems and remove mountpoints after use."
15241 msgstr ""
15242
15243 # type: textblock
15244 #. type: textblock
15245 #: ../src/guestfs-actions.pod:4541
15246 msgid ""
15247 "C<guestfs_umount_all> unmounts filesystems by sorting the paths longest "
15248 "first, so for this to work for manual mountpoints, you must ensure that the "
15249 "innermost mountpoints have the longest pathnames, as in the example code "
15250 "above."
15251 msgstr ""
15252
15253 # type: textblock
15254 #. type: textblock
15255 #: ../src/guestfs-actions.pod:4546 ../fish/guestfish-actions.pod:3083
15256 msgid ""
15257 "For more details see L<https://bugzilla.redhat.com/show_bug.cgi?id=599503>"
15258 msgstr ""
15259
15260 #. type: textblock
15261 #: ../src/guestfs-actions.pod:4548
15262 msgid ""
15263 "Autosync [see C<guestfs_set_autosync>, this is set by default on handles] "
15264 "can cause C<guestfs_umount_all> to be called when the handle is closed which "
15265 "can also trigger these issues."
15266 msgstr ""
15267
15268 # type: textblock
15269 #. type: textblock
15270 #: ../src/guestfs-actions.pod:4554 ../src/guestfs-actions.pod:4820
15271 #: ../src/guestfs-actions.pod:5739
15272 msgid "(Added in 1.0.62)"
15273 msgstr ""
15274
15275 # type: =head2
15276 #. type: =head2
15277 #: ../src/guestfs-actions.pod:4556
15278 msgid "guestfs_mknod"
15279 msgstr ""
15280
15281 # type: verbatim
15282 #. type: verbatim
15283 #: ../src/guestfs-actions.pod:4558
15284 #, no-wrap
15285 msgid ""
15286 " int\n"
15287 " guestfs_mknod (guestfs_h *g,\n"
15288 "                int mode,\n"
15289 "                int devmajor,\n"
15290 "                int devminor,\n"
15291 "                const char *path);\n"
15292 "\n"
15293 msgstr ""
15294
15295 # type: textblock
15296 #. type: textblock
15297 #: ../src/guestfs-actions.pod:4565 ../fish/guestfish-actions.pod:3093
15298 msgid ""
15299 "This call creates block or character special devices, or named pipes (FIFOs)."
15300 msgstr ""
15301
15302 # type: textblock
15303 #. type: textblock
15304 #: ../src/guestfs-actions.pod:4568 ../fish/guestfish-actions.pod:3096
15305 msgid ""
15306 "The C<mode> parameter should be the mode, using the standard constants.  "
15307 "C<devmajor> and C<devminor> are the device major and minor numbers, only "
15308 "used when creating block and character special devices."
15309 msgstr ""
15310
15311 # type: textblock
15312 #. type: textblock
15313 #: ../src/guestfs-actions.pod:4573
15314 msgid ""
15315 "Note that, just like L<mknod(2)>, the mode must be bitwise OR'd with "
15316 "S_IFBLK, S_IFCHR, S_IFIFO or S_IFSOCK (otherwise this call just creates a "
15317 "regular file).  These constants are available in the standard Linux header "
15318 "files, or you can use C<guestfs_mknod_b>, C<guestfs_mknod_c> or "
15319 "C<guestfs_mkfifo> which are wrappers around this command which bitwise OR in "
15320 "the appropriate constant for you."
15321 msgstr ""
15322
15323 # type: =head2
15324 #. type: =head2
15325 #: ../src/guestfs-actions.pod:4587
15326 msgid "guestfs_mknod_b"
15327 msgstr ""
15328
15329 # type: verbatim
15330 #. type: verbatim
15331 #: ../src/guestfs-actions.pod:4589
15332 #, no-wrap
15333 msgid ""
15334 " int\n"
15335 " guestfs_mknod_b (guestfs_h *g,\n"
15336 "                  int mode,\n"
15337 "                  int devmajor,\n"
15338 "                  int devminor,\n"
15339 "                  const char *path);\n"
15340 "\n"
15341 msgstr ""
15342
15343 # type: textblock
15344 #. type: textblock
15345 #: ../src/guestfs-actions.pod:4596
15346 msgid ""
15347 "This call creates a block device node called C<path> with mode C<mode> and "
15348 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
15349 "wrapper around C<guestfs_mknod>."
15350 msgstr ""
15351
15352 # type: =head2
15353 #. type: =head2
15354 #: ../src/guestfs-actions.pod:4606
15355 msgid "guestfs_mknod_c"
15356 msgstr ""
15357
15358 # type: verbatim
15359 #. type: verbatim
15360 #: ../src/guestfs-actions.pod:4608
15361 #, no-wrap
15362 msgid ""
15363 " int\n"
15364 " guestfs_mknod_c (guestfs_h *g,\n"
15365 "                  int mode,\n"
15366 "                  int devmajor,\n"
15367 "                  int devminor,\n"
15368 "                  const char *path);\n"
15369 "\n"
15370 msgstr ""
15371
15372 # type: textblock
15373 #. type: textblock
15374 #: ../src/guestfs-actions.pod:4615
15375 msgid ""
15376 "This call creates a char device node called C<path> with mode C<mode> and "
15377 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
15378 "wrapper around C<guestfs_mknod>."
15379 msgstr ""
15380
15381 # type: =head2
15382 #. type: =head2
15383 #: ../src/guestfs-actions.pod:4625
15384 msgid "guestfs_mkswap"
15385 msgstr ""
15386
15387 # type: verbatim
15388 #. type: verbatim
15389 #: ../src/guestfs-actions.pod:4627
15390 #, no-wrap
15391 msgid ""
15392 " int\n"
15393 " guestfs_mkswap (guestfs_h *g,\n"
15394 "                 const char *device);\n"
15395 "\n"
15396 msgstr ""
15397
15398 # type: textblock
15399 #. type: textblock
15400 #: ../src/guestfs-actions.pod:4631 ../fish/guestfish-actions.pod:3135
15401 msgid "Create a swap partition on C<device>."
15402 msgstr ""
15403
15404 # type: =head2
15405 #. type: =head2
15406 #: ../src/guestfs-actions.pod:4637
15407 msgid "guestfs_mkswap_L"
15408 msgstr ""
15409
15410 # type: verbatim
15411 #. type: verbatim
15412 #: ../src/guestfs-actions.pod:4639
15413 #, no-wrap
15414 msgid ""
15415 " int\n"
15416 " guestfs_mkswap_L (guestfs_h *g,\n"
15417 "                   const char *label,\n"
15418 "                   const char *device);\n"
15419 "\n"
15420 msgstr ""
15421
15422 # type: textblock
15423 #. type: textblock
15424 #: ../src/guestfs-actions.pod:4644 ../fish/guestfish-actions.pod:3141
15425 msgid "Create a swap partition on C<device> with label C<label>."
15426 msgstr ""
15427
15428 # type: textblock
15429 #. type: textblock
15430 #: ../src/guestfs-actions.pod:4646 ../fish/guestfish-actions.pod:3143
15431 msgid ""
15432 "Note that you cannot attach a swap label to a block device (eg. C</dev/"
15433 "sda>), just to a partition.  This appears to be a limitation of the kernel "
15434 "or swap tools."
15435 msgstr ""
15436
15437 # type: =head2
15438 #. type: =head2
15439 #: ../src/guestfs-actions.pod:4654
15440 msgid "guestfs_mkswap_U"
15441 msgstr ""
15442
15443 # type: verbatim
15444 #. type: verbatim
15445 #: ../src/guestfs-actions.pod:4656
15446 #, no-wrap
15447 msgid ""
15448 " int\n"
15449 " guestfs_mkswap_U (guestfs_h *g,\n"
15450 "                   const char *uuid,\n"
15451 "                   const char *device);\n"
15452 "\n"
15453 msgstr ""
15454
15455 # type: textblock
15456 #. type: textblock
15457 #: ../src/guestfs-actions.pod:4661 ../fish/guestfish-actions.pod:3151
15458 msgid "Create a swap partition on C<device> with UUID C<uuid>."
15459 msgstr ""
15460
15461 # type: =head2
15462 #. type: =head2
15463 #: ../src/guestfs-actions.pod:4667
15464 msgid "guestfs_mkswap_file"
15465 msgstr ""
15466
15467 # type: verbatim
15468 #. type: verbatim
15469 #: ../src/guestfs-actions.pod:4669
15470 #, no-wrap
15471 msgid ""
15472 " int\n"
15473 " guestfs_mkswap_file (guestfs_h *g,\n"
15474 "                      const char *path);\n"
15475 "\n"
15476 msgstr ""
15477
15478 # type: textblock
15479 #. type: textblock
15480 #: ../src/guestfs-actions.pod:4673 ../fish/guestfish-actions.pod:3157
15481 msgid "Create a swap file."
15482 msgstr ""
15483
15484 # type: textblock
15485 #. type: textblock
15486 #: ../src/guestfs-actions.pod:4675
15487 msgid ""
15488 "This command just writes a swap file signature to an existing file.  To "
15489 "create the file itself, use something like C<guestfs_fallocate>."
15490 msgstr ""
15491
15492 # type: =head2
15493 #. type: =head2
15494 #: ../src/guestfs-actions.pod:4682
15495 msgid "guestfs_modprobe"
15496 msgstr ""
15497
15498 # type: verbatim
15499 #. type: verbatim
15500 #: ../src/guestfs-actions.pod:4684
15501 #, no-wrap
15502 msgid ""
15503 " int\n"
15504 " guestfs_modprobe (guestfs_h *g,\n"
15505 "                   const char *modulename);\n"
15506 "\n"
15507 msgstr ""
15508
15509 # type: textblock
15510 #. type: textblock
15511 #: ../src/guestfs-actions.pod:4688 ../fish/guestfish-actions.pod:3166
15512 msgid "This loads a kernel module in the appliance."
15513 msgstr ""
15514
15515 # type: textblock
15516 #. type: textblock
15517 #: ../src/guestfs-actions.pod:4690 ../fish/guestfish-actions.pod:3168
15518 msgid ""
15519 "The kernel module must have been whitelisted when libguestfs was built (see "
15520 "C<appliance/kmod.whitelist.in> in the source)."
15521 msgstr ""
15522
15523 # type: =head2
15524 #. type: =head2
15525 #: ../src/guestfs-actions.pod:4697
15526 msgid "guestfs_mount"
15527 msgstr ""
15528
15529 # type: verbatim
15530 #. type: verbatim
15531 #: ../src/guestfs-actions.pod:4699
15532 #, no-wrap
15533 msgid ""
15534 " int\n"
15535 " guestfs_mount (guestfs_h *g,\n"
15536 "                const char *device,\n"
15537 "                const char *mountpoint);\n"
15538 "\n"
15539 msgstr ""
15540
15541 # type: textblock
15542 #. type: textblock
15543 #: ../src/guestfs-actions.pod:4704 ../fish/guestfish-actions.pod:3175
15544 msgid ""
15545 "Mount a guest disk at a position in the filesystem.  Block devices are named "
15546 "C</dev/sda>, C</dev/sdb> and so on, as they were added to the guest.  If "
15547 "those block devices contain partitions, they will have the usual names (eg. "
15548 "C</dev/sda1>).  Also LVM C</dev/VG/LV>-style names can be used."
15549 msgstr ""
15550
15551 # type: textblock
15552 #. type: textblock
15553 #: ../src/guestfs-actions.pod:4710 ../fish/guestfish-actions.pod:3181
15554 msgid ""
15555 "The rules are the same as for L<mount(2)>: A filesystem must first be "
15556 "mounted on C</> before others can be mounted.  Other filesystems can only be "
15557 "mounted on directories which already exist."
15558 msgstr ""
15559
15560 # type: textblock
15561 #. type: textblock
15562 #: ../src/guestfs-actions.pod:4715 ../fish/guestfish-actions.pod:3186
15563 msgid ""
15564 "The mounted filesystem is writable, if we have sufficient permissions on the "
15565 "underlying device."
15566 msgstr ""
15567
15568 # type: textblock
15569 #. type: textblock
15570 #: ../src/guestfs-actions.pod:4718
15571 msgid ""
15572 "B<Important note:> When you use this call, the filesystem options C<sync> "
15573 "and C<noatime> are set implicitly.  This was originally done because we "
15574 "thought it would improve reliability, but it turns out that I<-o sync> has a "
15575 "very large negative performance impact and negligible effect on "
15576 "reliability.  Therefore we recommend that you avoid using C<guestfs_mount> "
15577 "in any code that needs performance, and instead use C<guestfs_mount_options> "
15578 "(use an empty string for the first parameter if you don't want any options)."
15579 msgstr ""
15580
15581 #. type: textblock
15582 #: ../src/guestfs-actions.pod:4730 ../fish/guestfish-actions.pod:3199
15583 msgid ""
15584 "This function is deprecated.  In new code, use the C<mount_options> call "
15585 "instead."
15586 msgstr ""
15587
15588 # type: =head2
15589 #. type: =head2
15590 #: ../src/guestfs-actions.pod:4739
15591 msgid "guestfs_mount_loop"
15592 msgstr ""
15593
15594 # type: verbatim
15595 #. type: verbatim
15596 #: ../src/guestfs-actions.pod:4741
15597 #, no-wrap
15598 msgid ""
15599 " int\n"
15600 " guestfs_mount_loop (guestfs_h *g,\n"
15601 "                     const char *file,\n"
15602 "                     const char *mountpoint);\n"
15603 "\n"
15604 msgstr ""
15605
15606 # type: textblock
15607 #. type: textblock
15608 #: ../src/guestfs-actions.pod:4746 ../fish/guestfish-actions.pod:3210
15609 msgid ""
15610 "This command lets you mount C<file> (a filesystem image in a file) on a "
15611 "mount point.  It is entirely equivalent to the command C<mount -o loop file "
15612 "mountpoint>."
15613 msgstr ""
15614
15615 # type: =head2
15616 #. type: =head2
15617 #: ../src/guestfs-actions.pod:4754
15618 msgid "guestfs_mount_options"
15619 msgstr ""
15620
15621 # type: verbatim
15622 #. type: verbatim
15623 #: ../src/guestfs-actions.pod:4756
15624 #, no-wrap
15625 msgid ""
15626 " int\n"
15627 " guestfs_mount_options (guestfs_h *g,\n"
15628 "                        const char *options,\n"
15629 "                        const char *device,\n"
15630 "                        const char *mountpoint);\n"
15631 "\n"
15632 msgstr ""
15633
15634 # type: textblock
15635 #. type: textblock
15636 #: ../src/guestfs-actions.pod:4762
15637 msgid ""
15638 "This is the same as the C<guestfs_mount> command, but it allows you to set "
15639 "the mount options as for the L<mount(8)> I<-o> flag."
15640 msgstr ""
15641
15642 # type: textblock
15643 #. type: textblock
15644 #: ../src/guestfs-actions.pod:4766 ../fish/guestfish-actions.pod:3222
15645 msgid ""
15646 "If the C<options> parameter is an empty string, then no options are passed "
15647 "(all options default to whatever the filesystem uses)."
15648 msgstr ""
15649
15650 # type: textblock
15651 #. type: textblock
15652 #: ../src/guestfs-actions.pod:4772 ../src/guestfs-actions.pod:4786
15653 #: ../src/guestfs-actions.pod:4803
15654 msgid "(Added in 1.0.10)"
15655 msgstr ""
15656
15657 # type: =head2
15658 #. type: =head2
15659 #: ../src/guestfs-actions.pod:4774
15660 msgid "guestfs_mount_ro"
15661 msgstr ""
15662
15663 # type: verbatim
15664 #. type: verbatim
15665 #: ../src/guestfs-actions.pod:4776
15666 #, no-wrap
15667 msgid ""
15668 " int\n"
15669 " guestfs_mount_ro (guestfs_h *g,\n"
15670 "                   const char *device,\n"
15671 "                   const char *mountpoint);\n"
15672 "\n"
15673 msgstr ""
15674
15675 # type: textblock
15676 #. type: textblock
15677 #: ../src/guestfs-actions.pod:4781
15678 msgid ""
15679 "This is the same as the C<guestfs_mount> command, but it mounts the "
15680 "filesystem with the read-only (I<-o ro>) flag."
15681 msgstr ""
15682
15683 # type: =head2
15684 #. type: =head2
15685 #: ../src/guestfs-actions.pod:4788
15686 msgid "guestfs_mount_vfs"
15687 msgstr ""
15688
15689 # type: verbatim
15690 #. type: verbatim
15691 #: ../src/guestfs-actions.pod:4790
15692 #, no-wrap
15693 msgid ""
15694 " int\n"
15695 " guestfs_mount_vfs (guestfs_h *g,\n"
15696 "                    const char *options,\n"
15697 "                    const char *vfstype,\n"
15698 "                    const char *device,\n"
15699 "                    const char *mountpoint);\n"
15700 "\n"
15701 msgstr ""
15702
15703 # type: textblock
15704 #. type: textblock
15705 #: ../src/guestfs-actions.pod:4797
15706 msgid ""
15707 "This is the same as the C<guestfs_mount> command, but it allows you to set "
15708 "both the mount options and the vfstype as for the L<mount(8)> I<-o> and I<-"
15709 "t> flags."
15710 msgstr ""
15711
15712 # type: =head2
15713 #. type: =head2
15714 #: ../src/guestfs-actions.pod:4805
15715 msgid "guestfs_mountpoints"
15716 msgstr ""
15717
15718 # type: verbatim
15719 #. type: verbatim
15720 #: ../src/guestfs-actions.pod:4807
15721 #, no-wrap
15722 msgid ""
15723 " char **\n"
15724 " guestfs_mountpoints (guestfs_h *g);\n"
15725 "\n"
15726 msgstr ""
15727
15728 # type: textblock
15729 #. type: textblock
15730 #: ../src/guestfs-actions.pod:4810
15731 msgid ""
15732 "This call is similar to C<guestfs_mounts>.  That call returns a list of "
15733 "devices.  This one returns a hash table (map) of device name to directory "
15734 "where the device is mounted."
15735 msgstr ""
15736
15737 # type: =head2
15738 #. type: =head2
15739 #: ../src/guestfs-actions.pod:4822
15740 msgid "guestfs_mounts"
15741 msgstr ""
15742
15743 # type: verbatim
15744 #. type: verbatim
15745 #: ../src/guestfs-actions.pod:4824
15746 #, no-wrap
15747 msgid ""
15748 " char **\n"
15749 " guestfs_mounts (guestfs_h *g);\n"
15750 "\n"
15751 msgstr ""
15752
15753 # type: textblock
15754 #. type: textblock
15755 #: ../src/guestfs-actions.pod:4827 ../fish/guestfish-actions.pod:3253
15756 msgid ""
15757 "This returns the list of currently mounted filesystems.  It returns the list "
15758 "of devices (eg. C</dev/sda1>, C</dev/VG/LV>)."
15759 msgstr ""
15760
15761 # type: textblock
15762 #. type: textblock
15763 #: ../src/guestfs-actions.pod:4830 ../fish/guestfish-actions.pod:3256
15764 msgid "Some internal mounts are not shown."
15765 msgstr ""
15766
15767 # type: textblock
15768 #. type: textblock
15769 #: ../src/guestfs-actions.pod:4832
15770 msgid "See also: C<guestfs_mountpoints>"
15771 msgstr ""
15772
15773 # type: =head2
15774 #. type: =head2
15775 #: ../src/guestfs-actions.pod:4840
15776 msgid "guestfs_mv"
15777 msgstr ""
15778
15779 # type: verbatim
15780 #. type: verbatim
15781 #: ../src/guestfs-actions.pod:4842
15782 #, no-wrap
15783 msgid ""
15784 " int\n"
15785 " guestfs_mv (guestfs_h *g,\n"
15786 "             const char *src,\n"
15787 "             const char *dest);\n"
15788 "\n"
15789 msgstr ""
15790
15791 # type: textblock
15792 #. type: textblock
15793 #: ../src/guestfs-actions.pod:4847 ../fish/guestfish-actions.pod:3264
15794 msgid ""
15795 "This moves a file from C<src> to C<dest> where C<dest> is either a "
15796 "destination filename or destination directory."
15797 msgstr ""
15798
15799 # type: =head2
15800 #. type: =head2
15801 #: ../src/guestfs-actions.pod:4854
15802 msgid "guestfs_ntfs_3g_probe"
15803 msgstr ""
15804
15805 # type: verbatim
15806 #. type: verbatim
15807 #: ../src/guestfs-actions.pod:4856
15808 #, no-wrap
15809 msgid ""
15810 " int\n"
15811 " guestfs_ntfs_3g_probe (guestfs_h *g,\n"
15812 "                        int rw,\n"
15813 "                        const char *device);\n"
15814 "\n"
15815 msgstr ""
15816
15817 # type: textblock
15818 #. type: textblock
15819 #: ../src/guestfs-actions.pod:4861 ../fish/guestfish-actions.pod:3271
15820 msgid ""
15821 "This command runs the L<ntfs-3g.probe(8)> command which probes an NTFS "
15822 "C<device> for mountability.  (Not all NTFS volumes can be mounted read-"
15823 "write, and some cannot be mounted at all)."
15824 msgstr ""
15825
15826 # type: textblock
15827 #. type: textblock
15828 #: ../src/guestfs-actions.pod:4865 ../fish/guestfish-actions.pod:3275
15829 msgid ""
15830 "C<rw> is a boolean flag.  Set it to true if you want to test if the volume "
15831 "can be mounted read-write.  Set it to false if you want to test if the "
15832 "volume can be mounted read-only."
15833 msgstr ""
15834
15835 # type: textblock
15836 #. type: textblock
15837 #: ../src/guestfs-actions.pod:4869 ../fish/guestfish-actions.pod:3279
15838 msgid ""
15839 "The return value is an integer which C<0> if the operation would succeed, or "
15840 "some non-zero value documented in the L<ntfs-3g.probe(8)> manual page."
15841 msgstr ""
15842
15843 # type: textblock
15844 #. type: textblock
15845 #: ../src/guestfs-actions.pod:4875
15846 msgid "(Added in 1.0.43)"
15847 msgstr ""
15848
15849 # type: =head2
15850 #. type: =head2
15851 #: ../src/guestfs-actions.pod:4877
15852 msgid "guestfs_ntfsresize"
15853 msgstr ""
15854
15855 # type: verbatim
15856 #. type: verbatim
15857 #: ../src/guestfs-actions.pod:4879
15858 #, no-wrap
15859 msgid ""
15860 " int\n"
15861 " guestfs_ntfsresize (guestfs_h *g,\n"
15862 "                     const char *device);\n"
15863 "\n"
15864 msgstr ""
15865
15866 #. type: textblock
15867 #: ../src/guestfs-actions.pod:4883 ../fish/guestfish-actions.pod:3287
15868 msgid ""
15869 "This command resizes an NTFS filesystem, expanding or shrinking it to the "
15870 "size of the underlying device."
15871 msgstr ""
15872
15873 #. type: textblock
15874 #: ../src/guestfs-actions.pod:4886 ../fish/guestfish-actions.pod:3290
15875 msgid ""
15876 "I<Note:> After the resize operation, the filesystem is marked as requiring a "
15877 "consistency check (for safety).  You have to boot into Windows to perform "
15878 "this check and clear this condition.  Furthermore, ntfsresize refuses to "
15879 "resize filesystems which have been marked in this way.  So in effect it is "
15880 "not possible to call ntfsresize multiple times on a single filesystem "
15881 "without booting into Windows between each resize."
15882 msgstr ""
15883
15884 #. type: textblock
15885 #: ../src/guestfs-actions.pod:4894 ../fish/guestfish-actions.pod:3298
15886 msgid "See also L<ntfsresize(8)>."
15887 msgstr ""
15888
15889 # type: =head2
15890 #. type: =head2
15891 #: ../src/guestfs-actions.pod:4900
15892 msgid "guestfs_ntfsresize_size"
15893 msgstr ""
15894
15895 # type: verbatim
15896 #. type: verbatim
15897 #: ../src/guestfs-actions.pod:4902
15898 #, no-wrap
15899 msgid ""
15900 " int\n"
15901 " guestfs_ntfsresize_size (guestfs_h *g,\n"
15902 "                          const char *device,\n"
15903 "                          int64_t size);\n"
15904 "\n"
15905 msgstr ""
15906
15907 # type: textblock
15908 #. type: textblock
15909 #: ../src/guestfs-actions.pod:4907
15910 msgid ""
15911 "This command is the same as C<guestfs_ntfsresize> except that it allows you "
15912 "to specify the new size (in bytes) explicitly."
15913 msgstr ""
15914
15915 # type: textblock
15916 #. type: textblock
15917 #: ../src/guestfs-actions.pod:4912 ../src/guestfs-actions.pod:5348
15918 #: ../src/guestfs-actions.pod:5421 ../src/guestfs-actions.pod:5687
15919 #: ../src/guestfs-actions.pod:7293
15920 msgid "(Added in 1.3.14)"
15921 msgstr ""
15922
15923 # type: =head2
15924 #. type: =head2
15925 #: ../src/guestfs-actions.pod:4914
15926 msgid "guestfs_part_add"
15927 msgstr ""
15928
15929 # type: verbatim
15930 #. type: verbatim
15931 #: ../src/guestfs-actions.pod:4916
15932 #, no-wrap
15933 msgid ""
15934 " int\n"
15935 " guestfs_part_add (guestfs_h *g,\n"
15936 "                   const char *device,\n"
15937 "                   const char *prlogex,\n"
15938 "                   int64_t startsect,\n"
15939 "                   int64_t endsect);\n"
15940 "\n"
15941 msgstr ""
15942
15943 # type: textblock
15944 #. type: textblock
15945 #: ../src/guestfs-actions.pod:4923
15946 msgid ""
15947 "This command adds a partition to C<device>.  If there is no partition table "
15948 "on the device, call C<guestfs_part_init> first."
15949 msgstr ""
15950
15951 # type: textblock
15952 #. type: textblock
15953 #: ../src/guestfs-actions.pod:4926 ../fish/guestfish-actions.pod:3314
15954 msgid ""
15955 "The C<prlogex> parameter is the type of partition.  Normally you should pass "
15956 "C<p> or C<primary> here, but MBR partition tables also support C<l> (or "
15957 "C<logical>) and C<e> (or C<extended>) partition types."
15958 msgstr ""
15959
15960 # type: textblock
15961 #. type: textblock
15962 #: ../src/guestfs-actions.pod:4931 ../fish/guestfish-actions.pod:3319
15963 msgid ""
15964 "C<startsect> and C<endsect> are the start and end of the partition in "
15965 "I<sectors>.  C<endsect> may be negative, which means it counts backwards "
15966 "from the end of the disk (C<-1> is the last sector)."
15967 msgstr ""
15968
15969 # type: textblock
15970 #. type: textblock
15971 #: ../src/guestfs-actions.pod:4935
15972 msgid ""
15973 "Creating a partition which covers the whole disk is not so easy.  Use "
15974 "C<guestfs_part_disk> to do that."
15975 msgstr ""
15976
15977 # type: textblock
15978 #. type: textblock
15979 #: ../src/guestfs-actions.pod:4940 ../src/guestfs-actions.pod:4978
15980 #: ../src/guestfs-actions.pod:5031 ../src/guestfs-actions.pod:5109
15981 #: ../src/guestfs-actions.pod:5147 ../src/guestfs-actions.pod:5166
15982 #: ../src/guestfs-actions.pod:5206
15983 msgid "(Added in 1.0.78)"
15984 msgstr ""
15985
15986 # type: =head2
15987 #. type: =head2
15988 #: ../src/guestfs-actions.pod:4942
15989 msgid "guestfs_part_del"
15990 msgstr ""
15991
15992 # type: verbatim
15993 #. type: verbatim
15994 #: ../src/guestfs-actions.pod:4944
15995 #, no-wrap
15996 msgid ""
15997 " int\n"
15998 " guestfs_part_del (guestfs_h *g,\n"
15999 "                   const char *device,\n"
16000 "                   int partnum);\n"
16001 "\n"
16002 msgstr ""
16003
16004 # type: textblock
16005 #. type: textblock
16006 #: ../src/guestfs-actions.pod:4949 ../fish/guestfish-actions.pod:3330
16007 msgid "This command deletes the partition numbered C<partnum> on C<device>."
16008 msgstr ""
16009
16010 # type: textblock
16011 #. type: textblock
16012 #: ../src/guestfs-actions.pod:4951 ../fish/guestfish-actions.pod:3332
16013 msgid ""
16014 "Note that in the case of MBR partitioning, deleting an extended partition "
16015 "also deletes any logical partitions it contains."
16016 msgstr ""
16017
16018 # type: =head2
16019 #. type: =head2
16020 #: ../src/guestfs-actions.pod:4959
16021 msgid "guestfs_part_disk"
16022 msgstr ""
16023
16024 # type: verbatim
16025 #. type: verbatim
16026 #: ../src/guestfs-actions.pod:4961
16027 #, no-wrap
16028 msgid ""
16029 " int\n"
16030 " guestfs_part_disk (guestfs_h *g,\n"
16031 "                    const char *device,\n"
16032 "                    const char *parttype);\n"
16033 "\n"
16034 msgstr ""
16035
16036 # type: textblock
16037 #. type: textblock
16038 #: ../src/guestfs-actions.pod:4966
16039 msgid ""
16040 "This command is simply a combination of C<guestfs_part_init> followed by "
16041 "C<guestfs_part_add> to create a single primary partition covering the whole "
16042 "disk."
16043 msgstr ""
16044
16045 # type: textblock
16046 #. type: textblock
16047 #: ../src/guestfs-actions.pod:4970
16048 msgid ""
16049 "C<parttype> is the partition table type, usually C<mbr> or C<gpt>, but other "
16050 "possible values are described in C<guestfs_part_init>."
16051 msgstr ""
16052
16053 # type: =head2
16054 #. type: =head2
16055 #: ../src/guestfs-actions.pod:4980
16056 msgid "guestfs_part_get_bootable"
16057 msgstr ""
16058
16059 # type: verbatim
16060 #. type: verbatim
16061 #: ../src/guestfs-actions.pod:4982
16062 #, no-wrap
16063 msgid ""
16064 " int\n"
16065 " guestfs_part_get_bootable (guestfs_h *g,\n"
16066 "                            const char *device,\n"
16067 "                            int partnum);\n"
16068 "\n"
16069 msgstr ""
16070
16071 # type: textblock
16072 #. type: textblock
16073 #: ../src/guestfs-actions.pod:4987 ../fish/guestfish-actions.pod:3354
16074 msgid ""
16075 "This command returns true if the partition C<partnum> on C<device> has the "
16076 "bootable flag set."
16077 msgstr ""
16078
16079 # type: textblock
16080 #. type: textblock
16081 #: ../src/guestfs-actions.pod:4990
16082 msgid "See also C<guestfs_part_set_bootable>."
16083 msgstr ""
16084
16085 # type: =head2
16086 #. type: =head2
16087 #: ../src/guestfs-actions.pod:4996
16088 msgid "guestfs_part_get_mbr_id"
16089 msgstr ""
16090
16091 # type: verbatim
16092 #. type: verbatim
16093 #: ../src/guestfs-actions.pod:4998
16094 #, no-wrap
16095 msgid ""
16096 " int\n"
16097 " guestfs_part_get_mbr_id (guestfs_h *g,\n"
16098 "                          const char *device,\n"
16099 "                          int partnum);\n"
16100 "\n"
16101 msgstr ""
16102
16103 # type: textblock
16104 #. type: textblock
16105 #: ../src/guestfs-actions.pod:5003 ../fish/guestfish-actions.pod:3363
16106 msgid ""
16107 "Returns the MBR type byte (also known as the ID byte) from the numbered "
16108 "partition C<partnum>."
16109 msgstr ""
16110
16111 # type: textblock
16112 #. type: textblock
16113 #: ../src/guestfs-actions.pod:5006 ../src/guestfs-actions.pod:5182
16114 msgid ""
16115 "Note that only MBR (old DOS-style) partitions have type bytes.  You will get "
16116 "undefined results for other partition table types (see "
16117 "C<guestfs_part_get_parttype>)."
16118 msgstr ""
16119
16120 # type: =head2
16121 #. type: =head2
16122 #: ../src/guestfs-actions.pod:5014
16123 msgid "guestfs_part_get_parttype"
16124 msgstr ""
16125
16126 # type: verbatim
16127 #. type: verbatim
16128 #: ../src/guestfs-actions.pod:5016
16129 #, no-wrap
16130 msgid ""
16131 " char *\n"
16132 " guestfs_part_get_parttype (guestfs_h *g,\n"
16133 "                            const char *device);\n"
16134 "\n"
16135 msgstr ""
16136
16137 # type: textblock
16138 #. type: textblock
16139 #: ../src/guestfs-actions.pod:5020 ../fish/guestfish-actions.pod:3374
16140 msgid ""
16141 "This command examines the partition table on C<device> and returns the "
16142 "partition table type (format) being used."
16143 msgstr ""
16144
16145 # type: textblock
16146 #. type: textblock
16147 #: ../src/guestfs-actions.pod:5023
16148 msgid ""
16149 "Common return values include: C<msdos> (a DOS/Windows style MBR partition "
16150 "table), C<gpt> (a GPT/EFI-style partition table).  Other values are "
16151 "possible, although unusual.  See C<guestfs_part_init> for a full list."
16152 msgstr ""
16153
16154 # type: =head2
16155 #. type: =head2
16156 #: ../src/guestfs-actions.pod:5033
16157 msgid "guestfs_part_init"
16158 msgstr ""
16159
16160 # type: verbatim
16161 #. type: verbatim
16162 #: ../src/guestfs-actions.pod:5035
16163 #, no-wrap
16164 msgid ""
16165 " int\n"
16166 " guestfs_part_init (guestfs_h *g,\n"
16167 "                    const char *device,\n"
16168 "                    const char *parttype);\n"
16169 "\n"
16170 msgstr ""
16171
16172 # type: textblock
16173 #. type: textblock
16174 #: ../src/guestfs-actions.pod:5040 ../fish/guestfish-actions.pod:3386
16175 msgid ""
16176 "This creates an empty partition table on C<device> of one of the partition "
16177 "types listed below.  Usually C<parttype> should be either C<msdos> or C<gpt> "
16178 "(for large disks)."
16179 msgstr ""
16180
16181 # type: textblock
16182 #. type: textblock
16183 #: ../src/guestfs-actions.pod:5044
16184 msgid ""
16185 "Initially there are no partitions.  Following this, you should call "
16186 "C<guestfs_part_add> for each partition required."
16187 msgstr ""
16188
16189 # type: textblock
16190 #. type: textblock
16191 #: ../src/guestfs-actions.pod:5047 ../fish/guestfish-actions.pod:3393
16192 msgid "Possible values for C<parttype> are:"
16193 msgstr ""
16194
16195 # type: =item
16196 #. type: =item
16197 #: ../src/guestfs-actions.pod:5051 ../fish/guestfish-actions.pod:3397
16198 msgid "B<efi> | B<gpt>"
16199 msgstr ""
16200
16201 # type: textblock
16202 #. type: textblock
16203 #: ../src/guestfs-actions.pod:5053 ../fish/guestfish-actions.pod:3399
16204 msgid "Intel EFI / GPT partition table."
16205 msgstr ""
16206
16207 # type: textblock
16208 #. type: textblock
16209 #: ../src/guestfs-actions.pod:5055 ../fish/guestfish-actions.pod:3401
16210 msgid ""
16211 "This is recommended for >= 2 TB partitions that will be accessed from Linux "
16212 "and Intel-based Mac OS X.  It also has limited backwards compatibility with "
16213 "the C<mbr> format."
16214 msgstr ""
16215
16216 # type: =item
16217 #. type: =item
16218 #: ../src/guestfs-actions.pod:5059 ../fish/guestfish-actions.pod:3405
16219 msgid "B<mbr> | B<msdos>"
16220 msgstr ""
16221
16222 # type: textblock
16223 #. type: textblock
16224 #: ../src/guestfs-actions.pod:5061 ../fish/guestfish-actions.pod:3407
16225 msgid ""
16226 "The standard PC \"Master Boot Record\" (MBR) format used by MS-DOS and "
16227 "Windows.  This partition type will B<only> work for device sizes up to 2 "
16228 "TB.  For large disks we recommend using C<gpt>."
16229 msgstr ""
16230
16231 # type: textblock
16232 #. type: textblock
16233 #: ../src/guestfs-actions.pod:5068 ../fish/guestfish-actions.pod:3414
16234 msgid ""
16235 "Other partition table types that may work but are not supported include:"
16236 msgstr ""
16237
16238 # type: =item
16239 #. type: =item
16240 #: ../src/guestfs-actions.pod:5073 ../fish/guestfish-actions.pod:3419
16241 msgid "B<aix>"
16242 msgstr ""
16243
16244 # type: textblock
16245 #. type: textblock
16246 #: ../src/guestfs-actions.pod:5075 ../fish/guestfish-actions.pod:3421
16247 msgid "AIX disk labels."
16248 msgstr ""
16249
16250 # type: =item
16251 #. type: =item
16252 #: ../src/guestfs-actions.pod:5077 ../fish/guestfish-actions.pod:3423
16253 msgid "B<amiga> | B<rdb>"
16254 msgstr ""
16255
16256 # type: textblock
16257 #. type: textblock
16258 #: ../src/guestfs-actions.pod:5079 ../fish/guestfish-actions.pod:3425
16259 msgid "Amiga \"Rigid Disk Block\" format."
16260 msgstr ""
16261
16262 # type: =item
16263 #. type: =item
16264 #: ../src/guestfs-actions.pod:5081 ../fish/guestfish-actions.pod:3427
16265 msgid "B<bsd>"
16266 msgstr ""
16267
16268 # type: textblock
16269 #. type: textblock
16270 #: ../src/guestfs-actions.pod:5083 ../fish/guestfish-actions.pod:3429
16271 msgid "BSD disk labels."
16272 msgstr ""
16273
16274 # type: =item
16275 #. type: =item
16276 #: ../src/guestfs-actions.pod:5085 ../fish/guestfish-actions.pod:3431
16277 msgid "B<dasd>"
16278 msgstr ""
16279
16280 # type: textblock
16281 #. type: textblock
16282 #: ../src/guestfs-actions.pod:5087 ../fish/guestfish-actions.pod:3433
16283 msgid "DASD, used on IBM mainframes."
16284 msgstr ""
16285
16286 # type: =item
16287 #. type: =item
16288 #: ../src/guestfs-actions.pod:5089 ../fish/guestfish-actions.pod:3435
16289 msgid "B<dvh>"
16290 msgstr ""
16291
16292 # type: textblock
16293 #. type: textblock
16294 #: ../src/guestfs-actions.pod:5091 ../fish/guestfish-actions.pod:3437
16295 msgid "MIPS/SGI volumes."
16296 msgstr ""
16297
16298 # type: =item
16299 #. type: =item
16300 #: ../src/guestfs-actions.pod:5093 ../fish/guestfish-actions.pod:3439
16301 msgid "B<mac>"
16302 msgstr ""
16303
16304 # type: textblock
16305 #. type: textblock
16306 #: ../src/guestfs-actions.pod:5095 ../fish/guestfish-actions.pod:3441
16307 msgid "Old Mac partition format.  Modern Macs use C<gpt>."
16308 msgstr ""
16309
16310 # type: =item
16311 #. type: =item
16312 #: ../src/guestfs-actions.pod:5097 ../fish/guestfish-actions.pod:3443
16313 msgid "B<pc98>"
16314 msgstr ""
16315
16316 # type: textblock
16317 #. type: textblock
16318 #: ../src/guestfs-actions.pod:5099 ../fish/guestfish-actions.pod:3445
16319 msgid "NEC PC-98 format, common in Japan apparently."
16320 msgstr ""
16321
16322 # type: =item
16323 #. type: =item
16324 #: ../src/guestfs-actions.pod:5101 ../fish/guestfish-actions.pod:3447
16325 msgid "B<sun>"
16326 msgstr ""
16327
16328 # type: textblock
16329 #. type: textblock
16330 #: ../src/guestfs-actions.pod:5103 ../fish/guestfish-actions.pod:3449
16331 msgid "Sun disk labels."
16332 msgstr ""
16333
16334 # type: =head2
16335 #. type: =head2
16336 #: ../src/guestfs-actions.pod:5111
16337 msgid "guestfs_part_list"
16338 msgstr ""
16339
16340 # type: verbatim
16341 #. type: verbatim
16342 #: ../src/guestfs-actions.pod:5113
16343 #, no-wrap
16344 msgid ""
16345 " struct guestfs_partition_list *\n"
16346 " guestfs_part_list (guestfs_h *g,\n"
16347 "                    const char *device);\n"
16348 "\n"
16349 msgstr ""
16350
16351 # type: textblock
16352 #. type: textblock
16353 #: ../src/guestfs-actions.pod:5117 ../fish/guestfish-actions.pod:3457
16354 msgid ""
16355 "This command parses the partition table on C<device> and returns the list of "
16356 "partitions found."
16357 msgstr ""
16358
16359 # type: textblock
16360 #. type: textblock
16361 #: ../src/guestfs-actions.pod:5120 ../fish/guestfish-actions.pod:3460
16362 msgid "The fields in the returned structure are:"
16363 msgstr ""
16364
16365 # type: =item
16366 #. type: =item
16367 #: ../src/guestfs-actions.pod:5124 ../fish/guestfish-actions.pod:3464
16368 msgid "B<part_num>"
16369 msgstr ""
16370
16371 # type: textblock
16372 #. type: textblock
16373 #: ../src/guestfs-actions.pod:5126 ../fish/guestfish-actions.pod:3466
16374 msgid "Partition number, counting from 1."
16375 msgstr ""
16376
16377 # type: =item
16378 #. type: =item
16379 #: ../src/guestfs-actions.pod:5128 ../fish/guestfish-actions.pod:3468
16380 msgid "B<part_start>"
16381 msgstr ""
16382
16383 # type: textblock
16384 #. type: textblock
16385 #: ../src/guestfs-actions.pod:5130
16386 msgid ""
16387 "Start of the partition I<in bytes>.  To get sectors you have to divide by "
16388 "the device's sector size, see C<guestfs_blockdev_getss>."
16389 msgstr ""
16390
16391 # type: =item
16392 #. type: =item
16393 #: ../src/guestfs-actions.pod:5133 ../fish/guestfish-actions.pod:3473
16394 msgid "B<part_end>"
16395 msgstr ""
16396
16397 # type: textblock
16398 #. type: textblock
16399 #: ../src/guestfs-actions.pod:5135 ../fish/guestfish-actions.pod:3475
16400 msgid "End of the partition in bytes."
16401 msgstr ""
16402
16403 # type: =item
16404 #. type: =item
16405 #: ../src/guestfs-actions.pod:5137 ../fish/guestfish-actions.pod:3477
16406 msgid "B<part_size>"
16407 msgstr ""
16408
16409 # type: textblock
16410 #. type: textblock
16411 #: ../src/guestfs-actions.pod:5139 ../fish/guestfish-actions.pod:3479
16412 msgid "Size of the partition in bytes."
16413 msgstr ""
16414
16415 # type: textblock
16416 #. type: textblock
16417 #: ../src/guestfs-actions.pod:5143
16418 msgid ""
16419 "This function returns a C<struct guestfs_partition_list *>, or NULL if there "
16420 "was an error.  I<The caller must call C<guestfs_free_partition_list> after "
16421 "use>."
16422 msgstr ""
16423
16424 # type: =head2
16425 #. type: =head2
16426 #: ../src/guestfs-actions.pod:5149
16427 msgid "guestfs_part_set_bootable"
16428 msgstr ""
16429
16430 # type: verbatim
16431 #. type: verbatim
16432 #: ../src/guestfs-actions.pod:5151
16433 #, no-wrap
16434 msgid ""
16435 " int\n"
16436 " guestfs_part_set_bootable (guestfs_h *g,\n"
16437 "                            const char *device,\n"
16438 "                            int partnum,\n"
16439 "                            int bootable);\n"
16440 "\n"
16441 msgstr ""
16442
16443 # type: textblock
16444 #. type: textblock
16445 #: ../src/guestfs-actions.pod:5157 ../fish/guestfish-actions.pod:3487
16446 msgid ""
16447 "This sets the bootable flag on partition numbered C<partnum> on device "
16448 "C<device>.  Note that partitions are numbered from 1."
16449 msgstr ""
16450
16451 # type: textblock
16452 #. type: textblock
16453 #: ../src/guestfs-actions.pod:5160 ../fish/guestfish-actions.pod:3490
16454 msgid ""
16455 "The bootable flag is used by some operating systems (notably Windows) to "
16456 "determine which partition to boot from.  It is by no means universally "
16457 "recognized."
16458 msgstr ""
16459
16460 # type: =head2
16461 #. type: =head2
16462 #: ../src/guestfs-actions.pod:5168
16463 msgid "guestfs_part_set_mbr_id"
16464 msgstr ""
16465
16466 # type: verbatim
16467 #. type: verbatim
16468 #: ../src/guestfs-actions.pod:5170
16469 #, no-wrap
16470 msgid ""
16471 " int\n"
16472 " guestfs_part_set_mbr_id (guestfs_h *g,\n"
16473 "                          const char *device,\n"
16474 "                          int partnum,\n"
16475 "                          int idbyte);\n"
16476 "\n"
16477 msgstr ""
16478
16479 # type: textblock
16480 #. type: textblock
16481 #: ../src/guestfs-actions.pod:5176 ../fish/guestfish-actions.pod:3498
16482 msgid ""
16483 "Sets the MBR type byte (also known as the ID byte) of the numbered partition "
16484 "C<partnum> to C<idbyte>.  Note that the type bytes quoted in most "
16485 "documentation are in fact hexadecimal numbers, but usually documented "
16486 "without any leading \"0x\" which might be confusing."
16487 msgstr ""
16488
16489 # type: =head2
16490 #. type: =head2
16491 #: ../src/guestfs-actions.pod:5190
16492 msgid "guestfs_part_set_name"
16493 msgstr ""
16494
16495 # type: verbatim
16496 #. type: verbatim
16497 #: ../src/guestfs-actions.pod:5192
16498 #, no-wrap
16499 msgid ""
16500 " int\n"
16501 " guestfs_part_set_name (guestfs_h *g,\n"
16502 "                        const char *device,\n"
16503 "                        int partnum,\n"
16504 "                        const char *name);\n"
16505 "\n"
16506 msgstr ""
16507
16508 # type: textblock
16509 #. type: textblock
16510 #: ../src/guestfs-actions.pod:5198 ../fish/guestfish-actions.pod:3512
16511 msgid ""
16512 "This sets the partition name on partition numbered C<partnum> on device "
16513 "C<device>.  Note that partitions are numbered from 1."
16514 msgstr ""
16515
16516 # type: textblock
16517 #. type: textblock
16518 #: ../src/guestfs-actions.pod:5201 ../fish/guestfish-actions.pod:3515
16519 msgid ""
16520 "The partition name can only be set on certain types of partition table.  "
16521 "This works on C<gpt> but not on C<mbr> partitions."
16522 msgstr ""
16523
16524 # type: =head2
16525 #. type: =head2
16526 #: ../src/guestfs-actions.pod:5208
16527 msgid "guestfs_part_to_dev"
16528 msgstr ""
16529
16530 # type: verbatim
16531 #. type: verbatim
16532 #: ../src/guestfs-actions.pod:5210
16533 #, no-wrap
16534 msgid ""
16535 " char *\n"
16536 " guestfs_part_to_dev (guestfs_h *g,\n"
16537 "                      const char *partition);\n"
16538 "\n"
16539 msgstr ""
16540
16541 # type: textblock
16542 #. type: textblock
16543 #: ../src/guestfs-actions.pod:5214 ../fish/guestfish-actions.pod:3522
16544 msgid ""
16545 "This function takes a partition name (eg. \"/dev/sdb1\") and removes the "
16546 "partition number, returning the device name (eg. \"/dev/sdb\")."
16547 msgstr ""
16548
16549 # type: textblock
16550 #. type: textblock
16551 #: ../src/guestfs-actions.pod:5218
16552 msgid ""
16553 "The named partition must exist, for example as a string returned from "
16554 "C<guestfs_list_partitions>."
16555 msgstr ""
16556
16557 # type: =head2
16558 #. type: =head2
16559 #: ../src/guestfs-actions.pod:5226
16560 msgid "guestfs_ping_daemon"
16561 msgstr ""
16562
16563 # type: verbatim
16564 #. type: verbatim
16565 #: ../src/guestfs-actions.pod:5228
16566 #, no-wrap
16567 msgid ""
16568 " int\n"
16569 " guestfs_ping_daemon (guestfs_h *g);\n"
16570 "\n"
16571 msgstr ""
16572
16573 # type: textblock
16574 #. type: textblock
16575 #: ../src/guestfs-actions.pod:5231 ../fish/guestfish-actions.pod:3533
16576 msgid ""
16577 "This is a test probe into the guestfs daemon running inside the qemu "
16578 "subprocess.  Calling this function checks that the daemon responds to the "
16579 "ping message, without affecting the daemon or attached block device(s) in "
16580 "any other way."
16581 msgstr ""
16582
16583 # type: =head2
16584 #. type: =head2
16585 #: ../src/guestfs-actions.pod:5240
16586 msgid "guestfs_pread"
16587 msgstr ""
16588
16589 # type: verbatim
16590 #. type: verbatim
16591 #: ../src/guestfs-actions.pod:5242
16592 #, no-wrap
16593 msgid ""
16594 " char *\n"
16595 " guestfs_pread (guestfs_h *g,\n"
16596 "                const char *path,\n"
16597 "                int count,\n"
16598 "                int64_t offset,\n"
16599 "                size_t *size_r);\n"
16600 "\n"
16601 msgstr ""
16602
16603 # type: textblock
16604 #. type: textblock
16605 #: ../src/guestfs-actions.pod:5249 ../fish/guestfish-actions.pod:3542
16606 msgid ""
16607 "This command lets you read part of a file.  It reads C<count> bytes of the "
16608 "file, starting at C<offset>, from file C<path>."
16609 msgstr ""
16610
16611 # type: textblock
16612 #. type: textblock
16613 #: ../src/guestfs-actions.pod:5252 ../src/guestfs-actions.pod:5278
16614 #: ../fish/guestfish-actions.pod:3545 ../fish/guestfish-actions.pod:3560
16615 msgid ""
16616 "This may read fewer bytes than requested.  For further details see the "
16617 "L<pread(2)> system call."
16618 msgstr ""
16619
16620 # type: textblock
16621 #. type: textblock
16622 #: ../src/guestfs-actions.pod:5255
16623 msgid "See also C<guestfs_pwrite>, C<guestfs_pread_device>."
16624 msgstr ""
16625
16626 # type: =head2
16627 #. type: =head2
16628 #: ../src/guestfs-actions.pod:5266
16629 msgid "guestfs_pread_device"
16630 msgstr ""
16631
16632 # type: verbatim
16633 #. type: verbatim
16634 #: ../src/guestfs-actions.pod:5268
16635 #, no-wrap
16636 msgid ""
16637 " char *\n"
16638 " guestfs_pread_device (guestfs_h *g,\n"
16639 "                       const char *device,\n"
16640 "                       int count,\n"
16641 "                       int64_t offset,\n"
16642 "                       size_t *size_r);\n"
16643 "\n"
16644 msgstr ""
16645
16646 # type: textblock
16647 #. type: textblock
16648 #: ../src/guestfs-actions.pod:5275 ../fish/guestfish-actions.pod:3557
16649 msgid ""
16650 "This command lets you read part of a file.  It reads C<count> bytes of "
16651 "C<device>, starting at C<offset>."
16652 msgstr ""
16653
16654 # type: textblock
16655 #. type: textblock
16656 #: ../src/guestfs-actions.pod:5281
16657 msgid "See also C<guestfs_pread>."
16658 msgstr ""
16659
16660 # type: textblock
16661 #. type: textblock
16662 #: ../src/guestfs-actions.pod:5290
16663 msgid "(Added in 1.5.21)"
16664 msgstr ""
16665
16666 # type: =head2
16667 #. type: =head2
16668 #: ../src/guestfs-actions.pod:5292
16669 msgid "guestfs_pvcreate"
16670 msgstr ""
16671
16672 # type: verbatim
16673 #. type: verbatim
16674 #: ../src/guestfs-actions.pod:5294
16675 #, no-wrap
16676 msgid ""
16677 " int\n"
16678 " guestfs_pvcreate (guestfs_h *g,\n"
16679 "                   const char *device);\n"
16680 "\n"
16681 msgstr ""
16682
16683 # type: textblock
16684 #. type: textblock
16685 #: ../src/guestfs-actions.pod:5298 ../fish/guestfish-actions.pod:3572
16686 msgid ""
16687 "This creates an LVM physical volume on the named C<device>, where C<device> "
16688 "should usually be a partition name such as C</dev/sda1>."
16689 msgstr ""
16690
16691 # type: =head2
16692 #. type: =head2
16693 #: ../src/guestfs-actions.pod:5306
16694 msgid "guestfs_pvremove"
16695 msgstr ""
16696
16697 # type: verbatim
16698 #. type: verbatim
16699 #: ../src/guestfs-actions.pod:5308
16700 #, no-wrap
16701 msgid ""
16702 " int\n"
16703 " guestfs_pvremove (guestfs_h *g,\n"
16704 "                   const char *device);\n"
16705 "\n"
16706 msgstr ""
16707
16708 # type: textblock
16709 #. type: textblock
16710 #: ../src/guestfs-actions.pod:5312 ../fish/guestfish-actions.pod:3580
16711 msgid ""
16712 "This wipes a physical volume C<device> so that LVM will no longer recognise "
16713 "it."
16714 msgstr ""
16715
16716 # type: textblock
16717 #. type: textblock
16718 #: ../src/guestfs-actions.pod:5315 ../fish/guestfish-actions.pod:3583
16719 msgid ""
16720 "The implementation uses the C<pvremove> command which refuses to wipe "
16721 "physical volumes that contain any volume groups, so you have to remove those "
16722 "first."
16723 msgstr ""
16724
16725 # type: =head2
16726 #. type: =head2
16727 #: ../src/guestfs-actions.pod:5323
16728 msgid "guestfs_pvresize"
16729 msgstr ""
16730
16731 # type: verbatim
16732 #. type: verbatim
16733 #: ../src/guestfs-actions.pod:5325
16734 #, no-wrap
16735 msgid ""
16736 " int\n"
16737 " guestfs_pvresize (guestfs_h *g,\n"
16738 "                   const char *device);\n"
16739 "\n"
16740 msgstr ""
16741
16742 # type: textblock
16743 #. type: textblock
16744 #: ../src/guestfs-actions.pod:5329 ../fish/guestfish-actions.pod:3591
16745 msgid ""
16746 "This resizes (expands or shrinks) an existing LVM physical volume to match "
16747 "the new size of the underlying device."
16748 msgstr ""
16749
16750 # type: =head2
16751 #. type: =head2
16752 #: ../src/guestfs-actions.pod:5336
16753 msgid "guestfs_pvresize_size"
16754 msgstr ""
16755
16756 # type: verbatim
16757 #. type: verbatim
16758 #: ../src/guestfs-actions.pod:5338
16759 #, no-wrap
16760 msgid ""
16761 " int\n"
16762 " guestfs_pvresize_size (guestfs_h *g,\n"
16763 "                        const char *device,\n"
16764 "                        int64_t size);\n"
16765 "\n"
16766 msgstr ""
16767
16768 # type: textblock
16769 #. type: textblock
16770 #: ../src/guestfs-actions.pod:5343
16771 msgid ""
16772 "This command is the same as C<guestfs_pvresize> except that it allows you to "
16773 "specify the new size (in bytes) explicitly."
16774 msgstr ""
16775
16776 # type: =head2
16777 #. type: =head2
16778 #: ../src/guestfs-actions.pod:5350
16779 msgid "guestfs_pvs"
16780 msgstr ""
16781
16782 # type: verbatim
16783 #. type: verbatim
16784 #: ../src/guestfs-actions.pod:5352
16785 #, no-wrap
16786 msgid ""
16787 " char **\n"
16788 " guestfs_pvs (guestfs_h *g);\n"
16789 "\n"
16790 msgstr ""
16791
16792 # type: textblock
16793 #. type: textblock
16794 #: ../src/guestfs-actions.pod:5355 ../fish/guestfish-actions.pod:3605
16795 msgid ""
16796 "List all the physical volumes detected.  This is the equivalent of the L<pvs"
16797 "(8)> command."
16798 msgstr ""
16799
16800 # type: textblock
16801 #. type: textblock
16802 #: ../src/guestfs-actions.pod:5358 ../fish/guestfish-actions.pod:3608
16803 msgid ""
16804 "This returns a list of just the device names that contain PVs (eg. C</dev/"
16805 "sda2>)."
16806 msgstr ""
16807
16808 # type: textblock
16809 #. type: textblock
16810 #: ../src/guestfs-actions.pod:5361
16811 msgid "See also C<guestfs_pvs_full>."
16812 msgstr ""
16813
16814 # type: =head2
16815 #. type: =head2
16816 #: ../src/guestfs-actions.pod:5369
16817 msgid "guestfs_pvs_full"
16818 msgstr ""
16819
16820 # type: verbatim
16821 #. type: verbatim
16822 #: ../src/guestfs-actions.pod:5371
16823 #, no-wrap
16824 msgid ""
16825 " struct guestfs_lvm_pv_list *\n"
16826 " guestfs_pvs_full (guestfs_h *g);\n"
16827 "\n"
16828 msgstr ""
16829
16830 # type: textblock
16831 #. type: textblock
16832 #: ../src/guestfs-actions.pod:5374 ../fish/guestfish-actions.pod:3617
16833 msgid ""
16834 "List all the physical volumes detected.  This is the equivalent of the L<pvs"
16835 "(8)> command.  The \"full\" version includes all fields."
16836 msgstr ""
16837
16838 # type: textblock
16839 #. type: textblock
16840 #: ../src/guestfs-actions.pod:5377
16841 msgid ""
16842 "This function returns a C<struct guestfs_lvm_pv_list *>, or NULL if there "
16843 "was an error.  I<The caller must call C<guestfs_free_lvm_pv_list> after use>."
16844 msgstr ""
16845
16846 # type: =head2
16847 #. type: =head2
16848 #: ../src/guestfs-actions.pod:5383
16849 msgid "guestfs_pvuuid"
16850 msgstr ""
16851
16852 # type: verbatim
16853 #. type: verbatim
16854 #: ../src/guestfs-actions.pod:5385
16855 #, no-wrap
16856 msgid ""
16857 " char *\n"
16858 " guestfs_pvuuid (guestfs_h *g,\n"
16859 "                 const char *device);\n"
16860 "\n"
16861 msgstr ""
16862
16863 # type: textblock
16864 #. type: textblock
16865 #: ../src/guestfs-actions.pod:5389 ../fish/guestfish-actions.pod:3624
16866 msgid "This command returns the UUID of the LVM PV C<device>."
16867 msgstr ""
16868
16869 # type: =head2
16870 #. type: =head2
16871 #: ../src/guestfs-actions.pod:5396
16872 msgid "guestfs_pwrite"
16873 msgstr ""
16874
16875 # type: verbatim
16876 #. type: verbatim
16877 #: ../src/guestfs-actions.pod:5398
16878 #, no-wrap
16879 msgid ""
16880 " int\n"
16881 " guestfs_pwrite (guestfs_h *g,\n"
16882 "                 const char *path,\n"
16883 "                 const char *content,\n"
16884 "                 size_t content_size,\n"
16885 "                 int64_t offset);\n"
16886 "\n"
16887 msgstr ""
16888
16889 # type: textblock
16890 #. type: textblock
16891 #: ../src/guestfs-actions.pod:5405 ../fish/guestfish-actions.pod:3630
16892 msgid ""
16893 "This command writes to part of a file.  It writes the data buffer C<content> "
16894 "to the file C<path> starting at offset C<offset>."
16895 msgstr ""
16896
16897 # type: textblock
16898 #. type: textblock
16899 #: ../src/guestfs-actions.pod:5408 ../fish/guestfish-actions.pod:3633
16900 msgid ""
16901 "This command implements the L<pwrite(2)> system call, and like that system "
16902 "call it may not write the full data requested.  The return value is the "
16903 "number of bytes that were actually written to the file.  This could even be "
16904 "0, although short writes are unlikely for regular files in ordinary "
16905 "circumstances."
16906 msgstr ""
16907
16908 # type: textblock
16909 #. type: textblock
16910 #: ../src/guestfs-actions.pod:5414
16911 msgid "See also C<guestfs_pread>, C<guestfs_pwrite_device>."
16912 msgstr ""
16913
16914 # type: =head2
16915 #. type: =head2
16916 #: ../src/guestfs-actions.pod:5423
16917 msgid "guestfs_pwrite_device"
16918 msgstr ""
16919
16920 # type: verbatim
16921 #. type: verbatim
16922 #: ../src/guestfs-actions.pod:5425
16923 #, no-wrap
16924 msgid ""
16925 " int\n"
16926 " guestfs_pwrite_device (guestfs_h *g,\n"
16927 "                        const char *device,\n"
16928 "                        const char *content,\n"
16929 "                        size_t content_size,\n"
16930 "                        int64_t offset);\n"
16931 "\n"
16932 msgstr ""
16933
16934 # type: textblock
16935 #. type: textblock
16936 #: ../src/guestfs-actions.pod:5432 ../fish/guestfish-actions.pod:3648
16937 msgid ""
16938 "This command writes to part of a device.  It writes the data buffer "
16939 "C<content> to C<device> starting at offset C<offset>."
16940 msgstr ""
16941
16942 # type: textblock
16943 #. type: textblock
16944 #: ../src/guestfs-actions.pod:5435 ../fish/guestfish-actions.pod:3651
16945 msgid ""
16946 "This command implements the L<pwrite(2)> system call, and like that system "
16947 "call it may not write the full data requested (although short writes to disk "
16948 "devices and partitions are probably impossible with standard Linux kernels)."
16949 msgstr ""
16950
16951 # type: textblock
16952 #. type: textblock
16953 #: ../src/guestfs-actions.pod:5440
16954 msgid "See also C<guestfs_pwrite>."
16955 msgstr ""
16956
16957 # type: textblock
16958 #. type: textblock
16959 #: ../src/guestfs-actions.pod:5447
16960 msgid "(Added in 1.5.20)"
16961 msgstr ""
16962
16963 # type: =head2
16964 #. type: =head2
16965 #: ../src/guestfs-actions.pod:5449
16966 msgid "guestfs_read_file"
16967 msgstr ""
16968
16969 # type: verbatim
16970 #. type: verbatim
16971 #: ../src/guestfs-actions.pod:5451
16972 #, no-wrap
16973 msgid ""
16974 " char *\n"
16975 " guestfs_read_file (guestfs_h *g,\n"
16976 "                    const char *path,\n"
16977 "                    size_t *size_r);\n"
16978 "\n"
16979 msgstr ""
16980
16981 # type: textblock
16982 #. type: textblock
16983 #: ../src/guestfs-actions.pod:5456 ../fish/guestfish-actions.pod:3665
16984 msgid "This calls returns the contents of the file C<path> as a buffer."
16985 msgstr ""
16986
16987 # type: textblock
16988 #. type: textblock
16989 #: ../src/guestfs-actions.pod:5459
16990 msgid ""
16991 "Unlike C<guestfs_cat>, this function can correctly handle files that contain "
16992 "embedded ASCII NUL characters.  However unlike C<guestfs_download>, this "
16993 "function is limited in the total size of file that can be handled."
16994 msgstr ""
16995
16996 # type: textblock
16997 #. type: textblock
16998 #: ../src/guestfs-actions.pod:5471
16999 msgid "(Added in 1.0.63)"
17000 msgstr ""
17001
17002 # type: =head2
17003 #. type: =head2
17004 #: ../src/guestfs-actions.pod:5473
17005 msgid "guestfs_read_lines"
17006 msgstr ""
17007
17008 # type: verbatim
17009 #. type: verbatim
17010 #: ../src/guestfs-actions.pod:5475
17011 #, no-wrap
17012 msgid ""
17013 " char **\n"
17014 " guestfs_read_lines (guestfs_h *g,\n"
17015 "                     const char *path);\n"
17016 "\n"
17017 msgstr ""
17018
17019 # type: textblock
17020 #. type: textblock
17021 #: ../src/guestfs-actions.pod:5481 ../fish/guestfish-actions.pod:3682
17022 msgid ""
17023 "The file contents are returned as a list of lines.  Trailing C<LF> and "
17024 "C<CRLF> character sequences are I<not> returned."
17025 msgstr ""
17026
17027 # type: textblock
17028 #. type: textblock
17029 #: ../src/guestfs-actions.pod:5484
17030 msgid ""
17031 "Note that this function cannot correctly handle binary files (specifically, "
17032 "files containing C<\\0> character which is treated as end of line).  For "
17033 "those you need to use the C<guestfs_read_file> function which has a more "
17034 "complex interface."
17035 msgstr ""
17036
17037 # type: =head2
17038 #. type: =head2
17039 #: ../src/guestfs-actions.pod:5495
17040 msgid "guestfs_readdir"
17041 msgstr ""
17042
17043 # type: verbatim
17044 #. type: verbatim
17045 #: ../src/guestfs-actions.pod:5497
17046 #, no-wrap
17047 msgid ""
17048 " struct guestfs_dirent_list *\n"
17049 " guestfs_readdir (guestfs_h *g,\n"
17050 "                  const char *dir);\n"
17051 "\n"
17052 msgstr ""
17053
17054 # type: textblock
17055 #. type: textblock
17056 #: ../src/guestfs-actions.pod:5501 ../fish/guestfish-actions.pod:3694
17057 msgid "This returns the list of directory entries in directory C<dir>."
17058 msgstr ""
17059
17060 # type: textblock
17061 #. type: textblock
17062 #: ../src/guestfs-actions.pod:5503 ../fish/guestfish-actions.pod:3696
17063 msgid ""
17064 "All entries in the directory are returned, including C<.> and C<..>.  The "
17065 "entries are I<not> sorted, but returned in the same order as the underlying "
17066 "filesystem."
17067 msgstr ""
17068
17069 # type: textblock
17070 #. type: textblock
17071 #: ../src/guestfs-actions.pod:5507 ../fish/guestfish-actions.pod:3700
17072 msgid ""
17073 "Also this call returns basic file type information about each file.  The "
17074 "C<ftyp> field will contain one of the following characters:"
17075 msgstr ""
17076
17077 # type: =item
17078 #. type: =item
17079 #: ../src/guestfs-actions.pod:5512 ../fish/guestfish-actions.pod:3705
17080 msgid "'b'"
17081 msgstr ""
17082
17083 # type: textblock
17084 #. type: textblock
17085 #: ../src/guestfs-actions.pod:5514 ../fish/guestfish-actions.pod:3707
17086 msgid "Block special"
17087 msgstr ""
17088
17089 # type: =item
17090 #. type: =item
17091 #: ../src/guestfs-actions.pod:5516 ../fish/guestfish-actions.pod:3709
17092 msgid "'c'"
17093 msgstr ""
17094
17095 # type: textblock
17096 #. type: textblock
17097 #: ../src/guestfs-actions.pod:5518 ../fish/guestfish-actions.pod:3711
17098 msgid "Char special"
17099 msgstr ""
17100
17101 # type: =item
17102 #. type: =item
17103 #: ../src/guestfs-actions.pod:5520 ../fish/guestfish-actions.pod:3713
17104 msgid "'d'"
17105 msgstr ""
17106
17107 # type: textblock
17108 #. type: textblock
17109 #: ../src/guestfs-actions.pod:5522 ../fish/guestfish-actions.pod:3715
17110 msgid "Directory"
17111 msgstr ""
17112
17113 # type: =item
17114 #. type: =item
17115 #: ../src/guestfs-actions.pod:5524 ../fish/guestfish-actions.pod:3717
17116 msgid "'f'"
17117 msgstr ""
17118
17119 # type: textblock
17120 #. type: textblock
17121 #: ../src/guestfs-actions.pod:5526 ../fish/guestfish-actions.pod:3719
17122 msgid "FIFO (named pipe)"
17123 msgstr ""
17124
17125 # type: =item
17126 #. type: =item
17127 #: ../src/guestfs-actions.pod:5528 ../fish/guestfish-actions.pod:3721
17128 msgid "'l'"
17129 msgstr ""
17130
17131 # type: textblock
17132 #. type: textblock
17133 #: ../src/guestfs-actions.pod:5530 ../fish/guestfish-actions.pod:3723
17134 msgid "Symbolic link"
17135 msgstr ""
17136
17137 # type: =item
17138 #. type: =item
17139 #: ../src/guestfs-actions.pod:5532 ../fish/guestfish-actions.pod:3725
17140 msgid "'r'"
17141 msgstr ""
17142
17143 # type: textblock
17144 #. type: textblock
17145 #: ../src/guestfs-actions.pod:5534 ../fish/guestfish-actions.pod:3727
17146 msgid "Regular file"
17147 msgstr ""
17148
17149 # type: =item
17150 #. type: =item
17151 #: ../src/guestfs-actions.pod:5536 ../fish/guestfish-actions.pod:3729
17152 msgid "'s'"
17153 msgstr ""
17154
17155 # type: textblock
17156 #. type: textblock
17157 #: ../src/guestfs-actions.pod:5538 ../fish/guestfish-actions.pod:3731
17158 msgid "Socket"
17159 msgstr ""
17160
17161 # type: =item
17162 #. type: =item
17163 #: ../src/guestfs-actions.pod:5540 ../fish/guestfish-actions.pod:3733
17164 msgid "'u'"
17165 msgstr ""
17166
17167 # type: textblock
17168 #. type: textblock
17169 #: ../src/guestfs-actions.pod:5542 ../fish/guestfish-actions.pod:3735
17170 msgid "Unknown file type"
17171 msgstr ""
17172
17173 # type: =item
17174 #. type: =item
17175 #: ../src/guestfs-actions.pod:5544 ../fish/guestfish-actions.pod:3737
17176 msgid "'?'"
17177 msgstr ""
17178
17179 # type: textblock
17180 #. type: textblock
17181 #: ../src/guestfs-actions.pod:5546 ../fish/guestfish-actions.pod:3739
17182 msgid ""
17183 "The L<readdir(3)> call returned a C<d_type> field with an unexpected value"
17184 msgstr ""
17185
17186 # type: textblock
17187 #. type: textblock
17188 #: ../src/guestfs-actions.pod:5551
17189 msgid ""
17190 "This function is primarily intended for use by programs.  To get a simple "
17191 "list of names, use C<guestfs_ls>.  To get a printable directory for human "
17192 "consumption, use C<guestfs_ll>."
17193 msgstr ""
17194
17195 # type: textblock
17196 #. type: textblock
17197 #: ../src/guestfs-actions.pod:5555
17198 msgid ""
17199 "This function returns a C<struct guestfs_dirent_list *>, or NULL if there "
17200 "was an error.  I<The caller must call C<guestfs_free_dirent_list> after use>."
17201 msgstr ""
17202
17203 # type: =head2
17204 #. type: =head2
17205 #: ../src/guestfs-actions.pod:5561
17206 msgid "guestfs_readlink"
17207 msgstr ""
17208
17209 # type: verbatim
17210 #. type: verbatim
17211 #: ../src/guestfs-actions.pod:5563
17212 #, no-wrap
17213 msgid ""
17214 " char *\n"
17215 " guestfs_readlink (guestfs_h *g,\n"
17216 "                   const char *path);\n"
17217 "\n"
17218 msgstr ""
17219
17220 # type: textblock
17221 #. type: textblock
17222 #: ../src/guestfs-actions.pod:5567 ../fish/guestfish-actions.pod:3752
17223 msgid "This command reads the target of a symbolic link."
17224 msgstr ""
17225
17226 # type: =head2
17227 #. type: =head2
17228 #: ../src/guestfs-actions.pod:5574
17229 msgid "guestfs_readlinklist"
17230 msgstr ""
17231
17232 # type: verbatim
17233 #. type: verbatim
17234 #: ../src/guestfs-actions.pod:5576
17235 #, no-wrap
17236 msgid ""
17237 " char **\n"
17238 " guestfs_readlinklist (guestfs_h *g,\n"
17239 "                       const char *path,\n"
17240 "                       char *const *names);\n"
17241 "\n"
17242 msgstr ""
17243
17244 # type: textblock
17245 #. type: textblock
17246 #: ../src/guestfs-actions.pod:5581 ../fish/guestfish-actions.pod:3758
17247 msgid ""
17248 "This call allows you to do a C<readlink> operation on multiple files, where "
17249 "all files are in the directory C<path>.  C<names> is the list of files from "
17250 "this directory."
17251 msgstr ""
17252
17253 # type: textblock
17254 #. type: textblock
17255 #: ../src/guestfs-actions.pod:5585 ../fish/guestfish-actions.pod:3762
17256 msgid ""
17257 "On return you get a list of strings, with a one-to-one correspondence to the "
17258 "C<names> list.  Each string is the value of the symbolic link."
17259 msgstr ""
17260
17261 # type: textblock
17262 #. type: textblock
17263 #: ../src/guestfs-actions.pod:5589 ../fish/guestfish-actions.pod:3766
17264 msgid ""
17265 "If the C<readlink(2)> operation fails on any name, then the corresponding "
17266 "result string is the empty string C<\"\">.  However the whole operation is "
17267 "completed even if there were C<readlink(2)> errors, and so you can call this "
17268 "function with names where you don't know if they are symbolic links already "
17269 "(albeit slightly less efficient)."
17270 msgstr ""
17271
17272 # type: textblock
17273 #. type: textblock
17274 #: ../src/guestfs-actions.pod:5596 ../fish/guestfish-actions.pod:3773
17275 msgid ""
17276 "This call is intended for programs that want to efficiently list a directory "
17277 "contents without making many round-trips.  Very long directory listings "
17278 "might cause the protocol message size to be exceeded, causing this call to "
17279 "fail.  The caller must split up such requests into smaller groups of names."
17280 msgstr ""
17281
17282 # type: =head2
17283 #. type: =head2
17284 #: ../src/guestfs-actions.pod:5609
17285 msgid "guestfs_realpath"
17286 msgstr ""
17287
17288 # type: verbatim
17289 #. type: verbatim
17290 #: ../src/guestfs-actions.pod:5611
17291 #, no-wrap
17292 msgid ""
17293 " char *\n"
17294 " guestfs_realpath (guestfs_h *g,\n"
17295 "                   const char *path);\n"
17296 "\n"
17297 msgstr ""
17298
17299 # type: textblock
17300 #. type: textblock
17301 #: ../src/guestfs-actions.pod:5615 ../fish/guestfish-actions.pod:3784
17302 msgid ""
17303 "Return the canonicalized absolute pathname of C<path>.  The returned path "
17304 "has no C<.>, C<..> or symbolic link path elements."
17305 msgstr ""
17306
17307 # type: =head2
17308 #. type: =head2
17309 #: ../src/guestfs-actions.pod:5623
17310 msgid "guestfs_removexattr"
17311 msgstr ""
17312
17313 # type: verbatim
17314 #. type: verbatim
17315 #: ../src/guestfs-actions.pod:5625
17316 #, no-wrap
17317 msgid ""
17318 " int\n"
17319 " guestfs_removexattr (guestfs_h *g,\n"
17320 "                      const char *xattr,\n"
17321 "                      const char *path);\n"
17322 "\n"
17323 msgstr ""
17324
17325 # type: textblock
17326 #. type: textblock
17327 #: ../src/guestfs-actions.pod:5630 ../fish/guestfish-actions.pod:3791
17328 msgid ""
17329 "This call removes the extended attribute named C<xattr> of the file C<path>."
17330 msgstr ""
17331
17332 # type: textblock
17333 #. type: textblock
17334 #: ../src/guestfs-actions.pod:5633
17335 msgid "See also: C<guestfs_lremovexattr>, L<attr(5)>."
17336 msgstr ""
17337
17338 # type: =head2
17339 #. type: =head2
17340 #: ../src/guestfs-actions.pod:5639
17341 msgid "guestfs_resize2fs"
17342 msgstr ""
17343
17344 # type: verbatim
17345 #. type: verbatim
17346 #: ../src/guestfs-actions.pod:5641
17347 #, no-wrap
17348 msgid ""
17349 " int\n"
17350 " guestfs_resize2fs (guestfs_h *g,\n"
17351 "                    const char *device);\n"
17352 "\n"
17353 msgstr ""
17354
17355 # type: textblock
17356 #. type: textblock
17357 #: ../src/guestfs-actions.pod:5645 ../fish/guestfish-actions.pod:3800
17358 msgid ""
17359 "This resizes an ext2, ext3 or ext4 filesystem to match the size of the "
17360 "underlying device."
17361 msgstr ""
17362
17363 # type: textblock
17364 #. type: textblock
17365 #: ../src/guestfs-actions.pod:5648
17366 msgid ""
17367 "I<Note:> It is sometimes required that you run C<guestfs_e2fsck_f> on the "
17368 "C<device> before calling this command.  For unknown reasons C<resize2fs> "
17369 "sometimes gives an error about this and sometimes not.  In any case, it is "
17370 "always safe to call C<guestfs_e2fsck_f> before calling this function."
17371 msgstr ""
17372
17373 #. type: =head2
17374 #: ../src/guestfs-actions.pod:5658
17375 msgid "guestfs_resize2fs_M"
17376 msgstr ""
17377
17378 #. type: verbatim
17379 #: ../src/guestfs-actions.pod:5660
17380 #, no-wrap
17381 msgid ""
17382 " int\n"
17383 " guestfs_resize2fs_M (guestfs_h *g,\n"
17384 "                      const char *device);\n"
17385 "\n"
17386 msgstr ""
17387
17388 #. type: textblock
17389 #: ../src/guestfs-actions.pod:5664
17390 msgid ""
17391 "This command is the same as C<guestfs_resize2fs>, but the filesystem is "
17392 "resized to its minimum size.  This works like the I<-M> option to the "
17393 "C<resize2fs> command."
17394 msgstr ""
17395
17396 #. type: textblock
17397 #: ../src/guestfs-actions.pod:5668
17398 msgid ""
17399 "To get the resulting size of the filesystem you should call "
17400 "C<guestfs_tune2fs_l> and read the C<Block size> and C<Block count> values.  "
17401 "These two numbers, multiplied together, give the resulting size of the "
17402 "minimal filesystem in bytes."
17403 msgstr ""
17404
17405 # type: =head2
17406 #. type: =head2
17407 #: ../src/guestfs-actions.pod:5675
17408 msgid "guestfs_resize2fs_size"
17409 msgstr ""
17410
17411 # type: verbatim
17412 #. type: verbatim
17413 #: ../src/guestfs-actions.pod:5677
17414 #, no-wrap
17415 msgid ""
17416 " int\n"
17417 " guestfs_resize2fs_size (guestfs_h *g,\n"
17418 "                         const char *device,\n"
17419 "                         int64_t size);\n"
17420 "\n"
17421 msgstr ""
17422
17423 # type: textblock
17424 #. type: textblock
17425 #: ../src/guestfs-actions.pod:5682
17426 msgid ""
17427 "This command is the same as C<guestfs_resize2fs> except that it allows you "
17428 "to specify the new size (in bytes) explicitly."
17429 msgstr ""
17430
17431 # type: =head2
17432 #. type: =head2
17433 #: ../src/guestfs-actions.pod:5689
17434 msgid "guestfs_rm"
17435 msgstr ""
17436
17437 # type: verbatim
17438 #. type: verbatim
17439 #: ../src/guestfs-actions.pod:5691
17440 #, no-wrap
17441 msgid ""
17442 " int\n"
17443 " guestfs_rm (guestfs_h *g,\n"
17444 "             const char *path);\n"
17445 "\n"
17446 msgstr ""
17447
17448 # type: textblock
17449 #. type: textblock
17450 #: ../src/guestfs-actions.pod:5695 ../fish/guestfish-actions.pod:3833
17451 msgid "Remove the single file C<path>."
17452 msgstr ""
17453
17454 # type: =head2
17455 #. type: =head2
17456 #: ../src/guestfs-actions.pod:5701
17457 msgid "guestfs_rm_rf"
17458 msgstr ""
17459
17460 # type: verbatim
17461 #. type: verbatim
17462 #: ../src/guestfs-actions.pod:5703
17463 #, no-wrap
17464 msgid ""
17465 " int\n"
17466 " guestfs_rm_rf (guestfs_h *g,\n"
17467 "                const char *path);\n"
17468 "\n"
17469 msgstr ""
17470
17471 # type: textblock
17472 #. type: textblock
17473 #: ../src/guestfs-actions.pod:5707 ../fish/guestfish-actions.pod:3839
17474 msgid ""
17475 "Remove the file or directory C<path>, recursively removing the contents if "
17476 "its a directory.  This is like the C<rm -rf> shell command."
17477 msgstr ""
17478
17479 # type: =head2
17480 #. type: =head2
17481 #: ../src/guestfs-actions.pod:5715
17482 msgid "guestfs_rmdir"
17483 msgstr ""
17484
17485 # type: verbatim
17486 #. type: verbatim
17487 #: ../src/guestfs-actions.pod:5717
17488 #, no-wrap
17489 msgid ""
17490 " int\n"
17491 " guestfs_rmdir (guestfs_h *g,\n"
17492 "                const char *path);\n"
17493 "\n"
17494 msgstr ""
17495
17496 # type: textblock
17497 #. type: textblock
17498 #: ../src/guestfs-actions.pod:5721 ../fish/guestfish-actions.pod:3847
17499 msgid "Remove the single directory C<path>."
17500 msgstr ""
17501
17502 # type: =head2
17503 #. type: =head2
17504 #: ../src/guestfs-actions.pod:5727
17505 msgid "guestfs_rmmountpoint"
17506 msgstr ""
17507
17508 # type: verbatim
17509 #. type: verbatim
17510 #: ../src/guestfs-actions.pod:5729
17511 #, no-wrap
17512 msgid ""
17513 " int\n"
17514 " guestfs_rmmountpoint (guestfs_h *g,\n"
17515 "                       const char *exemptpath);\n"
17516 "\n"
17517 msgstr ""
17518
17519 # type: textblock
17520 #. type: textblock
17521 #: ../src/guestfs-actions.pod:5733
17522 msgid ""
17523 "This calls removes a mountpoint that was previously created with "
17524 "C<guestfs_mkmountpoint>.  See C<guestfs_mkmountpoint> for full details."
17525 msgstr ""
17526
17527 # type: =head2
17528 #. type: =head2
17529 #: ../src/guestfs-actions.pod:5741
17530 msgid "guestfs_scrub_device"
17531 msgstr ""
17532
17533 # type: verbatim
17534 #. type: verbatim
17535 #: ../src/guestfs-actions.pod:5743
17536 #, no-wrap
17537 msgid ""
17538 " int\n"
17539 " guestfs_scrub_device (guestfs_h *g,\n"
17540 "                       const char *device);\n"
17541 "\n"
17542 msgstr ""
17543
17544 # type: textblock
17545 #. type: textblock
17546 #: ../src/guestfs-actions.pod:5747 ../fish/guestfish-actions.pod:3861
17547 msgid ""
17548 "This command writes patterns over C<device> to make data retrieval more "
17549 "difficult."
17550 msgstr ""
17551
17552 # type: textblock
17553 #. type: textblock
17554 #: ../src/guestfs-actions.pod:5750 ../src/guestfs-actions.pod:5771
17555 #: ../src/guestfs-actions.pod:5790 ../fish/guestfish-actions.pod:3864
17556 #: ../fish/guestfish-actions.pod:3879 ../fish/guestfish-actions.pod:3892
17557 msgid ""
17558 "It is an interface to the L<scrub(1)> program.  See that manual page for "
17559 "more details."
17560 msgstr ""
17561
17562 # type: textblock
17563 #. type: textblock
17564 #: ../src/guestfs-actions.pod:5758 ../src/guestfs-actions.pod:5776
17565 #: ../src/guestfs-actions.pod:5795
17566 msgid "(Added in 1.0.52)"
17567 msgstr ""
17568
17569 # type: =head2
17570 #. type: =head2
17571 #: ../src/guestfs-actions.pod:5760
17572 msgid "guestfs_scrub_file"
17573 msgstr ""
17574
17575 # type: verbatim
17576 #. type: verbatim
17577 #: ../src/guestfs-actions.pod:5762
17578 #, no-wrap
17579 msgid ""
17580 " int\n"
17581 " guestfs_scrub_file (guestfs_h *g,\n"
17582 "                     const char *file);\n"
17583 "\n"
17584 msgstr ""
17585
17586 # type: textblock
17587 #. type: textblock
17588 #: ../src/guestfs-actions.pod:5766 ../fish/guestfish-actions.pod:3874
17589 msgid ""
17590 "This command writes patterns over a file to make data retrieval more "
17591 "difficult."
17592 msgstr ""
17593
17594 # type: textblock
17595 #. type: textblock
17596 #: ../src/guestfs-actions.pod:5769 ../fish/guestfish-actions.pod:3877
17597 msgid "The file is I<removed> after scrubbing."
17598 msgstr ""
17599
17600 # type: =head2
17601 #. type: =head2
17602 #: ../src/guestfs-actions.pod:5778
17603 msgid "guestfs_scrub_freespace"
17604 msgstr ""
17605
17606 # type: verbatim
17607 #. type: verbatim
17608 #: ../src/guestfs-actions.pod:5780
17609 #, no-wrap
17610 msgid ""
17611 " int\n"
17612 " guestfs_scrub_freespace (guestfs_h *g,\n"
17613 "                          const char *dir);\n"
17614 "\n"
17615 msgstr ""
17616
17617 # type: textblock
17618 #. type: textblock
17619 #: ../src/guestfs-actions.pod:5784
17620 msgid ""
17621 "This command creates the directory C<dir> and then fills it with files until "
17622 "the filesystem is full, and scrubs the files as for C<guestfs_scrub_file>, "
17623 "and deletes them.  The intention is to scrub any free space on the partition "
17624 "containing C<dir>."
17625 msgstr ""
17626
17627 # type: =head2
17628 #. type: =head2
17629 #: ../src/guestfs-actions.pod:5797
17630 msgid "guestfs_set_append"
17631 msgstr ""
17632
17633 # type: verbatim
17634 #. type: verbatim
17635 #: ../src/guestfs-actions.pod:5799
17636 #, no-wrap
17637 msgid ""
17638 " int\n"
17639 " guestfs_set_append (guestfs_h *g,\n"
17640 "                     const char *append);\n"
17641 "\n"
17642 msgstr ""
17643
17644 # type: textblock
17645 #. type: textblock
17646 #: ../src/guestfs-actions.pod:5803 ../fish/guestfish-actions.pod:3901
17647 msgid ""
17648 "This function is used to add additional options to the guest kernel command "
17649 "line."
17650 msgstr ""
17651
17652 # type: textblock
17653 #. type: textblock
17654 #: ../src/guestfs-actions.pod:5806 ../fish/guestfish-actions.pod:3904
17655 msgid ""
17656 "The default is C<NULL> unless overridden by setting C<LIBGUESTFS_APPEND> "
17657 "environment variable."
17658 msgstr ""
17659
17660 # type: textblock
17661 #. type: textblock
17662 #: ../src/guestfs-actions.pod:5809 ../fish/guestfish-actions.pod:3907
17663 msgid ""
17664 "Setting C<append> to C<NULL> means I<no> additional options are passed "
17665 "(libguestfs always adds a few of its own)."
17666 msgstr ""
17667
17668 #. type: =head2
17669 #: ../src/guestfs-actions.pod:5816
17670 msgid "guestfs_set_attach_method"
17671 msgstr ""
17672
17673 #. type: verbatim
17674 #: ../src/guestfs-actions.pod:5818
17675 #, no-wrap
17676 msgid ""
17677 " int\n"
17678 " guestfs_set_attach_method (guestfs_h *g,\n"
17679 "                            const char *attachmethod);\n"
17680 "\n"
17681 msgstr ""
17682
17683 #. type: textblock
17684 #: ../src/guestfs-actions.pod:5822 ../fish/guestfish-actions.pod:3916
17685 msgid ""
17686 "Set the method that libguestfs uses to connect to the back end guestfsd "
17687 "daemon.  Possible methods are:"
17688 msgstr ""
17689
17690 #. type: textblock
17691 #: ../src/guestfs-actions.pod:5829 ../fish/guestfish-actions.pod:3923
17692 msgid ""
17693 "Launch an appliance and connect to it.  This is the ordinary method and the "
17694 "default."
17695 msgstr ""
17696
17697 #. type: =item
17698 #: ../src/guestfs-actions.pod:5832 ../fish/guestfish-actions.pod:3926
17699 msgid "C<unix:I<path>>"
17700 msgstr ""
17701
17702 #. type: textblock
17703 #: ../src/guestfs-actions.pod:5834 ../fish/guestfish-actions.pod:3928
17704 msgid "Connect to the Unix domain socket I<path>."
17705 msgstr ""
17706
17707 #. type: textblock
17708 #: ../src/guestfs-actions.pod:5836 ../fish/guestfish-actions.pod:3930
17709 msgid ""
17710 "This method lets you connect to an existing daemon or (using virtio-serial) "
17711 "to a live guest.  For more information, see L<guestfs(3)/ATTACHING TO "
17712 "RUNNING DAEMONS>."
17713 msgstr ""
17714
17715 # type: =head2
17716 #. type: =head2
17717 #: ../src/guestfs-actions.pod:5844
17718 msgid "guestfs_set_autosync"
17719 msgstr ""
17720
17721 # type: verbatim
17722 #. type: verbatim
17723 #: ../src/guestfs-actions.pod:5846
17724 #, no-wrap
17725 msgid ""
17726 " int\n"
17727 " guestfs_set_autosync (guestfs_h *g,\n"
17728 "                       int autosync);\n"
17729 "\n"
17730 msgstr ""
17731
17732 #. type: textblock
17733 #: ../src/guestfs-actions.pod:5850 ../fish/guestfish-actions.pod:3942
17734 msgid ""
17735 "If C<autosync> is true, this enables autosync.  Libguestfs will make a best "
17736 "effort attempt to make filesystems consistent and synchronized when the "
17737 "handle is closed (also if the program exits without closing handles)."
17738 msgstr ""
17739
17740 # type: textblock
17741 #. type: textblock
17742 #: ../src/guestfs-actions.pod:5855 ../fish/guestfish-actions.pod:3947
17743 msgid ""
17744 "This is enabled by default (since libguestfs 1.5.24, previously it was "
17745 "disabled by default)."
17746 msgstr ""
17747
17748 # type: =head2
17749 #. type: =head2
17750 #: ../src/guestfs-actions.pod:5862
17751 msgid "guestfs_set_direct"
17752 msgstr ""
17753
17754 # type: verbatim
17755 #. type: verbatim
17756 #: ../src/guestfs-actions.pod:5864
17757 #, no-wrap
17758 msgid ""
17759 " int\n"
17760 " guestfs_set_direct (guestfs_h *g,\n"
17761 "                     int direct);\n"
17762 "\n"
17763 msgstr ""
17764
17765 # type: textblock
17766 #. type: textblock
17767 #: ../src/guestfs-actions.pod:5868 ../fish/guestfish-actions.pod:3956
17768 msgid ""
17769 "If the direct appliance mode flag is enabled, then stdin and stdout are "
17770 "passed directly through to the appliance once it is launched."
17771 msgstr ""
17772
17773 # type: textblock
17774 #. type: textblock
17775 #: ../src/guestfs-actions.pod:5872
17776 msgid ""
17777 "One consequence of this is that log messages aren't caught by the library "
17778 "and handled by C<guestfs_set_log_message_callback>, but go straight to "
17779 "stdout."
17780 msgstr ""
17781
17782 # type: textblock
17783 #. type: textblock
17784 #: ../src/guestfs-actions.pod:5876 ../fish/guestfish-actions.pod:3964
17785 msgid "You probably don't want to use this unless you know what you are doing."
17786 msgstr ""
17787
17788 # type: textblock
17789 #. type: textblock
17790 #: ../src/guestfs-actions.pod:5879 ../fish/guestfish-actions.pod:3967
17791 msgid "The default is disabled."
17792 msgstr ""
17793
17794 # type: =head2
17795 #. type: =head2
17796 #: ../src/guestfs-actions.pod:5885
17797 msgid "guestfs_set_e2label"
17798 msgstr ""
17799
17800 # type: verbatim
17801 #. type: verbatim
17802 #: ../src/guestfs-actions.pod:5887
17803 #, no-wrap
17804 msgid ""
17805 " int\n"
17806 " guestfs_set_e2label (guestfs_h *g,\n"
17807 "                      const char *device,\n"
17808 "                      const char *label);\n"
17809 "\n"
17810 msgstr ""
17811
17812 # type: textblock
17813 #. type: textblock
17814 #: ../src/guestfs-actions.pod:5892 ../fish/guestfish-actions.pod:3973
17815 msgid ""
17816 "This sets the ext2/3/4 filesystem label of the filesystem on C<device> to "
17817 "C<label>.  Filesystem labels are limited to 16 characters."
17818 msgstr ""
17819
17820 # type: textblock
17821 #. type: textblock
17822 #: ../src/guestfs-actions.pod:5896
17823 msgid ""
17824 "You can use either C<guestfs_tune2fs_l> or C<guestfs_get_e2label> to return "
17825 "the existing label on a filesystem."
17826 msgstr ""
17827
17828 # type: =head2
17829 #. type: =head2
17830 #: ../src/guestfs-actions.pod:5903
17831 msgid "guestfs_set_e2uuid"
17832 msgstr ""
17833
17834 # type: verbatim
17835 #. type: verbatim
17836 #: ../src/guestfs-actions.pod:5905
17837 #, no-wrap
17838 msgid ""
17839 " int\n"
17840 " guestfs_set_e2uuid (guestfs_h *g,\n"
17841 "                     const char *device,\n"
17842 "                     const char *uuid);\n"
17843 "\n"
17844 msgstr ""
17845
17846 # type: textblock
17847 #. type: textblock
17848 #: ../src/guestfs-actions.pod:5910 ../fish/guestfish-actions.pod:3984
17849 msgid ""
17850 "This sets the ext2/3/4 filesystem UUID of the filesystem on C<device> to "
17851 "C<uuid>.  The format of the UUID and alternatives such as C<clear>, "
17852 "C<random> and C<time> are described in the L<tune2fs(8)> manpage."
17853 msgstr ""
17854
17855 # type: textblock
17856 #. type: textblock
17857 #: ../src/guestfs-actions.pod:5915
17858 msgid ""
17859 "You can use either C<guestfs_tune2fs_l> or C<guestfs_get_e2uuid> to return "
17860 "the existing UUID of a filesystem."
17861 msgstr ""
17862
17863 # type: =head2
17864 #. type: =head2
17865 #: ../src/guestfs-actions.pod:5922
17866 msgid "guestfs_set_memsize"
17867 msgstr ""
17868
17869 # type: verbatim
17870 #. type: verbatim
17871 #: ../src/guestfs-actions.pod:5924
17872 #, no-wrap
17873 msgid ""
17874 " int\n"
17875 " guestfs_set_memsize (guestfs_h *g,\n"
17876 "                      int memsize);\n"
17877 "\n"
17878 msgstr ""
17879
17880 # type: textblock
17881 #. type: textblock
17882 #: ../src/guestfs-actions.pod:5928
17883 msgid ""
17884 "This sets the memory size in megabytes allocated to the qemu subprocess.  "
17885 "This only has any effect if called before C<guestfs_launch>."
17886 msgstr ""
17887
17888 # type: textblock
17889 #. type: textblock
17890 #: ../src/guestfs-actions.pod:5932 ../fish/guestfish-actions.pod:4002
17891 msgid ""
17892 "You can also change this by setting the environment variable "
17893 "C<LIBGUESTFS_MEMSIZE> before the handle is created."
17894 msgstr ""
17895
17896 # type: =head2
17897 #. type: =head2
17898 #: ../src/guestfs-actions.pod:5943
17899 msgid "guestfs_set_network"
17900 msgstr ""
17901
17902 # type: verbatim
17903 #. type: verbatim
17904 #: ../src/guestfs-actions.pod:5945
17905 #, no-wrap
17906 msgid ""
17907 " int\n"
17908 " guestfs_set_network (guestfs_h *g,\n"
17909 "                      int network);\n"
17910 "\n"
17911 msgstr ""
17912
17913 # type: textblock
17914 #. type: textblock
17915 #: ../src/guestfs-actions.pod:5949 ../fish/guestfish-actions.pod:4015
17916 msgid ""
17917 "If C<network> is true, then the network is enabled in the libguestfs "
17918 "appliance.  The default is false."
17919 msgstr ""
17920
17921 # type: textblock
17922 #. type: textblock
17923 #: ../src/guestfs-actions.pod:5952 ../fish/guestfish-actions.pod:4018
17924 msgid ""
17925 "This affects whether commands are able to access the network (see L<guestfs"
17926 "(3)/RUNNING COMMANDS>)."
17927 msgstr ""
17928
17929 # type: textblock
17930 #. type: textblock
17931 #: ../src/guestfs-actions.pod:5955
17932 msgid ""
17933 "You must call this before calling C<guestfs_launch>, otherwise it has no "
17934 "effect."
17935 msgstr ""
17936
17937 # type: =head2
17938 #. type: =head2
17939 #: ../src/guestfs-actions.pod:5962
17940 msgid "guestfs_set_path"
17941 msgstr ""
17942
17943 # type: verbatim
17944 #. type: verbatim
17945 #: ../src/guestfs-actions.pod:5964
17946 #, no-wrap
17947 msgid ""
17948 " int\n"
17949 " guestfs_set_path (guestfs_h *g,\n"
17950 "                   const char *searchpath);\n"
17951 "\n"
17952 msgstr ""
17953
17954 # type: textblock
17955 #. type: textblock
17956 #: ../src/guestfs-actions.pod:5968 ../fish/guestfish-actions.pod:4030
17957 msgid "Set the path that libguestfs searches for kernel and initrd.img."
17958 msgstr ""
17959
17960 # type: textblock
17961 #. type: textblock
17962 #: ../src/guestfs-actions.pod:5970 ../fish/guestfish-actions.pod:4032
17963 msgid ""
17964 "The default is C<$libdir/guestfs> unless overridden by setting "
17965 "C<LIBGUESTFS_PATH> environment variable."
17966 msgstr ""
17967
17968 # type: textblock
17969 #. type: textblock
17970 #: ../src/guestfs-actions.pod:5973 ../fish/guestfish-actions.pod:4035
17971 msgid "Setting C<path> to C<NULL> restores the default path."
17972 msgstr ""
17973
17974 # type: =head2
17975 #. type: =head2
17976 #: ../src/guestfs-actions.pod:5979
17977 msgid "guestfs_set_qemu"
17978 msgstr ""
17979
17980 # type: verbatim
17981 #. type: verbatim
17982 #: ../src/guestfs-actions.pod:5981
17983 #, no-wrap
17984 msgid ""
17985 " int\n"
17986 " guestfs_set_qemu (guestfs_h *g,\n"
17987 "                   const char *qemu);\n"
17988 "\n"
17989 msgstr ""
17990
17991 # type: textblock
17992 #. type: textblock
17993 #: ../src/guestfs-actions.pod:5985 ../fish/guestfish-actions.pod:4043
17994 msgid "Set the qemu binary that we will use."
17995 msgstr ""
17996
17997 # type: textblock
17998 #. type: textblock
17999 #: ../src/guestfs-actions.pod:5987 ../fish/guestfish-actions.pod:4045
18000 msgid ""
18001 "The default is chosen when the library was compiled by the configure script."
18002 msgstr ""
18003
18004 # type: textblock
18005 #. type: textblock
18006 #: ../src/guestfs-actions.pod:5990 ../fish/guestfish-actions.pod:4048
18007 msgid ""
18008 "You can also override this by setting the C<LIBGUESTFS_QEMU> environment "
18009 "variable."
18010 msgstr ""
18011
18012 # type: textblock
18013 #. type: textblock
18014 #: ../src/guestfs-actions.pod:5993 ../fish/guestfish-actions.pod:4051
18015 msgid "Setting C<qemu> to C<NULL> restores the default qemu binary."
18016 msgstr ""
18017
18018 # type: textblock
18019 #. type: textblock
18020 #: ../src/guestfs-actions.pod:5995 ../fish/guestfish-actions.pod:4053
18021 msgid ""
18022 "Note that you should call this function as early as possible after creating "
18023 "the handle.  This is because some pre-launch operations depend on testing "
18024 "qemu features (by running C<qemu -help>).  If the qemu binary changes, we "
18025 "don't retest features, and so you might see inconsistent results.  Using the "
18026 "environment variable C<LIBGUESTFS_QEMU> is safest of all since that picks "
18027 "the qemu binary at the same time as the handle is created."
18028 msgstr ""
18029
18030 # type: =head2
18031 #. type: =head2
18032 #: ../src/guestfs-actions.pod:6007
18033 msgid "guestfs_set_recovery_proc"
18034 msgstr ""
18035
18036 # type: verbatim
18037 #. type: verbatim
18038 #: ../src/guestfs-actions.pod:6009
18039 #, no-wrap
18040 msgid ""
18041 " int\n"
18042 " guestfs_set_recovery_proc (guestfs_h *g,\n"
18043 "                            int recoveryproc);\n"
18044 "\n"
18045 msgstr ""
18046
18047 # type: textblock
18048 #. type: textblock
18049 #: ../src/guestfs-actions.pod:6013
18050 msgid ""
18051 "If this is called with the parameter C<false> then C<guestfs_launch> does "
18052 "not create a recovery process.  The purpose of the recovery process is to "
18053 "stop runaway qemu processes in the case where the main program aborts "
18054 "abruptly."
18055 msgstr ""
18056
18057 # type: textblock
18058 #. type: textblock
18059 #: ../src/guestfs-actions.pod:6018
18060 msgid ""
18061 "This only has any effect if called before C<guestfs_launch>, and the default "
18062 "is true."
18063 msgstr ""
18064
18065 # type: textblock
18066 #. type: textblock
18067 #: ../src/guestfs-actions.pod:6021 ../fish/guestfish-actions.pod:4075
18068 msgid ""
18069 "About the only time when you would want to disable this is if the main "
18070 "process will fork itself into the background (\"daemonize\" itself).  In "
18071 "this case the recovery process thinks that the main program has disappeared "
18072 "and so kills qemu, which is not very helpful."
18073 msgstr ""
18074
18075 # type: =head2
18076 #. type: =head2
18077 #: ../src/guestfs-actions.pod:6031
18078 msgid "guestfs_set_selinux"
18079 msgstr ""
18080
18081 # type: verbatim
18082 #. type: verbatim
18083 #: ../src/guestfs-actions.pod:6033
18084 #, no-wrap
18085 msgid ""
18086 " int\n"
18087 " guestfs_set_selinux (guestfs_h *g,\n"
18088 "                      int selinux);\n"
18089 "\n"
18090 msgstr ""
18091
18092 # type: textblock
18093 #. type: textblock
18094 #: ../src/guestfs-actions.pod:6037 ../fish/guestfish-actions.pod:4087
18095 msgid ""
18096 "This sets the selinux flag that is passed to the appliance at boot time.  "
18097 "The default is C<selinux=0> (disabled)."
18098 msgstr ""
18099
18100 # type: textblock
18101 #. type: textblock
18102 #: ../src/guestfs-actions.pod:6040 ../fish/guestfish-actions.pod:4090
18103 msgid ""
18104 "Note that if SELinux is enabled, it is always in Permissive mode "
18105 "(C<enforcing=0>)."
18106 msgstr ""
18107
18108 # type: =head2
18109 #. type: =head2
18110 #: ../src/guestfs-actions.pod:6050
18111 msgid "guestfs_set_trace"
18112 msgstr ""
18113
18114 # type: verbatim
18115 #. type: verbatim
18116 #: ../src/guestfs-actions.pod:6052
18117 #, no-wrap
18118 msgid ""
18119 " int\n"
18120 " guestfs_set_trace (guestfs_h *g,\n"
18121 "                    int trace);\n"
18122 "\n"
18123 msgstr ""
18124
18125 #. type: textblock
18126 #: ../src/guestfs-actions.pod:6056 ../fish/guestfish-actions.pod:4102
18127 msgid ""
18128 "If the command trace flag is set to 1, then libguestfs calls, parameters and "
18129 "return values are traced."
18130 msgstr ""
18131
18132 # type: textblock
18133 #. type: textblock
18134 #: ../src/guestfs-actions.pod:6059 ../fish/guestfish-actions.pod:4105
18135 msgid ""
18136 "If you want to trace C API calls into libguestfs (and other libraries) then "
18137 "possibly a better way is to use the external ltrace(1) command."
18138 msgstr ""
18139
18140 # type: textblock
18141 #. type: textblock
18142 #: ../src/guestfs-actions.pod:6063 ../fish/guestfish-actions.pod:4109
18143 msgid ""
18144 "Command traces are disabled unless the environment variable "
18145 "C<LIBGUESTFS_TRACE> is defined and set to C<1>."
18146 msgstr ""
18147
18148 #. type: textblock
18149 #: ../src/guestfs-actions.pod:6066
18150 msgid ""
18151 "Trace messages are normally sent to C<stderr>, unless you register a "
18152 "callback to send them somewhere else (see C<guestfs_set_event_callback>)."
18153 msgstr ""
18154
18155 # type: =head2
18156 #. type: =head2
18157 #: ../src/guestfs-actions.pod:6074
18158 msgid "guestfs_set_verbose"
18159 msgstr ""
18160
18161 # type: verbatim
18162 #. type: verbatim
18163 #: ../src/guestfs-actions.pod:6076
18164 #, no-wrap
18165 msgid ""
18166 " int\n"
18167 " guestfs_set_verbose (guestfs_h *g,\n"
18168 "                      int verbose);\n"
18169 "\n"
18170 msgstr ""
18171
18172 #. type: textblock
18173 #: ../src/guestfs-actions.pod:6080 ../fish/guestfish-actions.pod:4122
18174 msgid "If C<verbose> is true, this turns on verbose messages."
18175 msgstr ""
18176
18177 # type: textblock
18178 #. type: textblock
18179 #: ../src/guestfs-actions.pod:6082 ../fish/guestfish-actions.pod:4124
18180 msgid ""
18181 "Verbose messages are disabled unless the environment variable "
18182 "C<LIBGUESTFS_DEBUG> is defined and set to C<1>."
18183 msgstr ""
18184
18185 #. type: textblock
18186 #: ../src/guestfs-actions.pod:6085
18187 msgid ""
18188 "Verbose messages are normally sent to C<stderr>, unless you register a "
18189 "callback to send them somewhere else (see C<guestfs_set_event_callback>)."
18190 msgstr ""
18191
18192 # type: =head2
18193 #. type: =head2
18194 #: ../src/guestfs-actions.pod:6093
18195 msgid "guestfs_setcon"
18196 msgstr ""
18197
18198 # type: verbatim
18199 #. type: verbatim
18200 #: ../src/guestfs-actions.pod:6095
18201 #, no-wrap
18202 msgid ""
18203 " int\n"
18204 " guestfs_setcon (guestfs_h *g,\n"
18205 "                 const char *context);\n"
18206 "\n"
18207 msgstr ""
18208
18209 # type: textblock
18210 #. type: textblock
18211 #: ../src/guestfs-actions.pod:6099 ../fish/guestfish-actions.pod:4135
18212 msgid ""
18213 "This sets the SELinux security context of the daemon to the string "
18214 "C<context>."
18215 msgstr ""
18216
18217 # type: textblock
18218 #. type: textblock
18219 #: ../src/guestfs-actions.pod:6102 ../fish/guestfish-actions.pod:4138
18220 msgid "See the documentation about SELINUX in L<guestfs(3)>."
18221 msgstr ""
18222
18223 # type: =head2
18224 #. type: =head2
18225 #: ../src/guestfs-actions.pod:6108
18226 msgid "guestfs_setxattr"
18227 msgstr ""
18228
18229 # type: verbatim
18230 #. type: verbatim
18231 #: ../src/guestfs-actions.pod:6110
18232 #, no-wrap
18233 msgid ""
18234 " int\n"
18235 " guestfs_setxattr (guestfs_h *g,\n"
18236 "                   const char *xattr,\n"
18237 "                   const char *val,\n"
18238 "                   int vallen,\n"
18239 "                   const char *path);\n"
18240 "\n"
18241 msgstr ""
18242
18243 # type: textblock
18244 #. type: textblock
18245 #: ../src/guestfs-actions.pod:6117 ../fish/guestfish-actions.pod:4144
18246 msgid ""
18247 "This call sets the extended attribute named C<xattr> of the file C<path> to "
18248 "the value C<val> (of length C<vallen>).  The value is arbitrary 8 bit data."
18249 msgstr ""
18250
18251 # type: textblock
18252 #. type: textblock
18253 #: ../src/guestfs-actions.pod:6121
18254 msgid "See also: C<guestfs_lsetxattr>, L<attr(5)>."
18255 msgstr ""
18256
18257 # type: =head2
18258 #. type: =head2
18259 #: ../src/guestfs-actions.pod:6127
18260 msgid "guestfs_sfdisk"
18261 msgstr ""
18262
18263 # type: verbatim
18264 #. type: verbatim
18265 #: ../src/guestfs-actions.pod:6129
18266 #, no-wrap
18267 msgid ""
18268 " int\n"
18269 " guestfs_sfdisk (guestfs_h *g,\n"
18270 "                 const char *device,\n"
18271 "                 int cyls,\n"
18272 "                 int heads,\n"
18273 "                 int sectors,\n"
18274 "                 char *const *lines);\n"
18275 "\n"
18276 msgstr ""
18277
18278 # type: textblock
18279 #. type: textblock
18280 #: ../src/guestfs-actions.pod:6137 ../fish/guestfish-actions.pod:4154
18281 msgid ""
18282 "This is a direct interface to the L<sfdisk(8)> program for creating "
18283 "partitions on block devices."
18284 msgstr ""
18285
18286 # type: textblock
18287 #. type: textblock
18288 #: ../src/guestfs-actions.pod:6140 ../fish/guestfish-actions.pod:4157
18289 msgid "C<device> should be a block device, for example C</dev/sda>."
18290 msgstr ""
18291
18292 # type: textblock
18293 #. type: textblock
18294 #: ../src/guestfs-actions.pod:6142 ../fish/guestfish-actions.pod:4159
18295 msgid ""
18296 "C<cyls>, C<heads> and C<sectors> are the number of cylinders, heads and "
18297 "sectors on the device, which are passed directly to sfdisk as the I<-C>, I<-"
18298 "H> and I<-S> parameters.  If you pass C<0> for any of these, then the "
18299 "corresponding parameter is omitted.  Usually for 'large' disks, you can just "
18300 "pass C<0> for these, but for small (floppy-sized) disks, sfdisk (or rather, "
18301 "the kernel) cannot work out the right geometry and you will need to tell it."
18302 msgstr ""
18303
18304 # type: textblock
18305 #. type: textblock
18306 #: ../src/guestfs-actions.pod:6150 ../fish/guestfish-actions.pod:4167
18307 msgid ""
18308 "C<lines> is a list of lines that we feed to C<sfdisk>.  For more information "
18309 "refer to the L<sfdisk(8)> manpage."
18310 msgstr ""
18311
18312 # type: textblock
18313 #. type: textblock
18314 #: ../src/guestfs-actions.pod:6153 ../fish/guestfish-actions.pod:4170
18315 msgid ""
18316 "To create a single partition occupying the whole disk, you would pass "
18317 "C<lines> as a single element list, when the single element being the string "
18318 "C<,> (comma)."
18319 msgstr ""
18320
18321 # type: textblock
18322 #. type: textblock
18323 #: ../src/guestfs-actions.pod:6157
18324 msgid ""
18325 "See also: C<guestfs_sfdisk_l>, C<guestfs_sfdisk_N>, C<guestfs_part_init>"
18326 msgstr ""
18327
18328 #. type: textblock
18329 #: ../src/guestfs-actions.pod:6165 ../src/guestfs-actions.pod:6195
18330 #: ../src/guestfs-actions.pod:6228 ../fish/guestfish-actions.pod:4180
18331 #: ../fish/guestfish-actions.pod:4203 ../fish/guestfish-actions.pod:4225
18332 msgid ""
18333 "This function is deprecated.  In new code, use the C<part_add> call instead."
18334 msgstr ""
18335
18336 # type: =head2
18337 #. type: =head2
18338 #: ../src/guestfs-actions.pod:6174
18339 msgid "guestfs_sfdiskM"
18340 msgstr ""
18341
18342 # type: verbatim
18343 #. type: verbatim
18344 #: ../src/guestfs-actions.pod:6176
18345 #, no-wrap
18346 msgid ""
18347 " int\n"
18348 " guestfs_sfdiskM (guestfs_h *g,\n"
18349 "                  const char *device,\n"
18350 "                  char *const *lines);\n"
18351 "\n"
18352 msgstr ""
18353
18354 # type: textblock
18355 #. type: textblock
18356 #: ../src/guestfs-actions.pod:6181
18357 msgid ""
18358 "This is a simplified interface to the C<guestfs_sfdisk> command, where "
18359 "partition sizes are specified in megabytes only (rounded to the nearest "
18360 "cylinder) and you don't need to specify the cyls, heads and sectors "
18361 "parameters which were rarely if ever used anyway."
18362 msgstr ""
18363
18364 # type: textblock
18365 #. type: textblock
18366 #: ../src/guestfs-actions.pod:6187
18367 msgid ""
18368 "See also: C<guestfs_sfdisk>, the L<sfdisk(8)> manpage and "
18369 "C<guestfs_part_disk>"
18370 msgstr ""
18371
18372 # type: =head2
18373 #. type: =head2
18374 #: ../src/guestfs-actions.pod:6204
18375 msgid "guestfs_sfdisk_N"
18376 msgstr ""
18377
18378 # type: verbatim
18379 #. type: verbatim
18380 #: ../src/guestfs-actions.pod:6206
18381 #, no-wrap
18382 msgid ""
18383 " int\n"
18384 " guestfs_sfdisk_N (guestfs_h *g,\n"
18385 "                   const char *device,\n"
18386 "                   int partnum,\n"
18387 "                   int cyls,\n"
18388 "                   int heads,\n"
18389 "                   int sectors,\n"
18390 "                   const char *line);\n"
18391 "\n"
18392 msgstr ""
18393
18394 # type: textblock
18395 #. type: textblock
18396 #: ../src/guestfs-actions.pod:6215 ../fish/guestfish-actions.pod:4214
18397 msgid ""
18398 "This runs L<sfdisk(8)> option to modify just the single partition C<n> "
18399 "(note: C<n> counts from 1)."
18400 msgstr ""
18401
18402 # type: textblock
18403 #. type: textblock
18404 #: ../src/guestfs-actions.pod:6218
18405 msgid ""
18406 "For other parameters, see C<guestfs_sfdisk>.  You should usually pass C<0> "
18407 "for the cyls/heads/sectors parameters."
18408 msgstr ""
18409
18410 # type: textblock
18411 #. type: textblock
18412 #: ../src/guestfs-actions.pod:6221
18413 msgid "See also: C<guestfs_part_add>"
18414 msgstr ""
18415
18416 # type: =head2
18417 #. type: =head2
18418 #: ../src/guestfs-actions.pod:6237
18419 msgid "guestfs_sfdisk_disk_geometry"
18420 msgstr ""
18421
18422 # type: verbatim
18423 #. type: verbatim
18424 #: ../src/guestfs-actions.pod:6239
18425 #, no-wrap
18426 msgid ""
18427 " char *\n"
18428 " guestfs_sfdisk_disk_geometry (guestfs_h *g,\n"
18429 "                               const char *device);\n"
18430 "\n"
18431 msgstr ""
18432
18433 # type: textblock
18434 #. type: textblock
18435 #: ../src/guestfs-actions.pod:6243
18436 msgid ""
18437 "This displays the disk geometry of C<device> read from the partition table.  "
18438 "Especially in the case where the underlying block device has been resized, "
18439 "this can be different from the kernel's idea of the geometry (see "
18440 "C<guestfs_sfdisk_kernel_geometry>)."
18441 msgstr ""
18442
18443 # type: textblock
18444 #. type: textblock
18445 #: ../src/guestfs-actions.pod:6248 ../src/guestfs-actions.pod:6264
18446 #: ../fish/guestfish-actions.pod:4241 ../fish/guestfish-actions.pod:4250
18447 msgid "The result is in human-readable format, and not designed to be parsed."
18448 msgstr ""
18449
18450 # type: =head2
18451 #. type: =head2
18452 #: ../src/guestfs-actions.pod:6256
18453 msgid "guestfs_sfdisk_kernel_geometry"
18454 msgstr ""
18455
18456 # type: verbatim
18457 #. type: verbatim
18458 #: ../src/guestfs-actions.pod:6258
18459 #, no-wrap
18460 msgid ""
18461 " char *\n"
18462 " guestfs_sfdisk_kernel_geometry (guestfs_h *g,\n"
18463 "                                 const char *device);\n"
18464 "\n"
18465 msgstr ""
18466
18467 # type: textblock
18468 #. type: textblock
18469 #: ../src/guestfs-actions.pod:6262 ../fish/guestfish-actions.pod:4248
18470 msgid "This displays the kernel's idea of the geometry of C<device>."
18471 msgstr ""
18472
18473 # type: =head2
18474 #. type: =head2
18475 #: ../src/guestfs-actions.pod:6272
18476 msgid "guestfs_sfdisk_l"
18477 msgstr ""
18478
18479 # type: verbatim
18480 #. type: verbatim
18481 #: ../src/guestfs-actions.pod:6274
18482 #, no-wrap
18483 msgid ""
18484 " char *\n"
18485 " guestfs_sfdisk_l (guestfs_h *g,\n"
18486 "                   const char *device);\n"
18487 "\n"
18488 msgstr ""
18489
18490 # type: textblock
18491 #. type: textblock
18492 #: ../src/guestfs-actions.pod:6278 ../fish/guestfish-actions.pod:4257
18493 msgid ""
18494 "This displays the partition table on C<device>, in the human-readable output "
18495 "of the L<sfdisk(8)> command.  It is not intended to be parsed."
18496 msgstr ""
18497
18498 # type: textblock
18499 #. type: textblock
18500 #: ../src/guestfs-actions.pod:6282
18501 msgid "See also: C<guestfs_part_list>"
18502 msgstr ""
18503
18504 #. type: textblock
18505 #: ../src/guestfs-actions.pod:6287 ../fish/guestfish-actions.pod:4263
18506 msgid ""
18507 "This function is deprecated.  In new code, use the C<part_list> call instead."
18508 msgstr ""
18509
18510 # type: =head2
18511 #. type: =head2
18512 #: ../src/guestfs-actions.pod:6296
18513 msgid "guestfs_sh"
18514 msgstr ""
18515
18516 # type: verbatim
18517 #. type: verbatim
18518 #: ../src/guestfs-actions.pod:6298
18519 #, no-wrap
18520 msgid ""
18521 " char *\n"
18522 " guestfs_sh (guestfs_h *g,\n"
18523 "             const char *command);\n"
18524 "\n"
18525 msgstr ""
18526
18527 # type: textblock
18528 #. type: textblock
18529 #: ../src/guestfs-actions.pod:6302 ../fish/guestfish-actions.pod:4274
18530 msgid ""
18531 "This call runs a command from the guest filesystem via the guest's C</bin/"
18532 "sh>."
18533 msgstr ""
18534
18535 # type: textblock
18536 #. type: textblock
18537 #: ../src/guestfs-actions.pod:6305
18538 msgid "This is like C<guestfs_command>, but passes the command to:"
18539 msgstr ""
18540
18541 # type: verbatim
18542 #. type: verbatim
18543 #: ../src/guestfs-actions.pod:6307 ../fish/guestfish-actions.pod:4279
18544 #, no-wrap
18545 msgid ""
18546 " /bin/sh -c \"command\"\n"
18547 "\n"
18548 msgstr ""
18549
18550 # type: textblock
18551 #. type: textblock
18552 #: ../src/guestfs-actions.pod:6309 ../fish/guestfish-actions.pod:4281
18553 msgid ""
18554 "Depending on the guest's shell, this usually results in wildcards being "
18555 "expanded, shell expressions being interpolated and so on."
18556 msgstr ""
18557
18558 # type: textblock
18559 #. type: textblock
18560 #: ../src/guestfs-actions.pod:6313
18561 msgid "All the provisos about C<guestfs_command> apply to this call."
18562 msgstr ""
18563
18564 # type: =head2
18565 #. type: =head2
18566 #: ../src/guestfs-actions.pod:6320
18567 msgid "guestfs_sh_lines"
18568 msgstr ""
18569
18570 # type: verbatim
18571 #. type: verbatim
18572 #: ../src/guestfs-actions.pod:6322
18573 #, no-wrap
18574 msgid ""
18575 " char **\n"
18576 " guestfs_sh_lines (guestfs_h *g,\n"
18577 "                   const char *command);\n"
18578 "\n"
18579 msgstr ""
18580
18581 # type: textblock
18582 #. type: textblock
18583 #: ../src/guestfs-actions.pod:6326
18584 msgid ""
18585 "This is the same as C<guestfs_sh>, but splits the result into a list of "
18586 "lines."
18587 msgstr ""
18588
18589 # type: textblock
18590 #. type: textblock
18591 #: ../src/guestfs-actions.pod:6329
18592 msgid "See also: C<guestfs_command_lines>"
18593 msgstr ""
18594
18595 # type: =head2
18596 #. type: =head2
18597 #: ../src/guestfs-actions.pod:6337
18598 msgid "guestfs_sleep"
18599 msgstr ""
18600
18601 # type: verbatim
18602 #. type: verbatim
18603 #: ../src/guestfs-actions.pod:6339
18604 #, no-wrap
18605 msgid ""
18606 " int\n"
18607 " guestfs_sleep (guestfs_h *g,\n"
18608 "                int secs);\n"
18609 "\n"
18610 msgstr ""
18611
18612 # type: textblock
18613 #. type: textblock
18614 #: ../src/guestfs-actions.pod:6343 ../fish/guestfish-actions.pod:4300
18615 msgid "Sleep for C<secs> seconds."
18616 msgstr ""
18617
18618 # type: textblock
18619 #. type: textblock
18620 #: ../src/guestfs-actions.pod:6347
18621 msgid "(Added in 1.0.41)"
18622 msgstr ""
18623
18624 # type: =head2
18625 #. type: =head2
18626 #: ../src/guestfs-actions.pod:6349 ../src/guestfs-structs.pod:109
18627 msgid "guestfs_stat"
18628 msgstr ""
18629
18630 # type: verbatim
18631 #. type: verbatim
18632 #: ../src/guestfs-actions.pod:6351
18633 #, no-wrap
18634 msgid ""
18635 " struct guestfs_stat *\n"
18636 " guestfs_stat (guestfs_h *g,\n"
18637 "               const char *path);\n"
18638 "\n"
18639 msgstr ""
18640
18641 # type: textblock
18642 #. type: textblock
18643 #: ../src/guestfs-actions.pod:6357 ../fish/guestfish-actions.pod:4308
18644 msgid "This is the same as the C<stat(2)> system call."
18645 msgstr ""
18646
18647 # type: =head2
18648 #. type: =head2
18649 #: ../src/guestfs-actions.pod:6365 ../src/guestfs-structs.pod:135
18650 msgid "guestfs_statvfs"
18651 msgstr ""
18652
18653 # type: verbatim
18654 #. type: verbatim
18655 #: ../src/guestfs-actions.pod:6367
18656 #, no-wrap
18657 msgid ""
18658 " struct guestfs_statvfs *\n"
18659 " guestfs_statvfs (guestfs_h *g,\n"
18660 "                  const char *path);\n"
18661 "\n"
18662 msgstr ""
18663
18664 # type: textblock
18665 #. type: textblock
18666 #: ../src/guestfs-actions.pod:6371 ../fish/guestfish-actions.pod:4314
18667 msgid ""
18668 "Returns file system statistics for any mounted file system.  C<path> should "
18669 "be a file or directory in the mounted file system (typically it is the mount "
18670 "point itself, but it doesn't need to be)."
18671 msgstr ""
18672
18673 # type: textblock
18674 #. type: textblock
18675 #: ../src/guestfs-actions.pod:6375 ../fish/guestfish-actions.pod:4318
18676 msgid "This is the same as the C<statvfs(2)> system call."
18677 msgstr ""
18678
18679 # type: textblock
18680 #. type: textblock
18681 #: ../src/guestfs-actions.pod:6377
18682 msgid ""
18683 "This function returns a C<struct guestfs_statvfs *>, or NULL if there was an "
18684 "error.  I<The caller must call C<guestfs_free_statvfs> after use>."
18685 msgstr ""
18686
18687 # type: =head2
18688 #. type: =head2
18689 #: ../src/guestfs-actions.pod:6383
18690 msgid "guestfs_strings"
18691 msgstr ""
18692
18693 # type: verbatim
18694 #. type: verbatim
18695 #: ../src/guestfs-actions.pod:6385
18696 #, no-wrap
18697 msgid ""
18698 " char **\n"
18699 " guestfs_strings (guestfs_h *g,\n"
18700 "                  const char *path);\n"
18701 "\n"
18702 msgstr ""
18703
18704 # type: textblock
18705 #. type: textblock
18706 #: ../src/guestfs-actions.pod:6389 ../fish/guestfish-actions.pod:4324
18707 msgid ""
18708 "This runs the L<strings(1)> command on a file and returns the list of "
18709 "printable strings found."
18710 msgstr ""
18711
18712 # type: =head2
18713 #. type: =head2
18714 #: ../src/guestfs-actions.pod:6401
18715 msgid "guestfs_strings_e"
18716 msgstr ""
18717
18718 # type: verbatim
18719 #. type: verbatim
18720 #: ../src/guestfs-actions.pod:6403
18721 #, no-wrap
18722 msgid ""
18723 " char **\n"
18724 " guestfs_strings_e (guestfs_h *g,\n"
18725 "                    const char *encoding,\n"
18726 "                    const char *path);\n"
18727 "\n"
18728 msgstr ""
18729
18730 # type: textblock
18731 #. type: textblock
18732 #: ../src/guestfs-actions.pod:6408
18733 msgid ""
18734 "This is like the C<guestfs_strings> command, but allows you to specify the "
18735 "encoding of strings that are looked for in the source file C<path>."
18736 msgstr ""
18737
18738 # type: textblock
18739 #. type: textblock
18740 #: ../src/guestfs-actions.pod:6412 ../fish/guestfish-actions.pod:4338
18741 msgid "Allowed encodings are:"
18742 msgstr ""
18743
18744 # type: =item
18745 #. type: =item
18746 #: ../src/guestfs-actions.pod:6416 ../fish/guestfish-actions.pod:4342
18747 msgid "s"
18748 msgstr ""
18749
18750 # type: textblock
18751 #. type: textblock
18752 #: ../src/guestfs-actions.pod:6418
18753 msgid ""
18754 "Single 7-bit-byte characters like ASCII and the ASCII-compatible parts of "
18755 "ISO-8859-X (this is what C<guestfs_strings> uses)."
18756 msgstr ""
18757
18758 # type: =item
18759 #. type: =item
18760 #: ../src/guestfs-actions.pod:6421 ../fish/guestfish-actions.pod:4347
18761 msgid "S"
18762 msgstr ""
18763
18764 # type: textblock
18765 #. type: textblock
18766 #: ../src/guestfs-actions.pod:6423 ../fish/guestfish-actions.pod:4349
18767 msgid "Single 8-bit-byte characters."
18768 msgstr ""
18769
18770 # type: =item
18771 #. type: =item
18772 #: ../src/guestfs-actions.pod:6425 ../fish/guestfish-actions.pod:4351
18773 msgid "b"
18774 msgstr ""
18775
18776 # type: textblock
18777 #. type: textblock
18778 #: ../src/guestfs-actions.pod:6427 ../fish/guestfish-actions.pod:4353
18779 msgid "16-bit big endian strings such as those encoded in UTF-16BE or UCS-2BE."
18780 msgstr ""
18781
18782 # type: =item
18783 #. type: =item
18784 #: ../src/guestfs-actions.pod:6430 ../fish/guestfish-actions.pod:4356
18785 msgid "l (lower case letter L)"
18786 msgstr ""
18787
18788 # type: textblock
18789 #. type: textblock
18790 #: ../src/guestfs-actions.pod:6432 ../fish/guestfish-actions.pod:4358
18791 msgid ""
18792 "16-bit little endian such as UTF-16LE and UCS-2LE.  This is useful for "
18793 "examining binaries in Windows guests."
18794 msgstr ""
18795
18796 # type: =item
18797 #. type: =item
18798 #: ../src/guestfs-actions.pod:6435 ../fish/guestfish-actions.pod:4361
18799 msgid "B"
18800 msgstr ""
18801
18802 # type: textblock
18803 #. type: textblock
18804 #: ../src/guestfs-actions.pod:6437 ../fish/guestfish-actions.pod:4363
18805 msgid "32-bit big endian such as UCS-4BE."
18806 msgstr ""
18807
18808 # type: =item
18809 #. type: =item
18810 #: ../src/guestfs-actions.pod:6439 ../fish/guestfish-actions.pod:4365
18811 msgid "L"
18812 msgstr ""
18813
18814 # type: textblock
18815 #. type: textblock
18816 #: ../src/guestfs-actions.pod:6441 ../fish/guestfish-actions.pod:4367
18817 msgid "32-bit little endian such as UCS-4LE."
18818 msgstr ""
18819
18820 # type: textblock
18821 #. type: textblock
18822 #: ../src/guestfs-actions.pod:6445 ../fish/guestfish-actions.pod:4371
18823 msgid "The returned strings are transcoded to UTF-8."
18824 msgstr ""
18825
18826 # type: =head2
18827 #. type: =head2
18828 #: ../src/guestfs-actions.pod:6456
18829 msgid "guestfs_swapoff_device"
18830 msgstr ""
18831
18832 # type: verbatim
18833 #. type: verbatim
18834 #: ../src/guestfs-actions.pod:6458
18835 #, no-wrap
18836 msgid ""
18837 " int\n"
18838 " guestfs_swapoff_device (guestfs_h *g,\n"
18839 "                         const char *device);\n"
18840 "\n"
18841 msgstr ""
18842
18843 # type: textblock
18844 #. type: textblock
18845 #: ../src/guestfs-actions.pod:6462
18846 msgid ""
18847 "This command disables the libguestfs appliance swap device or partition "
18848 "named C<device>.  See C<guestfs_swapon_device>."
18849 msgstr ""
18850
18851 # type: =head2
18852 #. type: =head2
18853 #: ../src/guestfs-actions.pod:6470
18854 msgid "guestfs_swapoff_file"
18855 msgstr ""
18856
18857 # type: verbatim
18858 #. type: verbatim
18859 #: ../src/guestfs-actions.pod:6472
18860 #, no-wrap
18861 msgid ""
18862 " int\n"
18863 " guestfs_swapoff_file (guestfs_h *g,\n"
18864 "                       const char *file);\n"
18865 "\n"
18866 msgstr ""
18867
18868 # type: textblock
18869 #. type: textblock
18870 #: ../src/guestfs-actions.pod:6476 ../fish/guestfish-actions.pod:4388
18871 msgid "This command disables the libguestfs appliance swap on file."
18872 msgstr ""
18873
18874 # type: =head2
18875 #. type: =head2
18876 #: ../src/guestfs-actions.pod:6482
18877 msgid "guestfs_swapoff_label"
18878 msgstr ""
18879
18880 # type: verbatim
18881 #. type: verbatim
18882 #: ../src/guestfs-actions.pod:6484
18883 #, no-wrap
18884 msgid ""
18885 " int\n"
18886 " guestfs_swapoff_label (guestfs_h *g,\n"
18887 "                        const char *label);\n"
18888 "\n"
18889 msgstr ""
18890
18891 # type: textblock
18892 #. type: textblock
18893 #: ../src/guestfs-actions.pod:6488 ../fish/guestfish-actions.pod:4394
18894 msgid ""
18895 "This command disables the libguestfs appliance swap on labeled swap "
18896 "partition."
18897 msgstr ""
18898
18899 # type: =head2
18900 #. type: =head2
18901 #: ../src/guestfs-actions.pod:6495
18902 msgid "guestfs_swapoff_uuid"
18903 msgstr ""
18904
18905 # type: verbatim
18906 #. type: verbatim
18907 #: ../src/guestfs-actions.pod:6497
18908 #, no-wrap
18909 msgid ""
18910 " int\n"
18911 " guestfs_swapoff_uuid (guestfs_h *g,\n"
18912 "                       const char *uuid);\n"
18913 "\n"
18914 msgstr ""
18915
18916 # type: textblock
18917 #. type: textblock
18918 #: ../src/guestfs-actions.pod:6501 ../fish/guestfish-actions.pod:4401
18919 msgid ""
18920 "This command disables the libguestfs appliance swap partition with the given "
18921 "UUID."
18922 msgstr ""
18923
18924 # type: =head2
18925 #. type: =head2
18926 #: ../src/guestfs-actions.pod:6508
18927 msgid "guestfs_swapon_device"
18928 msgstr ""
18929
18930 # type: verbatim
18931 #. type: verbatim
18932 #: ../src/guestfs-actions.pod:6510
18933 #, no-wrap
18934 msgid ""
18935 " int\n"
18936 " guestfs_swapon_device (guestfs_h *g,\n"
18937 "                        const char *device);\n"
18938 "\n"
18939 msgstr ""
18940
18941 # type: textblock
18942 #. type: textblock
18943 #: ../src/guestfs-actions.pod:6514
18944 msgid ""
18945 "This command enables the libguestfs appliance to use the swap device or "
18946 "partition named C<device>.  The increased memory is made available for all "
18947 "commands, for example those run using C<guestfs_command> or C<guestfs_sh>."
18948 msgstr ""
18949
18950 # type: textblock
18951 #. type: textblock
18952 #: ../src/guestfs-actions.pod:6519 ../fish/guestfish-actions.pod:4413
18953 msgid ""
18954 "Note that you should not swap to existing guest swap partitions unless you "
18955 "know what you are doing.  They may contain hibernation information, or other "
18956 "information that the guest doesn't want you to trash.  You also risk leaking "
18957 "information about the host to the guest this way.  Instead, attach a new "
18958 "host device to the guest and swap on that."
18959 msgstr ""
18960
18961 # type: =head2
18962 #. type: =head2
18963 #: ../src/guestfs-actions.pod:6530
18964 msgid "guestfs_swapon_file"
18965 msgstr ""
18966
18967 # type: verbatim
18968 #. type: verbatim
18969 #: ../src/guestfs-actions.pod:6532
18970 #, no-wrap
18971 msgid ""
18972 " int\n"
18973 " guestfs_swapon_file (guestfs_h *g,\n"
18974 "                      const char *file);\n"
18975 "\n"
18976 msgstr ""
18977
18978 # type: textblock
18979 #. type: textblock
18980 #: ../src/guestfs-actions.pod:6536
18981 msgid ""
18982 "This command enables swap to a file.  See C<guestfs_swapon_device> for other "
18983 "notes."
18984 msgstr ""
18985
18986 # type: =head2
18987 #. type: =head2
18988 #: ../src/guestfs-actions.pod:6543
18989 msgid "guestfs_swapon_label"
18990 msgstr ""
18991
18992 # type: verbatim
18993 #. type: verbatim
18994 #: ../src/guestfs-actions.pod:6545
18995 #, no-wrap
18996 msgid ""
18997 " int\n"
18998 " guestfs_swapon_label (guestfs_h *g,\n"
18999 "                       const char *label);\n"
19000 "\n"
19001 msgstr ""
19002
19003 # type: textblock
19004 #. type: textblock
19005 #: ../src/guestfs-actions.pod:6549
19006 msgid ""
19007 "This command enables swap to a labeled swap partition.  See "
19008 "C<guestfs_swapon_device> for other notes."
19009 msgstr ""
19010
19011 # type: =head2
19012 #. type: =head2
19013 #: ../src/guestfs-actions.pod:6556
19014 msgid "guestfs_swapon_uuid"
19015 msgstr ""
19016
19017 # type: verbatim
19018 #. type: verbatim
19019 #: ../src/guestfs-actions.pod:6558
19020 #, no-wrap
19021 msgid ""
19022 " int\n"
19023 " guestfs_swapon_uuid (guestfs_h *g,\n"
19024 "                      const char *uuid);\n"
19025 "\n"
19026 msgstr ""
19027
19028 # type: textblock
19029 #. type: textblock
19030 #: ../src/guestfs-actions.pod:6562
19031 msgid ""
19032 "This command enables swap to a swap partition with the given UUID.  See "
19033 "C<guestfs_swapon_device> for other notes."
19034 msgstr ""
19035
19036 # type: =head2
19037 #. type: =head2
19038 #: ../src/guestfs-actions.pod:6569
19039 msgid "guestfs_sync"
19040 msgstr ""
19041
19042 # type: verbatim
19043 #. type: verbatim
19044 #: ../src/guestfs-actions.pod:6571
19045 #, no-wrap
19046 msgid ""
19047 " int\n"
19048 " guestfs_sync (guestfs_h *g);\n"
19049 "\n"
19050 msgstr ""
19051
19052 # type: textblock
19053 #. type: textblock
19054 #: ../src/guestfs-actions.pod:6574 ../fish/guestfish-actions.pod:4445
19055 msgid ""
19056 "This syncs the disk, so that any writes are flushed through to the "
19057 "underlying disk image."
19058 msgstr ""
19059
19060 # type: textblock
19061 #. type: textblock
19062 #: ../src/guestfs-actions.pod:6577 ../fish/guestfish-actions.pod:4448
19063 msgid ""
19064 "You should always call this if you have modified a disk image, before "
19065 "closing the handle."
19066 msgstr ""
19067
19068 # type: =head2
19069 #. type: =head2
19070 #: ../src/guestfs-actions.pod:6584
19071 msgid "guestfs_tail"
19072 msgstr ""
19073
19074 # type: verbatim
19075 #. type: verbatim
19076 #: ../src/guestfs-actions.pod:6586
19077 #, no-wrap
19078 msgid ""
19079 " char **\n"
19080 " guestfs_tail (guestfs_h *g,\n"
19081 "               const char *path);\n"
19082 "\n"
19083 msgstr ""
19084
19085 # type: textblock
19086 #. type: textblock
19087 #: ../src/guestfs-actions.pod:6590 ../fish/guestfish-actions.pod:4455
19088 msgid ""
19089 "This command returns up to the last 10 lines of a file as a list of strings."
19090 msgstr ""
19091
19092 # type: =head2
19093 #. type: =head2
19094 #: ../src/guestfs-actions.pod:6602
19095 msgid "guestfs_tail_n"
19096 msgstr ""
19097
19098 # type: verbatim
19099 #. type: verbatim
19100 #: ../src/guestfs-actions.pod:6604
19101 #, no-wrap
19102 msgid ""
19103 " char **\n"
19104 " guestfs_tail_n (guestfs_h *g,\n"
19105 "                 int nrlines,\n"
19106 "                 const char *path);\n"
19107 "\n"
19108 msgstr ""
19109
19110 # type: textblock
19111 #. type: textblock
19112 #: ../src/guestfs-actions.pod:6609 ../fish/guestfish-actions.pod:4465
19113 msgid ""
19114 "If the parameter C<nrlines> is a positive number, this returns the last "
19115 "C<nrlines> lines of the file C<path>."
19116 msgstr ""
19117
19118 # type: textblock
19119 #. type: textblock
19120 #: ../src/guestfs-actions.pod:6612 ../fish/guestfish-actions.pod:4468
19121 msgid ""
19122 "If the parameter C<nrlines> is a negative number, this returns lines from "
19123 "the file C<path>, starting with the C<-nrlines>th line."
19124 msgstr ""
19125
19126 # type: =head2
19127 #. type: =head2
19128 #: ../src/guestfs-actions.pod:6626
19129 msgid "guestfs_tar_in"
19130 msgstr ""
19131
19132 # type: verbatim
19133 #. type: verbatim
19134 #: ../src/guestfs-actions.pod:6628
19135 #, no-wrap
19136 msgid ""
19137 " int\n"
19138 " guestfs_tar_in (guestfs_h *g,\n"
19139 "                 const char *tarfile,\n"
19140 "                 const char *directory);\n"
19141 "\n"
19142 msgstr ""
19143
19144 # type: textblock
19145 #. type: textblock
19146 #: ../src/guestfs-actions.pod:6633 ../fish/guestfish-actions.pod:4480
19147 msgid ""
19148 "This command uploads and unpacks local file C<tarfile> (an I<uncompressed> "
19149 "tar file) into C<directory>."
19150 msgstr ""
19151
19152 # type: textblock
19153 #. type: textblock
19154 #: ../src/guestfs-actions.pod:6636
19155 msgid ""
19156 "To upload a compressed tarball, use C<guestfs_tgz_in> or C<guestfs_txz_in>."
19157 msgstr ""
19158
19159 # type: textblock
19160 #. type: textblock
19161 #: ../src/guestfs-actions.pod:6641 ../src/guestfs-actions.pod:6658
19162 #: ../src/guestfs-actions.pod:6674 ../src/guestfs-actions.pod:6690
19163 msgid "(Added in 1.0.3)"
19164 msgstr ""
19165
19166 # type: =head2
19167 #. type: =head2
19168 #: ../src/guestfs-actions.pod:6643
19169 msgid "guestfs_tar_out"
19170 msgstr ""
19171
19172 # type: verbatim
19173 #. type: verbatim
19174 #: ../src/guestfs-actions.pod:6645
19175 #, no-wrap
19176 msgid ""
19177 " int\n"
19178 " guestfs_tar_out (guestfs_h *g,\n"
19179 "                  const char *directory,\n"
19180 "                  const char *tarfile);\n"
19181 "\n"
19182 msgstr ""
19183
19184 # type: textblock
19185 #. type: textblock
19186 #: ../src/guestfs-actions.pod:6650 ../fish/guestfish-actions.pod:4492
19187 msgid ""
19188 "This command packs the contents of C<directory> and downloads it to local "
19189 "file C<tarfile>."
19190 msgstr ""
19191
19192 # type: textblock
19193 #. type: textblock
19194 #: ../src/guestfs-actions.pod:6653
19195 msgid ""
19196 "To download a compressed tarball, use C<guestfs_tgz_out> or "
19197 "C<guestfs_txz_out>."
19198 msgstr ""
19199
19200 # type: =head2
19201 #. type: =head2
19202 #: ../src/guestfs-actions.pod:6660
19203 msgid "guestfs_tgz_in"
19204 msgstr ""
19205
19206 # type: verbatim
19207 #. type: verbatim
19208 #: ../src/guestfs-actions.pod:6662
19209 #, no-wrap
19210 msgid ""
19211 " int\n"
19212 " guestfs_tgz_in (guestfs_h *g,\n"
19213 "                 const char *tarball,\n"
19214 "                 const char *directory);\n"
19215 "\n"
19216 msgstr ""
19217
19218 # type: textblock
19219 #. type: textblock
19220 #: ../src/guestfs-actions.pod:6667 ../fish/guestfish-actions.pod:4504
19221 msgid ""
19222 "This command uploads and unpacks local file C<tarball> (a I<gzip compressed> "
19223 "tar file) into C<directory>."
19224 msgstr ""
19225
19226 # type: textblock
19227 #. type: textblock
19228 #: ../src/guestfs-actions.pod:6670
19229 msgid "To upload an uncompressed tarball, use C<guestfs_tar_in>."
19230 msgstr ""
19231
19232 # type: =head2
19233 #. type: =head2
19234 #: ../src/guestfs-actions.pod:6676
19235 msgid "guestfs_tgz_out"
19236 msgstr ""
19237
19238 # type: verbatim
19239 #. type: verbatim
19240 #: ../src/guestfs-actions.pod:6678
19241 #, no-wrap
19242 msgid ""
19243 " int\n"
19244 " guestfs_tgz_out (guestfs_h *g,\n"
19245 "                  const char *directory,\n"
19246 "                  const char *tarball);\n"
19247 "\n"
19248 msgstr ""
19249
19250 # type: textblock
19251 #. type: textblock
19252 #: ../src/guestfs-actions.pod:6683 ../fish/guestfish-actions.pod:4515
19253 msgid ""
19254 "This command packs the contents of C<directory> and downloads it to local "
19255 "file C<tarball>."
19256 msgstr ""
19257
19258 # type: textblock
19259 #. type: textblock
19260 #: ../src/guestfs-actions.pod:6686
19261 msgid "To download an uncompressed tarball, use C<guestfs_tar_out>."
19262 msgstr ""
19263
19264 # type: =head2
19265 #. type: =head2
19266 #: ../src/guestfs-actions.pod:6692
19267 msgid "guestfs_touch"
19268 msgstr ""
19269
19270 # type: verbatim
19271 #. type: verbatim
19272 #: ../src/guestfs-actions.pod:6694
19273 #, no-wrap
19274 msgid ""
19275 " int\n"
19276 " guestfs_touch (guestfs_h *g,\n"
19277 "                const char *path);\n"
19278 "\n"
19279 msgstr ""
19280
19281 # type: textblock
19282 #. type: textblock
19283 #: ../src/guestfs-actions.pod:6698 ../fish/guestfish-actions.pod:4526
19284 msgid ""
19285 "Touch acts like the L<touch(1)> command.  It can be used to update the "
19286 "timestamps on a file, or, if the file does not exist, to create a new zero-"
19287 "length file."
19288 msgstr ""
19289
19290 # type: textblock
19291 #. type: textblock
19292 #: ../src/guestfs-actions.pod:6702 ../fish/guestfish-actions.pod:4530
19293 msgid ""
19294 "This command only works on regular files, and will fail on other file types "
19295 "such as directories, symbolic links, block special etc."
19296 msgstr ""
19297
19298 # type: =head2
19299 #. type: =head2
19300 #: ../src/guestfs-actions.pod:6709
19301 msgid "guestfs_truncate"
19302 msgstr ""
19303
19304 # type: verbatim
19305 #. type: verbatim
19306 #: ../src/guestfs-actions.pod:6711
19307 #, no-wrap
19308 msgid ""
19309 " int\n"
19310 " guestfs_truncate (guestfs_h *g,\n"
19311 "                   const char *path);\n"
19312 "\n"
19313 msgstr ""
19314
19315 # type: textblock
19316 #. type: textblock
19317 #: ../src/guestfs-actions.pod:6715 ../fish/guestfish-actions.pod:4537
19318 msgid ""
19319 "This command truncates C<path> to a zero-length file.  The file must exist "
19320 "already."
19321 msgstr ""
19322
19323 # type: =head2
19324 #. type: =head2
19325 #: ../src/guestfs-actions.pod:6722
19326 msgid "guestfs_truncate_size"
19327 msgstr ""
19328
19329 # type: verbatim
19330 #. type: verbatim
19331 #: ../src/guestfs-actions.pod:6724
19332 #, no-wrap
19333 msgid ""
19334 " int\n"
19335 " guestfs_truncate_size (guestfs_h *g,\n"
19336 "                        const char *path,\n"
19337 "                        int64_t size);\n"
19338 "\n"
19339 msgstr ""
19340
19341 # type: textblock
19342 #. type: textblock
19343 #: ../src/guestfs-actions.pod:6729 ../fish/guestfish-actions.pod:4544
19344 msgid ""
19345 "This command truncates C<path> to size C<size> bytes.  The file must exist "
19346 "already."
19347 msgstr ""
19348
19349 # type: textblock
19350 #. type: textblock
19351 #: ../src/guestfs-actions.pod:6732
19352 msgid ""
19353 "If the current file size is less than C<size> then the file is extended to "
19354 "the required size with zero bytes.  This creates a sparse file (ie. disk "
19355 "blocks are not allocated for the file until you write to it).  To create a "
19356 "non-sparse file of zeroes, use C<guestfs_fallocate64> instead."
19357 msgstr ""
19358
19359 # type: =head2
19360 #. type: =head2
19361 #: ../src/guestfs-actions.pod:6742
19362 msgid "guestfs_tune2fs_l"
19363 msgstr ""
19364
19365 # type: verbatim
19366 #. type: verbatim
19367 #: ../src/guestfs-actions.pod:6744
19368 #, no-wrap
19369 msgid ""
19370 " char **\n"
19371 " guestfs_tune2fs_l (guestfs_h *g,\n"
19372 "                    const char *device);\n"
19373 "\n"
19374 msgstr ""
19375
19376 # type: textblock
19377 #. type: textblock
19378 #: ../src/guestfs-actions.pod:6748 ../fish/guestfish-actions.pod:4557
19379 msgid ""
19380 "This returns the contents of the ext2, ext3 or ext4 filesystem superblock on "
19381 "C<device>."
19382 msgstr ""
19383
19384 # type: textblock
19385 #. type: textblock
19386 #: ../src/guestfs-actions.pod:6751 ../fish/guestfish-actions.pod:4560
19387 msgid ""
19388 "It is the same as running C<tune2fs -l device>.  See L<tune2fs(8)> manpage "
19389 "for more details.  The list of fields returned isn't clearly defined, and "
19390 "depends on both the version of C<tune2fs> that libguestfs was built against, "
19391 "and the filesystem itself."
19392 msgstr ""
19393
19394 # type: =head2
19395 #. type: =head2
19396 #: ../src/guestfs-actions.pod:6764
19397 msgid "guestfs_txz_in"
19398 msgstr ""
19399
19400 # type: verbatim
19401 #. type: verbatim
19402 #: ../src/guestfs-actions.pod:6766
19403 #, no-wrap
19404 msgid ""
19405 " int\n"
19406 " guestfs_txz_in (guestfs_h *g,\n"
19407 "                 const char *tarball,\n"
19408 "                 const char *directory);\n"
19409 "\n"
19410 msgstr ""
19411
19412 # type: textblock
19413 #. type: textblock
19414 #: ../src/guestfs-actions.pod:6771 ../fish/guestfish-actions.pod:4569
19415 msgid ""
19416 "This command uploads and unpacks local file C<tarball> (an I<xz compressed> "
19417 "tar file) into C<directory>."
19418 msgstr ""
19419
19420 # type: =head2
19421 #. type: =head2
19422 #: ../src/guestfs-actions.pod:6778
19423 msgid "guestfs_txz_out"
19424 msgstr ""
19425
19426 # type: verbatim
19427 #. type: verbatim
19428 #: ../src/guestfs-actions.pod:6780
19429 #, no-wrap
19430 msgid ""
19431 " int\n"
19432 " guestfs_txz_out (guestfs_h *g,\n"
19433 "                  const char *directory,\n"
19434 "                  const char *tarball);\n"
19435 "\n"
19436 msgstr ""
19437
19438 # type: textblock
19439 #. type: textblock
19440 #: ../src/guestfs-actions.pod:6785 ../fish/guestfish-actions.pod:4578
19441 msgid ""
19442 "This command packs the contents of C<directory> and downloads it to local "
19443 "file C<tarball> (as an xz compressed tar archive)."
19444 msgstr ""
19445
19446 # type: =head2
19447 #. type: =head2
19448 #: ../src/guestfs-actions.pod:6792
19449 msgid "guestfs_umask"
19450 msgstr ""
19451
19452 # type: verbatim
19453 #. type: verbatim
19454 #: ../src/guestfs-actions.pod:6794
19455 #, no-wrap
19456 msgid ""
19457 " int\n"
19458 " guestfs_umask (guestfs_h *g,\n"
19459 "                int mask);\n"
19460 "\n"
19461 msgstr ""
19462
19463 # type: textblock
19464 #. type: textblock
19465 #: ../src/guestfs-actions.pod:6798 ../fish/guestfish-actions.pod:4587
19466 msgid ""
19467 "This function sets the mask used for creating new files and device nodes to "
19468 "C<mask & 0777>."
19469 msgstr ""
19470
19471 # type: textblock
19472 #. type: textblock
19473 #: ../src/guestfs-actions.pod:6801 ../fish/guestfish-actions.pod:4590
19474 msgid ""
19475 "Typical umask values would be C<022> which creates new files with "
19476 "permissions like \"-rw-r--r--\" or \"-rwxr-xr-x\", and C<002> which creates "
19477 "new files with permissions like \"-rw-rw-r--\" or \"-rwxrwxr-x\"."
19478 msgstr ""
19479
19480 # type: textblock
19481 #. type: textblock
19482 #: ../src/guestfs-actions.pod:6806 ../fish/guestfish-actions.pod:4595
19483 msgid ""
19484 "The default umask is C<022>.  This is important because it means that "
19485 "directories and device nodes will be created with C<0644> or C<0755> mode "
19486 "even if you specify C<0777>."
19487 msgstr ""
19488
19489 # type: textblock
19490 #. type: textblock
19491 #: ../src/guestfs-actions.pod:6810
19492 msgid ""
19493 "See also C<guestfs_get_umask>, L<umask(2)>, C<guestfs_mknod>, "
19494 "C<guestfs_mkdir>."
19495 msgstr ""
19496
19497 # type: textblock
19498 #. type: textblock
19499 #: ../src/guestfs-actions.pod:6813 ../fish/guestfish-actions.pod:4602
19500 msgid "This call returns the previous umask."
19501 msgstr ""
19502
19503 # type: =head2
19504 #. type: =head2
19505 #: ../src/guestfs-actions.pod:6819
19506 msgid "guestfs_umount"
19507 msgstr ""
19508
19509 # type: verbatim
19510 #. type: verbatim
19511 #: ../src/guestfs-actions.pod:6821
19512 #, no-wrap
19513 msgid ""
19514 " int\n"
19515 " guestfs_umount (guestfs_h *g,\n"
19516 "                 const char *pathordevice);\n"
19517 "\n"
19518 msgstr ""
19519
19520 # type: textblock
19521 #. type: textblock
19522 #: ../src/guestfs-actions.pod:6825 ../fish/guestfish-actions.pod:4610
19523 msgid ""
19524 "This unmounts the given filesystem.  The filesystem may be specified either "
19525 "by its mountpoint (path) or the device which contains the filesystem."
19526 msgstr ""
19527
19528 # type: =head2
19529 #. type: =head2
19530 #: ../src/guestfs-actions.pod:6833
19531 msgid "guestfs_umount_all"
19532 msgstr ""
19533
19534 # type: verbatim
19535 #. type: verbatim
19536 #: ../src/guestfs-actions.pod:6835
19537 #, no-wrap
19538 msgid ""
19539 " int\n"
19540 " guestfs_umount_all (guestfs_h *g);\n"
19541 "\n"
19542 msgstr ""
19543
19544 # type: textblock
19545 #. type: textblock
19546 #: ../src/guestfs-actions.pod:6838 ../fish/guestfish-actions.pod:4620
19547 msgid "This unmounts all mounted filesystems."
19548 msgstr ""
19549
19550 # type: textblock
19551 #. type: textblock
19552 #: ../src/guestfs-actions.pod:6840 ../fish/guestfish-actions.pod:4622
19553 msgid "Some internal mounts are not unmounted by this call."
19554 msgstr ""
19555
19556 # type: =head2
19557 #. type: =head2
19558 #: ../src/guestfs-actions.pod:6846
19559 msgid "guestfs_upload"
19560 msgstr ""
19561
19562 # type: verbatim
19563 #. type: verbatim
19564 #: ../src/guestfs-actions.pod:6848
19565 #, no-wrap
19566 msgid ""
19567 " int\n"
19568 " guestfs_upload (guestfs_h *g,\n"
19569 "                 const char *filename,\n"
19570 "                 const char *remotefilename);\n"
19571 "\n"
19572 msgstr ""
19573
19574 # type: textblock
19575 #. type: textblock
19576 #: ../src/guestfs-actions.pod:6853 ../src/guestfs-actions.pod:6877
19577 #: ../fish/guestfish-actions.pod:4628 ../fish/guestfish-actions.pod:4641
19578 msgid "Upload local file C<filename> to C<remotefilename> on the filesystem."
19579 msgstr ""
19580
19581 # type: textblock
19582 #. type: textblock
19583 #: ../src/guestfs-actions.pod:6858
19584 msgid "See also C<guestfs_download>."
19585 msgstr ""
19586
19587 # type: =head2
19588 #. type: =head2
19589 #: ../src/guestfs-actions.pod:6869
19590 msgid "guestfs_upload_offset"
19591 msgstr ""
19592
19593 # type: verbatim
19594 #. type: verbatim
19595 #: ../src/guestfs-actions.pod:6871
19596 #, no-wrap
19597 msgid ""
19598 " int\n"
19599 " guestfs_upload_offset (guestfs_h *g,\n"
19600 "                        const char *filename,\n"
19601 "                        const char *remotefilename,\n"
19602 "                        int64_t offset);\n"
19603 "\n"
19604 msgstr ""
19605
19606 # type: textblock
19607 #. type: textblock
19608 #: ../src/guestfs-actions.pod:6880 ../fish/guestfish-actions.pod:4644
19609 msgid ""
19610 "C<remotefilename> is overwritten starting at the byte C<offset> specified.  "
19611 "The intention is to overwrite parts of existing files or devices, although "
19612 "if a non-existant file is specified then it is created with a \"hole\" "
19613 "before C<offset>.  The size of the data written is implicit in the size of "
19614 "the source C<filename>."
19615 msgstr ""
19616
19617 # type: textblock
19618 #. type: textblock
19619 #: ../src/guestfs-actions.pod:6887
19620 msgid ""
19621 "Note that there is no limit on the amount of data that can be uploaded with "
19622 "this call, unlike with C<guestfs_pwrite>, and this call always writes the "
19623 "full amount unless an error occurs."
19624 msgstr ""
19625
19626 # type: textblock
19627 #. type: textblock
19628 #: ../src/guestfs-actions.pod:6892
19629 msgid "See also C<guestfs_upload>, C<guestfs_pwrite>."
19630 msgstr ""
19631
19632 # type: =head2
19633 #. type: =head2
19634 #: ../src/guestfs-actions.pod:6903
19635 msgid "guestfs_utimens"
19636 msgstr ""
19637
19638 # type: verbatim
19639 #. type: verbatim
19640 #: ../src/guestfs-actions.pod:6905
19641 #, no-wrap
19642 msgid ""
19643 " int\n"
19644 " guestfs_utimens (guestfs_h *g,\n"
19645 "                  const char *path,\n"
19646 "                  int64_t atsecs,\n"
19647 "                  int64_t atnsecs,\n"
19648 "                  int64_t mtsecs,\n"
19649 "                  int64_t mtnsecs);\n"
19650 "\n"
19651 msgstr ""
19652
19653 # type: textblock
19654 #. type: textblock
19655 #: ../src/guestfs-actions.pod:6913 ../fish/guestfish-actions.pod:4664
19656 msgid "This command sets the timestamps of a file with nanosecond precision."
19657 msgstr ""
19658
19659 # type: textblock
19660 #. type: textblock
19661 #: ../src/guestfs-actions.pod:6916 ../fish/guestfish-actions.pod:4667
19662 msgid ""
19663 "C<atsecs, atnsecs> are the last access time (atime) in secs and nanoseconds "
19664 "from the epoch."
19665 msgstr ""
19666
19667 # type: textblock
19668 #. type: textblock
19669 #: ../src/guestfs-actions.pod:6919 ../fish/guestfish-actions.pod:4670
19670 msgid ""
19671 "C<mtsecs, mtnsecs> are the last modification time (mtime) in secs and "
19672 "nanoseconds from the epoch."
19673 msgstr ""
19674
19675 # type: textblock
19676 #. type: textblock
19677 #: ../src/guestfs-actions.pod:6922 ../fish/guestfish-actions.pod:4673
19678 msgid ""
19679 "If the C<*nsecs> field contains the special value C<-1> then the "
19680 "corresponding timestamp is set to the current time.  (The C<*secs> field is "
19681 "ignored in this case)."
19682 msgstr ""
19683
19684 # type: textblock
19685 #. type: textblock
19686 #: ../src/guestfs-actions.pod:6926 ../fish/guestfish-actions.pod:4677
19687 msgid ""
19688 "If the C<*nsecs> field contains the special value C<-2> then the "
19689 "corresponding timestamp is left unchanged.  (The C<*secs> field is ignored "
19690 "in this case)."
19691 msgstr ""
19692
19693 # type: =head2
19694 #. type: =head2
19695 #: ../src/guestfs-actions.pod:6934 ../src/guestfs-structs.pod:175
19696 msgid "guestfs_version"
19697 msgstr ""
19698
19699 # type: verbatim
19700 #. type: verbatim
19701 #: ../src/guestfs-actions.pod:6936
19702 #, no-wrap
19703 msgid ""
19704 " struct guestfs_version *\n"
19705 " guestfs_version (guestfs_h *g);\n"
19706 "\n"
19707 msgstr ""
19708
19709 # type: textblock
19710 #. type: textblock
19711 #: ../src/guestfs-actions.pod:6939 ../fish/guestfish-actions.pod:4685
19712 msgid ""
19713 "Return the libguestfs version number that the program is linked against."
19714 msgstr ""
19715
19716 # type: textblock
19717 #. type: textblock
19718 #: ../src/guestfs-actions.pod:6942 ../fish/guestfish-actions.pod:4688
19719 msgid ""
19720 "Note that because of dynamic linking this is not necessarily the version of "
19721 "libguestfs that you compiled against.  You can compile the program, and then "
19722 "at runtime dynamically link against a completely different C<libguestfs.so> "
19723 "library."
19724 msgstr ""
19725
19726 # type: textblock
19727 #. type: textblock
19728 #: ../src/guestfs-actions.pod:6947 ../fish/guestfish-actions.pod:4693
19729 msgid ""
19730 "This call was added in version C<1.0.58>.  In previous versions of "
19731 "libguestfs there was no way to get the version number.  From C code you can "
19732 "use dynamic linker functions to find out if this symbol exists (if it "
19733 "doesn't, then it's an earlier version)."
19734 msgstr ""
19735
19736 # type: textblock
19737 #. type: textblock
19738 #: ../src/guestfs-actions.pod:6953 ../fish/guestfish-actions.pod:4699
19739 msgid ""
19740 "The call returns a structure with four elements.  The first three (C<major>, "
19741 "C<minor> and C<release>) are numbers and correspond to the usual version "
19742 "triplet.  The fourth element (C<extra>) is a string and is normally empty, "
19743 "but may be used for distro-specific information."
19744 msgstr ""
19745
19746 # type: textblock
19747 #. type: textblock
19748 #: ../src/guestfs-actions.pod:6959 ../fish/guestfish-actions.pod:4705
19749 msgid ""
19750 "To construct the original version string: C<$major.$minor.$release$extra>"
19751 msgstr ""
19752
19753 # type: textblock
19754 #. type: textblock
19755 #: ../src/guestfs-actions.pod:6962 ../fish/guestfish-actions.pod:4708
19756 msgid "See also: L<guestfs(3)/LIBGUESTFS VERSION NUMBERS>."
19757 msgstr ""
19758
19759 # type: textblock
19760 #. type: textblock
19761 #: ../src/guestfs-actions.pod:6964
19762 msgid ""
19763 "I<Note:> Don't use this call to test for availability of features.  In "
19764 "enterprise distributions we backport features from later versions into "
19765 "earlier versions, making this an unreliable way to test for features.  Use "
19766 "C<guestfs_available> instead."
19767 msgstr ""
19768
19769 # type: textblock
19770 #. type: textblock
19771 #: ../src/guestfs-actions.pod:6970
19772 msgid ""
19773 "This function returns a C<struct guestfs_version *>, or NULL if there was an "
19774 "error.  I<The caller must call C<guestfs_free_version> after use>."
19775 msgstr ""
19776
19777 # type: textblock
19778 #. type: textblock
19779 #: ../src/guestfs-actions.pod:6974
19780 msgid "(Added in 1.0.58)"
19781 msgstr ""
19782
19783 # type: =head2
19784 #. type: =head2
19785 #: ../src/guestfs-actions.pod:6976
19786 msgid "guestfs_vfs_label"
19787 msgstr ""
19788
19789 # type: verbatim
19790 #. type: verbatim
19791 #: ../src/guestfs-actions.pod:6978
19792 #, no-wrap
19793 msgid ""
19794 " char *\n"
19795 " guestfs_vfs_label (guestfs_h *g,\n"
19796 "                    const char *device);\n"
19797 "\n"
19798 msgstr ""
19799
19800 # type: textblock
19801 #. type: textblock
19802 #: ../src/guestfs-actions.pod:6982 ../fish/guestfish-actions.pod:4720
19803 msgid "This returns the filesystem label of the filesystem on C<device>."
19804 msgstr ""
19805
19806 # type: textblock
19807 #. type: textblock
19808 #: ../src/guestfs-actions.pod:6985 ../fish/guestfish-actions.pod:4723
19809 msgid "If the filesystem is unlabeled, this returns the empty string."
19810 msgstr ""
19811
19812 # type: textblock
19813 #. type: textblock
19814 #: ../src/guestfs-actions.pod:6987
19815 msgid "To find a filesystem from the label, use C<guestfs_findfs_label>."
19816 msgstr ""
19817
19818 # type: textblock
19819 #. type: textblock
19820 #: ../src/guestfs-actions.pod:6992 ../src/guestfs-actions.pod:7029
19821 msgid "(Added in 1.3.18)"
19822 msgstr ""
19823
19824 # type: =head2
19825 #. type: =head2
19826 #: ../src/guestfs-actions.pod:6994
19827 msgid "guestfs_vfs_type"
19828 msgstr ""
19829
19830 # type: verbatim
19831 #. type: verbatim
19832 #: ../src/guestfs-actions.pod:6996
19833 #, no-wrap
19834 msgid ""
19835 " char *\n"
19836 " guestfs_vfs_type (guestfs_h *g,\n"
19837 "                   const char *device);\n"
19838 "\n"
19839 msgstr ""
19840
19841 # type: textblock
19842 #. type: textblock
19843 #: ../src/guestfs-actions.pod:7000 ../fish/guestfish-actions.pod:4731
19844 msgid ""
19845 "This command gets the filesystem type corresponding to the filesystem on "
19846 "C<device>."
19847 msgstr ""
19848
19849 # type: textblock
19850 #. type: textblock
19851 #: ../src/guestfs-actions.pod:7003 ../fish/guestfish-actions.pod:4734
19852 msgid ""
19853 "For most filesystems, the result is the name of the Linux VFS module which "
19854 "would be used to mount this filesystem if you mounted it without specifying "
19855 "the filesystem type.  For example a string such as C<ext3> or C<ntfs>."
19856 msgstr ""
19857
19858 # type: =head2
19859 #. type: =head2
19860 #: ../src/guestfs-actions.pod:7013
19861 msgid "guestfs_vfs_uuid"
19862 msgstr ""
19863
19864 # type: verbatim
19865 #. type: verbatim
19866 #: ../src/guestfs-actions.pod:7015
19867 #, no-wrap
19868 msgid ""
19869 " char *\n"
19870 " guestfs_vfs_uuid (guestfs_h *g,\n"
19871 "                   const char *device);\n"
19872 "\n"
19873 msgstr ""
19874
19875 # type: textblock
19876 #. type: textblock
19877 #: ../src/guestfs-actions.pod:7019 ../fish/guestfish-actions.pod:4743
19878 msgid "This returns the filesystem UUID of the filesystem on C<device>."
19879 msgstr ""
19880
19881 # type: textblock
19882 #. type: textblock
19883 #: ../src/guestfs-actions.pod:7022 ../fish/guestfish-actions.pod:4746
19884 msgid "If the filesystem does not have a UUID, this returns the empty string."
19885 msgstr ""
19886
19887 # type: textblock
19888 #. type: textblock
19889 #: ../src/guestfs-actions.pod:7024
19890 msgid "To find a filesystem from the UUID, use C<guestfs_findfs_uuid>."
19891 msgstr ""
19892
19893 # type: =head2
19894 #. type: =head2
19895 #: ../src/guestfs-actions.pod:7031
19896 msgid "guestfs_vg_activate"
19897 msgstr ""
19898
19899 # type: verbatim
19900 #. type: verbatim
19901 #: ../src/guestfs-actions.pod:7033
19902 #, no-wrap
19903 msgid ""
19904 " int\n"
19905 " guestfs_vg_activate (guestfs_h *g,\n"
19906 "                      int activate,\n"
19907 "                      char *const *volgroups);\n"
19908 "\n"
19909 msgstr ""
19910
19911 # type: textblock
19912 #. type: textblock
19913 #: ../src/guestfs-actions.pod:7038 ../fish/guestfish-actions.pod:4754
19914 msgid ""
19915 "This command activates or (if C<activate> is false) deactivates all logical "
19916 "volumes in the listed volume groups C<volgroups>.  If activated, then they "
19917 "are made known to the kernel, ie. they appear as C</dev/mapper> devices.  If "
19918 "deactivated, then those devices disappear."
19919 msgstr ""
19920
19921 # type: textblock
19922 #. type: textblock
19923 #: ../src/guestfs-actions.pod:7044 ../fish/guestfish-actions.pod:4760
19924 msgid "This command is the same as running C<vgchange -a y|n volgroups...>"
19925 msgstr ""
19926
19927 # type: textblock
19928 #. type: textblock
19929 #: ../src/guestfs-actions.pod:7046 ../fish/guestfish-actions.pod:4762
19930 msgid ""
19931 "Note that if C<volgroups> is an empty list then B<all> volume groups are "
19932 "activated or deactivated."
19933 msgstr ""
19934
19935 # type: =head2
19936 #. type: =head2
19937 #: ../src/guestfs-actions.pod:7053
19938 msgid "guestfs_vg_activate_all"
19939 msgstr ""
19940
19941 # type: verbatim
19942 #. type: verbatim
19943 #: ../src/guestfs-actions.pod:7055
19944 #, no-wrap
19945 msgid ""
19946 " int\n"
19947 " guestfs_vg_activate_all (guestfs_h *g,\n"
19948 "                          int activate);\n"
19949 "\n"
19950 msgstr ""
19951
19952 # type: textblock
19953 #. type: textblock
19954 #: ../src/guestfs-actions.pod:7059 ../fish/guestfish-actions.pod:4769
19955 msgid ""
19956 "This command activates or (if C<activate> is false) deactivates all logical "
19957 "volumes in all volume groups.  If activated, then they are made known to the "
19958 "kernel, ie. they appear as C</dev/mapper> devices.  If deactivated, then "
19959 "those devices disappear."
19960 msgstr ""
19961
19962 # type: textblock
19963 #. type: textblock
19964 #: ../src/guestfs-actions.pod:7065 ../fish/guestfish-actions.pod:4775
19965 msgid "This command is the same as running C<vgchange -a y|n>"
19966 msgstr ""
19967
19968 # type: =head2
19969 #. type: =head2
19970 #: ../src/guestfs-actions.pod:7071
19971 msgid "guestfs_vgcreate"
19972 msgstr ""
19973
19974 # type: verbatim
19975 #. type: verbatim
19976 #: ../src/guestfs-actions.pod:7073
19977 #, no-wrap
19978 msgid ""
19979 " int\n"
19980 " guestfs_vgcreate (guestfs_h *g,\n"
19981 "                   const char *volgroup,\n"
19982 "                   char *const *physvols);\n"
19983 "\n"
19984 msgstr ""
19985
19986 # type: textblock
19987 #. type: textblock
19988 #: ../src/guestfs-actions.pod:7078 ../fish/guestfish-actions.pod:4781
19989 msgid ""
19990 "This creates an LVM volume group called C<volgroup> from the non-empty list "
19991 "of physical volumes C<physvols>."
19992 msgstr ""
19993
19994 # type: =head2
19995 #. type: =head2
19996 #: ../src/guestfs-actions.pod:7085
19997 msgid "guestfs_vglvuuids"
19998 msgstr ""
19999
20000 # type: verbatim
20001 #. type: verbatim
20002 #: ../src/guestfs-actions.pod:7087
20003 #, no-wrap
20004 msgid ""
20005 " char **\n"
20006 " guestfs_vglvuuids (guestfs_h *g,\n"
20007 "                    const char *vgname);\n"
20008 "\n"
20009 msgstr ""
20010
20011 # type: textblock
20012 #. type: textblock
20013 #: ../src/guestfs-actions.pod:7091 ../fish/guestfish-actions.pod:4788
20014 msgid ""
20015 "Given a VG called C<vgname>, this returns the UUIDs of all the logical "
20016 "volumes created in this volume group."
20017 msgstr ""
20018
20019 # type: textblock
20020 #. type: textblock
20021 #: ../src/guestfs-actions.pod:7094
20022 msgid ""
20023 "You can use this along with C<guestfs_lvs> and C<guestfs_lvuuid> calls to "
20024 "associate logical volumes and volume groups."
20025 msgstr ""
20026
20027 # type: textblock
20028 #. type: textblock
20029 #: ../src/guestfs-actions.pod:7097
20030 msgid "See also C<guestfs_vgpvuuids>."
20031 msgstr ""
20032
20033 # type: =head2
20034 #. type: =head2
20035 #: ../src/guestfs-actions.pod:7105
20036 msgid "guestfs_vgpvuuids"
20037 msgstr ""
20038
20039 # type: verbatim
20040 #. type: verbatim
20041 #: ../src/guestfs-actions.pod:7107
20042 #, no-wrap
20043 msgid ""
20044 " char **\n"
20045 " guestfs_vgpvuuids (guestfs_h *g,\n"
20046 "                    const char *vgname);\n"
20047 "\n"
20048 msgstr ""
20049
20050 # type: textblock
20051 #. type: textblock
20052 #: ../src/guestfs-actions.pod:7111 ../fish/guestfish-actions.pod:4800
20053 msgid ""
20054 "Given a VG called C<vgname>, this returns the UUIDs of all the physical "
20055 "volumes that this volume group resides on."
20056 msgstr ""
20057
20058 # type: textblock
20059 #. type: textblock
20060 #: ../src/guestfs-actions.pod:7114
20061 msgid ""
20062 "You can use this along with C<guestfs_pvs> and C<guestfs_pvuuid> calls to "
20063 "associate physical volumes and volume groups."
20064 msgstr ""
20065
20066 # type: textblock
20067 #. type: textblock
20068 #: ../src/guestfs-actions.pod:7117
20069 msgid "See also C<guestfs_vglvuuids>."
20070 msgstr ""
20071
20072 # type: =head2
20073 #. type: =head2
20074 #: ../src/guestfs-actions.pod:7125
20075 msgid "guestfs_vgremove"
20076 msgstr ""
20077
20078 # type: verbatim
20079 #. type: verbatim
20080 #: ../src/guestfs-actions.pod:7127
20081 #, no-wrap
20082 msgid ""
20083 " int\n"
20084 " guestfs_vgremove (guestfs_h *g,\n"
20085 "                   const char *vgname);\n"
20086 "\n"
20087 msgstr ""
20088
20089 # type: textblock
20090 #. type: textblock
20091 #: ../src/guestfs-actions.pod:7131 ../fish/guestfish-actions.pod:4812
20092 msgid "Remove an LVM volume group C<vgname>, (for example C<VG>)."
20093 msgstr ""
20094
20095 # type: textblock
20096 #. type: textblock
20097 #: ../src/guestfs-actions.pod:7133 ../fish/guestfish-actions.pod:4814
20098 msgid ""
20099 "This also forcibly removes all logical volumes in the volume group (if any)."
20100 msgstr ""
20101
20102 # type: =head2
20103 #. type: =head2
20104 #: ../src/guestfs-actions.pod:7140
20105 msgid "guestfs_vgrename"
20106 msgstr ""
20107
20108 # type: verbatim
20109 #. type: verbatim
20110 #: ../src/guestfs-actions.pod:7142
20111 #, no-wrap
20112 msgid ""
20113 " int\n"
20114 " guestfs_vgrename (guestfs_h *g,\n"
20115 "                   const char *volgroup,\n"
20116 "                   const char *newvolgroup);\n"
20117 "\n"
20118 msgstr ""
20119
20120 # type: textblock
20121 #. type: textblock
20122 #: ../src/guestfs-actions.pod:7147 ../fish/guestfish-actions.pod:4821
20123 msgid "Rename a volume group C<volgroup> with the new name C<newvolgroup>."
20124 msgstr ""
20125
20126 # type: =head2
20127 #. type: =head2
20128 #: ../src/guestfs-actions.pod:7153
20129 msgid "guestfs_vgs"
20130 msgstr ""
20131
20132 # type: verbatim
20133 #. type: verbatim
20134 #: ../src/guestfs-actions.pod:7155
20135 #, no-wrap
20136 msgid ""
20137 " char **\n"
20138 " guestfs_vgs (guestfs_h *g);\n"
20139 "\n"
20140 msgstr ""
20141
20142 # type: textblock
20143 #. type: textblock
20144 #: ../src/guestfs-actions.pod:7158 ../fish/guestfish-actions.pod:4827
20145 msgid ""
20146 "List all the volumes groups detected.  This is the equivalent of the L<vgs(8)"
20147 "> command."
20148 msgstr ""
20149
20150 # type: textblock
20151 #. type: textblock
20152 #: ../src/guestfs-actions.pod:7161 ../fish/guestfish-actions.pod:4830
20153 msgid ""
20154 "This returns a list of just the volume group names that were detected (eg. "
20155 "C<VolGroup00>)."
20156 msgstr ""
20157
20158 # type: textblock
20159 #. type: textblock
20160 #: ../src/guestfs-actions.pod:7164
20161 msgid "See also C<guestfs_vgs_full>."
20162 msgstr ""
20163
20164 # type: =head2
20165 #. type: =head2
20166 #: ../src/guestfs-actions.pod:7172
20167 msgid "guestfs_vgs_full"
20168 msgstr ""
20169
20170 # type: verbatim
20171 #. type: verbatim
20172 #: ../src/guestfs-actions.pod:7174
20173 #, no-wrap
20174 msgid ""
20175 " struct guestfs_lvm_vg_list *\n"
20176 " guestfs_vgs_full (guestfs_h *g);\n"
20177 "\n"
20178 msgstr ""
20179
20180 # type: textblock
20181 #. type: textblock
20182 #: ../src/guestfs-actions.pod:7177 ../fish/guestfish-actions.pod:4839
20183 msgid ""
20184 "List all the volumes groups detected.  This is the equivalent of the L<vgs(8)"
20185 "> command.  The \"full\" version includes all fields."
20186 msgstr ""
20187
20188 # type: textblock
20189 #. type: textblock
20190 #: ../src/guestfs-actions.pod:7180
20191 msgid ""
20192 "This function returns a C<struct guestfs_lvm_vg_list *>, or NULL if there "
20193 "was an error.  I<The caller must call C<guestfs_free_lvm_vg_list> after use>."
20194 msgstr ""
20195
20196 # type: =head2
20197 #. type: =head2
20198 #: ../src/guestfs-actions.pod:7186
20199 msgid "guestfs_vgscan"
20200 msgstr ""
20201
20202 # type: verbatim
20203 #. type: verbatim
20204 #: ../src/guestfs-actions.pod:7188
20205 #, no-wrap
20206 msgid ""
20207 " int\n"
20208 " guestfs_vgscan (guestfs_h *g);\n"
20209 "\n"
20210 msgstr ""
20211
20212 # type: textblock
20213 #. type: textblock
20214 #: ../src/guestfs-actions.pod:7191 ../fish/guestfish-actions.pod:4846
20215 msgid ""
20216 "This rescans all block devices and rebuilds the list of LVM physical "
20217 "volumes, volume groups and logical volumes."
20218 msgstr ""
20219
20220 # type: =head2
20221 #. type: =head2
20222 #: ../src/guestfs-actions.pod:7198
20223 msgid "guestfs_vguuid"
20224 msgstr ""
20225
20226 # type: verbatim
20227 #. type: verbatim
20228 #: ../src/guestfs-actions.pod:7200
20229 #, no-wrap
20230 msgid ""
20231 " char *\n"
20232 " guestfs_vguuid (guestfs_h *g,\n"
20233 "                 const char *vgname);\n"
20234 "\n"
20235 msgstr ""
20236
20237 # type: textblock
20238 #. type: textblock
20239 #: ../src/guestfs-actions.pod:7204 ../fish/guestfish-actions.pod:4853
20240 msgid "This command returns the UUID of the LVM VG named C<vgname>."
20241 msgstr ""
20242
20243 # type: =head2
20244 #. type: =head2
20245 #: ../src/guestfs-actions.pod:7211
20246 msgid "guestfs_wait_ready"
20247 msgstr ""
20248
20249 # type: verbatim
20250 #. type: verbatim
20251 #: ../src/guestfs-actions.pod:7213
20252 #, no-wrap
20253 msgid ""
20254 " int\n"
20255 " guestfs_wait_ready (guestfs_h *g);\n"
20256 "\n"
20257 msgstr ""
20258
20259 # type: textblock
20260 #. type: textblock
20261 #: ../src/guestfs-actions.pod:7216
20262 msgid "This function is a no op."
20263 msgstr ""
20264
20265 # type: textblock
20266 #. type: textblock
20267 #: ../src/guestfs-actions.pod:7218
20268 msgid ""
20269 "In versions of the API E<lt> 1.0.71 you had to call this function just after "
20270 "calling C<guestfs_launch> to wait for the launch to complete.  However this "
20271 "is no longer necessary because C<guestfs_launch> now does the waiting."
20272 msgstr ""
20273
20274 # type: textblock
20275 #. type: textblock
20276 #: ../src/guestfs-actions.pod:7223
20277 msgid ""
20278 "If you see any calls to this function in code then you can just remove them, "
20279 "unless you want to retain compatibility with older versions of the API."
20280 msgstr ""
20281
20282 #. type: textblock
20283 #: ../src/guestfs-actions.pod:7229
20284 msgid ""
20285 "This function is deprecated.  In new code, use the C<launch> call instead."
20286 msgstr ""
20287
20288 # type: =head2
20289 #. type: =head2
20290 #: ../src/guestfs-actions.pod:7238
20291 msgid "guestfs_wc_c"
20292 msgstr ""
20293
20294 # type: verbatim
20295 #. type: verbatim
20296 #: ../src/guestfs-actions.pod:7240
20297 #, no-wrap
20298 msgid ""
20299 " int\n"
20300 " guestfs_wc_c (guestfs_h *g,\n"
20301 "               const char *path);\n"
20302 "\n"
20303 msgstr ""
20304
20305 # type: textblock
20306 #. type: textblock
20307 #: ../src/guestfs-actions.pod:7244 ../fish/guestfish-actions.pod:4859
20308 msgid ""
20309 "This command counts the characters in a file, using the C<wc -c> external "
20310 "command."
20311 msgstr ""
20312
20313 # type: =head2
20314 #. type: =head2
20315 #: ../src/guestfs-actions.pod:7251
20316 msgid "guestfs_wc_l"
20317 msgstr ""
20318
20319 # type: verbatim
20320 #. type: verbatim
20321 #: ../src/guestfs-actions.pod:7253
20322 #, no-wrap
20323 msgid ""
20324 " int\n"
20325 " guestfs_wc_l (guestfs_h *g,\n"
20326 "               const char *path);\n"
20327 "\n"
20328 msgstr ""
20329
20330 # type: textblock
20331 #. type: textblock
20332 #: ../src/guestfs-actions.pod:7257 ../fish/guestfish-actions.pod:4866
20333 msgid ""
20334 "This command counts the lines in a file, using the C<wc -l> external command."
20335 msgstr ""
20336
20337 # type: =head2
20338 #. type: =head2
20339 #: ../src/guestfs-actions.pod:7264
20340 msgid "guestfs_wc_w"
20341 msgstr ""
20342
20343 # type: verbatim
20344 #. type: verbatim
20345 #: ../src/guestfs-actions.pod:7266
20346 #, no-wrap
20347 msgid ""
20348 " int\n"
20349 " guestfs_wc_w (guestfs_h *g,\n"
20350 "               const char *path);\n"
20351 "\n"
20352 msgstr ""
20353
20354 # type: textblock
20355 #. type: textblock
20356 #: ../src/guestfs-actions.pod:7270 ../fish/guestfish-actions.pod:4873
20357 msgid ""
20358 "This command counts the words in a file, using the C<wc -w> external command."
20359 msgstr ""
20360
20361 # type: =head2
20362 #. type: =head2
20363 #: ../src/guestfs-actions.pod:7277
20364 msgid "guestfs_write"
20365 msgstr ""
20366
20367 # type: verbatim
20368 #. type: verbatim
20369 #: ../src/guestfs-actions.pod:7279
20370 #, no-wrap
20371 msgid ""
20372 " int\n"
20373 " guestfs_write (guestfs_h *g,\n"
20374 "                const char *path,\n"
20375 "                const char *content,\n"
20376 "                size_t content_size);\n"
20377 "\n"
20378 msgstr ""
20379
20380 # type: textblock
20381 #. type: textblock
20382 #: ../src/guestfs-actions.pod:7285 ../fish/guestfish-actions.pod:4880
20383 msgid ""
20384 "This call creates a file called C<path>.  The content of the file is the "
20385 "string C<content> (which can contain any 8 bit data)."
20386 msgstr ""
20387
20388 # type: =head2
20389 #. type: =head2
20390 #: ../src/guestfs-actions.pod:7295
20391 msgid "guestfs_write_file"
20392 msgstr ""
20393
20394 # type: verbatim
20395 #. type: verbatim
20396 #: ../src/guestfs-actions.pod:7297
20397 #, no-wrap
20398 msgid ""
20399 " int\n"
20400 " guestfs_write_file (guestfs_h *g,\n"
20401 "                     const char *path,\n"
20402 "                     const char *content,\n"
20403 "                     int size);\n"
20404 "\n"
20405 msgstr ""
20406
20407 # type: textblock
20408 #. type: textblock
20409 #: ../src/guestfs-actions.pod:7303 ../fish/guestfish-actions.pod:4890
20410 msgid ""
20411 "This call creates a file called C<path>.  The contents of the file is the "
20412 "string C<content> (which can contain any 8 bit data), with length C<size>."
20413 msgstr ""
20414
20415 # type: textblock
20416 #. type: textblock
20417 #: ../src/guestfs-actions.pod:7307 ../fish/guestfish-actions.pod:4894
20418 msgid ""
20419 "As a special case, if C<size> is C<0> then the length is calculated using "
20420 "C<strlen> (so in this case the content cannot contain embedded ASCII NULs)."
20421 msgstr ""
20422
20423 # type: textblock
20424 #. type: textblock
20425 #: ../src/guestfs-actions.pod:7311 ../fish/guestfish-actions.pod:4898
20426 msgid ""
20427 "I<NB.> Owing to a bug, writing content containing ASCII NUL characters does "
20428 "I<not> work, even if the length is specified."
20429 msgstr ""
20430
20431 # type: textblock
20432 #. type: textblock
20433 #: ../src/guestfs-actions.pod:7319 ../fish/guestfish-actions.pod:4904
20434 msgid ""
20435 "This function is deprecated.  In new code, use the C<write> call instead."
20436 msgstr ""
20437
20438 # type: =head2
20439 #. type: =head2
20440 #: ../src/guestfs-actions.pod:7328
20441 msgid "guestfs_zegrep"
20442 msgstr ""
20443
20444 # type: verbatim
20445 #. type: verbatim
20446 #: ../src/guestfs-actions.pod:7330
20447 #, no-wrap
20448 msgid ""
20449 " char **\n"
20450 " guestfs_zegrep (guestfs_h *g,\n"
20451 "                 const char *regex,\n"
20452 "                 const char *path);\n"
20453 "\n"
20454 msgstr ""
20455
20456 # type: textblock
20457 #. type: textblock
20458 #: ../src/guestfs-actions.pod:7335 ../fish/guestfish-actions.pod:4915
20459 msgid ""
20460 "This calls the external C<zegrep> program and returns the matching lines."
20461 msgstr ""
20462
20463 # type: =head2
20464 #. type: =head2
20465 #: ../src/guestfs-actions.pod:7347
20466 msgid "guestfs_zegrepi"
20467 msgstr ""
20468
20469 # type: verbatim
20470 #. type: verbatim
20471 #: ../src/guestfs-actions.pod:7349
20472 #, no-wrap
20473 msgid ""
20474 " char **\n"
20475 " guestfs_zegrepi (guestfs_h *g,\n"
20476 "                  const char *regex,\n"
20477 "                  const char *path);\n"
20478 "\n"
20479 msgstr ""
20480
20481 # type: textblock
20482 #. type: textblock
20483 #: ../src/guestfs-actions.pod:7354 ../fish/guestfish-actions.pod:4925
20484 msgid ""
20485 "This calls the external C<zegrep -i> program and returns the matching lines."
20486 msgstr ""
20487
20488 # type: =head2
20489 #. type: =head2
20490 #: ../src/guestfs-actions.pod:7366
20491 msgid "guestfs_zero"
20492 msgstr ""
20493
20494 # type: verbatim
20495 #. type: verbatim
20496 #: ../src/guestfs-actions.pod:7368
20497 #, no-wrap
20498 msgid ""
20499 " int\n"
20500 " guestfs_zero (guestfs_h *g,\n"
20501 "               const char *device);\n"
20502 "\n"
20503 msgstr ""
20504
20505 # type: textblock
20506 #. type: textblock
20507 #: ../src/guestfs-actions.pod:7372 ../fish/guestfish-actions.pod:4935
20508 msgid "This command writes zeroes over the first few blocks of C<device>."
20509 msgstr ""
20510
20511 # type: textblock
20512 #. type: textblock
20513 #: ../src/guestfs-actions.pod:7374 ../fish/guestfish-actions.pod:4937
20514 msgid ""
20515 "How many blocks are zeroed isn't specified (but it's I<not> enough to "
20516 "securely wipe the device).  It should be sufficient to remove any partition "
20517 "tables, filesystem superblocks and so on."
20518 msgstr ""
20519
20520 # type: textblock
20521 #. type: textblock
20522 #: ../src/guestfs-actions.pod:7378
20523 msgid "See also: C<guestfs_zero_device>, C<guestfs_scrub_device>."
20524 msgstr ""
20525
20526 # type: =head2
20527 #. type: =head2
20528 #: ../src/guestfs-actions.pod:7389
20529 msgid "guestfs_zero_device"
20530 msgstr ""
20531
20532 # type: verbatim
20533 #. type: verbatim
20534 #: ../src/guestfs-actions.pod:7391
20535 #, no-wrap
20536 msgid ""
20537 " int\n"
20538 " guestfs_zero_device (guestfs_h *g,\n"
20539 "                      const char *device);\n"
20540 "\n"
20541 msgstr ""
20542
20543 # type: textblock
20544 #. type: textblock
20545 #: ../src/guestfs-actions.pod:7395
20546 msgid ""
20547 "This command writes zeroes over the entire C<device>.  Compare with "
20548 "C<guestfs_zero> which just zeroes the first few blocks of a device."
20549 msgstr ""
20550
20551 # type: textblock
20552 #. type: textblock
20553 #: ../src/guestfs-actions.pod:7409
20554 msgid "(Added in 1.3.1)"
20555 msgstr ""
20556
20557 # type: =head2
20558 #. type: =head2
20559 #: ../src/guestfs-actions.pod:7411
20560 msgid "guestfs_zerofree"
20561 msgstr ""
20562
20563 # type: verbatim
20564 #. type: verbatim
20565 #: ../src/guestfs-actions.pod:7413
20566 #, no-wrap
20567 msgid ""
20568 " int\n"
20569 " guestfs_zerofree (guestfs_h *g,\n"
20570 "                   const char *device);\n"
20571 "\n"
20572 msgstr ""
20573
20574 # type: textblock
20575 #. type: textblock
20576 #: ../src/guestfs-actions.pod:7417 ../fish/guestfish-actions.pod:4958
20577 msgid ""
20578 "This runs the I<zerofree> program on C<device>.  This program claims to zero "
20579 "unused inodes and disk blocks on an ext2/3 filesystem, thus making it "
20580 "possible to compress the filesystem more effectively."
20581 msgstr ""
20582
20583 # type: textblock
20584 #. type: textblock
20585 #: ../src/guestfs-actions.pod:7422 ../fish/guestfish-actions.pod:4963
20586 msgid "You should B<not> run this program if the filesystem is mounted."
20587 msgstr ""
20588
20589 # type: textblock
20590 #. type: textblock
20591 #: ../src/guestfs-actions.pod:7425 ../fish/guestfish-actions.pod:4966
20592 msgid ""
20593 "It is possible that using this program can damage the filesystem or data on "
20594 "the filesystem."
20595 msgstr ""
20596
20597 # type: =head2
20598 #. type: =head2
20599 #: ../src/guestfs-actions.pod:7432
20600 msgid "guestfs_zfgrep"
20601 msgstr ""
20602
20603 # type: verbatim
20604 #. type: verbatim
20605 #: ../src/guestfs-actions.pod:7434
20606 #, no-wrap
20607 msgid ""
20608 " char **\n"
20609 " guestfs_zfgrep (guestfs_h *g,\n"
20610 "                 const char *pattern,\n"
20611 "                 const char *path);\n"
20612 "\n"
20613 msgstr ""
20614
20615 # type: textblock
20616 #. type: textblock
20617 #: ../src/guestfs-actions.pod:7439 ../fish/guestfish-actions.pod:4973
20618 msgid ""
20619 "This calls the external C<zfgrep> program and returns the matching lines."
20620 msgstr ""
20621
20622 # type: =head2
20623 #. type: =head2
20624 #: ../src/guestfs-actions.pod:7451
20625 msgid "guestfs_zfgrepi"
20626 msgstr ""
20627
20628 # type: verbatim
20629 #. type: verbatim
20630 #: ../src/guestfs-actions.pod:7453
20631 #, no-wrap
20632 msgid ""
20633 " char **\n"
20634 " guestfs_zfgrepi (guestfs_h *g,\n"
20635 "                  const char *pattern,\n"
20636 "                  const char *path);\n"
20637 "\n"
20638 msgstr ""
20639
20640 # type: textblock
20641 #. type: textblock
20642 #: ../src/guestfs-actions.pod:7458 ../fish/guestfish-actions.pod:4983
20643 msgid ""
20644 "This calls the external C<zfgrep -i> program and returns the matching lines."
20645 msgstr ""
20646
20647 # type: =head2
20648 #. type: =head2
20649 #: ../src/guestfs-actions.pod:7470
20650 msgid "guestfs_zfile"
20651 msgstr ""
20652
20653 # type: verbatim
20654 #. type: verbatim
20655 #: ../src/guestfs-actions.pod:7472
20656 #, no-wrap
20657 msgid ""
20658 " char *\n"
20659 " guestfs_zfile (guestfs_h *g,\n"
20660 "                const char *meth,\n"
20661 "                const char *path);\n"
20662 "\n"
20663 msgstr ""
20664
20665 # type: textblock
20666 #. type: textblock
20667 #: ../src/guestfs-actions.pod:7477 ../fish/guestfish-actions.pod:4993
20668 msgid ""
20669 "This command runs C<file> after first decompressing C<path> using C<method>."
20670 msgstr ""
20671
20672 # type: textblock
20673 #. type: textblock
20674 #: ../src/guestfs-actions.pod:7480 ../fish/guestfish-actions.pod:4996
20675 msgid "C<method> must be one of C<gzip>, C<compress> or C<bzip2>."
20676 msgstr ""
20677
20678 # type: textblock
20679 #. type: textblock
20680 #: ../src/guestfs-actions.pod:7482
20681 msgid ""
20682 "Since 1.0.63, use C<guestfs_file> instead which can now process compressed "
20683 "files."
20684 msgstr ""
20685
20686 # type: textblock
20687 #. type: textblock
20688 #: ../src/guestfs-actions.pod:7488 ../fish/guestfish-actions.pod:5001
20689 msgid ""
20690 "This function is deprecated.  In new code, use the C<file> call instead."
20691 msgstr ""
20692
20693 # type: =head2
20694 #. type: =head2
20695 #: ../src/guestfs-actions.pod:7497
20696 msgid "guestfs_zgrep"
20697 msgstr ""
20698
20699 # type: verbatim
20700 #. type: verbatim
20701 #: ../src/guestfs-actions.pod:7499
20702 #, no-wrap
20703 msgid ""
20704 " char **\n"
20705 " guestfs_zgrep (guestfs_h *g,\n"
20706 "                const char *regex,\n"
20707 "                const char *path);\n"
20708 "\n"
20709 msgstr ""
20710
20711 # type: textblock
20712 #. type: textblock
20713 #: ../src/guestfs-actions.pod:7504 ../fish/guestfish-actions.pod:5012
20714 msgid ""
20715 "This calls the external C<zgrep> program and returns the matching lines."
20716 msgstr ""
20717
20718 # type: =head2
20719 #. type: =head2
20720 #: ../src/guestfs-actions.pod:7516
20721 msgid "guestfs_zgrepi"
20722 msgstr ""
20723
20724 # type: verbatim
20725 #. type: verbatim
20726 #: ../src/guestfs-actions.pod:7518
20727 #, no-wrap
20728 msgid ""
20729 " char **\n"
20730 " guestfs_zgrepi (guestfs_h *g,\n"
20731 "                 const char *regex,\n"
20732 "                 const char *path);\n"
20733 "\n"
20734 msgstr ""
20735
20736 # type: textblock
20737 #. type: textblock
20738 #: ../src/guestfs-actions.pod:7523 ../fish/guestfish-actions.pod:5022
20739 msgid ""
20740 "This calls the external C<zgrep -i> program and returns the matching lines."
20741 msgstr ""
20742
20743 # type: =item
20744 #. type: =item
20745 #: ../src/guestfs-availability.pod:3
20746 msgid "B<augeas>"
20747 msgstr ""
20748
20749 # type: textblock
20750 #. type: textblock
20751 #: ../src/guestfs-availability.pod:5
20752 msgid ""
20753 "The following functions: L</guestfs_aug_clear> L</guestfs_aug_close> L</"
20754 "guestfs_aug_defnode> L</guestfs_aug_defvar> L</guestfs_aug_get> L</"
20755 "guestfs_aug_init> L</guestfs_aug_insert> L</guestfs_aug_load> L</"
20756 "guestfs_aug_ls> L</guestfs_aug_match> L</guestfs_aug_mv> L</guestfs_aug_rm> "
20757 "L</guestfs_aug_save> L</guestfs_aug_set>"
20758 msgstr ""
20759
20760 # type: =item
20761 #. type: =item
20762 #: ../src/guestfs-availability.pod:21
20763 msgid "B<inotify>"
20764 msgstr ""
20765
20766 # type: textblock
20767 #. type: textblock
20768 #: ../src/guestfs-availability.pod:23
20769 msgid ""
20770 "The following functions: L</guestfs_inotify_add_watch> L</"
20771 "guestfs_inotify_close> L</guestfs_inotify_files> L</guestfs_inotify_init> L</"
20772 "guestfs_inotify_read> L</guestfs_inotify_rm_watch>"
20773 msgstr ""
20774
20775 # type: =item
20776 #. type: =item
20777 #: ../src/guestfs-availability.pod:31
20778 msgid "B<linuxfsuuid>"
20779 msgstr ""
20780
20781 # type: textblock
20782 #. type: textblock
20783 #: ../src/guestfs-availability.pod:33
20784 msgid ""
20785 "The following functions: L</guestfs_mke2fs_JU> L</guestfs_mke2journal_U> L</"
20786 "guestfs_mkswap_U> L</guestfs_swapoff_uuid> L</guestfs_swapon_uuid>"
20787 msgstr ""
20788
20789 # type: =item
20790 #. type: =item
20791 #: ../src/guestfs-availability.pod:40
20792 msgid "B<linuxmodules>"
20793 msgstr ""
20794
20795 # type: textblock
20796 #. type: textblock
20797 #: ../src/guestfs-availability.pod:42
20798 msgid "The following functions: L</guestfs_modprobe>"
20799 msgstr ""
20800
20801 # type: =item
20802 #. type: =item
20803 #: ../src/guestfs-availability.pod:45
20804 msgid "B<linuxxattrs>"
20805 msgstr ""
20806
20807 # type: textblock
20808 #. type: textblock
20809 #: ../src/guestfs-availability.pod:47
20810 msgid ""
20811 "The following functions: L</guestfs_getxattr> L</guestfs_getxattrs> L</"
20812 "guestfs_lgetxattr> L</guestfs_lgetxattrs> L</guestfs_lremovexattr> L</"
20813 "guestfs_lsetxattr> L</guestfs_lxattrlist> L</guestfs_removexattr> L</"
20814 "guestfs_setxattr>"
20815 msgstr ""
20816
20817 # type: =item
20818 #. type: =item
20819 #: ../src/guestfs-availability.pod:58
20820 msgid "B<luks>"
20821 msgstr ""
20822
20823 # type: textblock
20824 #. type: textblock
20825 #: ../src/guestfs-availability.pod:60
20826 msgid ""
20827 "The following functions: L</guestfs_luks_add_key> L</guestfs_luks_close> L</"
20828 "guestfs_luks_format> L</guestfs_luks_format_cipher> L</"
20829 "guestfs_luks_kill_slot> L</guestfs_luks_open> L</guestfs_luks_open_ro>"
20830 msgstr ""
20831
20832 # type: =item
20833 #. type: =item
20834 #: ../src/guestfs-availability.pod:69
20835 msgid "B<lvm2>"
20836 msgstr ""
20837
20838 # type: textblock
20839 #. type: textblock
20840 #: ../src/guestfs-availability.pod:71
20841 msgid ""
20842 "The following functions: L</guestfs_is_lv> L</guestfs_lvcreate> L</"
20843 "guestfs_lvm_remove_all> L</guestfs_lvm_set_filter> L</guestfs_lvremove> L</"
20844 "guestfs_lvresize> L</guestfs_lvresize_free> L</guestfs_lvs> L</"
20845 "guestfs_lvs_full> L</guestfs_pvcreate> L</guestfs_pvremove> L</"
20846 "guestfs_pvresize> L</guestfs_pvresize_size> L</guestfs_pvs> L</"
20847 "guestfs_pvs_full> L</guestfs_vg_activate> L</guestfs_vg_activate_all> L</"
20848 "guestfs_vgcreate> L</guestfs_vgremove> L</guestfs_vgs> L</guestfs_vgs_full>"
20849 msgstr ""
20850
20851 # type: =item
20852 #. type: =item
20853 #: ../src/guestfs-availability.pod:94
20854 msgid "B<mknod>"
20855 msgstr ""
20856
20857 # type: textblock
20858 #. type: textblock
20859 #: ../src/guestfs-availability.pod:96
20860 msgid ""
20861 "The following functions: L</guestfs_mkfifo> L</guestfs_mknod> L</"
20862 "guestfs_mknod_b> L</guestfs_mknod_c>"
20863 msgstr ""
20864
20865 # type: =item
20866 #. type: =item
20867 #: ../src/guestfs-availability.pod:102
20868 msgid "B<ntfs3g>"
20869 msgstr ""
20870
20871 # type: textblock
20872 #. type: textblock
20873 #: ../src/guestfs-availability.pod:104
20874 msgid "The following functions: L</guestfs_ntfs_3g_probe>"
20875 msgstr ""
20876
20877 # type: =item
20878 #. type: =item
20879 #: ../src/guestfs-availability.pod:107
20880 msgid "B<ntfsprogs>"
20881 msgstr ""
20882
20883 # type: textblock
20884 #. type: textblock
20885 #: ../src/guestfs-availability.pod:109
20886 msgid ""
20887 "The following functions: L</guestfs_ntfsresize> L</guestfs_ntfsresize_size>"
20888 msgstr ""
20889
20890 # type: =item
20891 #. type: =item
20892 #: ../src/guestfs-availability.pod:113
20893 msgid "B<realpath>"
20894 msgstr ""
20895
20896 # type: textblock
20897 #. type: textblock
20898 #: ../src/guestfs-availability.pod:115
20899 msgid "The following functions: L</guestfs_realpath>"
20900 msgstr ""
20901
20902 # type: =item
20903 #. type: =item
20904 #: ../src/guestfs-availability.pod:118
20905 msgid "B<scrub>"
20906 msgstr ""
20907
20908 # type: textblock
20909 #. type: textblock
20910 #: ../src/guestfs-availability.pod:120
20911 msgid ""
20912 "The following functions: L</guestfs_scrub_device> L</guestfs_scrub_file> L</"
20913 "guestfs_scrub_freespace>"
20914 msgstr ""
20915
20916 # type: =item
20917 #. type: =item
20918 #: ../src/guestfs-availability.pod:125
20919 msgid "B<selinux>"
20920 msgstr ""
20921
20922 # type: textblock
20923 #. type: textblock
20924 #: ../src/guestfs-availability.pod:127
20925 msgid "The following functions: L</guestfs_getcon> L</guestfs_setcon>"
20926 msgstr ""
20927
20928 # type: =item
20929 #. type: =item
20930 #: ../src/guestfs-availability.pod:131
20931 msgid "B<xz>"
20932 msgstr ""
20933
20934 # type: textblock
20935 #. type: textblock
20936 #: ../src/guestfs-availability.pod:133
20937 msgid "The following functions: L</guestfs_txz_in> L</guestfs_txz_out>"
20938 msgstr ""
20939
20940 # type: =item
20941 #. type: =item
20942 #: ../src/guestfs-availability.pod:137
20943 msgid "B<zerofree>"
20944 msgstr ""
20945
20946 # type: textblock
20947 #. type: textblock
20948 #: ../src/guestfs-availability.pod:139
20949 msgid "The following functions: L</guestfs_zerofree>"
20950 msgstr ""
20951
20952 # type: =head2
20953 #. type: =head2
20954 #: ../src/guestfs-structs.pod:1
20955 msgid "guestfs_int_bool"
20956 msgstr ""
20957
20958 # type: verbatim
20959 #. type: verbatim
20960 #: ../src/guestfs-structs.pod:3
20961 #, no-wrap
20962 msgid ""
20963 " struct guestfs_int_bool {\n"
20964 "   int32_t i;\n"
20965 "   int32_t b;\n"
20966 " };\n"
20967 " \n"
20968 msgstr ""
20969
20970 # type: verbatim
20971 #. type: verbatim
20972 #: ../src/guestfs-structs.pod:8
20973 #, no-wrap
20974 msgid ""
20975 " struct guestfs_int_bool_list {\n"
20976 "   uint32_t len; /* Number of elements in list. */\n"
20977 "   struct guestfs_int_bool *val; /* Elements. */\n"
20978 " };\n"
20979 " \n"
20980 msgstr ""
20981
20982 # type: verbatim
20983 #. type: verbatim
20984 #: ../src/guestfs-structs.pod:13
20985 #, no-wrap
20986 msgid ""
20987 " void guestfs_free_int_bool (struct guestfs_free_int_bool *);\n"
20988 " void guestfs_free_int_bool_list (struct guestfs_free_int_bool_list *);\n"
20989 "\n"
20990 msgstr ""
20991
20992 # type: =head2
20993 #. type: =head2
20994 #: ../src/guestfs-structs.pod:16
20995 msgid "guestfs_lvm_pv"
20996 msgstr ""
20997
20998 # type: verbatim
20999 #. type: verbatim
21000 #: ../src/guestfs-structs.pod:18
21001 #, no-wrap
21002 msgid ""
21003 " struct guestfs_lvm_pv {\n"
21004 "   char *pv_name;\n"
21005 "   /* The next field is NOT nul-terminated, be careful when printing it: */\n"
21006 "   char pv_uuid[32];\n"
21007 "   char *pv_fmt;\n"
21008 "   uint64_t pv_size;\n"
21009 "   uint64_t dev_size;\n"
21010 "   uint64_t pv_free;\n"
21011 "   uint64_t pv_used;\n"
21012 "   char *pv_attr;\n"
21013 "   int64_t pv_pe_count;\n"
21014 "   int64_t pv_pe_alloc_count;\n"
21015 "   char *pv_tags;\n"
21016 "   uint64_t pe_start;\n"
21017 "   int64_t pv_mda_count;\n"
21018 "   uint64_t pv_mda_free;\n"
21019 " };\n"
21020 " \n"
21021 msgstr ""
21022
21023 # type: verbatim
21024 #. type: verbatim
21025 #: ../src/guestfs-structs.pod:36
21026 #, no-wrap
21027 msgid ""
21028 " struct guestfs_lvm_pv_list {\n"
21029 "   uint32_t len; /* Number of elements in list. */\n"
21030 "   struct guestfs_lvm_pv *val; /* Elements. */\n"
21031 " };\n"
21032 " \n"
21033 msgstr ""
21034
21035 # type: verbatim
21036 #. type: verbatim
21037 #: ../src/guestfs-structs.pod:41
21038 #, no-wrap
21039 msgid ""
21040 " void guestfs_free_lvm_pv (struct guestfs_free_lvm_pv *);\n"
21041 " void guestfs_free_lvm_pv_list (struct guestfs_free_lvm_pv_list *);\n"
21042 "\n"
21043 msgstr ""
21044
21045 # type: =head2
21046 #. type: =head2
21047 #: ../src/guestfs-structs.pod:44
21048 msgid "guestfs_lvm_vg"
21049 msgstr ""
21050
21051 # type: verbatim
21052 #. type: verbatim
21053 #: ../src/guestfs-structs.pod:46
21054 #, no-wrap
21055 msgid ""
21056 " struct guestfs_lvm_vg {\n"
21057 "   char *vg_name;\n"
21058 "   /* The next field is NOT nul-terminated, be careful when printing it: */\n"
21059 "   char vg_uuid[32];\n"
21060 "   char *vg_fmt;\n"
21061 "   char *vg_attr;\n"
21062 "   uint64_t vg_size;\n"
21063 "   uint64_t vg_free;\n"
21064 "   char *vg_sysid;\n"
21065 "   uint64_t vg_extent_size;\n"
21066 "   int64_t vg_extent_count;\n"
21067 "   int64_t vg_free_count;\n"
21068 "   int64_t max_lv;\n"
21069 "   int64_t max_pv;\n"
21070 "   int64_t pv_count;\n"
21071 "   int64_t lv_count;\n"
21072 "   int64_t snap_count;\n"
21073 "   int64_t vg_seqno;\n"
21074 "   char *vg_tags;\n"
21075 "   int64_t vg_mda_count;\n"
21076 "   uint64_t vg_mda_free;\n"
21077 " };\n"
21078 " \n"
21079 msgstr ""
21080
21081 # type: verbatim
21082 #. type: verbatim
21083 #: ../src/guestfs-structs.pod:69
21084 #, no-wrap
21085 msgid ""
21086 " struct guestfs_lvm_vg_list {\n"
21087 "   uint32_t len; /* Number of elements in list. */\n"
21088 "   struct guestfs_lvm_vg *val; /* Elements. */\n"
21089 " };\n"
21090 " \n"
21091 msgstr ""
21092
21093 # type: verbatim
21094 #. type: verbatim
21095 #: ../src/guestfs-structs.pod:74
21096 #, no-wrap
21097 msgid ""
21098 " void guestfs_free_lvm_vg (struct guestfs_free_lvm_vg *);\n"
21099 " void guestfs_free_lvm_vg_list (struct guestfs_free_lvm_vg_list *);\n"
21100 "\n"
21101 msgstr ""
21102
21103 # type: =head2
21104 #. type: =head2
21105 #: ../src/guestfs-structs.pod:77
21106 msgid "guestfs_lvm_lv"
21107 msgstr ""
21108
21109 # type: verbatim
21110 #. type: verbatim
21111 #: ../src/guestfs-structs.pod:79
21112 #, no-wrap
21113 msgid ""
21114 " struct guestfs_lvm_lv {\n"
21115 "   char *lv_name;\n"
21116 "   /* The next field is NOT nul-terminated, be careful when printing it: */\n"
21117 "   char lv_uuid[32];\n"
21118 "   char *lv_attr;\n"
21119 "   int64_t lv_major;\n"
21120 "   int64_t lv_minor;\n"
21121 "   int64_t lv_kernel_major;\n"
21122 "   int64_t lv_kernel_minor;\n"
21123 "   uint64_t lv_size;\n"
21124 "   int64_t seg_count;\n"
21125 "   char *origin;\n"
21126 "   /* The next field is [0..100] or -1 meaning 'not present': */\n"
21127 "   float snap_percent;\n"
21128 "   /* The next field is [0..100] or -1 meaning 'not present': */\n"
21129 "   float copy_percent;\n"
21130 "   char *move_pv;\n"
21131 "   char *lv_tags;\n"
21132 "   char *mirror_log;\n"
21133 "   char *modules;\n"
21134 " };\n"
21135 " \n"
21136 msgstr ""
21137
21138 # type: verbatim
21139 #. type: verbatim
21140 #: ../src/guestfs-structs.pod:101
21141 #, no-wrap
21142 msgid ""
21143 " struct guestfs_lvm_lv_list {\n"
21144 "   uint32_t len; /* Number of elements in list. */\n"
21145 "   struct guestfs_lvm_lv *val; /* Elements. */\n"
21146 " };\n"
21147 " \n"
21148 msgstr ""
21149
21150 # type: verbatim
21151 #. type: verbatim
21152 #: ../src/guestfs-structs.pod:106
21153 #, no-wrap
21154 msgid ""
21155 " void guestfs_free_lvm_lv (struct guestfs_free_lvm_lv *);\n"
21156 " void guestfs_free_lvm_lv_list (struct guestfs_free_lvm_lv_list *);\n"
21157 "\n"
21158 msgstr ""
21159
21160 # type: verbatim
21161 #. type: verbatim
21162 #: ../src/guestfs-structs.pod:111
21163 #, no-wrap
21164 msgid ""
21165 " struct guestfs_stat {\n"
21166 "   int64_t dev;\n"
21167 "   int64_t ino;\n"
21168 "   int64_t mode;\n"
21169 "   int64_t nlink;\n"
21170 "   int64_t uid;\n"
21171 "   int64_t gid;\n"
21172 "   int64_t rdev;\n"
21173 "   int64_t size;\n"
21174 "   int64_t blksize;\n"
21175 "   int64_t blocks;\n"
21176 "   int64_t atime;\n"
21177 "   int64_t mtime;\n"
21178 "   int64_t ctime;\n"
21179 " };\n"
21180 " \n"
21181 msgstr ""
21182
21183 # type: verbatim
21184 #. type: verbatim
21185 #: ../src/guestfs-structs.pod:127
21186 #, no-wrap
21187 msgid ""
21188 " struct guestfs_stat_list {\n"
21189 "   uint32_t len; /* Number of elements in list. */\n"
21190 "   struct guestfs_stat *val; /* Elements. */\n"
21191 " };\n"
21192 " \n"
21193 msgstr ""
21194
21195 # type: verbatim
21196 #. type: verbatim
21197 #: ../src/guestfs-structs.pod:132
21198 #, no-wrap
21199 msgid ""
21200 " void guestfs_free_stat (struct guestfs_free_stat *);\n"
21201 " void guestfs_free_stat_list (struct guestfs_free_stat_list *);\n"
21202 "\n"
21203 msgstr ""
21204
21205 # type: verbatim
21206 #. type: verbatim
21207 #: ../src/guestfs-structs.pod:137
21208 #, no-wrap
21209 msgid ""
21210 " struct guestfs_statvfs {\n"
21211 "   int64_t bsize;\n"
21212 "   int64_t frsize;\n"
21213 "   int64_t blocks;\n"
21214 "   int64_t bfree;\n"
21215 "   int64_t bavail;\n"
21216 "   int64_t files;\n"
21217 "   int64_t ffree;\n"
21218 "   int64_t favail;\n"
21219 "   int64_t fsid;\n"
21220 "   int64_t flag;\n"
21221 "   int64_t namemax;\n"
21222 " };\n"
21223 " \n"
21224 msgstr ""
21225
21226 # type: verbatim
21227 #. type: verbatim
21228 #: ../src/guestfs-structs.pod:151
21229 #, no-wrap
21230 msgid ""
21231 " struct guestfs_statvfs_list {\n"
21232 "   uint32_t len; /* Number of elements in list. */\n"
21233 "   struct guestfs_statvfs *val; /* Elements. */\n"
21234 " };\n"
21235 " \n"
21236 msgstr ""
21237
21238 # type: verbatim
21239 #. type: verbatim
21240 #: ../src/guestfs-structs.pod:156
21241 #, no-wrap
21242 msgid ""
21243 " void guestfs_free_statvfs (struct guestfs_free_statvfs *);\n"
21244 " void guestfs_free_statvfs_list (struct guestfs_free_statvfs_list *);\n"
21245 "\n"
21246 msgstr ""
21247
21248 # type: =head2
21249 #. type: =head2
21250 #: ../src/guestfs-structs.pod:159
21251 msgid "guestfs_dirent"
21252 msgstr ""
21253
21254 # type: verbatim
21255 #. type: verbatim
21256 #: ../src/guestfs-structs.pod:161
21257 #, no-wrap
21258 msgid ""
21259 " struct guestfs_dirent {\n"
21260 "   int64_t ino;\n"
21261 "   char ftyp;\n"
21262 "   char *name;\n"
21263 " };\n"
21264 " \n"
21265 msgstr ""
21266
21267 # type: verbatim
21268 #. type: verbatim
21269 #: ../src/guestfs-structs.pod:167
21270 #, no-wrap
21271 msgid ""
21272 " struct guestfs_dirent_list {\n"
21273 "   uint32_t len; /* Number of elements in list. */\n"
21274 "   struct guestfs_dirent *val; /* Elements. */\n"
21275 " };\n"
21276 " \n"
21277 msgstr ""
21278
21279 # type: verbatim
21280 #. type: verbatim
21281 #: ../src/guestfs-structs.pod:172
21282 #, no-wrap
21283 msgid ""
21284 " void guestfs_free_dirent (struct guestfs_free_dirent *);\n"
21285 " void guestfs_free_dirent_list (struct guestfs_free_dirent_list *);\n"
21286 "\n"
21287 msgstr ""
21288
21289 # type: verbatim
21290 #. type: verbatim
21291 #: ../src/guestfs-structs.pod:177
21292 #, no-wrap
21293 msgid ""
21294 " struct guestfs_version {\n"
21295 "   int64_t major;\n"
21296 "   int64_t minor;\n"
21297 "   int64_t release;\n"
21298 "   char *extra;\n"
21299 " };\n"
21300 " \n"
21301 msgstr ""
21302
21303 # type: verbatim
21304 #. type: verbatim
21305 #: ../src/guestfs-structs.pod:184
21306 #, no-wrap
21307 msgid ""
21308 " struct guestfs_version_list {\n"
21309 "   uint32_t len; /* Number of elements in list. */\n"
21310 "   struct guestfs_version *val; /* Elements. */\n"
21311 " };\n"
21312 " \n"
21313 msgstr ""
21314
21315 # type: verbatim
21316 #. type: verbatim
21317 #: ../src/guestfs-structs.pod:189
21318 #, no-wrap
21319 msgid ""
21320 " void guestfs_free_version (struct guestfs_free_version *);\n"
21321 " void guestfs_free_version_list (struct guestfs_free_version_list *);\n"
21322 "\n"
21323 msgstr ""
21324
21325 # type: =head2
21326 #. type: =head2
21327 #: ../src/guestfs-structs.pod:192
21328 msgid "guestfs_xattr"
21329 msgstr ""
21330
21331 # type: verbatim
21332 #. type: verbatim
21333 #: ../src/guestfs-structs.pod:194
21334 #, no-wrap
21335 msgid ""
21336 " struct guestfs_xattr {\n"
21337 "   char *attrname;\n"
21338 "   /* The next two fields describe a byte array. */\n"
21339 "   uint32_t attrval_len;\n"
21340 "   char *attrval;\n"
21341 " };\n"
21342 " \n"
21343 msgstr ""
21344
21345 # type: verbatim
21346 #. type: verbatim
21347 #: ../src/guestfs-structs.pod:201
21348 #, no-wrap
21349 msgid ""
21350 " struct guestfs_xattr_list {\n"
21351 "   uint32_t len; /* Number of elements in list. */\n"
21352 "   struct guestfs_xattr *val; /* Elements. */\n"
21353 " };\n"
21354 " \n"
21355 msgstr ""
21356
21357 # type: verbatim
21358 #. type: verbatim
21359 #: ../src/guestfs-structs.pod:206
21360 #, no-wrap
21361 msgid ""
21362 " void guestfs_free_xattr (struct guestfs_free_xattr *);\n"
21363 " void guestfs_free_xattr_list (struct guestfs_free_xattr_list *);\n"
21364 "\n"
21365 msgstr ""
21366
21367 # type: =head2
21368 #. type: =head2
21369 #: ../src/guestfs-structs.pod:209
21370 msgid "guestfs_inotify_event"
21371 msgstr ""
21372
21373 # type: verbatim
21374 #. type: verbatim
21375 #: ../src/guestfs-structs.pod:211
21376 #, no-wrap
21377 msgid ""
21378 " struct guestfs_inotify_event {\n"
21379 "   int64_t in_wd;\n"
21380 "   uint32_t in_mask;\n"
21381 "   uint32_t in_cookie;\n"
21382 "   char *in_name;\n"
21383 " };\n"
21384 " \n"
21385 msgstr ""
21386
21387 # type: verbatim
21388 #. type: verbatim
21389 #: ../src/guestfs-structs.pod:218
21390 #, no-wrap
21391 msgid ""
21392 " struct guestfs_inotify_event_list {\n"
21393 "   uint32_t len; /* Number of elements in list. */\n"
21394 "   struct guestfs_inotify_event *val; /* Elements. */\n"
21395 " };\n"
21396 " \n"
21397 msgstr ""
21398
21399 # type: verbatim
21400 #. type: verbatim
21401 #: ../src/guestfs-structs.pod:223
21402 #, no-wrap
21403 msgid ""
21404 " void guestfs_free_inotify_event (struct guestfs_free_inotify_event *);\n"
21405 " void guestfs_free_inotify_event_list (struct guestfs_free_inotify_event_list *);\n"
21406 "\n"
21407 msgstr ""
21408
21409 # type: =head2
21410 #. type: =head2
21411 #: ../src/guestfs-structs.pod:226
21412 msgid "guestfs_partition"
21413 msgstr ""
21414
21415 # type: verbatim
21416 #. type: verbatim
21417 #: ../src/guestfs-structs.pod:228
21418 #, no-wrap
21419 msgid ""
21420 " struct guestfs_partition {\n"
21421 "   int32_t part_num;\n"
21422 "   uint64_t part_start;\n"
21423 "   uint64_t part_end;\n"
21424 "   uint64_t part_size;\n"
21425 " };\n"
21426 " \n"
21427 msgstr ""
21428
21429 # type: verbatim
21430 #. type: verbatim
21431 #: ../src/guestfs-structs.pod:235
21432 #, no-wrap
21433 msgid ""
21434 " struct guestfs_partition_list {\n"
21435 "   uint32_t len; /* Number of elements in list. */\n"
21436 "   struct guestfs_partition *val; /* Elements. */\n"
21437 " };\n"
21438 " \n"
21439 msgstr ""
21440
21441 # type: verbatim
21442 #. type: verbatim
21443 #: ../src/guestfs-structs.pod:240
21444 #, no-wrap
21445 msgid ""
21446 " void guestfs_free_partition (struct guestfs_free_partition *);\n"
21447 " void guestfs_free_partition_list (struct guestfs_free_partition_list *);\n"
21448 "\n"
21449 msgstr ""
21450
21451 # type: =head2
21452 #. type: =head2
21453 #: ../src/guestfs-structs.pod:243
21454 msgid "guestfs_application"
21455 msgstr ""
21456
21457 # type: verbatim
21458 #. type: verbatim
21459 #: ../src/guestfs-structs.pod:245
21460 #, no-wrap
21461 msgid ""
21462 " struct guestfs_application {\n"
21463 "   char *app_name;\n"
21464 "   char *app_display_name;\n"
21465 "   int32_t app_epoch;\n"
21466 "   char *app_version;\n"
21467 "   char *app_release;\n"
21468 "   char *app_install_path;\n"
21469 "   char *app_trans_path;\n"
21470 "   char *app_publisher;\n"
21471 "   char *app_url;\n"
21472 "   char *app_source_package;\n"
21473 "   char *app_summary;\n"
21474 "   char *app_description;\n"
21475 " };\n"
21476 " \n"
21477 msgstr ""
21478
21479 # type: verbatim
21480 #. type: verbatim
21481 #: ../src/guestfs-structs.pod:260
21482 #, no-wrap
21483 msgid ""
21484 " struct guestfs_application_list {\n"
21485 "   uint32_t len; /* Number of elements in list. */\n"
21486 "   struct guestfs_application *val; /* Elements. */\n"
21487 " };\n"
21488 " \n"
21489 msgstr ""
21490
21491 # type: verbatim
21492 #. type: verbatim
21493 #: ../src/guestfs-structs.pod:265
21494 #, no-wrap
21495 msgid ""
21496 " void guestfs_free_application (struct guestfs_free_application *);\n"
21497 " void guestfs_free_application_list (struct guestfs_free_application_list *);\n"
21498 "\n"
21499 msgstr ""
21500
21501 # type: textblock
21502 #. type: textblock
21503 #: ../fish/guestfish.pod:5
21504 msgid "guestfish - the libguestfs Filesystem Interactive SHell"
21505 msgstr ""
21506
21507 # type: verbatim
21508 #. type: verbatim
21509 #: ../fish/guestfish.pod:9
21510 #, no-wrap
21511 msgid ""
21512 " guestfish [--options] [commands]\n"
21513 "\n"
21514 msgstr ""
21515
21516 # type: verbatim
21517 #. type: verbatim
21518 #: ../fish/guestfish.pod:11
21519 #, no-wrap
21520 msgid ""
21521 " guestfish\n"
21522 "\n"
21523 msgstr ""
21524
21525 # type: verbatim
21526 #. type: verbatim
21527 #: ../fish/guestfish.pod:13
21528 #, no-wrap
21529 msgid ""
21530 " guestfish [--ro|--rw] -a disk.img\n"
21531 "\n"
21532 msgstr ""
21533
21534 # type: verbatim
21535 #. type: verbatim
21536 #: ../fish/guestfish.pod:15
21537 #, no-wrap
21538 msgid ""
21539 " guestfish [--ro|--rw] -a disk.img -m dev[:mountpoint]\n"
21540 "\n"
21541 msgstr ""
21542
21543 # type: verbatim
21544 #. type: verbatim
21545 #: ../fish/guestfish.pod:17
21546 #, no-wrap
21547 msgid ""
21548 " guestfish -d libvirt-domain\n"
21549 "\n"
21550 msgstr ""
21551
21552 # type: verbatim
21553 #. type: verbatim
21554 #: ../fish/guestfish.pod:19
21555 #, no-wrap
21556 msgid ""
21557 " guestfish [--ro|--rw] -a disk.img -i\n"
21558 "\n"
21559 msgstr ""
21560
21561 # type: verbatim
21562 #. type: verbatim
21563 #: ../fish/guestfish.pod:21
21564 #, no-wrap
21565 msgid ""
21566 " guestfish -d libvirt-domain -i\n"
21567 "\n"
21568 msgstr ""
21569
21570 # type: =head1
21571 #. type: =head1
21572 #: ../fish/guestfish.pod:23 ../fuse/guestmount.pod:15 ../tools/virt-edit.pl:44
21573 #: ../tools/virt-win-reg.pl:51 ../tools/virt-tar.pl:64
21574 msgid "WARNING"
21575 msgstr ""
21576
21577 # type: textblock
21578 #. type: textblock
21579 #: ../fish/guestfish.pod:25
21580 msgid ""
21581 "Using guestfish in read/write mode on live virtual machines can be "
21582 "dangerous, potentially causing disk corruption.  Use the I<--ro> (read-only) "
21583 "option to use guestfish safely if the disk image or virtual machine might be "
21584 "live."
21585 msgstr ""
21586
21587 # type: textblock
21588 #. type: textblock
21589 #: ../fish/guestfish.pod:32
21590 msgid ""
21591 "Guestfish is a shell and command-line tool for examining and modifying "
21592 "virtual machine filesystems.  It uses libguestfs and exposes all of the "
21593 "functionality of the guestfs API, see L<guestfs(3)>."
21594 msgstr ""
21595
21596 # type: textblock
21597 #. type: textblock
21598 #: ../fish/guestfish.pod:36
21599 msgid ""
21600 "Guestfish gives you structured access to the libguestfs API, from shell "
21601 "scripts or the command line or interactively.  If you want to rescue a "
21602 "broken virtual machine image, you should look at the L<virt-rescue(1)> "
21603 "command."
21604 msgstr ""
21605
21606 # type: =head1
21607 #. type: =head1
21608 #: ../fish/guestfish.pod:41 ../fish/guestfish.pod:947
21609 #: ../fuse/guestmount.pod:39 ../tools/virt-edit.pl:63 ../tools/virt-tar.pl:50
21610 msgid "EXAMPLES"
21611 msgstr ""
21612
21613 # type: =head2
21614 #. type: =head2
21615 #: ../fish/guestfish.pod:43
21616 msgid "As an interactive shell"
21617 msgstr ""
21618
21619 # type: verbatim
21620 #. type: verbatim
21621 #: ../fish/guestfish.pod:45
21622 #, no-wrap
21623 msgid ""
21624 " $ guestfish\n"
21625 " \n"
21626 msgstr ""
21627
21628 # type: verbatim
21629 #. type: verbatim
21630 #: ../fish/guestfish.pod:47
21631 #, no-wrap
21632 msgid ""
21633 " Welcome to guestfish, the libguestfs filesystem interactive shell for\n"
21634 " editing virtual machine filesystems.\n"
21635 " \n"
21636 msgstr ""
21637
21638 # type: verbatim
21639 #. type: verbatim
21640 #: ../fish/guestfish.pod:50
21641 #, no-wrap
21642 msgid ""
21643 " Type: 'help' for a list of commands\n"
21644 "       'man' to read the manual\n"
21645 "       'quit' to quit the shell\n"
21646 " \n"
21647 msgstr ""
21648
21649 # type: verbatim
21650 #. type: verbatim
21651 #: ../fish/guestfish.pod:54
21652 #, no-wrap
21653 msgid ""
21654 " ><fs> add-ro disk.img\n"
21655 " ><fs> run\n"
21656 " ><fs> list-filesystems\n"
21657 " /dev/sda1: ext4\n"
21658 " /dev/vg_guest/lv_root: ext4\n"
21659 " /dev/vg_guest/lv_swap: swap\n"
21660 " ><fs> mount /dev/vg_guest/lv_root /\n"
21661 " ><fs> cat /etc/fstab\n"
21662 " # /etc/fstab\n"
21663 " # Created by anaconda\n"
21664 " [...]\n"
21665 " ><fs> exit\n"
21666 "\n"
21667 msgstr ""
21668
21669 # type: =head2
21670 #. type: =head2
21671 #: ../fish/guestfish.pod:67
21672 msgid "From shell scripts"
21673 msgstr ""
21674
21675 # type: textblock
21676 #. type: textblock
21677 #: ../fish/guestfish.pod:69
21678 msgid "Create a new C</etc/motd> file in a guest or disk image:"
21679 msgstr ""
21680
21681 # type: verbatim
21682 #. type: verbatim
21683 #: ../fish/guestfish.pod:71
21684 #, no-wrap
21685 msgid ""
21686 " guestfish <<_EOF_\n"
21687 " add disk.img\n"
21688 " run\n"
21689 " mount /dev/vg_guest/lv_root /\n"
21690 " write /etc/motd \"Welcome, new users\"\n"
21691 " _EOF_\n"
21692 "\n"
21693 msgstr ""
21694
21695 # type: textblock
21696 #. type: textblock
21697 #: ../fish/guestfish.pod:78
21698 msgid "List the LVM logical volumes in a disk image:"
21699 msgstr ""
21700
21701 # type: verbatim
21702 #. type: verbatim
21703 #: ../fish/guestfish.pod:80
21704 #, no-wrap
21705 msgid ""
21706 " guestfish -a disk.img --ro <<_EOF_\n"
21707 " run\n"
21708 " lvs\n"
21709 " _EOF_\n"
21710 "\n"
21711 msgstr ""
21712
21713 # type: textblock
21714 #. type: textblock
21715 #: ../fish/guestfish.pod:85
21716 msgid "List all the filesystems in a disk image:"
21717 msgstr ""
21718
21719 # type: verbatim
21720 #. type: verbatim
21721 #: ../fish/guestfish.pod:87
21722 #, no-wrap
21723 msgid ""
21724 " guestfish -a disk.img --ro <<_EOF_\n"
21725 " run\n"
21726 " list-filesystems\n"
21727 " _EOF_\n"
21728 "\n"
21729 msgstr ""
21730
21731 # type: =head2
21732 #. type: =head2
21733 #: ../fish/guestfish.pod:92
21734 msgid "On one command line"
21735 msgstr ""
21736
21737 # type: textblock
21738 #. type: textblock
21739 #: ../fish/guestfish.pod:94
21740 msgid "Update C</etc/resolv.conf> in a guest:"
21741 msgstr ""
21742
21743 # type: verbatim
21744 #. type: verbatim
21745 #: ../fish/guestfish.pod:96
21746 #, no-wrap
21747 msgid ""
21748 " guestfish \\\n"
21749 "   add disk.img : run : mount /dev/vg_guest/lv_root / : \\\n"
21750 "   write /etc/resolv.conf \"nameserver 1.2.3.4\"\n"
21751 "\n"
21752 msgstr ""
21753
21754 # type: textblock
21755 #. type: textblock
21756 #: ../fish/guestfish.pod:100
21757 msgid "Edit C</boot/grub/grub.conf> interactively:"
21758 msgstr ""
21759
21760 # type: verbatim
21761 #. type: verbatim
21762 #: ../fish/guestfish.pod:102
21763 #, no-wrap
21764 msgid ""
21765 " guestfish --rw --add disk.img \\\n"
21766 "   --mount /dev/vg_guest/lv_root \\\n"
21767 "   --mount /dev/sda1:/boot \\\n"
21768 "   edit /boot/grub/grub.conf\n"
21769 "\n"
21770 msgstr ""
21771
21772 # type: =head2
21773 #. type: =head2
21774 #: ../fish/guestfish.pod:107
21775 msgid "Mount disks automatically"
21776 msgstr ""
21777
21778 # type: textblock
21779 #. type: textblock
21780 #: ../fish/guestfish.pod:109
21781 msgid ""
21782 "Use the I<-i> option to automatically mount the disks from a virtual machine:"
21783 msgstr ""
21784
21785 # type: verbatim
21786 #. type: verbatim
21787 #: ../fish/guestfish.pod:112
21788 #, no-wrap
21789 msgid ""
21790 " guestfish --ro -a disk.img -i cat /etc/group\n"
21791 "\n"
21792 msgstr ""
21793
21794 # type: verbatim
21795 #. type: verbatim
21796 #: ../fish/guestfish.pod:114
21797 #, no-wrap
21798 msgid ""
21799 " guestfish --ro -d libvirt-domain -i cat /etc/group\n"
21800 "\n"
21801 msgstr ""
21802
21803 # type: textblock
21804 #. type: textblock
21805 #: ../fish/guestfish.pod:116
21806 msgid "Another way to edit C</boot/grub/grub.conf> interactively is:"
21807 msgstr ""
21808
21809 # type: verbatim
21810 #. type: verbatim
21811 #: ../fish/guestfish.pod:118
21812 #, no-wrap
21813 msgid ""
21814 " guestfish --rw -a disk.img -i edit /boot/grub/grub.conf\n"
21815 "\n"
21816 msgstr ""
21817
21818 # type: =head2
21819 #. type: =head2
21820 #: ../fish/guestfish.pod:120
21821 msgid "As a script interpreter"
21822 msgstr ""
21823
21824 # type: textblock
21825 #. type: textblock
21826 #: ../fish/guestfish.pod:122
21827 msgid "Create a 100MB disk containing an ext2-formatted partition:"
21828 msgstr ""
21829
21830 # type: verbatim
21831 #. type: verbatim
21832 #: ../fish/guestfish.pod:124
21833 #, no-wrap
21834 msgid ""
21835 " #!/usr/bin/guestfish -f\n"
21836 " sparse test1.img 100M\n"
21837 " run\n"
21838 " part-disk /dev/sda mbr\n"
21839 " mkfs ext2 /dev/sda1\n"
21840 "\n"
21841 msgstr ""
21842
21843 # type: =head2
21844 #. type: =head2
21845 #: ../fish/guestfish.pod:130
21846 msgid "Start with a prepared disk"
21847 msgstr ""
21848
21849 # type: textblock
21850 #. type: textblock
21851 #: ../fish/guestfish.pod:132
21852 msgid ""
21853 "An alternate way to create a 100MB disk called C<test1.img> containing a "
21854 "single ext2-formatted partition:"
21855 msgstr ""
21856
21857 # type: verbatim
21858 #. type: verbatim
21859 #: ../fish/guestfish.pod:135
21860 #, no-wrap
21861 msgid ""
21862 " guestfish -N fs\n"
21863 "\n"
21864 msgstr ""
21865
21866 # type: textblock
21867 #. type: textblock
21868 #: ../fish/guestfish.pod:137
21869 msgid "To list what is available do:"
21870 msgstr ""
21871
21872 # type: verbatim
21873 #. type: verbatim
21874 #: ../fish/guestfish.pod:139 ../fish/guestfish.pod:938
21875 #, no-wrap
21876 msgid ""
21877 " guestfish -N help | less\n"
21878 "\n"
21879 msgstr ""
21880
21881 # type: =head2
21882 #. type: =head2
21883 #: ../fish/guestfish.pod:141
21884 msgid "Remote control"
21885 msgstr ""
21886
21887 # type: verbatim
21888 #. type: verbatim
21889 #: ../fish/guestfish.pod:143
21890 #, no-wrap
21891 msgid ""
21892 " eval \"`guestfish --listen`\"\n"
21893 " guestfish --remote add-ro disk.img\n"
21894 " guestfish --remote run\n"
21895 " guestfish --remote lvs\n"
21896 "\n"
21897 msgstr ""
21898
21899 # type: =head1
21900 #. type: =head1
21901 #: ../fish/guestfish.pod:148 ../test-tool/libguestfs-test-tool.pod:37
21902 #: ../fuse/guestmount.pod:83 ../tools/virt-edit.pl:81
21903 #: ../tools/virt-win-reg.pl:96 ../tools/virt-list-filesystems.pl:53
21904 #: ../tools/virt-tar.pl:103 ../tools/virt-make-fs.pl:153
21905 #: ../tools/virt-list-partitions.pl:54
21906 msgid "OPTIONS"
21907 msgstr ""
21908
21909 # type: =item
21910 #. type: =item
21911 #: ../fish/guestfish.pod:152 ../fuse/guestmount.pod:141
21912 #: ../tools/virt-edit.pl:89 ../tools/virt-win-reg.pl:104
21913 #: ../tools/virt-list-filesystems.pl:61 ../tools/virt-tar.pl:111
21914 #: ../tools/virt-make-fs.pl:161 ../tools/virt-list-partitions.pl:62
21915 msgid "B<--help>"
21916 msgstr ""
21917
21918 # type: textblock
21919 #. type: textblock
21920 #: ../fish/guestfish.pod:154
21921 msgid "Displays general help on options."
21922 msgstr ""
21923
21924 # type: =item
21925 #. type: =item
21926 #: ../fish/guestfish.pod:156
21927 msgid "B<-h>"
21928 msgstr ""
21929
21930 # type: =item
21931 #. type: =item
21932 #: ../fish/guestfish.pod:158
21933 msgid "B<--cmd-help>"
21934 msgstr ""
21935
21936 # type: textblock
21937 #. type: textblock
21938 #: ../fish/guestfish.pod:160
21939 msgid "Lists all available guestfish commands."
21940 msgstr ""
21941
21942 # type: =item
21943 #. type: =item
21944 #: ../fish/guestfish.pod:162
21945 msgid "B<-h cmd>"
21946 msgstr ""
21947
21948 # type: =item
21949 #. type: =item
21950 #: ../fish/guestfish.pod:164
21951 msgid "B<--cmd-help cmd>"
21952 msgstr ""
21953
21954 # type: textblock
21955 #. type: textblock
21956 #: ../fish/guestfish.pod:166
21957 msgid "Displays detailed help on a single command C<cmd>."
21958 msgstr ""
21959
21960 # type: =item
21961 #. type: =item
21962 #: ../fish/guestfish.pod:168
21963 msgid "B<-a image>"
21964 msgstr ""
21965
21966 # type: =item
21967 #. type: =item
21968 #: ../fish/guestfish.pod:170
21969 msgid "B<--add image>"
21970 msgstr ""
21971
21972 # type: textblock
21973 #. type: textblock
21974 #: ../fish/guestfish.pod:172
21975 msgid "Add a block device or virtual machine image to the shell."
21976 msgstr ""
21977
21978 # type: textblock
21979 #. type: textblock
21980 #: ../fish/guestfish.pod:174 ../fuse/guestmount.pod:91
21981 msgid ""
21982 "The format of the disk image is auto-detected.  To override this and force a "
21983 "particular format use the I<--format=..> option."
21984 msgstr ""
21985
21986 #. type: textblock
21987 #: ../fish/guestfish.pod:177
21988 msgid ""
21989 "Using this flag is mostly equivalent to using the C<add> command, with "
21990 "C<readonly:true> if the I<--ro> flag was given, and with C<format:...> if "
21991 "the I<--format=...> flag was given."
21992 msgstr ""
21993
21994 # type: =item
21995 #. type: =item
21996 #: ../fish/guestfish.pod:181
21997 msgid "B<-c URI>"
21998 msgstr ""
21999
22000 # type: =item
22001 #. type: =item
22002 #: ../fish/guestfish.pod:183
22003 msgid "B<--connect URI>"
22004 msgstr ""
22005
22006 # type: textblock
22007 #. type: textblock
22008 #: ../fish/guestfish.pod:185 ../fuse/guestmount.pod:96
22009 msgid ""
22010 "When used in conjunction with the I<-d> option, this specifies the libvirt "
22011 "URI to use.  The default is to use the default libvirt connection."
22012 msgstr ""
22013
22014 # type: =item
22015 #. type: =item
22016 #: ../fish/guestfish.pod:189
22017 msgid "B<--csh>"
22018 msgstr ""
22019
22020 # type: textblock
22021 #. type: textblock
22022 #: ../fish/guestfish.pod:191
22023 msgid ""
22024 "If using the I<--listen> option and a csh-like shell, use this option.  See "
22025 "section L</REMOTE CONTROL AND CSH> below."
22026 msgstr ""
22027
22028 # type: =item
22029 #. type: =item
22030 #: ../fish/guestfish.pod:194
22031 msgid "B<-d libvirt-domain>"
22032 msgstr ""
22033
22034 # type: =item
22035 #. type: =item
22036 #: ../fish/guestfish.pod:196
22037 msgid "B<--domain libvirt-domain>"
22038 msgstr ""
22039
22040 # type: textblock
22041 #. type: textblock
22042 #: ../fish/guestfish.pod:198 ../fuse/guestmount.pod:102
22043 msgid ""
22044 "Add disks from the named libvirt domain.  If the I<--ro> option is also "
22045 "used, then any libvirt domain can be used.  However in write mode, only "
22046 "libvirt domains which are shut down can be named here."
22047 msgstr ""
22048
22049 # type: textblock
22050 #. type: textblock
22051 #: ../fish/guestfish.pod:202
22052 msgid ""
22053 "Using this flag is mostly equivalent to using the C<add-domain> command, "
22054 "with C<readonly:true> if the I<--ro> flag was given, and with C<format:...> "
22055 "if the I<--format:...> flag was given."
22056 msgstr ""
22057
22058 # type: =item
22059 #. type: =item
22060 #: ../fish/guestfish.pod:206
22061 msgid "B<-D>"
22062 msgstr ""
22063
22064 # type: =item
22065 #. type: =item
22066 #: ../fish/guestfish.pod:208
22067 msgid "B<--no-dest-paths>"
22068 msgstr ""
22069
22070 # type: textblock
22071 #. type: textblock
22072 #: ../fish/guestfish.pod:210
22073 msgid ""
22074 "Don't tab-complete paths on the guest filesystem.  It is useful to be able "
22075 "to hit the tab key to complete paths on the guest filesystem, but this "
22076 "causes extra \"hidden\" guestfs calls to be made, so this option is here to "
22077 "allow this feature to be disabled."
22078 msgstr ""
22079
22080 # type: =item
22081 #. type: =item
22082 #: ../fish/guestfish.pod:215 ../fuse/guestmount.pod:118
22083 msgid "B<--echo-keys>"
22084 msgstr ""
22085
22086 # type: textblock
22087 #. type: textblock
22088 #: ../fish/guestfish.pod:217 ../fuse/guestmount.pod:120
22089 msgid ""
22090 "When prompting for keys and passphrases, guestfish normally turns echoing "
22091 "off so you cannot see what you are typing.  If you are not worried about "
22092 "Tempest attacks and there is no one else in the room you can specify this "
22093 "flag to see what you are typing."
22094 msgstr ""
22095
22096 # type: =item
22097 #. type: =item
22098 #: ../fish/guestfish.pod:222
22099 msgid "B<-f file>"
22100 msgstr ""
22101
22102 # type: =item
22103 #. type: =item
22104 #: ../fish/guestfish.pod:224
22105 msgid "B<--file file>"
22106 msgstr ""
22107
22108 # type: textblock
22109 #. type: textblock
22110 #: ../fish/guestfish.pod:226
22111 msgid "Read commands from C<file>.  To write pure guestfish scripts, use:"
22112 msgstr ""
22113
22114 # type: verbatim
22115 #. type: verbatim
22116 #: ../fish/guestfish.pod:229
22117 #, no-wrap
22118 msgid ""
22119 " #!/usr/bin/guestfish -f\n"
22120 "\n"
22121 msgstr ""
22122
22123 # type: =item
22124 #. type: =item
22125 #: ../fish/guestfish.pod:231
22126 msgid "B<--format=raw|qcow2|..>"
22127 msgstr ""
22128
22129 # type: =item
22130 #. type: =item
22131 #: ../fish/guestfish.pod:233
22132 msgid "B<--format>"
22133 msgstr ""
22134
22135 # type: textblock
22136 #. type: textblock
22137 #: ../fish/guestfish.pod:235 ../fuse/guestmount.pod:127
22138 msgid ""
22139 "The default for the I<-a> option is to auto-detect the format of the disk "
22140 "image.  Using this forces the disk format for I<-a> options which follow on "
22141 "the command line.  Using I<--format> with no argument switches back to auto-"
22142 "detection for subsequent I<-a> options."
22143 msgstr ""
22144
22145 # type: verbatim
22146 #. type: verbatim
22147 #: ../fish/guestfish.pod:242
22148 #, no-wrap
22149 msgid ""
22150 " guestfish --format=raw -a disk.img\n"
22151 "\n"
22152 msgstr ""
22153
22154 # type: textblock
22155 #. type: textblock
22156 #: ../fish/guestfish.pod:244
22157 msgid "forces raw format (no auto-detection) for C<disk.img>."
22158 msgstr ""
22159
22160 # type: verbatim
22161 #. type: verbatim
22162 #: ../fish/guestfish.pod:246
22163 #, no-wrap
22164 msgid ""
22165 " guestfish --format=raw -a disk.img --format -a another.img\n"
22166 "\n"
22167 msgstr ""
22168
22169 # type: textblock
22170 #. type: textblock
22171 #: ../fish/guestfish.pod:248
22172 msgid ""
22173 "forces raw format (no auto-detection) for C<disk.img> and reverts to auto-"
22174 "detection for C<another.img>."
22175 msgstr ""
22176
22177 # type: textblock
22178 #. type: textblock
22179 #: ../fish/guestfish.pod:251
22180 msgid ""
22181 "If you have untrusted raw-format guest disk images, you should use this "
22182 "option to specify the disk format.  This avoids a possible security problem "
22183 "with malicious guests (CVE-2010-3851).  See also L</add-drive-opts>."
22184 msgstr ""
22185
22186 # type: =item
22187 #. type: =item
22188 #: ../fish/guestfish.pod:256
22189 msgid "B<-i>"
22190 msgstr ""
22191
22192 # type: =item
22193 #. type: =item
22194 #: ../fish/guestfish.pod:258
22195 msgid "B<--inspector>"
22196 msgstr ""
22197
22198 # type: textblock
22199 #. type: textblock
22200 #: ../fish/guestfish.pod:260 ../fuse/guestmount.pod:147
22201 msgid ""
22202 "Using L<virt-inspector(1)> code, inspect the disks looking for an operating "
22203 "system and mount filesystems as they would be mounted on the real virtual "
22204 "machine."
22205 msgstr ""
22206
22207 # type: textblock
22208 #. type: textblock
22209 #: ../fish/guestfish.pod:264
22210 msgid "Typical usage is either:"
22211 msgstr ""
22212
22213 # type: verbatim
22214 #. type: verbatim
22215 #: ../fish/guestfish.pod:266
22216 #, no-wrap
22217 msgid ""
22218 " guestfish -d myguest -i\n"
22219 "\n"
22220 msgstr ""
22221
22222 # type: textblock
22223 #. type: textblock
22224 #: ../fish/guestfish.pod:268
22225 msgid "(for an inactive libvirt domain called I<myguest>), or:"
22226 msgstr ""
22227
22228 # type: verbatim
22229 #. type: verbatim
22230 #: ../fish/guestfish.pod:270
22231 #, no-wrap
22232 msgid ""
22233 " guestfish --ro -d myguest -i\n"
22234 "\n"
22235 msgstr ""
22236
22237 # type: textblock
22238 #. type: textblock
22239 #: ../fish/guestfish.pod:272
22240 msgid "(for active domains, readonly), or specify the block device directly:"
22241 msgstr ""
22242
22243 # type: verbatim
22244 #. type: verbatim
22245 #: ../fish/guestfish.pod:274
22246 #, no-wrap
22247 msgid ""
22248 " guestfish --rw -a /dev/Guests/MyGuest -i\n"
22249 "\n"
22250 msgstr ""
22251
22252 # type: textblock
22253 #. type: textblock
22254 #: ../fish/guestfish.pod:276
22255 msgid ""
22256 "Note that the command line syntax changed slightly over older versions of "
22257 "guestfish.  You can still use the old syntax:"
22258 msgstr ""
22259
22260 # type: verbatim
22261 #. type: verbatim
22262 #: ../fish/guestfish.pod:279
22263 #, no-wrap
22264 msgid ""
22265 " guestfish [--ro] -i disk.img\n"
22266 "\n"
22267 msgstr ""
22268
22269 # type: verbatim
22270 #. type: verbatim
22271 #: ../fish/guestfish.pod:281
22272 #, no-wrap
22273 msgid ""
22274 " guestfish [--ro] -i libvirt-domain\n"
22275 "\n"
22276 msgstr ""
22277
22278 # type: textblock
22279 #. type: textblock
22280 #: ../fish/guestfish.pod:283
22281 msgid ""
22282 "Using this flag is mostly equivalent to using the C<inspect-os> command and "
22283 "then using other commands to mount the filesystems that were found."
22284 msgstr ""
22285
22286 # type: =item
22287 #. type: =item
22288 #: ../fish/guestfish.pod:287 ../fuse/guestmount.pod:151
22289 msgid "B<--keys-from-stdin>"
22290 msgstr ""
22291
22292 # type: textblock
22293 #. type: textblock
22294 #: ../fish/guestfish.pod:289 ../fuse/guestmount.pod:153
22295 msgid ""
22296 "Read key or passphrase parameters from stdin.  The default is to try to read "
22297 "passphrases from the user by opening C</dev/tty>."
22298 msgstr ""
22299
22300 # type: =item
22301 #. type: =item
22302 #: ../fish/guestfish.pod:292
22303 msgid "B<--listen>"
22304 msgstr ""
22305
22306 # type: textblock
22307 #. type: textblock
22308 #: ../fish/guestfish.pod:294
22309 msgid ""
22310 "Fork into the background and listen for remote commands.  See section L</"
22311 "REMOTE CONTROL GUESTFISH OVER A SOCKET> below."
22312 msgstr ""
22313
22314 #. type: =item
22315 #: ../fish/guestfish.pod:297 ../fuse/guestmount.pod:156
22316 msgid "B<--live>"
22317 msgstr ""
22318
22319 #. type: textblock
22320 #: ../fish/guestfish.pod:299 ../fuse/guestmount.pod:158
22321 msgid ""
22322 "Connect to a live virtual machine.  (Experimental, see L<guestfs(3)/"
22323 "ATTACHING TO RUNNING DAEMONS>)."
22324 msgstr ""
22325
22326 #. type: =item
22327 #: ../fish/guestfish.pod:302 ../fuse/guestmount.pod:161
22328 msgid "B<-m dev[:mountpoint[:options]]>"
22329 msgstr ""
22330
22331 #. type: =item
22332 #: ../fish/guestfish.pod:304 ../fuse/guestmount.pod:163
22333 msgid "B<--mount dev[:mountpoint[:options]]>"
22334 msgstr ""
22335
22336 # type: textblock
22337 #. type: textblock
22338 #: ../fish/guestfish.pod:306
22339 msgid "Mount the named partition or logical volume on the given mountpoint."
22340 msgstr ""
22341
22342 # type: textblock
22343 #. type: textblock
22344 #: ../fish/guestfish.pod:308
22345 msgid "If the mountpoint is omitted, it defaults to C</>."
22346 msgstr ""
22347
22348 # type: textblock
22349 #. type: textblock
22350 #: ../fish/guestfish.pod:310
22351 msgid "You have to mount something on C</> before most commands will work."
22352 msgstr ""
22353
22354 # type: textblock
22355 #. type: textblock
22356 #: ../fish/guestfish.pod:312
22357 msgid ""
22358 "If any I<-m> or I<--mount> options are given, the guest is automatically "
22359 "launched."
22360 msgstr ""
22361
22362 # type: textblock
22363 #. type: textblock
22364 #: ../fish/guestfish.pod:315
22365 msgid ""
22366 "If you don't know what filesystems a disk image contains, you can either run "
22367 "guestfish without this option, then list the partitions, filesystems and LVs "
22368 "available (see L</list-partitions>, L</list-filesystems> and L</lvs> "
22369 "commands), or you can use the L<virt-filesystems(1)> program."
22370 msgstr ""
22371
22372 #. type: textblock
22373 #: ../fish/guestfish.pod:321 ../fuse/guestmount.pod:171
22374 msgid ""
22375 "The third (and rarely used) part of the mount parameter is the list of mount "
22376 "options used to mount the underlying filesystem.  If this is not given, then "
22377 "the mount options are either the empty string or C<ro> (the latter if the "
22378 "I<--ro> flag is used).  By specifying the mount options, you override this "
22379 "default choice.  Probably the only time you would use this is to enable ACLs "
22380 "and/or extended attributes if the filesystem can support them:"
22381 msgstr ""
22382
22383 #. type: verbatim
22384 #: ../fish/guestfish.pod:329 ../fuse/guestmount.pod:179
22385 #, no-wrap
22386 msgid ""
22387 " -m /dev/sda1:/:acl,user_xattr\n"
22388 "\n"
22389 msgstr ""
22390
22391 #. type: textblock
22392 #: ../fish/guestfish.pod:331
22393 msgid "Using this flag is equivalent to using the C<mount-options> command."
22394 msgstr ""
22395
22396 # type: =item
22397 #. type: =item
22398 #: ../fish/guestfish.pod:333
22399 msgid "B<-n>"
22400 msgstr ""
22401
22402 # type: =item
22403 #. type: =item
22404 #: ../fish/guestfish.pod:335
22405 msgid "B<--no-sync>"
22406 msgstr ""
22407
22408 # type: textblock
22409 #. type: textblock
22410 #: ../fish/guestfish.pod:337
22411 msgid ""
22412 "Disable autosync.  This is enabled by default.  See the discussion of "
22413 "autosync in the L<guestfs(3)> manpage."
22414 msgstr ""
22415
22416 # type: =item
22417 #. type: =item
22418 #: ../fish/guestfish.pod:340
22419 msgid "B<-N type>"
22420 msgstr ""
22421
22422 # type: =item
22423 #. type: =item
22424 #: ../fish/guestfish.pod:342
22425 msgid "B<--new type>"
22426 msgstr ""
22427
22428 # type: =item
22429 #. type: =item
22430 #: ../fish/guestfish.pod:344
22431 msgid "B<-N help>"
22432 msgstr ""
22433
22434 # type: textblock
22435 #. type: textblock
22436 #: ../fish/guestfish.pod:346
22437 msgid ""
22438 "Prepare a fresh disk image formatted as \"type\".  This is an alternative to "
22439 "the I<-a> option: whereas I<-a> adds an existing disk, I<-N> creates a "
22440 "preformatted disk with a filesystem and adds it.  See L</PREPARED DISK "
22441 "IMAGES> below."
22442 msgstr ""
22443
22444 # type: =item
22445 #. type: =item
22446 #: ../fish/guestfish.pod:351
22447 msgid "B<--progress-bars>"
22448 msgstr ""
22449
22450 # type: textblock
22451 #. type: textblock
22452 #: ../fish/guestfish.pod:353
22453 msgid "Enable progress bars, even when guestfish is used non-interactively."
22454 msgstr ""
22455
22456 # type: textblock
22457 #. type: textblock
22458 #: ../fish/guestfish.pod:355
22459 msgid ""
22460 "Progress bars are enabled by default when guestfish is used as an "
22461 "interactive shell."
22462 msgstr ""
22463
22464 # type: =item
22465 #. type: =item
22466 #: ../fish/guestfish.pod:358
22467 msgid "B<--no-progress-bars>"
22468 msgstr ""
22469
22470 # type: textblock
22471 #. type: textblock
22472 #: ../fish/guestfish.pod:360
22473 msgid "Disable progress bars."
22474 msgstr ""
22475
22476 # type: =item
22477 #. type: =item
22478 #: ../fish/guestfish.pod:362
22479 msgid "B<--remote[=pid]>"
22480 msgstr ""
22481
22482 # type: textblock
22483 #. type: textblock
22484 #: ../fish/guestfish.pod:364
22485 msgid ""
22486 "Send remote commands to C<$GUESTFISH_PID> or C<pid>.  See section L</REMOTE "
22487 "CONTROL GUESTFISH OVER A SOCKET> below."
22488 msgstr ""
22489
22490 # type: =item
22491 #. type: =item
22492 #: ../fish/guestfish.pod:367
22493 msgid "B<-r>"
22494 msgstr ""
22495
22496 # type: =item
22497 #. type: =item
22498 #: ../fish/guestfish.pod:369
22499 msgid "B<--ro>"
22500 msgstr ""
22501
22502 # type: textblock
22503 #. type: textblock
22504 #: ../fish/guestfish.pod:371
22505 msgid ""
22506 "This changes the I<-a>, I<-d> and I<-m> options so that disks are added and "
22507 "mounts are done read-only."
22508 msgstr ""
22509
22510 # type: textblock
22511 #. type: textblock
22512 #: ../fish/guestfish.pod:374
22513 msgid ""
22514 "The option must always be used if the disk image or virtual machine might be "
22515 "running, and is generally recommended in cases where you don't need write "
22516 "access to the disk."
22517 msgstr ""
22518
22519 # type: textblock
22520 #. type: textblock
22521 #: ../fish/guestfish.pod:378
22522 msgid ""
22523 "Note that prepared disk images created with I<-N> are not affected by this "
22524 "option.  Also commands like C<add> are not affected - you have to specify "
22525 "the C<readonly:true> option explicitly if you need it."
22526 msgstr ""
22527
22528 # type: textblock
22529 #. type: textblock
22530 #: ../fish/guestfish.pod:382
22531 msgid "See also L</OPENING DISKS FOR READ AND WRITE> below."
22532 msgstr ""
22533
22534 # type: =item
22535 #. type: =item
22536 #: ../fish/guestfish.pod:384 ../fuse/guestmount.pod:235
22537 msgid "B<--selinux>"
22538 msgstr ""
22539
22540 # type: textblock
22541 #. type: textblock
22542 #: ../fish/guestfish.pod:386
22543 msgid "Enable SELinux support for the guest.  See L<guestfs(3)/SELINUX>."
22544 msgstr ""
22545
22546 # type: =item
22547 #. type: =item
22548 #: ../fish/guestfish.pod:388
22549 msgid "B<-v>"
22550 msgstr ""
22551
22552 # type: =item
22553 #. type: =item
22554 #: ../fish/guestfish.pod:390
22555 msgid "B<--verbose>"
22556 msgstr ""
22557
22558 # type: textblock
22559 #. type: textblock
22560 #: ../fish/guestfish.pod:392
22561 msgid ""
22562 "Enable very verbose messages.  This is particularly useful if you find a bug."
22563 msgstr ""
22564
22565 # type: =item
22566 #. type: =item
22567 #: ../fish/guestfish.pod:395
22568 msgid "B<-V>"
22569 msgstr ""
22570
22571 # type: =item
22572 #. type: =item
22573 #: ../fish/guestfish.pod:397 ../tools/virt-edit.pl:97
22574 #: ../tools/virt-win-reg.pl:112 ../tools/virt-list-filesystems.pl:69
22575 #: ../tools/virt-tar.pl:119 ../tools/virt-make-fs.pl:169
22576 #: ../tools/virt-list-partitions.pl:70
22577 msgid "B<--version>"
22578 msgstr ""
22579
22580 # type: textblock
22581 #. type: textblock
22582 #: ../fish/guestfish.pod:399
22583 msgid "Display the guestfish / libguestfs version number and exit."
22584 msgstr ""
22585
22586 # type: =item
22587 #. type: =item
22588 #: ../fish/guestfish.pod:401
22589 msgid "B<-w>"
22590 msgstr ""
22591
22592 # type: =item
22593 #. type: =item
22594 #: ../fish/guestfish.pod:403
22595 msgid "B<--rw>"
22596 msgstr ""
22597
22598 #. type: textblock
22599 #: ../fish/guestfish.pod:405 ../fuse/guestmount.pod:249
22600 msgid ""
22601 "This changes the I<-a>, I<-d> and I<-m> options so that disks are added and "
22602 "mounts are done read-write."
22603 msgstr ""
22604
22605 #. type: textblock
22606 #: ../fish/guestfish.pod:408
22607 msgid "See L</OPENING DISKS FOR READ AND WRITE> below."
22608 msgstr ""
22609
22610 # type: =item
22611 #. type: =item
22612 #: ../fish/guestfish.pod:410
22613 msgid "B<-x>"
22614 msgstr ""
22615
22616 # type: textblock
22617 #. type: textblock
22618 #: ../fish/guestfish.pod:412
22619 msgid "Echo each command before executing it."
22620 msgstr ""
22621
22622 # type: =head1
22623 #. type: =head1
22624 #: ../fish/guestfish.pod:416
22625 msgid "COMMANDS ON COMMAND LINE"
22626 msgstr ""
22627
22628 # type: textblock
22629 #. type: textblock
22630 #: ../fish/guestfish.pod:418
22631 msgid ""
22632 "Any additional (non-option) arguments are treated as commands to execute."
22633 msgstr ""
22634
22635 # type: textblock
22636 #. type: textblock
22637 #: ../fish/guestfish.pod:421
22638 msgid ""
22639 "Commands to execute should be separated by a colon (C<:>), where the colon "
22640 "is a separate parameter.  Thus:"
22641 msgstr ""
22642
22643 # type: verbatim
22644 #. type: verbatim
22645 #: ../fish/guestfish.pod:424
22646 #, no-wrap
22647 msgid ""
22648 " guestfish cmd [args...] : cmd [args...] : cmd [args...] ...\n"
22649 "\n"
22650 msgstr ""
22651
22652 # type: textblock
22653 #. type: textblock
22654 #: ../fish/guestfish.pod:426
22655 msgid ""
22656 "If there are no additional arguments, then we enter a shell, either an "
22657 "interactive shell with a prompt (if the input is a terminal) or a non-"
22658 "interactive shell."
22659 msgstr ""
22660
22661 # type: textblock
22662 #. type: textblock
22663 #: ../fish/guestfish.pod:430
22664 msgid ""
22665 "In either command line mode or non-interactive shell, the first command that "
22666 "gives an error causes the whole shell to exit.  In interactive mode (with a "
22667 "prompt) if a command fails, you can continue to enter commands."
22668 msgstr ""
22669
22670 # type: =head1
22671 #. type: =head1
22672 #: ../fish/guestfish.pod:435
22673 msgid "USING launch (OR run)"
22674 msgstr ""
22675
22676 # type: textblock
22677 #. type: textblock
22678 #: ../fish/guestfish.pod:437
22679 msgid ""
22680 "As with L<guestfs(3)>, you must first configure your guest by adding disks, "
22681 "then launch it, then mount any disks you need, and finally issue actions/"
22682 "commands.  So the general order of the day is:"
22683 msgstr ""
22684
22685 # type: textblock
22686 #. type: textblock
22687 #: ../fish/guestfish.pod:445
22688 msgid "add or -a/--add"
22689 msgstr ""
22690
22691 # type: textblock
22692 #. type: textblock
22693 #: ../fish/guestfish.pod:449
22694 msgid "launch (aka run)"
22695 msgstr ""
22696
22697 # type: textblock
22698 #. type: textblock
22699 #: ../fish/guestfish.pod:453
22700 msgid "mount or -m/--mount"
22701 msgstr ""
22702
22703 # type: textblock
22704 #. type: textblock
22705 #: ../fish/guestfish.pod:457
22706 msgid "any other commands"
22707 msgstr ""
22708
22709 # type: textblock
22710 #. type: textblock
22711 #: ../fish/guestfish.pod:461
22712 msgid ""
22713 "C<run> is a synonym for C<launch>.  You must C<launch> (or C<run>)  your "
22714 "guest before mounting or performing any other commands."
22715 msgstr ""
22716
22717 # type: textblock
22718 #. type: textblock
22719 #: ../fish/guestfish.pod:464
22720 msgid ""
22721 "The only exception is that if any of the I<-i>, I<-m>, I<--mount>, I<-N> or "
22722 "I<--new> options were given then C<run> is done automatically, simply "
22723 "because guestfish can't perform the action you asked for without doing this."
22724 msgstr ""
22725
22726 # type: =head1
22727 #. type: =head1
22728 #: ../fish/guestfish.pod:469
22729 msgid "OPENING DISKS FOR READ AND WRITE"
22730 msgstr ""
22731
22732 #. type: textblock
22733 #: ../fish/guestfish.pod:471
22734 msgid ""
22735 "The guestfish, L<guestmount(1)> and L<virt-rescue(1)> options I<--ro> and "
22736 "I<--rw> affect whether the other command line options I<-a>, I<-c>, I<-d>, "
22737 "I<-i> and I<-m> open disk images read-only or for writing."
22738 msgstr ""
22739
22740 #. type: textblock
22741 #: ../fish/guestfish.pod:476
22742 msgid ""
22743 "In libguestfs E<le> 1.10, guestfish, guestmount and virt-rescue defaulted to "
22744 "opening disk images supplied on the command line for write.  To open a disk "
22745 "image read-only you have to do I<-a image --ro>."
22746 msgstr ""
22747
22748 # type: textblock
22749 #. type: textblock
22750 #: ../fish/guestfish.pod:480
22751 msgid ""
22752 "This matters: If you accidentally open a live VM disk image writable then "
22753 "you will cause irreversible disk corruption."
22754 msgstr ""
22755
22756 #. type: textblock
22757 #: ../fish/guestfish.pod:483
22758 msgid ""
22759 "By libguestfs 1.12 we intend to change the default the other way.  Disk "
22760 "images will be opened read-only.  You will have to either specify "
22761 "I<guestfish --rw>, I<guestmount --rw>, I<virt-rescue --rw>, or change the "
22762 "configuration file C</etc/libguestfs-tools.conf> in order to get write "
22763 "access for disk images specified by those other command line options."
22764 msgstr ""
22765
22766 #. type: textblock
22767 #: ../fish/guestfish.pod:490
22768 msgid ""
22769 "This version of guestfish, guestmount and virt-rescue has a I<--rw> option "
22770 "which does nothing (it is already the default).  However it is highly "
22771 "recommended that you use this option to indicate that you need write access, "
22772 "and prepare your scripts for the day when this option will be required for "
22773 "write access."
22774 msgstr ""
22775
22776 # type: textblock
22777 #. type: textblock
22778 #: ../fish/guestfish.pod:496
22779 msgid ""
22780 "B<Note:> This does I<not> affect commands like L</add> and L</mount>, or any "
22781 "other libguestfs program apart from guestfish and guestmount."
22782 msgstr ""
22783
22784 # type: =head1
22785 #. type: =head1
22786 #: ../fish/guestfish.pod:499
22787 msgid "QUOTING"
22788 msgstr ""
22789
22790 # type: textblock
22791 #. type: textblock
22792 #: ../fish/guestfish.pod:501
22793 msgid ""
22794 "You can quote ordinary parameters using either single or double quotes.  For "
22795 "example:"
22796 msgstr ""
22797
22798 # type: verbatim
22799 #. type: verbatim
22800 #: ../fish/guestfish.pod:504
22801 #, no-wrap
22802 msgid ""
22803 " add \"file with a space.img\"\n"
22804 "\n"
22805 msgstr ""
22806
22807 # type: verbatim
22808 #. type: verbatim
22809 #: ../fish/guestfish.pod:506
22810 #, no-wrap
22811 msgid ""
22812 " rm '/file name'\n"
22813 "\n"
22814 msgstr ""
22815
22816 # type: verbatim
22817 #. type: verbatim
22818 #: ../fish/guestfish.pod:508
22819 #, no-wrap
22820 msgid ""
22821 " rm '/\"'\n"
22822 "\n"
22823 msgstr ""
22824
22825 # type: textblock
22826 #. type: textblock
22827 #: ../fish/guestfish.pod:510
22828 msgid ""
22829 "A few commands require a list of strings to be passed.  For these, use a "
22830 "whitespace-separated list, enclosed in quotes.  Strings containing "
22831 "whitespace to be passed through must be enclosed in single quotes.  A "
22832 "literal single quote must be escaped with a backslash."
22833 msgstr ""
22834
22835 # type: verbatim
22836 #. type: verbatim
22837 #: ../fish/guestfish.pod:515
22838 #, no-wrap
22839 msgid ""
22840 " vgcreate VG \"/dev/sda1 /dev/sdb1\"\n"
22841 " command \"/bin/echo 'foo      bar'\"\n"
22842 " command \"/bin/echo \\'foo\\'\"\n"
22843 "\n"
22844 msgstr ""
22845
22846 # type: =head1
22847 #. type: =head1
22848 #: ../fish/guestfish.pod:519
22849 msgid "OPTIONAL ARGUMENTS"
22850 msgstr ""
22851
22852 # type: textblock
22853 #. type: textblock
22854 #: ../fish/guestfish.pod:521
22855 msgid ""
22856 "Some commands take optional arguments.  These arguments appear in this "
22857 "documentation as C<[argname:..]>.  You can use them as in these examples:"
22858 msgstr ""
22859
22860 # type: verbatim
22861 #. type: verbatim
22862 #: ../fish/guestfish.pod:525
22863 #, no-wrap
22864 msgid ""
22865 " add-drive-opts filename\n"
22866 "\n"
22867 msgstr ""
22868
22869 # type: verbatim
22870 #. type: verbatim
22871 #: ../fish/guestfish.pod:527
22872 #, no-wrap
22873 msgid ""
22874 " add-drive-opts filename readonly:true\n"
22875 "\n"
22876 msgstr ""
22877
22878 # type: verbatim
22879 #. type: verbatim
22880 #: ../fish/guestfish.pod:529
22881 #, no-wrap
22882 msgid ""
22883 " add-drive-opts filename format:qcow2 readonly:false\n"
22884 "\n"
22885 msgstr ""
22886
22887 # type: textblock
22888 #. type: textblock
22889 #: ../fish/guestfish.pod:531
22890 msgid ""
22891 "Each optional argument can appear at most once.  All optional arguments must "
22892 "appear after the required ones."
22893 msgstr ""
22894
22895 # type: =head1
22896 #. type: =head1
22897 #: ../fish/guestfish.pod:534
22898 msgid "NUMBERS"
22899 msgstr ""
22900
22901 # type: textblock
22902 #. type: textblock
22903 #: ../fish/guestfish.pod:536
22904 msgid ""
22905 "This section applies to all commands which can take integers as parameters."
22906 msgstr ""
22907
22908 # type: =head2
22909 #. type: =head2
22910 #: ../fish/guestfish.pod:539
22911 msgid "SIZE SUFFIX"
22912 msgstr ""
22913
22914 # type: textblock
22915 #. type: textblock
22916 #: ../fish/guestfish.pod:541
22917 msgid ""
22918 "When the command takes a parameter measured in bytes, you can use one of the "
22919 "following suffixes to specify kilobytes, megabytes and larger sizes:"
22920 msgstr ""
22921
22922 # type: =item
22923 #. type: =item
22924 #: ../fish/guestfish.pod:547
22925 msgid "B<k> or B<K> or B<KiB>"
22926 msgstr ""
22927
22928 # type: textblock
22929 #. type: textblock
22930 #: ../fish/guestfish.pod:549
22931 msgid "The size in kilobytes (multiplied by 1024)."
22932 msgstr ""
22933
22934 # type: =item
22935 #. type: =item
22936 #: ../fish/guestfish.pod:551
22937 msgid "B<KB>"
22938 msgstr ""
22939
22940 # type: textblock
22941 #. type: textblock
22942 #: ../fish/guestfish.pod:553
22943 msgid "The size in SI 1000 byte units."
22944 msgstr ""
22945
22946 # type: =item
22947 #. type: =item
22948 #: ../fish/guestfish.pod:555
22949 msgid "B<M> or B<MiB>"
22950 msgstr ""
22951
22952 # type: textblock
22953 #. type: textblock
22954 #: ../fish/guestfish.pod:557
22955 msgid "The size in megabytes (multiplied by 1048576)."
22956 msgstr ""
22957
22958 # type: =item
22959 #. type: =item
22960 #: ../fish/guestfish.pod:559
22961 msgid "B<MB>"
22962 msgstr ""
22963
22964 # type: textblock
22965 #. type: textblock
22966 #: ../fish/guestfish.pod:561
22967 msgid "The size in SI 1000000 byte units."
22968 msgstr ""
22969
22970 # type: =item
22971 #. type: =item
22972 #: ../fish/guestfish.pod:563
22973 msgid "B<G> or B<GiB>"
22974 msgstr ""
22975
22976 # type: textblock
22977 #. type: textblock
22978 #: ../fish/guestfish.pod:565
22979 msgid "The size in gigabytes (multiplied by 2**30)."
22980 msgstr ""
22981
22982 # type: =item
22983 #. type: =item
22984 #: ../fish/guestfish.pod:567
22985 msgid "B<GB>"
22986 msgstr ""
22987
22988 # type: textblock
22989 #. type: textblock
22990 #: ../fish/guestfish.pod:569
22991 msgid "The size in SI 10**9 byte units."
22992 msgstr ""
22993
22994 # type: =item
22995 #. type: =item
22996 #: ../fish/guestfish.pod:571
22997 msgid "B<T> or B<TiB>"
22998 msgstr ""
22999
23000 # type: textblock
23001 #. type: textblock
23002 #: ../fish/guestfish.pod:573
23003 msgid "The size in terabytes (multiplied by 2**40)."
23004 msgstr ""
23005
23006 # type: =item
23007 #. type: =item
23008 #: ../fish/guestfish.pod:575
23009 msgid "B<TB>"
23010 msgstr ""
23011
23012 # type: textblock
23013 #. type: textblock
23014 #: ../fish/guestfish.pod:577
23015 msgid "The size in SI 10**12 byte units."
23016 msgstr ""
23017
23018 # type: =item
23019 #. type: =item
23020 #: ../fish/guestfish.pod:579
23021 msgid "B<P> or B<PiB>"
23022 msgstr ""
23023
23024 # type: textblock
23025 #. type: textblock
23026 #: ../fish/guestfish.pod:581
23027 msgid "The size in petabytes (multiplied by 2**50)."
23028 msgstr ""
23029
23030 # type: =item
23031 #. type: =item
23032 #: ../fish/guestfish.pod:583
23033 msgid "B<PB>"
23034 msgstr ""
23035
23036 # type: textblock
23037 #. type: textblock
23038 #: ../fish/guestfish.pod:585
23039 msgid "The size in SI 10**15 byte units."
23040 msgstr ""
23041
23042 # type: =item
23043 #. type: =item
23044 #: ../fish/guestfish.pod:587
23045 msgid "B<E> or B<EiB>"
23046 msgstr ""
23047
23048 # type: textblock
23049 #. type: textblock
23050 #: ../fish/guestfish.pod:589
23051 msgid "The size in exabytes (multiplied by 2**60)."
23052 msgstr ""
23053
23054 # type: =item
23055 #. type: =item
23056 #: ../fish/guestfish.pod:591
23057 msgid "B<EB>"
23058 msgstr ""
23059
23060 # type: textblock
23061 #. type: textblock
23062 #: ../fish/guestfish.pod:593
23063 msgid "The size in SI 10**18 byte units."
23064 msgstr ""
23065
23066 # type: =item
23067 #. type: =item
23068 #: ../fish/guestfish.pod:595
23069 msgid "B<Z> or B<ZiB>"
23070 msgstr ""
23071
23072 # type: textblock
23073 #. type: textblock
23074 #: ../fish/guestfish.pod:597
23075 msgid "The size in zettabytes (multiplied by 2**70)."
23076 msgstr ""
23077
23078 # type: =item
23079 #. type: =item
23080 #: ../fish/guestfish.pod:599
23081 msgid "B<ZB>"
23082 msgstr ""
23083
23084 # type: textblock
23085 #. type: textblock
23086 #: ../fish/guestfish.pod:601
23087 msgid "The size in SI 10**21 byte units."
23088 msgstr ""
23089
23090 # type: =item
23091 #. type: =item
23092 #: ../fish/guestfish.pod:603
23093 msgid "B<Y> or B<YiB>"
23094 msgstr ""
23095
23096 # type: textblock
23097 #. type: textblock
23098 #: ../fish/guestfish.pod:605
23099 msgid "The size in yottabytes (multiplied by 2**80)."
23100 msgstr ""
23101
23102 # type: =item
23103 #. type: =item
23104 #: ../fish/guestfish.pod:607
23105 msgid "B<YB>"
23106 msgstr ""
23107
23108 # type: textblock
23109 #. type: textblock
23110 #: ../fish/guestfish.pod:609
23111 msgid "The size in SI 10**24 byte units."
23112 msgstr ""
23113
23114 # type: verbatim
23115 #. type: verbatim
23116 #: ../fish/guestfish.pod:615
23117 #, no-wrap
23118 msgid ""
23119 " truncate-size /file 1G\n"
23120 "\n"
23121 msgstr ""
23122
23123 # type: textblock
23124 #. type: textblock
23125 #: ../fish/guestfish.pod:617
23126 msgid "would truncate the file to 1 gigabyte."
23127 msgstr ""
23128
23129 # type: textblock
23130 #. type: textblock
23131 #: ../fish/guestfish.pod:619
23132 msgid ""
23133 "Be careful because a few commands take sizes in kilobytes or megabytes (eg. "
23134 "the parameter to L</memsize> is specified in megabytes already).  Adding a "
23135 "suffix will probably not do what you expect."
23136 msgstr ""
23137
23138 # type: =head2
23139 #. type: =head2
23140 #: ../fish/guestfish.pod:623
23141 msgid "OCTAL AND HEXADECIMAL NUMBERS"
23142 msgstr ""
23143
23144 # type: textblock
23145 #. type: textblock
23146 #: ../fish/guestfish.pod:625
23147 msgid ""
23148 "For specifying the radix (base) use the C convention: C<0> to prefix an "
23149 "octal number or C<0x> to prefix a hexadecimal number.  For example:"
23150 msgstr ""
23151
23152 # type: verbatim
23153 #. type: verbatim
23154 #: ../fish/guestfish.pod:628
23155 #, no-wrap
23156 msgid ""
23157 " 1234      decimal number 1234\n"
23158 " 02322     octal number, equivalent to decimal 1234\n"
23159 " 0x4d2     hexadecimal number, equivalent to decimal 1234\n"
23160 "\n"
23161 msgstr ""
23162
23163 # type: textblock
23164 #. type: textblock
23165 #: ../fish/guestfish.pod:632
23166 msgid ""
23167 "When using the C<chmod> command, you almost always want to specify an octal "
23168 "number for the mode, and you must prefix it with C<0> (unlike the Unix "
23169 "L<chmod(1)> program):"
23170 msgstr ""
23171
23172 # type: verbatim
23173 #. type: verbatim
23174 #: ../fish/guestfish.pod:636
23175 #, no-wrap
23176 msgid ""
23177 " chmod 0777 /public  # OK\n"
23178 " chmod 777 /public   # WRONG! This is mode 777 decimal = 01411 octal.\n"
23179 "\n"
23180 msgstr ""
23181
23182 # type: textblock
23183 #. type: textblock
23184 #: ../fish/guestfish.pod:639
23185 msgid ""
23186 "Commands that return numbers usually print them in decimal, but some "
23187 "commands print numbers in other radices (eg. C<umask> prints the mode in "
23188 "octal, preceeded by C<0>)."
23189 msgstr ""
23190
23191 # type: =head1
23192 #. type: =head1
23193 #: ../fish/guestfish.pod:643
23194 msgid "WILDCARDS AND GLOBBING"
23195 msgstr ""
23196
23197 # type: textblock
23198 #. type: textblock
23199 #: ../fish/guestfish.pod:645
23200 msgid ""
23201 "Neither guestfish nor the underlying guestfs API performs wildcard expansion "
23202 "(globbing) by default.  So for example the following will not do what you "
23203 "expect:"
23204 msgstr ""
23205
23206 # type: verbatim
23207 #. type: verbatim
23208 #: ../fish/guestfish.pod:649
23209 #, no-wrap
23210 msgid ""
23211 " rm-rf /home/*\n"
23212 "\n"
23213 msgstr ""
23214
23215 # type: textblock
23216 #. type: textblock
23217 #: ../fish/guestfish.pod:651
23218 msgid ""
23219 "Assuming you don't have a directory called literally C</home/*> then the "
23220 "above command will return an error."
23221 msgstr ""
23222
23223 # type: textblock
23224 #. type: textblock
23225 #: ../fish/guestfish.pod:654
23226 msgid "To perform wildcard expansion, use the C<glob> command."
23227 msgstr ""
23228
23229 # type: verbatim
23230 #. type: verbatim
23231 #: ../fish/guestfish.pod:656
23232 #, no-wrap
23233 msgid ""
23234 " glob rm-rf /home/*\n"
23235 "\n"
23236 msgstr ""
23237
23238 # type: textblock
23239 #. type: textblock
23240 #: ../fish/guestfish.pod:658
23241 msgid ""
23242 "runs C<rm-rf> on each path that matches (ie. potentially running the command "
23243 "many times), equivalent to:"
23244 msgstr ""
23245
23246 # type: verbatim
23247 #. type: verbatim
23248 #: ../fish/guestfish.pod:661
23249 #, no-wrap
23250 msgid ""
23251 " rm-rf /home/jim\n"
23252 " rm-rf /home/joe\n"
23253 " rm-rf /home/mary\n"
23254 "\n"
23255 msgstr ""
23256
23257 # type: textblock
23258 #. type: textblock
23259 #: ../fish/guestfish.pod:665
23260 msgid "C<glob> only works on simple guest paths and not on device names."
23261 msgstr ""
23262
23263 # type: textblock
23264 #. type: textblock
23265 #: ../fish/guestfish.pod:667
23266 msgid ""
23267 "If you have several parameters, each containing a wildcard, then glob will "
23268 "perform a Cartesian product."
23269 msgstr ""
23270
23271 # type: =head1
23272 #. type: =head1
23273 #: ../fish/guestfish.pod:670
23274 msgid "COMMENTS"
23275 msgstr ""
23276
23277 # type: textblock
23278 #. type: textblock
23279 #: ../fish/guestfish.pod:672
23280 msgid ""
23281 "Any line which starts with a I<#> character is treated as a comment and "
23282 "ignored.  The I<#> can optionally be preceeded by whitespace, but B<not> by "
23283 "a command.  For example:"
23284 msgstr ""
23285
23286 # type: verbatim
23287 #. type: verbatim
23288 #: ../fish/guestfish.pod:676
23289 #, no-wrap
23290 msgid ""
23291 " # this is a comment\n"
23292 "         # this is a comment\n"
23293 " foo # NOT a comment\n"
23294 "\n"
23295 msgstr ""
23296
23297 # type: textblock
23298 #. type: textblock
23299 #: ../fish/guestfish.pod:680
23300 msgid "Blank lines are also ignored."
23301 msgstr ""
23302
23303 # type: =head1
23304 #. type: =head1
23305 #: ../fish/guestfish.pod:682
23306 msgid "RUNNING COMMANDS LOCALLY"
23307 msgstr ""
23308
23309 # type: textblock
23310 #. type: textblock
23311 #: ../fish/guestfish.pod:684
23312 msgid ""
23313 "Any line which starts with a I<!> character is treated as a command sent to "
23314 "the local shell (C</bin/sh> or whatever L<system(3)> uses).  For example:"
23315 msgstr ""
23316
23317 # type: verbatim
23318 #. type: verbatim
23319 #: ../fish/guestfish.pod:688
23320 #, no-wrap
23321 msgid ""
23322 " !mkdir local\n"
23323 " tgz-out /remote local/remote-data.tar.gz\n"
23324 "\n"
23325 msgstr ""
23326
23327 # type: textblock
23328 #. type: textblock
23329 #: ../fish/guestfish.pod:691
23330 msgid ""
23331 "will create a directory C<local> on the host, and then export the contents "
23332 "of C</remote> on the mounted filesystem to C<local/remote-data.tar.gz>.  "
23333 "(See C<tgz-out>)."
23334 msgstr ""
23335
23336 # type: textblock
23337 #. type: textblock
23338 #: ../fish/guestfish.pod:695
23339 msgid ""
23340 "To change the local directory, use the C<lcd> command.  C<!cd> will have no "
23341 "effect, due to the way that subprocesses work in Unix."
23342 msgstr ""
23343
23344 #. type: =head2
23345 #: ../fish/guestfish.pod:698
23346 msgid "LOCAL COMMANDS WITH INLINE EXECUTION"
23347 msgstr ""
23348
23349 #. type: textblock
23350 #: ../fish/guestfish.pod:700
23351 msgid ""
23352 "If a line starts with I<E<lt>!> then the shell command is executed (as for "
23353 "I<!>), but subsequently any output (stdout) of the shell command is parsed "
23354 "and executed as guestfish commands."
23355 msgstr ""
23356
23357 #. type: textblock
23358 #: ../fish/guestfish.pod:704
23359 msgid ""
23360 "Thus you can use shell script to construct arbitrary guestfish commands "
23361 "which are then parsed by guestfish."
23362 msgstr ""
23363
23364 #. type: textblock
23365 #: ../fish/guestfish.pod:707
23366 msgid ""
23367 "For example it is tedious to create a sequence of files (eg. C</foo.1> "
23368 "through C</foo.100>) using guestfish commands alone.  However this is simple "
23369 "if we use a shell script to create the guestfish commands for us:"
23370 msgstr ""
23371
23372 #. type: verbatim
23373 #: ../fish/guestfish.pod:712
23374 #, no-wrap
23375 msgid ""
23376 " <! for n in `seq 1 100`; do echo write /foo.$n $n; done\n"
23377 "\n"
23378 msgstr ""
23379
23380 #. type: textblock
23381 #: ../fish/guestfish.pod:714
23382 msgid "or with names like C</foo.001>:"
23383 msgstr ""
23384
23385 #. type: verbatim
23386 #: ../fish/guestfish.pod:716
23387 #, no-wrap
23388 msgid ""
23389 " <! for n in `seq 1 100`; do printf \"write /foo.%03d %d\\n\" $n $n; done\n"
23390 "\n"
23391 msgstr ""
23392
23393 #. type: textblock
23394 #: ../fish/guestfish.pod:718
23395 msgid ""
23396 "When using guestfish interactively it can be helpful to just run the shell "
23397 "script first (ie. remove the initial C<E<lt>> character so it is just an "
23398 "ordinary I<!> local command), see what guestfish commands it would run, and "
23399 "when you are happy with those prepend the C<E<lt>> character to run the "
23400 "guestfish commands for real."
23401 msgstr ""
23402
23403 # type: =head1
23404 #. type: =head1
23405 #: ../fish/guestfish.pod:724
23406 msgid "PIPES"
23407 msgstr ""
23408
23409 # type: textblock
23410 #. type: textblock
23411 #: ../fish/guestfish.pod:726
23412 msgid ""
23413 "Use C<command E<lt>spaceE<gt> | command> to pipe the output of the first "
23414 "command (a guestfish command) to the second command (any host command).  For "
23415 "example:"
23416 msgstr ""
23417
23418 # type: verbatim
23419 #. type: verbatim
23420 #: ../fish/guestfish.pod:730
23421 #, no-wrap
23422 msgid ""
23423 " cat /etc/passwd | awk -F: '$3 == 0 { print }'\n"
23424 "\n"
23425 msgstr ""
23426
23427 # type: textblock
23428 #. type: textblock
23429 #: ../fish/guestfish.pod:732
23430 msgid ""
23431 "(where C<cat> is the guestfish cat command, but C<awk> is the host awk "
23432 "program).  The above command would list all accounts in the guest filesystem "
23433 "which have UID 0, ie. root accounts including backdoors.  Other examples:"
23434 msgstr ""
23435
23436 # type: verbatim
23437 #. type: verbatim
23438 #: ../fish/guestfish.pod:737
23439 #, no-wrap
23440 msgid ""
23441 " hexdump /bin/ls | head\n"
23442 " list-devices | tail -1\n"
23443 " tgz-out / - | tar ztf -\n"
23444 "\n"
23445 msgstr ""
23446
23447 # type: textblock
23448 #. type: textblock
23449 #: ../fish/guestfish.pod:741
23450 msgid ""
23451 "The space before the pipe symbol is required, any space after the pipe "
23452 "symbol is optional.  Everything after the pipe symbol is just passed "
23453 "straight to the host shell, so it can contain redirections, globs and "
23454 "anything else that makes sense on the host side."
23455 msgstr ""
23456
23457 # type: textblock
23458 #. type: textblock
23459 #: ../fish/guestfish.pod:746
23460 msgid ""
23461 "To use a literal argument which begins with a pipe symbol, you have to quote "
23462 "it, eg:"
23463 msgstr ""
23464
23465 # type: verbatim
23466 #. type: verbatim
23467 #: ../fish/guestfish.pod:749
23468 #, no-wrap
23469 msgid ""
23470 " echo \"|\"\n"
23471 "\n"
23472 msgstr ""
23473
23474 # type: =head1
23475 #. type: =head1
23476 #: ../fish/guestfish.pod:751
23477 msgid "HOME DIRECTORIES"
23478 msgstr ""
23479
23480 # type: textblock
23481 #. type: textblock
23482 #: ../fish/guestfish.pod:753
23483 msgid ""
23484 "If a parameter starts with the character C<~> then the tilde may be expanded "
23485 "as a home directory path (either C<~> for the current user's home directory, "
23486 "or C<~user> for another user)."
23487 msgstr ""
23488
23489 # type: textblock
23490 #. type: textblock
23491 #: ../fish/guestfish.pod:757
23492 msgid ""
23493 "Note that home directory expansion happens for users known I<on the host>, "
23494 "not in the guest filesystem."
23495 msgstr ""
23496
23497 # type: textblock
23498 #. type: textblock
23499 #: ../fish/guestfish.pod:760
23500 msgid ""
23501 "To use a literal argument which begins with a tilde, you have to quote it, "
23502 "eg:"
23503 msgstr ""
23504
23505 # type: verbatim
23506 #. type: verbatim
23507 #: ../fish/guestfish.pod:763
23508 #, no-wrap
23509 msgid ""
23510 " echo \"~\"\n"
23511 "\n"
23512 msgstr ""
23513
23514 # type: textblock
23515 #. type: textblock
23516 #: ../fish/guestfish.pod:767
23517 msgid ""
23518 "Libguestfs has some support for Linux guests encrypted according to the "
23519 "Linux Unified Key Setup (LUKS) standard, which includes nearly all whole "
23520 "disk encryption systems used by modern Linux guests.  Currently only LVM-on-"
23521 "LUKS is supported."
23522 msgstr ""
23523
23524 # type: textblock
23525 #. type: textblock
23526 #: ../fish/guestfish.pod:772
23527 msgid "Identify encrypted block devices and partitions using L</vfs-type>:"
23528 msgstr ""
23529
23530 # type: verbatim
23531 #. type: verbatim
23532 #: ../fish/guestfish.pod:774
23533 #, no-wrap
23534 msgid ""
23535 " ><fs> vfs-type /dev/sda2\n"
23536 " crypto_LUKS\n"
23537 "\n"
23538 msgstr ""
23539
23540 # type: textblock
23541 #. type: textblock
23542 #: ../fish/guestfish.pod:777
23543 msgid ""
23544 "Then open those devices using L</luks-open>.  This creates a device-mapper "
23545 "device called C</dev/mapper/luksdev>."
23546 msgstr ""
23547
23548 # type: verbatim
23549 #. type: verbatim
23550 #: ../fish/guestfish.pod:780
23551 #, no-wrap
23552 msgid ""
23553 " ><fs> luks-open /dev/sda2 luksdev\n"
23554 " Enter key or passphrase (\"key\"): <enter the passphrase>\n"
23555 "\n"
23556 msgstr ""
23557
23558 # type: textblock
23559 #. type: textblock
23560 #: ../fish/guestfish.pod:783
23561 msgid ""
23562 "Finally you have to tell LVM to scan for volume groups on the newly created "
23563 "mapper device:"
23564 msgstr ""
23565
23566 # type: verbatim
23567 #. type: verbatim
23568 #: ../fish/guestfish.pod:786
23569 #, no-wrap
23570 msgid ""
23571 " vgscan\n"
23572 " vg-activate-all true\n"
23573 "\n"
23574 msgstr ""
23575
23576 # type: textblock
23577 #. type: textblock
23578 #: ../fish/guestfish.pod:789
23579 msgid "The logical volume(s) can now be mounted in the usual way."
23580 msgstr ""
23581
23582 # type: textblock
23583 #. type: textblock
23584 #: ../fish/guestfish.pod:791
23585 msgid ""
23586 "Before closing a LUKS device you must unmount any logical volumes on it and "
23587 "deactivate the volume groups by calling C<vg-activate false VG> on each "
23588 "one.  Then you can close the mapper device:"
23589 msgstr ""
23590
23591 # type: verbatim
23592 #. type: verbatim
23593 #: ../fish/guestfish.pod:795
23594 #, no-wrap
23595 msgid ""
23596 " vg-activate false /dev/VG\n"
23597 " luks-close /dev/mapper/luksdev\n"
23598 "\n"
23599 msgstr ""
23600
23601 # type: =head1
23602 #. type: =head1
23603 #: ../fish/guestfish.pod:798 ../tools/virt-edit.pl:342
23604 msgid "WINDOWS PATHS"
23605 msgstr ""
23606
23607 #. type: textblock
23608 #: ../fish/guestfish.pod:800
23609 msgid ""
23610 "If a path is prefixed with C<win:> then you can use Windows-style drive "
23611 "letters and paths (with some limitations).  The following commands are "
23612 "equivalent:"
23613 msgstr ""
23614
23615 # type: verbatim
23616 #. type: verbatim
23617 #: ../fish/guestfish.pod:804
23618 #, no-wrap
23619 msgid ""
23620 " file /WINDOWS/system32/config/system.LOG\n"
23621 "\n"
23622 msgstr ""
23623
23624 # type: verbatim
23625 #. type: verbatim
23626 #: ../fish/guestfish.pod:806
23627 #, no-wrap
23628 msgid ""
23629 " file win:\\windows\\system32\\config\\system.log\n"
23630 "\n"
23631 msgstr ""
23632
23633 #. type: verbatim
23634 #: ../fish/guestfish.pod:808
23635 #, no-wrap
23636 msgid ""
23637 " file WIN:C:\\Windows\\SYSTEM32\\CONFIG\\SYSTEM.LOG\n"
23638 "\n"
23639 msgstr ""
23640
23641 #. type: textblock
23642 #: ../fish/guestfish.pod:810
23643 msgid ""
23644 "The parameter is rewritten \"behind the scenes\" by looking up the position "
23645 "where the drive is mounted, prepending that to the path, changing all "
23646 "backslash characters to forward slash, then resolving the result using L</"
23647 "case-sensitive-path>.  For example if the E: drive was mounted on C</e> then "
23648 "the parameter might be rewritten like this:"
23649 msgstr ""
23650
23651 #. type: verbatim
23652 #: ../fish/guestfish.pod:816
23653 #, no-wrap
23654 msgid ""
23655 " win:e:\\foo\\bar => /e/FOO/bar\n"
23656 "\n"
23657 msgstr ""
23658
23659 #. type: textblock
23660 #: ../fish/guestfish.pod:818
23661 msgid "This only works in argument positions that expect a path."
23662 msgstr ""
23663
23664 # type: =head1
23665 #. type: =head1
23666 #: ../fish/guestfish.pod:820
23667 msgid "UPLOADING AND DOWNLOADING FILES"
23668 msgstr ""
23669
23670 # type: textblock
23671 #. type: textblock
23672 #: ../fish/guestfish.pod:822
23673 msgid ""
23674 "For commands such as C<upload>, C<download>, C<tar-in>, C<tar-out> and "
23675 "others which upload from or download to a local file, you can use the "
23676 "special filename C<-> to mean \"from stdin\" or \"to stdout\".  For example:"
23677 msgstr ""
23678
23679 # type: verbatim
23680 #. type: verbatim
23681 #: ../fish/guestfish.pod:826
23682 #, no-wrap
23683 msgid ""
23684 " upload - /foo\n"
23685 "\n"
23686 msgstr ""
23687
23688 # type: textblock
23689 #. type: textblock
23690 #: ../fish/guestfish.pod:828
23691 msgid ""
23692 "reads stdin and creates from that a file C</foo> in the disk image, and:"
23693 msgstr ""
23694
23695 # type: verbatim
23696 #. type: verbatim
23697 #: ../fish/guestfish.pod:831
23698 #, no-wrap
23699 msgid ""
23700 " tar-out /etc - | tar tf -\n"
23701 "\n"
23702 msgstr ""
23703
23704 # type: textblock
23705 #. type: textblock
23706 #: ../fish/guestfish.pod:833
23707 msgid ""
23708 "writes the tarball to stdout and then pipes that into the external \"tar\" "
23709 "command (see L</PIPES>)."
23710 msgstr ""
23711
23712 # type: textblock
23713 #. type: textblock
23714 #: ../fish/guestfish.pod:836
23715 msgid ""
23716 "When using C<-> to read from stdin, the input is read up to the end of "
23717 "stdin.  You can also use a special \"heredoc\"-like syntax to read up to "
23718 "some arbitrary end marker:"
23719 msgstr ""
23720
23721 # type: verbatim
23722 #. type: verbatim
23723 #: ../fish/guestfish.pod:840
23724 #, no-wrap
23725 msgid ""
23726 " upload -<<END /foo\n"
23727 " input line 1\n"
23728 " input line 2\n"
23729 " input line 3\n"
23730 " END\n"
23731 "\n"
23732 msgstr ""
23733
23734 # type: textblock
23735 #. type: textblock
23736 #: ../fish/guestfish.pod:846
23737 msgid ""
23738 "Any string of characters can be used instead of C<END>.  The end marker must "
23739 "appear on a line of its own, without any preceeding or following characters "
23740 "(not even spaces)."
23741 msgstr ""
23742
23743 # type: textblock
23744 #. type: textblock
23745 #: ../fish/guestfish.pod:850
23746 msgid ""
23747 "Note that the C<-E<lt>E<lt>> syntax only applies to parameters used to "
23748 "upload local files (so-called \"FileIn\" parameters in the generator)."
23749 msgstr ""
23750
23751 # type: =head1
23752 #. type: =head1
23753 #: ../fish/guestfish.pod:853
23754 msgid "EXIT ON ERROR BEHAVIOUR"
23755 msgstr ""
23756
23757 # type: textblock
23758 #. type: textblock
23759 #: ../fish/guestfish.pod:855
23760 msgid ""
23761 "By default, guestfish will ignore any errors when in interactive mode (ie. "
23762 "taking commands from a human over a tty), and will exit on the first error "
23763 "in non-interactive mode (scripts, commands given on the command line)."
23764 msgstr ""
23765
23766 # type: textblock
23767 #. type: textblock
23768 #: ../fish/guestfish.pod:860
23769 msgid ""
23770 "If you prefix a command with a I<-> character, then that command will not "
23771 "cause guestfish to exit, even if that (one) command returns an error."
23772 msgstr ""
23773
23774 # type: =head1
23775 #. type: =head1
23776 #: ../fish/guestfish.pod:864
23777 msgid "REMOTE CONTROL GUESTFISH OVER A SOCKET"
23778 msgstr ""
23779
23780 # type: textblock
23781 #. type: textblock
23782 #: ../fish/guestfish.pod:866
23783 msgid ""
23784 "Guestfish can be remote-controlled over a socket.  This is useful "
23785 "particularly in shell scripts where you want to make several different "
23786 "changes to a filesystem, but you don't want the overhead of starting up a "
23787 "guestfish process each time."
23788 msgstr ""
23789
23790 # type: textblock
23791 #. type: textblock
23792 #: ../fish/guestfish.pod:871
23793 msgid "Start a guestfish server process using:"
23794 msgstr ""
23795
23796 # type: verbatim
23797 #. type: verbatim
23798 #: ../fish/guestfish.pod:873
23799 #, no-wrap
23800 msgid ""
23801 " eval \"`guestfish --listen`\"\n"
23802 "\n"
23803 msgstr ""
23804
23805 # type: textblock
23806 #. type: textblock
23807 #: ../fish/guestfish.pod:875
23808 msgid "and then send it commands by doing:"
23809 msgstr ""
23810
23811 # type: verbatim
23812 #. type: verbatim
23813 #: ../fish/guestfish.pod:877
23814 #, no-wrap
23815 msgid ""
23816 " guestfish --remote cmd [...]\n"
23817 "\n"
23818 msgstr ""
23819
23820 # type: textblock
23821 #. type: textblock
23822 #: ../fish/guestfish.pod:879
23823 msgid "To cause the server to exit, send it the exit command:"
23824 msgstr ""
23825
23826 # type: verbatim
23827 #. type: verbatim
23828 #: ../fish/guestfish.pod:881
23829 #, no-wrap
23830 msgid ""
23831 " guestfish --remote exit\n"
23832 "\n"
23833 msgstr ""
23834
23835 # type: textblock
23836 #. type: textblock
23837 #: ../fish/guestfish.pod:883
23838 msgid ""
23839 "Note that the server will normally exit if there is an error in a command.  "
23840 "You can change this in the usual way.  See section L</EXIT ON ERROR "
23841 "BEHAVIOUR>."
23842 msgstr ""
23843
23844 # type: =head2
23845 #. type: =head2
23846 #: ../fish/guestfish.pod:887
23847 msgid "CONTROLLING MULTIPLE GUESTFISH PROCESSES"
23848 msgstr ""
23849
23850 # type: textblock
23851 #. type: textblock
23852 #: ../fish/guestfish.pod:889
23853 msgid ""
23854 "The C<eval> statement sets the environment variable C<$GUESTFISH_PID>, which "
23855 "is how the I<--remote> option knows where to send the commands.  You can "
23856 "have several guestfish listener processes running using:"
23857 msgstr ""
23858
23859 # type: verbatim
23860 #. type: verbatim
23861 #: ../fish/guestfish.pod:893
23862 #, no-wrap
23863 msgid ""
23864 " eval \"`guestfish --listen`\"\n"
23865 " pid1=$GUESTFISH_PID\n"
23866 " eval \"`guestfish --listen`\"\n"
23867 " pid2=$GUESTFISH_PID\n"
23868 " ...\n"
23869 " guestfish --remote=$pid1 cmd\n"
23870 " guestfish --remote=$pid2 cmd\n"
23871 "\n"
23872 msgstr ""
23873
23874 # type: =head2
23875 #. type: =head2
23876 #: ../fish/guestfish.pod:901
23877 msgid "REMOTE CONTROL AND CSH"
23878 msgstr ""
23879
23880 # type: textblock
23881 #. type: textblock
23882 #: ../fish/guestfish.pod:903
23883 msgid ""
23884 "When using csh-like shells (csh, tcsh etc) you have to add the I<--csh> "
23885 "option:"
23886 msgstr ""
23887
23888 # type: verbatim
23889 #. type: verbatim
23890 #: ../fish/guestfish.pod:906
23891 #, no-wrap
23892 msgid ""
23893 " eval \"`guestfish --listen --csh`\"\n"
23894 "\n"
23895 msgstr ""
23896
23897 # type: =head2
23898 #. type: =head2
23899 #: ../fish/guestfish.pod:908
23900 msgid "REMOTE CONTROL DETAILS"
23901 msgstr ""
23902
23903 # type: textblock
23904 #. type: textblock
23905 #: ../fish/guestfish.pod:910
23906 msgid ""
23907 "Remote control happens over a Unix domain socket called C</tmp/.guestfish-"
23908 "$UID/socket-$PID>, where C<$UID> is the effective user ID of the process, "
23909 "and C<$PID> is the process ID of the server."
23910 msgstr ""
23911
23912 # type: textblock
23913 #. type: textblock
23914 #: ../fish/guestfish.pod:914
23915 msgid "Guestfish client and server versions must match exactly."
23916 msgstr ""
23917
23918 # type: =head1
23919 #. type: =head1
23920 #: ../fish/guestfish.pod:916
23921 msgid "PREPARED DISK IMAGES"
23922 msgstr ""
23923
23924 # type: textblock
23925 #. type: textblock
23926 #: ../fish/guestfish.pod:918
23927 msgid ""
23928 "Use the I<-N type> or I<--new type> parameter to select one of a set of "
23929 "preformatted disk images that guestfish can make for you to save typing.  "
23930 "This is particularly useful for testing purposes.  This option is used "
23931 "instead of the I<-a> option, and like I<-a> can appear multiple times (and "
23932 "can be mixed with I<-a>)."
23933 msgstr ""
23934
23935 # type: textblock
23936 #. type: textblock
23937 #: ../fish/guestfish.pod:924
23938 msgid ""
23939 "The new disk is called C<test1.img> for the first I<-N>, C<test2.img> for "
23940 "the second and so on.  Existing files in the current directory are "
23941 "I<overwritten>."
23942 msgstr ""
23943
23944 # type: textblock
23945 #. type: textblock
23946 #: ../fish/guestfish.pod:928
23947 msgid ""
23948 "The type briefly describes how the disk should be sized, partitioned, how "
23949 "filesystem(s) should be created, and how content should be added.  "
23950 "Optionally the type can be followed by extra parameters, separated by C<:> "
23951 "(colon) characters.  For example, I<-N fs> creates a default 100MB, sparsely-"
23952 "allocated disk, containing a single partition, with the partition formatted "
23953 "as ext2.  I<-N fs:ext4:1G> is the same, but for an ext4 filesystem on a 1GB "
23954 "disk instead."
23955 msgstr ""
23956
23957 # type: textblock
23958 #. type: textblock
23959 #: ../fish/guestfish.pod:936
23960 msgid "To list the available types and any extra parameters they take, run:"
23961 msgstr ""
23962
23963 # type: textblock
23964 #. type: textblock
23965 #: ../fish/guestfish.pod:940
23966 msgid ""
23967 "Note that the prepared filesystem is not mounted.  You would usually have to "
23968 "use the C<mount /dev/sda1 /> command or add the I<-m /dev/sda1> option."
23969 msgstr ""
23970
23971 # type: textblock
23972 #. type: textblock
23973 #: ../fish/guestfish.pod:944
23974 msgid ""
23975 "If any I<-N> or I<--new> options are given, the guest is automatically "
23976 "launched."
23977 msgstr ""
23978
23979 # type: textblock
23980 #. type: textblock
23981 #: ../fish/guestfish.pod:949
23982 msgid "Create a 100MB disk with an ext4-formatted partition:"
23983 msgstr ""
23984
23985 # type: verbatim
23986 #. type: verbatim
23987 #: ../fish/guestfish.pod:951
23988 #, no-wrap
23989 msgid ""
23990 " guestfish -N fs:ext4\n"
23991 "\n"
23992 msgstr ""
23993
23994 # type: textblock
23995 #. type: textblock
23996 #: ../fish/guestfish.pod:953
23997 msgid "Create a 32MB disk with a VFAT-formatted partition, and mount it:"
23998 msgstr ""
23999
24000 # type: verbatim
24001 #. type: verbatim
24002 #: ../fish/guestfish.pod:955
24003 #, no-wrap
24004 msgid ""
24005 " guestfish -N fs:vfat:32M -m /dev/sda1\n"
24006 "\n"
24007 msgstr ""
24008
24009 # type: textblock
24010 #. type: textblock
24011 #: ../fish/guestfish.pod:957
24012 msgid "Create a blank 200MB disk:"
24013 msgstr ""
24014
24015 # type: verbatim
24016 #. type: verbatim
24017 #: ../fish/guestfish.pod:959
24018 #, no-wrap
24019 msgid ""
24020 " guestfish -N disk:200M\n"
24021 "\n"
24022 msgstr ""
24023
24024 # type: =head1
24025 #. type: =head1
24026 #: ../fish/guestfish.pod:961
24027 msgid "PROGRESS BARS"
24028 msgstr ""
24029
24030 # type: textblock
24031 #. type: textblock
24032 #: ../fish/guestfish.pod:963
24033 msgid ""
24034 "Some (not all) long-running commands send progress notification messages as "
24035 "they are running.  Guestfish turns these messages into progress bars."
24036 msgstr ""
24037
24038 # type: textblock
24039 #. type: textblock
24040 #: ../fish/guestfish.pod:967
24041 msgid ""
24042 "When a command that supports progress bars takes longer than two seconds to "
24043 "run, and if progress bars are enabled, then you will see one appearing below "
24044 "the command:"
24045 msgstr ""
24046
24047 # type: verbatim
24048 #. type: verbatim
24049 #: ../fish/guestfish.pod:971
24050 #, no-wrap
24051 msgid ""
24052 " ><fs> copy-size /large-file /another-file 2048M\n"
24053 " / 10% [#####-----------------------------------------] 00:30\n"
24054 "\n"
24055 msgstr ""
24056
24057 # type: textblock
24058 #. type: textblock
24059 #: ../fish/guestfish.pod:974
24060 msgid ""
24061 "The spinner on the left hand side moves round once for every progress "
24062 "notification received from the backend.  This is a (reasonably) golden "
24063 "assurance that the command is \"doing something\" even if the progress bar "
24064 "is not moving, because the command is able to send the progress "
24065 "notifications.  When the bar reaches 100% and the command finishes, the "
24066 "spinner disappears."
24067 msgstr ""
24068
24069 # type: textblock
24070 #. type: textblock
24071 #: ../fish/guestfish.pod:981
24072 msgid ""
24073 "Progress bars are enabled by default when guestfish is used interactively.  "
24074 "You can enable them even for non-interactive modes using I<--progress-bars>, "
24075 "and you can disable them completely using I<--no-progress-bars>."
24076 msgstr ""
24077
24078 # type: =head1
24079 #. type: =head1
24080 #: ../fish/guestfish.pod:986
24081 msgid "GUESTFISH COMMANDS"
24082 msgstr ""
24083
24084 # type: textblock
24085 #. type: textblock
24086 #: ../fish/guestfish.pod:988
24087 msgid ""
24088 "The commands in this section are guestfish convenience commands, in other "
24089 "words, they are not part of the L<guestfs(3)> API."
24090 msgstr ""
24091
24092 # type: =head2
24093 #. type: =head2
24094 #: ../fish/guestfish.pod:991
24095 msgid "help"
24096 msgstr ""
24097
24098 # type: verbatim
24099 #. type: verbatim
24100 #: ../fish/guestfish.pod:993
24101 #, no-wrap
24102 msgid ""
24103 " help\n"
24104 " help cmd\n"
24105 "\n"
24106 msgstr ""
24107
24108 # type: textblock
24109 #. type: textblock
24110 #: ../fish/guestfish.pod:996
24111 msgid "Without any parameter, this provides general help."
24112 msgstr ""
24113
24114 # type: textblock
24115 #. type: textblock
24116 #: ../fish/guestfish.pod:998
24117 msgid "With a C<cmd> parameter, this displays detailed help for that command."
24118 msgstr ""
24119
24120 # type: =head2
24121 #. type: =head2
24122 #: ../fish/guestfish.pod:1000
24123 msgid "quit | exit"
24124 msgstr ""
24125
24126 # type: textblock
24127 #. type: textblock
24128 #: ../fish/guestfish.pod:1002
24129 msgid "This exits guestfish.  You can also use C<^D> key."
24130 msgstr ""
24131
24132 # type: textblock
24133 #. type: textblock
24134 #: ../fish/guestfish.pod:1004
24135 msgid "@FISH_COMMANDS@"
24136 msgstr ""
24137
24138 # type: =head1
24139 #. type: =head1
24140 #: ../fish/guestfish.pod:1006
24141 msgid "COMMANDS"
24142 msgstr ""
24143
24144 # type: =head1
24145 #. type: =head1
24146 #: ../fish/guestfish.pod:1010 ../test-tool/libguestfs-test-tool.pod:77
24147 msgid "EXIT CODE"
24148 msgstr ""
24149
24150 # type: textblock
24151 #. type: textblock
24152 #: ../fish/guestfish.pod:1012
24153 msgid ""
24154 "guestfish returns 0 if the commands completed without error, or 1 if there "
24155 "was an error."
24156 msgstr ""
24157
24158 # type: =item
24159 #. type: =item
24160 #: ../fish/guestfish.pod:1019
24161 msgid "EDITOR"
24162 msgstr ""
24163
24164 # type: textblock
24165 #. type: textblock
24166 #: ../fish/guestfish.pod:1021
24167 msgid ""
24168 "The C<edit> command uses C<$EDITOR> as the editor.  If not set, it uses "
24169 "C<vi>."
24170 msgstr ""
24171
24172 # type: =item
24173 #. type: =item
24174 #: ../fish/guestfish.pod:1024
24175 msgid "GUESTFISH_PID"
24176 msgstr ""
24177
24178 # type: textblock
24179 #. type: textblock
24180 #: ../fish/guestfish.pod:1026
24181 msgid ""
24182 "Used with the I<--remote> option to specify the remote guestfish process to "
24183 "control.  See section L</REMOTE CONTROL GUESTFISH OVER A SOCKET>."
24184 msgstr ""
24185
24186 # type: =item
24187 #. type: =item
24188 #: ../fish/guestfish.pod:1030
24189 msgid "HEXEDITOR"
24190 msgstr ""
24191
24192 # type: textblock
24193 #. type: textblock
24194 #: ../fish/guestfish.pod:1032
24195 msgid ""
24196 "The L</hexedit> command uses C<$HEXEDITOR> as the external hex editor.  If "
24197 "not specified, the external L<hexedit(1)> program is used."
24198 msgstr ""
24199
24200 # type: =item
24201 #. type: =item
24202 #: ../fish/guestfish.pod:1036
24203 msgid "HOME"
24204 msgstr ""
24205
24206 # type: textblock
24207 #. type: textblock
24208 #: ../fish/guestfish.pod:1038
24209 msgid ""
24210 "If compiled with GNU readline support, various files in the home directory "
24211 "can be used.  See L</FILES>."
24212 msgstr ""
24213
24214 # type: textblock
24215 #. type: textblock
24216 #: ../fish/guestfish.pod:1047
24217 msgid ""
24218 "Set C<LIBGUESTFS_DEBUG=1> to enable verbose messages.  This has the same "
24219 "effect as using the B<-v> option."
24220 msgstr ""
24221
24222 # type: textblock
24223 #. type: textblock
24224 #: ../fish/guestfish.pod:1059
24225 msgid ""
24226 "Set the path that guestfish uses to search for kernel and initrd.img.  See "
24227 "the discussion of paths in L<guestfs(3)>."
24228 msgstr ""
24229
24230 # type: textblock
24231 #. type: textblock
24232 #: ../fish/guestfish.pod:1070
24233 msgid "Set C<LIBGUESTFS_TRACE=1> to enable command traces."
24234 msgstr ""
24235
24236 # type: =item
24237 #. type: =item
24238 #: ../fish/guestfish.pod:1072
24239 msgid "PAGER"
24240 msgstr ""
24241
24242 # type: textblock
24243 #. type: textblock
24244 #: ../fish/guestfish.pod:1074
24245 msgid ""
24246 "The C<more> command uses C<$PAGER> as the pager.  If not set, it uses "
24247 "C<more>."
24248 msgstr ""
24249
24250 # type: =head1
24251 #. type: =head1
24252 #: ../fish/guestfish.pod:1090 ../fuse/guestmount.pod:262
24253 msgid "FILES"
24254 msgstr ""
24255
24256 #. type: =item
24257 #: ../fish/guestfish.pod:1094 ../fuse/guestmount.pod:266
24258 msgid "$HOME/.libguestfs-tools.rc"
24259 msgstr ""
24260
24261 #. type: =item
24262 #: ../fish/guestfish.pod:1096 ../fuse/guestmount.pod:268
24263 msgid "/etc/libguestfs-tools.conf"
24264 msgstr ""
24265
24266 #. type: textblock
24267 #: ../fish/guestfish.pod:1098 ../fuse/guestmount.pod:270
24268 msgid ""
24269 "This configuration file controls the default read-only or read-write mode "
24270 "(I<--ro> or I<--rw>)."
24271 msgstr ""
24272
24273 #. type: textblock
24274 #: ../fish/guestfish.pod:1101
24275 msgid "See L</OPENING DISKS FOR READ AND WRITE>."
24276 msgstr ""
24277
24278 # type: =item
24279 #. type: =item
24280 #: ../fish/guestfish.pod:1103
24281 msgid "$HOME/.guestfish"
24282 msgstr ""
24283
24284 # type: textblock
24285 #. type: textblock
24286 #: ../fish/guestfish.pod:1105
24287 msgid ""
24288 "If compiled with GNU readline support, then the command history is saved in "
24289 "this file."
24290 msgstr ""
24291
24292 # type: =item
24293 #. type: =item
24294 #: ../fish/guestfish.pod:1108
24295 msgid "$HOME/.inputrc"
24296 msgstr ""
24297
24298 # type: =item
24299 #. type: =item
24300 #: ../fish/guestfish.pod:1110
24301 msgid "/etc/inputrc"
24302 msgstr ""
24303
24304 # type: textblock
24305 #. type: textblock
24306 #: ../fish/guestfish.pod:1112
24307 msgid ""
24308 "If compiled with GNU readline support, then these files can be used to "
24309 "configure readline.  For further information, please see L<readline(3)/"
24310 "INITIALIZATION FILE>."
24311 msgstr ""
24312
24313 # type: textblock
24314 #. type: textblock
24315 #: ../fish/guestfish.pod:1116
24316 msgid "To write rules which only apply to guestfish, use:"
24317 msgstr ""
24318
24319 # type: verbatim
24320 #. type: verbatim
24321 #: ../fish/guestfish.pod:1118
24322 #, no-wrap
24323 msgid ""
24324 " $if guestfish\n"
24325 " ...\n"
24326 " $endif\n"
24327 "\n"
24328 msgstr ""
24329
24330 # type: textblock
24331 #. type: textblock
24332 #: ../fish/guestfish.pod:1122
24333 msgid ""
24334 "Variables that you can set in inputrc that change the behaviour of guestfish "
24335 "in useful ways include:"
24336 msgstr ""
24337
24338 # type: =item
24339 #. type: =item
24340 #: ../fish/guestfish.pod:1127
24341 msgid "completion-ignore-case (default: on)"
24342 msgstr ""
24343
24344 # type: textblock
24345 #. type: textblock
24346 #: ../fish/guestfish.pod:1129
24347 msgid ""
24348 "By default, guestfish will ignore case when tab-completing paths on the "
24349 "disk.  Use:"
24350 msgstr ""
24351
24352 # type: verbatim
24353 #. type: verbatim
24354 #: ../fish/guestfish.pod:1132
24355 #, no-wrap
24356 msgid ""
24357 " set completion-ignore-case off\n"
24358 "\n"
24359 msgstr ""
24360
24361 # type: textblock
24362 #. type: textblock
24363 #: ../fish/guestfish.pod:1134
24364 msgid "to make guestfish case sensitive."
24365 msgstr ""
24366
24367 # type: =item
24368 #. type: =item
24369 #: ../fish/guestfish.pod:1138
24370 msgid "test1.img"
24371 msgstr ""
24372
24373 # type: =item
24374 #. type: =item
24375 #: ../fish/guestfish.pod:1140
24376 msgid "test2.img (etc)"
24377 msgstr ""
24378
24379 #. type: textblock
24380 #: ../fish/guestfish.pod:1142
24381 msgid ""
24382 "When using the I<-N> or I<--new> option, the prepared disk or filesystem "
24383 "will be created in the file C<test1.img> in the current directory.  The "
24384 "second use of I<-N> will use C<test2.img> and so on.  Any existing file with "
24385 "the same name will be overwritten."
24386 msgstr ""
24387
24388 #. type: textblock
24389 #: ../fish/guestfish.pod:1151
24390 msgid ""
24391 "L<guestfs(3)>, L<http://libguestfs.org/>, L<virt-cat(1)>, L<virt-copy-in(1)"
24392 ">, L<virt-copy-out(1)>, L<virt-df(1)>, L<virt-edit(1)>, L<virt-filesystems(1)"
24393 ">, L<virt-inspector(1)>, L<virt-list-filesystems(1)>, L<virt-list-partitions"
24394 "(1)>, L<virt-ls(1)>, L<virt-make-fs(1)>, L<virt-rescue(1)>, L<virt-resize(1)"
24395 ">, L<virt-tar(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>, L<virt-win-reg(1)"
24396 ">, L<hexedit(1)>."
24397 msgstr ""
24398
24399 # type: textblock
24400 #. type: textblock
24401 #: ../fish/guestfish.pod:1181 ../test-tool/libguestfs-test-tool.pod:102
24402 #: ../fuse/guestmount.pod:297 ../tools/virt-edit.pl:518
24403 #: ../tools/virt-win-reg.pl:606 ../tools/virt-list-filesystems.pl:210
24404 #: ../tools/virt-tar.pl:309 ../tools/virt-make-fs.pl:572
24405 #: ../tools/virt-list-partitions.pl:277
24406 msgid ""
24407 "This program is free software; you can redistribute it and/or modify it "
24408 "under the terms of the GNU General Public License as published by the Free "
24409 "Software Foundation; either version 2 of the License, or (at your option) "
24410 "any later version."
24411 msgstr ""
24412
24413 # type: textblock
24414 #. type: textblock
24415 #: ../fish/guestfish.pod:1186 ../test-tool/libguestfs-test-tool.pod:107
24416 #: ../fuse/guestmount.pod:302 ../tools/virt-edit.pl:523
24417 #: ../tools/virt-win-reg.pl:611 ../tools/virt-list-filesystems.pl:215
24418 #: ../tools/virt-tar.pl:314 ../tools/virt-make-fs.pl:577
24419 #: ../tools/virt-list-partitions.pl:282
24420 msgid ""
24421 "This program is distributed in the hope that it will be useful, but WITHOUT "
24422 "ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or "
24423 "FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for "
24424 "more details."
24425 msgstr ""
24426
24427 # type: textblock
24428 #. type: textblock
24429 #: ../fish/guestfish.pod:1191 ../test-tool/libguestfs-test-tool.pod:112
24430 #: ../fuse/guestmount.pod:307 ../tools/virt-edit.pl:528
24431 #: ../tools/virt-win-reg.pl:616 ../tools/virt-list-filesystems.pl:220
24432 #: ../tools/virt-tar.pl:319 ../tools/virt-make-fs.pl:582
24433 #: ../tools/virt-list-partitions.pl:287
24434 msgid ""
24435 "You should have received a copy of the GNU General Public License along with "
24436 "this program; if not, write to the Free Software Foundation, Inc., 675 Mass "
24437 "Ave, Cambridge, MA 02139, USA."
24438 msgstr ""
24439
24440 # type: =head2
24441 #. type: =head2
24442 #: ../fish/guestfish-actions.pod:1
24443 msgid "add-cdrom"
24444 msgstr ""
24445
24446 # type: verbatim
24447 #. type: verbatim
24448 #: ../fish/guestfish-actions.pod:3
24449 #, no-wrap
24450 msgid ""
24451 " add-cdrom filename\n"
24452 "\n"
24453 msgstr ""
24454
24455 # type: textblock
24456 #. type: textblock
24457 #: ../fish/guestfish-actions.pod:15
24458 msgid ""
24459 "This call checks for the existence of C<filename>.  This stops you from "
24460 "specifying other types of drive which are supported by qemu such as C<nbd:> "
24461 "and C<http:> URLs.  To specify those, use the general L</config> call "
24462 "instead."
24463 msgstr ""
24464
24465 # type: textblock
24466 #. type: textblock
24467 #: ../fish/guestfish-actions.pod:22
24468 msgid ""
24469 "If you just want to add an ISO file (often you use this as an efficient way "
24470 "to transfer large files into the guest), then you should probably use L</add-"
24471 "drive-ro> instead."
24472 msgstr ""
24473
24474 # type: =head2
24475 #. type: =head2
24476 #: ../fish/guestfish-actions.pod:35
24477 msgid "add-domain"
24478 msgstr ""
24479
24480 # type: =head2
24481 #. type: =head2
24482 #: ../fish/guestfish-actions.pod:37
24483 msgid "domain"
24484 msgstr ""
24485
24486 #. type: verbatim
24487 #: ../fish/guestfish-actions.pod:39
24488 #, no-wrap
24489 msgid ""
24490 " add-domain dom [libvirturi:..] [readonly:..] [iface:..] [live:..]\n"
24491 "\n"
24492 msgstr ""
24493
24494 # type: textblock
24495 #. type: textblock
24496 #: ../fish/guestfish-actions.pod:41
24497 msgid ""
24498 "This function adds the disk(s) attached to the named libvirt domain C<dom>.  "
24499 "It works by connecting to libvirt, requesting the domain and domain XML from "
24500 "libvirt, parsing it for disks, and calling L</add-drive-opts> on each one."
24501 msgstr ""
24502
24503 # type: textblock
24504 #. type: textblock
24505 #: ../fish/guestfish-actions.pod:71
24506 msgid ""
24507 "The other optional parameters are passed directly through to L</add-drive-"
24508 "opts>."
24509 msgstr ""
24510
24511 # type: textblock
24512 #. type: textblock
24513 #: ../fish/guestfish-actions.pod:74 ../fish/guestfish-actions.pod:138
24514 #: ../fish/guestfish-actions.pod:3044
24515 msgid ""
24516 "This command has one or more optional arguments.  See L</OPTIONAL ARGUMENTS>."
24517 msgstr ""
24518
24519 # type: =head2
24520 #. type: =head2
24521 #: ../fish/guestfish-actions.pod:76
24522 msgid "add-drive"
24523 msgstr ""
24524
24525 # type: verbatim
24526 #. type: verbatim
24527 #: ../fish/guestfish-actions.pod:78
24528 #, no-wrap
24529 msgid ""
24530 " add-drive filename\n"
24531 "\n"
24532 msgstr ""
24533
24534 # type: textblock
24535 #. type: textblock
24536 #: ../fish/guestfish-actions.pod:80
24537 msgid ""
24538 "This function is the equivalent of calling L</add-drive-opts> with no "
24539 "optional parameters, so the disk is added writable, with the format being "
24540 "detected automatically."
24541 msgstr ""
24542
24543 # type: textblock
24544 #. type: textblock
24545 #: ../fish/guestfish-actions.pod:84
24546 msgid ""
24547 "Automatic detection of the format opens you up to a potential security hole "
24548 "when dealing with untrusted raw-format images.  See CVE-2010-3851 and "
24549 "RHBZ#642934.  Specifying the format closes this security hole.  Therefore "
24550 "you should think about replacing calls to this function with calls to L</add-"
24551 "drive-opts>, and specifying the format."
24552 msgstr ""
24553
24554 # type: =head2
24555 #. type: =head2
24556 #: ../fish/guestfish-actions.pod:91
24557 msgid "add-drive-opts"
24558 msgstr ""
24559
24560 # type: =head2
24561 #. type: =head2
24562 #: ../fish/guestfish-actions.pod:93
24563 msgid "add"
24564 msgstr ""
24565
24566 # type: verbatim
24567 #. type: verbatim
24568 #: ../fish/guestfish-actions.pod:95
24569 #, no-wrap
24570 msgid ""
24571 " add-drive-opts filename [readonly:..] [format:..] [iface:..]\n"
24572 "\n"
24573 msgstr ""
24574
24575 # type: textblock
24576 #. type: textblock
24577 #: ../fish/guestfish-actions.pod:122
24578 msgid ""
24579 "This forces the image format.  If you omit this (or use L</add-drive> or L</"
24580 "add-drive-ro>) then the format is automatically detected.  Possible formats "
24581 "include C<raw> and C<qcow2>."
24582 msgstr ""
24583
24584 # type: textblock
24585 #. type: textblock
24586 #: ../fish/guestfish-actions.pod:133
24587 msgid ""
24588 "This rarely-used option lets you emulate the behaviour of the deprecated L</"
24589 "add-drive-with-if> call (q.v.)"
24590 msgstr ""
24591
24592 # type: =head2
24593 #. type: =head2
24594 #: ../fish/guestfish-actions.pod:140
24595 msgid "add-drive-ro"
24596 msgstr ""
24597
24598 # type: =head2
24599 #. type: =head2
24600 #: ../fish/guestfish-actions.pod:142
24601 msgid "add-ro"
24602 msgstr ""
24603
24604 # type: verbatim
24605 #. type: verbatim
24606 #: ../fish/guestfish-actions.pod:144
24607 #, no-wrap
24608 msgid ""
24609 " add-drive-ro filename\n"
24610 "\n"
24611 msgstr ""
24612
24613 # type: textblock
24614 #. type: textblock
24615 #: ../fish/guestfish-actions.pod:146
24616 msgid ""
24617 "This function is the equivalent of calling L</add-drive-opts> with the "
24618 "optional parameter C<GUESTFS_ADD_DRIVE_OPTS_READONLY> set to 1, so the disk "
24619 "is added read-only, with the format being detected automatically."
24620 msgstr ""
24621
24622 # type: =head2
24623 #. type: =head2
24624 #: ../fish/guestfish-actions.pod:151
24625 msgid "add-drive-ro-with-if"
24626 msgstr ""
24627
24628 # type: verbatim
24629 #. type: verbatim
24630 #: ../fish/guestfish-actions.pod:153
24631 #, no-wrap
24632 msgid ""
24633 " add-drive-ro-with-if filename iface\n"
24634 "\n"
24635 msgstr ""
24636
24637 # type: textblock
24638 #. type: textblock
24639 #: ../fish/guestfish-actions.pod:155
24640 msgid ""
24641 "This is the same as L</add-drive-ro> but it allows you to specify the QEMU "
24642 "interface emulation to use at run time."
24643 msgstr ""
24644
24645 # type: =head2
24646 #. type: =head2
24647 #: ../fish/guestfish-actions.pod:165
24648 msgid "add-drive-with-if"
24649 msgstr ""
24650
24651 # type: verbatim
24652 #. type: verbatim
24653 #: ../fish/guestfish-actions.pod:167
24654 #, no-wrap
24655 msgid ""
24656 " add-drive-with-if filename iface\n"
24657 "\n"
24658 msgstr ""
24659
24660 # type: textblock
24661 #. type: textblock
24662 #: ../fish/guestfish-actions.pod:169
24663 msgid ""
24664 "This is the same as L</add-drive> but it allows you to specify the QEMU "
24665 "interface emulation to use at run time."
24666 msgstr ""
24667
24668 # type: =head2
24669 #. type: =head2
24670 #: ../fish/guestfish-actions.pod:179
24671 msgid "aug-clear"
24672 msgstr ""
24673
24674 # type: verbatim
24675 #. type: verbatim
24676 #: ../fish/guestfish-actions.pod:181
24677 #, no-wrap
24678 msgid ""
24679 " aug-clear augpath\n"
24680 "\n"
24681 msgstr ""
24682
24683 # type: =head2
24684 #. type: =head2
24685 #: ../fish/guestfish-actions.pod:186
24686 msgid "aug-close"
24687 msgstr ""
24688
24689 # type: verbatim
24690 #. type: verbatim
24691 #: ../fish/guestfish-actions.pod:188
24692 #, no-wrap
24693 msgid ""
24694 " aug-close\n"
24695 "\n"
24696 msgstr ""
24697
24698 # type: textblock
24699 #. type: textblock
24700 #: ../fish/guestfish-actions.pod:190
24701 msgid ""
24702 "Close the current Augeas handle and free up any resources used by it.  After "
24703 "calling this, you have to call L</aug-init> again before you can use any "
24704 "other Augeas functions."
24705 msgstr ""
24706
24707 # type: =head2
24708 #. type: =head2
24709 #: ../fish/guestfish-actions.pod:195
24710 msgid "aug-defnode"
24711 msgstr ""
24712
24713 # type: verbatim
24714 #. type: verbatim
24715 #: ../fish/guestfish-actions.pod:197
24716 #, no-wrap
24717 msgid ""
24718 " aug-defnode name expr val\n"
24719 "\n"
24720 msgstr ""
24721
24722 # type: textblock
24723 #. type: textblock
24724 #: ../fish/guestfish-actions.pod:202
24725 msgid ""
24726 "If C<expr> evaluates to an empty nodeset, a node is created, equivalent to "
24727 "calling L</aug-set> C<expr>, C<value>.  C<name> will be the nodeset "
24728 "containing that single node."
24729 msgstr ""
24730
24731 # type: =head2
24732 #. type: =head2
24733 #: ../fish/guestfish-actions.pod:210
24734 msgid "aug-defvar"
24735 msgstr ""
24736
24737 # type: verbatim
24738 #. type: verbatim
24739 #: ../fish/guestfish-actions.pod:212
24740 #, no-wrap
24741 msgid ""
24742 " aug-defvar name expr\n"
24743 "\n"
24744 msgstr ""
24745
24746 # type: =head2
24747 #. type: =head2
24748 #: ../fish/guestfish-actions.pod:221
24749 msgid "aug-get"
24750 msgstr ""
24751
24752 # type: verbatim
24753 #. type: verbatim
24754 #: ../fish/guestfish-actions.pod:223
24755 #, no-wrap
24756 msgid ""
24757 " aug-get augpath\n"
24758 "\n"
24759 msgstr ""
24760
24761 # type: =head2
24762 #. type: =head2
24763 #: ../fish/guestfish-actions.pod:228
24764 msgid "aug-init"
24765 msgstr ""
24766
24767 # type: verbatim
24768 #. type: verbatim
24769 #: ../fish/guestfish-actions.pod:230
24770 #, no-wrap
24771 msgid ""
24772 " aug-init root flags\n"
24773 "\n"
24774 msgstr ""
24775
24776 # type: textblock
24777 #. type: textblock
24778 #: ../fish/guestfish-actions.pod:236
24779 msgid "You must call this before using any other L</aug-*> commands."
24780 msgstr ""
24781
24782 # type: textblock
24783 #. type: textblock
24784 #: ../fish/guestfish-actions.pod:271
24785 msgid "Do not load the tree in L</aug-init>."
24786 msgstr ""
24787
24788 # type: textblock
24789 #. type: textblock
24790 #: ../fish/guestfish-actions.pod:275
24791 msgid "To close the handle, you can call L</aug-close>."
24792 msgstr ""
24793
24794 # type: =head2
24795 #. type: =head2
24796 #: ../fish/guestfish-actions.pod:279
24797 msgid "aug-insert"
24798 msgstr ""
24799
24800 # type: verbatim
24801 #. type: verbatim
24802 #: ../fish/guestfish-actions.pod:281
24803 #, no-wrap
24804 msgid ""
24805 " aug-insert augpath label true|false\n"
24806 "\n"
24807 msgstr ""
24808
24809 # type: =head2
24810 #. type: =head2
24811 #: ../fish/guestfish-actions.pod:291
24812 msgid "aug-load"
24813 msgstr ""
24814
24815 # type: verbatim
24816 #. type: verbatim
24817 #: ../fish/guestfish-actions.pod:293
24818 #, no-wrap
24819 msgid ""
24820 " aug-load\n"
24821 "\n"
24822 msgstr ""
24823
24824 # type: =head2
24825 #. type: =head2
24826 #: ../fish/guestfish-actions.pod:300
24827 msgid "aug-ls"
24828 msgstr ""
24829
24830 # type: verbatim
24831 #. type: verbatim
24832 #: ../fish/guestfish-actions.pod:302
24833 #, no-wrap
24834 msgid ""
24835 " aug-ls augpath\n"
24836 "\n"
24837 msgstr ""
24838
24839 # type: textblock
24840 #. type: textblock
24841 #: ../fish/guestfish-actions.pod:304
24842 msgid ""
24843 "This is just a shortcut for listing L</aug-match> C<path/*> and sorting the "
24844 "resulting nodes into alphabetical order."
24845 msgstr ""
24846
24847 # type: =head2
24848 #. type: =head2
24849 #: ../fish/guestfish-actions.pod:307
24850 msgid "aug-match"
24851 msgstr ""
24852
24853 # type: verbatim
24854 #. type: verbatim
24855 #: ../fish/guestfish-actions.pod:309
24856 #, no-wrap
24857 msgid ""
24858 " aug-match augpath\n"
24859 "\n"
24860 msgstr ""
24861
24862 # type: =head2
24863 #. type: =head2
24864 #: ../fish/guestfish-actions.pod:315
24865 msgid "aug-mv"
24866 msgstr ""
24867
24868 # type: verbatim
24869 #. type: verbatim
24870 #: ../fish/guestfish-actions.pod:317
24871 #, no-wrap
24872 msgid ""
24873 " aug-mv src dest\n"
24874 "\n"
24875 msgstr ""
24876
24877 # type: =head2
24878 #. type: =head2
24879 #: ../fish/guestfish-actions.pod:322
24880 msgid "aug-rm"
24881 msgstr ""
24882
24883 # type: verbatim
24884 #. type: verbatim
24885 #: ../fish/guestfish-actions.pod:324
24886 #, no-wrap
24887 msgid ""
24888 " aug-rm augpath\n"
24889 "\n"
24890 msgstr ""
24891
24892 # type: =head2
24893 #. type: =head2
24894 #: ../fish/guestfish-actions.pod:330
24895 msgid "aug-save"
24896 msgstr ""
24897
24898 # type: verbatim
24899 #. type: verbatim
24900 #: ../fish/guestfish-actions.pod:332
24901 #, no-wrap
24902 msgid ""
24903 " aug-save\n"
24904 "\n"
24905 msgstr ""
24906
24907 # type: textblock
24908 #. type: textblock
24909 #: ../fish/guestfish-actions.pod:336
24910 msgid ""
24911 "The flags which were passed to L</aug-init> affect exactly how files are "
24912 "saved."
24913 msgstr ""
24914
24915 # type: =head2
24916 #. type: =head2
24917 #: ../fish/guestfish-actions.pod:339
24918 msgid "aug-set"
24919 msgstr ""
24920
24921 # type: verbatim
24922 #. type: verbatim
24923 #: ../fish/guestfish-actions.pod:341
24924 #, no-wrap
24925 msgid ""
24926 " aug-set augpath val\n"
24927 "\n"
24928 msgstr ""
24929
24930 # type: textblock
24931 #. type: textblock
24932 #: ../fish/guestfish-actions.pod:345
24933 msgid ""
24934 "In the Augeas API, it is possible to clear a node by setting the value to "
24935 "NULL.  Due to an oversight in the libguestfs API you cannot do that with "
24936 "this call.  Instead you must use the L</aug-clear> call."
24937 msgstr ""
24938
24939 # type: =head2
24940 #. type: =head2
24941 #: ../fish/guestfish-actions.pod:350
24942 msgid "available"
24943 msgstr ""
24944
24945 # type: verbatim
24946 #. type: verbatim
24947 #: ../fish/guestfish-actions.pod:352
24948 #, no-wrap
24949 msgid ""
24950 " available 'groups ...'\n"
24951 "\n"
24952 msgstr ""
24953
24954 # type: textblock
24955 #. type: textblock
24956 #: ../fish/guestfish-actions.pod:358
24957 msgid ""
24958 "The libguestfs groups, and the functions that those groups correspond to, "
24959 "are listed in L<guestfs(3)/AVAILABILITY>.  You can also fetch this list at "
24960 "runtime by calling L</available-all-groups>."
24961 msgstr ""
24962
24963 # type: textblock
24964 #. type: textblock
24965 #: ../fish/guestfish-actions.pod:382
24966 msgid "You must call L</launch> before calling this function."
24967 msgstr ""
24968
24969 # type: textblock
24970 #. type: textblock
24971 #: ../fish/guestfish-actions.pod:404
24972 msgid ""
24973 "This call was added in version C<1.0.80>.  In previous versions of "
24974 "libguestfs all you could do would be to speculatively execute a command to "
24975 "find out if the daemon implemented it.  See also L</version>."
24976 msgstr ""
24977
24978 # type: =head2
24979 #. type: =head2
24980 #: ../fish/guestfish-actions.pod:411
24981 msgid "available-all-groups"
24982 msgstr ""
24983
24984 # type: verbatim
24985 #. type: verbatim
24986 #: ../fish/guestfish-actions.pod:413
24987 #, no-wrap
24988 msgid ""
24989 " available-all-groups\n"
24990 "\n"
24991 msgstr ""
24992
24993 # type: textblock
24994 #. type: textblock
24995 #: ../fish/guestfish-actions.pod:415
24996 msgid ""
24997 "This command returns a list of all optional groups that this daemon knows "
24998 "about.  Note this returns both supported and unsupported groups.  To find "
24999 "out which ones the daemon can actually support you have to call L</"
25000 "available> on each member of the returned list."
25001 msgstr ""
25002
25003 # type: textblock
25004 #. type: textblock
25005 #: ../fish/guestfish-actions.pod:421
25006 msgid "See also L</available> and L<guestfs(3)/AVAILABILITY>."
25007 msgstr ""
25008
25009 # type: =head2
25010 #. type: =head2
25011 #: ../fish/guestfish-actions.pod:423
25012 msgid "base64-in"
25013 msgstr ""
25014
25015 # type: verbatim
25016 #. type: verbatim
25017 #: ../fish/guestfish-actions.pod:425
25018 #, no-wrap
25019 msgid ""
25020 " base64-in (base64file|-) filename\n"
25021 "\n"
25022 msgstr ""
25023
25024 # type: textblock
25025 #. type: textblock
25026 #: ../fish/guestfish-actions.pod:430 ../fish/guestfish-actions.pod:439
25027 #: ../fish/guestfish-actions.pod:663 ../fish/guestfish-actions.pod:832
25028 #: ../fish/guestfish-actions.pod:851 ../fish/guestfish-actions.pod:1225
25029 #: ../fish/guestfish-actions.pod:4486 ../fish/guestfish-actions.pod:4498
25030 #: ../fish/guestfish-actions.pod:4509 ../fish/guestfish-actions.pod:4520
25031 #: ../fish/guestfish-actions.pod:4572 ../fish/guestfish-actions.pod:4581
25032 #: ../fish/guestfish-actions.pod:4635 ../fish/guestfish-actions.pod:4658
25033 msgid "Use C<-> instead of a filename to read/write from stdin/stdout."
25034 msgstr ""
25035
25036 # type: =head2
25037 #. type: =head2
25038 #: ../fish/guestfish-actions.pod:432
25039 msgid "base64-out"
25040 msgstr ""
25041
25042 # type: verbatim
25043 #. type: verbatim
25044 #: ../fish/guestfish-actions.pod:434
25045 #, no-wrap
25046 msgid ""
25047 " base64-out filename (base64file|-)\n"
25048 "\n"
25049 msgstr ""
25050
25051 # type: =head2
25052 #. type: =head2
25053 #: ../fish/guestfish-actions.pod:441
25054 msgid "blockdev-flushbufs"
25055 msgstr ""
25056
25057 # type: verbatim
25058 #. type: verbatim
25059 #: ../fish/guestfish-actions.pod:443
25060 #, no-wrap
25061 msgid ""
25062 " blockdev-flushbufs device\n"
25063 "\n"
25064 msgstr ""
25065
25066 # type: =head2
25067 #. type: =head2
25068 #: ../fish/guestfish-actions.pod:450
25069 msgid "blockdev-getbsz"
25070 msgstr ""
25071
25072 # type: verbatim
25073 #. type: verbatim
25074 #: ../fish/guestfish-actions.pod:452
25075 #, no-wrap
25076 msgid ""
25077 " blockdev-getbsz device\n"
25078 "\n"
25079 msgstr ""
25080
25081 # type: =head2
25082 #. type: =head2
25083 #: ../fish/guestfish-actions.pod:461
25084 msgid "blockdev-getro"
25085 msgstr ""
25086
25087 # type: verbatim
25088 #. type: verbatim
25089 #: ../fish/guestfish-actions.pod:463
25090 #, no-wrap
25091 msgid ""
25092 " blockdev-getro device\n"
25093 "\n"
25094 msgstr ""
25095
25096 # type: =head2
25097 #. type: =head2
25098 #: ../fish/guestfish-actions.pod:470
25099 msgid "blockdev-getsize64"
25100 msgstr ""
25101
25102 # type: verbatim
25103 #. type: verbatim
25104 #: ../fish/guestfish-actions.pod:472
25105 #, no-wrap
25106 msgid ""
25107 " blockdev-getsize64 device\n"
25108 "\n"
25109 msgstr ""
25110
25111 # type: textblock
25112 #. type: textblock
25113 #: ../fish/guestfish-actions.pod:476
25114 msgid "See also L</blockdev-getsz>."
25115 msgstr ""
25116
25117 # type: =head2
25118 #. type: =head2
25119 #: ../fish/guestfish-actions.pod:480
25120 msgid "blockdev-getss"
25121 msgstr ""
25122
25123 # type: verbatim
25124 #. type: verbatim
25125 #: ../fish/guestfish-actions.pod:482
25126 #, no-wrap
25127 msgid ""
25128 " blockdev-getss device\n"
25129 "\n"
25130 msgstr ""
25131
25132 # type: textblock
25133 #. type: textblock
25134 #: ../fish/guestfish-actions.pod:487
25135 msgid ""
25136 "(Note, this is not the size in sectors, use L</blockdev-getsz> for that)."
25137 msgstr ""
25138
25139 # type: =head2
25140 #. type: =head2
25141 #: ../fish/guestfish-actions.pod:492
25142 msgid "blockdev-getsz"
25143 msgstr ""
25144
25145 # type: verbatim
25146 #. type: verbatim
25147 #: ../fish/guestfish-actions.pod:494
25148 #, no-wrap
25149 msgid ""
25150 " blockdev-getsz device\n"
25151 "\n"
25152 msgstr ""
25153
25154 # type: textblock
25155 #. type: textblock
25156 #: ../fish/guestfish-actions.pod:499
25157 msgid ""
25158 "See also L</blockdev-getss> for the real sector size of the device, and L</"
25159 "blockdev-getsize64> for the more useful I<size in bytes>."
25160 msgstr ""
25161
25162 # type: =head2
25163 #. type: =head2
25164 #: ../fish/guestfish-actions.pod:505
25165 msgid "blockdev-rereadpt"
25166 msgstr ""
25167
25168 # type: verbatim
25169 #. type: verbatim
25170 #: ../fish/guestfish-actions.pod:507
25171 #, no-wrap
25172 msgid ""
25173 " blockdev-rereadpt device\n"
25174 "\n"
25175 msgstr ""
25176
25177 # type: =head2
25178 #. type: =head2
25179 #: ../fish/guestfish-actions.pod:513
25180 msgid "blockdev-setbsz"
25181 msgstr ""
25182
25183 # type: verbatim
25184 #. type: verbatim
25185 #: ../fish/guestfish-actions.pod:515
25186 #, no-wrap
25187 msgid ""
25188 " blockdev-setbsz device blocksize\n"
25189 "\n"
25190 msgstr ""
25191
25192 # type: =head2
25193 #. type: =head2
25194 #: ../fish/guestfish-actions.pod:524
25195 msgid "blockdev-setro"
25196 msgstr ""
25197
25198 # type: verbatim
25199 #. type: verbatim
25200 #: ../fish/guestfish-actions.pod:526
25201 #, no-wrap
25202 msgid ""
25203 " blockdev-setro device\n"
25204 "\n"
25205 msgstr ""
25206
25207 # type: =head2
25208 #. type: =head2
25209 #: ../fish/guestfish-actions.pod:532
25210 msgid "blockdev-setrw"
25211 msgstr ""
25212
25213 # type: verbatim
25214 #. type: verbatim
25215 #: ../fish/guestfish-actions.pod:534
25216 #, no-wrap
25217 msgid ""
25218 " blockdev-setrw device\n"
25219 "\n"
25220 msgstr ""
25221
25222 # type: =head2
25223 #. type: =head2
25224 #: ../fish/guestfish-actions.pod:540
25225 msgid "case-sensitive-path"
25226 msgstr ""
25227
25228 # type: verbatim
25229 #. type: verbatim
25230 #: ../fish/guestfish-actions.pod:542
25231 #, no-wrap
25232 msgid ""
25233 " case-sensitive-path path\n"
25234 "\n"
25235 msgstr ""
25236
25237 # type: textblock
25238 #. type: textblock
25239 #: ../fish/guestfish-actions.pod:566
25240 msgid ""
25241 "Thus L</case-sensitive-path> (\"/Windows/System32\")  might return C<\"/"
25242 "WINDOWS/system32\"> (the exact return value would depend on details of how "
25243 "the directories were originally created under Windows)."
25244 msgstr ""
25245
25246 # type: textblock
25247 #. type: textblock
25248 #: ../fish/guestfish-actions.pod:574
25249 msgid "See also L</realpath>."
25250 msgstr ""
25251
25252 # type: =head2
25253 #. type: =head2
25254 #: ../fish/guestfish-actions.pod:576
25255 msgid "cat"
25256 msgstr ""
25257
25258 # type: verbatim
25259 #. type: verbatim
25260 #: ../fish/guestfish-actions.pod:578
25261 #, no-wrap
25262 msgid ""
25263 " cat path\n"
25264 "\n"
25265 msgstr ""
25266
25267 # type: textblock
25268 #. type: textblock
25269 #: ../fish/guestfish-actions.pod:582
25270 msgid ""
25271 "Note that this function cannot correctly handle binary files (specifically, "
25272 "files containing C<\\0> character which is treated as end of string).  For "
25273 "those you need to use the L</read-file> or L</download> functions which have "
25274 "a more complex interface."
25275 msgstr ""
25276
25277 # type: =head2
25278 #. type: =head2
25279 #: ../fish/guestfish-actions.pod:590
25280 msgid "checksum"
25281 msgstr ""
25282
25283 # type: verbatim
25284 #. type: verbatim
25285 #: ../fish/guestfish-actions.pod:592
25286 #, no-wrap
25287 msgid ""
25288 " checksum csumtype path\n"
25289 "\n"
25290 msgstr ""
25291
25292 # type: textblock
25293 #. type: textblock
25294 #: ../fish/guestfish-actions.pod:635
25295 msgid "To get the checksum for a device, use L</checksum-device>."
25296 msgstr ""
25297
25298 # type: textblock
25299 #. type: textblock
25300 #: ../fish/guestfish-actions.pod:637
25301 msgid "To get the checksums for many files, use L</checksums-out>."
25302 msgstr ""
25303
25304 # type: =head2
25305 #. type: =head2
25306 #: ../fish/guestfish-actions.pod:639
25307 msgid "checksum-device"
25308 msgstr ""
25309
25310 # type: verbatim
25311 #. type: verbatim
25312 #: ../fish/guestfish-actions.pod:641
25313 #, no-wrap
25314 msgid ""
25315 " checksum-device csumtype device\n"
25316 "\n"
25317 msgstr ""
25318
25319 # type: textblock
25320 #. type: textblock
25321 #: ../fish/guestfish-actions.pod:643
25322 msgid ""
25323 "This call computes the MD5, SHAx or CRC checksum of the contents of the "
25324 "device named C<device>.  For the types of checksums supported see the L</"
25325 "checksum> command."
25326 msgstr ""
25327
25328 # type: =head2
25329 #. type: =head2
25330 #: ../fish/guestfish-actions.pod:647
25331 msgid "checksums-out"
25332 msgstr ""
25333
25334 # type: verbatim
25335 #. type: verbatim
25336 #: ../fish/guestfish-actions.pod:649
25337 #, no-wrap
25338 msgid ""
25339 " checksums-out csumtype directory (sumsfile|-)\n"
25340 "\n"
25341 msgstr ""
25342
25343 # type: =head2
25344 #. type: =head2
25345 #: ../fish/guestfish-actions.pod:665
25346 msgid "chmod"
25347 msgstr ""
25348
25349 # type: verbatim
25350 #. type: verbatim
25351 #: ../fish/guestfish-actions.pod:667
25352 #, no-wrap
25353 msgid ""
25354 " chmod mode path\n"
25355 "\n"
25356 msgstr ""
25357
25358 # type: =head2
25359 #. type: =head2
25360 #: ../fish/guestfish-actions.pod:678
25361 msgid "chown"
25362 msgstr ""
25363
25364 # type: verbatim
25365 #. type: verbatim
25366 #: ../fish/guestfish-actions.pod:680
25367 #, no-wrap
25368 msgid ""
25369 " chown owner group path\n"
25370 "\n"
25371 msgstr ""
25372
25373 # type: =head2
25374 #. type: =head2
25375 #: ../fish/guestfish-actions.pod:688
25376 msgid "command"
25377 msgstr ""
25378
25379 # type: verbatim
25380 #. type: verbatim
25381 #: ../fish/guestfish-actions.pod:690
25382 #, no-wrap
25383 msgid ""
25384 " command 'arguments ...'\n"
25385 "\n"
25386 msgstr ""
25387
25388 # type: textblock
25389 #. type: textblock
25390 #: ../fish/guestfish-actions.pod:697
25391 msgid ""
25392 "The single parameter is an argv-style list of arguments.  The first element "
25393 "is the name of the program to run.  Subsequent elements are parameters.  The "
25394 "list must be non-empty (ie. must contain a program name).  Note that the "
25395 "command runs directly, and is I<not> invoked via the shell (see L</sh>)."
25396 msgstr ""
25397
25398 # type: =head2
25399 #. type: =head2
25400 #: ../fish/guestfish-actions.pod:725
25401 msgid "command-lines"
25402 msgstr ""
25403
25404 # type: verbatim
25405 #. type: verbatim
25406 #: ../fish/guestfish-actions.pod:727
25407 #, no-wrap
25408 msgid ""
25409 " command-lines 'arguments ...'\n"
25410 "\n"
25411 msgstr ""
25412
25413 # type: textblock
25414 #. type: textblock
25415 #: ../fish/guestfish-actions.pod:729
25416 msgid ""
25417 "This is the same as L</command>, but splits the result into a list of lines."
25418 msgstr ""
25419
25420 # type: textblock
25421 #. type: textblock
25422 #: ../fish/guestfish-actions.pod:732
25423 msgid "See also: L</sh-lines>"
25424 msgstr ""
25425
25426 # type: =head2
25427 #. type: =head2
25428 #: ../fish/guestfish-actions.pod:737
25429 msgid "config"
25430 msgstr ""
25431
25432 # type: verbatim
25433 #. type: verbatim
25434 #: ../fish/guestfish-actions.pod:739
25435 #, no-wrap
25436 msgid ""
25437 " config qemuparam qemuvalue\n"
25438 "\n"
25439 msgstr ""
25440
25441 # type: =head2
25442 #. type: =head2
25443 #: ../fish/guestfish-actions.pod:750
25444 msgid "copy-size"
25445 msgstr ""
25446
25447 # type: verbatim
25448 #. type: verbatim
25449 #: ../fish/guestfish-actions.pod:752
25450 #, no-wrap
25451 msgid ""
25452 " copy-size src dest size\n"
25453 "\n"
25454 msgstr ""
25455
25456 # type: =head2
25457 #. type: =head2
25458 #: ../fish/guestfish-actions.pod:760
25459 msgid "cp"
25460 msgstr ""
25461
25462 # type: verbatim
25463 #. type: verbatim
25464 #: ../fish/guestfish-actions.pod:762
25465 #, no-wrap
25466 msgid ""
25467 " cp src dest\n"
25468 "\n"
25469 msgstr ""
25470
25471 # type: =head2
25472 #. type: =head2
25473 #: ../fish/guestfish-actions.pod:767
25474 msgid "cp-a"
25475 msgstr ""
25476
25477 # type: verbatim
25478 #. type: verbatim
25479 #: ../fish/guestfish-actions.pod:769
25480 #, no-wrap
25481 msgid ""
25482 " cp-a src dest\n"
25483 "\n"
25484 msgstr ""
25485
25486 # type: =head2
25487 #. type: =head2
25488 #: ../fish/guestfish-actions.pod:774
25489 msgid "dd"
25490 msgstr ""
25491
25492 # type: verbatim
25493 #. type: verbatim
25494 #: ../fish/guestfish-actions.pod:776
25495 #, no-wrap
25496 msgid ""
25497 " dd src dest\n"
25498 "\n"
25499 msgstr ""
25500
25501 # type: textblock
25502 #. type: textblock
25503 #: ../fish/guestfish-actions.pod:783
25504 msgid ""
25505 "If the destination is a device, it must be as large or larger than the "
25506 "source file or device, otherwise the copy will fail.  This command cannot do "
25507 "partial copies (see L</copy-size>)."
25508 msgstr ""
25509
25510 # type: =head2
25511 #. type: =head2
25512 #: ../fish/guestfish-actions.pod:787
25513 msgid "df"
25514 msgstr ""
25515
25516 # type: verbatim
25517 #. type: verbatim
25518 #: ../fish/guestfish-actions.pod:789
25519 #, no-wrap
25520 msgid ""
25521 " df\n"
25522 "\n"
25523 msgstr ""
25524
25525 # type: textblock
25526 #. type: textblock
25527 #: ../fish/guestfish-actions.pod:793 ../fish/guestfish-actions.pod:804
25528 msgid ""
25529 "This command is mostly useful for interactive sessions.  It is I<not> "
25530 "intended that you try to parse the output string.  Use L</statvfs> from "
25531 "programs."
25532 msgstr ""
25533
25534 # type: =head2
25535 #. type: =head2
25536 #: ../fish/guestfish-actions.pod:797
25537 msgid "df-h"
25538 msgstr ""
25539
25540 # type: verbatim
25541 #. type: verbatim
25542 #: ../fish/guestfish-actions.pod:799
25543 #, no-wrap
25544 msgid ""
25545 " df-h\n"
25546 "\n"
25547 msgstr ""
25548
25549 # type: =head2
25550 #. type: =head2
25551 #: ../fish/guestfish-actions.pod:808
25552 msgid "dmesg"
25553 msgstr ""
25554
25555 # type: verbatim
25556 #. type: verbatim
25557 #: ../fish/guestfish-actions.pod:810
25558 #, no-wrap
25559 msgid ""
25560 " dmesg\n"
25561 "\n"
25562 msgstr ""
25563
25564 # type: textblock
25565 #. type: textblock
25566 #: ../fish/guestfish-actions.pod:816
25567 msgid ""
25568 "Another way to get the same information is to enable verbose messages with "
25569 "L</set-verbose> or by setting the environment variable C<LIBGUESTFS_DEBUG=1> "
25570 "before running the program."
25571 msgstr ""
25572
25573 # type: =head2
25574 #. type: =head2
25575 #: ../fish/guestfish-actions.pod:821
25576 msgid "download"
25577 msgstr ""
25578
25579 # type: verbatim
25580 #. type: verbatim
25581 #: ../fish/guestfish-actions.pod:823
25582 #, no-wrap
25583 msgid ""
25584 " download remotefilename (filename|-)\n"
25585 "\n"
25586 msgstr ""
25587
25588 # type: textblock
25589 #. type: textblock
25590 #: ../fish/guestfish-actions.pod:830
25591 msgid "See also L</upload>, L</cat>."
25592 msgstr ""
25593
25594 # type: =head2
25595 #. type: =head2
25596 #: ../fish/guestfish-actions.pod:834
25597 msgid "download-offset"
25598 msgstr ""
25599
25600 # type: verbatim
25601 #. type: verbatim
25602 #: ../fish/guestfish-actions.pod:836
25603 #, no-wrap
25604 msgid ""
25605 " download-offset remotefilename (filename|-) offset size\n"
25606 "\n"
25607 msgstr ""
25608
25609 # type: textblock
25610 #. type: textblock
25611 #: ../fish/guestfish-actions.pod:844
25612 msgid ""
25613 "Note that there is no limit on the amount of data that can be downloaded "
25614 "with this call, unlike with L</pread>, and this call always reads the full "
25615 "amount unless an error occurs."
25616 msgstr ""
25617
25618 # type: textblock
25619 #. type: textblock
25620 #: ../fish/guestfish-actions.pod:849
25621 msgid "See also L</download>, L</pread>."
25622 msgstr ""
25623
25624 # type: =head2
25625 #. type: =head2
25626 #: ../fish/guestfish-actions.pod:853
25627 msgid "drop-caches"
25628 msgstr ""
25629
25630 # type: verbatim
25631 #. type: verbatim
25632 #: ../fish/guestfish-actions.pod:855
25633 #, no-wrap
25634 msgid ""
25635 " drop-caches whattodrop\n"
25636 "\n"
25637 msgstr ""
25638
25639 # type: =head2
25640 #. type: =head2
25641 #: ../fish/guestfish-actions.pod:867
25642 msgid "du"
25643 msgstr ""
25644
25645 # type: verbatim
25646 #. type: verbatim
25647 #: ../fish/guestfish-actions.pod:869
25648 #, no-wrap
25649 msgid ""
25650 " du path\n"
25651 "\n"
25652 msgstr ""
25653
25654 # type: =head2
25655 #. type: =head2
25656 #: ../fish/guestfish-actions.pod:881
25657 msgid "e2fsck-f"
25658 msgstr ""
25659
25660 # type: verbatim
25661 #. type: verbatim
25662 #: ../fish/guestfish-actions.pod:883
25663 #, no-wrap
25664 msgid ""
25665 " e2fsck-f device\n"
25666 "\n"
25667 msgstr ""
25668
25669 # type: textblock
25670 #. type: textblock
25671 #: ../fish/guestfish-actions.pod:889
25672 msgid ""
25673 "This command is only needed because of L</resize2fs> (q.v.).  Normally you "
25674 "should use L</fsck>."
25675 msgstr ""
25676
25677 # type: =head2
25678 #. type: =head2
25679 #: ../fish/guestfish-actions.pod:892
25680 msgid "echo-daemon"
25681 msgstr ""
25682
25683 # type: verbatim
25684 #. type: verbatim
25685 #: ../fish/guestfish-actions.pod:894
25686 #, no-wrap
25687 msgid ""
25688 " echo-daemon 'words ...'\n"
25689 "\n"
25690 msgstr ""
25691
25692 # type: textblock
25693 #. type: textblock
25694 #: ../fish/guestfish-actions.pod:901
25695 msgid "See also L</ping-daemon>."
25696 msgstr ""
25697
25698 # type: =head2
25699 #. type: =head2
25700 #: ../fish/guestfish-actions.pod:903
25701 msgid "egrep"
25702 msgstr ""
25703
25704 # type: verbatim
25705 #. type: verbatim
25706 #: ../fish/guestfish-actions.pod:905
25707 #, no-wrap
25708 msgid ""
25709 " egrep regex path\n"
25710 "\n"
25711 msgstr ""
25712
25713 # type: =head2
25714 #. type: =head2
25715 #: ../fish/guestfish-actions.pod:913
25716 msgid "egrepi"
25717 msgstr ""
25718
25719 # type: verbatim
25720 #. type: verbatim
25721 #: ../fish/guestfish-actions.pod:915
25722 #, no-wrap
25723 msgid ""
25724 " egrepi regex path\n"
25725 "\n"
25726 msgstr ""
25727
25728 # type: =head2
25729 #. type: =head2
25730 #: ../fish/guestfish-actions.pod:923
25731 msgid "equal"
25732 msgstr ""
25733
25734 # type: verbatim
25735 #. type: verbatim
25736 #: ../fish/guestfish-actions.pod:925
25737 #, no-wrap
25738 msgid ""
25739 " equal file1 file2\n"
25740 "\n"
25741 msgstr ""
25742
25743 # type: =head2
25744 #. type: =head2
25745 #: ../fish/guestfish-actions.pod:932
25746 msgid "exists"
25747 msgstr ""
25748
25749 # type: verbatim
25750 #. type: verbatim
25751 #: ../fish/guestfish-actions.pod:934
25752 #, no-wrap
25753 msgid ""
25754 " exists path\n"
25755 "\n"
25756 msgstr ""
25757
25758 # type: textblock
25759 #. type: textblock
25760 #: ../fish/guestfish-actions.pod:939
25761 msgid "See also L</is-file>, L</is-dir>, L</stat>."
25762 msgstr ""
25763
25764 # type: =head2
25765 #. type: =head2
25766 #: ../fish/guestfish-actions.pod:941
25767 msgid "fallocate"
25768 msgstr ""
25769
25770 # type: verbatim
25771 #. type: verbatim
25772 #: ../fish/guestfish-actions.pod:943
25773 #, no-wrap
25774 msgid ""
25775 " fallocate path len\n"
25776 "\n"
25777 msgstr ""
25778
25779 # type: =head2
25780 #. type: =head2
25781 #: ../fish/guestfish-actions.pod:960
25782 msgid "fallocate64"
25783 msgstr ""
25784
25785 # type: verbatim
25786 #. type: verbatim
25787 #: ../fish/guestfish-actions.pod:962
25788 #, no-wrap
25789 msgid ""
25790 " fallocate64 path len\n"
25791 "\n"
25792 msgstr ""
25793
25794 # type: textblock
25795 #. type: textblock
25796 #: ../fish/guestfish-actions.pod:968
25797 msgid ""
25798 "Note that this call allocates disk blocks for the file.  To create a sparse "
25799 "file use L</truncate-size> instead."
25800 msgstr ""
25801
25802 # type: textblock
25803 #. type: textblock
25804 #: ../fish/guestfish-actions.pod:971
25805 msgid ""
25806 "The deprecated call L</fallocate> does the same, but owing to an oversight "
25807 "it only allowed 30 bit lengths to be specified, effectively limiting the "
25808 "maximum size of files created through that call to 1GB."
25809 msgstr ""
25810
25811 # type: =head2
25812 #. type: =head2
25813 #: ../fish/guestfish-actions.pod:980
25814 msgid "fgrep"
25815 msgstr ""
25816
25817 # type: verbatim
25818 #. type: verbatim
25819 #: ../fish/guestfish-actions.pod:982
25820 #, no-wrap
25821 msgid ""
25822 " fgrep pattern path\n"
25823 "\n"
25824 msgstr ""
25825
25826 # type: =head2
25827 #. type: =head2
25828 #: ../fish/guestfish-actions.pod:990
25829 msgid "fgrepi"
25830 msgstr ""
25831
25832 # type: verbatim
25833 #. type: verbatim
25834 #: ../fish/guestfish-actions.pod:992
25835 #, no-wrap
25836 msgid ""
25837 " fgrepi pattern path\n"
25838 "\n"
25839 msgstr ""
25840
25841 # type: =head2
25842 #. type: =head2
25843 #: ../fish/guestfish-actions.pod:1000
25844 msgid "file"
25845 msgstr ""
25846
25847 # type: verbatim
25848 #. type: verbatim
25849 #: ../fish/guestfish-actions.pod:1002
25850 #, no-wrap
25851 msgid ""
25852 " file path\n"
25853 "\n"
25854 msgstr ""
25855
25856 #. type: textblock
25857 #: ../fish/guestfish-actions.pod:1018
25858 msgid ""
25859 "See also: L<file(1)>, L</vfs-type>, L</lstat>, L</is-file>, L</is-blockdev> "
25860 "(etc)."
25861 msgstr ""
25862
25863 # type: =head2
25864 #. type: =head2
25865 #: ../fish/guestfish-actions.pod:1021
25866 msgid "file-architecture"
25867 msgstr ""
25868
25869 # type: verbatim
25870 #. type: verbatim
25871 #: ../fish/guestfish-actions.pod:1023
25872 #, no-wrap
25873 msgid ""
25874 " file-architecture filename\n"
25875 "\n"
25876 msgstr ""
25877
25878 # type: =head2
25879 #. type: =head2
25880 #: ../fish/guestfish-actions.pod:1126
25881 msgid "filesize"
25882 msgstr ""
25883
25884 # type: verbatim
25885 #. type: verbatim
25886 #: ../fish/guestfish-actions.pod:1128
25887 #, no-wrap
25888 msgid ""
25889 " filesize file\n"
25890 "\n"
25891 msgstr ""
25892
25893 # type: textblock
25894 #. type: textblock
25895 #: ../fish/guestfish-actions.pod:1132
25896 msgid ""
25897 "To get other stats about a file, use L</stat>, L</lstat>, L</is-dir>, L</is-"
25898 "file> etc.  To get the size of block devices, use L</blockdev-getsize64>."
25899 msgstr ""
25900
25901 # type: =head2
25902 #. type: =head2
25903 #: ../fish/guestfish-actions.pod:1136
25904 msgid "fill"
25905 msgstr ""
25906
25907 # type: verbatim
25908 #. type: verbatim
25909 #: ../fish/guestfish-actions.pod:1138
25910 #, no-wrap
25911 msgid ""
25912 " fill c len path\n"
25913 "\n"
25914 msgstr ""
25915
25916 # type: textblock
25917 #. type: textblock
25918 #: ../fish/guestfish-actions.pod:1144
25919 msgid ""
25920 "To fill a file with zero bytes (sparsely), it is much more efficient to use "
25921 "L</truncate-size>.  To create a file with a pattern of repeating bytes use "
25922 "L</fill-pattern>."
25923 msgstr ""
25924
25925 # type: =head2
25926 #. type: =head2
25927 #: ../fish/guestfish-actions.pod:1149
25928 msgid "fill-pattern"
25929 msgstr ""
25930
25931 # type: verbatim
25932 #. type: verbatim
25933 #: ../fish/guestfish-actions.pod:1151
25934 #, no-wrap
25935 msgid ""
25936 " fill-pattern pattern len path\n"
25937 "\n"
25938 msgstr ""
25939
25940 # type: textblock
25941 #. type: textblock
25942 #: ../fish/guestfish-actions.pod:1153
25943 msgid ""
25944 "This function is like L</fill> except that it creates a new file of length "
25945 "C<len> containing the repeating pattern of bytes in C<pattern>.  The pattern "
25946 "is truncated if necessary to ensure the length of the file is exactly C<len> "
25947 "bytes."
25948 msgstr ""
25949
25950 # type: =head2
25951 #. type: =head2
25952 #: ../fish/guestfish-actions.pod:1158
25953 msgid "find"
25954 msgstr ""
25955
25956 # type: verbatim
25957 #. type: verbatim
25958 #: ../fish/guestfish-actions.pod:1160
25959 #, no-wrap
25960 msgid ""
25961 " find directory\n"
25962 "\n"
25963 msgstr ""
25964
25965 # type: textblock
25966 #. type: textblock
25967 #: ../fish/guestfish-actions.pod:1174
25968 msgid "then the returned list from L</find> C</tmp> would be 4 elements:"
25969 msgstr ""
25970
25971 # type: textblock
25972 #. type: textblock
25973 #: ../fish/guestfish-actions.pod:1187
25974 msgid "See also L</find0>."
25975 msgstr ""
25976
25977 # type: =head2
25978 #. type: =head2
25979 #: ../fish/guestfish-actions.pod:1192
25980 msgid "find0"
25981 msgstr ""
25982
25983 # type: verbatim
25984 #. type: verbatim
25985 #: ../fish/guestfish-actions.pod:1194
25986 #, no-wrap
25987 msgid ""
25988 " find0 directory (files|-)\n"
25989 "\n"
25990 msgstr ""
25991
25992 # type: textblock
25993 #. type: textblock
25994 #: ../fish/guestfish-actions.pod:1200
25995 msgid ""
25996 "This command works the same way as L</find> with the following exceptions:"
25997 msgstr ""
25998
25999 # type: =head2
26000 #. type: =head2
26001 #: ../fish/guestfish-actions.pod:1227
26002 msgid "findfs-label"
26003 msgstr ""
26004
26005 # type: verbatim
26006 #. type: verbatim
26007 #: ../fish/guestfish-actions.pod:1229
26008 #, no-wrap
26009 msgid ""
26010 " findfs-label label\n"
26011 "\n"
26012 msgstr ""
26013
26014 # type: textblock
26015 #. type: textblock
26016 #: ../fish/guestfish-actions.pod:1235
26017 msgid "To find the label of a filesystem, use L</vfs-label>."
26018 msgstr ""
26019
26020 # type: =head2
26021 #. type: =head2
26022 #: ../fish/guestfish-actions.pod:1237
26023 msgid "findfs-uuid"
26024 msgstr ""
26025
26026 # type: verbatim
26027 #. type: verbatim
26028 #: ../fish/guestfish-actions.pod:1239
26029 #, no-wrap
26030 msgid ""
26031 " findfs-uuid uuid\n"
26032 "\n"
26033 msgstr ""
26034
26035 # type: textblock
26036 #. type: textblock
26037 #: ../fish/guestfish-actions.pod:1245
26038 msgid "To find the UUID of a filesystem, use L</vfs-uuid>."
26039 msgstr ""
26040
26041 # type: =head2
26042 #. type: =head2
26043 #: ../fish/guestfish-actions.pod:1247
26044 msgid "fsck"
26045 msgstr ""
26046
26047 # type: verbatim
26048 #. type: verbatim
26049 #: ../fish/guestfish-actions.pod:1249
26050 #, no-wrap
26051 msgid ""
26052 " fsck fstype device\n"
26053 "\n"
26054 msgstr ""
26055
26056 # type: =head2
26057 #. type: =head2
26058 #: ../fish/guestfish-actions.pod:1279
26059 msgid "get-append"
26060 msgstr ""
26061
26062 # type: verbatim
26063 #. type: verbatim
26064 #: ../fish/guestfish-actions.pod:1281
26065 #, no-wrap
26066 msgid ""
26067 " get-append\n"
26068 "\n"
26069 msgstr ""
26070
26071 #. type: =head2
26072 #: ../fish/guestfish-actions.pod:1288
26073 msgid "get-attach-method"
26074 msgstr ""
26075
26076 #. type: verbatim
26077 #: ../fish/guestfish-actions.pod:1290
26078 #, no-wrap
26079 msgid ""
26080 " get-attach-method\n"
26081 "\n"
26082 msgstr ""
26083
26084 #. type: textblock
26085 #: ../fish/guestfish-actions.pod:1292
26086 msgid "Return the current attach method.  See L</set-attach-method>."
26087 msgstr ""
26088
26089 # type: =head2
26090 #. type: =head2
26091 #: ../fish/guestfish-actions.pod:1294
26092 msgid "get-autosync"
26093 msgstr ""
26094
26095 # type: verbatim
26096 #. type: verbatim
26097 #: ../fish/guestfish-actions.pod:1296
26098 #, no-wrap
26099 msgid ""
26100 " get-autosync\n"
26101 "\n"
26102 msgstr ""
26103
26104 # type: =head2
26105 #. type: =head2
26106 #: ../fish/guestfish-actions.pod:1300
26107 msgid "get-direct"
26108 msgstr ""
26109
26110 # type: verbatim
26111 #. type: verbatim
26112 #: ../fish/guestfish-actions.pod:1302
26113 #, no-wrap
26114 msgid ""
26115 " get-direct\n"
26116 "\n"
26117 msgstr ""
26118
26119 # type: =head2
26120 #. type: =head2
26121 #: ../fish/guestfish-actions.pod:1306
26122 msgid "get-e2label"
26123 msgstr ""
26124
26125 # type: verbatim
26126 #. type: verbatim
26127 #: ../fish/guestfish-actions.pod:1308
26128 #, no-wrap
26129 msgid ""
26130 " get-e2label device\n"
26131 "\n"
26132 msgstr ""
26133
26134 # type: =head2
26135 #. type: =head2
26136 #: ../fish/guestfish-actions.pod:1320
26137 msgid "get-e2uuid"
26138 msgstr ""
26139
26140 # type: verbatim
26141 #. type: verbatim
26142 #: ../fish/guestfish-actions.pod:1322
26143 #, no-wrap
26144 msgid ""
26145 " get-e2uuid device\n"
26146 "\n"
26147 msgstr ""
26148
26149 # type: =head2
26150 #. type: =head2
26151 #: ../fish/guestfish-actions.pod:1334
26152 msgid "get-memsize"
26153 msgstr ""
26154
26155 # type: verbatim
26156 #. type: verbatim
26157 #: ../fish/guestfish-actions.pod:1336
26158 #, no-wrap
26159 msgid ""
26160 " get-memsize\n"
26161 "\n"
26162 msgstr ""
26163
26164 # type: textblock
26165 #. type: textblock
26166 #: ../fish/guestfish-actions.pod:1341
26167 msgid ""
26168 "If L</set-memsize> was not called on this handle, and if "
26169 "C<LIBGUESTFS_MEMSIZE> was not set, then this returns the compiled-in default "
26170 "value for memsize."
26171 msgstr ""
26172
26173 # type: =head2
26174 #. type: =head2
26175 #: ../fish/guestfish-actions.pod:1348
26176 msgid "get-network"
26177 msgstr ""
26178
26179 # type: verbatim
26180 #. type: verbatim
26181 #: ../fish/guestfish-actions.pod:1350
26182 #, no-wrap
26183 msgid ""
26184 " get-network\n"
26185 "\n"
26186 msgstr ""
26187
26188 # type: =head2
26189 #. type: =head2
26190 #: ../fish/guestfish-actions.pod:1354
26191 msgid "get-path"
26192 msgstr ""
26193
26194 # type: verbatim
26195 #. type: verbatim
26196 #: ../fish/guestfish-actions.pod:1356
26197 #, no-wrap
26198 msgid ""
26199 " get-path\n"
26200 "\n"
26201 msgstr ""
26202
26203 # type: =head2
26204 #. type: =head2
26205 #: ../fish/guestfish-actions.pod:1363
26206 msgid "get-pid"
26207 msgstr ""
26208
26209 # type: =head2
26210 #. type: =head2
26211 #: ../fish/guestfish-actions.pod:1365
26212 msgid "pid"
26213 msgstr ""
26214
26215 # type: verbatim
26216 #. type: verbatim
26217 #: ../fish/guestfish-actions.pod:1367
26218 #, no-wrap
26219 msgid ""
26220 " get-pid\n"
26221 "\n"
26222 msgstr ""
26223
26224 # type: =head2
26225 #. type: =head2
26226 #: ../fish/guestfish-actions.pod:1374
26227 msgid "get-qemu"
26228 msgstr ""
26229
26230 # type: verbatim
26231 #. type: verbatim
26232 #: ../fish/guestfish-actions.pod:1376
26233 #, no-wrap
26234 msgid ""
26235 " get-qemu\n"
26236 "\n"
26237 msgstr ""
26238
26239 # type: =head2
26240 #. type: =head2
26241 #: ../fish/guestfish-actions.pod:1383
26242 msgid "get-recovery-proc"
26243 msgstr ""
26244
26245 # type: verbatim
26246 #. type: verbatim
26247 #: ../fish/guestfish-actions.pod:1385
26248 #, no-wrap
26249 msgid ""
26250 " get-recovery-proc\n"
26251 "\n"
26252 msgstr ""
26253
26254 # type: =head2
26255 #. type: =head2
26256 #: ../fish/guestfish-actions.pod:1389
26257 msgid "get-selinux"
26258 msgstr ""
26259
26260 # type: verbatim
26261 #. type: verbatim
26262 #: ../fish/guestfish-actions.pod:1391
26263 #, no-wrap
26264 msgid ""
26265 " get-selinux\n"
26266 "\n"
26267 msgstr ""
26268
26269 # type: textblock
26270 #. type: textblock
26271 #: ../fish/guestfish-actions.pod:1393
26272 msgid ""
26273 "This returns the current setting of the selinux flag which is passed to the "
26274 "appliance at boot time.  See L</set-selinux>."
26275 msgstr ""
26276
26277 # type: =head2
26278 #. type: =head2
26279 #: ../fish/guestfish-actions.pod:1399
26280 msgid "get-state"
26281 msgstr ""
26282
26283 # type: verbatim
26284 #. type: verbatim
26285 #: ../fish/guestfish-actions.pod:1401
26286 #, no-wrap
26287 msgid ""
26288 " get-state\n"
26289 "\n"
26290 msgstr ""
26291
26292 # type: =head2
26293 #. type: =head2
26294 #: ../fish/guestfish-actions.pod:1408
26295 msgid "get-trace"
26296 msgstr ""
26297
26298 # type: verbatim
26299 #. type: verbatim
26300 #: ../fish/guestfish-actions.pod:1410
26301 #, no-wrap
26302 msgid ""
26303 " get-trace\n"
26304 "\n"
26305 msgstr ""
26306
26307 # type: =head2
26308 #. type: =head2
26309 #: ../fish/guestfish-actions.pod:1414
26310 msgid "get-umask"
26311 msgstr ""
26312
26313 # type: verbatim
26314 #. type: verbatim
26315 #: ../fish/guestfish-actions.pod:1416
26316 #, no-wrap
26317 msgid ""
26318 " get-umask\n"
26319 "\n"
26320 msgstr ""
26321
26322 # type: textblock
26323 #. type: textblock
26324 #: ../fish/guestfish-actions.pod:1418
26325 msgid ""
26326 "Return the current umask.  By default the umask is C<022> unless it has been "
26327 "set by calling L</umask>."
26328 msgstr ""
26329
26330 # type: =head2
26331 #. type: =head2
26332 #: ../fish/guestfish-actions.pod:1421
26333 msgid "get-verbose"
26334 msgstr ""
26335
26336 # type: verbatim
26337 #. type: verbatim
26338 #: ../fish/guestfish-actions.pod:1423
26339 #, no-wrap
26340 msgid ""
26341 " get-verbose\n"
26342 "\n"
26343 msgstr ""
26344
26345 # type: =head2
26346 #. type: =head2
26347 #: ../fish/guestfish-actions.pod:1427
26348 msgid "getcon"
26349 msgstr ""
26350
26351 # type: verbatim
26352 #. type: verbatim
26353 #: ../fish/guestfish-actions.pod:1429
26354 #, no-wrap
26355 msgid ""
26356 " getcon\n"
26357 "\n"
26358 msgstr ""
26359
26360 # type: textblock
26361 #. type: textblock
26362 #: ../fish/guestfish-actions.pod:1433
26363 msgid "See the documentation about SELINUX in L<guestfs(3)>, and L</setcon>"
26364 msgstr ""
26365
26366 # type: =head2
26367 #. type: =head2
26368 #: ../fish/guestfish-actions.pod:1436
26369 msgid "getxattr"
26370 msgstr ""
26371
26372 # type: verbatim
26373 #. type: verbatim
26374 #: ../fish/guestfish-actions.pod:1438
26375 #, no-wrap
26376 msgid ""
26377 " getxattr path name\n"
26378 "\n"
26379 msgstr ""
26380
26381 # type: textblock
26382 #. type: textblock
26383 #: ../fish/guestfish-actions.pod:1440
26384 msgid ""
26385 "Get a single extended attribute from file C<path> named C<name>.  This call "
26386 "follows symlinks.  If you want to lookup an extended attribute for the "
26387 "symlink itself, use L</lgetxattr>."
26388 msgstr ""
26389
26390 # type: textblock
26391 #. type: textblock
26392 #: ../fish/guestfish-actions.pod:1444 ../fish/guestfish-actions.pod:2450
26393 msgid ""
26394 "Normally it is better to get all extended attributes from a file in one go "
26395 "by calling L</getxattrs>.  However some Linux filesystem implementations are "
26396 "buggy and do not provide a way to list out attributes.  For these "
26397 "filesystems (notably ntfs-3g)  you have to know the names of the extended "
26398 "attributes you want in advance and call this function."
26399 msgstr ""
26400
26401 # type: textblock
26402 #. type: textblock
26403 #: ../fish/guestfish-actions.pod:1454
26404 msgid "See also: L</getxattrs>, L</lgetxattr>, L<attr(5)>."
26405 msgstr ""
26406
26407 # type: =head2
26408 #. type: =head2
26409 #: ../fish/guestfish-actions.pod:1456
26410 msgid "getxattrs"
26411 msgstr ""
26412
26413 # type: verbatim
26414 #. type: verbatim
26415 #: ../fish/guestfish-actions.pod:1458
26416 #, no-wrap
26417 msgid ""
26418 " getxattrs path\n"
26419 "\n"
26420 msgstr ""
26421
26422 # type: textblock
26423 #. type: textblock
26424 #: ../fish/guestfish-actions.pod:1466
26425 msgid "See also: L</lgetxattrs>, L<attr(5)>."
26426 msgstr ""
26427
26428 # type: =head2
26429 #. type: =head2
26430 #: ../fish/guestfish-actions.pod:1468
26431 msgid "glob-expand"
26432 msgstr ""
26433
26434 # type: verbatim
26435 #. type: verbatim
26436 #: ../fish/guestfish-actions.pod:1470
26437 #, no-wrap
26438 msgid ""
26439 " glob-expand pattern\n"
26440 "\n"
26441 msgstr ""
26442
26443 # type: =head2
26444 #. type: =head2
26445 #: ../fish/guestfish-actions.pod:1483
26446 msgid "grep"
26447 msgstr ""
26448
26449 # type: verbatim
26450 #. type: verbatim
26451 #: ../fish/guestfish-actions.pod:1485
26452 #, no-wrap
26453 msgid ""
26454 " grep regex path\n"
26455 "\n"
26456 msgstr ""
26457
26458 # type: =head2
26459 #. type: =head2
26460 #: ../fish/guestfish-actions.pod:1493
26461 msgid "grepi"
26462 msgstr ""
26463
26464 # type: verbatim
26465 #. type: verbatim
26466 #: ../fish/guestfish-actions.pod:1495
26467 #, no-wrap
26468 msgid ""
26469 " grepi regex path\n"
26470 "\n"
26471 msgstr ""
26472
26473 # type: =head2
26474 #. type: =head2
26475 #: ../fish/guestfish-actions.pod:1503
26476 msgid "grub-install"
26477 msgstr ""
26478
26479 # type: verbatim
26480 #. type: verbatim
26481 #: ../fish/guestfish-actions.pod:1505
26482 #, no-wrap
26483 msgid ""
26484 " grub-install root device\n"
26485 "\n"
26486 msgstr ""
26487
26488 # type: =head2
26489 #. type: =head2
26490 #: ../fish/guestfish-actions.pod:1521
26491 msgid "head"
26492 msgstr ""
26493
26494 # type: verbatim
26495 #. type: verbatim
26496 #: ../fish/guestfish-actions.pod:1523
26497 #, no-wrap
26498 msgid ""
26499 " head path\n"
26500 "\n"
26501 msgstr ""
26502
26503 # type: =head2
26504 #. type: =head2
26505 #: ../fish/guestfish-actions.pod:1531
26506 msgid "head-n"
26507 msgstr ""
26508
26509 # type: verbatim
26510 #. type: verbatim
26511 #: ../fish/guestfish-actions.pod:1533
26512 #, no-wrap
26513 msgid ""
26514 " head-n nrlines path\n"
26515 "\n"
26516 msgstr ""
26517
26518 # type: =head2
26519 #. type: =head2
26520 #: ../fish/guestfish-actions.pod:1546
26521 msgid "hexdump"
26522 msgstr ""
26523
26524 # type: verbatim
26525 #. type: verbatim
26526 #: ../fish/guestfish-actions.pod:1548
26527 #, no-wrap
26528 msgid ""
26529 " hexdump path\n"
26530 "\n"
26531 msgstr ""
26532
26533 # type: =head2
26534 #. type: =head2
26535 #: ../fish/guestfish-actions.pod:1556
26536 msgid "initrd-cat"
26537 msgstr ""
26538
26539 # type: verbatim
26540 #. type: verbatim
26541 #: ../fish/guestfish-actions.pod:1558
26542 #, no-wrap
26543 msgid ""
26544 " initrd-cat initrdpath filename\n"
26545 "\n"
26546 msgstr ""
26547
26548 # type: textblock
26549 #. type: textblock
26550 #: ../fish/guestfish-actions.pod:1570
26551 msgid "See also L</initrd-list>."
26552 msgstr ""
26553
26554 # type: =head2
26555 #. type: =head2
26556 #: ../fish/guestfish-actions.pod:1575
26557 msgid "initrd-list"
26558 msgstr ""
26559
26560 # type: verbatim
26561 #. type: verbatim
26562 #: ../fish/guestfish-actions.pod:1577
26563 #, no-wrap
26564 msgid ""
26565 " initrd-list path\n"
26566 "\n"
26567 msgstr ""
26568
26569 # type: =head2
26570 #. type: =head2
26571 #: ../fish/guestfish-actions.pod:1589
26572 msgid "inotify-add-watch"
26573 msgstr ""
26574
26575 # type: verbatim
26576 #. type: verbatim
26577 #: ../fish/guestfish-actions.pod:1591
26578 #, no-wrap
26579 msgid ""
26580 " inotify-add-watch path mask\n"
26581 "\n"
26582 msgstr ""
26583
26584 # type: =head2
26585 #. type: =head2
26586 #: ../fish/guestfish-actions.pod:1603
26587 msgid "inotify-close"
26588 msgstr ""
26589
26590 # type: verbatim
26591 #. type: verbatim
26592 #: ../fish/guestfish-actions.pod:1605
26593 #, no-wrap
26594 msgid ""
26595 " inotify-close\n"
26596 "\n"
26597 msgstr ""
26598
26599 # type: =head2
26600 #. type: =head2
26601 #: ../fish/guestfish-actions.pod:1611
26602 msgid "inotify-files"
26603 msgstr ""
26604
26605 # type: verbatim
26606 #. type: verbatim
26607 #: ../fish/guestfish-actions.pod:1613
26608 #, no-wrap
26609 msgid ""
26610 " inotify-files\n"
26611 "\n"
26612 msgstr ""
26613
26614 # type: textblock
26615 #. type: textblock
26616 #: ../fish/guestfish-actions.pod:1615
26617 msgid ""
26618 "This function is a helpful wrapper around L</inotify-read> which just "
26619 "returns a list of pathnames of objects that were touched.  The returned "
26620 "pathnames are sorted and deduplicated."
26621 msgstr ""
26622
26623 # type: =head2
26624 #. type: =head2
26625 #: ../fish/guestfish-actions.pod:1619
26626 msgid "inotify-init"
26627 msgstr ""
26628
26629 # type: verbatim
26630 #. type: verbatim
26631 #: ../fish/guestfish-actions.pod:1621
26632 #, no-wrap
26633 msgid ""
26634 " inotify-init maxevents\n"
26635 "\n"
26636 msgstr ""
26637
26638 # type: textblock
26639 #. type: textblock
26640 #: ../fish/guestfish-actions.pod:1627
26641 msgid ""
26642 "C<maxevents> is the maximum number of events which will be queued up between "
26643 "calls to L</inotify-read> or L</inotify-files>.  If this is passed as C<0>, "
26644 "then the kernel (or previously set)  default is used.  For Linux 2.6.29 the "
26645 "default was 16384 events.  Beyond this limit, the kernel throws away events, "
26646 "but records the fact that it threw them away by setting a flag "
26647 "C<IN_Q_OVERFLOW> in the returned structure list (see L</inotify-read>)."
26648 msgstr ""
26649
26650 # type: textblock
26651 #. type: textblock
26652 #: ../fish/guestfish-actions.pod:1637
26653 msgid ""
26654 "Before any events are generated, you have to add some watches to the "
26655 "internal watch list.  See: L</inotify-add-watch>, L</inotify-rm-watch> and "
26656 "L</inotify-watch-all>."
26657 msgstr ""
26658
26659 # type: textblock
26660 #. type: textblock
26661 #: ../fish/guestfish-actions.pod:1643
26662 msgid ""
26663 "Queued up events should be read periodically by calling L</inotify-read> (or "
26664 "L</inotify-files> which is just a helpful wrapper around L</inotify-read>).  "
26665 "If you don't read the events out often enough then you risk the internal "
26666 "queue overflowing."
26667 msgstr ""
26668
26669 # type: textblock
26670 #. type: textblock
26671 #: ../fish/guestfish-actions.pod:1650
26672 msgid ""
26673 "The handle should be closed after use by calling L</inotify-close>.  This "
26674 "also removes any watches automatically."
26675 msgstr ""
26676
26677 # type: =head2
26678 #. type: =head2
26679 #: ../fish/guestfish-actions.pod:1659
26680 msgid "inotify-read"
26681 msgstr ""
26682
26683 # type: verbatim
26684 #. type: verbatim
26685 #: ../fish/guestfish-actions.pod:1661
26686 #, no-wrap
26687 msgid ""
26688 " inotify-read\n"
26689 "\n"
26690 msgstr ""
26691
26692 # type: =head2
26693 #. type: =head2
26694 #: ../fish/guestfish-actions.pod:1674
26695 msgid "inotify-rm-watch"
26696 msgstr ""
26697
26698 # type: verbatim
26699 #. type: verbatim
26700 #: ../fish/guestfish-actions.pod:1676
26701 #, no-wrap
26702 msgid ""
26703 " inotify-rm-watch wd\n"
26704 "\n"
26705 msgstr ""
26706
26707 # type: textblock
26708 #. type: textblock
26709 #: ../fish/guestfish-actions.pod:1678
26710 msgid "Remove a previously defined inotify watch.  See L</inotify-add-watch>."
26711 msgstr ""
26712
26713 # type: =head2
26714 #. type: =head2
26715 #: ../fish/guestfish-actions.pod:1681
26716 msgid "inspect-get-arch"
26717 msgstr ""
26718
26719 # type: verbatim
26720 #. type: verbatim
26721 #: ../fish/guestfish-actions.pod:1683
26722 #, no-wrap
26723 msgid ""
26724 " inspect-get-arch root\n"
26725 "\n"
26726 msgstr ""
26727
26728 # type: textblock
26729 #. type: textblock
26730 #: ../fish/guestfish-actions.pod:1685 ../fish/guestfish-actions.pod:1701
26731 #: ../fish/guestfish-actions.pod:1787 ../fish/guestfish-actions.pod:1823
26732 #: ../fish/guestfish-actions.pod:1841 ../fish/guestfish-actions.pod:1875
26733 #: ../fish/guestfish-actions.pod:1890 ../fish/guestfish-actions.pod:1911
26734 #: ../fish/guestfish-actions.pod:1926 ../fish/guestfish-actions.pod:1959
26735 #: ../fish/guestfish-actions.pod:1981 ../fish/guestfish-actions.pod:2005
26736 #: ../fish/guestfish-actions.pod:2022 ../fish/guestfish-actions.pod:2065
26737 #: ../fish/guestfish-actions.pod:2100 ../fish/guestfish-actions.pod:2116
26738 #: ../fish/guestfish-actions.pod:2132 ../fish/guestfish-actions.pod:2145
26739 #: ../fish/guestfish-actions.pod:2158 ../fish/guestfish-actions.pod:2173
26740 msgid ""
26741 "This function should only be called with a root device string as returned by "
26742 "L</inspect-os>."
26743 msgstr ""
26744
26745 # type: textblock
26746 #. type: textblock
26747 #: ../fish/guestfish-actions.pod:1688
26748 msgid ""
26749 "This returns the architecture of the inspected operating system.  The "
26750 "possible return values are listed under L</file-architecture>."
26751 msgstr ""
26752
26753 # type: =head2
26754 #. type: =head2
26755 #: ../fish/guestfish-actions.pod:1697
26756 msgid "inspect-get-distro"
26757 msgstr ""
26758
26759 # type: verbatim
26760 #. type: verbatim
26761 #: ../fish/guestfish-actions.pod:1699
26762 #, no-wrap
26763 msgid ""
26764 " inspect-get-distro root\n"
26765 "\n"
26766 msgstr ""
26767
26768 #. type: =head2
26769 #: ../fish/guestfish-actions.pod:1783
26770 msgid "inspect-get-drive-mappings"
26771 msgstr ""
26772
26773 #. type: verbatim
26774 #: ../fish/guestfish-actions.pod:1785
26775 #, no-wrap
26776 msgid ""
26777 " inspect-get-drive-mappings root\n"
26778 "\n"
26779 msgstr ""
26780
26781 #. type: textblock
26782 #: ../fish/guestfish-actions.pod:1815
26783 msgid ""
26784 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
26785 "get-mountpoints>, L</inspect-get-filesystems>."
26786 msgstr ""
26787
26788 # type: =head2
26789 #. type: =head2
26790 #: ../fish/guestfish-actions.pod:1819
26791 msgid "inspect-get-filesystems"
26792 msgstr ""
26793
26794 # type: verbatim
26795 #. type: verbatim
26796 #: ../fish/guestfish-actions.pod:1821
26797 #, no-wrap
26798 msgid ""
26799 " inspect-get-filesystems root\n"
26800 "\n"
26801 msgstr ""
26802
26803 # type: textblock
26804 #. type: textblock
26805 #: ../fish/guestfish-actions.pod:1834
26806 msgid ""
26807 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
26808 "get-mountpoints>."
26809 msgstr ""
26810
26811 #. type: =head2
26812 #: ../fish/guestfish-actions.pod:1837
26813 msgid "inspect-get-format"
26814 msgstr ""
26815
26816 #. type: verbatim
26817 #: ../fish/guestfish-actions.pod:1839
26818 #, no-wrap
26819 msgid ""
26820 " inspect-get-format root\n"
26821 "\n"
26822 msgstr ""
26823
26824 # type: =head2
26825 #. type: =head2
26826 #: ../fish/guestfish-actions.pod:1871
26827 msgid "inspect-get-hostname"
26828 msgstr ""
26829
26830 # type: verbatim
26831 #. type: verbatim
26832 #: ../fish/guestfish-actions.pod:1873
26833 #, no-wrap
26834 msgid ""
26835 " inspect-get-hostname root\n"
26836 "\n"
26837 msgstr ""
26838
26839 # type: =head2
26840 #. type: =head2
26841 #: ../fish/guestfish-actions.pod:1886
26842 msgid "inspect-get-major-version"
26843 msgstr ""
26844
26845 # type: verbatim
26846 #. type: verbatim
26847 #: ../fish/guestfish-actions.pod:1888
26848 #, no-wrap
26849 msgid ""
26850 " inspect-get-major-version root\n"
26851 "\n"
26852 msgstr ""
26853
26854 # type: =head2
26855 #. type: =head2
26856 #: ../fish/guestfish-actions.pod:1907
26857 msgid "inspect-get-minor-version"
26858 msgstr ""
26859
26860 # type: verbatim
26861 #. type: verbatim
26862 #: ../fish/guestfish-actions.pod:1909
26863 #, no-wrap
26864 msgid ""
26865 " inspect-get-minor-version root\n"
26866 "\n"
26867 msgstr ""
26868
26869 # type: textblock
26870 #. type: textblock
26871 #: ../fish/guestfish-actions.pod:1919
26872 msgid ""
26873 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
26874 "get-major-version>."
26875 msgstr ""
26876
26877 # type: =head2
26878 #. type: =head2
26879 #: ../fish/guestfish-actions.pod:1922
26880 msgid "inspect-get-mountpoints"
26881 msgstr ""
26882
26883 # type: verbatim
26884 #. type: verbatim
26885 #: ../fish/guestfish-actions.pod:1924
26886 #, no-wrap
26887 msgid ""
26888 " inspect-get-mountpoints root\n"
26889 "\n"
26890 msgstr ""
26891
26892 #. type: textblock
26893 #: ../fish/guestfish-actions.pod:1946
26894 msgid ""
26895 "For operating systems like Windows which still use drive letters, this call "
26896 "will only return an entry for the first drive \"mounted on\" C</>.  For "
26897 "information about the mapping of drive letters to partitions, see L</inspect-"
26898 "get-drive-mappings>."
26899 msgstr ""
26900
26901 # type: textblock
26902 #. type: textblock
26903 #: ../fish/guestfish-actions.pod:1952
26904 msgid ""
26905 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
26906 "get-filesystems>."
26907 msgstr ""
26908
26909 # type: =head2
26910 #. type: =head2
26911 #: ../fish/guestfish-actions.pod:1955
26912 msgid "inspect-get-package-format"
26913 msgstr ""
26914
26915 # type: verbatim
26916 #. type: verbatim
26917 #: ../fish/guestfish-actions.pod:1957
26918 #, no-wrap
26919 msgid ""
26920 " inspect-get-package-format root\n"
26921 "\n"
26922 msgstr ""
26923
26924 # type: textblock
26925 #. type: textblock
26926 #: ../fish/guestfish-actions.pod:1962
26927 msgid ""
26928 "This function and L</inspect-get-package-management> return the package "
26929 "format and package management tool used by the inspected operating system.  "
26930 "For example for Fedora these functions would return C<rpm> (package format) "
26931 "and C<yum> (package management)."
26932 msgstr ""
26933
26934 # type: =head2
26935 #. type: =head2
26936 #: ../fish/guestfish-actions.pod:1977
26937 msgid "inspect-get-package-management"
26938 msgstr ""
26939
26940 # type: verbatim
26941 #. type: verbatim
26942 #: ../fish/guestfish-actions.pod:1979
26943 #, no-wrap
26944 msgid ""
26945 " inspect-get-package-management root\n"
26946 "\n"
26947 msgstr ""
26948
26949 # type: textblock
26950 #. type: textblock
26951 #: ../fish/guestfish-actions.pod:1984
26952 msgid ""
26953 "L</inspect-get-package-format> and this function return the package format "
26954 "and package management tool used by the inspected operating system.  For "
26955 "example for Fedora these functions would return C<rpm> (package format) and "
26956 "C<yum> (package management)."
26957 msgstr ""
26958
26959 # type: =head2
26960 #. type: =head2
26961 #: ../fish/guestfish-actions.pod:2001
26962 msgid "inspect-get-product-name"
26963 msgstr ""
26964
26965 # type: verbatim
26966 #. type: verbatim
26967 #: ../fish/guestfish-actions.pod:2003
26968 #, no-wrap
26969 msgid ""
26970 " inspect-get-product-name root\n"
26971 "\n"
26972 msgstr ""
26973
26974 #. type: =head2
26975 #: ../fish/guestfish-actions.pod:2018
26976 msgid "inspect-get-product-variant"
26977 msgstr ""
26978
26979 #. type: verbatim
26980 #: ../fish/guestfish-actions.pod:2020
26981 #, no-wrap
26982 msgid ""
26983 " inspect-get-product-variant root\n"
26984 "\n"
26985 msgstr ""
26986
26987 #. type: textblock
26988 #: ../fish/guestfish-actions.pod:2044
26989 msgid ""
26990 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
26991 "get-product-name>, L</inspect-get-major-version>."
26992 msgstr ""
26993
26994 # type: =head2
26995 #. type: =head2
26996 #: ../fish/guestfish-actions.pod:2048
26997 msgid "inspect-get-roots"
26998 msgstr ""
26999
27000 # type: verbatim
27001 #. type: verbatim
27002 #: ../fish/guestfish-actions.pod:2050
27003 #, no-wrap
27004 msgid ""
27005 " inspect-get-roots\n"
27006 "\n"
27007 msgstr ""
27008
27009 # type: textblock
27010 #. type: textblock
27011 #: ../fish/guestfish-actions.pod:2052
27012 msgid ""
27013 "This function is a convenient way to get the list of root devices, as "
27014 "returned from a previous call to L</inspect-os>, but without redoing the "
27015 "whole inspection process."
27016 msgstr ""
27017
27018 # type: textblock
27019 #. type: textblock
27020 #: ../fish/guestfish-actions.pod:2056
27021 msgid ""
27022 "This returns an empty list if either no root devices were found or the "
27023 "caller has not called L</inspect-os>."
27024 msgstr ""
27025
27026 # type: =head2
27027 #. type: =head2
27028 #: ../fish/guestfish-actions.pod:2061
27029 msgid "inspect-get-type"
27030 msgstr ""
27031
27032 # type: verbatim
27033 #. type: verbatim
27034 #: ../fish/guestfish-actions.pod:2063
27035 #, no-wrap
27036 msgid ""
27037 " inspect-get-type root\n"
27038 "\n"
27039 msgstr ""
27040
27041 #. type: =head2
27042 #: ../fish/guestfish-actions.pod:2096
27043 msgid "inspect-get-windows-current-control-set"
27044 msgstr ""
27045
27046 #. type: verbatim
27047 #: ../fish/guestfish-actions.pod:2098
27048 #, no-wrap
27049 msgid ""
27050 " inspect-get-windows-current-control-set root\n"
27051 "\n"
27052 msgstr ""
27053
27054 # type: =head2
27055 #. type: =head2
27056 #: ../fish/guestfish-actions.pod:2112
27057 msgid "inspect-get-windows-systemroot"
27058 msgstr ""
27059
27060 # type: verbatim
27061 #. type: verbatim
27062 #: ../fish/guestfish-actions.pod:2114
27063 #, no-wrap
27064 msgid ""
27065 " inspect-get-windows-systemroot root\n"
27066 "\n"
27067 msgstr ""
27068
27069 #. type: =head2
27070 #: ../fish/guestfish-actions.pod:2128
27071 msgid "inspect-is-live"
27072 msgstr ""
27073
27074 #. type: verbatim
27075 #: ../fish/guestfish-actions.pod:2130
27076 #, no-wrap
27077 msgid ""
27078 " inspect-is-live root\n"
27079 "\n"
27080 msgstr ""
27081
27082 #. type: textblock
27083 #: ../fish/guestfish-actions.pod:2135
27084 msgid ""
27085 "If L</inspect-get-format> returns C<installer> (this is an install disk), "
27086 "then this returns true if a live image was detected on the disk."
27087 msgstr ""
27088
27089 #. type: =head2
27090 #: ../fish/guestfish-actions.pod:2141
27091 msgid "inspect-is-multipart"
27092 msgstr ""
27093
27094 #. type: verbatim
27095 #: ../fish/guestfish-actions.pod:2143
27096 #, no-wrap
27097 msgid ""
27098 " inspect-is-multipart root\n"
27099 "\n"
27100 msgstr ""
27101
27102 #. type: textblock
27103 #: ../fish/guestfish-actions.pod:2148
27104 msgid ""
27105 "If L</inspect-get-format> returns C<installer> (this is an install disk), "
27106 "then this returns true if the disk is part of a set."
27107 msgstr ""
27108
27109 #. type: =head2
27110 #: ../fish/guestfish-actions.pod:2154
27111 msgid "inspect-is-netinst"
27112 msgstr ""
27113
27114 #. type: verbatim
27115 #: ../fish/guestfish-actions.pod:2156
27116 #, no-wrap
27117 msgid ""
27118 " inspect-is-netinst root\n"
27119 "\n"
27120 msgstr ""
27121
27122 #. type: textblock
27123 #: ../fish/guestfish-actions.pod:2161
27124 msgid ""
27125 "If L</inspect-get-format> returns C<installer> (this is an install disk), "
27126 "then this returns true if the disk is a network installer, ie. not a self-"
27127 "contained install CD but one which is likely to require network access to "
27128 "complete the install."
27129 msgstr ""
27130
27131 # type: =head2
27132 #. type: =head2
27133 #: ../fish/guestfish-actions.pod:2169
27134 msgid "inspect-list-applications"
27135 msgstr ""
27136
27137 # type: verbatim
27138 #. type: verbatim
27139 #: ../fish/guestfish-actions.pod:2171
27140 #, no-wrap
27141 msgid ""
27142 " inspect-list-applications root\n"
27143 "\n"
27144 msgstr ""
27145
27146 # type: textblock
27147 #. type: textblock
27148 #: ../fish/guestfish-actions.pod:2178
27149 msgid ""
27150 "I<Note:> This call works differently from other parts of the inspection "
27151 "API.  You have to call L</inspect-os>, then L</inspect-get-mountpoints>, "
27152 "then mount up the disks, before calling this.  Listing applications is a "
27153 "significantly more difficult operation which requires access to the full "
27154 "filesystem.  Also note that unlike the other L</inspect-get-*> calls which "
27155 "are just returning data cached in the libguestfs handle, this call actually "
27156 "reads parts of the mounted filesystems during the call."
27157 msgstr ""
27158
27159 # type: =head2
27160 #. type: =head2
27161 #: ../fish/guestfish-actions.pod:2268
27162 msgid "inspect-os"
27163 msgstr ""
27164
27165 # type: verbatim
27166 #. type: verbatim
27167 #: ../fish/guestfish-actions.pod:2270
27168 #, no-wrap
27169 msgid ""
27170 " inspect-os\n"
27171 "\n"
27172 msgstr ""
27173
27174 # type: textblock
27175 #. type: textblock
27176 #: ../fish/guestfish-actions.pod:2285
27177 msgid ""
27178 "You can pass the root string(s) returned to other L</inspect-get-*> "
27179 "functions in order to query further information about each operating system, "
27180 "such as the name and version."
27181 msgstr ""
27182
27183 # type: textblock
27184 #. type: textblock
27185 #: ../fish/guestfish-actions.pod:2290
27186 msgid ""
27187 "This function uses other libguestfs features such as L</mount-ro> and L</"
27188 "umount-all> in order to mount and unmount filesystems and look at the "
27189 "contents.  This should be called with no disks currently mounted.  The "
27190 "function may also use Augeas, so any existing Augeas handle will be closed."
27191 msgstr ""
27192
27193 # type: textblock
27194 #. type: textblock
27195 #: ../fish/guestfish-actions.pod:2302 ../fish/guestfish-actions.pod:2478
27196 #: ../fish/guestfish-actions.pod:2524
27197 msgid "See also L</list-filesystems>."
27198 msgstr ""
27199
27200 # type: =head2
27201 #. type: =head2
27202 #: ../fish/guestfish-actions.pod:2304
27203 msgid "is-blockdev"
27204 msgstr ""
27205
27206 # type: verbatim
27207 #. type: verbatim
27208 #: ../fish/guestfish-actions.pod:2306
27209 #, no-wrap
27210 msgid ""
27211 " is-blockdev path\n"
27212 "\n"
27213 msgstr ""
27214
27215 # type: textblock
27216 #. type: textblock
27217 #: ../fish/guestfish-actions.pod:2311 ../fish/guestfish-actions.pod:2329
27218 #: ../fish/guestfish-actions.pod:2348 ../fish/guestfish-actions.pod:2357
27219 #: ../fish/guestfish-actions.pod:2367 ../fish/guestfish-actions.pod:2401
27220 #: ../fish/guestfish-actions.pod:2410
27221 msgid "See also L</stat>."
27222 msgstr ""
27223
27224 # type: =head2
27225 #. type: =head2
27226 #: ../fish/guestfish-actions.pod:2313
27227 msgid "is-busy"
27228 msgstr ""
27229
27230 # type: verbatim
27231 #. type: verbatim
27232 #: ../fish/guestfish-actions.pod:2315
27233 #, no-wrap
27234 msgid ""
27235 " is-busy\n"
27236 "\n"
27237 msgstr ""
27238
27239 # type: =head2
27240 #. type: =head2
27241 #: ../fish/guestfish-actions.pod:2322
27242 msgid "is-chardev"
27243 msgstr ""
27244
27245 # type: verbatim
27246 #. type: verbatim
27247 #: ../fish/guestfish-actions.pod:2324
27248 #, no-wrap
27249 msgid ""
27250 " is-chardev path\n"
27251 "\n"
27252 msgstr ""
27253
27254 # type: =head2
27255 #. type: =head2
27256 #: ../fish/guestfish-actions.pod:2331
27257 msgid "is-config"
27258 msgstr ""
27259
27260 # type: verbatim
27261 #. type: verbatim
27262 #: ../fish/guestfish-actions.pod:2333
27263 #, no-wrap
27264 msgid ""
27265 " is-config\n"
27266 "\n"
27267 msgstr ""
27268
27269 # type: =head2
27270 #. type: =head2
27271 #: ../fish/guestfish-actions.pod:2340
27272 msgid "is-dir"
27273 msgstr ""
27274
27275 # type: verbatim
27276 #. type: verbatim
27277 #: ../fish/guestfish-actions.pod:2342
27278 #, no-wrap
27279 msgid ""
27280 " is-dir path\n"
27281 "\n"
27282 msgstr ""
27283
27284 # type: =head2
27285 #. type: =head2
27286 #: ../fish/guestfish-actions.pod:2350
27287 msgid "is-fifo"
27288 msgstr ""
27289
27290 # type: verbatim
27291 #. type: verbatim
27292 #: ../fish/guestfish-actions.pod:2352
27293 #, no-wrap
27294 msgid ""
27295 " is-fifo path\n"
27296 "\n"
27297 msgstr ""
27298
27299 # type: =head2
27300 #. type: =head2
27301 #: ../fish/guestfish-actions.pod:2359
27302 msgid "is-file"
27303 msgstr ""
27304
27305 # type: verbatim
27306 #. type: verbatim
27307 #: ../fish/guestfish-actions.pod:2361
27308 #, no-wrap
27309 msgid ""
27310 " is-file path\n"
27311 "\n"
27312 msgstr ""
27313
27314 # type: =head2
27315 #. type: =head2
27316 #: ../fish/guestfish-actions.pod:2369
27317 msgid "is-launching"
27318 msgstr ""
27319
27320 # type: verbatim
27321 #. type: verbatim
27322 #: ../fish/guestfish-actions.pod:2371
27323 #, no-wrap
27324 msgid ""
27325 " is-launching\n"
27326 "\n"
27327 msgstr ""
27328
27329 # type: =head2
27330 #. type: =head2
27331 #: ../fish/guestfish-actions.pod:2378
27332 msgid "is-lv"
27333 msgstr ""
27334
27335 # type: verbatim
27336 #. type: verbatim
27337 #: ../fish/guestfish-actions.pod:2380
27338 #, no-wrap
27339 msgid ""
27340 " is-lv device\n"
27341 "\n"
27342 msgstr ""
27343
27344 # type: =head2
27345 #. type: =head2
27346 #: ../fish/guestfish-actions.pod:2385
27347 msgid "is-ready"
27348 msgstr ""
27349
27350 # type: verbatim
27351 #. type: verbatim
27352 #: ../fish/guestfish-actions.pod:2387
27353 #, no-wrap
27354 msgid ""
27355 " is-ready\n"
27356 "\n"
27357 msgstr ""
27358
27359 # type: =head2
27360 #. type: =head2
27361 #: ../fish/guestfish-actions.pod:2394
27362 msgid "is-socket"
27363 msgstr ""
27364
27365 # type: verbatim
27366 #. type: verbatim
27367 #: ../fish/guestfish-actions.pod:2396
27368 #, no-wrap
27369 msgid ""
27370 " is-socket path\n"
27371 "\n"
27372 msgstr ""
27373
27374 # type: =head2
27375 #. type: =head2
27376 #: ../fish/guestfish-actions.pod:2403
27377 msgid "is-symlink"
27378 msgstr ""
27379
27380 # type: verbatim
27381 #. type: verbatim
27382 #: ../fish/guestfish-actions.pod:2405
27383 #, no-wrap
27384 msgid ""
27385 " is-symlink path\n"
27386 "\n"
27387 msgstr ""
27388
27389 # type: =head2
27390 #. type: =head2
27391 #: ../fish/guestfish-actions.pod:2412
27392 msgid "kill-subprocess"
27393 msgstr ""
27394
27395 # type: verbatim
27396 #. type: verbatim
27397 #: ../fish/guestfish-actions.pod:2414
27398 #, no-wrap
27399 msgid ""
27400 " kill-subprocess\n"
27401 "\n"
27402 msgstr ""
27403
27404 # type: =head2
27405 #. type: =head2
27406 #: ../fish/guestfish-actions.pod:2418
27407 msgid "launch"
27408 msgstr ""
27409
27410 # type: =head2
27411 #. type: =head2
27412 #: ../fish/guestfish-actions.pod:2420
27413 msgid "run"
27414 msgstr ""
27415
27416 # type: verbatim
27417 #. type: verbatim
27418 #: ../fish/guestfish-actions.pod:2422
27419 #, no-wrap
27420 msgid ""
27421 " launch\n"
27422 "\n"
27423 msgstr ""
27424
27425 # type: =head2
27426 #. type: =head2
27427 #: ../fish/guestfish-actions.pod:2430
27428 msgid "lchown"
27429 msgstr ""
27430
27431 # type: verbatim
27432 #. type: verbatim
27433 #: ../fish/guestfish-actions.pod:2432
27434 #, no-wrap
27435 msgid ""
27436 " lchown owner group path\n"
27437 "\n"
27438 msgstr ""
27439
27440 # type: textblock
27441 #. type: textblock
27442 #: ../fish/guestfish-actions.pod:2434
27443 msgid ""
27444 "Change the file owner to C<owner> and group to C<group>.  This is like L</"
27445 "chown> but if C<path> is a symlink then the link itself is changed, not the "
27446 "target."
27447 msgstr ""
27448
27449 # type: =head2
27450 #. type: =head2
27451 #: ../fish/guestfish-actions.pod:2442
27452 msgid "lgetxattr"
27453 msgstr ""
27454
27455 # type: verbatim
27456 #. type: verbatim
27457 #: ../fish/guestfish-actions.pod:2444
27458 #, no-wrap
27459 msgid ""
27460 " lgetxattr path name\n"
27461 "\n"
27462 msgstr ""
27463
27464 # type: textblock
27465 #. type: textblock
27466 #: ../fish/guestfish-actions.pod:2460
27467 msgid "See also: L</lgetxattrs>, L</getxattr>, L<attr(5)>."
27468 msgstr ""
27469
27470 # type: =head2
27471 #. type: =head2
27472 #: ../fish/guestfish-actions.pod:2462
27473 msgid "lgetxattrs"
27474 msgstr ""
27475
27476 # type: verbatim
27477 #. type: verbatim
27478 #: ../fish/guestfish-actions.pod:2464
27479 #, no-wrap
27480 msgid ""
27481 " lgetxattrs path\n"
27482 "\n"
27483 msgstr ""
27484
27485 # type: textblock
27486 #. type: textblock
27487 #: ../fish/guestfish-actions.pod:2466
27488 msgid ""
27489 "This is the same as L</getxattrs>, but if C<path> is a symbolic link, then "
27490 "it returns the extended attributes of the link itself."
27491 msgstr ""
27492
27493 # type: =head2
27494 #. type: =head2
27495 #: ../fish/guestfish-actions.pod:2470
27496 msgid "list-devices"
27497 msgstr ""
27498
27499 # type: verbatim
27500 #. type: verbatim
27501 #: ../fish/guestfish-actions.pod:2472
27502 #, no-wrap
27503 msgid ""
27504 " list-devices\n"
27505 "\n"
27506 msgstr ""
27507
27508 # type: =head2
27509 #. type: =head2
27510 #: ../fish/guestfish-actions.pod:2480
27511 msgid "list-filesystems"
27512 msgstr ""
27513
27514 # type: verbatim
27515 #. type: verbatim
27516 #: ../fish/guestfish-actions.pod:2482
27517 #, no-wrap
27518 msgid ""
27519 " list-filesystems\n"
27520 "\n"
27521 msgstr ""
27522
27523 # type: textblock
27524 #. type: textblock
27525 #: ../fish/guestfish-actions.pod:2501
27526 msgid ""
27527 "This command runs other libguestfs commands, which might include L</mount> "
27528 "and L</umount>, and therefore you should use this soon after launch and only "
27529 "when nothing is mounted."
27530 msgstr ""
27531
27532 # type: textblock
27533 #. type: textblock
27534 #: ../fish/guestfish-actions.pod:2505
27535 msgid ""
27536 "Not all of the filesystems returned will be mountable.  In particular, swap "
27537 "partitions are returned in the list.  Also this command does not check that "
27538 "each filesystem found is valid and mountable, and some filesystems might be "
27539 "mountable but require special options.  Filesystems may not all belong to a "
27540 "single logical operating system (use L</inspect-os> to look for OSes)."
27541 msgstr ""
27542
27543 # type: =head2
27544 #. type: =head2
27545 #: ../fish/guestfish-actions.pod:2513
27546 msgid "list-partitions"
27547 msgstr ""
27548
27549 # type: verbatim
27550 #. type: verbatim
27551 #: ../fish/guestfish-actions.pod:2515
27552 #, no-wrap
27553 msgid ""
27554 " list-partitions\n"
27555 "\n"
27556 msgstr ""
27557
27558 # type: textblock
27559 #. type: textblock
27560 #: ../fish/guestfish-actions.pod:2521
27561 msgid ""
27562 "This does not return logical volumes.  For that you will need to call L</"
27563 "lvs>."
27564 msgstr ""
27565
27566 # type: =head2
27567 #. type: =head2
27568 #: ../fish/guestfish-actions.pod:2526
27569 msgid "ll"
27570 msgstr ""
27571
27572 # type: verbatim
27573 #. type: verbatim
27574 #: ../fish/guestfish-actions.pod:2528
27575 #, no-wrap
27576 msgid ""
27577 " ll directory\n"
27578 "\n"
27579 msgstr ""
27580
27581 # type: =head2
27582 #. type: =head2
27583 #: ../fish/guestfish-actions.pod:2536
27584 msgid "ln"
27585 msgstr ""
27586
27587 # type: verbatim
27588 #. type: verbatim
27589 #: ../fish/guestfish-actions.pod:2538
27590 #, no-wrap
27591 msgid ""
27592 " ln target linkname\n"
27593 "\n"
27594 msgstr ""
27595
27596 # type: =head2
27597 #. type: =head2
27598 #: ../fish/guestfish-actions.pod:2542
27599 msgid "ln-f"
27600 msgstr ""
27601
27602 # type: verbatim
27603 #. type: verbatim
27604 #: ../fish/guestfish-actions.pod:2544
27605 #, no-wrap
27606 msgid ""
27607 " ln-f target linkname\n"
27608 "\n"
27609 msgstr ""
27610
27611 # type: =head2
27612 #. type: =head2
27613 #: ../fish/guestfish-actions.pod:2549
27614 msgid "ln-s"
27615 msgstr ""
27616
27617 # type: verbatim
27618 #. type: verbatim
27619 #: ../fish/guestfish-actions.pod:2551
27620 #, no-wrap
27621 msgid ""
27622 " ln-s target linkname\n"
27623 "\n"
27624 msgstr ""
27625
27626 # type: =head2
27627 #. type: =head2
27628 #: ../fish/guestfish-actions.pod:2555
27629 msgid "ln-sf"
27630 msgstr ""
27631
27632 # type: verbatim
27633 #. type: verbatim
27634 #: ../fish/guestfish-actions.pod:2557
27635 #, no-wrap
27636 msgid ""
27637 " ln-sf target linkname\n"
27638 "\n"
27639 msgstr ""
27640
27641 # type: =head2
27642 #. type: =head2
27643 #: ../fish/guestfish-actions.pod:2562
27644 msgid "lremovexattr"
27645 msgstr ""
27646
27647 # type: verbatim
27648 #. type: verbatim
27649 #: ../fish/guestfish-actions.pod:2564
27650 #, no-wrap
27651 msgid ""
27652 " lremovexattr xattr path\n"
27653 "\n"
27654 msgstr ""
27655
27656 # type: textblock
27657 #. type: textblock
27658 #: ../fish/guestfish-actions.pod:2566
27659 msgid ""
27660 "This is the same as L</removexattr>, but if C<path> is a symbolic link, then "
27661 "it removes an extended attribute of the link itself."
27662 msgstr ""
27663
27664 # type: =head2
27665 #. type: =head2
27666 #: ../fish/guestfish-actions.pod:2570
27667 msgid "ls"
27668 msgstr ""
27669
27670 # type: verbatim
27671 #. type: verbatim
27672 #: ../fish/guestfish-actions.pod:2572
27673 #, no-wrap
27674 msgid ""
27675 " ls directory\n"
27676 "\n"
27677 msgstr ""
27678
27679 # type: textblock
27680 #. type: textblock
27681 #: ../fish/guestfish-actions.pod:2578
27682 msgid ""
27683 "This command is mostly useful for interactive sessions.  Programs should "
27684 "probably use L</readdir> instead."
27685 msgstr ""
27686
27687 # type: =head2
27688 #. type: =head2
27689 #: ../fish/guestfish-actions.pod:2581
27690 msgid "lsetxattr"
27691 msgstr ""
27692
27693 # type: verbatim
27694 #. type: verbatim
27695 #: ../fish/guestfish-actions.pod:2583
27696 #, no-wrap
27697 msgid ""
27698 " lsetxattr xattr val vallen path\n"
27699 "\n"
27700 msgstr ""
27701
27702 # type: textblock
27703 #. type: textblock
27704 #: ../fish/guestfish-actions.pod:2585
27705 msgid ""
27706 "This is the same as L</setxattr>, but if C<path> is a symbolic link, then it "
27707 "sets an extended attribute of the link itself."
27708 msgstr ""
27709
27710 # type: =head2
27711 #. type: =head2
27712 #: ../fish/guestfish-actions.pod:2589
27713 msgid "lstat"
27714 msgstr ""
27715
27716 # type: verbatim
27717 #. type: verbatim
27718 #: ../fish/guestfish-actions.pod:2591
27719 #, no-wrap
27720 msgid ""
27721 " lstat path\n"
27722 "\n"
27723 msgstr ""
27724
27725 # type: textblock
27726 #. type: textblock
27727 #: ../fish/guestfish-actions.pod:2595
27728 msgid ""
27729 "This is the same as L</stat> except that if C<path> is a symbolic link, then "
27730 "the link is stat-ed, not the file it refers to."
27731 msgstr ""
27732
27733 # type: =head2
27734 #. type: =head2
27735 #: ../fish/guestfish-actions.pod:2601
27736 msgid "lstatlist"
27737 msgstr ""
27738
27739 # type: verbatim
27740 #. type: verbatim
27741 #: ../fish/guestfish-actions.pod:2603
27742 #, no-wrap
27743 msgid ""
27744 " lstatlist path 'names ...'\n"
27745 "\n"
27746 msgstr ""
27747
27748 # type: textblock
27749 #. type: textblock
27750 #: ../fish/guestfish-actions.pod:2605
27751 msgid ""
27752 "This call allows you to perform the L</lstat> operation on multiple files, "
27753 "where all files are in the directory C<path>.  C<names> is the list of files "
27754 "from this directory."
27755 msgstr ""
27756
27757 # type: textblock
27758 #. type: textblock
27759 #: ../fish/guestfish-actions.pod:2614
27760 msgid ""
27761 "This call is intended for programs that want to efficiently list a directory "
27762 "contents without making many round-trips.  See also L</lxattrlist> for a "
27763 "similarly efficient call for getting extended attributes.  Very long "
27764 "directory listings might cause the protocol message size to be exceeded, "
27765 "causing this call to fail.  The caller must split up such requests into "
27766 "smaller groups of names."
27767 msgstr ""
27768
27769 # type: =head2
27770 #. type: =head2
27771 #: ../fish/guestfish-actions.pod:2622
27772 msgid "luks-add-key"
27773 msgstr ""
27774
27775 # type: verbatim
27776 #. type: verbatim
27777 #: ../fish/guestfish-actions.pod:2624
27778 #, no-wrap
27779 msgid ""
27780 " luks-add-key device keyslot\n"
27781 "\n"
27782 msgstr ""
27783
27784 # type: textblock
27785 #. type: textblock
27786 #: ../fish/guestfish-actions.pod:2631
27787 msgid ""
27788 "Note that if C<keyslot> already contains a key, then this command will "
27789 "fail.  You have to use L</luks-kill-slot> first to remove that key."
27790 msgstr ""
27791
27792 # type: textblock
27793 #. type: textblock
27794 #: ../fish/guestfish-actions.pod:2635 ../fish/guestfish-actions.pod:2657
27795 #: ../fish/guestfish-actions.pod:2670 ../fish/guestfish-actions.pod:2684
27796 #: ../fish/guestfish-actions.pod:2707 ../fish/guestfish-actions.pod:2717
27797 msgid ""
27798 "This command has one or more key or passphrase parameters.  Guestfish will "
27799 "prompt for these separately."
27800 msgstr ""
27801
27802 # type: =head2
27803 #. type: =head2
27804 #: ../fish/guestfish-actions.pod:2638
27805 msgid "luks-close"
27806 msgstr ""
27807
27808 # type: verbatim
27809 #. type: verbatim
27810 #: ../fish/guestfish-actions.pod:2640
27811 #, no-wrap
27812 msgid ""
27813 " luks-close device\n"
27814 "\n"
27815 msgstr ""
27816
27817 # type: textblock
27818 #. type: textblock
27819 #: ../fish/guestfish-actions.pod:2642
27820 msgid ""
27821 "This closes a LUKS device that was created earlier by L</luks-open> or L</"
27822 "luks-open-ro>.  The C<device> parameter must be the name of the LUKS mapping "
27823 "device (ie. C</dev/mapper/mapname>) and I<not> the name of the underlying "
27824 "block device."
27825 msgstr ""
27826
27827 # type: =head2
27828 #. type: =head2
27829 #: ../fish/guestfish-actions.pod:2648
27830 msgid "luks-format"
27831 msgstr ""
27832
27833 # type: verbatim
27834 #. type: verbatim
27835 #: ../fish/guestfish-actions.pod:2650
27836 #, no-wrap
27837 msgid ""
27838 " luks-format device keyslot\n"
27839 "\n"
27840 msgstr ""
27841
27842 # type: =head2
27843 #. type: =head2
27844 #: ../fish/guestfish-actions.pod:2663
27845 msgid "luks-format-cipher"
27846 msgstr ""
27847
27848 # type: verbatim
27849 #. type: verbatim
27850 #: ../fish/guestfish-actions.pod:2665
27851 #, no-wrap
27852 msgid ""
27853 " luks-format-cipher device keyslot cipher\n"
27854 "\n"
27855 msgstr ""
27856
27857 # type: textblock
27858 #. type: textblock
27859 #: ../fish/guestfish-actions.pod:2667
27860 msgid ""
27861 "This command is the same as L</luks-format> but it also allows you to set "
27862 "the C<cipher> used."
27863 msgstr ""
27864
27865 # type: =head2
27866 #. type: =head2
27867 #: ../fish/guestfish-actions.pod:2676
27868 msgid "luks-kill-slot"
27869 msgstr ""
27870
27871 # type: verbatim
27872 #. type: verbatim
27873 #: ../fish/guestfish-actions.pod:2678
27874 #, no-wrap
27875 msgid ""
27876 " luks-kill-slot device keyslot\n"
27877 "\n"
27878 msgstr ""
27879
27880 # type: =head2
27881 #. type: =head2
27882 #: ../fish/guestfish-actions.pod:2687
27883 msgid "luks-open"
27884 msgstr ""
27885
27886 # type: verbatim
27887 #. type: verbatim
27888 #: ../fish/guestfish-actions.pod:2689
27889 #, no-wrap
27890 msgid ""
27891 " luks-open device mapname\n"
27892 "\n"
27893 msgstr ""
27894
27895 # type: textblock
27896 #. type: textblock
27897 #: ../fish/guestfish-actions.pod:2703
27898 msgid ""
27899 "If this block device contains LVM volume groups, then calling L</vgscan> "
27900 "followed by L</vg-activate-all> will make them visible."
27901 msgstr ""
27902
27903 # type: =head2
27904 #. type: =head2
27905 #: ../fish/guestfish-actions.pod:2710
27906 msgid "luks-open-ro"
27907 msgstr ""
27908
27909 # type: verbatim
27910 #. type: verbatim
27911 #: ../fish/guestfish-actions.pod:2712
27912 #, no-wrap
27913 msgid ""
27914 " luks-open-ro device mapname\n"
27915 "\n"
27916 msgstr ""
27917
27918 # type: textblock
27919 #. type: textblock
27920 #: ../fish/guestfish-actions.pod:2714
27921 msgid ""
27922 "This is the same as L</luks-open> except that a read-only mapping is created."
27923 msgstr ""
27924
27925 # type: =head2
27926 #. type: =head2
27927 #: ../fish/guestfish-actions.pod:2720
27928 msgid "lvcreate"
27929 msgstr ""
27930
27931 # type: verbatim
27932 #. type: verbatim
27933 #: ../fish/guestfish-actions.pod:2722
27934 #, no-wrap
27935 msgid ""
27936 " lvcreate logvol volgroup mbytes\n"
27937 "\n"
27938 msgstr ""
27939
27940 # type: =head2
27941 #. type: =head2
27942 #: ../fish/guestfish-actions.pod:2727
27943 msgid "lvm-canonical-lv-name"
27944 msgstr ""
27945
27946 # type: verbatim
27947 #. type: verbatim
27948 #: ../fish/guestfish-actions.pod:2729
27949 #, no-wrap
27950 msgid ""
27951 " lvm-canonical-lv-name lvname\n"
27952 "\n"
27953 msgstr ""
27954
27955 # type: textblock
27956 #. type: textblock
27957 #: ../fish/guestfish-actions.pod:2738
27958 msgid "See also L</is-lv>."
27959 msgstr ""
27960
27961 # type: =head2
27962 #. type: =head2
27963 #: ../fish/guestfish-actions.pod:2740
27964 msgid "lvm-clear-filter"
27965 msgstr ""
27966
27967 # type: verbatim
27968 #. type: verbatim
27969 #: ../fish/guestfish-actions.pod:2742
27970 #, no-wrap
27971 msgid ""
27972 " lvm-clear-filter\n"
27973 "\n"
27974 msgstr ""
27975
27976 # type: textblock
27977 #. type: textblock
27978 #: ../fish/guestfish-actions.pod:2744
27979 msgid ""
27980 "This undoes the effect of L</lvm-set-filter>.  LVM will be able to see every "
27981 "block device."
27982 msgstr ""
27983
27984 # type: =head2
27985 #. type: =head2
27986 #: ../fish/guestfish-actions.pod:2750
27987 msgid "lvm-remove-all"
27988 msgstr ""
27989
27990 # type: verbatim
27991 #. type: verbatim
27992 #: ../fish/guestfish-actions.pod:2752
27993 #, no-wrap
27994 msgid ""
27995 " lvm-remove-all\n"
27996 "\n"
27997 msgstr ""
27998
27999 # type: =head2
28000 #. type: =head2
28001 #: ../fish/guestfish-actions.pod:2760
28002 msgid "lvm-set-filter"
28003 msgstr ""
28004
28005 # type: verbatim
28006 #. type: verbatim
28007 #: ../fish/guestfish-actions.pod:2762
28008 #, no-wrap
28009 msgid ""
28010 " lvm-set-filter 'devices ...'\n"
28011 "\n"
28012 msgstr ""
28013
28014 # type: =head2
28015 #. type: =head2
28016 #: ../fish/guestfish-actions.pod:2787
28017 msgid "lvremove"
28018 msgstr ""
28019
28020 # type: verbatim
28021 #. type: verbatim
28022 #: ../fish/guestfish-actions.pod:2789
28023 #, no-wrap
28024 msgid ""
28025 " lvremove device\n"
28026 "\n"
28027 msgstr ""
28028
28029 # type: =head2
28030 #. type: =head2
28031 #: ../fish/guestfish-actions.pod:2797
28032 msgid "lvrename"
28033 msgstr ""
28034
28035 # type: verbatim
28036 #. type: verbatim
28037 #: ../fish/guestfish-actions.pod:2799
28038 #, no-wrap
28039 msgid ""
28040 " lvrename logvol newlogvol\n"
28041 "\n"
28042 msgstr ""
28043
28044 # type: =head2
28045 #. type: =head2
28046 #: ../fish/guestfish-actions.pod:2803
28047 msgid "lvresize"
28048 msgstr ""
28049
28050 # type: verbatim
28051 #. type: verbatim
28052 #: ../fish/guestfish-actions.pod:2805
28053 #, no-wrap
28054 msgid ""
28055 " lvresize device mbytes\n"
28056 "\n"
28057 msgstr ""
28058
28059 # type: =head2
28060 #. type: =head2
28061 #: ../fish/guestfish-actions.pod:2811
28062 msgid "lvresize-free"
28063 msgstr ""
28064
28065 # type: verbatim
28066 #. type: verbatim
28067 #: ../fish/guestfish-actions.pod:2813
28068 #, no-wrap
28069 msgid ""
28070 " lvresize-free lv percent\n"
28071 "\n"
28072 msgstr ""
28073
28074 # type: =head2
28075 #. type: =head2
28076 #: ../fish/guestfish-actions.pod:2821
28077 msgid "lvs"
28078 msgstr ""
28079
28080 # type: verbatim
28081 #. type: verbatim
28082 #: ../fish/guestfish-actions.pod:2823
28083 #, no-wrap
28084 msgid ""
28085 " lvs\n"
28086 "\n"
28087 msgstr ""
28088
28089 # type: textblock
28090 #. type: textblock
28091 #: ../fish/guestfish-actions.pod:2831
28092 msgid "See also L</lvs-full>, L</list-filesystems>."
28093 msgstr ""
28094
28095 # type: =head2
28096 #. type: =head2
28097 #: ../fish/guestfish-actions.pod:2833
28098 msgid "lvs-full"
28099 msgstr ""
28100
28101 # type: verbatim
28102 #. type: verbatim
28103 #: ../fish/guestfish-actions.pod:2835
28104 #, no-wrap
28105 msgid ""
28106 " lvs-full\n"
28107 "\n"
28108 msgstr ""
28109
28110 # type: =head2
28111 #. type: =head2
28112 #: ../fish/guestfish-actions.pod:2840
28113 msgid "lvuuid"
28114 msgstr ""
28115
28116 # type: verbatim
28117 #. type: verbatim
28118 #: ../fish/guestfish-actions.pod:2842
28119 #, no-wrap
28120 msgid ""
28121 " lvuuid device\n"
28122 "\n"
28123 msgstr ""
28124
28125 # type: =head2
28126 #. type: =head2
28127 #: ../fish/guestfish-actions.pod:2846
28128 msgid "lxattrlist"
28129 msgstr ""
28130
28131 # type: verbatim
28132 #. type: verbatim
28133 #: ../fish/guestfish-actions.pod:2848
28134 #, no-wrap
28135 msgid ""
28136 " lxattrlist path 'names ...'\n"
28137 "\n"
28138 msgstr ""
28139
28140 # type: textblock
28141 #. type: textblock
28142 #: ../fish/guestfish-actions.pod:2864
28143 msgid ""
28144 "This call is intended for programs that want to efficiently list a directory "
28145 "contents without making many round-trips.  See also L</lstatlist> for a "
28146 "similarly efficient call for getting standard stats.  Very long directory "
28147 "listings might cause the protocol message size to be exceeded, causing this "
28148 "call to fail.  The caller must split up such requests into smaller groups of "
28149 "names."
28150 msgstr ""
28151
28152 # type: =head2
28153 #. type: =head2
28154 #: ../fish/guestfish-actions.pod:2872
28155 msgid "mkdir"
28156 msgstr ""
28157
28158 # type: verbatim
28159 #. type: verbatim
28160 #: ../fish/guestfish-actions.pod:2874
28161 #, no-wrap
28162 msgid ""
28163 " mkdir path\n"
28164 "\n"
28165 msgstr ""
28166
28167 # type: =head2
28168 #. type: =head2
28169 #: ../fish/guestfish-actions.pod:2878
28170 msgid "mkdir-mode"
28171 msgstr ""
28172
28173 # type: verbatim
28174 #. type: verbatim
28175 #: ../fish/guestfish-actions.pod:2880
28176 #, no-wrap
28177 msgid ""
28178 " mkdir-mode path mode\n"
28179 "\n"
28180 msgstr ""
28181
28182 # type: textblock
28183 #. type: textblock
28184 #: ../fish/guestfish-actions.pod:2889
28185 msgid "See also L</mkdir>, L</umask>"
28186 msgstr ""
28187
28188 # type: =head2
28189 #. type: =head2
28190 #: ../fish/guestfish-actions.pod:2891
28191 msgid "mkdir-p"
28192 msgstr ""
28193
28194 # type: verbatim
28195 #. type: verbatim
28196 #: ../fish/guestfish-actions.pod:2893
28197 #, no-wrap
28198 msgid ""
28199 " mkdir-p path\n"
28200 "\n"
28201 msgstr ""
28202
28203 # type: =head2
28204 #. type: =head2
28205 #: ../fish/guestfish-actions.pod:2898
28206 msgid "mkdtemp"
28207 msgstr ""
28208
28209 # type: verbatim
28210 #. type: verbatim
28211 #: ../fish/guestfish-actions.pod:2900
28212 #, no-wrap
28213 msgid ""
28214 " mkdtemp template\n"
28215 "\n"
28216 msgstr ""
28217
28218 # type: =head2
28219 #. type: =head2
28220 #: ../fish/guestfish-actions.pod:2921
28221 msgid "mke2fs-J"
28222 msgstr ""
28223
28224 # type: verbatim
28225 #. type: verbatim
28226 #: ../fish/guestfish-actions.pod:2923
28227 #, no-wrap
28228 msgid ""
28229 " mke2fs-J fstype blocksize device journal\n"
28230 "\n"
28231 msgstr ""
28232
28233 # type: textblock
28234 #. type: textblock
28235 #: ../fish/guestfish-actions.pod:2931
28236 msgid "See also L</mke2journal>."
28237 msgstr ""
28238
28239 # type: =head2
28240 #. type: =head2
28241 #: ../fish/guestfish-actions.pod:2933
28242 msgid "mke2fs-JL"
28243 msgstr ""
28244
28245 # type: verbatim
28246 #. type: verbatim
28247 #: ../fish/guestfish-actions.pod:2935
28248 #, no-wrap
28249 msgid ""
28250 " mke2fs-JL fstype blocksize device label\n"
28251 "\n"
28252 msgstr ""
28253
28254 # type: textblock
28255 #. type: textblock
28256 #: ../fish/guestfish-actions.pod:2940
28257 msgid "See also L</mke2journal-L>."
28258 msgstr ""
28259
28260 # type: =head2
28261 #. type: =head2
28262 #: ../fish/guestfish-actions.pod:2942
28263 msgid "mke2fs-JU"
28264 msgstr ""
28265
28266 # type: verbatim
28267 #. type: verbatim
28268 #: ../fish/guestfish-actions.pod:2944
28269 #, no-wrap
28270 msgid ""
28271 " mke2fs-JU fstype blocksize device uuid\n"
28272 "\n"
28273 msgstr ""
28274
28275 # type: textblock
28276 #. type: textblock
28277 #: ../fish/guestfish-actions.pod:2949
28278 msgid "See also L</mke2journal-U>."
28279 msgstr ""
28280
28281 # type: =head2
28282 #. type: =head2
28283 #: ../fish/guestfish-actions.pod:2951
28284 msgid "mke2journal"
28285 msgstr ""
28286
28287 # type: verbatim
28288 #. type: verbatim
28289 #: ../fish/guestfish-actions.pod:2953
28290 #, no-wrap
28291 msgid ""
28292 " mke2journal blocksize device\n"
28293 "\n"
28294 msgstr ""
28295
28296 # type: =head2
28297 #. type: =head2
28298 #: ../fish/guestfish-actions.pod:2960
28299 msgid "mke2journal-L"
28300 msgstr ""
28301
28302 # type: verbatim
28303 #. type: verbatim
28304 #: ../fish/guestfish-actions.pod:2962
28305 #, no-wrap
28306 msgid ""
28307 " mke2journal-L blocksize label device\n"
28308 "\n"
28309 msgstr ""
28310
28311 # type: =head2
28312 #. type: =head2
28313 #: ../fish/guestfish-actions.pod:2966
28314 msgid "mke2journal-U"
28315 msgstr ""
28316
28317 # type: verbatim
28318 #. type: verbatim
28319 #: ../fish/guestfish-actions.pod:2968
28320 #, no-wrap
28321 msgid ""
28322 " mke2journal-U blocksize uuid device\n"
28323 "\n"
28324 msgstr ""
28325
28326 # type: =head2
28327 #. type: =head2
28328 #: ../fish/guestfish-actions.pod:2972
28329 msgid "mkfifo"
28330 msgstr ""
28331
28332 # type: verbatim
28333 #. type: verbatim
28334 #: ../fish/guestfish-actions.pod:2974
28335 #, no-wrap
28336 msgid ""
28337 " mkfifo mode path\n"
28338 "\n"
28339 msgstr ""
28340
28341 # type: textblock
28342 #. type: textblock
28343 #: ../fish/guestfish-actions.pod:2976
28344 msgid ""
28345 "This call creates a FIFO (named pipe) called C<path> with mode C<mode>.  It "
28346 "is just a convenient wrapper around L</mknod>."
28347 msgstr ""
28348
28349 # type: =head2
28350 #. type: =head2
28351 #: ../fish/guestfish-actions.pod:2982
28352 msgid "mkfs"
28353 msgstr ""
28354
28355 # type: verbatim
28356 #. type: verbatim
28357 #: ../fish/guestfish-actions.pod:2984
28358 #, no-wrap
28359 msgid ""
28360 " mkfs fstype device\n"
28361 "\n"
28362 msgstr ""
28363
28364 # type: =head2
28365 #. type: =head2
28366 #: ../fish/guestfish-actions.pod:2990
28367 msgid "mkfs-b"
28368 msgstr ""
28369
28370 # type: verbatim
28371 #. type: verbatim
28372 #: ../fish/guestfish-actions.pod:2992
28373 #, no-wrap
28374 msgid ""
28375 " mkfs-b fstype blocksize device\n"
28376 "\n"
28377 msgstr ""
28378
28379 # type: textblock
28380 #. type: textblock
28381 #: ../fish/guestfish-actions.pod:2994
28382 msgid ""
28383 "This call is similar to L</mkfs>, but it allows you to control the block "
28384 "size of the resulting filesystem.  Supported block sizes depend on the "
28385 "filesystem type, but typically they are C<1024>, C<2048> or C<4096> only."
28386 msgstr ""
28387
28388 # type: =head2
28389 #. type: =head2
28390 #: ../fish/guestfish-actions.pod:3009
28391 msgid "mkfs-opts"
28392 msgstr ""
28393
28394 #. type: verbatim
28395 #: ../fish/guestfish-actions.pod:3011
28396 #, no-wrap
28397 msgid ""
28398 " mkfs-opts fstype device [blocksize:..] [features:..]\n"
28399 "\n"
28400 msgstr ""
28401
28402 # type: =head2
28403 #. type: =head2
28404 #: ../fish/guestfish-actions.pod:3046
28405 msgid "mkmountpoint"
28406 msgstr ""
28407
28408 # type: verbatim
28409 #. type: verbatim
28410 #: ../fish/guestfish-actions.pod:3048
28411 #, no-wrap
28412 msgid ""
28413 " mkmountpoint exemptpath\n"
28414 "\n"
28415 msgstr ""
28416
28417 # type: textblock
28418 #. type: textblock
28419 #: ../fish/guestfish-actions.pod:3050
28420 msgid ""
28421 "L</mkmountpoint> and L</rmmountpoint> are specialized calls that can be used "
28422 "to create extra mountpoints before mounting the first filesystem."
28423 msgstr ""
28424
28425 # type: textblock
28426 #. type: textblock
28427 #: ../fish/guestfish-actions.pod:3074
28428 msgid ""
28429 "L</mkmountpoint> is not compatible with L</umount-all>.  You may get "
28430 "unexpected errors if you try to mix these calls.  It is safest to manually "
28431 "unmount filesystems and remove mountpoints after use."
28432 msgstr ""
28433
28434 # type: textblock
28435 #. type: textblock
28436 #: ../fish/guestfish-actions.pod:3078
28437 msgid ""
28438 "L</umount-all> unmounts filesystems by sorting the paths longest first, so "
28439 "for this to work for manual mountpoints, you must ensure that the innermost "
28440 "mountpoints have the longest pathnames, as in the example code above."
28441 msgstr ""
28442
28443 #. type: textblock
28444 #: ../fish/guestfish-actions.pod:3085
28445 msgid ""
28446 "Autosync [see L</set-autosync>, this is set by default on handles] can cause "
28447 "L</umount-all> to be called when the handle is closed which can also trigger "
28448 "these issues."
28449 msgstr ""
28450
28451 # type: =head2
28452 #. type: =head2
28453 #: ../fish/guestfish-actions.pod:3089
28454 msgid "mknod"
28455 msgstr ""
28456
28457 # type: verbatim
28458 #. type: verbatim
28459 #: ../fish/guestfish-actions.pod:3091
28460 #, no-wrap
28461 msgid ""
28462 " mknod mode devmajor devminor path\n"
28463 "\n"
28464 msgstr ""
28465
28466 # type: textblock
28467 #. type: textblock
28468 #: ../fish/guestfish-actions.pod:3101
28469 msgid ""
28470 "Note that, just like L<mknod(2)>, the mode must be bitwise OR'd with "
28471 "S_IFBLK, S_IFCHR, S_IFIFO or S_IFSOCK (otherwise this call just creates a "
28472 "regular file).  These constants are available in the standard Linux header "
28473 "files, or you can use L</mknod-b>, L</mknod-c> or L</mkfifo> which are "
28474 "wrappers around this command which bitwise OR in the appropriate constant "
28475 "for you."
28476 msgstr ""
28477
28478 # type: =head2
28479 #. type: =head2
28480 #: ../fish/guestfish-actions.pod:3111
28481 msgid "mknod-b"
28482 msgstr ""
28483
28484 # type: verbatim
28485 #. type: verbatim
28486 #: ../fish/guestfish-actions.pod:3113
28487 #, no-wrap
28488 msgid ""
28489 " mknod-b mode devmajor devminor path\n"
28490 "\n"
28491 msgstr ""
28492
28493 # type: textblock
28494 #. type: textblock
28495 #: ../fish/guestfish-actions.pod:3115
28496 msgid ""
28497 "This call creates a block device node called C<path> with mode C<mode> and "
28498 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
28499 "wrapper around L</mknod>."
28500 msgstr ""
28501
28502 # type: =head2
28503 #. type: =head2
28504 #: ../fish/guestfish-actions.pod:3121
28505 msgid "mknod-c"
28506 msgstr ""
28507
28508 # type: verbatim
28509 #. type: verbatim
28510 #: ../fish/guestfish-actions.pod:3123
28511 #, no-wrap
28512 msgid ""
28513 " mknod-c mode devmajor devminor path\n"
28514 "\n"
28515 msgstr ""
28516
28517 # type: textblock
28518 #. type: textblock
28519 #: ../fish/guestfish-actions.pod:3125
28520 msgid ""
28521 "This call creates a char device node called C<path> with mode C<mode> and "
28522 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
28523 "wrapper around L</mknod>."
28524 msgstr ""
28525
28526 # type: =head2
28527 #. type: =head2
28528 #: ../fish/guestfish-actions.pod:3131
28529 msgid "mkswap"
28530 msgstr ""
28531
28532 # type: verbatim
28533 #. type: verbatim
28534 #: ../fish/guestfish-actions.pod:3133
28535 #, no-wrap
28536 msgid ""
28537 " mkswap device\n"
28538 "\n"
28539 msgstr ""
28540
28541 # type: =head2
28542 #. type: =head2
28543 #: ../fish/guestfish-actions.pod:3137
28544 msgid "mkswap-L"
28545 msgstr ""
28546
28547 # type: verbatim
28548 #. type: verbatim
28549 #: ../fish/guestfish-actions.pod:3139
28550 #, no-wrap
28551 msgid ""
28552 " mkswap-L label device\n"
28553 "\n"
28554 msgstr ""
28555
28556 # type: =head2
28557 #. type: =head2
28558 #: ../fish/guestfish-actions.pod:3147
28559 msgid "mkswap-U"
28560 msgstr ""
28561
28562 # type: verbatim
28563 #. type: verbatim
28564 #: ../fish/guestfish-actions.pod:3149
28565 #, no-wrap
28566 msgid ""
28567 " mkswap-U uuid device\n"
28568 "\n"
28569 msgstr ""
28570
28571 # type: =head2
28572 #. type: =head2
28573 #: ../fish/guestfish-actions.pod:3153
28574 msgid "mkswap-file"
28575 msgstr ""
28576
28577 # type: verbatim
28578 #. type: verbatim
28579 #: ../fish/guestfish-actions.pod:3155
28580 #, no-wrap
28581 msgid ""
28582 " mkswap-file path\n"
28583 "\n"
28584 msgstr ""
28585
28586 # type: textblock
28587 #. type: textblock
28588 #: ../fish/guestfish-actions.pod:3159
28589 msgid ""
28590 "This command just writes a swap file signature to an existing file.  To "
28591 "create the file itself, use something like L</fallocate>."
28592 msgstr ""
28593
28594 # type: =head2
28595 #. type: =head2
28596 #: ../fish/guestfish-actions.pod:3162
28597 msgid "modprobe"
28598 msgstr ""
28599
28600 # type: verbatim
28601 #. type: verbatim
28602 #: ../fish/guestfish-actions.pod:3164
28603 #, no-wrap
28604 msgid ""
28605 " modprobe modulename\n"
28606 "\n"
28607 msgstr ""
28608
28609 # type: =head2
28610 #. type: =head2
28611 #: ../fish/guestfish-actions.pod:3171
28612 msgid "mount"
28613 msgstr ""
28614
28615 # type: verbatim
28616 #. type: verbatim
28617 #: ../fish/guestfish-actions.pod:3173
28618 #, no-wrap
28619 msgid ""
28620 " mount device mountpoint\n"
28621 "\n"
28622 msgstr ""
28623
28624 # type: textblock
28625 #. type: textblock
28626 #: ../fish/guestfish-actions.pod:3189
28627 msgid ""
28628 "B<Important note:> When you use this call, the filesystem options C<sync> "
28629 "and C<noatime> are set implicitly.  This was originally done because we "
28630 "thought it would improve reliability, but it turns out that I<-o sync> has a "
28631 "very large negative performance impact and negligible effect on "
28632 "reliability.  Therefore we recommend that you avoid using L</mount> in any "
28633 "code that needs performance, and instead use L</mount-options> (use an empty "
28634 "string for the first parameter if you don't want any options)."
28635 msgstr ""
28636
28637 # type: =head2
28638 #. type: =head2
28639 #: ../fish/guestfish-actions.pod:3206
28640 msgid "mount-loop"
28641 msgstr ""
28642
28643 # type: verbatim
28644 #. type: verbatim
28645 #: ../fish/guestfish-actions.pod:3208
28646 #, no-wrap
28647 msgid ""
28648 " mount-loop file mountpoint\n"
28649 "\n"
28650 msgstr ""
28651
28652 # type: =head2
28653 #. type: =head2
28654 #: ../fish/guestfish-actions.pod:3214
28655 msgid "mount-options"
28656 msgstr ""
28657
28658 # type: verbatim
28659 #. type: verbatim
28660 #: ../fish/guestfish-actions.pod:3216
28661 #, no-wrap
28662 msgid ""
28663 " mount-options options device mountpoint\n"
28664 "\n"
28665 msgstr ""
28666
28667 # type: textblock
28668 #. type: textblock
28669 #: ../fish/guestfish-actions.pod:3218
28670 msgid ""
28671 "This is the same as the L</mount> command, but it allows you to set the "
28672 "mount options as for the L<mount(8)> I<-o> flag."
28673 msgstr ""
28674
28675 # type: =head2
28676 #. type: =head2
28677 #: ../fish/guestfish-actions.pod:3226
28678 msgid "mount-ro"
28679 msgstr ""
28680
28681 # type: verbatim
28682 #. type: verbatim
28683 #: ../fish/guestfish-actions.pod:3228
28684 #, no-wrap
28685 msgid ""
28686 " mount-ro device mountpoint\n"
28687 "\n"
28688 msgstr ""
28689
28690 # type: textblock
28691 #. type: textblock
28692 #: ../fish/guestfish-actions.pod:3230
28693 msgid ""
28694 "This is the same as the L</mount> command, but it mounts the filesystem with "
28695 "the read-only (I<-o ro>) flag."
28696 msgstr ""
28697
28698 # type: =head2
28699 #. type: =head2
28700 #: ../fish/guestfish-actions.pod:3233
28701 msgid "mount-vfs"
28702 msgstr ""
28703
28704 # type: verbatim
28705 #. type: verbatim
28706 #: ../fish/guestfish-actions.pod:3235
28707 #, no-wrap
28708 msgid ""
28709 " mount-vfs options vfstype device mountpoint\n"
28710 "\n"
28711 msgstr ""
28712
28713 # type: textblock
28714 #. type: textblock
28715 #: ../fish/guestfish-actions.pod:3237
28716 msgid ""
28717 "This is the same as the L</mount> command, but it allows you to set both the "
28718 "mount options and the vfstype as for the L<mount(8)> I<-o> and I<-t> flags."
28719 msgstr ""
28720
28721 # type: =head2
28722 #. type: =head2
28723 #: ../fish/guestfish-actions.pod:3241
28724 msgid "mountpoints"
28725 msgstr ""
28726
28727 # type: verbatim
28728 #. type: verbatim
28729 #: ../fish/guestfish-actions.pod:3243
28730 #, no-wrap
28731 msgid ""
28732 " mountpoints\n"
28733 "\n"
28734 msgstr ""
28735
28736 # type: textblock
28737 #. type: textblock
28738 #: ../fish/guestfish-actions.pod:3245
28739 msgid ""
28740 "This call is similar to L</mounts>.  That call returns a list of devices.  "
28741 "This one returns a hash table (map) of device name to directory where the "
28742 "device is mounted."
28743 msgstr ""
28744
28745 # type: =head2
28746 #. type: =head2
28747 #: ../fish/guestfish-actions.pod:3249
28748 msgid "mounts"
28749 msgstr ""
28750
28751 # type: verbatim
28752 #. type: verbatim
28753 #: ../fish/guestfish-actions.pod:3251
28754 #, no-wrap
28755 msgid ""
28756 " mounts\n"
28757 "\n"
28758 msgstr ""
28759
28760 # type: textblock
28761 #. type: textblock
28762 #: ../fish/guestfish-actions.pod:3258
28763 msgid "See also: L</mountpoints>"
28764 msgstr ""
28765
28766 # type: =head2
28767 #. type: =head2
28768 #: ../fish/guestfish-actions.pod:3260
28769 msgid "mv"
28770 msgstr ""
28771
28772 # type: verbatim
28773 #. type: verbatim
28774 #: ../fish/guestfish-actions.pod:3262
28775 #, no-wrap
28776 msgid ""
28777 " mv src dest\n"
28778 "\n"
28779 msgstr ""
28780
28781 # type: =head2
28782 #. type: =head2
28783 #: ../fish/guestfish-actions.pod:3267
28784 msgid "ntfs-3g-probe"
28785 msgstr ""
28786
28787 # type: verbatim
28788 #. type: verbatim
28789 #: ../fish/guestfish-actions.pod:3269
28790 #, no-wrap
28791 msgid ""
28792 " ntfs-3g-probe true|false device\n"
28793 "\n"
28794 msgstr ""
28795
28796 # type: =head2
28797 #. type: =head2
28798 #: ../fish/guestfish-actions.pod:3283
28799 msgid "ntfsresize"
28800 msgstr ""
28801
28802 # type: verbatim
28803 #. type: verbatim
28804 #: ../fish/guestfish-actions.pod:3285
28805 #, no-wrap
28806 msgid ""
28807 " ntfsresize device\n"
28808 "\n"
28809 msgstr ""
28810
28811 # type: =head2
28812 #. type: =head2
28813 #: ../fish/guestfish-actions.pod:3300
28814 msgid "ntfsresize-size"
28815 msgstr ""
28816
28817 # type: verbatim
28818 #. type: verbatim
28819 #: ../fish/guestfish-actions.pod:3302
28820 #, no-wrap
28821 msgid ""
28822 " ntfsresize-size device size\n"
28823 "\n"
28824 msgstr ""
28825
28826 # type: textblock
28827 #. type: textblock
28828 #: ../fish/guestfish-actions.pod:3304
28829 msgid ""
28830 "This command is the same as L</ntfsresize> except that it allows you to "
28831 "specify the new size (in bytes) explicitly."
28832 msgstr ""
28833
28834 # type: =head2
28835 #. type: =head2
28836 #: ../fish/guestfish-actions.pod:3307
28837 msgid "part-add"
28838 msgstr ""
28839
28840 # type: verbatim
28841 #. type: verbatim
28842 #: ../fish/guestfish-actions.pod:3309
28843 #, no-wrap
28844 msgid ""
28845 " part-add device prlogex startsect endsect\n"
28846 "\n"
28847 msgstr ""
28848
28849 # type: textblock
28850 #. type: textblock
28851 #: ../fish/guestfish-actions.pod:3311
28852 msgid ""
28853 "This command adds a partition to C<device>.  If there is no partition table "
28854 "on the device, call L</part-init> first."
28855 msgstr ""
28856
28857 # type: textblock
28858 #. type: textblock
28859 #: ../fish/guestfish-actions.pod:3323
28860 msgid ""
28861 "Creating a partition which covers the whole disk is not so easy.  Use L</"
28862 "part-disk> to do that."
28863 msgstr ""
28864
28865 # type: =head2
28866 #. type: =head2
28867 #: ../fish/guestfish-actions.pod:3326
28868 msgid "part-del"
28869 msgstr ""
28870
28871 # type: verbatim
28872 #. type: verbatim
28873 #: ../fish/guestfish-actions.pod:3328
28874 #, no-wrap
28875 msgid ""
28876 " part-del device partnum\n"
28877 "\n"
28878 msgstr ""
28879
28880 # type: =head2
28881 #. type: =head2
28882 #: ../fish/guestfish-actions.pod:3336
28883 msgid "part-disk"
28884 msgstr ""
28885
28886 # type: verbatim
28887 #. type: verbatim
28888 #: ../fish/guestfish-actions.pod:3338
28889 #, no-wrap
28890 msgid ""
28891 " part-disk device parttype\n"
28892 "\n"
28893 msgstr ""
28894
28895 # type: textblock
28896 #. type: textblock
28897 #: ../fish/guestfish-actions.pod:3340
28898 msgid ""
28899 "This command is simply a combination of L</part-init> followed by L</part-"
28900 "add> to create a single primary partition covering the whole disk."
28901 msgstr ""
28902
28903 # type: textblock
28904 #. type: textblock
28905 #: ../fish/guestfish-actions.pod:3344
28906 msgid ""
28907 "C<parttype> is the partition table type, usually C<mbr> or C<gpt>, but other "
28908 "possible values are described in L</part-init>."
28909 msgstr ""
28910
28911 # type: =head2
28912 #. type: =head2
28913 #: ../fish/guestfish-actions.pod:3350
28914 msgid "part-get-bootable"
28915 msgstr ""
28916
28917 # type: verbatim
28918 #. type: verbatim
28919 #: ../fish/guestfish-actions.pod:3352
28920 #, no-wrap
28921 msgid ""
28922 " part-get-bootable device partnum\n"
28923 "\n"
28924 msgstr ""
28925
28926 # type: textblock
28927 #. type: textblock
28928 #: ../fish/guestfish-actions.pod:3357
28929 msgid "See also L</part-set-bootable>."
28930 msgstr ""
28931
28932 # type: =head2
28933 #. type: =head2
28934 #: ../fish/guestfish-actions.pod:3359
28935 msgid "part-get-mbr-id"
28936 msgstr ""
28937
28938 # type: verbatim
28939 #. type: verbatim
28940 #: ../fish/guestfish-actions.pod:3361
28941 #, no-wrap
28942 msgid ""
28943 " part-get-mbr-id device partnum\n"
28944 "\n"
28945 msgstr ""
28946
28947 # type: textblock
28948 #. type: textblock
28949 #: ../fish/guestfish-actions.pod:3366 ../fish/guestfish-actions.pod:3504
28950 msgid ""
28951 "Note that only MBR (old DOS-style) partitions have type bytes.  You will get "
28952 "undefined results for other partition table types (see L</part-get-"
28953 "parttype>)."
28954 msgstr ""
28955
28956 # type: =head2
28957 #. type: =head2
28958 #: ../fish/guestfish-actions.pod:3370
28959 msgid "part-get-parttype"
28960 msgstr ""
28961
28962 # type: verbatim
28963 #. type: verbatim
28964 #: ../fish/guestfish-actions.pod:3372
28965 #, no-wrap
28966 msgid ""
28967 " part-get-parttype device\n"
28968 "\n"
28969 msgstr ""
28970
28971 # type: textblock
28972 #. type: textblock
28973 #: ../fish/guestfish-actions.pod:3377
28974 msgid ""
28975 "Common return values include: C<msdos> (a DOS/Windows style MBR partition "
28976 "table), C<gpt> (a GPT/EFI-style partition table).  Other values are "
28977 "possible, although unusual.  See L</part-init> for a full list."
28978 msgstr ""
28979
28980 # type: =head2
28981 #. type: =head2
28982 #: ../fish/guestfish-actions.pod:3382
28983 msgid "part-init"
28984 msgstr ""
28985
28986 # type: verbatim
28987 #. type: verbatim
28988 #: ../fish/guestfish-actions.pod:3384
28989 #, no-wrap
28990 msgid ""
28991 " part-init device parttype\n"
28992 "\n"
28993 msgstr ""
28994
28995 # type: textblock
28996 #. type: textblock
28997 #: ../fish/guestfish-actions.pod:3390
28998 msgid ""
28999 "Initially there are no partitions.  Following this, you should call L</part-"
29000 "add> for each partition required."
29001 msgstr ""
29002
29003 # type: =head2
29004 #. type: =head2
29005 #: ../fish/guestfish-actions.pod:3453
29006 msgid "part-list"
29007 msgstr ""
29008
29009 # type: verbatim
29010 #. type: verbatim
29011 #: ../fish/guestfish-actions.pod:3455
29012 #, no-wrap
29013 msgid ""
29014 " part-list device\n"
29015 "\n"
29016 msgstr ""
29017
29018 # type: textblock
29019 #. type: textblock
29020 #: ../fish/guestfish-actions.pod:3470
29021 msgid ""
29022 "Start of the partition I<in bytes>.  To get sectors you have to divide by "
29023 "the device's sector size, see L</blockdev-getss>."
29024 msgstr ""
29025
29026 # type: =head2
29027 #. type: =head2
29028 #: ../fish/guestfish-actions.pod:3483
29029 msgid "part-set-bootable"
29030 msgstr ""
29031
29032 # type: verbatim
29033 #. type: verbatim
29034 #: ../fish/guestfish-actions.pod:3485
29035 #, no-wrap
29036 msgid ""
29037 " part-set-bootable device partnum true|false\n"
29038 "\n"
29039 msgstr ""
29040
29041 # type: =head2
29042 #. type: =head2
29043 #: ../fish/guestfish-actions.pod:3494
29044 msgid "part-set-mbr-id"
29045 msgstr ""
29046
29047 # type: verbatim
29048 #. type: verbatim
29049 #: ../fish/guestfish-actions.pod:3496
29050 #, no-wrap
29051 msgid ""
29052 " part-set-mbr-id device partnum idbyte\n"
29053 "\n"
29054 msgstr ""
29055
29056 # type: =head2
29057 #. type: =head2
29058 #: ../fish/guestfish-actions.pod:3508
29059 msgid "part-set-name"
29060 msgstr ""
29061
29062 # type: verbatim
29063 #. type: verbatim
29064 #: ../fish/guestfish-actions.pod:3510
29065 #, no-wrap
29066 msgid ""
29067 " part-set-name device partnum name\n"
29068 "\n"
29069 msgstr ""
29070
29071 # type: =head2
29072 #. type: =head2
29073 #: ../fish/guestfish-actions.pod:3518
29074 msgid "part-to-dev"
29075 msgstr ""
29076
29077 # type: verbatim
29078 #. type: verbatim
29079 #: ../fish/guestfish-actions.pod:3520
29080 #, no-wrap
29081 msgid ""
29082 " part-to-dev partition\n"
29083 "\n"
29084 msgstr ""
29085
29086 # type: textblock
29087 #. type: textblock
29088 #: ../fish/guestfish-actions.pod:3526
29089 msgid ""
29090 "The named partition must exist, for example as a string returned from L</"
29091 "list-partitions>."
29092 msgstr ""
29093
29094 # type: =head2
29095 #. type: =head2
29096 #: ../fish/guestfish-actions.pod:3529
29097 msgid "ping-daemon"
29098 msgstr ""
29099
29100 # type: verbatim
29101 #. type: verbatim
29102 #: ../fish/guestfish-actions.pod:3531
29103 #, no-wrap
29104 msgid ""
29105 " ping-daemon\n"
29106 "\n"
29107 msgstr ""
29108
29109 # type: =head2
29110 #. type: =head2
29111 #: ../fish/guestfish-actions.pod:3538
29112 msgid "pread"
29113 msgstr ""
29114
29115 # type: verbatim
29116 #. type: verbatim
29117 #: ../fish/guestfish-actions.pod:3540
29118 #, no-wrap
29119 msgid ""
29120 " pread path count offset\n"
29121 "\n"
29122 msgstr ""
29123
29124 # type: textblock
29125 #. type: textblock
29126 #: ../fish/guestfish-actions.pod:3548
29127 msgid "See also L</pwrite>, L</pread-device>."
29128 msgstr ""
29129
29130 # type: =head2
29131 #. type: =head2
29132 #: ../fish/guestfish-actions.pod:3553
29133 msgid "pread-device"
29134 msgstr ""
29135
29136 # type: verbatim
29137 #. type: verbatim
29138 #: ../fish/guestfish-actions.pod:3555
29139 #, no-wrap
29140 msgid ""
29141 " pread-device device count offset\n"
29142 "\n"
29143 msgstr ""
29144
29145 # type: textblock
29146 #. type: textblock
29147 #: ../fish/guestfish-actions.pod:3563
29148 msgid "See also L</pread>."
29149 msgstr ""
29150
29151 # type: =head2
29152 #. type: =head2
29153 #: ../fish/guestfish-actions.pod:3568
29154 msgid "pvcreate"
29155 msgstr ""
29156
29157 # type: verbatim
29158 #. type: verbatim
29159 #: ../fish/guestfish-actions.pod:3570
29160 #, no-wrap
29161 msgid ""
29162 " pvcreate device\n"
29163 "\n"
29164 msgstr ""
29165
29166 # type: =head2
29167 #. type: =head2
29168 #: ../fish/guestfish-actions.pod:3576
29169 msgid "pvremove"
29170 msgstr ""
29171
29172 # type: verbatim
29173 #. type: verbatim
29174 #: ../fish/guestfish-actions.pod:3578
29175 #, no-wrap
29176 msgid ""
29177 " pvremove device\n"
29178 "\n"
29179 msgstr ""
29180
29181 # type: =head2
29182 #. type: =head2
29183 #: ../fish/guestfish-actions.pod:3587
29184 msgid "pvresize"
29185 msgstr ""
29186
29187 # type: verbatim
29188 #. type: verbatim
29189 #: ../fish/guestfish-actions.pod:3589
29190 #, no-wrap
29191 msgid ""
29192 " pvresize device\n"
29193 "\n"
29194 msgstr ""
29195
29196 # type: =head2
29197 #. type: =head2
29198 #: ../fish/guestfish-actions.pod:3594
29199 msgid "pvresize-size"
29200 msgstr ""
29201
29202 # type: verbatim
29203 #. type: verbatim
29204 #: ../fish/guestfish-actions.pod:3596
29205 #, no-wrap
29206 msgid ""
29207 " pvresize-size device size\n"
29208 "\n"
29209 msgstr ""
29210
29211 # type: textblock
29212 #. type: textblock
29213 #: ../fish/guestfish-actions.pod:3598
29214 msgid ""
29215 "This command is the same as L</pvresize> except that it allows you to "
29216 "specify the new size (in bytes) explicitly."
29217 msgstr ""
29218
29219 # type: =head2
29220 #. type: =head2
29221 #: ../fish/guestfish-actions.pod:3601
29222 msgid "pvs"
29223 msgstr ""
29224
29225 # type: verbatim
29226 #. type: verbatim
29227 #: ../fish/guestfish-actions.pod:3603
29228 #, no-wrap
29229 msgid ""
29230 " pvs\n"
29231 "\n"
29232 msgstr ""
29233
29234 # type: textblock
29235 #. type: textblock
29236 #: ../fish/guestfish-actions.pod:3611
29237 msgid "See also L</pvs-full>."
29238 msgstr ""
29239
29240 # type: =head2
29241 #. type: =head2
29242 #: ../fish/guestfish-actions.pod:3613
29243 msgid "pvs-full"
29244 msgstr ""
29245
29246 # type: verbatim
29247 #. type: verbatim
29248 #: ../fish/guestfish-actions.pod:3615
29249 #, no-wrap
29250 msgid ""
29251 " pvs-full\n"
29252 "\n"
29253 msgstr ""
29254
29255 # type: =head2
29256 #. type: =head2
29257 #: ../fish/guestfish-actions.pod:3620
29258 msgid "pvuuid"
29259 msgstr ""
29260
29261 # type: verbatim
29262 #. type: verbatim
29263 #: ../fish/guestfish-actions.pod:3622
29264 #, no-wrap
29265 msgid ""
29266 " pvuuid device\n"
29267 "\n"
29268 msgstr ""
29269
29270 # type: =head2
29271 #. type: =head2
29272 #: ../fish/guestfish-actions.pod:3626
29273 msgid "pwrite"
29274 msgstr ""
29275
29276 # type: verbatim
29277 #. type: verbatim
29278 #: ../fish/guestfish-actions.pod:3628
29279 #, no-wrap
29280 msgid ""
29281 " pwrite path content offset\n"
29282 "\n"
29283 msgstr ""
29284
29285 # type: textblock
29286 #. type: textblock
29287 #: ../fish/guestfish-actions.pod:3639
29288 msgid "See also L</pread>, L</pwrite-device>."
29289 msgstr ""
29290
29291 # type: =head2
29292 #. type: =head2
29293 #: ../fish/guestfish-actions.pod:3644
29294 msgid "pwrite-device"
29295 msgstr ""
29296
29297 # type: verbatim
29298 #. type: verbatim
29299 #: ../fish/guestfish-actions.pod:3646
29300 #, no-wrap
29301 msgid ""
29302 " pwrite-device device content offset\n"
29303 "\n"
29304 msgstr ""
29305
29306 # type: textblock
29307 #. type: textblock
29308 #: ../fish/guestfish-actions.pod:3656
29309 msgid "See also L</pwrite>."
29310 msgstr ""
29311
29312 # type: =head2
29313 #. type: =head2
29314 #: ../fish/guestfish-actions.pod:3661
29315 msgid "read-file"
29316 msgstr ""
29317
29318 # type: verbatim
29319 #. type: verbatim
29320 #: ../fish/guestfish-actions.pod:3663
29321 #, no-wrap
29322 msgid ""
29323 " read-file path\n"
29324 "\n"
29325 msgstr ""
29326
29327 # type: textblock
29328 #. type: textblock
29329 #: ../fish/guestfish-actions.pod:3668
29330 msgid ""
29331 "Unlike L</cat>, this function can correctly handle files that contain "
29332 "embedded ASCII NUL characters.  However unlike L</download>, this function "
29333 "is limited in the total size of file that can be handled."
29334 msgstr ""
29335
29336 # type: =head2
29337 #. type: =head2
29338 #: ../fish/guestfish-actions.pod:3676
29339 msgid "read-lines"
29340 msgstr ""
29341
29342 # type: verbatim
29343 #. type: verbatim
29344 #: ../fish/guestfish-actions.pod:3678
29345 #, no-wrap
29346 msgid ""
29347 " read-lines path\n"
29348 "\n"
29349 msgstr ""
29350
29351 # type: textblock
29352 #. type: textblock
29353 #: ../fish/guestfish-actions.pod:3685
29354 msgid ""
29355 "Note that this function cannot correctly handle binary files (specifically, "
29356 "files containing C<\\0> character which is treated as end of line).  For "
29357 "those you need to use the L</read-file> function which has a more complex "
29358 "interface."
29359 msgstr ""
29360
29361 # type: =head2
29362 #. type: =head2
29363 #: ../fish/guestfish-actions.pod:3690
29364 msgid "readdir"
29365 msgstr ""
29366
29367 # type: verbatim
29368 #. type: verbatim
29369 #: ../fish/guestfish-actions.pod:3692
29370 #, no-wrap
29371 msgid ""
29372 " readdir dir\n"
29373 "\n"
29374 msgstr ""
29375
29376 # type: textblock
29377 #. type: textblock
29378 #: ../fish/guestfish-actions.pod:3744
29379 msgid ""
29380 "This function is primarily intended for use by programs.  To get a simple "
29381 "list of names, use L</ls>.  To get a printable directory for human "
29382 "consumption, use L</ll>."
29383 msgstr ""
29384
29385 # type: =head2
29386 #. type: =head2
29387 #: ../fish/guestfish-actions.pod:3748
29388 msgid "readlink"
29389 msgstr ""
29390
29391 # type: verbatim
29392 #. type: verbatim
29393 #: ../fish/guestfish-actions.pod:3750
29394 #, no-wrap
29395 msgid ""
29396 " readlink path\n"
29397 "\n"
29398 msgstr ""
29399
29400 # type: =head2
29401 #. type: =head2
29402 #: ../fish/guestfish-actions.pod:3754
29403 msgid "readlinklist"
29404 msgstr ""
29405
29406 # type: verbatim
29407 #. type: verbatim
29408 #: ../fish/guestfish-actions.pod:3756
29409 #, no-wrap
29410 msgid ""
29411 " readlinklist path 'names ...'\n"
29412 "\n"
29413 msgstr ""
29414
29415 # type: =head2
29416 #. type: =head2
29417 #: ../fish/guestfish-actions.pod:3780
29418 msgid "realpath"
29419 msgstr ""
29420
29421 # type: verbatim
29422 #. type: verbatim
29423 #: ../fish/guestfish-actions.pod:3782
29424 #, no-wrap
29425 msgid ""
29426 " realpath path\n"
29427 "\n"
29428 msgstr ""
29429
29430 # type: =head2
29431 #. type: =head2
29432 #: ../fish/guestfish-actions.pod:3787
29433 msgid "removexattr"
29434 msgstr ""
29435
29436 # type: verbatim
29437 #. type: verbatim
29438 #: ../fish/guestfish-actions.pod:3789
29439 #, no-wrap
29440 msgid ""
29441 " removexattr xattr path\n"
29442 "\n"
29443 msgstr ""
29444
29445 # type: textblock
29446 #. type: textblock
29447 #: ../fish/guestfish-actions.pod:3794
29448 msgid "See also: L</lremovexattr>, L<attr(5)>."
29449 msgstr ""
29450
29451 # type: =head2
29452 #. type: =head2
29453 #: ../fish/guestfish-actions.pod:3796
29454 msgid "resize2fs"
29455 msgstr ""
29456
29457 # type: verbatim
29458 #. type: verbatim
29459 #: ../fish/guestfish-actions.pod:3798
29460 #, no-wrap
29461 msgid ""
29462 " resize2fs device\n"
29463 "\n"
29464 msgstr ""
29465
29466 # type: textblock
29467 #. type: textblock
29468 #: ../fish/guestfish-actions.pod:3803
29469 msgid ""
29470 "I<Note:> It is sometimes required that you run L</e2fsck-f> on the C<device> "
29471 "before calling this command.  For unknown reasons C<resize2fs> sometimes "
29472 "gives an error about this and sometimes not.  In any case, it is always safe "
29473 "to call L</e2fsck-f> before calling this function."
29474 msgstr ""
29475
29476 #. type: =head2
29477 #: ../fish/guestfish-actions.pod:3809
29478 msgid "resize2fs-M"
29479 msgstr ""
29480
29481 #. type: verbatim
29482 #: ../fish/guestfish-actions.pod:3811
29483 #, no-wrap
29484 msgid ""
29485 " resize2fs-M device\n"
29486 "\n"
29487 msgstr ""
29488
29489 #. type: textblock
29490 #: ../fish/guestfish-actions.pod:3813
29491 msgid ""
29492 "This command is the same as L</resize2fs>, but the filesystem is resized to "
29493 "its minimum size.  This works like the I<-M> option to the C<resize2fs> "
29494 "command."
29495 msgstr ""
29496
29497 #. type: textblock
29498 #: ../fish/guestfish-actions.pod:3817
29499 msgid ""
29500 "To get the resulting size of the filesystem you should call L</tune2fs-l> "
29501 "and read the C<Block size> and C<Block count> values.  These two numbers, "
29502 "multiplied together, give the resulting size of the minimal filesystem in "
29503 "bytes."
29504 msgstr ""
29505
29506 # type: =head2
29507 #. type: =head2
29508 #: ../fish/guestfish-actions.pod:3822
29509 msgid "resize2fs-size"
29510 msgstr ""
29511
29512 # type: verbatim
29513 #. type: verbatim
29514 #: ../fish/guestfish-actions.pod:3824
29515 #, no-wrap
29516 msgid ""
29517 " resize2fs-size device size\n"
29518 "\n"
29519 msgstr ""
29520
29521 # type: textblock
29522 #. type: textblock
29523 #: ../fish/guestfish-actions.pod:3826
29524 msgid ""
29525 "This command is the same as L</resize2fs> except that it allows you to "
29526 "specify the new size (in bytes) explicitly."
29527 msgstr ""
29528
29529 # type: =head2
29530 #. type: =head2
29531 #: ../fish/guestfish-actions.pod:3829
29532 msgid "rm"
29533 msgstr ""
29534
29535 # type: verbatim
29536 #. type: verbatim
29537 #: ../fish/guestfish-actions.pod:3831
29538 #, no-wrap
29539 msgid ""
29540 " rm path\n"
29541 "\n"
29542 msgstr ""
29543
29544 # type: =head2
29545 #. type: =head2
29546 #: ../fish/guestfish-actions.pod:3835
29547 msgid "rm-rf"
29548 msgstr ""
29549
29550 # type: verbatim
29551 #. type: verbatim
29552 #: ../fish/guestfish-actions.pod:3837
29553 #, no-wrap
29554 msgid ""
29555 " rm-rf path\n"
29556 "\n"
29557 msgstr ""
29558
29559 # type: =head2
29560 #. type: =head2
29561 #: ../fish/guestfish-actions.pod:3843
29562 msgid "rmdir"
29563 msgstr ""
29564
29565 # type: verbatim
29566 #. type: verbatim
29567 #: ../fish/guestfish-actions.pod:3845
29568 #, no-wrap
29569 msgid ""
29570 " rmdir path\n"
29571 "\n"
29572 msgstr ""
29573
29574 # type: =head2
29575 #. type: =head2
29576 #: ../fish/guestfish-actions.pod:3849
29577 msgid "rmmountpoint"
29578 msgstr ""
29579
29580 # type: verbatim
29581 #. type: verbatim
29582 #: ../fish/guestfish-actions.pod:3851
29583 #, no-wrap
29584 msgid ""
29585 " rmmountpoint exemptpath\n"
29586 "\n"
29587 msgstr ""
29588
29589 # type: textblock
29590 #. type: textblock
29591 #: ../fish/guestfish-actions.pod:3853
29592 msgid ""
29593 "This calls removes a mountpoint that was previously created with L</"
29594 "mkmountpoint>.  See L</mkmountpoint> for full details."
29595 msgstr ""
29596
29597 # type: =head2
29598 #. type: =head2
29599 #: ../fish/guestfish-actions.pod:3857
29600 msgid "scrub-device"
29601 msgstr ""
29602
29603 # type: verbatim
29604 #. type: verbatim
29605 #: ../fish/guestfish-actions.pod:3859
29606 #, no-wrap
29607 msgid ""
29608 " scrub-device device\n"
29609 "\n"
29610 msgstr ""
29611
29612 # type: =head2
29613 #. type: =head2
29614 #: ../fish/guestfish-actions.pod:3870
29615 msgid "scrub-file"
29616 msgstr ""
29617
29618 # type: verbatim
29619 #. type: verbatim
29620 #: ../fish/guestfish-actions.pod:3872
29621 #, no-wrap
29622 msgid ""
29623 " scrub-file file\n"
29624 "\n"
29625 msgstr ""
29626
29627 # type: =head2
29628 #. type: =head2
29629 #: ../fish/guestfish-actions.pod:3882
29630 msgid "scrub-freespace"
29631 msgstr ""
29632
29633 # type: verbatim
29634 #. type: verbatim
29635 #: ../fish/guestfish-actions.pod:3884
29636 #, no-wrap
29637 msgid ""
29638 " scrub-freespace dir\n"
29639 "\n"
29640 msgstr ""
29641
29642 # type: textblock
29643 #. type: textblock
29644 #: ../fish/guestfish-actions.pod:3886
29645 msgid ""
29646 "This command creates the directory C<dir> and then fills it with files until "
29647 "the filesystem is full, and scrubs the files as for L</scrub-file>, and "
29648 "deletes them.  The intention is to scrub any free space on the partition "
29649 "containing C<dir>."
29650 msgstr ""
29651
29652 # type: =head2
29653 #. type: =head2
29654 #: ../fish/guestfish-actions.pod:3895
29655 msgid "set-append"
29656 msgstr ""
29657
29658 # type: =head2
29659 #. type: =head2
29660 #: ../fish/guestfish-actions.pod:3897
29661 msgid "append"
29662 msgstr ""
29663
29664 # type: verbatim
29665 #. type: verbatim
29666 #: ../fish/guestfish-actions.pod:3899
29667 #, no-wrap
29668 msgid ""
29669 " set-append append\n"
29670 "\n"
29671 msgstr ""
29672
29673 #. type: =head2
29674 #: ../fish/guestfish-actions.pod:3910
29675 msgid "set-attach-method"
29676 msgstr ""
29677
29678 #. type: =head2
29679 #: ../fish/guestfish-actions.pod:3912
29680 msgid "attach-method"
29681 msgstr ""
29682
29683 #. type: verbatim
29684 #: ../fish/guestfish-actions.pod:3914
29685 #, no-wrap
29686 msgid ""
29687 " set-attach-method attachmethod\n"
29688 "\n"
29689 msgstr ""
29690
29691 # type: =head2
29692 #. type: =head2
29693 #: ../fish/guestfish-actions.pod:3936
29694 msgid "set-autosync"
29695 msgstr ""
29696
29697 # type: =head2
29698 #. type: =head2
29699 #: ../fish/guestfish-actions.pod:3938
29700 msgid "autosync"
29701 msgstr ""
29702
29703 # type: verbatim
29704 #. type: verbatim
29705 #: ../fish/guestfish-actions.pod:3940
29706 #, no-wrap
29707 msgid ""
29708 " set-autosync true|false\n"
29709 "\n"
29710 msgstr ""
29711
29712 # type: =head2
29713 #. type: =head2
29714 #: ../fish/guestfish-actions.pod:3950
29715 msgid "set-direct"
29716 msgstr ""
29717
29718 # type: =head2
29719 #. type: =head2
29720 #: ../fish/guestfish-actions.pod:3952
29721 msgid "direct"
29722 msgstr ""
29723
29724 # type: verbatim
29725 #. type: verbatim
29726 #: ../fish/guestfish-actions.pod:3954
29727 #, no-wrap
29728 msgid ""
29729 " set-direct true|false\n"
29730 "\n"
29731 msgstr ""
29732
29733 # type: textblock
29734 #. type: textblock
29735 #: ../fish/guestfish-actions.pod:3960
29736 msgid ""
29737 "One consequence of this is that log messages aren't caught by the library "
29738 "and handled by L</set-log-message-callback>, but go straight to stdout."
29739 msgstr ""
29740
29741 # type: =head2
29742 #. type: =head2
29743 #: ../fish/guestfish-actions.pod:3969
29744 msgid "set-e2label"
29745 msgstr ""
29746
29747 # type: verbatim
29748 #. type: verbatim
29749 #: ../fish/guestfish-actions.pod:3971
29750 #, no-wrap
29751 msgid ""
29752 " set-e2label device label\n"
29753 "\n"
29754 msgstr ""
29755
29756 # type: textblock
29757 #. type: textblock
29758 #: ../fish/guestfish-actions.pod:3977
29759 msgid ""
29760 "You can use either L</tune2fs-l> or L</get-e2label> to return the existing "
29761 "label on a filesystem."
29762 msgstr ""
29763
29764 # type: =head2
29765 #. type: =head2
29766 #: ../fish/guestfish-actions.pod:3980
29767 msgid "set-e2uuid"
29768 msgstr ""
29769
29770 # type: verbatim
29771 #. type: verbatim
29772 #: ../fish/guestfish-actions.pod:3982
29773 #, no-wrap
29774 msgid ""
29775 " set-e2uuid device uuid\n"
29776 "\n"
29777 msgstr ""
29778
29779 # type: textblock
29780 #. type: textblock
29781 #: ../fish/guestfish-actions.pod:3989
29782 msgid ""
29783 "You can use either L</tune2fs-l> or L</get-e2uuid> to return the existing "
29784 "UUID of a filesystem."
29785 msgstr ""
29786
29787 # type: =head2
29788 #. type: =head2
29789 #: ../fish/guestfish-actions.pod:3992
29790 msgid "set-memsize"
29791 msgstr ""
29792
29793 # type: =head2
29794 #. type: =head2
29795 #: ../fish/guestfish-actions.pod:3994
29796 msgid "memsize"
29797 msgstr ""
29798
29799 # type: verbatim
29800 #. type: verbatim
29801 #: ../fish/guestfish-actions.pod:3996
29802 #, no-wrap
29803 msgid ""
29804 " set-memsize memsize\n"
29805 "\n"
29806 msgstr ""
29807
29808 # type: textblock
29809 #. type: textblock
29810 #: ../fish/guestfish-actions.pod:3998
29811 msgid ""
29812 "This sets the memory size in megabytes allocated to the qemu subprocess.  "
29813 "This only has any effect if called before L</launch>."
29814 msgstr ""
29815
29816 # type: =head2
29817 #. type: =head2
29818 #: ../fish/guestfish-actions.pod:4009
29819 msgid "set-network"
29820 msgstr ""
29821
29822 # type: =head2
29823 #. type: =head2
29824 #: ../fish/guestfish-actions.pod:4011
29825 msgid "network"
29826 msgstr ""
29827
29828 # type: verbatim
29829 #. type: verbatim
29830 #: ../fish/guestfish-actions.pod:4013
29831 #, no-wrap
29832 msgid ""
29833 " set-network true|false\n"
29834 "\n"
29835 msgstr ""
29836
29837 # type: textblock
29838 #. type: textblock
29839 #: ../fish/guestfish-actions.pod:4021
29840 msgid ""
29841 "You must call this before calling L</launch>, otherwise it has no effect."
29842 msgstr ""
29843
29844 # type: =head2
29845 #. type: =head2
29846 #: ../fish/guestfish-actions.pod:4024
29847 msgid "set-path"
29848 msgstr ""
29849
29850 # type: =head2
29851 #. type: =head2
29852 #: ../fish/guestfish-actions.pod:4026
29853 msgid "path"
29854 msgstr ""
29855
29856 # type: verbatim
29857 #. type: verbatim
29858 #: ../fish/guestfish-actions.pod:4028
29859 #, no-wrap
29860 msgid ""
29861 " set-path searchpath\n"
29862 "\n"
29863 msgstr ""
29864
29865 # type: =head2
29866 #. type: =head2
29867 #: ../fish/guestfish-actions.pod:4037
29868 msgid "set-qemu"
29869 msgstr ""
29870
29871 # type: =head2
29872 #. type: =head2
29873 #: ../fish/guestfish-actions.pod:4039
29874 msgid "qemu"
29875 msgstr ""
29876
29877 # type: verbatim
29878 #. type: verbatim
29879 #: ../fish/guestfish-actions.pod:4041
29880 #, no-wrap
29881 msgid ""
29882 " set-qemu qemu\n"
29883 "\n"
29884 msgstr ""
29885
29886 # type: =head2
29887 #. type: =head2
29888 #: ../fish/guestfish-actions.pod:4061
29889 msgid "set-recovery-proc"
29890 msgstr ""
29891
29892 # type: =head2
29893 #. type: =head2
29894 #: ../fish/guestfish-actions.pod:4063
29895 msgid "recovery-proc"
29896 msgstr ""
29897
29898 # type: verbatim
29899 #. type: verbatim
29900 #: ../fish/guestfish-actions.pod:4065
29901 #, no-wrap
29902 msgid ""
29903 " set-recovery-proc true|false\n"
29904 "\n"
29905 msgstr ""
29906
29907 # type: textblock
29908 #. type: textblock
29909 #: ../fish/guestfish-actions.pod:4067
29910 msgid ""
29911 "If this is called with the parameter C<false> then L</launch> does not "
29912 "create a recovery process.  The purpose of the recovery process is to stop "
29913 "runaway qemu processes in the case where the main program aborts abruptly."
29914 msgstr ""
29915
29916 # type: textblock
29917 #. type: textblock
29918 #: ../fish/guestfish-actions.pod:4072
29919 msgid ""
29920 "This only has any effect if called before L</launch>, and the default is "
29921 "true."
29922 msgstr ""
29923
29924 # type: =head2
29925 #. type: =head2
29926 #: ../fish/guestfish-actions.pod:4081
29927 msgid "set-selinux"
29928 msgstr ""
29929
29930 # type: =head2
29931 #. type: =head2
29932 #: ../fish/guestfish-actions.pod:4083
29933 msgid "selinux"
29934 msgstr ""
29935
29936 # type: verbatim
29937 #. type: verbatim
29938 #: ../fish/guestfish-actions.pod:4085
29939 #, no-wrap
29940 msgid ""
29941 " set-selinux true|false\n"
29942 "\n"
29943 msgstr ""
29944
29945 # type: =head2
29946 #. type: =head2
29947 #: ../fish/guestfish-actions.pod:4096
29948 msgid "set-trace"
29949 msgstr ""
29950
29951 # type: =head2
29952 #. type: =head2
29953 #: ../fish/guestfish-actions.pod:4098
29954 msgid "trace"
29955 msgstr ""
29956
29957 # type: verbatim
29958 #. type: verbatim
29959 #: ../fish/guestfish-actions.pod:4100
29960 #, no-wrap
29961 msgid ""
29962 " set-trace true|false\n"
29963 "\n"
29964 msgstr ""
29965
29966 #. type: textblock
29967 #: ../fish/guestfish-actions.pod:4112
29968 msgid ""
29969 "Trace messages are normally sent to C<stderr>, unless you register a "
29970 "callback to send them somewhere else (see L</set-event-callback>)."
29971 msgstr ""
29972
29973 # type: =head2
29974 #. type: =head2
29975 #: ../fish/guestfish-actions.pod:4116
29976 msgid "set-verbose"
29977 msgstr ""
29978
29979 # type: =head2
29980 #. type: =head2
29981 #: ../fish/guestfish-actions.pod:4118
29982 msgid "verbose"
29983 msgstr ""
29984
29985 # type: verbatim
29986 #. type: verbatim
29987 #: ../fish/guestfish-actions.pod:4120
29988 #, no-wrap
29989 msgid ""
29990 " set-verbose true|false\n"
29991 "\n"
29992 msgstr ""
29993
29994 #. type: textblock
29995 #: ../fish/guestfish-actions.pod:4127
29996 msgid ""
29997 "Verbose messages are normally sent to C<stderr>, unless you register a "
29998 "callback to send them somewhere else (see L</set-event-callback>)."
29999 msgstr ""
30000
30001 # type: =head2
30002 #. type: =head2
30003 #: ../fish/guestfish-actions.pod:4131
30004 msgid "setcon"
30005 msgstr ""
30006
30007 # type: verbatim
30008 #. type: verbatim
30009 #: ../fish/guestfish-actions.pod:4133
30010 #, no-wrap
30011 msgid ""
30012 " setcon context\n"
30013 "\n"
30014 msgstr ""
30015
30016 # type: =head2
30017 #. type: =head2
30018 #: ../fish/guestfish-actions.pod:4140
30019 msgid "setxattr"
30020 msgstr ""
30021
30022 # type: verbatim
30023 #. type: verbatim
30024 #: ../fish/guestfish-actions.pod:4142
30025 #, no-wrap
30026 msgid ""
30027 " setxattr xattr val vallen path\n"
30028 "\n"
30029 msgstr ""
30030
30031 # type: textblock
30032 #. type: textblock
30033 #: ../fish/guestfish-actions.pod:4148
30034 msgid "See also: L</lsetxattr>, L<attr(5)>."
30035 msgstr ""
30036
30037 # type: =head2
30038 #. type: =head2
30039 #: ../fish/guestfish-actions.pod:4150
30040 msgid "sfdisk"
30041 msgstr ""
30042
30043 # type: verbatim
30044 #. type: verbatim
30045 #: ../fish/guestfish-actions.pod:4152
30046 #, no-wrap
30047 msgid ""
30048 " sfdisk device cyls heads sectors 'lines ...'\n"
30049 "\n"
30050 msgstr ""
30051
30052 # type: textblock
30053 #. type: textblock
30054 #: ../fish/guestfish-actions.pod:4174
30055 msgid "See also: L</sfdisk-l>, L</sfdisk-N>, L</part-init>"
30056 msgstr ""
30057
30058 # type: =head2
30059 #. type: =head2
30060 #: ../fish/guestfish-actions.pod:4187
30061 msgid "sfdiskM"
30062 msgstr ""
30063
30064 # type: verbatim
30065 #. type: verbatim
30066 #: ../fish/guestfish-actions.pod:4189
30067 #, no-wrap
30068 msgid ""
30069 " sfdiskM device 'lines ...'\n"
30070 "\n"
30071 msgstr ""
30072
30073 # type: textblock
30074 #. type: textblock
30075 #: ../fish/guestfish-actions.pod:4191
30076 msgid ""
30077 "This is a simplified interface to the L</sfdisk> command, where partition "
30078 "sizes are specified in megabytes only (rounded to the nearest cylinder) and "
30079 "you don't need to specify the cyls, heads and sectors parameters which were "
30080 "rarely if ever used anyway."
30081 msgstr ""
30082
30083 # type: textblock
30084 #. type: textblock
30085 #: ../fish/guestfish-actions.pod:4197
30086 msgid "See also: L</sfdisk>, the L<sfdisk(8)> manpage and L</part-disk>"
30087 msgstr ""
30088
30089 # type: =head2
30090 #. type: =head2
30091 #: ../fish/guestfish-actions.pod:4210
30092 msgid "sfdisk-N"
30093 msgstr ""
30094
30095 # type: verbatim
30096 #. type: verbatim
30097 #: ../fish/guestfish-actions.pod:4212
30098 #, no-wrap
30099 msgid ""
30100 " sfdisk-N device partnum cyls heads sectors line\n"
30101 "\n"
30102 msgstr ""
30103
30104 # type: textblock
30105 #. type: textblock
30106 #: ../fish/guestfish-actions.pod:4217
30107 msgid ""
30108 "For other parameters, see L</sfdisk>.  You should usually pass C<0> for the "
30109 "cyls/heads/sectors parameters."
30110 msgstr ""
30111
30112 # type: textblock
30113 #. type: textblock
30114 #: ../fish/guestfish-actions.pod:4220
30115 msgid "See also: L</part-add>"
30116 msgstr ""
30117
30118 # type: =head2
30119 #. type: =head2
30120 #: ../fish/guestfish-actions.pod:4232
30121 msgid "sfdisk-disk-geometry"
30122 msgstr ""
30123
30124 # type: verbatim
30125 #. type: verbatim
30126 #: ../fish/guestfish-actions.pod:4234
30127 #, no-wrap
30128 msgid ""
30129 " sfdisk-disk-geometry device\n"
30130 "\n"
30131 msgstr ""
30132
30133 # type: textblock
30134 #. type: textblock
30135 #: ../fish/guestfish-actions.pod:4236
30136 msgid ""
30137 "This displays the disk geometry of C<device> read from the partition table.  "
30138 "Especially in the case where the underlying block device has been resized, "
30139 "this can be different from the kernel's idea of the geometry (see L</sfdisk-"
30140 "kernel-geometry>)."
30141 msgstr ""
30142
30143 # type: =head2
30144 #. type: =head2
30145 #: ../fish/guestfish-actions.pod:4244
30146 msgid "sfdisk-kernel-geometry"
30147 msgstr ""
30148
30149 # type: verbatim
30150 #. type: verbatim
30151 #: ../fish/guestfish-actions.pod:4246
30152 #, no-wrap
30153 msgid ""
30154 " sfdisk-kernel-geometry device\n"
30155 "\n"
30156 msgstr ""
30157
30158 # type: =head2
30159 #. type: =head2
30160 #: ../fish/guestfish-actions.pod:4253
30161 msgid "sfdisk-l"
30162 msgstr ""
30163
30164 # type: verbatim
30165 #. type: verbatim
30166 #: ../fish/guestfish-actions.pod:4255
30167 #, no-wrap
30168 msgid ""
30169 " sfdisk-l device\n"
30170 "\n"
30171 msgstr ""
30172
30173 # type: textblock
30174 #. type: textblock
30175 #: ../fish/guestfish-actions.pod:4261
30176 msgid "See also: L</part-list>"
30177 msgstr ""
30178
30179 # type: =head2
30180 #. type: =head2
30181 #: ../fish/guestfish-actions.pod:4270
30182 msgid "sh"
30183 msgstr ""
30184
30185 # type: verbatim
30186 #. type: verbatim
30187 #: ../fish/guestfish-actions.pod:4272
30188 #, no-wrap
30189 msgid ""
30190 " sh command\n"
30191 "\n"
30192 msgstr ""
30193
30194 # type: textblock
30195 #. type: textblock
30196 #: ../fish/guestfish-actions.pod:4277
30197 msgid "This is like L</command>, but passes the command to:"
30198 msgstr ""
30199
30200 # type: textblock
30201 #. type: textblock
30202 #: ../fish/guestfish-actions.pod:4285
30203 msgid "All the provisos about L</command> apply to this call."
30204 msgstr ""
30205
30206 # type: =head2
30207 #. type: =head2
30208 #: ../fish/guestfish-actions.pod:4287
30209 msgid "sh-lines"
30210 msgstr ""
30211
30212 # type: verbatim
30213 #. type: verbatim
30214 #: ../fish/guestfish-actions.pod:4289
30215 #, no-wrap
30216 msgid ""
30217 " sh-lines command\n"
30218 "\n"
30219 msgstr ""
30220
30221 # type: textblock
30222 #. type: textblock
30223 #: ../fish/guestfish-actions.pod:4291
30224 msgid "This is the same as L</sh>, but splits the result into a list of lines."
30225 msgstr ""
30226
30227 # type: textblock
30228 #. type: textblock
30229 #: ../fish/guestfish-actions.pod:4294
30230 msgid "See also: L</command-lines>"
30231 msgstr ""
30232
30233 # type: =head2
30234 #. type: =head2
30235 #: ../fish/guestfish-actions.pod:4296
30236 msgid "sleep"
30237 msgstr ""
30238
30239 # type: verbatim
30240 #. type: verbatim
30241 #: ../fish/guestfish-actions.pod:4298
30242 #, no-wrap
30243 msgid ""
30244 " sleep secs\n"
30245 "\n"
30246 msgstr ""
30247
30248 # type: =head2
30249 #. type: =head2
30250 #: ../fish/guestfish-actions.pod:4302
30251 msgid "stat"
30252 msgstr ""
30253
30254 # type: verbatim
30255 #. type: verbatim
30256 #: ../fish/guestfish-actions.pod:4304
30257 #, no-wrap
30258 msgid ""
30259 " stat path\n"
30260 "\n"
30261 msgstr ""
30262
30263 # type: =head2
30264 #. type: =head2
30265 #: ../fish/guestfish-actions.pod:4310
30266 msgid "statvfs"
30267 msgstr ""
30268
30269 # type: verbatim
30270 #. type: verbatim
30271 #: ../fish/guestfish-actions.pod:4312
30272 #, no-wrap
30273 msgid ""
30274 " statvfs path\n"
30275 "\n"
30276 msgstr ""
30277
30278 # type: =head2
30279 #. type: =head2
30280 #: ../fish/guestfish-actions.pod:4320
30281 msgid "strings"
30282 msgstr ""
30283
30284 # type: verbatim
30285 #. type: verbatim
30286 #: ../fish/guestfish-actions.pod:4322
30287 #, no-wrap
30288 msgid ""
30289 " strings path\n"
30290 "\n"
30291 msgstr ""
30292
30293 # type: =head2
30294 #. type: =head2
30295 #: ../fish/guestfish-actions.pod:4330
30296 msgid "strings-e"
30297 msgstr ""
30298
30299 # type: verbatim
30300 #. type: verbatim
30301 #: ../fish/guestfish-actions.pod:4332
30302 #, no-wrap
30303 msgid ""
30304 " strings-e encoding path\n"
30305 "\n"
30306 msgstr ""
30307
30308 # type: textblock
30309 #. type: textblock
30310 #: ../fish/guestfish-actions.pod:4334
30311 msgid ""
30312 "This is like the L</strings> command, but allows you to specify the encoding "
30313 "of strings that are looked for in the source file C<path>."
30314 msgstr ""
30315
30316 # type: textblock
30317 #. type: textblock
30318 #: ../fish/guestfish-actions.pod:4344
30319 msgid ""
30320 "Single 7-bit-byte characters like ASCII and the ASCII-compatible parts of "
30321 "ISO-8859-X (this is what L</strings> uses)."
30322 msgstr ""
30323
30324 # type: =head2
30325 #. type: =head2
30326 #: ../fish/guestfish-actions.pod:4376
30327 msgid "swapoff-device"
30328 msgstr ""
30329
30330 # type: verbatim
30331 #. type: verbatim
30332 #: ../fish/guestfish-actions.pod:4378
30333 #, no-wrap
30334 msgid ""
30335 " swapoff-device device\n"
30336 "\n"
30337 msgstr ""
30338
30339 # type: textblock
30340 #. type: textblock
30341 #: ../fish/guestfish-actions.pod:4380
30342 msgid ""
30343 "This command disables the libguestfs appliance swap device or partition "
30344 "named C<device>.  See L</swapon-device>."
30345 msgstr ""
30346
30347 # type: =head2
30348 #. type: =head2
30349 #: ../fish/guestfish-actions.pod:4384
30350 msgid "swapoff-file"
30351 msgstr ""
30352
30353 # type: verbatim
30354 #. type: verbatim
30355 #: ../fish/guestfish-actions.pod:4386
30356 #, no-wrap
30357 msgid ""
30358 " swapoff-file file\n"
30359 "\n"
30360 msgstr ""
30361
30362 # type: =head2
30363 #. type: =head2
30364 #: ../fish/guestfish-actions.pod:4390
30365 msgid "swapoff-label"
30366 msgstr ""
30367
30368 # type: verbatim
30369 #. type: verbatim
30370 #: ../fish/guestfish-actions.pod:4392
30371 #, no-wrap
30372 msgid ""
30373 " swapoff-label label\n"
30374 "\n"
30375 msgstr ""
30376
30377 # type: =head2
30378 #. type: =head2
30379 #: ../fish/guestfish-actions.pod:4397
30380 msgid "swapoff-uuid"
30381 msgstr ""
30382
30383 # type: verbatim
30384 #. type: verbatim
30385 #: ../fish/guestfish-actions.pod:4399
30386 #, no-wrap
30387 msgid ""
30388 " swapoff-uuid uuid\n"
30389 "\n"
30390 msgstr ""
30391
30392 # type: =head2
30393 #. type: =head2
30394 #: ../fish/guestfish-actions.pod:4404
30395 msgid "swapon-device"
30396 msgstr ""
30397
30398 # type: verbatim
30399 #. type: verbatim
30400 #: ../fish/guestfish-actions.pod:4406
30401 #, no-wrap
30402 msgid ""
30403 " swapon-device device\n"
30404 "\n"
30405 msgstr ""
30406
30407 # type: textblock
30408 #. type: textblock
30409 #: ../fish/guestfish-actions.pod:4408
30410 msgid ""
30411 "This command enables the libguestfs appliance to use the swap device or "
30412 "partition named C<device>.  The increased memory is made available for all "
30413 "commands, for example those run using L</command> or L</sh>."
30414 msgstr ""
30415
30416 # type: =head2
30417 #. type: =head2
30418 #: ../fish/guestfish-actions.pod:4420
30419 msgid "swapon-file"
30420 msgstr ""
30421
30422 # type: verbatim
30423 #. type: verbatim
30424 #: ../fish/guestfish-actions.pod:4422
30425 #, no-wrap
30426 msgid ""
30427 " swapon-file file\n"
30428 "\n"
30429 msgstr ""
30430
30431 # type: textblock
30432 #. type: textblock
30433 #: ../fish/guestfish-actions.pod:4424
30434 msgid ""
30435 "This command enables swap to a file.  See L</swapon-device> for other notes."
30436 msgstr ""
30437
30438 # type: =head2
30439 #. type: =head2
30440 #: ../fish/guestfish-actions.pod:4427
30441 msgid "swapon-label"
30442 msgstr ""
30443
30444 # type: verbatim
30445 #. type: verbatim
30446 #: ../fish/guestfish-actions.pod:4429
30447 #, no-wrap
30448 msgid ""
30449 " swapon-label label\n"
30450 "\n"
30451 msgstr ""
30452
30453 # type: textblock
30454 #. type: textblock
30455 #: ../fish/guestfish-actions.pod:4431
30456 msgid ""
30457 "This command enables swap to a labeled swap partition.  See L</swapon-"
30458 "device> for other notes."
30459 msgstr ""
30460
30461 # type: =head2
30462 #. type: =head2
30463 #: ../fish/guestfish-actions.pod:4434
30464 msgid "swapon-uuid"
30465 msgstr ""
30466
30467 # type: verbatim
30468 #. type: verbatim
30469 #: ../fish/guestfish-actions.pod:4436
30470 #, no-wrap
30471 msgid ""
30472 " swapon-uuid uuid\n"
30473 "\n"
30474 msgstr ""
30475
30476 # type: textblock
30477 #. type: textblock
30478 #: ../fish/guestfish-actions.pod:4438
30479 msgid ""
30480 "This command enables swap to a swap partition with the given UUID.  See L</"
30481 "swapon-device> for other notes."
30482 msgstr ""
30483
30484 # type: =head2
30485 #. type: =head2
30486 #: ../fish/guestfish-actions.pod:4441
30487 msgid "sync"
30488 msgstr ""
30489
30490 # type: verbatim
30491 #. type: verbatim
30492 #: ../fish/guestfish-actions.pod:4443
30493 #, no-wrap
30494 msgid ""
30495 " sync\n"
30496 "\n"
30497 msgstr ""
30498
30499 # type: =head2
30500 #. type: =head2
30501 #: ../fish/guestfish-actions.pod:4451
30502 msgid "tail"
30503 msgstr ""
30504
30505 # type: verbatim
30506 #. type: verbatim
30507 #: ../fish/guestfish-actions.pod:4453
30508 #, no-wrap
30509 msgid ""
30510 " tail path\n"
30511 "\n"
30512 msgstr ""
30513
30514 # type: =head2
30515 #. type: =head2
30516 #: ../fish/guestfish-actions.pod:4461
30517 msgid "tail-n"
30518 msgstr ""
30519
30520 # type: verbatim
30521 #. type: verbatim
30522 #: ../fish/guestfish-actions.pod:4463
30523 #, no-wrap
30524 msgid ""
30525 " tail-n nrlines path\n"
30526 "\n"
30527 msgstr ""
30528
30529 # type: =head2
30530 #. type: =head2
30531 #: ../fish/guestfish-actions.pod:4476
30532 msgid "tar-in"
30533 msgstr ""
30534
30535 # type: verbatim
30536 #. type: verbatim
30537 #: ../fish/guestfish-actions.pod:4478
30538 #, no-wrap
30539 msgid ""
30540 " tar-in (tarfile|-) directory\n"
30541 "\n"
30542 msgstr ""
30543
30544 # type: textblock
30545 #. type: textblock
30546 #: ../fish/guestfish-actions.pod:4483
30547 msgid "To upload a compressed tarball, use L</tgz-in> or L</txz-in>."
30548 msgstr ""
30549
30550 # type: =head2
30551 #. type: =head2
30552 #: ../fish/guestfish-actions.pod:4488
30553 msgid "tar-out"
30554 msgstr ""
30555
30556 # type: verbatim
30557 #. type: verbatim
30558 #: ../fish/guestfish-actions.pod:4490
30559 #, no-wrap
30560 msgid ""
30561 " tar-out directory (tarfile|-)\n"
30562 "\n"
30563 msgstr ""
30564
30565 # type: textblock
30566 #. type: textblock
30567 #: ../fish/guestfish-actions.pod:4495
30568 msgid "To download a compressed tarball, use L</tgz-out> or L</txz-out>."
30569 msgstr ""
30570
30571 # type: =head2
30572 #. type: =head2
30573 #: ../fish/guestfish-actions.pod:4500
30574 msgid "tgz-in"
30575 msgstr ""
30576
30577 # type: verbatim
30578 #. type: verbatim
30579 #: ../fish/guestfish-actions.pod:4502
30580 #, no-wrap
30581 msgid ""
30582 " tgz-in (tarball|-) directory\n"
30583 "\n"
30584 msgstr ""
30585
30586 # type: textblock
30587 #. type: textblock
30588 #: ../fish/guestfish-actions.pod:4507
30589 msgid "To upload an uncompressed tarball, use L</tar-in>."
30590 msgstr ""
30591
30592 # type: =head2
30593 #. type: =head2
30594 #: ../fish/guestfish-actions.pod:4511
30595 msgid "tgz-out"
30596 msgstr ""
30597
30598 # type: verbatim
30599 #. type: verbatim
30600 #: ../fish/guestfish-actions.pod:4513
30601 #, no-wrap
30602 msgid ""
30603 " tgz-out directory (tarball|-)\n"
30604 "\n"
30605 msgstr ""
30606
30607 # type: textblock
30608 #. type: textblock
30609 #: ../fish/guestfish-actions.pod:4518
30610 msgid "To download an uncompressed tarball, use L</tar-out>."
30611 msgstr ""
30612
30613 # type: =head2
30614 #. type: =head2
30615 #: ../fish/guestfish-actions.pod:4522
30616 msgid "touch"
30617 msgstr ""
30618
30619 # type: verbatim
30620 #. type: verbatim
30621 #: ../fish/guestfish-actions.pod:4524
30622 #, no-wrap
30623 msgid ""
30624 " touch path\n"
30625 "\n"
30626 msgstr ""
30627
30628 # type: =head2
30629 #. type: =head2
30630 #: ../fish/guestfish-actions.pod:4533
30631 msgid "truncate"
30632 msgstr ""
30633
30634 # type: verbatim
30635 #. type: verbatim
30636 #: ../fish/guestfish-actions.pod:4535
30637 #, no-wrap
30638 msgid ""
30639 " truncate path\n"
30640 "\n"
30641 msgstr ""
30642
30643 # type: =head2
30644 #. type: =head2
30645 #: ../fish/guestfish-actions.pod:4540
30646 msgid "truncate-size"
30647 msgstr ""
30648
30649 # type: verbatim
30650 #. type: verbatim
30651 #: ../fish/guestfish-actions.pod:4542
30652 #, no-wrap
30653 msgid ""
30654 " truncate-size path size\n"
30655 "\n"
30656 msgstr ""
30657
30658 # type: textblock
30659 #. type: textblock
30660 #: ../fish/guestfish-actions.pod:4547
30661 msgid ""
30662 "If the current file size is less than C<size> then the file is extended to "
30663 "the required size with zero bytes.  This creates a sparse file (ie. disk "
30664 "blocks are not allocated for the file until you write to it).  To create a "
30665 "non-sparse file of zeroes, use L</fallocate64> instead."
30666 msgstr ""
30667
30668 # type: =head2
30669 #. type: =head2
30670 #: ../fish/guestfish-actions.pod:4553
30671 msgid "tune2fs-l"
30672 msgstr ""
30673
30674 # type: verbatim
30675 #. type: verbatim
30676 #: ../fish/guestfish-actions.pod:4555
30677 #, no-wrap
30678 msgid ""
30679 " tune2fs-l device\n"
30680 "\n"
30681 msgstr ""
30682
30683 # type: =head2
30684 #. type: =head2
30685 #: ../fish/guestfish-actions.pod:4565
30686 msgid "txz-in"
30687 msgstr ""
30688
30689 # type: verbatim
30690 #. type: verbatim
30691 #: ../fish/guestfish-actions.pod:4567
30692 #, no-wrap
30693 msgid ""
30694 " txz-in (tarball|-) directory\n"
30695 "\n"
30696 msgstr ""
30697
30698 # type: =head2
30699 #. type: =head2
30700 #: ../fish/guestfish-actions.pod:4574
30701 msgid "txz-out"
30702 msgstr ""
30703
30704 # type: verbatim
30705 #. type: verbatim
30706 #: ../fish/guestfish-actions.pod:4576
30707 #, no-wrap
30708 msgid ""
30709 " txz-out directory (tarball|-)\n"
30710 "\n"
30711 msgstr ""
30712
30713 # type: =head2
30714 #. type: =head2
30715 #: ../fish/guestfish-actions.pod:4583
30716 msgid "umask"
30717 msgstr ""
30718
30719 # type: verbatim
30720 #. type: verbatim
30721 #: ../fish/guestfish-actions.pod:4585
30722 #, no-wrap
30723 msgid ""
30724 " umask mask\n"
30725 "\n"
30726 msgstr ""
30727
30728 # type: textblock
30729 #. type: textblock
30730 #: ../fish/guestfish-actions.pod:4599
30731 msgid "See also L</get-umask>, L<umask(2)>, L</mknod>, L</mkdir>."
30732 msgstr ""
30733
30734 # type: =head2
30735 #. type: =head2
30736 #: ../fish/guestfish-actions.pod:4604
30737 msgid "umount"
30738 msgstr ""
30739
30740 # type: =head2
30741 #. type: =head2
30742 #: ../fish/guestfish-actions.pod:4606
30743 msgid "unmount"
30744 msgstr ""
30745
30746 # type: verbatim
30747 #. type: verbatim
30748 #: ../fish/guestfish-actions.pod:4608
30749 #, no-wrap
30750 msgid ""
30751 " umount pathordevice\n"
30752 "\n"
30753 msgstr ""
30754
30755 # type: =head2
30756 #. type: =head2
30757 #: ../fish/guestfish-actions.pod:4614
30758 msgid "umount-all"
30759 msgstr ""
30760
30761 # type: =head2
30762 #. type: =head2
30763 #: ../fish/guestfish-actions.pod:4616
30764 msgid "unmount-all"
30765 msgstr ""
30766
30767 # type: verbatim
30768 #. type: verbatim
30769 #: ../fish/guestfish-actions.pod:4618
30770 #, no-wrap
30771 msgid ""
30772 " umount-all\n"
30773 "\n"
30774 msgstr ""
30775
30776 # type: =head2
30777 #. type: =head2
30778 #: ../fish/guestfish-actions.pod:4624
30779 msgid "upload"
30780 msgstr ""
30781
30782 # type: verbatim
30783 #. type: verbatim
30784 #: ../fish/guestfish-actions.pod:4626
30785 #, no-wrap
30786 msgid ""
30787 " upload (filename|-) remotefilename\n"
30788 "\n"
30789 msgstr ""
30790
30791 # type: textblock
30792 #. type: textblock
30793 #: ../fish/guestfish-actions.pod:4633
30794 msgid "See also L</download>."
30795 msgstr ""
30796
30797 # type: =head2
30798 #. type: =head2
30799 #: ../fish/guestfish-actions.pod:4637
30800 msgid "upload-offset"
30801 msgstr ""
30802
30803 # type: verbatim
30804 #. type: verbatim
30805 #: ../fish/guestfish-actions.pod:4639
30806 #, no-wrap
30807 msgid ""
30808 " upload-offset (filename|-) remotefilename offset\n"
30809 "\n"
30810 msgstr ""
30811
30812 # type: textblock
30813 #. type: textblock
30814 #: ../fish/guestfish-actions.pod:4651
30815 msgid ""
30816 "Note that there is no limit on the amount of data that can be uploaded with "
30817 "this call, unlike with L</pwrite>, and this call always writes the full "
30818 "amount unless an error occurs."
30819 msgstr ""
30820
30821 # type: textblock
30822 #. type: textblock
30823 #: ../fish/guestfish-actions.pod:4656
30824 msgid "See also L</upload>, L</pwrite>."
30825 msgstr ""
30826
30827 # type: =head2
30828 #. type: =head2
30829 #: ../fish/guestfish-actions.pod:4660
30830 msgid "utimens"
30831 msgstr ""
30832
30833 # type: verbatim
30834 #. type: verbatim
30835 #: ../fish/guestfish-actions.pod:4662
30836 #, no-wrap
30837 msgid ""
30838 " utimens path atsecs atnsecs mtsecs mtnsecs\n"
30839 "\n"
30840 msgstr ""
30841
30842 # type: =head2
30843 #. type: =head2
30844 #: ../fish/guestfish-actions.pod:4681
30845 msgid "version"
30846 msgstr ""
30847
30848 # type: verbatim
30849 #. type: verbatim
30850 #: ../fish/guestfish-actions.pod:4683
30851 #, no-wrap
30852 msgid ""
30853 " version\n"
30854 "\n"
30855 msgstr ""
30856
30857 # type: textblock
30858 #. type: textblock
30859 #: ../fish/guestfish-actions.pod:4710
30860 msgid ""
30861 "I<Note:> Don't use this call to test for availability of features.  In "
30862 "enterprise distributions we backport features from later versions into "
30863 "earlier versions, making this an unreliable way to test for features.  Use "
30864 "L</available> instead."
30865 msgstr ""
30866
30867 # type: =head2
30868 #. type: =head2
30869 #: ../fish/guestfish-actions.pod:4716
30870 msgid "vfs-label"
30871 msgstr ""
30872
30873 # type: verbatim
30874 #. type: verbatim
30875 #: ../fish/guestfish-actions.pod:4718
30876 #, no-wrap
30877 msgid ""
30878 " vfs-label device\n"
30879 "\n"
30880 msgstr ""
30881
30882 # type: textblock
30883 #. type: textblock
30884 #: ../fish/guestfish-actions.pod:4725
30885 msgid "To find a filesystem from the label, use L</findfs-label>."
30886 msgstr ""
30887
30888 # type: =head2
30889 #. type: =head2
30890 #: ../fish/guestfish-actions.pod:4727
30891 msgid "vfs-type"
30892 msgstr ""
30893
30894 # type: verbatim
30895 #. type: verbatim
30896 #: ../fish/guestfish-actions.pod:4729
30897 #, no-wrap
30898 msgid ""
30899 " vfs-type device\n"
30900 "\n"
30901 msgstr ""
30902
30903 # type: =head2
30904 #. type: =head2
30905 #: ../fish/guestfish-actions.pod:4739
30906 msgid "vfs-uuid"
30907 msgstr ""
30908
30909 # type: verbatim
30910 #. type: verbatim
30911 #: ../fish/guestfish-actions.pod:4741
30912 #, no-wrap
30913 msgid ""
30914 " vfs-uuid device\n"
30915 "\n"
30916 msgstr ""
30917
30918 # type: textblock
30919 #. type: textblock
30920 #: ../fish/guestfish-actions.pod:4748
30921 msgid "To find a filesystem from the UUID, use L</findfs-uuid>."
30922 msgstr ""
30923
30924 # type: =head2
30925 #. type: =head2
30926 #: ../fish/guestfish-actions.pod:4750
30927 msgid "vg-activate"
30928 msgstr ""
30929
30930 # type: verbatim
30931 #. type: verbatim
30932 #: ../fish/guestfish-actions.pod:4752
30933 #, no-wrap
30934 msgid ""
30935 " vg-activate true|false 'volgroups ...'\n"
30936 "\n"
30937 msgstr ""
30938
30939 # type: =head2
30940 #. type: =head2
30941 #: ../fish/guestfish-actions.pod:4765
30942 msgid "vg-activate-all"
30943 msgstr ""
30944
30945 # type: verbatim
30946 #. type: verbatim
30947 #: ../fish/guestfish-actions.pod:4767
30948 #, no-wrap
30949 msgid ""
30950 " vg-activate-all true|false\n"
30951 "\n"
30952 msgstr ""
30953
30954 # type: =head2
30955 #. type: =head2
30956 #: ../fish/guestfish-actions.pod:4777
30957 msgid "vgcreate"
30958 msgstr ""
30959
30960 # type: verbatim
30961 #. type: verbatim
30962 #: ../fish/guestfish-actions.pod:4779
30963 #, no-wrap
30964 msgid ""
30965 " vgcreate volgroup 'physvols ...'\n"
30966 "\n"
30967 msgstr ""
30968
30969 # type: =head2
30970 #. type: =head2
30971 #: ../fish/guestfish-actions.pod:4784
30972 msgid "vglvuuids"
30973 msgstr ""
30974
30975 # type: verbatim
30976 #. type: verbatim
30977 #: ../fish/guestfish-actions.pod:4786
30978 #, no-wrap
30979 msgid ""
30980 " vglvuuids vgname\n"
30981 "\n"
30982 msgstr ""
30983
30984 # type: textblock
30985 #. type: textblock
30986 #: ../fish/guestfish-actions.pod:4791
30987 msgid ""
30988 "You can use this along with L</lvs> and L</lvuuid> calls to associate "
30989 "logical volumes and volume groups."
30990 msgstr ""
30991
30992 # type: textblock
30993 #. type: textblock
30994 #: ../fish/guestfish-actions.pod:4794
30995 msgid "See also L</vgpvuuids>."
30996 msgstr ""
30997
30998 # type: =head2
30999 #. type: =head2
31000 #: ../fish/guestfish-actions.pod:4796
31001 msgid "vgpvuuids"
31002 msgstr ""
31003
31004 # type: verbatim
31005 #. type: verbatim
31006 #: ../fish/guestfish-actions.pod:4798
31007 #, no-wrap
31008 msgid ""
31009 " vgpvuuids vgname\n"
31010 "\n"
31011 msgstr ""
31012
31013 # type: textblock
31014 #. type: textblock
31015 #: ../fish/guestfish-actions.pod:4803
31016 msgid ""
31017 "You can use this along with L</pvs> and L</pvuuid> calls to associate "
31018 "physical volumes and volume groups."
31019 msgstr ""
31020
31021 # type: textblock
31022 #. type: textblock
31023 #: ../fish/guestfish-actions.pod:4806
31024 msgid "See also L</vglvuuids>."
31025 msgstr ""
31026
31027 # type: =head2
31028 #. type: =head2
31029 #: ../fish/guestfish-actions.pod:4808
31030 msgid "vgremove"
31031 msgstr ""
31032
31033 # type: verbatim
31034 #. type: verbatim
31035 #: ../fish/guestfish-actions.pod:4810
31036 #, no-wrap
31037 msgid ""
31038 " vgremove vgname\n"
31039 "\n"
31040 msgstr ""
31041
31042 # type: =head2
31043 #. type: =head2
31044 #: ../fish/guestfish-actions.pod:4817
31045 msgid "vgrename"
31046 msgstr ""
31047
31048 # type: verbatim
31049 #. type: verbatim
31050 #: ../fish/guestfish-actions.pod:4819
31051 #, no-wrap
31052 msgid ""
31053 " vgrename volgroup newvolgroup\n"
31054 "\n"
31055 msgstr ""
31056
31057 # type: =head2
31058 #. type: =head2
31059 #: ../fish/guestfish-actions.pod:4823
31060 msgid "vgs"
31061 msgstr ""
31062
31063 # type: verbatim
31064 #. type: verbatim
31065 #: ../fish/guestfish-actions.pod:4825
31066 #, no-wrap
31067 msgid ""
31068 " vgs\n"
31069 "\n"
31070 msgstr ""
31071
31072 # type: textblock
31073 #. type: textblock
31074 #: ../fish/guestfish-actions.pod:4833
31075 msgid "See also L</vgs-full>."
31076 msgstr ""
31077
31078 # type: =head2
31079 #. type: =head2
31080 #: ../fish/guestfish-actions.pod:4835
31081 msgid "vgs-full"
31082 msgstr ""
31083
31084 # type: verbatim
31085 #. type: verbatim
31086 #: ../fish/guestfish-actions.pod:4837
31087 #, no-wrap
31088 msgid ""
31089 " vgs-full\n"
31090 "\n"
31091 msgstr ""
31092
31093 # type: =head2
31094 #. type: =head2
31095 #: ../fish/guestfish-actions.pod:4842
31096 msgid "vgscan"
31097 msgstr ""
31098
31099 # type: verbatim
31100 #. type: verbatim
31101 #: ../fish/guestfish-actions.pod:4844
31102 #, no-wrap
31103 msgid ""
31104 " vgscan\n"
31105 "\n"
31106 msgstr ""
31107
31108 # type: =head2
31109 #. type: =head2
31110 #: ../fish/guestfish-actions.pod:4849
31111 msgid "vguuid"
31112 msgstr ""
31113
31114 # type: verbatim
31115 #. type: verbatim
31116 #: ../fish/guestfish-actions.pod:4851
31117 #, no-wrap
31118 msgid ""
31119 " vguuid vgname\n"
31120 "\n"
31121 msgstr ""
31122
31123 # type: =head2
31124 #. type: =head2
31125 #: ../fish/guestfish-actions.pod:4855
31126 msgid "wc-c"
31127 msgstr ""
31128
31129 # type: verbatim
31130 #. type: verbatim
31131 #: ../fish/guestfish-actions.pod:4857
31132 #, no-wrap
31133 msgid ""
31134 " wc-c path\n"
31135 "\n"
31136 msgstr ""
31137
31138 # type: =head2
31139 #. type: =head2
31140 #: ../fish/guestfish-actions.pod:4862
31141 msgid "wc-l"
31142 msgstr ""
31143
31144 # type: verbatim
31145 #. type: verbatim
31146 #: ../fish/guestfish-actions.pod:4864
31147 #, no-wrap
31148 msgid ""
31149 " wc-l path\n"
31150 "\n"
31151 msgstr ""
31152
31153 # type: =head2
31154 #. type: =head2
31155 #: ../fish/guestfish-actions.pod:4869
31156 msgid "wc-w"
31157 msgstr ""
31158
31159 # type: verbatim
31160 #. type: verbatim
31161 #: ../fish/guestfish-actions.pod:4871
31162 #, no-wrap
31163 msgid ""
31164 " wc-w path\n"
31165 "\n"
31166 msgstr ""
31167
31168 # type: =head2
31169 #. type: =head2
31170 #: ../fish/guestfish-actions.pod:4876
31171 msgid "write"
31172 msgstr ""
31173
31174 # type: verbatim
31175 #. type: verbatim
31176 #: ../fish/guestfish-actions.pod:4878
31177 #, no-wrap
31178 msgid ""
31179 " write path content\n"
31180 "\n"
31181 msgstr ""
31182
31183 # type: =head2
31184 #. type: =head2
31185 #: ../fish/guestfish-actions.pod:4886
31186 msgid "write-file"
31187 msgstr ""
31188
31189 # type: verbatim
31190 #. type: verbatim
31191 #: ../fish/guestfish-actions.pod:4888
31192 #, no-wrap
31193 msgid ""
31194 " write-file path content size\n"
31195 "\n"
31196 msgstr ""
31197
31198 # type: =head2
31199 #. type: =head2
31200 #: ../fish/guestfish-actions.pod:4911
31201 msgid "zegrep"
31202 msgstr ""
31203
31204 # type: verbatim
31205 #. type: verbatim
31206 #: ../fish/guestfish-actions.pod:4913
31207 #, no-wrap
31208 msgid ""
31209 " zegrep regex path\n"
31210 "\n"
31211 msgstr ""
31212
31213 # type: =head2
31214 #. type: =head2
31215 #: ../fish/guestfish-actions.pod:4921
31216 msgid "zegrepi"
31217 msgstr ""
31218
31219 # type: verbatim
31220 #. type: verbatim
31221 #: ../fish/guestfish-actions.pod:4923
31222 #, no-wrap
31223 msgid ""
31224 " zegrepi regex path\n"
31225 "\n"
31226 msgstr ""
31227
31228 # type: =head2
31229 #. type: =head2
31230 #: ../fish/guestfish-actions.pod:4931
31231 msgid "zero"
31232 msgstr ""
31233
31234 # type: verbatim
31235 #. type: verbatim
31236 #: ../fish/guestfish-actions.pod:4933
31237 #, no-wrap
31238 msgid ""
31239 " zero device\n"
31240 "\n"
31241 msgstr ""
31242
31243 # type: textblock
31244 #. type: textblock
31245 #: ../fish/guestfish-actions.pod:4941
31246 msgid "See also: L</zero-device>, L</scrub-device>."
31247 msgstr ""
31248
31249 # type: =head2
31250 #. type: =head2
31251 #: ../fish/guestfish-actions.pod:4943
31252 msgid "zero-device"
31253 msgstr ""
31254
31255 # type: verbatim
31256 #. type: verbatim
31257 #: ../fish/guestfish-actions.pod:4945
31258 #, no-wrap
31259 msgid ""
31260 " zero-device device\n"
31261 "\n"
31262 msgstr ""
31263
31264 # type: textblock
31265 #. type: textblock
31266 #: ../fish/guestfish-actions.pod:4947
31267 msgid ""
31268 "This command writes zeroes over the entire C<device>.  Compare with L</zero> "
31269 "which just zeroes the first few blocks of a device."
31270 msgstr ""
31271
31272 # type: =head2
31273 #. type: =head2
31274 #: ../fish/guestfish-actions.pod:4954
31275 msgid "zerofree"
31276 msgstr ""
31277
31278 # type: verbatim
31279 #. type: verbatim
31280 #: ../fish/guestfish-actions.pod:4956
31281 #, no-wrap
31282 msgid ""
31283 " zerofree device\n"
31284 "\n"
31285 msgstr ""
31286
31287 # type: =head2
31288 #. type: =head2
31289 #: ../fish/guestfish-actions.pod:4969
31290 msgid "zfgrep"
31291 msgstr ""
31292
31293 # type: verbatim
31294 #. type: verbatim
31295 #: ../fish/guestfish-actions.pod:4971
31296 #, no-wrap
31297 msgid ""
31298 " zfgrep pattern path\n"
31299 "\n"
31300 msgstr ""
31301
31302 # type: =head2
31303 #. type: =head2
31304 #: ../fish/guestfish-actions.pod:4979
31305 msgid "zfgrepi"
31306 msgstr ""
31307
31308 # type: verbatim
31309 #. type: verbatim
31310 #: ../fish/guestfish-actions.pod:4981
31311 #, no-wrap
31312 msgid ""
31313 " zfgrepi pattern path\n"
31314 "\n"
31315 msgstr ""
31316
31317 # type: =head2
31318 #. type: =head2
31319 #: ../fish/guestfish-actions.pod:4989
31320 msgid "zfile"
31321 msgstr ""
31322
31323 # type: verbatim
31324 #. type: verbatim
31325 #: ../fish/guestfish-actions.pod:4991
31326 #, no-wrap
31327 msgid ""
31328 " zfile meth path\n"
31329 "\n"
31330 msgstr ""
31331
31332 # type: textblock
31333 #. type: textblock
31334 #: ../fish/guestfish-actions.pod:4998
31335 msgid ""
31336 "Since 1.0.63, use L</file> instead which can now process compressed files."
31337 msgstr ""
31338
31339 # type: =head2
31340 #. type: =head2
31341 #: ../fish/guestfish-actions.pod:5008
31342 msgid "zgrep"
31343 msgstr ""
31344
31345 # type: verbatim
31346 #. type: verbatim
31347 #: ../fish/guestfish-actions.pod:5010
31348 #, no-wrap
31349 msgid ""
31350 " zgrep regex path\n"
31351 "\n"
31352 msgstr ""
31353
31354 # type: =head2
31355 #. type: =head2
31356 #: ../fish/guestfish-actions.pod:5018
31357 msgid "zgrepi"
31358 msgstr ""
31359
31360 # type: verbatim
31361 #. type: verbatim
31362 #: ../fish/guestfish-actions.pod:5020
31363 #, no-wrap
31364 msgid ""
31365 " zgrepi regex path\n"
31366 "\n"
31367 msgstr ""
31368
31369 # type: =head2
31370 #. type: =head2
31371 #: ../fish/guestfish-commands.pod:1
31372 msgid "alloc"
31373 msgstr ""
31374
31375 # type: =head2
31376 #. type: =head2
31377 #: ../fish/guestfish-commands.pod:3
31378 msgid "allocate"
31379 msgstr ""
31380
31381 # type: verbatim
31382 #. type: verbatim
31383 #: ../fish/guestfish-commands.pod:5
31384 #, no-wrap
31385 msgid ""
31386 " alloc filename size\n"
31387 "\n"
31388 msgstr ""
31389
31390 # type: textblock
31391 #. type: textblock
31392 #: ../fish/guestfish-commands.pod:7
31393 msgid ""
31394 "This creates an empty (zeroed) file of the given size, and then adds so it "
31395 "can be further examined."
31396 msgstr ""
31397
31398 # type: textblock
31399 #. type: textblock
31400 #: ../fish/guestfish-commands.pod:10 ../fish/guestfish-commands.pod:168
31401 msgid "For more advanced image creation, see L<qemu-img(1)> utility."
31402 msgstr ""
31403
31404 # type: textblock
31405 #. type: textblock
31406 #: ../fish/guestfish-commands.pod:12 ../fish/guestfish-commands.pod:170
31407 msgid "Size can be specified using standard suffixes, eg. C<1M>."
31408 msgstr ""
31409
31410 # type: textblock
31411 #. type: textblock
31412 #: ../fish/guestfish-commands.pod:14
31413 msgid ""
31414 "To create a sparse file, use L</sparse> instead.  To create a prepared disk "
31415 "image, see L</PREPARED DISK IMAGES>."
31416 msgstr ""
31417
31418 # type: =head2
31419 #. type: =head2
31420 #: ../fish/guestfish-commands.pod:17
31421 msgid "copy-in"
31422 msgstr ""
31423
31424 # type: verbatim
31425 #. type: verbatim
31426 #: ../fish/guestfish-commands.pod:19
31427 #, no-wrap
31428 msgid ""
31429 " copy-in local [local ...] /remotedir\n"
31430 "\n"
31431 msgstr ""
31432
31433 # type: textblock
31434 #. type: textblock
31435 #: ../fish/guestfish-commands.pod:21
31436 msgid ""
31437 "C<copy-in> copies local files or directories recursively into the disk "
31438 "image, placing them in the directory called C</remotedir> (which must "
31439 "exist).  This guestfish meta-command turns into a sequence of L</tar-in> and "
31440 "other commands as necessary."
31441 msgstr ""
31442
31443 # type: textblock
31444 #. type: textblock
31445 #: ../fish/guestfish-commands.pod:26
31446 msgid ""
31447 "Multiple local files and directories can be specified, but the last "
31448 "parameter must always be a remote directory.  Wildcards cannot be used."
31449 msgstr ""
31450
31451 # type: =head2
31452 #. type: =head2
31453 #: ../fish/guestfish-commands.pod:30
31454 msgid "copy-out"
31455 msgstr ""
31456
31457 # type: verbatim
31458 #. type: verbatim
31459 #: ../fish/guestfish-commands.pod:32
31460 #, no-wrap
31461 msgid ""
31462 " copy-out remote [remote ...] localdir\n"
31463 "\n"
31464 msgstr ""
31465
31466 # type: textblock
31467 #. type: textblock
31468 #: ../fish/guestfish-commands.pod:34
31469 msgid ""
31470 "C<copy-out> copies remote files or directories recursively out of the disk "
31471 "image, placing them on the host disk in a local directory called C<localdir> "
31472 "(which must exist).  This guestfish meta-command turns into a sequence of L</"
31473 "download>, L</tar-out> and other commands as necessary."
31474 msgstr ""
31475
31476 # type: textblock
31477 #. type: textblock
31478 #: ../fish/guestfish-commands.pod:40
31479 msgid ""
31480 "Multiple remote files and directories can be specified, but the last "
31481 "parameter must always be a local directory.  To download to the current "
31482 "directory, use C<.> as in:"
31483 msgstr ""
31484
31485 # type: verbatim
31486 #. type: verbatim
31487 #: ../fish/guestfish-commands.pod:44
31488 #, no-wrap
31489 msgid ""
31490 " copy-out /home .\n"
31491 "\n"
31492 msgstr ""
31493
31494 # type: textblock
31495 #. type: textblock
31496 #: ../fish/guestfish-commands.pod:46
31497 msgid ""
31498 "Wildcards cannot be used in the ordinary command, but you can use them with "
31499 "the help of L</glob> like this:"
31500 msgstr ""
31501
31502 # type: verbatim
31503 #. type: verbatim
31504 #: ../fish/guestfish-commands.pod:49
31505 #, no-wrap
31506 msgid ""
31507 " glob copy-out /home/* .\n"
31508 "\n"
31509 msgstr ""
31510
31511 # type: =head2
31512 #. type: =head2
31513 #: ../fish/guestfish-commands.pod:51
31514 msgid "echo"
31515 msgstr ""
31516
31517 # type: verbatim
31518 #. type: verbatim
31519 #: ../fish/guestfish-commands.pod:53
31520 #, no-wrap
31521 msgid ""
31522 " echo [params ...]\n"
31523 "\n"
31524 msgstr ""
31525
31526 # type: textblock
31527 #. type: textblock
31528 #: ../fish/guestfish-commands.pod:55
31529 msgid "This echos the parameters to the terminal."
31530 msgstr ""
31531
31532 # type: =head2
31533 #. type: =head2
31534 #: ../fish/guestfish-commands.pod:57
31535 msgid "edit"
31536 msgstr ""
31537
31538 # type: =head2
31539 #. type: =head2
31540 #: ../fish/guestfish-commands.pod:59
31541 msgid "vi"
31542 msgstr ""
31543
31544 # type: =head2
31545 #. type: =head2
31546 #: ../fish/guestfish-commands.pod:61
31547 msgid "emacs"
31548 msgstr ""
31549
31550 # type: verbatim
31551 #. type: verbatim
31552 #: ../fish/guestfish-commands.pod:63
31553 #, no-wrap
31554 msgid ""
31555 " edit filename\n"
31556 "\n"
31557 msgstr ""
31558
31559 # type: textblock
31560 #. type: textblock
31561 #: ../fish/guestfish-commands.pod:65
31562 msgid ""
31563 "This is used to edit a file.  It downloads the file, edits it locally using "
31564 "your editor, then uploads the result."
31565 msgstr ""
31566
31567 # type: textblock
31568 #. type: textblock
31569 #: ../fish/guestfish-commands.pod:68
31570 msgid ""
31571 "The editor is C<$EDITOR>.  However if you use the alternate commands C<vi> "
31572 "or C<emacs> you will get those corresponding editors."
31573 msgstr ""
31574
31575 # type: =head2
31576 #. type: =head2
31577 #: ../fish/guestfish-commands.pod:72
31578 msgid "glob"
31579 msgstr ""
31580
31581 # type: verbatim
31582 #. type: verbatim
31583 #: ../fish/guestfish-commands.pod:74
31584 #, no-wrap
31585 msgid ""
31586 " glob command args...\n"
31587 "\n"
31588 msgstr ""
31589
31590 # type: textblock
31591 #. type: textblock
31592 #: ../fish/guestfish-commands.pod:76
31593 msgid ""
31594 "Expand wildcards in any paths in the args list, and run C<command> "
31595 "repeatedly on each matching path."
31596 msgstr ""
31597
31598 # type: textblock
31599 #. type: textblock
31600 #: ../fish/guestfish-commands.pod:79
31601 msgid "See L</WILDCARDS AND GLOBBING>."
31602 msgstr ""
31603
31604 # type: =head2
31605 #. type: =head2
31606 #: ../fish/guestfish-commands.pod:81
31607 msgid "hexedit"
31608 msgstr ""
31609
31610 # type: verbatim
31611 #. type: verbatim
31612 #: ../fish/guestfish-commands.pod:83
31613 #, no-wrap
31614 msgid ""
31615 " hexedit <filename|device>\n"
31616 " hexedit <filename|device> <max>\n"
31617 " hexedit <filename|device> <start> <max>\n"
31618 "\n"
31619 msgstr ""
31620
31621 # type: textblock
31622 #. type: textblock
31623 #: ../fish/guestfish-commands.pod:87
31624 msgid ""
31625 "Use hexedit (a hex editor) to edit all or part of a binary file or block "
31626 "device."
31627 msgstr ""
31628
31629 # type: textblock
31630 #. type: textblock
31631 #: ../fish/guestfish-commands.pod:90
31632 msgid ""
31633 "This command works by downloading potentially the whole file or device, "
31634 "editing it locally, then uploading it.  If the file or device is large, you "
31635 "have to specify which part you wish to edit by using C<max> and/or C<start> "
31636 "C<max> parameters.  C<start> and C<max> are specified in bytes, with the "
31637 "usual modifiers allowed such as C<1M> (1 megabyte)."
31638 msgstr ""
31639
31640 # type: textblock
31641 #. type: textblock
31642 #: ../fish/guestfish-commands.pod:97
31643 msgid "For example to edit the first few sectors of a disk you might do:"
31644 msgstr ""
31645
31646 # type: verbatim
31647 #. type: verbatim
31648 #: ../fish/guestfish-commands.pod:100
31649 #, no-wrap
31650 msgid ""
31651 " hexedit /dev/sda 1M\n"
31652 "\n"
31653 msgstr ""
31654
31655 # type: textblock
31656 #. type: textblock
31657 #: ../fish/guestfish-commands.pod:102
31658 msgid ""
31659 "which would allow you to edit anywhere within the first megabyte of the disk."
31660 msgstr ""
31661
31662 # type: textblock
31663 #. type: textblock
31664 #: ../fish/guestfish-commands.pod:105
31665 msgid "To edit the superblock of an ext2 filesystem on C</dev/sda1>, do:"
31666 msgstr ""
31667
31668 # type: verbatim
31669 #. type: verbatim
31670 #: ../fish/guestfish-commands.pod:107
31671 #, no-wrap
31672 msgid ""
31673 " hexedit /dev/sda1 0x400 0x400\n"
31674 "\n"
31675 msgstr ""
31676
31677 # type: textblock
31678 #. type: textblock
31679 #: ../fish/guestfish-commands.pod:109
31680 msgid "(assuming the superblock is in the standard location)."
31681 msgstr ""
31682
31683 # type: textblock
31684 #. type: textblock
31685 #: ../fish/guestfish-commands.pod:111
31686 msgid ""
31687 "This command requires the external L<hexedit(1)> program.  You can specify "
31688 "another program to use by setting the C<HEXEDITOR> environment variable."
31689 msgstr ""
31690
31691 # type: textblock
31692 #. type: textblock
31693 #: ../fish/guestfish-commands.pod:115
31694 msgid "See also L</hexdump>."
31695 msgstr ""
31696
31697 # type: =head2
31698 #. type: =head2
31699 #: ../fish/guestfish-commands.pod:117
31700 msgid "lcd"
31701 msgstr ""
31702
31703 # type: verbatim
31704 #. type: verbatim
31705 #: ../fish/guestfish-commands.pod:119
31706 #, no-wrap
31707 msgid ""
31708 " lcd directory\n"
31709 "\n"
31710 msgstr ""
31711
31712 # type: textblock
31713 #. type: textblock
31714 #: ../fish/guestfish-commands.pod:121
31715 msgid ""
31716 "Change the local directory, ie. the current directory of guestfish itself."
31717 msgstr ""
31718
31719 # type: textblock
31720 #. type: textblock
31721 #: ../fish/guestfish-commands.pod:124
31722 msgid "Note that C<!cd> won't do what you might expect."
31723 msgstr ""
31724
31725 # type: =head2
31726 #. type: =head2
31727 #: ../fish/guestfish-commands.pod:126
31728 msgid "man"
31729 msgstr ""
31730
31731 # type: =head2
31732 #. type: =head2
31733 #: ../fish/guestfish-commands.pod:128
31734 msgid "manual"
31735 msgstr ""
31736
31737 # type: verbatim
31738 #. type: verbatim
31739 #: ../fish/guestfish-commands.pod:130
31740 #, no-wrap
31741 msgid ""
31742 "  man\n"
31743 "\n"
31744 msgstr ""
31745
31746 # type: textblock
31747 #. type: textblock
31748 #: ../fish/guestfish-commands.pod:132
31749 msgid "Opens the manual page for guestfish."
31750 msgstr ""
31751
31752 # type: =head2
31753 #. type: =head2
31754 #: ../fish/guestfish-commands.pod:134
31755 msgid "more"
31756 msgstr ""
31757
31758 # type: =head2
31759 #. type: =head2
31760 #: ../fish/guestfish-commands.pod:136
31761 msgid "less"
31762 msgstr ""
31763
31764 # type: verbatim
31765 #. type: verbatim
31766 #: ../fish/guestfish-commands.pod:138
31767 #, no-wrap
31768 msgid ""
31769 " more filename\n"
31770 "\n"
31771 msgstr ""
31772
31773 # type: verbatim
31774 #. type: verbatim
31775 #: ../fish/guestfish-commands.pod:140
31776 #, no-wrap
31777 msgid ""
31778 " less filename\n"
31779 "\n"
31780 msgstr ""
31781
31782 # type: textblock
31783 #. type: textblock
31784 #: ../fish/guestfish-commands.pod:142
31785 msgid "This is used to view a file."
31786 msgstr ""
31787
31788 # type: textblock
31789 #. type: textblock
31790 #: ../fish/guestfish-commands.pod:144
31791 msgid ""
31792 "The default viewer is C<$PAGER>.  However if you use the alternate command "
31793 "C<less> you will get the C<less> command specifically."
31794 msgstr ""
31795
31796 # type: =head2
31797 #. type: =head2
31798 #: ../fish/guestfish-commands.pod:147
31799 msgid "reopen"
31800 msgstr ""
31801
31802 # type: verbatim
31803 #. type: verbatim
31804 #: ../fish/guestfish-commands.pod:149
31805 #, no-wrap
31806 msgid ""
31807 "  reopen\n"
31808 "\n"
31809 msgstr ""
31810
31811 # type: textblock
31812 #. type: textblock
31813 #: ../fish/guestfish-commands.pod:151
31814 msgid ""
31815 "Close and reopen the libguestfs handle.  It is not necessary to use this "
31816 "normally, because the handle is closed properly when guestfish exits.  "
31817 "However this is occasionally useful for testing."
31818 msgstr ""
31819
31820 # type: =head2
31821 #. type: =head2
31822 #: ../fish/guestfish-commands.pod:155
31823 msgid "sparse"
31824 msgstr ""
31825
31826 # type: verbatim
31827 #. type: verbatim
31828 #: ../fish/guestfish-commands.pod:157
31829 #, no-wrap
31830 msgid ""
31831 " sparse filename size\n"
31832 "\n"
31833 msgstr ""
31834
31835 # type: textblock
31836 #. type: textblock
31837 #: ../fish/guestfish-commands.pod:159
31838 msgid ""
31839 "This creates an empty sparse file of the given size, and then adds so it can "
31840 "be further examined."
31841 msgstr ""
31842
31843 # type: textblock
31844 #. type: textblock
31845 #: ../fish/guestfish-commands.pod:162
31846 msgid ""
31847 "In all respects it works the same as the L</alloc> command, except that the "
31848 "image file is allocated sparsely, which means that disk blocks are not "
31849 "assigned to the file until they are needed.  Sparse disk files only use "
31850 "space when written to, but they are slower and there is a danger you could "
31851 "run out of real disk space during a write operation."
31852 msgstr ""
31853
31854 # type: =head2
31855 #. type: =head2
31856 #: ../fish/guestfish-commands.pod:172
31857 msgid "supported"
31858 msgstr ""
31859
31860 # type: verbatim
31861 #. type: verbatim
31862 #: ../fish/guestfish-commands.pod:174
31863 #, no-wrap
31864 msgid ""
31865 " supported\n"
31866 "\n"
31867 msgstr ""
31868
31869 # type: textblock
31870 #. type: textblock
31871 #: ../fish/guestfish-commands.pod:176
31872 msgid ""
31873 "This command returns a list of the optional groups known to the daemon, and "
31874 "indicates which ones are supported by this build of the libguestfs appliance."
31875 msgstr ""
31876
31877 # type: textblock
31878 #. type: textblock
31879 #: ../fish/guestfish-commands.pod:180
31880 msgid "See also L<guestfs(3)/AVAILABILITY>."
31881 msgstr ""
31882
31883 # type: =head2
31884 #. type: =head2
31885 #: ../fish/guestfish-commands.pod:182
31886 msgid "time"
31887 msgstr ""
31888
31889 # type: verbatim
31890 #. type: verbatim
31891 #: ../fish/guestfish-commands.pod:184
31892 #, no-wrap
31893 msgid ""
31894 " time command args...\n"
31895 "\n"
31896 msgstr ""
31897
31898 # type: textblock
31899 #. type: textblock
31900 #: ../fish/guestfish-commands.pod:186
31901 msgid ""
31902 "Run the command as usual, but print the elapsed time afterwards.  This can "
31903 "be useful for benchmarking operations."
31904 msgstr ""
31905
31906 # type: textblock
31907 #. type: textblock
31908 #: ../test-tool/libguestfs-test-tool.pod:5
31909 msgid "libguestfs-test-tool - End user tests for libguestfs"
31910 msgstr ""
31911
31912 # type: verbatim
31913 #. type: verbatim
31914 #: ../test-tool/libguestfs-test-tool.pod:9
31915 #, no-wrap
31916 msgid ""
31917 " libguestfs-test-tool [--options]\n"
31918 "\n"
31919 msgstr ""
31920
31921 # type: textblock
31922 #. type: textblock
31923 #: ../test-tool/libguestfs-test-tool.pod:13
31924 msgid ""
31925 "libguestfs-test-tool is a test program shipped with libguestfs to end users "
31926 "and developers, to allow them to check basic libguestfs functionality is "
31927 "working.  This is needed because libguestfs occasionally breaks for reasons "
31928 "beyond our control: usually because of changes in the underlying qemu or "
31929 "kernel packages, or the host environment."
31930 msgstr ""
31931
31932 # type: textblock
31933 #. type: textblock
31934 #: ../test-tool/libguestfs-test-tool.pod:20
31935 msgid "If you suspect a problem in libguestfs, then just run:"
31936 msgstr ""
31937
31938 # type: verbatim
31939 #. type: verbatim
31940 #: ../test-tool/libguestfs-test-tool.pod:22
31941 #, no-wrap
31942 msgid ""
31943 " libguestfs-test-tool\n"
31944 "\n"
31945 msgstr ""
31946
31947 # type: textblock
31948 #. type: textblock
31949 #: ../test-tool/libguestfs-test-tool.pod:24
31950 msgid "It will print lots of diagnostic messages."
31951 msgstr ""
31952
31953 # type: textblock
31954 #. type: textblock
31955 #: ../test-tool/libguestfs-test-tool.pod:26
31956 msgid "If it runs to completion successfully, you will see this near the end:"
31957 msgstr ""
31958
31959 # type: verbatim
31960 #. type: verbatim
31961 #: ../test-tool/libguestfs-test-tool.pod:28
31962 #, no-wrap
31963 msgid ""
31964 " ===== TEST FINISHED OK =====\n"
31965 "\n"
31966 msgstr ""
31967
31968 # type: textblock
31969 #. type: textblock
31970 #: ../test-tool/libguestfs-test-tool.pod:30
31971 msgid "and the test tool will exit with code 0."
31972 msgstr ""
31973
31974 # type: textblock
31975 #. type: textblock
31976 #: ../test-tool/libguestfs-test-tool.pod:32
31977 msgid ""
31978 "If it fails (and/or exits with non-zero error code), please paste the "
31979 "B<complete, unedited> output of the test tool into a bug report.  More "
31980 "information about reporting bugs can be found on the L<http://libguestfs.org/"
31981 "> website."
31982 msgstr ""
31983
31984 # type: =item
31985 #. type: =item
31986 #: ../test-tool/libguestfs-test-tool.pod:41
31987 msgid "I<--help>"
31988 msgstr ""
31989
31990 # type: textblock
31991 #. type: textblock
31992 #: ../test-tool/libguestfs-test-tool.pod:43
31993 msgid "Display short usage information and exit."
31994 msgstr ""
31995
31996 # type: =item
31997 #. type: =item
31998 #: ../test-tool/libguestfs-test-tool.pod:45
31999 msgid "I<--qemu qemu_binary>"
32000 msgstr ""
32001
32002 # type: textblock
32003 #. type: textblock
32004 #: ../test-tool/libguestfs-test-tool.pod:47
32005 msgid ""
32006 "If you have downloaded another qemu binary, point this option at the full "
32007 "path of the binary to try it."
32008 msgstr ""
32009
32010 # type: =item
32011 #. type: =item
32012 #: ../test-tool/libguestfs-test-tool.pod:50
32013 msgid "I<--qemudir qemu_source_dir>"
32014 msgstr ""
32015
32016 # type: textblock
32017 #. type: textblock
32018 #: ../test-tool/libguestfs-test-tool.pod:52
32019 msgid ""
32020 "If you have compiled qemu from source, point this option at the source "
32021 "directory to try it."
32022 msgstr ""
32023
32024 # type: =item
32025 #. type: =item
32026 #: ../test-tool/libguestfs-test-tool.pod:55
32027 msgid "I<--timeout N>"
32028 msgstr ""
32029
32030 # type: textblock
32031 #. type: textblock
32032 #: ../test-tool/libguestfs-test-tool.pod:57
32033 msgid ""
32034 "Set the launch timeout to C<N> seconds.  The default is 120 seconds which "
32035 "does not usually need to be adjusted unless your machine is very slow."
32036 msgstr ""
32037
32038 # type: =head1
32039 #. type: =head1
32040 #: ../test-tool/libguestfs-test-tool.pod:63
32041 msgid "TRYING OUT A DIFFERENT VERSION OF QEMU"
32042 msgstr ""
32043
32044 # type: textblock
32045 #. type: textblock
32046 #: ../test-tool/libguestfs-test-tool.pod:65
32047 msgid ""
32048 "If you have compiled another version of qemu from source and would like to "
32049 "try that, then you can use the I<--qemudir> option to point to the qemu "
32050 "source directory."
32051 msgstr ""
32052
32053 # type: textblock
32054 #. type: textblock
32055 #: ../test-tool/libguestfs-test-tool.pod:69
32056 msgid ""
32057 "If you have downloaded a qemu binary from somewhere, use the I<--qemu> "
32058 "option to point to the binary."
32059 msgstr ""
32060
32061 # type: textblock
32062 #. type: textblock
32063 #: ../test-tool/libguestfs-test-tool.pod:72
32064 msgid ""
32065 "When using an alternate qemu with libguestfs, usually you would need to "
32066 "write a qemu wrapper script (see section I<QEMU WRAPPERS> in L<guestfs(3)"
32067 ">).  libguestfs-test-tool writes a temporary qemu wrapper script when you "
32068 "use either of the I<--qemudir> or I<--qemu> options."
32069 msgstr ""
32070
32071 # type: textblock
32072 #. type: textblock
32073 #: ../test-tool/libguestfs-test-tool.pod:79
32074 msgid ""
32075 "libguestfs-test-tool returns I<0> if the tests completed without error, or "
32076 "I<1> if there was an error."
32077 msgstr ""
32078
32079 # type: textblock
32080 #. type: textblock
32081 #: ../test-tool/libguestfs-test-tool.pod:84
32082 msgid ""
32083 "For the full list of environment variables which may affect libguestfs, "
32084 "please see the L<guestfs(3)> manual page."
32085 msgstr ""
32086
32087 # type: textblock
32088 #. type: textblock
32089 #: ../test-tool/libguestfs-test-tool.pod:89
32090 msgid "L<guestfs(3)>, L<http://libguestfs.org/>, L<http://qemu.org/>."
32091 msgstr ""
32092
32093 # type: textblock
32094 #. type: textblock
32095 #: ../fuse/guestmount.pod:5
32096 msgid ""
32097 "guestmount - Mount a guest filesystem on the host using FUSE and libguestfs"
32098 msgstr ""
32099
32100 # type: verbatim
32101 #. type: verbatim
32102 #: ../fuse/guestmount.pod:9
32103 #, no-wrap
32104 msgid ""
32105 " guestmount [--options] -a disk.img -m device [--ro] mountpoint\n"
32106 "\n"
32107 msgstr ""
32108
32109 # type: verbatim
32110 #. type: verbatim
32111 #: ../fuse/guestmount.pod:11
32112 #, no-wrap
32113 msgid ""
32114 " guestmount [--options] -a disk.img -i [--ro] mountpoint\n"
32115 "\n"
32116 msgstr ""
32117
32118 # type: verbatim
32119 #. type: verbatim
32120 #: ../fuse/guestmount.pod:13
32121 #, no-wrap
32122 msgid ""
32123 " guestmount [--options] -d Guest -i [--ro] mountpoint\n"
32124 "\n"
32125 msgstr ""
32126
32127 # type: textblock
32128 #. type: textblock
32129 #: ../fuse/guestmount.pod:17
32130 msgid ""
32131 "You must I<not> use C<guestmount> in read-write mode on live virtual "
32132 "machines.  If you do this, you risk disk corruption in the VM."
32133 msgstr ""
32134
32135 # type: textblock
32136 #. type: textblock
32137 #: ../fuse/guestmount.pod:22
32138 msgid ""
32139 "The guestmount program can be used to mount virtual machine filesystems and "
32140 "other disk images on the host.  It uses libguestfs for access to the guest "
32141 "filesystem, and FUSE (the \"filesystem in userspace\") to make it appear as "
32142 "a mountable device."
32143 msgstr ""
32144
32145 # type: textblock
32146 #. type: textblock
32147 #: ../fuse/guestmount.pod:27
32148 msgid ""
32149 "Along with other options, you have to give at least one device (I<-a> "
32150 "option) or libvirt domain (I<-d> option), and at least one mountpoint (I<-m> "
32151 "option) or use the I<-i> inspection option.  How this works is better "
32152 "explained in the L<guestfish(1)> manual page, or by looking at the examples "
32153 "below."
32154 msgstr ""
32155
32156 # type: textblock
32157 #. type: textblock
32158 #: ../fuse/guestmount.pod:33
32159 msgid ""
32160 "FUSE lets you mount filesystems as non-root.  The mountpoint must be owned "
32161 "by you, and the filesystem will not be visible to any other users unless you "
32162 "make certain global configuration changes to C</etc/fuse.conf>.  To unmount "
32163 "the filesystem, use the C<fusermount -u> command."
32164 msgstr ""
32165
32166 # type: textblock
32167 #. type: textblock
32168 #: ../fuse/guestmount.pod:41
32169 msgid ""
32170 "For a typical Windows guest which has its main filesystem on the first "
32171 "partition:"
32172 msgstr ""
32173
32174 # type: verbatim
32175 #. type: verbatim
32176 #: ../fuse/guestmount.pod:44
32177 #, no-wrap
32178 msgid ""
32179 " guestmount -a windows.img -m /dev/sda1 --ro /mnt\n"
32180 "\n"
32181 msgstr ""
32182
32183 # type: textblock
32184 #. type: textblock
32185 #: ../fuse/guestmount.pod:46
32186 msgid ""
32187 "For a typical Linux guest which has a /boot filesystem on the first "
32188 "partition, and the root filesystem on a logical volume:"
32189 msgstr ""
32190
32191 # type: verbatim
32192 #. type: verbatim
32193 #: ../fuse/guestmount.pod:49
32194 #, no-wrap
32195 msgid ""
32196 " guestmount -a linux.img -m /dev/VG/LV -m /dev/sda1:/boot --ro /mnt\n"
32197 "\n"
32198 msgstr ""
32199
32200 # type: textblock
32201 #. type: textblock
32202 #: ../fuse/guestmount.pod:51
32203 msgid "To get libguestfs to detect guest mountpoints for you:"
32204 msgstr ""
32205
32206 # type: verbatim
32207 #. type: verbatim
32208 #: ../fuse/guestmount.pod:53
32209 #, no-wrap
32210 msgid ""
32211 " guestmount -a guest.img -i --ro /mnt\n"
32212 "\n"
32213 msgstr ""
32214
32215 # type: textblock
32216 #. type: textblock
32217 #: ../fuse/guestmount.pod:55
32218 msgid "For a libvirt guest called \"Guest\" you could do:"
32219 msgstr ""
32220
32221 # type: verbatim
32222 #. type: verbatim
32223 #: ../fuse/guestmount.pod:57
32224 #, no-wrap
32225 msgid ""
32226 " guestmount -d Guest -i --ro /mnt\n"
32227 "\n"
32228 msgstr ""
32229
32230 # type: textblock
32231 #. type: textblock
32232 #: ../fuse/guestmount.pod:59
32233 msgid ""
32234 "If you don't know what filesystems are contained in a guest or disk image, "
32235 "use L<virt-filesystems(1)> first:"
32236 msgstr ""
32237
32238 # type: verbatim
32239 #. type: verbatim
32240 #: ../fuse/guestmount.pod:62
32241 #, no-wrap
32242 msgid ""
32243 " virt-filesystems MyGuest\n"
32244 "\n"
32245 msgstr ""
32246
32247 # type: textblock
32248 #. type: textblock
32249 #: ../fuse/guestmount.pod:64
32250 msgid ""
32251 "If you want to trace the libguestfs calls but without excessive debugging "
32252 "information, we recommend:"
32253 msgstr ""
32254
32255 # type: verbatim
32256 #. type: verbatim
32257 #: ../fuse/guestmount.pod:67
32258 #, no-wrap
32259 msgid ""
32260 " guestmount [...] --trace /mnt\n"
32261 "\n"
32262 msgstr ""
32263
32264 # type: textblock
32265 #. type: textblock
32266 #: ../fuse/guestmount.pod:69
32267 msgid "If you want to debug the program, we recommend:"
32268 msgstr ""
32269
32270 # type: verbatim
32271 #. type: verbatim
32272 #: ../fuse/guestmount.pod:71
32273 #, no-wrap
32274 msgid ""
32275 " guestmount [...] --trace --verbose /mnt\n"
32276 "\n"
32277 msgstr ""
32278
32279 #. type: =head1
32280 #: ../fuse/guestmount.pod:73
32281 msgid "NOTES"
32282 msgstr ""
32283
32284 #. type: =head2
32285 #: ../fuse/guestmount.pod:75
32286 msgid "Other users cannot see the filesystem by default"
32287 msgstr ""
32288
32289 #. type: textblock
32290 #: ../fuse/guestmount.pod:77
32291 msgid ""
32292 "If you mount a filesystem as one user (eg. root), then other users will not "
32293 "be able to see it by default.  The fix is to add the FUSE C<allow_other> "
32294 "option when mounting:"
32295 msgstr ""
32296
32297 #. type: verbatim
32298 #: ../fuse/guestmount.pod:81
32299 #, no-wrap
32300 msgid ""
32301 " sudo guestmount [...] -o allow_other /mnt\n"
32302 "\n"
32303 msgstr ""
32304
32305 # type: =item
32306 #. type: =item
32307 #: ../fuse/guestmount.pod:87
32308 msgid "B<-a image> | B<--add image>"
32309 msgstr ""
32310
32311 # type: textblock
32312 #. type: textblock
32313 #: ../fuse/guestmount.pod:89
32314 msgid "Add a block device or virtual machine image."
32315 msgstr ""
32316
32317 # type: =item
32318 #. type: =item
32319 #: ../fuse/guestmount.pod:94
32320 msgid "B<-c URI> | B<--connect URI>"
32321 msgstr ""
32322
32323 # type: =item
32324 #. type: =item
32325 #: ../fuse/guestmount.pod:100
32326 msgid "B<-d libvirt-domain> | B<--domain libvirt-domain>"
32327 msgstr ""
32328
32329 # type: =item
32330 #. type: =item
32331 #: ../fuse/guestmount.pod:106
32332 msgid "B<--dir-cache-timeout N>"
32333 msgstr ""
32334
32335 # type: textblock
32336 #. type: textblock
32337 #: ../fuse/guestmount.pod:108
32338 msgid ""
32339 "Set the readdir cache timeout to I<N> seconds, the default being 60 "
32340 "seconds.  The readdir cache [actually, there are several semi-independent "
32341 "caches] is populated after a readdir(2) call with the stat and extended "
32342 "attributes of the files in the directory, in anticipation that they will be "
32343 "requested soon after."
32344 msgstr ""
32345
32346 # type: textblock
32347 #. type: textblock
32348 #: ../fuse/guestmount.pod:114
32349 msgid ""
32350 "There is also a different attribute cache implemented by FUSE (see the FUSE "
32351 "option I<-o attr_timeout>), but the FUSE cache does not anticipate future "
32352 "requests, only cache existing ones."
32353 msgstr ""
32354
32355 # type: =item
32356 #. type: =item
32357 #: ../fuse/guestmount.pod:125
32358 msgid "B<--format=raw|qcow2|..> | B<--format>"
32359 msgstr ""
32360
32361 # type: textblock
32362 #. type: textblock
32363 #: ../fuse/guestmount.pod:132
32364 msgid ""
32365 "If you have untrusted raw-format guest disk images, you should use this "
32366 "option to specify the disk format.  This avoids a possible security problem "
32367 "with malicious guests (CVE-2010-3851).  See also L<guestfs(3)/"
32368 "guestfs_add_drive_opts>."
32369 msgstr ""
32370
32371 # type: =item
32372 #. type: =item
32373 #: ../fuse/guestmount.pod:137
32374 msgid "B<--fuse-help>"
32375 msgstr ""
32376
32377 # type: textblock
32378 #. type: textblock
32379 #: ../fuse/guestmount.pod:139
32380 msgid "Display help on special FUSE options (see I<-o> below)."
32381 msgstr ""
32382
32383 # type: textblock
32384 #. type: textblock
32385 #: ../fuse/guestmount.pod:143
32386 msgid "Display brief help and exit."
32387 msgstr ""
32388
32389 # type: =item
32390 #. type: =item
32391 #: ../fuse/guestmount.pod:145
32392 msgid "B<-i> | B<--inspector>"
32393 msgstr ""
32394
32395 # type: textblock
32396 #. type: textblock
32397 #: ../fuse/guestmount.pod:165
32398 msgid ""
32399 "Mount the named partition or logical volume on the given mountpoint B<in the "
32400 "guest> (this has nothing to do with mountpoints in the host)."
32401 msgstr ""
32402
32403 # type: textblock
32404 #. type: textblock
32405 #: ../fuse/guestmount.pod:168
32406 msgid ""
32407 "If the mountpoint is omitted, it defaults to C</>.  You have to mount "
32408 "something on C</>."
32409 msgstr ""
32410
32411 # type: =item
32412 #. type: =item
32413 #: ../fuse/guestmount.pod:181
32414 msgid "B<-n> | B<--no-sync>"
32415 msgstr ""
32416
32417 # type: textblock
32418 #. type: textblock
32419 #: ../fuse/guestmount.pod:183
32420 msgid ""
32421 "By default, we attempt to sync the guest disk when the FUSE mountpoint is "
32422 "unmounted.  If you specify this option, then we don't attempt to sync the "
32423 "disk.  See the discussion of autosync in the L<guestfs(3)> manpage."
32424 msgstr ""
32425
32426 # type: =item
32427 #. type: =item
32428 #: ../fuse/guestmount.pod:188
32429 msgid "B<-o option> | B<--option option>"
32430 msgstr ""
32431
32432 # type: textblock
32433 #. type: textblock
32434 #: ../fuse/guestmount.pod:190
32435 msgid "Pass extra options to FUSE."
32436 msgstr ""
32437
32438 # type: textblock
32439 #. type: textblock
32440 #: ../fuse/guestmount.pod:192
32441 msgid ""
32442 "To get a list of all the extra options supported by FUSE, use the command "
32443 "below.  Note that only the FUSE I<-o> options can be passed, and only some "
32444 "of them are a good idea."
32445 msgstr ""
32446
32447 # type: verbatim
32448 #. type: verbatim
32449 #: ../fuse/guestmount.pod:196
32450 #, no-wrap
32451 msgid ""
32452 " guestmount --fuse-help\n"
32453 "\n"
32454 msgstr ""
32455
32456 # type: textblock
32457 #. type: textblock
32458 #: ../fuse/guestmount.pod:198
32459 msgid "Some potentially useful FUSE options:"
32460 msgstr ""
32461
32462 # type: =item
32463 #. type: =item
32464 #: ../fuse/guestmount.pod:202
32465 msgid "B<-o allow_other>"
32466 msgstr ""
32467
32468 # type: textblock
32469 #. type: textblock
32470 #: ../fuse/guestmount.pod:204
32471 msgid "Allow other users to see the filesystem."
32472 msgstr ""
32473
32474 # type: =item
32475 #. type: =item
32476 #: ../fuse/guestmount.pod:206
32477 msgid "B<-o attr_timeout=N>"
32478 msgstr ""
32479
32480 # type: textblock
32481 #. type: textblock
32482 #: ../fuse/guestmount.pod:208
32483 msgid "Enable attribute caching by FUSE, and set the timeout to I<N> seconds."
32484 msgstr ""
32485
32486 # type: =item
32487 #. type: =item
32488 #: ../fuse/guestmount.pod:210
32489 msgid "B<-o kernel_cache>"
32490 msgstr ""
32491
32492 # type: textblock
32493 #. type: textblock
32494 #: ../fuse/guestmount.pod:212
32495 msgid ""
32496 "Allow the kernel to cache files (reduces the number of reads that have to go "
32497 "through the L<guestfs(3)> API).  This is generally a good idea if you can "
32498 "afford the extra memory usage."
32499 msgstr ""
32500
32501 # type: =item
32502 #. type: =item
32503 #: ../fuse/guestmount.pod:216
32504 msgid "B<-o uid=N> B<-o gid=N>"
32505 msgstr ""
32506
32507 # type: textblock
32508 #. type: textblock
32509 #: ../fuse/guestmount.pod:218
32510 msgid ""
32511 "Use these options to map all UIDs and GIDs inside the guest filesystem to "
32512 "the chosen values."
32513 msgstr ""
32514
32515 # type: =item
32516 #. type: =item
32517 #: ../fuse/guestmount.pod:223
32518 msgid "B<-r> | B<--ro>"
32519 msgstr ""
32520
32521 # type: textblock
32522 #. type: textblock
32523 #: ../fuse/guestmount.pod:225
32524 msgid ""
32525 "Add devices and mount everything read-only.  Also disallow writes and make "
32526 "the disk appear read-only to FUSE."
32527 msgstr ""
32528
32529 # type: textblock
32530 #. type: textblock
32531 #: ../fuse/guestmount.pod:228
32532 msgid ""
32533 "This is highly recommended if you are not going to edit the guest disk.  If "
32534 "the guest is running and this option is I<not> supplied, then there is a "
32535 "strong risk of disk corruption in the guest.  We try to prevent this from "
32536 "happening, but it is not always possible."
32537 msgstr ""
32538
32539 # type: textblock
32540 #. type: textblock
32541 #: ../fuse/guestmount.pod:233
32542 msgid "See also L<guestfish(1)/OPENING DISKS FOR READ AND WRITE>."
32543 msgstr ""
32544
32545 # type: textblock
32546 #. type: textblock
32547 #: ../fuse/guestmount.pod:237
32548 msgid "Enable SELinux support for the guest."
32549 msgstr ""
32550
32551 # type: =item
32552 #. type: =item
32553 #: ../fuse/guestmount.pod:239
32554 msgid "B<-v> | B<--verbose>"
32555 msgstr ""
32556
32557 # type: textblock
32558 #. type: textblock
32559 #: ../fuse/guestmount.pod:241
32560 msgid "Enable verbose messages from underlying libguestfs."
32561 msgstr ""
32562
32563 # type: =item
32564 #. type: =item
32565 #: ../fuse/guestmount.pod:243
32566 msgid "B<-V> | B<--version>"
32567 msgstr ""
32568
32569 # type: textblock
32570 #. type: textblock
32571 #: ../fuse/guestmount.pod:245
32572 msgid "Display the program version and exit."
32573 msgstr ""
32574
32575 # type: =item
32576 #. type: =item
32577 #: ../fuse/guestmount.pod:247
32578 msgid "B<-w> | B<--rw>"
32579 msgstr ""
32580
32581 #. type: textblock
32582 #: ../fuse/guestmount.pod:252 ../fuse/guestmount.pod:273
32583 msgid "See L<guestfish(1)/OPENING DISKS FOR READ AND WRITE>."
32584 msgstr ""
32585
32586 # type: =item
32587 #. type: =item
32588 #: ../fuse/guestmount.pod:254
32589 msgid "B<-x> | B<--trace>"
32590 msgstr ""
32591
32592 # type: textblock
32593 #. type: textblock
32594 #: ../fuse/guestmount.pod:256
32595 msgid "Trace libguestfs calls and entry into each FUSE function."
32596 msgstr ""
32597
32598 # type: textblock
32599 #. type: textblock
32600 #: ../fuse/guestmount.pod:258
32601 msgid "This also stops the daemon from forking into the background."
32602 msgstr ""
32603
32604 # type: textblock
32605 #. type: textblock
32606 #: ../fuse/guestmount.pod:279
32607 msgid ""
32608 "L<guestfish(1)>, L<virt-inspector(1)>, L<virt-cat(1)>, L<virt-edit(1)>, "
32609 "L<virt-tar(1)>, L<guestfs(3)>, L<http://libguestfs.org/>, L<http://fuse.sf."
32610 "net/>."
32611 msgstr ""
32612
32613 # type: textblock
32614 #. type: textblock
32615 #: ../fuse/guestmount.pod:294
32616 msgid "Copyright (C) 2009-2010 Red Hat Inc.  L<http://libguestfs.org/>"
32617 msgstr ""
32618
32619 # type: textblock
32620 #. type: textblock
32621 #: ../tools/virt-edit.pl:34
32622 msgid "virt-edit - Edit a file in a virtual machine"
32623 msgstr ""
32624
32625 # type: verbatim
32626 #. type: verbatim
32627 #: ../tools/virt-edit.pl:38
32628 #, no-wrap
32629 msgid ""
32630 " virt-edit [--options] domname file\n"
32631 "\n"
32632 msgstr ""
32633
32634 # type: verbatim
32635 #. type: verbatim
32636 #: ../tools/virt-edit.pl:40
32637 #, no-wrap
32638 msgid ""
32639 " virt-edit [--options] disk.img [disk.img ...] file\n"
32640 "\n"
32641 msgstr ""
32642
32643 # type: verbatim
32644 #. type: verbatim
32645 #: ../tools/virt-edit.pl:42
32646 #, no-wrap
32647 msgid ""
32648 " virt-edit [domname|disk.img] file -e 'expr'\n"
32649 "\n"
32650 msgstr ""
32651
32652 # type: textblock
32653 #. type: textblock
32654 #: ../tools/virt-edit.pl:46
32655 msgid ""
32656 "You must I<not> use C<virt-edit> on live virtual machines.  If you do this, "
32657 "you risk disk corruption in the VM.  C<virt-edit> tries to stop you from "
32658 "doing this, but doesn't catch all cases."
32659 msgstr ""
32660
32661 # type: textblock
32662 #. type: textblock
32663 #: ../tools/virt-edit.pl:52
32664 msgid ""
32665 "C<virt-edit> is a command line tool to edit C<file> where C<file> exists in "
32666 "the named virtual machine (or disk image)."
32667 msgstr ""
32668
32669 #. type: textblock
32670 #: ../tools/virt-edit.pl:55
32671 msgid "If you want to just view a file, use L<virt-cat(1)>."
32672 msgstr ""
32673
32674 #. type: textblock
32675 #: ../tools/virt-edit.pl:57
32676 msgid ""
32677 "For more complex cases you should look at the L<guestfish(1)> tool (see L</"
32678 "USING GUESTFISH> below)."
32679 msgstr ""
32680
32681 #. type: textblock
32682 #: ../tools/virt-edit.pl:60
32683 msgid ""
32684 "C<virt-edit> cannot be used to create a new file, nor to edit multiple "
32685 "files.  L<guestfish(1)> can do that and much more."
32686 msgstr ""
32687
32688 # type: textblock
32689 #. type: textblock
32690 #: ../tools/virt-edit.pl:65
32691 msgid "Edit the named files interactively:"
32692 msgstr ""
32693
32694 # type: verbatim
32695 #. type: verbatim
32696 #: ../tools/virt-edit.pl:67
32697 #, no-wrap
32698 msgid ""
32699 " virt-edit mydomain /boot/grub/grub.conf\n"
32700 "\n"
32701 msgstr ""
32702
32703 # type: verbatim
32704 #. type: verbatim
32705 #: ../tools/virt-edit.pl:69
32706 #, no-wrap
32707 msgid ""
32708 " virt-edit mydomain /etc/passwd\n"
32709 "\n"
32710 msgstr ""
32711
32712 #. type: textblock
32713 #: ../tools/virt-edit.pl:71
32714 msgid "For Windows guests, some Windows paths are understood:"
32715 msgstr ""
32716
32717 #. type: verbatim
32718 #: ../tools/virt-edit.pl:73
32719 #, no-wrap
32720 msgid ""
32721 " virt-edit mywindomain 'c:\\autoexec.bat'\n"
32722 "\n"
32723 msgstr ""
32724
32725 # type: textblock
32726 #. type: textblock
32727 #: ../tools/virt-edit.pl:75
32728 msgid ""
32729 "You can also edit files non-interactively (see L</NON-INTERACTIVE EDITING> "
32730 "below).  To change the init default level to 5:"
32731 msgstr ""
32732
32733 # type: verbatim
32734 #. type: verbatim
32735 #: ../tools/virt-edit.pl:79
32736 #, no-wrap
32737 msgid ""
32738 " virt-edit mydomain /etc/inittab -e 's/^id:.*/id:5:initdefault:/'\n"
32739 "\n"
32740 msgstr ""
32741
32742 # type: textblock
32743 #. type: textblock
32744 #: ../tools/virt-edit.pl:91 ../tools/virt-win-reg.pl:106
32745 #: ../tools/virt-list-filesystems.pl:63 ../tools/virt-tar.pl:113
32746 #: ../tools/virt-make-fs.pl:163 ../tools/virt-list-partitions.pl:64
32747 msgid "Display brief help."
32748 msgstr ""
32749
32750 # type: textblock
32751 #. type: textblock
32752 #: ../tools/virt-edit.pl:99 ../tools/virt-win-reg.pl:114
32753 #: ../tools/virt-list-filesystems.pl:71 ../tools/virt-tar.pl:121
32754 #: ../tools/virt-make-fs.pl:171 ../tools/virt-list-partitions.pl:72
32755 msgid "Display version number and exit."
32756 msgstr ""
32757
32758 # type: =item
32759 #. type: =item
32760 #: ../tools/virt-edit.pl:105
32761 msgid "B<--backup extension> | B<-b extension>"
32762 msgstr ""
32763
32764 # type: textblock
32765 #. type: textblock
32766 #: ../tools/virt-edit.pl:107
32767 msgid ""
32768 "Create a backup of the original file I<in the guest disk image>.  The backup "
32769 "has the original filename with C<extension> added."
32770 msgstr ""
32771
32772 # type: textblock
32773 #. type: textblock
32774 #: ../tools/virt-edit.pl:110
32775 msgid ""
32776 "Usually the first character of C<extension> would be a dot C<.> so you would "
32777 "write:"
32778 msgstr ""
32779
32780 # type: verbatim
32781 #. type: verbatim
32782 #: ../tools/virt-edit.pl:113
32783 #, no-wrap
32784 msgid ""
32785 " virt-edit -b .orig [etc]\n"
32786 "\n"
32787 msgstr ""
32788
32789 # type: textblock
32790 #. type: textblock
32791 #: ../tools/virt-edit.pl:115
32792 msgid "By default, no backup file is made."
32793 msgstr ""
32794
32795 # type: =item
32796 #. type: =item
32797 #: ../tools/virt-edit.pl:121 ../tools/virt-win-reg.pl:128
32798 #: ../tools/virt-list-filesystems.pl:77 ../tools/virt-tar.pl:127
32799 #: ../tools/virt-list-partitions.pl:78
32800 msgid "B<--connect URI> | B<-c URI>"
32801 msgstr ""
32802
32803 # type: textblock
32804 #. type: textblock
32805 #: ../tools/virt-edit.pl:123 ../tools/virt-win-reg.pl:130
32806 #: ../tools/virt-list-filesystems.pl:79 ../tools/virt-tar.pl:129
32807 #: ../tools/virt-list-partitions.pl:80
32808 msgid ""
32809 "If using libvirt, connect to the given I<URI>.  If omitted, then we connect "
32810 "to the default libvirt hypervisor."
32811 msgstr ""
32812
32813 # type: textblock
32814 #. type: textblock
32815 #: ../tools/virt-edit.pl:126 ../tools/virt-win-reg.pl:133
32816 #: ../tools/virt-list-filesystems.pl:82 ../tools/virt-tar.pl:132
32817 #: ../tools/virt-list-partitions.pl:83
32818 msgid ""
32819 "If you specify guest block devices directly, then libvirt is not used at all."
32820 msgstr ""
32821
32822 # type: =item
32823 #. type: =item
32824 #: ../tools/virt-edit.pl:133 ../tools/virt-win-reg.pl:140
32825 #: ../tools/virt-list-filesystems.pl:89 ../tools/virt-tar.pl:139
32826 #: ../tools/virt-list-partitions.pl:90
32827 msgid "B<--format> raw"
32828 msgstr ""
32829
32830 # type: textblock
32831 #. type: textblock
32832 #: ../tools/virt-edit.pl:135 ../tools/virt-win-reg.pl:142
32833 #: ../tools/virt-list-filesystems.pl:91 ../tools/virt-tar.pl:141
32834 #: ../tools/virt-list-partitions.pl:92
32835 msgid ""
32836 "Specify the format of disk images given on the command line.  If this is "
32837 "omitted then the format is autodetected from the content of the disk image."
32838 msgstr ""
32839
32840 # type: textblock
32841 #. type: textblock
32842 #: ../tools/virt-edit.pl:139 ../tools/virt-win-reg.pl:146
32843 #: ../tools/virt-list-filesystems.pl:95 ../tools/virt-tar.pl:145
32844 #: ../tools/virt-list-partitions.pl:96
32845 msgid ""
32846 "If disk images are requested from libvirt, then this program asks libvirt "
32847 "for this information.  In this case, the value of the format parameter is "
32848 "ignored."
32849 msgstr ""
32850
32851 # type: textblock
32852 #. type: textblock
32853 #: ../tools/virt-edit.pl:143 ../tools/virt-win-reg.pl:150
32854 #: ../tools/virt-list-filesystems.pl:99 ../tools/virt-tar.pl:149
32855 #: ../tools/virt-list-partitions.pl:100
32856 msgid ""
32857 "If working with untrusted raw-format guest disk images, you should ensure "
32858 "the format is always specified."
32859 msgstr ""
32860
32861 # type: =item
32862 #. type: =item
32863 #: ../tools/virt-edit.pl:150
32864 msgid "B<--expr EXPR> | B<-e EXPR>"
32865 msgstr ""
32866
32867 # type: textblock
32868 #. type: textblock
32869 #: ../tools/virt-edit.pl:152
32870 msgid ""
32871 "Instead of launching the external editor, non-interactively apply the Perl "
32872 "expression C<EXPR> to each line in the file.  See L</NON-INTERACTIVE "
32873 "EDITING> below."
32874 msgstr ""
32875
32876 # type: textblock
32877 #. type: textblock
32878 #: ../tools/virt-edit.pl:156
32879 msgid ""
32880 "Be careful to properly quote the expression to prevent it from being altered "
32881 "by the shell."
32882 msgstr ""
32883
32884 # type: =head1
32885 #. type: =head1
32886 #: ../tools/virt-edit.pl:280
32887 msgid "NON-INTERACTIVE EDITING"
32888 msgstr ""
32889
32890 # type: textblock
32891 #. type: textblock
32892 #: ../tools/virt-edit.pl:282
32893 msgid ""
32894 "C<virt-edit> normally calls out to C<$EDITOR> (or vi) so the system "
32895 "administrator can interactively edit the file."
32896 msgstr ""
32897
32898 # type: textblock
32899 #. type: textblock
32900 #: ../tools/virt-edit.pl:285
32901 msgid ""
32902 "There are two ways also to use C<virt-edit> from scripts in order to make "
32903 "automated edits to files.  (Note that although you I<can> use C<virt-edit> "
32904 "like this, it's less error-prone to write scripts directly using the "
32905 "libguestfs API and Augeas for configuration file editing.)"
32906 msgstr ""
32907
32908 # type: textblock
32909 #. type: textblock
32910 #: ../tools/virt-edit.pl:291
32911 msgid ""
32912 "The first method is to temporarily set C<$EDITOR> to any script or program "
32913 "you want to run.  The script is invoked as C<$EDITOR tmpfile> and it should "
32914 "update C<tmpfile> in place however it likes."
32915 msgstr ""
32916
32917 #. type: textblock
32918 #: ../tools/virt-edit.pl:295
32919 msgid ""
32920 "The second method is to use the I<-e> parameter of C<virt-edit> to run a "
32921 "short Perl snippet in the style of L<sed(1)>.  For example to replace all "
32922 "instances of C<foo> with C<bar> in a file:"
32923 msgstr ""
32924
32925 # type: verbatim
32926 #. type: verbatim
32927 #: ../tools/virt-edit.pl:299
32928 #, no-wrap
32929 msgid ""
32930 " virt-edit domname filename -e 's/foo/bar/'\n"
32931 "\n"
32932 msgstr ""
32933
32934 # type: textblock
32935 #. type: textblock
32936 #: ../tools/virt-edit.pl:301
32937 msgid ""
32938 "The full power of Perl regular expressions can be used (see L<perlre(1)>).  "
32939 "For example to delete root's password you could do:"
32940 msgstr ""
32941
32942 # type: verbatim
32943 #. type: verbatim
32944 #: ../tools/virt-edit.pl:304
32945 #, no-wrap
32946 msgid ""
32947 " virt-edit domname /etc/passwd -e 's/^root:.*?:/root::/'\n"
32948 "\n"
32949 msgstr ""
32950
32951 # type: textblock
32952 #. type: textblock
32953 #: ../tools/virt-edit.pl:306
32954 msgid ""
32955 "What really happens is that the snippet is evaluated as a Perl expression "
32956 "for each line of the file.  The line, including the final C<\\n>, is passed "
32957 "in C<$_> and the expression should update C<$_> or leave it unchanged."
32958 msgstr ""
32959
32960 # type: textblock
32961 #. type: textblock
32962 #: ../tools/virt-edit.pl:311
32963 msgid ""
32964 "To delete a line, set C<$_> to the empty string.  For example, to delete the "
32965 "C<apache> user account from the password file you can do:"
32966 msgstr ""
32967
32968 # type: verbatim
32969 #. type: verbatim
32970 #: ../tools/virt-edit.pl:314
32971 #, no-wrap
32972 msgid ""
32973 " virt-edit mydomain /etc/passwd -e '$_ = \"\" if /^apache:/'\n"
32974 "\n"
32975 msgstr ""
32976
32977 # type: textblock
32978 #. type: textblock
32979 #: ../tools/virt-edit.pl:316
32980 msgid ""
32981 "To insert a line, prepend or append it to C<$_>.  However appending lines to "
32982 "the end of the file is rather difficult this way since there is no concept "
32983 "of \"last line of the file\" - your expression just doesn't get called "
32984 "again.  You might want to use the first method (setting C<$EDITOR>) if you "
32985 "want to do this."
32986 msgstr ""
32987
32988 # type: textblock
32989 #. type: textblock
32990 #: ../tools/virt-edit.pl:322
32991 msgid ""
32992 "The variable C<$lineno> contains the current line number.  As is "
32993 "traditional, the first line in the file is number C<1>."
32994 msgstr ""
32995
32996 # type: textblock
32997 #. type: textblock
32998 #: ../tools/virt-edit.pl:325
32999 msgid ""
33000 "The return value from the expression is ignored, but the expression may call "
33001 "C<die> in order to abort the whole program, leaving the original file "
33002 "untouched."
33003 msgstr ""
33004
33005 # type: textblock
33006 #. type: textblock
33007 #: ../tools/virt-edit.pl:329
33008 msgid ""
33009 "Remember when matching the end of a line that C<$_> may contain the final C<"
33010 "\\n>, or (for DOS files) C<\\r\\n>, or if the file does not end with a "
33011 "newline then neither of these.  Thus to match or substitute some text at the "
33012 "end of a line, use this regular expression:"
33013 msgstr ""
33014
33015 # type: verbatim
33016 #. type: verbatim
33017 #: ../tools/virt-edit.pl:334
33018 #, no-wrap
33019 msgid ""
33020 " /some text(\\r?\\n)?$/\n"
33021 "\n"
33022 msgstr ""
33023
33024 # type: textblock
33025 #. type: textblock
33026 #: ../tools/virt-edit.pl:336
33027 msgid ""
33028 "Alternately, use the perl C<chomp> function, being careful not to chomp C<"
33029 "$_> itself (since that would remove all newlines from the file):"
33030 msgstr ""
33031
33032 # type: verbatim
33033 #. type: verbatim
33034 #: ../tools/virt-edit.pl:340
33035 #, no-wrap
33036 msgid ""
33037 " my $m = $_; chomp $m; $m =~ /some text$/\n"
33038 "\n"
33039 msgstr ""
33040
33041 #. type: textblock
33042 #: ../tools/virt-edit.pl:344
33043 msgid ""
33044 "C<virt-edit> has a limited ability to understand Windows drive letters and "
33045 "paths (eg. C<E:\\foo\\bar.txt>)."
33046 msgstr ""
33047
33048 #. type: textblock
33049 #: ../tools/virt-edit.pl:347
33050 msgid "If and only if the guest is running Windows then:"
33051 msgstr ""
33052
33053 #. type: textblock
33054 #: ../tools/virt-edit.pl:353
33055 msgid ""
33056 "Drive letter prefixes like C<C:> are resolved against the Windows Registry "
33057 "to the correct filesystem."
33058 msgstr ""
33059
33060 #. type: textblock
33061 #: ../tools/virt-edit.pl:358
33062 msgid ""
33063 "Any backslash (C<\\>) characters in the path are replaced with forward "
33064 "slashes so that libguestfs can process it."
33065 msgstr ""
33066
33067 #. type: textblock
33068 #: ../tools/virt-edit.pl:363
33069 msgid ""
33070 "The path is resolved case insensitively to locate the file that should be "
33071 "edited."
33072 msgstr ""
33073
33074 #. type: textblock
33075 #: ../tools/virt-edit.pl:368
33076 msgid "There are some known shortcomings:"
33077 msgstr ""
33078
33079 #. type: textblock
33080 #: ../tools/virt-edit.pl:374
33081 msgid "Some NTFS symbolic links may not be followed correctly."
33082 msgstr ""
33083
33084 #. type: textblock
33085 #: ../tools/virt-edit.pl:378
33086 msgid "NTFS junction points that cross filesystems are not followed."
33087 msgstr ""
33088
33089 #. type: =head1
33090 #: ../tools/virt-edit.pl:435
33091 msgid "USING GUESTFISH"
33092 msgstr ""
33093
33094 #. type: textblock
33095 #: ../tools/virt-edit.pl:437
33096 msgid ""
33097 "L<guestfish(1)> is a more powerful, lower level tool which you can use when "
33098 "C<virt-edit> doesn't work."
33099 msgstr ""
33100
33101 #. type: textblock
33102 #: ../tools/virt-edit.pl:440
33103 msgid "Using C<virt-edit> is approximately equivalent to doing:"
33104 msgstr ""
33105
33106 #. type: verbatim
33107 #: ../tools/virt-edit.pl:442
33108 #, no-wrap
33109 msgid ""
33110 " guestfish --rw -i -d domname edit /file\n"
33111 "\n"
33112 msgstr ""
33113
33114 #. type: textblock
33115 #: ../tools/virt-edit.pl:444
33116 msgid ""
33117 "where C<domname> is the name of the libvirt guest, and C</file> is the full "
33118 "path to the file."
33119 msgstr ""
33120
33121 #. type: textblock
33122 #: ../tools/virt-edit.pl:447
33123 msgid ""
33124 "The command above uses libguestfs's guest inspection feature and so does not "
33125 "work on guests that libguestfs cannot inspect, or on things like arbitrary "
33126 "disk images that don't contain guests.  To edit a file on a disk image "
33127 "directly, use:"
33128 msgstr ""
33129
33130 #. type: verbatim
33131 #: ../tools/virt-edit.pl:452
33132 #, no-wrap
33133 msgid ""
33134 " guestfish --rw -a disk.img -m /dev/sda1 edit /file\n"
33135 "\n"
33136 msgstr ""
33137
33138 #. type: textblock
33139 #: ../tools/virt-edit.pl:454
33140 msgid ""
33141 "where C<disk.img> is the disk image, C</dev/sda1> is the filesystem within "
33142 "the disk image to edit, and C</file> is the full path to the file."
33143 msgstr ""
33144
33145 #. type: textblock
33146 #: ../tools/virt-edit.pl:458
33147 msgid ""
33148 "C<virt-edit> cannot create new files.  Use the guestfish commands C<touch>, "
33149 "C<write> or C<upload> instead:"
33150 msgstr ""
33151
33152 #. type: verbatim
33153 #: ../tools/virt-edit.pl:461
33154 #, no-wrap
33155 msgid ""
33156 " guestfish --rw -i -d domname touch /newfile\n"
33157 "\n"
33158 msgstr ""
33159
33160 #. type: verbatim
33161 #: ../tools/virt-edit.pl:463
33162 #, no-wrap
33163 msgid ""
33164 " guestfish --rw -i -d domname write /newfile \"new content\"\n"
33165 "\n"
33166 msgstr ""
33167
33168 #. type: verbatim
33169 #: ../tools/virt-edit.pl:465
33170 #, no-wrap
33171 msgid ""
33172 " guestfish --rw -i -d domname upload localfile /newfile\n"
33173 "\n"
33174 msgstr ""
33175
33176 #. type: textblock
33177 #: ../tools/virt-edit.pl:467
33178 msgid ""
33179 "C<virt-edit> cannot edit multiple files, but guestfish can do it like this:"
33180 msgstr ""
33181
33182 #. type: verbatim
33183 #: ../tools/virt-edit.pl:470
33184 #, no-wrap
33185 msgid ""
33186 " guestfish --rw -i -d domname edit /file1 : edit /file2\n"
33187 "\n"
33188 msgstr ""
33189
33190 # type: =item
33191 #. type: =item
33192 #: ../tools/virt-edit.pl:480
33193 msgid "C<EDITOR>"
33194 msgstr ""
33195
33196 # type: textblock
33197 #. type: textblock
33198 #: ../tools/virt-edit.pl:482
33199 msgid ""
33200 "If set, this string is used as the editor.  It may contain arguments, eg. C<"
33201 "\"emacs -nw\">"
33202 msgstr ""
33203
33204 # type: textblock
33205 #. type: textblock
33206 #: ../tools/virt-edit.pl:485
33207 msgid "If not set, C<vi> is used."
33208 msgstr ""
33209
33210 # type: =head2
33211 #. type: =head1
33212 #: ../tools/virt-edit.pl:489 ../tools/virt-win-reg.pl:559
33213 #: ../tools/virt-list-filesystems.pl:182 ../tools/virt-tar.pl:279
33214 #: ../tools/virt-make-fs.pl:532 ../tools/virt-list-partitions.pl:250
33215 msgid "SHELL QUOTING"
33216 msgstr ""
33217
33218 # type: textblock
33219 #. type: textblock
33220 #: ../tools/virt-edit.pl:491 ../tools/virt-win-reg.pl:567
33221 #: ../tools/virt-list-filesystems.pl:184 ../tools/virt-tar.pl:281
33222 #: ../tools/virt-make-fs.pl:534 ../tools/virt-list-partitions.pl:252
33223 msgid ""
33224 "Libvirt guest names can contain arbitrary characters, some of which have "
33225 "meaning to the shell such as C<#> and space.  You may need to quote or "
33226 "escape these characters on the command line.  See the shell manual page L<sh"
33227 "(1)> for details."
33228 msgstr ""
33229
33230 #. type: textblock
33231 #: ../tools/virt-edit.pl:498
33232 msgid ""
33233 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-copy-in(1)>, L<virt-"
33234 "tar-in(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, "
33235 "L<http://libguestfs.org/>, L<perl(1)>, L<perlre(1)>."
33236 msgstr ""
33237
33238 # type: =head1
33239 #. type: =head1
33240 #: ../tools/virt-edit.pl:510 ../tools/virt-win-reg.pl:598
33241 #: ../tools/virt-list-filesystems.pl:202 ../tools/virt-tar.pl:301
33242 #: ../tools/virt-make-fs.pl:564 ../tools/virt-list-partitions.pl:269
33243 msgid "AUTHOR"
33244 msgstr ""
33245
33246 # type: textblock
33247 #. type: textblock
33248 #: ../tools/virt-edit.pl:512 ../tools/virt-win-reg.pl:600
33249 #: ../tools/virt-list-filesystems.pl:204 ../tools/virt-tar.pl:303
33250 #: ../tools/virt-make-fs.pl:566 ../tools/virt-list-partitions.pl:271
33251 msgid "Richard W.M. Jones L<http://people.redhat.com/~rjones/>"
33252 msgstr ""
33253
33254 #. type: textblock
33255 #: ../tools/virt-edit.pl:516
33256 msgid "Copyright (C) 2009-2011 Red Hat Inc."
33257 msgstr ""
33258
33259 # type: textblock
33260 #. type: textblock
33261 #: ../tools/virt-win-reg.pl:37
33262 msgid ""
33263 "virt-win-reg - Export and merge Windows Registry entries from a Windows guest"
33264 msgstr ""
33265
33266 # type: verbatim
33267 #. type: verbatim
33268 #: ../tools/virt-win-reg.pl:41
33269 #, no-wrap
33270 msgid ""
33271 " virt-win-reg domname 'HKLM\\Path\\To\\Subkey'\n"
33272 "\n"
33273 msgstr ""
33274
33275 # type: verbatim
33276 #. type: verbatim
33277 #: ../tools/virt-win-reg.pl:43
33278 #, no-wrap
33279 msgid ""
33280 " virt-win-reg domname 'HKLM\\Path\\To\\Subkey' name\n"
33281 "\n"
33282 msgstr ""
33283
33284 # type: verbatim
33285 #. type: verbatim
33286 #: ../tools/virt-win-reg.pl:45
33287 #, no-wrap
33288 msgid ""
33289 " virt-win-reg domname 'HKLM\\Path\\To\\Subkey' @\n"
33290 "\n"
33291 msgstr ""
33292
33293 # type: verbatim
33294 #. type: verbatim
33295 #: ../tools/virt-win-reg.pl:47
33296 #, no-wrap
33297 msgid ""
33298 " virt-win-reg --merge domname [input.reg ...]\n"
33299 "\n"
33300 msgstr ""
33301
33302 # type: verbatim
33303 #. type: verbatim
33304 #: ../tools/virt-win-reg.pl:49
33305 #, no-wrap
33306 msgid ""
33307 " virt-win-reg [--options] disk.img ... # instead of domname\n"
33308 "\n"
33309 msgstr ""
33310
33311 #. type: textblock
33312 #: ../tools/virt-win-reg.pl:53
33313 msgid ""
33314 "You must I<not> use C<virt-win-reg> with the I<--merge> option on live "
33315 "virtual machines.  If you do this, you I<will> get irreversible disk "
33316 "corruption in the VM.  C<virt-win-reg> tries to stop you from doing this, "
33317 "but doesn't catch all cases."
33318 msgstr ""
33319
33320 #. type: textblock
33321 #: ../tools/virt-win-reg.pl:58
33322 msgid ""
33323 "Modifying the Windows Registry is an inherently risky operation.  The format "
33324 "is deliberately obscure and undocumented, and Registry changes can leave the "
33325 "system unbootable.  Therefore when using the I<--merge> option, make sure "
33326 "you have a reliable backup first."
33327 msgstr ""
33328
33329 # type: textblock
33330 #. type: textblock
33331 #: ../tools/virt-win-reg.pl:65
33332 msgid ""
33333 "This program can export and merge Windows Registry entries from a Windows "
33334 "guest."
33335 msgstr ""
33336
33337 # type: textblock
33338 #. type: textblock
33339 #: ../tools/virt-win-reg.pl:68
33340 msgid ""
33341 "The first parameter is the libvirt guest name or the raw disk image of a "
33342 "Windows guest."
33343 msgstr ""
33344
33345 #. type: textblock
33346 #: ../tools/virt-win-reg.pl:71
33347 msgid ""
33348 "If I<--merge> is I<not> specified, then the chosen registry key is displayed/"
33349 "exported (recursively).  For example:"
33350 msgstr ""
33351
33352 # type: verbatim
33353 #. type: verbatim
33354 #: ../tools/virt-win-reg.pl:74
33355 #, no-wrap
33356 msgid ""
33357 " $ virt-win-reg Windows7 'HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft'\n"
33358 "\n"
33359 msgstr ""
33360
33361 # type: textblock
33362 #. type: textblock
33363 #: ../tools/virt-win-reg.pl:76
33364 msgid ""
33365 "You can also display single values from within registry keys, for example:"
33366 msgstr ""
33367
33368 # type: verbatim
33369 #. type: verbatim
33370 #: ../tools/virt-win-reg.pl:79
33371 #, no-wrap
33372 msgid ""
33373 " $ cvkey='HKLM\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion'\n"
33374 " $ virt-win-reg Windows7 $cvkey ProductName\n"
33375 " Windows 7 Enterprise\n"
33376 "\n"
33377 msgstr ""
33378
33379 #. type: textblock
33380 #: ../tools/virt-win-reg.pl:83
33381 msgid ""
33382 "With I<--merge>, you can merge a textual regedit file into the Windows "
33383 "Registry:"
33384 msgstr ""
33385
33386 # type: verbatim
33387 #. type: verbatim
33388 #: ../tools/virt-win-reg.pl:86
33389 #, no-wrap
33390 msgid ""
33391 " $ virt-win-reg --merge Windows7 changes.reg\n"
33392 "\n"
33393 msgstr ""
33394
33395 # type: =head2
33396 #. type: =head1
33397 #: ../tools/virt-win-reg.pl:88 ../tools/virt-tar.pl:45
33398 msgid "NOTE"
33399 msgstr ""
33400
33401 # type: textblock
33402 #. type: textblock
33403 #: ../tools/virt-win-reg.pl:90
33404 msgid ""
33405 "This program is only meant for simple access to the registry.  If you want "
33406 "to do complicated things with the registry, we suggest you download the "
33407 "Registry hive files from the guest using L<libguestfs(3)> or L<guestfish(1)> "
33408 "and access them locally, eg. using L<hivex(3)>, L<hivexsh(1)> or "
33409 "L<hivexregedit(1)>."
33410 msgstr ""
33411
33412 # type: =item
33413 #. type: =item
33414 #: ../tools/virt-win-reg.pl:120 ../tools/virt-make-fs.pl:177
33415 msgid "B<--debug>"
33416 msgstr ""
33417
33418 # type: textblock
33419 #. type: textblock
33420 #: ../tools/virt-win-reg.pl:122
33421 msgid "Enable debugging messages."
33422 msgstr ""
33423
33424 # type: =item
33425 #. type: =item
33426 #: ../tools/virt-win-reg.pl:157
33427 msgid "B<--merge>"
33428 msgstr ""
33429
33430 # type: textblock
33431 #. type: textblock
33432 #: ../tools/virt-win-reg.pl:159
33433 msgid ""
33434 "In merge mode, this merges a textual regedit file into the Windows Registry "
33435 "of the virtual machine.  If this flag is I<not> given then virt-win-reg "
33436 "displays or exports Registry entries instead."
33437 msgstr ""
33438
33439 #. type: textblock
33440 #: ../tools/virt-win-reg.pl:163
33441 msgid ""
33442 "Note that I<--merge> is I<unsafe> to use on live virtual machines, and will "
33443 "result in disk corruption.  However exporting (without this flag)  is always "
33444 "safe."
33445 msgstr ""
33446
33447 # type: =item
33448 #. type: =item
33449 #: ../tools/virt-win-reg.pl:171
33450 msgid "B<--encoding> UTF-16LE|ASCII"
33451 msgstr ""
33452
33453 # type: textblock
33454 #. type: textblock
33455 #: ../tools/virt-win-reg.pl:173
33456 msgid ""
33457 "When merging (only), you may need to specify the encoding for strings to be "
33458 "used in the hive file.  This is explained in detail in L<Win::Hivex::Regedit"
33459 "(3)/ENCODING STRINGS>."
33460 msgstr ""
33461
33462 # type: textblock
33463 #. type: textblock
33464 #: ../tools/virt-win-reg.pl:177
33465 msgid ""
33466 "The default is to use UTF-16LE, which should work with recent versions of "
33467 "Windows."
33468 msgstr ""
33469
33470 # type: =head2
33471 #. type: =head1
33472 #: ../tools/virt-win-reg.pl:402
33473 msgid "SUPPORTED SYSTEMS"
33474 msgstr ""
33475
33476 # type: textblock
33477 #. type: textblock
33478 #: ../tools/virt-win-reg.pl:404
33479 msgid ""
33480 "The program currently supports Windows NT-derived guests starting with "
33481 "Windows XP through to at least Windows 7."
33482 msgstr ""
33483
33484 # type: textblock
33485 #. type: textblock
33486 #: ../tools/virt-win-reg.pl:407
33487 msgid ""
33488 "Registry support is done for C<HKEY_LOCAL_MACHINE\\SAM>, C<HKEY_LOCAL_MACHINE"
33489 "\\SECURITY>, C<HKEY_LOCAL_MACHINE\\SOFTWARE>, C<HKEY_LOCAL_MACHINE\\SYSTEM> "
33490 "and C<HKEY_USERS\\.DEFAULT>."
33491 msgstr ""
33492
33493 # type: textblock
33494 #. type: textblock
33495 #: ../tools/virt-win-reg.pl:411
33496 msgid ""
33497 "You can use C<HKLM> as a shorthand for C<HKEY_LOCAL_MACHINE>, and C<HKU> for "
33498 "C<HKEY_USERS>."
33499 msgstr ""
33500
33501 # type: textblock
33502 #. type: textblock
33503 #: ../tools/virt-win-reg.pl:414
33504 msgid ""
33505 "C<HKEY_USERS\\$SID> and C<HKEY_CURRENT_USER> are B<not> supported at this "
33506 "time."
33507 msgstr ""
33508
33509 # type: =head2
33510 #. type: =head1
33511 #: ../tools/virt-win-reg.pl:417
33512 msgid "ENCODING"
33513 msgstr ""
33514
33515 # type: textblock
33516 #. type: textblock
33517 #: ../tools/virt-win-reg.pl:419
33518 msgid ""
33519 "C<virt-win-reg> expects that regedit files have already been reencoded in "
33520 "the local encoding.  Usually on Linux hosts, this means UTF-8 with Unix-"
33521 "style line endings.  Since Windows regedit files are often in UTF-16LE with "
33522 "Windows-style line endings, you may need to reencode the whole file before "
33523 "or after processing."
33524 msgstr ""
33525
33526 #. type: textblock
33527 #: ../tools/virt-win-reg.pl:425
33528 msgid ""
33529 "To reencode a file from Windows format to Linux (before processing it with "
33530 "the I<--merge> option), you would do something like this:"
33531 msgstr ""
33532
33533 # type: verbatim
33534 #. type: verbatim
33535 #: ../tools/virt-win-reg.pl:428
33536 #, no-wrap
33537 msgid ""
33538 " iconv -f utf-16le -t utf-8 < win.reg | dos2unix > linux.reg\n"
33539 "\n"
33540 msgstr ""
33541
33542 # type: textblock
33543 #. type: textblock
33544 #: ../tools/virt-win-reg.pl:430
33545 msgid ""
33546 "To go in the opposite direction, after exporting and before sending the file "
33547 "to a Windows user, do something like this:"
33548 msgstr ""
33549
33550 # type: verbatim
33551 #. type: verbatim
33552 #: ../tools/virt-win-reg.pl:433
33553 #, no-wrap
33554 msgid ""
33555 " unix2dos linux.reg | iconv -f utf-8 -t utf-16le > win.reg\n"
33556 "\n"
33557 msgstr ""
33558
33559 # type: textblock
33560 #. type: textblock
33561 #: ../tools/virt-win-reg.pl:435
33562 msgid "For more information about encoding, see L<Win::Hivex::Regedit(3)>."
33563 msgstr ""
33564
33565 # type: textblock
33566 #. type: textblock
33567 #: ../tools/virt-win-reg.pl:437
33568 msgid ""
33569 "If you are unsure about the current encoding, use the L<file(1)> command.  "
33570 "Recent versions of Windows regedit.exe produce a UTF-16LE file with Windows-"
33571 "style (CRLF) line endings, like this:"
33572 msgstr ""
33573
33574 # type: verbatim
33575 #. type: verbatim
33576 #: ../tools/virt-win-reg.pl:441
33577 #, no-wrap
33578 msgid ""
33579 " $ file software.reg\n"
33580 " software.reg: Little-endian UTF-16 Unicode text, with very long lines,\n"
33581 " with CRLF line terminators\n"
33582 "\n"
33583 msgstr ""
33584
33585 #. type: textblock
33586 #: ../tools/virt-win-reg.pl:445
33587 msgid "This file would need conversion before you could I<--merge> it."
33588 msgstr ""
33589
33590 # type: =head2
33591 #. type: =head1
33592 #: ../tools/virt-win-reg.pl:447
33593 msgid "CurrentControlSet etc."
33594 msgstr ""
33595
33596 # type: textblock
33597 #. type: textblock
33598 #: ../tools/virt-win-reg.pl:449
33599 msgid ""
33600 "Registry keys like C<CurrentControlSet> don't really exist in the Windows "
33601 "Registry at the level of the hive file, and therefore you cannot modify "
33602 "these."
33603 msgstr ""
33604
33605 # type: textblock
33606 #. type: textblock
33607 #: ../tools/virt-win-reg.pl:453
33608 msgid ""
33609 "C<CurrentControlSet> is usually an alias for C<ControlSet001>.  In some "
33610 "circumstances it might refer to another control set.  The way to find out is "
33611 "to look at the C<HKLM\\SYSTEM\\Select> key:"
33612 msgstr ""
33613
33614 # type: verbatim
33615 #. type: verbatim
33616 #: ../tools/virt-win-reg.pl:457
33617 #, no-wrap
33618 msgid ""
33619 " # virt-win-reg WindowsGuest 'HKLM\\SYSTEM\\Select'\n"
33620 " [HKEY_LOCAL_MACHINE\\SYSTEM\\Select]\n"
33621 " \"Current\"=dword:00000001\n"
33622 " \"Default\"=dword:00000001\n"
33623 " \"Failed\"=dword:00000000\n"
33624 " \"LastKnownGood\"=dword:00000002\n"
33625 "\n"
33626 msgstr ""
33627
33628 # type: textblock
33629 #. type: textblock
33630 #: ../tools/virt-win-reg.pl:464
33631 msgid "\"Current\" is the one which Windows will choose when it boots."
33632 msgstr ""
33633
33634 # type: textblock
33635 #. type: textblock
33636 #: ../tools/virt-win-reg.pl:466
33637 msgid ""
33638 "Similarly, other C<Current...> keys in the path may need to be replaced."
33639 msgstr ""
33640
33641 # type: =head1
33642 #. type: =head1
33643 #: ../tools/virt-win-reg.pl:469
33644 msgid "WINDOWS TIPS"
33645 msgstr ""
33646
33647 # type: textblock
33648 #. type: textblock
33649 #: ../tools/virt-win-reg.pl:471
33650 msgid ""
33651 "Note that some of these tips modify the guest disk image.  The guest I<must> "
33652 "be shut off, else you will get disk corruption."
33653 msgstr ""
33654
33655 # type: =head2
33656 #. type: =head2
33657 #: ../tools/virt-win-reg.pl:474
33658 msgid "RUNNING A BATCH SCRIPT WHEN A USER LOGS IN"
33659 msgstr ""
33660
33661 # type: textblock
33662 #. type: textblock
33663 #: ../tools/virt-win-reg.pl:476
33664 msgid ""
33665 "Prepare a DOS batch script, VBScript or executable.  Upload this using "
33666 "L<guestfish(1)>.  For this example the script is called C<test.bat> and it "
33667 "is uploaded into C<C:\\>:"
33668 msgstr ""
33669
33670 # type: verbatim
33671 #. type: verbatim
33672 #: ../tools/virt-win-reg.pl:480
33673 #, no-wrap
33674 msgid ""
33675 " guestfish -i -d WindowsGuest upload test.bat /test.bat\n"
33676 "\n"
33677 msgstr ""
33678
33679 # type: textblock
33680 #. type: textblock
33681 #: ../tools/virt-win-reg.pl:482
33682 msgid "Prepare a regedit file containing the registry change:"
33683 msgstr ""
33684
33685 # type: verbatim
33686 #. type: verbatim
33687 #: ../tools/virt-win-reg.pl:484
33688 #, no-wrap
33689 msgid ""
33690 " cat > test.reg <<'EOF'\n"
33691 " [HKLM\\Software\\Microsoft\\Windows\\CurrentVersion\\RunOnce]\n"
33692 " \"Test\"=\"c:\\\\test.bat\"\n"
33693 " EOF\n"
33694 "\n"
33695 msgstr ""
33696
33697 # type: textblock
33698 #. type: textblock
33699 #: ../tools/virt-win-reg.pl:489
33700 msgid ""
33701 "In this example we use the key C<RunOnce> which means that the script will "
33702 "run precisely once when the first user logs in.  If you want it to run every "
33703 "time a user logs in, replace C<RunOnce> with C<Run>."
33704 msgstr ""
33705
33706 # type: textblock
33707 #. type: textblock
33708 #: ../tools/virt-win-reg.pl:493
33709 msgid "Now update the registry:"
33710 msgstr ""
33711
33712 # type: verbatim
33713 #. type: verbatim
33714 #: ../tools/virt-win-reg.pl:495
33715 #, no-wrap
33716 msgid ""
33717 " virt-win-reg --merge WindowsGuest test.reg\n"
33718 "\n"
33719 msgstr ""
33720
33721 # type: =head2
33722 #. type: =head2
33723 #: ../tools/virt-win-reg.pl:497
33724 msgid "INSTALLING A SERVICE"
33725 msgstr ""
33726
33727 # type: textblock
33728 #. type: textblock
33729 #: ../tools/virt-win-reg.pl:499
33730 msgid ""
33731 "This section assumes you are familiar with Windows services, and you either "
33732 "have a program which handles the Windows Service Control Protocol directly "
33733 "or you want to run any program using a service wrapper like SrvAny or the "
33734 "free RHSrvAny."
33735 msgstr ""
33736
33737 # type: textblock
33738 #. type: textblock
33739 #: ../tools/virt-win-reg.pl:504
33740 msgid ""
33741 "First upload the program and optionally the service wrapper.  In this case "
33742 "the test program is called C<test.exe> and we are using the RHSrvAny wrapper:"
33743 msgstr ""
33744
33745 # type: verbatim
33746 #. type: verbatim
33747 #: ../tools/virt-win-reg.pl:508
33748 #, no-wrap
33749 msgid ""
33750 " guestfish -i -d WindowsGuest <<EOF\n"
33751 "   upload rhsrvany.exe /rhsrvany.exe\n"
33752 "   upload test.exe /test.exe\n"
33753 " EOF\n"
33754 "\n"
33755 msgstr ""
33756
33757 # type: textblock
33758 #. type: textblock
33759 #: ../tools/virt-win-reg.pl:513
33760 msgid ""
33761 "Prepare a regedit file containing the registry changes.  In this example, "
33762 "the first registry change is needed for the service itself or the service "
33763 "wrapper (if used).  The second registry change is only needed because I am "
33764 "using the RHSrvAny service wrapper."
33765 msgstr ""
33766
33767 # type: verbatim
33768 #. type: verbatim
33769 #: ../tools/virt-win-reg.pl:518
33770 #, no-wrap
33771 msgid ""
33772 " cat > service.reg <<'EOF'\n"
33773 " [HKLM\\SYSTEM\\ControlSet001\\services\\RHSrvAny]\n"
33774 " \"Type\"=dword:00000010\n"
33775 " \"Start\"=dword:00000002\n"
33776 " \"ErrorControl\"=dword:00000001\n"
33777 " \"ImagePath\"=\"c:\\\\rhsrvany.exe\"\n"
33778 " \"DisplayName\"=\"RHSrvAny\"\n"
33779 " \"ObjectName\"=\"NetworkService\"\n"
33780 " \n"
33781 msgstr ""
33782
33783 # type: verbatim
33784 #. type: verbatim
33785 #: ../tools/virt-win-reg.pl:527
33786 #, no-wrap
33787 msgid ""
33788 " [HKLM\\SYSTEM\\ControlSet001\\services\\RHSrvAny\\Parameters]\n"
33789 " \"CommandLine\"=\"c:\\\\test.exe\"\n"
33790 " \"PWD\"=\"c:\\\\Temp\"\n"
33791 " EOF\n"
33792 "\n"
33793 msgstr ""
33794
33795 # type: textblock
33796 #. type: textblock
33797 #: ../tools/virt-win-reg.pl:538
33798 msgid ""
33799 "For use of C<ControlSet001> see the section above in this manual page.  You "
33800 "may need to adjust this according to the control set that is in use by the "
33801 "guest."
33802 msgstr ""
33803
33804 # type: textblock
33805 #. type: textblock
33806 #: ../tools/virt-win-reg.pl:544
33807 msgid ""
33808 "C<\"ObjectName\"> controls the privileges that the service will have.  An "
33809 "alternative is C<\"ObjectName\"=\"LocalSystem\"> which would be the most "
33810 "privileged account."
33811 msgstr ""
33812
33813 # type: textblock
33814 #. type: textblock
33815 #: ../tools/virt-win-reg.pl:550
33816 msgid ""
33817 "For the meaning of the magic numbers, see this Microsoft KB article: "
33818 "L<http://support.microsoft.com/kb/103000>."
33819 msgstr ""
33820
33821 # type: textblock
33822 #. type: textblock
33823 #: ../tools/virt-win-reg.pl:555
33824 msgid "Update the registry:"
33825 msgstr ""
33826
33827 # type: verbatim
33828 #. type: verbatim
33829 #: ../tools/virt-win-reg.pl:557
33830 #, no-wrap
33831 msgid ""
33832 " virt-win-reg --merge WindowsGuest service.reg\n"
33833 "\n"
33834 msgstr ""
33835
33836 # type: textblock
33837 #. type: textblock
33838 #: ../tools/virt-win-reg.pl:561
33839 msgid ""
33840 "Be careful when passing parameters containing C<\\> (backslash) in the "
33841 "shell.  Usually you will have to use 'single quotes' or double backslashes "
33842 "(but not both) to protect them from the shell."
33843 msgstr ""
33844
33845 # type: textblock
33846 #. type: textblock
33847 #: ../tools/virt-win-reg.pl:565
33848 msgid "Paths and value names are case-insensitive."
33849 msgstr ""
33850
33851 # type: textblock
33852 #. type: textblock
33853 #: ../tools/virt-win-reg.pl:574
33854 msgid ""
33855 "L<hivex(3)>, L<hivexsh(1)>, L<hivexregedit(1)>, L<guestfs(3)>, L<guestfish(1)"
33856 ">, L<virt-cat(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Win::Hivex"
33857 "(3)>, L<Win::Hivex::Regedit(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
33858 msgstr ""
33859
33860 # type: textblock
33861 #. type: textblock
33862 #: ../tools/virt-win-reg.pl:589 ../tools/virt-make-fs.pl:555
33863 msgid ""
33864 "When reporting bugs, please enable debugging and capture the I<complete> "
33865 "output:"
33866 msgstr ""
33867
33868 # type: verbatim
33869 #. type: verbatim
33870 #: ../tools/virt-win-reg.pl:592
33871 #, no-wrap
33872 msgid ""
33873 " export LIBGUESTFS_DEBUG=1\n"
33874 " virt-win-reg --debug [... rest ...] > /tmp/virt-win-reg.log 2>&1\n"
33875 "\n"
33876 msgstr ""
33877
33878 # type: textblock
33879 #. type: textblock
33880 #: ../tools/virt-win-reg.pl:595
33881 msgid ""
33882 "Attach /tmp/virt-win-reg.log to a new bug report at L<https://bugzilla."
33883 "redhat.com/>"
33884 msgstr ""
33885
33886 # type: textblock
33887 #. type: textblock
33888 #: ../tools/virt-win-reg.pl:604 ../tools/virt-make-fs.pl:570
33889 msgid "Copyright (C) 2010 Red Hat Inc."
33890 msgstr ""
33891
33892 # type: textblock
33893 #. type: textblock
33894 #: ../tools/virt-list-filesystems.pl:32
33895 msgid ""
33896 "virt-list-filesystems - List filesystems in a virtual machine or disk image"
33897 msgstr ""
33898
33899 # type: verbatim
33900 #. type: verbatim
33901 #: ../tools/virt-list-filesystems.pl:36
33902 #, no-wrap
33903 msgid ""
33904 " virt-list-filesystems [--options] domname\n"
33905 "\n"
33906 msgstr ""
33907
33908 # type: verbatim
33909 #. type: verbatim
33910 #: ../tools/virt-list-filesystems.pl:38
33911 #, no-wrap
33912 msgid ""
33913 " virt-list-filesystems [--options] disk.img [disk.img ...]\n"
33914 "\n"
33915 msgstr ""
33916
33917 # type: textblock
33918 #. type: textblock
33919 #: ../tools/virt-list-filesystems.pl:42 ../tools/virt-list-partitions.pl:42
33920 msgid ""
33921 "This tool is obsolete.  Use L<virt-filesystems(1)> as a more flexible "
33922 "replacement."
33923 msgstr ""
33924
33925 # type: textblock
33926 #. type: textblock
33927 #: ../tools/virt-list-filesystems.pl:45
33928 msgid ""
33929 "C<virt-list-filesystems> is a command line tool to list the filesystems that "
33930 "are contained in a virtual machine or disk image."
33931 msgstr ""
33932
33933 # type: textblock
33934 #. type: textblock
33935 #: ../tools/virt-list-filesystems.pl:49
33936 msgid ""
33937 "C<virt-list-filesystems> is just a simple wrapper around L<libguestfs(3)> "
33938 "functionality.  For more complex cases you should look at the L<guestfish(1)"
33939 "> tool."
33940 msgstr ""
33941
33942 # type: =item
33943 #. type: =item
33944 #: ../tools/virt-list-filesystems.pl:106 ../tools/virt-list-partitions.pl:115
33945 msgid "B<-l> | B<--long>"
33946 msgstr ""
33947
33948 # type: textblock
33949 #. type: textblock
33950 #: ../tools/virt-list-filesystems.pl:108
33951 msgid ""
33952 "With this option, C<virt-list-filesystems> displays the type of each "
33953 "filesystem too (where \"type\" means C<ext3>, C<xfs> etc.)"
33954 msgstr ""
33955
33956 # type: =item
33957 #. type: =item
33958 #: ../tools/virt-list-filesystems.pl:115
33959 msgid "B<-a> | B<--all>"
33960 msgstr ""
33961
33962 # type: textblock
33963 #. type: textblock
33964 #: ../tools/virt-list-filesystems.pl:117
33965 msgid ""
33966 "Normally we only show mountable filesystems.  If this option is given then "
33967 "swap devices are shown too."
33968 msgstr ""
33969
33970 # type: textblock
33971 #. type: textblock
33972 #: ../tools/virt-list-filesystems.pl:191
33973 msgid ""
33974 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-tar(1)>, L<virt-"
33975 "filesystems(1)>, L<virt-list-partitions(1)>, L<Sys::Guestfs(3)>, L<Sys::"
33976 "Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
33977 msgstr ""
33978
33979 # type: textblock
33980 #. type: textblock
33981 #: ../tools/virt-list-filesystems.pl:208 ../tools/virt-tar.pl:307
33982 msgid "Copyright (C) 2009 Red Hat Inc."
33983 msgstr ""
33984
33985 # type: textblock
33986 #. type: textblock
33987 #: ../tools/virt-tar.pl:33
33988 msgid "virt-tar - Extract or upload files to a virtual machine"
33989 msgstr ""
33990
33991 # type: verbatim
33992 #. type: verbatim
33993 #: ../tools/virt-tar.pl:37
33994 #, no-wrap
33995 msgid ""
33996 " virt-tar [--options] -x domname directory tarball\n"
33997 "\n"
33998 msgstr ""
33999
34000 # type: verbatim
34001 #. type: verbatim
34002 #: ../tools/virt-tar.pl:39
34003 #, no-wrap
34004 msgid ""
34005 " virt-tar [--options] -u domname tarball directory\n"
34006 "\n"
34007 msgstr ""
34008
34009 # type: verbatim
34010 #. type: verbatim
34011 #: ../tools/virt-tar.pl:41
34012 #, no-wrap
34013 msgid ""
34014 " virt-tar [--options] disk.img [disk.img ...] -x directory tarball\n"
34015 "\n"
34016 msgstr ""
34017
34018 # type: verbatim
34019 #. type: verbatim
34020 #: ../tools/virt-tar.pl:43
34021 #, no-wrap
34022 msgid ""
34023 " virt-tar [--options] disk.img [disk.img ...] -u tarball directory\n"
34024 "\n"
34025 msgstr ""
34026
34027 #. type: textblock
34028 #: ../tools/virt-tar.pl:47
34029 msgid ""
34030 "This tool is obsolete.  Use L<virt-copy-in(1)>, L<virt-copy-out(1)>, L<virt-"
34031 "tar-in(1)>, L<virt-tar-out(1)> as replacements."
34032 msgstr ""
34033
34034 # type: textblock
34035 #. type: textblock
34036 #: ../tools/virt-tar.pl:52
34037 msgid "Download C</home> from the VM into a local tarball:"
34038 msgstr ""
34039
34040 # type: verbatim
34041 #. type: verbatim
34042 #: ../tools/virt-tar.pl:54
34043 #, no-wrap
34044 msgid ""
34045 " virt-tar -x domname /home home.tar\n"
34046 "\n"
34047 msgstr ""
34048
34049 # type: verbatim
34050 #. type: verbatim
34051 #: ../tools/virt-tar.pl:56
34052 #, no-wrap
34053 msgid ""
34054 " virt-tar -zx domname /home home.tar.gz\n"
34055 "\n"
34056 msgstr ""
34057
34058 # type: textblock
34059 #. type: textblock
34060 #: ../tools/virt-tar.pl:58
34061 msgid "Upload a local tarball and unpack it inside C</tmp> in the VM:"
34062 msgstr ""
34063
34064 # type: verbatim
34065 #. type: verbatim
34066 #: ../tools/virt-tar.pl:60
34067 #, no-wrap
34068 msgid ""
34069 " virt-tar -u domname uploadstuff.tar /tmp\n"
34070 "\n"
34071 msgstr ""
34072
34073 # type: verbatim
34074 #. type: verbatim
34075 #: ../tools/virt-tar.pl:62
34076 #, no-wrap
34077 msgid ""
34078 " virt-tar -zu domname uploadstuff.tar.gz /tmp\n"
34079 "\n"
34080 msgstr ""
34081
34082 #. type: textblock
34083 #: ../tools/virt-tar.pl:66
34084 msgid ""
34085 "You must I<not> use C<virt-tar> with the I<-u> option (upload) on live "
34086 "virtual machines.  If you do this, you risk disk corruption in the VM.  "
34087 "C<virt-tar> tries to stop you from doing this, but doesn't catch all cases."
34088 msgstr ""
34089
34090 #. type: textblock
34091 #: ../tools/virt-tar.pl:71
34092 msgid ""
34093 "You can use I<-x> (extract) on live virtual machines, but you might get "
34094 "inconsistent results or errors if there is filesystem activity inside the "
34095 "VM.  If the live VM is synched and quiescent, then C<virt-tar> will usually "
34096 "work, but the only way to guarantee consistent results is if the virtual "
34097 "machine is shut down."
34098 msgstr ""
34099
34100 # type: textblock
34101 #. type: textblock
34102 #: ../tools/virt-tar.pl:79
34103 msgid ""
34104 "C<virt-tar> is a general purpose archive tool for downloading and uploading "
34105 "parts of a guest filesystem.  There are many possibilities: making backups, "
34106 "uploading data files, snooping on guest activity, fixing or customizing "
34107 "guests, etc."
34108 msgstr ""
34109
34110 # type: textblock
34111 #. type: textblock
34112 #: ../tools/virt-tar.pl:84
34113 msgid ""
34114 "If you want to just view a single file, use L<virt-cat(1)>.  If you just "
34115 "want to edit a single file, use L<virt-edit(1)>.  For more complex cases you "
34116 "should look at the L<guestfish(1)> tool."
34117 msgstr ""
34118
34119 #. type: textblock
34120 #: ../tools/virt-tar.pl:88
34121 msgid ""
34122 "There are two modes of operation: I<-x> (eXtract) downloads a directory and "
34123 "its contents (recursively) from the virtual machine into a local tarball.  "
34124 "I<-u> uploads from a local tarball, unpacking it into a directory inside the "
34125 "virtual machine.  You cannot use these two options together."
34126 msgstr ""
34127
34128 #. type: textblock
34129 #: ../tools/virt-tar.pl:94
34130 msgid ""
34131 "In addition, you may need to use the I<-z> (gZip) option to enable "
34132 "compression.  When uploading, you have to specify I<-z> if the upload file "
34133 "is compressed because virt-tar won't detect this on its own."
34134 msgstr ""
34135
34136 # type: textblock
34137 #. type: textblock
34138 #: ../tools/virt-tar.pl:98
34139 msgid ""
34140 "C<virt-tar> can only handle tar (optionally gzipped) format tarballs.  For "
34141 "example it cannot do PKZip files or bzip2 compression.  If you want that "
34142 "then you'll have to rebuild the tarballs yourself.  (This is a limitation of "
34143 "the L<libguestfs(3)> API)."
34144 msgstr ""
34145
34146 # type: =item
34147 #. type: =item
34148 #: ../tools/virt-tar.pl:156
34149 msgid "B<-x> | B<--extract> | B<--download>"
34150 msgstr ""
34151
34152 # type: =item
34153 #. type: =item
34154 #: ../tools/virt-tar.pl:158
34155 msgid "B<-u> | B<--upload>"
34156 msgstr ""
34157
34158 #. type: textblock
34159 #: ../tools/virt-tar.pl:160
34160 msgid ""
34161 "Use I<-x> to extract (download) a directory from a virtual machine to a "
34162 "local tarball."
34163 msgstr ""
34164
34165 #. type: textblock
34166 #: ../tools/virt-tar.pl:163
34167 msgid ""
34168 "Use I<-u> to upload and unpack from a local tarball into a virtual machine.  "
34169 "Please read the L</WARNING> section above before using this option."
34170 msgstr ""
34171
34172 # type: textblock
34173 #. type: textblock
34174 #: ../tools/virt-tar.pl:167
34175 msgid "You must specify exactly one of these options."
34176 msgstr ""
34177
34178 # type: =item
34179 #. type: =item
34180 #: ../tools/virt-tar.pl:173
34181 msgid "B<-z> | B<--gzip>"
34182 msgstr ""
34183
34184 # type: textblock
34185 #. type: textblock
34186 #: ../tools/virt-tar.pl:175
34187 msgid "Specify that the input or output tarball is gzip-compressed."
34188 msgstr ""
34189
34190 #. type: textblock
34191 #: ../tools/virt-tar.pl:288
34192 msgid ""
34193 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-edit(1)>, L<virt-copy-"
34194 "in(1)>, L<virt-copy-out(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>, L<Sys::"
34195 "Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs."
34196 "org/>."
34197 msgstr ""
34198
34199 # type: textblock
34200 #. type: textblock
34201 #: ../tools/virt-make-fs.pl:37
34202 msgid "virt-make-fs - Make a filesystem from a tar archive or files"
34203 msgstr ""
34204
34205 # type: verbatim
34206 #. type: verbatim
34207 #: ../tools/virt-make-fs.pl:41
34208 #, no-wrap
34209 msgid ""
34210 " virt-make-fs [--options] input.tar output.img\n"
34211 "\n"
34212 msgstr ""
34213
34214 # type: verbatim
34215 #. type: verbatim
34216 #: ../tools/virt-make-fs.pl:43
34217 #, no-wrap
34218 msgid ""
34219 " virt-make-fs [--options] input.tar.gz output.img\n"
34220 "\n"
34221 msgstr ""
34222
34223 # type: verbatim
34224 #. type: verbatim
34225 #: ../tools/virt-make-fs.pl:45
34226 #, no-wrap
34227 msgid ""
34228 " virt-make-fs [--options] directory output.img\n"
34229 "\n"
34230 msgstr ""
34231
34232 # type: textblock
34233 #. type: textblock
34234 #: ../tools/virt-make-fs.pl:49
34235 msgid ""
34236 "Virt-make-fs is a command line tool for creating a filesystem from a tar "
34237 "archive or some files in a directory.  It is similar to tools like L<mkisofs"
34238 "(1)>, L<genisoimage(1)> and L<mksquashfs(1)>.  Unlike those tools, it can "
34239 "create common filesystem types like ext2/3 or NTFS, which can be useful if "
34240 "you want to attach these filesystems to existing virtual machines (eg. to "
34241 "import large amounts of read-only data to a VM)."
34242 msgstr ""
34243
34244 # type: textblock
34245 #. type: textblock
34246 #: ../tools/virt-make-fs.pl:57
34247 msgid "Basic usage is:"
34248 msgstr ""
34249
34250 # type: verbatim
34251 #. type: verbatim
34252 #: ../tools/virt-make-fs.pl:59
34253 #, no-wrap
34254 msgid ""
34255 " virt-make-fs input output\n"
34256 "\n"
34257 msgstr ""
34258
34259 # type: textblock
34260 #. type: textblock
34261 #: ../tools/virt-make-fs.pl:61
34262 msgid ""
34263 "where C<input> is either a directory containing files that you want to add, "
34264 "or a tar archive (either uncompressed tar or gzip-compressed tar); and "
34265 "C<output> is a disk image.  The input type is detected automatically.  The "
34266 "output disk image defaults to a raw ext2 image unless you specify extra "
34267 "flags (see L</OPTIONS> below)."
34268 msgstr ""
34269
34270 # type: =head2
34271 #. type: =head2
34272 #: ../tools/virt-make-fs.pl:67
34273 msgid "EXTRA SPACE"
34274 msgstr ""
34275
34276 #. type: textblock
34277 #: ../tools/virt-make-fs.pl:69
34278 msgid ""
34279 "Unlike formats such as tar and squashfs, a filesystem does not \"just fit\" "
34280 "the files that it contains, but might have extra space.  Depending on how "
34281 "you are going to use the output, you might think this extra space is wasted "
34282 "and want to minimize it, or you might want to leave space so that more files "
34283 "can be added later.  Virt-make-fs defaults to minimizing the extra space, "
34284 "but you can use the I<--size> flag to leave space in the filesystem if you "
34285 "want it."
34286 msgstr ""
34287
34288 #. type: textblock
34289 #: ../tools/virt-make-fs.pl:77
34290 msgid ""
34291 "An alternative way to leave extra space but not make the output image any "
34292 "bigger is to use an alternative disk image format (instead of the default "
34293 "\"raw\" format).  Using I<--format=qcow2> will use the native QEmu/KVM qcow2 "
34294 "image format (check your hypervisor supports this before using it).  This "
34295 "allows you to choose a large I<--size> but the extra space won't actually be "
34296 "allocated in the image until you try to store something in it."
34297 msgstr ""
34298
34299 #. type: textblock
34300 #: ../tools/virt-make-fs.pl:85
34301 msgid ""
34302 "Don't forget that you can also use local commands including L<resize2fs(8)> "
34303 "and L<virt-resize(1)> to resize existing filesystems, or rerun virt-make-fs "
34304 "to build another image from scratch."
34305 msgstr ""
34306
34307 # type: =head3
34308 #. type: =head3
34309 #: ../tools/virt-make-fs.pl:89 ../tools/virt-make-fs.pl:123
34310 #: ../tools/virt-make-fs.pl:142
34311 msgid "EXAMPLE"
34312 msgstr ""
34313
34314 # type: verbatim
34315 #. type: verbatim
34316 #: ../tools/virt-make-fs.pl:91
34317 #, no-wrap
34318 msgid ""
34319 " virt-make-fs --format=qcow2 --size=+200M input output.img\n"
34320 "\n"
34321 msgstr ""
34322
34323 # type: =head2
34324 #. type: =head2
34325 #: ../tools/virt-make-fs.pl:93
34326 msgid "FILESYSTEM TYPE"
34327 msgstr ""
34328
34329 # type: textblock
34330 #. type: textblock
34331 #: ../tools/virt-make-fs.pl:95
34332 msgid ""
34333 "The default filesystem type is C<ext2>.  Just about any filesystem type that "
34334 "libguestfs supports can be used (but I<not> read-only formats like "
34335 "ISO9660).  Here are some of the more common choices:"
34336 msgstr ""
34337
34338 # type: =item
34339 #. type: =item
34340 #: ../tools/virt-make-fs.pl:101
34341 msgid "I<ext3>"
34342 msgstr ""
34343
34344 # type: textblock
34345 #. type: textblock
34346 #: ../tools/virt-make-fs.pl:103
34347 msgid ""
34348 "Note that ext3 filesystems contain a journal, typically 1-32 MB in size.  If "
34349 "you are not going to use the filesystem in a way that requires the journal, "
34350 "then this is just wasted overhead."
34351 msgstr ""
34352
34353 # type: =item
34354 #. type: =item
34355 #: ../tools/virt-make-fs.pl:107
34356 msgid "I<ntfs> or I<vfat>"
34357 msgstr ""
34358
34359 # type: textblock
34360 #. type: textblock
34361 #: ../tools/virt-make-fs.pl:109
34362 msgid "Useful if exporting data to a Windows guest."
34363 msgstr ""
34364
34365 # type: textblock
34366 #. type: textblock
34367 #: ../tools/virt-make-fs.pl:111
34368 msgid ""
34369 "I<Note for vfat>: The tar archive or local directory must only contain files "
34370 "which are owned by root (ie. UID:GID = 0:0).  The reason is that the tar "
34371 "program running within libguestfs is unable to change the ownership of non-"
34372 "root files, since vfat itself does not support this."
34373 msgstr ""
34374
34375 # type: =item
34376 #. type: =item
34377 #: ../tools/virt-make-fs.pl:116
34378 msgid "I<minix>"
34379 msgstr ""
34380
34381 # type: textblock
34382 #. type: textblock
34383 #: ../tools/virt-make-fs.pl:118
34384 msgid ""
34385 "Lower overhead than C<ext2>, but certain limitations on filename length and "
34386 "total filesystem size."
34387 msgstr ""
34388
34389 # type: verbatim
34390 #. type: verbatim
34391 #: ../tools/virt-make-fs.pl:125
34392 #, no-wrap
34393 msgid ""
34394 " virt-make-fs --type=minix input minixfs.img\n"
34395 "\n"
34396 msgstr ""
34397
34398 # type: =head2
34399 #. type: =head2
34400 #: ../tools/virt-make-fs.pl:127
34401 msgid "TO PARTITION OR NOT TO PARTITION"
34402 msgstr ""
34403
34404 # type: textblock
34405 #. type: textblock
34406 #: ../tools/virt-make-fs.pl:129
34407 msgid "Optionally virt-make-fs can add a partition table to the output disk."
34408 msgstr ""
34409
34410 # type: textblock
34411 #. type: textblock
34412 #: ../tools/virt-make-fs.pl:131
34413 msgid ""
34414 "Adding a partition can make the disk image more compatible with certain "
34415 "virtualized operating systems which don't expect to see a filesystem "
34416 "directly located on a block device (Linux doesn't care and will happily "
34417 "handle both types)."
34418 msgstr ""
34419
34420 # type: textblock
34421 #. type: textblock
34422 #: ../tools/virt-make-fs.pl:136
34423 msgid ""
34424 "On the other hand, if you have a partition table then the output image is no "
34425 "longer a straight filesystem.  For example you cannot run L<fsck(8)> "
34426 "directly on a partitioned disk image.  (However libguestfs tools such as "
34427 "L<guestfish(1)> and L<virt-resize(1)> can still be used)."
34428 msgstr ""
34429
34430 # type: textblock
34431 #. type: textblock
34432 #: ../tools/virt-make-fs.pl:144
34433 msgid "Add an MBR partition:"
34434 msgstr ""
34435
34436 # type: verbatim
34437 #. type: verbatim
34438 #: ../tools/virt-make-fs.pl:146
34439 #, no-wrap
34440 msgid ""
34441 " virt-make-fs --partition -- input disk.img\n"
34442 "\n"
34443 msgstr ""
34444
34445 # type: textblock
34446 #. type: textblock
34447 #: ../tools/virt-make-fs.pl:148
34448 msgid ""
34449 "If the output disk image could be terabyte-sized or larger, it's better to "
34450 "use an EFI/GPT-compatible partition table:"
34451 msgstr ""
34452
34453 # type: verbatim
34454 #. type: verbatim
34455 #: ../tools/virt-make-fs.pl:151
34456 #, no-wrap
34457 msgid ""
34458 " virt-make-fs --partition=gpt --size=+4T --format=qcow2 input disk.img\n"
34459 "\n"
34460 msgstr ""
34461
34462 # type: textblock
34463 #. type: textblock
34464 #: ../tools/virt-make-fs.pl:179
34465 msgid "Enable debugging information."
34466 msgstr ""
34467
34468 # type: =item
34469 #. type: =item
34470 #: ../tools/virt-make-fs.pl:185
34471 msgid "B<--size=E<lt>NE<gt>>"
34472 msgstr ""
34473
34474 # type: =item
34475 #. type: =item
34476 #: ../tools/virt-make-fs.pl:187
34477 msgid "B<--size=+E<lt>NE<gt>>"
34478 msgstr ""
34479
34480 # type: =item
34481 #. type: =item
34482 #: ../tools/virt-make-fs.pl:189
34483 msgid "B<-s E<lt>NE<gt>>"
34484 msgstr ""
34485
34486 # type: =item
34487 #. type: =item
34488 #: ../tools/virt-make-fs.pl:191
34489 msgid "B<-s +E<lt>NE<gt>>"
34490 msgstr ""
34491
34492 #. type: textblock
34493 #: ../tools/virt-make-fs.pl:193
34494 msgid ""
34495 "Use the I<--size> (or I<-s>) option to choose the size of the output image."
34496 msgstr ""
34497
34498 # type: textblock
34499 #. type: textblock
34500 #: ../tools/virt-make-fs.pl:196
34501 msgid ""
34502 "If this option is I<not> given, then the output image will be just large "
34503 "enough to contain all the files, with not much wasted space."
34504 msgstr ""
34505
34506 # type: textblock
34507 #. type: textblock
34508 #: ../tools/virt-make-fs.pl:199
34509 msgid ""
34510 "To choose a fixed size output disk, specify an absolute number followed by b/"
34511 "K/M/G/T/P/E to mean bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, "
34512 "Petabytes or Exabytes.  This must be large enough to contain all the input "
34513 "files, else you will get an error."
34514 msgstr ""
34515
34516 #. type: textblock
34517 #: ../tools/virt-make-fs.pl:204
34518 msgid ""
34519 "To leave extra space, specify C<+> (plus sign) and a number followed by b/K/"
34520 "M/G/T/P/E to mean bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, "
34521 "Petabytes or Exabytes.  For example: I<--size=+200M> means enough space for "
34522 "the input files, and (approximately) an extra 200 MB free space."
34523 msgstr ""
34524
34525 # type: textblock
34526 #. type: textblock
34527 #: ../tools/virt-make-fs.pl:210
34528 msgid ""
34529 "Note that virt-make-fs estimates free space, and therefore will not produce "
34530 "filesystems containing precisely the free space requested.  (It is much more "
34531 "expensive and time-consuming to produce a filesystem which has precisely the "
34532 "desired free space)."
34533 msgstr ""
34534
34535 # type: =item
34536 #. type: =item
34537 #: ../tools/virt-make-fs.pl:219
34538 msgid "B<--format=E<lt>fmtE<gt>>"
34539 msgstr ""
34540
34541 # type: =item
34542 #. type: =item
34543 #: ../tools/virt-make-fs.pl:221
34544 msgid "B<-F E<lt>fmtE<gt>>"
34545 msgstr ""
34546
34547 # type: textblock
34548 #. type: textblock
34549 #: ../tools/virt-make-fs.pl:223
34550 msgid "Choose the output disk image format."
34551 msgstr ""
34552
34553 # type: textblock
34554 #. type: textblock
34555 #: ../tools/virt-make-fs.pl:225
34556 msgid "The default is C<raw> (raw disk image)."
34557 msgstr ""
34558
34559 # type: textblock
34560 #. type: textblock
34561 #: ../tools/virt-make-fs.pl:227
34562 msgid ""
34563 "For other choices, see the L<qemu-img(1)> manpage.  The only other choice "
34564 "that would really make sense here is C<qcow2>."
34565 msgstr ""
34566
34567 # type: =item
34568 #. type: =item
34569 #: ../tools/virt-make-fs.pl:234
34570 msgid "B<--type=E<lt>fsE<gt>>"
34571 msgstr ""
34572
34573 # type: =item
34574 #. type: =item
34575 #: ../tools/virt-make-fs.pl:236
34576 msgid "B<-t E<lt>fsE<gt>>"
34577 msgstr ""
34578
34579 # type: textblock
34580 #. type: textblock
34581 #: ../tools/virt-make-fs.pl:238
34582 msgid "Choose the output filesystem type."
34583 msgstr ""
34584
34585 # type: textblock
34586 #. type: textblock
34587 #: ../tools/virt-make-fs.pl:240
34588 msgid "The default is C<ext2>."
34589 msgstr ""
34590
34591 # type: textblock
34592 #. type: textblock
34593 #: ../tools/virt-make-fs.pl:242
34594 msgid ""
34595 "Any filesystem which is supported read-write by libguestfs can be used here."
34596 msgstr ""
34597
34598 # type: =item
34599 #. type: =item
34600 #: ../tools/virt-make-fs.pl:249
34601 msgid "B<--partition>"
34602 msgstr ""
34603
34604 # type: =item
34605 #. type: =item
34606 #: ../tools/virt-make-fs.pl:251
34607 msgid "B<--partition=E<lt>parttypeE<gt>>"
34608 msgstr ""
34609
34610 # type: textblock
34611 #. type: textblock
34612 #: ../tools/virt-make-fs.pl:253
34613 msgid ""
34614 "If specified, this flag adds an MBR partition table to the output disk image."
34615 msgstr ""
34616
34617 #. type: textblock
34618 #: ../tools/virt-make-fs.pl:256
34619 msgid ""
34620 "You can change the partition table type, eg. I<--partition=gpt> for large "
34621 "disks."
34622 msgstr ""
34623
34624 #. type: textblock
34625 #: ../tools/virt-make-fs.pl:259
34626 msgid ""
34627 "Note that if you just use a lonesome I<--partition>, the Perl option parser "
34628 "might consider the next parameter to be the partition type.  For example:"
34629 msgstr ""
34630
34631 # type: verbatim
34632 #. type: verbatim
34633 #: ../tools/virt-make-fs.pl:263
34634 #, no-wrap
34635 msgid ""
34636 " virt-make-fs --partition input.tar ...\n"
34637 "\n"
34638 msgstr ""
34639
34640 #. type: textblock
34641 #: ../tools/virt-make-fs.pl:265
34642 msgid ""
34643 "would cause virt-make-fs to think you wanted to use a partition type of "
34644 "C<input.tar> which is completely wrong.  To avoid this, use I<--> (a double "
34645 "dash) between options and the input file argument:"
34646 msgstr ""
34647
34648 # type: verbatim
34649 #. type: verbatim
34650 #: ../tools/virt-make-fs.pl:269
34651 #, no-wrap
34652 msgid ""
34653 " virt-make-fs --partition -- input.tar ...\n"
34654 "\n"
34655 msgstr ""
34656
34657 #. type: textblock
34658 #: ../tools/virt-make-fs.pl:541
34659 msgid ""
34660 "L<guestfish(1)>, L<virt-resize(1)>, L<virt-tar-in(1)>, L<mkisofs(1)>, "
34661 "L<genisoimage(1)>, L<mksquashfs(1)>, L<mke2fs(8)>, L<resize2fs(8)>, L<guestfs"
34662 "(3)>, L<Sys::Guestfs(3)>, L<http://libguestfs.org/>."
34663 msgstr ""
34664
34665 # type: verbatim
34666 #. type: verbatim
34667 #: ../tools/virt-make-fs.pl:558
34668 #, no-wrap
34669 msgid ""
34670 " export LIBGUESTFS_DEBUG=1\n"
34671 " virt-make-fs --debug [...] > /tmp/virt-make-fs.log 2>&1\n"
34672 "\n"
34673 msgstr ""
34674
34675 # type: textblock
34676 #. type: textblock
34677 #: ../tools/virt-make-fs.pl:561
34678 msgid ""
34679 "Attach /tmp/virt-make-fs.log to a new bug report at L<https://bugzilla."
34680 "redhat.com/>"
34681 msgstr ""
34682
34683 # type: textblock
34684 #. type: textblock
34685 #: ../tools/virt-list-partitions.pl:32
34686 msgid ""
34687 "virt-list-partitions - List partitions in a virtual machine or disk image"
34688 msgstr ""
34689
34690 # type: verbatim
34691 #. type: verbatim
34692 #: ../tools/virt-list-partitions.pl:36
34693 #, no-wrap
34694 msgid ""
34695 " virt-list-partitions [--options] domname\n"
34696 "\n"
34697 msgstr ""
34698
34699 # type: verbatim
34700 #. type: verbatim
34701 #: ../tools/virt-list-partitions.pl:38
34702 #, no-wrap
34703 msgid ""
34704 " virt-list-partitions [--options] disk.img [disk.img ...]\n"
34705 "\n"
34706 msgstr ""
34707
34708 # type: textblock
34709 #. type: textblock
34710 #: ../tools/virt-list-partitions.pl:45
34711 msgid ""
34712 "C<virt-list-partitions> is a command line tool to list the partitions that "
34713 "are contained in a virtual machine or disk image.  It is mainly useful as a "
34714 "first step to using L<virt-resize(1)>."
34715 msgstr ""
34716
34717 # type: textblock
34718 #. type: textblock
34719 #: ../tools/virt-list-partitions.pl:50
34720 msgid ""
34721 "C<virt-list-partitions> is just a simple wrapper around L<libguestfs(3)> "
34722 "functionality.  For more complex cases you should look at the L<guestfish(1)"
34723 "> tool."
34724 msgstr ""
34725
34726 # type: =item
34727 #. type: =item
34728 #: ../tools/virt-list-partitions.pl:107
34729 msgid "B<-h> | B<--human-readable>"
34730 msgstr ""
34731
34732 # type: textblock
34733 #. type: textblock
34734 #: ../tools/virt-list-partitions.pl:109
34735 msgid "Show sizes in human-readable form (eg. \"1G\")."
34736 msgstr ""
34737
34738 # type: textblock
34739 #. type: textblock
34740 #: ../tools/virt-list-partitions.pl:117
34741 msgid ""
34742 "With this option, C<virt-list-partitions> displays the type and size of each "
34743 "partition too (where \"type\" means C<ext3>, C<pv> etc.)"
34744 msgstr ""
34745
34746 # type: =item
34747 #. type: =item
34748 #: ../tools/virt-list-partitions.pl:124
34749 msgid "B<-t> | B<--total>"
34750 msgstr ""
34751
34752 # type: textblock
34753 #. type: textblock
34754 #: ../tools/virt-list-partitions.pl:126
34755 msgid ""
34756 "Display the total size of each block device (as a separate row or rows)."
34757 msgstr ""
34758
34759 # type: textblock
34760 #. type: textblock
34761 #: ../tools/virt-list-partitions.pl:259
34762 msgid ""
34763 "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
34764 "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib"
34765 "(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
34766 msgstr ""
34767
34768 # type: textblock
34769 #. type: textblock
34770 #: ../tools/virt-list-partitions.pl:275
34771 msgid "Copyright (C) 2009-2010 Red Hat Inc."
34772 msgstr ""