09b5d430c6857e11e8c553d1faae5b603b00243b
[libguestfs.git] / po-docs / libguestfs-docs.pot
1 # SOME DESCRIPTIVE TITLE
2 # Copyright (C) YEAR Red Hat Inc.
3 # This file is distributed under the same license as the libguestfs package.
4 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
5 #
6 #, fuzzy
7 msgid ""
8 msgstr ""
9 "Project-Id-Version: libguestfs 1.10.8\n"
10 "Report-Msgid-Bugs-To: libguestfs@redhat.com\n"
11 "POT-Creation-Date: 2011-08-17 13:55+0200\n"
12 "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
13 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
14 "Language-Team: LANGUAGE <LL@li.org>\n"
15 "Language: \n"
16 "MIME-Version: 1.0\n"
17 "Content-Type: text/plain; charset=UTF-8\n"
18 "Content-Transfer-Encoding: 8bit\n"
19
20 #. type: =head1
21 #: ../src/guestfs.pod:3 ../fish/guestfish.pod:3 ../test-tool/libguestfs-test-tool.pod:3 ../fuse/guestmount.pod:3 ../tools/virt-edit.pl:32 ../tools/virt-win-reg.pl:35 ../tools/virt-list-filesystems.pl:30 ../tools/virt-tar.pl:31 ../tools/virt-make-fs.pl:35 ../tools/virt-list-partitions.pl:30
22 msgid "NAME"
23 msgstr ""
24
25 #. type: textblock
26 #: ../src/guestfs.pod:5
27 msgid "guestfs - Library for accessing and modifying virtual machine images"
28 msgstr ""
29
30 #. type: =head1
31 #: ../src/guestfs.pod:7 ../fish/guestfish.pod:7 ../test-tool/libguestfs-test-tool.pod:7 ../fuse/guestmount.pod:7 ../tools/virt-edit.pl:36 ../tools/virt-win-reg.pl:39 ../tools/virt-list-filesystems.pl:34 ../tools/virt-tar.pl:35 ../tools/virt-make-fs.pl:39 ../tools/virt-list-partitions.pl:34
32 msgid "SYNOPSIS"
33 msgstr ""
34
35 #. type: verbatim
36 #: ../src/guestfs.pod:9
37 #, no-wrap
38 msgid ""
39 " #include <guestfs.h>\n"
40 " \n"
41 msgstr ""
42
43 #. type: verbatim
44 #: ../src/guestfs.pod:11
45 #, no-wrap
46 msgid ""
47 " guestfs_h *g = guestfs_create ();\n"
48 " guestfs_add_drive (g, \"guest.img\");\n"
49 " guestfs_launch (g);\n"
50 " guestfs_mount (g, \"/dev/sda1\", \"/\");\n"
51 " guestfs_touch (g, \"/hello\");\n"
52 " guestfs_umount (g, \"/\");\n"
53 " guestfs_close (g);\n"
54 "\n"
55 msgstr ""
56
57 #. type: verbatim
58 #: ../src/guestfs.pod:19
59 #, no-wrap
60 msgid ""
61 " cc prog.c -o prog -lguestfs\n"
62 "or:\n"
63 " cc prog.c -o prog `pkg-config libguestfs --cflags --libs`\n"
64 "\n"
65 msgstr ""
66
67 #. type: =head1
68 #: ../src/guestfs.pod:23 ../fish/guestfish.pod:30 ../test-tool/libguestfs-test-tool.pod:11 ../fuse/guestmount.pod:20 ../tools/virt-edit.pl:50 ../tools/virt-win-reg.pl:63 ../tools/virt-list-filesystems.pl:40 ../tools/virt-tar.pl:77 ../tools/virt-make-fs.pl:47 ../tools/virt-list-partitions.pl:40
69 msgid "DESCRIPTION"
70 msgstr ""
71
72 #. type: textblock
73 #: ../src/guestfs.pod:25
74 msgid ""
75 "Libguestfs is a library for accessing and modifying guest disk images.  "
76 "Amongst the things this is good for: making batch configuration changes to "
77 "guests, getting disk used/free statistics (see also: virt-df), migrating "
78 "between virtualization systems (see also: virt-p2v), performing partial "
79 "backups, performing partial guest clones, cloning guests and changing "
80 "registry/UUID/hostname info, and much else besides."
81 msgstr ""
82
83 #. type: textblock
84 #: ../src/guestfs.pod:33
85 msgid ""
86 "Libguestfs uses Linux kernel and qemu code, and can access any type of guest "
87 "filesystem that Linux and qemu can, including but not limited to: ext2/3/4, "
88 "btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, "
89 "qcow2, vmdk."
90 msgstr ""
91
92 #. type: textblock
93 #: ../src/guestfs.pod:38
94 msgid ""
95 "Libguestfs provides ways to enumerate guest storage (eg. partitions, LVs, "
96 "what filesystem is in each LV, etc.).  It can also run commands in the "
97 "context of the guest.  Also you can access filesystems over FUSE."
98 msgstr ""
99
100 #. type: textblock
101 #: ../src/guestfs.pod:43
102 msgid ""
103 "Libguestfs is a library that can be linked with C and C++ management "
104 "programs (or management programs written in OCaml, Perl, Python, Ruby, Java, "
105 "PHP, Haskell or C#).  You can also use it from shell scripts or the command "
106 "line."
107 msgstr ""
108
109 #. type: textblock
110 #: ../src/guestfs.pod:48
111 msgid ""
112 "You don't need to be root to use libguestfs, although obviously you do need "
113 "enough permissions to access the disk images."
114 msgstr ""
115
116 #. type: textblock
117 #: ../src/guestfs.pod:51
118 msgid ""
119 "Libguestfs is a large API because it can do many things.  For a gentle "
120 "introduction, please read the L</API OVERVIEW> section next."
121 msgstr ""
122
123 #. type: textblock
124 #: ../src/guestfs.pod:54
125 msgid ""
126 "There are also some example programs in the L<guestfs-examples(3)> manual "
127 "page."
128 msgstr ""
129
130 #. type: =head1
131 #: ../src/guestfs.pod:57
132 msgid "API OVERVIEW"
133 msgstr ""
134
135 #. type: textblock
136 #: ../src/guestfs.pod:59
137 msgid ""
138 "This section provides a gentler overview of the libguestfs API.  We also try "
139 "to group API calls together, where that may not be obvious from reading "
140 "about the individual calls in the main section of this manual."
141 msgstr ""
142
143 #. type: =head2
144 #: ../src/guestfs.pod:64
145 msgid "HANDLES"
146 msgstr ""
147
148 #. type: textblock
149 #: ../src/guestfs.pod:66
150 msgid ""
151 "Before you can use libguestfs calls, you have to create a handle.  Then you "
152 "must add at least one disk image to the handle, followed by launching the "
153 "handle, then performing whatever operations you want, and finally closing "
154 "the handle.  By convention we use the single letter C<g> for the name of the "
155 "handle variable, although of course you can use any name you want."
156 msgstr ""
157
158 #. type: textblock
159 #: ../src/guestfs.pod:73
160 msgid "The general structure of all libguestfs-using programs looks like this:"
161 msgstr ""
162
163 #. type: verbatim
164 #: ../src/guestfs.pod:76
165 #, no-wrap
166 msgid ""
167 " guestfs_h *g = guestfs_create ();\n"
168 " \n"
169 msgstr ""
170
171 #. type: verbatim
172 #: ../src/guestfs.pod:78
173 #, no-wrap
174 msgid ""
175 " /* Call guestfs_add_drive additional times if there are\n"
176 "  * multiple disk images.\n"
177 "  */\n"
178 " guestfs_add_drive (g, \"guest.img\");\n"
179 " \n"
180 msgstr ""
181
182 #. type: verbatim
183 #: ../src/guestfs.pod:83
184 #, no-wrap
185 msgid ""
186 " /* Most manipulation calls won't work until you've launched\n"
187 "  * the handle 'g'.  You have to do this _after_ adding drives\n"
188 "  * and _before_ other commands.\n"
189 "  */\n"
190 " guestfs_launch (g);\n"
191 " \n"
192 msgstr ""
193
194 #. type: verbatim
195 #: ../src/guestfs.pod:89
196 #, no-wrap
197 msgid ""
198 " /* Now you can examine what partitions, LVs etc are available.\n"
199 "  */\n"
200 " char **partitions = guestfs_list_partitions (g);\n"
201 " char **logvols = guestfs_lvs (g);\n"
202 " \n"
203 msgstr ""
204
205 #. type: verbatim
206 #: ../src/guestfs.pod:94
207 #, no-wrap
208 msgid ""
209 " /* To access a filesystem in the image, you must mount it.\n"
210 "  */\n"
211 " guestfs_mount (g, \"/dev/sda1\", \"/\");\n"
212 " \n"
213 msgstr ""
214
215 #. type: verbatim
216 #: ../src/guestfs.pod:98
217 #, no-wrap
218 msgid ""
219 " /* Now you can perform filesystem actions on the guest\n"
220 "  * disk image.\n"
221 "  */\n"
222 " guestfs_touch (g, \"/hello\");\n"
223 " \n"
224 msgstr ""
225
226 #. type: verbatim
227 #: ../src/guestfs.pod:103
228 #, no-wrap
229 msgid ""
230 " /* This is only needed for libguestfs < 1.5.24.  Since then\n"
231 "  * it is done automatically when you close the handle.  See\n"
232 "  * discussion of autosync in this page.\n"
233 "  */\n"
234 " guestfs_sync (g);\n"
235 " \n"
236 msgstr ""
237
238 #. type: verbatim
239 #: ../src/guestfs.pod:109
240 #, no-wrap
241 msgid ""
242 " /* Close the handle 'g'. */\n"
243 " guestfs_close (g);\n"
244 "\n"
245 msgstr ""
246
247 #. type: textblock
248 #: ../src/guestfs.pod:112
249 msgid ""
250 "The code above doesn't include any error checking.  In real code you should "
251 "check return values carefully for errors.  In general all functions that "
252 "return integers return C<-1> on error, and all functions that return "
253 "pointers return C<NULL> on error.  See section L</ERROR HANDLING> below for "
254 "how to handle errors, and consult the documentation for each function call "
255 "below to see precisely how they return error indications.  See "
256 "L<guestfs-examples(3)> for fully worked examples."
257 msgstr ""
258
259 #. type: =head2
260 #: ../src/guestfs.pod:121
261 msgid "DISK IMAGES"
262 msgstr ""
263
264 #. type: textblock
265 #: ../src/guestfs.pod:123
266 msgid ""
267 "The image filename (C<\"guest.img\"> in the example above) could be a disk "
268 "image from a virtual machine, a L<dd(1)> copy of a physical hard disk, an "
269 "actual block device, or simply an empty file of zeroes that you have created "
270 "through L<posix_fallocate(3)>.  Libguestfs lets you do useful things to all "
271 "of these."
272 msgstr ""
273
274 #. type: textblock
275 #: ../src/guestfs.pod:129
276 msgid ""
277 "The call you should use in modern code for adding drives is "
278 "L</guestfs_add_drive_opts>.  To add a disk image, allowing writes, and "
279 "specifying that the format is raw, do:"
280 msgstr ""
281
282 #. type: verbatim
283 #: ../src/guestfs.pod:133
284 #, no-wrap
285 msgid ""
286 " guestfs_add_drive_opts (g, filename,\n"
287 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"raw\",\n"
288 "                         -1);\n"
289 "\n"
290 msgstr ""
291
292 #. type: textblock
293 #: ../src/guestfs.pod:137
294 msgid "You can add a disk read-only using:"
295 msgstr ""
296
297 #. type: verbatim
298 #: ../src/guestfs.pod:139
299 #, no-wrap
300 msgid ""
301 " guestfs_add_drive_opts (g, filename,\n"
302 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"raw\",\n"
303 "                         GUESTFS_ADD_DRIVE_OPTS_READONLY, 1,\n"
304 "                         -1);\n"
305 "\n"
306 msgstr ""
307
308 #. type: textblock
309 #: ../src/guestfs.pod:144
310 msgid ""
311 "or by calling the older function L</guestfs_add_drive_ro>.  In either case "
312 "libguestfs won't modify the file."
313 msgstr ""
314
315 #. type: textblock
316 #: ../src/guestfs.pod:147
317 msgid ""
318 "Be extremely cautious if the disk image is in use, eg. if it is being used "
319 "by a virtual machine.  Adding it read-write will almost certainly cause disk "
320 "corruption, but adding it read-only is safe."
321 msgstr ""
322
323 #. type: textblock
324 #: ../src/guestfs.pod:151
325 msgid ""
326 "You must add at least one disk image, and you may add multiple disk images.  "
327 "In the API, the disk images are usually referred to as C</dev/sda> (for the "
328 "first one you added), C</dev/sdb> (for the second one you added), etc."
329 msgstr ""
330
331 #. type: textblock
332 #: ../src/guestfs.pod:156
333 msgid ""
334 "Once L</guestfs_launch> has been called you cannot add any more images.  You "
335 "can call L</guestfs_list_devices> to get a list of the device names, in the "
336 "order that you added them.  See also L</BLOCK DEVICE NAMING> below."
337 msgstr ""
338
339 #. type: =head2
340 #: ../src/guestfs.pod:161
341 msgid "MOUNTING"
342 msgstr ""
343
344 #. type: textblock
345 #: ../src/guestfs.pod:163
346 msgid ""
347 "Before you can read or write files, create directories and so on in a disk "
348 "image that contains filesystems, you have to mount those filesystems using "
349 "L</guestfs_mount_options> or L</guestfs_mount_ro>.  If you already know that "
350 "a disk image contains (for example) one partition with a filesystem on that "
351 "partition, then you can mount it directly:"
352 msgstr ""
353
354 #. type: verbatim
355 #: ../src/guestfs.pod:170
356 #, no-wrap
357 msgid ""
358 " guestfs_mount_options (g, \"\", \"/dev/sda1\", \"/\");\n"
359 "\n"
360 msgstr ""
361
362 #. type: textblock
363 #: ../src/guestfs.pod:172
364 msgid ""
365 "where C</dev/sda1> means literally the first partition (C<1>) of the first "
366 "disk image that we added (C</dev/sda>).  If the disk contains Linux LVM2 "
367 "logical volumes you could refer to those instead (eg. C</dev/VG/LV>).  Note "
368 "that these are libguestfs virtual devices, and are nothing to do with host "
369 "devices."
370 msgstr ""
371
372 #. type: textblock
373 #: ../src/guestfs.pod:178
374 msgid ""
375 "If you are given a disk image and you don't know what it contains then you "
376 "have to find out.  Libguestfs can do that too: use "
377 "L</guestfs_list_partitions> and L</guestfs_lvs> to list possible partitions "
378 "and LVs, and either try mounting each to see what is mountable, or else "
379 "examine them with L</guestfs_vfs_type> or L</guestfs_file>.  To list just "
380 "filesystems, use L</guestfs_list_filesystems>."
381 msgstr ""
382
383 #. type: textblock
384 #: ../src/guestfs.pod:186
385 msgid ""
386 "Libguestfs also has a set of APIs for inspection of unknown disk images (see "
387 "L</INSPECTION> below).  But you might find it easier to look at higher level "
388 "programs built on top of libguestfs, in particular L<virt-inspector(1)>."
389 msgstr ""
390
391 #. type: textblock
392 #: ../src/guestfs.pod:191
393 msgid ""
394 "To mount a filesystem read-only, use L</guestfs_mount_ro>.  There are "
395 "several other variations of the C<guestfs_mount_*> call."
396 msgstr ""
397
398 #. type: =head2
399 #: ../src/guestfs.pod:194
400 msgid "FILESYSTEM ACCESS AND MODIFICATION"
401 msgstr ""
402
403 #. type: textblock
404 #: ../src/guestfs.pod:196
405 msgid ""
406 "The majority of the libguestfs API consists of fairly low-level calls for "
407 "accessing and modifying the files, directories, symlinks etc on mounted "
408 "filesystems.  There are over a hundred such calls which you can find listed "
409 "in detail below in this man page, and we don't even pretend to cover them "
410 "all in this overview."
411 msgstr ""
412
413 #. type: textblock
414 #: ../src/guestfs.pod:202
415 msgid ""
416 "Specify filenames as full paths, starting with C<\"/\"> and including the "
417 "mount point."
418 msgstr ""
419
420 #. type: textblock
421 #: ../src/guestfs.pod:205
422 msgid ""
423 "For example, if you mounted a filesystem at C<\"/\"> and you want to read "
424 "the file called C<\"etc/passwd\"> then you could do:"
425 msgstr ""
426
427 #. type: verbatim
428 #: ../src/guestfs.pod:208
429 #, no-wrap
430 msgid ""
431 " char *data = guestfs_cat (g, \"/etc/passwd\");\n"
432 "\n"
433 msgstr ""
434
435 #. type: textblock
436 #: ../src/guestfs.pod:210
437 msgid ""
438 "This would return C<data> as a newly allocated buffer containing the full "
439 "content of that file (with some conditions: see also L</DOWNLOADING> below), "
440 "or C<NULL> if there was an error."
441 msgstr ""
442
443 #. type: textblock
444 #: ../src/guestfs.pod:214
445 msgid ""
446 "As another example, to create a top-level directory on that filesystem "
447 "called C<\"var\"> you would do:"
448 msgstr ""
449
450 #. type: verbatim
451 #: ../src/guestfs.pod:217
452 #, no-wrap
453 msgid ""
454 " guestfs_mkdir (g, \"/var\");\n"
455 "\n"
456 msgstr ""
457
458 #. type: textblock
459 #: ../src/guestfs.pod:219
460 msgid "To create a symlink you could do:"
461 msgstr ""
462
463 #. type: verbatim
464 #: ../src/guestfs.pod:221
465 #, no-wrap
466 msgid ""
467 " guestfs_ln_s (g, \"/etc/init.d/portmap\",\n"
468 "               \"/etc/rc3.d/S30portmap\");\n"
469 "\n"
470 msgstr ""
471
472 #. type: textblock
473 #: ../src/guestfs.pod:224
474 msgid ""
475 "Libguestfs will reject attempts to use relative paths and there is no "
476 "concept of a current working directory."
477 msgstr ""
478
479 #. type: textblock
480 #: ../src/guestfs.pod:227
481 msgid ""
482 "Libguestfs can return errors in many situations: for example if the "
483 "filesystem isn't writable, or if a file or directory that you requested "
484 "doesn't exist.  If you are using the C API (documented here)  you have to "
485 "check for those error conditions after each call.  (Other language bindings "
486 "turn these errors into exceptions)."
487 msgstr ""
488
489 #. type: textblock
490 #: ../src/guestfs.pod:233
491 msgid ""
492 "File writes are affected by the per-handle umask, set by calling "
493 "L</guestfs_umask> and defaulting to 022.  See L</UMASK>."
494 msgstr ""
495
496 #. type: =head2
497 #: ../src/guestfs.pod:236
498 msgid "PARTITIONING"
499 msgstr ""
500
501 #. type: textblock
502 #: ../src/guestfs.pod:238
503 msgid ""
504 "Libguestfs contains API calls to read, create and modify partition tables on "
505 "disk images."
506 msgstr ""
507
508 #. type: textblock
509 #: ../src/guestfs.pod:241
510 msgid ""
511 "In the common case where you want to create a single partition covering the "
512 "whole disk, you should use the L</guestfs_part_disk> call:"
513 msgstr ""
514
515 #. type: verbatim
516 #: ../src/guestfs.pod:245
517 #, no-wrap
518 msgid ""
519 " const char *parttype = \"mbr\";\n"
520 " if (disk_is_larger_than_2TB)\n"
521 "   parttype = \"gpt\";\n"
522 " guestfs_part_disk (g, \"/dev/sda\", parttype);\n"
523 "\n"
524 msgstr ""
525
526 #. type: textblock
527 #: ../src/guestfs.pod:250
528 msgid ""
529 "Obviously this effectively wipes anything that was on that disk image "
530 "before."
531 msgstr ""
532
533 #. type: =head2
534 #: ../src/guestfs.pod:253
535 msgid "LVM2"
536 msgstr ""
537
538 #. type: textblock
539 #: ../src/guestfs.pod:255
540 msgid ""
541 "Libguestfs provides access to a large part of the LVM2 API, such as "
542 "L</guestfs_lvcreate> and L</guestfs_vgremove>.  It won't make much sense "
543 "unless you familiarize yourself with the concepts of physical volumes, "
544 "volume groups and logical volumes."
545 msgstr ""
546
547 #. type: textblock
548 #: ../src/guestfs.pod:260
549 msgid ""
550 "This author strongly recommends reading the LVM HOWTO, online at "
551 "L<http://tldp.org/HOWTO/LVM-HOWTO/>."
552 msgstr ""
553
554 #. type: =head2
555 #: ../src/guestfs.pod:263
556 msgid "DOWNLOADING"
557 msgstr ""
558
559 #. type: textblock
560 #: ../src/guestfs.pod:265
561 msgid ""
562 "Use L</guestfs_cat> to download small, text only files.  This call is "
563 "limited to files which are less than 2 MB and which cannot contain any ASCII "
564 "NUL (C<\\0>) characters.  However the API is very simple to use."
565 msgstr ""
566
567 #. type: textblock
568 #: ../src/guestfs.pod:269
569 msgid ""
570 "L</guestfs_read_file> can be used to read files which contain arbitrary 8 "
571 "bit data, since it returns a (pointer, size) pair.  However it is still "
572 "limited to \"small\" files, less than 2 MB."
573 msgstr ""
574
575 #. type: textblock
576 #: ../src/guestfs.pod:273
577 msgid ""
578 "L</guestfs_download> can be used to download any file, with no limits on "
579 "content or size (even files larger than 4 GB)."
580 msgstr ""
581
582 #. type: textblock
583 #: ../src/guestfs.pod:276
584 msgid "To download multiple files, see L</guestfs_tar_out> and L</guestfs_tgz_out>."
585 msgstr ""
586
587 #. type: =head2
588 #: ../src/guestfs.pod:279
589 msgid "UPLOADING"
590 msgstr ""
591
592 #. type: textblock
593 #: ../src/guestfs.pod:281
594 msgid ""
595 "It's often the case that you want to write a file or files to the disk "
596 "image."
597 msgstr ""
598
599 #. type: textblock
600 #: ../src/guestfs.pod:284
601 msgid ""
602 "To write a small file with fixed content, use L</guestfs_write>.  To create "
603 "a file of all zeroes, use L</guestfs_truncate_size> (sparse) or "
604 "L</guestfs_fallocate64> (with all disk blocks allocated).  There are a "
605 "variety of other functions for creating test files, for example "
606 "L</guestfs_fill> and L</guestfs_fill_pattern>."
607 msgstr ""
608
609 #. type: textblock
610 #: ../src/guestfs.pod:290
611 msgid ""
612 "To upload a single file, use L</guestfs_upload>.  This call has no limits on "
613 "file content or size (even files larger than 4 GB)."
614 msgstr ""
615
616 #. type: textblock
617 #: ../src/guestfs.pod:293
618 msgid "To upload multiple files, see L</guestfs_tar_in> and L</guestfs_tgz_in>."
619 msgstr ""
620
621 #. type: textblock
622 #: ../src/guestfs.pod:295
623 msgid ""
624 "However the fastest way to upload I<large numbers of arbitrary files> is to "
625 "turn them into a squashfs or CD ISO (see L<mksquashfs(8)> and "
626 "L<mkisofs(8)>), then attach this using L</guestfs_add_drive_ro>.  If you add "
627 "the drive in a predictable way (eg. adding it last after all other drives) "
628 "then you can get the device name from L</guestfs_list_devices> and mount it "
629 "directly using L</guestfs_mount_ro>.  Note that squashfs images are "
630 "sometimes non-portable between kernel versions, and they don't support "
631 "labels or UUIDs.  If you want to pre-build an image or you need to mount it "
632 "using a label or UUID, use an ISO image instead."
633 msgstr ""
634
635 #. type: =head2
636 #: ../src/guestfs.pod:306
637 msgid "COPYING"
638 msgstr ""
639
640 #. type: textblock
641 #: ../src/guestfs.pod:308
642 msgid ""
643 "There are various different commands for copying between files and devices "
644 "and in and out of the guest filesystem.  These are summarised in the table "
645 "below."
646 msgstr ""
647
648 #. type: =item
649 #: ../src/guestfs.pod:314
650 msgid "B<file> to B<file>"
651 msgstr ""
652
653 #. type: textblock
654 #: ../src/guestfs.pod:316
655 msgid ""
656 "Use L</guestfs_cp> to copy a single file, or L</guestfs_cp_a> to copy "
657 "directories recursively."
658 msgstr ""
659
660 #. type: =item
661 #: ../src/guestfs.pod:319
662 msgid "B<file or device> to B<file or device>"
663 msgstr ""
664
665 #. type: textblock
666 #: ../src/guestfs.pod:321
667 msgid ""
668 "Use L</guestfs_dd> which efficiently uses L<dd(1)> to copy between files and "
669 "devices in the guest."
670 msgstr ""
671
672 #. type: textblock
673 #: ../src/guestfs.pod:324
674 msgid "Example: duplicate the contents of an LV:"
675 msgstr ""
676
677 #. type: verbatim
678 #: ../src/guestfs.pod:326
679 #, no-wrap
680 msgid ""
681 " guestfs_dd (g, \"/dev/VG/Original\", \"/dev/VG/Copy\");\n"
682 "\n"
683 msgstr ""
684
685 #. type: textblock
686 #: ../src/guestfs.pod:328
687 msgid ""
688 "The destination (C</dev/VG/Copy>) must be at least as large as the source "
689 "(C</dev/VG/Original>).  To copy less than the whole source device, use "
690 "L</guestfs_copy_size>."
691 msgstr ""
692
693 #. type: =item
694 #: ../src/guestfs.pod:332
695 msgid "B<file on the host> to B<file or device>"
696 msgstr ""
697
698 #. type: textblock
699 #: ../src/guestfs.pod:334
700 msgid "Use L</guestfs_upload>.  See L</UPLOADING> above."
701 msgstr ""
702
703 #. type: =item
704 #: ../src/guestfs.pod:336
705 msgid "B<file or device> to B<file on the host>"
706 msgstr ""
707
708 #. type: textblock
709 #: ../src/guestfs.pod:338
710 msgid "Use L</guestfs_download>.  See L</DOWNLOADING> above."
711 msgstr ""
712
713 #. type: =head2
714 #: ../src/guestfs.pod:342
715 msgid "UPLOADING AND DOWNLOADING TO PIPES AND FILE DESCRIPTORS"
716 msgstr ""
717
718 #. type: textblock
719 #: ../src/guestfs.pod:344
720 msgid ""
721 "Calls like L</guestfs_upload>, L</guestfs_download>, L</guestfs_tar_in>, "
722 "L</guestfs_tar_out> etc appear to only take filenames as arguments, so it "
723 "appears you can only upload and download to files.  However many Un*x-like "
724 "hosts let you use the special device files C</dev/stdin>, C</dev/stdout>, "
725 "C</dev/stderr> and C</dev/fd/N> to read and write from stdin, stdout, "
726 "stderr, and arbitrary file descriptor N."
727 msgstr ""
728
729 #. type: textblock
730 #: ../src/guestfs.pod:352
731 msgid "For example, L<virt-cat(1)> writes its output to stdout by doing:"
732 msgstr ""
733
734 #. type: verbatim
735 #: ../src/guestfs.pod:355
736 #, no-wrap
737 msgid ""
738 " guestfs_download (g, filename, \"/dev/stdout\");\n"
739 "\n"
740 msgstr ""
741
742 #. type: textblock
743 #: ../src/guestfs.pod:357
744 msgid "and you can write tar output to a file descriptor C<fd> by doing:"
745 msgstr ""
746
747 #. type: verbatim
748 #: ../src/guestfs.pod:359
749 #, no-wrap
750 msgid ""
751 " char devfd[64];\n"
752 " snprintf (devfd, sizeof devfd, \"/dev/fd/%d\", fd);\n"
753 " guestfs_tar_out (g, \"/\", devfd);\n"
754 "\n"
755 msgstr ""
756
757 #. type: =head2
758 #: ../src/guestfs.pod:363
759 msgid "LISTING FILES"
760 msgstr ""
761
762 #. type: textblock
763 #: ../src/guestfs.pod:365
764 msgid ""
765 "L</guestfs_ll> is just designed for humans to read (mainly when using the "
766 "L<guestfish(1)>-equivalent command C<ll>)."
767 msgstr ""
768
769 #. type: textblock
770 #: ../src/guestfs.pod:368
771 msgid ""
772 "L</guestfs_ls> is a quick way to get a list of files in a directory from "
773 "programs, as a flat list of strings."
774 msgstr ""
775
776 #. type: textblock
777 #: ../src/guestfs.pod:371
778 msgid ""
779 "L</guestfs_readdir> is a programmatic way to get a list of files in a "
780 "directory, plus additional information about each one.  It is more "
781 "equivalent to using the L<readdir(3)> call on a local filesystem."
782 msgstr ""
783
784 #. type: textblock
785 #: ../src/guestfs.pod:375
786 msgid ""
787 "L</guestfs_find> and L</guestfs_find0> can be used to recursively list "
788 "files."
789 msgstr ""
790
791 #. type: =head2
792 #: ../src/guestfs.pod:378
793 msgid "RUNNING COMMANDS"
794 msgstr ""
795
796 #. type: textblock
797 #: ../src/guestfs.pod:380
798 msgid ""
799 "Although libguestfs is primarily an API for manipulating files inside guest "
800 "images, we also provide some limited facilities for running commands inside "
801 "guests."
802 msgstr ""
803
804 #. type: textblock
805 #: ../src/guestfs.pod:384
806 msgid "There are many limitations to this:"
807 msgstr ""
808
809 #. type: =item
810 #: ../src/guestfs.pod:388 ../src/guestfs.pod:393 ../src/guestfs.pod:398 ../src/guestfs.pod:402 ../src/guestfs.pod:407 ../src/guestfs.pod:411 ../src/guestfs.pod:416 ../src/guestfs.pod:421 ../src/guestfs.pod:1064 ../src/guestfs.pod:1068 ../src/guestfs.pod:1072 ../src/guestfs.pod:1077 ../src/guestfs.pod:1085 ../src/guestfs.pod:1104 ../src/guestfs.pod:1112 ../src/guestfs.pod:1134 ../src/guestfs.pod:1138 ../src/guestfs.pod:1142 ../src/guestfs.pod:1146 ../src/guestfs.pod:1150 ../src/guestfs.pod:1154 ../src/guestfs.pod:1643 ../src/guestfs.pod:1648 ../src/guestfs.pod:1652 ../src/guestfs.pod:1753 ../src/guestfs.pod:1758 ../src/guestfs.pod:1762 ../src/guestfs.pod:1772 ../src/guestfs.pod:2007 ../src/guestfs.pod:2012 ../src/guestfs.pod:2018 ../src/guestfs.pod:2026 ../src/guestfs.pod:2380 ../src/guestfs.pod:2386 ../src/guestfs.pod:2391 ../src/guestfs.pod:2397 ../src/guestfs.pod:2968 ../src/guestfs.pod:2972 ../src/guestfs.pod:2976 ../src/guestfs.pod:2980 ../src/guestfs-actions.pod:15 ../src/guestfs-actions.pod:22 ../src/guestfs-actions.pod:582 ../src/guestfs-actions.pod:590 ../src/guestfs-actions.pod:597 ../src/guestfs-actions.pod:604 ../src/guestfs-actions.pod:1602 ../src/guestfs-actions.pod:1606 ../src/guestfs-actions.pod:1610 ../src/guestfs-actions.pod:1614 ../src/guestfs-actions.pod:1622 ../src/guestfs-actions.pod:1626 ../src/guestfs-actions.pod:1630 ../src/guestfs-actions.pod:1640 ../src/guestfs-actions.pod:1644 ../src/guestfs-actions.pod:1648 ../src/guestfs-actions.pod:1786 ../src/guestfs-actions.pod:1790 ../src/guestfs-actions.pod:1795 ../src/guestfs-actions.pod:1800 ../src/guestfs-actions.pod:1861 ../src/guestfs-actions.pod:1865 ../src/guestfs-actions.pod:1870 ../fish/guestfish.pod:443 ../fish/guestfish.pod:447 ../fish/guestfish.pod:451 ../fish/guestfish.pod:455 ../fish/guestfish-actions.pod:13 ../fish/guestfish-actions.pod:20 ../fish/guestfish-actions.pod:385 ../fish/guestfish-actions.pod:393 ../fish/guestfish-actions.pod:400 ../fish/guestfish-actions.pod:407 ../fish/guestfish-actions.pod:1074 ../fish/guestfish-actions.pod:1078 ../fish/guestfish-actions.pod:1082 ../fish/guestfish-actions.pod:1086 ../fish/guestfish-actions.pod:1094 ../fish/guestfish-actions.pod:1098 ../fish/guestfish-actions.pod:1102 ../fish/guestfish-actions.pod:1112 ../fish/guestfish-actions.pod:1116 ../fish/guestfish-actions.pod:1120 ../fish/guestfish-actions.pod:1210 ../fish/guestfish-actions.pod:1214 ../fish/guestfish-actions.pod:1219 ../fish/guestfish-actions.pod:1224 ../fish/guestfish-actions.pod:1266 ../fish/guestfish-actions.pod:1270 ../fish/guestfish-actions.pod:1275 ../tools/virt-edit.pl:351 ../tools/virt-edit.pl:356 ../tools/virt-edit.pl:361 ../tools/virt-edit.pl:372 ../tools/virt-edit.pl:376 ../tools/virt-win-reg.pl:536 ../tools/virt-win-reg.pl:542 ../tools/virt-win-reg.pl:548
811 msgid "*"
812 msgstr ""
813
814 #. type: textblock
815 #: ../src/guestfs.pod:390
816 msgid ""
817 "The kernel version that the command runs under will be different from what "
818 "it expects."
819 msgstr ""
820
821 #. type: textblock
822 #: ../src/guestfs.pod:395
823 msgid ""
824 "If the command needs to communicate with daemons, then most likely they "
825 "won't be running."
826 msgstr ""
827
828 #. type: textblock
829 #: ../src/guestfs.pod:400
830 msgid "The command will be running in limited memory."
831 msgstr ""
832
833 #. type: textblock
834 #: ../src/guestfs.pod:404
835 msgid ""
836 "The network may not be available unless you enable it (see "
837 "L</guestfs_set_network>)."
838 msgstr ""
839
840 #. type: textblock
841 #: ../src/guestfs.pod:409
842 msgid "Only supports Linux guests (not Windows, BSD, etc)."
843 msgstr ""
844
845 #. type: textblock
846 #: ../src/guestfs.pod:413
847 msgid "Architecture limitations (eg. won't work for a PPC guest on an X86 host)."
848 msgstr ""
849
850 #. type: textblock
851 #: ../src/guestfs.pod:418
852 msgid ""
853 "For SELinux guests, you may need to enable SELinux and load policy first.  "
854 "See L</SELINUX> in this manpage."
855 msgstr ""
856
857 #. type: textblock
858 #: ../src/guestfs.pod:423
859 msgid ""
860 "I<Security:> It is not safe to run commands from untrusted, possibly "
861 "malicious guests.  These commands may attempt to exploit your program by "
862 "sending unexpected output.  They could also try to exploit the Linux kernel "
863 "or qemu provided by the libguestfs appliance.  They could use the network "
864 "provided by the libguestfs appliance to bypass ordinary network partitions "
865 "and firewalls.  They could use the elevated privileges or different SELinux "
866 "context of your program to their advantage."
867 msgstr ""
868
869 #. type: textblock
870 #: ../src/guestfs.pod:432
871 msgid ""
872 "A secure alternative is to use libguestfs to install a \"firstboot\" script "
873 "(a script which runs when the guest next boots normally), and to have this "
874 "script run the commands you want in the normal context of the running guest, "
875 "network security and so on.  For information about other security issues, "
876 "see L</SECURITY>."
877 msgstr ""
878
879 #. type: textblock
880 #: ../src/guestfs.pod:440
881 msgid ""
882 "The two main API calls to run commands are L</guestfs_command> and "
883 "L</guestfs_sh> (there are also variations)."
884 msgstr ""
885
886 #. type: textblock
887 #: ../src/guestfs.pod:443
888 msgid ""
889 "The difference is that L</guestfs_sh> runs commands using the shell, so any "
890 "shell globs, redirections, etc will work."
891 msgstr ""
892
893 #. type: =head2
894 #: ../src/guestfs.pod:446
895 msgid "CONFIGURATION FILES"
896 msgstr ""
897
898 #. type: textblock
899 #: ../src/guestfs.pod:448
900 msgid ""
901 "To read and write configuration files in Linux guest filesystems, we "
902 "strongly recommend using Augeas.  For example, Augeas understands how to "
903 "read and write, say, a Linux shadow password file or X.org configuration "
904 "file, and so avoids you having to write that code."
905 msgstr ""
906
907 #. type: textblock
908 #: ../src/guestfs.pod:453
909 msgid ""
910 "The main Augeas calls are bound through the C<guestfs_aug_*> APIs.  We don't "
911 "document Augeas itself here because there is excellent documentation on the "
912 "L<http://augeas.net/> website."
913 msgstr ""
914
915 #. type: textblock
916 #: ../src/guestfs.pod:457
917 msgid ""
918 "If you don't want to use Augeas (you fool!) then try calling "
919 "L</guestfs_read_lines> to get the file as a list of lines which you can "
920 "iterate over."
921 msgstr ""
922
923 #. type: =head2
924 #: ../src/guestfs.pod:461
925 msgid "SELINUX"
926 msgstr ""
927
928 #. type: textblock
929 #: ../src/guestfs.pod:463
930 msgid ""
931 "We support SELinux guests.  To ensure that labeling happens correctly in "
932 "SELinux guests, you need to enable SELinux and load the guest's policy:"
933 msgstr ""
934
935 #. type: =item
936 #: ../src/guestfs.pod:469 ../src/guestfs.pod:1257 ../src/guestfs.pod:1395 ../src/guestfs.pod:2425
937 msgid "1."
938 msgstr ""
939
940 #. type: textblock
941 #: ../src/guestfs.pod:471
942 msgid "Before launching, do:"
943 msgstr ""
944
945 #. type: verbatim
946 #: ../src/guestfs.pod:473
947 #, no-wrap
948 msgid ""
949 " guestfs_set_selinux (g, 1);\n"
950 "\n"
951 msgstr ""
952
953 #. type: =item
954 #: ../src/guestfs.pod:475 ../src/guestfs.pod:1261 ../src/guestfs.pod:1399 ../src/guestfs.pod:2450
955 msgid "2."
956 msgstr ""
957
958 #. type: textblock
959 #: ../src/guestfs.pod:477
960 msgid ""
961 "After mounting the guest's filesystem(s), load the policy.  This is best "
962 "done by running the L<load_policy(8)> command in the guest itself:"
963 msgstr ""
964
965 #. type: verbatim
966 #: ../src/guestfs.pod:481
967 #, no-wrap
968 msgid ""
969 " guestfs_sh (g, \"/usr/sbin/load_policy\");\n"
970 "\n"
971 msgstr ""
972
973 #. type: textblock
974 #: ../src/guestfs.pod:483
975 msgid ""
976 "(Older versions of C<load_policy> require you to specify the name of the "
977 "policy file)."
978 msgstr ""
979
980 #. type: =item
981 #: ../src/guestfs.pod:486 ../src/guestfs.pod:1405
982 msgid "3."
983 msgstr ""
984
985 #. type: textblock
986 #: ../src/guestfs.pod:488
987 msgid ""
988 "Optionally, set the security context for the API.  The correct security "
989 "context to use can only be known by inspecting the guest.  As an example:"
990 msgstr ""
991
992 #. type: verbatim
993 #: ../src/guestfs.pod:492
994 #, no-wrap
995 msgid ""
996 " guestfs_setcon (g, \"unconfined_u:unconfined_r:unconfined_t:s0\");\n"
997 "\n"
998 msgstr ""
999
1000 #. type: textblock
1001 #: ../src/guestfs.pod:496
1002 msgid "This will work for running commands and editing existing files."
1003 msgstr ""
1004
1005 #. type: textblock
1006 #: ../src/guestfs.pod:498
1007 msgid ""
1008 "When new files are created, you may need to label them explicitly, for "
1009 "example by running the external command C<restorecon pathname>."
1010 msgstr ""
1011
1012 #. type: =head2
1013 #: ../src/guestfs.pod:502
1014 msgid "UMASK"
1015 msgstr ""
1016
1017 #. type: textblock
1018 #: ../src/guestfs.pod:504
1019 msgid ""
1020 "Certain calls are affected by the current file mode creation mask (the "
1021 "\"umask\").  In particular ones which create files or directories, such as "
1022 "L</guestfs_touch>, L</guestfs_mknod> or L</guestfs_mkdir>.  This affects "
1023 "either the default mode that the file is created with or modifies the mode "
1024 "that you supply."
1025 msgstr ""
1026
1027 #. type: textblock
1028 #: ../src/guestfs.pod:510
1029 msgid ""
1030 "The default umask is C<022>, so files are created with modes such as C<0644> "
1031 "and directories with C<0755>."
1032 msgstr ""
1033
1034 #. type: textblock
1035 #: ../src/guestfs.pod:513
1036 msgid ""
1037 "There are two ways to avoid being affected by umask.  Either set umask to 0 "
1038 "(call C<guestfs_umask (g, 0)> early after launching).  Or call "
1039 "L</guestfs_chmod> after creating each file or directory."
1040 msgstr ""
1041
1042 #. type: textblock
1043 #: ../src/guestfs.pod:517
1044 msgid "For more information about umask, see L<umask(2)>."
1045 msgstr ""
1046
1047 #. type: =head1
1048 #: ../src/guestfs.pod:519 ../fish/guestfish.pod:765
1049 msgid "ENCRYPTED DISKS"
1050 msgstr ""
1051
1052 #. type: textblock
1053 #: ../src/guestfs.pod:521
1054 msgid ""
1055 "Libguestfs allows you to access Linux guests which have been encrypted using "
1056 "whole disk encryption that conforms to the Linux Unified Key Setup (LUKS) "
1057 "standard.  This includes nearly all whole disk encryption systems used by "
1058 "modern Linux guests."
1059 msgstr ""
1060
1061 #. type: textblock
1062 #: ../src/guestfs.pod:527
1063 msgid ""
1064 "Use L</guestfs_vfs_type> to identify LUKS-encrypted block devices (it "
1065 "returns the string C<crypto_LUKS>)."
1066 msgstr ""
1067
1068 #. type: textblock
1069 #: ../src/guestfs.pod:530
1070 msgid ""
1071 "Then open these devices by calling L</guestfs_luks_open>.  Obviously you "
1072 "will require the passphrase!"
1073 msgstr ""
1074
1075 #. type: textblock
1076 #: ../src/guestfs.pod:533
1077 msgid ""
1078 "Opening a LUKS device creates a new device mapper device called "
1079 "C</dev/mapper/mapname> (where C<mapname> is the string you supply to "
1080 "L</guestfs_luks_open>).  Reads and writes to this mapper device are "
1081 "decrypted from and encrypted to the underlying block device respectively."
1082 msgstr ""
1083
1084 #. type: textblock
1085 #: ../src/guestfs.pod:539
1086 msgid ""
1087 "LVM volume groups on the device can be made visible by calling "
1088 "L</guestfs_vgscan> followed by L</guestfs_vg_activate_all>.  The logical "
1089 "volume(s) can now be mounted in the usual way."
1090 msgstr ""
1091
1092 #. type: textblock
1093 #: ../src/guestfs.pod:543
1094 msgid ""
1095 "Use the reverse process to close a LUKS device.  Unmount any logical volumes "
1096 "on it, deactivate the volume groups by caling C<guestfs_vg_activate (g, 0, "
1097 "[\"/dev/VG\"])>.  Then close the mapper device by calling "
1098 "L</guestfs_luks_close> on the C</dev/mapper/mapname> device (I<not> the "
1099 "underlying encrypted block device)."
1100 msgstr ""
1101
1102 #. type: =head2
1103 #: ../src/guestfs.pod:550
1104 msgid "INSPECTION"
1105 msgstr ""
1106
1107 #. type: textblock
1108 #: ../src/guestfs.pod:552
1109 msgid ""
1110 "Libguestfs has APIs for inspecting an unknown disk image to find out if it "
1111 "contains operating systems, an install CD or a live CD.  (These APIs used to "
1112 "be in a separate Perl-only library called L<Sys::Guestfs::Lib(3)> but since "
1113 "version 1.5.3 the most frequently used part of this library has been "
1114 "rewritten in C and moved into the core code)."
1115 msgstr ""
1116
1117 #. type: textblock
1118 #: ../src/guestfs.pod:559
1119 msgid ""
1120 "Add all disks belonging to the unknown virtual machine and call "
1121 "L</guestfs_launch> in the usual way."
1122 msgstr ""
1123
1124 #. type: textblock
1125 #: ../src/guestfs.pod:562
1126 msgid ""
1127 "Then call L</guestfs_inspect_os>.  This function uses other libguestfs calls "
1128 "and certain heuristics, and returns a list of operating systems that were "
1129 "found.  An empty list means none were found.  A single element is the root "
1130 "filesystem of the operating system.  For dual- or multi-boot guests, "
1131 "multiple roots can be returned, each one corresponding to a separate "
1132 "operating system.  (Multi-boot virtual machines are extremely rare in the "
1133 "world of virtualization, but since this scenario can happen, we have built "
1134 "libguestfs to deal with it.)"
1135 msgstr ""
1136
1137 #. type: textblock
1138 #: ../src/guestfs.pod:571
1139 msgid ""
1140 "For each root, you can then call various C<guestfs_inspect_get_*> functions "
1141 "to get additional details about that operating system.  For example, call "
1142 "L</guestfs_inspect_get_type> to return the string C<windows> or C<linux> for "
1143 "Windows and Linux-based operating systems respectively."
1144 msgstr ""
1145
1146 #. type: textblock
1147 #: ../src/guestfs.pod:577
1148 msgid ""
1149 "Un*x-like and Linux-based operating systems usually consist of several "
1150 "filesystems which are mounted at boot time (for example, a separate boot "
1151 "partition mounted on C</boot>).  The inspection rules are able to detect how "
1152 "filesystems correspond to mount points.  Call "
1153 "C<guestfs_inspect_get_mountpoints> to get this mapping.  It might return a "
1154 "hash table like this example:"
1155 msgstr ""
1156
1157 #. type: verbatim
1158 #: ../src/guestfs.pod:584
1159 #, no-wrap
1160 msgid ""
1161 " /boot => /dev/sda1\n"
1162 " /     => /dev/vg_guest/lv_root\n"
1163 " /usr  => /dev/vg_guest/lv_usr\n"
1164 "\n"
1165 msgstr ""
1166
1167 #. type: textblock
1168 #: ../src/guestfs.pod:588
1169 msgid ""
1170 "The caller can then make calls to L</guestfs_mount_options> to mount the "
1171 "filesystems as suggested."
1172 msgstr ""
1173
1174 #. type: textblock
1175 #: ../src/guestfs.pod:591
1176 msgid ""
1177 "Be careful to mount filesystems in the right order (eg. C</> before "
1178 "C</usr>).  Sorting the keys of the hash by length, shortest first, should "
1179 "work."
1180 msgstr ""
1181
1182 #. type: textblock
1183 #: ../src/guestfs.pod:595
1184 msgid ""
1185 "Inspection currently only works for some common operating systems.  "
1186 "Contributors are welcome to send patches for other operating systems that we "
1187 "currently cannot detect."
1188 msgstr ""
1189
1190 #. type: textblock
1191 #: ../src/guestfs.pod:599
1192 msgid ""
1193 "Encrypted disks must be opened before inspection.  See L</ENCRYPTED DISKS> "
1194 "for more details.  The L</guestfs_inspect_os> function just ignores any "
1195 "encrypted devices."
1196 msgstr ""
1197
1198 #. type: textblock
1199 #: ../src/guestfs.pod:603
1200 msgid ""
1201 "A note on the implementation: The call L</guestfs_inspect_os> performs "
1202 "inspection and caches the results in the guest handle.  Subsequent calls to "
1203 "C<guestfs_inspect_get_*> return this cached information, but I<do not> "
1204 "re-read the disks.  If you change the content of the guest disks, you can "
1205 "redo inspection by calling L</guestfs_inspect_os> again.  "
1206 "(L</guestfs_inspect_list_applications> works a little differently from the "
1207 "other calls and does read the disks.  See documentation for that function "
1208 "for details)."
1209 msgstr ""
1210
1211 #. type: =head3
1212 #: ../src/guestfs.pod:612
1213 msgid "INSPECTING INSTALL DISKS"
1214 msgstr ""
1215
1216 #. type: textblock
1217 #: ../src/guestfs.pod:614
1218 msgid ""
1219 "Libguestfs (since 1.9.4) can detect some install disks, install CDs, live "
1220 "CDs and more."
1221 msgstr ""
1222
1223 #. type: textblock
1224 #: ../src/guestfs.pod:617
1225 msgid ""
1226 "Call L</guestfs_inspect_get_format> to return the format of the operating "
1227 "system, which currently can be C<installed> (a regular operating system) or "
1228 "C<installer> (some sort of install disk)."
1229 msgstr ""
1230
1231 #. type: textblock
1232 #: ../src/guestfs.pod:621
1233 msgid ""
1234 "Further information is available about the operating system that can be "
1235 "installed using the regular inspection APIs like "
1236 "L</guestfs_inspect_get_product_name>, L</guestfs_inspect_get_major_version> "
1237 "etc."
1238 msgstr ""
1239
1240 #. type: textblock
1241 #: ../src/guestfs.pod:626
1242 msgid ""
1243 "Some additional information specific to installer disks is also available "
1244 "from the L</guestfs_inspect_is_live>, L</guestfs_inspect_is_netinst> and "
1245 "L</guestfs_inspect_is_multipart> calls."
1246 msgstr ""
1247
1248 #. type: =head2
1249 #: ../src/guestfs.pod:631
1250 msgid "SPECIAL CONSIDERATIONS FOR WINDOWS GUESTS"
1251 msgstr ""
1252
1253 #. type: textblock
1254 #: ../src/guestfs.pod:633
1255 msgid ""
1256 "Libguestfs can mount NTFS partitions.  It does this using the "
1257 "L<http://www.ntfs-3g.org/> driver."
1258 msgstr ""
1259
1260 #. type: =head3
1261 #: ../src/guestfs.pod:636
1262 msgid "DRIVE LETTERS AND PATHS"
1263 msgstr ""
1264
1265 #. type: textblock
1266 #: ../src/guestfs.pod:638
1267 msgid ""
1268 "DOS and Windows still use drive letters, and the filesystems are always "
1269 "treated as case insensitive by Windows itself, and therefore you might find "
1270 "a Windows configuration file referring to a path like "
1271 "C<c:\\windows\\system32>.  When the filesystem is mounted in libguestfs, "
1272 "that directory might be referred to as C</WINDOWS/System32>."
1273 msgstr ""
1274
1275 #. type: textblock
1276 #: ../src/guestfs.pod:644
1277 msgid ""
1278 "Drive letter mappings can be found using inspection (see L</INSPECTION> and "
1279 "L</guestfs_inspect_get_drive_mappings>)"
1280 msgstr ""
1281
1282 #. type: textblock
1283 #: ../src/guestfs.pod:647
1284 msgid ""
1285 "Dealing with separator characters (backslash vs forward slash) is outside "
1286 "the scope of libguestfs, but usually a simple character replacement will "
1287 "work."
1288 msgstr ""
1289
1290 #. type: textblock
1291 #: ../src/guestfs.pod:651
1292 msgid ""
1293 "To resolve the case insensitivity of paths, call "
1294 "L</guestfs_case_sensitive_path>."
1295 msgstr ""
1296
1297 #. type: =head3
1298 #: ../src/guestfs.pod:654
1299 msgid "ACCESSING THE WINDOWS REGISTRY"
1300 msgstr ""
1301
1302 #. type: textblock
1303 #: ../src/guestfs.pod:656
1304 msgid ""
1305 "Libguestfs also provides some help for decoding Windows Registry \"hive\" "
1306 "files, through the library C<hivex> which is part of the libguestfs project "
1307 "although ships as a separate tarball.  You have to locate and download the "
1308 "hive file(s) yourself, and then pass them to C<hivex> functions.  See also "
1309 "the programs L<hivexml(1)>, L<hivexsh(1)>, L<hivexregedit(1)> and "
1310 "L<virt-win-reg(1)> for more help on this issue."
1311 msgstr ""
1312
1313 #. type: =head3
1314 #: ../src/guestfs.pod:664
1315 msgid "SYMLINKS ON NTFS-3G FILESYSTEMS"
1316 msgstr ""
1317
1318 #. type: textblock
1319 #: ../src/guestfs.pod:666
1320 msgid ""
1321 "Ntfs-3g tries to rewrite \"Junction Points\" and NTFS \"symbolic links\" to "
1322 "provide something which looks like a Linux symlink.  The way it tries to do "
1323 "the rewriting is described here:"
1324 msgstr ""
1325
1326 #. type: textblock
1327 #: ../src/guestfs.pod:670
1328 msgid "L<http://www.tuxera.com/community/ntfs-3g-advanced/junction-points-and-symbolic-links/>"
1329 msgstr ""
1330
1331 #. type: textblock
1332 #: ../src/guestfs.pod:672
1333 msgid ""
1334 "The essential problem is that ntfs-3g simply does not have enough "
1335 "information to do a correct job.  NTFS links can contain drive letters and "
1336 "references to external device GUIDs that ntfs-3g has no way of resolving.  "
1337 "It is almost certainly the case that libguestfs callers should ignore what "
1338 "ntfs-3g does (ie. don't use L</guestfs_readlink> on NTFS volumes)."
1339 msgstr ""
1340
1341 #. type: textblock
1342 #: ../src/guestfs.pod:679
1343 msgid ""
1344 "Instead if you encounter a symbolic link on an ntfs-3g filesystem, use "
1345 "L</guestfs_lgetxattr> to read the C<system.ntfs_reparse_data> extended "
1346 "attribute, and read the raw reparse data from that (you can find the format "
1347 "documented in various places around the web)."
1348 msgstr ""
1349
1350 #. type: =head3
1351 #: ../src/guestfs.pod:684
1352 msgid "EXTENDED ATTRIBUTES ON NTFS-3G FILESYSTEMS"
1353 msgstr ""
1354
1355 #. type: textblock
1356 #: ../src/guestfs.pod:686
1357 msgid ""
1358 "There are other useful extended attributes that can be read from ntfs-3g "
1359 "filesystems (using L</guestfs_getxattr>).  See:"
1360 msgstr ""
1361
1362 #. type: textblock
1363 #: ../src/guestfs.pod:689
1364 msgid "L<http://www.tuxera.com/community/ntfs-3g-advanced/extended-attributes/>"
1365 msgstr ""
1366
1367 #. type: =head2
1368 #: ../src/guestfs.pod:691
1369 msgid "USING LIBGUESTFS WITH OTHER PROGRAMMING LANGUAGES"
1370 msgstr ""
1371
1372 #. type: textblock
1373 #: ../src/guestfs.pod:693
1374 msgid ""
1375 "Although we don't want to discourage you from using the C API, we will "
1376 "mention here that the same API is also available in other languages."
1377 msgstr ""
1378
1379 #. type: textblock
1380 #: ../src/guestfs.pod:696
1381 msgid ""
1382 "The API is broadly identical in all supported languages.  This means that "
1383 "the C call C<guestfs_add_drive_ro(g,file)> is C<$g-E<gt>add_drive_ro($file)> "
1384 "in Perl, C<g.add_drive_ro(file)> in Python, and C<g#add_drive_ro file> in "
1385 "OCaml.  In other words, a straightforward, predictable isomorphism between "
1386 "each language."
1387 msgstr ""
1388
1389 #. type: textblock
1390 #: ../src/guestfs.pod:702
1391 msgid ""
1392 "Error messages are automatically transformed into exceptions if the language "
1393 "supports it."
1394 msgstr ""
1395
1396 #. type: textblock
1397 #: ../src/guestfs.pod:705
1398 msgid ""
1399 "We don't try to \"object orientify\" parts of the API in OO languages, "
1400 "although contributors are welcome to write higher level APIs above what we "
1401 "provide in their favourite languages if they wish."
1402 msgstr ""
1403
1404 #. type: =item
1405 #: ../src/guestfs.pod:711
1406 msgid "B<C++>"
1407 msgstr ""
1408
1409 #. type: textblock
1410 #: ../src/guestfs.pod:713
1411 msgid ""
1412 "You can use the I<guestfs.h> header file from C++ programs.  The C++ API is "
1413 "identical to the C API.  C++ classes and exceptions are not used."
1414 msgstr ""
1415
1416 #. type: =item
1417 #: ../src/guestfs.pod:717
1418 msgid "B<C#>"
1419 msgstr ""
1420
1421 #. type: textblock
1422 #: ../src/guestfs.pod:719
1423 msgid ""
1424 "The C# bindings are highly experimental.  Please read the warnings at the "
1425 "top of C<csharp/Libguestfs.cs>."
1426 msgstr ""
1427
1428 #. type: =item
1429 #: ../src/guestfs.pod:722
1430 msgid "B<Haskell>"
1431 msgstr ""
1432
1433 #. type: textblock
1434 #: ../src/guestfs.pod:724
1435 msgid ""
1436 "This is the only language binding that is working but incomplete.  Only "
1437 "calls which return simple integers have been bound in Haskell, and we are "
1438 "looking for help to complete this binding."
1439 msgstr ""
1440
1441 #. type: =item
1442 #: ../src/guestfs.pod:728
1443 msgid "B<Java>"
1444 msgstr ""
1445
1446 #. type: textblock
1447 #: ../src/guestfs.pod:730
1448 msgid ""
1449 "Full documentation is contained in the Javadoc which is distributed with "
1450 "libguestfs."
1451 msgstr ""
1452
1453 #. type: =item
1454 #: ../src/guestfs.pod:733
1455 msgid "B<OCaml>"
1456 msgstr ""
1457
1458 #. type: textblock
1459 #: ../src/guestfs.pod:735
1460 msgid "See L<guestfs-ocaml(3)>."
1461 msgstr ""
1462
1463 #. type: =item
1464 #: ../src/guestfs.pod:737
1465 msgid "B<Perl>"
1466 msgstr ""
1467
1468 #. type: textblock
1469 #: ../src/guestfs.pod:739
1470 msgid "See L<guestfs-perl(3)> and L<Sys::Guestfs(3)>."
1471 msgstr ""
1472
1473 #. type: =item
1474 #: ../src/guestfs.pod:741
1475 msgid "B<PHP>"
1476 msgstr ""
1477
1478 #. type: textblock
1479 #: ../src/guestfs.pod:743
1480 msgid ""
1481 "For documentation see C<README-PHP> supplied with libguestfs sources or in "
1482 "the php-libguestfs package for your distribution."
1483 msgstr ""
1484
1485 #. type: textblock
1486 #: ../src/guestfs.pod:746
1487 msgid "The PHP binding only works correctly on 64 bit machines."
1488 msgstr ""
1489
1490 #. type: =item
1491 #: ../src/guestfs.pod:748
1492 msgid "B<Python>"
1493 msgstr ""
1494
1495 #. type: textblock
1496 #: ../src/guestfs.pod:750
1497 msgid "See L<guestfs-python(3)>."
1498 msgstr ""
1499
1500 #. type: =item
1501 #: ../src/guestfs.pod:752
1502 msgid "B<Ruby>"
1503 msgstr ""
1504
1505 #. type: textblock
1506 #: ../src/guestfs.pod:754
1507 msgid "See L<guestfs-ruby(3)>."
1508 msgstr ""
1509
1510 #. type: =item
1511 #: ../src/guestfs.pod:756
1512 msgid "B<shell scripts>"
1513 msgstr ""
1514
1515 #. type: textblock
1516 #: ../src/guestfs.pod:758
1517 msgid "See L<guestfish(1)>."
1518 msgstr ""
1519
1520 #. type: =head2
1521 #: ../src/guestfs.pod:762
1522 msgid "LIBGUESTFS GOTCHAS"
1523 msgstr ""
1524
1525 #. type: textblock
1526 #: ../src/guestfs.pod:764
1527 msgid ""
1528 "L<http://en.wikipedia.org/wiki/Gotcha_(programming)>: \"A feature of a "
1529 "system [...] that works in the way it is documented but is counterintuitive "
1530 "and almost invites mistakes.\""
1531 msgstr ""
1532
1533 #. type: textblock
1534 #: ../src/guestfs.pod:768
1535 msgid ""
1536 "Since we developed libguestfs and the associated tools, there are several "
1537 "things we would have designed differently, but are now stuck with for "
1538 "backwards compatibility or other reasons.  If there is ever a libguestfs 2.0 "
1539 "release, you can expect these to change.  Beware of them."
1540 msgstr ""
1541
1542 #. type: =item
1543 #: ../src/guestfs.pod:776
1544 msgid "Autosync / forgetting to sync."
1545 msgstr ""
1546
1547 #. type: textblock
1548 #: ../src/guestfs.pod:778
1549 msgid ""
1550 "I<Update:> Autosync is enabled by default for all API users starting from "
1551 "libguestfs 1.5.24.  This section only applies to older versions."
1552 msgstr ""
1553
1554 #. type: textblock
1555 #: ../src/guestfs.pod:781
1556 msgid ""
1557 "When modifying a filesystem from C or another language, you B<must> unmount "
1558 "all filesystems and call L</guestfs_sync> explicitly before you close the "
1559 "libguestfs handle.  You can also call:"
1560 msgstr ""
1561
1562 #. type: verbatim
1563 #: ../src/guestfs.pod:785
1564 #, no-wrap
1565 msgid ""
1566 " guestfs_set_autosync (g, 1);\n"
1567 "\n"
1568 msgstr ""
1569
1570 #. type: textblock
1571 #: ../src/guestfs.pod:787
1572 msgid ""
1573 "to have the unmount/sync done automatically for you when the handle 'g' is "
1574 "closed.  (This feature is called \"autosync\", L</guestfs_set_autosync> "
1575 "q.v.)"
1576 msgstr ""
1577
1578 #. type: textblock
1579 #: ../src/guestfs.pod:791
1580 msgid ""
1581 "If you forget to do this, then it is entirely possible that your changes "
1582 "won't be written out, or will be partially written, or (very rarely) that "
1583 "you'll get disk corruption."
1584 msgstr ""
1585
1586 #. type: textblock
1587 #: ../src/guestfs.pod:795
1588 msgid ""
1589 "Note that in L<guestfish(3)> autosync is the default.  So quick and dirty "
1590 "guestfish scripts that forget to sync will work just fine, which can make "
1591 "this very puzzling if you are trying to debug a problem."
1592 msgstr ""
1593
1594 #. type: =item
1595 #: ../src/guestfs.pod:799
1596 msgid "Mount option C<-o sync> should not be the default."
1597 msgstr ""
1598
1599 #. type: textblock
1600 #: ../src/guestfs.pod:801
1601 msgid ""
1602 "If you use L</guestfs_mount>, then C<-o sync,noatime> are added implicitly.  "
1603 "However C<-o sync> does not add any reliability benefit, but does have a "
1604 "very large performance impact."
1605 msgstr ""
1606
1607 #. type: textblock
1608 #: ../src/guestfs.pod:805
1609 msgid ""
1610 "The work around is to use L</guestfs_mount_options> and set the mount "
1611 "options that you actually want to use."
1612 msgstr ""
1613
1614 #. type: =item
1615 #: ../src/guestfs.pod:808
1616 msgid "Read-only should be the default."
1617 msgstr ""
1618
1619 #. type: textblock
1620 #: ../src/guestfs.pod:810
1621 msgid ""
1622 "In L<guestfish(3)>, I<--ro> should be the default, and you should have to "
1623 "specify I<--rw> if you want to make changes to the image."
1624 msgstr ""
1625
1626 #. type: textblock
1627 #: ../src/guestfs.pod:813
1628 msgid "This would reduce the potential to corrupt live VM images."
1629 msgstr ""
1630
1631 #. type: textblock
1632 #: ../src/guestfs.pod:815
1633 msgid ""
1634 "Note that many filesystems change the disk when you just mount and unmount, "
1635 "even if you didn't perform any writes.  You need to use "
1636 "L</guestfs_add_drive_ro> to guarantee that the disk is not changed."
1637 msgstr ""
1638
1639 #. type: =item
1640 #: ../src/guestfs.pod:819
1641 msgid "guestfish command line is hard to use."
1642 msgstr ""
1643
1644 #. type: textblock
1645 #: ../src/guestfs.pod:821
1646 msgid ""
1647 "C<guestfish disk.img> doesn't do what people expect (open C<disk.img> for "
1648 "examination).  It tries to run a guestfish command C<disk.img> which doesn't "
1649 "exist, so it fails.  In earlier versions of guestfish the error message was "
1650 "also unintuitive, but we have corrected this since.  Like the Bourne shell, "
1651 "we should have used C<guestfish -c command> to run commands."
1652 msgstr ""
1653
1654 #. type: =item
1655 #: ../src/guestfs.pod:828
1656 msgid "guestfish megabyte modifiers don't work right on all commands"
1657 msgstr ""
1658
1659 #. type: textblock
1660 #: ../src/guestfs.pod:830
1661 msgid ""
1662 "In recent guestfish you can use C<1M> to mean 1 megabyte (and similarly for "
1663 "other modifiers).  What guestfish actually does is to multiply the number "
1664 "part by the modifier part and pass the result to the C API.  However this "
1665 "doesn't work for a few APIs which aren't expecting bytes, but are already "
1666 "expecting some other unit (eg. megabytes)."
1667 msgstr ""
1668
1669 #. type: textblock
1670 #: ../src/guestfs.pod:837
1671 msgid "The most common is L</guestfs_lvcreate>.  The guestfish command:"
1672 msgstr ""
1673
1674 #. type: verbatim
1675 #: ../src/guestfs.pod:839
1676 #, no-wrap
1677 msgid ""
1678 " lvcreate LV VG 100M\n"
1679 "\n"
1680 msgstr ""
1681
1682 #. type: textblock
1683 #: ../src/guestfs.pod:841
1684 msgid ""
1685 "does not do what you might expect.  Instead because L</guestfs_lvcreate> is "
1686 "already expecting megabytes, this tries to create a 100 I<terabyte> (100 "
1687 "megabytes * megabytes) logical volume.  The error message you get from this "
1688 "is also a little obscure."
1689 msgstr ""
1690
1691 #. type: textblock
1692 #: ../src/guestfs.pod:846
1693 msgid ""
1694 "This could be fixed in the generator by specially marking parameters and "
1695 "return values which take bytes or other units."
1696 msgstr ""
1697
1698 #. type: =item
1699 #: ../src/guestfs.pod:849
1700 msgid "Ambiguity between devices and paths"
1701 msgstr ""
1702
1703 #. type: textblock
1704 #: ../src/guestfs.pod:851
1705 msgid ""
1706 "There is a subtle ambiguity in the API between a device name "
1707 "(eg. C</dev/sdb2>) and a similar pathname.  A file might just happen to be "
1708 "called C<sdb2> in the directory C</dev> (consider some non-Unix VM image)."
1709 msgstr ""
1710
1711 #. type: textblock
1712 #: ../src/guestfs.pod:856
1713 msgid ""
1714 "In the current API we usually resolve this ambiguity by having two separate "
1715 "calls, for example L</guestfs_checksum> and L</guestfs_checksum_device>.  "
1716 "Some API calls are ambiguous and (incorrectly) resolve the problem by "
1717 "detecting if the path supplied begins with C</dev/>."
1718 msgstr ""
1719
1720 #. type: textblock
1721 #: ../src/guestfs.pod:862
1722 msgid ""
1723 "To avoid both the ambiguity and the need to duplicate some calls, we could "
1724 "make paths/devices into structured names.  One way to do this would be to "
1725 "use a notation like grub (C<hd(0,0)>), although nobody really likes this "
1726 "aspect of grub.  Another way would be to use a structured type, equivalent "
1727 "to this OCaml type:"
1728 msgstr ""
1729
1730 #. type: verbatim
1731 #: ../src/guestfs.pod:868
1732 #, no-wrap
1733 msgid ""
1734 " type path = Path of string | Device of int | Partition of int * int\n"
1735 "\n"
1736 msgstr ""
1737
1738 #. type: textblock
1739 #: ../src/guestfs.pod:870
1740 msgid "which would allow you to pass arguments like:"
1741 msgstr ""
1742
1743 #. type: verbatim
1744 #: ../src/guestfs.pod:872
1745 #, no-wrap
1746 msgid ""
1747 " Path \"/foo/bar\"\n"
1748 " Device 1            (* /dev/sdb, or perhaps /dev/sda *)\n"
1749 " Partition (1, 2)    (* /dev/sdb2 (or is it /dev/sda2 or /dev/sdb3?) *)\n"
1750 " Path \"/dev/sdb2\"    (* not a device *)\n"
1751 "\n"
1752 msgstr ""
1753
1754 #. type: textblock
1755 #: ../src/guestfs.pod:877
1756 msgid ""
1757 "As you can see there are still problems to resolve even with this "
1758 "representation.  Also consider how it might work in guestfish."
1759 msgstr ""
1760
1761 #. type: =head2
1762 #: ../src/guestfs.pod:882
1763 msgid "KEYS AND PASSPHRASES"
1764 msgstr ""
1765
1766 #. type: textblock
1767 #: ../src/guestfs.pod:884
1768 msgid ""
1769 "Certain libguestfs calls take a parameter that contains sensitive key "
1770 "material, passed in as a C string."
1771 msgstr ""
1772
1773 #. type: textblock
1774 #: ../src/guestfs.pod:887
1775 msgid ""
1776 "In the future we would hope to change the libguestfs implementation so that "
1777 "keys are L<mlock(2)>-ed into physical RAM, and thus can never end up in "
1778 "swap.  However this is I<not> done at the moment, because of the complexity "
1779 "of such an implementation."
1780 msgstr ""
1781
1782 #. type: textblock
1783 #: ../src/guestfs.pod:892
1784 msgid ""
1785 "Therefore you should be aware that any key parameter you pass to libguestfs "
1786 "might end up being written out to the swap partition.  If this is a concern, "
1787 "scrub the swap partition or don't use libguestfs on encrypted devices."
1788 msgstr ""
1789
1790 #. type: =head2
1791 #: ../src/guestfs.pod:897
1792 msgid "MULTIPLE HANDLES AND MULTIPLE THREADS"
1793 msgstr ""
1794
1795 #. type: textblock
1796 #: ../src/guestfs.pod:899
1797 msgid ""
1798 "All high-level libguestfs actions are synchronous.  If you want to use "
1799 "libguestfs asynchronously then you must create a thread."
1800 msgstr ""
1801
1802 #. type: textblock
1803 #: ../src/guestfs.pod:902
1804 msgid ""
1805 "Only use the handle from a single thread.  Either use the handle exclusively "
1806 "from one thread, or provide your own mutex so that two threads cannot issue "
1807 "calls on the same handle at the same time."
1808 msgstr ""
1809
1810 #. type: textblock
1811 #: ../src/guestfs.pod:906
1812 msgid ""
1813 "See the graphical program guestfs-browser for one possible architecture for "
1814 "multithreaded programs using libvirt and libguestfs."
1815 msgstr ""
1816
1817 #. type: =head2
1818 #: ../src/guestfs.pod:909
1819 msgid "PATH"
1820 msgstr ""
1821
1822 #. type: textblock
1823 #: ../src/guestfs.pod:911
1824 msgid ""
1825 "Libguestfs needs a supermin appliance, which it finds by looking along an "
1826 "internal path."
1827 msgstr ""
1828
1829 #. type: textblock
1830 #: ../src/guestfs.pod:914
1831 msgid ""
1832 "By default it looks for these in the directory C<$libdir/guestfs> "
1833 "(eg. C</usr/local/lib/guestfs> or C</usr/lib64/guestfs>)."
1834 msgstr ""
1835
1836 #. type: textblock
1837 #: ../src/guestfs.pod:917
1838 msgid ""
1839 "Use L</guestfs_set_path> or set the environment variable L</LIBGUESTFS_PATH> "
1840 "to change the directories that libguestfs will search in.  The value is a "
1841 "colon-separated list of paths.  The current directory is I<not> searched "
1842 "unless the path contains an empty element or C<.>.  For example "
1843 "C<LIBGUESTFS_PATH=:/usr/lib/guestfs> would search the current directory and "
1844 "then C</usr/lib/guestfs>."
1845 msgstr ""
1846
1847 #. type: =head2
1848 #: ../src/guestfs.pod:924
1849 msgid "QEMU WRAPPERS"
1850 msgstr ""
1851
1852 #. type: textblock
1853 #: ../src/guestfs.pod:926
1854 msgid ""
1855 "If you want to compile your own qemu, run qemu from a non-standard location, "
1856 "or pass extra arguments to qemu, then you can write a shell-script wrapper "
1857 "around qemu."
1858 msgstr ""
1859
1860 #. type: textblock
1861 #: ../src/guestfs.pod:930
1862 msgid ""
1863 "There is one important rule to remember: you I<must C<exec qemu>> as the "
1864 "last command in the shell script (so that qemu replaces the shell and "
1865 "becomes the direct child of the libguestfs-using program).  If you don't do "
1866 "this, then the qemu process won't be cleaned up correctly."
1867 msgstr ""
1868
1869 #. type: textblock
1870 #: ../src/guestfs.pod:935
1871 msgid ""
1872 "Here is an example of a wrapper, where I have built my own copy of qemu from "
1873 "source:"
1874 msgstr ""
1875
1876 #. type: verbatim
1877 #: ../src/guestfs.pod:938
1878 #, no-wrap
1879 msgid ""
1880 " #!/bin/sh -\n"
1881 " qemudir=/home/rjones/d/qemu\n"
1882 " exec $qemudir/x86_64-softmmu/qemu-system-x86_64 -L $qemudir/pc-bios "
1883 "\"$@\"\n"
1884 "\n"
1885 msgstr ""
1886
1887 #. type: textblock
1888 #: ../src/guestfs.pod:942
1889 msgid ""
1890 "Save this script as C</tmp/qemu.wrapper> (or wherever), C<chmod +x>, and "
1891 "then use it by setting the LIBGUESTFS_QEMU environment variable.  For "
1892 "example:"
1893 msgstr ""
1894
1895 #. type: verbatim
1896 #: ../src/guestfs.pod:946
1897 #, no-wrap
1898 msgid ""
1899 " LIBGUESTFS_QEMU=/tmp/qemu.wrapper guestfish\n"
1900 "\n"
1901 msgstr ""
1902
1903 #. type: textblock
1904 #: ../src/guestfs.pod:948
1905 msgid ""
1906 "Note that libguestfs also calls qemu with the -help and -version options in "
1907 "order to determine features."
1908 msgstr ""
1909
1910 #. type: =head2
1911 #: ../src/guestfs.pod:951
1912 msgid "ATTACHING TO RUNNING DAEMONS"
1913 msgstr ""
1914
1915 #. type: textblock
1916 #: ../src/guestfs.pod:953
1917 msgid ""
1918 "I<Note (1):> This is B<highly experimental> and has a tendency to eat "
1919 "babies.  Use with caution."
1920 msgstr ""
1921
1922 #. type: textblock
1923 #: ../src/guestfs.pod:956
1924 msgid ""
1925 "I<Note (2):> This section explains how to attach to a running daemon from a "
1926 "low level perspective.  For most users, simply using virt tools such as "
1927 "L<guestfish(1)> with the I<--live> option will \"just work\"."
1928 msgstr ""
1929
1930 #. type: =head3
1931 #: ../src/guestfs.pod:960
1932 msgid "Using guestfs_set_attach_method"
1933 msgstr ""
1934
1935 #. type: textblock
1936 #: ../src/guestfs.pod:962
1937 msgid ""
1938 "By calling L</guestfs_set_attach_method> you can change how the library "
1939 "connects to the C<guestfsd> daemon in L</guestfs_launch> (read "
1940 "L</ARCHITECTURE> for some background)."
1941 msgstr ""
1942
1943 #. type: textblock
1944 #: ../src/guestfs.pod:966
1945 msgid ""
1946 "The normal attach method is C<appliance>, where a small appliance is created "
1947 "containing the daemon, and then the library connects to this."
1948 msgstr ""
1949
1950 #. type: textblock
1951 #: ../src/guestfs.pod:969
1952 msgid ""
1953 "Setting attach method to C<unix:I<path>> (where I<path> is the path of a "
1954 "Unix domain socket) causes L</guestfs_launch> to connect to an existing "
1955 "daemon over the Unix domain socket."
1956 msgstr ""
1957
1958 #. type: textblock
1959 #: ../src/guestfs.pod:973
1960 msgid ""
1961 "The normal use for this is to connect to a running virtual machine that "
1962 "contains a C<guestfsd> daemon, and send commands so you can read and write "
1963 "files inside the live virtual machine."
1964 msgstr ""
1965
1966 #. type: =head3
1967 #: ../src/guestfs.pod:977
1968 msgid "Using guestfs_add_domain with live flag"
1969 msgstr ""
1970
1971 #. type: textblock
1972 #: ../src/guestfs.pod:979
1973 msgid ""
1974 "L</guestfs_add_domain> provides some help for getting the correct attach "
1975 "method.  If you pass the C<live> option to this function, then (if the "
1976 "virtual machine is running) it will examine the libvirt XML looking for a "
1977 "virtio-serial channel to connect to:"
1978 msgstr ""
1979
1980 #. type: verbatim
1981 #: ../src/guestfs.pod:985
1982 #, no-wrap
1983 msgid ""
1984 " <domain>\n"
1985 "   ...\n"
1986 "   <devices>\n"
1987 "     ...\n"
1988 "     <channel type='unix'>\n"
1989 "       <source mode='bind' path='/path/to/socket'/>\n"
1990 "       <target type='virtio' name='org.libguestfs.channel.0'/>\n"
1991 "     </channel>\n"
1992 "     ...\n"
1993 "   </devices>\n"
1994 " </domain>\n"
1995 "\n"
1996 msgstr ""
1997
1998 #. type: textblock
1999 #: ../src/guestfs.pod:997
2000 msgid ""
2001 "L</guestfs_add_domain> extracts C</path/to/socket> and sets the attach "
2002 "method to C<unix:/path/to/socket>."
2003 msgstr ""
2004
2005 #. type: textblock
2006 #: ../src/guestfs.pod:1000
2007 msgid ""
2008 "Some of the libguestfs tools (including guestfish) support a I<--live> "
2009 "option which is passed through to L</guestfs_add_domain> thus allowing you "
2010 "to attach to and modify live virtual machines."
2011 msgstr ""
2012
2013 #. type: textblock
2014 #: ../src/guestfs.pod:1004
2015 msgid ""
2016 "The virtual machine needs to have been set up beforehand so that it has the "
2017 "virtio-serial channel and so that guestfsd is running inside it."
2018 msgstr ""
2019
2020 #. type: =head2
2021 #: ../src/guestfs.pod:1008
2022 msgid "ABI GUARANTEE"
2023 msgstr ""
2024
2025 #. type: textblock
2026 #: ../src/guestfs.pod:1010
2027 msgid ""
2028 "We guarantee the libguestfs ABI (binary interface), for public, high-level "
2029 "actions as outlined in this section.  Although we will deprecate some "
2030 "actions, for example if they get replaced by newer calls, we will keep the "
2031 "old actions forever.  This allows you the developer to program in confidence "
2032 "against the libguestfs API."
2033 msgstr ""
2034
2035 #. type: =head2
2036 #: ../src/guestfs.pod:1016
2037 msgid "BLOCK DEVICE NAMING"
2038 msgstr ""
2039
2040 #. type: textblock
2041 #: ../src/guestfs.pod:1018
2042 msgid ""
2043 "In the kernel there is now quite a profusion of schemata for naming block "
2044 "devices (in this context, by I<block device> I mean a physical or virtual "
2045 "hard drive).  The original Linux IDE driver used names starting with "
2046 "C</dev/hd*>.  SCSI devices have historically used a different naming scheme, "
2047 "C</dev/sd*>.  When the Linux kernel I<libata> driver became a popular "
2048 "replacement for the old IDE driver (particularly for SATA devices) those "
2049 "devices also used the C</dev/sd*> scheme.  Additionally we now have virtual "
2050 "machines with paravirtualized drivers.  This has created several different "
2051 "naming systems, such as C</dev/vd*> for virtio disks and C</dev/xvd*> for "
2052 "Xen PV disks."
2053 msgstr ""
2054
2055 #. type: textblock
2056 #: ../src/guestfs.pod:1030
2057 msgid ""
2058 "As discussed above, libguestfs uses a qemu appliance running an embedded "
2059 "Linux kernel to access block devices.  We can run a variety of appliances "
2060 "based on a variety of Linux kernels."
2061 msgstr ""
2062
2063 #. type: textblock
2064 #: ../src/guestfs.pod:1034
2065 msgid ""
2066 "This causes a problem for libguestfs because many API calls use device or "
2067 "partition names.  Working scripts and the recipe (example) scripts that we "
2068 "make available over the internet could fail if the naming scheme changes."
2069 msgstr ""
2070
2071 #. type: textblock
2072 #: ../src/guestfs.pod:1039
2073 msgid ""
2074 "Therefore libguestfs defines C</dev/sd*> as the I<standard naming scheme>.  "
2075 "Internally C</dev/sd*> names are translated, if necessary, to other names as "
2076 "required.  For example, under RHEL 5 which uses the C</dev/hd*> scheme, any "
2077 "device parameter C</dev/sda2> is translated to C</dev/hda2> transparently."
2078 msgstr ""
2079
2080 #. type: textblock
2081 #: ../src/guestfs.pod:1045
2082 msgid ""
2083 "Note that this I<only> applies to parameters.  The L</guestfs_list_devices>, "
2084 "L</guestfs_list_partitions> and similar calls return the true names of the "
2085 "devices and partitions as known to the appliance."
2086 msgstr ""
2087
2088 #. type: =head3
2089 #: ../src/guestfs.pod:1050
2090 msgid "ALGORITHM FOR BLOCK DEVICE NAME TRANSLATION"
2091 msgstr ""
2092
2093 #. type: textblock
2094 #: ../src/guestfs.pod:1052
2095 msgid ""
2096 "Usually this translation is transparent.  However in some (very rare)  cases "
2097 "you may need to know the exact algorithm.  Such cases include where you use "
2098 "L</guestfs_config> to add a mixture of virtio and IDE devices to the "
2099 "qemu-based appliance, so have a mixture of C</dev/sd*> and C</dev/vd*> "
2100 "devices."
2101 msgstr ""
2102
2103 #. type: textblock
2104 #: ../src/guestfs.pod:1058
2105 msgid ""
2106 "The algorithm is applied only to I<parameters> which are known to be either "
2107 "device or partition names.  Return values from functions such as "
2108 "L</guestfs_list_devices> are never changed."
2109 msgstr ""
2110
2111 #. type: textblock
2112 #: ../src/guestfs.pod:1066
2113 msgid "Is the string a parameter which is a device or partition name?"
2114 msgstr ""
2115
2116 #. type: textblock
2117 #: ../src/guestfs.pod:1070
2118 msgid "Does the string begin with C</dev/sd>?"
2119 msgstr ""
2120
2121 #. type: textblock
2122 #: ../src/guestfs.pod:1074
2123 msgid ""
2124 "Does the named device exist? If so, we use that device.  However if I<not> "
2125 "then we continue with this algorithm."
2126 msgstr ""
2127
2128 #. type: textblock
2129 #: ../src/guestfs.pod:1079
2130 msgid "Replace initial C</dev/sd> string with C</dev/hd>."
2131 msgstr ""
2132
2133 #. type: textblock
2134 #: ../src/guestfs.pod:1081
2135 msgid "For example, change C</dev/sda2> to C</dev/hda2>."
2136 msgstr ""
2137
2138 #. type: textblock
2139 #: ../src/guestfs.pod:1083
2140 msgid "If that named device exists, use it.  If not, continue."
2141 msgstr ""
2142
2143 #. type: textblock
2144 #: ../src/guestfs.pod:1087
2145 msgid "Replace initial C</dev/sd> string with C</dev/vd>."
2146 msgstr ""
2147
2148 #. type: textblock
2149 #: ../src/guestfs.pod:1089
2150 msgid "If that named device exists, use it.  If not, return an error."
2151 msgstr ""
2152
2153 #. type: =head3
2154 #: ../src/guestfs.pod:1093
2155 msgid "PORTABILITY CONCERNS WITH BLOCK DEVICE NAMING"
2156 msgstr ""
2157
2158 #. type: textblock
2159 #: ../src/guestfs.pod:1095
2160 msgid ""
2161 "Although the standard naming scheme and automatic translation is useful for "
2162 "simple programs and guestfish scripts, for larger programs it is best not to "
2163 "rely on this mechanism."
2164 msgstr ""
2165
2166 #. type: textblock
2167 #: ../src/guestfs.pod:1099
2168 msgid ""
2169 "Where possible for maximum future portability programs using libguestfs "
2170 "should use these future-proof techniques:"
2171 msgstr ""
2172
2173 #. type: textblock
2174 #: ../src/guestfs.pod:1106
2175 msgid ""
2176 "Use L</guestfs_list_devices> or L</guestfs_list_partitions> to list actual "
2177 "device names, and then use those names directly."
2178 msgstr ""
2179
2180 #. type: textblock
2181 #: ../src/guestfs.pod:1109
2182 msgid "Since those device names exist by definition, they will never be translated."
2183 msgstr ""
2184
2185 #. type: textblock
2186 #: ../src/guestfs.pod:1114
2187 msgid ""
2188 "Use higher level ways to identify filesystems, such as LVM names, UUIDs and "
2189 "filesystem labels."
2190 msgstr ""
2191
2192 #. type: =head1
2193 #: ../src/guestfs.pod:1119
2194 msgid "SECURITY"
2195 msgstr ""
2196
2197 #. type: textblock
2198 #: ../src/guestfs.pod:1121
2199 msgid ""
2200 "This section discusses security implications of using libguestfs, "
2201 "particularly with untrusted or malicious guests or disk images."
2202 msgstr ""
2203
2204 #. type: =head2
2205 #: ../src/guestfs.pod:1124
2206 msgid "GENERAL SECURITY CONSIDERATIONS"
2207 msgstr ""
2208
2209 #. type: textblock
2210 #: ../src/guestfs.pod:1126
2211 msgid ""
2212 "Be careful with any files or data that you download from a guest (by "
2213 "\"download\" we mean not just the L</guestfs_download> command but any "
2214 "command that reads files, filenames, directories or anything else from a "
2215 "disk image).  An attacker could manipulate the data to fool your program "
2216 "into doing the wrong thing.  Consider cases such as:"
2217 msgstr ""
2218
2219 #. type: textblock
2220 #: ../src/guestfs.pod:1136
2221 msgid "the data (file etc) not being present"
2222 msgstr ""
2223
2224 #. type: textblock
2225 #: ../src/guestfs.pod:1140
2226 msgid "being present but empty"
2227 msgstr ""
2228
2229 #. type: textblock
2230 #: ../src/guestfs.pod:1144
2231 msgid "being much larger than normal"
2232 msgstr ""
2233
2234 #. type: textblock
2235 #: ../src/guestfs.pod:1148
2236 msgid "containing arbitrary 8 bit data"
2237 msgstr ""
2238
2239 #. type: textblock
2240 #: ../src/guestfs.pod:1152
2241 msgid "being in an unexpected character encoding"
2242 msgstr ""
2243
2244 #. type: textblock
2245 #: ../src/guestfs.pod:1156
2246 msgid "containing homoglyphs."
2247 msgstr ""
2248
2249 #. type: =head2
2250 #: ../src/guestfs.pod:1160
2251 msgid "SECURITY OF MOUNTING FILESYSTEMS"
2252 msgstr ""
2253
2254 #. type: textblock
2255 #: ../src/guestfs.pod:1162
2256 msgid ""
2257 "When you mount a filesystem under Linux, mistakes in the kernel filesystem "
2258 "(VFS) module can sometimes be escalated into exploits by deliberately "
2259 "creating a malicious, malformed filesystem.  These exploits are very severe "
2260 "for two reasons.  Firstly there are very many filesystem drivers in the "
2261 "kernel, and many of them are infrequently used and not much developer "
2262 "attention has been paid to the code.  Linux userspace helps potential "
2263 "crackers by detecting the filesystem type and automatically choosing the "
2264 "right VFS driver, even if that filesystem type is obscure or unexpected for "
2265 "the administrator.  Secondly, a kernel-level exploit is like a local root "
2266 "exploit (worse in some ways), giving immediate and total access to the "
2267 "system right down to the hardware level."
2268 msgstr ""
2269
2270 #. type: textblock
2271 #: ../src/guestfs.pod:1175
2272 msgid ""
2273 "That explains why you should never mount a filesystem from an untrusted "
2274 "guest on your host kernel.  How about libguestfs? We run a Linux kernel "
2275 "inside a qemu virtual machine, usually running as a non-root user.  The "
2276 "attacker would need to write a filesystem which first exploited the kernel, "
2277 "and then exploited either qemu virtualization (eg. a faulty qemu driver) or "
2278 "the libguestfs protocol, and finally to be as serious as the host kernel "
2279 "exploit it would need to escalate its privileges to root.  This multi-step "
2280 "escalation, performed by a static piece of data, is thought to be extremely "
2281 "hard to do, although we never say 'never' about security issues."
2282 msgstr ""
2283
2284 #. type: textblock
2285 #: ../src/guestfs.pod:1186
2286 msgid ""
2287 "In any case callers can reduce the attack surface by forcing the filesystem "
2288 "type when mounting (use L</guestfs_mount_vfs>)."
2289 msgstr ""
2290
2291 #. type: =head2
2292 #: ../src/guestfs.pod:1189
2293 msgid "PROTOCOL SECURITY"
2294 msgstr ""
2295
2296 #. type: textblock
2297 #: ../src/guestfs.pod:1191
2298 msgid ""
2299 "The protocol is designed to be secure, being based on RFC 4506 (XDR)  with a "
2300 "defined upper message size.  However a program that uses libguestfs must "
2301 "also take care - for example you can write a program that downloads a binary "
2302 "from a disk image and executes it locally, and no amount of protocol "
2303 "security will save you from the consequences."
2304 msgstr ""
2305
2306 #. type: =head2
2307 #: ../src/guestfs.pod:1197
2308 msgid "INSPECTION SECURITY"
2309 msgstr ""
2310
2311 #. type: textblock
2312 #: ../src/guestfs.pod:1199
2313 msgid ""
2314 "Parts of the inspection API (see L</INSPECTION>) return untrusted strings "
2315 "directly from the guest, and these could contain any 8 bit data.  Callers "
2316 "should be careful to escape these before printing them to a structured file "
2317 "(for example, use HTML escaping if creating a web page)."
2318 msgstr ""
2319
2320 #. type: textblock
2321 #: ../src/guestfs.pod:1205
2322 msgid ""
2323 "Guest configuration may be altered in unusual ways by the administrator of "
2324 "the virtual machine, and may not reflect reality (particularly for untrusted "
2325 "or actively malicious guests).  For example we parse the hostname from "
2326 "configuration files like C</etc/sysconfig/network> that we find in the "
2327 "guest, but the guest administrator can easily manipulate these files to "
2328 "provide the wrong hostname."
2329 msgstr ""
2330
2331 #. type: textblock
2332 #: ../src/guestfs.pod:1213
2333 msgid ""
2334 "The inspection API parses guest configuration using two external libraries: "
2335 "Augeas (Linux configuration) and hivex (Windows Registry).  Both are "
2336 "designed to be robust in the face of malicious data, although denial of "
2337 "service attacks are still possible, for example with oversized configuration "
2338 "files."
2339 msgstr ""
2340
2341 #. type: =head2
2342 #: ../src/guestfs.pod:1219
2343 msgid "RUNNING UNTRUSTED GUEST COMMANDS"
2344 msgstr ""
2345
2346 #. type: textblock
2347 #: ../src/guestfs.pod:1221
2348 msgid ""
2349 "Be very cautious about running commands from the guest.  By running a "
2350 "command in the guest, you are giving CPU time to a binary that you do not "
2351 "control, under the same user account as the library, albeit wrapped in qemu "
2352 "virtualization.  More information and alternatives can be found in the "
2353 "section L</RUNNING COMMANDS>."
2354 msgstr ""
2355
2356 #. type: =head2
2357 #: ../src/guestfs.pod:1227
2358 msgid "CVE-2010-3851"
2359 msgstr ""
2360
2361 #. type: textblock
2362 #: ../src/guestfs.pod:1229
2363 msgid "https://bugzilla.redhat.com/642934"
2364 msgstr ""
2365
2366 #. type: textblock
2367 #: ../src/guestfs.pod:1231
2368 msgid ""
2369 "This security bug concerns the automatic disk format detection that qemu "
2370 "does on disk images."
2371 msgstr ""
2372
2373 #. type: textblock
2374 #: ../src/guestfs.pod:1234
2375 msgid ""
2376 "A raw disk image is just the raw bytes, there is no header.  Other disk "
2377 "images like qcow2 contain a special header.  Qemu deals with this by looking "
2378 "for one of the known headers, and if none is found then assuming the disk "
2379 "image must be raw."
2380 msgstr ""
2381
2382 #. type: textblock
2383 #: ../src/guestfs.pod:1239
2384 msgid ""
2385 "This allows a guest which has been given a raw disk image to write some "
2386 "other header.  At next boot (or when the disk image is accessed by "
2387 "libguestfs) qemu would do autodetection and think the disk image format was, "
2388 "say, qcow2 based on the header written by the guest."
2389 msgstr ""
2390
2391 #. type: textblock
2392 #: ../src/guestfs.pod:1244
2393 msgid ""
2394 "This in itself would not be a problem, but qcow2 offers many features, one "
2395 "of which is to allow a disk image to refer to another image (called the "
2396 "\"backing disk\").  It does this by placing the path to the backing disk "
2397 "into the qcow2 header.  This path is not validated and could point to any "
2398 "host file (eg. \"/etc/passwd\").  The backing disk is then exposed through "
2399 "\"holes\" in the qcow2 disk image, which of course is completely under the "
2400 "control of the attacker."
2401 msgstr ""
2402
2403 #. type: textblock
2404 #: ../src/guestfs.pod:1252
2405 msgid "In libguestfs this is rather hard to exploit except under two circumstances:"
2406 msgstr ""
2407
2408 #. type: textblock
2409 #: ../src/guestfs.pod:1259
2410 msgid "You have enabled the network or have opened the disk in write mode."
2411 msgstr ""
2412
2413 #. type: textblock
2414 #: ../src/guestfs.pod:1263
2415 msgid ""
2416 "You are also running untrusted code from the guest (see L</RUNNING "
2417 "COMMANDS>)."
2418 msgstr ""
2419
2420 #. type: textblock
2421 #: ../src/guestfs.pod:1268
2422 msgid ""
2423 "The way to avoid this is to specify the expected disk format when adding "
2424 "disks (the optional C<format> option to L</guestfs_add_drive_opts>).  You "
2425 "should always do this if the disk is raw format, and it's a good idea for "
2426 "other cases too."
2427 msgstr ""
2428
2429 #. type: textblock
2430 #: ../src/guestfs.pod:1273
2431 msgid ""
2432 "For disks added from libvirt using calls like L</guestfs_add_domain>, the "
2433 "format is fetched from libvirt and passed through."
2434 msgstr ""
2435
2436 #. type: textblock
2437 #: ../src/guestfs.pod:1276
2438 msgid ""
2439 "For libguestfs tools, use the I<--format> command line parameter as "
2440 "appropriate."
2441 msgstr ""
2442
2443 #. type: =head1
2444 #: ../src/guestfs.pod:1279
2445 msgid "CONNECTION MANAGEMENT"
2446 msgstr ""
2447
2448 #. type: =head2
2449 #: ../src/guestfs.pod:1281
2450 msgid "guestfs_h *"
2451 msgstr ""
2452
2453 #. type: textblock
2454 #: ../src/guestfs.pod:1283
2455 msgid ""
2456 "C<guestfs_h> is the opaque type representing a connection handle.  Create a "
2457 "handle by calling L</guestfs_create>.  Call L</guestfs_close> to free the "
2458 "handle and release all resources used."
2459 msgstr ""
2460
2461 #. type: textblock
2462 #: ../src/guestfs.pod:1287
2463 msgid ""
2464 "For information on using multiple handles and threads, see the section "
2465 "L</MULTIPLE HANDLES AND MULTIPLE THREADS> above."
2466 msgstr ""
2467
2468 #. type: =head2
2469 #: ../src/guestfs.pod:1290
2470 msgid "guestfs_create"
2471 msgstr ""
2472
2473 #. type: verbatim
2474 #: ../src/guestfs.pod:1292
2475 #, no-wrap
2476 msgid ""
2477 " guestfs_h *guestfs_create (void);\n"
2478 "\n"
2479 msgstr ""
2480
2481 #. type: textblock
2482 #: ../src/guestfs.pod:1294
2483 msgid "Create a connection handle."
2484 msgstr ""
2485
2486 #. type: textblock
2487 #: ../src/guestfs.pod:1296
2488 msgid ""
2489 "On success this returns a non-NULL pointer to a handle.  On error it returns "
2490 "NULL."
2491 msgstr ""
2492
2493 #. type: textblock
2494 #: ../src/guestfs.pod:1299
2495 msgid ""
2496 "You have to \"configure\" the handle after creating it.  This includes "
2497 "calling L</guestfs_add_drive_opts> (or one of the equivalent calls) on the "
2498 "handle at least once."
2499 msgstr ""
2500
2501 #. type: textblock
2502 #: ../src/guestfs.pod:1303
2503 msgid "After configuring the handle, you have to call L</guestfs_launch>."
2504 msgstr ""
2505
2506 #. type: textblock
2507 #: ../src/guestfs.pod:1305
2508 msgid ""
2509 "You may also want to configure error handling for the handle.  See the "
2510 "L</ERROR HANDLING> section below."
2511 msgstr ""
2512
2513 #. type: =head2
2514 #: ../src/guestfs.pod:1308
2515 msgid "guestfs_close"
2516 msgstr ""
2517
2518 #. type: verbatim
2519 #: ../src/guestfs.pod:1310
2520 #, no-wrap
2521 msgid ""
2522 " void guestfs_close (guestfs_h *g);\n"
2523 "\n"
2524 msgstr ""
2525
2526 #. type: textblock
2527 #: ../src/guestfs.pod:1312
2528 msgid "This closes the connection handle and frees up all resources used."
2529 msgstr ""
2530
2531 #. type: textblock
2532 #: ../src/guestfs.pod:1314
2533 msgid ""
2534 "If autosync was set on the handle and the handle was launched, then this "
2535 "implicitly calls various functions to unmount filesystems and sync the "
2536 "disk.  See L</guestfs_set_autosync> for more details."
2537 msgstr ""
2538
2539 #. type: textblock
2540 #: ../src/guestfs.pod:1318
2541 msgid "If a close callback was set on the handle, then it is called."
2542 msgstr ""
2543
2544 #. type: =head1
2545 #: ../src/guestfs.pod:1320
2546 msgid "ERROR HANDLING"
2547 msgstr ""
2548
2549 #. type: textblock
2550 #: ../src/guestfs.pod:1322
2551 msgid ""
2552 "API functions can return errors.  For example, almost all functions that "
2553 "return C<int> will return C<-1> to indicate an error."
2554 msgstr ""
2555
2556 #. type: textblock
2557 #: ../src/guestfs.pod:1325
2558 msgid ""
2559 "Additional information is available for errors: an error message string and "
2560 "optionally an error number (errno) if the thing that failed was a system "
2561 "call."
2562 msgstr ""
2563
2564 #. type: textblock
2565 #: ../src/guestfs.pod:1329
2566 msgid ""
2567 "You can get at the additional information about the last error on the handle "
2568 "by calling L</guestfs_last_error>, L</guestfs_last_errno>, and/or by setting "
2569 "up an error handler with L</guestfs_set_error_handler>."
2570 msgstr ""
2571
2572 #. type: textblock
2573 #: ../src/guestfs.pod:1334
2574 msgid ""
2575 "When the handle is created, a default error handler is installed which "
2576 "prints the error message string to C<stderr>.  For small short-running "
2577 "command line programs it is sufficient to do:"
2578 msgstr ""
2579
2580 #. type: verbatim
2581 #: ../src/guestfs.pod:1338
2582 #, no-wrap
2583 msgid ""
2584 " if (guestfs_launch (g) == -1)\n"
2585 "   exit (EXIT_FAILURE);\n"
2586 "\n"
2587 msgstr ""
2588
2589 #. type: textblock
2590 #: ../src/guestfs.pod:1341
2591 msgid ""
2592 "since the default error handler will ensure that an error message has been "
2593 "printed to C<stderr> before the program exits."
2594 msgstr ""
2595
2596 #. type: textblock
2597 #: ../src/guestfs.pod:1344
2598 msgid ""
2599 "For other programs the caller will almost certainly want to install an "
2600 "alternate error handler or do error handling in-line like this:"
2601 msgstr ""
2602
2603 #. type: verbatim
2604 #: ../src/guestfs.pod:1347
2605 #, no-wrap
2606 msgid ""
2607 " g = guestfs_create ();\n"
2608 " \n"
2609 msgstr ""
2610
2611 #. type: verbatim
2612 #: ../src/guestfs.pod:1349
2613 #, no-wrap
2614 msgid ""
2615 " /* This disables the default behaviour of printing errors\n"
2616 "    on stderr. */\n"
2617 " guestfs_set_error_handler (g, NULL, NULL);\n"
2618 " \n"
2619 msgstr ""
2620
2621 #. type: verbatim
2622 #: ../src/guestfs.pod:1353
2623 #, no-wrap
2624 msgid ""
2625 " if (guestfs_launch (g) == -1) {\n"
2626 "   /* Examine the error message and print it etc. */\n"
2627 "   char *msg = guestfs_last_error (g);\n"
2628 "   int errnum = guestfs_last_errno (g);\n"
2629 "   fprintf (stderr, \"%s\\n\", msg);\n"
2630 "   /* ... */\n"
2631 "  }\n"
2632 "\n"
2633 msgstr ""
2634
2635 #. type: textblock
2636 #: ../src/guestfs.pod:1361
2637 msgid ""
2638 "Out of memory errors are handled differently.  The default action is to call "
2639 "L<abort(3)>.  If this is undesirable, then you can set a handler using "
2640 "L</guestfs_set_out_of_memory_handler>."
2641 msgstr ""
2642
2643 #. type: textblock
2644 #: ../src/guestfs.pod:1365
2645 msgid ""
2646 "L</guestfs_create> returns C<NULL> if the handle cannot be created, and "
2647 "because there is no handle if this happens there is no way to get additional "
2648 "error information.  However L</guestfs_create> is supposed to be a "
2649 "lightweight operation which can only fail because of insufficient memory (it "
2650 "returns NULL in this case)."
2651 msgstr ""
2652
2653 #. type: =head2
2654 #: ../src/guestfs.pod:1371
2655 msgid "guestfs_last_error"
2656 msgstr ""
2657
2658 #. type: verbatim
2659 #: ../src/guestfs.pod:1373
2660 #, no-wrap
2661 msgid ""
2662 " const char *guestfs_last_error (guestfs_h *g);\n"
2663 "\n"
2664 msgstr ""
2665
2666 #. type: textblock
2667 #: ../src/guestfs.pod:1375
2668 msgid ""
2669 "This returns the last error message that happened on C<g>.  If there has not "
2670 "been an error since the handle was created, then this returns C<NULL>."
2671 msgstr ""
2672
2673 #. type: textblock
2674 #: ../src/guestfs.pod:1379
2675 msgid ""
2676 "The lifetime of the returned string is until the next error occurs, or "
2677 "L</guestfs_close> is called."
2678 msgstr ""
2679
2680 #. type: =head2
2681 #: ../src/guestfs.pod:1382
2682 msgid "guestfs_last_errno"
2683 msgstr ""
2684
2685 #. type: verbatim
2686 #: ../src/guestfs.pod:1384
2687 #, no-wrap
2688 msgid ""
2689 " int guestfs_last_errno (guestfs_h *g);\n"
2690 "\n"
2691 msgstr ""
2692
2693 #. type: textblock
2694 #: ../src/guestfs.pod:1386
2695 msgid "This returns the last error number (errno) that happened on C<g>."
2696 msgstr ""
2697
2698 #. type: textblock
2699 #: ../src/guestfs.pod:1388
2700 msgid "If successful, an errno integer not equal to zero is returned."
2701 msgstr ""
2702
2703 #. type: textblock
2704 #: ../src/guestfs.pod:1390
2705 msgid "If no error, this returns 0.  This call can return 0 in three situations:"
2706 msgstr ""
2707
2708 #. type: textblock
2709 #: ../src/guestfs.pod:1397
2710 msgid "There has not been any error on the handle."
2711 msgstr ""
2712
2713 #. type: textblock
2714 #: ../src/guestfs.pod:1401
2715 msgid ""
2716 "There has been an error but the errno was meaningless.  This corresponds to "
2717 "the case where the error did not come from a failed system call, but for "
2718 "some other reason."
2719 msgstr ""
2720
2721 #. type: textblock
2722 #: ../src/guestfs.pod:1407
2723 msgid ""
2724 "There was an error from a failed system call, but for some reason the errno "
2725 "was not captured and returned.  This usually indicates a bug in libguestfs."
2726 msgstr ""
2727
2728 #. type: textblock
2729 #: ../src/guestfs.pod:1413
2730 msgid ""
2731 "Libguestfs tries to convert the errno from inside the applicance into a "
2732 "corresponding errno for the caller (not entirely trivial: the appliance "
2733 "might be running a completely different operating system from the library "
2734 "and error numbers are not standardized across Un*xen).  If this could not be "
2735 "done, then the error is translated to C<EINVAL>.  In practice this should "
2736 "only happen in very rare circumstances."
2737 msgstr ""
2738
2739 #. type: =head2
2740 #: ../src/guestfs.pod:1421
2741 msgid "guestfs_set_error_handler"
2742 msgstr ""
2743
2744 #. type: verbatim
2745 #: ../src/guestfs.pod:1423
2746 #, no-wrap
2747 msgid ""
2748 " typedef void (*guestfs_error_handler_cb) (guestfs_h *g,\n"
2749 "                                           void *opaque,\n"
2750 "                                           const char *msg);\n"
2751 " void guestfs_set_error_handler (guestfs_h *g,\n"
2752 "                                 guestfs_error_handler_cb cb,\n"
2753 "                                 void *opaque);\n"
2754 "\n"
2755 msgstr ""
2756
2757 #. type: textblock
2758 #: ../src/guestfs.pod:1430
2759 msgid ""
2760 "The callback C<cb> will be called if there is an error.  The parameters "
2761 "passed to the callback are an opaque data pointer and the error message "
2762 "string."
2763 msgstr ""
2764
2765 #. type: textblock
2766 #: ../src/guestfs.pod:1434
2767 msgid ""
2768 "C<errno> is not passed to the callback.  To get that the callback must call "
2769 "L</guestfs_last_errno>."
2770 msgstr ""
2771
2772 #. type: textblock
2773 #: ../src/guestfs.pod:1437
2774 msgid ""
2775 "Note that the message string C<msg> is freed as soon as the callback "
2776 "function returns, so if you want to stash it somewhere you must make your "
2777 "own copy."
2778 msgstr ""
2779
2780 #. type: textblock
2781 #: ../src/guestfs.pod:1441
2782 msgid "The default handler prints messages on C<stderr>."
2783 msgstr ""
2784
2785 #. type: textblock
2786 #: ../src/guestfs.pod:1443
2787 msgid "If you set C<cb> to C<NULL> then I<no> handler is called."
2788 msgstr ""
2789
2790 #. type: =head2
2791 #: ../src/guestfs.pod:1445
2792 msgid "guestfs_get_error_handler"
2793 msgstr ""
2794
2795 #. type: verbatim
2796 #: ../src/guestfs.pod:1447
2797 #, no-wrap
2798 msgid ""
2799 " guestfs_error_handler_cb guestfs_get_error_handler (guestfs_h *g,\n"
2800 "                                                     void **opaque_rtn);\n"
2801 "\n"
2802 msgstr ""
2803
2804 #. type: textblock
2805 #: ../src/guestfs.pod:1450
2806 msgid "Returns the current error handler callback."
2807 msgstr ""
2808
2809 #. type: =head2
2810 #: ../src/guestfs.pod:1452
2811 msgid "guestfs_set_out_of_memory_handler"
2812 msgstr ""
2813
2814 #. type: verbatim
2815 #: ../src/guestfs.pod:1454
2816 #, no-wrap
2817 msgid ""
2818 " typedef void (*guestfs_abort_cb) (void);\n"
2819 " void guestfs_set_out_of_memory_handler (guestfs_h *g,\n"
2820 "                                         guestfs_abort_cb);\n"
2821 "\n"
2822 msgstr ""
2823
2824 #. type: textblock
2825 #: ../src/guestfs.pod:1458
2826 msgid ""
2827 "The callback C<cb> will be called if there is an out of memory situation.  "
2828 "I<Note this callback must not return>."
2829 msgstr ""
2830
2831 #. type: textblock
2832 #: ../src/guestfs.pod:1461
2833 msgid "The default is to call L<abort(3)>."
2834 msgstr ""
2835
2836 #. type: textblock
2837 #: ../src/guestfs.pod:1463
2838 msgid "You cannot set C<cb> to C<NULL>.  You can't ignore out of memory situations."
2839 msgstr ""
2840
2841 #. type: =head2
2842 #: ../src/guestfs.pod:1466
2843 msgid "guestfs_get_out_of_memory_handler"
2844 msgstr ""
2845
2846 #. type: verbatim
2847 #: ../src/guestfs.pod:1468
2848 #, no-wrap
2849 msgid ""
2850 " guestfs_abort_fn guestfs_get_out_of_memory_handler (guestfs_h *g);\n"
2851 "\n"
2852 msgstr ""
2853
2854 #. type: textblock
2855 #: ../src/guestfs.pod:1470
2856 msgid "This returns the current out of memory handler."
2857 msgstr ""
2858
2859 #. type: =head1
2860 #: ../src/guestfs.pod:1472
2861 msgid "API CALLS"
2862 msgstr ""
2863
2864 #. type: textblock
2865 #: ../src/guestfs.pod:1474 ../fish/guestfish.pod:1019
2866 msgid "@ACTIONS@"
2867 msgstr ""
2868
2869 #. type: =head1
2870 #: ../src/guestfs.pod:1476
2871 msgid "STRUCTURES"
2872 msgstr ""
2873
2874 #. type: textblock
2875 #: ../src/guestfs.pod:1478
2876 msgid "@STRUCTS@"
2877 msgstr ""
2878
2879 #. type: =head1
2880 #: ../src/guestfs.pod:1480
2881 msgid "AVAILABILITY"
2882 msgstr ""
2883
2884 #. type: =head2
2885 #: ../src/guestfs.pod:1482
2886 msgid "GROUPS OF FUNCTIONALITY IN THE APPLIANCE"
2887 msgstr ""
2888
2889 #. type: textblock
2890 #: ../src/guestfs.pod:1484
2891 msgid ""
2892 "Using L</guestfs_available> you can test availability of the following "
2893 "groups of functions.  This test queries the appliance to see if the "
2894 "appliance you are currently using supports the functionality."
2895 msgstr ""
2896
2897 #. type: textblock
2898 #: ../src/guestfs.pod:1489
2899 msgid "@AVAILABILITY@"
2900 msgstr ""
2901
2902 #. type: =head2
2903 #: ../src/guestfs.pod:1491
2904 msgid "GUESTFISH supported COMMAND"
2905 msgstr ""
2906
2907 #. type: textblock
2908 #: ../src/guestfs.pod:1493
2909 msgid ""
2910 "In L<guestfish(3)> there is a handy interactive command C<supported> which "
2911 "prints out the available groups and whether they are supported by this build "
2912 "of libguestfs.  Note however that you have to do C<run> first."
2913 msgstr ""
2914
2915 #. type: =head2
2916 #: ../src/guestfs.pod:1498
2917 msgid "SINGLE CALLS AT COMPILE TIME"
2918 msgstr ""
2919
2920 #. type: textblock
2921 #: ../src/guestfs.pod:1500
2922 msgid ""
2923 "Since version 1.5.8, C<E<lt>guestfs.hE<gt>> defines symbols for each C API "
2924 "function, such as:"
2925 msgstr ""
2926
2927 #. type: verbatim
2928 #: ../src/guestfs.pod:1503
2929 #, no-wrap
2930 msgid ""
2931 " #define LIBGUESTFS_HAVE_DD 1\n"
2932 "\n"
2933 msgstr ""
2934
2935 #. type: textblock
2936 #: ../src/guestfs.pod:1505
2937 msgid "if L</guestfs_dd> is available."
2938 msgstr ""
2939
2940 #. type: textblock
2941 #: ../src/guestfs.pod:1507
2942 msgid ""
2943 "Before version 1.5.8, if you needed to test whether a single libguestfs "
2944 "function is available at compile time, we recommended using build tools such "
2945 "as autoconf or cmake.  For example in autotools you could use:"
2946 msgstr ""
2947
2948 #. type: verbatim
2949 #: ../src/guestfs.pod:1512
2950 #, no-wrap
2951 msgid ""
2952 " AC_CHECK_LIB([guestfs],[guestfs_create])\n"
2953 " AC_CHECK_FUNCS([guestfs_dd])\n"
2954 "\n"
2955 msgstr ""
2956
2957 #. type: textblock
2958 #: ../src/guestfs.pod:1515
2959 msgid ""
2960 "which would result in C<HAVE_GUESTFS_DD> being either defined or not defined "
2961 "in your program."
2962 msgstr ""
2963
2964 #. type: =head2
2965 #: ../src/guestfs.pod:1518
2966 msgid "SINGLE CALLS AT RUN TIME"
2967 msgstr ""
2968
2969 #. type: textblock
2970 #: ../src/guestfs.pod:1520
2971 msgid ""
2972 "Testing at compile time doesn't guarantee that a function really exists in "
2973 "the library.  The reason is that you might be dynamically linked against a "
2974 "previous I<libguestfs.so> (dynamic library)  which doesn't have the call.  "
2975 "This situation unfortunately results in a segmentation fault, which is a "
2976 "shortcoming of the C dynamic linking system itself."
2977 msgstr ""
2978
2979 #. type: textblock
2980 #: ../src/guestfs.pod:1527
2981 msgid ""
2982 "You can use L<dlopen(3)> to test if a function is available at run time, as "
2983 "in this example program (note that you still need the compile time check as "
2984 "well):"
2985 msgstr ""
2986
2987 #. type: verbatim
2988 #: ../src/guestfs.pod:1531
2989 #, no-wrap
2990 msgid ""
2991 " #include <stdio.h>\n"
2992 " #include <stdlib.h>\n"
2993 " #include <unistd.h>\n"
2994 " #include <dlfcn.h>\n"
2995 " #include <guestfs.h>\n"
2996 " \n"
2997 msgstr ""
2998
2999 #. type: verbatim
3000 #: ../src/guestfs.pod:1537
3001 #, no-wrap
3002 msgid ""
3003 " main ()\n"
3004 " {\n"
3005 " #ifdef LIBGUESTFS_HAVE_DD\n"
3006 "   void *dl;\n"
3007 "   int has_function;\n"
3008 " \n"
3009 msgstr ""
3010
3011 #. type: verbatim
3012 #: ../src/guestfs.pod:1543
3013 #, no-wrap
3014 msgid ""
3015 "   /* Test if the function guestfs_dd is really available. */\n"
3016 "   dl = dlopen (NULL, RTLD_LAZY);\n"
3017 "   if (!dl) {\n"
3018 "     fprintf (stderr, \"dlopen: %s\\n\", dlerror ());\n"
3019 "     exit (EXIT_FAILURE);\n"
3020 "   }\n"
3021 "   has_function = dlsym (dl, \"guestfs_dd\") != NULL;\n"
3022 "   dlclose (dl);\n"
3023 " \n"
3024 msgstr ""
3025
3026 #. type: verbatim
3027 #: ../src/guestfs.pod:1552
3028 #, no-wrap
3029 msgid ""
3030 "   if (!has_function)\n"
3031 "     printf (\"this libguestfs.so does NOT have guestfs_dd function\\n\");\n"
3032 "   else {\n"
3033 "     printf (\"this libguestfs.so has guestfs_dd function\\n\");\n"
3034 "     /* Now it's safe to call\n"
3035 "     guestfs_dd (g, \"foo\", \"bar\");\n"
3036 "     */\n"
3037 "   }\n"
3038 " #else\n"
3039 "   printf (\"guestfs_dd function was not found at compile time\\n\");\n"
3040 " #endif\n"
3041 "  }\n"
3042 "\n"
3043 msgstr ""
3044
3045 #. type: textblock
3046 #: ../src/guestfs.pod:1565
3047 msgid ""
3048 "You may think the above is an awful lot of hassle, and it is.  There are "
3049 "other ways outside of the C linking system to ensure that this kind of "
3050 "incompatibility never arises, such as using package versioning:"
3051 msgstr ""
3052
3053 #. type: verbatim
3054 #: ../src/guestfs.pod:1570
3055 #, no-wrap
3056 msgid ""
3057 " Requires: libguestfs >= 1.0.80\n"
3058 "\n"
3059 msgstr ""
3060
3061 #. type: =head1
3062 #: ../src/guestfs.pod:1572
3063 msgid "CALLS WITH OPTIONAL ARGUMENTS"
3064 msgstr ""
3065
3066 #. type: textblock
3067 #: ../src/guestfs.pod:1574
3068 msgid ""
3069 "A recent feature of the API is the introduction of calls which take optional "
3070 "arguments.  In C these are declared 3 ways.  The main way is as a call which "
3071 "takes variable arguments (ie. C<...>), as in this example:"
3072 msgstr ""
3073
3074 #. type: verbatim
3075 #: ../src/guestfs.pod:1579
3076 #, no-wrap
3077 msgid ""
3078 " int guestfs_add_drive_opts (guestfs_h *g, const char *filename, ...);\n"
3079 "\n"
3080 msgstr ""
3081
3082 #. type: textblock
3083 #: ../src/guestfs.pod:1581
3084 msgid ""
3085 "Call this with a list of optional arguments, terminated by C<-1>.  So to "
3086 "call with no optional arguments specified:"
3087 msgstr ""
3088
3089 #. type: verbatim
3090 #: ../src/guestfs.pod:1584
3091 #, no-wrap
3092 msgid ""
3093 " guestfs_add_drive_opts (g, filename, -1);\n"
3094 "\n"
3095 msgstr ""
3096
3097 #. type: textblock
3098 #: ../src/guestfs.pod:1586
3099 msgid "With a single optional argument:"
3100 msgstr ""
3101
3102 #. type: verbatim
3103 #: ../src/guestfs.pod:1588
3104 #, no-wrap
3105 msgid ""
3106 " guestfs_add_drive_opts (g, filename,\n"
3107 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"qcow2\",\n"
3108 "                         -1);\n"
3109 "\n"
3110 msgstr ""
3111
3112 #. type: textblock
3113 #: ../src/guestfs.pod:1592
3114 msgid "With two:"
3115 msgstr ""
3116
3117 #. type: verbatim
3118 #: ../src/guestfs.pod:1594
3119 #, no-wrap
3120 msgid ""
3121 " guestfs_add_drive_opts (g, filename,\n"
3122 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"qcow2\",\n"
3123 "                         GUESTFS_ADD_DRIVE_OPTS_READONLY, 1,\n"
3124 "                         -1);\n"
3125 "\n"
3126 msgstr ""
3127
3128 #. type: textblock
3129 #: ../src/guestfs.pod:1599
3130 msgid ""
3131 "and so forth.  Don't forget the terminating C<-1> otherwise Bad Things will "
3132 "happen!"
3133 msgstr ""
3134
3135 #. type: =head2
3136 #: ../src/guestfs.pod:1602
3137 msgid "USING va_list FOR OPTIONAL ARGUMENTS"
3138 msgstr ""
3139
3140 #. type: textblock
3141 #: ../src/guestfs.pod:1604
3142 msgid ""
3143 "The second variant has the same name with the suffix C<_va>, which works the "
3144 "same way but takes a C<va_list>.  See the C manual for details.  For the "
3145 "example function, this is declared:"
3146 msgstr ""
3147
3148 #. type: verbatim
3149 #: ../src/guestfs.pod:1608
3150 #, no-wrap
3151 msgid ""
3152 " int guestfs_add_drive_opts_va (guestfs_h *g, const char *filename,\n"
3153 "                                va_list args);\n"
3154 "\n"
3155 msgstr ""
3156
3157 #. type: =head2
3158 #: ../src/guestfs.pod:1611
3159 msgid "CONSTRUCTING OPTIONAL ARGUMENTS"
3160 msgstr ""
3161
3162 #. type: textblock
3163 #: ../src/guestfs.pod:1613
3164 msgid ""
3165 "The third variant is useful where you need to construct these calls.  You "
3166 "pass in a structure where you fill in the optional fields.  The structure "
3167 "has a bitmask as the first element which you must set to indicate which "
3168 "fields you have filled in.  For our example function the structure and call "
3169 "are declared:"
3170 msgstr ""
3171
3172 #. type: verbatim
3173 #: ../src/guestfs.pod:1619
3174 #, no-wrap
3175 msgid ""
3176 " struct guestfs_add_drive_opts_argv {\n"
3177 "   uint64_t bitmask;\n"
3178 "   int readonly;\n"
3179 "   const char *format;\n"
3180 "   /* ... */\n"
3181 " };\n"
3182 " int guestfs_add_drive_opts_argv (guestfs_h *g, const char *filename,\n"
3183 "              const struct guestfs_add_drive_opts_argv *optargs);\n"
3184 "\n"
3185 msgstr ""
3186
3187 #. type: textblock
3188 #: ../src/guestfs.pod:1628
3189 msgid "You could call it like this:"
3190 msgstr ""
3191
3192 #. type: verbatim
3193 #: ../src/guestfs.pod:1630
3194 #, no-wrap
3195 msgid ""
3196 " struct guestfs_add_drive_opts_argv optargs = {\n"
3197 "   .bitmask = GUESTFS_ADD_DRIVE_OPTS_READONLY_BITMASK |\n"
3198 "              GUESTFS_ADD_DRIVE_OPTS_FORMAT_BITMASK,\n"
3199 "   .readonly = 1,\n"
3200 "   .format = \"qcow2\"\n"
3201 " };\n"
3202 " \n"
3203 msgstr ""
3204
3205 #. type: verbatim
3206 #: ../src/guestfs.pod:1637
3207 #, no-wrap
3208 msgid ""
3209 " guestfs_add_drive_opts_argv (g, filename, &optargs);\n"
3210 "\n"
3211 msgstr ""
3212
3213 #. type: textblock
3214 #: ../src/guestfs.pod:1639 ../src/guestfs-actions.pod:11 ../src/guestfs-actions.pod:1857 ../fish/guestfish-actions.pod:9 ../fish/guestfish-actions.pod:1262 ../tools/virt-win-reg.pl:532
3215 msgid "Notes:"
3216 msgstr ""
3217
3218 #. type: textblock
3219 #: ../src/guestfs.pod:1645
3220 msgid "The C<_BITMASK> suffix on each option name when specifying the bitmask."
3221 msgstr ""
3222
3223 #. type: textblock
3224 #: ../src/guestfs.pod:1650
3225 msgid "You do not need to fill in all fields of the structure."
3226 msgstr ""
3227
3228 #. type: textblock
3229 #: ../src/guestfs.pod:1654
3230 msgid ""
3231 "There must be a one-to-one correspondence between fields of the structure "
3232 "that are filled in, and bits set in the bitmask."
3233 msgstr ""
3234
3235 #. type: =head2
3236 #: ../src/guestfs.pod:1659
3237 msgid "OPTIONAL ARGUMENTS IN OTHER LANGUAGES"
3238 msgstr ""
3239
3240 #. type: textblock
3241 #: ../src/guestfs.pod:1661
3242 msgid ""
3243 "In other languages, optional arguments are expressed in the way that is "
3244 "natural for that language.  We refer you to the language-specific "
3245 "documentation for more details on that."
3246 msgstr ""
3247
3248 #. type: textblock
3249 #: ../src/guestfs.pod:1665
3250 msgid "For guestfish, see L<guestfish(1)/OPTIONAL ARGUMENTS>."
3251 msgstr ""
3252
3253 #. type: =head2
3254 #: ../src/guestfs.pod:1667
3255 msgid "SETTING CALLBACKS TO HANDLE EVENTS"
3256 msgstr ""
3257
3258 #. type: textblock
3259 #: ../src/guestfs.pod:1669
3260 msgid ""
3261 "B<Note:> This section documents the generic event mechanism introduced in "
3262 "libguestfs 1.10, which you should use in new code if possible.  The old "
3263 "functions C<guestfs_set_log_message_callback>, "
3264 "C<guestfs_set_subprocess_quit_callback>, "
3265 "C<guestfs_set_launch_done_callback>, C<guestfs_set_close_callback> and "
3266 "C<guestfs_set_progress_callback> are no longer documented in this manual "
3267 "page."
3268 msgstr ""
3269
3270 #. type: textblock
3271 #: ../src/guestfs.pod:1677
3272 msgid ""
3273 "Handles generate events when certain things happen, such as log messages "
3274 "being generated, progress messages during long-running operations, or the "
3275 "handle being closed.  The API calls described below let you register a "
3276 "callback to be called when events happen.  You can register multiple "
3277 "callbacks (for the same, different or overlapping sets of events), and "
3278 "individually remove callbacks.  If callbacks are not removed, then they "
3279 "remain in force until the handle is closed."
3280 msgstr ""
3281
3282 #. type: textblock
3283 #: ../src/guestfs.pod:1685
3284 msgid ""
3285 "In the current implementation, events are only generated synchronously: that "
3286 "means that events (and hence callbacks) can only happen while you are in the "
3287 "middle of making another libguestfs call.  The callback is called in the "
3288 "same thread."
3289 msgstr ""
3290
3291 #. type: textblock
3292 #: ../src/guestfs.pod:1690
3293 msgid ""
3294 "Events may contain a payload, usually nothing (void), an array of 64 bit "
3295 "unsigned integers, or a message buffer.  Payloads are discussed later on."
3296 msgstr ""
3297
3298 #. type: =head3
3299 #: ../src/guestfs.pod:1694
3300 msgid "CLASSES OF EVENTS"
3301 msgstr ""
3302
3303 #. type: =item
3304 #: ../src/guestfs.pod:1698
3305 msgid "GUESTFS_EVENT_CLOSE (payload type: void)"
3306 msgstr ""
3307
3308 #. type: textblock
3309 #: ../src/guestfs.pod:1701
3310 msgid ""
3311 "The callback function will be called while the handle is being closed "
3312 "(synchronously from L</guestfs_close>)."
3313 msgstr ""
3314
3315 #. type: textblock
3316 #: ../src/guestfs.pod:1704
3317 msgid ""
3318 "Note that libguestfs installs an L<atexit(3)> handler to try to clean up "
3319 "handles that are open when the program exits.  This means that this callback "
3320 "might be called indirectly from L<exit(3)>, which can cause unexpected "
3321 "problems in higher-level languages (eg. if your HLL interpreter has already "
3322 "been cleaned up by the time this is called, and if your callback then jumps "
3323 "into some HLL function)."
3324 msgstr ""
3325
3326 #. type: textblock
3327 #: ../src/guestfs.pod:1711
3328 msgid ""
3329 "If no callback is registered: the handle is closed without any callback "
3330 "being invoked."
3331 msgstr ""
3332
3333 #. type: =item
3334 #: ../src/guestfs.pod:1714
3335 msgid "GUESTFS_EVENT_SUBPROCESS_QUIT (payload type: void)"
3336 msgstr ""
3337
3338 #. type: textblock
3339 #: ../src/guestfs.pod:1717
3340 msgid ""
3341 "The callback function will be called when the child process quits, either "
3342 "asynchronously or if killed by L</guestfs_kill_subprocess>.  (This "
3343 "corresponds to a transition from any state to the CONFIG state)."
3344 msgstr ""
3345
3346 #. type: textblock
3347 #: ../src/guestfs.pod:1721 ../src/guestfs.pod:1730
3348 msgid "If no callback is registered: the event is ignored."
3349 msgstr ""
3350
3351 #. type: =item
3352 #: ../src/guestfs.pod:1723
3353 msgid "GUESTFS_EVENT_LAUNCH_DONE (payload type: void)"
3354 msgstr ""
3355
3356 #. type: textblock
3357 #: ../src/guestfs.pod:1726
3358 msgid ""
3359 "The callback function will be called when the child process becomes ready "
3360 "first time after it has been launched.  (This corresponds to a transition "
3361 "from LAUNCHING to the READY state)."
3362 msgstr ""
3363
3364 #. type: =item
3365 #: ../src/guestfs.pod:1732
3366 msgid "GUESTFS_EVENT_PROGRESS (payload type: array of 4 x uint64_t)"
3367 msgstr ""
3368
3369 #. type: textblock
3370 #: ../src/guestfs.pod:1735
3371 msgid ""
3372 "Some long-running operations can generate progress messages.  If this "
3373 "callback is registered, then it will be called each time a progress message "
3374 "is generated (usually two seconds after the operation started, and three "
3375 "times per second thereafter until it completes, although the frequency may "
3376 "change in future versions)."
3377 msgstr ""
3378
3379 #. type: textblock
3380 #: ../src/guestfs.pod:1741
3381 msgid ""
3382 "The callback receives in the payload four unsigned 64 bit numbers which are "
3383 "(in order): C<proc_nr>, C<serial>, C<position>, C<total>."
3384 msgstr ""
3385
3386 #. type: textblock
3387 #: ../src/guestfs.pod:1744
3388 msgid ""
3389 "The units of C<total> are not defined, although for some operations C<total> "
3390 "may relate in some way to the amount of data to be transferred (eg. in bytes "
3391 "or megabytes), and C<position> may be the portion which has been "
3392 "transferred."
3393 msgstr ""
3394
3395 #. type: textblock
3396 #: ../src/guestfs.pod:1749
3397 msgid "The only defined and stable parts of the API are:"
3398 msgstr ""
3399
3400 #. type: textblock
3401 #: ../src/guestfs.pod:1755
3402 msgid ""
3403 "The callback can display to the user some type of progress bar or indicator "
3404 "which shows the ratio of C<position>:C<total>."
3405 msgstr ""
3406
3407 #. type: textblock
3408 #: ../src/guestfs.pod:1760
3409 msgid "0 E<lt>= C<position> E<lt>= C<total>"
3410 msgstr ""
3411
3412 #. type: textblock
3413 #: ../src/guestfs.pod:1764
3414 msgid ""
3415 "If any progress notification is sent during a call, then a final progress "
3416 "notification is always sent when C<position> = C<total> (I<unless> the call "
3417 "fails with an error)."
3418 msgstr ""
3419
3420 #. type: textblock
3421 #: ../src/guestfs.pod:1768
3422 msgid ""
3423 "This is to simplify caller code, so callers can easily set the progress "
3424 "indicator to \"100%\" at the end of the operation, without requiring special "
3425 "code to detect this case."
3426 msgstr ""
3427
3428 #. type: textblock
3429 #: ../src/guestfs.pod:1774
3430 msgid ""
3431 "For some calls we are unable to estimate the progress of the call, but we "
3432 "can still generate progress messages to indicate activity.  This is known as "
3433 "\"pulse mode\", and is directly supported by certain progress bar "
3434 "implementations (eg. GtkProgressBar)."
3435 msgstr ""
3436
3437 #. type: textblock
3438 #: ../src/guestfs.pod:1779
3439 msgid ""
3440 "For these calls, zero or more progress messages are generated with "
3441 "C<position = 0> and C<total = 1>, followed by a final message with "
3442 "C<position = total = 1>."
3443 msgstr ""
3444
3445 #. type: textblock
3446 #: ../src/guestfs.pod:1783
3447 msgid ""
3448 "As noted above, if the call fails with an error then the final message may "
3449 "not be generated."
3450 msgstr ""
3451
3452 #. type: textblock
3453 #: ../src/guestfs.pod:1788
3454 msgid ""
3455 "The callback also receives the procedure number (C<proc_nr>) and serial "
3456 "number (C<serial>) of the call.  These are only useful for debugging "
3457 "protocol issues, and the callback can normally ignore them.  The callback "
3458 "may want to print these numbers in error messages or debugging messages."
3459 msgstr ""
3460
3461 #. type: textblock
3462 #: ../src/guestfs.pod:1794
3463 msgid "If no callback is registered: progress messages are discarded."
3464 msgstr ""
3465
3466 #. type: =item
3467 #: ../src/guestfs.pod:1796
3468 msgid "GUESTFS_EVENT_APPLIANCE (payload type: message buffer)"
3469 msgstr ""
3470
3471 #. type: textblock
3472 #: ../src/guestfs.pod:1799
3473 msgid ""
3474 "The callback function is called whenever a log message is generated by qemu, "
3475 "the appliance kernel, guestfsd (daemon), or utility programs."
3476 msgstr ""
3477
3478 #. type: textblock
3479 #: ../src/guestfs.pod:1802
3480 msgid ""
3481 "If the verbose flag (L</guestfs_set_verbose>) is set before launch "
3482 "(L</guestfs_launch>) then additional debug messages are generated."
3483 msgstr ""
3484
3485 #. type: textblock
3486 #: ../src/guestfs.pod:1805 ../src/guestfs.pod:1819
3487 msgid ""
3488 "If no callback is registered: the messages are discarded unless the verbose "
3489 "flag is set in which case they are sent to stderr.  You can override the "
3490 "printing of verbose messages to stderr by setting up a callback."
3491 msgstr ""
3492
3493 #. type: =item
3494 #: ../src/guestfs.pod:1810
3495 msgid "GUESTFS_EVENT_LIBRARY (payload type: message buffer)"
3496 msgstr ""
3497
3498 #. type: textblock
3499 #: ../src/guestfs.pod:1813
3500 msgid ""
3501 "The callback function is called whenever a log message is generated by the "
3502 "library part of libguestfs."
3503 msgstr ""
3504
3505 #. type: textblock
3506 #: ../src/guestfs.pod:1816
3507 msgid ""
3508 "If the verbose flag (L</guestfs_set_verbose>) is set then additional debug "
3509 "messages are generated."
3510 msgstr ""
3511
3512 #. type: =item
3513 #: ../src/guestfs.pod:1824
3514 msgid "GUESTFS_EVENT_TRACE (payload type: message buffer)"
3515 msgstr ""
3516
3517 #. type: textblock
3518 #: ../src/guestfs.pod:1827
3519 msgid ""
3520 "The callback function is called whenever a trace message is generated.  This "
3521 "only applies if the trace flag (L</guestfs_set_trace>) is set."
3522 msgstr ""
3523
3524 #. type: textblock
3525 #: ../src/guestfs.pod:1830
3526 msgid ""
3527 "If no callback is registered: the messages are sent to stderr.  You can "
3528 "override the printing of trace messages to stderr by setting up a callback."
3529 msgstr ""
3530
3531 #. type: =head3
3532 #: ../src/guestfs.pod:1836
3533 msgid "guestfs_set_event_callback"
3534 msgstr ""
3535
3536 #. type: verbatim
3537 #: ../src/guestfs.pod:1838
3538 #, no-wrap
3539 msgid ""
3540 " int guestfs_set_event_callback (guestfs_h *g,\n"
3541 "                                 guestfs_event_callback cb,\n"
3542 "                                 uint64_t event_bitmask,\n"
3543 "                                 int flags,\n"
3544 "                                 void *opaque);\n"
3545 "\n"
3546 msgstr ""
3547
3548 #. type: textblock
3549 #: ../src/guestfs.pod:1844
3550 msgid ""
3551 "This function registers a callback (C<cb>) for all event classes in the "
3552 "C<event_bitmask>."
3553 msgstr ""
3554
3555 #. type: textblock
3556 #: ../src/guestfs.pod:1847
3557 msgid ""
3558 "For example, to register for all log message events, you could call this "
3559 "function with the bitmask C<GUESTFS_EVENT_APPLIANCE|GUESTFS_EVENT_LIBRARY>.  "
3560 "To register a single callback for all possible classes of events, use "
3561 "C<GUESTFS_EVENT_ALL>."
3562 msgstr ""
3563
3564 #. type: textblock
3565 #: ../src/guestfs.pod:1853
3566 msgid "C<flags> should always be passed as 0."
3567 msgstr ""
3568
3569 #. type: textblock
3570 #: ../src/guestfs.pod:1855
3571 msgid ""
3572 "C<opaque> is an opaque pointer which is passed to the callback.  You can use "
3573 "it for any purpose."
3574 msgstr ""
3575
3576 #. type: textblock
3577 #: ../src/guestfs.pod:1858
3578 msgid ""
3579 "The return value is the event handle (an integer) which you can use to "
3580 "delete the callback (see below)."
3581 msgstr ""
3582
3583 #. type: textblock
3584 #: ../src/guestfs.pod:1861
3585 msgid ""
3586 "If there is an error, this function returns C<-1>, and sets the error in the "
3587 "handle in the usual way (see L</guestfs_last_error> etc.)"
3588 msgstr ""
3589
3590 #. type: textblock
3591 #: ../src/guestfs.pod:1864
3592 msgid ""
3593 "Callbacks remain in effect until they are deleted, or until the handle is "
3594 "closed."
3595 msgstr ""
3596
3597 #. type: textblock
3598 #: ../src/guestfs.pod:1867
3599 msgid ""
3600 "In the case where multiple callbacks are registered for a particular event "
3601 "class, all of the callbacks are called.  The order in which multiple "
3602 "callbacks are called is not defined."
3603 msgstr ""
3604
3605 #. type: =head3
3606 #: ../src/guestfs.pod:1871
3607 msgid "guestfs_delete_event_callback"
3608 msgstr ""
3609
3610 #. type: verbatim
3611 #: ../src/guestfs.pod:1873
3612 #, no-wrap
3613 msgid ""
3614 " void guestfs_delete_event_callback (guestfs_h *g, int event_handle);\n"
3615 "\n"
3616 msgstr ""
3617
3618 #. type: textblock
3619 #: ../src/guestfs.pod:1875
3620 msgid ""
3621 "Delete a callback that was previously registered.  C<event_handle> should be "
3622 "the integer that was returned by a previous call to "
3623 "C<guestfs_set_event_callback> on the same handle."
3624 msgstr ""
3625
3626 #. type: =head3
3627 #: ../src/guestfs.pod:1879
3628 msgid "guestfs_event_callback"
3629 msgstr ""
3630
3631 #. type: verbatim
3632 #: ../src/guestfs.pod:1881
3633 #, no-wrap
3634 msgid ""
3635 " typedef void (*guestfs_event_callback) (\n"
3636 "                  guestfs_h *g,\n"
3637 "                  void *opaque,\n"
3638 "                  uint64_t event,\n"
3639 "                  int event_handle,\n"
3640 "                  int flags,\n"
3641 "                  const char *buf, size_t buf_len,\n"
3642 "                  const uint64_t *array, size_t array_len);\n"
3643 "\n"
3644 msgstr ""
3645
3646 #. type: textblock
3647 #: ../src/guestfs.pod:1890
3648 msgid "This is the type of the event callback function that you have to provide."
3649 msgstr ""
3650
3651 #. type: textblock
3652 #: ../src/guestfs.pod:1893
3653 msgid ""
3654 "The basic parameters are: the handle (C<g>), the opaque user pointer "
3655 "(C<opaque>), the event class (eg. C<GUESTFS_EVENT_PROGRESS>), the event "
3656 "handle, and C<flags> which in the current API you should ignore."
3657 msgstr ""
3658
3659 #. type: textblock
3660 #: ../src/guestfs.pod:1897
3661 msgid ""
3662 "The remaining parameters contain the event payload (if any).  Each event may "
3663 "contain a payload, which usually relates to the event class, but for future "
3664 "proofing your code should be written to handle any payload for any event "
3665 "class."
3666 msgstr ""
3667
3668 #. type: textblock
3669 #: ../src/guestfs.pod:1902
3670 msgid ""
3671 "C<buf> and C<buf_len> contain a message buffer (if C<buf_len == 0>, then "
3672 "there is no message buffer).  Note that this message buffer can contain "
3673 "arbitrary 8 bit data, including NUL bytes."
3674 msgstr ""
3675
3676 #. type: textblock
3677 #: ../src/guestfs.pod:1906
3678 msgid ""
3679 "C<array> and C<array_len> is an array of 64 bit unsigned integers.  At the "
3680 "moment this is only used for progress messages."
3681 msgstr ""
3682
3683 #. type: =head3
3684 #: ../src/guestfs.pod:1909
3685 msgid "EXAMPLE: CAPTURING LOG MESSAGES"
3686 msgstr ""
3687
3688 #. type: textblock
3689 #: ../src/guestfs.pod:1911
3690 msgid ""
3691 "One motivation for the generic event API was to allow GUI programs to "
3692 "capture debug and other messages.  In libguestfs E<le> 1.8 these were sent "
3693 "unconditionally to C<stderr>."
3694 msgstr ""
3695
3696 #. type: textblock
3697 #: ../src/guestfs.pod:1915
3698 msgid ""
3699 "Events associated with log messages are: C<GUESTFS_EVENT_LIBRARY>, "
3700 "C<GUESTFS_EVENT_APPLIANCE> and C<GUESTFS_EVENT_TRACE>.  (Note that error "
3701 "messages are not events; you must capture error messages separately)."
3702 msgstr ""
3703
3704 #. type: textblock
3705 #: ../src/guestfs.pod:1920
3706 msgid ""
3707 "Programs have to set up a callback to capture the classes of events of "
3708 "interest:"
3709 msgstr ""
3710
3711 #. type: verbatim
3712 #: ../src/guestfs.pod:1923
3713 #, no-wrap
3714 msgid ""
3715 " int eh =\n"
3716 "   guestfs_set_event_callback\n"
3717 "     (g, message_callback,\n"
3718 "      GUESTFS_EVENT_LIBRARY|GUESTFS_EVENT_APPLIANCE|\n"
3719 "      GUESTFS_EVENT_TRACE,\n"
3720 "      0, NULL) == -1)\n"
3721 " if (eh == -1) {\n"
3722 "   // handle error in the usual way\n"
3723 " }\n"
3724 "\n"
3725 msgstr ""
3726
3727 #. type: textblock
3728 #: ../src/guestfs.pod:1933
3729 msgid ""
3730 "The callback can then direct messages to the appropriate place.  In this "
3731 "example, messages are directed to syslog:"
3732 msgstr ""
3733
3734 #. type: verbatim
3735 #: ../src/guestfs.pod:1936
3736 #, no-wrap
3737 msgid ""
3738 " static void\n"
3739 " message_callback (\n"
3740 "         guestfs_h *g,\n"
3741 "         void *opaque,\n"
3742 "         uint64_t event,\n"
3743 "         int event_handle,\n"
3744 "         int flags,\n"
3745 "         const char *buf, size_t buf_len,\n"
3746 "         const uint64_t *array, size_t array_len)\n"
3747 " {\n"
3748 "   const int priority = LOG_USER|LOG_INFO;\n"
3749 "   if (buf_len > 0)\n"
3750 "     syslog (priority, \"event 0x%lx: %s\", event, buf);\n"
3751 " }\n"
3752 "\n"
3753 msgstr ""
3754
3755 #. type: =head1
3756 #: ../src/guestfs.pod:1951
3757 msgid "PRIVATE DATA AREA"
3758 msgstr ""
3759
3760 #. type: textblock
3761 #: ../src/guestfs.pod:1953
3762 msgid ""
3763 "You can attach named pieces of private data to the libguestfs handle, fetch "
3764 "them by name, and walk over them, for the lifetime of the handle.  This is "
3765 "called the private data area and is only available from the C API."
3766 msgstr ""
3767
3768 #. type: textblock
3769 #: ../src/guestfs.pod:1958
3770 msgid "To attach a named piece of data, use the following call:"
3771 msgstr ""
3772
3773 #. type: verbatim
3774 #: ../src/guestfs.pod:1960
3775 #, no-wrap
3776 msgid ""
3777 " void guestfs_set_private (guestfs_h *g, const char *key, void *data);\n"
3778 "\n"
3779 msgstr ""
3780
3781 #. type: textblock
3782 #: ../src/guestfs.pod:1962
3783 msgid ""
3784 "C<key> is the name to associate with this data, and C<data> is an arbitrary "
3785 "pointer (which can be C<NULL>).  Any previous item with the same key is "
3786 "overwritten."
3787 msgstr ""
3788
3789 #. type: textblock
3790 #: ../src/guestfs.pod:1966
3791 msgid ""
3792 "You can use any C<key> you want, but your key should I<not> start with an "
3793 "underscore character.  Keys beginning with an underscore character are "
3794 "reserved for internal libguestfs purposes (eg. for implementing language "
3795 "bindings).  It is recommended that you prefix the key with some unique "
3796 "string to avoid collisions with other users."
3797 msgstr ""
3798
3799 #. type: textblock
3800 #: ../src/guestfs.pod:1972
3801 msgid "To retrieve the pointer, use:"
3802 msgstr ""
3803
3804 #. type: verbatim
3805 #: ../src/guestfs.pod:1974
3806 #, no-wrap
3807 msgid ""
3808 " void *guestfs_get_private (guestfs_h *g, const char *key);\n"
3809 "\n"
3810 msgstr ""
3811
3812 #. type: textblock
3813 #: ../src/guestfs.pod:1976
3814 msgid ""
3815 "This function returns C<NULL> if either no data is found associated with "
3816 "C<key>, or if the user previously set the C<key>'s C<data> pointer to "
3817 "C<NULL>."
3818 msgstr ""
3819
3820 #. type: textblock
3821 #: ../src/guestfs.pod:1980
3822 msgid ""
3823 "Libguestfs does not try to look at or interpret the C<data> pointer in any "
3824 "way.  As far as libguestfs is concerned, it need not be a valid pointer at "
3825 "all.  In particular, libguestfs does I<not> try to free the data when the "
3826 "handle is closed.  If the data must be freed, then the caller must either "
3827 "free it before calling L</guestfs_close> or must set up a close callback to "
3828 "do it (see L</GUESTFS_EVENT_CLOSE>)."
3829 msgstr ""
3830
3831 #. type: textblock
3832 #: ../src/guestfs.pod:1987
3833 msgid "To walk over all entries, use these two functions:"
3834 msgstr ""
3835
3836 #. type: verbatim
3837 #: ../src/guestfs.pod:1989
3838 #, no-wrap
3839 msgid ""
3840 " void *guestfs_first_private (guestfs_h *g, const char **key_rtn);\n"
3841 "\n"
3842 msgstr ""
3843
3844 #. type: verbatim
3845 #: ../src/guestfs.pod:1991
3846 #, no-wrap
3847 msgid ""
3848 " void *guestfs_next_private (guestfs_h *g, const char **key_rtn);\n"
3849 "\n"
3850 msgstr ""
3851
3852 #. type: textblock
3853 #: ../src/guestfs.pod:1993
3854 msgid ""
3855 "C<guestfs_first_private> returns the first key, pointer pair (\"first\" does "
3856 "not have any particular meaning -- keys are not returned in any defined "
3857 "order).  A pointer to the key is returned in C<*key_rtn> and the "
3858 "corresponding data pointer is returned from the function.  C<NULL> is "
3859 "returned if there are no keys stored in the handle."
3860 msgstr ""
3861
3862 #. type: textblock
3863 #: ../src/guestfs.pod:1999
3864 msgid ""
3865 "C<guestfs_next_private> returns the next key, pointer pair.  The return "
3866 "value of this function is also C<NULL> is there are no further entries to "
3867 "return."
3868 msgstr ""
3869
3870 #. type: textblock
3871 #: ../src/guestfs.pod:2003
3872 msgid "Notes about walking over entries:"
3873 msgstr ""
3874
3875 #. type: textblock
3876 #: ../src/guestfs.pod:2009
3877 msgid "You must not call C<guestfs_set_private> while walking over the entries."
3878 msgstr ""
3879
3880 #. type: textblock
3881 #: ../src/guestfs.pod:2014
3882 msgid ""
3883 "The handle maintains an internal iterator which is reset when you call "
3884 "C<guestfs_first_private>.  This internal iterator is invalidated when you "
3885 "call C<guestfs_set_private>."
3886 msgstr ""
3887
3888 #. type: textblock
3889 #: ../src/guestfs.pod:2020
3890 msgid "If you have set the data pointer associated with a key to C<NULL>, ie:"
3891 msgstr ""
3892
3893 #. type: verbatim
3894 #: ../src/guestfs.pod:2022
3895 #, no-wrap
3896 msgid ""
3897 " guestfs_set_private (g, key, NULL);\n"
3898 "\n"
3899 msgstr ""
3900
3901 #. type: textblock
3902 #: ../src/guestfs.pod:2024
3903 msgid "then that C<key> is not returned when walking."
3904 msgstr ""
3905
3906 #. type: textblock
3907 #: ../src/guestfs.pod:2028
3908 msgid ""
3909 "C<*key_rtn> is only valid until the next call to C<guestfs_first_private>, "
3910 "C<guestfs_next_private> or C<guestfs_set_private>."
3911 msgstr ""
3912
3913 #. type: textblock
3914 #: ../src/guestfs.pod:2034
3915 msgid ""
3916 "The following example code shows how to print all keys and data pointers "
3917 "that are associated with the handle C<g>:"
3918 msgstr ""
3919
3920 #. type: verbatim
3921 #: ../src/guestfs.pod:2037
3922 #, no-wrap
3923 msgid ""
3924 " const char *key;\n"
3925 " void *data = guestfs_first_private (g, &key);\n"
3926 " while (data != NULL)\n"
3927 "   {\n"
3928 "     printf (\"key = %s, data = %p\\n\", key, data);\n"
3929 "     data = guestfs_next_private (g, &key);\n"
3930 "   }\n"
3931 "\n"
3932 msgstr ""
3933
3934 #. type: textblock
3935 #: ../src/guestfs.pod:2045
3936 msgid ""
3937 "More commonly you are only interested in keys that begin with an "
3938 "application-specific prefix C<foo_>.  Modify the loop like so:"
3939 msgstr ""
3940
3941 #. type: verbatim
3942 #: ../src/guestfs.pod:2048
3943 #, no-wrap
3944 msgid ""
3945 " const char *key;\n"
3946 " void *data = guestfs_first_private (g, &key);\n"
3947 " while (data != NULL)\n"
3948 "   {\n"
3949 "     if (strncmp (key, \"foo_\", strlen (\"foo_\")) == 0)\n"
3950 "       printf (\"key = %s, data = %p\\n\", key, data);\n"
3951 "     data = guestfs_next_private (g, &key);\n"
3952 "   }\n"
3953 "\n"
3954 msgstr ""
3955
3956 #. type: textblock
3957 #: ../src/guestfs.pod:2057
3958 msgid ""
3959 "If you need to modify keys while walking, then you have to jump back to the "
3960 "beginning of the loop.  For example, to delete all keys prefixed with "
3961 "C<foo_>:"
3962 msgstr ""
3963
3964 #. type: verbatim
3965 #: ../src/guestfs.pod:2061
3966 #, no-wrap
3967 msgid ""
3968 "  const char *key;\n"
3969 "  void *data;\n"
3970 " again:\n"
3971 "  data = guestfs_first_private (g, &key);\n"
3972 "  while (data != NULL)\n"
3973 "    {\n"
3974 "      if (strncmp (key, \"foo_\", strlen (\"foo_\")) == 0)\n"
3975 "        {\n"
3976 "          guestfs_set_private (g, key, NULL);\n"
3977 "          /* note that 'key' pointer is now invalid, and so is\n"
3978 "             the internal iterator */\n"
3979 "          goto again;\n"
3980 "        }\n"
3981 "      data = guestfs_next_private (g, &key);\n"
3982 "    }\n"
3983 "\n"
3984 msgstr ""
3985
3986 #. type: textblock
3987 #: ../src/guestfs.pod:2077
3988 msgid ""
3989 "Note that the above loop is guaranteed to terminate because the keys are "
3990 "being deleted, but other manipulations of keys within the loop might not "
3991 "terminate unless you also maintain an indication of which keys have been "
3992 "visited."
3993 msgstr ""
3994
3995 #. type: =end
3996 #: ../src/guestfs.pod:2082 ../src/guestfs.pod:2087
3997 msgid "html"
3998 msgstr ""
3999
4000 #. type: textblock
4001 #: ../src/guestfs.pod:2084
4002 msgid ""
4003 "<!-- old anchor for the next section --> <a "
4004 "name=\"state_machine_and_low_level_event_api\"/>"
4005 msgstr ""
4006
4007 #. type: =head1
4008 #: ../src/guestfs.pod:2089
4009 msgid "ARCHITECTURE"
4010 msgstr ""
4011
4012 #. type: textblock
4013 #: ../src/guestfs.pod:2091
4014 msgid ""
4015 "Internally, libguestfs is implemented by running an appliance (a special "
4016 "type of small virtual machine) using L<qemu(1)>.  Qemu runs as a child "
4017 "process of the main program."
4018 msgstr ""
4019
4020 #. type: verbatim
4021 #: ../src/guestfs.pod:2095
4022 #, no-wrap
4023 msgid ""
4024 "  ___________________\n"
4025 " /                   \\\n"
4026 " | main program      |\n"
4027 " |                   |\n"
4028 " |                   |           child process / appliance\n"
4029 " |                   |           __________________________\n"
4030 " |                   |          / qemu                     \\\n"
4031 " +-------------------+   RPC    |      +-----------------+ |\n"
4032 " | libguestfs     <--------------------> guestfsd        | |\n"
4033 " |                   |          |      +-----------------+ |\n"
4034 " \\___________________/          |      | Linux kernel    | |\n"
4035 "                                |      +--^--------------+ |\n"
4036 "                                \\_________|________________/\n"
4037 "                                          |\n"
4038 "                                   _______v______\n"
4039 "                                  /              \\\n"
4040 "                                  | Device or    |\n"
4041 "                                  | disk image   |\n"
4042 "                                  \\______________/\n"
4043 "\n"
4044 msgstr ""
4045
4046 #. type: textblock
4047 #: ../src/guestfs.pod:2115
4048 msgid ""
4049 "The library, linked to the main program, creates the child process and hence "
4050 "the appliance in the L</guestfs_launch> function."
4051 msgstr ""
4052
4053 #. type: textblock
4054 #: ../src/guestfs.pod:2118
4055 msgid ""
4056 "Inside the appliance is a Linux kernel and a complete stack of userspace "
4057 "tools (such as LVM and ext2 programs) and a small controlling daemon called "
4058 "L</guestfsd>.  The library talks to L</guestfsd> using remote procedure "
4059 "calls (RPC).  There is a mostly one-to-one correspondence between libguestfs "
4060 "API calls and RPC calls to the daemon.  Lastly the disk image(s) are "
4061 "attached to the qemu process which translates device access by the "
4062 "appliance's Linux kernel into accesses to the image."
4063 msgstr ""
4064
4065 #. type: textblock
4066 #: ../src/guestfs.pod:2127
4067 msgid ""
4068 "A common misunderstanding is that the appliance \"is\" the virtual machine.  "
4069 "Although the disk image you are attached to might also be used by some "
4070 "virtual machine, libguestfs doesn't know or care about this.  (But you will "
4071 "care if both libguestfs's qemu process and your virtual machine are trying "
4072 "to update the disk image at the same time, since these usually results in "
4073 "massive disk corruption)."
4074 msgstr ""
4075
4076 #. type: =head1
4077 #: ../src/guestfs.pod:2134
4078 msgid "STATE MACHINE"
4079 msgstr ""
4080
4081 #. type: textblock
4082 #: ../src/guestfs.pod:2136
4083 msgid "libguestfs uses a state machine to model the child process:"
4084 msgstr ""
4085
4086 #. type: verbatim
4087 #: ../src/guestfs.pod:2138
4088 #, no-wrap
4089 msgid ""
4090 "                         |\n"
4091 "                    guestfs_create\n"
4092 "                         |\n"
4093 "                         |\n"
4094 "                     ____V_____\n"
4095 "                    /          \\\n"
4096 "                    |  CONFIG  |\n"
4097 "                    \\__________/\n"
4098 "                     ^ ^   ^  \\\n"
4099 "                    /  |    \\  \\ guestfs_launch\n"
4100 "                   /   |    _\\__V______\n"
4101 "                  /    |   /           \\\n"
4102 "                 /     |   | LAUNCHING |\n"
4103 "                /      |   \\___________/\n"
4104 "               /       |       /\n"
4105 "              /        |  guestfs_launch\n"
4106 "             /         |     /\n"
4107 "    ______  /        __|____V\n"
4108 "   /      \\ ------> /        \\\n"
4109 "   | BUSY |         | READY  |\n"
4110 "   \\______/ <------ \\________/\n"
4111 "\n"
4112 msgstr ""
4113
4114 #. type: textblock
4115 #: ../src/guestfs.pod:2160
4116 msgid ""
4117 "The normal transitions are (1) CONFIG (when the handle is created, but there "
4118 "is no child process), (2) LAUNCHING (when the child process is booting up), "
4119 "(3) alternating between READY and BUSY as commands are issued to, and "
4120 "carried out by, the child process."
4121 msgstr ""
4122
4123 #. type: textblock
4124 #: ../src/guestfs.pod:2165
4125 msgid ""
4126 "The guest may be killed by L</guestfs_kill_subprocess>, or may die "
4127 "asynchronously at any time (eg. due to some internal error), and that causes "
4128 "the state to transition back to CONFIG."
4129 msgstr ""
4130
4131 #. type: textblock
4132 #: ../src/guestfs.pod:2169
4133 msgid ""
4134 "Configuration commands for qemu such as L</guestfs_add_drive> can only be "
4135 "issued when in the CONFIG state."
4136 msgstr ""
4137
4138 #. type: textblock
4139 #: ../src/guestfs.pod:2172
4140 msgid ""
4141 "The API offers one call that goes from CONFIG through LAUNCHING to READY.  "
4142 "L</guestfs_launch> blocks until the child process is READY to accept "
4143 "commands (or until some failure or timeout).  L</guestfs_launch> internally "
4144 "moves the state from CONFIG to LAUNCHING while it is running."
4145 msgstr ""
4146
4147 #. type: textblock
4148 #: ../src/guestfs.pod:2178
4149 msgid ""
4150 "API actions such as L</guestfs_mount> can only be issued when in the READY "
4151 "state.  These API calls block waiting for the command to be carried out "
4152 "(ie. the state to transition to BUSY and then back to READY).  There are no "
4153 "non-blocking versions, and no way to issue more than one command per handle "
4154 "at the same time."
4155 msgstr ""
4156
4157 #. type: textblock
4158 #: ../src/guestfs.pod:2184
4159 msgid ""
4160 "Finally, the child process sends asynchronous messages back to the main "
4161 "program, such as kernel log messages.  You can register a callback to "
4162 "receive these messages."
4163 msgstr ""
4164
4165 #. type: =head1
4166 #: ../src/guestfs.pod:2188
4167 msgid "INTERNALS"
4168 msgstr ""
4169
4170 #. type: =head2
4171 #: ../src/guestfs.pod:2190
4172 msgid "COMMUNICATION PROTOCOL"
4173 msgstr ""
4174
4175 #. type: textblock
4176 #: ../src/guestfs.pod:2192
4177 msgid ""
4178 "Don't rely on using this protocol directly.  This section documents how it "
4179 "currently works, but it may change at any time."
4180 msgstr ""
4181
4182 #. type: textblock
4183 #: ../src/guestfs.pod:2195
4184 msgid ""
4185 "The protocol used to talk between the library and the daemon running inside "
4186 "the qemu virtual machine is a simple RPC mechanism built on top of XDR (RFC "
4187 "1014, RFC 1832, RFC 4506)."
4188 msgstr ""
4189
4190 #. type: textblock
4191 #: ../src/guestfs.pod:2199
4192 msgid ""
4193 "The detailed format of structures is in C<src/guestfs_protocol.x> (note: "
4194 "this file is automatically generated)."
4195 msgstr ""
4196
4197 #. type: textblock
4198 #: ../src/guestfs.pod:2202
4199 msgid ""
4200 "There are two broad cases, ordinary functions that don't have any C<FileIn> "
4201 "and C<FileOut> parameters, which are handled with very simple request/reply "
4202 "messages.  Then there are functions that have any C<FileIn> or C<FileOut> "
4203 "parameters, which use the same request and reply messages, but they may also "
4204 "be followed by files sent using a chunked encoding."
4205 msgstr ""
4206
4207 #. type: =head3
4208 #: ../src/guestfs.pod:2209
4209 msgid "ORDINARY FUNCTIONS (NO FILEIN/FILEOUT PARAMS)"
4210 msgstr ""
4211
4212 #. type: textblock
4213 #: ../src/guestfs.pod:2211
4214 msgid "For ordinary functions, the request message is:"
4215 msgstr ""
4216
4217 #. type: verbatim
4218 #: ../src/guestfs.pod:2213
4219 #, no-wrap
4220 msgid ""
4221 " total length (header + arguments,\n"
4222 "      but not including the length word itself)\n"
4223 " struct guestfs_message_header (encoded as XDR)\n"
4224 " struct guestfs_<foo>_args (encoded as XDR)\n"
4225 "\n"
4226 msgstr ""
4227
4228 #. type: textblock
4229 #: ../src/guestfs.pod:2218
4230 msgid ""
4231 "The total length field allows the daemon to allocate a fixed size buffer "
4232 "into which it slurps the rest of the message.  As a result, the total length "
4233 "is limited to C<GUESTFS_MESSAGE_MAX> bytes (currently 4MB), which means the "
4234 "effective size of any request is limited to somewhere under this size."
4235 msgstr ""
4236
4237 #. type: textblock
4238 #: ../src/guestfs.pod:2224
4239 msgid ""
4240 "Note also that many functions don't take any arguments, in which case the "
4241 "C<guestfs_I<foo>_args> is completely omitted."
4242 msgstr ""
4243
4244 #. type: textblock
4245 #: ../src/guestfs.pod:2227
4246 msgid ""
4247 "The header contains the procedure number (C<guestfs_proc>) which is how the "
4248 "receiver knows what type of args structure to expect, or none at all."
4249 msgstr ""
4250
4251 #. type: textblock
4252 #: ../src/guestfs.pod:2231
4253 msgid ""
4254 "For functions that take optional arguments, the optional arguments are "
4255 "encoded in the C<guestfs_I<foo>_args> structure in the same way as ordinary "
4256 "arguments.  A bitmask in the header indicates which optional arguments are "
4257 "meaningful.  The bitmask is also checked to see if it contains bits set "
4258 "which the daemon does not know about (eg. if more optional arguments were "
4259 "added in a later version of the library), and this causes the call to be "
4260 "rejected."
4261 msgstr ""
4262
4263 #. type: textblock
4264 #: ../src/guestfs.pod:2239
4265 msgid "The reply message for ordinary functions is:"
4266 msgstr ""
4267
4268 #. type: verbatim
4269 #: ../src/guestfs.pod:2241
4270 #, no-wrap
4271 msgid ""
4272 " total length (header + ret,\n"
4273 "      but not including the length word itself)\n"
4274 " struct guestfs_message_header (encoded as XDR)\n"
4275 " struct guestfs_<foo>_ret (encoded as XDR)\n"
4276 "\n"
4277 msgstr ""
4278
4279 #. type: textblock
4280 #: ../src/guestfs.pod:2246
4281 msgid ""
4282 "As above the C<guestfs_I<foo>_ret> structure may be completely omitted for "
4283 "functions that return no formal return values."
4284 msgstr ""
4285
4286 #. type: textblock
4287 #: ../src/guestfs.pod:2249
4288 msgid "As above the total length of the reply is limited to C<GUESTFS_MESSAGE_MAX>."
4289 msgstr ""
4290
4291 #. type: textblock
4292 #: ../src/guestfs.pod:2252
4293 msgid ""
4294 "In the case of an error, a flag is set in the header, and the reply message "
4295 "is slightly changed:"
4296 msgstr ""
4297
4298 #. type: verbatim
4299 #: ../src/guestfs.pod:2255
4300 #, no-wrap
4301 msgid ""
4302 " total length (header + error,\n"
4303 "      but not including the length word itself)\n"
4304 " struct guestfs_message_header (encoded as XDR)\n"
4305 " struct guestfs_message_error (encoded as XDR)\n"
4306 "\n"
4307 msgstr ""
4308
4309 #. type: textblock
4310 #: ../src/guestfs.pod:2260
4311 msgid ""
4312 "The C<guestfs_message_error> structure contains the error message as a "
4313 "string."
4314 msgstr ""
4315
4316 #. type: =head3
4317 #: ../src/guestfs.pod:2263
4318 msgid "FUNCTIONS THAT HAVE FILEIN PARAMETERS"
4319 msgstr ""
4320
4321 #. type: textblock
4322 #: ../src/guestfs.pod:2265
4323 msgid ""
4324 "A C<FileIn> parameter indicates that we transfer a file I<into> the guest.  "
4325 "The normal request message is sent (see above).  However this is followed by "
4326 "a sequence of file chunks."
4327 msgstr ""
4328
4329 #. type: verbatim
4330 #: ../src/guestfs.pod:2269
4331 #, no-wrap
4332 msgid ""
4333 " total length (header + arguments,\n"
4334 "      but not including the length word itself,\n"
4335 "      and not including the chunks)\n"
4336 " struct guestfs_message_header (encoded as XDR)\n"
4337 " struct guestfs_<foo>_args (encoded as XDR)\n"
4338 " sequence of chunks for FileIn param #0\n"
4339 " sequence of chunks for FileIn param #1 etc.\n"
4340 "\n"
4341 msgstr ""
4342
4343 #. type: textblock
4344 #: ../src/guestfs.pod:2277
4345 msgid "The \"sequence of chunks\" is:"
4346 msgstr ""
4347
4348 #. type: verbatim
4349 #: ../src/guestfs.pod:2279
4350 #, no-wrap
4351 msgid ""
4352 " length of chunk (not including length word itself)\n"
4353 " struct guestfs_chunk (encoded as XDR)\n"
4354 " length of chunk\n"
4355 " struct guestfs_chunk (encoded as XDR)\n"
4356 "   ...\n"
4357 " length of chunk\n"
4358 " struct guestfs_chunk (with data.data_len == 0)\n"
4359 "\n"
4360 msgstr ""
4361
4362 #. type: textblock
4363 #: ../src/guestfs.pod:2287
4364 msgid ""
4365 "The final chunk has the C<data_len> field set to zero.  Additionally a flag "
4366 "is set in the final chunk to indicate either successful completion or early "
4367 "cancellation."
4368 msgstr ""
4369
4370 #. type: textblock
4371 #: ../src/guestfs.pod:2291
4372 msgid ""
4373 "At time of writing there are no functions that have more than one FileIn "
4374 "parameter.  However this is (theoretically) supported, by sending the "
4375 "sequence of chunks for each FileIn parameter one after another (from left to "
4376 "right)."
4377 msgstr ""
4378
4379 #. type: textblock
4380 #: ../src/guestfs.pod:2296
4381 msgid ""
4382 "Both the library (sender) I<and> the daemon (receiver) may cancel the "
4383 "transfer.  The library does this by sending a chunk with a special flag set "
4384 "to indicate cancellation.  When the daemon sees this, it cancels the whole "
4385 "RPC, does I<not> send any reply, and goes back to reading the next request."
4386 msgstr ""
4387
4388 #. type: textblock
4389 #: ../src/guestfs.pod:2302
4390 msgid ""
4391 "The daemon may also cancel.  It does this by writing a special word "
4392 "C<GUESTFS_CANCEL_FLAG> to the socket.  The library listens for this during "
4393 "the transfer, and if it gets it, it will cancel the transfer (it sends a "
4394 "cancel chunk).  The special word is chosen so that even if cancellation "
4395 "happens right at the end of the transfer (after the library has finished "
4396 "writing and has started listening for the reply), the \"spurious\" cancel "
4397 "flag will not be confused with the reply message."
4398 msgstr ""
4399
4400 #. type: textblock
4401 #: ../src/guestfs.pod:2311
4402 msgid ""
4403 "This protocol allows the transfer of arbitrary sized files (no 32 bit "
4404 "limit), and also files where the size is not known in advance (eg. from "
4405 "pipes or sockets).  However the chunks are rather small "
4406 "(C<GUESTFS_MAX_CHUNK_SIZE>), so that neither the library nor the daemon need "
4407 "to keep much in memory."
4408 msgstr ""
4409
4410 #. type: =head3
4411 #: ../src/guestfs.pod:2317
4412 msgid "FUNCTIONS THAT HAVE FILEOUT PARAMETERS"
4413 msgstr ""
4414
4415 #. type: textblock
4416 #: ../src/guestfs.pod:2319
4417 msgid ""
4418 "The protocol for FileOut parameters is exactly the same as for FileIn "
4419 "parameters, but with the roles of daemon and library reversed."
4420 msgstr ""
4421
4422 #. type: verbatim
4423 #: ../src/guestfs.pod:2322
4424 #, no-wrap
4425 msgid ""
4426 " total length (header + ret,\n"
4427 "      but not including the length word itself,\n"
4428 "      and not including the chunks)\n"
4429 " struct guestfs_message_header (encoded as XDR)\n"
4430 " struct guestfs_<foo>_ret (encoded as XDR)\n"
4431 " sequence of chunks for FileOut param #0\n"
4432 " sequence of chunks for FileOut param #1 etc.\n"
4433 "\n"
4434 msgstr ""
4435
4436 #. type: =head3
4437 #: ../src/guestfs.pod:2330
4438 msgid "INITIAL MESSAGE"
4439 msgstr ""
4440
4441 #. type: textblock
4442 #: ../src/guestfs.pod:2332
4443 msgid ""
4444 "When the daemon launches it sends an initial word (C<GUESTFS_LAUNCH_FLAG>) "
4445 "which indicates that the guest and daemon is alive.  This is what "
4446 "L</guestfs_launch> waits for."
4447 msgstr ""
4448
4449 #. type: =head3
4450 #: ../src/guestfs.pod:2336
4451 msgid "PROGRESS NOTIFICATION MESSAGES"
4452 msgstr ""
4453
4454 #. type: textblock
4455 #: ../src/guestfs.pod:2338
4456 msgid ""
4457 "The daemon may send progress notification messages at any time.  These are "
4458 "distinguished by the normal length word being replaced by "
4459 "C<GUESTFS_PROGRESS_FLAG>, followed by a fixed size progress message."
4460 msgstr ""
4461
4462 #. type: textblock
4463 #: ../src/guestfs.pod:2342
4464 msgid ""
4465 "The library turns them into progress callbacks (see "
4466 "L</GUESTFS_EVENT_PROGRESS>) if there is a callback registered, or discards "
4467 "them if not."
4468 msgstr ""
4469
4470 #. type: textblock
4471 #: ../src/guestfs.pod:2346
4472 msgid ""
4473 "The daemon self-limits the frequency of progress messages it sends (see "
4474 "C<daemon/proto.c:notify_progress>).  Not all calls generate progress "
4475 "messages."
4476 msgstr ""
4477
4478 #. type: =head1
4479 #: ../src/guestfs.pod:2350
4480 msgid "LIBGUESTFS VERSION NUMBERS"
4481 msgstr ""
4482
4483 #. type: textblock
4484 #: ../src/guestfs.pod:2352
4485 msgid ""
4486 "Since April 2010, libguestfs has started to make separate development and "
4487 "stable releases, along with corresponding branches in our git repository.  "
4488 "These separate releases can be identified by version number:"
4489 msgstr ""
4490
4491 #. type: verbatim
4492 #: ../src/guestfs.pod:2357
4493 #, no-wrap
4494 msgid ""
4495 "                 even numbers for stable: 1.2.x, 1.4.x, ...\n"
4496 "       .-------- odd numbers for development: 1.3.x, 1.5.x, ...\n"
4497 "       |\n"
4498 "       v\n"
4499 " 1  .  3  .  5\n"
4500 " ^           ^\n"
4501 " |           |\n"
4502 " |           `-------- sub-version\n"
4503 " |\n"
4504 " `------ always '1' because we don't change the ABI\n"
4505 "\n"
4506 msgstr ""
4507
4508 #. type: textblock
4509 #: ../src/guestfs.pod:2368
4510 msgid "Thus \"1.3.5\" is the 5th update to the development branch \"1.3\"."
4511 msgstr ""
4512
4513 #. type: textblock
4514 #: ../src/guestfs.pod:2370
4515 msgid ""
4516 "As time passes we cherry pick fixes from the development branch and backport "
4517 "those into the stable branch, the effect being that the stable branch should "
4518 "get more stable and less buggy over time.  So the stable releases are ideal "
4519 "for people who don't need new features but would just like the software to "
4520 "work."
4521 msgstr ""
4522
4523 #. type: textblock
4524 #: ../src/guestfs.pod:2376
4525 msgid "Our criteria for backporting changes are:"
4526 msgstr ""
4527
4528 #. type: textblock
4529 #: ../src/guestfs.pod:2382
4530 msgid ""
4531 "Documentation changes which don't affect any code are backported unless the "
4532 "documentation refers to a future feature which is not in stable."
4533 msgstr ""
4534
4535 #. type: textblock
4536 #: ../src/guestfs.pod:2388
4537 msgid ""
4538 "Bug fixes which are not controversial, fix obvious problems, and have been "
4539 "well tested are backported."
4540 msgstr ""
4541
4542 #. type: textblock
4543 #: ../src/guestfs.pod:2393
4544 msgid ""
4545 "Simple rearrangements of code which shouldn't affect how it works get "
4546 "backported.  This is so that the code in the two branches doesn't get too "
4547 "far out of step, allowing us to backport future fixes more easily."
4548 msgstr ""
4549
4550 #. type: textblock
4551 #: ../src/guestfs.pod:2399
4552 msgid ""
4553 "We I<don't> backport new features, new APIs, new tools etc, except in one "
4554 "exceptional case: the new feature is required in order to implement an "
4555 "important bug fix."
4556 msgstr ""
4557
4558 #. type: textblock
4559 #: ../src/guestfs.pod:2405
4560 msgid ""
4561 "A new stable branch starts when we think the new features in development are "
4562 "substantial and compelling enough over the current stable branch to warrant "
4563 "it.  When that happens we create new stable and development versions 1.N.0 "
4564 "and 1.(N+1).0 [N is even].  The new dot-oh release won't necessarily be so "
4565 "stable at this point, but by backporting fixes from development, that branch "
4566 "will stabilize over time."
4567 msgstr ""
4568
4569 #. type: =head1
4570 #: ../src/guestfs.pod:2413
4571 msgid "EXTENDING LIBGUESTFS"
4572 msgstr ""
4573
4574 #. type: =head2
4575 #: ../src/guestfs.pod:2415
4576 msgid "ADDING A NEW API ACTION"
4577 msgstr ""
4578
4579 #. type: textblock
4580 #: ../src/guestfs.pod:2417
4581 msgid ""
4582 "Large amounts of boilerplate code in libguestfs (RPC, bindings, "
4583 "documentation) are generated, and this makes it easy to extend the "
4584 "libguestfs API."
4585 msgstr ""
4586
4587 #. type: textblock
4588 #: ../src/guestfs.pod:2421
4589 msgid "To add a new API action there are two changes:"
4590 msgstr ""
4591
4592 #. type: textblock
4593 #: ../src/guestfs.pod:2427
4594 msgid ""
4595 "You need to add a description of the call (name, parameters, return type, "
4596 "tests, documentation) to C<generator/generator_actions.ml>."
4597 msgstr ""
4598
4599 #. type: textblock
4600 #: ../src/guestfs.pod:2430
4601 msgid ""
4602 "There are two sorts of API action, depending on whether the call goes "
4603 "through to the daemon in the appliance, or is serviced entirely by the "
4604 "library (see L</ARCHITECTURE> above).  L</guestfs_sync> is an example of the "
4605 "former, since the sync is done in the appliance.  L</guestfs_set_trace> is "
4606 "an example of the latter, since a trace flag is maintained in the handle and "
4607 "all tracing is done on the library side."
4608 msgstr ""
4609
4610 #. type: textblock
4611 #: ../src/guestfs.pod:2438
4612 msgid ""
4613 "Most new actions are of the first type, and get added to the "
4614 "C<daemon_functions> list.  Each function has a unique procedure number used "
4615 "in the RPC protocol which is assigned to that action when we publish "
4616 "libguestfs and cannot be reused.  Take the latest procedure number and "
4617 "increment it."
4618 msgstr ""
4619
4620 #. type: textblock
4621 #: ../src/guestfs.pod:2444
4622 msgid ""
4623 "For library-only actions of the second type, add to the "
4624 "C<non_daemon_functions> list.  Since these functions are serviced by the "
4625 "library and do not travel over the RPC mechanism to the daemon, these "
4626 "functions do not need a procedure number, and so the procedure number is set "
4627 "to C<-1>."
4628 msgstr ""
4629
4630 #. type: textblock
4631 #: ../src/guestfs.pod:2452
4632 msgid "Implement the action (in C):"
4633 msgstr ""
4634
4635 #. type: textblock
4636 #: ../src/guestfs.pod:2454
4637 msgid ""
4638 "For daemon actions, implement the function C<do_E<lt>nameE<gt>> in the "
4639 "C<daemon/> directory."
4640 msgstr ""
4641
4642 #. type: textblock
4643 #: ../src/guestfs.pod:2457
4644 msgid ""
4645 "For library actions, implement the function C<guestfs__E<lt>nameE<gt>> "
4646 "(note: double underscore) in the C<src/> directory."
4647 msgstr ""
4648
4649 #. type: textblock
4650 #: ../src/guestfs.pod:2460
4651 msgid "In either case, use another function as an example of what to do."
4652 msgstr ""
4653
4654 #. type: textblock
4655 #: ../src/guestfs.pod:2464
4656 msgid "After making these changes, use C<make> to compile."
4657 msgstr ""
4658
4659 #. type: textblock
4660 #: ../src/guestfs.pod:2466
4661 msgid ""
4662 "Note that you don't need to implement the RPC, language bindings, manual "
4663 "pages or anything else.  It's all automatically generated from the OCaml "
4664 "description."
4665 msgstr ""
4666
4667 #. type: =head2
4668 #: ../src/guestfs.pod:2470
4669 msgid "ADDING TESTS FOR AN API ACTION"
4670 msgstr ""
4671
4672 #. type: textblock
4673 #: ../src/guestfs.pod:2472
4674 msgid ""
4675 "You can supply zero or as many tests as you want per API call.  The tests "
4676 "can either be added as part of the API description "
4677 "(C<generator/generator_actions.ml>), or in some rarer cases you may want to "
4678 "drop a script into C<regressions/>.  Note that adding a script to "
4679 "C<regressions/> is slower, so if possible use the first method."
4680 msgstr ""
4681
4682 #. type: textblock
4683 #: ../src/guestfs.pod:2478
4684 msgid ""
4685 "The following describes the test environment used when you add an API test "
4686 "in C<generator_actions.ml>."
4687 msgstr ""
4688
4689 #. type: textblock
4690 #: ../src/guestfs.pod:2481
4691 msgid "The test environment has 4 block devices:"
4692 msgstr ""
4693
4694 #. type: =item
4695 #: ../src/guestfs.pod:2485
4696 msgid "C</dev/sda> 500MB"
4697 msgstr ""
4698
4699 #. type: textblock
4700 #: ../src/guestfs.pod:2487
4701 msgid "General block device for testing."
4702 msgstr ""
4703
4704 #. type: =item
4705 #: ../src/guestfs.pod:2489
4706 msgid "C</dev/sdb> 50MB"
4707 msgstr ""
4708
4709 #. type: textblock
4710 #: ../src/guestfs.pod:2491
4711 msgid ""
4712 "C</dev/sdb1> is an ext2 filesystem used for testing filesystem write "
4713 "operations."
4714 msgstr ""
4715
4716 #. type: =item
4717 #: ../src/guestfs.pod:2494
4718 msgid "C</dev/sdc> 10MB"
4719 msgstr ""
4720
4721 #. type: textblock
4722 #: ../src/guestfs.pod:2496
4723 msgid "Used in a few tests where two block devices are needed."
4724 msgstr ""
4725
4726 #. type: =item
4727 #: ../src/guestfs.pod:2498
4728 msgid "C</dev/sdd>"
4729 msgstr ""
4730
4731 #. type: textblock
4732 #: ../src/guestfs.pod:2500
4733 msgid "ISO with fixed content (see C<images/test.iso>)."
4734 msgstr ""
4735
4736 #. type: textblock
4737 #: ../src/guestfs.pod:2504
4738 msgid ""
4739 "To be able to run the tests in a reasonable amount of time, the libguestfs "
4740 "appliance and block devices are reused between tests.  So don't try testing "
4741 "L</guestfs_kill_subprocess> :-x"
4742 msgstr ""
4743
4744 #. type: textblock
4745 #: ../src/guestfs.pod:2508
4746 msgid ""
4747 "Each test starts with an initial scenario, selected using one of the "
4748 "C<Init*> expressions, described in C<generator/generator_types.ml>.  These "
4749 "initialize the disks mentioned above in a particular way as documented in "
4750 "C<generator_types.ml>.  You should not assume anything about the previous "
4751 "contents of other disks that are not initialized."
4752 msgstr ""
4753
4754 #. type: textblock
4755 #: ../src/guestfs.pod:2514
4756 msgid ""
4757 "You can add a prerequisite clause to any individual test.  This is a "
4758 "run-time check, which, if it fails, causes the test to be skipped.  Useful "
4759 "if testing a command which might not work on all variations of libguestfs "
4760 "builds.  A test that has prerequisite of C<Always> means to run "
4761 "unconditionally."
4762 msgstr ""
4763
4764 #. type: textblock
4765 #: ../src/guestfs.pod:2520
4766 msgid ""
4767 "In addition, packagers can skip individual tests by setting environment "
4768 "variables before running C<make check>."
4769 msgstr ""
4770
4771 #. type: verbatim
4772 #: ../src/guestfs.pod:2523
4773 #, no-wrap
4774 msgid ""
4775 " SKIP_TEST_<CMD>_<NUM>=1\n"
4776 "\n"
4777 msgstr ""
4778
4779 #. type: textblock
4780 #: ../src/guestfs.pod:2525
4781 msgid "eg: C<SKIP_TEST_COMMAND_3=1> skips test #3 of L</guestfs_command>."
4782 msgstr ""
4783
4784 #. type: textblock
4785 #: ../src/guestfs.pod:2527
4786 msgid "or:"
4787 msgstr ""
4788
4789 #. type: verbatim
4790 #: ../src/guestfs.pod:2529
4791 #, no-wrap
4792 msgid ""
4793 " SKIP_TEST_<CMD>=1\n"
4794 "\n"
4795 msgstr ""
4796
4797 #. type: textblock
4798 #: ../src/guestfs.pod:2531
4799 msgid "eg: C<SKIP_TEST_ZEROFREE=1> skips all L</guestfs_zerofree> tests."
4800 msgstr ""
4801
4802 #. type: textblock
4803 #: ../src/guestfs.pod:2533
4804 msgid "Packagers can run only certain tests by setting for example:"
4805 msgstr ""
4806
4807 #. type: verbatim
4808 #: ../src/guestfs.pod:2535
4809 #, no-wrap
4810 msgid ""
4811 " TEST_ONLY=\"vfs_type zerofree\"\n"
4812 "\n"
4813 msgstr ""
4814
4815 #. type: textblock
4816 #: ../src/guestfs.pod:2537
4817 msgid ""
4818 "See C<capitests/tests.c> for more details of how these environment variables "
4819 "work."
4820 msgstr ""
4821
4822 #. type: =head2
4823 #: ../src/guestfs.pod:2540
4824 msgid "DEBUGGING NEW API ACTIONS"
4825 msgstr ""
4826
4827 #. type: textblock
4828 #: ../src/guestfs.pod:2542
4829 msgid "Test new actions work before submitting them."
4830 msgstr ""
4831
4832 #. type: textblock
4833 #: ../src/guestfs.pod:2544
4834 msgid "You can use guestfish to try out new commands."
4835 msgstr ""
4836
4837 #. type: textblock
4838 #: ../src/guestfs.pod:2546
4839 msgid ""
4840 "Debugging the daemon is a problem because it runs inside a minimal "
4841 "environment.  However you can fprintf messages in the daemon to stderr, and "
4842 "they will show up if you use C<guestfish -v>."
4843 msgstr ""
4844
4845 #. type: =head2
4846 #: ../src/guestfs.pod:2550
4847 msgid "FORMATTING CODE AND OTHER CONVENTIONS"
4848 msgstr ""
4849
4850 #. type: textblock
4851 #: ../src/guestfs.pod:2552
4852 msgid ""
4853 "Our C source code generally adheres to some basic code-formatting "
4854 "conventions.  The existing code base is not totally consistent on this "
4855 "front, but we do prefer that contributed code be formatted similarly.  In "
4856 "short, use spaces-not-TABs for indentation, use 2 spaces for each "
4857 "indentation level, and other than that, follow the K&R style."
4858 msgstr ""
4859
4860 #. type: textblock
4861 #: ../src/guestfs.pod:2558
4862 msgid ""
4863 "If you use Emacs, add the following to one of one of your start-up files "
4864 "(e.g., ~/.emacs), to help ensure that you get indentation right:"
4865 msgstr ""
4866
4867 #. type: verbatim
4868 #: ../src/guestfs.pod:2561
4869 #, no-wrap
4870 msgid ""
4871 " ;;; In libguestfs, indent with spaces everywhere (not TABs).\n"
4872 " ;;; Exceptions: Makefile and ChangeLog modes.\n"
4873 " (add-hook 'find-file-hook\n"
4874 "     '(lambda () (if (and buffer-file-name\n"
4875 "                          (string-match \"/libguestfs\\\\>\"\n"
4876 "                              (buffer-file-name))\n"
4877 "                          (not (string-equal mode-name \"Change Log\"))\n"
4878 "                          (not (string-equal mode-name \"Makefile\")))\n"
4879 "                     (setq indent-tabs-mode nil))))\n"
4880 " \n"
4881 msgstr ""
4882
4883 #. type: verbatim
4884 #: ../src/guestfs.pod:2571
4885 #, no-wrap
4886 msgid ""
4887 " ;;; When editing C sources in libguestfs, use this style.\n"
4888 " (defun libguestfs-c-mode ()\n"
4889 "   \"C mode with adjusted defaults for use with libguestfs.\"\n"
4890 "   (interactive)\n"
4891 "   (c-set-style \"K&R\")\n"
4892 "   (setq c-indent-level 2)\n"
4893 "   (setq c-basic-offset 2))\n"
4894 " (add-hook 'c-mode-hook\n"
4895 "           '(lambda () (if (string-match \"/libguestfs\\\\>\"\n"
4896 "                               (buffer-file-name))\n"
4897 "                           (libguestfs-c-mode))))\n"
4898 "\n"
4899 msgstr ""
4900
4901 #. type: textblock
4902 #: ../src/guestfs.pod:2583
4903 msgid "Enable warnings when compiling (and fix any problems this finds):"
4904 msgstr ""
4905
4906 #. type: verbatim
4907 #: ../src/guestfs.pod:2586
4908 #, no-wrap
4909 msgid ""
4910 " ./configure --enable-gcc-warnings\n"
4911 "\n"
4912 msgstr ""
4913
4914 #. type: textblock
4915 #: ../src/guestfs.pod:2588
4916 msgid "Useful targets are:"
4917 msgstr ""
4918
4919 #. type: verbatim
4920 #: ../src/guestfs.pod:2590
4921 #, no-wrap
4922 msgid ""
4923 " make syntax-check  # checks the syntax of the C code\n"
4924 " make check         # runs the test suite\n"
4925 "\n"
4926 msgstr ""
4927
4928 #. type: =head2
4929 #: ../src/guestfs.pod:2593
4930 msgid "DAEMON CUSTOM PRINTF FORMATTERS"
4931 msgstr ""
4932
4933 #. type: textblock
4934 #: ../src/guestfs.pod:2595
4935 msgid ""
4936 "In the daemon code we have created custom printf formatters C<%Q> and C<%R>, "
4937 "which are used to do shell quoting."
4938 msgstr ""
4939
4940 #. type: =item
4941 #: ../src/guestfs.pod:2600
4942 msgid "%Q"
4943 msgstr ""
4944
4945 #. type: textblock
4946 #: ../src/guestfs.pod:2602
4947 msgid ""
4948 "Simple shell quoted string.  Any spaces or other shell characters are "
4949 "escaped for you."
4950 msgstr ""
4951
4952 #. type: =item
4953 #: ../src/guestfs.pod:2605
4954 msgid "%R"
4955 msgstr ""
4956
4957 #. type: textblock
4958 #: ../src/guestfs.pod:2607
4959 msgid ""
4960 "Same as C<%Q> except the string is treated as a path which is prefixed by "
4961 "the sysroot."
4962 msgstr ""
4963
4964 #. type: textblock
4965 #: ../src/guestfs.pod:2612 ../fish/guestfish.pod:240 ../fish/guestfish.pod:613
4966 msgid "For example:"
4967 msgstr ""
4968
4969 #. type: verbatim
4970 #: ../src/guestfs.pod:2614
4971 #, no-wrap
4972 msgid ""
4973 " asprintf (&cmd, \"cat %R\", path);\n"
4974 "\n"
4975 msgstr ""
4976
4977 #. type: textblock
4978 #: ../src/guestfs.pod:2616
4979 msgid "would produce C<cat /sysroot/some\\ path\\ with\\ spaces>"
4980 msgstr ""
4981
4982 #. type: textblock
4983 #: ../src/guestfs.pod:2618
4984 msgid ""
4985 "I<Note:> Do I<not> use these when you are passing parameters to the "
4986 "C<command{,r,v,rv}()> functions.  These parameters do NOT need to be quoted "
4987 "because they are not passed via the shell (instead, straight to exec).  You "
4988 "probably want to use the C<sysroot_path()> function however."
4989 msgstr ""
4990
4991 #. type: =head2
4992 #: ../src/guestfs.pod:2624
4993 msgid "SUBMITTING YOUR NEW API ACTIONS"
4994 msgstr ""
4995
4996 #. type: textblock
4997 #: ../src/guestfs.pod:2626
4998 msgid ""
4999 "Submit patches to the mailing list: "
5000 "L<http://www.redhat.com/mailman/listinfo/libguestfs> and CC to "
5001 "L<rjones@redhat.com>."
5002 msgstr ""
5003
5004 #. type: =head2
5005 #: ../src/guestfs.pod:2630
5006 msgid "INTERNATIONALIZATION (I18N) SUPPORT"
5007 msgstr ""
5008
5009 #. type: textblock
5010 #: ../src/guestfs.pod:2632
5011 msgid "We support i18n (gettext anyhow) in the library."
5012 msgstr ""
5013
5014 #. type: textblock
5015 #: ../src/guestfs.pod:2634
5016 msgid ""
5017 "However many messages come from the daemon, and we don't translate those at "
5018 "the moment.  One reason is that the appliance generally has all locale files "
5019 "removed from it, because they take up a lot of space.  So we'd have to readd "
5020 "some of those, as well as copying our PO files into the appliance."
5021 msgstr ""
5022
5023 #. type: textblock
5024 #: ../src/guestfs.pod:2640
5025 msgid ""
5026 "Debugging messages are never translated, since they are intended for the "
5027 "programmers."
5028 msgstr ""
5029
5030 #. type: =head2
5031 #: ../src/guestfs.pod:2643
5032 msgid "SOURCE CODE SUBDIRECTORIES"
5033 msgstr ""
5034
5035 #. type: =item
5036 #: ../src/guestfs.pod:2647 ../src/guestfs-actions.pod:5832 ../fish/guestfish-actions.pod:3926
5037 msgid "C<appliance>"
5038 msgstr ""
5039
5040 #. type: textblock
5041 #: ../src/guestfs.pod:2649
5042 msgid "The libguestfs appliance, build scripts and so on."
5043 msgstr ""
5044
5045 #. type: =item
5046 #: ../src/guestfs.pod:2651
5047 msgid "C<capitests>"
5048 msgstr ""
5049
5050 #. type: textblock
5051 #: ../src/guestfs.pod:2653
5052 msgid "Automated tests of the C API."
5053 msgstr ""
5054
5055 #. type: =item
5056 #: ../src/guestfs.pod:2655
5057 msgid "C<cat>"
5058 msgstr ""
5059
5060 #. type: textblock
5061 #: ../src/guestfs.pod:2657
5062 msgid ""
5063 "The L<virt-cat(1)>, L<virt-filesystems(1)> and L<virt-ls(1)> commands and "
5064 "documentation."
5065 msgstr ""
5066
5067 #. type: =item
5068 #: ../src/guestfs.pod:2660
5069 msgid "C<caution>"
5070 msgstr ""
5071
5072 #. type: textblock
5073 #: ../src/guestfs.pod:2662
5074 msgid ""
5075 "Safety and liveness tests of components that libguestfs depends upon (not of "
5076 "libguestfs itself).  Mainly this is for qemu and the kernel."
5077 msgstr ""
5078
5079 #. type: =item
5080 #: ../src/guestfs.pod:2665
5081 msgid "C<contrib>"
5082 msgstr ""
5083
5084 #. type: textblock
5085 #: ../src/guestfs.pod:2667
5086 msgid "Outside contributions, experimental parts."
5087 msgstr ""
5088
5089 #. type: =item
5090 #: ../src/guestfs.pod:2669
5091 msgid "C<daemon>"
5092 msgstr ""
5093
5094 #. type: textblock
5095 #: ../src/guestfs.pod:2671
5096 msgid ""
5097 "The daemon that runs inside the libguestfs appliance and carries out "
5098 "actions."
5099 msgstr ""
5100
5101 #. type: =item
5102 #: ../src/guestfs.pod:2674
5103 msgid "C<df>"
5104 msgstr ""
5105
5106 #. type: textblock
5107 #: ../src/guestfs.pod:2676
5108 msgid "L<virt-df(1)> command and documentation."
5109 msgstr ""
5110
5111 #. type: =item
5112 #: ../src/guestfs.pod:2678
5113 msgid "C<examples>"
5114 msgstr ""
5115
5116 #. type: textblock
5117 #: ../src/guestfs.pod:2680
5118 msgid "C API example code."
5119 msgstr ""
5120
5121 #. type: =item
5122 #: ../src/guestfs.pod:2682
5123 msgid "C<fish>"
5124 msgstr ""
5125
5126 #. type: textblock
5127 #: ../src/guestfs.pod:2684
5128 msgid ""
5129 "L<guestfish(1)>, the command-line shell, and various shell scripts built on "
5130 "top such as L<virt-copy-in(1)>, L<virt-copy-out(1)>, L<virt-tar-in(1)>, "
5131 "L<virt-tar-out(1)>."
5132 msgstr ""
5133
5134 #. type: =item
5135 #: ../src/guestfs.pod:2688
5136 msgid "C<fuse>"
5137 msgstr ""
5138
5139 #. type: textblock
5140 #: ../src/guestfs.pod:2690
5141 msgid "L<guestmount(1)>, FUSE (userspace filesystem) built on top of libguestfs."
5142 msgstr ""
5143
5144 #. type: =item
5145 #: ../src/guestfs.pod:2692
5146 msgid "C<generator>"
5147 msgstr ""
5148
5149 #. type: textblock
5150 #: ../src/guestfs.pod:2694
5151 msgid ""
5152 "The crucially important generator, used to automatically generate large "
5153 "amounts of boilerplate C code for things like RPC and bindings."
5154 msgstr ""
5155
5156 #. type: =item
5157 #: ../src/guestfs.pod:2697
5158 msgid "C<images>"
5159 msgstr ""
5160
5161 #. type: textblock
5162 #: ../src/guestfs.pod:2699
5163 msgid "Files used by the test suite."
5164 msgstr ""
5165
5166 #. type: textblock
5167 #: ../src/guestfs.pod:2701
5168 msgid "Some \"phony\" guest images which we test against."
5169 msgstr ""
5170
5171 #. type: =item
5172 #: ../src/guestfs.pod:2703
5173 msgid "C<inspector>"
5174 msgstr ""
5175
5176 #. type: textblock
5177 #: ../src/guestfs.pod:2705
5178 msgid "L<virt-inspector(1)>, the virtual machine image inspector."
5179 msgstr ""
5180
5181 #. type: =item
5182 #: ../src/guestfs.pod:2707
5183 msgid "C<logo>"
5184 msgstr ""
5185
5186 #. type: textblock
5187 #: ../src/guestfs.pod:2709
5188 msgid "Logo used on the website.  The fish is called Arthur by the way."
5189 msgstr ""
5190
5191 #. type: =item
5192 #: ../src/guestfs.pod:2711
5193 msgid "C<m4>"
5194 msgstr ""
5195
5196 #. type: textblock
5197 #: ../src/guestfs.pod:2713
5198 msgid "M4 macros used by autoconf."
5199 msgstr ""
5200
5201 #. type: =item
5202 #: ../src/guestfs.pod:2715
5203 msgid "C<po>"
5204 msgstr ""
5205
5206 #. type: textblock
5207 #: ../src/guestfs.pod:2717
5208 msgid "Translations of simple gettext strings."
5209 msgstr ""
5210
5211 #. type: =item
5212 #: ../src/guestfs.pod:2719
5213 msgid "C<po-docs>"
5214 msgstr ""
5215
5216 #. type: textblock
5217 #: ../src/guestfs.pod:2721
5218 msgid ""
5219 "The build infrastructure and PO files for translations of manpages and POD "
5220 "files.  Eventually this will be combined with the C<po> directory, but that "
5221 "is rather complicated."
5222 msgstr ""
5223
5224 #. type: =item
5225 #: ../src/guestfs.pod:2725
5226 msgid "C<regressions>"
5227 msgstr ""
5228
5229 #. type: textblock
5230 #: ../src/guestfs.pod:2727
5231 msgid "Regression tests."
5232 msgstr ""
5233
5234 #. type: =item
5235 #: ../src/guestfs.pod:2729
5236 msgid "C<rescue>"
5237 msgstr ""
5238
5239 #. type: textblock
5240 #: ../src/guestfs.pod:2731
5241 msgid "L<virt-rescue(1)> command and documentation."
5242 msgstr ""
5243
5244 #. type: =item
5245 #: ../src/guestfs.pod:2733
5246 msgid "C<src>"
5247 msgstr ""
5248
5249 #. type: textblock
5250 #: ../src/guestfs.pod:2735
5251 msgid "Source code to the C library."
5252 msgstr ""
5253
5254 #. type: =item
5255 #: ../src/guestfs.pod:2737
5256 msgid "C<tools>"
5257 msgstr ""
5258
5259 #. type: textblock
5260 #: ../src/guestfs.pod:2739
5261 msgid "Command line tools written in Perl (L<virt-resize(1)> and many others)."
5262 msgstr ""
5263
5264 #. type: =item
5265 #: ../src/guestfs.pod:2741
5266 msgid "C<test-tool>"
5267 msgstr ""
5268
5269 #. type: textblock
5270 #: ../src/guestfs.pod:2743
5271 msgid ""
5272 "Test tool for end users to test if their qemu/kernel combination will work "
5273 "with libguestfs."
5274 msgstr ""
5275
5276 #. type: =item
5277 #: ../src/guestfs.pod:2746
5278 msgid "C<csharp>"
5279 msgstr ""
5280
5281 #. type: =item
5282 #: ../src/guestfs.pod:2748
5283 msgid "C<haskell>"
5284 msgstr ""
5285
5286 #. type: =item
5287 #: ../src/guestfs.pod:2750
5288 msgid "C<java>"
5289 msgstr ""
5290
5291 #. type: =item
5292 #: ../src/guestfs.pod:2752
5293 msgid "C<ocaml>"
5294 msgstr ""
5295
5296 #. type: =item
5297 #: ../src/guestfs.pod:2754
5298 msgid "C<php>"
5299 msgstr ""
5300
5301 #. type: =item
5302 #: ../src/guestfs.pod:2756
5303 msgid "C<perl>"
5304 msgstr ""
5305
5306 #. type: =item
5307 #: ../src/guestfs.pod:2758
5308 msgid "C<python>"
5309 msgstr ""
5310
5311 #. type: =item
5312 #: ../src/guestfs.pod:2760
5313 msgid "C<ruby>"
5314 msgstr ""
5315
5316 #. type: textblock
5317 #: ../src/guestfs.pod:2762
5318 msgid "Language bindings."
5319 msgstr ""
5320
5321 #. type: =head1
5322 #: ../src/guestfs.pod:2766
5323 msgid "LIMITS"
5324 msgstr ""
5325
5326 #. type: =head2
5327 #: ../src/guestfs.pod:2768
5328 msgid "PROTOCOL LIMITS"
5329 msgstr ""
5330
5331 #. type: textblock
5332 #: ../src/guestfs.pod:2770
5333 msgid ""
5334 "Internally libguestfs uses a message-based protocol to pass API calls and "
5335 "their responses to and from a small \"appliance\" (see L</INTERNALS> for "
5336 "plenty more detail about this).  The maximum message size used by the "
5337 "protocol is slightly less than 4 MB.  For some API calls you may need to be "
5338 "aware of this limit.  The API calls which may be affected are individually "
5339 "documented, with a link back to this section of the documentation."
5340 msgstr ""
5341
5342 #. type: textblock
5343 #: ../src/guestfs.pod:2778
5344 msgid ""
5345 "A simple call such as L</guestfs_cat> returns its result (the file data) in "
5346 "a simple string.  Because this string is at some point internally encoded as "
5347 "a message, the maximum size that it can return is slightly under 4 MB.  If "
5348 "the requested file is larger than this then you will get an error."
5349 msgstr ""
5350
5351 #. type: textblock
5352 #: ../src/guestfs.pod:2784
5353 msgid ""
5354 "In order to transfer large files into and out of the guest filesystem, you "
5355 "need to use particular calls that support this.  The sections L</UPLOADING> "
5356 "and L</DOWNLOADING> document how to do this."
5357 msgstr ""
5358
5359 #. type: textblock
5360 #: ../src/guestfs.pod:2788
5361 msgid ""
5362 "You might also consider mounting the disk image using our FUSE filesystem "
5363 "support (L<guestmount(1)>)."
5364 msgstr ""
5365
5366 #. type: =head2
5367 #: ../src/guestfs.pod:2791
5368 msgid "MAXIMUM NUMBER OF DISKS"
5369 msgstr ""
5370
5371 #. type: textblock
5372 #: ../src/guestfs.pod:2793
5373 msgid "When using virtio disks (the default) the current limit is B<25> disks."
5374 msgstr ""
5375
5376 #. type: textblock
5377 #: ../src/guestfs.pod:2796
5378 msgid ""
5379 "Virtio itself consumes 1 virtual PCI slot per disk, and PCI is limited to 31 "
5380 "slots.  However febootstrap only understands disks with names C</dev/vda> "
5381 "through C</dev/vdz> (26 letters) and it reserves one disk for its own "
5382 "purposes."
5383 msgstr ""
5384
5385 #. type: textblock
5386 #: ../src/guestfs.pod:2801
5387 msgid ""
5388 "We are working to substantially raise this limit in future versions but it "
5389 "requires complex changes to qemu."
5390 msgstr ""
5391
5392 #. type: textblock
5393 #: ../src/guestfs.pod:2804
5394 msgid ""
5395 "In future versions of libguestfs it should also be possible to \"hot plug\" "
5396 "disks (add and remove disks after calling L</guestfs_launch>).  This also "
5397 "requires changes to qemu."
5398 msgstr ""
5399
5400 #. type: =head2
5401 #: ../src/guestfs.pod:2808
5402 msgid "MAXIMUM NUMBER OF PARTITIONS PER DISK"
5403 msgstr ""
5404
5405 #. type: textblock
5406 #: ../src/guestfs.pod:2810
5407 msgid "Virtio limits the maximum number of partitions per disk to B<15>."
5408 msgstr ""
5409
5410 #. type: textblock
5411 #: ../src/guestfs.pod:2812
5412 msgid ""
5413 "This is because it reserves 4 bits for the minor device number (thus "
5414 "C</dev/vda>, and C</dev/vda1> through C</dev/vda15>)."
5415 msgstr ""
5416
5417 #. type: textblock
5418 #: ../src/guestfs.pod:2815
5419 msgid ""
5420 "If you attach a disk with more than 15 partitions, the extra partitions are "
5421 "ignored by libguestfs."
5422 msgstr ""
5423
5424 #. type: =head2
5425 #: ../src/guestfs.pod:2818
5426 msgid "MAXIMUM SIZE OF A DISK"
5427 msgstr ""
5428
5429 #. type: textblock
5430 #: ../src/guestfs.pod:2820
5431 msgid "Probably the limit is between 2**63-1 and 2**64-1 bytes."
5432 msgstr ""
5433
5434 #. type: textblock
5435 #: ../src/guestfs.pod:2822
5436 msgid ""
5437 "We have tested block devices up to 1 exabyte (2**60 or "
5438 "1,152,921,504,606,846,976 bytes) using sparse files backed by an XFS host "
5439 "filesystem."
5440 msgstr ""
5441
5442 #. type: textblock
5443 #: ../src/guestfs.pod:2826
5444 msgid ""
5445 "Although libguestfs probably does not impose any limit, the underlying host "
5446 "storage will.  If you store disk images on a host ext4 filesystem, then the "
5447 "maximum size will be limited by the maximum ext4 file size (currently 16 "
5448 "TB).  If you store disk images as host logical volumes then you are limited "
5449 "by the maximum size of an LV."
5450 msgstr ""
5451
5452 #. type: textblock
5453 #: ../src/guestfs.pod:2832
5454 msgid ""
5455 "For the hugest disk image files, we recommend using XFS on the host for "
5456 "storage."
5457 msgstr ""
5458
5459 #. type: =head2
5460 #: ../src/guestfs.pod:2835
5461 msgid "MAXIMUM SIZE OF A PARTITION"
5462 msgstr ""
5463
5464 #. type: textblock
5465 #: ../src/guestfs.pod:2837
5466 msgid ""
5467 "The MBR (ie. classic MS-DOS) partitioning scheme uses 32 bit sector "
5468 "numbers.  Assuming a 512 byte sector size, this means that MBR cannot "
5469 "address a partition located beyond 2 TB on the disk."
5470 msgstr ""
5471
5472 #. type: textblock
5473 #: ../src/guestfs.pod:2841
5474 msgid ""
5475 "It is recommended that you use GPT partitions on disks which are larger than "
5476 "this size.  GPT uses 64 bit sector numbers and so can address partitions "
5477 "which are theoretically larger than the largest disk we could support."
5478 msgstr ""
5479
5480 #. type: =head2
5481 #: ../src/guestfs.pod:2846
5482 msgid "MAXIMUM SIZE OF A FILESYSTEM, FILES, DIRECTORIES"
5483 msgstr ""
5484
5485 #. type: textblock
5486 #: ../src/guestfs.pod:2848
5487 msgid ""
5488 "This depends on the filesystem type.  libguestfs itself does not impose any "
5489 "known limit.  Consult Wikipedia or the filesystem documentation to find out "
5490 "what these limits are."
5491 msgstr ""
5492
5493 #. type: =head2
5494 #: ../src/guestfs.pod:2852
5495 msgid "MAXIMUM UPLOAD AND DOWNLOAD"
5496 msgstr ""
5497
5498 #. type: textblock
5499 #: ../src/guestfs.pod:2854
5500 msgid ""
5501 "The API functions L</guestfs_upload>, L</guestfs_download>, "
5502 "L</guestfs_tar_in>, L</guestfs_tar_out> and the like allow unlimited sized "
5503 "uploads and downloads."
5504 msgstr ""
5505
5506 #. type: =head2
5507 #: ../src/guestfs.pod:2858
5508 msgid "INSPECTION LIMITS"
5509 msgstr ""
5510
5511 #. type: textblock
5512 #: ../src/guestfs.pod:2860
5513 msgid ""
5514 "The inspection code has several arbitrary limits on things like the size of "
5515 "Windows Registry hive it will read, and the length of product name.  These "
5516 "are intended to stop a malicious guest from consuming arbitrary amounts of "
5517 "memory and disk space on the host, and should not be reached in practice.  "
5518 "See the source code for more information."
5519 msgstr ""
5520
5521 #. type: =head1
5522 #: ../src/guestfs.pod:2866 ../fish/guestfish.pod:1026 ../test-tool/libguestfs-test-tool.pod:82 ../tools/virt-edit.pl:476
5523 msgid "ENVIRONMENT VARIABLES"
5524 msgstr ""
5525
5526 #. type: =item
5527 #: ../src/guestfs.pod:2870 ../fish/guestfish.pod:1052
5528 msgid "LIBGUESTFS_APPEND"
5529 msgstr ""
5530
5531 #. type: textblock
5532 #: ../src/guestfs.pod:2872 ../fish/guestfish.pod:1054
5533 msgid "Pass additional options to the guest kernel."
5534 msgstr ""
5535
5536 #. type: =item
5537 #: ../src/guestfs.pod:2874 ../fish/guestfish.pod:1056
5538 msgid "LIBGUESTFS_DEBUG"
5539 msgstr ""
5540
5541 #. type: textblock
5542 #: ../src/guestfs.pod:2876
5543 msgid ""
5544 "Set C<LIBGUESTFS_DEBUG=1> to enable verbose messages.  This has the same "
5545 "effect as calling C<guestfs_set_verbose (g, 1)>."
5546 msgstr ""
5547
5548 #. type: =item
5549 #: ../src/guestfs.pod:2879 ../fish/guestfish.pod:1061
5550 msgid "LIBGUESTFS_MEMSIZE"
5551 msgstr ""
5552
5553 #. type: textblock
5554 #: ../src/guestfs.pod:2881 ../fish/guestfish.pod:1063
5555 msgid "Set the memory allocated to the qemu process, in megabytes.  For example:"
5556 msgstr ""
5557
5558 #. type: verbatim
5559 #: ../src/guestfs.pod:2884 ../fish/guestfish.pod:1066
5560 #, no-wrap
5561 msgid ""
5562 " LIBGUESTFS_MEMSIZE=700\n"
5563 "\n"
5564 msgstr ""
5565
5566 #. type: =item
5567 #: ../src/guestfs.pod:2886 ../fish/guestfish.pod:1068
5568 msgid "LIBGUESTFS_PATH"
5569 msgstr ""
5570
5571 #. type: textblock
5572 #: ../src/guestfs.pod:2888
5573 msgid ""
5574 "Set the path that libguestfs uses to search for a supermin appliance.  See "
5575 "the discussion of paths in section L</PATH> above."
5576 msgstr ""
5577
5578 #. type: =item
5579 #: ../src/guestfs.pod:2891 ../fish/guestfish.pod:1073
5580 msgid "LIBGUESTFS_QEMU"
5581 msgstr ""
5582
5583 #. type: textblock
5584 #: ../src/guestfs.pod:2893 ../fish/guestfish.pod:1075
5585 msgid ""
5586 "Set the default qemu binary that libguestfs uses.  If not set, then the qemu "
5587 "which was found at compile time by the configure script is used."
5588 msgstr ""
5589
5590 #. type: textblock
5591 #: ../src/guestfs.pod:2897
5592 msgid "See also L</QEMU WRAPPERS> above."
5593 msgstr ""
5594
5595 #. type: =item
5596 #: ../src/guestfs.pod:2899 ../fish/guestfish.pod:1079
5597 msgid "LIBGUESTFS_TRACE"
5598 msgstr ""
5599
5600 #. type: textblock
5601 #: ../src/guestfs.pod:2901
5602 msgid ""
5603 "Set C<LIBGUESTFS_TRACE=1> to enable command traces.  This has the same "
5604 "effect as calling C<guestfs_set_trace (g, 1)>."
5605 msgstr ""
5606
5607 #. type: =item
5608 #: ../src/guestfs.pod:2904 ../fish/guestfish.pod:1088
5609 msgid "TMPDIR"
5610 msgstr ""
5611
5612 #. type: textblock
5613 #: ../src/guestfs.pod:2906 ../fish/guestfish.pod:1090
5614 msgid ""
5615 "Location of temporary directory, defaults to C</tmp> except for the cached "
5616 "supermin appliance which defaults to C</var/tmp>."
5617 msgstr ""
5618
5619 #. type: textblock
5620 #: ../src/guestfs.pod:2909 ../fish/guestfish.pod:1093
5621 msgid ""
5622 "If libguestfs was compiled to use the supermin appliance then the real "
5623 "appliance is cached in this directory, shared between all handles belonging "
5624 "to the same EUID.  You can use C<$TMPDIR> to configure another directory to "
5625 "use in case C</var/tmp> is not large enough."
5626 msgstr ""
5627
5628 #. type: =head1
5629 #: ../src/guestfs.pod:2917 ../fish/guestfish.pod:1160 ../test-tool/libguestfs-test-tool.pod:87 ../fuse/guestmount.pod:277 ../tools/virt-edit.pl:496 ../tools/virt-win-reg.pl:572 ../tools/virt-list-filesystems.pl:189 ../tools/virt-tar.pl:286 ../tools/virt-make-fs.pl:539 ../tools/virt-list-partitions.pl:257
5630 msgid "SEE ALSO"
5631 msgstr ""
5632
5633 #. type: textblock
5634 #: ../src/guestfs.pod:2919
5635 msgid ""
5636 "L<guestfs-examples(3)>, L<guestfs-ocaml(3)>, L<guestfs-perl(3)>, "
5637 "L<guestfs-python(3)>, L<guestfs-ruby(3)>, L<guestfish(1)>, L<guestmount(1)>, "
5638 "L<virt-cat(1)>, L<virt-copy-in(1)>, L<virt-copy-out(1)>, L<virt-df(1)>, "
5639 "L<virt-edit(1)>, L<virt-filesystems(1)>, L<virt-inspector(1)>, "
5640 "L<virt-list-filesystems(1)>, L<virt-list-partitions(1)>, L<virt-ls(1)>, "
5641 "L<virt-make-fs(1)>, L<virt-rescue(1)>, L<virt-tar(1)>, L<virt-tar-in(1)>, "
5642 "L<virt-tar-out(1)>, L<virt-win-reg(1)>, L<qemu(1)>, L<febootstrap(1)>, "
5643 "L<hivex(3)>, L<http://libguestfs.org/>."
5644 msgstr ""
5645
5646 #. type: textblock
5647 #: ../src/guestfs.pod:2947
5648 msgid ""
5649 "Tools with a similar purpose: L<fdisk(8)>, L<parted(8)>, L<kpartx(8)>, "
5650 "L<lvm(8)>, L<disktype(1)>."
5651 msgstr ""
5652
5653 #. type: =head1
5654 #: ../src/guestfs.pod:2954 ../tools/virt-win-reg.pl:587 ../tools/virt-make-fs.pl:553
5655 msgid "BUGS"
5656 msgstr ""
5657
5658 #. type: textblock
5659 #: ../src/guestfs.pod:2956
5660 msgid "To get a list of bugs against libguestfs use this link:"
5661 msgstr ""
5662
5663 #. type: textblock
5664 #: ../src/guestfs.pod:2958
5665 msgid "L<https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools>"
5666 msgstr ""
5667
5668 #. type: textblock
5669 #: ../src/guestfs.pod:2960
5670 msgid "To report a new bug against libguestfs use this link:"
5671 msgstr ""
5672
5673 #. type: textblock
5674 #: ../src/guestfs.pod:2962
5675 msgid "L<https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools>"
5676 msgstr ""
5677
5678 #. type: textblock
5679 #: ../src/guestfs.pod:2964
5680 msgid "When reporting a bug, please check:"
5681 msgstr ""
5682
5683 #. type: textblock
5684 #: ../src/guestfs.pod:2970
5685 msgid "That the bug hasn't been reported already."
5686 msgstr ""
5687
5688 #. type: textblock
5689 #: ../src/guestfs.pod:2974
5690 msgid "That you are testing a recent version."
5691 msgstr ""
5692
5693 #. type: textblock
5694 #: ../src/guestfs.pod:2978
5695 msgid "Describe the bug accurately, and give a way to reproduce it."
5696 msgstr ""
5697
5698 #. type: textblock
5699 #: ../src/guestfs.pod:2982
5700 msgid ""
5701 "Run libguestfs-test-tool and paste the B<complete, unedited> output into the "
5702 "bug report."
5703 msgstr ""
5704
5705 #. type: =head1
5706 #: ../src/guestfs.pod:2987 ../fish/guestfish.pod:1183 ../test-tool/libguestfs-test-tool.pod:93 ../fuse/guestmount.pod:288
5707 msgid "AUTHORS"
5708 msgstr ""
5709
5710 #. type: textblock
5711 #: ../src/guestfs.pod:2989 ../fish/guestfish.pod:1185 ../test-tool/libguestfs-test-tool.pod:95 ../fuse/guestmount.pod:290
5712 msgid "Richard W.M. Jones (C<rjones at redhat dot com>)"
5713 msgstr ""
5714
5715 #. type: =head1
5716 #: ../src/guestfs.pod:2991 ../fish/guestfish.pod:1187 ../test-tool/libguestfs-test-tool.pod:97 ../fuse/guestmount.pod:292 ../tools/virt-edit.pl:514 ../tools/virt-win-reg.pl:602 ../tools/virt-list-filesystems.pl:206 ../tools/virt-tar.pl:305 ../tools/virt-make-fs.pl:568 ../tools/virt-list-partitions.pl:273
5717 msgid "COPYRIGHT"
5718 msgstr ""
5719
5720 #. type: textblock
5721 #: ../src/guestfs.pod:2993 ../fish/guestfish.pod:1189 ../test-tool/libguestfs-test-tool.pod:99
5722 msgid "Copyright (C) 2009-2011 Red Hat Inc.  L<http://libguestfs.org/>"
5723 msgstr ""
5724
5725 #. type: textblock
5726 #: ../src/guestfs.pod:2996
5727 msgid ""
5728 "This library is free software; you can redistribute it and/or modify it "
5729 "under the terms of the GNU Lesser General Public License as published by the "
5730 "Free Software Foundation; either version 2 of the License, or (at your "
5731 "option) any later version."
5732 msgstr ""
5733
5734 #. type: textblock
5735 #: ../src/guestfs.pod:3001
5736 msgid ""
5737 "This library is distributed in the hope that it will be useful, but WITHOUT "
5738 "ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or "
5739 "FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public License "
5740 "for more details."
5741 msgstr ""
5742
5743 #. type: textblock
5744 #: ../src/guestfs.pod:3006
5745 msgid ""
5746 "You should have received a copy of the GNU Lesser General Public License "
5747 "along with this library; if not, write to the Free Software Foundation, "
5748 "Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA"
5749 msgstr ""
5750
5751 #. type: =head2
5752 #: ../src/guestfs-actions.pod:1
5753 msgid "guestfs_add_cdrom"
5754 msgstr ""
5755
5756 #. type: verbatim
5757 #: ../src/guestfs-actions.pod:3
5758 #, no-wrap
5759 msgid ""
5760 " int\n"
5761 " guestfs_add_cdrom (guestfs_h *g,\n"
5762 "                    const char *filename);\n"
5763 "\n"
5764 msgstr ""
5765
5766 #. type: textblock
5767 #: ../src/guestfs-actions.pod:7 ../fish/guestfish-actions.pod:5
5768 msgid "This function adds a virtual CD-ROM disk image to the guest."
5769 msgstr ""
5770
5771 #. type: textblock
5772 #: ../src/guestfs-actions.pod:9 ../fish/guestfish-actions.pod:7
5773 msgid "This is equivalent to the qemu parameter I<-cdrom filename>."
5774 msgstr ""
5775
5776 #. type: textblock
5777 #: ../src/guestfs-actions.pod:17
5778 msgid ""
5779 "This call checks for the existence of C<filename>.  This stops you from "
5780 "specifying other types of drive which are supported by qemu such as C<nbd:> "
5781 "and C<http:> URLs.  To specify those, use the general C<guestfs_config> call "
5782 "instead."
5783 msgstr ""
5784
5785 #. type: textblock
5786 #: ../src/guestfs-actions.pod:24
5787 msgid ""
5788 "If you just want to add an ISO file (often you use this as an efficient way "
5789 "to transfer large files into the guest), then you should probably use "
5790 "C<guestfs_add_drive_ro> instead."
5791 msgstr ""
5792
5793 #. type: textblock
5794 #: ../src/guestfs-actions.pod:30 ../src/guestfs-actions.pod:134 ../src/guestfs-actions.pod:195 ../src/guestfs-actions.pod:232 ../src/guestfs-actions.pod:246 ../src/guestfs-actions.pod:267 ../src/guestfs-actions.pod:287 ../src/guestfs-actions.pod:301 ../src/guestfs-actions.pod:421 ../src/guestfs-actions.pod:441 ../src/guestfs-actions.pod:455 ../src/guestfs-actions.pod:500 ../src/guestfs-actions.pod:528 ../src/guestfs-actions.pod:546 ../src/guestfs-actions.pod:613 ../src/guestfs-actions.pod:646 ../src/guestfs-actions.pod:660 ../src/guestfs-actions.pod:675 ../src/guestfs-actions.pod:774 ../src/guestfs-actions.pod:792 ../src/guestfs-actions.pod:806 ../src/guestfs-actions.pod:820 ../src/guestfs-actions.pod:981 ../src/guestfs-actions.pod:1001 ../src/guestfs-actions.pod:1019 ../src/guestfs-actions.pod:1103 ../src/guestfs-actions.pod:1121 ../src/guestfs-actions.pod:1140 ../src/guestfs-actions.pod:1154 ../src/guestfs-actions.pod:1174 ../src/guestfs-actions.pod:1244 ../src/guestfs-actions.pod:1275 ../src/guestfs-actions.pod:1300 ../src/guestfs-actions.pod:1342 ../src/guestfs-actions.pod:1448 ../src/guestfs-actions.pod:1482 ../src/guestfs-actions.pod:1697 ../src/guestfs-actions.pod:1719 ../src/guestfs-actions.pod:1806 ../src/guestfs-actions.pod:2268 ../src/guestfs-actions.pod:2412 ../src/guestfs-actions.pod:2473 ../src/guestfs-actions.pod:2508 ../src/guestfs-actions.pod:3461 ../src/guestfs-actions.pod:3476 ../src/guestfs-actions.pod:3501 ../src/guestfs-actions.pod:3656 ../src/guestfs-actions.pod:3670 ../src/guestfs-actions.pod:3683 ../src/guestfs-actions.pod:3697 ../src/guestfs-actions.pod:3712 ../src/guestfs-actions.pod:3748 ../src/guestfs-actions.pod:3820 ../src/guestfs-actions.pod:3840 ../src/guestfs-actions.pod:3857 ../src/guestfs-actions.pod:3880 ../src/guestfs-actions.pod:3903 ../src/guestfs-actions.pod:3935 ../src/guestfs-actions.pod:3954 ../src/guestfs-actions.pod:3973 ../src/guestfs-actions.pod:4008 ../src/guestfs-actions.pod:4020 ../src/guestfs-actions.pod:4056 ../src/guestfs-actions.pod:4072 ../src/guestfs-actions.pod:4085 ../src/guestfs-actions.pod:4100 ../src/guestfs-actions.pod:4117 ../src/guestfs-actions.pod:4210 ../src/guestfs-actions.pod:4230 ../src/guestfs-actions.pod:4243 ../src/guestfs-actions.pod:4294 ../src/guestfs-actions.pod:4312 ../src/guestfs-actions.pod:4330 ../src/guestfs-actions.pod:4346 ../src/guestfs-actions.pod:4360 ../src/guestfs-actions.pod:4374 ../src/guestfs-actions.pod:4391 ../src/guestfs-actions.pod:4406 ../src/guestfs-actions.pod:4426 ../src/guestfs-actions.pod:4484 ../src/guestfs-actions.pod:4557 ../src/guestfs-actions.pod:4588 ../src/guestfs-actions.pod:4607 ../src/guestfs-actions.pod:4626 ../src/guestfs-actions.pod:4638 ../src/guestfs-actions.pod:4655 ../src/guestfs-actions.pod:4668 ../src/guestfs-actions.pod:4683 ../src/guestfs-actions.pod:4698 ../src/guestfs-actions.pod:4733 ../src/guestfs-actions.pod:4755 ../src/guestfs-actions.pod:4775 ../src/guestfs-actions.pod:4789 ../src/guestfs-actions.pod:4806 ../src/guestfs-actions.pod:4855 ../src/guestfs-actions.pod:4901 ../src/guestfs-actions.pod:4915 ../src/guestfs-actions.pod:4943 ../src/guestfs-actions.pod:4960 ../src/guestfs-actions.pod:4978 ../src/guestfs-actions.pod:5112 ../src/guestfs-actions.pod:5169 ../src/guestfs-actions.pod:5191 ../src/guestfs-actions.pod:5209 ../src/guestfs-actions.pod:5241 ../src/guestfs-actions.pod:5307 ../src/guestfs-actions.pod:5324 ../src/guestfs-actions.pod:5337 ../src/guestfs-actions.pod:5351 ../src/guestfs-actions.pod:5640 ../src/guestfs-actions.pod:5659 ../src/guestfs-actions.pod:5678 ../src/guestfs-actions.pod:5690 ../src/guestfs-actions.pod:5702 ../src/guestfs-actions.pod:5716 ../src/guestfs-actions.pod:5728 ../src/guestfs-actions.pod:5742 ../src/guestfs-actions.pod:5758 ../src/guestfs-actions.pod:5779 ../src/guestfs-actions.pod:5798 ../src/guestfs-actions.pod:5817 ../src/guestfs-actions.pod:5847 ../src/guestfs-actions.pod:5863 ../src/guestfs-actions.pod:5886 ../src/guestfs-actions.pod:5904 ../src/guestfs-actions.pod:5923 ../src/guestfs-actions.pod:5944 ../src/guestfs-actions.pod:5963 ../src/guestfs-actions.pod:5980 ../src/guestfs-actions.pod:6008 ../src/guestfs-actions.pod:6032 ../src/guestfs-actions.pod:6051 ../src/guestfs-actions.pod:6075 ../src/guestfs-actions.pod:6094 ../src/guestfs-actions.pod:6109 ../src/guestfs-actions.pod:6128 ../src/guestfs-actions.pod:6165 ../src/guestfs-actions.pod:6195 ../src/guestfs-actions.pod:6228 ../src/guestfs-actions.pod:6350 ../src/guestfs-actions.pod:6471 ../src/guestfs-actions.pod:6483 ../src/guestfs-actions.pod:6496 ../src/guestfs-actions.pod:6509 ../src/guestfs-actions.pod:6531 ../src/guestfs-actions.pod:6544 ../src/guestfs-actions.pod:6557 ../src/guestfs-actions.pod:6570 ../src/guestfs-actions.pod:6585 ../src/guestfs-actions.pod:6644 ../src/guestfs-actions.pod:6661 ../src/guestfs-actions.pod:6677 ../src/guestfs-actions.pod:6693 ../src/guestfs-actions.pod:6710 ../src/guestfs-actions.pod:6723 ../src/guestfs-actions.pod:6743 ../src/guestfs-actions.pod:6779 ../src/guestfs-actions.pod:6793 ../src/guestfs-actions.pod:6834 ../src/guestfs-actions.pod:6847 ../src/guestfs-actions.pod:6865 ../src/guestfs-actions.pod:6899 ../src/guestfs-actions.pod:6935 ../src/guestfs-actions.pod:7054 ../src/guestfs-actions.pod:7072 ../src/guestfs-actions.pod:7086 ../src/guestfs-actions.pod:7141 ../src/guestfs-actions.pod:7154 ../src/guestfs-actions.pod:7199 ../src/guestfs-actions.pod:7232 ../src/guestfs-actions.pod:7293 ../src/guestfs-actions.pod:7319 ../src/guestfs-actions.pod:7385 ../src/guestfs-actions.pod:7404 ../src/guestfs-actions.pod:7433
5795 msgid "This function returns 0 on success or -1 on error."
5796 msgstr ""
5797
5798 #. type: textblock
5799 #: ../src/guestfs-actions.pod:32 ../src/guestfs-actions.pod:248 ../src/guestfs-actions.pod:269
5800 msgid ""
5801 "This function is deprecated.  In new code, use the "
5802 "L</guestfs_add_drive_opts> call instead."
5803 msgstr ""
5804
5805 #. type: textblock
5806 #: ../src/guestfs-actions.pod:35 ../src/guestfs-actions.pod:251 ../src/guestfs-actions.pod:272 ../src/guestfs-actions.pod:1453 ../src/guestfs-actions.pod:1946 ../src/guestfs-actions.pod:1967 ../src/guestfs-actions.pod:4431 ../src/guestfs-actions.pod:4738 ../src/guestfs-actions.pod:6173 ../src/guestfs-actions.pod:6203 ../src/guestfs-actions.pod:6236 ../src/guestfs-actions.pod:6295 ../src/guestfs-actions.pod:7237 ../src/guestfs-actions.pod:7327 ../src/guestfs-actions.pod:7496 ../fish/guestfish-actions.pod:31 ../fish/guestfish-actions.pod:161 ../fish/guestfish-actions.pod:175 ../fish/guestfish-actions.pod:961 ../fish/guestfish-actions.pod:1321 ../fish/guestfish-actions.pod:1335 ../fish/guestfish-actions.pod:3010 ../fish/guestfish-actions.pod:3207 ../fish/guestfish-actions.pod:4188 ../fish/guestfish-actions.pod:4211 ../fish/guestfish-actions.pod:4233 ../fish/guestfish-actions.pod:4271 ../fish/guestfish-actions.pod:4912 ../fish/guestfish-actions.pod:5009
5807 msgid ""
5808 "Deprecated functions will not be removed from the API, but the fact that "
5809 "they are deprecated indicates that there are problems with correct use of "
5810 "these functions."
5811 msgstr ""
5812
5813 #. type: textblock
5814 #: ../src/guestfs-actions.pod:39 ../src/guestfs-actions.pod:136 ../src/guestfs-actions.pod:1105 ../src/guestfs-actions.pod:1918 ../src/guestfs-actions.pod:2016 ../src/guestfs-actions.pod:2119 ../src/guestfs-actions.pod:3463 ../src/guestfs-actions.pod:3483 ../src/guestfs-actions.pod:4742 ../src/guestfs-actions.pod:5865 ../src/guestfs-actions.pod:5982 ../src/guestfs-actions.pod:6096 ../src/guestfs-actions.pod:6587 ../src/guestfs-actions.pod:6712 ../src/guestfs-actions.pod:7241
5815 msgid "(Added in 0.3)"
5816 msgstr ""
5817
5818 #. type: =head2
5819 #: ../src/guestfs-actions.pod:41
5820 msgid "guestfs_add_domain"
5821 msgstr ""
5822
5823 #. type: verbatim
5824 #: ../src/guestfs-actions.pod:43
5825 #, no-wrap
5826 msgid ""
5827 " int\n"
5828 " guestfs_add_domain (guestfs_h *g,\n"
5829 "                     const char *dom,\n"
5830 "                     ...);\n"
5831 "\n"
5832 msgstr ""
5833
5834 #. type: textblock
5835 #: ../src/guestfs-actions.pod:48 ../src/guestfs-actions.pod:145 ../src/guestfs-actions.pod:4445
5836 msgid ""
5837 "You may supply a list of optional arguments to this call.  Use zero or more "
5838 "of the following pairs of parameters, and terminate the list with C<-1> on "
5839 "its own.  See L</CALLS WITH OPTIONAL ARGUMENTS>."
5840 msgstr ""
5841
5842 #. type: verbatim
5843 #: ../src/guestfs-actions.pod:53
5844 #, no-wrap
5845 msgid ""
5846 " GUESTFS_ADD_DOMAIN_LIBVIRTURI, const char *libvirturi,\n"
5847 " GUESTFS_ADD_DOMAIN_READONLY, int readonly,\n"
5848 " GUESTFS_ADD_DOMAIN_IFACE, const char *iface,\n"
5849 " GUESTFS_ADD_DOMAIN_LIVE, int live,\n"
5850 "\n"
5851 msgstr ""
5852
5853 #. type: textblock
5854 #: ../src/guestfs-actions.pod:58
5855 msgid ""
5856 "This function adds the disk(s) attached to the named libvirt domain C<dom>.  "
5857 "It works by connecting to libvirt, requesting the domain and domain XML from "
5858 "libvirt, parsing it for disks, and calling C<guestfs_add_drive_opts> on each "
5859 "one."
5860 msgstr ""
5861
5862 #. type: textblock
5863 #: ../src/guestfs-actions.pod:63 ../fish/guestfish-actions.pod:46
5864 msgid ""
5865 "The number of disks added is returned.  This operation is atomic: if an "
5866 "error is returned, then no disks are added."
5867 msgstr ""
5868
5869 #. type: textblock
5870 #: ../src/guestfs-actions.pod:66 ../fish/guestfish-actions.pod:49
5871 msgid ""
5872 "This function does some minimal checks to make sure the libvirt domain is "
5873 "not running (unless C<readonly> is true).  In a future version we will try "
5874 "to acquire the libvirt lock on each disk."
5875 msgstr ""
5876
5877 #. type: textblock
5878 #: ../src/guestfs-actions.pod:70 ../fish/guestfish-actions.pod:53
5879 msgid ""
5880 "Disks must be accessible locally.  This often means that adding disks from a "
5881 "remote libvirt connection (see L<http://libvirt.org/remote.html>)  will fail "
5882 "unless those disks are accessible via the same device path locally too."
5883 msgstr ""
5884
5885 #. type: textblock
5886 #: ../src/guestfs-actions.pod:75 ../fish/guestfish-actions.pod:58
5887 msgid ""
5888 "The optional C<libvirturi> parameter sets the libvirt URI (see "
5889 "L<http://libvirt.org/uri.html>).  If this is not set then we connect to the "
5890 "default libvirt URI (or one set through an environment variable, see the "
5891 "libvirt documentation for full details)."
5892 msgstr ""
5893
5894 #. type: textblock
5895 #: ../src/guestfs-actions.pod:81 ../fish/guestfish-actions.pod:64
5896 msgid ""
5897 "The optional C<live> flag controls whether this call will try to connect to "
5898 "a running virtual machine C<guestfsd> process if it sees a suitable "
5899 "E<lt>channelE<gt> element in the libvirt XML definition.  The default (if "
5900 "the flag is omitted) is never to try.  See L<guestfs(3)/ATTACHING TO RUNNING "
5901 "DAEMONS> for more information."
5902 msgstr ""
5903
5904 #. type: textblock
5905 #: ../src/guestfs-actions.pod:88
5906 msgid ""
5907 "The other optional parameters are passed directly through to "
5908 "C<guestfs_add_drive_opts>."
5909 msgstr ""
5910
5911 #. type: textblock
5912 #: ../src/guestfs-actions.pod:91 ../src/guestfs-actions.pod:344 ../src/guestfs-actions.pod:514 ../src/guestfs-actions.pod:692 ../src/guestfs-actions.pod:723 ../src/guestfs-actions.pod:741 ../src/guestfs-actions.pod:760 ../src/guestfs-actions.pod:1320 ../src/guestfs-actions.pod:1676 ../src/guestfs-actions.pod:1879 ../src/guestfs-actions.pod:1988 ../src/guestfs-actions.pod:2028 ../src/guestfs-actions.pod:2083 ../src/guestfs-actions.pod:2106 ../src/guestfs-actions.pod:2399 ../src/guestfs-actions.pod:2782 ../src/guestfs-actions.pod:2803 ../src/guestfs-actions.pod:4878 ../src/guestfs-actions.pod:5015 ../src/guestfs-actions.pod:5421 ../src/guestfs-actions.pod:5447 ../src/guestfs-actions.pod:6820 ../src/guestfs-actions.pod:7252 ../src/guestfs-actions.pod:7265 ../src/guestfs-actions.pod:7278
5913 msgid "On error this function returns -1."
5914 msgstr ""
5915
5916 #. type: textblock
5917 #: ../src/guestfs-actions.pod:93
5918 msgid "(Added in 1.7.4)"
5919 msgstr ""
5920
5921 #. type: =head2
5922 #: ../src/guestfs-actions.pod:95
5923 msgid "guestfs_add_domain_va"
5924 msgstr ""
5925
5926 #. type: verbatim
5927 #: ../src/guestfs-actions.pod:97
5928 #, no-wrap
5929 msgid ""
5930 " int\n"
5931 " guestfs_add_domain_va (guestfs_h *g,\n"
5932 "                        const char *dom,\n"
5933 "                        va_list args);\n"
5934 "\n"
5935 msgstr ""
5936
5937 #. type: textblock
5938 #: ../src/guestfs-actions.pod:102
5939 msgid "This is the \"va_list variant\" of L</guestfs_add_domain>."
5940 msgstr ""
5941
5942 #. type: textblock
5943 #: ../src/guestfs-actions.pod:104 ../src/guestfs-actions.pod:115 ../src/guestfs-actions.pod:208 ../src/guestfs-actions.pod:219 ../src/guestfs-actions.pod:4498 ../src/guestfs-actions.pod:4510
5944 msgid "See L</CALLS WITH OPTIONAL ARGUMENTS>."
5945 msgstr ""
5946
5947 #. type: =head2
5948 #: ../src/guestfs-actions.pod:106
5949 msgid "guestfs_add_domain_argv"
5950 msgstr ""
5951
5952 #. type: verbatim
5953 #: ../src/guestfs-actions.pod:108
5954 #, no-wrap
5955 msgid ""
5956 " int\n"
5957 " guestfs_add_domain_argv (guestfs_h *g,\n"
5958 "                          const char *dom,\n"
5959 "                          const struct guestfs_add_domain_argv *optargs);\n"
5960 "\n"
5961 msgstr ""
5962
5963 #. type: textblock
5964 #: ../src/guestfs-actions.pod:113
5965 msgid "This is the \"argv variant\" of L</guestfs_add_domain>."
5966 msgstr ""
5967
5968 #. type: =head2
5969 #: ../src/guestfs-actions.pod:117
5970 msgid "guestfs_add_drive"
5971 msgstr ""
5972
5973 #. type: verbatim
5974 #: ../src/guestfs-actions.pod:119
5975 #, no-wrap
5976 msgid ""
5977 " int\n"
5978 " guestfs_add_drive (guestfs_h *g,\n"
5979 "                    const char *filename);\n"
5980 "\n"
5981 msgstr ""
5982
5983 #. type: textblock
5984 #: ../src/guestfs-actions.pod:123
5985 msgid ""
5986 "This function is the equivalent of calling C<guestfs_add_drive_opts> with no "
5987 "optional parameters, so the disk is added writable, with the format being "
5988 "detected automatically."
5989 msgstr ""
5990
5991 #. type: textblock
5992 #: ../src/guestfs-actions.pod:127
5993 msgid ""
5994 "Automatic detection of the format opens you up to a potential security hole "
5995 "when dealing with untrusted raw-format images.  See CVE-2010-3851 and "
5996 "RHBZ#642934.  Specifying the format closes this security hole.  Therefore "
5997 "you should think about replacing calls to this function with calls to "
5998 "C<guestfs_add_drive_opts>, and specifying the format."
5999 msgstr ""
6000
6001 #. type: =head2
6002 #: ../src/guestfs-actions.pod:138
6003 msgid "guestfs_add_drive_opts"
6004 msgstr ""
6005
6006 #. type: verbatim
6007 #: ../src/guestfs-actions.pod:140
6008 #, no-wrap
6009 msgid ""
6010 " int\n"
6011 " guestfs_add_drive_opts (guestfs_h *g,\n"
6012 "                         const char *filename,\n"
6013 "                         ...);\n"
6014 "\n"
6015 msgstr ""
6016
6017 #. type: verbatim
6018 #: ../src/guestfs-actions.pod:150
6019 #, no-wrap
6020 msgid ""
6021 " GUESTFS_ADD_DRIVE_OPTS_READONLY, int readonly,\n"
6022 " GUESTFS_ADD_DRIVE_OPTS_FORMAT, const char *format,\n"
6023 " GUESTFS_ADD_DRIVE_OPTS_IFACE, const char *iface,\n"
6024 "\n"
6025 msgstr ""
6026
6027 #. type: textblock
6028 #: ../src/guestfs-actions.pod:154 ../fish/guestfish-actions.pod:97
6029 msgid ""
6030 "This function adds a virtual machine disk image C<filename> to libguestfs.  "
6031 "The first time you call this function, the disk appears as C</dev/sda>, the "
6032 "second time as C</dev/sdb>, and so on."
6033 msgstr ""
6034
6035 #. type: textblock
6036 #: ../src/guestfs-actions.pod:159 ../fish/guestfish-actions.pod:102
6037 msgid ""
6038 "You don't necessarily need to be root when using libguestfs.  However you "
6039 "obviously do need sufficient permissions to access the filename for whatever "
6040 "operations you want to perform (ie. read access if you just want to read the "
6041 "image or write access if you want to modify the image)."
6042 msgstr ""
6043
6044 #. type: textblock
6045 #: ../src/guestfs-actions.pod:165 ../fish/guestfish-actions.pod:108
6046 msgid "This call checks that C<filename> exists."
6047 msgstr ""
6048
6049 #. type: textblock
6050 #: ../src/guestfs-actions.pod:167 ../src/guestfs-actions.pod:4456 ../fish/guestfish-actions.pod:110 ../fish/guestfish-actions.pod:3021
6051 msgid "The optional arguments are:"
6052 msgstr ""
6053
6054 #. type: =item
6055 #: ../src/guestfs-actions.pod:171 ../fish/guestfish-actions.pod:114
6056 msgid "C<readonly>"
6057 msgstr ""
6058
6059 #. type: textblock
6060 #: ../src/guestfs-actions.pod:173 ../fish/guestfish-actions.pod:116
6061 msgid ""
6062 "If true then the image is treated as read-only.  Writes are still allowed, "
6063 "but they are stored in a temporary snapshot overlay which is discarded at "
6064 "the end.  The disk that you add is not modified."
6065 msgstr ""
6066
6067 #. type: =item
6068 #: ../src/guestfs-actions.pod:177 ../fish/guestfish-actions.pod:120
6069 msgid "C<format>"
6070 msgstr ""
6071
6072 #. type: textblock
6073 #: ../src/guestfs-actions.pod:179
6074 msgid ""
6075 "This forces the image format.  If you omit this (or use C<guestfs_add_drive> "
6076 "or C<guestfs_add_drive_ro>) then the format is automatically detected.  "
6077 "Possible formats include C<raw> and C<qcow2>."
6078 msgstr ""
6079
6080 #. type: textblock
6081 #: ../src/guestfs-actions.pod:183 ../fish/guestfish-actions.pod:126
6082 msgid ""
6083 "Automatic detection of the format opens you up to a potential security hole "
6084 "when dealing with untrusted raw-format images.  See CVE-2010-3851 and "
6085 "RHBZ#642934.  Specifying the format closes this security hole."
6086 msgstr ""
6087
6088 #. type: =item
6089 #: ../src/guestfs-actions.pod:188 ../fish/guestfish-actions.pod:131
6090 msgid "C<iface>"
6091 msgstr ""
6092
6093 #. type: textblock
6094 #: ../src/guestfs-actions.pod:190
6095 msgid ""
6096 "This rarely-used option lets you emulate the behaviour of the deprecated "
6097 "C<guestfs_add_drive_with_if> call (q.v.)"
6098 msgstr ""
6099
6100 #. type: textblock
6101 #: ../src/guestfs-actions.pod:197
6102 msgid "(Added in 1.5.23)"
6103 msgstr ""
6104
6105 #. type: =head2
6106 #: ../src/guestfs-actions.pod:199
6107 msgid "guestfs_add_drive_opts_va"
6108 msgstr ""
6109
6110 #. type: verbatim
6111 #: ../src/guestfs-actions.pod:201
6112 #, no-wrap
6113 msgid ""
6114 " int\n"
6115 " guestfs_add_drive_opts_va (guestfs_h *g,\n"
6116 "                            const char *filename,\n"
6117 "                            va_list args);\n"
6118 "\n"
6119 msgstr ""
6120
6121 #. type: textblock
6122 #: ../src/guestfs-actions.pod:206
6123 msgid "This is the \"va_list variant\" of L</guestfs_add_drive_opts>."
6124 msgstr ""
6125
6126 #. type: =head2
6127 #: ../src/guestfs-actions.pod:210
6128 msgid "guestfs_add_drive_opts_argv"
6129 msgstr ""
6130
6131 #. type: verbatim
6132 #: ../src/guestfs-actions.pod:212
6133 #, no-wrap
6134 msgid ""
6135 " int\n"
6136 " guestfs_add_drive_opts_argv (guestfs_h *g,\n"
6137 "                              const char *filename,\n"
6138 "                              const struct guestfs_add_drive_opts_argv "
6139 "*optargs);\n"
6140 "\n"
6141 msgstr ""
6142
6143 #. type: textblock
6144 #: ../src/guestfs-actions.pod:217
6145 msgid "This is the \"argv variant\" of L</guestfs_add_drive_opts>."
6146 msgstr ""
6147
6148 #. type: =head2
6149 #: ../src/guestfs-actions.pod:221
6150 msgid "guestfs_add_drive_ro"
6151 msgstr ""
6152
6153 #. type: verbatim
6154 #: ../src/guestfs-actions.pod:223
6155 #, no-wrap
6156 msgid ""
6157 " int\n"
6158 " guestfs_add_drive_ro (guestfs_h *g,\n"
6159 "                       const char *filename);\n"
6160 "\n"
6161 msgstr ""
6162
6163 #. type: textblock
6164 #: ../src/guestfs-actions.pod:227
6165 msgid ""
6166 "This function is the equivalent of calling C<guestfs_add_drive_opts> with "
6167 "the optional parameter C<GUESTFS_ADD_DRIVE_OPTS_READONLY> set to 1, so the "
6168 "disk is added read-only, with the format being detected automatically."
6169 msgstr ""
6170
6171 #. type: textblock
6172 #: ../src/guestfs-actions.pod:234
6173 msgid "(Added in 1.0.38)"
6174 msgstr ""
6175
6176 #. type: =head2
6177 #: ../src/guestfs-actions.pod:236
6178 msgid "guestfs_add_drive_ro_with_if"
6179 msgstr ""
6180
6181 #. type: verbatim
6182 #: ../src/guestfs-actions.pod:238
6183 #, no-wrap
6184 msgid ""
6185 " int\n"
6186 " guestfs_add_drive_ro_with_if (guestfs_h *g,\n"
6187 "                               const char *filename,\n"
6188 "                               const char *iface);\n"
6189 "\n"
6190 msgstr ""
6191
6192 #. type: textblock
6193 #: ../src/guestfs-actions.pod:243
6194 msgid ""
6195 "This is the same as C<guestfs_add_drive_ro> but it allows you to specify the "
6196 "QEMU interface emulation to use at run time."
6197 msgstr ""
6198
6199 #. type: textblock
6200 #: ../src/guestfs-actions.pod:255 ../src/guestfs-actions.pod:276 ../src/guestfs-actions.pod:2358
6201 msgid "(Added in 1.0.84)"
6202 msgstr ""
6203
6204 #. type: =head2
6205 #: ../src/guestfs-actions.pod:257
6206 msgid "guestfs_add_drive_with_if"
6207 msgstr ""
6208
6209 #. type: verbatim
6210 #: ../src/guestfs-actions.pod:259
6211 #, no-wrap
6212 msgid ""
6213 " int\n"
6214 " guestfs_add_drive_with_if (guestfs_h *g,\n"
6215 "                            const char *filename,\n"
6216 "                            const char *iface);\n"
6217 "\n"
6218 msgstr ""
6219
6220 #. type: textblock
6221 #: ../src/guestfs-actions.pod:264
6222 msgid ""
6223 "This is the same as C<guestfs_add_drive> but it allows you to specify the "
6224 "QEMU interface emulation to use at run time."
6225 msgstr ""
6226
6227 #. type: =head2
6228 #: ../src/guestfs-actions.pod:278
6229 msgid "guestfs_aug_clear"
6230 msgstr ""
6231
6232 #. type: verbatim
6233 #: ../src/guestfs-actions.pod:280
6234 #, no-wrap
6235 msgid ""
6236 " int\n"
6237 " guestfs_aug_clear (guestfs_h *g,\n"
6238 "                    const char *augpath);\n"
6239 "\n"
6240 msgstr ""
6241
6242 #. type: textblock
6243 #: ../src/guestfs-actions.pod:284 ../fish/guestfish-actions.pod:183
6244 msgid ""
6245 "Set the value associated with C<path> to C<NULL>.  This is the same as the "
6246 "L<augtool(1)> C<clear> command."
6247 msgstr ""
6248
6249 #. type: textblock
6250 #: ../src/guestfs-actions.pod:289 ../src/guestfs-actions.pod:2108
6251 msgid "(Added in 1.3.4)"
6252 msgstr ""
6253
6254 #. type: =head2
6255 #: ../src/guestfs-actions.pod:291
6256 msgid "guestfs_aug_close"
6257 msgstr ""
6258
6259 #. type: verbatim
6260 #: ../src/guestfs-actions.pod:293
6261 #, no-wrap
6262 msgid ""
6263 " int\n"
6264 " guestfs_aug_close (guestfs_h *g);\n"
6265 "\n"
6266 msgstr ""
6267
6268 #. type: textblock
6269 #: ../src/guestfs-actions.pod:296
6270 msgid ""
6271 "Close the current Augeas handle and free up any resources used by it.  After "
6272 "calling this, you have to call C<guestfs_aug_init> again before you can use "
6273 "any other Augeas functions."
6274 msgstr ""
6275
6276 #. type: textblock
6277 #: ../src/guestfs-actions.pod:303 ../src/guestfs-actions.pod:328 ../src/guestfs-actions.pod:346 ../src/guestfs-actions.pod:360 ../src/guestfs-actions.pod:423 ../src/guestfs-actions.pod:443 ../src/guestfs-actions.pod:457 ../src/guestfs-actions.pod:488 ../src/guestfs-actions.pod:502 ../src/guestfs-actions.pod:516 ../src/guestfs-actions.pod:530 ../src/guestfs-actions.pod:548 ../src/guestfs-actions.pod:5498
6278 msgid "(Added in 0.7)"
6279 msgstr ""
6280
6281 #. type: =head2
6282 #: ../src/guestfs-actions.pod:305
6283 msgid "guestfs_aug_defnode"
6284 msgstr ""
6285
6286 #. type: verbatim
6287 #: ../src/guestfs-actions.pod:307
6288 #, no-wrap
6289 msgid ""
6290 " struct guestfs_int_bool *\n"
6291 " guestfs_aug_defnode (guestfs_h *g,\n"
6292 "                      const char *name,\n"
6293 "                      const char *expr,\n"
6294 "                      const char *val);\n"
6295 "\n"
6296 msgstr ""
6297
6298 #. type: textblock
6299 #: ../src/guestfs-actions.pod:313 ../fish/guestfish-actions.pod:199
6300 msgid "Defines a variable C<name> whose value is the result of evaluating C<expr>."
6301 msgstr ""
6302
6303 #. type: textblock
6304 #: ../src/guestfs-actions.pod:316
6305 msgid ""
6306 "If C<expr> evaluates to an empty nodeset, a node is created, equivalent to "
6307 "calling C<guestfs_aug_set> C<expr>, C<value>.  C<name> will be the nodeset "
6308 "containing that single node."
6309 msgstr ""
6310
6311 #. type: textblock
6312 #: ../src/guestfs-actions.pod:320 ../fish/guestfish-actions.pod:206
6313 msgid ""
6314 "On success this returns a pair containing the number of nodes in the "
6315 "nodeset, and a boolean flag if a node was created."
6316 msgstr ""
6317
6318 #. type: textblock
6319 #: ../src/guestfs-actions.pod:324
6320 msgid ""
6321 "This function returns a C<struct guestfs_int_bool *>, or NULL if there was "
6322 "an error.  I<The caller must call C<guestfs_free_int_bool> after use>."
6323 msgstr ""
6324
6325 #. type: =head2
6326 #: ../src/guestfs-actions.pod:330
6327 msgid "guestfs_aug_defvar"
6328 msgstr ""
6329
6330 #. type: verbatim
6331 #: ../src/guestfs-actions.pod:332
6332 #, no-wrap
6333 msgid ""
6334 " int\n"
6335 " guestfs_aug_defvar (guestfs_h *g,\n"
6336 "                     const char *name,\n"
6337 "                     const char *expr);\n"
6338 "\n"
6339 msgstr ""
6340
6341 #. type: textblock
6342 #: ../src/guestfs-actions.pod:337 ../fish/guestfish-actions.pod:214
6343 msgid ""
6344 "Defines an Augeas variable C<name> whose value is the result of evaluating "
6345 "C<expr>.  If C<expr> is NULL, then C<name> is undefined."
6346 msgstr ""
6347
6348 #. type: textblock
6349 #: ../src/guestfs-actions.pod:341 ../fish/guestfish-actions.pod:218
6350 msgid ""
6351 "On success this returns the number of nodes in C<expr>, or C<0> if C<expr> "
6352 "evaluates to something which is not a nodeset."
6353 msgstr ""
6354
6355 #. type: =head2
6356 #: ../src/guestfs-actions.pod:348
6357 msgid "guestfs_aug_get"
6358 msgstr ""
6359
6360 #. type: verbatim
6361 #: ../src/guestfs-actions.pod:350
6362 #, no-wrap
6363 msgid ""
6364 " char *\n"
6365 " guestfs_aug_get (guestfs_h *g,\n"
6366 "                  const char *augpath);\n"
6367 "\n"
6368 msgstr ""
6369
6370 #. type: textblock
6371 #: ../src/guestfs-actions.pod:354 ../fish/guestfish-actions.pod:225
6372 msgid ""
6373 "Look up the value associated with C<path>.  If C<path> matches exactly one "
6374 "node, the C<value> is returned."
6375 msgstr ""
6376
6377 #. type: textblock
6378 #: ../src/guestfs-actions.pod:357 ../src/guestfs-actions.pod:862 ../src/guestfs-actions.pod:880 ../src/guestfs-actions.pod:940 ../src/guestfs-actions.pod:956 ../src/guestfs-actions.pod:1059 ../src/guestfs-actions.pod:1189 ../src/guestfs-actions.pod:1206 ../src/guestfs-actions.pod:1225 ../src/guestfs-actions.pod:1359 ../src/guestfs-actions.pod:1547 ../src/guestfs-actions.pod:1659 ../src/guestfs-actions.pod:1822 ../src/guestfs-actions.pod:1839 ../src/guestfs-actions.pod:1906 ../src/guestfs-actions.pod:1940 ../src/guestfs-actions.pod:1961 ../src/guestfs-actions.pod:2131 ../src/guestfs-actions.pod:2323 ../src/guestfs-actions.pod:2530 ../src/guestfs-actions.pod:2623 ../src/guestfs-actions.pod:2734 ../src/guestfs-actions.pod:2754 ../src/guestfs-actions.pod:2874 ../src/guestfs-actions.pod:2905 ../src/guestfs-actions.pod:2929 ../src/guestfs-actions.pod:2966 ../src/guestfs-actions.pod:3026 ../src/guestfs-actions.pod:3049 ../src/guestfs-actions.pod:3070 ../src/guestfs-actions.pod:3642 ../src/guestfs-actions.pod:3992 ../src/guestfs-actions.pod:4162 ../src/guestfs-actions.pod:4272 ../src/guestfs-actions.pod:5033 ../src/guestfs-actions.pod:5226 ../src/guestfs-actions.pod:5396 ../src/guestfs-actions.pod:5574 ../src/guestfs-actions.pod:5623 ../src/guestfs-actions.pod:6256 ../src/guestfs-actions.pod:6272 ../src/guestfs-actions.pod:6289 ../src/guestfs-actions.pod:6320 ../src/guestfs-actions.pod:6994 ../src/guestfs-actions.pod:7013 ../src/guestfs-actions.pod:7031 ../src/guestfs-actions.pod:7211 ../src/guestfs-actions.pod:7490
6379 msgid ""
6380 "This function returns a string, or NULL on error.  I<The caller must free "
6381 "the returned string after use>."
6382 msgstr ""
6383
6384 #. type: =head2
6385 #: ../src/guestfs-actions.pod:362
6386 msgid "guestfs_aug_init"
6387 msgstr ""
6388
6389 #. type: verbatim
6390 #: ../src/guestfs-actions.pod:364
6391 #, no-wrap
6392 msgid ""
6393 " int\n"
6394 " guestfs_aug_init (guestfs_h *g,\n"
6395 "                   const char *root,\n"
6396 "                   int flags);\n"
6397 "\n"
6398 msgstr ""
6399
6400 #. type: textblock
6401 #: ../src/guestfs-actions.pod:369 ../fish/guestfish-actions.pod:232
6402 msgid ""
6403 "Create a new Augeas handle for editing configuration files.  If there was "
6404 "any previous Augeas handle associated with this guestfs session, then it is "
6405 "closed."
6406 msgstr ""
6407
6408 #. type: textblock
6409 #: ../src/guestfs-actions.pod:373
6410 msgid "You must call this before using any other C<guestfs_aug_*> commands."
6411 msgstr ""
6412
6413 #. type: textblock
6414 #: ../src/guestfs-actions.pod:376 ../fish/guestfish-actions.pod:239
6415 msgid "C<root> is the filesystem root.  C<root> must not be NULL, use C</> instead."
6416 msgstr ""
6417
6418 #. type: textblock
6419 #: ../src/guestfs-actions.pod:379 ../fish/guestfish-actions.pod:242
6420 msgid ""
6421 "The flags are the same as the flags defined in E<lt>augeas.hE<gt>, the "
6422 "logical I<or> of the following integers:"
6423 msgstr ""
6424
6425 #. type: =item
6426 #: ../src/guestfs-actions.pod:385 ../fish/guestfish-actions.pod:248
6427 msgid "C<AUG_SAVE_BACKUP> = 1"
6428 msgstr ""
6429
6430 #. type: textblock
6431 #: ../src/guestfs-actions.pod:387 ../fish/guestfish-actions.pod:250
6432 msgid "Keep the original file with a C<.augsave> extension."
6433 msgstr ""
6434
6435 #. type: =item
6436 #: ../src/guestfs-actions.pod:389 ../fish/guestfish-actions.pod:252
6437 msgid "C<AUG_SAVE_NEWFILE> = 2"
6438 msgstr ""
6439
6440 #. type: textblock
6441 #: ../src/guestfs-actions.pod:391 ../fish/guestfish-actions.pod:254
6442 msgid ""
6443 "Save changes into a file with extension C<.augnew>, and do not overwrite "
6444 "original.  Overrides C<AUG_SAVE_BACKUP>."
6445 msgstr ""
6446
6447 #. type: =item
6448 #: ../src/guestfs-actions.pod:394 ../fish/guestfish-actions.pod:257
6449 msgid "C<AUG_TYPE_CHECK> = 4"
6450 msgstr ""
6451
6452 #. type: textblock
6453 #: ../src/guestfs-actions.pod:396 ../fish/guestfish-actions.pod:259
6454 msgid "Typecheck lenses."
6455 msgstr ""
6456
6457 #. type: textblock
6458 #: ../src/guestfs-actions.pod:398
6459 msgid ""
6460 "This option is only useful when debugging Augeas lenses.  Use of this option "
6461 "may require additional memory for the libguestfs appliance.  You may need to "
6462 "set the C<LIBGUESTFS_MEMSIZE> environment variable or call "
6463 "C<guestfs_set_memsize>."
6464 msgstr ""
6465
6466 #. type: =item
6467 #: ../src/guestfs-actions.pod:403 ../fish/guestfish-actions.pod:266
6468 msgid "C<AUG_NO_STDINC> = 8"
6469 msgstr ""
6470
6471 #. type: textblock
6472 #: ../src/guestfs-actions.pod:405 ../fish/guestfish-actions.pod:268
6473 msgid "Do not use standard load path for modules."
6474 msgstr ""
6475
6476 #. type: =item
6477 #: ../src/guestfs-actions.pod:407 ../fish/guestfish-actions.pod:270
6478 msgid "C<AUG_SAVE_NOOP> = 16"
6479 msgstr ""
6480
6481 #. type: textblock
6482 #: ../src/guestfs-actions.pod:409 ../fish/guestfish-actions.pod:272
6483 msgid "Make save a no-op, just record what would have been changed."
6484 msgstr ""
6485
6486 #. type: =item
6487 #: ../src/guestfs-actions.pod:411 ../fish/guestfish-actions.pod:274
6488 msgid "C<AUG_NO_LOAD> = 32"
6489 msgstr ""
6490
6491 #. type: textblock
6492 #: ../src/guestfs-actions.pod:413
6493 msgid "Do not load the tree in C<guestfs_aug_init>."
6494 msgstr ""
6495
6496 #. type: textblock
6497 #: ../src/guestfs-actions.pod:417
6498 msgid "To close the handle, you can call C<guestfs_aug_close>."
6499 msgstr ""
6500
6501 #. type: textblock
6502 #: ../src/guestfs-actions.pod:419 ../fish/guestfish-actions.pod:282
6503 msgid "To find out more about Augeas, see L<http://augeas.net/>."
6504 msgstr ""
6505
6506 #. type: =head2
6507 #: ../src/guestfs-actions.pod:425
6508 msgid "guestfs_aug_insert"
6509 msgstr ""
6510
6511 #. type: verbatim
6512 #: ../src/guestfs-actions.pod:427
6513 #, no-wrap
6514 msgid ""
6515 " int\n"
6516 " guestfs_aug_insert (guestfs_h *g,\n"
6517 "                     const char *augpath,\n"
6518 "                     const char *label,\n"
6519 "                     int before);\n"
6520 "\n"
6521 msgstr ""
6522
6523 #. type: textblock
6524 #: ../src/guestfs-actions.pod:433 ../fish/guestfish-actions.pod:288
6525 msgid ""
6526 "Create a new sibling C<label> for C<path>, inserting it into the tree before "
6527 "or after C<path> (depending on the boolean flag C<before>)."
6528 msgstr ""
6529
6530 #. type: textblock
6531 #: ../src/guestfs-actions.pod:437 ../fish/guestfish-actions.pod:292
6532 msgid ""
6533 "C<path> must match exactly one existing node in the tree, and C<label> must "
6534 "be a label, ie. not contain C</>, C<*> or end with a bracketed index C<[N]>."
6535 msgstr ""
6536
6537 #. type: =head2
6538 #: ../src/guestfs-actions.pod:445
6539 msgid "guestfs_aug_load"
6540 msgstr ""
6541
6542 #. type: verbatim
6543 #: ../src/guestfs-actions.pod:447
6544 #, no-wrap
6545 msgid ""
6546 " int\n"
6547 " guestfs_aug_load (guestfs_h *g);\n"
6548 "\n"
6549 msgstr ""
6550
6551 #. type: textblock
6552 #: ../src/guestfs-actions.pod:450 ../fish/guestfish-actions.pod:300
6553 msgid "Load files into the tree."
6554 msgstr ""
6555
6556 #. type: textblock
6557 #: ../src/guestfs-actions.pod:452 ../fish/guestfish-actions.pod:302
6558 msgid "See C<aug_load> in the Augeas documentation for the full gory details."
6559 msgstr ""
6560
6561 #. type: =head2
6562 #: ../src/guestfs-actions.pod:459
6563 msgid "guestfs_aug_ls"
6564 msgstr ""
6565
6566 #. type: verbatim
6567 #: ../src/guestfs-actions.pod:461
6568 #, no-wrap
6569 msgid ""
6570 " char **\n"
6571 " guestfs_aug_ls (guestfs_h *g,\n"
6572 "                 const char *augpath);\n"
6573 "\n"
6574 msgstr ""
6575
6576 #. type: textblock
6577 #: ../src/guestfs-actions.pod:465
6578 msgid ""
6579 "This is just a shortcut for listing C<guestfs_aug_match> C<path/*> and "
6580 "sorting the resulting nodes into alphabetical order."
6581 msgstr ""
6582
6583 #. type: textblock
6584 #: ../src/guestfs-actions.pod:468 ../src/guestfs-actions.pod:484 ../src/guestfs-actions.pod:630 ../src/guestfs-actions.pod:1078 ../src/guestfs-actions.pod:1374 ../src/guestfs-actions.pod:1393 ../src/guestfs-actions.pod:1496 ../src/guestfs-actions.pod:1515 ../src/guestfs-actions.pod:1761 ../src/guestfs-actions.pod:2203 ../src/guestfs-actions.pod:2219 ../src/guestfs-actions.pod:2238 ../src/guestfs-actions.pod:2281 ../src/guestfs-actions.pod:2305 ../src/guestfs-actions.pod:2376 ../src/guestfs-actions.pod:2425 ../src/guestfs-actions.pod:2692 ../src/guestfs-actions.pod:2983 ../src/guestfs-actions.pod:3272 ../src/guestfs-actions.pod:3562 ../src/guestfs-actions.pod:3624 ../src/guestfs-actions.pod:3729 ../src/guestfs-actions.pod:4134 ../src/guestfs-actions.pod:4839 ../src/guestfs-actions.pod:5368 ../src/guestfs-actions.pod:5494 ../src/guestfs-actions.pod:5608 ../src/guestfs-actions.pod:6336 ../src/guestfs-actions.pod:6397 ../src/guestfs-actions.pod:6452 ../src/guestfs-actions.pod:6598 ../src/guestfs-actions.pod:6622 ../src/guestfs-actions.pod:7104 ../src/guestfs-actions.pod:7124 ../src/guestfs-actions.pod:7171 ../src/guestfs-actions.pod:7343 ../src/guestfs-actions.pod:7362 ../src/guestfs-actions.pod:7447 ../src/guestfs-actions.pod:7466 ../src/guestfs-actions.pod:7512 ../src/guestfs-actions.pod:7531
6585 msgid ""
6586 "This function returns a NULL-terminated array of strings (like "
6587 "L<environ(3)>), or NULL if there was an error.  I<The caller must free the "
6588 "strings and the array after use>."
6589 msgstr ""
6590
6591 #. type: textblock
6592 #: ../src/guestfs-actions.pod:472 ../src/guestfs-actions.pod:1003 ../src/guestfs-actions.pod:1021 ../src/guestfs-actions.pod:1431 ../src/guestfs-actions.pod:3350 ../src/guestfs-actions.pod:3381 ../src/guestfs-actions.pod:3975 ../src/guestfs-actions.pod:4025 ../src/guestfs-actions.pod:4212 ../src/guestfs-actions.pod:4245 ../src/guestfs-actions.pod:4408 ../src/guestfs-actions.pod:4843 ../src/guestfs-actions.pod:5309 ../src/guestfs-actions.pod:5704 ../src/guestfs-actions.pod:5718 ../src/guestfs-actions.pod:5730 ../src/guestfs-actions.pod:6177 ../src/guestfs-actions.pod:6836 ../src/guestfs-actions.pod:6849 ../src/guestfs-actions.pod:7088 ../src/guestfs-actions.pod:7331
6593 msgid "(Added in 0.8)"
6594 msgstr ""
6595
6596 #. type: =head2
6597 #: ../src/guestfs-actions.pod:474
6598 msgid "guestfs_aug_match"
6599 msgstr ""
6600
6601 #. type: verbatim
6602 #: ../src/guestfs-actions.pod:476
6603 #, no-wrap
6604 msgid ""
6605 " char **\n"
6606 " guestfs_aug_match (guestfs_h *g,\n"
6607 "                    const char *augpath);\n"
6608 "\n"
6609 msgstr ""
6610
6611 #. type: textblock
6612 #: ../src/guestfs-actions.pod:480 ../fish/guestfish-actions.pod:316
6613 msgid ""
6614 "Returns a list of paths which match the path expression C<path>.  The "
6615 "returned paths are sufficiently qualified so that they match exactly one "
6616 "node in the current tree."
6617 msgstr ""
6618
6619 #. type: =head2
6620 #: ../src/guestfs-actions.pod:490
6621 msgid "guestfs_aug_mv"
6622 msgstr ""
6623
6624 #. type: verbatim
6625 #: ../src/guestfs-actions.pod:492
6626 #, no-wrap
6627 msgid ""
6628 " int\n"
6629 " guestfs_aug_mv (guestfs_h *g,\n"
6630 "                 const char *src,\n"
6631 "                 const char *dest);\n"
6632 "\n"
6633 msgstr ""
6634
6635 #. type: textblock
6636 #: ../src/guestfs-actions.pod:497 ../fish/guestfish-actions.pod:324
6637 msgid ""
6638 "Move the node C<src> to C<dest>.  C<src> must match exactly one node.  "
6639 "C<dest> is overwritten if it exists."
6640 msgstr ""
6641
6642 #. type: =head2
6643 #: ../src/guestfs-actions.pod:504
6644 msgid "guestfs_aug_rm"
6645 msgstr ""
6646
6647 #. type: verbatim
6648 #: ../src/guestfs-actions.pod:506
6649 #, no-wrap
6650 msgid ""
6651 " int\n"
6652 " guestfs_aug_rm (guestfs_h *g,\n"
6653 "                 const char *augpath);\n"
6654 "\n"
6655 msgstr ""
6656
6657 #. type: textblock
6658 #: ../src/guestfs-actions.pod:510 ../fish/guestfish-actions.pod:331
6659 msgid "Remove C<path> and all of its children."
6660 msgstr ""
6661
6662 #. type: textblock
6663 #: ../src/guestfs-actions.pod:512 ../fish/guestfish-actions.pod:333
6664 msgid "On success this returns the number of entries which were removed."
6665 msgstr ""
6666
6667 #. type: =head2
6668 #: ../src/guestfs-actions.pod:518
6669 msgid "guestfs_aug_save"
6670 msgstr ""
6671
6672 #. type: verbatim
6673 #: ../src/guestfs-actions.pod:520
6674 #, no-wrap
6675 msgid ""
6676 " int\n"
6677 " guestfs_aug_save (guestfs_h *g);\n"
6678 "\n"
6679 msgstr ""
6680
6681 #. type: textblock
6682 #: ../src/guestfs-actions.pod:523 ../fish/guestfish-actions.pod:339
6683 msgid "This writes all pending changes to disk."
6684 msgstr ""
6685
6686 #. type: textblock
6687 #: ../src/guestfs-actions.pod:525
6688 msgid ""
6689 "The flags which were passed to C<guestfs_aug_init> affect exactly how files "
6690 "are saved."
6691 msgstr ""
6692
6693 #. type: =head2
6694 #: ../src/guestfs-actions.pod:532
6695 msgid "guestfs_aug_set"
6696 msgstr ""
6697
6698 #. type: verbatim
6699 #: ../src/guestfs-actions.pod:534
6700 #, no-wrap
6701 msgid ""
6702 " int\n"
6703 " guestfs_aug_set (guestfs_h *g,\n"
6704 "                  const char *augpath,\n"
6705 "                  const char *val);\n"
6706 "\n"
6707 msgstr ""
6708
6709 #. type: textblock
6710 #: ../src/guestfs-actions.pod:539 ../fish/guestfish-actions.pod:348
6711 msgid "Set the value associated with C<path> to C<val>."
6712 msgstr ""
6713
6714 #. type: textblock
6715 #: ../src/guestfs-actions.pod:541
6716 msgid ""
6717 "In the Augeas API, it is possible to clear a node by setting the value to "
6718 "NULL.  Due to an oversight in the libguestfs API you cannot do that with "
6719 "this call.  Instead you must use the C<guestfs_aug_clear> call."
6720 msgstr ""
6721
6722 #. type: =head2
6723 #: ../src/guestfs-actions.pod:550
6724 msgid "guestfs_available"
6725 msgstr ""
6726
6727 #. type: verbatim
6728 #: ../src/guestfs-actions.pod:552
6729 #, no-wrap
6730 msgid ""
6731 " int\n"
6732 " guestfs_available (guestfs_h *g,\n"
6733 "                    char *const *groups);\n"
6734 "\n"
6735 msgstr ""
6736
6737 #. type: textblock
6738 #: ../src/guestfs-actions.pod:556 ../fish/guestfish-actions.pod:359
6739 msgid ""
6740 "This command is used to check the availability of some groups of "
6741 "functionality in the appliance, which not all builds of the libguestfs "
6742 "appliance will be able to provide."
6743 msgstr ""
6744
6745 #. type: textblock
6746 #: ../src/guestfs-actions.pod:560
6747 msgid ""
6748 "The libguestfs groups, and the functions that those groups correspond to, "
6749 "are listed in L<guestfs(3)/AVAILABILITY>.  You can also fetch this list at "
6750 "runtime by calling C<guestfs_available_all_groups>."
6751 msgstr ""
6752
6753 #. type: textblock
6754 #: ../src/guestfs-actions.pod:565 ../fish/guestfish-actions.pod:368
6755 msgid ""
6756 "The argument C<groups> is a list of group names, eg: C<[\"inotify\", "
6757 "\"augeas\"]> would check for the availability of the Linux inotify functions "
6758 "and Augeas (configuration file editing) functions."
6759 msgstr ""
6760
6761 #. type: textblock
6762 #: ../src/guestfs-actions.pod:570 ../fish/guestfish-actions.pod:373
6763 msgid "The command returns no error if I<all> requested groups are available."
6764 msgstr ""
6765
6766 #. type: textblock
6767 #: ../src/guestfs-actions.pod:572 ../fish/guestfish-actions.pod:375
6768 msgid ""
6769 "It fails with an error if one or more of the requested groups is unavailable "
6770 "in the appliance."
6771 msgstr ""
6772
6773 #. type: textblock
6774 #: ../src/guestfs-actions.pod:575 ../fish/guestfish-actions.pod:378
6775 msgid ""
6776 "If an unknown group name is included in the list of groups then an error is "
6777 "always returned."
6778 msgstr ""
6779
6780 #. type: textblock
6781 #: ../src/guestfs-actions.pod:578 ../fish/guestfish-actions.pod:381
6782 msgid "I<Notes:>"
6783 msgstr ""
6784
6785 #. type: textblock
6786 #: ../src/guestfs-actions.pod:584
6787 msgid "You must call C<guestfs_launch> before calling this function."
6788 msgstr ""
6789
6790 #. type: textblock
6791 #: ../src/guestfs-actions.pod:586 ../fish/guestfish-actions.pod:389
6792 msgid ""
6793 "The reason is because we don't know what groups are supported by the "
6794 "appliance/daemon until it is running and can be queried."
6795 msgstr ""
6796
6797 #. type: textblock
6798 #: ../src/guestfs-actions.pod:592 ../fish/guestfish-actions.pod:395
6799 msgid ""
6800 "If a group of functions is available, this does not necessarily mean that "
6801 "they will work.  You still have to check for errors when calling individual "
6802 "API functions even if they are available."
6803 msgstr ""
6804
6805 #. type: textblock
6806 #: ../src/guestfs-actions.pod:599 ../fish/guestfish-actions.pod:402
6807 msgid ""
6808 "It is usually the job of distro packagers to build complete functionality "
6809 "into the libguestfs appliance.  Upstream libguestfs, if built from source "
6810 "with all requirements satisfied, will support everything."
6811 msgstr ""
6812
6813 #. type: textblock
6814 #: ../src/guestfs-actions.pod:606
6815 msgid ""
6816 "This call was added in version C<1.0.80>.  In previous versions of "
6817 "libguestfs all you could do would be to speculatively execute a command to "
6818 "find out if the daemon implemented it.  See also C<guestfs_version>."
6819 msgstr ""
6820
6821 #. type: textblock
6822 #: ../src/guestfs-actions.pod:615 ../src/guestfs-actions.pod:1176
6823 msgid "(Added in 1.0.80)"
6824 msgstr ""
6825
6826 #. type: =head2
6827 #: ../src/guestfs-actions.pod:617
6828 msgid "guestfs_available_all_groups"
6829 msgstr ""
6830
6831 #. type: verbatim
6832 #: ../src/guestfs-actions.pod:619
6833 #, no-wrap
6834 msgid ""
6835 " char **\n"
6836 " guestfs_available_all_groups (guestfs_h *g);\n"
6837 "\n"
6838 msgstr ""
6839
6840 #. type: textblock
6841 #: ../src/guestfs-actions.pod:622
6842 msgid ""
6843 "This command returns a list of all optional groups that this daemon knows "
6844 "about.  Note this returns both supported and unsupported groups.  To find "
6845 "out which ones the daemon can actually support you have to call "
6846 "C<guestfs_available> on each member of the returned list."
6847 msgstr ""
6848
6849 #. type: textblock
6850 #: ../src/guestfs-actions.pod:628
6851 msgid "See also C<guestfs_available> and L<guestfs(3)/AVAILABILITY>."
6852 msgstr ""
6853
6854 #. type: textblock
6855 #: ../src/guestfs-actions.pod:634
6856 msgid "(Added in 1.3.15)"
6857 msgstr ""
6858
6859 #. type: =head2
6860 #: ../src/guestfs-actions.pod:636
6861 msgid "guestfs_base64_in"
6862 msgstr ""
6863
6864 #. type: verbatim
6865 #: ../src/guestfs-actions.pod:638
6866 #, no-wrap
6867 msgid ""
6868 " int\n"
6869 " guestfs_base64_in (guestfs_h *g,\n"
6870 "                    const char *base64file,\n"
6871 "                    const char *filename);\n"
6872 "\n"
6873 msgstr ""
6874
6875 #. type: textblock
6876 #: ../src/guestfs-actions.pod:643 ../fish/guestfish-actions.pod:432
6877 msgid "This command uploads base64-encoded data from C<base64file> to C<filename>."
6878 msgstr ""
6879
6880 #. type: textblock
6881 #: ../src/guestfs-actions.pod:648 ../src/guestfs-actions.pod:662
6882 msgid "(Added in 1.3.5)"
6883 msgstr ""
6884
6885 #. type: =head2
6886 #: ../src/guestfs-actions.pod:650
6887 msgid "guestfs_base64_out"
6888 msgstr ""
6889
6890 #. type: verbatim
6891 #: ../src/guestfs-actions.pod:652
6892 #, no-wrap
6893 msgid ""
6894 " int\n"
6895 " guestfs_base64_out (guestfs_h *g,\n"
6896 "                     const char *filename,\n"
6897 "                     const char *base64file);\n"
6898 "\n"
6899 msgstr ""
6900
6901 #. type: textblock
6902 #: ../src/guestfs-actions.pod:657 ../fish/guestfish-actions.pod:441
6903 msgid ""
6904 "This command downloads the contents of C<filename>, writing it out to local "
6905 "file C<base64file> encoded as base64."
6906 msgstr ""
6907
6908 #. type: =head2
6909 #: ../src/guestfs-actions.pod:664
6910 msgid "guestfs_blockdev_flushbufs"
6911 msgstr ""
6912
6913 #. type: verbatim
6914 #: ../src/guestfs-actions.pod:666
6915 #, no-wrap
6916 msgid ""
6917 " int\n"
6918 " guestfs_blockdev_flushbufs (guestfs_h *g,\n"
6919 "                             const char *device);\n"
6920 "\n"
6921 msgstr ""
6922
6923 #. type: textblock
6924 #: ../src/guestfs-actions.pod:670 ../fish/guestfish-actions.pod:450
6925 msgid "This tells the kernel to flush internal buffers associated with C<device>."
6926 msgstr ""
6927
6928 #. type: textblock
6929 #: ../src/guestfs-actions.pod:673 ../src/guestfs-actions.pod:690 ../src/guestfs-actions.pod:705 ../src/guestfs-actions.pod:721 ../src/guestfs-actions.pod:739 ../src/guestfs-actions.pod:758 ../src/guestfs-actions.pod:772 ../src/guestfs-actions.pod:790 ../src/guestfs-actions.pod:804 ../src/guestfs-actions.pod:818 ../fish/guestfish-actions.pod:453 ../fish/guestfish-actions.pod:464 ../fish/guestfish-actions.pod:473 ../fish/guestfish-actions.pod:483 ../fish/guestfish-actions.pod:495 ../fish/guestfish-actions.pod:508 ../fish/guestfish-actions.pod:516 ../fish/guestfish-actions.pod:527 ../fish/guestfish-actions.pod:535 ../fish/guestfish-actions.pod:543
6930 msgid "This uses the L<blockdev(8)> command."
6931 msgstr ""
6932
6933 #. type: textblock
6934 #: ../src/guestfs-actions.pod:677 ../src/guestfs-actions.pod:694 ../src/guestfs-actions.pod:709 ../src/guestfs-actions.pod:725 ../src/guestfs-actions.pod:743 ../src/guestfs-actions.pod:762 ../src/guestfs-actions.pod:776 ../src/guestfs-actions.pod:794 ../src/guestfs-actions.pod:808 ../src/guestfs-actions.pod:822
6935 msgid "(Added in 0.9.3)"
6936 msgstr ""
6937
6938 #. type: =head2
6939 #: ../src/guestfs-actions.pod:679
6940 msgid "guestfs_blockdev_getbsz"
6941 msgstr ""
6942
6943 #. type: verbatim
6944 #: ../src/guestfs-actions.pod:681
6945 #, no-wrap
6946 msgid ""
6947 " int\n"
6948 " guestfs_blockdev_getbsz (guestfs_h *g,\n"
6949 "                          const char *device);\n"
6950 "\n"
6951 msgstr ""
6952
6953 #. type: textblock
6954 #: ../src/guestfs-actions.pod:685 ../fish/guestfish-actions.pod:459
6955 msgid "This returns the block size of a device."
6956 msgstr ""
6957
6958 #. type: textblock
6959 #: ../src/guestfs-actions.pod:687 ../src/guestfs-actions.pod:787 ../fish/guestfish-actions.pod:461 ../fish/guestfish-actions.pod:524
6960 msgid ""
6961 "(Note this is different from both I<size in blocks> and I<filesystem block "
6962 "size>)."
6963 msgstr ""
6964
6965 #. type: =head2
6966 #: ../src/guestfs-actions.pod:696
6967 msgid "guestfs_blockdev_getro"
6968 msgstr ""
6969
6970 #. type: verbatim
6971 #: ../src/guestfs-actions.pod:698
6972 #, no-wrap
6973 msgid ""
6974 " int\n"
6975 " guestfs_blockdev_getro (guestfs_h *g,\n"
6976 "                         const char *device);\n"
6977 "\n"
6978 msgstr ""
6979
6980 #. type: textblock
6981 #: ../src/guestfs-actions.pod:702 ../fish/guestfish-actions.pod:470
6982 msgid ""
6983 "Returns a boolean indicating if the block device is read-only (true if "
6984 "read-only, false if not)."
6985 msgstr ""
6986
6987 #. type: textblock
6988 #: ../src/guestfs-actions.pod:707 ../src/guestfs-actions.pod:1414 ../src/guestfs-actions.pod:1429 ../src/guestfs-actions.pod:1916 ../src/guestfs-actions.pod:1927 ../src/guestfs-actions.pod:1999 ../src/guestfs-actions.pod:2054 ../src/guestfs-actions.pod:2069 ../src/guestfs-actions.pod:2094 ../src/guestfs-actions.pod:2117 ../src/guestfs-actions.pod:3090 ../src/guestfs-actions.pod:3107 ../src/guestfs-actions.pod:3126 ../src/guestfs-actions.pod:3289 ../src/guestfs-actions.pod:3303 ../src/guestfs-actions.pod:3318 ../src/guestfs-actions.pod:3332 ../src/guestfs-actions.pod:3348 ../src/guestfs-actions.pod:3363 ../src/guestfs-actions.pod:3379 ../src/guestfs-actions.pod:3393 ../src/guestfs-actions.pod:3406 ../src/guestfs-actions.pod:3420 ../src/guestfs-actions.pod:3435 ../src/guestfs-actions.pod:3450 ../src/guestfs-actions.pod:4997
6989 msgid "This function returns a C truth value on success or -1 on error."
6990 msgstr ""
6991
6992 #. type: =head2
6993 #: ../src/guestfs-actions.pod:711
6994 msgid "guestfs_blockdev_getsize64"
6995 msgstr ""
6996
6997 #. type: verbatim
6998 #: ../src/guestfs-actions.pod:713
6999 #, no-wrap
7000 msgid ""
7001 " int64_t\n"
7002 " guestfs_blockdev_getsize64 (guestfs_h *g,\n"
7003 "                             const char *device);\n"
7004 "\n"
7005 msgstr ""
7006
7007 #. type: textblock
7008 #: ../src/guestfs-actions.pod:717 ../fish/guestfish-actions.pod:479
7009 msgid "This returns the size of the device in bytes."
7010 msgstr ""
7011
7012 #. type: textblock
7013 #: ../src/guestfs-actions.pod:719
7014 msgid "See also C<guestfs_blockdev_getsz>."
7015 msgstr ""
7016
7017 #. type: =head2
7018 #: ../src/guestfs-actions.pod:727
7019 msgid "guestfs_blockdev_getss"
7020 msgstr ""
7021
7022 #. type: verbatim
7023 #: ../src/guestfs-actions.pod:729
7024 #, no-wrap
7025 msgid ""
7026 " int\n"
7027 " guestfs_blockdev_getss (guestfs_h *g,\n"
7028 "                         const char *device);\n"
7029 "\n"
7030 msgstr ""
7031
7032 #. type: textblock
7033 #: ../src/guestfs-actions.pod:733 ../fish/guestfish-actions.pod:489
7034 msgid ""
7035 "This returns the size of sectors on a block device.  Usually 512, but can be "
7036 "larger for modern devices."
7037 msgstr ""
7038
7039 #. type: textblock
7040 #: ../src/guestfs-actions.pod:736
7041 msgid ""
7042 "(Note, this is not the size in sectors, use C<guestfs_blockdev_getsz> for "
7043 "that)."
7044 msgstr ""
7045
7046 #. type: =head2
7047 #: ../src/guestfs-actions.pod:745
7048 msgid "guestfs_blockdev_getsz"
7049 msgstr ""
7050
7051 #. type: verbatim
7052 #: ../src/guestfs-actions.pod:747
7053 #, no-wrap
7054 msgid ""
7055 " int64_t\n"
7056 " guestfs_blockdev_getsz (guestfs_h *g,\n"
7057 "                         const char *device);\n"
7058 "\n"
7059 msgstr ""
7060
7061 #. type: textblock
7062 #: ../src/guestfs-actions.pod:751 ../fish/guestfish-actions.pod:501
7063 msgid ""
7064 "This returns the size of the device in units of 512-byte sectors (even if "
7065 "the sectorsize isn't 512 bytes ... weird)."
7066 msgstr ""
7067
7068 #. type: textblock
7069 #: ../src/guestfs-actions.pod:754
7070 msgid ""
7071 "See also C<guestfs_blockdev_getss> for the real sector size of the device, "
7072 "and C<guestfs_blockdev_getsize64> for the more useful I<size in bytes>."
7073 msgstr ""
7074
7075 #. type: =head2
7076 #: ../src/guestfs-actions.pod:764
7077 msgid "guestfs_blockdev_rereadpt"
7078 msgstr ""
7079
7080 #. type: verbatim
7081 #: ../src/guestfs-actions.pod:766
7082 #, no-wrap
7083 msgid ""
7084 " int\n"
7085 " guestfs_blockdev_rereadpt (guestfs_h *g,\n"
7086 "                            const char *device);\n"
7087 "\n"
7088 msgstr ""
7089
7090 #. type: textblock
7091 #: ../src/guestfs-actions.pod:770 ../fish/guestfish-actions.pod:514
7092 msgid "Reread the partition table on C<device>."
7093 msgstr ""
7094
7095 #. type: =head2
7096 #: ../src/guestfs-actions.pod:778
7097 msgid "guestfs_blockdev_setbsz"
7098 msgstr ""
7099
7100 #. type: verbatim
7101 #: ../src/guestfs-actions.pod:780
7102 #, no-wrap
7103 msgid ""
7104 " int\n"
7105 " guestfs_blockdev_setbsz (guestfs_h *g,\n"
7106 "                          const char *device,\n"
7107 "                          int blocksize);\n"
7108 "\n"
7109 msgstr ""
7110
7111 #. type: textblock
7112 #: ../src/guestfs-actions.pod:785 ../fish/guestfish-actions.pod:522
7113 msgid "This sets the block size of a device."
7114 msgstr ""
7115
7116 #. type: =head2
7117 #: ../src/guestfs-actions.pod:796
7118 msgid "guestfs_blockdev_setro"
7119 msgstr ""
7120
7121 #. type: verbatim
7122 #: ../src/guestfs-actions.pod:798
7123 #, no-wrap
7124 msgid ""
7125 " int\n"
7126 " guestfs_blockdev_setro (guestfs_h *g,\n"
7127 "                         const char *device);\n"
7128 "\n"
7129 msgstr ""
7130
7131 #. type: textblock
7132 #: ../src/guestfs-actions.pod:802 ../fish/guestfish-actions.pod:533
7133 msgid "Sets the block device named C<device> to read-only."
7134 msgstr ""
7135
7136 #. type: =head2
7137 #: ../src/guestfs-actions.pod:810
7138 msgid "guestfs_blockdev_setrw"
7139 msgstr ""
7140
7141 #. type: verbatim
7142 #: ../src/guestfs-actions.pod:812
7143 #, no-wrap
7144 msgid ""
7145 " int\n"
7146 " guestfs_blockdev_setrw (guestfs_h *g,\n"
7147 "                         const char *device);\n"
7148 "\n"
7149 msgstr ""
7150
7151 #. type: textblock
7152 #: ../src/guestfs-actions.pod:816 ../fish/guestfish-actions.pod:541
7153 msgid "Sets the block device named C<device> to read-write."
7154 msgstr ""
7155
7156 #. type: =head2
7157 #: ../src/guestfs-actions.pod:824
7158 msgid "guestfs_case_sensitive_path"
7159 msgstr ""
7160
7161 #. type: verbatim
7162 #: ../src/guestfs-actions.pod:826
7163 #, no-wrap
7164 msgid ""
7165 " char *\n"
7166 " guestfs_case_sensitive_path (guestfs_h *g,\n"
7167 "                              const char *path);\n"
7168 "\n"
7169 msgstr ""
7170
7171 #. type: textblock
7172 #: ../src/guestfs-actions.pod:830 ../fish/guestfish-actions.pod:549
7173 msgid ""
7174 "This can be used to resolve case insensitive paths on a filesystem which is "
7175 "case sensitive.  The use case is to resolve paths which you have read from "
7176 "Windows configuration files or the Windows Registry, to the true path."
7177 msgstr ""
7178
7179 #. type: textblock
7180 #: ../src/guestfs-actions.pod:835 ../fish/guestfish-actions.pod:554
7181 msgid ""
7182 "The command handles a peculiarity of the Linux ntfs-3g filesystem driver "
7183 "(and probably others), which is that although the underlying filesystem is "
7184 "case-insensitive, the driver exports the filesystem to Linux as "
7185 "case-sensitive."
7186 msgstr ""
7187
7188 #. type: textblock
7189 #: ../src/guestfs-actions.pod:840 ../fish/guestfish-actions.pod:559
7190 msgid ""
7191 "One consequence of this is that special directories such as C<c:\\windows> "
7192 "may appear as C</WINDOWS> or C</windows> (or other things) depending on the "
7193 "precise details of how they were created.  In Windows itself this would not "
7194 "be a problem."
7195 msgstr ""
7196
7197 #. type: textblock
7198 #: ../src/guestfs-actions.pod:846 ../fish/guestfish-actions.pod:565
7199 msgid ""
7200 "Bug or feature? You decide: "
7201 "L<http://www.tuxera.com/community/ntfs-3g-faq/#posixfilenames1>"
7202 msgstr ""
7203
7204 #. type: textblock
7205 #: ../src/guestfs-actions.pod:849 ../fish/guestfish-actions.pod:568
7206 msgid ""
7207 "This function resolves the true case of each element in the path and returns "
7208 "the case-sensitive path."
7209 msgstr ""
7210
7211 #. type: textblock
7212 #: ../src/guestfs-actions.pod:852
7213 msgid ""
7214 "Thus C<guestfs_case_sensitive_path> (\"/Windows/System32\")  might return "
7215 "C<\"/WINDOWS/system32\"> (the exact return value would depend on details of "
7216 "how the directories were originally created under Windows)."
7217 msgstr ""
7218
7219 #. type: textblock
7220 #: ../src/guestfs-actions.pod:857 ../fish/guestfish-actions.pod:576
7221 msgid "I<Note>: This function does not handle drive names, backslashes etc."
7222 msgstr ""
7223
7224 #. type: textblock
7225 #: ../src/guestfs-actions.pod:860
7226 msgid "See also C<guestfs_realpath>."
7227 msgstr ""
7228
7229 #. type: textblock
7230 #: ../src/guestfs-actions.pod:865 ../src/guestfs-actions.pod:7016
7231 msgid "(Added in 1.0.75)"
7232 msgstr ""
7233
7234 #. type: =head2
7235 #: ../src/guestfs-actions.pod:867
7236 msgid "guestfs_cat"
7237 msgstr ""
7238
7239 #. type: verbatim
7240 #: ../src/guestfs-actions.pod:869
7241 #, no-wrap
7242 msgid ""
7243 " char *\n"
7244 " guestfs_cat (guestfs_h *g,\n"
7245 "              const char *path);\n"
7246 "\n"
7247 msgstr ""
7248
7249 #. type: textblock
7250 #: ../src/guestfs-actions.pod:873 ../src/guestfs-actions.pod:5484 ../fish/guestfish-actions.pod:585 ../fish/guestfish-actions.pod:3685
7251 msgid "Return the contents of the file named C<path>."
7252 msgstr ""
7253
7254 #. type: textblock
7255 #: ../src/guestfs-actions.pod:875
7256 msgid ""
7257 "Note that this function cannot correctly handle binary files (specifically, "
7258 "files containing C<\\0> character which is treated as end of string).  For "
7259 "those you need to use the C<guestfs_read_file> or C<guestfs_download> "
7260 "functions which have a more complex interface."
7261 msgstr ""
7262
7263 #. type: textblock
7264 #: ../src/guestfs-actions.pod:883 ../src/guestfs-actions.pod:1062 ../src/guestfs-actions.pod:1082 ../src/guestfs-actions.pod:1378 ../src/guestfs-actions.pod:1397 ../src/guestfs-actions.pod:1500 ../src/guestfs-actions.pod:1519 ../src/guestfs-actions.pod:1765 ../src/guestfs-actions.pod:2223 ../src/guestfs-actions.pod:2242 ../src/guestfs-actions.pod:2285 ../src/guestfs-actions.pod:2309 ../src/guestfs-actions.pod:2326 ../src/guestfs-actions.pod:2355 ../src/guestfs-actions.pod:5266 ../src/guestfs-actions.pod:5292 ../src/guestfs-actions.pod:5423 ../src/guestfs-actions.pod:5449 ../src/guestfs-actions.pod:5473 ../src/guestfs-actions.pod:6401 ../src/guestfs-actions.pod:6456 ../src/guestfs-actions.pod:6602 ../src/guestfs-actions.pod:6626 ../src/guestfs-actions.pod:7295 ../src/guestfs-actions.pod:7321 ../src/guestfs-actions.pod:7347 ../src/guestfs-actions.pod:7366 ../src/guestfs-actions.pod:7451 ../src/guestfs-actions.pod:7470 ../src/guestfs-actions.pod:7516 ../src/guestfs-actions.pod:7535 ../fish/guestfish-actions.pod:592 ../fish/guestfish-actions.pod:727 ../fish/guestfish-actions.pod:739 ../fish/guestfish-actions.pod:915 ../fish/guestfish-actions.pod:925 ../fish/guestfish-actions.pod:992 ../fish/guestfish-actions.pod:1002 ../fish/guestfish-actions.pod:1194 ../fish/guestfish-actions.pod:1495 ../fish/guestfish-actions.pod:1505 ../fish/guestfish-actions.pod:1533 ../fish/guestfish-actions.pod:1548 ../fish/guestfish-actions.pod:1558 ../fish/guestfish-actions.pod:1577 ../fish/guestfish-actions.pod:3555 ../fish/guestfish-actions.pod:3570 ../fish/guestfish-actions.pod:3646 ../fish/guestfish-actions.pod:3663 ../fish/guestfish-actions.pod:3678 ../fish/guestfish-actions.pod:4332 ../fish/guestfish-actions.pod:4378 ../fish/guestfish-actions.pod:4463 ../fish/guestfish-actions.pod:4478 ../fish/guestfish-actions.pod:4888 ../fish/guestfish-actions.pod:4906 ../fish/guestfish-actions.pod:4923 ../fish/guestfish-actions.pod:4933 ../fish/guestfish-actions.pod:4981 ../fish/guestfish-actions.pod:4991 ../fish/guestfish-actions.pod:5020 ../fish/guestfish-actions.pod:5030
7265 msgid ""
7266 "Because of the message protocol, there is a transfer limit of somewhere "
7267 "between 2MB and 4MB.  See L<guestfs(3)/PROTOCOL LIMITS>."
7268 msgstr ""
7269
7270 #. type: textblock
7271 #: ../src/guestfs-actions.pod:886 ../src/guestfs-actions.pod:3566 ../src/guestfs-actions.pod:3628 ../src/guestfs-actions.pod:3645 ../src/guestfs-actions.pod:3733 ../src/guestfs-actions.pod:4138 ../src/guestfs-actions.pod:4152 ../src/guestfs-actions.pod:5372 ../src/guestfs-actions.pod:5386 ../src/guestfs-actions.pod:7175 ../src/guestfs-actions.pod:7189
7272 msgid "(Added in 0.4)"
7273 msgstr ""
7274
7275 #. type: =head2
7276 #: ../src/guestfs-actions.pod:888
7277 msgid "guestfs_checksum"
7278 msgstr ""
7279
7280 #. type: verbatim
7281 #: ../src/guestfs-actions.pod:890
7282 #, no-wrap
7283 msgid ""
7284 " char *\n"
7285 " guestfs_checksum (guestfs_h *g,\n"
7286 "                   const char *csumtype,\n"
7287 "                   const char *path);\n"
7288 "\n"
7289 msgstr ""
7290
7291 #. type: textblock
7292 #: ../src/guestfs-actions.pod:895 ../fish/guestfish-actions.pod:599
7293 msgid "This call computes the MD5, SHAx or CRC checksum of the file named C<path>."
7294 msgstr ""
7295
7296 #. type: textblock
7297 #: ../src/guestfs-actions.pod:898 ../fish/guestfish-actions.pod:602
7298 msgid ""
7299 "The type of checksum to compute is given by the C<csumtype> parameter which "
7300 "must have one of the following values:"
7301 msgstr ""
7302
7303 #. type: =item
7304 #: ../src/guestfs-actions.pod:903 ../fish/guestfish-actions.pod:607
7305 msgid "C<crc>"
7306 msgstr ""
7307
7308 #. type: textblock
7309 #: ../src/guestfs-actions.pod:905 ../fish/guestfish-actions.pod:609
7310 msgid ""
7311 "Compute the cyclic redundancy check (CRC) specified by POSIX for the "
7312 "C<cksum> command."
7313 msgstr ""
7314
7315 #. type: =item
7316 #: ../src/guestfs-actions.pod:908 ../fish/guestfish-actions.pod:612
7317 msgid "C<md5>"
7318 msgstr ""
7319
7320 #. type: textblock
7321 #: ../src/guestfs-actions.pod:910 ../fish/guestfish-actions.pod:614
7322 msgid "Compute the MD5 hash (using the C<md5sum> program)."
7323 msgstr ""
7324
7325 #. type: =item
7326 #: ../src/guestfs-actions.pod:912 ../fish/guestfish-actions.pod:616
7327 msgid "C<sha1>"
7328 msgstr ""
7329
7330 #. type: textblock
7331 #: ../src/guestfs-actions.pod:914 ../fish/guestfish-actions.pod:618
7332 msgid "Compute the SHA1 hash (using the C<sha1sum> program)."
7333 msgstr ""
7334
7335 #. type: =item
7336 #: ../src/guestfs-actions.pod:916 ../fish/guestfish-actions.pod:620
7337 msgid "C<sha224>"
7338 msgstr ""
7339
7340 #. type: textblock
7341 #: ../src/guestfs-actions.pod:918 ../fish/guestfish-actions.pod:622
7342 msgid "Compute the SHA224 hash (using the C<sha224sum> program)."
7343 msgstr ""
7344
7345 #. type: =item
7346 #: ../src/guestfs-actions.pod:920 ../fish/guestfish-actions.pod:624
7347 msgid "C<sha256>"
7348 msgstr ""
7349
7350 #. type: textblock
7351 #: ../src/guestfs-actions.pod:922 ../fish/guestfish-actions.pod:626
7352 msgid "Compute the SHA256 hash (using the C<sha256sum> program)."
7353 msgstr ""
7354
7355 #. type: =item
7356 #: ../src/guestfs-actions.pod:924 ../fish/guestfish-actions.pod:628
7357 msgid "C<sha384>"
7358 msgstr ""
7359
7360 #. type: textblock
7361 #: ../src/guestfs-actions.pod:926 ../fish/guestfish-actions.pod:630
7362 msgid "Compute the SHA384 hash (using the C<sha384sum> program)."
7363 msgstr ""
7364
7365 #. type: =item
7366 #: ../src/guestfs-actions.pod:928 ../fish/guestfish-actions.pod:632
7367 msgid "C<sha512>"
7368 msgstr ""
7369
7370 #. type: textblock
7371 #: ../src/guestfs-actions.pod:930 ../fish/guestfish-actions.pod:634
7372 msgid "Compute the SHA512 hash (using the C<sha512sum> program)."
7373 msgstr ""
7374
7375 #. type: textblock
7376 #: ../src/guestfs-actions.pod:934 ../fish/guestfish-actions.pod:638
7377 msgid "The checksum is returned as a printable string."
7378 msgstr ""
7379
7380 #. type: textblock
7381 #: ../src/guestfs-actions.pod:936
7382 msgid "To get the checksum for a device, use C<guestfs_checksum_device>."
7383 msgstr ""
7384
7385 #. type: textblock
7386 #: ../src/guestfs-actions.pod:938
7387 msgid "To get the checksums for many files, use C<guestfs_checksums_out>."
7388 msgstr ""
7389
7390 #. type: textblock
7391 #: ../src/guestfs-actions.pod:943 ../src/guestfs-actions.pod:1251 ../src/guestfs-actions.pod:2085 ../src/guestfs-actions.pod:3305 ../src/guestfs-actions.pod:3334 ../src/guestfs-actions.pod:3395 ../src/guestfs-actions.pod:3422 ../src/guestfs-actions.pod:6872
7392 msgid "(Added in 1.0.2)"
7393 msgstr ""
7394
7395 #. type: =head2
7396 #: ../src/guestfs-actions.pod:945
7397 msgid "guestfs_checksum_device"
7398 msgstr ""
7399
7400 #. type: verbatim
7401 #: ../src/guestfs-actions.pod:947
7402 #, no-wrap
7403 msgid ""
7404 " char *\n"
7405 " guestfs_checksum_device (guestfs_h *g,\n"
7406 "                          const char *csumtype,\n"
7407 "                          const char *device);\n"
7408 "\n"
7409 msgstr ""
7410
7411 #. type: textblock
7412 #: ../src/guestfs-actions.pod:952
7413 msgid ""
7414 "This call computes the MD5, SHAx or CRC checksum of the contents of the "
7415 "device named C<device>.  For the types of checksums supported see the "
7416 "C<guestfs_checksum> command."
7417 msgstr ""
7418
7419 #. type: textblock
7420 #: ../src/guestfs-actions.pod:959 ../src/guestfs-actions.pod:4903 ../src/guestfs-actions.pod:4962 ../src/guestfs-actions.pod:4999 ../src/guestfs-actions.pod:5017 ../src/guestfs-actions.pod:5193 ../src/guestfs-actions.pod:6781 ../src/guestfs-actions.pod:6795 ../src/guestfs-actions.pod:7201
7421 msgid "(Added in 1.3.2)"
7422 msgstr ""
7423
7424 #. type: =head2
7425 #: ../src/guestfs-actions.pod:961
7426 msgid "guestfs_checksums_out"
7427 msgstr ""
7428
7429 #. type: verbatim
7430 #: ../src/guestfs-actions.pod:963
7431 #, no-wrap
7432 msgid ""
7433 " int\n"
7434 " guestfs_checksums_out (guestfs_h *g,\n"
7435 "                        const char *csumtype,\n"
7436 "                        const char *directory,\n"
7437 "                        const char *sumsfile);\n"
7438 "\n"
7439 msgstr ""
7440
7441 #. type: textblock
7442 #: ../src/guestfs-actions.pod:969 ../fish/guestfish-actions.pod:656
7443 msgid ""
7444 "This command computes the checksums of all regular files in C<directory> and "
7445 "then emits a list of those checksums to the local output file C<sumsfile>."
7446 msgstr ""
7447
7448 #. type: textblock
7449 #: ../src/guestfs-actions.pod:973 ../fish/guestfish-actions.pod:660
7450 msgid ""
7451 "This can be used for verifying the integrity of a virtual machine.  However "
7452 "to be properly secure you should pay attention to the output of the checksum "
7453 "command (it uses the ones from GNU coreutils).  In particular when the "
7454 "filename is not printable, coreutils uses a special backslash syntax.  For "
7455 "more information, see the GNU coreutils info file."
7456 msgstr ""
7457
7458 #. type: textblock
7459 #: ../src/guestfs-actions.pod:983
7460 msgid "(Added in 1.3.7)"
7461 msgstr ""
7462
7463 #. type: =head2
7464 #: ../src/guestfs-actions.pod:985
7465 msgid "guestfs_chmod"
7466 msgstr ""
7467
7468 #. type: verbatim
7469 #: ../src/guestfs-actions.pod:987
7470 #, no-wrap
7471 msgid ""
7472 " int\n"
7473 " guestfs_chmod (guestfs_h *g,\n"
7474 "                int mode,\n"
7475 "                const char *path);\n"
7476 "\n"
7477 msgstr ""
7478
7479 #. type: textblock
7480 #: ../src/guestfs-actions.pod:992 ../fish/guestfish-actions.pod:674
7481 msgid ""
7482 "Change the mode (permissions) of C<path> to C<mode>.  Only numeric modes are "
7483 "supported."
7484 msgstr ""
7485
7486 #. type: textblock
7487 #: ../src/guestfs-actions.pod:995 ../fish/guestfish-actions.pod:677
7488 msgid ""
7489 "I<Note>: When using this command from guestfish, C<mode> by default would be "
7490 "decimal, unless you prefix it with C<0> to get octal, ie. use C<0700> not "
7491 "C<700>."
7492 msgstr ""
7493
7494 #. type: textblock
7495 #: ../src/guestfs-actions.pod:999 ../src/guestfs-actions.pod:4389 ../src/guestfs-actions.pod:4586 ../src/guestfs-actions.pod:4605 ../src/guestfs-actions.pod:4624 ../fish/guestfish-actions.pod:681 ../fish/guestfish-actions.pod:2985 ../fish/guestfish-actions.pod:3114 ../fish/guestfish-actions.pod:3124 ../fish/guestfish-actions.pod:3134
7496 msgid "The mode actually set is affected by the umask."
7497 msgstr ""
7498
7499 #. type: =head2
7500 #: ../src/guestfs-actions.pod:1005
7501 msgid "guestfs_chown"
7502 msgstr ""
7503
7504 #. type: verbatim
7505 #: ../src/guestfs-actions.pod:1007
7506 #, no-wrap
7507 msgid ""
7508 " int\n"
7509 " guestfs_chown (guestfs_h *g,\n"
7510 "                int owner,\n"
7511 "                int group,\n"
7512 "                const char *path);\n"
7513 "\n"
7514 msgstr ""
7515
7516 #. type: textblock
7517 #: ../src/guestfs-actions.pod:1013 ../fish/guestfish-actions.pod:687
7518 msgid "Change the file owner to C<owner> and group to C<group>."
7519 msgstr ""
7520
7521 #. type: textblock
7522 #: ../src/guestfs-actions.pod:1015 ../src/guestfs-actions.pod:3497 ../fish/guestfish-actions.pod:689 ../fish/guestfish-actions.pod:2443
7523 msgid ""
7524 "Only numeric uid and gid are supported.  If you want to use names, you will "
7525 "need to locate and parse the password file yourself (Augeas support makes "
7526 "this relatively easy)."
7527 msgstr ""
7528
7529 #. type: =head2
7530 #: ../src/guestfs-actions.pod:1023
7531 msgid "guestfs_command"
7532 msgstr ""
7533
7534 #. type: verbatim
7535 #: ../src/guestfs-actions.pod:1025
7536 #, no-wrap
7537 msgid ""
7538 " char *\n"
7539 " guestfs_command (guestfs_h *g,\n"
7540 "                  char *const *arguments);\n"
7541 "\n"
7542 msgstr ""
7543
7544 #. type: textblock
7545 #: ../src/guestfs-actions.pod:1029 ../fish/guestfish-actions.pod:697
7546 msgid ""
7547 "This call runs a command from the guest filesystem.  The filesystem must be "
7548 "mounted, and must contain a compatible operating system (ie. something "
7549 "Linux, with the same or compatible processor architecture)."
7550 msgstr ""
7551
7552 #. type: textblock
7553 #: ../src/guestfs-actions.pod:1034
7554 msgid ""
7555 "The single parameter is an argv-style list of arguments.  The first element "
7556 "is the name of the program to run.  Subsequent elements are parameters.  The "
7557 "list must be non-empty (ie. must contain a program name).  Note that the "
7558 "command runs directly, and is I<not> invoked via the shell (see "
7559 "C<guestfs_sh>)."
7560 msgstr ""
7561
7562 #. type: textblock
7563 #: ../src/guestfs-actions.pod:1041 ../fish/guestfish-actions.pod:709
7564 msgid "The return value is anything printed to I<stdout> by the command."
7565 msgstr ""
7566
7567 #. type: textblock
7568 #: ../src/guestfs-actions.pod:1044 ../fish/guestfish-actions.pod:712
7569 msgid ""
7570 "If the command returns a non-zero exit status, then this function returns an "
7571 "error message.  The error message string is the content of I<stderr> from "
7572 "the command."
7573 msgstr ""
7574
7575 #. type: textblock
7576 #: ../src/guestfs-actions.pod:1048 ../fish/guestfish-actions.pod:716
7577 msgid ""
7578 "The C<$PATH> environment variable will contain at least C</usr/bin> and "
7579 "C</bin>.  If you require a program from another location, you should provide "
7580 "the full path in the first parameter."
7581 msgstr ""
7582
7583 #. type: textblock
7584 #: ../src/guestfs-actions.pod:1053 ../fish/guestfish-actions.pod:721
7585 msgid ""
7586 "Shared libraries and data files required by the program must be available on "
7587 "filesystems which are mounted in the correct places.  It is the caller's "
7588 "responsibility to ensure all filesystems that are needed are mounted at the "
7589 "right locations."
7590 msgstr ""
7591
7592 #. type: textblock
7593 #: ../src/guestfs-actions.pod:1065 ../src/guestfs-actions.pod:1085 ../src/guestfs-actions.pod:1550
7594 msgid "(Added in 0.9.1)"
7595 msgstr ""
7596
7597 #. type: =head2
7598 #: ../src/guestfs-actions.pod:1067
7599 msgid "guestfs_command_lines"
7600 msgstr ""
7601
7602 #. type: verbatim
7603 #: ../src/guestfs-actions.pod:1069
7604 #, no-wrap
7605 msgid ""
7606 " char **\n"
7607 " guestfs_command_lines (guestfs_h *g,\n"
7608 "                        char *const *arguments);\n"
7609 "\n"
7610 msgstr ""
7611
7612 #. type: textblock
7613 #: ../src/guestfs-actions.pod:1073
7614 msgid ""
7615 "This is the same as C<guestfs_command>, but splits the result into a list of "
7616 "lines."
7617 msgstr ""
7618
7619 #. type: textblock
7620 #: ../src/guestfs-actions.pod:1076
7621 msgid "See also: C<guestfs_sh_lines>"
7622 msgstr ""
7623
7624 #. type: =head2
7625 #: ../src/guestfs-actions.pod:1087
7626 msgid "guestfs_config"
7627 msgstr ""
7628
7629 #. type: verbatim
7630 #: ../src/guestfs-actions.pod:1089
7631 #, no-wrap
7632 msgid ""
7633 " int\n"
7634 " guestfs_config (guestfs_h *g,\n"
7635 "                 const char *qemuparam,\n"
7636 "                 const char *qemuvalue);\n"
7637 "\n"
7638 msgstr ""
7639
7640 #. type: textblock
7641 #: ../src/guestfs-actions.pod:1094 ../fish/guestfish-actions.pod:746
7642 msgid ""
7643 "This can be used to add arbitrary qemu command line parameters of the form "
7644 "I<-param value>.  Actually it's not quite arbitrary - we prevent you from "
7645 "setting some parameters which would interfere with parameters that we use."
7646 msgstr ""
7647
7648 #. type: textblock
7649 #: ../src/guestfs-actions.pod:1099 ../fish/guestfish-actions.pod:751
7650 msgid "The first character of C<param> string must be a C<-> (dash)."
7651 msgstr ""
7652
7653 #. type: textblock
7654 #: ../src/guestfs-actions.pod:1101 ../fish/guestfish-actions.pod:753
7655 msgid "C<value> can be NULL."
7656 msgstr ""
7657
7658 #. type: =head2
7659 #: ../src/guestfs-actions.pod:1107
7660 msgid "guestfs_copy_size"
7661 msgstr ""
7662
7663 #. type: verbatim
7664 #: ../src/guestfs-actions.pod:1109
7665 #, no-wrap
7666 msgid ""
7667 " int\n"
7668 " guestfs_copy_size (guestfs_h *g,\n"
7669 "                    const char *src,\n"
7670 "                    const char *dest,\n"
7671 "                    int64_t size);\n"
7672 "\n"
7673 msgstr ""
7674
7675 #. type: textblock
7676 #: ../src/guestfs-actions.pod:1115 ../fish/guestfish-actions.pod:759
7677 msgid ""
7678 "This command copies exactly C<size> bytes from one source device or file "
7679 "C<src> to another destination device or file C<dest>."
7680 msgstr ""
7681
7682 #. type: textblock
7683 #: ../src/guestfs-actions.pod:1118 ../fish/guestfish-actions.pod:762
7684 msgid ""
7685 "Note this will fail if the source is too short or if the destination is not "
7686 "large enough."
7687 msgstr ""
7688
7689 #. type: textblock
7690 #: ../src/guestfs-actions.pod:1123 ../src/guestfs-actions.pod:1246 ../src/guestfs-actions.pod:1277 ../src/guestfs-actions.pod:1322 ../src/guestfs-actions.pod:1699 ../src/guestfs-actions.pod:1721 ../src/guestfs-actions.pod:3478 ../src/guestfs-actions.pod:6867 ../src/guestfs-actions.pod:6901 ../src/guestfs-actions.pod:7387 ../src/guestfs-actions.pod:7406
7691 msgid ""
7692 "This long-running command can generate progress notification messages so "
7693 "that the caller can display a progress bar or indicator.  To receive these "
7694 "messages, the caller must register a progress event callback.  See "
7695 "L<guestfs(3)/GUESTFS_EVENT_PROGRESS>."
7696 msgstr ""
7697
7698 #. type: textblock
7699 #: ../src/guestfs-actions.pod:1128 ../src/guestfs-actions.pod:4165 ../src/guestfs-actions.pod:5399 ../src/guestfs-actions.pod:7108 ../src/guestfs-actions.pod:7128 ../src/guestfs-actions.pod:7214
7700 msgid "(Added in 1.0.87)"
7701 msgstr ""
7702
7703 #. type: =head2
7704 #: ../src/guestfs-actions.pod:1130
7705 msgid "guestfs_cp"
7706 msgstr ""
7707
7708 #. type: verbatim
7709 #: ../src/guestfs-actions.pod:1132
7710 #, no-wrap
7711 msgid ""
7712 " int\n"
7713 " guestfs_cp (guestfs_h *g,\n"
7714 "             const char *src,\n"
7715 "             const char *dest);\n"
7716 "\n"
7717 msgstr ""
7718
7719 #. type: textblock
7720 #: ../src/guestfs-actions.pod:1137 ../fish/guestfish-actions.pod:769
7721 msgid ""
7722 "This copies a file from C<src> to C<dest> where C<dest> is either a "
7723 "destination filename or destination directory."
7724 msgstr ""
7725
7726 #. type: textblock
7727 #: ../src/guestfs-actions.pod:1142 ../src/guestfs-actions.pod:1156 ../src/guestfs-actions.pod:1228 ../src/guestfs-actions.pod:1302 ../src/guestfs-actions.pod:1416 ../src/guestfs-actions.pod:4857 ../src/guestfs-actions.pod:5243
7728 msgid "(Added in 1.0.18)"
7729 msgstr ""
7730
7731 #. type: =head2
7732 #: ../src/guestfs-actions.pod:1144
7733 msgid "guestfs_cp_a"
7734 msgstr ""
7735
7736 #. type: verbatim
7737 #: ../src/guestfs-actions.pod:1146
7738 #, no-wrap
7739 msgid ""
7740 " int\n"
7741 " guestfs_cp_a (guestfs_h *g,\n"
7742 "               const char *src,\n"
7743 "               const char *dest);\n"
7744 "\n"
7745 msgstr ""
7746
7747 #. type: textblock
7748 #: ../src/guestfs-actions.pod:1151 ../fish/guestfish-actions.pod:776
7749 msgid ""
7750 "This copies a file or directory from C<src> to C<dest> recursively using the "
7751 "C<cp -a> command."
7752 msgstr ""
7753
7754 #. type: =head2
7755 #: ../src/guestfs-actions.pod:1158
7756 msgid "guestfs_dd"
7757 msgstr ""
7758
7759 #. type: verbatim
7760 #: ../src/guestfs-actions.pod:1160
7761 #, no-wrap
7762 msgid ""
7763 " int\n"
7764 " guestfs_dd (guestfs_h *g,\n"
7765 "             const char *src,\n"
7766 "             const char *dest);\n"
7767 "\n"
7768 msgstr ""
7769
7770 #. type: textblock
7771 #: ../src/guestfs-actions.pod:1165 ../fish/guestfish-actions.pod:783
7772 msgid ""
7773 "This command copies from one source device or file C<src> to another "
7774 "destination device or file C<dest>.  Normally you would use this to copy to "
7775 "or from a device or partition, for example to duplicate a filesystem."
7776 msgstr ""
7777
7778 #. type: textblock
7779 #: ../src/guestfs-actions.pod:1170
7780 msgid ""
7781 "If the destination is a device, it must be as large or larger than the "
7782 "source file or device, otherwise the copy will fail.  This command cannot do "
7783 "partial copies (see C<guestfs_copy_size>)."
7784 msgstr ""
7785
7786 #. type: =head2
7787 #: ../src/guestfs-actions.pod:1178
7788 msgid "guestfs_df"
7789 msgstr ""
7790
7791 #. type: verbatim
7792 #: ../src/guestfs-actions.pod:1180
7793 #, no-wrap
7794 msgid ""
7795 " char *\n"
7796 " guestfs_df (guestfs_h *g);\n"
7797 "\n"
7798 msgstr ""
7799
7800 #. type: textblock
7801 #: ../src/guestfs-actions.pod:1183 ../fish/guestfish-actions.pod:796
7802 msgid "This command runs the C<df> command to report disk space used."
7803 msgstr ""
7804
7805 #. type: textblock
7806 #: ../src/guestfs-actions.pod:1185 ../src/guestfs-actions.pod:1202
7807 msgid ""
7808 "This command is mostly useful for interactive sessions.  It is I<not> "
7809 "intended that you try to parse the output string.  Use C<guestfs_statvfs> "
7810 "from programs."
7811 msgstr ""
7812
7813 #. type: textblock
7814 #: ../src/guestfs-actions.pod:1192 ../src/guestfs-actions.pod:1209 ../src/guestfs-actions.pod:1327 ../src/guestfs-actions.pod:2288 ../src/guestfs-actions.pod:2312 ../src/guestfs-actions.pod:2380 ../src/guestfs-actions.pod:4275 ../src/guestfs-actions.pod:4757 ../src/guestfs-actions.pod:6605 ../src/guestfs-actions.pod:6629 ../src/guestfs-actions.pod:7254 ../src/guestfs-actions.pod:7267 ../src/guestfs-actions.pod:7280
7815 msgid "(Added in 1.0.54)"
7816 msgstr ""
7817
7818 #. type: =head2
7819 #: ../src/guestfs-actions.pod:1194
7820 msgid "guestfs_df_h"
7821 msgstr ""
7822
7823 #. type: verbatim
7824 #: ../src/guestfs-actions.pod:1196
7825 #, no-wrap
7826 msgid ""
7827 " char *\n"
7828 " guestfs_df_h (guestfs_h *g);\n"
7829 "\n"
7830 msgstr ""
7831
7832 #. type: textblock
7833 #: ../src/guestfs-actions.pod:1199 ../fish/guestfish-actions.pod:806
7834 msgid ""
7835 "This command runs the C<df -h> command to report disk space used in "
7836 "human-readable format."
7837 msgstr ""
7838
7839 #. type: =head2
7840 #: ../src/guestfs-actions.pod:1211
7841 msgid "guestfs_dmesg"
7842 msgstr ""
7843
7844 #. type: verbatim
7845 #: ../src/guestfs-actions.pod:1213
7846 #, no-wrap
7847 msgid ""
7848 " char *\n"
7849 " guestfs_dmesg (guestfs_h *g);\n"
7850 "\n"
7851 msgstr ""
7852
7853 #. type: textblock
7854 #: ../src/guestfs-actions.pod:1216 ../fish/guestfish-actions.pod:817
7855 msgid ""
7856 "This returns the kernel messages (C<dmesg> output) from the guest kernel.  "
7857 "This is sometimes useful for extended debugging of problems."
7858 msgstr ""
7859
7860 #. type: textblock
7861 #: ../src/guestfs-actions.pod:1220
7862 msgid ""
7863 "Another way to get the same information is to enable verbose messages with "
7864 "C<guestfs_set_verbose> or by setting the environment variable "
7865 "C<LIBGUESTFS_DEBUG=1> before running the program."
7866 msgstr ""
7867
7868 #. type: =head2
7869 #: ../src/guestfs-actions.pod:1230
7870 msgid "guestfs_download"
7871 msgstr ""
7872
7873 #. type: verbatim
7874 #: ../src/guestfs-actions.pod:1232
7875 #, no-wrap
7876 msgid ""
7877 " int\n"
7878 " guestfs_download (guestfs_h *g,\n"
7879 "                   const char *remotefilename,\n"
7880 "                   const char *filename);\n"
7881 "\n"
7882 msgstr ""
7883
7884 #. type: textblock
7885 #: ../src/guestfs-actions.pod:1237 ../src/guestfs-actions.pod:1262 ../fish/guestfish-actions.pod:830 ../fish/guestfish-actions.pod:843
7886 msgid ""
7887 "Download file C<remotefilename> and save it as C<filename> on the local "
7888 "machine."
7889 msgstr ""
7890
7891 #. type: textblock
7892 #: ../src/guestfs-actions.pod:1240 ../src/guestfs-actions.pod:6861 ../fish/guestfish-actions.pod:833 ../fish/guestfish-actions.pod:4636
7893 msgid "C<filename> can also be a named pipe."
7894 msgstr ""
7895
7896 #. type: textblock
7897 #: ../src/guestfs-actions.pod:1242
7898 msgid "See also C<guestfs_upload>, C<guestfs_cat>."
7899 msgstr ""
7900
7901 #. type: =head2
7902 #: ../src/guestfs-actions.pod:1253
7903 msgid "guestfs_download_offset"
7904 msgstr ""
7905
7906 #. type: verbatim
7907 #: ../src/guestfs-actions.pod:1255
7908 #, no-wrap
7909 msgid ""
7910 " int\n"
7911 " guestfs_download_offset (guestfs_h *g,\n"
7912 "                          const char *remotefilename,\n"
7913 "                          const char *filename,\n"
7914 "                          int64_t offset,\n"
7915 "                          int64_t size);\n"
7916 "\n"
7917 msgstr ""
7918
7919 #. type: textblock
7920 #: ../src/guestfs-actions.pod:1265 ../fish/guestfish-actions.pod:846
7921 msgid ""
7922 "C<remotefilename> is read for C<size> bytes starting at C<offset> (this "
7923 "region must be within the file or device)."
7924 msgstr ""
7925
7926 #. type: textblock
7927 #: ../src/guestfs-actions.pod:1268
7928 msgid ""
7929 "Note that there is no limit on the amount of data that can be downloaded "
7930 "with this call, unlike with C<guestfs_pread>, and this call always reads the "
7931 "full amount unless an error occurs."
7932 msgstr ""
7933
7934 #. type: textblock
7935 #: ../src/guestfs-actions.pod:1273
7936 msgid "See also C<guestfs_download>, C<guestfs_pread>."
7937 msgstr ""
7938
7939 #. type: textblock
7940 #: ../src/guestfs-actions.pod:1282 ../src/guestfs-actions.pod:6906
7941 msgid "(Added in 1.5.17)"
7942 msgstr ""
7943
7944 #. type: =head2
7945 #: ../src/guestfs-actions.pod:1284
7946 msgid "guestfs_drop_caches"
7947 msgstr ""
7948
7949 #. type: verbatim
7950 #: ../src/guestfs-actions.pod:1286
7951 #, no-wrap
7952 msgid ""
7953 " int\n"
7954 " guestfs_drop_caches (guestfs_h *g,\n"
7955 "                      int whattodrop);\n"
7956 "\n"
7957 msgstr ""
7958
7959 #. type: textblock
7960 #: ../src/guestfs-actions.pod:1290 ../fish/guestfish-actions.pod:862
7961 msgid ""
7962 "This instructs the guest kernel to drop its page cache, and/or dentries and "
7963 "inode caches.  The parameter C<whattodrop> tells the kernel what precisely "
7964 "to drop, see L<http://linux-mm.org/Drop_Caches>"
7965 msgstr ""
7966
7967 #. type: textblock
7968 #: ../src/guestfs-actions.pod:1295 ../fish/guestfish-actions.pod:867
7969 msgid "Setting C<whattodrop> to 3 should drop everything."
7970 msgstr ""
7971
7972 #. type: textblock
7973 #: ../src/guestfs-actions.pod:1297 ../fish/guestfish-actions.pod:869
7974 msgid ""
7975 "This automatically calls L<sync(2)> before the operation, so that the "
7976 "maximum guest memory is freed."
7977 msgstr ""
7978
7979 #. type: =head2
7980 #: ../src/guestfs-actions.pod:1304
7981 msgid "guestfs_du"
7982 msgstr ""
7983
7984 #. type: verbatim
7985 #: ../src/guestfs-actions.pod:1306
7986 #, no-wrap
7987 msgid ""
7988 " int64_t\n"
7989 " guestfs_du (guestfs_h *g,\n"
7990 "             const char *path);\n"
7991 "\n"
7992 msgstr ""
7993
7994 #. type: textblock
7995 #: ../src/guestfs-actions.pod:1310 ../fish/guestfish-actions.pod:876
7996 msgid ""
7997 "This command runs the C<du -s> command to estimate file space usage for "
7998 "C<path>."
7999 msgstr ""
8000
8001 #. type: textblock
8002 #: ../src/guestfs-actions.pod:1313 ../fish/guestfish-actions.pod:879
8003 msgid ""
8004 "C<path> can be a file or a directory.  If C<path> is a directory then the "
8005 "estimate includes the contents of the directory and all subdirectories "
8006 "(recursively)."
8007 msgstr ""
8008
8009 #. type: textblock
8010 #: ../src/guestfs-actions.pod:1317 ../fish/guestfish-actions.pod:883
8011 msgid "The result is the estimated size in I<kilobytes> (ie. units of 1024 bytes)."
8012 msgstr ""
8013
8014 #. type: =head2
8015 #: ../src/guestfs-actions.pod:1329
8016 msgid "guestfs_e2fsck_f"
8017 msgstr ""
8018
8019 #. type: verbatim
8020 #: ../src/guestfs-actions.pod:1331
8021 #, no-wrap
8022 msgid ""
8023 " int\n"
8024 " guestfs_e2fsck_f (guestfs_h *g,\n"
8025 "                   const char *device);\n"
8026 "\n"
8027 msgstr ""
8028
8029 #. type: textblock
8030 #: ../src/guestfs-actions.pod:1335 ../fish/guestfish-actions.pod:890
8031 msgid ""
8032 "This runs C<e2fsck -p -f device>, ie. runs the ext2/ext3 filesystem checker "
8033 "on C<device>, noninteractively (I<-p>), even if the filesystem appears to be "
8034 "clean (I<-f>)."
8035 msgstr ""
8036
8037 #. type: textblock
8038 #: ../src/guestfs-actions.pod:1339
8039 msgid ""
8040 "This command is only needed because of C<guestfs_resize2fs> (q.v.).  "
8041 "Normally you should use C<guestfs_fsck>."
8042 msgstr ""
8043
8044 #. type: textblock
8045 #: ../src/guestfs-actions.pod:1344
8046 msgid "(Added in 1.0.29)"
8047 msgstr ""
8048
8049 #. type: =head2
8050 #: ../src/guestfs-actions.pod:1346
8051 msgid "guestfs_echo_daemon"
8052 msgstr ""
8053
8054 #. type: verbatim
8055 #: ../src/guestfs-actions.pod:1348
8056 #, no-wrap
8057 msgid ""
8058 " char *\n"
8059 " guestfs_echo_daemon (guestfs_h *g,\n"
8060 "                      char *const *words);\n"
8061 "\n"
8062 msgstr ""
8063
8064 #. type: textblock
8065 #: ../src/guestfs-actions.pod:1352 ../fish/guestfish-actions.pod:901
8066 msgid ""
8067 "This command concatenates the list of C<words> passed with single spaces "
8068 "between them and returns the resulting string."
8069 msgstr ""
8070
8071 #. type: textblock
8072 #: ../src/guestfs-actions.pod:1355 ../fish/guestfish-actions.pod:904
8073 msgid "You can use this command to test the connection through to the daemon."
8074 msgstr ""
8075
8076 #. type: textblock
8077 #: ../src/guestfs-actions.pod:1357
8078 msgid "See also C<guestfs_ping_daemon>."
8079 msgstr ""
8080
8081 #. type: textblock
8082 #: ../src/guestfs-actions.pod:1362 ../src/guestfs-actions.pod:2096 ../src/guestfs-actions.pod:6077
8083 msgid "(Added in 1.0.69)"
8084 msgstr ""
8085
8086 #. type: =head2
8087 #: ../src/guestfs-actions.pod:1364
8088 msgid "guestfs_egrep"
8089 msgstr ""
8090
8091 #. type: verbatim
8092 #: ../src/guestfs-actions.pod:1366
8093 #, no-wrap
8094 msgid ""
8095 " char **\n"
8096 " guestfs_egrep (guestfs_h *g,\n"
8097 "                const char *regex,\n"
8098 "                const char *path);\n"
8099 "\n"
8100 msgstr ""
8101
8102 #. type: textblock
8103 #: ../src/guestfs-actions.pod:1371 ../fish/guestfish-actions.pod:912
8104 msgid "This calls the external C<egrep> program and returns the matching lines."
8105 msgstr ""
8106
8107 #. type: textblock
8108 #: ../src/guestfs-actions.pod:1381 ../src/guestfs-actions.pod:1400 ../src/guestfs-actions.pod:1457 ../src/guestfs-actions.pod:1503 ../src/guestfs-actions.pod:1522 ../src/guestfs-actions.pod:2226 ../src/guestfs-actions.pod:2245 ../src/guestfs-actions.pod:2401 ../src/guestfs-actions.pod:2414 ../src/guestfs-actions.pod:2429 ../src/guestfs-actions.pod:2475 ../src/guestfs-actions.pod:2497 ../src/guestfs-actions.pod:2510 ../src/guestfs-actions.pod:3658 ../src/guestfs-actions.pod:3672 ../src/guestfs-actions.pod:3685 ../src/guestfs-actions.pod:3699 ../src/guestfs-actions.pod:4685 ../src/guestfs-actions.pod:5577 ../src/guestfs-actions.pod:5626 ../src/guestfs-actions.pod:6473 ../src/guestfs-actions.pod:6485 ../src/guestfs-actions.pod:6498 ../src/guestfs-actions.pod:6511 ../src/guestfs-actions.pod:6533 ../src/guestfs-actions.pod:6546 ../src/guestfs-actions.pod:6559 ../src/guestfs-actions.pod:6572 ../src/guestfs-actions.pod:7350 ../src/guestfs-actions.pod:7369 ../src/guestfs-actions.pod:7454 ../src/guestfs-actions.pod:7473 ../src/guestfs-actions.pod:7519 ../src/guestfs-actions.pod:7538
8109 msgid "(Added in 1.0.66)"
8110 msgstr ""
8111
8112 #. type: =head2
8113 #: ../src/guestfs-actions.pod:1383
8114 msgid "guestfs_egrepi"
8115 msgstr ""
8116
8117 #. type: verbatim
8118 #: ../src/guestfs-actions.pod:1385
8119 #, no-wrap
8120 msgid ""
8121 " char **\n"
8122 " guestfs_egrepi (guestfs_h *g,\n"
8123 "                 const char *regex,\n"
8124 "                 const char *path);\n"
8125 "\n"
8126 msgstr ""
8127
8128 #. type: textblock
8129 #: ../src/guestfs-actions.pod:1390 ../fish/guestfish-actions.pod:922
8130 msgid "This calls the external C<egrep -i> program and returns the matching lines."
8131 msgstr ""
8132
8133 #. type: =head2
8134 #: ../src/guestfs-actions.pod:1402
8135 msgid "guestfs_equal"
8136 msgstr ""
8137
8138 #. type: verbatim
8139 #: ../src/guestfs-actions.pod:1404
8140 #, no-wrap
8141 msgid ""
8142 " int\n"
8143 " guestfs_equal (guestfs_h *g,\n"
8144 "                const char *file1,\n"
8145 "                const char *file2);\n"
8146 "\n"
8147 msgstr ""
8148
8149 #. type: textblock
8150 #: ../src/guestfs-actions.pod:1409 ../fish/guestfish-actions.pod:932
8151 msgid ""
8152 "This compares the two files C<file1> and C<file2> and returns true if their "
8153 "content is exactly equal, or false otherwise."
8154 msgstr ""
8155
8156 #. type: textblock
8157 #: ../src/guestfs-actions.pod:1412 ../fish/guestfish-actions.pod:935
8158 msgid "The external L<cmp(1)> program is used for the comparison."
8159 msgstr ""
8160
8161 #. type: =head2
8162 #: ../src/guestfs-actions.pod:1418
8163 msgid "guestfs_exists"
8164 msgstr ""
8165
8166 #. type: verbatim
8167 #: ../src/guestfs-actions.pod:1420
8168 #, no-wrap
8169 msgid ""
8170 " int\n"
8171 " guestfs_exists (guestfs_h *g,\n"
8172 "                 const char *path);\n"
8173 "\n"
8174 msgstr ""
8175
8176 #. type: textblock
8177 #: ../src/guestfs-actions.pod:1424 ../fish/guestfish-actions.pod:941
8178 msgid ""
8179 "This returns C<true> if and only if there is a file, directory (or anything) "
8180 "with the given C<path> name."
8181 msgstr ""
8182
8183 #. type: textblock
8184 #: ../src/guestfs-actions.pod:1427
8185 msgid "See also C<guestfs_is_file>, C<guestfs_is_dir>, C<guestfs_stat>."
8186 msgstr ""
8187
8188 #. type: =head2
8189 #: ../src/guestfs-actions.pod:1433
8190 msgid "guestfs_fallocate"
8191 msgstr ""
8192
8193 #. type: verbatim
8194 #: ../src/guestfs-actions.pod:1435
8195 #, no-wrap
8196 msgid ""
8197 " int\n"
8198 " guestfs_fallocate (guestfs_h *g,\n"
8199 "                    const char *path,\n"
8200 "                    int len);\n"
8201 "\n"
8202 msgstr ""
8203
8204 #. type: textblock
8205 #: ../src/guestfs-actions.pod:1440 ../src/guestfs-actions.pod:1466 ../fish/guestfish-actions.pod:950 ../fish/guestfish-actions.pod:969
8206 msgid ""
8207 "This command preallocates a file (containing zero bytes) named C<path> of "
8208 "size C<len> bytes.  If the file exists already, it is overwritten."
8209 msgstr ""
8210
8211 #. type: textblock
8212 #: ../src/guestfs-actions.pod:1444 ../fish/guestfish-actions.pod:954
8213 msgid ""
8214 "Do not confuse this with the guestfish-specific C<alloc> command which "
8215 "allocates a file in the host and attaches it as a device."
8216 msgstr ""
8217
8218 #. type: textblock
8219 #: ../src/guestfs-actions.pod:1450
8220 msgid ""
8221 "This function is deprecated.  In new code, use the L</guestfs_fallocate64> "
8222 "call instead."
8223 msgstr ""
8224
8225 #. type: =head2
8226 #: ../src/guestfs-actions.pod:1459
8227 msgid "guestfs_fallocate64"
8228 msgstr ""
8229
8230 #. type: verbatim
8231 #: ../src/guestfs-actions.pod:1461
8232 #, no-wrap
8233 msgid ""
8234 " int\n"
8235 " guestfs_fallocate64 (guestfs_h *g,\n"
8236 "                      const char *path,\n"
8237 "                      int64_t len);\n"
8238 "\n"
8239 msgstr ""
8240
8241 #. type: textblock
8242 #: ../src/guestfs-actions.pod:1470
8243 msgid ""
8244 "Note that this call allocates disk blocks for the file.  To create a sparse "
8245 "file use C<guestfs_truncate_size> instead."
8246 msgstr ""
8247
8248 #. type: textblock
8249 #: ../src/guestfs-actions.pod:1473
8250 msgid ""
8251 "The deprecated call C<guestfs_fallocate> does the same, but owing to an "
8252 "oversight it only allowed 30 bit lengths to be specified, effectively "
8253 "limiting the maximum size of files created through that call to 1GB."
8254 msgstr ""
8255
8256 #. type: textblock
8257 #: ../src/guestfs-actions.pod:1478 ../fish/guestfish-actions.pod:981
8258 msgid ""
8259 "Do not confuse this with the guestfish-specific C<alloc> and C<sparse> "
8260 "commands which create a file in the host and attach it as a device."
8261 msgstr ""
8262
8263 #. type: textblock
8264 #: ../src/guestfs-actions.pod:1484
8265 msgid "(Added in 1.3.17)"
8266 msgstr ""
8267
8268 #. type: =head2
8269 #: ../src/guestfs-actions.pod:1486
8270 msgid "guestfs_fgrep"
8271 msgstr ""
8272
8273 #. type: verbatim
8274 #: ../src/guestfs-actions.pod:1488
8275 #, no-wrap
8276 msgid ""
8277 " char **\n"
8278 " guestfs_fgrep (guestfs_h *g,\n"
8279 "                const char *pattern,\n"
8280 "                const char *path);\n"
8281 "\n"
8282 msgstr ""
8283
8284 #. type: textblock
8285 #: ../src/guestfs-actions.pod:1493 ../fish/guestfish-actions.pod:989
8286 msgid "This calls the external C<fgrep> program and returns the matching lines."
8287 msgstr ""
8288
8289 #. type: =head2
8290 #: ../src/guestfs-actions.pod:1505
8291 msgid "guestfs_fgrepi"
8292 msgstr ""
8293
8294 #. type: verbatim
8295 #: ../src/guestfs-actions.pod:1507
8296 #, no-wrap
8297 msgid ""
8298 " char **\n"
8299 " guestfs_fgrepi (guestfs_h *g,\n"
8300 "                 const char *pattern,\n"
8301 "                 const char *path);\n"
8302 "\n"
8303 msgstr ""
8304
8305 #. type: textblock
8306 #: ../src/guestfs-actions.pod:1512 ../fish/guestfish-actions.pod:999
8307 msgid "This calls the external C<fgrep -i> program and returns the matching lines."
8308 msgstr ""
8309
8310 #. type: =head2
8311 #: ../src/guestfs-actions.pod:1524
8312 msgid "guestfs_file"
8313 msgstr ""
8314
8315 #. type: verbatim
8316 #: ../src/guestfs-actions.pod:1526
8317 #, no-wrap
8318 msgid ""
8319 " char *\n"
8320 " guestfs_file (guestfs_h *g,\n"
8321 "               const char *path);\n"
8322 "\n"
8323 msgstr ""
8324
8325 #. type: textblock
8326 #: ../src/guestfs-actions.pod:1530 ../fish/guestfish-actions.pod:1009
8327 msgid ""
8328 "This call uses the standard L<file(1)> command to determine the type or "
8329 "contents of the file."
8330 msgstr ""
8331
8332 #. type: textblock
8333 #: ../src/guestfs-actions.pod:1533 ../fish/guestfish-actions.pod:1012
8334 msgid ""
8335 "This call will also transparently look inside various types of compressed "
8336 "file."
8337 msgstr ""
8338
8339 #. type: textblock
8340 #: ../src/guestfs-actions.pod:1536 ../fish/guestfish-actions.pod:1015
8341 msgid ""
8342 "The exact command which runs is C<file -zb path>.  Note in particular that "
8343 "the filename is not prepended to the output (the I<-b> option)."
8344 msgstr ""
8345
8346 #. type: textblock
8347 #: ../src/guestfs-actions.pod:1540 ../fish/guestfish-actions.pod:1019
8348 msgid ""
8349 "The output depends on the output of the underlying L<file(1)> command and it "
8350 "can change in future in ways beyond our control.  In other words, the output "
8351 "is not guaranteed by the ABI."
8352 msgstr ""
8353
8354 #. type: textblock
8355 #: ../src/guestfs-actions.pod:1544
8356 msgid ""
8357 "See also: L<file(1)>, C<guestfs_vfs_type>, C<guestfs_lstat>, "
8358 "C<guestfs_is_file>, C<guestfs_is_blockdev> (etc)."
8359 msgstr ""
8360
8361 #. type: =head2
8362 #: ../src/guestfs-actions.pod:1552
8363 msgid "guestfs_file_architecture"
8364 msgstr ""
8365
8366 #. type: verbatim
8367 #: ../src/guestfs-actions.pod:1554
8368 #, no-wrap
8369 msgid ""
8370 " char *\n"
8371 " guestfs_file_architecture (guestfs_h *g,\n"
8372 "                            const char *filename);\n"
8373 "\n"
8374 msgstr ""
8375
8376 #. type: textblock
8377 #: ../src/guestfs-actions.pod:1558 ../fish/guestfish-actions.pod:1030
8378 msgid ""
8379 "This detects the architecture of the binary C<filename>, and returns it if "
8380 "known."
8381 msgstr ""
8382
8383 #. type: textblock
8384 #: ../src/guestfs-actions.pod:1561 ../fish/guestfish-actions.pod:1033
8385 msgid "Currently defined architectures are:"
8386 msgstr ""
8387
8388 #. type: =item
8389 #: ../src/guestfs-actions.pod:1565 ../fish/guestfish-actions.pod:1037
8390 msgid "\"i386\""
8391 msgstr ""
8392
8393 #. type: textblock
8394 #: ../src/guestfs-actions.pod:1567 ../fish/guestfish-actions.pod:1039
8395 msgid ""
8396 "This string is returned for all 32 bit i386, i486, i586, i686 binaries "
8397 "irrespective of the precise processor requirements of the binary."
8398 msgstr ""
8399
8400 #. type: =item
8401 #: ../src/guestfs-actions.pod:1570 ../fish/guestfish-actions.pod:1042
8402 msgid "\"x86_64\""
8403 msgstr ""
8404
8405 #. type: textblock
8406 #: ../src/guestfs-actions.pod:1572 ../fish/guestfish-actions.pod:1044
8407 msgid "64 bit x86-64."
8408 msgstr ""
8409
8410 #. type: =item
8411 #: ../src/guestfs-actions.pod:1574 ../fish/guestfish-actions.pod:1046
8412 msgid "\"sparc\""
8413 msgstr ""
8414
8415 #. type: textblock
8416 #: ../src/guestfs-actions.pod:1576 ../fish/guestfish-actions.pod:1048
8417 msgid "32 bit SPARC."
8418 msgstr ""
8419
8420 #. type: =item
8421 #: ../src/guestfs-actions.pod:1578 ../fish/guestfish-actions.pod:1050
8422 msgid "\"sparc64\""
8423 msgstr ""
8424
8425 #. type: textblock
8426 #: ../src/guestfs-actions.pod:1580 ../fish/guestfish-actions.pod:1052
8427 msgid "64 bit SPARC V9 and above."
8428 msgstr ""
8429
8430 #. type: =item
8431 #: ../src/guestfs-actions.pod:1582 ../fish/guestfish-actions.pod:1054
8432 msgid "\"ia64\""
8433 msgstr ""
8434
8435 #. type: textblock
8436 #: ../src/guestfs-actions.pod:1584 ../fish/guestfish-actions.pod:1056
8437 msgid "Intel Itanium."
8438 msgstr ""
8439
8440 #. type: =item
8441 #: ../src/guestfs-actions.pod:1586 ../fish/guestfish-actions.pod:1058
8442 msgid "\"ppc\""
8443 msgstr ""
8444
8445 #. type: textblock
8446 #: ../src/guestfs-actions.pod:1588 ../fish/guestfish-actions.pod:1060
8447 msgid "32 bit Power PC."
8448 msgstr ""
8449
8450 #. type: =item
8451 #: ../src/guestfs-actions.pod:1590 ../fish/guestfish-actions.pod:1062
8452 msgid "\"ppc64\""
8453 msgstr ""
8454
8455 #. type: textblock
8456 #: ../src/guestfs-actions.pod:1592 ../fish/guestfish-actions.pod:1064
8457 msgid "64 bit Power PC."
8458 msgstr ""
8459
8460 #. type: textblock
8461 #: ../src/guestfs-actions.pod:1596 ../fish/guestfish-actions.pod:1068
8462 msgid "Libguestfs may return other architecture strings in future."
8463 msgstr ""
8464
8465 #. type: textblock
8466 #: ../src/guestfs-actions.pod:1598 ../fish/guestfish-actions.pod:1070
8467 msgid "The function works on at least the following types of files:"
8468 msgstr ""
8469
8470 #. type: textblock
8471 #: ../src/guestfs-actions.pod:1604 ../fish/guestfish-actions.pod:1076
8472 msgid "many types of Un*x and Linux binary"
8473 msgstr ""
8474
8475 #. type: textblock
8476 #: ../src/guestfs-actions.pod:1608 ../fish/guestfish-actions.pod:1080
8477 msgid "many types of Un*x and Linux shared library"
8478 msgstr ""
8479
8480 #. type: textblock
8481 #: ../src/guestfs-actions.pod:1612 ../fish/guestfish-actions.pod:1084
8482 msgid "Windows Win32 and Win64 binaries"
8483 msgstr ""
8484
8485 #. type: textblock
8486 #: ../src/guestfs-actions.pod:1616 ../fish/guestfish-actions.pod:1088
8487 msgid "Windows Win32 and Win64 DLLs"
8488 msgstr ""
8489
8490 #. type: textblock
8491 #: ../src/guestfs-actions.pod:1618 ../fish/guestfish-actions.pod:1090
8492 msgid "Win32 binaries and DLLs return C<i386>."
8493 msgstr ""
8494
8495 #. type: textblock
8496 #: ../src/guestfs-actions.pod:1620 ../fish/guestfish-actions.pod:1092
8497 msgid "Win64 binaries and DLLs return C<x86_64>."
8498 msgstr ""
8499
8500 #. type: textblock
8501 #: ../src/guestfs-actions.pod:1624 ../fish/guestfish-actions.pod:1096
8502 msgid "Linux kernel modules"
8503 msgstr ""
8504
8505 #. type: textblock
8506 #: ../src/guestfs-actions.pod:1628 ../fish/guestfish-actions.pod:1100
8507 msgid "Linux new-style initrd images"
8508 msgstr ""
8509
8510 #. type: textblock
8511 #: ../src/guestfs-actions.pod:1632 ../fish/guestfish-actions.pod:1104
8512 msgid "some non-x86 Linux vmlinuz kernels"
8513 msgstr ""
8514
8515 #. type: textblock
8516 #: ../src/guestfs-actions.pod:1636 ../fish/guestfish-actions.pod:1108
8517 msgid "What it can't do currently:"
8518 msgstr ""
8519
8520 #. type: textblock
8521 #: ../src/guestfs-actions.pod:1642 ../fish/guestfish-actions.pod:1114
8522 msgid "static libraries (libfoo.a)"
8523 msgstr ""
8524
8525 #. type: textblock
8526 #: ../src/guestfs-actions.pod:1646 ../fish/guestfish-actions.pod:1118
8527 msgid "Linux old-style initrd as compressed ext2 filesystem (RHEL 3)"
8528 msgstr ""
8529
8530 #. type: textblock
8531 #: ../src/guestfs-actions.pod:1650 ../fish/guestfish-actions.pod:1122
8532 msgid "x86 Linux vmlinuz kernels"
8533 msgstr ""
8534
8535 #. type: textblock
8536 #: ../src/guestfs-actions.pod:1652 ../fish/guestfish-actions.pod:1124
8537 msgid ""
8538 "x86 vmlinuz images (bzImage format) consist of a mix of 16-, 32- and "
8539 "compressed code, and are horribly hard to unpack.  If you want to find the "
8540 "architecture of a kernel, use the architecture of the associated initrd or "
8541 "kernel module(s) instead."
8542 msgstr ""
8543
8544 #. type: textblock
8545 #: ../src/guestfs-actions.pod:1662 ../src/guestfs-actions.pod:1825 ../src/guestfs-actions.pod:1842 ../src/guestfs-actions.pod:2533 ../src/guestfs-actions.pod:2626 ../src/guestfs-actions.pod:2696 ../src/guestfs-actions.pod:2784 ../src/guestfs-actions.pod:2805 ../src/guestfs-actions.pod:2848 ../src/guestfs-actions.pod:2932 ../src/guestfs-actions.pod:3029 ../src/guestfs-actions.pod:3276 ../src/guestfs-actions.pod:3408
8546 msgid "(Added in 1.5.3)"
8547 msgstr ""
8548
8549 #. type: =head2
8550 #: ../src/guestfs-actions.pod:1664
8551 msgid "guestfs_filesize"
8552 msgstr ""
8553
8554 #. type: verbatim
8555 #: ../src/guestfs-actions.pod:1666
8556 #, no-wrap
8557 msgid ""
8558 " int64_t\n"
8559 " guestfs_filesize (guestfs_h *g,\n"
8560 "                   const char *file);\n"
8561 "\n"
8562 msgstr ""
8563
8564 #. type: textblock
8565 #: ../src/guestfs-actions.pod:1670 ../fish/guestfish-actions.pod:1135
8566 msgid "This command returns the size of C<file> in bytes."
8567 msgstr ""
8568
8569 #. type: textblock
8570 #: ../src/guestfs-actions.pod:1672
8571 msgid ""
8572 "To get other stats about a file, use C<guestfs_stat>, C<guestfs_lstat>, "
8573 "C<guestfs_is_dir>, C<guestfs_is_file> etc.  To get the size of block "
8574 "devices, use C<guestfs_blockdev_getsize64>."
8575 msgstr ""
8576
8577 #. type: textblock
8578 #: ../src/guestfs-actions.pod:1678
8579 msgid "(Added in 1.0.82)"
8580 msgstr ""
8581
8582 #. type: =head2
8583 #: ../src/guestfs-actions.pod:1680
8584 msgid "guestfs_fill"
8585 msgstr ""
8586
8587 #. type: verbatim
8588 #: ../src/guestfs-actions.pod:1682
8589 #, no-wrap
8590 msgid ""
8591 " int\n"
8592 " guestfs_fill (guestfs_h *g,\n"
8593 "               int c,\n"
8594 "               int len,\n"
8595 "               const char *path);\n"
8596 "\n"
8597 msgstr ""
8598
8599 #. type: textblock
8600 #: ../src/guestfs-actions.pod:1688 ../fish/guestfish-actions.pod:1145
8601 msgid ""
8602 "This command creates a new file called C<path>.  The initial content of the "
8603 "file is C<len> octets of C<c>, where C<c> must be a number in the range "
8604 "C<[0..255]>."
8605 msgstr ""
8606
8607 #. type: textblock
8608 #: ../src/guestfs-actions.pod:1692
8609 msgid ""
8610 "To fill a file with zero bytes (sparsely), it is much more efficient to use "
8611 "C<guestfs_truncate_size>.  To create a file with a pattern of repeating "
8612 "bytes use C<guestfs_fill_pattern>."
8613 msgstr ""
8614
8615 #. type: textblock
8616 #: ../src/guestfs-actions.pod:1704
8617 msgid "(Added in 1.0.79)"
8618 msgstr ""
8619
8620 #. type: =head2
8621 #: ../src/guestfs-actions.pod:1706
8622 msgid "guestfs_fill_pattern"
8623 msgstr ""
8624
8625 #. type: verbatim
8626 #: ../src/guestfs-actions.pod:1708
8627 #, no-wrap
8628 msgid ""
8629 " int\n"
8630 " guestfs_fill_pattern (guestfs_h *g,\n"
8631 "                       const char *pattern,\n"
8632 "                       int len,\n"
8633 "                       const char *path);\n"
8634 "\n"
8635 msgstr ""
8636
8637 #. type: textblock
8638 #: ../src/guestfs-actions.pod:1714
8639 msgid ""
8640 "This function is like C<guestfs_fill> except that it creates a new file of "
8641 "length C<len> containing the repeating pattern of bytes in C<pattern>.  The "
8642 "pattern is truncated if necessary to ensure the length of the file is "
8643 "exactly C<len> bytes."
8644 msgstr ""
8645
8646 #. type: textblock
8647 #: ../src/guestfs-actions.pod:1726
8648 msgid "(Added in 1.3.12)"
8649 msgstr ""
8650
8651 #. type: =head2
8652 #: ../src/guestfs-actions.pod:1728
8653 msgid "guestfs_find"
8654 msgstr ""
8655
8656 #. type: verbatim
8657 #: ../src/guestfs-actions.pod:1730
8658 #, no-wrap
8659 msgid ""
8660 " char **\n"
8661 " guestfs_find (guestfs_h *g,\n"
8662 "               const char *directory);\n"
8663 "\n"
8664 msgstr ""
8665
8666 #. type: textblock
8667 #: ../src/guestfs-actions.pod:1734 ../fish/guestfish-actions.pod:1167
8668 msgid ""
8669 "This command lists out all files and directories, recursively, starting at "
8670 "C<directory>.  It is essentially equivalent to running the shell command "
8671 "C<find directory -print> but some post-processing happens on the output, "
8672 "described below."
8673 msgstr ""
8674
8675 #. type: textblock
8676 #: ../src/guestfs-actions.pod:1739 ../fish/guestfish-actions.pod:1172
8677 msgid ""
8678 "This returns a list of strings I<without any prefix>.  Thus if the directory "
8679 "structure was:"
8680 msgstr ""
8681
8682 #. type: verbatim
8683 #: ../src/guestfs-actions.pod:1742 ../fish/guestfish-actions.pod:1175
8684 #, no-wrap
8685 msgid ""
8686 " /tmp/a\n"
8687 " /tmp/b\n"
8688 " /tmp/c/d\n"
8689 "\n"
8690 msgstr ""
8691
8692 #. type: textblock
8693 #: ../src/guestfs-actions.pod:1746
8694 msgid "then the returned list from C<guestfs_find> C</tmp> would be 4 elements:"
8695 msgstr ""
8696
8697 #. type: verbatim
8698 #: ../src/guestfs-actions.pod:1749 ../fish/guestfish-actions.pod:1182
8699 #, no-wrap
8700 msgid ""
8701 " a\n"
8702 " b\n"
8703 " c\n"
8704 " c/d\n"
8705 "\n"
8706 msgstr ""
8707
8708 #. type: textblock
8709 #: ../src/guestfs-actions.pod:1754 ../fish/guestfish-actions.pod:1187
8710 msgid "If C<directory> is not a directory, then this command returns an error."
8711 msgstr ""
8712
8713 #. type: textblock
8714 #: ../src/guestfs-actions.pod:1757 ../fish/guestfish-actions.pod:1190
8715 msgid "The returned list is sorted."
8716 msgstr ""
8717
8718 #. type: textblock
8719 #: ../src/guestfs-actions.pod:1759
8720 msgid "See also C<guestfs_find0>."
8721 msgstr ""
8722
8723 #. type: textblock
8724 #: ../src/guestfs-actions.pod:1768 ../src/guestfs-actions.pod:4102 ../src/guestfs-actions.pod:5661
8725 msgid "(Added in 1.0.27)"
8726 msgstr ""
8727
8728 #. type: =head2
8729 #: ../src/guestfs-actions.pod:1770
8730 msgid "guestfs_find0"
8731 msgstr ""
8732
8733 #. type: verbatim
8734 #: ../src/guestfs-actions.pod:1772
8735 #, no-wrap
8736 msgid ""
8737 " int\n"
8738 " guestfs_find0 (guestfs_h *g,\n"
8739 "                const char *directory,\n"
8740 "                const char *files);\n"
8741 "\n"
8742 msgstr ""
8743
8744 #. type: textblock
8745 #: ../src/guestfs-actions.pod:1777 ../fish/guestfish-actions.pod:1201
8746 msgid ""
8747 "This command lists out all files and directories, recursively, starting at "
8748 "C<directory>, placing the resulting list in the external file called "
8749 "C<files>."
8750 msgstr ""
8751
8752 #. type: textblock
8753 #: ../src/guestfs-actions.pod:1781
8754 msgid ""
8755 "This command works the same way as C<guestfs_find> with the following "
8756 "exceptions:"
8757 msgstr ""
8758
8759 #. type: textblock
8760 #: ../src/guestfs-actions.pod:1788 ../fish/guestfish-actions.pod:1212
8761 msgid "The resulting list is written to an external file."
8762 msgstr ""
8763
8764 #. type: textblock
8765 #: ../src/guestfs-actions.pod:1792 ../fish/guestfish-actions.pod:1216
8766 msgid ""
8767 "Items (filenames) in the result are separated by C<\\0> characters.  See "
8768 "L<find(1)> option I<-print0>."
8769 msgstr ""
8770
8771 #. type: textblock
8772 #: ../src/guestfs-actions.pod:1797 ../fish/guestfish-actions.pod:1221
8773 msgid "This command is not limited in the number of names that it can return."
8774 msgstr ""
8775
8776 #. type: textblock
8777 #: ../src/guestfs-actions.pod:1802 ../fish/guestfish-actions.pod:1226
8778 msgid "The result list is not sorted."
8779 msgstr ""
8780
8781 #. type: textblock
8782 #: ../src/guestfs-actions.pod:1808
8783 msgid "(Added in 1.0.74)"
8784 msgstr ""
8785
8786 #. type: =head2
8787 #: ../src/guestfs-actions.pod:1810
8788 msgid "guestfs_findfs_label"
8789 msgstr ""
8790
8791 #. type: verbatim
8792 #: ../src/guestfs-actions.pod:1812
8793 #, no-wrap
8794 msgid ""
8795 " char *\n"
8796 " guestfs_findfs_label (guestfs_h *g,\n"
8797 "                       const char *label);\n"
8798 "\n"
8799 msgstr ""
8800
8801 #. type: textblock
8802 #: ../src/guestfs-actions.pod:1816 ../fish/guestfish-actions.pod:1236
8803 msgid ""
8804 "This command searches the filesystems and returns the one which has the "
8805 "given label.  An error is returned if no such filesystem can be found."
8806 msgstr ""
8807
8808 #. type: textblock
8809 #: ../src/guestfs-actions.pod:1820
8810 msgid "To find the label of a filesystem, use C<guestfs_vfs_label>."
8811 msgstr ""
8812
8813 #. type: =head2
8814 #: ../src/guestfs-actions.pod:1827
8815 msgid "guestfs_findfs_uuid"
8816 msgstr ""
8817
8818 #. type: verbatim
8819 #: ../src/guestfs-actions.pod:1829
8820 #, no-wrap
8821 msgid ""
8822 " char *\n"
8823 " guestfs_findfs_uuid (guestfs_h *g,\n"
8824 "                      const char *uuid);\n"
8825 "\n"
8826 msgstr ""
8827
8828 #. type: textblock
8829 #: ../src/guestfs-actions.pod:1833 ../fish/guestfish-actions.pod:1246
8830 msgid ""
8831 "This command searches the filesystems and returns the one which has the "
8832 "given UUID.  An error is returned if no such filesystem can be found."
8833 msgstr ""
8834
8835 #. type: textblock
8836 #: ../src/guestfs-actions.pod:1837
8837 msgid "To find the UUID of a filesystem, use C<guestfs_vfs_uuid>."
8838 msgstr ""
8839
8840 #. type: =head2
8841 #: ../src/guestfs-actions.pod:1844
8842 msgid "guestfs_fsck"
8843 msgstr ""
8844
8845 #. type: verbatim
8846 #: ../src/guestfs-actions.pod:1846
8847 #, no-wrap
8848 msgid ""
8849 " int\n"
8850 " guestfs_fsck (guestfs_h *g,\n"
8851 "               const char *fstype,\n"
8852 "               const char *device);\n"
8853 "\n"
8854 msgstr ""
8855
8856 #. type: textblock
8857 #: ../src/guestfs-actions.pod:1851 ../fish/guestfish-actions.pod:1256
8858 msgid ""
8859 "This runs the filesystem checker (fsck) on C<device> which should have "
8860 "filesystem type C<fstype>."
8861 msgstr ""
8862
8863 #. type: textblock
8864 #: ../src/guestfs-actions.pod:1854 ../fish/guestfish-actions.pod:1259
8865 msgid ""
8866 "The returned integer is the status.  See L<fsck(8)> for the list of status "
8867 "codes from C<fsck>."
8868 msgstr ""
8869
8870 #. type: textblock
8871 #: ../src/guestfs-actions.pod:1863 ../fish/guestfish-actions.pod:1268
8872 msgid "Multiple status codes can be summed together."
8873 msgstr ""
8874
8875 #. type: textblock
8876 #: ../src/guestfs-actions.pod:1867 ../fish/guestfish-actions.pod:1272
8877 msgid ""
8878 "A non-zero return code can mean \"success\", for example if errors have been "
8879 "corrected on the filesystem."
8880 msgstr ""
8881
8882 #. type: textblock
8883 #: ../src/guestfs-actions.pod:1872 ../fish/guestfish-actions.pod:1277
8884 msgid "Checking or repairing NTFS volumes is not supported (by linux-ntfs)."
8885 msgstr ""
8886
8887 #. type: textblock
8888 #: ../src/guestfs-actions.pod:1877 ../fish/guestfish-actions.pod:1282
8889 msgid "This command is entirely equivalent to running C<fsck -a -t fstype device>."
8890 msgstr ""
8891
8892 #. type: textblock
8893 #: ../src/guestfs-actions.pod:1881 ../src/guestfs-actions.pod:7392
8894 msgid "(Added in 1.0.16)"
8895 msgstr ""
8896
8897 #. type: =head2
8898 #: ../src/guestfs-actions.pod:1883
8899 msgid "guestfs_get_append"
8900 msgstr ""
8901
8902 #. type: verbatim
8903 #: ../src/guestfs-actions.pod:1885
8904 #, no-wrap
8905 msgid ""
8906 " const char *\n"
8907 " guestfs_get_append (guestfs_h *g);\n"
8908 "\n"
8909 msgstr ""
8910
8911 #. type: textblock
8912 #: ../src/guestfs-actions.pod:1888 ../fish/guestfish-actions.pod:1288
8913 msgid ""
8914 "Return the additional kernel options which are added to the guest kernel "
8915 "command line."
8916 msgstr ""
8917
8918 #. type: textblock
8919 #: ../src/guestfs-actions.pod:1891 ../fish/guestfish-actions.pod:1291
8920 msgid "If C<NULL> then no options are added."
8921 msgstr ""
8922
8923 #. type: textblock
8924 #: ../src/guestfs-actions.pod:1893
8925 msgid ""
8926 "This function returns a string which may be NULL.  There is no way to return "
8927 "an error from this function.  The string is owned by the guest handle and "
8928 "must I<not> be freed."
8929 msgstr ""
8930
8931 #. type: textblock
8932 #: ../src/guestfs-actions.pod:1897 ../src/guestfs-actions.pod:5339 ../src/guestfs-actions.pod:5819 ../src/guestfs-actions.pod:6240 ../src/guestfs-actions.pod:6259 ../src/guestfs-actions.pod:6275 ../src/guestfs-actions.pod:6299 ../src/guestfs-actions.pod:7056 ../src/guestfs-actions.pod:7074 ../src/guestfs-actions.pod:7435
8933 msgid "(Added in 1.0.26)"
8934 msgstr ""
8935
8936 #. type: =head2
8937 #: ../src/guestfs-actions.pod:1899
8938 msgid "guestfs_get_attach_method"
8939 msgstr ""
8940
8941 #. type: verbatim
8942 #: ../src/guestfs-actions.pod:1901
8943 #, no-wrap
8944 msgid ""
8945 " char *\n"
8946 " guestfs_get_attach_method (guestfs_h *g);\n"
8947 "\n"
8948 msgstr ""
8949
8950 #. type: textblock
8951 #: ../src/guestfs-actions.pod:1904
8952 msgid "Return the current attach method.  See C<guestfs_set_attach_method>."
8953 msgstr ""
8954
8955 #. type: =head2
8956 #: ../src/guestfs-actions.pod:1909
8957 msgid "guestfs_get_autosync"
8958 msgstr ""
8959
8960 #. type: verbatim
8961 #: ../src/guestfs-actions.pod:1911
8962 #, no-wrap
8963 msgid ""
8964 " int\n"
8965 " guestfs_get_autosync (guestfs_h *g);\n"
8966 "\n"
8967 msgstr ""
8968
8969 #. type: textblock
8970 #: ../src/guestfs-actions.pod:1914 ../fish/guestfish-actions.pod:1303
8971 msgid "Get the autosync flag."
8972 msgstr ""
8973
8974 #. type: =head2
8975 #: ../src/guestfs-actions.pod:1920
8976 msgid "guestfs_get_direct"
8977 msgstr ""
8978
8979 #. type: verbatim
8980 #: ../src/guestfs-actions.pod:1922
8981 #, no-wrap
8982 msgid ""
8983 " int\n"
8984 " guestfs_get_direct (guestfs_h *g);\n"
8985 "\n"
8986 msgstr ""
8987
8988 #. type: textblock
8989 #: ../src/guestfs-actions.pod:1925 ../fish/guestfish-actions.pod:1309
8990 msgid "Return the direct appliance mode flag."
8991 msgstr ""
8992
8993 #. type: textblock
8994 #: ../src/guestfs-actions.pod:1929 ../src/guestfs-actions.pod:5888
8995 msgid "(Added in 1.0.72)"
8996 msgstr ""
8997
8998 #. type: =head2
8999 #: ../src/guestfs-actions.pod:1931
9000 msgid "guestfs_get_e2label"
9001 msgstr ""
9002
9003 #. type: verbatim
9004 #: ../src/guestfs-actions.pod:1933
9005 #, no-wrap
9006 msgid ""
9007 " char *\n"
9008 " guestfs_get_e2label (guestfs_h *g,\n"
9009 "                      const char *device);\n"
9010 "\n"
9011 msgstr ""
9012
9013 #. type: textblock
9014 #: ../src/guestfs-actions.pod:1937 ../fish/guestfish-actions.pod:1315
9015 msgid "This returns the ext2/3/4 filesystem label of the filesystem on C<device>."
9016 msgstr ""
9017
9018 #. type: textblock
9019 #: ../src/guestfs-actions.pod:1943
9020 msgid ""
9021 "This function is deprecated.  In new code, use the L</guestfs_vfs_label> "
9022 "call instead."
9023 msgstr ""
9024
9025 #. type: textblock
9026 #: ../src/guestfs-actions.pod:1950 ../src/guestfs-actions.pod:1971 ../src/guestfs-actions.pod:5906 ../src/guestfs-actions.pod:5925
9027 msgid "(Added in 1.0.15)"
9028 msgstr ""
9029
9030 #. type: =head2
9031 #: ../src/guestfs-actions.pod:1952
9032 msgid "guestfs_get_e2uuid"
9033 msgstr ""
9034
9035 #. type: verbatim
9036 #: ../src/guestfs-actions.pod:1954
9037 #, no-wrap
9038 msgid ""
9039 " char *\n"
9040 " guestfs_get_e2uuid (guestfs_h *g,\n"
9041 "                     const char *device);\n"
9042 "\n"
9043 msgstr ""
9044
9045 #. type: textblock
9046 #: ../src/guestfs-actions.pod:1958 ../fish/guestfish-actions.pod:1329
9047 msgid "This returns the ext2/3/4 filesystem UUID of the filesystem on C<device>."
9048 msgstr ""
9049
9050 #. type: textblock
9051 #: ../src/guestfs-actions.pod:1964
9052 msgid ""
9053 "This function is deprecated.  In new code, use the L</guestfs_vfs_uuid> call "
9054 "instead."
9055 msgstr ""
9056
9057 #. type: =head2
9058 #: ../src/guestfs-actions.pod:1973
9059 msgid "guestfs_get_memsize"
9060 msgstr ""
9061
9062 #. type: verbatim
9063 #: ../src/guestfs-actions.pod:1975
9064 #, no-wrap
9065 msgid ""
9066 " int\n"
9067 " guestfs_get_memsize (guestfs_h *g);\n"
9068 "\n"
9069 msgstr ""
9070
9071 #. type: textblock
9072 #: ../src/guestfs-actions.pod:1978 ../fish/guestfish-actions.pod:1343
9073 msgid "This gets the memory size in megabytes allocated to the qemu subprocess."
9074 msgstr ""
9075
9076 #. type: textblock
9077 #: ../src/guestfs-actions.pod:1981
9078 msgid ""
9079 "If C<guestfs_set_memsize> was not called on this handle, and if "
9080 "C<LIBGUESTFS_MEMSIZE> was not set, then this returns the compiled-in default "
9081 "value for memsize."
9082 msgstr ""
9083
9084 #. type: textblock
9085 #: ../src/guestfs-actions.pod:1985 ../src/guestfs-actions.pod:2066 ../src/guestfs-actions.pod:5941 ../src/guestfs-actions.pod:6048 ../fish/guestfish-actions.pod:1350 ../fish/guestfish-actions.pod:1401 ../fish/guestfish-actions.pod:4011 ../fish/guestfish-actions.pod:4098
9086 msgid "For more information on the architecture of libguestfs, see L<guestfs(3)>."
9087 msgstr ""
9088
9089 #. type: textblock
9090 #: ../src/guestfs-actions.pod:1990 ../src/guestfs-actions.pod:4393 ../src/guestfs-actions.pod:4590 ../src/guestfs-actions.pod:4609 ../src/guestfs-actions.pod:4628 ../src/guestfs-actions.pod:4640 ../src/guestfs-actions.pod:4657 ../src/guestfs-actions.pod:4670 ../src/guestfs-actions.pod:5564 ../src/guestfs-actions.pod:5946 ../src/guestfs-actions.pod:6207 ../src/guestfs-actions.pod:6822
9091 msgid "(Added in 1.0.55)"
9092 msgstr ""
9093
9094 #. type: =head2
9095 #: ../src/guestfs-actions.pod:1992
9096 msgid "guestfs_get_network"
9097 msgstr ""
9098
9099 #. type: verbatim
9100 #: ../src/guestfs-actions.pod:1994
9101 #, no-wrap
9102 msgid ""
9103 " int\n"
9104 " guestfs_get_network (guestfs_h *g);\n"
9105 "\n"
9106 msgstr ""
9107
9108 #. type: textblock
9109 #: ../src/guestfs-actions.pod:1997 ../fish/guestfish-actions.pod:1357
9110 msgid "This returns the enable network flag."
9111 msgstr ""
9112
9113 #. type: textblock
9114 #: ../src/guestfs-actions.pod:2001 ../src/guestfs-actions.pod:5965
9115 msgid "(Added in 1.5.4)"
9116 msgstr ""
9117
9118 #. type: =head2
9119 #: ../src/guestfs-actions.pod:2003
9120 msgid "guestfs_get_path"
9121 msgstr ""
9122
9123 #. type: verbatim
9124 #: ../src/guestfs-actions.pod:2005
9125 #, no-wrap
9126 msgid ""
9127 " const char *\n"
9128 " guestfs_get_path (guestfs_h *g);\n"
9129 "\n"
9130 msgstr ""
9131
9132 #. type: textblock
9133 #: ../src/guestfs-actions.pod:2008 ../fish/guestfish-actions.pod:1363
9134 msgid "Return the current search path."
9135 msgstr ""
9136
9137 #. type: textblock
9138 #: ../src/guestfs-actions.pod:2010 ../fish/guestfish-actions.pod:1365
9139 msgid ""
9140 "This is always non-NULL.  If it wasn't set already, then this will return "
9141 "the default path."
9142 msgstr ""
9143
9144 #. type: textblock
9145 #: ../src/guestfs-actions.pod:2013 ../src/guestfs-actions.pod:2042
9146 msgid ""
9147 "This function returns a string, or NULL on error.  The string is owned by "
9148 "the guest handle and must I<not> be freed."
9149 msgstr ""
9150
9151 #. type: =head2
9152 #: ../src/guestfs-actions.pod:2018
9153 msgid "guestfs_get_pid"
9154 msgstr ""
9155
9156 #. type: verbatim
9157 #: ../src/guestfs-actions.pod:2020
9158 #, no-wrap
9159 msgid ""
9160 " int\n"
9161 " guestfs_get_pid (guestfs_h *g);\n"
9162 "\n"
9163 msgstr ""
9164
9165 #. type: textblock
9166 #: ../src/guestfs-actions.pod:2023 ../fish/guestfish-actions.pod:1374
9167 msgid ""
9168 "Return the process ID of the qemu subprocess.  If there is no qemu "
9169 "subprocess, then this will return an error."
9170 msgstr ""
9171
9172 #. type: textblock
9173 #: ../src/guestfs-actions.pod:2026 ../fish/guestfish-actions.pod:1377
9174 msgid "This is an internal call used for debugging and testing."
9175 msgstr ""
9176
9177 #. type: textblock
9178 #: ../src/guestfs-actions.pod:2030
9179 msgid "(Added in 1.0.56)"
9180 msgstr ""
9181
9182 #. type: =head2
9183 #: ../src/guestfs-actions.pod:2032
9184 msgid "guestfs_get_qemu"
9185 msgstr ""
9186
9187 #. type: verbatim
9188 #: ../src/guestfs-actions.pod:2034
9189 #, no-wrap
9190 msgid ""
9191 " const char *\n"
9192 " guestfs_get_qemu (guestfs_h *g);\n"
9193 "\n"
9194 msgstr ""
9195
9196 #. type: textblock
9197 #: ../src/guestfs-actions.pod:2037 ../fish/guestfish-actions.pod:1383
9198 msgid "Return the current qemu binary."
9199 msgstr ""
9200
9201 #. type: textblock
9202 #: ../src/guestfs-actions.pod:2039 ../fish/guestfish-actions.pod:1385
9203 msgid ""
9204 "This is always non-NULL.  If it wasn't set already, then this will return "
9205 "the default qemu binary name."
9206 msgstr ""
9207
9208 #. type: textblock
9209 #: ../src/guestfs-actions.pod:2045 ../src/guestfs-actions.pod:6010
9210 msgid "(Added in 1.0.6)"
9211 msgstr ""
9212
9213 #. type: =head2
9214 #: ../src/guestfs-actions.pod:2047
9215 msgid "guestfs_get_recovery_proc"
9216 msgstr ""
9217
9218 #. type: verbatim
9219 #: ../src/guestfs-actions.pod:2049
9220 #, no-wrap
9221 msgid ""
9222 " int\n"
9223 " guestfs_get_recovery_proc (guestfs_h *g);\n"
9224 "\n"
9225 msgstr ""
9226
9227 #. type: textblock
9228 #: ../src/guestfs-actions.pod:2052 ../fish/guestfish-actions.pod:1392
9229 msgid "Return the recovery process enabled flag."
9230 msgstr ""
9231
9232 #. type: textblock
9233 #: ../src/guestfs-actions.pod:2056 ../src/guestfs-actions.pod:3503 ../src/guestfs-actions.pod:3800 ../src/guestfs-actions.pod:4200 ../src/guestfs-actions.pod:4232 ../src/guestfs-actions.pod:5269 ../src/guestfs-actions.pod:5612 ../src/guestfs-actions.pod:6034 ../src/guestfs-actions.pod:6725 ../src/guestfs-actions.pod:6745 ../src/guestfs-actions.pod:6937
9234 msgid "(Added in 1.0.77)"
9235 msgstr ""
9236
9237 #. type: =head2
9238 #: ../src/guestfs-actions.pod:2058
9239 msgid "guestfs_get_selinux"
9240 msgstr ""
9241
9242 #. type: verbatim
9243 #: ../src/guestfs-actions.pod:2060
9244 #, no-wrap
9245 msgid ""
9246 " int\n"
9247 " guestfs_get_selinux (guestfs_h *g);\n"
9248 "\n"
9249 msgstr ""
9250
9251 #. type: textblock
9252 #: ../src/guestfs-actions.pod:2063
9253 msgid ""
9254 "This returns the current setting of the selinux flag which is passed to the "
9255 "appliance at boot time.  See C<guestfs_set_selinux>."
9256 msgstr ""
9257
9258 #. type: textblock
9259 #: ../src/guestfs-actions.pod:2071 ../src/guestfs-actions.pod:2134 ../src/guestfs-actions.pod:6053 ../src/guestfs-actions.pod:6111
9260 msgid "(Added in 1.0.67)"
9261 msgstr ""
9262
9263 #. type: =head2
9264 #: ../src/guestfs-actions.pod:2073
9265 msgid "guestfs_get_state"
9266 msgstr ""
9267
9268 #. type: verbatim
9269 #: ../src/guestfs-actions.pod:2075
9270 #, no-wrap
9271 msgid ""
9272 " int\n"
9273 " guestfs_get_state (guestfs_h *g);\n"
9274 "\n"
9275 msgstr ""
9276
9277 #. type: textblock
9278 #: ../src/guestfs-actions.pod:2078 ../fish/guestfish-actions.pod:1408
9279 msgid ""
9280 "This returns the current state as an opaque integer.  This is only useful "
9281 "for printing debug and internal error messages."
9282 msgstr ""
9283
9284 #. type: textblock
9285 #: ../src/guestfs-actions.pod:2081 ../src/guestfs-actions.pod:3301 ../src/guestfs-actions.pod:3330 ../src/guestfs-actions.pod:3391 ../src/guestfs-actions.pod:3418 ../fish/guestfish-actions.pod:1411 ../fish/guestfish-actions.pod:2325 ../fish/guestfish-actions.pod:2343 ../fish/guestfish-actions.pod:2381 ../fish/guestfish-actions.pod:2397
9286 msgid "For more information on states, see L<guestfs(3)>."
9287 msgstr ""
9288
9289 #. type: =head2
9290 #: ../src/guestfs-actions.pod:2087
9291 msgid "guestfs_get_trace"
9292 msgstr ""
9293
9294 #. type: verbatim
9295 #: ../src/guestfs-actions.pod:2089
9296 #, no-wrap
9297 msgid ""
9298 " int\n"
9299 " guestfs_get_trace (guestfs_h *g);\n"
9300 "\n"
9301 msgstr ""
9302
9303 #. type: textblock
9304 #: ../src/guestfs-actions.pod:2092 ../fish/guestfish-actions.pod:1417
9305 msgid "Return the command trace flag."
9306 msgstr ""
9307
9308 #. type: =head2
9309 #: ../src/guestfs-actions.pod:2098
9310 msgid "guestfs_get_umask"
9311 msgstr ""
9312
9313 #. type: verbatim
9314 #: ../src/guestfs-actions.pod:2100
9315 #, no-wrap
9316 msgid ""
9317 " int\n"
9318 " guestfs_get_umask (guestfs_h *g);\n"
9319 "\n"
9320 msgstr ""
9321
9322 #. type: textblock
9323 #: ../src/guestfs-actions.pod:2103
9324 msgid ""
9325 "Return the current umask.  By default the umask is C<022> unless it has been "
9326 "set by calling C<guestfs_umask>."
9327 msgstr ""
9328
9329 #. type: =head2
9330 #: ../src/guestfs-actions.pod:2110
9331 msgid "guestfs_get_verbose"
9332 msgstr ""
9333
9334 #. type: verbatim
9335 #: ../src/guestfs-actions.pod:2112
9336 #, no-wrap
9337 msgid ""
9338 " int\n"
9339 " guestfs_get_verbose (guestfs_h *g);\n"
9340 "\n"
9341 msgstr ""
9342
9343 #. type: textblock
9344 #: ../src/guestfs-actions.pod:2115 ../fish/guestfish-actions.pod:1430
9345 msgid "This returns the verbose messages flag."
9346 msgstr ""
9347
9348 #. type: =head2
9349 #: ../src/guestfs-actions.pod:2121
9350 msgid "guestfs_getcon"
9351 msgstr ""
9352
9353 #. type: verbatim
9354 #: ../src/guestfs-actions.pod:2123
9355 #, no-wrap
9356 msgid ""
9357 " char *\n"
9358 " guestfs_getcon (guestfs_h *g);\n"
9359 "\n"
9360 msgstr ""
9361
9362 #. type: textblock
9363 #: ../src/guestfs-actions.pod:2126 ../fish/guestfish-actions.pod:1436
9364 msgid "This gets the SELinux security context of the daemon."
9365 msgstr ""
9366
9367 #. type: textblock
9368 #: ../src/guestfs-actions.pod:2128
9369 msgid "See the documentation about SELINUX in L<guestfs(3)>, and C<guestfs_setcon>"
9370 msgstr ""
9371
9372 #. type: =head2
9373 #: ../src/guestfs-actions.pod:2136
9374 msgid "guestfs_getxattr"
9375 msgstr ""
9376
9377 #. type: verbatim
9378 #: ../src/guestfs-actions.pod:2138
9379 #, no-wrap
9380 msgid ""
9381 " char *\n"
9382 " guestfs_getxattr (guestfs_h *g,\n"
9383 "                   const char *path,\n"
9384 "                   const char *name,\n"
9385 "                   size_t *size_r);\n"
9386 "\n"
9387 msgstr ""
9388
9389 #. type: textblock
9390 #: ../src/guestfs-actions.pod:2144
9391 msgid ""
9392 "Get a single extended attribute from file C<path> named C<name>.  This call "
9393 "follows symlinks.  If you want to lookup an extended attribute for the "
9394 "symlink itself, use C<guestfs_lgetxattr>."
9395 msgstr ""
9396
9397 #. type: textblock
9398 #: ../src/guestfs-actions.pod:2148 ../src/guestfs-actions.pod:3517
9399 msgid ""
9400 "Normally it is better to get all extended attributes from a file in one go "
9401 "by calling C<guestfs_getxattrs>.  However some Linux filesystem "
9402 "implementations are buggy and do not provide a way to list out attributes.  "
9403 "For these filesystems (notably ntfs-3g)  you have to know the names of the "
9404 "extended attributes you want in advance and call this function."
9405 msgstr ""
9406
9407 #. type: textblock
9408 #: ../src/guestfs-actions.pod:2155 ../src/guestfs-actions.pod:3524 ../fish/guestfish-actions.pod:1456 ../fish/guestfish-actions.pod:2462
9409 msgid ""
9410 "Extended attribute values are blobs of binary data.  If there is no extended "
9411 "attribute named C<name>, this returns an error."
9412 msgstr ""
9413
9414 #. type: textblock
9415 #: ../src/guestfs-actions.pod:2158
9416 msgid "See also: C<guestfs_getxattrs>, C<guestfs_lgetxattr>, L<attr(5)>."
9417 msgstr ""
9418
9419 #. type: textblock
9420 #: ../src/guestfs-actions.pod:2160 ../src/guestfs-actions.pod:2351 ../src/guestfs-actions.pod:3529 ../src/guestfs-actions.pod:5262 ../src/guestfs-actions.pod:5288 ../src/guestfs-actions.pod:5469
9421 msgid ""
9422 "This function returns a buffer, or NULL on error.  The size of the returned "
9423 "buffer is written to C<*size_r>.  I<The caller must free the returned buffer "
9424 "after use>."
9425 msgstr ""
9426
9427 #. type: textblock
9428 #: ../src/guestfs-actions.pod:2164 ../src/guestfs-actions.pod:3533
9429 msgid "(Added in 1.7.24)"
9430 msgstr ""
9431
9432 #. type: =head2
9433 #: ../src/guestfs-actions.pod:2166
9434 msgid "guestfs_getxattrs"
9435 msgstr ""
9436
9437 #. type: verbatim
9438 #: ../src/guestfs-actions.pod:2168
9439 #, no-wrap
9440 msgid ""
9441 " struct guestfs_xattr_list *\n"
9442 " guestfs_getxattrs (guestfs_h *g,\n"
9443 "                    const char *path);\n"
9444 "\n"
9445 msgstr ""
9446
9447 #. type: textblock
9448 #: ../src/guestfs-actions.pod:2172 ../fish/guestfish-actions.pod:1465
9449 msgid "This call lists the extended attributes of the file or directory C<path>."
9450 msgstr ""
9451
9452 #. type: textblock
9453 #: ../src/guestfs-actions.pod:2175 ../fish/guestfish-actions.pod:1468
9454 msgid ""
9455 "At the system call level, this is a combination of the L<listxattr(2)> and "
9456 "L<getxattr(2)> calls."
9457 msgstr ""
9458
9459 #. type: textblock
9460 #: ../src/guestfs-actions.pod:2178
9461 msgid "See also: C<guestfs_lgetxattrs>, L<attr(5)>."
9462 msgstr ""
9463
9464 #. type: textblock
9465 #: ../src/guestfs-actions.pod:2180 ../src/guestfs-actions.pod:3545 ../src/guestfs-actions.pod:4196
9466 msgid ""
9467 "This function returns a C<struct guestfs_xattr_list *>, or NULL if there was "
9468 "an error.  I<The caller must call C<guestfs_free_xattr_list> after use>."
9469 msgstr ""
9470
9471 #. type: textblock
9472 #: ../src/guestfs-actions.pod:2184 ../src/guestfs-actions.pod:3549 ../src/guestfs-actions.pod:3714 ../src/guestfs-actions.pod:3750 ../src/guestfs-actions.pod:5642 ../src/guestfs-actions.pod:6130 ../src/guestfs-actions.pod:7500
9473 msgid "(Added in 1.0.59)"
9474 msgstr ""
9475
9476 #. type: =head2
9477 #: ../src/guestfs-actions.pod:2186
9478 msgid "guestfs_glob_expand"
9479 msgstr ""
9480
9481 #. type: verbatim
9482 #: ../src/guestfs-actions.pod:2188
9483 #, no-wrap
9484 msgid ""
9485 " char **\n"
9486 " guestfs_glob_expand (guestfs_h *g,\n"
9487 "                      const char *pattern);\n"
9488 "\n"
9489 msgstr ""
9490
9491 #. type: textblock
9492 #: ../src/guestfs-actions.pod:2192 ../fish/guestfish-actions.pod:1477
9493 msgid ""
9494 "This command searches for all the pathnames matching C<pattern> according to "
9495 "the wildcard expansion rules used by the shell."
9496 msgstr ""
9497
9498 #. type: textblock
9499 #: ../src/guestfs-actions.pod:2196 ../fish/guestfish-actions.pod:1481
9500 msgid "If no paths match, then this returns an empty list (note: not an error)."
9501 msgstr ""
9502
9503 #. type: textblock
9504 #: ../src/guestfs-actions.pod:2199 ../fish/guestfish-actions.pod:1484
9505 msgid ""
9506 "It is just a wrapper around the C L<glob(3)> function with flags "
9507 "C<GLOB_MARK|GLOB_BRACE>.  See that manual page for more details."
9508 msgstr ""
9509
9510 #. type: textblock
9511 #: ../src/guestfs-actions.pod:2207 ../src/guestfs-actions.pod:6323 ../src/guestfs-actions.pod:6340
9512 msgid "(Added in 1.0.50)"
9513 msgstr ""
9514
9515 #. type: =head2
9516 #: ../src/guestfs-actions.pod:2209
9517 msgid "guestfs_grep"
9518 msgstr ""
9519
9520 #. type: verbatim
9521 #: ../src/guestfs-actions.pod:2211
9522 #, no-wrap
9523 msgid ""
9524 " char **\n"
9525 " guestfs_grep (guestfs_h *g,\n"
9526 "               const char *regex,\n"
9527 "               const char *path);\n"
9528 "\n"
9529 msgstr ""
9530
9531 #. type: textblock
9532 #: ../src/guestfs-actions.pod:2216 ../fish/guestfish-actions.pod:1492
9533 msgid "This calls the external C<grep> program and returns the matching lines."
9534 msgstr ""
9535
9536 #. type: =head2
9537 #: ../src/guestfs-actions.pod:2228
9538 msgid "guestfs_grepi"
9539 msgstr ""
9540
9541 #. type: verbatim
9542 #: ../src/guestfs-actions.pod:2230
9543 #, no-wrap
9544 msgid ""
9545 " char **\n"
9546 " guestfs_grepi (guestfs_h *g,\n"
9547 "                const char *regex,\n"
9548 "                const char *path);\n"
9549 "\n"
9550 msgstr ""
9551
9552 #. type: textblock
9553 #: ../src/guestfs-actions.pod:2235 ../fish/guestfish-actions.pod:1502
9554 msgid "This calls the external C<grep -i> program and returns the matching lines."
9555 msgstr ""
9556
9557 #. type: =head2
9558 #: ../src/guestfs-actions.pod:2247
9559 msgid "guestfs_grub_install"
9560 msgstr ""
9561
9562 #. type: verbatim
9563 #: ../src/guestfs-actions.pod:2249
9564 #, no-wrap
9565 msgid ""
9566 " int\n"
9567 " guestfs_grub_install (guestfs_h *g,\n"
9568 "                       const char *root,\n"
9569 "                       const char *device);\n"
9570 "\n"
9571 msgstr ""
9572
9573 #. type: textblock
9574 #: ../src/guestfs-actions.pod:2254 ../fish/guestfish-actions.pod:1512
9575 msgid ""
9576 "This command installs GRUB (the Grand Unified Bootloader) on C<device>, with "
9577 "the root directory being C<root>."
9578 msgstr ""
9579
9580 #. type: textblock
9581 #: ../src/guestfs-actions.pod:2257 ../fish/guestfish-actions.pod:1515
9582 msgid ""
9583 "Note: If grub-install reports the error \"No suitable drive was found in the "
9584 "generated device map.\" it may be that you need to create a "
9585 "C</boot/grub/device.map> file first that contains the mapping between grub "
9586 "device names and Linux device names.  It is usually sufficient to create a "
9587 "file containing:"
9588 msgstr ""
9589
9590 #. type: verbatim
9591 #: ../src/guestfs-actions.pod:2264 ../fish/guestfish-actions.pod:1522
9592 #, no-wrap
9593 msgid ""
9594 " (hd0) /dev/vda\n"
9595 "\n"
9596 msgstr ""
9597
9598 #. type: textblock
9599 #: ../src/guestfs-actions.pod:2266 ../fish/guestfish-actions.pod:1524
9600 msgid "replacing C</dev/vda> with the name of the installation device."
9601 msgstr ""
9602
9603 #. type: textblock
9604 #: ../src/guestfs-actions.pod:2270
9605 msgid "(Added in 1.0.17)"
9606 msgstr ""
9607
9608 #. type: =head2
9609 #: ../src/guestfs-actions.pod:2272
9610 msgid "guestfs_head"
9611 msgstr ""
9612
9613 #. type: verbatim
9614 #: ../src/guestfs-actions.pod:2274
9615 #, no-wrap
9616 msgid ""
9617 " char **\n"
9618 " guestfs_head (guestfs_h *g,\n"
9619 "               const char *path);\n"
9620 "\n"
9621 msgstr ""
9622
9623 #. type: textblock
9624 #: ../src/guestfs-actions.pod:2278 ../fish/guestfish-actions.pod:1530
9625 msgid ""
9626 "This command returns up to the first 10 lines of a file as a list of "
9627 "strings."
9628 msgstr ""
9629
9630 #. type: =head2
9631 #: ../src/guestfs-actions.pod:2290
9632 msgid "guestfs_head_n"
9633 msgstr ""
9634
9635 #. type: verbatim
9636 #: ../src/guestfs-actions.pod:2292
9637 #, no-wrap
9638 msgid ""
9639 " char **\n"
9640 " guestfs_head_n (guestfs_h *g,\n"
9641 "                 int nrlines,\n"
9642 "                 const char *path);\n"
9643 "\n"
9644 msgstr ""
9645
9646 #. type: textblock
9647 #: ../src/guestfs-actions.pod:2297 ../fish/guestfish-actions.pod:1540
9648 msgid ""
9649 "If the parameter C<nrlines> is a positive number, this returns the first "
9650 "C<nrlines> lines of the file C<path>."
9651 msgstr ""
9652
9653 #. type: textblock
9654 #: ../src/guestfs-actions.pod:2300 ../fish/guestfish-actions.pod:1543
9655 msgid ""
9656 "If the parameter C<nrlines> is a negative number, this returns lines from "
9657 "the file C<path>, excluding the last C<nrlines> lines."
9658 msgstr ""
9659
9660 #. type: textblock
9661 #: ../src/guestfs-actions.pod:2303 ../src/guestfs-actions.pod:6620 ../fish/guestfish-actions.pod:1546 ../fish/guestfish-actions.pod:4476
9662 msgid "If the parameter C<nrlines> is zero, this returns an empty list."
9663 msgstr ""
9664
9665 #. type: =head2
9666 #: ../src/guestfs-actions.pod:2314
9667 msgid "guestfs_hexdump"
9668 msgstr ""
9669
9670 #. type: verbatim
9671 #: ../src/guestfs-actions.pod:2316
9672 #, no-wrap
9673 msgid ""
9674 " char *\n"
9675 " guestfs_hexdump (guestfs_h *g,\n"
9676 "                  const char *path);\n"
9677 "\n"
9678 msgstr ""
9679
9680 #. type: textblock
9681 #: ../src/guestfs-actions.pod:2320 ../fish/guestfish-actions.pod:1555
9682 msgid ""
9683 "This runs C<hexdump -C> on the given C<path>.  The result is the "
9684 "human-readable, canonical hex dump of the file."
9685 msgstr ""
9686
9687 #. type: textblock
9688 #: ../src/guestfs-actions.pod:2329 ../src/guestfs-actions.pod:6404 ../src/guestfs-actions.pod:6459
9689 msgid "(Added in 1.0.22)"
9690 msgstr ""
9691
9692 #. type: =head2
9693 #: ../src/guestfs-actions.pod:2331
9694 msgid "guestfs_initrd_cat"
9695 msgstr ""
9696
9697 #. type: verbatim
9698 #: ../src/guestfs-actions.pod:2333
9699 #, no-wrap
9700 msgid ""
9701 " char *\n"
9702 " guestfs_initrd_cat (guestfs_h *g,\n"
9703 "                     const char *initrdpath,\n"
9704 "                     const char *filename,\n"
9705 "                     size_t *size_r);\n"
9706 "\n"
9707 msgstr ""
9708
9709 #. type: textblock
9710 #: ../src/guestfs-actions.pod:2339 ../fish/guestfish-actions.pod:1565
9711 msgid ""
9712 "This command unpacks the file C<filename> from the initrd file called "
9713 "C<initrdpath>.  The filename must be given I<without> the initial C</> "
9714 "character."
9715 msgstr ""
9716
9717 #. type: textblock
9718 #: ../src/guestfs-actions.pod:2343 ../fish/guestfish-actions.pod:1569
9719 msgid ""
9720 "For example, in guestfish you could use the following command to examine the "
9721 "boot script (usually called C</init>)  contained in a Linux initrd or "
9722 "initramfs image:"
9723 msgstr ""
9724
9725 #. type: verbatim
9726 #: ../src/guestfs-actions.pod:2347 ../fish/guestfish-actions.pod:1573
9727 #, no-wrap
9728 msgid ""
9729 " initrd-cat /boot/initrd-<version>.img init\n"
9730 "\n"
9731 msgstr ""
9732
9733 #. type: textblock
9734 #: ../src/guestfs-actions.pod:2349
9735 msgid "See also C<guestfs_initrd_list>."
9736 msgstr ""
9737
9738 #. type: =head2
9739 #: ../src/guestfs-actions.pod:2360
9740 msgid "guestfs_initrd_list"
9741 msgstr ""
9742
9743 #. type: verbatim
9744 #: ../src/guestfs-actions.pod:2362
9745 #, no-wrap
9746 msgid ""
9747 " char **\n"
9748 " guestfs_initrd_list (guestfs_h *g,\n"
9749 "                      const char *path);\n"
9750 "\n"
9751 msgstr ""
9752
9753 #. type: textblock
9754 #: ../src/guestfs-actions.pod:2366 ../fish/guestfish-actions.pod:1584
9755 msgid "This command lists out files contained in an initrd."
9756 msgstr ""
9757
9758 #. type: textblock
9759 #: ../src/guestfs-actions.pod:2368 ../fish/guestfish-actions.pod:1586
9760 msgid ""
9761 "The files are listed without any initial C</> character.  The files are "
9762 "listed in the order they appear (not necessarily alphabetical).  Directory "
9763 "names are listed as separate items."
9764 msgstr ""
9765
9766 #. type: textblock
9767 #: ../src/guestfs-actions.pod:2372 ../fish/guestfish-actions.pod:1590
9768 msgid ""
9769 "Old Linux kernels (2.4 and earlier) used a compressed ext2 filesystem as "
9770 "initrd.  We I<only> support the newer initramfs format (compressed cpio "
9771 "files)."
9772 msgstr ""
9773
9774 #. type: =head2
9775 #: ../src/guestfs-actions.pod:2382
9776 msgid "guestfs_inotify_add_watch"
9777 msgstr ""
9778
9779 #. type: verbatim
9780 #: ../src/guestfs-actions.pod:2384
9781 #, no-wrap
9782 msgid ""
9783 " int64_t\n"
9784 " guestfs_inotify_add_watch (guestfs_h *g,\n"
9785 "                            const char *path,\n"
9786 "                            int mask);\n"
9787 "\n"
9788 msgstr ""
9789
9790 #. type: textblock
9791 #: ../src/guestfs-actions.pod:2389 ../fish/guestfish-actions.pod:1598
9792 msgid "Watch C<path> for the events listed in C<mask>."
9793 msgstr ""
9794
9795 #. type: textblock
9796 #: ../src/guestfs-actions.pod:2391 ../fish/guestfish-actions.pod:1600
9797 msgid ""
9798 "Note that if C<path> is a directory then events within that directory are "
9799 "watched, but this does I<not> happen recursively (in subdirectories)."
9800 msgstr ""
9801
9802 #. type: textblock
9803 #: ../src/guestfs-actions.pod:2395 ../fish/guestfish-actions.pod:1604
9804 msgid ""
9805 "Note for non-C or non-Linux callers: the inotify events are defined by the "
9806 "Linux kernel ABI and are listed in C</usr/include/sys/inotify.h>."
9807 msgstr ""
9808
9809 #. type: =head2
9810 #: ../src/guestfs-actions.pod:2403
9811 msgid "guestfs_inotify_close"
9812 msgstr ""
9813
9814 #. type: verbatim
9815 #: ../src/guestfs-actions.pod:2405
9816 #, no-wrap
9817 msgid ""
9818 " int\n"
9819 " guestfs_inotify_close (guestfs_h *g);\n"
9820 "\n"
9821 msgstr ""
9822
9823 #. type: textblock
9824 #: ../src/guestfs-actions.pod:2408 ../fish/guestfish-actions.pod:1612
9825 msgid ""
9826 "This closes the inotify handle which was previously opened by inotify_init.  "
9827 "It removes all watches, throws away any pending events, and deallocates all "
9828 "resources."
9829 msgstr ""
9830
9831 #. type: =head2
9832 #: ../src/guestfs-actions.pod:2416
9833 msgid "guestfs_inotify_files"
9834 msgstr ""
9835
9836 #. type: verbatim
9837 #: ../src/guestfs-actions.pod:2418
9838 #, no-wrap
9839 msgid ""
9840 " char **\n"
9841 " guestfs_inotify_files (guestfs_h *g);\n"
9842 "\n"
9843 msgstr ""
9844
9845 #. type: textblock
9846 #: ../src/guestfs-actions.pod:2421
9847 msgid ""
9848 "This function is a helpful wrapper around C<guestfs_inotify_read> which just "
9849 "returns a list of pathnames of objects that were touched.  The returned "
9850 "pathnames are sorted and deduplicated."
9851 msgstr ""
9852
9853 #. type: =head2
9854 #: ../src/guestfs-actions.pod:2431
9855 msgid "guestfs_inotify_init"
9856 msgstr ""
9857
9858 #. type: verbatim
9859 #: ../src/guestfs-actions.pod:2433
9860 #, no-wrap
9861 msgid ""
9862 " int\n"
9863 " guestfs_inotify_init (guestfs_h *g,\n"
9864 "                       int maxevents);\n"
9865 "\n"
9866 msgstr ""
9867
9868 #. type: textblock
9869 #: ../src/guestfs-actions.pod:2437 ../fish/guestfish-actions.pod:1628
9870 msgid ""
9871 "This command creates a new inotify handle.  The inotify subsystem can be "
9872 "used to notify events which happen to objects in the guest filesystem."
9873 msgstr ""
9874
9875 #. type: textblock
9876 #: ../src/guestfs-actions.pod:2441
9877 msgid ""
9878 "C<maxevents> is the maximum number of events which will be queued up between "
9879 "calls to C<guestfs_inotify_read> or C<guestfs_inotify_files>.  If this is "
9880 "passed as C<0>, then the kernel (or previously set)  default is used.  For "
9881 "Linux 2.6.29 the default was 16384 events.  Beyond this limit, the kernel "
9882 "throws away events, but records the fact that it threw them away by setting "
9883 "a flag C<IN_Q_OVERFLOW> in the returned structure list (see "
9884 "C<guestfs_inotify_read>)."
9885 msgstr ""
9886
9887 #. type: textblock
9888 #: ../src/guestfs-actions.pod:2451
9889 msgid ""
9890 "Before any events are generated, you have to add some watches to the "
9891 "internal watch list.  See: C<guestfs_inotify_add_watch>, "
9892 "C<guestfs_inotify_rm_watch> and C<guestfs_inotify_watch_all>."
9893 msgstr ""
9894
9895 #. type: textblock
9896 #: ../src/guestfs-actions.pod:2457
9897 msgid ""
9898 "Queued up events should be read periodically by calling "
9899 "C<guestfs_inotify_read> (or C<guestfs_inotify_files> which is just a helpful "
9900 "wrapper around C<guestfs_inotify_read>).  If you don't read the events out "
9901 "often enough then you risk the internal queue overflowing."
9902 msgstr ""
9903
9904 #. type: textblock
9905 #: ../src/guestfs-actions.pod:2464
9906 msgid ""
9907 "The handle should be closed after use by calling C<guestfs_inotify_close>.  "
9908 "This also removes any watches automatically."
9909 msgstr ""
9910
9911 #. type: textblock
9912 #: ../src/guestfs-actions.pod:2468 ../fish/guestfish-actions.pod:1659
9913 msgid ""
9914 "See also L<inotify(7)> for an overview of the inotify interface as exposed "
9915 "by the Linux kernel, which is roughly what we expose via libguestfs.  Note "
9916 "that there is one global inotify handle per libguestfs instance."
9917 msgstr ""
9918
9919 #. type: =head2
9920 #: ../src/guestfs-actions.pod:2477
9921 msgid "guestfs_inotify_read"
9922 msgstr ""
9923
9924 #. type: verbatim
9925 #: ../src/guestfs-actions.pod:2479
9926 #, no-wrap
9927 msgid ""
9928 " struct guestfs_inotify_event_list *\n"
9929 " guestfs_inotify_read (guestfs_h *g);\n"
9930 "\n"
9931 msgstr ""
9932
9933 #. type: textblock
9934 #: ../src/guestfs-actions.pod:2482 ../fish/guestfish-actions.pod:1668
9935 msgid ""
9936 "Return the complete queue of events that have happened since the previous "
9937 "read call."
9938 msgstr ""
9939
9940 #. type: textblock
9941 #: ../src/guestfs-actions.pod:2485 ../fish/guestfish-actions.pod:1671
9942 msgid "If no events have happened, this returns an empty list."
9943 msgstr ""
9944
9945 #. type: textblock
9946 #: ../src/guestfs-actions.pod:2487 ../fish/guestfish-actions.pod:1673
9947 msgid ""
9948 "I<Note>: In order to make sure that all events have been read, you must call "
9949 "this function repeatedly until it returns an empty list.  The reason is that "
9950 "the call will read events up to the maximum appliance-to-host message size "
9951 "and leave remaining events in the queue."
9952 msgstr ""
9953
9954 #. type: textblock
9955 #: ../src/guestfs-actions.pod:2493
9956 msgid ""
9957 "This function returns a C<struct guestfs_inotify_event_list *>, or NULL if "
9958 "there was an error.  I<The caller must call "
9959 "C<guestfs_free_inotify_event_list> after use>."
9960 msgstr ""
9961
9962 #. type: =head2
9963 #: ../src/guestfs-actions.pod:2499
9964 msgid "guestfs_inotify_rm_watch"
9965 msgstr ""
9966
9967 #. type: verbatim
9968 #: ../src/guestfs-actions.pod:2501
9969 #, no-wrap
9970 msgid ""
9971 " int\n"
9972 " guestfs_inotify_rm_watch (guestfs_h *g,\n"
9973 "                           int wd);\n"
9974 "\n"
9975 msgstr ""
9976
9977 #. type: textblock
9978 #: ../src/guestfs-actions.pod:2505
9979 msgid ""
9980 "Remove a previously defined inotify watch.  See "
9981 "C<guestfs_inotify_add_watch>."
9982 msgstr ""
9983
9984 #. type: =head2
9985 #: ../src/guestfs-actions.pod:2512
9986 msgid "guestfs_inspect_get_arch"
9987 msgstr ""
9988
9989 #. type: verbatim
9990 #: ../src/guestfs-actions.pod:2514
9991 #, no-wrap
9992 msgid ""
9993 " char *\n"
9994 " guestfs_inspect_get_arch (guestfs_h *g,\n"
9995 "                           const char *root);\n"
9996 "\n"
9997 msgstr ""
9998
9999 #. type: textblock
10000 #: ../src/guestfs-actions.pod:2518 ../src/guestfs-actions.pod:2541 ../src/guestfs-actions.pod:2634 ../src/guestfs-actions.pod:2678 ../src/guestfs-actions.pod:2704 ../src/guestfs-actions.pod:2743 ../src/guestfs-actions.pod:2765 ../src/guestfs-actions.pod:2792 ../src/guestfs-actions.pod:2813 ../src/guestfs-actions.pod:2856 ../src/guestfs-actions.pod:2885 ../src/guestfs-actions.pod:2916 ../src/guestfs-actions.pod:2940 ../src/guestfs-actions.pod:2995 ../src/guestfs-actions.pod:3037 ../src/guestfs-actions.pod:3058 ../src/guestfs-actions.pod:3081 ../src/guestfs-actions.pod:3098 ../src/guestfs-actions.pod:3115 ../src/guestfs-actions.pod:3134
10001 msgid ""
10002 "This function should only be called with a root device string as returned by "
10003 "C<guestfs_inspect_os>."
10004 msgstr ""
10005
10006 #. type: textblock
10007 #: ../src/guestfs-actions.pod:2521
10008 msgid ""
10009 "This returns the architecture of the inspected operating system.  The "
10010 "possible return values are listed under C<guestfs_file_architecture>."
10011 msgstr ""
10012
10013 #. type: textblock
10014 #: ../src/guestfs-actions.pod:2525 ../fish/guestfish-actions.pod:1697
10015 msgid ""
10016 "If the architecture could not be determined, then the string C<unknown> is "
10017 "returned."
10018 msgstr ""
10019
10020 #. type: textblock
10021 #: ../src/guestfs-actions.pod:2528 ../src/guestfs-actions.pod:2621 ../src/guestfs-actions.pod:2732 ../src/guestfs-actions.pod:2752 ../src/guestfs-actions.pod:2780 ../src/guestfs-actions.pod:2872 ../src/guestfs-actions.pod:2903 ../src/guestfs-actions.pod:2927 ../src/guestfs-actions.pod:2981 ../src/guestfs-actions.pod:3024 ../src/guestfs-actions.pod:3047 ../src/guestfs-actions.pod:3068 ../src/guestfs-actions.pod:3088 ../src/guestfs-actions.pod:3105 ../src/guestfs-actions.pod:3124 ../src/guestfs-actions.pod:3227 ../src/guestfs-actions.pod:3268 ../fish/guestfish-actions.pod:1700 ../fish/guestfish-actions.pod:1786 ../fish/guestfish-actions.pod:1874 ../fish/guestfish-actions.pod:1889 ../fish/guestfish-actions.pod:1910 ../fish/guestfish-actions.pod:1980 ../fish/guestfish-actions.pod:2004 ../fish/guestfish-actions.pod:2021 ../fish/guestfish-actions.pod:2064 ../fish/guestfish-actions.pod:2099 ../fish/guestfish-actions.pod:2115 ../fish/guestfish-actions.pod:2131 ../fish/guestfish-actions.pod:2144 ../fish/guestfish-actions.pod:2157 ../fish/guestfish-actions.pod:2172 ../fish/guestfish-actions.pod:2271 ../fish/guestfish-actions.pod:2305
10022 msgid "Please read L<guestfs(3)/INSPECTION> for more details."
10023 msgstr ""
10024
10025 #. type: =head2
10026 #: ../src/guestfs-actions.pod:2535
10027 msgid "guestfs_inspect_get_distro"
10028 msgstr ""
10029
10030 #. type: verbatim
10031 #: ../src/guestfs-actions.pod:2537
10032 #, no-wrap
10033 msgid ""
10034 " char *\n"
10035 " guestfs_inspect_get_distro (guestfs_h *g,\n"
10036 "                             const char *root);\n"
10037 "\n"
10038 msgstr ""
10039
10040 #. type: textblock
10041 #: ../src/guestfs-actions.pod:2544 ../fish/guestfish-actions.pod:1709
10042 msgid "This returns the distro (distribution) of the inspected operating system."
10043 msgstr ""
10044
10045 #. type: textblock
10046 #: ../src/guestfs-actions.pod:2547 ../fish/guestfish-actions.pod:1712
10047 msgid "Currently defined distros are:"
10048 msgstr ""
10049
10050 #. type: =item
10051 #: ../src/guestfs-actions.pod:2551 ../fish/guestfish-actions.pod:1716
10052 msgid "\"archlinux\""
10053 msgstr ""
10054
10055 #. type: textblock
10056 #: ../src/guestfs-actions.pod:2553 ../fish/guestfish-actions.pod:1718
10057 msgid "Arch Linux."
10058 msgstr ""
10059
10060 #. type: =item
10061 #: ../src/guestfs-actions.pod:2555 ../fish/guestfish-actions.pod:1720
10062 msgid "\"centos\""
10063 msgstr ""
10064
10065 #. type: textblock
10066 #: ../src/guestfs-actions.pod:2557 ../fish/guestfish-actions.pod:1722
10067 msgid "CentOS."
10068 msgstr ""
10069
10070 #. type: =item
10071 #: ../src/guestfs-actions.pod:2559 ../fish/guestfish-actions.pod:1724
10072 msgid "\"debian\""
10073 msgstr ""
10074
10075 #. type: textblock
10076 #: ../src/guestfs-actions.pod:2561 ../fish/guestfish-actions.pod:1726
10077 msgid "Debian."
10078 msgstr ""
10079
10080 #. type: =item
10081 #: ../src/guestfs-actions.pod:2563 ../fish/guestfish-actions.pod:1728
10082 msgid "\"fedora\""
10083 msgstr ""
10084
10085 #. type: textblock
10086 #: ../src/guestfs-actions.pod:2565 ../fish/guestfish-actions.pod:1730
10087 msgid "Fedora."
10088 msgstr ""
10089
10090 #. type: =item
10091 #: ../src/guestfs-actions.pod:2567 ../fish/guestfish-actions.pod:1732
10092 msgid "\"gentoo\""
10093 msgstr ""
10094
10095 #. type: textblock
10096 #: ../src/guestfs-actions.pod:2569 ../fish/guestfish-actions.pod:1734
10097 msgid "Gentoo."
10098 msgstr ""
10099
10100 #. type: =item
10101 #: ../src/guestfs-actions.pod:2571 ../fish/guestfish-actions.pod:1736
10102 msgid "\"linuxmint\""
10103 msgstr ""
10104
10105 #. type: textblock
10106 #: ../src/guestfs-actions.pod:2573 ../fish/guestfish-actions.pod:1738
10107 msgid "Linux Mint."
10108 msgstr ""
10109
10110 #. type: =item
10111 #: ../src/guestfs-actions.pod:2575 ../fish/guestfish-actions.pod:1740
10112 msgid "\"mandriva\""
10113 msgstr ""
10114
10115 #. type: textblock
10116 #: ../src/guestfs-actions.pod:2577 ../fish/guestfish-actions.pod:1742
10117 msgid "Mandriva."
10118 msgstr ""
10119
10120 #. type: =item
10121 #: ../src/guestfs-actions.pod:2579 ../fish/guestfish-actions.pod:1744
10122 msgid "\"meego\""
10123 msgstr ""
10124
10125 #. type: textblock
10126 #: ../src/guestfs-actions.pod:2581 ../fish/guestfish-actions.pod:1746
10127 msgid "MeeGo."
10128 msgstr ""
10129
10130 #. type: =item
10131 #: ../src/guestfs-actions.pod:2583 ../fish/guestfish-actions.pod:1748
10132 msgid "\"pardus\""
10133 msgstr ""
10134
10135 #. type: textblock
10136 #: ../src/guestfs-actions.pod:2585 ../fish/guestfish-actions.pod:1750
10137 msgid "Pardus."
10138 msgstr ""
10139
10140 #. type: =item
10141 #: ../src/guestfs-actions.pod:2587 ../fish/guestfish-actions.pod:1752
10142 msgid "\"redhat-based\""
10143 msgstr ""
10144
10145 #. type: textblock
10146 #: ../src/guestfs-actions.pod:2589 ../fish/guestfish-actions.pod:1754
10147 msgid "Some Red Hat-derived distro."
10148 msgstr ""
10149
10150 #. type: =item
10151 #: ../src/guestfs-actions.pod:2591 ../fish/guestfish-actions.pod:1756
10152 msgid "\"rhel\""
10153 msgstr ""
10154
10155 #. type: textblock
10156 #: ../src/guestfs-actions.pod:2593 ../fish/guestfish-actions.pod:1758
10157 msgid "Red Hat Enterprise Linux."
10158 msgstr ""
10159
10160 #. type: =item
10161 #: ../src/guestfs-actions.pod:2595 ../fish/guestfish-actions.pod:1760
10162 msgid "\"scientificlinux\""
10163 msgstr ""
10164
10165 #. type: textblock
10166 #: ../src/guestfs-actions.pod:2597 ../fish/guestfish-actions.pod:1762
10167 msgid "Scientific Linux."
10168 msgstr ""
10169
10170 #. type: =item
10171 #: ../src/guestfs-actions.pod:2599 ../fish/guestfish-actions.pod:1764
10172 msgid "\"slackware\""
10173 msgstr ""
10174
10175 #. type: textblock
10176 #: ../src/guestfs-actions.pod:2601 ../fish/guestfish-actions.pod:1766
10177 msgid "Slackware."
10178 msgstr ""
10179
10180 #. type: =item
10181 #: ../src/guestfs-actions.pod:2603 ../fish/guestfish-actions.pod:1768
10182 msgid "\"ubuntu\""
10183 msgstr ""
10184
10185 #. type: textblock
10186 #: ../src/guestfs-actions.pod:2605 ../fish/guestfish-actions.pod:1770
10187 msgid "Ubuntu."
10188 msgstr ""
10189
10190 #. type: =item
10191 #: ../src/guestfs-actions.pod:2607 ../src/guestfs-actions.pod:2723 ../src/guestfs-actions.pod:3015 ../fish/guestfish-actions.pod:1772 ../fish/guestfish-actions.pod:1865 ../fish/guestfish-actions.pod:2090
10192 msgid "\"unknown\""
10193 msgstr ""
10194
10195 #. type: textblock
10196 #: ../src/guestfs-actions.pod:2609 ../fish/guestfish-actions.pod:1774
10197 msgid "The distro could not be determined."
10198 msgstr ""
10199
10200 #. type: =item
10201 #: ../src/guestfs-actions.pod:2611 ../src/guestfs-actions.pod:3007 ../fish/guestfish-actions.pod:1776 ../fish/guestfish-actions.pod:2082
10202 msgid "\"windows\""
10203 msgstr ""
10204
10205 #. type: textblock
10206 #: ../src/guestfs-actions.pod:2613 ../fish/guestfish-actions.pod:1778
10207 msgid ""
10208 "Windows does not have distributions.  This string is returned if the OS type "
10209 "is Windows."
10210 msgstr ""
10211
10212 #. type: textblock
10213 #: ../src/guestfs-actions.pod:2618 ../src/guestfs-actions.pod:2729 ../src/guestfs-actions.pod:3021 ../fish/guestfish-actions.pod:1783 ../fish/guestfish-actions.pod:1871 ../fish/guestfish-actions.pod:2096
10214 msgid ""
10215 "Future versions of libguestfs may return other strings here.  The caller "
10216 "should be prepared to handle any string."
10217 msgstr ""
10218
10219 #. type: =head2
10220 #: ../src/guestfs-actions.pod:2628
10221 msgid "guestfs_inspect_get_drive_mappings"
10222 msgstr ""
10223
10224 #. type: verbatim
10225 #: ../src/guestfs-actions.pod:2630
10226 #, no-wrap
10227 msgid ""
10228 " char **\n"
10229 " guestfs_inspect_get_drive_mappings (guestfs_h *g,\n"
10230 "                                     const char *root);\n"
10231 "\n"
10232 msgstr ""
10233
10234 #. type: textblock
10235 #: ../src/guestfs-actions.pod:2637 ../fish/guestfish-actions.pod:1795
10236 msgid ""
10237 "This call is useful for Windows which uses a primitive system of assigning "
10238 "drive letters (like \"C:\") to partitions.  This inspection API examines the "
10239 "Windows Registry to find out how disks/partitions are mapped to drive "
10240 "letters, and returns a hash table as in the example below:"
10241 msgstr ""
10242
10243 #. type: verbatim
10244 #: ../src/guestfs-actions.pod:2643 ../fish/guestfish-actions.pod:1801
10245 #, no-wrap
10246 msgid ""
10247 " C      =>     /dev/vda2\n"
10248 " E      =>     /dev/vdb1\n"
10249 " F      =>     /dev/vdc1\n"
10250 "\n"
10251 msgstr ""
10252
10253 #. type: textblock
10254 #: ../src/guestfs-actions.pod:2647 ../fish/guestfish-actions.pod:1805
10255 msgid ""
10256 "Note that keys are drive letters.  For Windows, the key is case insensitive "
10257 "and just contains the drive letter, without the customary colon separator "
10258 "character."
10259 msgstr ""
10260
10261 #. type: textblock
10262 #: ../src/guestfs-actions.pod:2651 ../fish/guestfish-actions.pod:1809
10263 msgid ""
10264 "In future we may support other operating systems that also used drive "
10265 "letters, but the keys for those might not be case insensitive and might be "
10266 "longer than 1 character.  For example in OS-9, hard drives were named C<h0>, "
10267 "C<h1> etc."
10268 msgstr ""
10269
10270 #. type: textblock
10271 #: ../src/guestfs-actions.pod:2656 ../fish/guestfish-actions.pod:1814
10272 msgid ""
10273 "For Windows guests, currently only hard drive mappings are returned.  "
10274 "Removable disks (eg. DVD-ROMs) are ignored."
10275 msgstr ""
10276
10277 #. type: textblock
10278 #: ../src/guestfs-actions.pod:2659 ../fish/guestfish-actions.pod:1817
10279 msgid ""
10280 "For guests that do not use drive mappings, or if the drive mappings could "
10281 "not be determined, this returns an empty hash table."
10282 msgstr ""
10283
10284 #. type: textblock
10285 #: ../src/guestfs-actions.pod:2662
10286 msgid ""
10287 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
10288 "C<guestfs_inspect_get_mountpoints>, C<guestfs_inspect_get_filesystems>."
10289 msgstr ""
10290
10291 #. type: textblock
10292 #: ../src/guestfs-actions.pod:2666 ../src/guestfs-actions.pod:2842 ../src/guestfs-actions.pod:3602 ../src/guestfs-actions.pod:4819 ../src/guestfs-actions.pod:6761
10293 msgid ""
10294 "This function returns a NULL-terminated array of strings, or NULL if there "
10295 "was an error.  The array of strings will always have length C<2n+1>, where "
10296 "C<n> keys and values alternate, followed by the trailing NULL entry.  I<The "
10297 "caller must free the strings and the array after use>."
10298 msgstr ""
10299
10300 #. type: =head2
10301 #: ../src/guestfs-actions.pod:2672
10302 msgid "guestfs_inspect_get_filesystems"
10303 msgstr ""
10304
10305 #. type: verbatim
10306 #: ../src/guestfs-actions.pod:2674
10307 #, no-wrap
10308 msgid ""
10309 " char **\n"
10310 " guestfs_inspect_get_filesystems (guestfs_h *g,\n"
10311 "                                  const char *root);\n"
10312 "\n"
10313 msgstr ""
10314
10315 #. type: textblock
10316 #: ../src/guestfs-actions.pod:2681 ../fish/guestfish-actions.pod:1831
10317 msgid ""
10318 "This returns a list of all the filesystems that we think are associated with "
10319 "this operating system.  This includes the root filesystem, other ordinary "
10320 "filesystems, and non-mounted devices like swap partitions."
10321 msgstr ""
10322
10323 #. type: textblock
10324 #: ../src/guestfs-actions.pod:2686 ../fish/guestfish-actions.pod:1836
10325 msgid ""
10326 "In the case of a multi-boot virtual machine, it is possible for a filesystem "
10327 "to be shared between operating systems."
10328 msgstr ""
10329
10330 #. type: textblock
10331 #: ../src/guestfs-actions.pod:2689
10332 msgid ""
10333 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
10334 "C<guestfs_inspect_get_mountpoints>."
10335 msgstr ""
10336
10337 #. type: =head2
10338 #: ../src/guestfs-actions.pod:2698
10339 msgid "guestfs_inspect_get_format"
10340 msgstr ""
10341
10342 #. type: verbatim
10343 #: ../src/guestfs-actions.pod:2700
10344 #, no-wrap
10345 msgid ""
10346 " char *\n"
10347 " guestfs_inspect_get_format (guestfs_h *g,\n"
10348 "                             const char *root);\n"
10349 "\n"
10350 msgstr ""
10351
10352 #. type: textblock
10353 #: ../src/guestfs-actions.pod:2707 ../fish/guestfish-actions.pod:1849
10354 msgid ""
10355 "This returns the format of the inspected operating system.  You can use it "
10356 "to detect install images, live CDs and similar."
10357 msgstr ""
10358
10359 #. type: textblock
10360 #: ../src/guestfs-actions.pod:2710 ../fish/guestfish-actions.pod:1852
10361 msgid "Currently defined formats are:"
10362 msgstr ""
10363
10364 #. type: =item
10365 #: ../src/guestfs-actions.pod:2714 ../fish/guestfish-actions.pod:1856
10366 msgid "\"installed\""
10367 msgstr ""
10368
10369 #. type: textblock
10370 #: ../src/guestfs-actions.pod:2716 ../fish/guestfish-actions.pod:1858
10371 msgid "This is an installed operating system."
10372 msgstr ""
10373
10374 #. type: =item
10375 #: ../src/guestfs-actions.pod:2718 ../fish/guestfish-actions.pod:1860
10376 msgid "\"installer\""
10377 msgstr ""
10378
10379 #. type: textblock
10380 #: ../src/guestfs-actions.pod:2720 ../fish/guestfish-actions.pod:1862
10381 msgid ""
10382 "The disk image being inspected is not an installed operating system, but a "
10383 "I<bootable> install disk, live CD, or similar."
10384 msgstr ""
10385
10386 #. type: textblock
10387 #: ../src/guestfs-actions.pod:2725 ../fish/guestfish-actions.pod:1867
10388 msgid "The format of this disk image is not known."
10389 msgstr ""
10390
10391 #. type: =head2
10392 #: ../src/guestfs-actions.pod:2737
10393 msgid "guestfs_inspect_get_hostname"
10394 msgstr ""
10395
10396 #. type: verbatim
10397 #: ../src/guestfs-actions.pod:2739
10398 #, no-wrap
10399 msgid ""
10400 " char *\n"
10401 " guestfs_inspect_get_hostname (guestfs_h *g,\n"
10402 "                               const char *root);\n"
10403 "\n"
10404 msgstr ""
10405
10406 #. type: textblock
10407 #: ../src/guestfs-actions.pod:2746 ../fish/guestfish-actions.pod:1883
10408 msgid ""
10409 "This function returns the hostname of the operating system as found by "
10410 "inspection of the guest's configuration files."
10411 msgstr ""
10412
10413 #. type: textblock
10414 #: ../src/guestfs-actions.pod:2749 ../fish/guestfish-actions.pod:1886
10415 msgid ""
10416 "If the hostname could not be determined, then the string C<unknown> is "
10417 "returned."
10418 msgstr ""
10419
10420 #. type: textblock
10421 #: ../src/guestfs-actions.pod:2757
10422 msgid "(Added in 1.7.9)"
10423 msgstr ""
10424
10425 #. type: =head2
10426 #: ../src/guestfs-actions.pod:2759
10427 msgid "guestfs_inspect_get_major_version"
10428 msgstr ""
10429
10430 #. type: verbatim
10431 #: ../src/guestfs-actions.pod:2761
10432 #, no-wrap
10433 msgid ""
10434 " int\n"
10435 " guestfs_inspect_get_major_version (guestfs_h *g,\n"
10436 "                                    const char *root);\n"
10437 "\n"
10438 msgstr ""
10439
10440 #. type: textblock
10441 #: ../src/guestfs-actions.pod:2768 ../fish/guestfish-actions.pod:1898
10442 msgid "This returns the major version number of the inspected operating system."
10443 msgstr ""
10444
10445 #. type: textblock
10446 #: ../src/guestfs-actions.pod:2771 ../fish/guestfish-actions.pod:1901
10447 msgid ""
10448 "Windows uses a consistent versioning scheme which is I<not> reflected in the "
10449 "popular public names used by the operating system.  Notably the operating "
10450 "system known as \"Windows 7\" is really version 6.1 (ie. major = 6, minor = "
10451 "1).  You can find out the real versions corresponding to releases of Windows "
10452 "by consulting Wikipedia or MSDN."
10453 msgstr ""
10454
10455 #. type: textblock
10456 #: ../src/guestfs-actions.pod:2778 ../src/guestfs-actions.pod:2798 ../fish/guestfish-actions.pod:1908 ../fish/guestfish-actions.pod:1922
10457 msgid "If the version could not be determined, then C<0> is returned."
10458 msgstr ""
10459
10460 #. type: =head2
10461 #: ../src/guestfs-actions.pod:2786
10462 msgid "guestfs_inspect_get_minor_version"
10463 msgstr ""
10464
10465 #. type: verbatim
10466 #: ../src/guestfs-actions.pod:2788
10467 #, no-wrap
10468 msgid ""
10469 " int\n"
10470 " guestfs_inspect_get_minor_version (guestfs_h *g,\n"
10471 "                                    const char *root);\n"
10472 "\n"
10473 msgstr ""
10474
10475 #. type: textblock
10476 #: ../src/guestfs-actions.pod:2795 ../fish/guestfish-actions.pod:1919
10477 msgid "This returns the minor version number of the inspected operating system."
10478 msgstr ""
10479
10480 #. type: textblock
10481 #: ../src/guestfs-actions.pod:2800
10482 msgid ""
10483 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
10484 "C<guestfs_inspect_get_major_version>."
10485 msgstr ""
10486
10487 #. type: =head2
10488 #: ../src/guestfs-actions.pod:2807
10489 msgid "guestfs_inspect_get_mountpoints"
10490 msgstr ""
10491
10492 #. type: verbatim
10493 #: ../src/guestfs-actions.pod:2809
10494 #, no-wrap
10495 msgid ""
10496 " char **\n"
10497 " guestfs_inspect_get_mountpoints (guestfs_h *g,\n"
10498 "                                  const char *root);\n"
10499 "\n"
10500 msgstr ""
10501
10502 #. type: textblock
10503 #: ../src/guestfs-actions.pod:2816 ../fish/guestfish-actions.pod:1934
10504 msgid ""
10505 "This returns a hash of where we think the filesystems associated with this "
10506 "operating system should be mounted.  Callers should note that this is at "
10507 "best an educated guess made by reading configuration files such as "
10508 "C</etc/fstab>.  I<In particular note> that this may return filesystems which "
10509 "are non-existent or not mountable and callers should be prepared to handle "
10510 "or ignore failures if they try to mount them."
10511 msgstr ""
10512
10513 #. type: textblock
10514 #: ../src/guestfs-actions.pod:2825 ../fish/guestfish-actions.pod:1943
10515 msgid ""
10516 "Each element in the returned hashtable has a key which is the path of the "
10517 "mountpoint (eg. C</boot>) and a value which is the filesystem that would be "
10518 "mounted there (eg. C</dev/sda1>)."
10519 msgstr ""
10520
10521 #. type: textblock
10522 #: ../src/guestfs-actions.pod:2830 ../fish/guestfish-actions.pod:1948
10523 msgid "Non-mounted devices such as swap devices are I<not> returned in this list."
10524 msgstr ""
10525
10526 #. type: textblock
10527 #: ../src/guestfs-actions.pod:2833
10528 msgid ""
10529 "For operating systems like Windows which still use drive letters, this call "
10530 "will only return an entry for the first drive \"mounted on\" C</>.  For "
10531 "information about the mapping of drive letters to partitions, see "
10532 "C<guestfs_inspect_get_drive_mappings>."
10533 msgstr ""
10534
10535 #. type: textblock
10536 #: ../src/guestfs-actions.pod:2839
10537 msgid ""
10538 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
10539 "C<guestfs_inspect_get_filesystems>."
10540 msgstr ""
10541
10542 #. type: =head2
10543 #: ../src/guestfs-actions.pod:2850
10544 msgid "guestfs_inspect_get_package_format"
10545 msgstr ""
10546
10547 #. type: verbatim
10548 #: ../src/guestfs-actions.pod:2852
10549 #, no-wrap
10550 msgid ""
10551 " char *\n"
10552 " guestfs_inspect_get_package_format (guestfs_h *g,\n"
10553 "                                     const char *root);\n"
10554 "\n"
10555 msgstr ""
10556
10557 #. type: textblock
10558 #: ../src/guestfs-actions.pod:2859
10559 msgid ""
10560 "This function and C<guestfs_inspect_get_package_management> return the "
10561 "package format and package management tool used by the inspected operating "
10562 "system.  For example for Fedora these functions would return C<rpm> (package "
10563 "format) and C<yum> (package management)."
10564 msgstr ""
10565
10566 #. type: textblock
10567 #: ../src/guestfs-actions.pod:2865 ../fish/guestfish-actions.pod:1973
10568 msgid ""
10569 "This returns the string C<unknown> if we could not determine the package "
10570 "format I<or> if the operating system does not have a real packaging system "
10571 "(eg. Windows)."
10572 msgstr ""
10573
10574 #. type: textblock
10575 #: ../src/guestfs-actions.pod:2869 ../fish/guestfish-actions.pod:1977
10576 msgid ""
10577 "Possible strings include: C<rpm>, C<deb>, C<ebuild>, C<pisi>, C<pacman>.  "
10578 "Future versions of libguestfs may return other strings."
10579 msgstr ""
10580
10581 #. type: textblock
10582 #: ../src/guestfs-actions.pod:2877 ../src/guestfs-actions.pod:2908
10583 msgid "(Added in 1.7.5)"
10584 msgstr ""
10585
10586 #. type: =head2
10587 #: ../src/guestfs-actions.pod:2879
10588 msgid "guestfs_inspect_get_package_management"
10589 msgstr ""
10590
10591 #. type: verbatim
10592 #: ../src/guestfs-actions.pod:2881
10593 #, no-wrap
10594 msgid ""
10595 " char *\n"
10596 " guestfs_inspect_get_package_management (guestfs_h *g,\n"
10597 "                                         const char *root);\n"
10598 "\n"
10599 msgstr ""
10600
10601 #. type: textblock
10602 #: ../src/guestfs-actions.pod:2888
10603 msgid ""
10604 "C<guestfs_inspect_get_package_format> and this function return the package "
10605 "format and package management tool used by the inspected operating system.  "
10606 "For example for Fedora these functions would return C<rpm> (package format) "
10607 "and C<yum> (package management)."
10608 msgstr ""
10609
10610 #. type: textblock
10611 #: ../src/guestfs-actions.pod:2894 ../fish/guestfish-actions.pod:1995
10612 msgid ""
10613 "This returns the string C<unknown> if we could not determine the package "
10614 "management tool I<or> if the operating system does not have a real packaging "
10615 "system (eg. Windows)."
10616 msgstr ""
10617
10618 #. type: textblock
10619 #: ../src/guestfs-actions.pod:2898 ../fish/guestfish-actions.pod:1999
10620 msgid ""
10621 "Possible strings include: C<yum>, C<up2date>, C<apt> (for all Debian "
10622 "derivatives), C<portage>, C<pisi>, C<pacman>, C<urpmi>.  Future versions of "
10623 "libguestfs may return other strings."
10624 msgstr ""
10625
10626 #. type: =head2
10627 #: ../src/guestfs-actions.pod:2910
10628 msgid "guestfs_inspect_get_product_name"
10629 msgstr ""
10630
10631 #. type: verbatim
10632 #: ../src/guestfs-actions.pod:2912
10633 #, no-wrap
10634 msgid ""
10635 " char *\n"
10636 " guestfs_inspect_get_product_name (guestfs_h *g,\n"
10637 "                                   const char *root);\n"
10638 "\n"
10639 msgstr ""
10640
10641 #. type: textblock
10642 #: ../src/guestfs-actions.pod:2919 ../fish/guestfish-actions.pod:2013
10643 msgid ""
10644 "This returns the product name of the inspected operating system.  The "
10645 "product name is generally some freeform string which can be displayed to the "
10646 "user, but should not be parsed by programs."
10647 msgstr ""
10648
10649 #. type: textblock
10650 #: ../src/guestfs-actions.pod:2924 ../fish/guestfish-actions.pod:2018
10651 msgid ""
10652 "If the product name could not be determined, then the string C<unknown> is "
10653 "returned."
10654 msgstr ""
10655
10656 #. type: =head2
10657 #: ../src/guestfs-actions.pod:2934
10658 msgid "guestfs_inspect_get_product_variant"
10659 msgstr ""
10660
10661 #. type: verbatim
10662 #: ../src/guestfs-actions.pod:2936
10663 #, no-wrap
10664 msgid ""
10665 " char *\n"
10666 " guestfs_inspect_get_product_variant (guestfs_h *g,\n"
10667 "                                      const char *root);\n"
10668 "\n"
10669 msgstr ""
10670
10671 #. type: textblock
10672 #: ../src/guestfs-actions.pod:2943 ../fish/guestfish-actions.pod:2030
10673 msgid "This returns the product variant of the inspected operating system."
10674 msgstr ""
10675
10676 #. type: textblock
10677 #: ../src/guestfs-actions.pod:2946 ../fish/guestfish-actions.pod:2033
10678 msgid ""
10679 "For Windows guests, this returns the contents of the Registry key "
10680 "C<HKLM\\Software\\Microsoft\\Windows NT\\CurrentVersion> C<InstallationType> "
10681 "which is usually a string such as C<Client> or C<Server> (other values are "
10682 "possible).  This can be used to distinguish consumer and enterprise versions "
10683 "of Windows that have the same version number (for example, Windows 7 and "
10684 "Windows 2008 Server are both version 6.1, but the former is C<Client> and "
10685 "the latter is C<Server>)."
10686 msgstr ""
10687
10688 #. type: textblock
10689 #: ../src/guestfs-actions.pod:2955 ../fish/guestfish-actions.pod:2042
10690 msgid ""
10691 "For enterprise Linux guests, in future we intend this to return the product "
10692 "variant such as C<Desktop>, C<Server> and so on.  But this is not "
10693 "implemented at present."
10694 msgstr ""
10695
10696 #. type: textblock
10697 #: ../src/guestfs-actions.pod:2959 ../fish/guestfish-actions.pod:2046
10698 msgid ""
10699 "If the product variant could not be determined, then the string C<unknown> "
10700 "is returned."
10701 msgstr ""
10702
10703 #. type: textblock
10704 #: ../src/guestfs-actions.pod:2962
10705 msgid ""
10706 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
10707 "C<guestfs_inspect_get_product_name>, C<guestfs_inspect_get_major_version>."
10708 msgstr ""
10709
10710 #. type: =head2
10711 #: ../src/guestfs-actions.pod:2969
10712 msgid "guestfs_inspect_get_roots"
10713 msgstr ""
10714
10715 #. type: verbatim
10716 #: ../src/guestfs-actions.pod:2971
10717 #, no-wrap
10718 msgid ""
10719 " char **\n"
10720 " guestfs_inspect_get_roots (guestfs_h *g);\n"
10721 "\n"
10722 msgstr ""
10723
10724 #. type: textblock
10725 #: ../src/guestfs-actions.pod:2974
10726 msgid ""
10727 "This function is a convenient way to get the list of root devices, as "
10728 "returned from a previous call to C<guestfs_inspect_os>, but without redoing "
10729 "the whole inspection process."
10730 msgstr ""
10731
10732 #. type: textblock
10733 #: ../src/guestfs-actions.pod:2978
10734 msgid ""
10735 "This returns an empty list if either no root devices were found or the "
10736 "caller has not called C<guestfs_inspect_os>."
10737 msgstr ""
10738
10739 #. type: textblock
10740 #: ../src/guestfs-actions.pod:2987
10741 msgid "(Added in 1.7.3)"
10742 msgstr ""
10743
10744 #. type: =head2
10745 #: ../src/guestfs-actions.pod:2989
10746 msgid "guestfs_inspect_get_type"
10747 msgstr ""
10748
10749 #. type: verbatim
10750 #: ../src/guestfs-actions.pod:2991
10751 #, no-wrap
10752 msgid ""
10753 " char *\n"
10754 " guestfs_inspect_get_type (guestfs_h *g,\n"
10755 "                           const char *root);\n"
10756 "\n"
10757 msgstr ""
10758
10759 #. type: textblock
10760 #: ../src/guestfs-actions.pod:2998 ../fish/guestfish-actions.pod:2073
10761 msgid ""
10762 "This returns the type of the inspected operating system.  Currently defined "
10763 "types are:"
10764 msgstr ""
10765
10766 #. type: =item
10767 #: ../src/guestfs-actions.pod:3003 ../fish/guestfish-actions.pod:2078
10768 msgid "\"linux\""
10769 msgstr ""
10770
10771 #. type: textblock
10772 #: ../src/guestfs-actions.pod:3005 ../fish/guestfish-actions.pod:2080
10773 msgid "Any Linux-based operating system."
10774 msgstr ""
10775
10776 #. type: textblock
10777 #: ../src/guestfs-actions.pod:3009 ../fish/guestfish-actions.pod:2084
10778 msgid "Any Microsoft Windows operating system."
10779 msgstr ""
10780
10781 #. type: =item
10782 #: ../src/guestfs-actions.pod:3011 ../fish/guestfish-actions.pod:2086
10783 msgid "\"freebsd\""
10784 msgstr ""
10785
10786 #. type: textblock
10787 #: ../src/guestfs-actions.pod:3013 ../fish/guestfish-actions.pod:2088
10788 msgid "FreeBSD."
10789 msgstr ""
10790
10791 #. type: textblock
10792 #: ../src/guestfs-actions.pod:3017 ../fish/guestfish-actions.pod:2092
10793 msgid "The operating system type could not be determined."
10794 msgstr ""
10795
10796 #. type: =head2
10797 #: ../src/guestfs-actions.pod:3031
10798 msgid "guestfs_inspect_get_windows_current_control_set"
10799 msgstr ""
10800
10801 #. type: verbatim
10802 #: ../src/guestfs-actions.pod:3033
10803 #, no-wrap
10804 msgid ""
10805 " char *\n"
10806 " guestfs_inspect_get_windows_current_control_set (guestfs_h *g,\n"
10807 "                                                  const char *root);\n"
10808 "\n"
10809 msgstr ""
10810
10811 #. type: textblock
10812 #: ../src/guestfs-actions.pod:3040 ../fish/guestfish-actions.pod:2108
10813 msgid ""
10814 "This returns the Windows CurrentControlSet of the inspected guest.  The "
10815 "CurrentControlSet is a registry key name such as C<ControlSet001>."
10816 msgstr ""
10817
10818 #. type: textblock
10819 #: ../src/guestfs-actions.pod:3043 ../fish/guestfish-actions.pod:2111
10820 msgid ""
10821 "This call assumes that the guest is Windows and that the Registry could be "
10822 "examined by inspection.  If this is not the case then an error is returned."
10823 msgstr ""
10824
10825 #. type: =head2
10826 #: ../src/guestfs-actions.pod:3052
10827 msgid "guestfs_inspect_get_windows_systemroot"
10828 msgstr ""
10829
10830 #. type: verbatim
10831 #: ../src/guestfs-actions.pod:3054
10832 #, no-wrap
10833 msgid ""
10834 " char *\n"
10835 " guestfs_inspect_get_windows_systemroot (guestfs_h *g,\n"
10836 "                                         const char *root);\n"
10837 "\n"
10838 msgstr ""
10839
10840 #. type: textblock
10841 #: ../src/guestfs-actions.pod:3061 ../fish/guestfish-actions.pod:2124
10842 msgid ""
10843 "This returns the Windows systemroot of the inspected guest.  The systemroot "
10844 "is a directory path such as C</WINDOWS>."
10845 msgstr ""
10846
10847 #. type: textblock
10848 #: ../src/guestfs-actions.pod:3064 ../fish/guestfish-actions.pod:2127
10849 msgid ""
10850 "This call assumes that the guest is Windows and that the systemroot could be "
10851 "determined by inspection.  If this is not the case then an error is "
10852 "returned."
10853 msgstr ""
10854
10855 #. type: textblock
10856 #: ../src/guestfs-actions.pod:3073
10857 msgid "(Added in 1.5.25)"
10858 msgstr ""
10859
10860 #. type: =head2
10861 #: ../src/guestfs-actions.pod:3075
10862 msgid "guestfs_inspect_is_live"
10863 msgstr ""
10864
10865 #. type: verbatim
10866 #: ../src/guestfs-actions.pod:3077
10867 #, no-wrap
10868 msgid ""
10869 " int\n"
10870 " guestfs_inspect_is_live (guestfs_h *g,\n"
10871 "                          const char *root);\n"
10872 "\n"
10873 msgstr ""
10874
10875 #. type: textblock
10876 #: ../src/guestfs-actions.pod:3084
10877 msgid ""
10878 "If C<guestfs_inspect_get_format> returns C<installer> (this is an install "
10879 "disk), then this returns true if a live image was detected on the disk."
10880 msgstr ""
10881
10882 #. type: =head2
10883 #: ../src/guestfs-actions.pod:3092
10884 msgid "guestfs_inspect_is_multipart"
10885 msgstr ""
10886
10887 #. type: verbatim
10888 #: ../src/guestfs-actions.pod:3094
10889 #, no-wrap
10890 msgid ""
10891 " int\n"
10892 " guestfs_inspect_is_multipart (guestfs_h *g,\n"
10893 "                               const char *root);\n"
10894 "\n"
10895 msgstr ""
10896
10897 #. type: textblock
10898 #: ../src/guestfs-actions.pod:3101
10899 msgid ""
10900 "If C<guestfs_inspect_get_format> returns C<installer> (this is an install "
10901 "disk), then this returns true if the disk is part of a set."
10902 msgstr ""
10903
10904 #. type: =head2
10905 #: ../src/guestfs-actions.pod:3109
10906 msgid "guestfs_inspect_is_netinst"
10907 msgstr ""
10908
10909 #. type: verbatim
10910 #: ../src/guestfs-actions.pod:3111
10911 #, no-wrap
10912 msgid ""
10913 " int\n"
10914 " guestfs_inspect_is_netinst (guestfs_h *g,\n"
10915 "                             const char *root);\n"
10916 "\n"
10917 msgstr ""
10918
10919 #. type: textblock
10920 #: ../src/guestfs-actions.pod:3118
10921 msgid ""
10922 "If C<guestfs_inspect_get_format> returns C<installer> (this is an install "
10923 "disk), then this returns true if the disk is a network installer, ie. not a "
10924 "self-contained install CD but one which is likely to require network access "
10925 "to complete the install."
10926 msgstr ""
10927
10928 #. type: =head2
10929 #: ../src/guestfs-actions.pod:3128
10930 msgid "guestfs_inspect_list_applications"
10931 msgstr ""
10932
10933 #. type: verbatim
10934 #: ../src/guestfs-actions.pod:3130
10935 #, no-wrap
10936 msgid ""
10937 " struct guestfs_application_list *\n"
10938 " guestfs_inspect_list_applications (guestfs_h *g,\n"
10939 "                                    const char *root);\n"
10940 "\n"
10941 msgstr ""
10942
10943 #. type: textblock
10944 #: ../src/guestfs-actions.pod:3137 ../fish/guestfish-actions.pod:2181
10945 msgid "Return the list of applications installed in the operating system."
10946 msgstr ""
10947
10948 #. type: textblock
10949 #: ../src/guestfs-actions.pod:3139
10950 msgid ""
10951 "I<Note:> This call works differently from other parts of the inspection "
10952 "API.  You have to call C<guestfs_inspect_os>, then "
10953 "C<guestfs_inspect_get_mountpoints>, then mount up the disks, before calling "
10954 "this.  Listing applications is a significantly more difficult operation "
10955 "which requires access to the full filesystem.  Also note that unlike the "
10956 "other C<guestfs_inspect_get_*> calls which are just returning data cached in "
10957 "the libguestfs handle, this call actually reads parts of the mounted "
10958 "filesystems during the call."
10959 msgstr ""
10960
10961 #. type: textblock
10962 #: ../src/guestfs-actions.pod:3149 ../fish/guestfish-actions.pod:2193
10963 msgid ""
10964 "This returns an empty list if the inspection code was not able to determine "
10965 "the list of applications."
10966 msgstr ""
10967
10968 #. type: textblock
10969 #: ../src/guestfs-actions.pod:3152 ../fish/guestfish-actions.pod:2196
10970 msgid "The application structure contains the following fields:"
10971 msgstr ""
10972
10973 #. type: =item
10974 #: ../src/guestfs-actions.pod:3156 ../fish/guestfish-actions.pod:2200
10975 msgid "C<app_name>"
10976 msgstr ""
10977
10978 #. type: textblock
10979 #: ../src/guestfs-actions.pod:3158 ../fish/guestfish-actions.pod:2202
10980 msgid ""
10981 "The name of the application.  For Red Hat-derived and Debian-derived Linux "
10982 "guests, this is the package name."
10983 msgstr ""
10984
10985 #. type: =item
10986 #: ../src/guestfs-actions.pod:3161 ../fish/guestfish-actions.pod:2205
10987 msgid "C<app_display_name>"
10988 msgstr ""
10989
10990 #. type: textblock
10991 #: ../src/guestfs-actions.pod:3163 ../fish/guestfish-actions.pod:2207
10992 msgid ""
10993 "The display name of the application, sometimes localized to the install "
10994 "language of the guest operating system."
10995 msgstr ""
10996
10997 #. type: textblock
10998 #: ../src/guestfs-actions.pod:3166 ../fish/guestfish-actions.pod:2210
10999 msgid ""
11000 "If unavailable this is returned as an empty string C<\"\">.  Callers needing "
11001 "to display something can use C<app_name> instead."
11002 msgstr ""
11003
11004 #. type: =item
11005 #: ../src/guestfs-actions.pod:3169 ../fish/guestfish-actions.pod:2213
11006 msgid "C<app_epoch>"
11007 msgstr ""
11008
11009 #. type: textblock
11010 #: ../src/guestfs-actions.pod:3171 ../fish/guestfish-actions.pod:2215
11011 msgid ""
11012 "For package managers which use epochs, this contains the epoch of the "
11013 "package (an integer).  If unavailable, this is returned as C<0>."
11014 msgstr ""
11015
11016 #. type: =item
11017 #: ../src/guestfs-actions.pod:3174 ../fish/guestfish-actions.pod:2218
11018 msgid "C<app_version>"
11019 msgstr ""
11020
11021 #. type: textblock
11022 #: ../src/guestfs-actions.pod:3176 ../fish/guestfish-actions.pod:2220
11023 msgid ""
11024 "The version string of the application or package.  If unavailable this is "
11025 "returned as an empty string C<\"\">."
11026 msgstr ""
11027
11028 #. type: =item
11029 #: ../src/guestfs-actions.pod:3179 ../fish/guestfish-actions.pod:2223
11030 msgid "C<app_release>"
11031 msgstr ""
11032
11033 #. type: textblock
11034 #: ../src/guestfs-actions.pod:3181 ../fish/guestfish-actions.pod:2225
11035 msgid ""
11036 "The release string of the application or package, for package managers that "
11037 "use this.  If unavailable this is returned as an empty string C<\"\">."
11038 msgstr ""
11039
11040 #. type: =item
11041 #: ../src/guestfs-actions.pod:3185 ../fish/guestfish-actions.pod:2229
11042 msgid "C<app_install_path>"
11043 msgstr ""
11044
11045 #. type: textblock
11046 #: ../src/guestfs-actions.pod:3187 ../fish/guestfish-actions.pod:2231
11047 msgid ""
11048 "The installation path of the application (on operating systems such as "
11049 "Windows which use installation paths).  This path is in the format used by "
11050 "the guest operating system, it is not a libguestfs path."
11051 msgstr ""
11052
11053 #. type: textblock
11054 #: ../src/guestfs-actions.pod:3192 ../fish/guestfish-actions.pod:2236
11055 msgid "If unavailable this is returned as an empty string C<\"\">."
11056 msgstr ""
11057
11058 #. type: =item
11059 #: ../src/guestfs-actions.pod:3194 ../fish/guestfish-actions.pod:2238
11060 msgid "C<app_trans_path>"
11061 msgstr ""
11062
11063 #. type: textblock
11064 #: ../src/guestfs-actions.pod:3196 ../fish/guestfish-actions.pod:2240
11065 msgid ""
11066 "The install path translated into a libguestfs path.  If unavailable this is "
11067 "returned as an empty string C<\"\">."
11068 msgstr ""
11069
11070 #. type: =item
11071 #: ../src/guestfs-actions.pod:3199 ../fish/guestfish-actions.pod:2243
11072 msgid "C<app_publisher>"
11073 msgstr ""
11074
11075 #. type: textblock
11076 #: ../src/guestfs-actions.pod:3201 ../fish/guestfish-actions.pod:2245
11077 msgid ""
11078 "The name of the publisher of the application, for package managers that use "
11079 "this.  If unavailable this is returned as an empty string C<\"\">."
11080 msgstr ""
11081
11082 #. type: =item
11083 #: ../src/guestfs-actions.pod:3205 ../fish/guestfish-actions.pod:2249
11084 msgid "C<app_url>"
11085 msgstr ""
11086
11087 #. type: textblock
11088 #: ../src/guestfs-actions.pod:3207 ../fish/guestfish-actions.pod:2251
11089 msgid ""
11090 "The URL (eg. upstream URL) of the application.  If unavailable this is "
11091 "returned as an empty string C<\"\">."
11092 msgstr ""
11093
11094 #. type: =item
11095 #: ../src/guestfs-actions.pod:3210 ../fish/guestfish-actions.pod:2254
11096 msgid "C<app_source_package>"
11097 msgstr ""
11098
11099 #. type: textblock
11100 #: ../src/guestfs-actions.pod:3212 ../fish/guestfish-actions.pod:2256
11101 msgid ""
11102 "For packaging systems which support this, the name of the source package.  "
11103 "If unavailable this is returned as an empty string C<\"\">."
11104 msgstr ""
11105
11106 #. type: =item
11107 #: ../src/guestfs-actions.pod:3215 ../fish/guestfish-actions.pod:2259
11108 msgid "C<app_summary>"
11109 msgstr ""
11110
11111 #. type: textblock
11112 #: ../src/guestfs-actions.pod:3217 ../fish/guestfish-actions.pod:2261
11113 msgid ""
11114 "A short (usually one line) description of the application or package.  If "
11115 "unavailable this is returned as an empty string C<\"\">."
11116 msgstr ""
11117
11118 #. type: =item
11119 #: ../src/guestfs-actions.pod:3220 ../fish/guestfish-actions.pod:2264
11120 msgid "C<app_description>"
11121 msgstr ""
11122
11123 #. type: textblock
11124 #: ../src/guestfs-actions.pod:3222 ../fish/guestfish-actions.pod:2266
11125 msgid ""
11126 "A longer description of the application or package.  If unavailable this is "
11127 "returned as an empty string C<\"\">."
11128 msgstr ""
11129
11130 #. type: textblock
11131 #: ../src/guestfs-actions.pod:3229
11132 msgid ""
11133 "This function returns a C<struct guestfs_application_list *>, or NULL if "
11134 "there was an error.  I<The caller must call C<guestfs_free_application_list> "
11135 "after use>."
11136 msgstr ""
11137
11138 #. type: textblock
11139 #: ../src/guestfs-actions.pod:3233
11140 msgid "(Added in 1.7.8)"
11141 msgstr ""
11142
11143 #. type: =head2
11144 #: ../src/guestfs-actions.pod:3235
11145 msgid "guestfs_inspect_os"
11146 msgstr ""
11147
11148 #. type: verbatim
11149 #: ../src/guestfs-actions.pod:3237
11150 #, no-wrap
11151 msgid ""
11152 " char **\n"
11153 " guestfs_inspect_os (guestfs_h *g);\n"
11154 "\n"
11155 msgstr ""
11156
11157 #. type: textblock
11158 #: ../src/guestfs-actions.pod:3240 ../fish/guestfish-actions.pod:2277
11159 msgid ""
11160 "This function uses other libguestfs functions and certain heuristics to "
11161 "inspect the disk(s) (usually disks belonging to a virtual machine), looking "
11162 "for operating systems."
11163 msgstr ""
11164
11165 #. type: textblock
11166 #: ../src/guestfs-actions.pod:3244 ../fish/guestfish-actions.pod:2281
11167 msgid "The list returned is empty if no operating systems were found."
11168 msgstr ""
11169
11170 #. type: textblock
11171 #: ../src/guestfs-actions.pod:3246 ../fish/guestfish-actions.pod:2283
11172 msgid ""
11173 "If one operating system was found, then this returns a list with a single "
11174 "element, which is the name of the root filesystem of this operating system.  "
11175 "It is also possible for this function to return a list containing more than "
11176 "one element, indicating a dual-boot or multi-boot virtual machine, with each "
11177 "element being the root filesystem of one of the operating systems."
11178 msgstr ""
11179
11180 #. type: textblock
11181 #: ../src/guestfs-actions.pod:3253
11182 msgid ""
11183 "You can pass the root string(s) returned to other C<guestfs_inspect_get_*> "
11184 "functions in order to query further information about each operating system, "
11185 "such as the name and version."
11186 msgstr ""
11187
11188 #. type: textblock
11189 #: ../src/guestfs-actions.pod:3258
11190 msgid ""
11191 "This function uses other libguestfs features such as C<guestfs_mount_ro> and "
11192 "C<guestfs_umount_all> in order to mount and unmount filesystems and look at "
11193 "the contents.  This should be called with no disks currently mounted.  The "
11194 "function may also use Augeas, so any existing Augeas handle will be closed."
11195 msgstr ""
11196
11197 #. type: textblock
11198 #: ../src/guestfs-actions.pod:3264 ../fish/guestfish-actions.pod:2301
11199 msgid ""
11200 "This function cannot decrypt encrypted disks.  The caller must do that first "
11201 "(supplying the necessary keys) if the disk is encrypted."
11202 msgstr ""
11203
11204 #. type: textblock
11205 #: ../src/guestfs-actions.pod:3270 ../src/guestfs-actions.pod:3560 ../src/guestfs-actions.pod:3622
11206 msgid "See also C<guestfs_list_filesystems>."
11207 msgstr ""
11208
11209 #. type: =head2
11210 #: ../src/guestfs-actions.pod:3278
11211 msgid "guestfs_is_blockdev"
11212 msgstr ""
11213
11214 #. type: verbatim
11215 #: ../src/guestfs-actions.pod:3280
11216 #, no-wrap
11217 msgid ""
11218 " int\n"
11219 " guestfs_is_blockdev (guestfs_h *g,\n"
11220 "                      const char *path);\n"
11221 "\n"
11222 msgstr ""
11223
11224 #. type: textblock
11225 #: ../src/guestfs-actions.pod:3284 ../fish/guestfish-actions.pod:2313
11226 msgid ""
11227 "This returns C<true> if and only if there is a block device with the given "
11228 "C<path> name."
11229 msgstr ""
11230
11231 #. type: textblock
11232 #: ../src/guestfs-actions.pod:3287 ../src/guestfs-actions.pod:3316 ../src/guestfs-actions.pod:3346 ../src/guestfs-actions.pod:3361 ../src/guestfs-actions.pod:3377 ../src/guestfs-actions.pod:3433 ../src/guestfs-actions.pod:3448
11233 msgid "See also C<guestfs_stat>."
11234 msgstr ""
11235
11236 #. type: textblock
11237 #: ../src/guestfs-actions.pod:3291 ../src/guestfs-actions.pod:3320 ../src/guestfs-actions.pod:3365 ../src/guestfs-actions.pod:3437 ../src/guestfs-actions.pod:3452
11238 msgid "(Added in 1.5.10)"
11239 msgstr ""
11240
11241 #. type: =head2
11242 #: ../src/guestfs-actions.pod:3293
11243 msgid "guestfs_is_busy"
11244 msgstr ""
11245
11246 #. type: verbatim
11247 #: ../src/guestfs-actions.pod:3295
11248 #, no-wrap
11249 msgid ""
11250 " int\n"
11251 " guestfs_is_busy (guestfs_h *g);\n"
11252 "\n"
11253 msgstr ""
11254
11255 #. type: textblock
11256 #: ../src/guestfs-actions.pod:3298 ../fish/guestfish-actions.pod:2322
11257 msgid ""
11258 "This returns true iff this handle is busy processing a command (in the "
11259 "C<BUSY> state)."
11260 msgstr ""
11261
11262 #. type: =head2
11263 #: ../src/guestfs-actions.pod:3307
11264 msgid "guestfs_is_chardev"
11265 msgstr ""
11266
11267 #. type: verbatim
11268 #: ../src/guestfs-actions.pod:3309
11269 #, no-wrap
11270 msgid ""
11271 " int\n"
11272 " guestfs_is_chardev (guestfs_h *g,\n"
11273 "                     const char *path);\n"
11274 "\n"
11275 msgstr ""
11276
11277 #. type: textblock
11278 #: ../src/guestfs-actions.pod:3313 ../fish/guestfish-actions.pod:2331
11279 msgid ""
11280 "This returns C<true> if and only if there is a character device with the "
11281 "given C<path> name."
11282 msgstr ""
11283
11284 #. type: =head2
11285 #: ../src/guestfs-actions.pod:3322
11286 msgid "guestfs_is_config"
11287 msgstr ""
11288
11289 #. type: verbatim
11290 #: ../src/guestfs-actions.pod:3324
11291 #, no-wrap
11292 msgid ""
11293 " int\n"
11294 " guestfs_is_config (guestfs_h *g);\n"
11295 "\n"
11296 msgstr ""
11297
11298 #. type: textblock
11299 #: ../src/guestfs-actions.pod:3327 ../fish/guestfish-actions.pod:2340
11300 msgid ""
11301 "This returns true iff this handle is being configured (in the C<CONFIG> "
11302 "state)."
11303 msgstr ""
11304
11305 #. type: =head2
11306 #: ../src/guestfs-actions.pod:3336
11307 msgid "guestfs_is_dir"
11308 msgstr ""
11309
11310 #. type: verbatim
11311 #: ../src/guestfs-actions.pod:3338
11312 #, no-wrap
11313 msgid ""
11314 " int\n"
11315 " guestfs_is_dir (guestfs_h *g,\n"
11316 "                 const char *path);\n"
11317 "\n"
11318 msgstr ""
11319
11320 #. type: textblock
11321 #: ../src/guestfs-actions.pod:3342 ../fish/guestfish-actions.pod:2349
11322 msgid ""
11323 "This returns C<true> if and only if there is a directory with the given "
11324 "C<path> name.  Note that it returns false for other objects like files."
11325 msgstr ""
11326
11327 #. type: =head2
11328 #: ../src/guestfs-actions.pod:3352
11329 msgid "guestfs_is_fifo"
11330 msgstr ""
11331
11332 #. type: verbatim
11333 #: ../src/guestfs-actions.pod:3354
11334 #, no-wrap
11335 msgid ""
11336 " int\n"
11337 " guestfs_is_fifo (guestfs_h *g,\n"
11338 "                  const char *path);\n"
11339 "\n"
11340 msgstr ""
11341
11342 #. type: textblock
11343 #: ../src/guestfs-actions.pod:3358 ../fish/guestfish-actions.pod:2359
11344 msgid ""
11345 "This returns C<true> if and only if there is a FIFO (named pipe)  with the "
11346 "given C<path> name."
11347 msgstr ""
11348
11349 #. type: =head2
11350 #: ../src/guestfs-actions.pod:3367
11351 msgid "guestfs_is_file"
11352 msgstr ""
11353
11354 #. type: verbatim
11355 #: ../src/guestfs-actions.pod:3369
11356 #, no-wrap
11357 msgid ""
11358 " int\n"
11359 " guestfs_is_file (guestfs_h *g,\n"
11360 "                  const char *path);\n"
11361 "\n"
11362 msgstr ""
11363
11364 #. type: textblock
11365 #: ../src/guestfs-actions.pod:3373 ../fish/guestfish-actions.pod:2368
11366 msgid ""
11367 "This returns C<true> if and only if there is a regular file with the given "
11368 "C<path> name.  Note that it returns false for other objects like "
11369 "directories."
11370 msgstr ""
11371
11372 #. type: =head2
11373 #: ../src/guestfs-actions.pod:3383
11374 msgid "guestfs_is_launching"
11375 msgstr ""
11376
11377 #. type: verbatim
11378 #: ../src/guestfs-actions.pod:3385
11379 #, no-wrap
11380 msgid ""
11381 " int\n"
11382 " guestfs_is_launching (guestfs_h *g);\n"
11383 "\n"
11384 msgstr ""
11385
11386 #. type: textblock
11387 #: ../src/guestfs-actions.pod:3388 ../fish/guestfish-actions.pod:2378
11388 msgid ""
11389 "This returns true iff this handle is launching the subprocess (in the "
11390 "C<LAUNCHING> state)."
11391 msgstr ""
11392
11393 #. type: =head2
11394 #: ../src/guestfs-actions.pod:3397
11395 msgid "guestfs_is_lv"
11396 msgstr ""
11397
11398 #. type: verbatim
11399 #: ../src/guestfs-actions.pod:3399
11400 #, no-wrap
11401 msgid ""
11402 " int\n"
11403 " guestfs_is_lv (guestfs_h *g,\n"
11404 "                const char *device);\n"
11405 "\n"
11406 msgstr ""
11407
11408 #. type: textblock
11409 #: ../src/guestfs-actions.pod:3403 ../fish/guestfish-actions.pod:2387
11410 msgid ""
11411 "This command tests whether C<device> is a logical volume, and returns true "
11412 "iff this is the case."
11413 msgstr ""
11414
11415 #. type: =head2
11416 #: ../src/guestfs-actions.pod:3410
11417 msgid "guestfs_is_ready"
11418 msgstr ""
11419
11420 #. type: verbatim
11421 #: ../src/guestfs-actions.pod:3412
11422 #, no-wrap
11423 msgid ""
11424 " int\n"
11425 " guestfs_is_ready (guestfs_h *g);\n"
11426 "\n"
11427 msgstr ""
11428
11429 #. type: textblock
11430 #: ../src/guestfs-actions.pod:3415 ../fish/guestfish-actions.pod:2394
11431 msgid ""
11432 "This returns true iff this handle is ready to accept commands (in the "
11433 "C<READY> state)."
11434 msgstr ""
11435
11436 #. type: =head2
11437 #: ../src/guestfs-actions.pod:3424
11438 msgid "guestfs_is_socket"
11439 msgstr ""
11440
11441 #. type: verbatim
11442 #: ../src/guestfs-actions.pod:3426
11443 #, no-wrap
11444 msgid ""
11445 " int\n"
11446 " guestfs_is_socket (guestfs_h *g,\n"
11447 "                    const char *path);\n"
11448 "\n"
11449 msgstr ""
11450
11451 #. type: textblock
11452 #: ../src/guestfs-actions.pod:3430 ../fish/guestfish-actions.pod:2403
11453 msgid ""
11454 "This returns C<true> if and only if there is a Unix domain socket with the "
11455 "given C<path> name."
11456 msgstr ""
11457
11458 #. type: =head2
11459 #: ../src/guestfs-actions.pod:3439
11460 msgid "guestfs_is_symlink"
11461 msgstr ""
11462
11463 #. type: verbatim
11464 #: ../src/guestfs-actions.pod:3441
11465 #, no-wrap
11466 msgid ""
11467 " int\n"
11468 " guestfs_is_symlink (guestfs_h *g,\n"
11469 "                     const char *path);\n"
11470 "\n"
11471 msgstr ""
11472
11473 #. type: textblock
11474 #: ../src/guestfs-actions.pod:3445 ../fish/guestfish-actions.pod:2412
11475 msgid ""
11476 "This returns C<true> if and only if there is a symbolic link with the given "
11477 "C<path> name."
11478 msgstr ""
11479
11480 #. type: =head2
11481 #: ../src/guestfs-actions.pod:3454
11482 msgid "guestfs_kill_subprocess"
11483 msgstr ""
11484
11485 #. type: verbatim
11486 #: ../src/guestfs-actions.pod:3456
11487 #, no-wrap
11488 msgid ""
11489 " int\n"
11490 " guestfs_kill_subprocess (guestfs_h *g);\n"
11491 "\n"
11492 msgstr ""
11493
11494 #. type: textblock
11495 #: ../src/guestfs-actions.pod:3459 ../fish/guestfish-actions.pod:2421
11496 msgid "This kills the qemu subprocess.  You should never need to call this."
11497 msgstr ""
11498
11499 #. type: =head2
11500 #: ../src/guestfs-actions.pod:3465
11501 msgid "guestfs_launch"
11502 msgstr ""
11503
11504 #. type: verbatim
11505 #: ../src/guestfs-actions.pod:3467
11506 #, no-wrap
11507 msgid ""
11508 " int\n"
11509 " guestfs_launch (guestfs_h *g);\n"
11510 "\n"
11511 msgstr ""
11512
11513 #. type: textblock
11514 #: ../src/guestfs-actions.pod:3470 ../fish/guestfish-actions.pod:2429
11515 msgid ""
11516 "Internally libguestfs is implemented by running a virtual machine using "
11517 "L<qemu(1)>."
11518 msgstr ""
11519
11520 #. type: textblock
11521 #: ../src/guestfs-actions.pod:3473 ../fish/guestfish-actions.pod:2432
11522 msgid ""
11523 "You should call this after configuring the handle (eg. adding drives) but "
11524 "before performing any actions."
11525 msgstr ""
11526
11527 #. type: =head2
11528 #: ../src/guestfs-actions.pod:3485
11529 msgid "guestfs_lchown"
11530 msgstr ""
11531
11532 #. type: verbatim
11533 #: ../src/guestfs-actions.pod:3487
11534 #, no-wrap
11535 msgid ""
11536 " int\n"
11537 " guestfs_lchown (guestfs_h *g,\n"
11538 "                 int owner,\n"
11539 "                 int group,\n"
11540 "                 const char *path);\n"
11541 "\n"
11542 msgstr ""
11543
11544 #. type: textblock
11545 #: ../src/guestfs-actions.pod:3493
11546 msgid ""
11547 "Change the file owner to C<owner> and group to C<group>.  This is like "
11548 "C<guestfs_chown> but if C<path> is a symlink then the link itself is "
11549 "changed, not the target."
11550 msgstr ""
11551
11552 #. type: =head2
11553 #: ../src/guestfs-actions.pod:3505
11554 msgid "guestfs_lgetxattr"
11555 msgstr ""
11556
11557 #. type: verbatim
11558 #: ../src/guestfs-actions.pod:3507
11559 #, no-wrap
11560 msgid ""
11561 " char *\n"
11562 " guestfs_lgetxattr (guestfs_h *g,\n"
11563 "                    const char *path,\n"
11564 "                    const char *name,\n"
11565 "                    size_t *size_r);\n"
11566 "\n"
11567 msgstr ""
11568
11569 #. type: textblock
11570 #: ../src/guestfs-actions.pod:3513 ../fish/guestfish-actions.pod:2451
11571 msgid ""
11572 "Get a single extended attribute from file C<path> named C<name>.  If C<path> "
11573 "is a symlink, then this call returns an extended attribute from the symlink."
11574 msgstr ""
11575
11576 #. type: textblock
11577 #: ../src/guestfs-actions.pod:3527
11578 msgid "See also: C<guestfs_lgetxattrs>, C<guestfs_getxattr>, L<attr(5)>."
11579 msgstr ""
11580
11581 #. type: =head2
11582 #: ../src/guestfs-actions.pod:3535
11583 msgid "guestfs_lgetxattrs"
11584 msgstr ""
11585
11586 #. type: verbatim
11587 #: ../src/guestfs-actions.pod:3537
11588 #, no-wrap
11589 msgid ""
11590 " struct guestfs_xattr_list *\n"
11591 " guestfs_lgetxattrs (guestfs_h *g,\n"
11592 "                     const char *path);\n"
11593 "\n"
11594 msgstr ""
11595
11596 #. type: textblock
11597 #: ../src/guestfs-actions.pod:3541
11598 msgid ""
11599 "This is the same as C<guestfs_getxattrs>, but if C<path> is a symbolic link, "
11600 "then it returns the extended attributes of the link itself."
11601 msgstr ""
11602
11603 #. type: =head2
11604 #: ../src/guestfs-actions.pod:3551
11605 msgid "guestfs_list_devices"
11606 msgstr ""
11607
11608 #. type: verbatim
11609 #: ../src/guestfs-actions.pod:3553
11610 #, no-wrap
11611 msgid ""
11612 " char **\n"
11613 " guestfs_list_devices (guestfs_h *g);\n"
11614 "\n"
11615 msgstr ""
11616
11617 #. type: textblock
11618 #: ../src/guestfs-actions.pod:3556 ../fish/guestfish-actions.pod:2479
11619 msgid "List all the block devices."
11620 msgstr ""
11621
11622 #. type: textblock
11623 #: ../src/guestfs-actions.pod:3558 ../fish/guestfish-actions.pod:2481
11624 msgid "The full block device names are returned, eg. C</dev/sda>."
11625 msgstr ""
11626
11627 #. type: =head2
11628 #: ../src/guestfs-actions.pod:3568
11629 msgid "guestfs_list_filesystems"
11630 msgstr ""
11631
11632 #. type: verbatim
11633 #: ../src/guestfs-actions.pod:3570
11634 #, no-wrap
11635 msgid ""
11636 " char **\n"
11637 " guestfs_list_filesystems (guestfs_h *g);\n"
11638 "\n"
11639 msgstr ""
11640
11641 #. type: textblock
11642 #: ../src/guestfs-actions.pod:3573 ../fish/guestfish-actions.pod:2489
11643 msgid ""
11644 "This inspection command looks for filesystems on partitions, block devices "
11645 "and logical volumes, returning a list of devices containing filesystems and "
11646 "their type."
11647 msgstr ""
11648
11649 #. type: textblock
11650 #: ../src/guestfs-actions.pod:3577 ../fish/guestfish-actions.pod:2493
11651 msgid ""
11652 "The return value is a hash, where the keys are the devices containing "
11653 "filesystems, and the values are the filesystem types.  For example:"
11654 msgstr ""
11655
11656 #. type: verbatim
11657 #: ../src/guestfs-actions.pod:3581 ../fish/guestfish-actions.pod:2497
11658 #, no-wrap
11659 msgid ""
11660 " \"/dev/sda1\" => \"ntfs\"\n"
11661 " \"/dev/sda2\" => \"ext2\"\n"
11662 " \"/dev/vg_guest/lv_root\" => \"ext4\"\n"
11663 " \"/dev/vg_guest/lv_swap\" => \"swap\"\n"
11664 "\n"
11665 msgstr ""
11666
11667 #. type: textblock
11668 #: ../src/guestfs-actions.pod:3586 ../fish/guestfish-actions.pod:2502
11669 msgid ""
11670 "The value can have the special value \"unknown\", meaning the content of the "
11671 "device is undetermined or empty.  \"swap\" means a Linux swap partition."
11672 msgstr ""
11673
11674 #. type: textblock
11675 #: ../src/guestfs-actions.pod:3590
11676 msgid ""
11677 "This command runs other libguestfs commands, which might include "
11678 "C<guestfs_mount> and C<guestfs_umount>, and therefore you should use this "
11679 "soon after launch and only when nothing is mounted."
11680 msgstr ""
11681
11682 #. type: textblock
11683 #: ../src/guestfs-actions.pod:3594
11684 msgid ""
11685 "Not all of the filesystems returned will be mountable.  In particular, swap "
11686 "partitions are returned in the list.  Also this command does not check that "
11687 "each filesystem found is valid and mountable, and some filesystems might be "
11688 "mountable but require special options.  Filesystems may not all belong to a "
11689 "single logical operating system (use C<guestfs_inspect_os> to look for "
11690 "OSes)."
11691 msgstr ""
11692
11693 #. type: textblock
11694 #: ../src/guestfs-actions.pod:3608 ../src/guestfs-actions.pod:5229
11695 msgid "(Added in 1.5.15)"
11696 msgstr ""
11697
11698 #. type: =head2
11699 #: ../src/guestfs-actions.pod:3610
11700 msgid "guestfs_list_partitions"
11701 msgstr ""
11702
11703 #. type: verbatim
11704 #: ../src/guestfs-actions.pod:3612
11705 #, no-wrap
11706 msgid ""
11707 " char **\n"
11708 " guestfs_list_partitions (guestfs_h *g);\n"
11709 "\n"
11710 msgstr ""
11711
11712 #. type: textblock
11713 #: ../src/guestfs-actions.pod:3615 ../fish/guestfish-actions.pod:2522
11714 msgid "List all the partitions detected on all block devices."
11715 msgstr ""
11716
11717 #. type: textblock
11718 #: ../src/guestfs-actions.pod:3617 ../fish/guestfish-actions.pod:2524
11719 msgid "The full partition device names are returned, eg. C</dev/sda1>"
11720 msgstr ""
11721
11722 #. type: textblock
11723 #: ../src/guestfs-actions.pod:3619
11724 msgid ""
11725 "This does not return logical volumes.  For that you will need to call "
11726 "C<guestfs_lvs>."
11727 msgstr ""
11728
11729 #. type: =head2
11730 #: ../src/guestfs-actions.pod:3630
11731 msgid "guestfs_ll"
11732 msgstr ""
11733
11734 #. type: verbatim
11735 #: ../src/guestfs-actions.pod:3632
11736 #, no-wrap
11737 msgid ""
11738 " char *\n"
11739 " guestfs_ll (guestfs_h *g,\n"
11740 "             const char *directory);\n"
11741 "\n"
11742 msgstr ""
11743
11744 #. type: textblock
11745 #: ../src/guestfs-actions.pod:3636 ../fish/guestfish-actions.pod:2535
11746 msgid ""
11747 "List the files in C<directory> (relative to the root directory, there is no "
11748 "cwd) in the format of 'ls -la'."
11749 msgstr ""
11750
11751 #. type: textblock
11752 #: ../src/guestfs-actions.pod:3639 ../fish/guestfish-actions.pod:2538
11753 msgid ""
11754 "This command is mostly useful for interactive sessions.  It is I<not> "
11755 "intended that you try to parse the output string."
11756 msgstr ""
11757
11758 #. type: =head2
11759 #: ../src/guestfs-actions.pod:3647
11760 msgid "guestfs_ln"
11761 msgstr ""
11762
11763 #. type: verbatim
11764 #: ../src/guestfs-actions.pod:3649
11765 #, no-wrap
11766 msgid ""
11767 " int\n"
11768 " guestfs_ln (guestfs_h *g,\n"
11769 "             const char *target,\n"
11770 "             const char *linkname);\n"
11771 "\n"
11772 msgstr ""
11773
11774 #. type: textblock
11775 #: ../src/guestfs-actions.pod:3654 ../fish/guestfish-actions.pod:2545
11776 msgid "This command creates a hard link using the C<ln> command."
11777 msgstr ""
11778
11779 #. type: =head2
11780 #: ../src/guestfs-actions.pod:3660
11781 msgid "guestfs_ln_f"
11782 msgstr ""
11783
11784 #. type: verbatim
11785 #: ../src/guestfs-actions.pod:3662
11786 #, no-wrap
11787 msgid ""
11788 " int\n"
11789 " guestfs_ln_f (guestfs_h *g,\n"
11790 "               const char *target,\n"
11791 "               const char *linkname);\n"
11792 "\n"
11793 msgstr ""
11794
11795 #. type: textblock
11796 #: ../src/guestfs-actions.pod:3667 ../fish/guestfish-actions.pod:2551
11797 msgid ""
11798 "This command creates a hard link using the C<ln -f> command.  The I<-f> "
11799 "option removes the link (C<linkname>) if it exists already."
11800 msgstr ""
11801
11802 #. type: =head2
11803 #: ../src/guestfs-actions.pod:3674
11804 msgid "guestfs_ln_s"
11805 msgstr ""
11806
11807 #. type: verbatim
11808 #: ../src/guestfs-actions.pod:3676
11809 #, no-wrap
11810 msgid ""
11811 " int\n"
11812 " guestfs_ln_s (guestfs_h *g,\n"
11813 "               const char *target,\n"
11814 "               const char *linkname);\n"
11815 "\n"
11816 msgstr ""
11817
11818 #. type: textblock
11819 #: ../src/guestfs-actions.pod:3681 ../fish/guestfish-actions.pod:2558
11820 msgid "This command creates a symbolic link using the C<ln -s> command."
11821 msgstr ""
11822
11823 #. type: =head2
11824 #: ../src/guestfs-actions.pod:3687
11825 msgid "guestfs_ln_sf"
11826 msgstr ""
11827
11828 #. type: verbatim
11829 #: ../src/guestfs-actions.pod:3689
11830 #, no-wrap
11831 msgid ""
11832 " int\n"
11833 " guestfs_ln_sf (guestfs_h *g,\n"
11834 "                const char *target,\n"
11835 "                const char *linkname);\n"
11836 "\n"
11837 msgstr ""
11838
11839 #. type: textblock
11840 #: ../src/guestfs-actions.pod:3694 ../fish/guestfish-actions.pod:2564
11841 msgid ""
11842 "This command creates a symbolic link using the C<ln -sf> command, The I<-f> "
11843 "option removes the link (C<linkname>) if it exists already."
11844 msgstr ""
11845
11846 #. type: =head2
11847 #: ../src/guestfs-actions.pod:3701
11848 msgid "guestfs_lremovexattr"
11849 msgstr ""
11850
11851 #. type: verbatim
11852 #: ../src/guestfs-actions.pod:3703
11853 #, no-wrap
11854 msgid ""
11855 " int\n"
11856 " guestfs_lremovexattr (guestfs_h *g,\n"
11857 "                       const char *xattr,\n"
11858 "                       const char *path);\n"
11859 "\n"
11860 msgstr ""
11861
11862 #. type: textblock
11863 #: ../src/guestfs-actions.pod:3708
11864 msgid ""
11865 "This is the same as C<guestfs_removexattr>, but if C<path> is a symbolic "
11866 "link, then it removes an extended attribute of the link itself."
11867 msgstr ""
11868
11869 #. type: =head2
11870 #: ../src/guestfs-actions.pod:3716
11871 msgid "guestfs_ls"
11872 msgstr ""
11873
11874 #. type: verbatim
11875 #: ../src/guestfs-actions.pod:3718
11876 #, no-wrap
11877 msgid ""
11878 " char **\n"
11879 " guestfs_ls (guestfs_h *g,\n"
11880 "             const char *directory);\n"
11881 "\n"
11882 msgstr ""
11883
11884 #. type: textblock
11885 #: ../src/guestfs-actions.pod:3722 ../fish/guestfish-actions.pod:2579
11886 msgid ""
11887 "List the files in C<directory> (relative to the root directory, there is no "
11888 "cwd).  The '.' and '..' entries are not returned, but hidden files are "
11889 "shown."
11890 msgstr ""
11891
11892 #. type: textblock
11893 #: ../src/guestfs-actions.pod:3726
11894 msgid ""
11895 "This command is mostly useful for interactive sessions.  Programs should "
11896 "probably use C<guestfs_readdir> instead."
11897 msgstr ""
11898
11899 #. type: =head2
11900 #: ../src/guestfs-actions.pod:3735
11901 msgid "guestfs_lsetxattr"
11902 msgstr ""
11903
11904 #. type: verbatim
11905 #: ../src/guestfs-actions.pod:3737
11906 #, no-wrap
11907 msgid ""
11908 " int\n"
11909 " guestfs_lsetxattr (guestfs_h *g,\n"
11910 "                    const char *xattr,\n"
11911 "                    const char *val,\n"
11912 "                    int vallen,\n"
11913 "                    const char *path);\n"
11914 "\n"
11915 msgstr ""
11916
11917 #. type: textblock
11918 #: ../src/guestfs-actions.pod:3744
11919 msgid ""
11920 "This is the same as C<guestfs_setxattr>, but if C<path> is a symbolic link, "
11921 "then it sets an extended attribute of the link itself."
11922 msgstr ""
11923
11924 #. type: =head2
11925 #: ../src/guestfs-actions.pod:3752
11926 msgid "guestfs_lstat"
11927 msgstr ""
11928
11929 #. type: verbatim
11930 #: ../src/guestfs-actions.pod:3754
11931 #, no-wrap
11932 msgid ""
11933 " struct guestfs_stat *\n"
11934 " guestfs_lstat (guestfs_h *g,\n"
11935 "                const char *path);\n"
11936 "\n"
11937 msgstr ""
11938
11939 #. type: textblock
11940 #: ../src/guestfs-actions.pod:3758 ../src/guestfs-actions.pod:6360 ../fish/guestfish-actions.pod:2598 ../fish/guestfish-actions.pod:4311
11941 msgid "Returns file information for the given C<path>."
11942 msgstr ""
11943
11944 #. type: textblock
11945 #: ../src/guestfs-actions.pod:3760
11946 msgid ""
11947 "This is the same as C<guestfs_stat> except that if C<path> is a symbolic "
11948 "link, then the link is stat-ed, not the file it refers to."
11949 msgstr ""
11950
11951 #. type: textblock
11952 #: ../src/guestfs-actions.pod:3764 ../fish/guestfish-actions.pod:2604
11953 msgid "This is the same as the C<lstat(2)> system call."
11954 msgstr ""
11955
11956 #. type: textblock
11957 #: ../src/guestfs-actions.pod:3766 ../src/guestfs-actions.pod:6364
11958 msgid ""
11959 "This function returns a C<struct guestfs_stat *>, or NULL if there was an "
11960 "error.  I<The caller must call C<guestfs_free_stat> after use>."
11961 msgstr ""
11962
11963 #. type: textblock
11964 #: ../src/guestfs-actions.pod:3770 ../src/guestfs-actions.pod:6368 ../src/guestfs-actions.pod:6386 ../src/guestfs-actions.pod:6767
11965 msgid "(Added in 0.9.2)"
11966 msgstr ""
11967
11968 #. type: =head2
11969 #: ../src/guestfs-actions.pod:3772
11970 msgid "guestfs_lstatlist"
11971 msgstr ""
11972
11973 #. type: verbatim
11974 #: ../src/guestfs-actions.pod:3774
11975 #, no-wrap
11976 msgid ""
11977 " struct guestfs_stat_list *\n"
11978 " guestfs_lstatlist (guestfs_h *g,\n"
11979 "                    const char *path,\n"
11980 "                    char *const *names);\n"
11981 "\n"
11982 msgstr ""
11983
11984 #. type: textblock
11985 #: ../src/guestfs-actions.pod:3779
11986 msgid ""
11987 "This call allows you to perform the C<guestfs_lstat> operation on multiple "
11988 "files, where all files are in the directory C<path>.  C<names> is the list "
11989 "of files from this directory."
11990 msgstr ""
11991
11992 #. type: textblock
11993 #: ../src/guestfs-actions.pod:3783 ../fish/guestfish-actions.pod:2614
11994 msgid ""
11995 "On return you get a list of stat structs, with a one-to-one correspondence "
11996 "to the C<names> list.  If any name did not exist or could not be lstat'd, "
11997 "then the C<ino> field of that structure is set to C<-1>."
11998 msgstr ""
11999
12000 #. type: textblock
12001 #: ../src/guestfs-actions.pod:3788
12002 msgid ""
12003 "This call is intended for programs that want to efficiently list a directory "
12004 "contents without making many round-trips.  See also C<guestfs_lxattrlist> "
12005 "for a similarly efficient call for getting extended attributes.  Very long "
12006 "directory listings might cause the protocol message size to be exceeded, "
12007 "causing this call to fail.  The caller must split up such requests into "
12008 "smaller groups of names."
12009 msgstr ""
12010
12011 #. type: textblock
12012 #: ../src/guestfs-actions.pod:3796
12013 msgid ""
12014 "This function returns a C<struct guestfs_stat_list *>, or NULL if there was "
12015 "an error.  I<The caller must call C<guestfs_free_stat_list> after use>."
12016 msgstr ""
12017
12018 #. type: =head2
12019 #: ../src/guestfs-actions.pod:3802
12020 msgid "guestfs_luks_add_key"
12021 msgstr ""
12022
12023 #. type: verbatim
12024 #: ../src/guestfs-actions.pod:3804
12025 #, no-wrap
12026 msgid ""
12027 " int\n"
12028 " guestfs_luks_add_key (guestfs_h *g,\n"
12029 "                       const char *device,\n"
12030 "                       const char *key,\n"
12031 "                       const char *newkey,\n"
12032 "                       int keyslot);\n"
12033 "\n"
12034 msgstr ""
12035
12036 #. type: textblock
12037 #: ../src/guestfs-actions.pod:3811 ../fish/guestfish-actions.pod:2631
12038 msgid ""
12039 "This command adds a new key on LUKS device C<device>.  C<key> is any "
12040 "existing key, and is used to access the device.  C<newkey> is the new key to "
12041 "add.  C<keyslot> is the key slot that will be replaced."
12042 msgstr ""
12043
12044 #. type: textblock
12045 #: ../src/guestfs-actions.pod:3816
12046 msgid ""
12047 "Note that if C<keyslot> already contains a key, then this command will "
12048 "fail.  You have to use C<guestfs_luks_kill_slot> first to remove that key."
12049 msgstr ""
12050
12051 #. type: textblock
12052 #: ../src/guestfs-actions.pod:3822 ../src/guestfs-actions.pod:3862 ../src/guestfs-actions.pod:3885 ../src/guestfs-actions.pod:3905 ../src/guestfs-actions.pod:3937 ../src/guestfs-actions.pod:3956
12053 msgid ""
12054 "This function takes a key or passphrase parameter which could contain "
12055 "sensitive material.  Read the section L</KEYS AND PASSPHRASES> for more "
12056 "information."
12057 msgstr ""
12058
12059 #. type: textblock
12060 #: ../src/guestfs-actions.pod:3826 ../src/guestfs-actions.pod:3866 ../src/guestfs-actions.pod:3889 ../src/guestfs-actions.pod:3909
12061 msgid "(Added in 1.5.2)"
12062 msgstr ""
12063
12064 #. type: =head2
12065 #: ../src/guestfs-actions.pod:3828
12066 msgid "guestfs_luks_close"
12067 msgstr ""
12068
12069 #. type: verbatim
12070 #: ../src/guestfs-actions.pod:3830
12071 #, no-wrap
12072 msgid ""
12073 " int\n"
12074 " guestfs_luks_close (guestfs_h *g,\n"
12075 "                     const char *device);\n"
12076 "\n"
12077 msgstr ""
12078
12079 #. type: textblock
12080 #: ../src/guestfs-actions.pod:3834
12081 msgid ""
12082 "This closes a LUKS device that was created earlier by C<guestfs_luks_open> "
12083 "or C<guestfs_luks_open_ro>.  The C<device> parameter must be the name of the "
12084 "LUKS mapping device (ie. C</dev/mapper/mapname>) and I<not> the name of the "
12085 "underlying block device."
12086 msgstr ""
12087
12088 #. type: textblock
12089 #: ../src/guestfs-actions.pod:3842 ../src/guestfs-actions.pod:3941 ../src/guestfs-actions.pod:3960 ../src/guestfs-actions.pod:4010 ../src/guestfs-actions.pod:4058
12090 msgid "(Added in 1.5.1)"
12091 msgstr ""
12092
12093 #. type: =head2
12094 #: ../src/guestfs-actions.pod:3844
12095 msgid "guestfs_luks_format"
12096 msgstr ""
12097
12098 #. type: verbatim
12099 #: ../src/guestfs-actions.pod:3846
12100 #, no-wrap
12101 msgid ""
12102 " int\n"
12103 " guestfs_luks_format (guestfs_h *g,\n"
12104 "                      const char *device,\n"
12105 "                      const char *key,\n"
12106 "                      int keyslot);\n"
12107 "\n"
12108 msgstr ""
12109
12110 #. type: textblock
12111 #: ../src/guestfs-actions.pod:3852 ../fish/guestfish-actions.pod:2657
12112 msgid ""
12113 "This command erases existing data on C<device> and formats the device as a "
12114 "LUKS encrypted device.  C<key> is the initial key, which is added to key "
12115 "slot C<slot>.  (LUKS supports 8 key slots, numbered 0-7)."
12116 msgstr ""
12117
12118 #. type: textblock
12119 #: ../src/guestfs-actions.pod:3859 ../src/guestfs-actions.pod:3882 ../src/guestfs-actions.pod:4022 ../src/guestfs-actions.pod:4980 ../src/guestfs-actions.pod:5760 ../src/guestfs-actions.pod:6167 ../src/guestfs-actions.pod:6197 ../src/guestfs-actions.pod:6230 ../src/guestfs-actions.pod:7411 ../fish/guestfish-actions.pod:2665 ../fish/guestfish-actions.pod:2678 ../fish/guestfish-actions.pod:2762 ../fish/guestfish-actions.pod:3352 ../fish/guestfish-actions.pod:3872 ../fish/guestfish-actions.pod:4182 ../fish/guestfish-actions.pod:4205 ../fish/guestfish-actions.pod:4227 ../fish/guestfish-actions.pod:4956
12120 msgid ""
12121 "B<This command is dangerous.  Without careful use you can easily destroy all "
12122 "your data>."
12123 msgstr ""
12124
12125 #. type: =head2
12126 #: ../src/guestfs-actions.pod:3868
12127 msgid "guestfs_luks_format_cipher"
12128 msgstr ""
12129
12130 #. type: verbatim
12131 #: ../src/guestfs-actions.pod:3870
12132 #, no-wrap
12133 msgid ""
12134 " int\n"
12135 " guestfs_luks_format_cipher (guestfs_h *g,\n"
12136 "                             const char *device,\n"
12137 "                             const char *key,\n"
12138 "                             int keyslot,\n"
12139 "                             const char *cipher);\n"
12140 "\n"
12141 msgstr ""
12142
12143 #. type: textblock
12144 #: ../src/guestfs-actions.pod:3877
12145 msgid ""
12146 "This command is the same as C<guestfs_luks_format> but it also allows you to "
12147 "set the C<cipher> used."
12148 msgstr ""
12149
12150 #. type: =head2
12151 #: ../src/guestfs-actions.pod:3891
12152 msgid "guestfs_luks_kill_slot"
12153 msgstr ""
12154
12155 #. type: verbatim
12156 #: ../src/guestfs-actions.pod:3893
12157 #, no-wrap
12158 msgid ""
12159 " int\n"
12160 " guestfs_luks_kill_slot (guestfs_h *g,\n"
12161 "                         const char *device,\n"
12162 "                         const char *key,\n"
12163 "                         int keyslot);\n"
12164 "\n"
12165 msgstr ""
12166
12167 #. type: textblock
12168 #: ../src/guestfs-actions.pod:3899 ../fish/guestfish-actions.pod:2685
12169 msgid ""
12170 "This command deletes the key in key slot C<keyslot> from the encrypted LUKS "
12171 "device C<device>.  C<key> must be one of the I<other> keys."
12172 msgstr ""
12173
12174 #. type: =head2
12175 #: ../src/guestfs-actions.pod:3911
12176 msgid "guestfs_luks_open"
12177 msgstr ""
12178
12179 #. type: verbatim
12180 #: ../src/guestfs-actions.pod:3913
12181 #, no-wrap
12182 msgid ""
12183 " int\n"
12184 " guestfs_luks_open (guestfs_h *g,\n"
12185 "                    const char *device,\n"
12186 "                    const char *key,\n"
12187 "                    const char *mapname);\n"
12188 "\n"
12189 msgstr ""
12190
12191 #. type: textblock
12192 #: ../src/guestfs-actions.pod:3919 ../fish/guestfish-actions.pod:2696
12193 msgid ""
12194 "This command opens a block device which has been encrypted according to the "
12195 "Linux Unified Key Setup (LUKS) standard."
12196 msgstr ""
12197
12198 #. type: textblock
12199 #: ../src/guestfs-actions.pod:3922 ../fish/guestfish-actions.pod:2699
12200 msgid "C<device> is the encrypted block device or partition."
12201 msgstr ""
12202
12203 #. type: textblock
12204 #: ../src/guestfs-actions.pod:3924 ../fish/guestfish-actions.pod:2701
12205 msgid ""
12206 "The caller must supply one of the keys associated with the LUKS block "
12207 "device, in the C<key> parameter."
12208 msgstr ""
12209
12210 #. type: textblock
12211 #: ../src/guestfs-actions.pod:3927 ../fish/guestfish-actions.pod:2704
12212 msgid ""
12213 "This creates a new block device called C</dev/mapper/mapname>.  Reads and "
12214 "writes to this block device are decrypted from and encrypted to the "
12215 "underlying C<device> respectively."
12216 msgstr ""
12217
12218 #. type: textblock
12219 #: ../src/guestfs-actions.pod:3931
12220 msgid ""
12221 "If this block device contains LVM volume groups, then calling "
12222 "C<guestfs_vgscan> followed by C<guestfs_vg_activate_all> will make them "
12223 "visible."
12224 msgstr ""
12225
12226 #. type: =head2
12227 #: ../src/guestfs-actions.pod:3943
12228 msgid "guestfs_luks_open_ro"
12229 msgstr ""
12230
12231 #. type: verbatim
12232 #: ../src/guestfs-actions.pod:3945
12233 #, no-wrap
12234 msgid ""
12235 " int\n"
12236 " guestfs_luks_open_ro (guestfs_h *g,\n"
12237 "                       const char *device,\n"
12238 "                       const char *key,\n"
12239 "                       const char *mapname);\n"
12240 "\n"
12241 msgstr ""
12242
12243 #. type: textblock
12244 #: ../src/guestfs-actions.pod:3951
12245 msgid ""
12246 "This is the same as C<guestfs_luks_open> except that a read-only mapping is "
12247 "created."
12248 msgstr ""
12249
12250 #. type: =head2
12251 #: ../src/guestfs-actions.pod:3962
12252 msgid "guestfs_lvcreate"
12253 msgstr ""
12254
12255 #. type: verbatim
12256 #: ../src/guestfs-actions.pod:3964
12257 #, no-wrap
12258 msgid ""
12259 " int\n"
12260 " guestfs_lvcreate (guestfs_h *g,\n"
12261 "                   const char *logvol,\n"
12262 "                   const char *volgroup,\n"
12263 "                   int mbytes);\n"
12264 "\n"
12265 msgstr ""
12266
12267 #. type: textblock
12268 #: ../src/guestfs-actions.pod:3970 ../fish/guestfish-actions.pod:2729
12269 msgid ""
12270 "This creates an LVM logical volume called C<logvol> on the volume group "
12271 "C<volgroup>, with C<size> megabytes."
12272 msgstr ""
12273
12274 #. type: =head2
12275 #: ../src/guestfs-actions.pod:3977
12276 msgid "guestfs_lvm_canonical_lv_name"
12277 msgstr ""
12278
12279 #. type: verbatim
12280 #: ../src/guestfs-actions.pod:3979
12281 #, no-wrap
12282 msgid ""
12283 " char *\n"
12284 " guestfs_lvm_canonical_lv_name (guestfs_h *g,\n"
12285 "                                const char *lvname);\n"
12286 "\n"
12287 msgstr ""
12288
12289 #. type: textblock
12290 #: ../src/guestfs-actions.pod:3983 ../fish/guestfish-actions.pod:2736
12291 msgid ""
12292 "This converts alternative naming schemes for LVs that you might find to the "
12293 "canonical name.  For example, C</dev/mapper/VG-LV> is converted to "
12294 "C</dev/VG/LV>."
12295 msgstr ""
12296
12297 #. type: textblock
12298 #: ../src/guestfs-actions.pod:3987 ../fish/guestfish-actions.pod:2740
12299 msgid ""
12300 "This command returns an error if the C<lvname> parameter does not refer to a "
12301 "logical volume."
12302 msgstr ""
12303
12304 #. type: textblock
12305 #: ../src/guestfs-actions.pod:3990
12306 msgid "See also C<guestfs_is_lv>."
12307 msgstr ""
12308
12309 #. type: textblock
12310 #: ../src/guestfs-actions.pod:3995
12311 msgid "(Added in 1.5.24)"
12312 msgstr ""
12313
12314 #. type: =head2
12315 #: ../src/guestfs-actions.pod:3997
12316 msgid "guestfs_lvm_clear_filter"
12317 msgstr ""
12318
12319 #. type: verbatim
12320 #: ../src/guestfs-actions.pod:3999
12321 #, no-wrap
12322 msgid ""
12323 " int\n"
12324 " guestfs_lvm_clear_filter (guestfs_h *g);\n"
12325 "\n"
12326 msgstr ""
12327
12328 #. type: textblock
12329 #: ../src/guestfs-actions.pod:4002
12330 msgid ""
12331 "This undoes the effect of C<guestfs_lvm_set_filter>.  LVM will be able to "
12332 "see every block device."
12333 msgstr ""
12334
12335 #. type: textblock
12336 #: ../src/guestfs-actions.pod:4005 ../src/guestfs-actions.pod:4047 ../fish/guestfish-actions.pod:2752 ../fish/guestfish-actions.pod:2783
12337 msgid "This command also clears the LVM cache and performs a volume group scan."
12338 msgstr ""
12339
12340 #. type: =head2
12341 #: ../src/guestfs-actions.pod:4012
12342 msgid "guestfs_lvm_remove_all"
12343 msgstr ""
12344
12345 #. type: verbatim
12346 #: ../src/guestfs-actions.pod:4014
12347 #, no-wrap
12348 msgid ""
12349 " int\n"
12350 " guestfs_lvm_remove_all (guestfs_h *g);\n"
12351 "\n"
12352 msgstr ""
12353
12354 #. type: textblock
12355 #: ../src/guestfs-actions.pod:4017 ../fish/guestfish-actions.pod:2759
12356 msgid ""
12357 "This command removes all LVM logical volumes, volume groups and physical "
12358 "volumes."
12359 msgstr ""
12360
12361 #. type: =head2
12362 #: ../src/guestfs-actions.pod:4027
12363 msgid "guestfs_lvm_set_filter"
12364 msgstr ""
12365
12366 #. type: verbatim
12367 #: ../src/guestfs-actions.pod:4029
12368 #, no-wrap
12369 msgid ""
12370 " int\n"
12371 " guestfs_lvm_set_filter (guestfs_h *g,\n"
12372 "                         char *const *devices);\n"
12373 "\n"
12374 msgstr ""
12375
12376 #. type: textblock
12377 #: ../src/guestfs-actions.pod:4033 ../fish/guestfish-actions.pod:2769
12378 msgid ""
12379 "This sets the LVM device filter so that LVM will only be able to \"see\" the "
12380 "block devices in the list C<devices>, and will ignore all other attached "
12381 "block devices."
12382 msgstr ""
12383
12384 #. type: textblock
12385 #: ../src/guestfs-actions.pod:4037 ../fish/guestfish-actions.pod:2773
12386 msgid ""
12387 "Where disk image(s) contain duplicate PVs or VGs, this command is useful to "
12388 "get LVM to ignore the duplicates, otherwise LVM can get confused.  Note also "
12389 "there are two types of duplication possible: either cloned PVs/VGs which "
12390 "have identical UUIDs; or VGs that are not cloned but just happen to have the "
12391 "same name.  In normal operation you cannot create this situation, but you "
12392 "can do it outside LVM, eg.  by cloning disk images or by bit twiddling "
12393 "inside the LVM metadata."
12394 msgstr ""
12395
12396 #. type: textblock
12397 #: ../src/guestfs-actions.pod:4050 ../fish/guestfish-actions.pod:2786
12398 msgid "You can filter whole block devices or individual partitions."
12399 msgstr ""
12400
12401 #. type: textblock
12402 #: ../src/guestfs-actions.pod:4052 ../fish/guestfish-actions.pod:2788
12403 msgid ""
12404 "You cannot use this if any VG is currently in use (eg.  contains a mounted "
12405 "filesystem), even if you are not filtering out that VG."
12406 msgstr ""
12407
12408 #. type: =head2
12409 #: ../src/guestfs-actions.pod:4060
12410 msgid "guestfs_lvremove"
12411 msgstr ""
12412
12413 #. type: verbatim
12414 #: ../src/guestfs-actions.pod:4062
12415 #, no-wrap
12416 msgid ""
12417 " int\n"
12418 " guestfs_lvremove (guestfs_h *g,\n"
12419 "                   const char *device);\n"
12420 "\n"
12421 msgstr ""
12422
12423 #. type: textblock
12424 #: ../src/guestfs-actions.pod:4066 ../fish/guestfish-actions.pod:2796
12425 msgid ""
12426 "Remove an LVM logical volume C<device>, where C<device> is the path to the "
12427 "LV, such as C</dev/VG/LV>."
12428 msgstr ""
12429
12430 #. type: textblock
12431 #: ../src/guestfs-actions.pod:4069 ../fish/guestfish-actions.pod:2799
12432 msgid ""
12433 "You can also remove all LVs in a volume group by specifying the VG name, "
12434 "C</dev/VG>."
12435 msgstr ""
12436
12437 #. type: textblock
12438 #: ../src/guestfs-actions.pod:4074 ../src/guestfs-actions.pod:5326 ../src/guestfs-actions.pod:7143
12439 msgid "(Added in 1.0.13)"
12440 msgstr ""
12441
12442 #. type: =head2
12443 #: ../src/guestfs-actions.pod:4076
12444 msgid "guestfs_lvrename"
12445 msgstr ""
12446
12447 #. type: verbatim
12448 #: ../src/guestfs-actions.pod:4078
12449 #, no-wrap
12450 msgid ""
12451 " int\n"
12452 " guestfs_lvrename (guestfs_h *g,\n"
12453 "                   const char *logvol,\n"
12454 "                   const char *newlogvol);\n"
12455 "\n"
12456 msgstr ""
12457
12458 #. type: textblock
12459 #: ../src/guestfs-actions.pod:4083 ../fish/guestfish-actions.pod:2806
12460 msgid "Rename a logical volume C<logvol> with the new name C<newlogvol>."
12461 msgstr ""
12462
12463 #. type: textblock
12464 #: ../src/guestfs-actions.pod:4087 ../src/guestfs-actions.pod:7156
12465 msgid "(Added in 1.0.83)"
12466 msgstr ""
12467
12468 #. type: =head2
12469 #: ../src/guestfs-actions.pod:4089
12470 msgid "guestfs_lvresize"
12471 msgstr ""
12472
12473 #. type: verbatim
12474 #: ../src/guestfs-actions.pod:4091
12475 #, no-wrap
12476 msgid ""
12477 " int\n"
12478 " guestfs_lvresize (guestfs_h *g,\n"
12479 "                   const char *device,\n"
12480 "                   int mbytes);\n"
12481 "\n"
12482 msgstr ""
12483
12484 #. type: textblock
12485 #: ../src/guestfs-actions.pod:4096 ../fish/guestfish-actions.pod:2812
12486 msgid ""
12487 "This resizes (expands or shrinks) an existing LVM logical volume to "
12488 "C<mbytes>.  When reducing, data in the reduced part is lost."
12489 msgstr ""
12490
12491 #. type: =head2
12492 #: ../src/guestfs-actions.pod:4104
12493 msgid "guestfs_lvresize_free"
12494 msgstr ""
12495
12496 #. type: verbatim
12497 #: ../src/guestfs-actions.pod:4106
12498 #, no-wrap
12499 msgid ""
12500 " int\n"
12501 " guestfs_lvresize_free (guestfs_h *g,\n"
12502 "                        const char *lv,\n"
12503 "                        int percent);\n"
12504 "\n"
12505 msgstr ""
12506
12507 #. type: textblock
12508 #: ../src/guestfs-actions.pod:4111 ../fish/guestfish-actions.pod:2820
12509 msgid ""
12510 "This expands an existing logical volume C<lv> so that it fills C<pc>% of the "
12511 "remaining free space in the volume group.  Commonly you would call this with "
12512 "pc = 100 which expands the logical volume as much as possible, using all "
12513 "remaining free space in the volume group."
12514 msgstr ""
12515
12516 #. type: textblock
12517 #: ../src/guestfs-actions.pod:4119
12518 msgid "(Added in 1.3.3)"
12519 msgstr ""
12520
12521 #. type: =head2
12522 #: ../src/guestfs-actions.pod:4121
12523 msgid "guestfs_lvs"
12524 msgstr ""
12525
12526 #. type: verbatim
12527 #: ../src/guestfs-actions.pod:4123
12528 #, no-wrap
12529 msgid ""
12530 " char **\n"
12531 " guestfs_lvs (guestfs_h *g);\n"
12532 "\n"
12533 msgstr ""
12534
12535 #. type: textblock
12536 #: ../src/guestfs-actions.pod:4126 ../fish/guestfish-actions.pod:2830
12537 msgid ""
12538 "List all the logical volumes detected.  This is the equivalent of the "
12539 "L<lvs(8)> command."
12540 msgstr ""
12541
12542 #. type: textblock
12543 #: ../src/guestfs-actions.pod:4129 ../fish/guestfish-actions.pod:2833
12544 msgid ""
12545 "This returns a list of the logical volume device names "
12546 "(eg. C</dev/VolGroup00/LogVol00>)."
12547 msgstr ""
12548
12549 #. type: textblock
12550 #: ../src/guestfs-actions.pod:4132
12551 msgid "See also C<guestfs_lvs_full>, C<guestfs_list_filesystems>."
12552 msgstr ""
12553
12554 #. type: =head2
12555 #: ../src/guestfs-actions.pod:4140
12556 msgid "guestfs_lvs_full"
12557 msgstr ""
12558
12559 #. type: verbatim
12560 #: ../src/guestfs-actions.pod:4142
12561 #, no-wrap
12562 msgid ""
12563 " struct guestfs_lvm_lv_list *\n"
12564 " guestfs_lvs_full (guestfs_h *g);\n"
12565 "\n"
12566 msgstr ""
12567
12568 #. type: textblock
12569 #: ../src/guestfs-actions.pod:4145 ../fish/guestfish-actions.pod:2842
12570 msgid ""
12571 "List all the logical volumes detected.  This is the equivalent of the "
12572 "L<lvs(8)> command.  The \"full\" version includes all fields."
12573 msgstr ""
12574
12575 #. type: textblock
12576 #: ../src/guestfs-actions.pod:4148
12577 msgid ""
12578 "This function returns a C<struct guestfs_lvm_lv_list *>, or NULL if there "
12579 "was an error.  I<The caller must call C<guestfs_free_lvm_lv_list> after "
12580 "use>."
12581 msgstr ""
12582
12583 #. type: =head2
12584 #: ../src/guestfs-actions.pod:4154
12585 msgid "guestfs_lvuuid"
12586 msgstr ""
12587
12588 #. type: verbatim
12589 #: ../src/guestfs-actions.pod:4156
12590 #, no-wrap
12591 msgid ""
12592 " char *\n"
12593 " guestfs_lvuuid (guestfs_h *g,\n"
12594 "                 const char *device);\n"
12595 "\n"
12596 msgstr ""
12597
12598 #. type: textblock
12599 #: ../src/guestfs-actions.pod:4160 ../fish/guestfish-actions.pod:2849
12600 msgid "This command returns the UUID of the LVM LV C<device>."
12601 msgstr ""
12602
12603 #. type: =head2
12604 #: ../src/guestfs-actions.pod:4167
12605 msgid "guestfs_lxattrlist"
12606 msgstr ""
12607
12608 #. type: verbatim
12609 #: ../src/guestfs-actions.pod:4169
12610 #, no-wrap
12611 msgid ""
12612 " struct guestfs_xattr_list *\n"
12613 " guestfs_lxattrlist (guestfs_h *g,\n"
12614 "                     const char *path,\n"
12615 "                     char *const *names);\n"
12616 "\n"
12617 msgstr ""
12618
12619 #. type: textblock
12620 #: ../src/guestfs-actions.pod:4174 ../fish/guestfish-actions.pod:2855
12621 msgid ""
12622 "This call allows you to get the extended attributes of multiple files, where "
12623 "all files are in the directory C<path>.  C<names> is the list of files from "
12624 "this directory."
12625 msgstr ""
12626
12627 #. type: textblock
12628 #: ../src/guestfs-actions.pod:4178 ../fish/guestfish-actions.pod:2859
12629 msgid ""
12630 "On return you get a flat list of xattr structs which must be interpreted "
12631 "sequentially.  The first xattr struct always has a zero-length C<attrname>.  "
12632 "C<attrval> in this struct is zero-length to indicate there was an error "
12633 "doing C<lgetxattr> for this file, I<or> is a C string which is a decimal "
12634 "number (the number of following attributes for this file, which could be "
12635 "C<\"0\">).  Then after the first xattr struct are the zero or more "
12636 "attributes for the first named file.  This repeats for the second and "
12637 "subsequent files."
12638 msgstr ""
12639
12640 #. type: textblock
12641 #: ../src/guestfs-actions.pod:4188
12642 msgid ""
12643 "This call is intended for programs that want to efficiently list a directory "
12644 "contents without making many round-trips.  See also C<guestfs_lstatlist> for "
12645 "a similarly efficient call for getting standard stats.  Very long directory "
12646 "listings might cause the protocol message size to be exceeded, causing this "
12647 "call to fail.  The caller must split up such requests into smaller groups of "
12648 "names."
12649 msgstr ""
12650
12651 #. type: =head2
12652 #: ../src/guestfs-actions.pod:4202
12653 msgid "guestfs_mkdir"
12654 msgstr ""
12655
12656 #. type: verbatim
12657 #: ../src/guestfs-actions.pod:4204
12658 #, no-wrap
12659 msgid ""
12660 " int\n"
12661 " guestfs_mkdir (guestfs_h *g,\n"
12662 "                const char *path);\n"
12663 "\n"
12664 msgstr ""
12665
12666 #. type: textblock
12667 #: ../src/guestfs-actions.pod:4208 ../fish/guestfish-actions.pod:2881
12668 msgid "Create a directory named C<path>."
12669 msgstr ""
12670
12671 #. type: =head2
12672 #: ../src/guestfs-actions.pod:4214
12673 msgid "guestfs_mkdir_mode"
12674 msgstr ""
12675
12676 #. type: verbatim
12677 #: ../src/guestfs-actions.pod:4216
12678 #, no-wrap
12679 msgid ""
12680 " int\n"
12681 " guestfs_mkdir_mode (guestfs_h *g,\n"
12682 "                     const char *path,\n"
12683 "                     int mode);\n"
12684 "\n"
12685 msgstr ""
12686
12687 #. type: textblock
12688 #: ../src/guestfs-actions.pod:4221 ../fish/guestfish-actions.pod:2887
12689 msgid ""
12690 "This command creates a directory, setting the initial permissions of the "
12691 "directory to C<mode>."
12692 msgstr ""
12693
12694 #. type: textblock
12695 #: ../src/guestfs-actions.pod:4224 ../fish/guestfish-actions.pod:2890
12696 msgid ""
12697 "For common Linux filesystems, the actual mode which is set will be C<mode & "
12698 "~umask & 01777>.  Non-native-Linux filesystems may interpret the mode in "
12699 "other ways."
12700 msgstr ""
12701
12702 #. type: textblock
12703 #: ../src/guestfs-actions.pod:4228
12704 msgid "See also C<guestfs_mkdir>, C<guestfs_umask>"
12705 msgstr ""
12706
12707 #. type: =head2
12708 #: ../src/guestfs-actions.pod:4234
12709 msgid "guestfs_mkdir_p"
12710 msgstr ""
12711
12712 #. type: verbatim
12713 #: ../src/guestfs-actions.pod:4236
12714 #, no-wrap
12715 msgid ""
12716 " int\n"
12717 " guestfs_mkdir_p (guestfs_h *g,\n"
12718 "                  const char *path);\n"
12719 "\n"
12720 msgstr ""
12721
12722 #. type: textblock
12723 #: ../src/guestfs-actions.pod:4240 ../fish/guestfish-actions.pod:2900
12724 msgid ""
12725 "Create a directory named C<path>, creating any parent directories as "
12726 "necessary.  This is like the C<mkdir -p> shell command."
12727 msgstr ""
12728
12729 #. type: =head2
12730 #: ../src/guestfs-actions.pod:4247
12731 msgid "guestfs_mkdtemp"
12732 msgstr ""
12733
12734 #. type: verbatim
12735 #: ../src/guestfs-actions.pod:4249
12736 #, no-wrap
12737 msgid ""
12738 " char *\n"
12739 " guestfs_mkdtemp (guestfs_h *g,\n"
12740 "                  const char *template);\n"
12741 "\n"
12742 msgstr ""
12743
12744 #. type: textblock
12745 #: ../src/guestfs-actions.pod:4253 ../fish/guestfish-actions.pod:2907
12746 msgid ""
12747 "This command creates a temporary directory.  The C<template> parameter "
12748 "should be a full pathname for the temporary directory name with the final "
12749 "six characters being \"XXXXXX\"."
12750 msgstr ""
12751
12752 #. type: textblock
12753 #: ../src/guestfs-actions.pod:4258 ../fish/guestfish-actions.pod:2912
12754 msgid ""
12755 "For example: \"/tmp/myprogXXXXXX\" or \"/Temp/myprogXXXXXX\", the second one "
12756 "being suitable for Windows filesystems."
12757 msgstr ""
12758
12759 #. type: textblock
12760 #: ../src/guestfs-actions.pod:4261 ../fish/guestfish-actions.pod:2915
12761 msgid "The name of the temporary directory that was created is returned."
12762 msgstr ""
12763
12764 #. type: textblock
12765 #: ../src/guestfs-actions.pod:4264 ../fish/guestfish-actions.pod:2918
12766 msgid "The temporary directory is created with mode 0700 and is owned by root."
12767 msgstr ""
12768
12769 #. type: textblock
12770 #: ../src/guestfs-actions.pod:4267 ../fish/guestfish-actions.pod:2921
12771 msgid ""
12772 "The caller is responsible for deleting the temporary directory and its "
12773 "contents after use."
12774 msgstr ""
12775
12776 #. type: textblock
12777 #: ../src/guestfs-actions.pod:4270 ../fish/guestfish-actions.pod:2924
12778 msgid "See also: L<mkdtemp(3)>"
12779 msgstr ""
12780
12781 #. type: =head2
12782 #: ../src/guestfs-actions.pod:4277
12783 msgid "guestfs_mke2fs_J"
12784 msgstr ""
12785
12786 #. type: verbatim
12787 #: ../src/guestfs-actions.pod:4279
12788 #, no-wrap
12789 msgid ""
12790 " int\n"
12791 " guestfs_mke2fs_J (guestfs_h *g,\n"
12792 "                   const char *fstype,\n"
12793 "                   int blocksize,\n"
12794 "                   const char *device,\n"
12795 "                   const char *journal);\n"
12796 "\n"
12797 msgstr ""
12798
12799 #. type: textblock
12800 #: ../src/guestfs-actions.pod:4286 ../fish/guestfish-actions.pod:2930
12801 msgid ""
12802 "This creates an ext2/3/4 filesystem on C<device> with an external journal on "
12803 "C<journal>.  It is equivalent to the command:"
12804 msgstr ""
12805
12806 #. type: verbatim
12807 #: ../src/guestfs-actions.pod:4290 ../fish/guestfish-actions.pod:2934
12808 #, no-wrap
12809 msgid ""
12810 " mke2fs -t fstype -b blocksize -J device=<journal> <device>\n"
12811 "\n"
12812 msgstr ""
12813
12814 #. type: textblock
12815 #: ../src/guestfs-actions.pod:4292
12816 msgid "See also C<guestfs_mke2journal>."
12817 msgstr ""
12818
12819 #. type: textblock
12820 #: ../src/guestfs-actions.pod:4296 ../src/guestfs-actions.pod:4314 ../src/guestfs-actions.pod:4332 ../src/guestfs-actions.pod:4348 ../src/guestfs-actions.pod:4362 ../src/guestfs-actions.pod:4376 ../src/guestfs-actions.pod:4435 ../src/guestfs-actions.pod:4700
12821 msgid "(Added in 1.0.68)"
12822 msgstr ""
12823
12824 #. type: =head2
12825 #: ../src/guestfs-actions.pod:4298
12826 msgid "guestfs_mke2fs_JL"
12827 msgstr ""
12828
12829 #. type: verbatim
12830 #: ../src/guestfs-actions.pod:4300
12831 #, no-wrap
12832 msgid ""
12833 " int\n"
12834 " guestfs_mke2fs_JL (guestfs_h *g,\n"
12835 "                    const char *fstype,\n"
12836 "                    int blocksize,\n"
12837 "                    const char *device,\n"
12838 "                    const char *label);\n"
12839 "\n"
12840 msgstr ""
12841
12842 #. type: textblock
12843 #: ../src/guestfs-actions.pod:4307 ../fish/guestfish-actions.pod:2942
12844 msgid ""
12845 "This creates an ext2/3/4 filesystem on C<device> with an external journal on "
12846 "the journal labeled C<label>."
12847 msgstr ""
12848
12849 #. type: textblock
12850 #: ../src/guestfs-actions.pod:4310
12851 msgid "See also C<guestfs_mke2journal_L>."
12852 msgstr ""
12853
12854 #. type: =head2
12855 #: ../src/guestfs-actions.pod:4316
12856 msgid "guestfs_mke2fs_JU"
12857 msgstr ""
12858
12859 #. type: verbatim
12860 #: ../src/guestfs-actions.pod:4318
12861 #, no-wrap
12862 msgid ""
12863 " int\n"
12864 " guestfs_mke2fs_JU (guestfs_h *g,\n"
12865 "                    const char *fstype,\n"
12866 "                    int blocksize,\n"
12867 "                    const char *device,\n"
12868 "                    const char *uuid);\n"
12869 "\n"
12870 msgstr ""
12871
12872 #. type: textblock
12873 #: ../src/guestfs-actions.pod:4325 ../fish/guestfish-actions.pod:2951
12874 msgid ""
12875 "This creates an ext2/3/4 filesystem on C<device> with an external journal on "
12876 "the journal with UUID C<uuid>."
12877 msgstr ""
12878
12879 #. type: textblock
12880 #: ../src/guestfs-actions.pod:4328
12881 msgid "See also C<guestfs_mke2journal_U>."
12882 msgstr ""
12883
12884 #. type: =head2
12885 #: ../src/guestfs-actions.pod:4334
12886 msgid "guestfs_mke2journal"
12887 msgstr ""
12888
12889 #. type: verbatim
12890 #: ../src/guestfs-actions.pod:4336
12891 #, no-wrap
12892 msgid ""
12893 " int\n"
12894 " guestfs_mke2journal (guestfs_h *g,\n"
12895 "                      int blocksize,\n"
12896 "                      const char *device);\n"
12897 "\n"
12898 msgstr ""
12899
12900 #. type: textblock
12901 #: ../src/guestfs-actions.pod:4341 ../fish/guestfish-actions.pod:2960
12902 msgid ""
12903 "This creates an ext2 external journal on C<device>.  It is equivalent to the "
12904 "command:"
12905 msgstr ""
12906
12907 #. type: verbatim
12908 #: ../src/guestfs-actions.pod:4344 ../fish/guestfish-actions.pod:2963
12909 #, no-wrap
12910 msgid ""
12911 " mke2fs -O journal_dev -b blocksize device\n"
12912 "\n"
12913 msgstr ""
12914
12915 #. type: =head2
12916 #: ../src/guestfs-actions.pod:4350
12917 msgid "guestfs_mke2journal_L"
12918 msgstr ""
12919
12920 #. type: verbatim
12921 #: ../src/guestfs-actions.pod:4352
12922 #, no-wrap
12923 msgid ""
12924 " int\n"
12925 " guestfs_mke2journal_L (guestfs_h *g,\n"
12926 "                        int blocksize,\n"
12927 "                        const char *label,\n"
12928 "                        const char *device);\n"
12929 "\n"
12930 msgstr ""
12931
12932 #. type: textblock
12933 #: ../src/guestfs-actions.pod:4358 ../fish/guestfish-actions.pod:2969
12934 msgid "This creates an ext2 external journal on C<device> with label C<label>."
12935 msgstr ""
12936
12937 #. type: =head2
12938 #: ../src/guestfs-actions.pod:4364
12939 msgid "guestfs_mke2journal_U"
12940 msgstr ""
12941
12942 #. type: verbatim
12943 #: ../src/guestfs-actions.pod:4366
12944 #, no-wrap
12945 msgid ""
12946 " int\n"
12947 " guestfs_mke2journal_U (guestfs_h *g,\n"
12948 "                        int blocksize,\n"
12949 "                        const char *uuid,\n"
12950 "                        const char *device);\n"
12951 "\n"
12952 msgstr ""
12953
12954 #. type: textblock
12955 #: ../src/guestfs-actions.pod:4372 ../fish/guestfish-actions.pod:2975
12956 msgid "This creates an ext2 external journal on C<device> with UUID C<uuid>."
12957 msgstr ""
12958
12959 #. type: =head2
12960 #: ../src/guestfs-actions.pod:4378
12961 msgid "guestfs_mkfifo"
12962 msgstr ""
12963
12964 #. type: verbatim
12965 #: ../src/guestfs-actions.pod:4380
12966 #, no-wrap
12967 msgid ""
12968 " int\n"
12969 " guestfs_mkfifo (guestfs_h *g,\n"
12970 "                 int mode,\n"
12971 "                 const char *path);\n"
12972 "\n"
12973 msgstr ""
12974
12975 #. type: textblock
12976 #: ../src/guestfs-actions.pod:4385
12977 msgid ""
12978 "This call creates a FIFO (named pipe) called C<path> with mode C<mode>.  It "
12979 "is just a convenient wrapper around C<guestfs_mknod>."
12980 msgstr ""
12981
12982 #. type: =head2
12983 #: ../src/guestfs-actions.pod:4395
12984 msgid "guestfs_mkfs"
12985 msgstr ""
12986
12987 #. type: verbatim
12988 #: ../src/guestfs-actions.pod:4397
12989 #, no-wrap
12990 msgid ""
12991 " int\n"
12992 " guestfs_mkfs (guestfs_h *g,\n"
12993 "               const char *fstype,\n"
12994 "               const char *device);\n"
12995 "\n"
12996 msgstr ""
12997
12998 #. type: textblock
12999 #: ../src/guestfs-actions.pod:4402 ../fish/guestfish-actions.pod:2991
13000 msgid ""
13001 "This creates a filesystem on C<device> (usually a partition or LVM logical "
13002 "volume).  The filesystem type is C<fstype>, for example C<ext3>."
13003 msgstr ""
13004
13005 #. type: =head2
13006 #: ../src/guestfs-actions.pod:4410
13007 msgid "guestfs_mkfs_b"
13008 msgstr ""
13009
13010 #. type: verbatim
13011 #: ../src/guestfs-actions.pod:4412
13012 #, no-wrap
13013 msgid ""
13014 " int\n"
13015 " guestfs_mkfs_b (guestfs_h *g,\n"
13016 "                 const char *fstype,\n"
13017 "                 int blocksize,\n"
13018 "                 const char *device);\n"
13019 "\n"
13020 msgstr ""
13021
13022 #. type: textblock
13023 #: ../src/guestfs-actions.pod:4418
13024 msgid ""
13025 "This call is similar to C<guestfs_mkfs>, but it allows you to control the "
13026 "block size of the resulting filesystem.  Supported block sizes depend on the "
13027 "filesystem type, but typically they are C<1024>, C<2048> or C<4096> only."
13028 msgstr ""
13029
13030 #. type: textblock
13031 #: ../src/guestfs-actions.pod:4423 ../src/guestfs-actions.pod:4466 ../fish/guestfish-actions.pod:3004 ../fish/guestfish-actions.pod:3031
13032 msgid ""
13033 "For VFAT and NTFS the C<blocksize> parameter is treated as the requested "
13034 "cluster size."
13035 msgstr ""
13036
13037 #. type: textblock
13038 #: ../src/guestfs-actions.pod:4428
13039 msgid ""
13040 "This function is deprecated.  In new code, use the L</guestfs_mkfs_opts> "
13041 "call instead."
13042 msgstr ""
13043
13044 #. type: =head2
13045 #: ../src/guestfs-actions.pod:4437
13046 msgid "guestfs_mkfs_opts"
13047 msgstr ""
13048
13049 #. type: verbatim
13050 #: ../src/guestfs-actions.pod:4439
13051 #, no-wrap
13052 msgid ""
13053 " int\n"
13054 " guestfs_mkfs_opts (guestfs_h *g,\n"
13055 "                    const char *fstype,\n"
13056 "                    const char *device,\n"
13057 "                    ...);\n"
13058 "\n"
13059 msgstr ""
13060
13061 #. type: verbatim
13062 #: ../src/guestfs-actions.pod:4450
13063 #, no-wrap
13064 msgid ""
13065 " GUESTFS_MKFS_OPTS_BLOCKSIZE, int blocksize,\n"
13066 " GUESTFS_MKFS_OPTS_FEATURES, const char *features,\n"
13067 "\n"
13068 msgstr ""
13069
13070 #. type: textblock
13071 #: ../src/guestfs-actions.pod:4453 ../fish/guestfish-actions.pod:3018
13072 msgid ""
13073 "This function creates a filesystem on C<device>.  The filesystem type is "
13074 "C<fstype>, for example C<ext3>."
13075 msgstr ""
13076
13077 #. type: =item
13078 #: ../src/guestfs-actions.pod:4460 ../fish/guestfish-actions.pod:3025
13079 msgid "C<blocksize>"
13080 msgstr ""
13081
13082 #. type: textblock
13083 #: ../src/guestfs-actions.pod:4462 ../fish/guestfish-actions.pod:3027
13084 msgid ""
13085 "The filesystem block size.  Supported block sizes depend on the filesystem "
13086 "type, but typically they are C<1024>, C<2048> or C<4096> for Linux ext2/3 "
13087 "filesystems."
13088 msgstr ""
13089
13090 #. type: textblock
13091 #: ../src/guestfs-actions.pod:4469 ../fish/guestfish-actions.pod:3034
13092 msgid "For UFS block sizes, please see L<mkfs.ufs(8)>."
13093 msgstr ""
13094
13095 #. type: =item
13096 #: ../src/guestfs-actions.pod:4471 ../fish/guestfish-actions.pod:3036
13097 msgid "C<features>"
13098 msgstr ""
13099
13100 #. type: textblock
13101 #: ../src/guestfs-actions.pod:4473 ../fish/guestfish-actions.pod:3038
13102 msgid "This passes the I<-O> parameter to the external mkfs program."
13103 msgstr ""
13104
13105 #. type: textblock
13106 #: ../src/guestfs-actions.pod:4475 ../fish/guestfish-actions.pod:3040
13107 msgid ""
13108 "For certain filesystem types, this allows extra filesystem features to be "
13109 "selected.  See L<mke2fs(8)> and L<mkfs.ufs(8)> for more details."
13110 msgstr ""
13111
13112 #. type: textblock
13113 #: ../src/guestfs-actions.pod:4479 ../fish/guestfish-actions.pod:3044
13114 msgid ""
13115 "You cannot use this optional parameter with the C<gfs> or C<gfs2> filesystem "
13116 "type."
13117 msgstr ""
13118
13119 #. type: textblock
13120 #: ../src/guestfs-actions.pod:4486
13121 msgid "(Added in 1.7.19)"
13122 msgstr ""
13123
13124 #. type: =head2
13125 #: ../src/guestfs-actions.pod:4488
13126 msgid "guestfs_mkfs_opts_va"
13127 msgstr ""
13128
13129 #. type: verbatim
13130 #: ../src/guestfs-actions.pod:4490
13131 #, no-wrap
13132 msgid ""
13133 " int\n"
13134 " guestfs_mkfs_opts_va (guestfs_h *g,\n"
13135 "                       const char *fstype,\n"
13136 "                       const char *device,\n"
13137 "                       va_list args);\n"
13138 "\n"
13139 msgstr ""
13140
13141 #. type: textblock
13142 #: ../src/guestfs-actions.pod:4496
13143 msgid "This is the \"va_list variant\" of L</guestfs_mkfs_opts>."
13144 msgstr ""
13145
13146 #. type: =head2
13147 #: ../src/guestfs-actions.pod:4500
13148 msgid "guestfs_mkfs_opts_argv"
13149 msgstr ""
13150
13151 #. type: verbatim
13152 #: ../src/guestfs-actions.pod:4502
13153 #, no-wrap
13154 msgid ""
13155 " int\n"
13156 " guestfs_mkfs_opts_argv (guestfs_h *g,\n"
13157 "                         const char *fstype,\n"
13158 "                         const char *device,\n"
13159 "                         const struct guestfs_mkfs_opts_argv *optargs);\n"
13160 "\n"
13161 msgstr ""
13162
13163 #. type: textblock
13164 #: ../src/guestfs-actions.pod:4508
13165 msgid "This is the \"argv variant\" of L</guestfs_mkfs_opts>."
13166 msgstr ""
13167
13168 #. type: =head2
13169 #: ../src/guestfs-actions.pod:4512
13170 msgid "guestfs_mkmountpoint"
13171 msgstr ""
13172
13173 #. type: verbatim
13174 #: ../src/guestfs-actions.pod:4514
13175 #, no-wrap
13176 msgid ""
13177 " int\n"
13178 " guestfs_mkmountpoint (guestfs_h *g,\n"
13179 "                       const char *exemptpath);\n"
13180 "\n"
13181 msgstr ""
13182
13183 #. type: textblock
13184 #: ../src/guestfs-actions.pod:4518
13185 msgid ""
13186 "C<guestfs_mkmountpoint> and C<guestfs_rmmountpoint> are specialized calls "
13187 "that can be used to create extra mountpoints before mounting the first "
13188 "filesystem."
13189 msgstr ""
13190
13191 #. type: textblock
13192 #: ../src/guestfs-actions.pod:4522 ../fish/guestfish-actions.pod:3059
13193 msgid ""
13194 "These calls are I<only> necessary in some very limited circumstances, mainly "
13195 "the case where you want to mount a mix of unrelated and/or read-only "
13196 "filesystems together."
13197 msgstr ""
13198
13199 #. type: textblock
13200 #: ../src/guestfs-actions.pod:4526 ../fish/guestfish-actions.pod:3063
13201 msgid ""
13202 "For example, live CDs often contain a \"Russian doll\" nest of filesystems, "
13203 "an ISO outer layer, with a squashfs image inside, with an ext2/3 image "
13204 "inside that.  You can unpack this as follows in guestfish:"
13205 msgstr ""
13206
13207 #. type: verbatim
13208 #: ../src/guestfs-actions.pod:4531 ../fish/guestfish-actions.pod:3068
13209 #, no-wrap
13210 msgid ""
13211 " add-ro Fedora-11-i686-Live.iso\n"
13212 " run\n"
13213 " mkmountpoint /cd\n"
13214 " mkmountpoint /sqsh\n"
13215 " mkmountpoint /ext3fs\n"
13216 " mount /dev/sda /cd\n"
13217 " mount-loop /cd/LiveOS/squashfs.img /sqsh\n"
13218 " mount-loop /sqsh/LiveOS/ext3fs.img /ext3fs\n"
13219 "\n"
13220 msgstr ""
13221
13222 #. type: textblock
13223 #: ../src/guestfs-actions.pod:4540 ../fish/guestfish-actions.pod:3077
13224 msgid "The inner filesystem is now unpacked under the /ext3fs mountpoint."
13225 msgstr ""
13226
13227 #. type: textblock
13228 #: ../src/guestfs-actions.pod:4542
13229 msgid ""
13230 "C<guestfs_mkmountpoint> is not compatible with C<guestfs_umount_all>.  You "
13231 "may get unexpected errors if you try to mix these calls.  It is safest to "
13232 "manually unmount filesystems and remove mountpoints after use."
13233 msgstr ""
13234
13235 #. type: textblock
13236 #: ../src/guestfs-actions.pod:4546
13237 msgid ""
13238 "C<guestfs_umount_all> unmounts filesystems by sorting the paths longest "
13239 "first, so for this to work for manual mountpoints, you must ensure that the "
13240 "innermost mountpoints have the longest pathnames, as in the example code "
13241 "above."
13242 msgstr ""
13243
13244 #. type: textblock
13245 #: ../src/guestfs-actions.pod:4551 ../fish/guestfish-actions.pod:3088
13246 msgid "For more details see L<https://bugzilla.redhat.com/show_bug.cgi?id=599503>"
13247 msgstr ""
13248
13249 #. type: textblock
13250 #: ../src/guestfs-actions.pod:4553
13251 msgid ""
13252 "Autosync [see C<guestfs_set_autosync>, this is set by default on handles] "
13253 "can cause C<guestfs_umount_all> to be called when the handle is closed which "
13254 "can also trigger these issues."
13255 msgstr ""
13256
13257 #. type: textblock
13258 #: ../src/guestfs-actions.pod:4559 ../src/guestfs-actions.pod:4825 ../src/guestfs-actions.pod:5744
13259 msgid "(Added in 1.0.62)"
13260 msgstr ""
13261
13262 #. type: =head2
13263 #: ../src/guestfs-actions.pod:4561
13264 msgid "guestfs_mknod"
13265 msgstr ""
13266
13267 #. type: verbatim
13268 #: ../src/guestfs-actions.pod:4563
13269 #, no-wrap
13270 msgid ""
13271 " int\n"
13272 " guestfs_mknod (guestfs_h *g,\n"
13273 "                int mode,\n"
13274 "                int devmajor,\n"
13275 "                int devminor,\n"
13276 "                const char *path);\n"
13277 "\n"
13278 msgstr ""
13279
13280 #. type: textblock
13281 #: ../src/guestfs-actions.pod:4570 ../fish/guestfish-actions.pod:3098
13282 msgid ""
13283 "This call creates block or character special devices, or named pipes "
13284 "(FIFOs)."
13285 msgstr ""
13286
13287 #. type: textblock
13288 #: ../src/guestfs-actions.pod:4573 ../fish/guestfish-actions.pod:3101
13289 msgid ""
13290 "The C<mode> parameter should be the mode, using the standard constants.  "
13291 "C<devmajor> and C<devminor> are the device major and minor numbers, only "
13292 "used when creating block and character special devices."
13293 msgstr ""
13294
13295 #. type: textblock
13296 #: ../src/guestfs-actions.pod:4578
13297 msgid ""
13298 "Note that, just like L<mknod(2)>, the mode must be bitwise OR'd with "
13299 "S_IFBLK, S_IFCHR, S_IFIFO or S_IFSOCK (otherwise this call just creates a "
13300 "regular file).  These constants are available in the standard Linux header "
13301 "files, or you can use C<guestfs_mknod_b>, C<guestfs_mknod_c> or "
13302 "C<guestfs_mkfifo> which are wrappers around this command which bitwise OR in "
13303 "the appropriate constant for you."
13304 msgstr ""
13305
13306 #. type: =head2
13307 #: ../src/guestfs-actions.pod:4592
13308 msgid "guestfs_mknod_b"
13309 msgstr ""
13310
13311 #. type: verbatim
13312 #: ../src/guestfs-actions.pod:4594
13313 #, no-wrap
13314 msgid ""
13315 " int\n"
13316 " guestfs_mknod_b (guestfs_h *g,\n"
13317 "                  int mode,\n"
13318 "                  int devmajor,\n"
13319 "                  int devminor,\n"
13320 "                  const char *path);\n"
13321 "\n"
13322 msgstr ""
13323
13324 #. type: textblock
13325 #: ../src/guestfs-actions.pod:4601
13326 msgid ""
13327 "This call creates a block device node called C<path> with mode C<mode> and "
13328 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
13329 "wrapper around C<guestfs_mknod>."
13330 msgstr ""
13331
13332 #. type: =head2
13333 #: ../src/guestfs-actions.pod:4611
13334 msgid "guestfs_mknod_c"
13335 msgstr ""
13336
13337 #. type: verbatim
13338 #: ../src/guestfs-actions.pod:4613
13339 #, no-wrap
13340 msgid ""
13341 " int\n"
13342 " guestfs_mknod_c (guestfs_h *g,\n"
13343 "                  int mode,\n"
13344 "                  int devmajor,\n"
13345 "                  int devminor,\n"
13346 "                  const char *path);\n"
13347 "\n"
13348 msgstr ""
13349
13350 #. type: textblock
13351 #: ../src/guestfs-actions.pod:4620
13352 msgid ""
13353 "This call creates a char device node called C<path> with mode C<mode> and "
13354 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
13355 "wrapper around C<guestfs_mknod>."
13356 msgstr ""
13357
13358 #. type: =head2
13359 #: ../src/guestfs-actions.pod:4630
13360 msgid "guestfs_mkswap"
13361 msgstr ""
13362
13363 #. type: verbatim
13364 #: ../src/guestfs-actions.pod:4632
13365 #, no-wrap
13366 msgid ""
13367 " int\n"
13368 " guestfs_mkswap (guestfs_h *g,\n"
13369 "                 const char *device);\n"
13370 "\n"
13371 msgstr ""
13372
13373 #. type: textblock
13374 #: ../src/guestfs-actions.pod:4636 ../fish/guestfish-actions.pod:3140
13375 msgid "Create a swap partition on C<device>."
13376 msgstr ""
13377
13378 #. type: =head2
13379 #: ../src/guestfs-actions.pod:4642
13380 msgid "guestfs_mkswap_L"
13381 msgstr ""
13382
13383 #. type: verbatim
13384 #: ../src/guestfs-actions.pod:4644
13385 #, no-wrap
13386 msgid ""
13387 " int\n"
13388 " guestfs_mkswap_L (guestfs_h *g,\n"
13389 "                   const char *label,\n"
13390 "                   const char *device);\n"
13391 "\n"
13392 msgstr ""
13393
13394 #. type: textblock
13395 #: ../src/guestfs-actions.pod:4649 ../fish/guestfish-actions.pod:3146
13396 msgid "Create a swap partition on C<device> with label C<label>."
13397 msgstr ""
13398
13399 #. type: textblock
13400 #: ../src/guestfs-actions.pod:4651 ../fish/guestfish-actions.pod:3148
13401 msgid ""
13402 "Note that you cannot attach a swap label to a block device "
13403 "(eg. C</dev/sda>), just to a partition.  This appears to be a limitation of "
13404 "the kernel or swap tools."
13405 msgstr ""
13406
13407 #. type: =head2
13408 #: ../src/guestfs-actions.pod:4659
13409 msgid "guestfs_mkswap_U"
13410 msgstr ""
13411
13412 #. type: verbatim
13413 #: ../src/guestfs-actions.pod:4661
13414 #, no-wrap
13415 msgid ""
13416 " int\n"
13417 " guestfs_mkswap_U (guestfs_h *g,\n"
13418 "                   const char *uuid,\n"
13419 "                   const char *device);\n"
13420 "\n"
13421 msgstr ""
13422
13423 #. type: textblock
13424 #: ../src/guestfs-actions.pod:4666 ../fish/guestfish-actions.pod:3156
13425 msgid "Create a swap partition on C<device> with UUID C<uuid>."
13426 msgstr ""
13427
13428 #. type: =head2
13429 #: ../src/guestfs-actions.pod:4672
13430 msgid "guestfs_mkswap_file"
13431 msgstr ""
13432
13433 #. type: verbatim
13434 #: ../src/guestfs-actions.pod:4674
13435 #, no-wrap
13436 msgid ""
13437 " int\n"
13438 " guestfs_mkswap_file (guestfs_h *g,\n"
13439 "                      const char *path);\n"
13440 "\n"
13441 msgstr ""
13442
13443 #. type: textblock
13444 #: ../src/guestfs-actions.pod:4678 ../fish/guestfish-actions.pod:3162
13445 msgid "Create a swap file."
13446 msgstr ""
13447
13448 #. type: textblock
13449 #: ../src/guestfs-actions.pod:4680
13450 msgid ""
13451 "This command just writes a swap file signature to an existing file.  To "
13452 "create the file itself, use something like C<guestfs_fallocate>."
13453 msgstr ""
13454
13455 #. type: =head2
13456 #: ../src/guestfs-actions.pod:4687
13457 msgid "guestfs_modprobe"
13458 msgstr ""
13459
13460 #. type: verbatim
13461 #: ../src/guestfs-actions.pod:4689
13462 #, no-wrap
13463 msgid ""
13464 " int\n"
13465 " guestfs_modprobe (guestfs_h *g,\n"
13466 "                   const char *modulename);\n"
13467 "\n"
13468 msgstr ""
13469
13470 #. type: textblock
13471 #: ../src/guestfs-actions.pod:4693 ../fish/guestfish-actions.pod:3171
13472 msgid "This loads a kernel module in the appliance."
13473 msgstr ""
13474
13475 #. type: textblock
13476 #: ../src/guestfs-actions.pod:4695 ../fish/guestfish-actions.pod:3173
13477 msgid ""
13478 "The kernel module must have been whitelisted when libguestfs was built (see "
13479 "C<appliance/kmod.whitelist.in> in the source)."
13480 msgstr ""
13481
13482 #. type: =head2
13483 #: ../src/guestfs-actions.pod:4702
13484 msgid "guestfs_mount"
13485 msgstr ""
13486
13487 #. type: verbatim
13488 #: ../src/guestfs-actions.pod:4704
13489 #, no-wrap
13490 msgid ""
13491 " int\n"
13492 " guestfs_mount (guestfs_h *g,\n"
13493 "                const char *device,\n"
13494 "                const char *mountpoint);\n"
13495 "\n"
13496 msgstr ""
13497
13498 #. type: textblock
13499 #: ../src/guestfs-actions.pod:4709 ../fish/guestfish-actions.pod:3180
13500 msgid ""
13501 "Mount a guest disk at a position in the filesystem.  Block devices are named "
13502 "C</dev/sda>, C</dev/sdb> and so on, as they were added to the guest.  If "
13503 "those block devices contain partitions, they will have the usual names "
13504 "(eg. C</dev/sda1>).  Also LVM C</dev/VG/LV>-style names can be used."
13505 msgstr ""
13506
13507 #. type: textblock
13508 #: ../src/guestfs-actions.pod:4715 ../fish/guestfish-actions.pod:3186
13509 msgid ""
13510 "The rules are the same as for L<mount(2)>: A filesystem must first be "
13511 "mounted on C</> before others can be mounted.  Other filesystems can only be "
13512 "mounted on directories which already exist."
13513 msgstr ""
13514
13515 #. type: textblock
13516 #: ../src/guestfs-actions.pod:4720 ../fish/guestfish-actions.pod:3191
13517 msgid ""
13518 "The mounted filesystem is writable, if we have sufficient permissions on the "
13519 "underlying device."
13520 msgstr ""
13521
13522 #. type: textblock
13523 #: ../src/guestfs-actions.pod:4723
13524 msgid ""
13525 "B<Important note:> When you use this call, the filesystem options C<sync> "
13526 "and C<noatime> are set implicitly.  This was originally done because we "
13527 "thought it would improve reliability, but it turns out that I<-o sync> has a "
13528 "very large negative performance impact and negligible effect on "
13529 "reliability.  Therefore we recommend that you avoid using C<guestfs_mount> "
13530 "in any code that needs performance, and instead use C<guestfs_mount_options> "
13531 "(use an empty string for the first parameter if you don't want any options)."
13532 msgstr ""
13533
13534 #. type: textblock
13535 #: ../src/guestfs-actions.pod:4735
13536 msgid ""
13537 "This function is deprecated.  In new code, use the L</guestfs_mount_options> "
13538 "call instead."
13539 msgstr ""
13540
13541 #. type: =head2
13542 #: ../src/guestfs-actions.pod:4744
13543 msgid "guestfs_mount_loop"
13544 msgstr ""
13545
13546 #. type: verbatim
13547 #: ../src/guestfs-actions.pod:4746
13548 #, no-wrap
13549 msgid ""
13550 " int\n"
13551 " guestfs_mount_loop (guestfs_h *g,\n"
13552 "                     const char *file,\n"
13553 "                     const char *mountpoint);\n"
13554 "\n"
13555 msgstr ""
13556
13557 #. type: textblock
13558 #: ../src/guestfs-actions.pod:4751 ../fish/guestfish-actions.pod:3215
13559 msgid ""
13560 "This command lets you mount C<file> (a filesystem image in a file) on a "
13561 "mount point.  It is entirely equivalent to the command C<mount -o loop file "
13562 "mountpoint>."
13563 msgstr ""
13564
13565 #. type: =head2
13566 #: ../src/guestfs-actions.pod:4759
13567 msgid "guestfs_mount_options"
13568 msgstr ""
13569
13570 #. type: verbatim
13571 #: ../src/guestfs-actions.pod:4761
13572 #, no-wrap
13573 msgid ""
13574 " int\n"
13575 " guestfs_mount_options (guestfs_h *g,\n"
13576 "                        const char *options,\n"
13577 "                        const char *device,\n"
13578 "                        const char *mountpoint);\n"
13579 "\n"
13580 msgstr ""
13581
13582 #. type: textblock
13583 #: ../src/guestfs-actions.pod:4767
13584 msgid ""
13585 "This is the same as the C<guestfs_mount> command, but it allows you to set "
13586 "the mount options as for the L<mount(8)> I<-o> flag."
13587 msgstr ""
13588
13589 #. type: textblock
13590 #: ../src/guestfs-actions.pod:4771 ../fish/guestfish-actions.pod:3227
13591 msgid ""
13592 "If the C<options> parameter is an empty string, then no options are passed "
13593 "(all options default to whatever the filesystem uses)."
13594 msgstr ""
13595
13596 #. type: textblock
13597 #: ../src/guestfs-actions.pod:4777 ../src/guestfs-actions.pod:4791 ../src/guestfs-actions.pod:4808
13598 msgid "(Added in 1.0.10)"
13599 msgstr ""
13600
13601 #. type: =head2
13602 #: ../src/guestfs-actions.pod:4779
13603 msgid "guestfs_mount_ro"
13604 msgstr ""
13605
13606 #. type: verbatim
13607 #: ../src/guestfs-actions.pod:4781
13608 #, no-wrap
13609 msgid ""
13610 " int\n"
13611 " guestfs_mount_ro (guestfs_h *g,\n"
13612 "                   const char *device,\n"
13613 "                   const char *mountpoint);\n"
13614 "\n"
13615 msgstr ""
13616
13617 #. type: textblock
13618 #: ../src/guestfs-actions.pod:4786
13619 msgid ""
13620 "This is the same as the C<guestfs_mount> command, but it mounts the "
13621 "filesystem with the read-only (I<-o ro>) flag."
13622 msgstr ""
13623
13624 #. type: =head2
13625 #: ../src/guestfs-actions.pod:4793
13626 msgid "guestfs_mount_vfs"
13627 msgstr ""
13628
13629 #. type: verbatim
13630 #: ../src/guestfs-actions.pod:4795
13631 #, no-wrap
13632 msgid ""
13633 " int\n"
13634 " guestfs_mount_vfs (guestfs_h *g,\n"
13635 "                    const char *options,\n"
13636 "                    const char *vfstype,\n"
13637 "                    const char *device,\n"
13638 "                    const char *mountpoint);\n"
13639 "\n"
13640 msgstr ""
13641
13642 #. type: textblock
13643 #: ../src/guestfs-actions.pod:4802
13644 msgid ""
13645 "This is the same as the C<guestfs_mount> command, but it allows you to set "
13646 "both the mount options and the vfstype as for the L<mount(8)> I<-o> and "
13647 "I<-t> flags."
13648 msgstr ""
13649
13650 #. type: =head2
13651 #: ../src/guestfs-actions.pod:4810
13652 msgid "guestfs_mountpoints"
13653 msgstr ""
13654
13655 #. type: verbatim
13656 #: ../src/guestfs-actions.pod:4812
13657 #, no-wrap
13658 msgid ""
13659 " char **\n"
13660 " guestfs_mountpoints (guestfs_h *g);\n"
13661 "\n"
13662 msgstr ""
13663
13664 #. type: textblock
13665 #: ../src/guestfs-actions.pod:4815
13666 msgid ""
13667 "This call is similar to C<guestfs_mounts>.  That call returns a list of "
13668 "devices.  This one returns a hash table (map) of device name to directory "
13669 "where the device is mounted."
13670 msgstr ""
13671
13672 #. type: =head2
13673 #: ../src/guestfs-actions.pod:4827
13674 msgid "guestfs_mounts"
13675 msgstr ""
13676
13677 #. type: verbatim
13678 #: ../src/guestfs-actions.pod:4829
13679 #, no-wrap
13680 msgid ""
13681 " char **\n"
13682 " guestfs_mounts (guestfs_h *g);\n"
13683 "\n"
13684 msgstr ""
13685
13686 #. type: textblock
13687 #: ../src/guestfs-actions.pod:4832 ../fish/guestfish-actions.pod:3258
13688 msgid ""
13689 "This returns the list of currently mounted filesystems.  It returns the list "
13690 "of devices (eg. C</dev/sda1>, C</dev/VG/LV>)."
13691 msgstr ""
13692
13693 #. type: textblock
13694 #: ../src/guestfs-actions.pod:4835 ../fish/guestfish-actions.pod:3261
13695 msgid "Some internal mounts are not shown."
13696 msgstr ""
13697
13698 #. type: textblock
13699 #: ../src/guestfs-actions.pod:4837
13700 msgid "See also: C<guestfs_mountpoints>"
13701 msgstr ""
13702
13703 #. type: =head2
13704 #: ../src/guestfs-actions.pod:4845
13705 msgid "guestfs_mv"
13706 msgstr ""
13707
13708 #. type: verbatim
13709 #: ../src/guestfs-actions.pod:4847
13710 #, no-wrap
13711 msgid ""
13712 " int\n"
13713 " guestfs_mv (guestfs_h *g,\n"
13714 "             const char *src,\n"
13715 "             const char *dest);\n"
13716 "\n"
13717 msgstr ""
13718
13719 #. type: textblock
13720 #: ../src/guestfs-actions.pod:4852 ../fish/guestfish-actions.pod:3269
13721 msgid ""
13722 "This moves a file from C<src> to C<dest> where C<dest> is either a "
13723 "destination filename or destination directory."
13724 msgstr ""
13725
13726 #. type: =head2
13727 #: ../src/guestfs-actions.pod:4859
13728 msgid "guestfs_ntfs_3g_probe"
13729 msgstr ""
13730
13731 #. type: verbatim
13732 #: ../src/guestfs-actions.pod:4861
13733 #, no-wrap
13734 msgid ""
13735 " int\n"
13736 " guestfs_ntfs_3g_probe (guestfs_h *g,\n"
13737 "                        int rw,\n"
13738 "                        const char *device);\n"
13739 "\n"
13740 msgstr ""
13741
13742 #. type: textblock
13743 #: ../src/guestfs-actions.pod:4866 ../fish/guestfish-actions.pod:3276
13744 msgid ""
13745 "This command runs the L<ntfs-3g.probe(8)> command which probes an NTFS "
13746 "C<device> for mountability.  (Not all NTFS volumes can be mounted "
13747 "read-write, and some cannot be mounted at all)."
13748 msgstr ""
13749
13750 #. type: textblock
13751 #: ../src/guestfs-actions.pod:4870 ../fish/guestfish-actions.pod:3280
13752 msgid ""
13753 "C<rw> is a boolean flag.  Set it to true if you want to test if the volume "
13754 "can be mounted read-write.  Set it to false if you want to test if the "
13755 "volume can be mounted read-only."
13756 msgstr ""
13757
13758 #. type: textblock
13759 #: ../src/guestfs-actions.pod:4874 ../fish/guestfish-actions.pod:3284
13760 msgid ""
13761 "The return value is an integer which C<0> if the operation would succeed, or "
13762 "some non-zero value documented in the L<ntfs-3g.probe(8)> manual page."
13763 msgstr ""
13764
13765 #. type: textblock
13766 #: ../src/guestfs-actions.pod:4880
13767 msgid "(Added in 1.0.43)"
13768 msgstr ""
13769
13770 #. type: =head2
13771 #: ../src/guestfs-actions.pod:4882
13772 msgid "guestfs_ntfsresize"
13773 msgstr ""
13774
13775 #. type: verbatim
13776 #: ../src/guestfs-actions.pod:4884
13777 #, no-wrap
13778 msgid ""
13779 " int\n"
13780 " guestfs_ntfsresize (guestfs_h *g,\n"
13781 "                     const char *device);\n"
13782 "\n"
13783 msgstr ""
13784
13785 #. type: textblock
13786 #: ../src/guestfs-actions.pod:4888 ../fish/guestfish-actions.pod:3292
13787 msgid ""
13788 "This command resizes an NTFS filesystem, expanding or shrinking it to the "
13789 "size of the underlying device."
13790 msgstr ""
13791
13792 #. type: textblock
13793 #: ../src/guestfs-actions.pod:4891 ../fish/guestfish-actions.pod:3295
13794 msgid ""
13795 "I<Note:> After the resize operation, the filesystem is marked as requiring a "
13796 "consistency check (for safety).  You have to boot into Windows to perform "
13797 "this check and clear this condition.  Furthermore, ntfsresize refuses to "
13798 "resize filesystems which have been marked in this way.  So in effect it is "
13799 "not possible to call ntfsresize multiple times on a single filesystem "
13800 "without booting into Windows between each resize."
13801 msgstr ""
13802
13803 #. type: textblock
13804 #: ../src/guestfs-actions.pod:4899 ../fish/guestfish-actions.pod:3303
13805 msgid "See also L<ntfsresize(8)>."
13806 msgstr ""
13807
13808 #. type: =head2
13809 #: ../src/guestfs-actions.pod:4905
13810 msgid "guestfs_ntfsresize_size"
13811 msgstr ""
13812
13813 #. type: verbatim
13814 #: ../src/guestfs-actions.pod:4907
13815 #, no-wrap
13816 msgid ""
13817 " int\n"
13818 " guestfs_ntfsresize_size (guestfs_h *g,\n"
13819 "                          const char *device,\n"
13820 "                          int64_t size);\n"
13821 "\n"
13822 msgstr ""
13823
13824 #. type: textblock
13825 #: ../src/guestfs-actions.pod:4912
13826 msgid ""
13827 "This command is the same as C<guestfs_ntfsresize> except that it allows you "
13828 "to specify the new size (in bytes) explicitly."
13829 msgstr ""
13830
13831 #. type: textblock
13832 #: ../src/guestfs-actions.pod:4917 ../src/guestfs-actions.pod:5353 ../src/guestfs-actions.pod:5426 ../src/guestfs-actions.pod:5692 ../src/guestfs-actions.pod:7298
13833 msgid "(Added in 1.3.14)"
13834 msgstr ""
13835
13836 #. type: =head2
13837 #: ../src/guestfs-actions.pod:4919
13838 msgid "guestfs_part_add"
13839 msgstr ""
13840
13841 #. type: verbatim
13842 #: ../src/guestfs-actions.pod:4921
13843 #, no-wrap
13844 msgid ""
13845 " int\n"
13846 " guestfs_part_add (guestfs_h *g,\n"
13847 "                   const char *device,\n"
13848 "                   const char *prlogex,\n"
13849 "                   int64_t startsect,\n"
13850 "                   int64_t endsect);\n"
13851 "\n"
13852 msgstr ""
13853
13854 #. type: textblock
13855 #: ../src/guestfs-actions.pod:4928
13856 msgid ""
13857 "This command adds a partition to C<device>.  If there is no partition table "
13858 "on the device, call C<guestfs_part_init> first."
13859 msgstr ""
13860
13861 #. type: textblock
13862 #: ../src/guestfs-actions.pod:4931 ../fish/guestfish-actions.pod:3319
13863 msgid ""
13864 "The C<prlogex> parameter is the type of partition.  Normally you should pass "
13865 "C<p> or C<primary> here, but MBR partition tables also support C<l> (or "
13866 "C<logical>) and C<e> (or C<extended>) partition types."
13867 msgstr ""
13868
13869 #. type: textblock
13870 #: ../src/guestfs-actions.pod:4936 ../fish/guestfish-actions.pod:3324
13871 msgid ""
13872 "C<startsect> and C<endsect> are the start and end of the partition in "
13873 "I<sectors>.  C<endsect> may be negative, which means it counts backwards "
13874 "from the end of the disk (C<-1> is the last sector)."
13875 msgstr ""
13876
13877 #. type: textblock
13878 #: ../src/guestfs-actions.pod:4940
13879 msgid ""
13880 "Creating a partition which covers the whole disk is not so easy.  Use "
13881 "C<guestfs_part_disk> to do that."
13882 msgstr ""
13883
13884 #. type: textblock
13885 #: ../src/guestfs-actions.pod:4945 ../src/guestfs-actions.pod:4983 ../src/guestfs-actions.pod:5036 ../src/guestfs-actions.pod:5114 ../src/guestfs-actions.pod:5152 ../src/guestfs-actions.pod:5171 ../src/guestfs-actions.pod:5211
13886 msgid "(Added in 1.0.78)"
13887 msgstr ""
13888
13889 #. type: =head2
13890 #: ../src/guestfs-actions.pod:4947
13891 msgid "guestfs_part_del"
13892 msgstr ""
13893
13894 #. type: verbatim
13895 #: ../src/guestfs-actions.pod:4949
13896 #, no-wrap
13897 msgid ""
13898 " int\n"
13899 " guestfs_part_del (guestfs_h *g,\n"
13900 "                   const char *device,\n"
13901 "                   int partnum);\n"
13902 "\n"
13903 msgstr ""
13904
13905 #. type: textblock
13906 #: ../src/guestfs-actions.pod:4954 ../fish/guestfish-actions.pod:3335
13907 msgid "This command deletes the partition numbered C<partnum> on C<device>."
13908 msgstr ""
13909
13910 #. type: textblock
13911 #: ../src/guestfs-actions.pod:4956 ../fish/guestfish-actions.pod:3337
13912 msgid ""
13913 "Note that in the case of MBR partitioning, deleting an extended partition "
13914 "also deletes any logical partitions it contains."
13915 msgstr ""
13916
13917 #. type: =head2
13918 #: ../src/guestfs-actions.pod:4964
13919 msgid "guestfs_part_disk"
13920 msgstr ""
13921
13922 #. type: verbatim
13923 #: ../src/guestfs-actions.pod:4966
13924 #, no-wrap
13925 msgid ""
13926 " int\n"
13927 " guestfs_part_disk (guestfs_h *g,\n"
13928 "                    const char *device,\n"
13929 "                    const char *parttype);\n"
13930 "\n"
13931 msgstr ""
13932
13933 #. type: textblock
13934 #: ../src/guestfs-actions.pod:4971
13935 msgid ""
13936 "This command is simply a combination of C<guestfs_part_init> followed by "
13937 "C<guestfs_part_add> to create a single primary partition covering the whole "
13938 "disk."
13939 msgstr ""
13940
13941 #. type: textblock
13942 #: ../src/guestfs-actions.pod:4975
13943 msgid ""
13944 "C<parttype> is the partition table type, usually C<mbr> or C<gpt>, but other "
13945 "possible values are described in C<guestfs_part_init>."
13946 msgstr ""
13947
13948 #. type: =head2
13949 #: ../src/guestfs-actions.pod:4985
13950 msgid "guestfs_part_get_bootable"
13951 msgstr ""
13952
13953 #. type: verbatim
13954 #: ../src/guestfs-actions.pod:4987
13955 #, no-wrap
13956 msgid ""
13957 " int\n"
13958 " guestfs_part_get_bootable (guestfs_h *g,\n"
13959 "                            const char *device,\n"
13960 "                            int partnum);\n"
13961 "\n"
13962 msgstr ""
13963
13964 #. type: textblock
13965 #: ../src/guestfs-actions.pod:4992 ../fish/guestfish-actions.pod:3359
13966 msgid ""
13967 "This command returns true if the partition C<partnum> on C<device> has the "
13968 "bootable flag set."
13969 msgstr ""
13970
13971 #. type: textblock
13972 #: ../src/guestfs-actions.pod:4995
13973 msgid "See also C<guestfs_part_set_bootable>."
13974 msgstr ""
13975
13976 #. type: =head2
13977 #: ../src/guestfs-actions.pod:5001
13978 msgid "guestfs_part_get_mbr_id"
13979 msgstr ""
13980
13981 #. type: verbatim
13982 #: ../src/guestfs-actions.pod:5003
13983 #, no-wrap
13984 msgid ""
13985 " int\n"
13986 " guestfs_part_get_mbr_id (guestfs_h *g,\n"
13987 "                          const char *device,\n"
13988 "                          int partnum);\n"
13989 "\n"
13990 msgstr ""
13991
13992 #. type: textblock
13993 #: ../src/guestfs-actions.pod:5008 ../fish/guestfish-actions.pod:3368
13994 msgid ""
13995 "Returns the MBR type byte (also known as the ID byte) from the numbered "
13996 "partition C<partnum>."
13997 msgstr ""
13998
13999 #. type: textblock
14000 #: ../src/guestfs-actions.pod:5011 ../src/guestfs-actions.pod:5187
14001 msgid ""
14002 "Note that only MBR (old DOS-style) partitions have type bytes.  You will get "
14003 "undefined results for other partition table types (see "
14004 "C<guestfs_part_get_parttype>)."
14005 msgstr ""
14006
14007 #. type: =head2
14008 #: ../src/guestfs-actions.pod:5019
14009 msgid "guestfs_part_get_parttype"
14010 msgstr ""
14011
14012 #. type: verbatim
14013 #: ../src/guestfs-actions.pod:5021
14014 #, no-wrap
14015 msgid ""
14016 " char *\n"
14017 " guestfs_part_get_parttype (guestfs_h *g,\n"
14018 "                            const char *device);\n"
14019 "\n"
14020 msgstr ""
14021
14022 #. type: textblock
14023 #: ../src/guestfs-actions.pod:5025 ../fish/guestfish-actions.pod:3379
14024 msgid ""
14025 "This command examines the partition table on C<device> and returns the "
14026 "partition table type (format) being used."
14027 msgstr ""
14028
14029 #. type: textblock
14030 #: ../src/guestfs-actions.pod:5028
14031 msgid ""
14032 "Common return values include: C<msdos> (a DOS/Windows style MBR partition "
14033 "table), C<gpt> (a GPT/EFI-style partition table).  Other values are "
14034 "possible, although unusual.  See C<guestfs_part_init> for a full list."
14035 msgstr ""
14036
14037 #. type: =head2
14038 #: ../src/guestfs-actions.pod:5038
14039 msgid "guestfs_part_init"
14040 msgstr ""
14041
14042 #. type: verbatim
14043 #: ../src/guestfs-actions.pod:5040
14044 #, no-wrap
14045 msgid ""
14046 " int\n"
14047 " guestfs_part_init (guestfs_h *g,\n"
14048 "                    const char *device,\n"
14049 "                    const char *parttype);\n"
14050 "\n"
14051 msgstr ""
14052
14053 #. type: textblock
14054 #: ../src/guestfs-actions.pod:5045 ../fish/guestfish-actions.pod:3391
14055 msgid ""
14056 "This creates an empty partition table on C<device> of one of the partition "
14057 "types listed below.  Usually C<parttype> should be either C<msdos> or C<gpt> "
14058 "(for large disks)."
14059 msgstr ""
14060
14061 #. type: textblock
14062 #: ../src/guestfs-actions.pod:5049
14063 msgid ""
14064 "Initially there are no partitions.  Following this, you should call "
14065 "C<guestfs_part_add> for each partition required."
14066 msgstr ""
14067
14068 #. type: textblock
14069 #: ../src/guestfs-actions.pod:5052 ../fish/guestfish-actions.pod:3398
14070 msgid "Possible values for C<parttype> are:"
14071 msgstr ""
14072
14073 #. type: =item
14074 #: ../src/guestfs-actions.pod:5056 ../fish/guestfish-actions.pod:3402
14075 msgid "B<efi> | B<gpt>"
14076 msgstr ""
14077
14078 #. type: textblock
14079 #: ../src/guestfs-actions.pod:5058 ../fish/guestfish-actions.pod:3404
14080 msgid "Intel EFI / GPT partition table."
14081 msgstr ""
14082
14083 #. type: textblock
14084 #: ../src/guestfs-actions.pod:5060 ../fish/guestfish-actions.pod:3406
14085 msgid ""
14086 "This is recommended for >= 2 TB partitions that will be accessed from Linux "
14087 "and Intel-based Mac OS X.  It also has limited backwards compatibility with "
14088 "the C<mbr> format."
14089 msgstr ""
14090
14091 #. type: =item
14092 #: ../src/guestfs-actions.pod:5064 ../fish/guestfish-actions.pod:3410
14093 msgid "B<mbr> | B<msdos>"
14094 msgstr ""
14095
14096 #. type: textblock
14097 #: ../src/guestfs-actions.pod:5066 ../fish/guestfish-actions.pod:3412
14098 msgid ""
14099 "The standard PC \"Master Boot Record\" (MBR) format used by MS-DOS and "
14100 "Windows.  This partition type will B<only> work for device sizes up to 2 "
14101 "TB.  For large disks we recommend using C<gpt>."
14102 msgstr ""
14103
14104 #. type: textblock
14105 #: ../src/guestfs-actions.pod:5073 ../fish/guestfish-actions.pod:3419
14106 msgid "Other partition table types that may work but are not supported include:"
14107 msgstr ""
14108
14109 #. type: =item
14110 #: ../src/guestfs-actions.pod:5078 ../fish/guestfish-actions.pod:3424
14111 msgid "B<aix>"
14112 msgstr ""
14113
14114 #. type: textblock
14115 #: ../src/guestfs-actions.pod:5080 ../fish/guestfish-actions.pod:3426
14116 msgid "AIX disk labels."
14117 msgstr ""
14118
14119 #. type: =item
14120 #: ../src/guestfs-actions.pod:5082 ../fish/guestfish-actions.pod:3428
14121 msgid "B<amiga> | B<rdb>"
14122 msgstr ""
14123
14124 #. type: textblock
14125 #: ../src/guestfs-actions.pod:5084 ../fish/guestfish-actions.pod:3430
14126 msgid "Amiga \"Rigid Disk Block\" format."
14127 msgstr ""
14128
14129 #. type: =item
14130 #: ../src/guestfs-actions.pod:5086 ../fish/guestfish-actions.pod:3432
14131 msgid "B<bsd>"
14132 msgstr ""
14133
14134 #. type: textblock
14135 #: ../src/guestfs-actions.pod:5088 ../fish/guestfish-actions.pod:3434
14136 msgid "BSD disk labels."
14137 msgstr ""
14138
14139 #. type: =item
14140 #: ../src/guestfs-actions.pod:5090 ../fish/guestfish-actions.pod:3436
14141 msgid "B<dasd>"
14142 msgstr ""
14143
14144 #. type: textblock
14145 #: ../src/guestfs-actions.pod:5092 ../fish/guestfish-actions.pod:3438
14146 msgid "DASD, used on IBM mainframes."
14147 msgstr ""
14148
14149 #. type: =item
14150 #: ../src/guestfs-actions.pod:5094 ../fish/guestfish-actions.pod:3440
14151 msgid "B<dvh>"
14152 msgstr ""
14153
14154 #. type: textblock
14155 #: ../src/guestfs-actions.pod:5096 ../fish/guestfish-actions.pod:3442
14156 msgid "MIPS/SGI volumes."
14157 msgstr ""
14158
14159 #. type: =item
14160 #: ../src/guestfs-actions.pod:5098 ../fish/guestfish-actions.pod:3444
14161 msgid "B<mac>"
14162 msgstr ""
14163
14164 #. type: textblock
14165 #: ../src/guestfs-actions.pod:5100 ../fish/guestfish-actions.pod:3446
14166 msgid "Old Mac partition format.  Modern Macs use C<gpt>."
14167 msgstr ""
14168
14169 #. type: =item
14170 #: ../src/guestfs-actions.pod:5102 ../fish/guestfish-actions.pod:3448
14171 msgid "B<pc98>"
14172 msgstr ""
14173
14174 #. type: textblock
14175 #: ../src/guestfs-actions.pod:5104 ../fish/guestfish-actions.pod:3450
14176 msgid "NEC PC-98 format, common in Japan apparently."
14177 msgstr ""
14178
14179 #. type: =item
14180 #: ../src/guestfs-actions.pod:5106 ../fish/guestfish-actions.pod:3452
14181 msgid "B<sun>"
14182 msgstr ""
14183
14184 #. type: textblock
14185 #: ../src/guestfs-actions.pod:5108 ../fish/guestfish-actions.pod:3454
14186 msgid "Sun disk labels."
14187 msgstr ""
14188
14189 #. type: =head2
14190 #: ../src/guestfs-actions.pod:5116
14191 msgid "guestfs_part_list"
14192 msgstr ""
14193
14194 #. type: verbatim
14195 #: ../src/guestfs-actions.pod:5118
14196 #, no-wrap
14197 msgid ""
14198 " struct guestfs_partition_list *\n"
14199 " guestfs_part_list (guestfs_h *g,\n"
14200 "                    const char *device);\n"
14201 "\n"
14202 msgstr ""
14203
14204 #. type: textblock
14205 #: ../src/guestfs-actions.pod:5122 ../fish/guestfish-actions.pod:3462
14206 msgid ""
14207 "This command parses the partition table on C<device> and returns the list of "
14208 "partitions found."
14209 msgstr ""
14210
14211 #. type: textblock
14212 #: ../src/guestfs-actions.pod:5125 ../fish/guestfish-actions.pod:3465
14213 msgid "The fields in the returned structure are:"
14214 msgstr ""
14215
14216 #. type: =item
14217 #: ../src/guestfs-actions.pod:5129 ../fish/guestfish-actions.pod:3469
14218 msgid "B<part_num>"
14219 msgstr ""
14220
14221 #. type: textblock
14222 #: ../src/guestfs-actions.pod:5131 ../fish/guestfish-actions.pod:3471
14223 msgid "Partition number, counting from 1."
14224 msgstr ""
14225
14226 #. type: =item
14227 #: ../src/guestfs-actions.pod:5133 ../fish/guestfish-actions.pod:3473
14228 msgid "B<part_start>"
14229 msgstr ""
14230
14231 #. type: textblock
14232 #: ../src/guestfs-actions.pod:5135
14233 msgid ""
14234 "Start of the partition I<in bytes>.  To get sectors you have to divide by "
14235 "the device's sector size, see C<guestfs_blockdev_getss>."
14236 msgstr ""
14237
14238 #. type: =item
14239 #: ../src/guestfs-actions.pod:5138 ../fish/guestfish-actions.pod:3478
14240 msgid "B<part_end>"
14241 msgstr ""
14242
14243 #. type: textblock
14244 #: ../src/guestfs-actions.pod:5140 ../fish/guestfish-actions.pod:3480
14245 msgid "End of the partition in bytes."
14246 msgstr ""
14247
14248 #. type: =item
14249 #: ../src/guestfs-actions.pod:5142 ../fish/guestfish-actions.pod:3482
14250 msgid "B<part_size>"
14251 msgstr ""
14252
14253 #. type: textblock
14254 #: ../src/guestfs-actions.pod:5144 ../fish/guestfish-actions.pod:3484
14255 msgid "Size of the partition in bytes."
14256 msgstr ""
14257
14258 #. type: textblock
14259 #: ../src/guestfs-actions.pod:5148
14260 msgid ""
14261 "This function returns a C<struct guestfs_partition_list *>, or NULL if there "
14262 "was an error.  I<The caller must call C<guestfs_free_partition_list> after "
14263 "use>."
14264 msgstr ""
14265
14266 #. type: =head2
14267 #: ../src/guestfs-actions.pod:5154
14268 msgid "guestfs_part_set_bootable"
14269 msgstr ""
14270
14271 #. type: verbatim
14272 #: ../src/guestfs-actions.pod:5156
14273 #, no-wrap
14274 msgid ""
14275 " int\n"
14276 " guestfs_part_set_bootable (guestfs_h *g,\n"
14277 "                            const char *device,\n"
14278 "                            int partnum,\n"
14279 "                            int bootable);\n"
14280 "\n"
14281 msgstr ""
14282
14283 #. type: textblock
14284 #: ../src/guestfs-actions.pod:5162 ../fish/guestfish-actions.pod:3492
14285 msgid ""
14286 "This sets the bootable flag on partition numbered C<partnum> on device "
14287 "C<device>.  Note that partitions are numbered from 1."
14288 msgstr ""
14289
14290 #. type: textblock
14291 #: ../src/guestfs-actions.pod:5165 ../fish/guestfish-actions.pod:3495
14292 msgid ""
14293 "The bootable flag is used by some operating systems (notably Windows) to "
14294 "determine which partition to boot from.  It is by no means universally "
14295 "recognized."
14296 msgstr ""
14297
14298 #. type: =head2
14299 #: ../src/guestfs-actions.pod:5173
14300 msgid "guestfs_part_set_mbr_id"
14301 msgstr ""
14302
14303 #. type: verbatim
14304 #: ../src/guestfs-actions.pod:5175
14305 #, no-wrap
14306 msgid ""
14307 " int\n"
14308 " guestfs_part_set_mbr_id (guestfs_h *g,\n"
14309 "                          const char *device,\n"
14310 "                          int partnum,\n"
14311 "                          int idbyte);\n"
14312 "\n"
14313 msgstr ""
14314
14315 #. type: textblock
14316 #: ../src/guestfs-actions.pod:5181 ../fish/guestfish-actions.pod:3503
14317 msgid ""
14318 "Sets the MBR type byte (also known as the ID byte) of the numbered partition "
14319 "C<partnum> to C<idbyte>.  Note that the type bytes quoted in most "
14320 "documentation are in fact hexadecimal numbers, but usually documented "
14321 "without any leading \"0x\" which might be confusing."
14322 msgstr ""
14323
14324 #. type: =head2
14325 #: ../src/guestfs-actions.pod:5195
14326 msgid "guestfs_part_set_name"
14327 msgstr ""
14328
14329 #. type: verbatim
14330 #: ../src/guestfs-actions.pod:5197
14331 #, no-wrap
14332 msgid ""
14333 " int\n"
14334 " guestfs_part_set_name (guestfs_h *g,\n"
14335 "                        const char *device,\n"
14336 "                        int partnum,\n"
14337 "                        const char *name);\n"
14338 "\n"
14339 msgstr ""
14340
14341 #. type: textblock
14342 #: ../src/guestfs-actions.pod:5203 ../fish/guestfish-actions.pod:3517
14343 msgid ""
14344 "This sets the partition name on partition numbered C<partnum> on device "
14345 "C<device>.  Note that partitions are numbered from 1."
14346 msgstr ""
14347
14348 #. type: textblock
14349 #: ../src/guestfs-actions.pod:5206 ../fish/guestfish-actions.pod:3520
14350 msgid ""
14351 "The partition name can only be set on certain types of partition table.  "
14352 "This works on C<gpt> but not on C<mbr> partitions."
14353 msgstr ""
14354
14355 #. type: =head2
14356 #: ../src/guestfs-actions.pod:5213
14357 msgid "guestfs_part_to_dev"
14358 msgstr ""
14359
14360 #. type: verbatim
14361 #: ../src/guestfs-actions.pod:5215
14362 #, no-wrap
14363 msgid ""
14364 " char *\n"
14365 " guestfs_part_to_dev (guestfs_h *g,\n"
14366 "                      const char *partition);\n"
14367 "\n"
14368 msgstr ""
14369
14370 #. type: textblock
14371 #: ../src/guestfs-actions.pod:5219 ../fish/guestfish-actions.pod:3527
14372 msgid ""
14373 "This function takes a partition name (eg. \"/dev/sdb1\") and removes the "
14374 "partition number, returning the device name (eg. \"/dev/sdb\")."
14375 msgstr ""
14376
14377 #. type: textblock
14378 #: ../src/guestfs-actions.pod:5223
14379 msgid ""
14380 "The named partition must exist, for example as a string returned from "
14381 "C<guestfs_list_partitions>."
14382 msgstr ""
14383
14384 #. type: =head2
14385 #: ../src/guestfs-actions.pod:5231
14386 msgid "guestfs_ping_daemon"
14387 msgstr ""
14388
14389 #. type: verbatim
14390 #: ../src/guestfs-actions.pod:5233
14391 #, no-wrap
14392 msgid ""
14393 " int\n"
14394 " guestfs_ping_daemon (guestfs_h *g);\n"
14395 "\n"
14396 msgstr ""
14397
14398 #. type: textblock
14399 #: ../src/guestfs-actions.pod:5236 ../fish/guestfish-actions.pod:3538
14400 msgid ""
14401 "This is a test probe into the guestfs daemon running inside the qemu "
14402 "subprocess.  Calling this function checks that the daemon responds to the "
14403 "ping message, without affecting the daemon or attached block device(s) in "
14404 "any other way."
14405 msgstr ""
14406
14407 #. type: =head2
14408 #: ../src/guestfs-actions.pod:5245
14409 msgid "guestfs_pread"
14410 msgstr ""
14411
14412 #. type: verbatim
14413 #: ../src/guestfs-actions.pod:5247
14414 #, no-wrap
14415 msgid ""
14416 " char *\n"
14417 " guestfs_pread (guestfs_h *g,\n"
14418 "                const char *path,\n"
14419 "                int count,\n"
14420 "                int64_t offset,\n"
14421 "                size_t *size_r);\n"
14422 "\n"
14423 msgstr ""
14424
14425 #. type: textblock
14426 #: ../src/guestfs-actions.pod:5254 ../fish/guestfish-actions.pod:3547
14427 msgid ""
14428 "This command lets you read part of a file.  It reads C<count> bytes of the "
14429 "file, starting at C<offset>, from file C<path>."
14430 msgstr ""
14431
14432 #. type: textblock
14433 #: ../src/guestfs-actions.pod:5257 ../src/guestfs-actions.pod:5283 ../fish/guestfish-actions.pod:3550 ../fish/guestfish-actions.pod:3565
14434 msgid ""
14435 "This may read fewer bytes than requested.  For further details see the "
14436 "L<pread(2)> system call."
14437 msgstr ""
14438
14439 #. type: textblock
14440 #: ../src/guestfs-actions.pod:5260
14441 msgid "See also C<guestfs_pwrite>, C<guestfs_pread_device>."
14442 msgstr ""
14443
14444 #. type: =head2
14445 #: ../src/guestfs-actions.pod:5271
14446 msgid "guestfs_pread_device"
14447 msgstr ""
14448
14449 #. type: verbatim
14450 #: ../src/guestfs-actions.pod:5273
14451 #, no-wrap
14452 msgid ""
14453 " char *\n"
14454 " guestfs_pread_device (guestfs_h *g,\n"
14455 "                       const char *device,\n"
14456 "                       int count,\n"
14457 "                       int64_t offset,\n"
14458 "                       size_t *size_r);\n"
14459 "\n"
14460 msgstr ""
14461
14462 #. type: textblock
14463 #: ../src/guestfs-actions.pod:5280 ../fish/guestfish-actions.pod:3562
14464 msgid ""
14465 "This command lets you read part of a file.  It reads C<count> bytes of "
14466 "C<device>, starting at C<offset>."
14467 msgstr ""
14468
14469 #. type: textblock
14470 #: ../src/guestfs-actions.pod:5286
14471 msgid "See also C<guestfs_pread>."
14472 msgstr ""
14473
14474 #. type: textblock
14475 #: ../src/guestfs-actions.pod:5295
14476 msgid "(Added in 1.5.21)"
14477 msgstr ""
14478
14479 #. type: =head2
14480 #: ../src/guestfs-actions.pod:5297
14481 msgid "guestfs_pvcreate"
14482 msgstr ""
14483
14484 #. type: verbatim
14485 #: ../src/guestfs-actions.pod:5299
14486 #, no-wrap
14487 msgid ""
14488 " int\n"
14489 " guestfs_pvcreate (guestfs_h *g,\n"
14490 "                   const char *device);\n"
14491 "\n"
14492 msgstr ""
14493
14494 #. type: textblock
14495 #: ../src/guestfs-actions.pod:5303 ../fish/guestfish-actions.pod:3577
14496 msgid ""
14497 "This creates an LVM physical volume on the named C<device>, where C<device> "
14498 "should usually be a partition name such as C</dev/sda1>."
14499 msgstr ""
14500
14501 #. type: =head2
14502 #: ../src/guestfs-actions.pod:5311
14503 msgid "guestfs_pvremove"
14504 msgstr ""
14505
14506 #. type: verbatim
14507 #: ../src/guestfs-actions.pod:5313
14508 #, no-wrap
14509 msgid ""
14510 " int\n"
14511 " guestfs_pvremove (guestfs_h *g,\n"
14512 "                   const char *device);\n"
14513 "\n"
14514 msgstr ""
14515
14516 #. type: textblock
14517 #: ../src/guestfs-actions.pod:5317 ../fish/guestfish-actions.pod:3585
14518 msgid ""
14519 "This wipes a physical volume C<device> so that LVM will no longer recognise "
14520 "it."
14521 msgstr ""
14522
14523 #. type: textblock
14524 #: ../src/guestfs-actions.pod:5320 ../fish/guestfish-actions.pod:3588
14525 msgid ""
14526 "The implementation uses the C<pvremove> command which refuses to wipe "
14527 "physical volumes that contain any volume groups, so you have to remove those "
14528 "first."
14529 msgstr ""
14530
14531 #. type: =head2
14532 #: ../src/guestfs-actions.pod:5328
14533 msgid "guestfs_pvresize"
14534 msgstr ""
14535
14536 #. type: verbatim
14537 #: ../src/guestfs-actions.pod:5330
14538 #, no-wrap
14539 msgid ""
14540 " int\n"
14541 " guestfs_pvresize (guestfs_h *g,\n"
14542 "                   const char *device);\n"
14543 "\n"
14544 msgstr ""
14545
14546 #. type: textblock
14547 #: ../src/guestfs-actions.pod:5334 ../fish/guestfish-actions.pod:3596
14548 msgid ""
14549 "This resizes (expands or shrinks) an existing LVM physical volume to match "
14550 "the new size of the underlying device."
14551 msgstr ""
14552
14553 #. type: =head2
14554 #: ../src/guestfs-actions.pod:5341
14555 msgid "guestfs_pvresize_size"
14556 msgstr ""
14557
14558 #. type: verbatim
14559 #: ../src/guestfs-actions.pod:5343
14560 #, no-wrap
14561 msgid ""
14562 " int\n"
14563 " guestfs_pvresize_size (guestfs_h *g,\n"
14564 "                        const char *device,\n"
14565 "                        int64_t size);\n"
14566 "\n"
14567 msgstr ""
14568
14569 #. type: textblock
14570 #: ../src/guestfs-actions.pod:5348
14571 msgid ""
14572 "This command is the same as C<guestfs_pvresize> except that it allows you to "
14573 "specify the new size (in bytes) explicitly."
14574 msgstr ""
14575
14576 #. type: =head2
14577 #: ../src/guestfs-actions.pod:5355
14578 msgid "guestfs_pvs"
14579 msgstr ""
14580
14581 #. type: verbatim
14582 #: ../src/guestfs-actions.pod:5357
14583 #, no-wrap
14584 msgid ""
14585 " char **\n"
14586 " guestfs_pvs (guestfs_h *g);\n"
14587 "\n"
14588 msgstr ""
14589
14590 #. type: textblock
14591 #: ../src/guestfs-actions.pod:5360 ../fish/guestfish-actions.pod:3610
14592 msgid ""
14593 "List all the physical volumes detected.  This is the equivalent of the "
14594 "L<pvs(8)> command."
14595 msgstr ""
14596
14597 #. type: textblock
14598 #: ../src/guestfs-actions.pod:5363 ../fish/guestfish-actions.pod:3613
14599 msgid ""
14600 "This returns a list of just the device names that contain PVs "
14601 "(eg. C</dev/sda2>)."
14602 msgstr ""
14603
14604 #. type: textblock
14605 #: ../src/guestfs-actions.pod:5366
14606 msgid "See also C<guestfs_pvs_full>."
14607 msgstr ""
14608
14609 #. type: =head2
14610 #: ../src/guestfs-actions.pod:5374
14611 msgid "guestfs_pvs_full"
14612 msgstr ""
14613
14614 #. type: verbatim
14615 #: ../src/guestfs-actions.pod:5376
14616 #, no-wrap
14617 msgid ""
14618 " struct guestfs_lvm_pv_list *\n"
14619 " guestfs_pvs_full (guestfs_h *g);\n"
14620 "\n"
14621 msgstr ""
14622
14623 #. type: textblock
14624 #: ../src/guestfs-actions.pod:5379 ../fish/guestfish-actions.pod:3622
14625 msgid ""
14626 "List all the physical volumes detected.  This is the equivalent of the "
14627 "L<pvs(8)> command.  The \"full\" version includes all fields."
14628 msgstr ""
14629
14630 #. type: textblock
14631 #: ../src/guestfs-actions.pod:5382
14632 msgid ""
14633 "This function returns a C<struct guestfs_lvm_pv_list *>, or NULL if there "
14634 "was an error.  I<The caller must call C<guestfs_free_lvm_pv_list> after "
14635 "use>."
14636 msgstr ""
14637
14638 #. type: =head2
14639 #: ../src/guestfs-actions.pod:5388
14640 msgid "guestfs_pvuuid"
14641 msgstr ""
14642
14643 #. type: verbatim
14644 #: ../src/guestfs-actions.pod:5390
14645 #, no-wrap
14646 msgid ""
14647 " char *\n"
14648 " guestfs_pvuuid (guestfs_h *g,\n"
14649 "                 const char *device);\n"
14650 "\n"
14651 msgstr ""
14652
14653 #. type: textblock
14654 #: ../src/guestfs-actions.pod:5394 ../fish/guestfish-actions.pod:3629
14655 msgid "This command returns the UUID of the LVM PV C<device>."
14656 msgstr ""
14657
14658 #. type: =head2
14659 #: ../src/guestfs-actions.pod:5401
14660 msgid "guestfs_pwrite"
14661 msgstr ""
14662
14663 #. type: verbatim
14664 #: ../src/guestfs-actions.pod:5403
14665 #, no-wrap
14666 msgid ""
14667 " int\n"
14668 " guestfs_pwrite (guestfs_h *g,\n"
14669 "                 const char *path,\n"
14670 "                 const char *content,\n"
14671 "                 size_t content_size,\n"
14672 "                 int64_t offset);\n"
14673 "\n"
14674 msgstr ""
14675
14676 #. type: textblock
14677 #: ../src/guestfs-actions.pod:5410 ../fish/guestfish-actions.pod:3635
14678 msgid ""
14679 "This command writes to part of a file.  It writes the data buffer C<content> "
14680 "to the file C<path> starting at offset C<offset>."
14681 msgstr ""
14682
14683 #. type: textblock
14684 #: ../src/guestfs-actions.pod:5413 ../fish/guestfish-actions.pod:3638
14685 msgid ""
14686 "This command implements the L<pwrite(2)> system call, and like that system "
14687 "call it may not write the full data requested.  The return value is the "
14688 "number of bytes that were actually written to the file.  This could even be "
14689 "0, although short writes are unlikely for regular files in ordinary "
14690 "circumstances."
14691 msgstr ""
14692
14693 #. type: textblock
14694 #: ../src/guestfs-actions.pod:5419
14695 msgid "See also C<guestfs_pread>, C<guestfs_pwrite_device>."
14696 msgstr ""
14697
14698 #. type: =head2
14699 #: ../src/guestfs-actions.pod:5428
14700 msgid "guestfs_pwrite_device"
14701 msgstr ""
14702
14703 #. type: verbatim
14704 #: ../src/guestfs-actions.pod:5430
14705 #, no-wrap
14706 msgid ""
14707 " int\n"
14708 " guestfs_pwrite_device (guestfs_h *g,\n"
14709 "                        const char *device,\n"
14710 "                        const char *content,\n"
14711 "                        size_t content_size,\n"
14712 "                        int64_t offset);\n"
14713 "\n"
14714 msgstr ""
14715
14716 #. type: textblock
14717 #: ../src/guestfs-actions.pod:5437 ../fish/guestfish-actions.pod:3653
14718 msgid ""
14719 "This command writes to part of a device.  It writes the data buffer "
14720 "C<content> to C<device> starting at offset C<offset>."
14721 msgstr ""
14722
14723 #. type: textblock
14724 #: ../src/guestfs-actions.pod:5440 ../fish/guestfish-actions.pod:3656
14725 msgid ""
14726 "This command implements the L<pwrite(2)> system call, and like that system "
14727 "call it may not write the full data requested (although short writes to disk "
14728 "devices and partitions are probably impossible with standard Linux kernels)."
14729 msgstr ""
14730
14731 #. type: textblock
14732 #: ../src/guestfs-actions.pod:5445
14733 msgid "See also C<guestfs_pwrite>."
14734 msgstr ""
14735
14736 #. type: textblock
14737 #: ../src/guestfs-actions.pod:5452
14738 msgid "(Added in 1.5.20)"
14739 msgstr ""
14740
14741 #. type: =head2
14742 #: ../src/guestfs-actions.pod:5454
14743 msgid "guestfs_read_file"
14744 msgstr ""
14745
14746 #. type: verbatim
14747 #: ../src/guestfs-actions.pod:5456
14748 #, no-wrap
14749 msgid ""
14750 " char *\n"
14751 " guestfs_read_file (guestfs_h *g,\n"
14752 "                    const char *path,\n"
14753 "                    size_t *size_r);\n"
14754 "\n"
14755 msgstr ""
14756
14757 #. type: textblock
14758 #: ../src/guestfs-actions.pod:5461 ../fish/guestfish-actions.pod:3670
14759 msgid "This calls returns the contents of the file C<path> as a buffer."
14760 msgstr ""
14761
14762 #. type: textblock
14763 #: ../src/guestfs-actions.pod:5464
14764 msgid ""
14765 "Unlike C<guestfs_cat>, this function can correctly handle files that contain "
14766 "embedded ASCII NUL characters.  However unlike C<guestfs_download>, this "
14767 "function is limited in the total size of file that can be handled."
14768 msgstr ""
14769
14770 #. type: textblock
14771 #: ../src/guestfs-actions.pod:5476
14772 msgid "(Added in 1.0.63)"
14773 msgstr ""
14774
14775 #. type: =head2
14776 #: ../src/guestfs-actions.pod:5478
14777 msgid "guestfs_read_lines"
14778 msgstr ""
14779
14780 #. type: verbatim
14781 #: ../src/guestfs-actions.pod:5480
14782 #, no-wrap
14783 msgid ""
14784 " char **\n"
14785 " guestfs_read_lines (guestfs_h *g,\n"
14786 "                     const char *path);\n"
14787 "\n"
14788 msgstr ""
14789
14790 #. type: textblock
14791 #: ../src/guestfs-actions.pod:5486 ../fish/guestfish-actions.pod:3687
14792 msgid ""
14793 "The file contents are returned as a list of lines.  Trailing C<LF> and "
14794 "C<CRLF> character sequences are I<not> returned."
14795 msgstr ""
14796
14797 #. type: textblock
14798 #: ../src/guestfs-actions.pod:5489
14799 msgid ""
14800 "Note that this function cannot correctly handle binary files (specifically, "
14801 "files containing C<\\0> character which is treated as end of line).  For "
14802 "those you need to use the C<guestfs_read_file> function which has a more "
14803 "complex interface."
14804 msgstr ""
14805
14806 #. type: =head2
14807 #: ../src/guestfs-actions.pod:5500
14808 msgid "guestfs_readdir"
14809 msgstr ""
14810
14811 #. type: verbatim
14812 #: ../src/guestfs-actions.pod:5502
14813 #, no-wrap
14814 msgid ""
14815 " struct guestfs_dirent_list *\n"
14816 " guestfs_readdir (guestfs_h *g,\n"
14817 "                  const char *dir);\n"
14818 "\n"
14819 msgstr ""
14820
14821 #. type: textblock
14822 #: ../src/guestfs-actions.pod:5506 ../fish/guestfish-actions.pod:3699
14823 msgid "This returns the list of directory entries in directory C<dir>."
14824 msgstr ""
14825
14826 #. type: textblock
14827 #: ../src/guestfs-actions.pod:5508 ../fish/guestfish-actions.pod:3701
14828 msgid ""
14829 "All entries in the directory are returned, including C<.> and C<..>.  The "
14830 "entries are I<not> sorted, but returned in the same order as the underlying "
14831 "filesystem."
14832 msgstr ""
14833
14834 #. type: textblock
14835 #: ../src/guestfs-actions.pod:5512 ../fish/guestfish-actions.pod:3705
14836 msgid ""
14837 "Also this call returns basic file type information about each file.  The "
14838 "C<ftyp> field will contain one of the following characters:"
14839 msgstr ""
14840
14841 #. type: =item
14842 #: ../src/guestfs-actions.pod:5517 ../fish/guestfish-actions.pod:3710
14843 msgid "'b'"
14844 msgstr ""
14845
14846 #. type: textblock
14847 #: ../src/guestfs-actions.pod:5519 ../fish/guestfish-actions.pod:3712
14848 msgid "Block special"
14849 msgstr ""
14850
14851 #. type: =item
14852 #: ../src/guestfs-actions.pod:5521 ../fish/guestfish-actions.pod:3714
14853 msgid "'c'"
14854 msgstr ""
14855
14856 #. type: textblock
14857 #: ../src/guestfs-actions.pod:5523 ../fish/guestfish-actions.pod:3716
14858 msgid "Char special"
14859 msgstr ""
14860
14861 #. type: =item
14862 #: ../src/guestfs-actions.pod:5525 ../fish/guestfish-actions.pod:3718
14863 msgid "'d'"
14864 msgstr ""
14865
14866 #. type: textblock
14867 #: ../src/guestfs-actions.pod:5527 ../fish/guestfish-actions.pod:3720
14868 msgid "Directory"
14869 msgstr ""
14870
14871 #. type: =item
14872 #: ../src/guestfs-actions.pod:5529 ../fish/guestfish-actions.pod:3722
14873 msgid "'f'"
14874 msgstr ""
14875
14876 #. type: textblock
14877 #: ../src/guestfs-actions.pod:5531 ../fish/guestfish-actions.pod:3724
14878 msgid "FIFO (named pipe)"
14879 msgstr ""
14880
14881 #. type: =item
14882 #: ../src/guestfs-actions.pod:5533 ../fish/guestfish-actions.pod:3726
14883 msgid "'l'"
14884 msgstr ""
14885
14886 #. type: textblock
14887 #: ../src/guestfs-actions.pod:5535 ../fish/guestfish-actions.pod:3728
14888 msgid "Symbolic link"
14889 msgstr ""
14890
14891 #. type: =item
14892 #: ../src/guestfs-actions.pod:5537 ../fish/guestfish-actions.pod:3730
14893 msgid "'r'"
14894 msgstr ""
14895
14896 #. type: textblock
14897 #: ../src/guestfs-actions.pod:5539 ../fish/guestfish-actions.pod:3732
14898 msgid "Regular file"
14899 msgstr ""
14900
14901 #. type: =item
14902 #: ../src/guestfs-actions.pod:5541 ../fish/guestfish-actions.pod:3734
14903 msgid "'s'"
14904 msgstr ""
14905
14906 #. type: textblock
14907 #: ../src/guestfs-actions.pod:5543 ../fish/guestfish-actions.pod:3736
14908 msgid "Socket"
14909 msgstr ""
14910
14911 #. type: =item
14912 #: ../src/guestfs-actions.pod:5545 ../fish/guestfish-actions.pod:3738
14913 msgid "'u'"
14914 msgstr ""
14915
14916 #. type: textblock
14917 #: ../src/guestfs-actions.pod:5547 ../fish/guestfish-actions.pod:3740
14918 msgid "Unknown file type"
14919 msgstr ""
14920
14921 #. type: =item
14922 #: ../src/guestfs-actions.pod:5549 ../fish/guestfish-actions.pod:3742
14923 msgid "'?'"
14924 msgstr ""
14925
14926 #. type: textblock
14927 #: ../src/guestfs-actions.pod:5551 ../fish/guestfish-actions.pod:3744
14928 msgid "The L<readdir(3)> call returned a C<d_type> field with an unexpected value"
14929 msgstr ""
14930
14931 #. type: textblock
14932 #: ../src/guestfs-actions.pod:5556
14933 msgid ""
14934 "This function is primarily intended for use by programs.  To get a simple "
14935 "list of names, use C<guestfs_ls>.  To get a printable directory for human "
14936 "consumption, use C<guestfs_ll>."
14937 msgstr ""
14938
14939 #. type: textblock
14940 #: ../src/guestfs-actions.pod:5560
14941 msgid ""
14942 "This function returns a C<struct guestfs_dirent_list *>, or NULL if there "
14943 "was an error.  I<The caller must call C<guestfs_free_dirent_list> after "
14944 "use>."
14945 msgstr ""
14946
14947 #. type: =head2
14948 #: ../src/guestfs-actions.pod:5566
14949 msgid "guestfs_readlink"
14950 msgstr ""
14951
14952 #. type: verbatim
14953 #: ../src/guestfs-actions.pod:5568
14954 #, no-wrap
14955 msgid ""
14956 " char *\n"
14957 " guestfs_readlink (guestfs_h *g,\n"
14958 "                   const char *path);\n"
14959 "\n"
14960 msgstr ""
14961
14962 #. type: textblock
14963 #: ../src/guestfs-actions.pod:5572 ../fish/guestfish-actions.pod:3757
14964 msgid "This command reads the target of a symbolic link."
14965 msgstr ""
14966
14967 #. type: =head2
14968 #: ../src/guestfs-actions.pod:5579
14969 msgid "guestfs_readlinklist"
14970 msgstr ""
14971
14972 #. type: verbatim
14973 #: ../src/guestfs-actions.pod:5581
14974 #, no-wrap
14975 msgid ""
14976 " char **\n"
14977 " guestfs_readlinklist (guestfs_h *g,\n"
14978 "                       const char *path,\n"
14979 "                       char *const *names);\n"
14980 "\n"
14981 msgstr ""
14982
14983 #. type: textblock
14984 #: ../src/guestfs-actions.pod:5586 ../fish/guestfish-actions.pod:3763
14985 msgid ""
14986 "This call allows you to do a C<readlink> operation on multiple files, where "
14987 "all files are in the directory C<path>.  C<names> is the list of files from "
14988 "this directory."
14989 msgstr ""
14990
14991 #. type: textblock
14992 #: ../src/guestfs-actions.pod:5590 ../fish/guestfish-actions.pod:3767
14993 msgid ""
14994 "On return you get a list of strings, with a one-to-one correspondence to the "
14995 "C<names> list.  Each string is the value of the symbolic link."
14996 msgstr ""
14997
14998 #. type: textblock
14999 #: ../src/guestfs-actions.pod:5594 ../fish/guestfish-actions.pod:3771
15000 msgid ""
15001 "If the C<readlink(2)> operation fails on any name, then the corresponding "
15002 "result string is the empty string C<\"\">.  However the whole operation is "
15003 "completed even if there were C<readlink(2)> errors, and so you can call this "
15004 "function with names where you don't know if they are symbolic links already "
15005 "(albeit slightly less efficient)."
15006 msgstr ""
15007
15008 #. type: textblock
15009 #: ../src/guestfs-actions.pod:5601 ../fish/guestfish-actions.pod:3778
15010 msgid ""
15011 "This call is intended for programs that want to efficiently list a directory "
15012 "contents without making many round-trips.  Very long directory listings "
15013 "might cause the protocol message size to be exceeded, causing this call to "
15014 "fail.  The caller must split up such requests into smaller groups of names."
15015 msgstr ""
15016
15017 #. type: =head2
15018 #: ../src/guestfs-actions.pod:5614
15019 msgid "guestfs_realpath"
15020 msgstr ""
15021
15022 #. type: verbatim
15023 #: ../src/guestfs-actions.pod:5616
15024 #, no-wrap
15025 msgid ""
15026 " char *\n"
15027 " guestfs_realpath (guestfs_h *g,\n"
15028 "                   const char *path);\n"
15029 "\n"
15030 msgstr ""
15031
15032 #. type: textblock
15033 #: ../src/guestfs-actions.pod:5620 ../fish/guestfish-actions.pod:3789
15034 msgid ""
15035 "Return the canonicalized absolute pathname of C<path>.  The returned path "
15036 "has no C<.>, C<..> or symbolic link path elements."
15037 msgstr ""
15038
15039 #. type: =head2
15040 #: ../src/guestfs-actions.pod:5628
15041 msgid "guestfs_removexattr"
15042 msgstr ""
15043
15044 #. type: verbatim
15045 #: ../src/guestfs-actions.pod:5630
15046 #, no-wrap
15047 msgid ""
15048 " int\n"
15049 " guestfs_removexattr (guestfs_h *g,\n"
15050 "                      const char *xattr,\n"
15051 "                      const char *path);\n"
15052 "\n"
15053 msgstr ""
15054
15055 #. type: textblock
15056 #: ../src/guestfs-actions.pod:5635 ../fish/guestfish-actions.pod:3796
15057 msgid "This call removes the extended attribute named C<xattr> of the file C<path>."
15058 msgstr ""
15059
15060 #. type: textblock
15061 #: ../src/guestfs-actions.pod:5638
15062 msgid "See also: C<guestfs_lremovexattr>, L<attr(5)>."
15063 msgstr ""
15064
15065 #. type: =head2
15066 #: ../src/guestfs-actions.pod:5644
15067 msgid "guestfs_resize2fs"
15068 msgstr ""
15069
15070 #. type: verbatim
15071 #: ../src/guestfs-actions.pod:5646
15072 #, no-wrap
15073 msgid ""
15074 " int\n"
15075 " guestfs_resize2fs (guestfs_h *g,\n"
15076 "                    const char *device);\n"
15077 "\n"
15078 msgstr ""
15079
15080 #. type: textblock
15081 #: ../src/guestfs-actions.pod:5650 ../fish/guestfish-actions.pod:3805
15082 msgid ""
15083 "This resizes an ext2, ext3 or ext4 filesystem to match the size of the "
15084 "underlying device."
15085 msgstr ""
15086
15087 #. type: textblock
15088 #: ../src/guestfs-actions.pod:5653
15089 msgid ""
15090 "I<Note:> It is sometimes required that you run C<guestfs_e2fsck_f> on the "
15091 "C<device> before calling this command.  For unknown reasons C<resize2fs> "
15092 "sometimes gives an error about this and sometimes not.  In any case, it is "
15093 "always safe to call C<guestfs_e2fsck_f> before calling this function."
15094 msgstr ""
15095
15096 #. type: =head2
15097 #: ../src/guestfs-actions.pod:5663
15098 msgid "guestfs_resize2fs_M"
15099 msgstr ""
15100
15101 #. type: verbatim
15102 #: ../src/guestfs-actions.pod:5665
15103 #, no-wrap
15104 msgid ""
15105 " int\n"
15106 " guestfs_resize2fs_M (guestfs_h *g,\n"
15107 "                      const char *device);\n"
15108 "\n"
15109 msgstr ""
15110
15111 #. type: textblock
15112 #: ../src/guestfs-actions.pod:5669
15113 msgid ""
15114 "This command is the same as C<guestfs_resize2fs>, but the filesystem is "
15115 "resized to its minimum size.  This works like the I<-M> option to the "
15116 "C<resize2fs> command."
15117 msgstr ""
15118
15119 #. type: textblock
15120 #: ../src/guestfs-actions.pod:5673
15121 msgid ""
15122 "To get the resulting size of the filesystem you should call "
15123 "C<guestfs_tune2fs_l> and read the C<Block size> and C<Block count> values.  "
15124 "These two numbers, multiplied together, give the resulting size of the "
15125 "minimal filesystem in bytes."
15126 msgstr ""
15127
15128 #. type: =head2
15129 #: ../src/guestfs-actions.pod:5680
15130 msgid "guestfs_resize2fs_size"
15131 msgstr ""
15132
15133 #. type: verbatim
15134 #: ../src/guestfs-actions.pod:5682
15135 #, no-wrap
15136 msgid ""
15137 " int\n"
15138 " guestfs_resize2fs_size (guestfs_h *g,\n"
15139 "                         const char *device,\n"
15140 "                         int64_t size);\n"
15141 "\n"
15142 msgstr ""
15143
15144 #. type: textblock
15145 #: ../src/guestfs-actions.pod:5687
15146 msgid ""
15147 "This command is the same as C<guestfs_resize2fs> except that it allows you "
15148 "to specify the new size (in bytes) explicitly."
15149 msgstr ""
15150
15151 #. type: =head2
15152 #: ../src/guestfs-actions.pod:5694
15153 msgid "guestfs_rm"
15154 msgstr ""
15155
15156 #. type: verbatim
15157 #: ../src/guestfs-actions.pod:5696
15158 #, no-wrap
15159 msgid ""
15160 " int\n"
15161 " guestfs_rm (guestfs_h *g,\n"
15162 "             const char *path);\n"
15163 "\n"
15164 msgstr ""
15165
15166 #. type: textblock
15167 #: ../src/guestfs-actions.pod:5700 ../fish/guestfish-actions.pod:3838
15168 msgid "Remove the single file C<path>."
15169 msgstr ""
15170
15171 #. type: =head2
15172 #: ../src/guestfs-actions.pod:5706
15173 msgid "guestfs_rm_rf"
15174 msgstr ""
15175
15176 #. type: verbatim
15177 #: ../src/guestfs-actions.pod:5708
15178 #, no-wrap
15179 msgid ""
15180 " int\n"
15181 " guestfs_rm_rf (guestfs_h *g,\n"
15182 "                const char *path);\n"
15183 "\n"
15184 msgstr ""
15185
15186 #. type: textblock
15187 #: ../src/guestfs-actions.pod:5712 ../fish/guestfish-actions.pod:3844
15188 msgid ""
15189 "Remove the file or directory C<path>, recursively removing the contents if "
15190 "its a directory.  This is like the C<rm -rf> shell command."
15191 msgstr ""
15192
15193 #. type: =head2
15194 #: ../src/guestfs-actions.pod:5720
15195 msgid "guestfs_rmdir"
15196 msgstr ""
15197
15198 #. type: verbatim
15199 #: ../src/guestfs-actions.pod:5722
15200 #, no-wrap
15201 msgid ""
15202 " int\n"
15203 " guestfs_rmdir (guestfs_h *g,\n"
15204 "                const char *path);\n"
15205 "\n"
15206 msgstr ""
15207
15208 #. type: textblock
15209 #: ../src/guestfs-actions.pod:5726 ../fish/guestfish-actions.pod:3852
15210 msgid "Remove the single directory C<path>."
15211 msgstr ""
15212
15213 #. type: =head2
15214 #: ../src/guestfs-actions.pod:5732
15215 msgid "guestfs_rmmountpoint"
15216 msgstr ""
15217
15218 #. type: verbatim
15219 #: ../src/guestfs-actions.pod:5734
15220 #, no-wrap
15221 msgid ""
15222 " int\n"
15223 " guestfs_rmmountpoint (guestfs_h *g,\n"
15224 "                       const char *exemptpath);\n"
15225 "\n"
15226 msgstr ""
15227
15228 #. type: textblock
15229 #: ../src/guestfs-actions.pod:5738
15230 msgid ""
15231 "This calls removes a mountpoint that was previously created with "
15232 "C<guestfs_mkmountpoint>.  See C<guestfs_mkmountpoint> for full details."
15233 msgstr ""
15234
15235 #. type: =head2
15236 #: ../src/guestfs-actions.pod:5746
15237 msgid "guestfs_scrub_device"
15238 msgstr ""
15239
15240 #. type: verbatim
15241 #: ../src/guestfs-actions.pod:5748
15242 #, no-wrap
15243 msgid ""
15244 " int\n"
15245 " guestfs_scrub_device (guestfs_h *g,\n"
15246 "                       const char *device);\n"
15247 "\n"
15248 msgstr ""
15249
15250 #. type: textblock
15251 #: ../src/guestfs-actions.pod:5752 ../fish/guestfish-actions.pod:3866
15252 msgid ""
15253 "This command writes patterns over C<device> to make data retrieval more "
15254 "difficult."
15255 msgstr ""
15256
15257 #. type: textblock
15258 #: ../src/guestfs-actions.pod:5755 ../src/guestfs-actions.pod:5776 ../src/guestfs-actions.pod:5795 ../fish/guestfish-actions.pod:3869 ../fish/guestfish-actions.pod:3884 ../fish/guestfish-actions.pod:3897
15259 msgid ""
15260 "It is an interface to the L<scrub(1)> program.  See that manual page for "
15261 "more details."
15262 msgstr ""
15263
15264 #. type: textblock
15265 #: ../src/guestfs-actions.pod:5763 ../src/guestfs-actions.pod:5781 ../src/guestfs-actions.pod:5800
15266 msgid "(Added in 1.0.52)"
15267 msgstr ""
15268
15269 #. type: =head2
15270 #: ../src/guestfs-actions.pod:5765
15271 msgid "guestfs_scrub_file"
15272 msgstr ""
15273
15274 #. type: verbatim
15275 #: ../src/guestfs-actions.pod:5767
15276 #, no-wrap
15277 msgid ""
15278 " int\n"
15279 " guestfs_scrub_file (guestfs_h *g,\n"
15280 "                     const char *file);\n"
15281 "\n"
15282 msgstr ""
15283
15284 #. type: textblock
15285 #: ../src/guestfs-actions.pod:5771 ../fish/guestfish-actions.pod:3879
15286 msgid ""
15287 "This command writes patterns over a file to make data retrieval more "
15288 "difficult."
15289 msgstr ""
15290
15291 #. type: textblock
15292 #: ../src/guestfs-actions.pod:5774 ../fish/guestfish-actions.pod:3882
15293 msgid "The file is I<removed> after scrubbing."
15294 msgstr ""
15295
15296 #. type: =head2
15297 #: ../src/guestfs-actions.pod:5783
15298 msgid "guestfs_scrub_freespace"
15299 msgstr ""
15300
15301 #. type: verbatim
15302 #: ../src/guestfs-actions.pod:5785
15303 #, no-wrap
15304 msgid ""
15305 " int\n"
15306 " guestfs_scrub_freespace (guestfs_h *g,\n"
15307 "                          const char *dir);\n"
15308 "\n"
15309 msgstr ""
15310
15311 #. type: textblock
15312 #: ../src/guestfs-actions.pod:5789
15313 msgid ""
15314 "This command creates the directory C<dir> and then fills it with files until "
15315 "the filesystem is full, and scrubs the files as for C<guestfs_scrub_file>, "
15316 "and deletes them.  The intention is to scrub any free space on the partition "
15317 "containing C<dir>."
15318 msgstr ""
15319
15320 #. type: =head2
15321 #: ../src/guestfs-actions.pod:5802
15322 msgid "guestfs_set_append"
15323 msgstr ""
15324
15325 #. type: verbatim
15326 #: ../src/guestfs-actions.pod:5804
15327 #, no-wrap
15328 msgid ""
15329 " int\n"
15330 " guestfs_set_append (guestfs_h *g,\n"
15331 "                     const char *append);\n"
15332 "\n"
15333 msgstr ""
15334
15335 #. type: textblock
15336 #: ../src/guestfs-actions.pod:5808 ../fish/guestfish-actions.pod:3906
15337 msgid ""
15338 "This function is used to add additional options to the guest kernel command "
15339 "line."
15340 msgstr ""
15341
15342 #. type: textblock
15343 #: ../src/guestfs-actions.pod:5811 ../fish/guestfish-actions.pod:3909
15344 msgid ""
15345 "The default is C<NULL> unless overridden by setting C<LIBGUESTFS_APPEND> "
15346 "environment variable."
15347 msgstr ""
15348
15349 #. type: textblock
15350 #: ../src/guestfs-actions.pod:5814 ../fish/guestfish-actions.pod:3912
15351 msgid ""
15352 "Setting C<append> to C<NULL> means I<no> additional options are passed "
15353 "(libguestfs always adds a few of its own)."
15354 msgstr ""
15355
15356 #. type: =head2
15357 #: ../src/guestfs-actions.pod:5821
15358 msgid "guestfs_set_attach_method"
15359 msgstr ""
15360
15361 #. type: verbatim
15362 #: ../src/guestfs-actions.pod:5823
15363 #, no-wrap
15364 msgid ""
15365 " int\n"
15366 " guestfs_set_attach_method (guestfs_h *g,\n"
15367 "                            const char *attachmethod);\n"
15368 "\n"
15369 msgstr ""
15370
15371 #. type: textblock
15372 #: ../src/guestfs-actions.pod:5827 ../fish/guestfish-actions.pod:3921
15373 msgid ""
15374 "Set the method that libguestfs uses to connect to the back end guestfsd "
15375 "daemon.  Possible methods are:"
15376 msgstr ""
15377
15378 #. type: textblock
15379 #: ../src/guestfs-actions.pod:5834 ../fish/guestfish-actions.pod:3928
15380 msgid ""
15381 "Launch an appliance and connect to it.  This is the ordinary method and the "
15382 "default."
15383 msgstr ""
15384
15385 #. type: =item
15386 #: ../src/guestfs-actions.pod:5837 ../fish/guestfish-actions.pod:3931
15387 msgid "C<unix:I<path>>"
15388 msgstr ""
15389
15390 #. type: textblock
15391 #: ../src/guestfs-actions.pod:5839 ../fish/guestfish-actions.pod:3933
15392 msgid "Connect to the Unix domain socket I<path>."
15393 msgstr ""
15394
15395 #. type: textblock
15396 #: ../src/guestfs-actions.pod:5841 ../fish/guestfish-actions.pod:3935
15397 msgid ""
15398 "This method lets you connect to an existing daemon or (using virtio-serial) "
15399 "to a live guest.  For more information, see L<guestfs(3)/ATTACHING TO "
15400 "RUNNING DAEMONS>."
15401 msgstr ""
15402
15403 #. type: =head2
15404 #: ../src/guestfs-actions.pod:5849
15405 msgid "guestfs_set_autosync"
15406 msgstr ""
15407
15408 #. type: verbatim
15409 #: ../src/guestfs-actions.pod:5851
15410 #, no-wrap
15411 msgid ""
15412 " int\n"
15413 " guestfs_set_autosync (guestfs_h *g,\n"
15414 "                       int autosync);\n"
15415 "\n"
15416 msgstr ""
15417
15418 #. type: textblock
15419 #: ../src/guestfs-actions.pod:5855 ../fish/guestfish-actions.pod:3947
15420 msgid ""
15421 "If C<autosync> is true, this enables autosync.  Libguestfs will make a best "
15422 "effort attempt to make filesystems consistent and synchronized when the "
15423 "handle is closed (also if the program exits without closing handles)."
15424 msgstr ""
15425
15426 #. type: textblock
15427 #: ../src/guestfs-actions.pod:5860 ../fish/guestfish-actions.pod:3952
15428 msgid ""
15429 "This is enabled by default (since libguestfs 1.5.24, previously it was "
15430 "disabled by default)."
15431 msgstr ""
15432
15433 #. type: =head2
15434 #: ../src/guestfs-actions.pod:5867
15435 msgid "guestfs_set_direct"
15436 msgstr ""
15437
15438 #. type: verbatim
15439 #: ../src/guestfs-actions.pod:5869
15440 #, no-wrap
15441 msgid ""
15442 " int\n"
15443 " guestfs_set_direct (guestfs_h *g,\n"
15444 "                     int direct);\n"
15445 "\n"
15446 msgstr ""
15447
15448 #. type: textblock
15449 #: ../src/guestfs-actions.pod:5873 ../fish/guestfish-actions.pod:3961
15450 msgid ""
15451 "If the direct appliance mode flag is enabled, then stdin and stdout are "
15452 "passed directly through to the appliance once it is launched."
15453 msgstr ""
15454
15455 #. type: textblock
15456 #: ../src/guestfs-actions.pod:5877
15457 msgid ""
15458 "One consequence of this is that log messages aren't caught by the library "
15459 "and handled by C<guestfs_set_log_message_callback>, but go straight to "
15460 "stdout."
15461 msgstr ""
15462
15463 #. type: textblock
15464 #: ../src/guestfs-actions.pod:5881 ../fish/guestfish-actions.pod:3969
15465 msgid "You probably don't want to use this unless you know what you are doing."
15466 msgstr ""
15467
15468 #. type: textblock
15469 #: ../src/guestfs-actions.pod:5884 ../fish/guestfish-actions.pod:3972
15470 msgid "The default is disabled."
15471 msgstr ""
15472
15473 #. type: =head2
15474 #: ../src/guestfs-actions.pod:5890
15475 msgid "guestfs_set_e2label"
15476 msgstr ""
15477
15478 #. type: verbatim
15479 #: ../src/guestfs-actions.pod:5892
15480 #, no-wrap
15481 msgid ""
15482 " int\n"
15483 " guestfs_set_e2label (guestfs_h *g,\n"
15484 "                      const char *device,\n"
15485 "                      const char *label);\n"
15486 "\n"
15487 msgstr ""
15488
15489 #. type: textblock
15490 #: ../src/guestfs-actions.pod:5897 ../fish/guestfish-actions.pod:3978
15491 msgid ""
15492 "This sets the ext2/3/4 filesystem label of the filesystem on C<device> to "
15493 "C<label>.  Filesystem labels are limited to 16 characters."
15494 msgstr ""
15495
15496 #. type: textblock
15497 #: ../src/guestfs-actions.pod:5901
15498 msgid ""
15499 "You can use either C<guestfs_tune2fs_l> or C<guestfs_get_e2label> to return "
15500 "the existing label on a filesystem."
15501 msgstr ""
15502
15503 #. type: =head2
15504 #: ../src/guestfs-actions.pod:5908
15505 msgid "guestfs_set_e2uuid"
15506 msgstr ""
15507
15508 #. type: verbatim
15509 #: ../src/guestfs-actions.pod:5910
15510 #, no-wrap
15511 msgid ""
15512 " int\n"
15513 " guestfs_set_e2uuid (guestfs_h *g,\n"
15514 "                     const char *device,\n"
15515 "                     const char *uuid);\n"
15516 "\n"
15517 msgstr ""
15518
15519 #. type: textblock
15520 #: ../src/guestfs-actions.pod:5915 ../fish/guestfish-actions.pod:3989
15521 msgid ""
15522 "This sets the ext2/3/4 filesystem UUID of the filesystem on C<device> to "
15523 "C<uuid>.  The format of the UUID and alternatives such as C<clear>, "
15524 "C<random> and C<time> are described in the L<tune2fs(8)> manpage."
15525 msgstr ""
15526
15527 #. type: textblock
15528 #: ../src/guestfs-actions.pod:5920
15529 msgid ""
15530 "You can use either C<guestfs_tune2fs_l> or C<guestfs_get_e2uuid> to return "
15531 "the existing UUID of a filesystem."
15532 msgstr ""
15533
15534 #. type: =head2
15535 #: ../src/guestfs-actions.pod:5927
15536 msgid "guestfs_set_memsize"
15537 msgstr ""
15538
15539 #. type: verbatim
15540 #: ../src/guestfs-actions.pod:5929
15541 #, no-wrap
15542 msgid ""
15543 " int\n"
15544 " guestfs_set_memsize (guestfs_h *g,\n"
15545 "                      int memsize);\n"
15546 "\n"
15547 msgstr ""
15548
15549 #. type: textblock
15550 #: ../src/guestfs-actions.pod:5933
15551 msgid ""
15552 "This sets the memory size in megabytes allocated to the qemu subprocess.  "
15553 "This only has any effect if called before C<guestfs_launch>."
15554 msgstr ""
15555
15556 #. type: textblock
15557 #: ../src/guestfs-actions.pod:5937 ../fish/guestfish-actions.pod:4007
15558 msgid ""
15559 "You can also change this by setting the environment variable "
15560 "C<LIBGUESTFS_MEMSIZE> before the handle is created."
15561 msgstr ""
15562
15563 #. type: =head2
15564 #: ../src/guestfs-actions.pod:5948
15565 msgid "guestfs_set_network"
15566 msgstr ""
15567
15568 #. type: verbatim
15569 #: ../src/guestfs-actions.pod:5950
15570 #, no-wrap
15571 msgid ""
15572 " int\n"
15573 " guestfs_set_network (guestfs_h *g,\n"
15574 "                      int network);\n"
15575 "\n"
15576 msgstr ""
15577
15578 #. type: textblock
15579 #: ../src/guestfs-actions.pod:5954 ../fish/guestfish-actions.pod:4020
15580 msgid ""
15581 "If C<network> is true, then the network is enabled in the libguestfs "
15582 "appliance.  The default is false."
15583 msgstr ""
15584
15585 #. type: textblock
15586 #: ../src/guestfs-actions.pod:5957 ../fish/guestfish-actions.pod:4023
15587 msgid ""
15588 "This affects whether commands are able to access the network (see "
15589 "L<guestfs(3)/RUNNING COMMANDS>)."
15590 msgstr ""
15591
15592 #. type: textblock
15593 #: ../src/guestfs-actions.pod:5960
15594 msgid ""
15595 "You must call this before calling C<guestfs_launch>, otherwise it has no "
15596 "effect."
15597 msgstr ""
15598
15599 #. type: =head2
15600 #: ../src/guestfs-actions.pod:5967
15601 msgid "guestfs_set_path"
15602 msgstr ""
15603
15604 #. type: verbatim
15605 #: ../src/guestfs-actions.pod:5969
15606 #, no-wrap
15607 msgid ""
15608 " int\n"
15609 " guestfs_set_path (guestfs_h *g,\n"
15610 "                   const char *searchpath);\n"
15611 "\n"
15612 msgstr ""
15613
15614 #. type: textblock
15615 #: ../src/guestfs-actions.pod:5973 ../fish/guestfish-actions.pod:4035
15616 msgid "Set the path that libguestfs searches for kernel and initrd.img."
15617 msgstr ""
15618
15619 #. type: textblock
15620 #: ../src/guestfs-actions.pod:5975 ../fish/guestfish-actions.pod:4037
15621 msgid ""
15622 "The default is C<$libdir/guestfs> unless overridden by setting "
15623 "C<LIBGUESTFS_PATH> environment variable."
15624 msgstr ""
15625
15626 #. type: textblock
15627 #: ../src/guestfs-actions.pod:5978 ../fish/guestfish-actions.pod:4040
15628 msgid "Setting C<path> to C<NULL> restores the default path."
15629 msgstr ""
15630
15631 #. type: =head2
15632 #: ../src/guestfs-actions.pod:5984
15633 msgid "guestfs_set_qemu"
15634 msgstr ""
15635
15636 #. type: verbatim
15637 #: ../src/guestfs-actions.pod:5986
15638 #, no-wrap
15639 msgid ""
15640 " int\n"
15641 " guestfs_set_qemu (guestfs_h *g,\n"
15642 "                   const char *qemu);\n"
15643 "\n"
15644 msgstr ""
15645
15646 #. type: textblock
15647 #: ../src/guestfs-actions.pod:5990 ../fish/guestfish-actions.pod:4048
15648 msgid "Set the qemu binary that we will use."
15649 msgstr ""
15650
15651 #. type: textblock
15652 #: ../src/guestfs-actions.pod:5992 ../fish/guestfish-actions.pod:4050
15653 msgid "The default is chosen when the library was compiled by the configure script."
15654 msgstr ""
15655
15656 #. type: textblock
15657 #: ../src/guestfs-actions.pod:5995 ../fish/guestfish-actions.pod:4053
15658 msgid ""
15659 "You can also override this by setting the C<LIBGUESTFS_QEMU> environment "
15660 "variable."
15661 msgstr ""
15662
15663 #. type: textblock
15664 #: ../src/guestfs-actions.pod:5998 ../fish/guestfish-actions.pod:4056
15665 msgid "Setting C<qemu> to C<NULL> restores the default qemu binary."
15666 msgstr ""
15667
15668 #. type: textblock
15669 #: ../src/guestfs-actions.pod:6000 ../fish/guestfish-actions.pod:4058
15670 msgid ""
15671 "Note that you should call this function as early as possible after creating "
15672 "the handle.  This is because some pre-launch operations depend on testing "
15673 "qemu features (by running C<qemu -help>).  If the qemu binary changes, we "
15674 "don't retest features, and so you might see inconsistent results.  Using the "
15675 "environment variable C<LIBGUESTFS_QEMU> is safest of all since that picks "
15676 "the qemu binary at the same time as the handle is created."
15677 msgstr ""
15678
15679 #. type: =head2
15680 #: ../src/guestfs-actions.pod:6012
15681 msgid "guestfs_set_recovery_proc"
15682 msgstr ""
15683
15684 #. type: verbatim
15685 #: ../src/guestfs-actions.pod:6014
15686 #, no-wrap
15687 msgid ""
15688 " int\n"
15689 " guestfs_set_recovery_proc (guestfs_h *g,\n"
15690 "                            int recoveryproc);\n"
15691 "\n"
15692 msgstr ""
15693
15694 #. type: textblock
15695 #: ../src/guestfs-actions.pod:6018
15696 msgid ""
15697 "If this is called with the parameter C<false> then C<guestfs_launch> does "
15698 "not create a recovery process.  The purpose of the recovery process is to "
15699 "stop runaway qemu processes in the case where the main program aborts "
15700 "abruptly."
15701 msgstr ""
15702
15703 #. type: textblock
15704 #: ../src/guestfs-actions.pod:6023
15705 msgid ""
15706 "This only has any effect if called before C<guestfs_launch>, and the default "
15707 "is true."
15708 msgstr ""
15709
15710 #. type: textblock
15711 #: ../src/guestfs-actions.pod:6026 ../fish/guestfish-actions.pod:4080
15712 msgid ""
15713 "About the only time when you would want to disable this is if the main "
15714 "process will fork itself into the background (\"daemonize\" itself).  In "
15715 "this case the recovery process thinks that the main program has disappeared "
15716 "and so kills qemu, which is not very helpful."
15717 msgstr ""
15718
15719 #. type: =head2
15720 #: ../src/guestfs-actions.pod:6036
15721 msgid "guestfs_set_selinux"
15722 msgstr ""
15723
15724 #. type: verbatim
15725 #: ../src/guestfs-actions.pod:6038
15726 #, no-wrap
15727 msgid ""
15728 " int\n"
15729 " guestfs_set_selinux (guestfs_h *g,\n"
15730 "                      int selinux);\n"
15731 "\n"
15732 msgstr ""
15733
15734 #. type: textblock
15735 #: ../src/guestfs-actions.pod:6042 ../fish/guestfish-actions.pod:4092
15736 msgid ""
15737 "This sets the selinux flag that is passed to the appliance at boot time.  "
15738 "The default is C<selinux=0> (disabled)."
15739 msgstr ""
15740
15741 #. type: textblock
15742 #: ../src/guestfs-actions.pod:6045 ../fish/guestfish-actions.pod:4095
15743 msgid ""
15744 "Note that if SELinux is enabled, it is always in Permissive mode "
15745 "(C<enforcing=0>)."
15746 msgstr ""
15747
15748 #. type: =head2
15749 #: ../src/guestfs-actions.pod:6055
15750 msgid "guestfs_set_trace"
15751 msgstr ""
15752
15753 #. type: verbatim
15754 #: ../src/guestfs-actions.pod:6057
15755 #, no-wrap
15756 msgid ""
15757 " int\n"
15758 " guestfs_set_trace (guestfs_h *g,\n"
15759 "                    int trace);\n"
15760 "\n"
15761 msgstr ""
15762
15763 #. type: textblock
15764 #: ../src/guestfs-actions.pod:6061 ../fish/guestfish-actions.pod:4107
15765 msgid ""
15766 "If the command trace flag is set to 1, then libguestfs calls, parameters and "
15767 "return values are traced."
15768 msgstr ""
15769
15770 #. type: textblock
15771 #: ../src/guestfs-actions.pod:6064 ../fish/guestfish-actions.pod:4110
15772 msgid ""
15773 "If you want to trace C API calls into libguestfs (and other libraries) then "
15774 "possibly a better way is to use the external ltrace(1) command."
15775 msgstr ""
15776
15777 #. type: textblock
15778 #: ../src/guestfs-actions.pod:6068 ../fish/guestfish-actions.pod:4114
15779 msgid ""
15780 "Command traces are disabled unless the environment variable "
15781 "C<LIBGUESTFS_TRACE> is defined and set to C<1>."
15782 msgstr ""
15783
15784 #. type: textblock
15785 #: ../src/guestfs-actions.pod:6071
15786 msgid ""
15787 "Trace messages are normally sent to C<stderr>, unless you register a "
15788 "callback to send them somewhere else (see C<guestfs_set_event_callback>)."
15789 msgstr ""
15790
15791 #. type: =head2
15792 #: ../src/guestfs-actions.pod:6079
15793 msgid "guestfs_set_verbose"
15794 msgstr ""
15795
15796 #. type: verbatim
15797 #: ../src/guestfs-actions.pod:6081
15798 #, no-wrap
15799 msgid ""
15800 " int\n"
15801 " guestfs_set_verbose (guestfs_h *g,\n"
15802 "                      int verbose);\n"
15803 "\n"
15804 msgstr ""
15805
15806 #. type: textblock
15807 #: ../src/guestfs-actions.pod:6085 ../fish/guestfish-actions.pod:4127
15808 msgid "If C<verbose> is true, this turns on verbose messages."
15809 msgstr ""
15810
15811 #. type: textblock
15812 #: ../src/guestfs-actions.pod:6087 ../fish/guestfish-actions.pod:4129
15813 msgid ""
15814 "Verbose messages are disabled unless the environment variable "
15815 "C<LIBGUESTFS_DEBUG> is defined and set to C<1>."
15816 msgstr ""
15817
15818 #. type: textblock
15819 #: ../src/guestfs-actions.pod:6090
15820 msgid ""
15821 "Verbose messages are normally sent to C<stderr>, unless you register a "
15822 "callback to send them somewhere else (see C<guestfs_set_event_callback>)."
15823 msgstr ""
15824
15825 #. type: =head2
15826 #: ../src/guestfs-actions.pod:6098
15827 msgid "guestfs_setcon"
15828 msgstr ""
15829
15830 #. type: verbatim
15831 #: ../src/guestfs-actions.pod:6100
15832 #, no-wrap
15833 msgid ""
15834 " int\n"
15835 " guestfs_setcon (guestfs_h *g,\n"
15836 "                 const char *context);\n"
15837 "\n"
15838 msgstr ""
15839
15840 #. type: textblock
15841 #: ../src/guestfs-actions.pod:6104 ../fish/guestfish-actions.pod:4140
15842 msgid ""
15843 "This sets the SELinux security context of the daemon to the string "
15844 "C<context>."
15845 msgstr ""
15846
15847 #. type: textblock
15848 #: ../src/guestfs-actions.pod:6107 ../fish/guestfish-actions.pod:4143
15849 msgid "See the documentation about SELINUX in L<guestfs(3)>."
15850 msgstr ""
15851
15852 #. type: =head2
15853 #: ../src/guestfs-actions.pod:6113
15854 msgid "guestfs_setxattr"
15855 msgstr ""
15856
15857 #. type: verbatim
15858 #: ../src/guestfs-actions.pod:6115
15859 #, no-wrap
15860 msgid ""
15861 " int\n"
15862 " guestfs_setxattr (guestfs_h *g,\n"
15863 "                   const char *xattr,\n"
15864 "                   const char *val,\n"
15865 "                   int vallen,\n"
15866 "                   const char *path);\n"
15867 "\n"
15868 msgstr ""
15869
15870 #. type: textblock
15871 #: ../src/guestfs-actions.pod:6122 ../fish/guestfish-actions.pod:4149
15872 msgid ""
15873 "This call sets the extended attribute named C<xattr> of the file C<path> to "
15874 "the value C<val> (of length C<vallen>).  The value is arbitrary 8 bit data."
15875 msgstr ""
15876
15877 #. type: textblock
15878 #: ../src/guestfs-actions.pod:6126
15879 msgid "See also: C<guestfs_lsetxattr>, L<attr(5)>."
15880 msgstr ""
15881
15882 #. type: =head2
15883 #: ../src/guestfs-actions.pod:6132
15884 msgid "guestfs_sfdisk"
15885 msgstr ""
15886
15887 #. type: verbatim
15888 #: ../src/guestfs-actions.pod:6134
15889 #, no-wrap
15890 msgid ""
15891 " int\n"
15892 " guestfs_sfdisk (guestfs_h *g,\n"
15893 "                 const char *device,\n"
15894 "                 int cyls,\n"
15895 "                 int heads,\n"
15896 "                 int sectors,\n"
15897 "                 char *const *lines);\n"
15898 "\n"
15899 msgstr ""
15900
15901 #. type: textblock
15902 #: ../src/guestfs-actions.pod:6142 ../fish/guestfish-actions.pod:4159
15903 msgid ""
15904 "This is a direct interface to the L<sfdisk(8)> program for creating "
15905 "partitions on block devices."
15906 msgstr ""
15907
15908 #. type: textblock
15909 #: ../src/guestfs-actions.pod:6145 ../fish/guestfish-actions.pod:4162
15910 msgid "C<device> should be a block device, for example C</dev/sda>."
15911 msgstr ""
15912
15913 #. type: textblock
15914 #: ../src/guestfs-actions.pod:6147 ../fish/guestfish-actions.pod:4164
15915 msgid ""
15916 "C<cyls>, C<heads> and C<sectors> are the number of cylinders, heads and "
15917 "sectors on the device, which are passed directly to sfdisk as the I<-C>, "
15918 "I<-H> and I<-S> parameters.  If you pass C<0> for any of these, then the "
15919 "corresponding parameter is omitted.  Usually for 'large' disks, you can just "
15920 "pass C<0> for these, but for small (floppy-sized) disks, sfdisk (or rather, "
15921 "the kernel) cannot work out the right geometry and you will need to tell it."
15922 msgstr ""
15923
15924 #. type: textblock
15925 #: ../src/guestfs-actions.pod:6155 ../fish/guestfish-actions.pod:4172
15926 msgid ""
15927 "C<lines> is a list of lines that we feed to C<sfdisk>.  For more information "
15928 "refer to the L<sfdisk(8)> manpage."
15929 msgstr ""
15930
15931 #. type: textblock
15932 #: ../src/guestfs-actions.pod:6158 ../fish/guestfish-actions.pod:4175
15933 msgid ""
15934 "To create a single partition occupying the whole disk, you would pass "
15935 "C<lines> as a single element list, when the single element being the string "
15936 "C<,> (comma)."
15937 msgstr ""
15938
15939 #. type: textblock
15940 #: ../src/guestfs-actions.pod:6162
15941 msgid "See also: C<guestfs_sfdisk_l>, C<guestfs_sfdisk_N>, C<guestfs_part_init>"
15942 msgstr ""
15943
15944 #. type: textblock
15945 #: ../src/guestfs-actions.pod:6170 ../src/guestfs-actions.pod:6200 ../src/guestfs-actions.pod:6233
15946 msgid ""
15947 "This function is deprecated.  In new code, use the L</guestfs_part_add> call "
15948 "instead."
15949 msgstr ""
15950
15951 #. type: =head2
15952 #: ../src/guestfs-actions.pod:6179
15953 msgid "guestfs_sfdiskM"
15954 msgstr ""
15955
15956 #. type: verbatim
15957 #: ../src/guestfs-actions.pod:6181
15958 #, no-wrap
15959 msgid ""
15960 " int\n"
15961 " guestfs_sfdiskM (guestfs_h *g,\n"
15962 "                  const char *device,\n"
15963 "                  char *const *lines);\n"
15964 "\n"
15965 msgstr ""
15966
15967 #. type: textblock
15968 #: ../src/guestfs-actions.pod:6186
15969 msgid ""
15970 "This is a simplified interface to the C<guestfs_sfdisk> command, where "
15971 "partition sizes are specified in megabytes only (rounded to the nearest "
15972 "cylinder) and you don't need to specify the cyls, heads and sectors "
15973 "parameters which were rarely if ever used anyway."
15974 msgstr ""
15975
15976 #. type: textblock
15977 #: ../src/guestfs-actions.pod:6192
15978 msgid ""
15979 "See also: C<guestfs_sfdisk>, the L<sfdisk(8)> manpage and "
15980 "C<guestfs_part_disk>"
15981 msgstr ""
15982
15983 #. type: =head2
15984 #: ../src/guestfs-actions.pod:6209
15985 msgid "guestfs_sfdisk_N"
15986 msgstr ""
15987
15988 #. type: verbatim
15989 #: ../src/guestfs-actions.pod:6211
15990 #, no-wrap
15991 msgid ""
15992 " int\n"
15993 " guestfs_sfdisk_N (guestfs_h *g,\n"
15994 "                   const char *device,\n"
15995 "                   int partnum,\n"
15996 "                   int cyls,\n"
15997 "                   int heads,\n"
15998 "                   int sectors,\n"
15999 "                   const char *line);\n"
16000 "\n"
16001 msgstr ""
16002
16003 #. type: textblock
16004 #: ../src/guestfs-actions.pod:6220 ../fish/guestfish-actions.pod:4219
16005 msgid ""
16006 "This runs L<sfdisk(8)> option to modify just the single partition C<n> "
16007 "(note: C<n> counts from 1)."
16008 msgstr ""
16009
16010 #. type: textblock
16011 #: ../src/guestfs-actions.pod:6223
16012 msgid ""
16013 "For other parameters, see C<guestfs_sfdisk>.  You should usually pass C<0> "
16014 "for the cyls/heads/sectors parameters."
16015 msgstr ""
16016
16017 #. type: textblock
16018 #: ../src/guestfs-actions.pod:6226
16019 msgid "See also: C<guestfs_part_add>"
16020 msgstr ""
16021
16022 #. type: =head2
16023 #: ../src/guestfs-actions.pod:6242
16024 msgid "guestfs_sfdisk_disk_geometry"
16025 msgstr ""
16026
16027 #. type: verbatim
16028 #: ../src/guestfs-actions.pod:6244
16029 #, no-wrap
16030 msgid ""
16031 " char *\n"
16032 " guestfs_sfdisk_disk_geometry (guestfs_h *g,\n"
16033 "                               const char *device);\n"
16034 "\n"
16035 msgstr ""
16036
16037 #. type: textblock
16038 #: ../src/guestfs-actions.pod:6248
16039 msgid ""
16040 "This displays the disk geometry of C<device> read from the partition table.  "
16041 "Especially in the case where the underlying block device has been resized, "
16042 "this can be different from the kernel's idea of the geometry (see "
16043 "C<guestfs_sfdisk_kernel_geometry>)."
16044 msgstr ""
16045
16046 #. type: textblock
16047 #: ../src/guestfs-actions.pod:6253 ../src/guestfs-actions.pod:6269 ../fish/guestfish-actions.pod:4246 ../fish/guestfish-actions.pod:4255
16048 msgid "The result is in human-readable format, and not designed to be parsed."
16049 msgstr ""
16050
16051 #. type: =head2
16052 #: ../src/guestfs-actions.pod:6261
16053 msgid "guestfs_sfdisk_kernel_geometry"
16054 msgstr ""
16055
16056 #. type: verbatim
16057 #: ../src/guestfs-actions.pod:6263
16058 #, no-wrap
16059 msgid ""
16060 " char *\n"
16061 " guestfs_sfdisk_kernel_geometry (guestfs_h *g,\n"
16062 "                                 const char *device);\n"
16063 "\n"
16064 msgstr ""
16065
16066 #. type: textblock
16067 #: ../src/guestfs-actions.pod:6267 ../fish/guestfish-actions.pod:4253
16068 msgid "This displays the kernel's idea of the geometry of C<device>."
16069 msgstr ""
16070
16071 #. type: =head2
16072 #: ../src/guestfs-actions.pod:6277
16073 msgid "guestfs_sfdisk_l"
16074 msgstr ""
16075
16076 #. type: verbatim
16077 #: ../src/guestfs-actions.pod:6279
16078 #, no-wrap
16079 msgid ""
16080 " char *\n"
16081 " guestfs_sfdisk_l (guestfs_h *g,\n"
16082 "                   const char *device);\n"
16083 "\n"
16084 msgstr ""
16085
16086 #. type: textblock
16087 #: ../src/guestfs-actions.pod:6283 ../fish/guestfish-actions.pod:4262
16088 msgid ""
16089 "This displays the partition table on C<device>, in the human-readable output "
16090 "of the L<sfdisk(8)> command.  It is not intended to be parsed."
16091 msgstr ""
16092
16093 #. type: textblock
16094 #: ../src/guestfs-actions.pod:6287
16095 msgid "See also: C<guestfs_part_list>"
16096 msgstr ""
16097
16098 #. type: textblock
16099 #: ../src/guestfs-actions.pod:6292
16100 msgid ""
16101 "This function is deprecated.  In new code, use the L</guestfs_part_list> "
16102 "call instead."
16103 msgstr ""
16104
16105 #. type: =head2
16106 #: ../src/guestfs-actions.pod:6301
16107 msgid "guestfs_sh"
16108 msgstr ""
16109
16110 #. type: verbatim
16111 #: ../src/guestfs-actions.pod:6303
16112 #, no-wrap
16113 msgid ""
16114 " char *\n"
16115 " guestfs_sh (guestfs_h *g,\n"
16116 "             const char *command);\n"
16117 "\n"
16118 msgstr ""
16119
16120 #. type: textblock
16121 #: ../src/guestfs-actions.pod:6307 ../fish/guestfish-actions.pod:4279
16122 msgid ""
16123 "This call runs a command from the guest filesystem via the guest's "
16124 "C</bin/sh>."
16125 msgstr ""
16126
16127 #. type: textblock
16128 #: ../src/guestfs-actions.pod:6310
16129 msgid "This is like C<guestfs_command>, but passes the command to:"
16130 msgstr ""
16131
16132 #. type: verbatim
16133 #: ../src/guestfs-actions.pod:6312 ../fish/guestfish-actions.pod:4284
16134 #, no-wrap
16135 msgid ""
16136 " /bin/sh -c \"command\"\n"
16137 "\n"
16138 msgstr ""
16139
16140 #. type: textblock
16141 #: ../src/guestfs-actions.pod:6314 ../fish/guestfish-actions.pod:4286
16142 msgid ""
16143 "Depending on the guest's shell, this usually results in wildcards being "
16144 "expanded, shell expressions being interpolated and so on."
16145 msgstr ""
16146
16147 #. type: textblock
16148 #: ../src/guestfs-actions.pod:6318
16149 msgid "All the provisos about C<guestfs_command> apply to this call."
16150 msgstr ""
16151
16152 #. type: =head2
16153 #: ../src/guestfs-actions.pod:6325
16154 msgid "guestfs_sh_lines"
16155 msgstr ""
16156
16157 #. type: verbatim
16158 #: ../src/guestfs-actions.pod:6327
16159 #, no-wrap
16160 msgid ""
16161 " char **\n"
16162 " guestfs_sh_lines (guestfs_h *g,\n"
16163 "                   const char *command);\n"
16164 "\n"
16165 msgstr ""
16166
16167 #. type: textblock
16168 #: ../src/guestfs-actions.pod:6331
16169 msgid ""
16170 "This is the same as C<guestfs_sh>, but splits the result into a list of "
16171 "lines."
16172 msgstr ""
16173
16174 #. type: textblock
16175 #: ../src/guestfs-actions.pod:6334
16176 msgid "See also: C<guestfs_command_lines>"
16177 msgstr ""
16178
16179 #. type: =head2
16180 #: ../src/guestfs-actions.pod:6342
16181 msgid "guestfs_sleep"
16182 msgstr ""
16183
16184 #. type: verbatim
16185 #: ../src/guestfs-actions.pod:6344
16186 #, no-wrap
16187 msgid ""
16188 " int\n"
16189 " guestfs_sleep (guestfs_h *g,\n"
16190 "                int secs);\n"
16191 "\n"
16192 msgstr ""
16193
16194 #. type: textblock
16195 #: ../src/guestfs-actions.pod:6348 ../fish/guestfish-actions.pod:4305
16196 msgid "Sleep for C<secs> seconds."
16197 msgstr ""
16198
16199 #. type: textblock
16200 #: ../src/guestfs-actions.pod:6352
16201 msgid "(Added in 1.0.41)"
16202 msgstr ""
16203
16204 #. type: =head2
16205 #: ../src/guestfs-actions.pod:6354 ../src/guestfs-structs.pod:109
16206 msgid "guestfs_stat"
16207 msgstr ""
16208
16209 #. type: verbatim
16210 #: ../src/guestfs-actions.pod:6356
16211 #, no-wrap
16212 msgid ""
16213 " struct guestfs_stat *\n"
16214 " guestfs_stat (guestfs_h *g,\n"
16215 "               const char *path);\n"
16216 "\n"
16217 msgstr ""
16218
16219 #. type: textblock
16220 #: ../src/guestfs-actions.pod:6362 ../fish/guestfish-actions.pod:4313
16221 msgid "This is the same as the C<stat(2)> system call."
16222 msgstr ""
16223
16224 #. type: =head2
16225 #: ../src/guestfs-actions.pod:6370 ../src/guestfs-structs.pod:135
16226 msgid "guestfs_statvfs"
16227 msgstr ""
16228
16229 #. type: verbatim
16230 #: ../src/guestfs-actions.pod:6372
16231 #, no-wrap
16232 msgid ""
16233 " struct guestfs_statvfs *\n"
16234 " guestfs_statvfs (guestfs_h *g,\n"
16235 "                  const char *path);\n"
16236 "\n"
16237 msgstr ""
16238
16239 #. type: textblock
16240 #: ../src/guestfs-actions.pod:6376 ../fish/guestfish-actions.pod:4319
16241 msgid ""
16242 "Returns file system statistics for any mounted file system.  C<path> should "
16243 "be a file or directory in the mounted file system (typically it is the mount "
16244 "point itself, but it doesn't need to be)."
16245 msgstr ""
16246
16247 #. type: textblock
16248 #: ../src/guestfs-actions.pod:6380 ../fish/guestfish-actions.pod:4323
16249 msgid "This is the same as the C<statvfs(2)> system call."
16250 msgstr ""
16251
16252 #. type: textblock
16253 #: ../src/guestfs-actions.pod:6382
16254 msgid ""
16255 "This function returns a C<struct guestfs_statvfs *>, or NULL if there was an "
16256 "error.  I<The caller must call C<guestfs_free_statvfs> after use>."
16257 msgstr ""
16258
16259 #. type: =head2
16260 #: ../src/guestfs-actions.pod:6388
16261 msgid "guestfs_strings"
16262 msgstr ""
16263
16264 #. type: verbatim
16265 #: ../src/guestfs-actions.pod:6390
16266 #, no-wrap
16267 msgid ""
16268 " char **\n"
16269 " guestfs_strings (guestfs_h *g,\n"
16270 "                  const char *path);\n"
16271 "\n"
16272 msgstr ""
16273
16274 #. type: textblock
16275 #: ../src/guestfs-actions.pod:6394 ../fish/guestfish-actions.pod:4329
16276 msgid ""
16277 "This runs the L<strings(1)> command on a file and returns the list of "
16278 "printable strings found."
16279 msgstr ""
16280
16281 #. type: =head2
16282 #: ../src/guestfs-actions.pod:6406
16283 msgid "guestfs_strings_e"
16284 msgstr ""
16285
16286 #. type: verbatim
16287 #: ../src/guestfs-actions.pod:6408
16288 #, no-wrap
16289 msgid ""
16290 " char **\n"
16291 " guestfs_strings_e (guestfs_h *g,\n"
16292 "                    const char *encoding,\n"
16293 "                    const char *path);\n"
16294 "\n"
16295 msgstr ""
16296
16297 #. type: textblock
16298 #: ../src/guestfs-actions.pod:6413
16299 msgid ""
16300 "This is like the C<guestfs_strings> command, but allows you to specify the "
16301 "encoding of strings that are looked for in the source file C<path>."
16302 msgstr ""
16303
16304 #. type: textblock
16305 #: ../src/guestfs-actions.pod:6417 ../fish/guestfish-actions.pod:4343
16306 msgid "Allowed encodings are:"
16307 msgstr ""
16308
16309 #. type: =item
16310 #: ../src/guestfs-actions.pod:6421 ../fish/guestfish-actions.pod:4347
16311 msgid "s"
16312 msgstr ""
16313
16314 #. type: textblock
16315 #: ../src/guestfs-actions.pod:6423
16316 msgid ""
16317 "Single 7-bit-byte characters like ASCII and the ASCII-compatible parts of "
16318 "ISO-8859-X (this is what C<guestfs_strings> uses)."
16319 msgstr ""
16320
16321 #. type: =item
16322 #: ../src/guestfs-actions.pod:6426 ../fish/guestfish-actions.pod:4352
16323 msgid "S"
16324 msgstr ""
16325
16326 #. type: textblock
16327 #: ../src/guestfs-actions.pod:6428 ../fish/guestfish-actions.pod:4354
16328 msgid "Single 8-bit-byte characters."
16329 msgstr ""
16330
16331 #. type: =item
16332 #: ../src/guestfs-actions.pod:6430 ../fish/guestfish-actions.pod:4356
16333 msgid "b"
16334 msgstr ""
16335
16336 #. type: textblock
16337 #: ../src/guestfs-actions.pod:6432 ../fish/guestfish-actions.pod:4358
16338 msgid "16-bit big endian strings such as those encoded in UTF-16BE or UCS-2BE."
16339 msgstr ""
16340
16341 #. type: =item
16342 #: ../src/guestfs-actions.pod:6435 ../fish/guestfish-actions.pod:4361
16343 msgid "l (lower case letter L)"
16344 msgstr ""
16345
16346 #. type: textblock
16347 #: ../src/guestfs-actions.pod:6437 ../fish/guestfish-actions.pod:4363
16348 msgid ""
16349 "16-bit little endian such as UTF-16LE and UCS-2LE.  This is useful for "
16350 "examining binaries in Windows guests."
16351 msgstr ""
16352
16353 #. type: =item
16354 #: ../src/guestfs-actions.pod:6440 ../fish/guestfish-actions.pod:4366
16355 msgid "B"
16356 msgstr ""
16357
16358 #. type: textblock
16359 #: ../src/guestfs-actions.pod:6442 ../fish/guestfish-actions.pod:4368
16360 msgid "32-bit big endian such as UCS-4BE."
16361 msgstr ""
16362
16363 #. type: =item
16364 #: ../src/guestfs-actions.pod:6444 ../fish/guestfish-actions.pod:4370
16365 msgid "L"
16366 msgstr ""
16367
16368 #. type: textblock
16369 #: ../src/guestfs-actions.pod:6446 ../fish/guestfish-actions.pod:4372
16370 msgid "32-bit little endian such as UCS-4LE."
16371 msgstr ""
16372
16373 #. type: textblock
16374 #: ../src/guestfs-actions.pod:6450 ../fish/guestfish-actions.pod:4376
16375 msgid "The returned strings are transcoded to UTF-8."
16376 msgstr ""
16377
16378 #. type: =head2
16379 #: ../src/guestfs-actions.pod:6461
16380 msgid "guestfs_swapoff_device"
16381 msgstr ""
16382
16383 #. type: verbatim
16384 #: ../src/guestfs-actions.pod:6463
16385 #, no-wrap
16386 msgid ""
16387 " int\n"
16388 " guestfs_swapoff_device (guestfs_h *g,\n"
16389 "                         const char *device);\n"
16390 "\n"
16391 msgstr ""
16392
16393 #. type: textblock
16394 #: ../src/guestfs-actions.pod:6467
16395 msgid ""
16396 "This command disables the libguestfs appliance swap device or partition "
16397 "named C<device>.  See C<guestfs_swapon_device>."
16398 msgstr ""
16399
16400 #. type: =head2
16401 #: ../src/guestfs-actions.pod:6475
16402 msgid "guestfs_swapoff_file"
16403 msgstr ""
16404
16405 #. type: verbatim
16406 #: ../src/guestfs-actions.pod:6477
16407 #, no-wrap
16408 msgid ""
16409 " int\n"
16410 " guestfs_swapoff_file (guestfs_h *g,\n"
16411 "                       const char *file);\n"
16412 "\n"
16413 msgstr ""
16414
16415 #. type: textblock
16416 #: ../src/guestfs-actions.pod:6481 ../fish/guestfish-actions.pod:4393
16417 msgid "This command disables the libguestfs appliance swap on file."
16418 msgstr ""
16419
16420 #. type: =head2
16421 #: ../src/guestfs-actions.pod:6487
16422 msgid "guestfs_swapoff_label"
16423 msgstr ""
16424
16425 #. type: verbatim
16426 #: ../src/guestfs-actions.pod:6489
16427 #, no-wrap
16428 msgid ""
16429 " int\n"
16430 " guestfs_swapoff_label (guestfs_h *g,\n"
16431 "                        const char *label);\n"
16432 "\n"
16433 msgstr ""
16434
16435 #. type: textblock
16436 #: ../src/guestfs-actions.pod:6493 ../fish/guestfish-actions.pod:4399
16437 msgid ""
16438 "This command disables the libguestfs appliance swap on labeled swap "
16439 "partition."
16440 msgstr ""
16441
16442 #. type: =head2
16443 #: ../src/guestfs-actions.pod:6500
16444 msgid "guestfs_swapoff_uuid"
16445 msgstr ""
16446
16447 #. type: verbatim
16448 #: ../src/guestfs-actions.pod:6502
16449 #, no-wrap
16450 msgid ""
16451 " int\n"
16452 " guestfs_swapoff_uuid (guestfs_h *g,\n"
16453 "                       const char *uuid);\n"
16454 "\n"
16455 msgstr ""
16456
16457 #. type: textblock
16458 #: ../src/guestfs-actions.pod:6506 ../fish/guestfish-actions.pod:4406
16459 msgid ""
16460 "This command disables the libguestfs appliance swap partition with the given "
16461 "UUID."
16462 msgstr ""
16463
16464 #. type: =head2
16465 #: ../src/guestfs-actions.pod:6513
16466 msgid "guestfs_swapon_device"
16467 msgstr ""
16468
16469 #. type: verbatim
16470 #: ../src/guestfs-actions.pod:6515
16471 #, no-wrap
16472 msgid ""
16473 " int\n"
16474 " guestfs_swapon_device (guestfs_h *g,\n"
16475 "                        const char *device);\n"
16476 "\n"
16477 msgstr ""
16478
16479 #. type: textblock
16480 #: ../src/guestfs-actions.pod:6519
16481 msgid ""
16482 "This command enables the libguestfs appliance to use the swap device or "
16483 "partition named C<device>.  The increased memory is made available for all "
16484 "commands, for example those run using C<guestfs_command> or C<guestfs_sh>."
16485 msgstr ""
16486
16487 #. type: textblock
16488 #: ../src/guestfs-actions.pod:6524 ../fish/guestfish-actions.pod:4418
16489 msgid ""
16490 "Note that you should not swap to existing guest swap partitions unless you "
16491 "know what you are doing.  They may contain hibernation information, or other "
16492 "information that the guest doesn't want you to trash.  You also risk leaking "
16493 "information about the host to the guest this way.  Instead, attach a new "
16494 "host device to the guest and swap on that."
16495 msgstr ""
16496
16497 #. type: =head2
16498 #: ../src/guestfs-actions.pod:6535
16499 msgid "guestfs_swapon_file"
16500 msgstr ""
16501
16502 #. type: verbatim
16503 #: ../src/guestfs-actions.pod:6537
16504 #, no-wrap
16505 msgid ""
16506 " int\n"
16507 " guestfs_swapon_file (guestfs_h *g,\n"
16508 "                      const char *file);\n"
16509 "\n"
16510 msgstr ""
16511
16512 #. type: textblock
16513 #: ../src/guestfs-actions.pod:6541
16514 msgid ""
16515 "This command enables swap to a file.  See C<guestfs_swapon_device> for other "
16516 "notes."
16517 msgstr ""
16518
16519 #. type: =head2
16520 #: ../src/guestfs-actions.pod:6548
16521 msgid "guestfs_swapon_label"
16522 msgstr ""
16523
16524 #. type: verbatim
16525 #: ../src/guestfs-actions.pod:6550
16526 #, no-wrap
16527 msgid ""
16528 " int\n"
16529 " guestfs_swapon_label (guestfs_h *g,\n"
16530 "                       const char *label);\n"
16531 "\n"
16532 msgstr ""
16533
16534 #. type: textblock
16535 #: ../src/guestfs-actions.pod:6554
16536 msgid ""
16537 "This command enables swap to a labeled swap partition.  See "
16538 "C<guestfs_swapon_device> for other notes."
16539 msgstr ""
16540
16541 #. type: =head2
16542 #: ../src/guestfs-actions.pod:6561
16543 msgid "guestfs_swapon_uuid"
16544 msgstr ""
16545
16546 #. type: verbatim
16547 #: ../src/guestfs-actions.pod:6563
16548 #, no-wrap
16549 msgid ""
16550 " int\n"
16551 " guestfs_swapon_uuid (guestfs_h *g,\n"
16552 "                      const char *uuid);\n"
16553 "\n"
16554 msgstr ""
16555
16556 #. type: textblock
16557 #: ../src/guestfs-actions.pod:6567
16558 msgid ""
16559 "This command enables swap to a swap partition with the given UUID.  See "
16560 "C<guestfs_swapon_device> for other notes."
16561 msgstr ""
16562
16563 #. type: =head2
16564 #: ../src/guestfs-actions.pod:6574
16565 msgid "guestfs_sync"
16566 msgstr ""
16567
16568 #. type: verbatim
16569 #: ../src/guestfs-actions.pod:6576
16570 #, no-wrap
16571 msgid ""
16572 " int\n"
16573 " guestfs_sync (guestfs_h *g);\n"
16574 "\n"
16575 msgstr ""
16576
16577 #. type: textblock
16578 #: ../src/guestfs-actions.pod:6579 ../fish/guestfish-actions.pod:4450
16579 msgid ""
16580 "This syncs the disk, so that any writes are flushed through to the "
16581 "underlying disk image."
16582 msgstr ""
16583
16584 #. type: textblock
16585 #: ../src/guestfs-actions.pod:6582 ../fish/guestfish-actions.pod:4453
16586 msgid ""
16587 "You should always call this if you have modified a disk image, before "
16588 "closing the handle."
16589 msgstr ""
16590
16591 #. type: =head2
16592 #: ../src/guestfs-actions.pod:6589
16593 msgid "guestfs_tail"
16594 msgstr ""
16595
16596 #. type: verbatim
16597 #: ../src/guestfs-actions.pod:6591
16598 #, no-wrap
16599 msgid ""
16600 " char **\n"
16601 " guestfs_tail (guestfs_h *g,\n"
16602 "               const char *path);\n"
16603 "\n"
16604 msgstr ""
16605
16606 #. type: textblock
16607 #: ../src/guestfs-actions.pod:6595 ../fish/guestfish-actions.pod:4460
16608 msgid "This command returns up to the last 10 lines of a file as a list of strings."
16609 msgstr ""
16610
16611 #. type: =head2
16612 #: ../src/guestfs-actions.pod:6607
16613 msgid "guestfs_tail_n"
16614 msgstr ""
16615
16616 #. type: verbatim
16617 #: ../src/guestfs-actions.pod:6609
16618 #, no-wrap
16619 msgid ""
16620 " char **\n"
16621 " guestfs_tail_n (guestfs_h *g,\n"
16622 "                 int nrlines,\n"
16623 "                 const char *path);\n"
16624 "\n"
16625 msgstr ""
16626
16627 #. type: textblock
16628 #: ../src/guestfs-actions.pod:6614 ../fish/guestfish-actions.pod:4470
16629 msgid ""
16630 "If the parameter C<nrlines> is a positive number, this returns the last "
16631 "C<nrlines> lines of the file C<path>."
16632 msgstr ""
16633
16634 #. type: textblock
16635 #: ../src/guestfs-actions.pod:6617 ../fish/guestfish-actions.pod:4473
16636 msgid ""
16637 "If the parameter C<nrlines> is a negative number, this returns lines from "
16638 "the file C<path>, starting with the C<-nrlines>th line."
16639 msgstr ""
16640
16641 #. type: =head2
16642 #: ../src/guestfs-actions.pod:6631
16643 msgid "guestfs_tar_in"
16644 msgstr ""
16645
16646 #. type: verbatim
16647 #: ../src/guestfs-actions.pod:6633
16648 #, no-wrap
16649 msgid ""
16650 " int\n"
16651 " guestfs_tar_in (guestfs_h *g,\n"
16652 "                 const char *tarfile,\n"
16653 "                 const char *directory);\n"
16654 "\n"
16655 msgstr ""
16656
16657 #. type: textblock
16658 #: ../src/guestfs-actions.pod:6638 ../fish/guestfish-actions.pod:4485
16659 msgid ""
16660 "This command uploads and unpacks local file C<tarfile> (an I<uncompressed> "
16661 "tar file) into C<directory>."
16662 msgstr ""
16663
16664 #. type: textblock
16665 #: ../src/guestfs-actions.pod:6641
16666 msgid "To upload a compressed tarball, use C<guestfs_tgz_in> or C<guestfs_txz_in>."
16667 msgstr ""
16668
16669 #. type: textblock
16670 #: ../src/guestfs-actions.pod:6646 ../src/guestfs-actions.pod:6663 ../src/guestfs-actions.pod:6679 ../src/guestfs-actions.pod:6695
16671 msgid "(Added in 1.0.3)"
16672 msgstr ""
16673
16674 #. type: =head2
16675 #: ../src/guestfs-actions.pod:6648
16676 msgid "guestfs_tar_out"
16677 msgstr ""
16678
16679 #. type: verbatim
16680 #: ../src/guestfs-actions.pod:6650
16681 #, no-wrap
16682 msgid ""
16683 " int\n"
16684 " guestfs_tar_out (guestfs_h *g,\n"
16685 "                  const char *directory,\n"
16686 "                  const char *tarfile);\n"
16687 "\n"
16688 msgstr ""
16689
16690 #. type: textblock
16691 #: ../src/guestfs-actions.pod:6655 ../fish/guestfish-actions.pod:4497
16692 msgid ""
16693 "This command packs the contents of C<directory> and downloads it to local "
16694 "file C<tarfile>."
16695 msgstr ""
16696
16697 #. type: textblock
16698 #: ../src/guestfs-actions.pod:6658
16699 msgid ""
16700 "To download a compressed tarball, use C<guestfs_tgz_out> or "
16701 "C<guestfs_txz_out>."
16702 msgstr ""
16703
16704 #. type: =head2
16705 #: ../src/guestfs-actions.pod:6665
16706 msgid "guestfs_tgz_in"
16707 msgstr ""
16708
16709 #. type: verbatim
16710 #: ../src/guestfs-actions.pod:6667
16711 #, no-wrap
16712 msgid ""
16713 " int\n"
16714 " guestfs_tgz_in (guestfs_h *g,\n"
16715 "                 const char *tarball,\n"
16716 "                 const char *directory);\n"
16717 "\n"
16718 msgstr ""
16719
16720 #. type: textblock
16721 #: ../src/guestfs-actions.pod:6672 ../fish/guestfish-actions.pod:4509
16722 msgid ""
16723 "This command uploads and unpacks local file C<tarball> (a I<gzip compressed> "
16724 "tar file) into C<directory>."
16725 msgstr ""
16726
16727 #. type: textblock
16728 #: ../src/guestfs-actions.pod:6675
16729 msgid "To upload an uncompressed tarball, use C<guestfs_tar_in>."
16730 msgstr ""
16731
16732 #. type: =head2
16733 #: ../src/guestfs-actions.pod:6681
16734 msgid "guestfs_tgz_out"
16735 msgstr ""
16736
16737 #. type: verbatim
16738 #: ../src/guestfs-actions.pod:6683
16739 #, no-wrap
16740 msgid ""
16741 " int\n"
16742 " guestfs_tgz_out (guestfs_h *g,\n"
16743 "                  const char *directory,\n"
16744 "                  const char *tarball);\n"
16745 "\n"
16746 msgstr ""
16747
16748 #. type: textblock
16749 #: ../src/guestfs-actions.pod:6688 ../fish/guestfish-actions.pod:4520
16750 msgid ""
16751 "This command packs the contents of C<directory> and downloads it to local "
16752 "file C<tarball>."
16753 msgstr ""
16754
16755 #. type: textblock
16756 #: ../src/guestfs-actions.pod:6691
16757 msgid "To download an uncompressed tarball, use C<guestfs_tar_out>."
16758 msgstr ""
16759
16760 #. type: =head2
16761 #: ../src/guestfs-actions.pod:6697
16762 msgid "guestfs_touch"
16763 msgstr ""
16764
16765 #. type: verbatim
16766 #: ../src/guestfs-actions.pod:6699
16767 #, no-wrap
16768 msgid ""
16769 " int\n"
16770 " guestfs_touch (guestfs_h *g,\n"
16771 "                const char *path);\n"
16772 "\n"
16773 msgstr ""
16774
16775 #. type: textblock
16776 #: ../src/guestfs-actions.pod:6703 ../fish/guestfish-actions.pod:4531
16777 msgid ""
16778 "Touch acts like the L<touch(1)> command.  It can be used to update the "
16779 "timestamps on a file, or, if the file does not exist, to create a new "
16780 "zero-length file."
16781 msgstr ""
16782
16783 #. type: textblock
16784 #: ../src/guestfs-actions.pod:6707 ../fish/guestfish-actions.pod:4535
16785 msgid ""
16786 "This command only works on regular files, and will fail on other file types "
16787 "such as directories, symbolic links, block special etc."
16788 msgstr ""
16789
16790 #. type: =head2
16791 #: ../src/guestfs-actions.pod:6714
16792 msgid "guestfs_truncate"
16793 msgstr ""
16794
16795 #. type: verbatim
16796 #: ../src/guestfs-actions.pod:6716
16797 #, no-wrap
16798 msgid ""
16799 " int\n"
16800 " guestfs_truncate (guestfs_h *g,\n"
16801 "                   const char *path);\n"
16802 "\n"
16803 msgstr ""
16804
16805 #. type: textblock
16806 #: ../src/guestfs-actions.pod:6720 ../fish/guestfish-actions.pod:4542
16807 msgid ""
16808 "This command truncates C<path> to a zero-length file.  The file must exist "
16809 "already."
16810 msgstr ""
16811
16812 #. type: =head2
16813 #: ../src/guestfs-actions.pod:6727
16814 msgid "guestfs_truncate_size"
16815 msgstr ""
16816
16817 #. type: verbatim
16818 #: ../src/guestfs-actions.pod:6729
16819 #, no-wrap
16820 msgid ""
16821 " int\n"
16822 " guestfs_truncate_size (guestfs_h *g,\n"
16823 "                        const char *path,\n"
16824 "                        int64_t size);\n"
16825 "\n"
16826 msgstr ""
16827
16828 #. type: textblock
16829 #: ../src/guestfs-actions.pod:6734 ../fish/guestfish-actions.pod:4549
16830 msgid ""
16831 "This command truncates C<path> to size C<size> bytes.  The file must exist "
16832 "already."
16833 msgstr ""
16834
16835 #. type: textblock
16836 #: ../src/guestfs-actions.pod:6737
16837 msgid ""
16838 "If the current file size is less than C<size> then the file is extended to "
16839 "the required size with zero bytes.  This creates a sparse file (ie. disk "
16840 "blocks are not allocated for the file until you write to it).  To create a "
16841 "non-sparse file of zeroes, use C<guestfs_fallocate64> instead."
16842 msgstr ""
16843
16844 #. type: =head2
16845 #: ../src/guestfs-actions.pod:6747
16846 msgid "guestfs_tune2fs_l"
16847 msgstr ""
16848
16849 #. type: verbatim
16850 #: ../src/guestfs-actions.pod:6749
16851 #, no-wrap
16852 msgid ""
16853 " char **\n"
16854 " guestfs_tune2fs_l (guestfs_h *g,\n"
16855 "                    const char *device);\n"
16856 "\n"
16857 msgstr ""
16858
16859 #. type: textblock
16860 #: ../src/guestfs-actions.pod:6753 ../fish/guestfish-actions.pod:4562
16861 msgid ""
16862 "This returns the contents of the ext2, ext3 or ext4 filesystem superblock on "
16863 "C<device>."
16864 msgstr ""
16865
16866 #. type: textblock
16867 #: ../src/guestfs-actions.pod:6756 ../fish/guestfish-actions.pod:4565
16868 msgid ""
16869 "It is the same as running C<tune2fs -l device>.  See L<tune2fs(8)> manpage "
16870 "for more details.  The list of fields returned isn't clearly defined, and "
16871 "depends on both the version of C<tune2fs> that libguestfs was built against, "
16872 "and the filesystem itself."
16873 msgstr ""
16874
16875 #. type: =head2
16876 #: ../src/guestfs-actions.pod:6769
16877 msgid "guestfs_txz_in"
16878 msgstr ""
16879
16880 #. type: verbatim
16881 #: ../src/guestfs-actions.pod:6771
16882 #, no-wrap
16883 msgid ""
16884 " int\n"
16885 " guestfs_txz_in (guestfs_h *g,\n"
16886 "                 const char *tarball,\n"
16887 "                 const char *directory);\n"
16888 "\n"
16889 msgstr ""
16890
16891 #. type: textblock
16892 #: ../src/guestfs-actions.pod:6776 ../fish/guestfish-actions.pod:4574
16893 msgid ""
16894 "This command uploads and unpacks local file C<tarball> (an I<xz compressed> "
16895 "tar file) into C<directory>."
16896 msgstr ""
16897
16898 #. type: =head2
16899 #: ../src/guestfs-actions.pod:6783
16900 msgid "guestfs_txz_out"
16901 msgstr ""
16902
16903 #. type: verbatim
16904 #: ../src/guestfs-actions.pod:6785
16905 #, no-wrap
16906 msgid ""
16907 " int\n"
16908 " guestfs_txz_out (guestfs_h *g,\n"
16909 "                  const char *directory,\n"
16910 "                  const char *tarball);\n"
16911 "\n"
16912 msgstr ""
16913
16914 #. type: textblock
16915 #: ../src/guestfs-actions.pod:6790 ../fish/guestfish-actions.pod:4583
16916 msgid ""
16917 "This command packs the contents of C<directory> and downloads it to local "
16918 "file C<tarball> (as an xz compressed tar archive)."
16919 msgstr ""
16920
16921 #. type: =head2
16922 #: ../src/guestfs-actions.pod:6797
16923 msgid "guestfs_umask"
16924 msgstr ""
16925
16926 #. type: verbatim
16927 #: ../src/guestfs-actions.pod:6799
16928 #, no-wrap
16929 msgid ""
16930 " int\n"
16931 " guestfs_umask (guestfs_h *g,\n"
16932 "                int mask);\n"
16933 "\n"
16934 msgstr ""
16935
16936 #. type: textblock
16937 #: ../src/guestfs-actions.pod:6803 ../fish/guestfish-actions.pod:4592
16938 msgid ""
16939 "This function sets the mask used for creating new files and device nodes to "
16940 "C<mask & 0777>."
16941 msgstr ""
16942
16943 #. type: textblock
16944 #: ../src/guestfs-actions.pod:6806 ../fish/guestfish-actions.pod:4595
16945 msgid ""
16946 "Typical umask values would be C<022> which creates new files with "
16947 "permissions like \"-rw-r--r--\" or \"-rwxr-xr-x\", and C<002> which creates "
16948 "new files with permissions like \"-rw-rw-r--\" or \"-rwxrwxr-x\"."
16949 msgstr ""
16950
16951 #. type: textblock
16952 #: ../src/guestfs-actions.pod:6811 ../fish/guestfish-actions.pod:4600
16953 msgid ""
16954 "The default umask is C<022>.  This is important because it means that "
16955 "directories and device nodes will be created with C<0644> or C<0755> mode "
16956 "even if you specify C<0777>."
16957 msgstr ""
16958
16959 #. type: textblock
16960 #: ../src/guestfs-actions.pod:6815
16961 msgid ""
16962 "See also C<guestfs_get_umask>, L<umask(2)>, C<guestfs_mknod>, "
16963 "C<guestfs_mkdir>."
16964 msgstr ""
16965
16966 #. type: textblock
16967 #: ../src/guestfs-actions.pod:6818 ../fish/guestfish-actions.pod:4607
16968 msgid "This call returns the previous umask."
16969 msgstr ""
16970
16971 #. type: =head2
16972 #: ../src/guestfs-actions.pod:6824
16973 msgid "guestfs_umount"
16974 msgstr ""
16975
16976 #. type: verbatim
16977 #: ../src/guestfs-actions.pod:6826
16978 #, no-wrap
16979 msgid ""
16980 " int\n"
16981 " guestfs_umount (guestfs_h *g,\n"
16982 "                 const char *pathordevice);\n"
16983 "\n"
16984 msgstr ""
16985
16986 #. type: textblock
16987 #: ../src/guestfs-actions.pod:6830 ../fish/guestfish-actions.pod:4615
16988 msgid ""
16989 "This unmounts the given filesystem.  The filesystem may be specified either "
16990 "by its mountpoint (path) or the device which contains the filesystem."
16991 msgstr ""
16992
16993 #. type: =head2
16994 #: ../src/guestfs-actions.pod:6838
16995 msgid "guestfs_umount_all"
16996 msgstr ""
16997
16998 #. type: verbatim
16999 #: ../src/guestfs-actions.pod:6840
17000 #, no-wrap
17001 msgid ""
17002 " int\n"
17003 " guestfs_umount_all (guestfs_h *g);\n"
17004 "\n"
17005 msgstr ""
17006
17007 #. type: textblock
17008 #: ../src/guestfs-actions.pod:6843 ../fish/guestfish-actions.pod:4625
17009 msgid "This unmounts all mounted filesystems."
17010 msgstr ""
17011
17012 #. type: textblock
17013 #: ../src/guestfs-actions.pod:6845 ../fish/guestfish-actions.pod:4627
17014 msgid "Some internal mounts are not unmounted by this call."
17015 msgstr ""
17016
17017 #. type: =head2
17018 #: ../src/guestfs-actions.pod:6851
17019 msgid "guestfs_upload"
17020 msgstr ""
17021
17022 #. type: verbatim
17023 #: ../src/guestfs-actions.pod:6853
17024 #, no-wrap
17025 msgid ""
17026 " int\n"
17027 " guestfs_upload (guestfs_h *g,\n"
17028 "                 const char *filename,\n"
17029 "                 const char *remotefilename);\n"
17030 "\n"
17031 msgstr ""
17032
17033 #. type: textblock
17034 #: ../src/guestfs-actions.pod:6858 ../src/guestfs-actions.pod:6882 ../fish/guestfish-actions.pod:4633 ../fish/guestfish-actions.pod:4646
17035 msgid "Upload local file C<filename> to C<remotefilename> on the filesystem."
17036 msgstr ""
17037
17038 #. type: textblock
17039 #: ../src/guestfs-actions.pod:6863
17040 msgid "See also C<guestfs_download>."
17041 msgstr ""
17042
17043 #. type: =head2
17044 #: ../src/guestfs-actions.pod:6874
17045 msgid "guestfs_upload_offset"
17046 msgstr ""
17047
17048 #. type: verbatim
17049 #: ../src/guestfs-actions.pod:6876
17050 #, no-wrap
17051 msgid ""
17052 " int\n"
17053 " guestfs_upload_offset (guestfs_h *g,\n"
17054 "                        const char *filename,\n"
17055 "                        const char *remotefilename,\n"
17056 "                        int64_t offset);\n"
17057 "\n"
17058 msgstr ""
17059
17060 #. type: textblock
17061 #: ../src/guestfs-actions.pod:6885 ../fish/guestfish-actions.pod:4649
17062 msgid ""
17063 "C<remotefilename> is overwritten starting at the byte C<offset> specified.  "
17064 "The intention is to overwrite parts of existing files or devices, although "
17065 "if a non-existant file is specified then it is created with a \"hole\" "
17066 "before C<offset>.  The size of the data written is implicit in the size of "
17067 "the source C<filename>."
17068 msgstr ""
17069
17070 #. type: textblock
17071 #: ../src/guestfs-actions.pod:6892
17072 msgid ""
17073 "Note that there is no limit on the amount of data that can be uploaded with "
17074 "this call, unlike with C<guestfs_pwrite>, and this call always writes the "
17075 "full amount unless an error occurs."
17076 msgstr ""
17077
17078 #. type: textblock
17079 #: ../src/guestfs-actions.pod:6897
17080 msgid "See also C<guestfs_upload>, C<guestfs_pwrite>."
17081 msgstr ""
17082
17083 #. type: =head2
17084 #: ../src/guestfs-actions.pod:6908
17085 msgid "guestfs_utimens"
17086 msgstr ""
17087
17088 #. type: verbatim
17089 #: ../src/guestfs-actions.pod:6910
17090 #, no-wrap
17091 msgid ""
17092 " int\n"
17093 " guestfs_utimens (guestfs_h *g,\n"
17094 "                  const char *path,\n"
17095 "                  int64_t atsecs,\n"
17096 "                  int64_t atnsecs,\n"
17097 "                  int64_t mtsecs,\n"
17098 "                  int64_t mtnsecs);\n"
17099 "\n"
17100 msgstr ""
17101
17102 #. type: textblock
17103 #: ../src/guestfs-actions.pod:6918 ../fish/guestfish-actions.pod:4669
17104 msgid "This command sets the timestamps of a file with nanosecond precision."
17105 msgstr ""
17106
17107 #. type: textblock
17108 #: ../src/guestfs-actions.pod:6921 ../fish/guestfish-actions.pod:4672
17109 msgid ""
17110 "C<atsecs, atnsecs> are the last access time (atime) in secs and nanoseconds "
17111 "from the epoch."
17112 msgstr ""
17113
17114 #. type: textblock
17115 #: ../src/guestfs-actions.pod:6924 ../fish/guestfish-actions.pod:4675
17116 msgid ""
17117 "C<mtsecs, mtnsecs> are the last modification time (mtime) in secs and "
17118 "nanoseconds from the epoch."
17119 msgstr ""
17120
17121 #. type: textblock
17122 #: ../src/guestfs-actions.pod:6927 ../fish/guestfish-actions.pod:4678
17123 msgid ""
17124 "If the C<*nsecs> field contains the special value C<-1> then the "
17125 "corresponding timestamp is set to the current time.  (The C<*secs> field is "
17126 "ignored in this case)."
17127 msgstr ""
17128
17129 #. type: textblock
17130 #: ../src/guestfs-actions.pod:6931 ../fish/guestfish-actions.pod:4682
17131 msgid ""
17132 "If the C<*nsecs> field contains the special value C<-2> then the "
17133 "corresponding timestamp is left unchanged.  (The C<*secs> field is ignored "
17134 "in this case)."
17135 msgstr ""
17136
17137 #. type: =head2
17138 #: ../src/guestfs-actions.pod:6939 ../src/guestfs-structs.pod:175
17139 msgid "guestfs_version"
17140 msgstr ""
17141
17142 #. type: verbatim
17143 #: ../src/guestfs-actions.pod:6941
17144 #, no-wrap
17145 msgid ""
17146 " struct guestfs_version *\n"
17147 " guestfs_version (guestfs_h *g);\n"
17148 "\n"
17149 msgstr ""
17150
17151 #. type: textblock
17152 #: ../src/guestfs-actions.pod:6944 ../fish/guestfish-actions.pod:4690
17153 msgid "Return the libguestfs version number that the program is linked against."
17154 msgstr ""
17155
17156 #. type: textblock
17157 #: ../src/guestfs-actions.pod:6947 ../fish/guestfish-actions.pod:4693
17158 msgid ""
17159 "Note that because of dynamic linking this is not necessarily the version of "
17160 "libguestfs that you compiled against.  You can compile the program, and then "
17161 "at runtime dynamically link against a completely different C<libguestfs.so> "
17162 "library."
17163 msgstr ""
17164
17165 #. type: textblock
17166 #: ../src/guestfs-actions.pod:6952 ../fish/guestfish-actions.pod:4698
17167 msgid ""
17168 "This call was added in version C<1.0.58>.  In previous versions of "
17169 "libguestfs there was no way to get the version number.  From C code you can "
17170 "use dynamic linker functions to find out if this symbol exists (if it "
17171 "doesn't, then it's an earlier version)."
17172 msgstr ""
17173
17174 #. type: textblock
17175 #: ../src/guestfs-actions.pod:6958 ../fish/guestfish-actions.pod:4704
17176 msgid ""
17177 "The call returns a structure with four elements.  The first three (C<major>, "
17178 "C<minor> and C<release>) are numbers and correspond to the usual version "
17179 "triplet.  The fourth element (C<extra>) is a string and is normally empty, "
17180 "but may be used for distro-specific information."
17181 msgstr ""
17182
17183 #. type: textblock
17184 #: ../src/guestfs-actions.pod:6964 ../fish/guestfish-actions.pod:4710
17185 msgid "To construct the original version string: C<$major.$minor.$release$extra>"
17186 msgstr ""
17187
17188 #. type: textblock
17189 #: ../src/guestfs-actions.pod:6967 ../fish/guestfish-actions.pod:4713
17190 msgid "See also: L<guestfs(3)/LIBGUESTFS VERSION NUMBERS>."
17191 msgstr ""
17192
17193 #. type: textblock
17194 #: ../src/guestfs-actions.pod:6969
17195 msgid ""
17196 "I<Note:> Don't use this call to test for availability of features.  In "
17197 "enterprise distributions we backport features from later versions into "
17198 "earlier versions, making this an unreliable way to test for features.  Use "
17199 "C<guestfs_available> instead."
17200 msgstr ""
17201
17202 #. type: textblock
17203 #: ../src/guestfs-actions.pod:6975
17204 msgid ""
17205 "This function returns a C<struct guestfs_version *>, or NULL if there was an "
17206 "error.  I<The caller must call C<guestfs_free_version> after use>."
17207 msgstr ""
17208
17209 #. type: textblock
17210 #: ../src/guestfs-actions.pod:6979
17211 msgid "(Added in 1.0.58)"
17212 msgstr ""
17213
17214 #. type: =head2
17215 #: ../src/guestfs-actions.pod:6981
17216 msgid "guestfs_vfs_label"
17217 msgstr ""
17218
17219 #. type: verbatim
17220 #: ../src/guestfs-actions.pod:6983
17221 #, no-wrap
17222 msgid ""
17223 " char *\n"
17224 " guestfs_vfs_label (guestfs_h *g,\n"
17225 "                    const char *device);\n"
17226 "\n"
17227 msgstr ""
17228
17229 #. type: textblock
17230 #: ../src/guestfs-actions.pod:6987 ../fish/guestfish-actions.pod:4725
17231 msgid "This returns the filesystem label of the filesystem on C<device>."
17232 msgstr ""
17233
17234 #. type: textblock
17235 #: ../src/guestfs-actions.pod:6990 ../fish/guestfish-actions.pod:4728
17236 msgid "If the filesystem is unlabeled, this returns the empty string."
17237 msgstr ""
17238
17239 #. type: textblock
17240 #: ../src/guestfs-actions.pod:6992
17241 msgid "To find a filesystem from the label, use C<guestfs_findfs_label>."
17242 msgstr ""
17243
17244 #. type: textblock
17245 #: ../src/guestfs-actions.pod:6997 ../src/guestfs-actions.pod:7034
17246 msgid "(Added in 1.3.18)"
17247 msgstr ""
17248
17249 #. type: =head2
17250 #: ../src/guestfs-actions.pod:6999
17251 msgid "guestfs_vfs_type"
17252 msgstr ""
17253
17254 #. type: verbatim
17255 #: ../src/guestfs-actions.pod:7001
17256 #, no-wrap
17257 msgid ""
17258 " char *\n"
17259 " guestfs_vfs_type (guestfs_h *g,\n"
17260 "                   const char *device);\n"
17261 "\n"
17262 msgstr ""
17263
17264 #. type: textblock
17265 #: ../src/guestfs-actions.pod:7005 ../fish/guestfish-actions.pod:4736
17266 msgid ""
17267 "This command gets the filesystem type corresponding to the filesystem on "
17268 "C<device>."
17269 msgstr ""
17270
17271 #. type: textblock
17272 #: ../src/guestfs-actions.pod:7008 ../fish/guestfish-actions.pod:4739
17273 msgid ""
17274 "For most filesystems, the result is the name of the Linux VFS module which "
17275 "would be used to mount this filesystem if you mounted it without specifying "
17276 "the filesystem type.  For example a string such as C<ext3> or C<ntfs>."
17277 msgstr ""
17278
17279 #. type: =head2
17280 #: ../src/guestfs-actions.pod:7018
17281 msgid "guestfs_vfs_uuid"
17282 msgstr ""
17283
17284 #. type: verbatim
17285 #: ../src/guestfs-actions.pod:7020
17286 #, no-wrap
17287 msgid ""
17288 " char *\n"
17289 " guestfs_vfs_uuid (guestfs_h *g,\n"
17290 "                   const char *device);\n"
17291 "\n"
17292 msgstr ""
17293
17294 #. type: textblock
17295 #: ../src/guestfs-actions.pod:7024 ../fish/guestfish-actions.pod:4748
17296 msgid "This returns the filesystem UUID of the filesystem on C<device>."
17297 msgstr ""
17298
17299 #. type: textblock
17300 #: ../src/guestfs-actions.pod:7027 ../fish/guestfish-actions.pod:4751
17301 msgid "If the filesystem does not have a UUID, this returns the empty string."
17302 msgstr ""
17303
17304 #. type: textblock
17305 #: ../src/guestfs-actions.pod:7029
17306 msgid "To find a filesystem from the UUID, use C<guestfs_findfs_uuid>."
17307 msgstr ""
17308
17309 #. type: =head2
17310 #: ../src/guestfs-actions.pod:7036
17311 msgid "guestfs_vg_activate"
17312 msgstr ""
17313
17314 #. type: verbatim
17315 #: ../src/guestfs-actions.pod:7038
17316 #, no-wrap
17317 msgid ""
17318 " int\n"
17319 " guestfs_vg_activate (guestfs_h *g,\n"
17320 "                      int activate,\n"
17321 "                      char *const *volgroups);\n"
17322 "\n"
17323 msgstr ""
17324
17325 #. type: textblock
17326 #: ../src/guestfs-actions.pod:7043 ../fish/guestfish-actions.pod:4759
17327 msgid ""
17328 "This command activates or (if C<activate> is false) deactivates all logical "
17329 "volumes in the listed volume groups C<volgroups>.  If activated, then they "
17330 "are made known to the kernel, ie. they appear as C</dev/mapper> devices.  If "
17331 "deactivated, then those devices disappear."
17332 msgstr ""
17333
17334 #. type: textblock
17335 #: ../src/guestfs-actions.pod:7049 ../fish/guestfish-actions.pod:4765
17336 msgid "This command is the same as running C<vgchange -a y|n volgroups...>"
17337 msgstr ""
17338
17339 #. type: textblock
17340 #: ../src/guestfs-actions.pod:7051 ../fish/guestfish-actions.pod:4767
17341 msgid ""
17342 "Note that if C<volgroups> is an empty list then B<all> volume groups are "
17343 "activated or deactivated."
17344 msgstr ""
17345
17346 #. type: =head2
17347 #: ../src/guestfs-actions.pod:7058
17348 msgid "guestfs_vg_activate_all"
17349 msgstr ""
17350
17351 #. type: verbatim
17352 #: ../src/guestfs-actions.pod:7060
17353 #, no-wrap
17354 msgid ""
17355 " int\n"
17356 " guestfs_vg_activate_all (guestfs_h *g,\n"
17357 "                          int activate);\n"
17358 "\n"
17359 msgstr ""
17360
17361 #. type: textblock
17362 #: ../src/guestfs-actions.pod:7064 ../fish/guestfish-actions.pod:4774
17363 msgid ""
17364 "This command activates or (if C<activate> is false) deactivates all logical "
17365 "volumes in all volume groups.  If activated, then they are made known to the "
17366 "kernel, ie. they appear as C</dev/mapper> devices.  If deactivated, then "
17367 "those devices disappear."
17368 msgstr ""
17369
17370 #. type: textblock
17371 #: ../src/guestfs-actions.pod:7070 ../fish/guestfish-actions.pod:4780
17372 msgid "This command is the same as running C<vgchange -a y|n>"
17373 msgstr ""
17374
17375 #. type: =head2
17376 #: ../src/guestfs-actions.pod:7076
17377 msgid "guestfs_vgcreate"
17378 msgstr ""
17379
17380 #. type: verbatim
17381 #: ../src/guestfs-actions.pod:7078
17382 #, no-wrap
17383 msgid ""
17384 " int\n"
17385 " guestfs_vgcreate (guestfs_h *g,\n"
17386 "                   const char *volgroup,\n"
17387 "                   char *const *physvols);\n"
17388 "\n"
17389 msgstr ""
17390
17391 #. type: textblock
17392 #: ../src/guestfs-actions.pod:7083 ../fish/guestfish-actions.pod:4786
17393 msgid ""
17394 "This creates an LVM volume group called C<volgroup> from the non-empty list "
17395 "of physical volumes C<physvols>."
17396 msgstr ""
17397
17398 #. type: =head2
17399 #: ../src/guestfs-actions.pod:7090
17400 msgid "guestfs_vglvuuids"
17401 msgstr ""
17402
17403 #. type: verbatim
17404 #: ../src/guestfs-actions.pod:7092
17405 #, no-wrap
17406 msgid ""
17407 " char **\n"
17408 " guestfs_vglvuuids (guestfs_h *g,\n"
17409 "                    const char *vgname);\n"
17410 "\n"
17411 msgstr ""
17412
17413 #. type: textblock
17414 #: ../src/guestfs-actions.pod:7096 ../fish/guestfish-actions.pod:4793
17415 msgid ""
17416 "Given a VG called C<vgname>, this returns the UUIDs of all the logical "
17417 "volumes created in this volume group."
17418 msgstr ""
17419
17420 #. type: textblock
17421 #: ../src/guestfs-actions.pod:7099
17422 msgid ""
17423 "You can use this along with C<guestfs_lvs> and C<guestfs_lvuuid> calls to "
17424 "associate logical volumes and volume groups."
17425 msgstr ""
17426
17427 #. type: textblock
17428 #: ../src/guestfs-actions.pod:7102
17429 msgid "See also C<guestfs_vgpvuuids>."
17430 msgstr ""
17431
17432 #. type: =head2
17433 #: ../src/guestfs-actions.pod:7110
17434 msgid "guestfs_vgpvuuids"
17435 msgstr ""
17436
17437 #. type: verbatim
17438 #: ../src/guestfs-actions.pod:7112
17439 #, no-wrap
17440 msgid ""
17441 " char **\n"
17442 " guestfs_vgpvuuids (guestfs_h *g,\n"
17443 "                    const char *vgname);\n"
17444 "\n"
17445 msgstr ""
17446
17447 #. type: textblock
17448 #: ../src/guestfs-actions.pod:7116 ../fish/guestfish-actions.pod:4805
17449 msgid ""
17450 "Given a VG called C<vgname>, this returns the UUIDs of all the physical "
17451 "volumes that this volume group resides on."
17452 msgstr ""
17453
17454 #. type: textblock
17455 #: ../src/guestfs-actions.pod:7119
17456 msgid ""
17457 "You can use this along with C<guestfs_pvs> and C<guestfs_pvuuid> calls to "
17458 "associate physical volumes and volume groups."
17459 msgstr ""
17460
17461 #. type: textblock
17462 #: ../src/guestfs-actions.pod:7122
17463 msgid "See also C<guestfs_vglvuuids>."
17464 msgstr ""
17465
17466 #. type: =head2
17467 #: ../src/guestfs-actions.pod:7130
17468 msgid "guestfs_vgremove"
17469 msgstr ""
17470
17471 #. type: verbatim
17472 #: ../src/guestfs-actions.pod:7132
17473 #, no-wrap
17474 msgid ""
17475 " int\n"
17476 " guestfs_vgremove (guestfs_h *g,\n"
17477 "                   const char *vgname);\n"
17478 "\n"
17479 msgstr ""
17480
17481 #. type: textblock
17482 #: ../src/guestfs-actions.pod:7136 ../fish/guestfish-actions.pod:4817
17483 msgid "Remove an LVM volume group C<vgname>, (for example C<VG>)."
17484 msgstr ""
17485
17486 #. type: textblock
17487 #: ../src/guestfs-actions.pod:7138 ../fish/guestfish-actions.pod:4819
17488 msgid "This also forcibly removes all logical volumes in the volume group (if any)."
17489 msgstr ""
17490
17491 #. type: =head2
17492 #: ../src/guestfs-actions.pod:7145
17493 msgid "guestfs_vgrename"
17494 msgstr ""
17495
17496 #. type: verbatim
17497 #: ../src/guestfs-actions.pod:7147
17498 #, no-wrap
17499 msgid ""
17500 " int\n"
17501 " guestfs_vgrename (guestfs_h *g,\n"
17502 "                   const char *volgroup,\n"
17503 "                   const char *newvolgroup);\n"
17504 "\n"
17505 msgstr ""
17506
17507 #. type: textblock
17508 #: ../src/guestfs-actions.pod:7152 ../fish/guestfish-actions.pod:4826
17509 msgid "Rename a volume group C<volgroup> with the new name C<newvolgroup>."
17510 msgstr ""
17511
17512 #. type: =head2
17513 #: ../src/guestfs-actions.pod:7158
17514 msgid "guestfs_vgs"
17515 msgstr ""
17516
17517 #. type: verbatim
17518 #: ../src/guestfs-actions.pod:7160
17519 #, no-wrap
17520 msgid ""
17521 " char **\n"
17522 " guestfs_vgs (guestfs_h *g);\n"
17523 "\n"
17524 msgstr ""
17525
17526 #. type: textblock
17527 #: ../src/guestfs-actions.pod:7163 ../fish/guestfish-actions.pod:4832
17528 msgid ""
17529 "List all the volumes groups detected.  This is the equivalent of the "
17530 "L<vgs(8)> command."
17531 msgstr ""
17532
17533 #. type: textblock
17534 #: ../src/guestfs-actions.pod:7166 ../fish/guestfish-actions.pod:4835
17535 msgid ""
17536 "This returns a list of just the volume group names that were detected "
17537 "(eg. C<VolGroup00>)."
17538 msgstr ""
17539
17540 #. type: textblock
17541 #: ../src/guestfs-actions.pod:7169
17542 msgid "See also C<guestfs_vgs_full>."
17543 msgstr ""
17544
17545 #. type: =head2
17546 #: ../src/guestfs-actions.pod:7177
17547 msgid "guestfs_vgs_full"
17548 msgstr ""
17549
17550 #. type: verbatim
17551 #: ../src/guestfs-actions.pod:7179
17552 #, no-wrap
17553 msgid ""
17554 " struct guestfs_lvm_vg_list *\n"
17555 " guestfs_vgs_full (guestfs_h *g);\n"
17556 "\n"
17557 msgstr ""
17558
17559 #. type: textblock
17560 #: ../src/guestfs-actions.pod:7182 ../fish/guestfish-actions.pod:4844
17561 msgid ""
17562 "List all the volumes groups detected.  This is the equivalent of the "
17563 "L<vgs(8)> command.  The \"full\" version includes all fields."
17564 msgstr ""
17565
17566 #. type: textblock
17567 #: ../src/guestfs-actions.pod:7185
17568 msgid ""
17569 "This function returns a C<struct guestfs_lvm_vg_list *>, or NULL if there "
17570 "was an error.  I<The caller must call C<guestfs_free_lvm_vg_list> after "
17571 "use>."
17572 msgstr ""
17573
17574 #. type: =head2
17575 #: ../src/guestfs-actions.pod:7191
17576 msgid "guestfs_vgscan"
17577 msgstr ""
17578
17579 #. type: verbatim
17580 #: ../src/guestfs-actions.pod:7193
17581 #, no-wrap
17582 msgid ""
17583 " int\n"
17584 " guestfs_vgscan (guestfs_h *g);\n"
17585 "\n"
17586 msgstr ""
17587
17588 #. type: textblock
17589 #: ../src/guestfs-actions.pod:7196 ../fish/guestfish-actions.pod:4851
17590 msgid ""
17591 "This rescans all block devices and rebuilds the list of LVM physical "
17592 "volumes, volume groups and logical volumes."
17593 msgstr ""
17594
17595 #. type: =head2
17596 #: ../src/guestfs-actions.pod:7203
17597 msgid "guestfs_vguuid"
17598 msgstr ""
17599
17600 #. type: verbatim
17601 #: ../src/guestfs-actions.pod:7205
17602 #, no-wrap
17603 msgid ""
17604 " char *\n"
17605 " guestfs_vguuid (guestfs_h *g,\n"
17606 "                 const char *vgname);\n"
17607 "\n"
17608 msgstr ""
17609
17610 #. type: textblock
17611 #: ../src/guestfs-actions.pod:7209 ../fish/guestfish-actions.pod:4858
17612 msgid "This command returns the UUID of the LVM VG named C<vgname>."
17613 msgstr ""
17614
17615 #. type: =head2
17616 #: ../src/guestfs-actions.pod:7216
17617 msgid "guestfs_wait_ready"
17618 msgstr ""
17619
17620 #. type: verbatim
17621 #: ../src/guestfs-actions.pod:7218
17622 #, no-wrap
17623 msgid ""
17624 " int\n"
17625 " guestfs_wait_ready (guestfs_h *g);\n"
17626 "\n"
17627 msgstr ""
17628
17629 #. type: textblock
17630 #: ../src/guestfs-actions.pod:7221
17631 msgid "This function is a no op."
17632 msgstr ""
17633
17634 #. type: textblock
17635 #: ../src/guestfs-actions.pod:7223
17636 msgid ""
17637 "In versions of the API E<lt> 1.0.71 you had to call this function just after "
17638 "calling C<guestfs_launch> to wait for the launch to complete.  However this "
17639 "is no longer necessary because C<guestfs_launch> now does the waiting."
17640 msgstr ""
17641
17642 #. type: textblock
17643 #: ../src/guestfs-actions.pod:7228
17644 msgid ""
17645 "If you see any calls to this function in code then you can just remove them, "
17646 "unless you want to retain compatibility with older versions of the API."
17647 msgstr ""
17648
17649 #. type: textblock
17650 #: ../src/guestfs-actions.pod:7234
17651 msgid ""
17652 "This function is deprecated.  In new code, use the L</guestfs_launch> call "
17653 "instead."
17654 msgstr ""
17655
17656 #. type: =head2
17657 #: ../src/guestfs-actions.pod:7243
17658 msgid "guestfs_wc_c"
17659 msgstr ""
17660
17661 #. type: verbatim
17662 #: ../src/guestfs-actions.pod:7245
17663 #, no-wrap
17664 msgid ""
17665 " int\n"
17666 " guestfs_wc_c (guestfs_h *g,\n"
17667 "               const char *path);\n"
17668 "\n"
17669 msgstr ""
17670
17671 #. type: textblock
17672 #: ../src/guestfs-actions.pod:7249 ../fish/guestfish-actions.pod:4864
17673 msgid ""
17674 "This command counts the characters in a file, using the C<wc -c> external "
17675 "command."
17676 msgstr ""
17677
17678 #. type: =head2
17679 #: ../src/guestfs-actions.pod:7256
17680 msgid "guestfs_wc_l"
17681 msgstr ""
17682
17683 #. type: verbatim
17684 #: ../src/guestfs-actions.pod:7258
17685 #, no-wrap
17686 msgid ""
17687 " int\n"
17688 " guestfs_wc_l (guestfs_h *g,\n"
17689 "               const char *path);\n"
17690 "\n"
17691 msgstr ""
17692
17693 #. type: textblock
17694 #: ../src/guestfs-actions.pod:7262 ../fish/guestfish-actions.pod:4871
17695 msgid ""
17696 "This command counts the lines in a file, using the C<wc -l> external "
17697 "command."
17698 msgstr ""
17699
17700 #. type: =head2
17701 #: ../src/guestfs-actions.pod:7269
17702 msgid "guestfs_wc_w"
17703 msgstr ""
17704
17705 #. type: verbatim
17706 #: ../src/guestfs-actions.pod:7271
17707 #, no-wrap
17708 msgid ""
17709 " int\n"
17710 " guestfs_wc_w (guestfs_h *g,\n"
17711 "               const char *path);\n"
17712 "\n"
17713 msgstr ""
17714
17715 #. type: textblock
17716 #: ../src/guestfs-actions.pod:7275 ../fish/guestfish-actions.pod:4878
17717 msgid ""
17718 "This command counts the words in a file, using the C<wc -w> external "
17719 "command."
17720 msgstr ""
17721
17722 #. type: =head2
17723 #: ../src/guestfs-actions.pod:7282
17724 msgid "guestfs_write"
17725 msgstr ""
17726
17727 #. type: verbatim
17728 #: ../src/guestfs-actions.pod:7284
17729 #, no-wrap
17730 msgid ""
17731 " int\n"
17732 " guestfs_write (guestfs_h *g,\n"
17733 "                const char *path,\n"
17734 "                const char *content,\n"
17735 "                size_t content_size);\n"
17736 "\n"
17737 msgstr ""
17738
17739 #. type: textblock
17740 #: ../src/guestfs-actions.pod:7290 ../fish/guestfish-actions.pod:4885
17741 msgid ""
17742 "This call creates a file called C<path>.  The content of the file is the "
17743 "string C<content> (which can contain any 8 bit data)."
17744 msgstr ""
17745
17746 #. type: =head2
17747 #: ../src/guestfs-actions.pod:7300
17748 msgid "guestfs_write_file"
17749 msgstr ""
17750
17751 #. type: verbatim
17752 #: ../src/guestfs-actions.pod:7302
17753 #, no-wrap
17754 msgid ""
17755 " int\n"
17756 " guestfs_write_file (guestfs_h *g,\n"
17757 "                     const char *path,\n"
17758 "                     const char *content,\n"
17759 "                     int size);\n"
17760 "\n"
17761 msgstr ""
17762
17763 #. type: textblock
17764 #: ../src/guestfs-actions.pod:7308 ../fish/guestfish-actions.pod:4895
17765 msgid ""
17766 "This call creates a file called C<path>.  The contents of the file is the "
17767 "string C<content> (which can contain any 8 bit data), with length C<size>."
17768 msgstr ""
17769
17770 #. type: textblock
17771 #: ../src/guestfs-actions.pod:7312 ../fish/guestfish-actions.pod:4899
17772 msgid ""
17773 "As a special case, if C<size> is C<0> then the length is calculated using "
17774 "C<strlen> (so in this case the content cannot contain embedded ASCII NULs)."
17775 msgstr ""
17776
17777 #. type: textblock
17778 #: ../src/guestfs-actions.pod:7316 ../fish/guestfish-actions.pod:4903
17779 msgid ""
17780 "I<NB.> Owing to a bug, writing content containing ASCII NUL characters does "
17781 "I<not> work, even if the length is specified."
17782 msgstr ""
17783
17784 #. type: textblock
17785 #: ../src/guestfs-actions.pod:7324
17786 msgid ""
17787 "This function is deprecated.  In new code, use the L</guestfs_write> call "
17788 "instead."
17789 msgstr ""
17790
17791 #. type: =head2
17792 #: ../src/guestfs-actions.pod:7333
17793 msgid "guestfs_zegrep"
17794 msgstr ""
17795
17796 #. type: verbatim
17797 #: ../src/guestfs-actions.pod:7335
17798 #, no-wrap
17799 msgid ""
17800 " char **\n"
17801 " guestfs_zegrep (guestfs_h *g,\n"
17802 "                 const char *regex,\n"
17803 "                 const char *path);\n"
17804 "\n"
17805 msgstr ""
17806
17807 #. type: textblock
17808 #: ../src/guestfs-actions.pod:7340 ../fish/guestfish-actions.pod:4920
17809 msgid "This calls the external C<zegrep> program and returns the matching lines."
17810 msgstr ""
17811
17812 #. type: =head2
17813 #: ../src/guestfs-actions.pod:7352
17814 msgid "guestfs_zegrepi"
17815 msgstr ""
17816
17817 #. type: verbatim
17818 #: ../src/guestfs-actions.pod:7354
17819 #, no-wrap
17820 msgid ""
17821 " char **\n"
17822 " guestfs_zegrepi (guestfs_h *g,\n"
17823 "                  const char *regex,\n"
17824 "                  const char *path);\n"
17825 "\n"
17826 msgstr ""
17827
17828 #. type: textblock
17829 #: ../src/guestfs-actions.pod:7359 ../fish/guestfish-actions.pod:4930
17830 msgid "This calls the external C<zegrep -i> program and returns the matching lines."
17831 msgstr ""
17832
17833 #. type: =head2
17834 #: ../src/guestfs-actions.pod:7371
17835 msgid "guestfs_zero"
17836 msgstr ""
17837
17838 #. type: verbatim
17839 #: ../src/guestfs-actions.pod:7373
17840 #, no-wrap
17841 msgid ""
17842 " int\n"
17843 " guestfs_zero (guestfs_h *g,\n"
17844 "               const char *device);\n"
17845 "\n"
17846 msgstr ""
17847
17848 #. type: textblock
17849 #: ../src/guestfs-actions.pod:7377 ../fish/guestfish-actions.pod:4940
17850 msgid "This command writes zeroes over the first few blocks of C<device>."
17851 msgstr ""
17852
17853 #. type: textblock
17854 #: ../src/guestfs-actions.pod:7379 ../fish/guestfish-actions.pod:4942
17855 msgid ""
17856 "How many blocks are zeroed isn't specified (but it's I<not> enough to "
17857 "securely wipe the device).  It should be sufficient to remove any partition "
17858 "tables, filesystem superblocks and so on."
17859 msgstr ""
17860
17861 #. type: textblock
17862 #: ../src/guestfs-actions.pod:7383
17863 msgid "See also: C<guestfs_zero_device>, C<guestfs_scrub_device>."
17864 msgstr ""
17865
17866 #. type: =head2
17867 #: ../src/guestfs-actions.pod:7394
17868 msgid "guestfs_zero_device"
17869 msgstr ""
17870
17871 #. type: verbatim
17872 #: ../src/guestfs-actions.pod:7396
17873 #, no-wrap
17874 msgid ""
17875 " int\n"
17876 " guestfs_zero_device (guestfs_h *g,\n"
17877 "                      const char *device);\n"
17878 "\n"
17879 msgstr ""
17880
17881 #. type: textblock
17882 #: ../src/guestfs-actions.pod:7400
17883 msgid ""
17884 "This command writes zeroes over the entire C<device>.  Compare with "
17885 "C<guestfs_zero> which just zeroes the first few blocks of a device."
17886 msgstr ""
17887
17888 #. type: textblock
17889 #: ../src/guestfs-actions.pod:7414
17890 msgid "(Added in 1.3.1)"
17891 msgstr ""
17892
17893 #. type: =head2
17894 #: ../src/guestfs-actions.pod:7416
17895 msgid "guestfs_zerofree"
17896 msgstr ""
17897
17898 #. type: verbatim
17899 #: ../src/guestfs-actions.pod:7418
17900 #, no-wrap
17901 msgid ""
17902 " int\n"
17903 " guestfs_zerofree (guestfs_h *g,\n"
17904 "                   const char *device);\n"
17905 "\n"
17906 msgstr ""
17907
17908 #. type: textblock
17909 #: ../src/guestfs-actions.pod:7422 ../fish/guestfish-actions.pod:4963
17910 msgid ""
17911 "This runs the I<zerofree> program on C<device>.  This program claims to zero "
17912 "unused inodes and disk blocks on an ext2/3 filesystem, thus making it "
17913 "possible to compress the filesystem more effectively."
17914 msgstr ""
17915
17916 #. type: textblock
17917 #: ../src/guestfs-actions.pod:7427 ../fish/guestfish-actions.pod:4968
17918 msgid "You should B<not> run this program if the filesystem is mounted."
17919 msgstr ""
17920
17921 #. type: textblock
17922 #: ../src/guestfs-actions.pod:7430 ../fish/guestfish-actions.pod:4971
17923 msgid ""
17924 "It is possible that using this program can damage the filesystem or data on "
17925 "the filesystem."
17926 msgstr ""
17927
17928 #. type: =head2
17929 #: ../src/guestfs-actions.pod:7437
17930 msgid "guestfs_zfgrep"
17931 msgstr ""
17932
17933 #. type: verbatim
17934 #: ../src/guestfs-actions.pod:7439
17935 #, no-wrap
17936 msgid ""
17937 " char **\n"
17938 " guestfs_zfgrep (guestfs_h *g,\n"
17939 "                 const char *pattern,\n"
17940 "                 const char *path);\n"
17941 "\n"
17942 msgstr ""
17943
17944 #. type: textblock
17945 #: ../src/guestfs-actions.pod:7444 ../fish/guestfish-actions.pod:4978
17946 msgid "This calls the external C<zfgrep> program and returns the matching lines."
17947 msgstr ""
17948
17949 #. type: =head2
17950 #: ../src/guestfs-actions.pod:7456
17951 msgid "guestfs_zfgrepi"
17952 msgstr ""
17953
17954 #. type: verbatim
17955 #: ../src/guestfs-actions.pod:7458
17956 #, no-wrap
17957 msgid ""
17958 " char **\n"
17959 " guestfs_zfgrepi (guestfs_h *g,\n"
17960 "                  const char *pattern,\n"
17961 "                  const char *path);\n"
17962 "\n"
17963 msgstr ""
17964
17965 #. type: textblock
17966 #: ../src/guestfs-actions.pod:7463 ../fish/guestfish-actions.pod:4988
17967 msgid "This calls the external C<zfgrep -i> program and returns the matching lines."
17968 msgstr ""
17969
17970 #. type: =head2
17971 #: ../src/guestfs-actions.pod:7475
17972 msgid "guestfs_zfile"
17973 msgstr ""
17974
17975 #. type: verbatim
17976 #: ../src/guestfs-actions.pod:7477
17977 #, no-wrap
17978 msgid ""
17979 " char *\n"
17980 " guestfs_zfile (guestfs_h *g,\n"
17981 "                const char *meth,\n"
17982 "                const char *path);\n"
17983 "\n"
17984 msgstr ""
17985
17986 #. type: textblock
17987 #: ../src/guestfs-actions.pod:7482 ../fish/guestfish-actions.pod:4998
17988 msgid "This command runs C<file> after first decompressing C<path> using C<method>."
17989 msgstr ""
17990
17991 #. type: textblock
17992 #: ../src/guestfs-actions.pod:7485 ../fish/guestfish-actions.pod:5001
17993 msgid "C<method> must be one of C<gzip>, C<compress> or C<bzip2>."
17994 msgstr ""
17995
17996 #. type: textblock
17997 #: ../src/guestfs-actions.pod:7487
17998 msgid ""
17999 "Since 1.0.63, use C<guestfs_file> instead which can now process compressed "
18000 "files."
18001 msgstr ""
18002
18003 #. type: textblock
18004 #: ../src/guestfs-actions.pod:7493
18005 msgid ""
18006 "This function is deprecated.  In new code, use the L</guestfs_file> call "
18007 "instead."
18008 msgstr ""
18009
18010 #. type: =head2
18011 #: ../src/guestfs-actions.pod:7502
18012 msgid "guestfs_zgrep"
18013 msgstr ""
18014
18015 #. type: verbatim
18016 #: ../src/guestfs-actions.pod:7504
18017 #, no-wrap
18018 msgid ""
18019 " char **\n"
18020 " guestfs_zgrep (guestfs_h *g,\n"
18021 "                const char *regex,\n"
18022 "                const char *path);\n"
18023 "\n"
18024 msgstr ""
18025
18026 #. type: textblock
18027 #: ../src/guestfs-actions.pod:7509 ../fish/guestfish-actions.pod:5017
18028 msgid "This calls the external C<zgrep> program and returns the matching lines."
18029 msgstr ""
18030
18031 #. type: =head2
18032 #: ../src/guestfs-actions.pod:7521
18033 msgid "guestfs_zgrepi"
18034 msgstr ""
18035
18036 #. type: verbatim
18037 #: ../src/guestfs-actions.pod:7523
18038 #, no-wrap
18039 msgid ""
18040 " char **\n"
18041 " guestfs_zgrepi (guestfs_h *g,\n"
18042 "                 const char *regex,\n"
18043 "                 const char *path);\n"
18044 "\n"
18045 msgstr ""
18046
18047 #. type: textblock
18048 #: ../src/guestfs-actions.pod:7528 ../fish/guestfish-actions.pod:5027
18049 msgid "This calls the external C<zgrep -i> program and returns the matching lines."
18050 msgstr ""
18051
18052 #. type: =item
18053 #: ../src/guestfs-availability.pod:3
18054 msgid "B<augeas>"
18055 msgstr ""
18056
18057 #. type: textblock
18058 #: ../src/guestfs-availability.pod:5
18059 msgid ""
18060 "The following functions: L</guestfs_aug_clear> L</guestfs_aug_close> "
18061 "L</guestfs_aug_defnode> L</guestfs_aug_defvar> L</guestfs_aug_get> "
18062 "L</guestfs_aug_init> L</guestfs_aug_insert> L</guestfs_aug_load> "
18063 "L</guestfs_aug_ls> L</guestfs_aug_match> L</guestfs_aug_mv> "
18064 "L</guestfs_aug_rm> L</guestfs_aug_save> L</guestfs_aug_set>"
18065 msgstr ""
18066
18067 #. type: =item
18068 #: ../src/guestfs-availability.pod:21
18069 msgid "B<inotify>"
18070 msgstr ""
18071
18072 #. type: textblock
18073 #: ../src/guestfs-availability.pod:23
18074 msgid ""
18075 "The following functions: L</guestfs_inotify_add_watch> "
18076 "L</guestfs_inotify_close> L</guestfs_inotify_files> L</guestfs_inotify_init> "
18077 "L</guestfs_inotify_read> L</guestfs_inotify_rm_watch>"
18078 msgstr ""
18079
18080 #. type: =item
18081 #: ../src/guestfs-availability.pod:31
18082 msgid "B<linuxfsuuid>"
18083 msgstr ""
18084
18085 #. type: textblock
18086 #: ../src/guestfs-availability.pod:33
18087 msgid ""
18088 "The following functions: L</guestfs_mke2fs_JU> L</guestfs_mke2journal_U> "
18089 "L</guestfs_mkswap_U> L</guestfs_swapoff_uuid> L</guestfs_swapon_uuid>"
18090 msgstr ""
18091
18092 #. type: =item
18093 #: ../src/guestfs-availability.pod:40
18094 msgid "B<linuxmodules>"
18095 msgstr ""
18096
18097 #. type: textblock
18098 #: ../src/guestfs-availability.pod:42
18099 msgid "The following functions: L</guestfs_modprobe>"
18100 msgstr ""
18101
18102 #. type: =item
18103 #: ../src/guestfs-availability.pod:45
18104 msgid "B<linuxxattrs>"
18105 msgstr ""
18106
18107 #. type: textblock
18108 #: ../src/guestfs-availability.pod:47
18109 msgid ""
18110 "The following functions: L</guestfs_getxattr> L</guestfs_getxattrs> "
18111 "L</guestfs_lgetxattr> L</guestfs_lgetxattrs> L</guestfs_lremovexattr> "
18112 "L</guestfs_lsetxattr> L</guestfs_lxattrlist> L</guestfs_removexattr> "
18113 "L</guestfs_setxattr>"
18114 msgstr ""
18115
18116 #. type: =item
18117 #: ../src/guestfs-availability.pod:58
18118 msgid "B<luks>"
18119 msgstr ""
18120
18121 #. type: textblock
18122 #: ../src/guestfs-availability.pod:60
18123 msgid ""
18124 "The following functions: L</guestfs_luks_add_key> L</guestfs_luks_close> "
18125 "L</guestfs_luks_format> L</guestfs_luks_format_cipher> "
18126 "L</guestfs_luks_kill_slot> L</guestfs_luks_open> L</guestfs_luks_open_ro>"
18127 msgstr ""
18128
18129 #. type: =item
18130 #: ../src/guestfs-availability.pod:69
18131 msgid "B<lvm2>"
18132 msgstr ""
18133
18134 #. type: textblock
18135 #: ../src/guestfs-availability.pod:71
18136 msgid ""
18137 "The following functions: L</guestfs_is_lv> L</guestfs_lvcreate> "
18138 "L</guestfs_lvm_remove_all> L</guestfs_lvm_set_filter> L</guestfs_lvremove> "
18139 "L</guestfs_lvresize> L</guestfs_lvresize_free> L</guestfs_lvs> "
18140 "L</guestfs_lvs_full> L</guestfs_pvcreate> L</guestfs_pvremove> "
18141 "L</guestfs_pvresize> L</guestfs_pvresize_size> L</guestfs_pvs> "
18142 "L</guestfs_pvs_full> L</guestfs_vg_activate> L</guestfs_vg_activate_all> "
18143 "L</guestfs_vgcreate> L</guestfs_vgremove> L</guestfs_vgs> "
18144 "L</guestfs_vgs_full>"
18145 msgstr ""
18146
18147 #. type: =item
18148 #: ../src/guestfs-availability.pod:94
18149 msgid "B<mknod>"
18150 msgstr ""
18151
18152 #. type: textblock
18153 #: ../src/guestfs-availability.pod:96
18154 msgid ""
18155 "The following functions: L</guestfs_mkfifo> L</guestfs_mknod> "
18156 "L</guestfs_mknod_b> L</guestfs_mknod_c>"
18157 msgstr ""
18158
18159 #. type: =item
18160 #: ../src/guestfs-availability.pod:102
18161 msgid "B<ntfs3g>"
18162 msgstr ""
18163
18164 #. type: textblock
18165 #: ../src/guestfs-availability.pod:104
18166 msgid "The following functions: L</guestfs_ntfs_3g_probe>"
18167 msgstr ""
18168
18169 #. type: =item
18170 #: ../src/guestfs-availability.pod:107
18171 msgid "B<ntfsprogs>"
18172 msgstr ""
18173
18174 #. type: textblock
18175 #: ../src/guestfs-availability.pod:109
18176 msgid "The following functions: L</guestfs_ntfsresize> L</guestfs_ntfsresize_size>"
18177 msgstr ""
18178
18179 #. type: =item
18180 #: ../src/guestfs-availability.pod:113
18181 msgid "B<realpath>"
18182 msgstr ""
18183
18184 #. type: textblock
18185 #: ../src/guestfs-availability.pod:115
18186 msgid "The following functions: L</guestfs_realpath>"
18187 msgstr ""
18188
18189 #. type: =item
18190 #: ../src/guestfs-availability.pod:118
18191 msgid "B<scrub>"
18192 msgstr ""
18193
18194 #. type: textblock
18195 #: ../src/guestfs-availability.pod:120
18196 msgid ""
18197 "The following functions: L</guestfs_scrub_device> L</guestfs_scrub_file> "
18198 "L</guestfs_scrub_freespace>"
18199 msgstr ""
18200
18201 #. type: =item
18202 #: ../src/guestfs-availability.pod:125
18203 msgid "B<selinux>"
18204 msgstr ""
18205
18206 #. type: textblock
18207 #: ../src/guestfs-availability.pod:127
18208 msgid "The following functions: L</guestfs_getcon> L</guestfs_setcon>"
18209 msgstr ""
18210
18211 #. type: =item
18212 #: ../src/guestfs-availability.pod:131
18213 msgid "B<xz>"
18214 msgstr ""
18215
18216 #. type: textblock
18217 #: ../src/guestfs-availability.pod:133
18218 msgid "The following functions: L</guestfs_txz_in> L</guestfs_txz_out>"
18219 msgstr ""
18220
18221 #. type: =item
18222 #: ../src/guestfs-availability.pod:137
18223 msgid "B<zerofree>"
18224 msgstr ""
18225
18226 #. type: textblock
18227 #: ../src/guestfs-availability.pod:139
18228 msgid "The following functions: L</guestfs_zerofree>"
18229 msgstr ""
18230
18231 #. type: =head2
18232 #: ../src/guestfs-structs.pod:1
18233 msgid "guestfs_int_bool"
18234 msgstr ""
18235
18236 #. type: verbatim
18237 #: ../src/guestfs-structs.pod:3
18238 #, no-wrap
18239 msgid ""
18240 " struct guestfs_int_bool {\n"
18241 "   int32_t i;\n"
18242 "   int32_t b;\n"
18243 " };\n"
18244 " \n"
18245 msgstr ""
18246
18247 #. type: verbatim
18248 #: ../src/guestfs-structs.pod:8
18249 #, no-wrap
18250 msgid ""
18251 " struct guestfs_int_bool_list {\n"
18252 "   uint32_t len; /* Number of elements in list. */\n"
18253 "   struct guestfs_int_bool *val; /* Elements. */\n"
18254 " };\n"
18255 " \n"
18256 msgstr ""
18257
18258 #. type: verbatim
18259 #: ../src/guestfs-structs.pod:13
18260 #, no-wrap
18261 msgid ""
18262 " void guestfs_free_int_bool (struct guestfs_free_int_bool *);\n"
18263 " void guestfs_free_int_bool_list (struct guestfs_free_int_bool_list *);\n"
18264 "\n"
18265 msgstr ""
18266
18267 #. type: =head2
18268 #: ../src/guestfs-structs.pod:16
18269 msgid "guestfs_lvm_pv"
18270 msgstr ""
18271
18272 #. type: verbatim
18273 #: ../src/guestfs-structs.pod:18
18274 #, no-wrap
18275 msgid ""
18276 " struct guestfs_lvm_pv {\n"
18277 "   char *pv_name;\n"
18278 "   /* The next field is NOT nul-terminated, be careful when printing it: "
18279 "*/\n"
18280 "   char pv_uuid[32];\n"
18281 "   char *pv_fmt;\n"
18282 "   uint64_t pv_size;\n"
18283 "   uint64_t dev_size;\n"
18284 "   uint64_t pv_free;\n"
18285 "   uint64_t pv_used;\n"
18286 "   char *pv_attr;\n"
18287 "   int64_t pv_pe_count;\n"
18288 "   int64_t pv_pe_alloc_count;\n"
18289 "   char *pv_tags;\n"
18290 "   uint64_t pe_start;\n"
18291 "   int64_t pv_mda_count;\n"
18292 "   uint64_t pv_mda_free;\n"
18293 " };\n"
18294 " \n"
18295 msgstr ""
18296
18297 #. type: verbatim
18298 #: ../src/guestfs-structs.pod:36
18299 #, no-wrap
18300 msgid ""
18301 " struct guestfs_lvm_pv_list {\n"
18302 "   uint32_t len; /* Number of elements in list. */\n"
18303 "   struct guestfs_lvm_pv *val; /* Elements. */\n"
18304 " };\n"
18305 " \n"
18306 msgstr ""
18307
18308 #. type: verbatim
18309 #: ../src/guestfs-structs.pod:41
18310 #, no-wrap
18311 msgid ""
18312 " void guestfs_free_lvm_pv (struct guestfs_free_lvm_pv *);\n"
18313 " void guestfs_free_lvm_pv_list (struct guestfs_free_lvm_pv_list *);\n"
18314 "\n"
18315 msgstr ""
18316
18317 #. type: =head2
18318 #: ../src/guestfs-structs.pod:44
18319 msgid "guestfs_lvm_vg"
18320 msgstr ""
18321
18322 #. type: verbatim
18323 #: ../src/guestfs-structs.pod:46
18324 #, no-wrap
18325 msgid ""
18326 " struct guestfs_lvm_vg {\n"
18327 "   char *vg_name;\n"
18328 "   /* The next field is NOT nul-terminated, be careful when printing it: "
18329 "*/\n"
18330 "   char vg_uuid[32];\n"
18331 "   char *vg_fmt;\n"
18332 "   char *vg_attr;\n"
18333 "   uint64_t vg_size;\n"
18334 "   uint64_t vg_free;\n"
18335 "   char *vg_sysid;\n"
18336 "   uint64_t vg_extent_size;\n"
18337 "   int64_t vg_extent_count;\n"
18338 "   int64_t vg_free_count;\n"
18339 "   int64_t max_lv;\n"
18340 "   int64_t max_pv;\n"
18341 "   int64_t pv_count;\n"
18342 "   int64_t lv_count;\n"
18343 "   int64_t snap_count;\n"
18344 "   int64_t vg_seqno;\n"
18345 "   char *vg_tags;\n"
18346 "   int64_t vg_mda_count;\n"
18347 "   uint64_t vg_mda_free;\n"
18348 " };\n"
18349 " \n"
18350 msgstr ""
18351
18352 #. type: verbatim
18353 #: ../src/guestfs-structs.pod:69
18354 #, no-wrap
18355 msgid ""
18356 " struct guestfs_lvm_vg_list {\n"
18357 "   uint32_t len; /* Number of elements in list. */\n"
18358 "   struct guestfs_lvm_vg *val; /* Elements. */\n"
18359 " };\n"
18360 " \n"
18361 msgstr ""
18362
18363 #. type: verbatim
18364 #: ../src/guestfs-structs.pod:74
18365 #, no-wrap
18366 msgid ""
18367 " void guestfs_free_lvm_vg (struct guestfs_free_lvm_vg *);\n"
18368 " void guestfs_free_lvm_vg_list (struct guestfs_free_lvm_vg_list *);\n"
18369 "\n"
18370 msgstr ""
18371
18372 #. type: =head2
18373 #: ../src/guestfs-structs.pod:77
18374 msgid "guestfs_lvm_lv"
18375 msgstr ""
18376
18377 #. type: verbatim
18378 #: ../src/guestfs-structs.pod:79
18379 #, no-wrap
18380 msgid ""
18381 " struct guestfs_lvm_lv {\n"
18382 "   char *lv_name;\n"
18383 "   /* The next field is NOT nul-terminated, be careful when printing it: "
18384 "*/\n"
18385 "   char lv_uuid[32];\n"
18386 "   char *lv_attr;\n"
18387 "   int64_t lv_major;\n"
18388 "   int64_t lv_minor;\n"
18389 "   int64_t lv_kernel_major;\n"
18390 "   int64_t lv_kernel_minor;\n"
18391 "   uint64_t lv_size;\n"
18392 "   int64_t seg_count;\n"
18393 "   char *origin;\n"
18394 "   /* The next field is [0..100] or -1 meaning 'not present': */\n"
18395 "   float snap_percent;\n"
18396 "   /* The next field is [0..100] or -1 meaning 'not present': */\n"
18397 "   float copy_percent;\n"
18398 "   char *move_pv;\n"
18399 "   char *lv_tags;\n"
18400 "   char *mirror_log;\n"
18401 "   char *modules;\n"
18402 " };\n"
18403 " \n"
18404 msgstr ""
18405
18406 #. type: verbatim
18407 #: ../src/guestfs-structs.pod:101
18408 #, no-wrap
18409 msgid ""
18410 " struct guestfs_lvm_lv_list {\n"
18411 "   uint32_t len; /* Number of elements in list. */\n"
18412 "   struct guestfs_lvm_lv *val; /* Elements. */\n"
18413 " };\n"
18414 " \n"
18415 msgstr ""
18416
18417 #. type: verbatim
18418 #: ../src/guestfs-structs.pod:106
18419 #, no-wrap
18420 msgid ""
18421 " void guestfs_free_lvm_lv (struct guestfs_free_lvm_lv *);\n"
18422 " void guestfs_free_lvm_lv_list (struct guestfs_free_lvm_lv_list *);\n"
18423 "\n"
18424 msgstr ""
18425
18426 #. type: verbatim
18427 #: ../src/guestfs-structs.pod:111
18428 #, no-wrap
18429 msgid ""
18430 " struct guestfs_stat {\n"
18431 "   int64_t dev;\n"
18432 "   int64_t ino;\n"
18433 "   int64_t mode;\n"
18434 "   int64_t nlink;\n"
18435 "   int64_t uid;\n"
18436 "   int64_t gid;\n"
18437 "   int64_t rdev;\n"
18438 "   int64_t size;\n"
18439 "   int64_t blksize;\n"
18440 "   int64_t blocks;\n"
18441 "   int64_t atime;\n"
18442 "   int64_t mtime;\n"
18443 "   int64_t ctime;\n"
18444 " };\n"
18445 " \n"
18446 msgstr ""
18447
18448 #. type: verbatim
18449 #: ../src/guestfs-structs.pod:127
18450 #, no-wrap
18451 msgid ""
18452 " struct guestfs_stat_list {\n"
18453 "   uint32_t len; /* Number of elements in list. */\n"
18454 "   struct guestfs_stat *val; /* Elements. */\n"
18455 " };\n"
18456 " \n"
18457 msgstr ""
18458
18459 #. type: verbatim
18460 #: ../src/guestfs-structs.pod:132
18461 #, no-wrap
18462 msgid ""
18463 " void guestfs_free_stat (struct guestfs_free_stat *);\n"
18464 " void guestfs_free_stat_list (struct guestfs_free_stat_list *);\n"
18465 "\n"
18466 msgstr ""
18467
18468 #. type: verbatim
18469 #: ../src/guestfs-structs.pod:137
18470 #, no-wrap
18471 msgid ""
18472 " struct guestfs_statvfs {\n"
18473 "   int64_t bsize;\n"
18474 "   int64_t frsize;\n"
18475 "   int64_t blocks;\n"
18476 "   int64_t bfree;\n"
18477 "   int64_t bavail;\n"
18478 "   int64_t files;\n"
18479 "   int64_t ffree;\n"
18480 "   int64_t favail;\n"
18481 "   int64_t fsid;\n"
18482 "   int64_t flag;\n"
18483 "   int64_t namemax;\n"
18484 " };\n"
18485 " \n"
18486 msgstr ""
18487
18488 #. type: verbatim
18489 #: ../src/guestfs-structs.pod:151
18490 #, no-wrap
18491 msgid ""
18492 " struct guestfs_statvfs_list {\n"
18493 "   uint32_t len; /* Number of elements in list. */\n"
18494 "   struct guestfs_statvfs *val; /* Elements. */\n"
18495 " };\n"
18496 " \n"
18497 msgstr ""
18498
18499 #. type: verbatim
18500 #: ../src/guestfs-structs.pod:156
18501 #, no-wrap
18502 msgid ""
18503 " void guestfs_free_statvfs (struct guestfs_free_statvfs *);\n"
18504 " void guestfs_free_statvfs_list (struct guestfs_free_statvfs_list *);\n"
18505 "\n"
18506 msgstr ""
18507
18508 #. type: =head2
18509 #: ../src/guestfs-structs.pod:159
18510 msgid "guestfs_dirent"
18511 msgstr ""
18512
18513 #. type: verbatim
18514 #: ../src/guestfs-structs.pod:161
18515 #, no-wrap
18516 msgid ""
18517 " struct guestfs_dirent {\n"
18518 "   int64_t ino;\n"
18519 "   char ftyp;\n"
18520 "   char *name;\n"
18521 " };\n"
18522 " \n"
18523 msgstr ""
18524
18525 #. type: verbatim
18526 #: ../src/guestfs-structs.pod:167
18527 #, no-wrap
18528 msgid ""
18529 " struct guestfs_dirent_list {\n"
18530 "   uint32_t len; /* Number of elements in list. */\n"
18531 "   struct guestfs_dirent *val; /* Elements. */\n"
18532 " };\n"
18533 " \n"
18534 msgstr ""
18535
18536 #. type: verbatim
18537 #: ../src/guestfs-structs.pod:172
18538 #, no-wrap
18539 msgid ""
18540 " void guestfs_free_dirent (struct guestfs_free_dirent *);\n"
18541 " void guestfs_free_dirent_list (struct guestfs_free_dirent_list *);\n"
18542 "\n"
18543 msgstr ""
18544
18545 #. type: verbatim
18546 #: ../src/guestfs-structs.pod:177
18547 #, no-wrap
18548 msgid ""
18549 " struct guestfs_version {\n"
18550 "   int64_t major;\n"
18551 "   int64_t minor;\n"
18552 "   int64_t release;\n"
18553 "   char *extra;\n"
18554 " };\n"
18555 " \n"
18556 msgstr ""
18557
18558 #. type: verbatim
18559 #: ../src/guestfs-structs.pod:184
18560 #, no-wrap
18561 msgid ""
18562 " struct guestfs_version_list {\n"
18563 "   uint32_t len; /* Number of elements in list. */\n"
18564 "   struct guestfs_version *val; /* Elements. */\n"
18565 " };\n"
18566 " \n"
18567 msgstr ""
18568
18569 #. type: verbatim
18570 #: ../src/guestfs-structs.pod:189
18571 #, no-wrap
18572 msgid ""
18573 " void guestfs_free_version (struct guestfs_free_version *);\n"
18574 " void guestfs_free_version_list (struct guestfs_free_version_list *);\n"
18575 "\n"
18576 msgstr ""
18577
18578 #. type: =head2
18579 #: ../src/guestfs-structs.pod:192
18580 msgid "guestfs_xattr"
18581 msgstr ""
18582
18583 #. type: verbatim
18584 #: ../src/guestfs-structs.pod:194
18585 #, no-wrap
18586 msgid ""
18587 " struct guestfs_xattr {\n"
18588 "   char *attrname;\n"
18589 "   /* The next two fields describe a byte array. */\n"
18590 "   uint32_t attrval_len;\n"
18591 "   char *attrval;\n"
18592 " };\n"
18593 " \n"
18594 msgstr ""
18595
18596 #. type: verbatim
18597 #: ../src/guestfs-structs.pod:201
18598 #, no-wrap
18599 msgid ""
18600 " struct guestfs_xattr_list {\n"
18601 "   uint32_t len; /* Number of elements in list. */\n"
18602 "   struct guestfs_xattr *val; /* Elements. */\n"
18603 " };\n"
18604 " \n"
18605 msgstr ""
18606
18607 #. type: verbatim
18608 #: ../src/guestfs-structs.pod:206
18609 #, no-wrap
18610 msgid ""
18611 " void guestfs_free_xattr (struct guestfs_free_xattr *);\n"
18612 " void guestfs_free_xattr_list (struct guestfs_free_xattr_list *);\n"
18613 "\n"
18614 msgstr ""
18615
18616 #. type: =head2
18617 #: ../src/guestfs-structs.pod:209
18618 msgid "guestfs_inotify_event"
18619 msgstr ""
18620
18621 #. type: verbatim
18622 #: ../src/guestfs-structs.pod:211
18623 #, no-wrap
18624 msgid ""
18625 " struct guestfs_inotify_event {\n"
18626 "   int64_t in_wd;\n"
18627 "   uint32_t in_mask;\n"
18628 "   uint32_t in_cookie;\n"
18629 "   char *in_name;\n"
18630 " };\n"
18631 " \n"
18632 msgstr ""
18633
18634 #. type: verbatim
18635 #: ../src/guestfs-structs.pod:218
18636 #, no-wrap
18637 msgid ""
18638 " struct guestfs_inotify_event_list {\n"
18639 "   uint32_t len; /* Number of elements in list. */\n"
18640 "   struct guestfs_inotify_event *val; /* Elements. */\n"
18641 " };\n"
18642 " \n"
18643 msgstr ""
18644
18645 #. type: verbatim
18646 #: ../src/guestfs-structs.pod:223
18647 #, no-wrap
18648 msgid ""
18649 " void guestfs_free_inotify_event (struct guestfs_free_inotify_event *);\n"
18650 " void guestfs_free_inotify_event_list (struct "
18651 "guestfs_free_inotify_event_list *);\n"
18652 "\n"
18653 msgstr ""
18654
18655 #. type: =head2
18656 #: ../src/guestfs-structs.pod:226
18657 msgid "guestfs_partition"
18658 msgstr ""
18659
18660 #. type: verbatim
18661 #: ../src/guestfs-structs.pod:228
18662 #, no-wrap
18663 msgid ""
18664 " struct guestfs_partition {\n"
18665 "   int32_t part_num;\n"
18666 "   uint64_t part_start;\n"
18667 "   uint64_t part_end;\n"
18668 "   uint64_t part_size;\n"
18669 " };\n"
18670 " \n"
18671 msgstr ""
18672
18673 #. type: verbatim
18674 #: ../src/guestfs-structs.pod:235
18675 #, no-wrap
18676 msgid ""
18677 " struct guestfs_partition_list {\n"
18678 "   uint32_t len; /* Number of elements in list. */\n"
18679 "   struct guestfs_partition *val; /* Elements. */\n"
18680 " };\n"
18681 " \n"
18682 msgstr ""
18683
18684 #. type: verbatim
18685 #: ../src/guestfs-structs.pod:240
18686 #, no-wrap
18687 msgid ""
18688 " void guestfs_free_partition (struct guestfs_free_partition *);\n"
18689 " void guestfs_free_partition_list (struct guestfs_free_partition_list *);\n"
18690 "\n"
18691 msgstr ""
18692
18693 #. type: =head2
18694 #: ../src/guestfs-structs.pod:243
18695 msgid "guestfs_application"
18696 msgstr ""
18697
18698 #. type: verbatim
18699 #: ../src/guestfs-structs.pod:245
18700 #, no-wrap
18701 msgid ""
18702 " struct guestfs_application {\n"
18703 "   char *app_name;\n"
18704 "   char *app_display_name;\n"
18705 "   int32_t app_epoch;\n"
18706 "   char *app_version;\n"
18707 "   char *app_release;\n"
18708 "   char *app_install_path;\n"
18709 "   char *app_trans_path;\n"
18710 "   char *app_publisher;\n"
18711 "   char *app_url;\n"
18712 "   char *app_source_package;\n"
18713 "   char *app_summary;\n"
18714 "   char *app_description;\n"
18715 " };\n"
18716 " \n"
18717 msgstr ""
18718
18719 #. type: verbatim
18720 #: ../src/guestfs-structs.pod:260
18721 #, no-wrap
18722 msgid ""
18723 " struct guestfs_application_list {\n"
18724 "   uint32_t len; /* Number of elements in list. */\n"
18725 "   struct guestfs_application *val; /* Elements. */\n"
18726 " };\n"
18727 " \n"
18728 msgstr ""
18729
18730 #. type: verbatim
18731 #: ../src/guestfs-structs.pod:265
18732 #, no-wrap
18733 msgid ""
18734 " void guestfs_free_application (struct guestfs_free_application *);\n"
18735 " void guestfs_free_application_list (struct guestfs_free_application_list "
18736 "*);\n"
18737 "\n"
18738 msgstr ""
18739
18740 #. type: textblock
18741 #: ../fish/guestfish.pod:5
18742 msgid "guestfish - the libguestfs Filesystem Interactive SHell"
18743 msgstr ""
18744
18745 #. type: verbatim
18746 #: ../fish/guestfish.pod:9
18747 #, no-wrap
18748 msgid ""
18749 " guestfish [--options] [commands]\n"
18750 "\n"
18751 msgstr ""
18752
18753 #. type: verbatim
18754 #: ../fish/guestfish.pod:11
18755 #, no-wrap
18756 msgid ""
18757 " guestfish\n"
18758 "\n"
18759 msgstr ""
18760
18761 #. type: verbatim
18762 #: ../fish/guestfish.pod:13
18763 #, no-wrap
18764 msgid ""
18765 " guestfish [--ro|--rw] -a disk.img\n"
18766 "\n"
18767 msgstr ""
18768
18769 #. type: verbatim
18770 #: ../fish/guestfish.pod:15
18771 #, no-wrap
18772 msgid ""
18773 " guestfish [--ro|--rw] -a disk.img -m dev[:mountpoint]\n"
18774 "\n"
18775 msgstr ""
18776
18777 #. type: verbatim
18778 #: ../fish/guestfish.pod:17
18779 #, no-wrap
18780 msgid ""
18781 " guestfish -d libvirt-domain\n"
18782 "\n"
18783 msgstr ""
18784
18785 #. type: verbatim
18786 #: ../fish/guestfish.pod:19
18787 #, no-wrap
18788 msgid ""
18789 " guestfish [--ro|--rw] -a disk.img -i\n"
18790 "\n"
18791 msgstr ""
18792
18793 #. type: verbatim
18794 #: ../fish/guestfish.pod:21
18795 #, no-wrap
18796 msgid ""
18797 " guestfish -d libvirt-domain -i\n"
18798 "\n"
18799 msgstr ""
18800
18801 #. type: =head1
18802 #: ../fish/guestfish.pod:23 ../fuse/guestmount.pod:15 ../tools/virt-edit.pl:44 ../tools/virt-win-reg.pl:51 ../tools/virt-tar.pl:64
18803 msgid "WARNING"
18804 msgstr ""
18805
18806 #. type: textblock
18807 #: ../fish/guestfish.pod:25
18808 msgid ""
18809 "Using guestfish in read/write mode on live virtual machines can be "
18810 "dangerous, potentially causing disk corruption.  Use the I<--ro> (read-only) "
18811 "option to use guestfish safely if the disk image or virtual machine might be "
18812 "live."
18813 msgstr ""
18814
18815 #. type: textblock
18816 #: ../fish/guestfish.pod:32
18817 msgid ""
18818 "Guestfish is a shell and command-line tool for examining and modifying "
18819 "virtual machine filesystems.  It uses libguestfs and exposes all of the "
18820 "functionality of the guestfs API, see L<guestfs(3)>."
18821 msgstr ""
18822
18823 #. type: textblock
18824 #: ../fish/guestfish.pod:36
18825 msgid ""
18826 "Guestfish gives you structured access to the libguestfs API, from shell "
18827 "scripts or the command line or interactively.  If you want to rescue a "
18828 "broken virtual machine image, you should look at the L<virt-rescue(1)> "
18829 "command."
18830 msgstr ""
18831
18832 #. type: =head1
18833 #: ../fish/guestfish.pod:41 ../fish/guestfish.pod:958 ../fuse/guestmount.pod:39 ../tools/virt-edit.pl:63 ../tools/virt-tar.pl:50
18834 msgid "EXAMPLES"
18835 msgstr ""
18836
18837 #. type: =head2
18838 #: ../fish/guestfish.pod:43
18839 msgid "As an interactive shell"
18840 msgstr ""
18841
18842 #. type: verbatim
18843 #: ../fish/guestfish.pod:45
18844 #, no-wrap
18845 msgid ""
18846 " $ guestfish\n"
18847 " \n"
18848 msgstr ""
18849
18850 #. type: verbatim
18851 #: ../fish/guestfish.pod:47
18852 #, no-wrap
18853 msgid ""
18854 " Welcome to guestfish, the libguestfs filesystem interactive shell for\n"
18855 " editing virtual machine filesystems.\n"
18856 " \n"
18857 msgstr ""
18858
18859 #. type: verbatim
18860 #: ../fish/guestfish.pod:50
18861 #, no-wrap
18862 msgid ""
18863 " Type: 'help' for a list of commands\n"
18864 "       'man' to read the manual\n"
18865 "       'quit' to quit the shell\n"
18866 " \n"
18867 msgstr ""
18868
18869 #. type: verbatim
18870 #: ../fish/guestfish.pod:54
18871 #, no-wrap
18872 msgid ""
18873 " ><fs> add-ro disk.img\n"
18874 " ><fs> run\n"
18875 " ><fs> list-filesystems\n"
18876 " /dev/sda1: ext4\n"
18877 " /dev/vg_guest/lv_root: ext4\n"
18878 " /dev/vg_guest/lv_swap: swap\n"
18879 " ><fs> mount /dev/vg_guest/lv_root /\n"
18880 " ><fs> cat /etc/fstab\n"
18881 " # /etc/fstab\n"
18882 " # Created by anaconda\n"
18883 " [...]\n"
18884 " ><fs> exit\n"
18885 "\n"
18886 msgstr ""
18887
18888 #. type: =head2
18889 #: ../fish/guestfish.pod:67
18890 msgid "From shell scripts"
18891 msgstr ""
18892
18893 #. type: textblock
18894 #: ../fish/guestfish.pod:69
18895 msgid "Create a new C</etc/motd> file in a guest or disk image:"
18896 msgstr ""
18897
18898 #. type: verbatim
18899 #: ../fish/guestfish.pod:71
18900 #, no-wrap
18901 msgid ""
18902 " guestfish <<_EOF_\n"
18903 " add disk.img\n"
18904 " run\n"
18905 " mount /dev/vg_guest/lv_root /\n"
18906 " write /etc/motd \"Welcome, new users\"\n"
18907 " _EOF_\n"
18908 "\n"
18909 msgstr ""
18910
18911 #. type: textblock
18912 #: ../fish/guestfish.pod:78
18913 msgid "List the LVM logical volumes in a disk image:"
18914 msgstr ""
18915
18916 #. type: verbatim
18917 #: ../fish/guestfish.pod:80
18918 #, no-wrap
18919 msgid ""
18920 " guestfish -a disk.img --ro <<_EOF_\n"
18921 " run\n"
18922 " lvs\n"
18923 " _EOF_\n"
18924 "\n"
18925 msgstr ""
18926
18927 #. type: textblock
18928 #: ../fish/guestfish.pod:85
18929 msgid "List all the filesystems in a disk image:"
18930 msgstr ""
18931
18932 #. type: verbatim
18933 #: ../fish/guestfish.pod:87
18934 #, no-wrap
18935 msgid ""
18936 " guestfish -a disk.img --ro <<_EOF_\n"
18937 " run\n"
18938 " list-filesystems\n"
18939 " _EOF_\n"
18940 "\n"
18941 msgstr ""
18942
18943 #. type: =head2
18944 #: ../fish/guestfish.pod:92
18945 msgid "On one command line"
18946 msgstr ""
18947
18948 #. type: textblock
18949 #: ../fish/guestfish.pod:94
18950 msgid "Update C</etc/resolv.conf> in a guest:"
18951 msgstr ""
18952
18953 #. type: verbatim
18954 #: ../fish/guestfish.pod:96
18955 #, no-wrap
18956 msgid ""
18957 " guestfish \\\n"
18958 "   add disk.img : run : mount /dev/vg_guest/lv_root / : \\\n"
18959 "   write /etc/resolv.conf \"nameserver 1.2.3.4\"\n"
18960 "\n"
18961 msgstr ""
18962
18963 #. type: textblock
18964 #: ../fish/guestfish.pod:100
18965 msgid "Edit C</boot/grub/grub.conf> interactively:"
18966 msgstr ""
18967
18968 #. type: verbatim
18969 #: ../fish/guestfish.pod:102
18970 #, no-wrap
18971 msgid ""
18972 " guestfish --rw --add disk.img \\\n"
18973 "   --mount /dev/vg_guest/lv_root \\\n"
18974 "   --mount /dev/sda1:/boot \\\n"
18975 "   edit /boot/grub/grub.conf\n"
18976 "\n"
18977 msgstr ""
18978
18979 #. type: =head2
18980 #: ../fish/guestfish.pod:107
18981 msgid "Mount disks automatically"
18982 msgstr ""
18983
18984 #. type: textblock
18985 #: ../fish/guestfish.pod:109
18986 msgid ""
18987 "Use the I<-i> option to automatically mount the disks from a virtual "
18988 "machine:"
18989 msgstr ""
18990
18991 #. type: verbatim
18992 #: ../fish/guestfish.pod:112
18993 #, no-wrap
18994 msgid ""
18995 " guestfish --ro -a disk.img -i cat /etc/group\n"
18996 "\n"
18997 msgstr ""
18998
18999 #. type: verbatim
19000 #: ../fish/guestfish.pod:114
19001 #, no-wrap
19002 msgid ""
19003 " guestfish --ro -d libvirt-domain -i cat /etc/group\n"
19004 "\n"
19005 msgstr ""
19006
19007 #. type: textblock
19008 #: ../fish/guestfish.pod:116
19009 msgid "Another way to edit C</boot/grub/grub.conf> interactively is:"
19010 msgstr ""
19011
19012 #. type: verbatim
19013 #: ../fish/guestfish.pod:118
19014 #, no-wrap
19015 msgid ""
19016 " guestfish --rw -a disk.img -i edit /boot/grub/grub.conf\n"
19017 "\n"
19018 msgstr ""
19019
19020 #. type: =head2
19021 #: ../fish/guestfish.pod:120
19022 msgid "As a script interpreter"
19023 msgstr ""
19024
19025 #. type: textblock
19026 #: ../fish/guestfish.pod:122
19027 msgid "Create a 100MB disk containing an ext2-formatted partition:"
19028 msgstr ""
19029
19030 #. type: verbatim
19031 #: ../fish/guestfish.pod:124
19032 #, no-wrap
19033 msgid ""
19034 " #!/usr/bin/guestfish -f\n"
19035 " sparse test1.img 100M\n"
19036 " run\n"
19037 " part-disk /dev/sda mbr\n"
19038 " mkfs ext2 /dev/sda1\n"
19039 "\n"
19040 msgstr ""
19041
19042 #. type: =head2
19043 #: ../fish/guestfish.pod:130
19044 msgid "Start with a prepared disk"
19045 msgstr ""
19046
19047 #. type: textblock
19048 #: ../fish/guestfish.pod:132
19049 msgid ""
19050 "An alternate way to create a 100MB disk called C<test1.img> containing a "
19051 "single ext2-formatted partition:"
19052 msgstr ""
19053
19054 #. type: verbatim
19055 #: ../fish/guestfish.pod:135
19056 #, no-wrap
19057 msgid ""
19058 " guestfish -N fs\n"
19059 "\n"
19060 msgstr ""
19061
19062 #. type: textblock
19063 #: ../fish/guestfish.pod:137
19064 msgid "To list what is available do:"
19065 msgstr ""
19066
19067 #. type: verbatim
19068 #: ../fish/guestfish.pod:139 ../fish/guestfish.pod:949
19069 #, no-wrap
19070 msgid ""
19071 " guestfish -N help | less\n"
19072 "\n"
19073 msgstr ""
19074
19075 #. type: =head2
19076 #: ../fish/guestfish.pod:141
19077 msgid "Remote control"
19078 msgstr ""
19079
19080 #. type: verbatim
19081 #: ../fish/guestfish.pod:143
19082 #, no-wrap
19083 msgid ""
19084 " eval \"`guestfish --listen`\"\n"
19085 " guestfish --remote add-ro disk.img\n"
19086 " guestfish --remote run\n"
19087 " guestfish --remote lvs\n"
19088 "\n"
19089 msgstr ""
19090
19091 #. type: =head1
19092 #: ../fish/guestfish.pod:148 ../test-tool/libguestfs-test-tool.pod:37 ../fuse/guestmount.pod:83 ../tools/virt-edit.pl:81 ../tools/virt-win-reg.pl:96 ../tools/virt-list-filesystems.pl:53 ../tools/virt-tar.pl:103 ../tools/virt-make-fs.pl:153 ../tools/virt-list-partitions.pl:54
19093 msgid "OPTIONS"
19094 msgstr ""
19095
19096 #. type: =item
19097 #: ../fish/guestfish.pod:152 ../fuse/guestmount.pod:141 ../tools/virt-edit.pl:89 ../tools/virt-win-reg.pl:104 ../tools/virt-list-filesystems.pl:61 ../tools/virt-tar.pl:111 ../tools/virt-make-fs.pl:161 ../tools/virt-list-partitions.pl:62
19098 msgid "B<--help>"
19099 msgstr ""
19100
19101 #. type: textblock
19102 #: ../fish/guestfish.pod:154
19103 msgid "Displays general help on options."
19104 msgstr ""
19105
19106 #. type: =item
19107 #: ../fish/guestfish.pod:156
19108 msgid "B<-h>"
19109 msgstr ""
19110
19111 #. type: =item
19112 #: ../fish/guestfish.pod:158
19113 msgid "B<--cmd-help>"
19114 msgstr ""
19115
19116 #. type: textblock
19117 #: ../fish/guestfish.pod:160
19118 msgid "Lists all available guestfish commands."
19119 msgstr ""
19120
19121 #. type: =item
19122 #: ../fish/guestfish.pod:162
19123 msgid "B<-h cmd>"
19124 msgstr ""
19125
19126 #. type: =item
19127 #: ../fish/guestfish.pod:164
19128 msgid "B<--cmd-help cmd>"
19129 msgstr ""
19130
19131 #. type: textblock
19132 #: ../fish/guestfish.pod:166
19133 msgid "Displays detailed help on a single command C<cmd>."
19134 msgstr ""
19135
19136 #. type: =item
19137 #: ../fish/guestfish.pod:168
19138 msgid "B<-a image>"
19139 msgstr ""
19140
19141 #. type: =item
19142 #: ../fish/guestfish.pod:170
19143 msgid "B<--add image>"
19144 msgstr ""
19145
19146 #. type: textblock
19147 #: ../fish/guestfish.pod:172
19148 msgid "Add a block device or virtual machine image to the shell."
19149 msgstr ""
19150
19151 #. type: textblock
19152 #: ../fish/guestfish.pod:174 ../fuse/guestmount.pod:91
19153 msgid ""
19154 "The format of the disk image is auto-detected.  To override this and force a "
19155 "particular format use the I<--format=..> option."
19156 msgstr ""
19157
19158 #. type: textblock
19159 #: ../fish/guestfish.pod:177
19160 msgid ""
19161 "Using this flag is mostly equivalent to using the C<add> command, with "
19162 "C<readonly:true> if the I<--ro> flag was given, and with C<format:...> if "
19163 "the I<--format=...> flag was given."
19164 msgstr ""
19165
19166 #. type: =item
19167 #: ../fish/guestfish.pod:181
19168 msgid "B<-c URI>"
19169 msgstr ""
19170
19171 #. type: =item
19172 #: ../fish/guestfish.pod:183
19173 msgid "B<--connect URI>"
19174 msgstr ""
19175
19176 #. type: textblock
19177 #: ../fish/guestfish.pod:185 ../fuse/guestmount.pod:96
19178 msgid ""
19179 "When used in conjunction with the I<-d> option, this specifies the libvirt "
19180 "URI to use.  The default is to use the default libvirt connection."
19181 msgstr ""
19182
19183 #. type: =item
19184 #: ../fish/guestfish.pod:189
19185 msgid "B<--csh>"
19186 msgstr ""
19187
19188 #. type: textblock
19189 #: ../fish/guestfish.pod:191
19190 msgid ""
19191 "If using the I<--listen> option and a csh-like shell, use this option.  See "
19192 "section L</REMOTE CONTROL AND CSH> below."
19193 msgstr ""
19194
19195 #. type: =item
19196 #: ../fish/guestfish.pod:194
19197 msgid "B<-d libvirt-domain>"
19198 msgstr ""
19199
19200 #. type: =item
19201 #: ../fish/guestfish.pod:196
19202 msgid "B<--domain libvirt-domain>"
19203 msgstr ""
19204
19205 #. type: textblock
19206 #: ../fish/guestfish.pod:198 ../fuse/guestmount.pod:102
19207 msgid ""
19208 "Add disks from the named libvirt domain.  If the I<--ro> option is also "
19209 "used, then any libvirt domain can be used.  However in write mode, only "
19210 "libvirt domains which are shut down can be named here."
19211 msgstr ""
19212
19213 #. type: textblock
19214 #: ../fish/guestfish.pod:202
19215 msgid ""
19216 "Using this flag is mostly equivalent to using the C<add-domain> command, "
19217 "with C<readonly:true> if the I<--ro> flag was given, and with C<format:...> "
19218 "if the I<--format:...> flag was given."
19219 msgstr ""
19220
19221 #. type: =item
19222 #: ../fish/guestfish.pod:206
19223 msgid "B<-D>"
19224 msgstr ""
19225
19226 #. type: =item
19227 #: ../fish/guestfish.pod:208
19228 msgid "B<--no-dest-paths>"
19229 msgstr ""
19230
19231 #. type: textblock
19232 #: ../fish/guestfish.pod:210
19233 msgid ""
19234 "Don't tab-complete paths on the guest filesystem.  It is useful to be able "
19235 "to hit the tab key to complete paths on the guest filesystem, but this "
19236 "causes extra \"hidden\" guestfs calls to be made, so this option is here to "
19237 "allow this feature to be disabled."
19238 msgstr ""
19239
19240 #. type: =item
19241 #: ../fish/guestfish.pod:215 ../fuse/guestmount.pod:118
19242 msgid "B<--echo-keys>"
19243 msgstr ""
19244
19245 #. type: textblock
19246 #: ../fish/guestfish.pod:217 ../fuse/guestmount.pod:120
19247 msgid ""
19248 "When prompting for keys and passphrases, guestfish normally turns echoing "
19249 "off so you cannot see what you are typing.  If you are not worried about "
19250 "Tempest attacks and there is no one else in the room you can specify this "
19251 "flag to see what you are typing."
19252 msgstr ""
19253
19254 #. type: =item
19255 #: ../fish/guestfish.pod:222
19256 msgid "B<-f file>"
19257 msgstr ""
19258
19259 #. type: =item
19260 #: ../fish/guestfish.pod:224
19261 msgid "B<--file file>"
19262 msgstr ""
19263
19264 #. type: textblock
19265 #: ../fish/guestfish.pod:226
19266 msgid "Read commands from C<file>.  To write pure guestfish scripts, use:"
19267 msgstr ""
19268
19269 #. type: verbatim
19270 #: ../fish/guestfish.pod:229
19271 #, no-wrap
19272 msgid ""
19273 " #!/usr/bin/guestfish -f\n"
19274 "\n"
19275 msgstr ""
19276
19277 #. type: =item
19278 #: ../fish/guestfish.pod:231
19279 msgid "B<--format=raw|qcow2|..>"
19280 msgstr ""
19281
19282 #. type: =item
19283 #: ../fish/guestfish.pod:233
19284 msgid "B<--format>"
19285 msgstr ""
19286
19287 #. type: textblock
19288 #: ../fish/guestfish.pod:235 ../fuse/guestmount.pod:127
19289 msgid ""
19290 "The default for the I<-a> option is to auto-detect the format of the disk "
19291 "image.  Using this forces the disk format for I<-a> options which follow on "
19292 "the command line.  Using I<--format> with no argument switches back to "
19293 "auto-detection for subsequent I<-a> options."
19294 msgstr ""
19295
19296 #. type: verbatim
19297 #: ../fish/guestfish.pod:242
19298 #, no-wrap
19299 msgid ""
19300 " guestfish --format=raw -a disk.img\n"
19301 "\n"
19302 msgstr ""
19303
19304 #. type: textblock
19305 #: ../fish/guestfish.pod:244
19306 msgid "forces raw format (no auto-detection) for C<disk.img>."
19307 msgstr ""
19308
19309 #. type: verbatim
19310 #: ../fish/guestfish.pod:246
19311 #, no-wrap
19312 msgid ""
19313 " guestfish --format=raw -a disk.img --format -a another.img\n"
19314 "\n"
19315 msgstr ""
19316
19317 #. type: textblock
19318 #: ../fish/guestfish.pod:248
19319 msgid ""
19320 "forces raw format (no auto-detection) for C<disk.img> and reverts to "
19321 "auto-detection for C<another.img>."
19322 msgstr ""
19323
19324 #. type: textblock
19325 #: ../fish/guestfish.pod:251
19326 msgid ""
19327 "If you have untrusted raw-format guest disk images, you should use this "
19328 "option to specify the disk format.  This avoids a possible security problem "
19329 "with malicious guests (CVE-2010-3851).  See also L</add-drive-opts>."
19330 msgstr ""
19331
19332 #. type: =item
19333 #: ../fish/guestfish.pod:256
19334 msgid "B<-i>"
19335 msgstr ""
19336
19337 #. type: =item
19338 #: ../fish/guestfish.pod:258
19339 msgid "B<--inspector>"
19340 msgstr ""
19341
19342 #. type: textblock
19343 #: ../fish/guestfish.pod:260 ../fuse/guestmount.pod:147
19344 msgid ""
19345 "Using L<virt-inspector(1)> code, inspect the disks looking for an operating "
19346 "system and mount filesystems as they would be mounted on the real virtual "
19347 "machine."
19348 msgstr ""
19349
19350 #. type: textblock
19351 #: ../fish/guestfish.pod:264
19352 msgid "Typical usage is either:"
19353 msgstr ""
19354
19355 #. type: verbatim
19356 #: ../fish/guestfish.pod:266
19357 #, no-wrap
19358 msgid ""
19359 " guestfish -d myguest -i\n"
19360 "\n"
19361 msgstr ""
19362
19363 #. type: textblock
19364 #: ../fish/guestfish.pod:268
19365 msgid "(for an inactive libvirt domain called I<myguest>), or:"
19366 msgstr ""
19367
19368 #. type: verbatim
19369 #: ../fish/guestfish.pod:270
19370 #, no-wrap
19371 msgid ""
19372 " guestfish --ro -d myguest -i\n"
19373 "\n"
19374 msgstr ""
19375
19376 #. type: textblock
19377 #: ../fish/guestfish.pod:272
19378 msgid "(for active domains, readonly), or specify the block device directly:"
19379 msgstr ""
19380
19381 #. type: verbatim
19382 #: ../fish/guestfish.pod:274
19383 #, no-wrap
19384 msgid ""
19385 " guestfish --rw -a /dev/Guests/MyGuest -i\n"
19386 "\n"
19387 msgstr ""
19388
19389 #. type: textblock
19390 #: ../fish/guestfish.pod:276
19391 msgid ""
19392 "Note that the command line syntax changed slightly over older versions of "
19393 "guestfish.  You can still use the old syntax:"
19394 msgstr ""
19395
19396 #. type: verbatim
19397 #: ../fish/guestfish.pod:279
19398 #, no-wrap
19399 msgid ""
19400 " guestfish [--ro] -i disk.img\n"
19401 "\n"
19402 msgstr ""
19403
19404 #. type: verbatim
19405 #: ../fish/guestfish.pod:281
19406 #, no-wrap
19407 msgid ""
19408 " guestfish [--ro] -i libvirt-domain\n"
19409 "\n"
19410 msgstr ""
19411
19412 #. type: textblock
19413 #: ../fish/guestfish.pod:283
19414 msgid ""
19415 "Using this flag is mostly equivalent to using the C<inspect-os> command and "
19416 "then using other commands to mount the filesystems that were found."
19417 msgstr ""
19418
19419 #. type: =item
19420 #: ../fish/guestfish.pod:287 ../fuse/guestmount.pod:151
19421 msgid "B<--keys-from-stdin>"
19422 msgstr ""
19423
19424 #. type: textblock
19425 #: ../fish/guestfish.pod:289 ../fuse/guestmount.pod:153
19426 msgid ""
19427 "Read key or passphrase parameters from stdin.  The default is to try to read "
19428 "passphrases from the user by opening C</dev/tty>."
19429 msgstr ""
19430
19431 #. type: =item
19432 #: ../fish/guestfish.pod:292
19433 msgid "B<--listen>"
19434 msgstr ""
19435
19436 #. type: textblock
19437 #: ../fish/guestfish.pod:294
19438 msgid ""
19439 "Fork into the background and listen for remote commands.  See section "
19440 "L</REMOTE CONTROL GUESTFISH OVER A SOCKET> below."
19441 msgstr ""
19442
19443 #. type: =item
19444 #: ../fish/guestfish.pod:297 ../fuse/guestmount.pod:156
19445 msgid "B<--live>"
19446 msgstr ""
19447
19448 #. type: textblock
19449 #: ../fish/guestfish.pod:299 ../fuse/guestmount.pod:158
19450 msgid ""
19451 "Connect to a live virtual machine.  (Experimental, see "
19452 "L<guestfs(3)/ATTACHING TO RUNNING DAEMONS>)."
19453 msgstr ""
19454
19455 #. type: =item
19456 #: ../fish/guestfish.pod:302 ../fuse/guestmount.pod:161
19457 msgid "B<-m dev[:mountpoint[:options]]>"
19458 msgstr ""
19459
19460 #. type: =item
19461 #: ../fish/guestfish.pod:304 ../fuse/guestmount.pod:163
19462 msgid "B<--mount dev[:mountpoint[:options]]>"
19463 msgstr ""
19464
19465 #. type: textblock
19466 #: ../fish/guestfish.pod:306
19467 msgid "Mount the named partition or logical volume on the given mountpoint."
19468 msgstr ""
19469
19470 #. type: textblock
19471 #: ../fish/guestfish.pod:308
19472 msgid "If the mountpoint is omitted, it defaults to C</>."
19473 msgstr ""
19474
19475 #. type: textblock
19476 #: ../fish/guestfish.pod:310
19477 msgid "You have to mount something on C</> before most commands will work."
19478 msgstr ""
19479
19480 #. type: textblock
19481 #: ../fish/guestfish.pod:312
19482 msgid ""
19483 "If any I<-m> or I<--mount> options are given, the guest is automatically "
19484 "launched."
19485 msgstr ""
19486
19487 #. type: textblock
19488 #: ../fish/guestfish.pod:315
19489 msgid ""
19490 "If you don't know what filesystems a disk image contains, you can either run "
19491 "guestfish without this option, then list the partitions, filesystems and LVs "
19492 "available (see L</list-partitions>, L</list-filesystems> and L</lvs> "
19493 "commands), or you can use the L<virt-filesystems(1)> program."
19494 msgstr ""
19495
19496 #. type: textblock
19497 #: ../fish/guestfish.pod:321 ../fuse/guestmount.pod:171
19498 msgid ""
19499 "The third (and rarely used) part of the mount parameter is the list of mount "
19500 "options used to mount the underlying filesystem.  If this is not given, then "
19501 "the mount options are either the empty string or C<ro> (the latter if the "
19502 "I<--ro> flag is used).  By specifying the mount options, you override this "
19503 "default choice.  Probably the only time you would use this is to enable ACLs "
19504 "and/or extended attributes if the filesystem can support them:"
19505 msgstr ""
19506
19507 #. type: verbatim
19508 #: ../fish/guestfish.pod:329 ../fuse/guestmount.pod:179
19509 #, no-wrap
19510 msgid ""
19511 " -m /dev/sda1:/:acl,user_xattr\n"
19512 "\n"
19513 msgstr ""
19514
19515 #. type: textblock
19516 #: ../fish/guestfish.pod:331
19517 msgid "Using this flag is equivalent to using the C<mount-options> command."
19518 msgstr ""
19519
19520 #. type: =item
19521 #: ../fish/guestfish.pod:333
19522 msgid "B<-n>"
19523 msgstr ""
19524
19525 #. type: =item
19526 #: ../fish/guestfish.pod:335
19527 msgid "B<--no-sync>"
19528 msgstr ""
19529
19530 #. type: textblock
19531 #: ../fish/guestfish.pod:337
19532 msgid ""
19533 "Disable autosync.  This is enabled by default.  See the discussion of "
19534 "autosync in the L<guestfs(3)> manpage."
19535 msgstr ""
19536
19537 #. type: =item
19538 #: ../fish/guestfish.pod:340
19539 msgid "B<-N type>"
19540 msgstr ""
19541
19542 #. type: =item
19543 #: ../fish/guestfish.pod:342
19544 msgid "B<--new type>"
19545 msgstr ""
19546
19547 #. type: =item
19548 #: ../fish/guestfish.pod:344
19549 msgid "B<-N help>"
19550 msgstr ""
19551
19552 #. type: textblock
19553 #: ../fish/guestfish.pod:346
19554 msgid ""
19555 "Prepare a fresh disk image formatted as \"type\".  This is an alternative to "
19556 "the I<-a> option: whereas I<-a> adds an existing disk, I<-N> creates a "
19557 "preformatted disk with a filesystem and adds it.  See L</PREPARED DISK "
19558 "IMAGES> below."
19559 msgstr ""
19560
19561 #. type: =item
19562 #: ../fish/guestfish.pod:351
19563 msgid "B<--progress-bars>"
19564 msgstr ""
19565
19566 #. type: textblock
19567 #: ../fish/guestfish.pod:353
19568 msgid "Enable progress bars, even when guestfish is used non-interactively."
19569 msgstr ""
19570
19571 #. type: textblock
19572 #: ../fish/guestfish.pod:355
19573 msgid ""
19574 "Progress bars are enabled by default when guestfish is used as an "
19575 "interactive shell."
19576 msgstr ""
19577
19578 #. type: =item
19579 #: ../fish/guestfish.pod:358
19580 msgid "B<--no-progress-bars>"
19581 msgstr ""
19582
19583 #. type: textblock
19584 #: ../fish/guestfish.pod:360
19585 msgid "Disable progress bars."
19586 msgstr ""
19587
19588 #. type: =item
19589 #: ../fish/guestfish.pod:362
19590 msgid "B<--remote[=pid]>"
19591 msgstr ""
19592
19593 #. type: textblock
19594 #: ../fish/guestfish.pod:364
19595 msgid ""
19596 "Send remote commands to C<$GUESTFISH_PID> or C<pid>.  See section L</REMOTE "
19597 "CONTROL GUESTFISH OVER A SOCKET> below."
19598 msgstr ""
19599
19600 #. type: =item
19601 #: ../fish/guestfish.pod:367
19602 msgid "B<-r>"
19603 msgstr ""
19604
19605 #. type: =item
19606 #: ../fish/guestfish.pod:369
19607 msgid "B<--ro>"
19608 msgstr ""
19609
19610 #. type: textblock
19611 #: ../fish/guestfish.pod:371
19612 msgid ""
19613 "This changes the I<-a>, I<-d> and I<-m> options so that disks are added and "
19614 "mounts are done read-only."
19615 msgstr ""
19616
19617 #. type: textblock
19618 #: ../fish/guestfish.pod:374
19619 msgid ""
19620 "The option must always be used if the disk image or virtual machine might be "
19621 "running, and is generally recommended in cases where you don't need write "
19622 "access to the disk."
19623 msgstr ""
19624
19625 #. type: textblock
19626 #: ../fish/guestfish.pod:378
19627 msgid ""
19628 "Note that prepared disk images created with I<-N> are not affected by this "
19629 "option.  Also commands like C<add> are not affected - you have to specify "
19630 "the C<readonly:true> option explicitly if you need it."
19631 msgstr ""
19632
19633 #. type: textblock
19634 #: ../fish/guestfish.pod:382
19635 msgid "See also L</OPENING DISKS FOR READ AND WRITE> below."
19636 msgstr ""
19637
19638 #. type: =item
19639 #: ../fish/guestfish.pod:384 ../fuse/guestmount.pod:235
19640 msgid "B<--selinux>"
19641 msgstr ""
19642
19643 #. type: textblock
19644 #: ../fish/guestfish.pod:386
19645 msgid "Enable SELinux support for the guest.  See L<guestfs(3)/SELINUX>."
19646 msgstr ""
19647
19648 #. type: =item
19649 #: ../fish/guestfish.pod:388
19650 msgid "B<-v>"
19651 msgstr ""
19652
19653 #. type: =item
19654 #: ../fish/guestfish.pod:390
19655 msgid "B<--verbose>"
19656 msgstr ""
19657
19658 #. type: textblock
19659 #: ../fish/guestfish.pod:392
19660 msgid ""
19661 "Enable very verbose messages.  This is particularly useful if you find a "
19662 "bug."
19663 msgstr ""
19664
19665 #. type: =item
19666 #: ../fish/guestfish.pod:395
19667 msgid "B<-V>"
19668 msgstr ""
19669
19670 #. type: =item
19671 #: ../fish/guestfish.pod:397 ../tools/virt-edit.pl:97 ../tools/virt-win-reg.pl:112 ../tools/virt-list-filesystems.pl:69 ../tools/virt-tar.pl:119 ../tools/virt-make-fs.pl:169 ../tools/virt-list-partitions.pl:70
19672 msgid "B<--version>"
19673 msgstr ""
19674
19675 #. type: textblock
19676 #: ../fish/guestfish.pod:399
19677 msgid "Display the guestfish / libguestfs version number and exit."
19678 msgstr ""
19679
19680 #. type: =item
19681 #: ../fish/guestfish.pod:401
19682 msgid "B<-w>"
19683 msgstr ""
19684
19685 #. type: =item
19686 #: ../fish/guestfish.pod:403
19687 msgid "B<--rw>"
19688 msgstr ""
19689
19690 #. type: textblock
19691 #: ../fish/guestfish.pod:405 ../fuse/guestmount.pod:249
19692 msgid ""
19693 "This changes the I<-a>, I<-d> and I<-m> options so that disks are added and "
19694 "mounts are done read-write."
19695 msgstr ""
19696
19697 #. type: textblock
19698 #: ../fish/guestfish.pod:408
19699 msgid "See L</OPENING DISKS FOR READ AND WRITE> below."
19700 msgstr ""
19701
19702 #. type: =item
19703 #: ../fish/guestfish.pod:410
19704 msgid "B<-x>"
19705 msgstr ""
19706
19707 #. type: textblock
19708 #: ../fish/guestfish.pod:412
19709 msgid "Echo each command before executing it."
19710 msgstr ""
19711
19712 #. type: =head1
19713 #: ../fish/guestfish.pod:416
19714 msgid "COMMANDS ON COMMAND LINE"
19715 msgstr ""
19716
19717 #. type: textblock
19718 #: ../fish/guestfish.pod:418
19719 msgid "Any additional (non-option) arguments are treated as commands to execute."
19720 msgstr ""
19721
19722 #. type: textblock
19723 #: ../fish/guestfish.pod:421
19724 msgid ""
19725 "Commands to execute should be separated by a colon (C<:>), where the colon "
19726 "is a separate parameter.  Thus:"
19727 msgstr ""
19728
19729 #. type: verbatim
19730 #: ../fish/guestfish.pod:424
19731 #, no-wrap
19732 msgid ""
19733 " guestfish cmd [args...] : cmd [args...] : cmd [args...] ...\n"
19734 "\n"
19735 msgstr ""
19736
19737 #. type: textblock
19738 #: ../fish/guestfish.pod:426
19739 msgid ""
19740 "If there are no additional arguments, then we enter a shell, either an "
19741 "interactive shell with a prompt (if the input is a terminal) or a "
19742 "non-interactive shell."
19743 msgstr ""
19744
19745 #. type: textblock
19746 #: ../fish/guestfish.pod:430
19747 msgid ""
19748 "In either command line mode or non-interactive shell, the first command that "
19749 "gives an error causes the whole shell to exit.  In interactive mode (with a "
19750 "prompt) if a command fails, you can continue to enter commands."
19751 msgstr ""
19752
19753 #. type: =head1
19754 #: ../fish/guestfish.pod:435
19755 msgid "USING launch (OR run)"
19756 msgstr ""
19757
19758 #. type: textblock
19759 #: ../fish/guestfish.pod:437
19760 msgid ""
19761 "As with L<guestfs(3)>, you must first configure your guest by adding disks, "
19762 "then launch it, then mount any disks you need, and finally issue "
19763 "actions/commands.  So the general order of the day is:"
19764 msgstr ""
19765
19766 #. type: textblock
19767 #: ../fish/guestfish.pod:445
19768 msgid "add or -a/--add"
19769 msgstr ""
19770
19771 #. type: textblock
19772 #: ../fish/guestfish.pod:449
19773 msgid "launch (aka run)"
19774 msgstr ""
19775
19776 #. type: textblock
19777 #: ../fish/guestfish.pod:453
19778 msgid "mount or -m/--mount"
19779 msgstr ""
19780
19781 #. type: textblock
19782 #: ../fish/guestfish.pod:457
19783 msgid "any other commands"
19784 msgstr ""
19785
19786 #. type: textblock
19787 #: ../fish/guestfish.pod:461
19788 msgid ""
19789 "C<run> is a synonym for C<launch>.  You must C<launch> (or C<run>)  your "
19790 "guest before mounting or performing any other commands."
19791 msgstr ""
19792
19793 #. type: textblock
19794 #: ../fish/guestfish.pod:464
19795 msgid ""
19796 "The only exception is that if any of the I<-i>, I<-m>, I<--mount>, I<-N> or "
19797 "I<--new> options were given then C<run> is done automatically, simply "
19798 "because guestfish can't perform the action you asked for without doing this."
19799 msgstr ""
19800
19801 #. type: =head1
19802 #: ../fish/guestfish.pod:469
19803 msgid "OPENING DISKS FOR READ AND WRITE"
19804 msgstr ""
19805
19806 #. type: textblock
19807 #: ../fish/guestfish.pod:471
19808 msgid ""
19809 "The guestfish, L<guestmount(1)> and L<virt-rescue(1)> options I<--ro> and "
19810 "I<--rw> affect whether the other command line options I<-a>, I<-c>, I<-d>, "
19811 "I<-i> and I<-m> open disk images read-only or for writing."
19812 msgstr ""
19813
19814 #. type: textblock
19815 #: ../fish/guestfish.pod:476
19816 msgid ""
19817 "In libguestfs E<le> 1.10, guestfish, guestmount and virt-rescue defaulted to "
19818 "opening disk images supplied on the command line for write.  To open a disk "
19819 "image read-only you have to do I<-a image --ro>."
19820 msgstr ""
19821
19822 #. type: textblock
19823 #: ../fish/guestfish.pod:480
19824 msgid ""
19825 "This matters: If you accidentally open a live VM disk image writable then "
19826 "you will cause irreversible disk corruption."
19827 msgstr ""
19828
19829 #. type: textblock
19830 #: ../fish/guestfish.pod:483
19831 msgid ""
19832 "By libguestfs 1.12 we intend to change the default the other way.  Disk "
19833 "images will be opened read-only.  You will have to either specify "
19834 "I<guestfish --rw>, I<guestmount --rw>, I<virt-rescue --rw>, or change the "
19835 "configuration file C</etc/libguestfs-tools.conf> in order to get write "
19836 "access for disk images specified by those other command line options."
19837 msgstr ""
19838
19839 #. type: textblock
19840 #: ../fish/guestfish.pod:490
19841 msgid ""
19842 "This version of guestfish, guestmount and virt-rescue has a I<--rw> option "
19843 "which does nothing (it is already the default).  However it is highly "
19844 "recommended that you use this option to indicate that you need write access, "
19845 "and prepare your scripts for the day when this option will be required for "
19846 "write access."
19847 msgstr ""
19848
19849 #. type: textblock
19850 #: ../fish/guestfish.pod:496
19851 msgid ""
19852 "B<Note:> This does I<not> affect commands like L</add> and L</mount>, or any "
19853 "other libguestfs program apart from guestfish and guestmount."
19854 msgstr ""
19855
19856 #. type: =head1
19857 #: ../fish/guestfish.pod:499
19858 msgid "QUOTING"
19859 msgstr ""
19860
19861 #. type: textblock
19862 #: ../fish/guestfish.pod:501
19863 msgid ""
19864 "You can quote ordinary parameters using either single or double quotes.  For "
19865 "example:"
19866 msgstr ""
19867
19868 #. type: verbatim
19869 #: ../fish/guestfish.pod:504
19870 #, no-wrap
19871 msgid ""
19872 " add \"file with a space.img\"\n"
19873 "\n"
19874 msgstr ""
19875
19876 #. type: verbatim
19877 #: ../fish/guestfish.pod:506
19878 #, no-wrap
19879 msgid ""
19880 " rm '/file name'\n"
19881 "\n"
19882 msgstr ""
19883
19884 #. type: verbatim
19885 #: ../fish/guestfish.pod:508
19886 #, no-wrap
19887 msgid ""
19888 " rm '/\"'\n"
19889 "\n"
19890 msgstr ""
19891
19892 #. type: textblock
19893 #: ../fish/guestfish.pod:510
19894 msgid ""
19895 "A few commands require a list of strings to be passed.  For these, use a "
19896 "whitespace-separated list, enclosed in quotes.  Strings containing "
19897 "whitespace to be passed through must be enclosed in single quotes.  A "
19898 "literal single quote must be escaped with a backslash."
19899 msgstr ""
19900
19901 #. type: verbatim
19902 #: ../fish/guestfish.pod:515
19903 #, no-wrap
19904 msgid ""
19905 " vgcreate VG \"/dev/sda1 /dev/sdb1\"\n"
19906 " command \"/bin/echo 'foo      bar'\"\n"
19907 " command \"/bin/echo \\'foo\\'\"\n"
19908 "\n"
19909 msgstr ""
19910
19911 #. type: =head1
19912 #: ../fish/guestfish.pod:519
19913 msgid "OPTIONAL ARGUMENTS"
19914 msgstr ""
19915
19916 #. type: textblock
19917 #: ../fish/guestfish.pod:521
19918 msgid ""
19919 "Some commands take optional arguments.  These arguments appear in this "
19920 "documentation as C<[argname:..]>.  You can use them as in these examples:"
19921 msgstr ""
19922
19923 #. type: verbatim
19924 #: ../fish/guestfish.pod:525
19925 #, no-wrap
19926 msgid ""
19927 " add-drive-opts filename\n"
19928 "\n"
19929 msgstr ""
19930
19931 #. type: verbatim
19932 #: ../fish/guestfish.pod:527
19933 #, no-wrap
19934 msgid ""
19935 " add-drive-opts filename readonly:true\n"
19936 "\n"
19937 msgstr ""
19938
19939 #. type: verbatim
19940 #: ../fish/guestfish.pod:529
19941 #, no-wrap
19942 msgid ""
19943 " add-drive-opts filename format:qcow2 readonly:false\n"
19944 "\n"
19945 msgstr ""
19946
19947 #. type: textblock
19948 #: ../fish/guestfish.pod:531
19949 msgid ""
19950 "Each optional argument can appear at most once.  All optional arguments must "
19951 "appear after the required ones."
19952 msgstr ""
19953
19954 #. type: =head1
19955 #: ../fish/guestfish.pod:534
19956 msgid "NUMBERS"
19957 msgstr ""
19958
19959 #. type: textblock
19960 #: ../fish/guestfish.pod:536
19961 msgid "This section applies to all commands which can take integers as parameters."
19962 msgstr ""
19963
19964 #. type: =head2
19965 #: ../fish/guestfish.pod:539
19966 msgid "SIZE SUFFIX"
19967 msgstr ""
19968
19969 #. type: textblock
19970 #: ../fish/guestfish.pod:541
19971 msgid ""
19972 "When the command takes a parameter measured in bytes, you can use one of the "
19973 "following suffixes to specify kilobytes, megabytes and larger sizes:"
19974 msgstr ""
19975
19976 #. type: =item
19977 #: ../fish/guestfish.pod:547
19978 msgid "B<k> or B<K> or B<KiB>"
19979 msgstr ""
19980
19981 #. type: textblock
19982 #: ../fish/guestfish.pod:549
19983 msgid "The size in kilobytes (multiplied by 1024)."
19984 msgstr ""
19985
19986 #. type: =item
19987 #: ../fish/guestfish.pod:551
19988 msgid "B<KB>"
19989 msgstr ""
19990
19991 #. type: textblock
19992 #: ../fish/guestfish.pod:553
19993 msgid "The size in SI 1000 byte units."
19994 msgstr ""
19995
19996 #. type: =item
19997 #: ../fish/guestfish.pod:555
19998 msgid "B<M> or B<MiB>"
19999 msgstr ""
20000
20001 #. type: textblock
20002 #: ../fish/guestfish.pod:557
20003 msgid "The size in megabytes (multiplied by 1048576)."
20004 msgstr ""
20005
20006 #. type: =item
20007 #: ../fish/guestfish.pod:559
20008 msgid "B<MB>"
20009 msgstr ""
20010
20011 #. type: textblock
20012 #: ../fish/guestfish.pod:561
20013 msgid "The size in SI 1000000 byte units."
20014 msgstr ""
20015
20016 #. type: =item
20017 #: ../fish/guestfish.pod:563
20018 msgid "B<G> or B<GiB>"
20019 msgstr ""
20020
20021 #. type: textblock
20022 #: ../fish/guestfish.pod:565
20023 msgid "The size in gigabytes (multiplied by 2**30)."
20024 msgstr ""
20025
20026 #. type: =item
20027 #: ../fish/guestfish.pod:567
20028 msgid "B<GB>"
20029 msgstr ""
20030
20031 #. type: textblock
20032 #: ../fish/guestfish.pod:569
20033 msgid "The size in SI 10**9 byte units."
20034 msgstr ""
20035
20036 #. type: =item
20037 #: ../fish/guestfish.pod:571
20038 msgid "B<T> or B<TiB>"
20039 msgstr ""
20040
20041 #. type: textblock
20042 #: ../fish/guestfish.pod:573
20043 msgid "The size in terabytes (multiplied by 2**40)."
20044 msgstr ""
20045
20046 #. type: =item
20047 #: ../fish/guestfish.pod:575
20048 msgid "B<TB>"
20049 msgstr ""
20050
20051 #. type: textblock
20052 #: ../fish/guestfish.pod:577
20053 msgid "The size in SI 10**12 byte units."
20054 msgstr ""
20055
20056 #. type: =item
20057 #: ../fish/guestfish.pod:579
20058 msgid "B<P> or B<PiB>"
20059 msgstr ""
20060
20061 #. type: textblock
20062 #: ../fish/guestfish.pod:581
20063 msgid "The size in petabytes (multiplied by 2**50)."
20064 msgstr ""
20065
20066 #. type: =item
20067 #: ../fish/guestfish.pod:583
20068 msgid "B<PB>"
20069 msgstr ""
20070
20071 #. type: textblock
20072 #: ../fish/guestfish.pod:585
20073 msgid "The size in SI 10**15 byte units."
20074 msgstr ""
20075
20076 #. type: =item
20077 #: ../fish/guestfish.pod:587
20078 msgid "B<E> or B<EiB>"
20079 msgstr ""
20080
20081 #. type: textblock
20082 #: ../fish/guestfish.pod:589
20083 msgid "The size in exabytes (multiplied by 2**60)."
20084 msgstr ""
20085
20086 #. type: =item
20087 #: ../fish/guestfish.pod:591
20088 msgid "B<EB>"
20089 msgstr ""
20090
20091 #. type: textblock
20092 #: ../fish/guestfish.pod:593
20093 msgid "The size in SI 10**18 byte units."
20094 msgstr ""
20095
20096 #. type: =item
20097 #: ../fish/guestfish.pod:595
20098 msgid "B<Z> or B<ZiB>"
20099 msgstr ""
20100
20101 #. type: textblock
20102 #: ../fish/guestfish.pod:597
20103 msgid "The size in zettabytes (multiplied by 2**70)."
20104 msgstr ""
20105
20106 #. type: =item
20107 #: ../fish/guestfish.pod:599
20108 msgid "B<ZB>"
20109 msgstr ""
20110
20111 #. type: textblock
20112 #: ../fish/guestfish.pod:601
20113 msgid "The size in SI 10**21 byte units."
20114 msgstr ""
20115
20116 #. type: =item
20117 #: ../fish/guestfish.pod:603
20118 msgid "B<Y> or B<YiB>"
20119 msgstr ""
20120
20121 #. type: textblock
20122 #: ../fish/guestfish.pod:605
20123 msgid "The size in yottabytes (multiplied by 2**80)."
20124 msgstr ""
20125
20126 #. type: =item
20127 #: ../fish/guestfish.pod:607
20128 msgid "B<YB>"
20129 msgstr ""
20130
20131 #. type: textblock
20132 #: ../fish/guestfish.pod:609
20133 msgid "The size in SI 10**24 byte units."
20134 msgstr ""
20135
20136 #. type: verbatim
20137 #: ../fish/guestfish.pod:615
20138 #, no-wrap
20139 msgid ""
20140 " truncate-size /file 1G\n"
20141 "\n"
20142 msgstr ""
20143
20144 #. type: textblock
20145 #: ../fish/guestfish.pod:617
20146 msgid "would truncate the file to 1 gigabyte."
20147 msgstr ""
20148
20149 #. type: textblock
20150 #: ../fish/guestfish.pod:619
20151 msgid ""
20152 "Be careful because a few commands take sizes in kilobytes or megabytes "
20153 "(eg. the parameter to L</memsize> is specified in megabytes already).  "
20154 "Adding a suffix will probably not do what you expect."
20155 msgstr ""
20156
20157 #. type: =head2
20158 #: ../fish/guestfish.pod:623
20159 msgid "OCTAL AND HEXADECIMAL NUMBERS"
20160 msgstr ""
20161
20162 #. type: textblock
20163 #: ../fish/guestfish.pod:625
20164 msgid ""
20165 "For specifying the radix (base) use the C convention: C<0> to prefix an "
20166 "octal number or C<0x> to prefix a hexadecimal number.  For example:"
20167 msgstr ""
20168
20169 #. type: verbatim
20170 #: ../fish/guestfish.pod:628
20171 #, no-wrap
20172 msgid ""
20173 " 1234      decimal number 1234\n"
20174 " 02322     octal number, equivalent to decimal 1234\n"
20175 " 0x4d2     hexadecimal number, equivalent to decimal 1234\n"
20176 "\n"
20177 msgstr ""
20178
20179 #. type: textblock
20180 #: ../fish/guestfish.pod:632
20181 msgid ""
20182 "When using the C<chmod> command, you almost always want to specify an octal "
20183 "number for the mode, and you must prefix it with C<0> (unlike the Unix "
20184 "L<chmod(1)> program):"
20185 msgstr ""
20186
20187 #. type: verbatim
20188 #: ../fish/guestfish.pod:636
20189 #, no-wrap
20190 msgid ""
20191 " chmod 0777 /public  # OK\n"
20192 " chmod 777 /public   # WRONG! This is mode 777 decimal = 01411 octal.\n"
20193 "\n"
20194 msgstr ""
20195
20196 #. type: textblock
20197 #: ../fish/guestfish.pod:639
20198 msgid ""
20199 "Commands that return numbers usually print them in decimal, but some "
20200 "commands print numbers in other radices (eg. C<umask> prints the mode in "
20201 "octal, preceeded by C<0>)."
20202 msgstr ""
20203
20204 #. type: =head1
20205 #: ../fish/guestfish.pod:643
20206 msgid "WILDCARDS AND GLOBBING"
20207 msgstr ""
20208
20209 #. type: textblock
20210 #: ../fish/guestfish.pod:645
20211 msgid ""
20212 "Neither guestfish nor the underlying guestfs API performs wildcard expansion "
20213 "(globbing) by default.  So for example the following will not do what you "
20214 "expect:"
20215 msgstr ""
20216
20217 #. type: verbatim
20218 #: ../fish/guestfish.pod:649
20219 #, no-wrap
20220 msgid ""
20221 " rm-rf /home/*\n"
20222 "\n"
20223 msgstr ""
20224
20225 #. type: textblock
20226 #: ../fish/guestfish.pod:651
20227 msgid ""
20228 "Assuming you don't have a directory called literally C</home/*> then the "
20229 "above command will return an error."
20230 msgstr ""
20231
20232 #. type: textblock
20233 #: ../fish/guestfish.pod:654
20234 msgid "To perform wildcard expansion, use the C<glob> command."
20235 msgstr ""
20236
20237 #. type: verbatim
20238 #: ../fish/guestfish.pod:656
20239 #, no-wrap
20240 msgid ""
20241 " glob rm-rf /home/*\n"
20242 "\n"
20243 msgstr ""
20244
20245 #. type: textblock
20246 #: ../fish/guestfish.pod:658
20247 msgid ""
20248 "runs C<rm-rf> on each path that matches (ie. potentially running the command "
20249 "many times), equivalent to:"
20250 msgstr ""
20251
20252 #. type: verbatim
20253 #: ../fish/guestfish.pod:661
20254 #, no-wrap
20255 msgid ""
20256 " rm-rf /home/jim\n"
20257 " rm-rf /home/joe\n"
20258 " rm-rf /home/mary\n"
20259 "\n"
20260 msgstr ""
20261
20262 #. type: textblock
20263 #: ../fish/guestfish.pod:665
20264 msgid "C<glob> only works on simple guest paths and not on device names."
20265 msgstr ""
20266
20267 #. type: textblock
20268 #: ../fish/guestfish.pod:667
20269 msgid ""
20270 "If you have several parameters, each containing a wildcard, then glob will "
20271 "perform a Cartesian product."
20272 msgstr ""
20273
20274 #. type: =head1
20275 #: ../fish/guestfish.pod:670
20276 msgid "COMMENTS"
20277 msgstr ""
20278
20279 #. type: textblock
20280 #: ../fish/guestfish.pod:672
20281 msgid ""
20282 "Any line which starts with a I<#> character is treated as a comment and "
20283 "ignored.  The I<#> can optionally be preceeded by whitespace, but B<not> by "
20284 "a command.  For example:"
20285 msgstr ""
20286
20287 #. type: verbatim
20288 #: ../fish/guestfish.pod:676
20289 #, no-wrap
20290 msgid ""
20291 " # this is a comment\n"
20292 "         # this is a comment\n"
20293 " foo # NOT a comment\n"
20294 "\n"
20295 msgstr ""
20296
20297 #. type: textblock
20298 #: ../fish/guestfish.pod:680
20299 msgid "Blank lines are also ignored."
20300 msgstr ""
20301
20302 #. type: =head1
20303 #: ../fish/guestfish.pod:682
20304 msgid "RUNNING COMMANDS LOCALLY"
20305 msgstr ""
20306
20307 #. type: textblock
20308 #: ../fish/guestfish.pod:684
20309 msgid ""
20310 "Any line which starts with a I<!> character is treated as a command sent to "
20311 "the local shell (C</bin/sh> or whatever L<system(3)> uses).  For example:"
20312 msgstr ""
20313
20314 #. type: verbatim
20315 #: ../fish/guestfish.pod:688
20316 #, no-wrap
20317 msgid ""
20318 " !mkdir local\n"
20319 " tgz-out /remote local/remote-data.tar.gz\n"
20320 "\n"
20321 msgstr ""
20322
20323 #. type: textblock
20324 #: ../fish/guestfish.pod:691
20325 msgid ""
20326 "will create a directory C<local> on the host, and then export the contents "
20327 "of C</remote> on the mounted filesystem to C<local/remote-data.tar.gz>.  "
20328 "(See C<tgz-out>)."
20329 msgstr ""
20330
20331 #. type: textblock
20332 #: ../fish/guestfish.pod:695
20333 msgid ""
20334 "To change the local directory, use the C<lcd> command.  C<!cd> will have no "
20335 "effect, due to the way that subprocesses work in Unix."
20336 msgstr ""
20337
20338 #. type: =head2
20339 #: ../fish/guestfish.pod:698
20340 msgid "LOCAL COMMANDS WITH INLINE EXECUTION"
20341 msgstr ""
20342
20343 #. type: textblock
20344 #: ../fish/guestfish.pod:700
20345 msgid ""
20346 "If a line starts with I<E<lt>!> then the shell command is executed (as for "
20347 "I<!>), but subsequently any output (stdout) of the shell command is parsed "
20348 "and executed as guestfish commands."
20349 msgstr ""
20350
20351 #. type: textblock
20352 #: ../fish/guestfish.pod:704
20353 msgid ""
20354 "Thus you can use shell script to construct arbitrary guestfish commands "
20355 "which are then parsed by guestfish."
20356 msgstr ""
20357
20358 #. type: textblock
20359 #: ../fish/guestfish.pod:707
20360 msgid ""
20361 "For example it is tedious to create a sequence of files (eg. C</foo.1> "
20362 "through C</foo.100>) using guestfish commands alone.  However this is simple "
20363 "if we use a shell script to create the guestfish commands for us:"
20364 msgstr ""
20365
20366 #. type: verbatim
20367 #: ../fish/guestfish.pod:712
20368 #, no-wrap
20369 msgid ""
20370 " <! for n in `seq 1 100`; do echo write /foo.$n $n; done\n"
20371 "\n"
20372 msgstr ""
20373
20374 #. type: textblock
20375 #: ../fish/guestfish.pod:714
20376 msgid "or with names like C</foo.001>:"
20377 msgstr ""
20378
20379 #. type: verbatim
20380 #: ../fish/guestfish.pod:716
20381 #, no-wrap
20382 msgid ""
20383 " <! for n in `seq 1 100`; do printf \"write /foo.%03d %d\\n\" $n $n; done\n"
20384 "\n"
20385 msgstr ""
20386
20387 #. type: textblock
20388 #: ../fish/guestfish.pod:718
20389 msgid ""
20390 "When using guestfish interactively it can be helpful to just run the shell "
20391 "script first (ie. remove the initial C<E<lt>> character so it is just an "
20392 "ordinary I<!> local command), see what guestfish commands it would run, and "
20393 "when you are happy with those prepend the C<E<lt>> character to run the "
20394 "guestfish commands for real."
20395 msgstr ""
20396
20397 #. type: =head1
20398 #: ../fish/guestfish.pod:724
20399 msgid "PIPES"
20400 msgstr ""
20401
20402 #. type: textblock
20403 #: ../fish/guestfish.pod:726
20404 msgid ""
20405 "Use C<command E<lt>spaceE<gt> | command> to pipe the output of the first "
20406 "command (a guestfish command) to the second command (any host command).  For "
20407 "example:"
20408 msgstr ""
20409
20410 #. type: verbatim
20411 #: ../fish/guestfish.pod:730
20412 #, no-wrap
20413 msgid ""
20414 " cat /etc/passwd | awk -F: '$3 == 0 { print }'\n"
20415 "\n"
20416 msgstr ""
20417
20418 #. type: textblock
20419 #: ../fish/guestfish.pod:732
20420 msgid ""
20421 "(where C<cat> is the guestfish cat command, but C<awk> is the host awk "
20422 "program).  The above command would list all accounts in the guest filesystem "
20423 "which have UID 0, ie. root accounts including backdoors.  Other examples:"
20424 msgstr ""
20425
20426 #. type: verbatim
20427 #: ../fish/guestfish.pod:737
20428 #, no-wrap
20429 msgid ""
20430 " hexdump /bin/ls | head\n"
20431 " list-devices | tail -1\n"
20432 " tgz-out / - | tar ztf -\n"
20433 "\n"
20434 msgstr ""
20435
20436 #. type: textblock
20437 #: ../fish/guestfish.pod:741
20438 msgid ""
20439 "The space before the pipe symbol is required, any space after the pipe "
20440 "symbol is optional.  Everything after the pipe symbol is just passed "
20441 "straight to the host shell, so it can contain redirections, globs and "
20442 "anything else that makes sense on the host side."
20443 msgstr ""
20444
20445 #. type: textblock
20446 #: ../fish/guestfish.pod:746
20447 msgid ""
20448 "To use a literal argument which begins with a pipe symbol, you have to quote "
20449 "it, eg:"
20450 msgstr ""
20451
20452 #. type: verbatim
20453 #: ../fish/guestfish.pod:749
20454 #, no-wrap
20455 msgid ""
20456 " echo \"|\"\n"
20457 "\n"
20458 msgstr ""
20459
20460 #. type: =head1
20461 #: ../fish/guestfish.pod:751
20462 msgid "HOME DIRECTORIES"
20463 msgstr ""
20464
20465 #. type: textblock
20466 #: ../fish/guestfish.pod:753
20467 msgid ""
20468 "If a parameter starts with the character C<~> then the tilde may be expanded "
20469 "as a home directory path (either C<~> for the current user's home directory, "
20470 "or C<~user> for another user)."
20471 msgstr ""
20472
20473 #. type: textblock
20474 #: ../fish/guestfish.pod:757
20475 msgid ""
20476 "Note that home directory expansion happens for users known I<on the host>, "
20477 "not in the guest filesystem."
20478 msgstr ""
20479
20480 #. type: textblock
20481 #: ../fish/guestfish.pod:760
20482 msgid ""
20483 "To use a literal argument which begins with a tilde, you have to quote it, "
20484 "eg:"
20485 msgstr ""
20486
20487 #. type: verbatim
20488 #: ../fish/guestfish.pod:763
20489 #, no-wrap
20490 msgid ""
20491 " echo \"~\"\n"
20492 "\n"
20493 msgstr ""
20494
20495 #. type: textblock
20496 #: ../fish/guestfish.pod:767
20497 msgid ""
20498 "Libguestfs has some support for Linux guests encrypted according to the "
20499 "Linux Unified Key Setup (LUKS) standard, which includes nearly all whole "
20500 "disk encryption systems used by modern Linux guests.  Currently only "
20501 "LVM-on-LUKS is supported."
20502 msgstr ""
20503
20504 #. type: textblock
20505 #: ../fish/guestfish.pod:772
20506 msgid "Identify encrypted block devices and partitions using L</vfs-type>:"
20507 msgstr ""
20508
20509 #. type: verbatim
20510 #: ../fish/guestfish.pod:774
20511 #, no-wrap
20512 msgid ""
20513 " ><fs> vfs-type /dev/sda2\n"
20514 " crypto_LUKS\n"
20515 "\n"
20516 msgstr ""
20517
20518 #. type: textblock
20519 #: ../fish/guestfish.pod:777
20520 msgid ""
20521 "Then open those devices using L</luks-open>.  This creates a device-mapper "
20522 "device called C</dev/mapper/luksdev>."
20523 msgstr ""
20524
20525 #. type: verbatim
20526 #: ../fish/guestfish.pod:780
20527 #, no-wrap
20528 msgid ""
20529 " ><fs> luks-open /dev/sda2 luksdev\n"
20530 " Enter key or passphrase (\"key\"): <enter the passphrase>\n"
20531 "\n"
20532 msgstr ""
20533
20534 #. type: textblock
20535 #: ../fish/guestfish.pod:783
20536 msgid ""
20537 "Finally you have to tell LVM to scan for volume groups on the newly created "
20538 "mapper device:"
20539 msgstr ""
20540
20541 #. type: verbatim
20542 #: ../fish/guestfish.pod:786
20543 #, no-wrap
20544 msgid ""
20545 " vgscan\n"
20546 " vg-activate-all true\n"
20547 "\n"
20548 msgstr ""
20549
20550 #. type: textblock
20551 #: ../fish/guestfish.pod:789
20552 msgid "The logical volume(s) can now be mounted in the usual way."
20553 msgstr ""
20554
20555 #. type: textblock
20556 #: ../fish/guestfish.pod:791
20557 msgid ""
20558 "Before closing a LUKS device you must unmount any logical volumes on it and "
20559 "deactivate the volume groups by calling C<vg-activate false VG> on each "
20560 "one.  Then you can close the mapper device:"
20561 msgstr ""
20562
20563 #. type: verbatim
20564 #: ../fish/guestfish.pod:795
20565 #, no-wrap
20566 msgid ""
20567 " vg-activate false /dev/VG\n"
20568 " luks-close /dev/mapper/luksdev\n"
20569 "\n"
20570 msgstr ""
20571
20572 #. type: =head1
20573 #: ../fish/guestfish.pod:798 ../tools/virt-edit.pl:342
20574 msgid "WINDOWS PATHS"
20575 msgstr ""
20576
20577 #. type: textblock
20578 #: ../fish/guestfish.pod:800
20579 msgid ""
20580 "If a path is prefixed with C<win:> then you can use Windows-style drive "
20581 "letters and paths (with some limitations).  The following commands are "
20582 "equivalent:"
20583 msgstr ""
20584
20585 #. type: verbatim
20586 #: ../fish/guestfish.pod:804
20587 #, no-wrap
20588 msgid ""
20589 " file /WINDOWS/system32/config/system.LOG\n"
20590 "\n"
20591 msgstr ""
20592
20593 #. type: verbatim
20594 #: ../fish/guestfish.pod:806
20595 #, no-wrap
20596 msgid ""
20597 " file win:\\windows\\system32\\config\\system.log\n"
20598 "\n"
20599 msgstr ""
20600
20601 #. type: verbatim
20602 #: ../fish/guestfish.pod:808
20603 #, no-wrap
20604 msgid ""
20605 " file WIN:C:\\Windows\\SYSTEM32\\CONFIG\\SYSTEM.LOG\n"
20606 "\n"
20607 msgstr ""
20608
20609 #. type: textblock
20610 #: ../fish/guestfish.pod:810
20611 msgid ""
20612 "The parameter is rewritten \"behind the scenes\" by looking up the position "
20613 "where the drive is mounted, prepending that to the path, changing all "
20614 "backslash characters to forward slash, then resolving the result using "
20615 "L</case-sensitive-path>.  For example if the E: drive was mounted on C</e> "
20616 "then the parameter might be rewritten like this:"
20617 msgstr ""
20618
20619 #. type: verbatim
20620 #: ../fish/guestfish.pod:816
20621 #, no-wrap
20622 msgid ""
20623 " win:e:\\foo\\bar => /e/FOO/bar\n"
20624 "\n"
20625 msgstr ""
20626
20627 #. type: textblock
20628 #: ../fish/guestfish.pod:818
20629 msgid "This only works in argument positions that expect a path."
20630 msgstr ""
20631
20632 #. type: =head1
20633 #: ../fish/guestfish.pod:820
20634 msgid "UPLOADING AND DOWNLOADING FILES"
20635 msgstr ""
20636
20637 #. type: textblock
20638 #: ../fish/guestfish.pod:822
20639 msgid ""
20640 "For commands such as C<upload>, C<download>, C<tar-in>, C<tar-out> and "
20641 "others which upload from or download to a local file, you can use the "
20642 "special filename C<-> to mean \"from stdin\" or \"to stdout\".  For example:"
20643 msgstr ""
20644
20645 #. type: verbatim
20646 #: ../fish/guestfish.pod:826
20647 #, no-wrap
20648 msgid ""
20649 " upload - /foo\n"
20650 "\n"
20651 msgstr ""
20652
20653 #. type: textblock
20654 #: ../fish/guestfish.pod:828
20655 msgid "reads stdin and creates from that a file C</foo> in the disk image, and:"
20656 msgstr ""
20657
20658 #. type: verbatim
20659 #: ../fish/guestfish.pod:831
20660 #, no-wrap
20661 msgid ""
20662 " tar-out /etc - | tar tf -\n"
20663 "\n"
20664 msgstr ""
20665
20666 #. type: textblock
20667 #: ../fish/guestfish.pod:833
20668 msgid ""
20669 "writes the tarball to stdout and then pipes that into the external \"tar\" "
20670 "command (see L</PIPES>)."
20671 msgstr ""
20672
20673 #. type: textblock
20674 #: ../fish/guestfish.pod:836
20675 msgid ""
20676 "When using C<-> to read from stdin, the input is read up to the end of "
20677 "stdin.  You can also use a special \"heredoc\"-like syntax to read up to "
20678 "some arbitrary end marker:"
20679 msgstr ""
20680
20681 #. type: verbatim
20682 #: ../fish/guestfish.pod:840
20683 #, no-wrap
20684 msgid ""
20685 " upload -<<END /foo\n"
20686 " input line 1\n"
20687 " input line 2\n"
20688 " input line 3\n"
20689 " END\n"
20690 "\n"
20691 msgstr ""
20692
20693 #. type: textblock
20694 #: ../fish/guestfish.pod:846
20695 msgid ""
20696 "Any string of characters can be used instead of C<END>.  The end marker must "
20697 "appear on a line of its own, without any preceeding or following characters "
20698 "(not even spaces)."
20699 msgstr ""
20700
20701 #. type: textblock
20702 #: ../fish/guestfish.pod:850
20703 msgid ""
20704 "Note that the C<-E<lt>E<lt>> syntax only applies to parameters used to "
20705 "upload local files (so-called \"FileIn\" parameters in the generator)."
20706 msgstr ""
20707
20708 #. type: =head1
20709 #: ../fish/guestfish.pod:853
20710 msgid "EXIT ON ERROR BEHAVIOUR"
20711 msgstr ""
20712
20713 #. type: textblock
20714 #: ../fish/guestfish.pod:855
20715 msgid ""
20716 "By default, guestfish will ignore any errors when in interactive mode "
20717 "(ie. taking commands from a human over a tty), and will exit on the first "
20718 "error in non-interactive mode (scripts, commands given on the command line)."
20719 msgstr ""
20720
20721 #. type: textblock
20722 #: ../fish/guestfish.pod:860
20723 msgid ""
20724 "If you prefix a command with a I<-> character, then that command will not "
20725 "cause guestfish to exit, even if that (one) command returns an error."
20726 msgstr ""
20727
20728 #. type: =head1
20729 #: ../fish/guestfish.pod:864
20730 msgid "REMOTE CONTROL GUESTFISH OVER A SOCKET"
20731 msgstr ""
20732
20733 #. type: textblock
20734 #: ../fish/guestfish.pod:866
20735 msgid ""
20736 "Guestfish can be remote-controlled over a socket.  This is useful "
20737 "particularly in shell scripts where you want to make several different "
20738 "changes to a filesystem, but you don't want the overhead of starting up a "
20739 "guestfish process each time."
20740 msgstr ""
20741
20742 #. type: textblock
20743 #: ../fish/guestfish.pod:871
20744 msgid "Start a guestfish server process using:"
20745 msgstr ""
20746
20747 #. type: verbatim
20748 #: ../fish/guestfish.pod:873
20749 #, no-wrap
20750 msgid ""
20751 " eval \"`guestfish --listen`\"\n"
20752 "\n"
20753 msgstr ""
20754
20755 #. type: textblock
20756 #: ../fish/guestfish.pod:875
20757 msgid "and then send it commands by doing:"
20758 msgstr ""
20759
20760 #. type: verbatim
20761 #: ../fish/guestfish.pod:877
20762 #, no-wrap
20763 msgid ""
20764 " guestfish --remote cmd [...]\n"
20765 "\n"
20766 msgstr ""
20767
20768 #. type: textblock
20769 #: ../fish/guestfish.pod:879
20770 msgid "To cause the server to exit, send it the exit command:"
20771 msgstr ""
20772
20773 #. type: verbatim
20774 #: ../fish/guestfish.pod:881
20775 #, no-wrap
20776 msgid ""
20777 " guestfish --remote exit\n"
20778 "\n"
20779 msgstr ""
20780
20781 #. type: textblock
20782 #: ../fish/guestfish.pod:883
20783 msgid ""
20784 "Note that the server will normally exit if there is an error in a command.  "
20785 "You can change this in the usual way.  See section L</EXIT ON ERROR "
20786 "BEHAVIOUR>."
20787 msgstr ""
20788
20789 #. type: =head2
20790 #: ../fish/guestfish.pod:887
20791 msgid "CONTROLLING MULTIPLE GUESTFISH PROCESSES"
20792 msgstr ""
20793
20794 #. type: textblock
20795 #: ../fish/guestfish.pod:889
20796 msgid ""
20797 "The C<eval> statement sets the environment variable C<$GUESTFISH_PID>, which "
20798 "is how the I<--remote> option knows where to send the commands.  You can "
20799 "have several guestfish listener processes running using:"
20800 msgstr ""
20801
20802 #. type: verbatim
20803 #: ../fish/guestfish.pod:893
20804 #, no-wrap
20805 msgid ""
20806 " eval \"`guestfish --listen`\"\n"
20807 " pid1=$GUESTFISH_PID\n"
20808 " eval \"`guestfish --listen`\"\n"
20809 " pid2=$GUESTFISH_PID\n"
20810 " ...\n"
20811 " guestfish --remote=$pid1 cmd\n"
20812 " guestfish --remote=$pid2 cmd\n"
20813 "\n"
20814 msgstr ""
20815
20816 #. type: =head2
20817 #: ../fish/guestfish.pod:901
20818 msgid "REMOTE CONTROL AND CSH"
20819 msgstr ""
20820
20821 #. type: textblock
20822 #: ../fish/guestfish.pod:903
20823 msgid ""
20824 "When using csh-like shells (csh, tcsh etc) you have to add the I<--csh> "
20825 "option:"
20826 msgstr ""
20827
20828 #. type: verbatim
20829 #: ../fish/guestfish.pod:906
20830 #, no-wrap
20831 msgid ""
20832 " eval \"`guestfish --listen --csh`\"\n"
20833 "\n"
20834 msgstr ""
20835
20836 #. type: =head2
20837 #: ../fish/guestfish.pod:908
20838 msgid "REMOTE CONTROL DETAILS"
20839 msgstr ""
20840
20841 #. type: textblock
20842 #: ../fish/guestfish.pod:910
20843 msgid ""
20844 "Remote control happens over a Unix domain socket called "
20845 "C</tmp/.guestfish-$UID/socket-$PID>, where C<$UID> is the effective user ID "
20846 "of the process, and C<$PID> is the process ID of the server."
20847 msgstr ""
20848
20849 #. type: textblock
20850 #: ../fish/guestfish.pod:914
20851 msgid "Guestfish client and server versions must match exactly."
20852 msgstr ""
20853
20854 #. type: =head2
20855 #: ../fish/guestfish.pod:916
20856 msgid "REMOTE CONTROL RUN COMMAND HANGING"
20857 msgstr ""
20858
20859 #. type: textblock
20860 #: ../fish/guestfish.pod:918
20861 msgid ""
20862 "Using the C<run> (or C<launch>) command remotely in a command substitution "
20863 "context hangs, ie. don't do (note the backquotes):"
20864 msgstr ""
20865
20866 #. type: verbatim
20867 #: ../fish/guestfish.pod:921
20868 #, no-wrap
20869 msgid ""
20870 " a=`guestfish --remote run`\n"
20871 "\n"
20872 msgstr ""
20873
20874 #. type: textblock
20875 #: ../fish/guestfish.pod:923
20876 msgid ""
20877 "Since the C<run> command produces no output on stdout, this is not useful "
20878 "anyway.  For further information see "
20879 "L<https://bugzilla.redhat.com/show_bug.cgi?id=592910>."
20880 msgstr ""
20881
20882 #. type: =head1
20883 #: ../fish/guestfish.pod:927
20884 msgid "PREPARED DISK IMAGES"
20885 msgstr ""
20886
20887 #. type: textblock
20888 #: ../fish/guestfish.pod:929
20889 msgid ""
20890 "Use the I<-N type> or I<--new type> parameter to select one of a set of "
20891 "preformatted disk images that guestfish can make for you to save typing.  "
20892 "This is particularly useful for testing purposes.  This option is used "
20893 "instead of the I<-a> option, and like I<-a> can appear multiple times (and "
20894 "can be mixed with I<-a>)."
20895 msgstr ""
20896
20897 #. type: textblock
20898 #: ../fish/guestfish.pod:935
20899 msgid ""
20900 "The new disk is called C<test1.img> for the first I<-N>, C<test2.img> for "
20901 "the second and so on.  Existing files in the current directory are "
20902 "I<overwritten>."
20903 msgstr ""
20904
20905 #. type: textblock
20906 #: ../fish/guestfish.pod:939
20907 msgid ""
20908 "The type briefly describes how the disk should be sized, partitioned, how "
20909 "filesystem(s) should be created, and how content should be added.  "
20910 "Optionally the type can be followed by extra parameters, separated by C<:> "
20911 "(colon) characters.  For example, I<-N fs> creates a default 100MB, "
20912 "sparsely-allocated disk, containing a single partition, with the partition "
20913 "formatted as ext2.  I<-N fs:ext4:1G> is the same, but for an ext4 filesystem "
20914 "on a 1GB disk instead."
20915 msgstr ""
20916
20917 #. type: textblock
20918 #: ../fish/guestfish.pod:947
20919 msgid "To list the available types and any extra parameters they take, run:"
20920 msgstr ""
20921
20922 #. type: textblock
20923 #: ../fish/guestfish.pod:951
20924 msgid ""
20925 "Note that the prepared filesystem is not mounted.  You would usually have to "
20926 "use the C<mount /dev/sda1 /> command or add the I<-m /dev/sda1> option."
20927 msgstr ""
20928
20929 #. type: textblock
20930 #: ../fish/guestfish.pod:955
20931 msgid ""
20932 "If any I<-N> or I<--new> options are given, the guest is automatically "
20933 "launched."
20934 msgstr ""
20935
20936 #. type: textblock
20937 #: ../fish/guestfish.pod:960
20938 msgid "Create a 100MB disk with an ext4-formatted partition:"
20939 msgstr ""
20940
20941 #. type: verbatim
20942 #: ../fish/guestfish.pod:962
20943 #, no-wrap
20944 msgid ""
20945 " guestfish -N fs:ext4\n"
20946 "\n"
20947 msgstr ""
20948
20949 #. type: textblock
20950 #: ../fish/guestfish.pod:964
20951 msgid "Create a 32MB disk with a VFAT-formatted partition, and mount it:"
20952 msgstr ""
20953
20954 #. type: verbatim
20955 #: ../fish/guestfish.pod:966
20956 #, no-wrap
20957 msgid ""
20958 " guestfish -N fs:vfat:32M -m /dev/sda1\n"
20959 "\n"
20960 msgstr ""
20961
20962 #. type: textblock
20963 #: ../fish/guestfish.pod:968
20964 msgid "Create a blank 200MB disk:"
20965 msgstr ""
20966
20967 #. type: verbatim
20968 #: ../fish/guestfish.pod:970
20969 #, no-wrap
20970 msgid ""
20971 " guestfish -N disk:200M\n"
20972 "\n"
20973 msgstr ""
20974
20975 #. type: =head1
20976 #: ../fish/guestfish.pod:972
20977 msgid "PROGRESS BARS"
20978 msgstr ""
20979
20980 #. type: textblock
20981 #: ../fish/guestfish.pod:974
20982 msgid ""
20983 "Some (not all) long-running commands send progress notification messages as "
20984 "they are running.  Guestfish turns these messages into progress bars."
20985 msgstr ""
20986
20987 #. type: textblock
20988 #: ../fish/guestfish.pod:978
20989 msgid ""
20990 "When a command that supports progress bars takes longer than two seconds to "
20991 "run, and if progress bars are enabled, then you will see one appearing below "
20992 "the command:"
20993 msgstr ""
20994
20995 #. type: verbatim
20996 #: ../fish/guestfish.pod:982
20997 #, no-wrap
20998 msgid ""
20999 " ><fs> copy-size /large-file /another-file 2048M\n"
21000 " / 10% [#####-----------------------------------------] 00:30\n"
21001 "\n"
21002 msgstr ""
21003
21004 #. type: textblock
21005 #: ../fish/guestfish.pod:985
21006 msgid ""
21007 "The spinner on the left hand side moves round once for every progress "
21008 "notification received from the backend.  This is a (reasonably) golden "
21009 "assurance that the command is \"doing something\" even if the progress bar "
21010 "is not moving, because the command is able to send the progress "
21011 "notifications.  When the bar reaches 100% and the command finishes, the "
21012 "spinner disappears."
21013 msgstr ""
21014
21015 #. type: textblock
21016 #: ../fish/guestfish.pod:992
21017 msgid ""
21018 "Progress bars are enabled by default when guestfish is used interactively.  "
21019 "You can enable them even for non-interactive modes using I<--progress-bars>, "
21020 "and you can disable them completely using I<--no-progress-bars>."
21021 msgstr ""
21022
21023 #. type: =head1
21024 #: ../fish/guestfish.pod:997
21025 msgid "GUESTFISH COMMANDS"
21026 msgstr ""
21027
21028 #. type: textblock
21029 #: ../fish/guestfish.pod:999
21030 msgid ""
21031 "The commands in this section are guestfish convenience commands, in other "
21032 "words, they are not part of the L<guestfs(3)> API."
21033 msgstr ""
21034
21035 #. type: =head2
21036 #: ../fish/guestfish.pod:1002
21037 msgid "help"
21038 msgstr ""
21039
21040 #. type: verbatim
21041 #: ../fish/guestfish.pod:1004
21042 #, no-wrap
21043 msgid ""
21044 " help\n"
21045 " help cmd\n"
21046 "\n"
21047 msgstr ""
21048
21049 #. type: textblock
21050 #: ../fish/guestfish.pod:1007
21051 msgid "Without any parameter, this provides general help."
21052 msgstr ""
21053
21054 #. type: textblock
21055 #: ../fish/guestfish.pod:1009
21056 msgid "With a C<cmd> parameter, this displays detailed help for that command."
21057 msgstr ""
21058
21059 #. type: =head2
21060 #: ../fish/guestfish.pod:1011
21061 msgid "quit | exit"
21062 msgstr ""
21063
21064 #. type: textblock
21065 #: ../fish/guestfish.pod:1013
21066 msgid "This exits guestfish.  You can also use C<^D> key."
21067 msgstr ""
21068
21069 #. type: textblock
21070 #: ../fish/guestfish.pod:1015
21071 msgid "@FISH_COMMANDS@"
21072 msgstr ""
21073
21074 #. type: =head1
21075 #: ../fish/guestfish.pod:1017
21076 msgid "COMMANDS"
21077 msgstr ""
21078
21079 #. type: =head1
21080 #: ../fish/guestfish.pod:1021 ../test-tool/libguestfs-test-tool.pod:77
21081 msgid "EXIT CODE"
21082 msgstr ""
21083
21084 #. type: textblock
21085 #: ../fish/guestfish.pod:1023
21086 msgid ""
21087 "guestfish returns 0 if the commands completed without error, or 1 if there "
21088 "was an error."
21089 msgstr ""
21090
21091 #. type: =item
21092 #: ../fish/guestfish.pod:1030
21093 msgid "EDITOR"
21094 msgstr ""
21095
21096 #. type: textblock
21097 #: ../fish/guestfish.pod:1032
21098 msgid ""
21099 "The C<edit> command uses C<$EDITOR> as the editor.  If not set, it uses "
21100 "C<vi>."
21101 msgstr ""
21102
21103 #. type: =item
21104 #: ../fish/guestfish.pod:1035
21105 msgid "GUESTFISH_PID"
21106 msgstr ""
21107
21108 #. type: textblock
21109 #: ../fish/guestfish.pod:1037
21110 msgid ""
21111 "Used with the I<--remote> option to specify the remote guestfish process to "
21112 "control.  See section L</REMOTE CONTROL GUESTFISH OVER A SOCKET>."
21113 msgstr ""
21114
21115 #. type: =item
21116 #: ../fish/guestfish.pod:1041
21117 msgid "HEXEDITOR"
21118 msgstr ""
21119
21120 #. type: textblock
21121 #: ../fish/guestfish.pod:1043
21122 msgid ""
21123 "The L</hexedit> command uses C<$HEXEDITOR> as the external hex editor.  If "
21124 "not specified, the external L<hexedit(1)> program is used."
21125 msgstr ""
21126
21127 #. type: =item
21128 #: ../fish/guestfish.pod:1047
21129 msgid "HOME"
21130 msgstr ""
21131
21132 #. type: textblock
21133 #: ../fish/guestfish.pod:1049
21134 msgid ""
21135 "If compiled with GNU readline support, various files in the home directory "
21136 "can be used.  See L</FILES>."
21137 msgstr ""
21138
21139 #. type: textblock
21140 #: ../fish/guestfish.pod:1058
21141 msgid ""
21142 "Set C<LIBGUESTFS_DEBUG=1> to enable verbose messages.  This has the same "
21143 "effect as using the B<-v> option."
21144 msgstr ""
21145
21146 #. type: textblock
21147 #: ../fish/guestfish.pod:1070
21148 msgid ""
21149 "Set the path that guestfish uses to search for kernel and initrd.img.  See "
21150 "the discussion of paths in L<guestfs(3)>."
21151 msgstr ""
21152
21153 #. type: textblock
21154 #: ../fish/guestfish.pod:1081
21155 msgid "Set C<LIBGUESTFS_TRACE=1> to enable command traces."
21156 msgstr ""
21157
21158 #. type: =item
21159 #: ../fish/guestfish.pod:1083
21160 msgid "PAGER"
21161 msgstr ""
21162
21163 #. type: textblock
21164 #: ../fish/guestfish.pod:1085
21165 msgid ""
21166 "The C<more> command uses C<$PAGER> as the pager.  If not set, it uses "
21167 "C<more>."
21168 msgstr ""
21169
21170 #. type: =head1
21171 #: ../fish/guestfish.pod:1101 ../fuse/guestmount.pod:262
21172 msgid "FILES"
21173 msgstr ""
21174
21175 #. type: =item
21176 #: ../fish/guestfish.pod:1105 ../fuse/guestmount.pod:266
21177 msgid "$HOME/.libguestfs-tools.rc"
21178 msgstr ""
21179
21180 #. type: =item
21181 #: ../fish/guestfish.pod:1107 ../fuse/guestmount.pod:268
21182 msgid "/etc/libguestfs-tools.conf"
21183 msgstr ""
21184
21185 #. type: textblock
21186 #: ../fish/guestfish.pod:1109 ../fuse/guestmount.pod:270
21187 msgid ""
21188 "This configuration file controls the default read-only or read-write mode "
21189 "(I<--ro> or I<--rw>)."
21190 msgstr ""
21191
21192 #. type: textblock
21193 #: ../fish/guestfish.pod:1112
21194 msgid "See L</OPENING DISKS FOR READ AND WRITE>."
21195 msgstr ""
21196
21197 #. type: =item
21198 #: ../fish/guestfish.pod:1114
21199 msgid "$HOME/.guestfish"
21200 msgstr ""
21201
21202 #. type: textblock
21203 #: ../fish/guestfish.pod:1116
21204 msgid ""
21205 "If compiled with GNU readline support, then the command history is saved in "
21206 "this file."
21207 msgstr ""
21208
21209 #. type: =item
21210 #: ../fish/guestfish.pod:1119
21211 msgid "$HOME/.inputrc"
21212 msgstr ""
21213
21214 #. type: =item
21215 #: ../fish/guestfish.pod:1121
21216 msgid "/etc/inputrc"
21217 msgstr ""
21218
21219 #. type: textblock
21220 #: ../fish/guestfish.pod:1123
21221 msgid ""
21222 "If compiled with GNU readline support, then these files can be used to "
21223 "configure readline.  For further information, please see "
21224 "L<readline(3)/INITIALIZATION FILE>."
21225 msgstr ""
21226
21227 #. type: textblock
21228 #: ../fish/guestfish.pod:1127
21229 msgid "To write rules which only apply to guestfish, use:"
21230 msgstr ""
21231
21232 #. type: verbatim
21233 #: ../fish/guestfish.pod:1129
21234 #, no-wrap
21235 msgid ""
21236 " $if guestfish\n"
21237 " ...\n"
21238 " $endif\n"
21239 "\n"
21240 msgstr ""
21241
21242 #. type: textblock
21243 #: ../fish/guestfish.pod:1133
21244 msgid ""
21245 "Variables that you can set in inputrc that change the behaviour of guestfish "
21246 "in useful ways include:"
21247 msgstr ""
21248
21249 #. type: =item
21250 #: ../fish/guestfish.pod:1138
21251 msgid "completion-ignore-case (default: on)"
21252 msgstr ""
21253
21254 #. type: textblock
21255 #: ../fish/guestfish.pod:1140
21256 msgid ""
21257 "By default, guestfish will ignore case when tab-completing paths on the "
21258 "disk.  Use:"
21259 msgstr ""
21260
21261 #. type: verbatim
21262 #: ../fish/guestfish.pod:1143
21263 #, no-wrap
21264 msgid ""
21265 " set completion-ignore-case off\n"
21266 "\n"
21267 msgstr ""
21268
21269 #. type: textblock
21270 #: ../fish/guestfish.pod:1145
21271 msgid "to make guestfish case sensitive."
21272 msgstr ""
21273
21274 #. type: =item
21275 #: ../fish/guestfish.pod:1149
21276 msgid "test1.img"
21277 msgstr ""
21278
21279 #. type: =item
21280 #: ../fish/guestfish.pod:1151
21281 msgid "test2.img (etc)"
21282 msgstr ""
21283
21284 #. type: textblock
21285 #: ../fish/guestfish.pod:1153
21286 msgid ""
21287 "When using the I<-N> or I<--new> option, the prepared disk or filesystem "
21288 "will be created in the file C<test1.img> in the current directory.  The "
21289 "second use of I<-N> will use C<test2.img> and so on.  Any existing file with "
21290 "the same name will be overwritten."
21291 msgstr ""
21292
21293 #. type: textblock
21294 #: ../fish/guestfish.pod:1162
21295 msgid ""
21296 "L<guestfs(3)>, L<http://libguestfs.org/>, L<virt-cat(1)>, "
21297 "L<virt-copy-in(1)>, L<virt-copy-out(1)>, L<virt-df(1)>, L<virt-edit(1)>, "
21298 "L<virt-filesystems(1)>, L<virt-inspector(1)>, L<virt-list-filesystems(1)>, "
21299 "L<virt-list-partitions(1)>, L<virt-ls(1)>, L<virt-make-fs(1)>, "
21300 "L<virt-rescue(1)>, L<virt-resize(1)>, L<virt-tar(1)>, L<virt-tar-in(1)>, "
21301 "L<virt-tar-out(1)>, L<virt-win-reg(1)>, L<hexedit(1)>."
21302 msgstr ""
21303
21304 #. type: textblock
21305 #: ../fish/guestfish.pod:1192 ../test-tool/libguestfs-test-tool.pod:102 ../fuse/guestmount.pod:297 ../tools/virt-edit.pl:518 ../tools/virt-win-reg.pl:606 ../tools/virt-list-filesystems.pl:210 ../tools/virt-tar.pl:309 ../tools/virt-make-fs.pl:572 ../tools/virt-list-partitions.pl:277
21306 msgid ""
21307 "This program is free software; you can redistribute it and/or modify it "
21308 "under the terms of the GNU General Public License as published by the Free "
21309 "Software Foundation; either version 2 of the License, or (at your option) "
21310 "any later version."
21311 msgstr ""
21312
21313 #. type: textblock
21314 #: ../fish/guestfish.pod:1197 ../test-tool/libguestfs-test-tool.pod:107 ../fuse/guestmount.pod:302 ../tools/virt-edit.pl:523 ../tools/virt-win-reg.pl:611 ../tools/virt-list-filesystems.pl:215 ../tools/virt-tar.pl:314 ../tools/virt-make-fs.pl:577 ../tools/virt-list-partitions.pl:282
21315 msgid ""
21316 "This program is distributed in the hope that it will be useful, but WITHOUT "
21317 "ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or "
21318 "FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for "
21319 "more details."
21320 msgstr ""
21321
21322 #. type: textblock
21323 #: ../fish/guestfish.pod:1202 ../test-tool/libguestfs-test-tool.pod:112 ../fuse/guestmount.pod:307 ../tools/virt-edit.pl:528 ../tools/virt-win-reg.pl:616 ../tools/virt-list-filesystems.pl:220 ../tools/virt-tar.pl:319 ../tools/virt-make-fs.pl:582 ../tools/virt-list-partitions.pl:287
21324 msgid ""
21325 "You should have received a copy of the GNU General Public License along with "
21326 "this program; if not, write to the Free Software Foundation, Inc., 675 Mass "
21327 "Ave, Cambridge, MA 02139, USA."
21328 msgstr ""
21329
21330 #. type: =head2
21331 #: ../fish/guestfish-actions.pod:1
21332 msgid "add-cdrom"
21333 msgstr ""
21334
21335 #. type: verbatim
21336 #: ../fish/guestfish-actions.pod:3
21337 #, no-wrap
21338 msgid ""
21339 " add-cdrom filename\n"
21340 "\n"
21341 msgstr ""
21342
21343 #. type: textblock
21344 #: ../fish/guestfish-actions.pod:15
21345 msgid ""
21346 "This call checks for the existence of C<filename>.  This stops you from "
21347 "specifying other types of drive which are supported by qemu such as C<nbd:> "
21348 "and C<http:> URLs.  To specify those, use the general L</config> call "
21349 "instead."
21350 msgstr ""
21351
21352 #. type: textblock
21353 #: ../fish/guestfish-actions.pod:22
21354 msgid ""
21355 "If you just want to add an ISO file (often you use this as an efficient way "
21356 "to transfer large files into the guest), then you should probably use "
21357 "L</add-drive-ro> instead."
21358 msgstr ""
21359
21360 #. type: textblock
21361 #: ../fish/guestfish-actions.pod:28 ../fish/guestfish-actions.pod:158 ../fish/guestfish-actions.pod:172
21362 msgid ""
21363 "This function is deprecated.  In new code, use the L</add_drive_opts> call "
21364 "instead."
21365 msgstr ""
21366
21367 #. type: =head2
21368 #: ../fish/guestfish-actions.pod:35
21369 msgid "add-domain"
21370 msgstr ""
21371
21372 #. type: =head2
21373 #: ../fish/guestfish-actions.pod:37
21374 msgid "domain"
21375 msgstr ""
21376
21377 #. type: verbatim
21378 #: ../fish/guestfish-actions.pod:39
21379 #, no-wrap
21380 msgid ""
21381 " add-domain dom [libvirturi:..] [readonly:..] [iface:..] [live:..]\n"
21382 "\n"
21383 msgstr ""
21384
21385 #. type: textblock
21386 #: ../fish/guestfish-actions.pod:41
21387 msgid ""
21388 "This function adds the disk(s) attached to the named libvirt domain C<dom>.  "
21389 "It works by connecting to libvirt, requesting the domain and domain XML from "
21390 "libvirt, parsing it for disks, and calling L</add-drive-opts> on each one."
21391 msgstr ""
21392
21393 #. type: textblock
21394 #: ../fish/guestfish-actions.pod:71
21395 msgid ""
21396 "The other optional parameters are passed directly through to "
21397 "L</add-drive-opts>."
21398 msgstr ""
21399
21400 #. type: textblock
21401 #: ../fish/guestfish-actions.pod:74 ../fish/guestfish-actions.pod:138 ../fish/guestfish-actions.pod:3049
21402 msgid ""
21403 "This command has one or more optional arguments.  See L</OPTIONAL "
21404 "ARGUMENTS>."
21405 msgstr ""
21406
21407 #. type: =head2
21408 #: ../fish/guestfish-actions.pod:76
21409 msgid "add-drive"
21410 msgstr ""
21411
21412 #. type: verbatim
21413 #: ../fish/guestfish-actions.pod:78
21414 #, no-wrap
21415 msgid ""
21416 " add-drive filename\n"
21417 "\n"
21418 msgstr ""
21419
21420 #. type: textblock
21421 #: ../fish/guestfish-actions.pod:80
21422 msgid ""
21423 "This function is the equivalent of calling L</add-drive-opts> with no "
21424 "optional parameters, so the disk is added writable, with the format being "
21425 "detected automatically."
21426 msgstr ""
21427
21428 #. type: textblock
21429 #: ../fish/guestfish-actions.pod:84
21430 msgid ""
21431 "Automatic detection of the format opens you up to a potential security hole "
21432 "when dealing with untrusted raw-format images.  See CVE-2010-3851 and "
21433 "RHBZ#642934.  Specifying the format closes this security hole.  Therefore "
21434 "you should think about replacing calls to this function with calls to "
21435 "L</add-drive-opts>, and specifying the format."
21436 msgstr ""
21437
21438 #. type: =head2
21439 #: ../fish/guestfish-actions.pod:91
21440 msgid "add-drive-opts"
21441 msgstr ""
21442
21443 #. type: =head2
21444 #: ../fish/guestfish-actions.pod:93
21445 msgid "add"
21446 msgstr ""
21447
21448 #. type: verbatim
21449 #: ../fish/guestfish-actions.pod:95
21450 #, no-wrap
21451 msgid ""
21452 " add-drive-opts filename [readonly:..] [format:..] [iface:..]\n"
21453 "\n"
21454 msgstr ""
21455
21456 #. type: textblock
21457 #: ../fish/guestfish-actions.pod:122
21458 msgid ""
21459 "This forces the image format.  If you omit this (or use L</add-drive> or "
21460 "L</add-drive-ro>) then the format is automatically detected.  Possible "
21461 "formats include C<raw> and C<qcow2>."
21462 msgstr ""
21463
21464 #. type: textblock
21465 #: ../fish/guestfish-actions.pod:133
21466 msgid ""
21467 "This rarely-used option lets you emulate the behaviour of the deprecated "
21468 "L</add-drive-with-if> call (q.v.)"
21469 msgstr ""
21470
21471 #. type: =head2
21472 #: ../fish/guestfish-actions.pod:140
21473 msgid "add-drive-ro"
21474 msgstr ""
21475
21476 #. type: =head2
21477 #: ../fish/guestfish-actions.pod:142
21478 msgid "add-ro"
21479 msgstr ""
21480
21481 #. type: verbatim
21482 #: ../fish/guestfish-actions.pod:144
21483 #, no-wrap
21484 msgid ""
21485 " add-drive-ro filename\n"
21486 "\n"
21487 msgstr ""
21488
21489 #. type: textblock
21490 #: ../fish/guestfish-actions.pod:146
21491 msgid ""
21492 "This function is the equivalent of calling L</add-drive-opts> with the "
21493 "optional parameter C<GUESTFS_ADD_DRIVE_OPTS_READONLY> set to 1, so the disk "
21494 "is added read-only, with the format being detected automatically."
21495 msgstr ""
21496
21497 #. type: =head2
21498 #: ../fish/guestfish-actions.pod:151
21499 msgid "add-drive-ro-with-if"
21500 msgstr ""
21501
21502 #. type: verbatim
21503 #: ../fish/guestfish-actions.pod:153
21504 #, no-wrap
21505 msgid ""
21506 " add-drive-ro-with-if filename iface\n"
21507 "\n"
21508 msgstr ""
21509
21510 #. type: textblock
21511 #: ../fish/guestfish-actions.pod:155
21512 msgid ""
21513 "This is the same as L</add-drive-ro> but it allows you to specify the QEMU "
21514 "interface emulation to use at run time."
21515 msgstr ""
21516
21517 #. type: =head2
21518 #: ../fish/guestfish-actions.pod:165
21519 msgid "add-drive-with-if"
21520 msgstr ""
21521
21522 #. type: verbatim
21523 #: ../fish/guestfish-actions.pod:167
21524 #, no-wrap
21525 msgid ""
21526 " add-drive-with-if filename iface\n"
21527 "\n"
21528 msgstr ""
21529
21530 #. type: textblock
21531 #: ../fish/guestfish-actions.pod:169
21532 msgid ""
21533 "This is the same as L</add-drive> but it allows you to specify the QEMU "
21534 "interface emulation to use at run time."
21535 msgstr ""
21536
21537 #. type: =head2
21538 #: ../fish/guestfish-actions.pod:179
21539 msgid "aug-clear"
21540 msgstr ""
21541
21542 #. type: verbatim
21543 #: ../fish/guestfish-actions.pod:181
21544 #, no-wrap
21545 msgid ""
21546 " aug-clear augpath\n"
21547 "\n"
21548 msgstr ""
21549
21550 #. type: =head2
21551 #: ../fish/guestfish-actions.pod:186
21552 msgid "aug-close"
21553 msgstr ""
21554
21555 #. type: verbatim
21556 #: ../fish/guestfish-actions.pod:188
21557 #, no-wrap
21558 msgid ""
21559 " aug-close\n"
21560 "\n"
21561 msgstr ""
21562
21563 #. type: textblock
21564 #: ../fish/guestfish-actions.pod:190
21565 msgid ""
21566 "Close the current Augeas handle and free up any resources used by it.  After "
21567 "calling this, you have to call L</aug-init> again before you can use any "
21568 "other Augeas functions."
21569 msgstr ""
21570
21571 #. type: =head2
21572 #: ../fish/guestfish-actions.pod:195
21573 msgid "aug-defnode"
21574 msgstr ""
21575
21576 #. type: verbatim
21577 #: ../fish/guestfish-actions.pod:197
21578 #, no-wrap
21579 msgid ""
21580 " aug-defnode name expr val\n"
21581 "\n"
21582 msgstr ""
21583
21584 #. type: textblock
21585 #: ../fish/guestfish-actions.pod:202
21586 msgid ""
21587 "If C<expr> evaluates to an empty nodeset, a node is created, equivalent to "
21588 "calling L</aug-set> C<expr>, C<value>.  C<name> will be the nodeset "
21589 "containing that single node."
21590 msgstr ""
21591
21592 #. type: =head2
21593 #: ../fish/guestfish-actions.pod:210
21594 msgid "aug-defvar"
21595 msgstr ""
21596
21597 #. type: verbatim
21598 #: ../fish/guestfish-actions.pod:212
21599 #, no-wrap
21600 msgid ""
21601 " aug-defvar name expr\n"
21602 "\n"
21603 msgstr ""
21604
21605 #. type: =head2
21606 #: ../fish/guestfish-actions.pod:221
21607 msgid "aug-get"
21608 msgstr ""
21609
21610 #. type: verbatim
21611 #: ../fish/guestfish-actions.pod:223
21612 #, no-wrap
21613 msgid ""
21614 " aug-get augpath\n"
21615 "\n"
21616 msgstr ""
21617
21618 #. type: =head2
21619 #: ../fish/guestfish-actions.pod:228
21620 msgid "aug-init"
21621 msgstr ""
21622
21623 #. type: verbatim
21624 #: ../fish/guestfish-actions.pod:230
21625 #, no-wrap
21626 msgid ""
21627 " aug-init root flags\n"
21628 "\n"
21629 msgstr ""
21630
21631 #. type: textblock
21632 #: ../fish/guestfish-actions.pod:236
21633 msgid "You must call this before using any other L</aug-*> commands."
21634 msgstr ""
21635
21636 #. type: textblock
21637 #: ../fish/guestfish-actions.pod:261
21638 msgid ""
21639 "This option is only useful when debugging Augeas lenses.  Use of this option "
21640 "may require additional memory for the libguestfs appliance.  You may need to "
21641 "set the C<LIBGUESTFS_MEMSIZE> environment variable or call L</set-memsize>."
21642 msgstr ""
21643
21644 #. type: textblock
21645 #: ../fish/guestfish-actions.pod:276
21646 msgid "Do not load the tree in L</aug-init>."
21647 msgstr ""
21648
21649 #. type: textblock
21650 #: ../fish/guestfish-actions.pod:280
21651 msgid "To close the handle, you can call L</aug-close>."
21652 msgstr ""
21653
21654 #. type: =head2
21655 #: ../fish/guestfish-actions.pod:284
21656 msgid "aug-insert"
21657 msgstr ""
21658
21659 #. type: verbatim
21660 #: ../fish/guestfish-actions.pod:286
21661 #, no-wrap
21662 msgid ""
21663 " aug-insert augpath label true|false\n"
21664 "\n"
21665 msgstr ""
21666
21667 #. type: =head2
21668 #: ../fish/guestfish-actions.pod:296
21669 msgid "aug-load"
21670 msgstr ""
21671
21672 #. type: verbatim
21673 #: ../fish/guestfish-actions.pod:298
21674 #, no-wrap
21675 msgid ""
21676 " aug-load\n"
21677 "\n"
21678 msgstr ""
21679
21680 #. type: =head2
21681 #: ../fish/guestfish-actions.pod:305
21682 msgid "aug-ls"
21683 msgstr ""
21684
21685 #. type: verbatim
21686 #: ../fish/guestfish-actions.pod:307
21687 #, no-wrap
21688 msgid ""
21689 " aug-ls augpath\n"
21690 "\n"
21691 msgstr ""
21692
21693 #. type: textblock
21694 #: ../fish/guestfish-actions.pod:309
21695 msgid ""
21696 "This is just a shortcut for listing L</aug-match> C<path/*> and sorting the "
21697 "resulting nodes into alphabetical order."
21698 msgstr ""
21699
21700 #. type: =head2
21701 #: ../fish/guestfish-actions.pod:312
21702 msgid "aug-match"
21703 msgstr ""
21704
21705 #. type: verbatim
21706 #: ../fish/guestfish-actions.pod:314
21707 #, no-wrap
21708 msgid ""
21709 " aug-match augpath\n"
21710 "\n"
21711 msgstr ""
21712
21713 #. type: =head2
21714 #: ../fish/guestfish-actions.pod:320
21715 msgid "aug-mv"
21716 msgstr ""
21717
21718 #. type: verbatim
21719 #: ../fish/guestfish-actions.pod:322
21720 #, no-wrap
21721 msgid ""
21722 " aug-mv src dest\n"
21723 "\n"
21724 msgstr ""
21725
21726 #. type: =head2
21727 #: ../fish/guestfish-actions.pod:327
21728 msgid "aug-rm"
21729 msgstr ""
21730
21731 #. type: verbatim
21732 #: ../fish/guestfish-actions.pod:329
21733 #, no-wrap
21734 msgid ""
21735 " aug-rm augpath\n"
21736 "\n"
21737 msgstr ""
21738
21739 #. type: =head2
21740 #: ../fish/guestfish-actions.pod:335
21741 msgid "aug-save"
21742 msgstr ""
21743
21744 #. type: verbatim
21745 #: ../fish/guestfish-actions.pod:337
21746 #, no-wrap
21747 msgid ""
21748 " aug-save\n"
21749 "\n"
21750 msgstr ""
21751
21752 #. type: textblock
21753 #: ../fish/guestfish-actions.pod:341
21754 msgid ""
21755 "The flags which were passed to L</aug-init> affect exactly how files are "
21756 "saved."
21757 msgstr ""
21758
21759 #. type: =head2
21760 #: ../fish/guestfish-actions.pod:344
21761 msgid "aug-set"
21762 msgstr ""
21763
21764 #. type: verbatim
21765 #: ../fish/guestfish-actions.pod:346
21766 #, no-wrap
21767 msgid ""
21768 " aug-set augpath val\n"
21769 "\n"
21770 msgstr ""
21771
21772 #. type: textblock
21773 #: ../fish/guestfish-actions.pod:350
21774 msgid ""
21775 "In the Augeas API, it is possible to clear a node by setting the value to "
21776 "NULL.  Due to an oversight in the libguestfs API you cannot do that with "
21777 "this call.  Instead you must use the L</aug-clear> call."
21778 msgstr ""
21779
21780 #. type: =head2
21781 #: ../fish/guestfish-actions.pod:355
21782 msgid "available"
21783 msgstr ""
21784
21785 #. type: verbatim
21786 #: ../fish/guestfish-actions.pod:357
21787 #, no-wrap
21788 msgid ""
21789 " available 'groups ...'\n"
21790 "\n"
21791 msgstr ""
21792
21793 #. type: textblock
21794 #: ../fish/guestfish-actions.pod:363
21795 msgid ""
21796 "The libguestfs groups, and the functions that those groups correspond to, "
21797 "are listed in L<guestfs(3)/AVAILABILITY>.  You can also fetch this list at "
21798 "runtime by calling L</available-all-groups>."
21799 msgstr ""
21800
21801 #. type: textblock
21802 #: ../fish/guestfish-actions.pod:387
21803 msgid "You must call L</launch> before calling this function."
21804 msgstr ""
21805
21806 #. type: textblock
21807 #: ../fish/guestfish-actions.pod:409
21808 msgid ""
21809 "This call was added in version C<1.0.80>.  In previous versions of "
21810 "libguestfs all you could do would be to speculatively execute a command to "
21811 "find out if the daemon implemented it.  See also L</version>."
21812 msgstr ""
21813
21814 #. type: =head2
21815 #: ../fish/guestfish-actions.pod:416
21816 msgid "available-all-groups"
21817 msgstr ""
21818
21819 #. type: verbatim
21820 #: ../fish/guestfish-actions.pod:418
21821 #, no-wrap
21822 msgid ""
21823 " available-all-groups\n"
21824 "\n"
21825 msgstr ""
21826
21827 #. type: textblock
21828 #: ../fish/guestfish-actions.pod:420
21829 msgid ""
21830 "This command returns a list of all optional groups that this daemon knows "
21831 "about.  Note this returns both supported and unsupported groups.  To find "
21832 "out which ones the daemon can actually support you have to call "
21833 "L</available> on each member of the returned list."
21834 msgstr ""
21835
21836 #. type: textblock
21837 #: ../fish/guestfish-actions.pod:426
21838 msgid "See also L</available> and L<guestfs(3)/AVAILABILITY>."
21839 msgstr ""
21840
21841 #. type: =head2
21842 #: ../fish/guestfish-actions.pod:428
21843 msgid "base64-in"
21844 msgstr ""
21845
21846 #. type: verbatim
21847 #: ../fish/guestfish-actions.pod:430
21848 #, no-wrap
21849 msgid ""
21850 " base64-in (base64file|-) filename\n"
21851 "\n"
21852 msgstr ""
21853
21854 #. type: textblock
21855 #: ../fish/guestfish-actions.pod:435 ../fish/guestfish-actions.pod:444 ../fish/guestfish-actions.pod:668 ../fish/guestfish-actions.pod:837 ../fish/guestfish-actions.pod:856 ../fish/guestfish-actions.pod:1230 ../fish/guestfish-actions.pod:4491 ../fish/guestfish-actions.pod:4503 ../fish/guestfish-actions.pod:4514 ../fish/guestfish-actions.pod:4525 ../fish/guestfish-actions.pod:4577 ../fish/guestfish-actions.pod:4586 ../fish/guestfish-actions.pod:4640 ../fish/guestfish-actions.pod:4663
21856 msgid "Use C<-> instead of a filename to read/write from stdin/stdout."
21857 msgstr ""
21858
21859 #. type: =head2
21860 #: ../fish/guestfish-actions.pod:437
21861 msgid "base64-out"
21862 msgstr ""
21863
21864 #. type: verbatim
21865 #: ../fish/guestfish-actions.pod:439
21866 #, no-wrap
21867 msgid ""
21868 " base64-out filename (base64file|-)\n"
21869 "\n"
21870 msgstr ""
21871
21872 #. type: =head2
21873 #: ../fish/guestfish-actions.pod:446
21874 msgid "blockdev-flushbufs"
21875 msgstr ""
21876
21877 #. type: verbatim
21878 #: ../fish/guestfish-actions.pod:448
21879 #, no-wrap
21880 msgid ""
21881 " blockdev-flushbufs device\n"
21882 "\n"
21883 msgstr ""
21884
21885 #. type: =head2
21886 #: ../fish/guestfish-actions.pod:455
21887 msgid "blockdev-getbsz"
21888 msgstr ""
21889
21890 #. type: verbatim
21891 #: ../fish/guestfish-actions.pod:457
21892 #, no-wrap
21893 msgid ""
21894 " blockdev-getbsz device\n"
21895 "\n"
21896 msgstr ""
21897
21898 #. type: =head2
21899 #: ../fish/guestfish-actions.pod:466
21900 msgid "blockdev-getro"
21901 msgstr ""
21902
21903 #. type: verbatim
21904 #: ../fish/guestfish-actions.pod:468
21905 #, no-wrap
21906 msgid ""
21907 " blockdev-getro device\n"
21908 "\n"
21909 msgstr ""
21910
21911 #. type: =head2
21912 #: ../fish/guestfish-actions.pod:475
21913 msgid "blockdev-getsize64"
21914 msgstr ""
21915
21916 #. type: verbatim
21917 #: ../fish/guestfish-actions.pod:477
21918 #, no-wrap
21919 msgid ""
21920 " blockdev-getsize64 device\n"
21921 "\n"
21922 msgstr ""
21923
21924 #. type: textblock
21925 #: ../fish/guestfish-actions.pod:481
21926 msgid "See also L</blockdev-getsz>."
21927 msgstr ""
21928
21929 #. type: =head2
21930 #: ../fish/guestfish-actions.pod:485
21931 msgid "blockdev-getss"
21932 msgstr ""
21933
21934 #. type: verbatim
21935 #: ../fish/guestfish-actions.pod:487
21936 #, no-wrap
21937 msgid ""
21938 " blockdev-getss device\n"
21939 "\n"
21940 msgstr ""
21941
21942 #. type: textblock
21943 #: ../fish/guestfish-actions.pod:492
21944 msgid "(Note, this is not the size in sectors, use L</blockdev-getsz> for that)."
21945 msgstr ""
21946
21947 #. type: =head2
21948 #: ../fish/guestfish-actions.pod:497
21949 msgid "blockdev-getsz"
21950 msgstr ""
21951
21952 #. type: verbatim
21953 #: ../fish/guestfish-actions.pod:499
21954 #, no-wrap
21955 msgid ""
21956 " blockdev-getsz device\n"
21957 "\n"
21958 msgstr ""
21959
21960 #. type: textblock
21961 #: ../fish/guestfish-actions.pod:504
21962 msgid ""
21963 "See also L</blockdev-getss> for the real sector size of the device, and "
21964 "L</blockdev-getsize64> for the more useful I<size in bytes>."
21965 msgstr ""
21966
21967 #. type: =head2
21968 #: ../fish/guestfish-actions.pod:510
21969 msgid "blockdev-rereadpt"
21970 msgstr ""
21971
21972 #. type: verbatim
21973 #: ../fish/guestfish-actions.pod:512
21974 #, no-wrap
21975 msgid ""
21976 " blockdev-rereadpt device\n"
21977 "\n"
21978 msgstr ""
21979
21980 #. type: =head2
21981 #: ../fish/guestfish-actions.pod:518
21982 msgid "blockdev-setbsz"
21983 msgstr ""
21984
21985 #. type: verbatim
21986 #: ../fish/guestfish-actions.pod:520
21987 #, no-wrap
21988 msgid ""
21989 " blockdev-setbsz device blocksize\n"
21990 "\n"
21991 msgstr ""
21992
21993 #. type: =head2
21994 #: ../fish/guestfish-actions.pod:529
21995 msgid "blockdev-setro"
21996 msgstr ""
21997
21998 #. type: verbatim
21999 #: ../fish/guestfish-actions.pod:531
22000 #, no-wrap
22001 msgid ""
22002 " blockdev-setro device\n"
22003 "\n"
22004 msgstr ""
22005
22006 #. type: =head2
22007 #: ../fish/guestfish-actions.pod:537
22008 msgid "blockdev-setrw"
22009 msgstr ""
22010
22011 #. type: verbatim
22012 #: ../fish/guestfish-actions.pod:539
22013 #, no-wrap
22014 msgid ""
22015 " blockdev-setrw device\n"
22016 "\n"
22017 msgstr ""
22018
22019 #. type: =head2
22020 #: ../fish/guestfish-actions.pod:545
22021 msgid "case-sensitive-path"
22022 msgstr ""
22023
22024 #. type: verbatim
22025 #: ../fish/guestfish-actions.pod:547
22026 #, no-wrap
22027 msgid ""
22028 " case-sensitive-path path\n"
22029 "\n"
22030 msgstr ""
22031
22032 #. type: textblock
22033 #: ../fish/guestfish-actions.pod:571
22034 msgid ""
22035 "Thus L</case-sensitive-path> (\"/Windows/System32\")  might return "
22036 "C<\"/WINDOWS/system32\"> (the exact return value would depend on details of "
22037 "how the directories were originally created under Windows)."
22038 msgstr ""
22039
22040 #. type: textblock
22041 #: ../fish/guestfish-actions.pod:579
22042 msgid "See also L</realpath>."
22043 msgstr ""
22044
22045 #. type: =head2
22046 #: ../fish/guestfish-actions.pod:581
22047 msgid "cat"
22048 msgstr ""
22049
22050 #. type: verbatim
22051 #: ../fish/guestfish-actions.pod:583
22052 #, no-wrap
22053 msgid ""
22054 " cat path\n"
22055 "\n"
22056 msgstr ""
22057
22058 #. type: textblock
22059 #: ../fish/guestfish-actions.pod:587
22060 msgid ""
22061 "Note that this function cannot correctly handle binary files (specifically, "
22062 "files containing C<\\0> character which is treated as end of string).  For "
22063 "those you need to use the L</read-file> or L</download> functions which have "
22064 "a more complex interface."
22065 msgstr ""
22066
22067 #. type: =head2
22068 #: ../fish/guestfish-actions.pod:595
22069 msgid "checksum"
22070 msgstr ""
22071
22072 #. type: verbatim
22073 #: ../fish/guestfish-actions.pod:597
22074 #, no-wrap
22075 msgid ""
22076 " checksum csumtype path\n"
22077 "\n"
22078 msgstr ""
22079
22080 #. type: textblock
22081 #: ../fish/guestfish-actions.pod:640
22082 msgid "To get the checksum for a device, use L</checksum-device>."
22083 msgstr ""
22084
22085 #. type: textblock
22086 #: ../fish/guestfish-actions.pod:642
22087 msgid "To get the checksums for many files, use L</checksums-out>."
22088 msgstr ""
22089
22090 #. type: =head2
22091 #: ../fish/guestfish-actions.pod:644
22092 msgid "checksum-device"
22093 msgstr ""
22094
22095 #. type: verbatim
22096 #: ../fish/guestfish-actions.pod:646
22097 #, no-wrap
22098 msgid ""
22099 " checksum-device csumtype device\n"
22100 "\n"
22101 msgstr ""
22102
22103 #. type: textblock
22104 #: ../fish/guestfish-actions.pod:648
22105 msgid ""
22106 "This call computes the MD5, SHAx or CRC checksum of the contents of the "
22107 "device named C<device>.  For the types of checksums supported see the "
22108 "L</checksum> command."
22109 msgstr ""
22110
22111 #. type: =head2
22112 #: ../fish/guestfish-actions.pod:652
22113 msgid "checksums-out"
22114 msgstr ""
22115
22116 #. type: verbatim
22117 #: ../fish/guestfish-actions.pod:654
22118 #, no-wrap
22119 msgid ""
22120 " checksums-out csumtype directory (sumsfile|-)\n"
22121 "\n"
22122 msgstr ""
22123
22124 #. type: =head2
22125 #: ../fish/guestfish-actions.pod:670
22126 msgid "chmod"
22127 msgstr ""
22128
22129 #. type: verbatim
22130 #: ../fish/guestfish-actions.pod:672
22131 #, no-wrap
22132 msgid ""
22133 " chmod mode path\n"
22134 "\n"
22135 msgstr ""
22136
22137 #. type: =head2
22138 #: ../fish/guestfish-actions.pod:683
22139 msgid "chown"
22140 msgstr ""
22141
22142 #. type: verbatim
22143 #: ../fish/guestfish-actions.pod:685
22144 #, no-wrap
22145 msgid ""
22146 " chown owner group path\n"
22147 "\n"
22148 msgstr ""
22149
22150 #. type: =head2
22151 #: ../fish/guestfish-actions.pod:693
22152 msgid "command"
22153 msgstr ""
22154
22155 #. type: verbatim
22156 #: ../fish/guestfish-actions.pod:695
22157 #, no-wrap
22158 msgid ""
22159 " command 'arguments ...'\n"
22160 "\n"
22161 msgstr ""
22162
22163 #. type: textblock
22164 #: ../fish/guestfish-actions.pod:702
22165 msgid ""
22166 "The single parameter is an argv-style list of arguments.  The first element "
22167 "is the name of the program to run.  Subsequent elements are parameters.  The "
22168 "list must be non-empty (ie. must contain a program name).  Note that the "
22169 "command runs directly, and is I<not> invoked via the shell (see L</sh>)."
22170 msgstr ""
22171
22172 #. type: =head2
22173 #: ../fish/guestfish-actions.pod:730
22174 msgid "command-lines"
22175 msgstr ""
22176
22177 #. type: verbatim
22178 #: ../fish/guestfish-actions.pod:732
22179 #, no-wrap
22180 msgid ""
22181 " command-lines 'arguments ...'\n"
22182 "\n"
22183 msgstr ""
22184
22185 #. type: textblock
22186 #: ../fish/guestfish-actions.pod:734
22187 msgid "This is the same as L</command>, but splits the result into a list of lines."
22188 msgstr ""
22189
22190 #. type: textblock
22191 #: ../fish/guestfish-actions.pod:737
22192 msgid "See also: L</sh-lines>"
22193 msgstr ""
22194
22195 #. type: =head2
22196 #: ../fish/guestfish-actions.pod:742
22197 msgid "config"
22198 msgstr ""
22199
22200 #. type: verbatim
22201 #: ../fish/guestfish-actions.pod:744
22202 #, no-wrap
22203 msgid ""
22204 " config qemuparam qemuvalue\n"
22205 "\n"
22206 msgstr ""
22207
22208 #. type: =head2
22209 #: ../fish/guestfish-actions.pod:755
22210 msgid "copy-size"
22211 msgstr ""
22212
22213 #. type: verbatim
22214 #: ../fish/guestfish-actions.pod:757
22215 #, no-wrap
22216 msgid ""
22217 " copy-size src dest size\n"
22218 "\n"
22219 msgstr ""
22220
22221 #. type: =head2
22222 #: ../fish/guestfish-actions.pod:765
22223 msgid "cp"
22224 msgstr ""
22225
22226 #. type: verbatim
22227 #: ../fish/guestfish-actions.pod:767
22228 #, no-wrap
22229 msgid ""
22230 " cp src dest\n"
22231 "\n"
22232 msgstr ""
22233
22234 #. type: =head2
22235 #: ../fish/guestfish-actions.pod:772
22236 msgid "cp-a"
22237 msgstr ""
22238
22239 #. type: verbatim
22240 #: ../fish/guestfish-actions.pod:774
22241 #, no-wrap
22242 msgid ""
22243 " cp-a src dest\n"
22244 "\n"
22245 msgstr ""
22246
22247 #. type: =head2
22248 #: ../fish/guestfish-actions.pod:779
22249 msgid "dd"
22250 msgstr ""
22251
22252 #. type: verbatim
22253 #: ../fish/guestfish-actions.pod:781
22254 #, no-wrap
22255 msgid ""
22256 " dd src dest\n"
22257 "\n"
22258 msgstr ""
22259
22260 #. type: textblock
22261 #: ../fish/guestfish-actions.pod:788
22262 msgid ""
22263 "If the destination is a device, it must be as large or larger than the "
22264 "source file or device, otherwise the copy will fail.  This command cannot do "
22265 "partial copies (see L</copy-size>)."
22266 msgstr ""
22267
22268 #. type: =head2
22269 #: ../fish/guestfish-actions.pod:792
22270 msgid "df"
22271 msgstr ""
22272
22273 #. type: verbatim
22274 #: ../fish/guestfish-actions.pod:794
22275 #, no-wrap
22276 msgid ""
22277 " df\n"
22278 "\n"
22279 msgstr ""
22280
22281 #. type: textblock
22282 #: ../fish/guestfish-actions.pod:798 ../fish/guestfish-actions.pod:809
22283 msgid ""
22284 "This command is mostly useful for interactive sessions.  It is I<not> "
22285 "intended that you try to parse the output string.  Use L</statvfs> from "
22286 "programs."
22287 msgstr ""
22288
22289 #. type: =head2
22290 #: ../fish/guestfish-actions.pod:802
22291 msgid "df-h"
22292 msgstr ""
22293
22294 #. type: verbatim
22295 #: ../fish/guestfish-actions.pod:804
22296 #, no-wrap
22297 msgid ""
22298 " df-h\n"
22299 "\n"
22300 msgstr ""
22301
22302 #. type: =head2
22303 #: ../fish/guestfish-actions.pod:813
22304 msgid "dmesg"
22305 msgstr ""
22306
22307 #. type: verbatim
22308 #: ../fish/guestfish-actions.pod:815
22309 #, no-wrap
22310 msgid ""
22311 " dmesg\n"
22312 "\n"
22313 msgstr ""
22314
22315 #. type: textblock
22316 #: ../fish/guestfish-actions.pod:821
22317 msgid ""
22318 "Another way to get the same information is to enable verbose messages with "
22319 "L</set-verbose> or by setting the environment variable C<LIBGUESTFS_DEBUG=1> "
22320 "before running the program."
22321 msgstr ""
22322
22323 #. type: =head2
22324 #: ../fish/guestfish-actions.pod:826
22325 msgid "download"
22326 msgstr ""
22327
22328 #. type: verbatim
22329 #: ../fish/guestfish-actions.pod:828
22330 #, no-wrap
22331 msgid ""
22332 " download remotefilename (filename|-)\n"
22333 "\n"
22334 msgstr ""
22335
22336 #. type: textblock
22337 #: ../fish/guestfish-actions.pod:835
22338 msgid "See also L</upload>, L</cat>."
22339 msgstr ""
22340
22341 #. type: =head2
22342 #: ../fish/guestfish-actions.pod:839
22343 msgid "download-offset"
22344 msgstr ""
22345
22346 #. type: verbatim
22347 #: ../fish/guestfish-actions.pod:841
22348 #, no-wrap
22349 msgid ""
22350 " download-offset remotefilename (filename|-) offset size\n"
22351 "\n"
22352 msgstr ""
22353
22354 #. type: textblock
22355 #: ../fish/guestfish-actions.pod:849
22356 msgid ""
22357 "Note that there is no limit on the amount of data that can be downloaded "
22358 "with this call, unlike with L</pread>, and this call always reads the full "
22359 "amount unless an error occurs."
22360 msgstr ""
22361
22362 #. type: textblock
22363 #: ../fish/guestfish-actions.pod:854
22364 msgid "See also L</download>, L</pread>."
22365 msgstr ""
22366
22367 #. type: =head2
22368 #: ../fish/guestfish-actions.pod:858
22369 msgid "drop-caches"
22370 msgstr ""
22371
22372 #. type: verbatim
22373 #: ../fish/guestfish-actions.pod:860
22374 #, no-wrap
22375 msgid ""
22376 " drop-caches whattodrop\n"
22377 "\n"
22378 msgstr ""
22379
22380 #. type: =head2
22381 #: ../fish/guestfish-actions.pod:872
22382 msgid "du"
22383 msgstr ""
22384
22385 #. type: verbatim
22386 #: ../fish/guestfish-actions.pod:874
22387 #, no-wrap
22388 msgid ""
22389 " du path\n"
22390 "\n"
22391 msgstr ""
22392
22393 #. type: =head2
22394 #: ../fish/guestfish-actions.pod:886
22395 msgid "e2fsck-f"
22396 msgstr ""
22397
22398 #. type: verbatim
22399 #: ../fish/guestfish-actions.pod:888
22400 #, no-wrap
22401 msgid ""
22402 " e2fsck-f device\n"
22403 "\n"
22404 msgstr ""
22405
22406 #. type: textblock
22407 #: ../fish/guestfish-actions.pod:894
22408 msgid ""
22409 "This command is only needed because of L</resize2fs> (q.v.).  Normally you "
22410 "should use L</fsck>."
22411 msgstr ""
22412
22413 #. type: =head2
22414 #: ../fish/guestfish-actions.pod:897
22415 msgid "echo-daemon"
22416 msgstr ""
22417
22418 #. type: verbatim
22419 #: ../fish/guestfish-actions.pod:899
22420 #, no-wrap
22421 msgid ""
22422 " echo-daemon 'words ...'\n"
22423 "\n"
22424 msgstr ""
22425
22426 #. type: textblock
22427 #: ../fish/guestfish-actions.pod:906
22428 msgid "See also L</ping-daemon>."
22429 msgstr ""
22430
22431 #. type: =head2
22432 #: ../fish/guestfish-actions.pod:908
22433 msgid "egrep"
22434 msgstr ""
22435
22436 #. type: verbatim
22437 #: ../fish/guestfish-actions.pod:910
22438 #, no-wrap
22439 msgid ""
22440 " egrep regex path\n"
22441 "\n"
22442 msgstr ""
22443
22444 #. type: =head2
22445 #: ../fish/guestfish-actions.pod:918
22446 msgid "egrepi"
22447 msgstr ""
22448
22449 #. type: verbatim
22450 #: ../fish/guestfish-actions.pod:920
22451 #, no-wrap
22452 msgid ""
22453 " egrepi regex path\n"
22454 "\n"
22455 msgstr ""
22456
22457 #. type: =head2
22458 #: ../fish/guestfish-actions.pod:928
22459 msgid "equal"
22460 msgstr ""
22461
22462 #. type: verbatim
22463 #: ../fish/guestfish-actions.pod:930
22464 #, no-wrap
22465 msgid ""
22466 " equal file1 file2\n"
22467 "\n"
22468 msgstr ""
22469
22470 #. type: =head2
22471 #: ../fish/guestfish-actions.pod:937
22472 msgid "exists"
22473 msgstr ""
22474
22475 #. type: verbatim
22476 #: ../fish/guestfish-actions.pod:939
22477 #, no-wrap
22478 msgid ""
22479 " exists path\n"
22480 "\n"
22481 msgstr ""
22482
22483 #. type: textblock
22484 #: ../fish/guestfish-actions.pod:944
22485 msgid "See also L</is-file>, L</is-dir>, L</stat>."
22486 msgstr ""
22487
22488 #. type: =head2
22489 #: ../fish/guestfish-actions.pod:946
22490 msgid "fallocate"
22491 msgstr ""
22492
22493 #. type: verbatim
22494 #: ../fish/guestfish-actions.pod:948
22495 #, no-wrap
22496 msgid ""
22497 " fallocate path len\n"
22498 "\n"
22499 msgstr ""
22500
22501 #. type: textblock
22502 #: ../fish/guestfish-actions.pod:958
22503 msgid ""
22504 "This function is deprecated.  In new code, use the L</fallocate64> call "
22505 "instead."
22506 msgstr ""
22507
22508 #. type: =head2
22509 #: ../fish/guestfish-actions.pod:965
22510 msgid "fallocate64"
22511 msgstr ""
22512
22513 #. type: verbatim
22514 #: ../fish/guestfish-actions.pod:967
22515 #, no-wrap
22516 msgid ""
22517 " fallocate64 path len\n"
22518 "\n"
22519 msgstr ""
22520
22521 #. type: textblock
22522 #: ../fish/guestfish-actions.pod:973
22523 msgid ""
22524 "Note that this call allocates disk blocks for the file.  To create a sparse "
22525 "file use L</truncate-size> instead."
22526 msgstr ""
22527
22528 #. type: textblock
22529 #: ../fish/guestfish-actions.pod:976
22530 msgid ""
22531 "The deprecated call L</fallocate> does the same, but owing to an oversight "
22532 "it only allowed 30 bit lengths to be specified, effectively limiting the "
22533 "maximum size of files created through that call to 1GB."
22534 msgstr ""
22535
22536 #. type: =head2
22537 #: ../fish/guestfish-actions.pod:985
22538 msgid "fgrep"
22539 msgstr ""
22540
22541 #. type: verbatim
22542 #: ../fish/guestfish-actions.pod:987
22543 #, no-wrap
22544 msgid ""
22545 " fgrep pattern path\n"
22546 "\n"
22547 msgstr ""
22548
22549 #. type: =head2
22550 #: ../fish/guestfish-actions.pod:995
22551 msgid "fgrepi"
22552 msgstr ""
22553
22554 #. type: verbatim
22555 #: ../fish/guestfish-actions.pod:997
22556 #, no-wrap
22557 msgid ""
22558 " fgrepi pattern path\n"
22559 "\n"
22560 msgstr ""
22561
22562 #. type: =head2
22563 #: ../fish/guestfish-actions.pod:1005
22564 msgid "file"
22565 msgstr ""
22566
22567 #. type: verbatim
22568 #: ../fish/guestfish-actions.pod:1007
22569 #, no-wrap
22570 msgid ""
22571 " file path\n"
22572 "\n"
22573 msgstr ""
22574
22575 #. type: textblock
22576 #: ../fish/guestfish-actions.pod:1023
22577 msgid ""
22578 "See also: L<file(1)>, L</vfs-type>, L</lstat>, L</is-file>, L</is-blockdev> "
22579 "(etc)."
22580 msgstr ""
22581
22582 #. type: =head2
22583 #: ../fish/guestfish-actions.pod:1026
22584 msgid "file-architecture"
22585 msgstr ""
22586
22587 #. type: verbatim
22588 #: ../fish/guestfish-actions.pod:1028
22589 #, no-wrap
22590 msgid ""
22591 " file-architecture filename\n"
22592 "\n"
22593 msgstr ""
22594
22595 #. type: =head2
22596 #: ../fish/guestfish-actions.pod:1131
22597 msgid "filesize"
22598 msgstr ""
22599
22600 #. type: verbatim
22601 #: ../fish/guestfish-actions.pod:1133
22602 #, no-wrap
22603 msgid ""
22604 " filesize file\n"
22605 "\n"
22606 msgstr ""
22607
22608 #. type: textblock
22609 #: ../fish/guestfish-actions.pod:1137
22610 msgid ""
22611 "To get other stats about a file, use L</stat>, L</lstat>, L</is-dir>, "
22612 "L</is-file> etc.  To get the size of block devices, use "
22613 "L</blockdev-getsize64>."
22614 msgstr ""
22615
22616 #. type: =head2
22617 #: ../fish/guestfish-actions.pod:1141
22618 msgid "fill"
22619 msgstr ""
22620
22621 #. type: verbatim
22622 #: ../fish/guestfish-actions.pod:1143
22623 #, no-wrap
22624 msgid ""
22625 " fill c len path\n"
22626 "\n"
22627 msgstr ""
22628
22629 #. type: textblock
22630 #: ../fish/guestfish-actions.pod:1149
22631 msgid ""
22632 "To fill a file with zero bytes (sparsely), it is much more efficient to use "
22633 "L</truncate-size>.  To create a file with a pattern of repeating bytes use "
22634 "L</fill-pattern>."
22635 msgstr ""
22636
22637 #. type: =head2
22638 #: ../fish/guestfish-actions.pod:1154
22639 msgid "fill-pattern"
22640 msgstr ""
22641
22642 #. type: verbatim
22643 #: ../fish/guestfish-actions.pod:1156
22644 #, no-wrap
22645 msgid ""
22646 " fill-pattern pattern len path\n"
22647 "\n"
22648 msgstr ""
22649
22650 #. type: textblock
22651 #: ../fish/guestfish-actions.pod:1158
22652 msgid ""
22653 "This function is like L</fill> except that it creates a new file of length "
22654 "C<len> containing the repeating pattern of bytes in C<pattern>.  The pattern "
22655 "is truncated if necessary to ensure the length of the file is exactly C<len> "
22656 "bytes."
22657 msgstr ""
22658
22659 #. type: =head2
22660 #: ../fish/guestfish-actions.pod:1163
22661 msgid "find"
22662 msgstr ""
22663
22664 #. type: verbatim
22665 #: ../fish/guestfish-actions.pod:1165
22666 #, no-wrap
22667 msgid ""
22668 " find directory\n"
22669 "\n"
22670 msgstr ""
22671
22672 #. type: textblock
22673 #: ../fish/guestfish-actions.pod:1179
22674 msgid "then the returned list from L</find> C</tmp> would be 4 elements:"
22675 msgstr ""
22676
22677 #. type: textblock
22678 #: ../fish/guestfish-actions.pod:1192
22679 msgid "See also L</find0>."
22680 msgstr ""
22681
22682 #. type: =head2
22683 #: ../fish/guestfish-actions.pod:1197
22684 msgid "find0"
22685 msgstr ""
22686
22687 #. type: verbatim
22688 #: ../fish/guestfish-actions.pod:1199
22689 #, no-wrap
22690 msgid ""
22691 " find0 directory (files|-)\n"
22692 "\n"
22693 msgstr ""
22694
22695 #. type: textblock
22696 #: ../fish/guestfish-actions.pod:1205
22697 msgid "This command works the same way as L</find> with the following exceptions:"
22698 msgstr ""
22699
22700 #. type: =head2
22701 #: ../fish/guestfish-actions.pod:1232
22702 msgid "findfs-label"
22703 msgstr ""
22704
22705 #. type: verbatim
22706 #: ../fish/guestfish-actions.pod:1234
22707 #, no-wrap
22708 msgid ""
22709 " findfs-label label\n"
22710 "\n"
22711 msgstr ""
22712
22713 #. type: textblock
22714 #: ../fish/guestfish-actions.pod:1240
22715 msgid "To find the label of a filesystem, use L</vfs-label>."
22716 msgstr ""
22717
22718 #. type: =head2
22719 #: ../fish/guestfish-actions.pod:1242
22720 msgid "findfs-uuid"
22721 msgstr ""
22722
22723 #. type: verbatim
22724 #: ../fish/guestfish-actions.pod:1244
22725 #, no-wrap
22726 msgid ""
22727 " findfs-uuid uuid\n"
22728 "\n"
22729 msgstr ""
22730
22731 #. type: textblock
22732 #: ../fish/guestfish-actions.pod:1250
22733 msgid "To find the UUID of a filesystem, use L</vfs-uuid>."
22734 msgstr ""
22735
22736 #. type: =head2
22737 #: ../fish/guestfish-actions.pod:1252
22738 msgid "fsck"
22739 msgstr ""
22740
22741 #. type: verbatim
22742 #: ../fish/guestfish-actions.pod:1254
22743 #, no-wrap
22744 msgid ""
22745 " fsck fstype device\n"
22746 "\n"
22747 msgstr ""
22748
22749 #. type: =head2
22750 #: ../fish/guestfish-actions.pod:1284
22751 msgid "get-append"
22752 msgstr ""
22753
22754 #. type: verbatim
22755 #: ../fish/guestfish-actions.pod:1286
22756 #, no-wrap
22757 msgid ""
22758 " get-append\n"
22759 "\n"
22760 msgstr ""
22761
22762 #. type: =head2
22763 #: ../fish/guestfish-actions.pod:1293
22764 msgid "get-attach-method"
22765 msgstr ""
22766
22767 #. type: verbatim
22768 #: ../fish/guestfish-actions.pod:1295
22769 #, no-wrap
22770 msgid ""
22771 " get-attach-method\n"
22772 "\n"
22773 msgstr ""
22774
22775 #. type: textblock
22776 #: ../fish/guestfish-actions.pod:1297
22777 msgid "Return the current attach method.  See L</set-attach-method>."
22778 msgstr ""
22779
22780 #. type: =head2
22781 #: ../fish/guestfish-actions.pod:1299
22782 msgid "get-autosync"
22783 msgstr ""
22784
22785 #. type: verbatim
22786 #: ../fish/guestfish-actions.pod:1301
22787 #, no-wrap
22788 msgid ""
22789 " get-autosync\n"
22790 "\n"
22791 msgstr ""
22792
22793 #. type: =head2
22794 #: ../fish/guestfish-actions.pod:1305
22795 msgid "get-direct"
22796 msgstr ""
22797
22798 #. type: verbatim
22799 #: ../fish/guestfish-actions.pod:1307
22800 #, no-wrap
22801 msgid ""
22802 " get-direct\n"
22803 "\n"
22804 msgstr ""
22805
22806 #. type: =head2
22807 #: ../fish/guestfish-actions.pod:1311
22808 msgid "get-e2label"
22809 msgstr ""
22810
22811 #. type: verbatim
22812 #: ../fish/guestfish-actions.pod:1313
22813 #, no-wrap
22814 msgid ""
22815 " get-e2label device\n"
22816 "\n"
22817 msgstr ""
22818
22819 #. type: textblock
22820 #: ../fish/guestfish-actions.pod:1318
22821 msgid ""
22822 "This function is deprecated.  In new code, use the L</vfs_label> call "
22823 "instead."
22824 msgstr ""
22825
22826 #. type: =head2
22827 #: ../fish/guestfish-actions.pod:1325
22828 msgid "get-e2uuid"
22829 msgstr ""
22830
22831 #. type: verbatim
22832 #: ../fish/guestfish-actions.pod:1327
22833 #, no-wrap
22834 msgid ""
22835 " get-e2uuid device\n"
22836 "\n"
22837 msgstr ""
22838
22839 #. type: textblock
22840 #: ../fish/guestfish-actions.pod:1332
22841 msgid ""
22842 "This function is deprecated.  In new code, use the L</vfs_uuid> call "
22843 "instead."
22844 msgstr ""
22845
22846 #. type: =head2
22847 #: ../fish/guestfish-actions.pod:1339
22848 msgid "get-memsize"
22849 msgstr ""
22850
22851 #. type: verbatim
22852 #: ../fish/guestfish-actions.pod:1341
22853 #, no-wrap
22854 msgid ""
22855 " get-memsize\n"
22856 "\n"
22857 msgstr ""
22858
22859 #. type: textblock
22860 #: ../fish/guestfish-actions.pod:1346
22861 msgid ""
22862 "If L</set-memsize> was not called on this handle, and if "
22863 "C<LIBGUESTFS_MEMSIZE> was not set, then this returns the compiled-in default "
22864 "value for memsize."
22865 msgstr ""
22866
22867 #. type: =head2
22868 #: ../fish/guestfish-actions.pod:1353
22869 msgid "get-network"
22870 msgstr ""
22871
22872 #. type: verbatim
22873 #: ../fish/guestfish-actions.pod:1355
22874 #, no-wrap
22875 msgid ""
22876 " get-network\n"
22877 "\n"
22878 msgstr ""
22879
22880 #. type: =head2
22881 #: ../fish/guestfish-actions.pod:1359
22882 msgid "get-path"
22883 msgstr ""
22884
22885 #. type: verbatim
22886 #: ../fish/guestfish-actions.pod:1361
22887 #, no-wrap
22888 msgid ""
22889 " get-path\n"
22890 "\n"
22891 msgstr ""
22892
22893 #. type: =head2
22894 #: ../fish/guestfish-actions.pod:1368
22895 msgid "get-pid"
22896 msgstr ""
22897
22898 #. type: =head2
22899 #: ../fish/guestfish-actions.pod:1370
22900 msgid "pid"
22901 msgstr ""
22902
22903 #. type: verbatim
22904 #: ../fish/guestfish-actions.pod:1372
22905 #, no-wrap
22906 msgid ""
22907 " get-pid\n"
22908 "\n"
22909 msgstr ""
22910
22911 #. type: =head2
22912 #: ../fish/guestfish-actions.pod:1379
22913 msgid "get-qemu"
22914 msgstr ""
22915
22916 #. type: verbatim
22917 #: ../fish/guestfish-actions.pod:1381
22918 #, no-wrap
22919 msgid ""
22920 " get-qemu\n"
22921 "\n"
22922 msgstr ""
22923
22924 #. type: =head2
22925 #: ../fish/guestfish-actions.pod:1388
22926 msgid "get-recovery-proc"
22927 msgstr ""
22928
22929 #. type: verbatim
22930 #: ../fish/guestfish-actions.pod:1390
22931 #, no-wrap
22932 msgid ""
22933 " get-recovery-proc\n"
22934 "\n"
22935 msgstr ""
22936
22937 #. type: =head2
22938 #: ../fish/guestfish-actions.pod:1394
22939 msgid "get-selinux"
22940 msgstr ""
22941
22942 #. type: verbatim
22943 #: ../fish/guestfish-actions.pod:1396
22944 #, no-wrap
22945 msgid ""
22946 " get-selinux\n"
22947 "\n"
22948 msgstr ""
22949
22950 #. type: textblock
22951 #: ../fish/guestfish-actions.pod:1398
22952 msgid ""
22953 "This returns the current setting of the selinux flag which is passed to the "
22954 "appliance at boot time.  See L</set-selinux>."
22955 msgstr ""
22956
22957 #. type: =head2
22958 #: ../fish/guestfish-actions.pod:1404
22959 msgid "get-state"
22960 msgstr ""
22961
22962 #. type: verbatim
22963 #: ../fish/guestfish-actions.pod:1406
22964 #, no-wrap
22965 msgid ""
22966 " get-state\n"
22967 "\n"
22968 msgstr ""
22969
22970 #. type: =head2
22971 #: ../fish/guestfish-actions.pod:1413
22972 msgid "get-trace"
22973 msgstr ""
22974
22975 #. type: verbatim
22976 #: ../fish/guestfish-actions.pod:1415
22977 #, no-wrap
22978 msgid ""
22979 " get-trace\n"
22980 "\n"
22981 msgstr ""
22982
22983 #. type: =head2
22984 #: ../fish/guestfish-actions.pod:1419
22985 msgid "get-umask"
22986 msgstr ""
22987
22988 #. type: verbatim
22989 #: ../fish/guestfish-actions.pod:1421
22990 #, no-wrap
22991 msgid ""
22992 " get-umask\n"
22993 "\n"
22994 msgstr ""
22995
22996 #. type: textblock
22997 #: ../fish/guestfish-actions.pod:1423
22998 msgid ""
22999 "Return the current umask.  By default the umask is C<022> unless it has been "
23000 "set by calling L</umask>."
23001 msgstr ""
23002
23003 #. type: =head2
23004 #: ../fish/guestfish-actions.pod:1426
23005 msgid "get-verbose"
23006 msgstr ""
23007
23008 #. type: verbatim
23009 #: ../fish/guestfish-actions.pod:1428
23010 #, no-wrap
23011 msgid ""
23012 " get-verbose\n"
23013 "\n"
23014 msgstr ""
23015
23016 #. type: =head2
23017 #: ../fish/guestfish-actions.pod:1432
23018 msgid "getcon"
23019 msgstr ""
23020
23021 #. type: verbatim
23022 #: ../fish/guestfish-actions.pod:1434
23023 #, no-wrap
23024 msgid ""
23025 " getcon\n"
23026 "\n"
23027 msgstr ""
23028
23029 #. type: textblock
23030 #: ../fish/guestfish-actions.pod:1438
23031 msgid "See the documentation about SELINUX in L<guestfs(3)>, and L</setcon>"
23032 msgstr ""
23033
23034 #. type: =head2
23035 #: ../fish/guestfish-actions.pod:1441
23036 msgid "getxattr"
23037 msgstr ""
23038
23039 #. type: verbatim
23040 #: ../fish/guestfish-actions.pod:1443
23041 #, no-wrap
23042 msgid ""
23043 " getxattr path name\n"
23044 "\n"
23045 msgstr ""
23046
23047 #. type: textblock
23048 #: ../fish/guestfish-actions.pod:1445
23049 msgid ""
23050 "Get a single extended attribute from file C<path> named C<name>.  This call "
23051 "follows symlinks.  If you want to lookup an extended attribute for the "
23052 "symlink itself, use L</lgetxattr>."
23053 msgstr ""
23054
23055 #. type: textblock
23056 #: ../fish/guestfish-actions.pod:1449 ../fish/guestfish-actions.pod:2455
23057 msgid ""
23058 "Normally it is better to get all extended attributes from a file in one go "
23059 "by calling L</getxattrs>.  However some Linux filesystem implementations are "
23060 "buggy and do not provide a way to list out attributes.  For these "
23061 "filesystems (notably ntfs-3g)  you have to know the names of the extended "
23062 "attributes you want in advance and call this function."
23063 msgstr ""
23064
23065 #. type: textblock
23066 #: ../fish/guestfish-actions.pod:1459
23067 msgid "See also: L</getxattrs>, L</lgetxattr>, L<attr(5)>."
23068 msgstr ""
23069
23070 #. type: =head2
23071 #: ../fish/guestfish-actions.pod:1461
23072 msgid "getxattrs"
23073 msgstr ""
23074
23075 #. type: verbatim
23076 #: ../fish/guestfish-actions.pod:1463
23077 #, no-wrap
23078 msgid ""
23079 " getxattrs path\n"
23080 "\n"
23081 msgstr ""
23082
23083 #. type: textblock
23084 #: ../fish/guestfish-actions.pod:1471
23085 msgid "See also: L</lgetxattrs>, L<attr(5)>."
23086 msgstr ""
23087
23088 #. type: =head2
23089 #: ../fish/guestfish-actions.pod:1473
23090 msgid "glob-expand"
23091 msgstr ""
23092
23093 #. type: verbatim
23094 #: ../fish/guestfish-actions.pod:1475
23095 #, no-wrap
23096 msgid ""
23097 " glob-expand pattern\n"
23098 "\n"
23099 msgstr ""
23100
23101 #. type: =head2
23102 #: ../fish/guestfish-actions.pod:1488
23103 msgid "grep"
23104 msgstr ""
23105
23106 #. type: verbatim
23107 #: ../fish/guestfish-actions.pod:1490
23108 #, no-wrap
23109 msgid ""
23110 " grep regex path\n"
23111 "\n"
23112 msgstr ""
23113
23114 #. type: =head2
23115 #: ../fish/guestfish-actions.pod:1498
23116 msgid "grepi"
23117 msgstr ""
23118
23119 #. type: verbatim
23120 #: ../fish/guestfish-actions.pod:1500
23121 #, no-wrap
23122 msgid ""
23123 " grepi regex path\n"
23124 "\n"
23125 msgstr ""
23126
23127 #. type: =head2
23128 #: ../fish/guestfish-actions.pod:1508
23129 msgid "grub-install"
23130 msgstr ""
23131
23132 #. type: verbatim
23133 #: ../fish/guestfish-actions.pod:1510
23134 #, no-wrap
23135 msgid ""
23136 " grub-install root device\n"
23137 "\n"
23138 msgstr ""
23139
23140 #. type: =head2
23141 #: ../fish/guestfish-actions.pod:1526
23142 msgid "head"
23143 msgstr ""
23144
23145 #. type: verbatim
23146 #: ../fish/guestfish-actions.pod:1528
23147 #, no-wrap
23148 msgid ""
23149 " head path\n"
23150 "\n"
23151 msgstr ""
23152
23153 #. type: =head2
23154 #: ../fish/guestfish-actions.pod:1536
23155 msgid "head-n"
23156 msgstr ""
23157
23158 #. type: verbatim
23159 #: ../fish/guestfish-actions.pod:1538
23160 #, no-wrap
23161 msgid ""
23162 " head-n nrlines path\n"
23163 "\n"
23164 msgstr ""
23165
23166 #. type: =head2
23167 #: ../fish/guestfish-actions.pod:1551
23168 msgid "hexdump"
23169 msgstr ""
23170
23171 #. type: verbatim
23172 #: ../fish/guestfish-actions.pod:1553
23173 #, no-wrap
23174 msgid ""
23175 " hexdump path\n"
23176 "\n"
23177 msgstr ""
23178
23179 #. type: =head2
23180 #: ../fish/guestfish-actions.pod:1561
23181 msgid "initrd-cat"
23182 msgstr ""
23183
23184 #. type: verbatim
23185 #: ../fish/guestfish-actions.pod:1563
23186 #, no-wrap
23187 msgid ""
23188 " initrd-cat initrdpath filename\n"
23189 "\n"
23190 msgstr ""
23191
23192 #. type: textblock
23193 #: ../fish/guestfish-actions.pod:1575
23194 msgid "See also L</initrd-list>."
23195 msgstr ""
23196
23197 #. type: =head2
23198 #: ../fish/guestfish-actions.pod:1580
23199 msgid "initrd-list"
23200 msgstr ""
23201
23202 #. type: verbatim
23203 #: ../fish/guestfish-actions.pod:1582
23204 #, no-wrap
23205 msgid ""
23206 " initrd-list path\n"
23207 "\n"
23208 msgstr ""
23209
23210 #. type: =head2
23211 #: ../fish/guestfish-actions.pod:1594
23212 msgid "inotify-add-watch"
23213 msgstr ""
23214
23215 #. type: verbatim
23216 #: ../fish/guestfish-actions.pod:1596
23217 #, no-wrap
23218 msgid ""
23219 " inotify-add-watch path mask\n"
23220 "\n"
23221 msgstr ""
23222
23223 #. type: =head2
23224 #: ../fish/guestfish-actions.pod:1608
23225 msgid "inotify-close"
23226 msgstr ""
23227
23228 #. type: verbatim
23229 #: ../fish/guestfish-actions.pod:1610
23230 #, no-wrap
23231 msgid ""
23232 " inotify-close\n"
23233 "\n"
23234 msgstr ""
23235
23236 #. type: =head2
23237 #: ../fish/guestfish-actions.pod:1616
23238 msgid "inotify-files"
23239 msgstr ""
23240
23241 #. type: verbatim
23242 #: ../fish/guestfish-actions.pod:1618
23243 #, no-wrap
23244 msgid ""
23245 " inotify-files\n"
23246 "\n"
23247 msgstr ""
23248
23249 #. type: textblock
23250 #: ../fish/guestfish-actions.pod:1620
23251 msgid ""
23252 "This function is a helpful wrapper around L</inotify-read> which just "
23253 "returns a list of pathnames of objects that were touched.  The returned "
23254 "pathnames are sorted and deduplicated."
23255 msgstr ""
23256
23257 #. type: =head2
23258 #: ../fish/guestfish-actions.pod:1624
23259 msgid "inotify-init"
23260 msgstr ""
23261
23262 #. type: verbatim
23263 #: ../fish/guestfish-actions.pod:1626
23264 #, no-wrap
23265 msgid ""
23266 " inotify-init maxevents\n"
23267 "\n"
23268 msgstr ""
23269
23270 #. type: textblock
23271 #: ../fish/guestfish-actions.pod:1632
23272 msgid ""
23273 "C<maxevents> is the maximum number of events which will be queued up between "
23274 "calls to L</inotify-read> or L</inotify-files>.  If this is passed as C<0>, "
23275 "then the kernel (or previously set)  default is used.  For Linux 2.6.29 the "
23276 "default was 16384 events.  Beyond this limit, the kernel throws away events, "
23277 "but records the fact that it threw them away by setting a flag "
23278 "C<IN_Q_OVERFLOW> in the returned structure list (see L</inotify-read>)."
23279 msgstr ""
23280
23281 #. type: textblock
23282 #: ../fish/guestfish-actions.pod:1642
23283 msgid ""
23284 "Before any events are generated, you have to add some watches to the "
23285 "internal watch list.  See: L</inotify-add-watch>, L</inotify-rm-watch> and "
23286 "L</inotify-watch-all>."
23287 msgstr ""
23288
23289 #. type: textblock
23290 #: ../fish/guestfish-actions.pod:1648
23291 msgid ""
23292 "Queued up events should be read periodically by calling L</inotify-read> (or "
23293 "L</inotify-files> which is just a helpful wrapper around L</inotify-read>).  "
23294 "If you don't read the events out often enough then you risk the internal "
23295 "queue overflowing."
23296 msgstr ""
23297
23298 #. type: textblock
23299 #: ../fish/guestfish-actions.pod:1655
23300 msgid ""
23301 "The handle should be closed after use by calling L</inotify-close>.  This "
23302 "also removes any watches automatically."
23303 msgstr ""
23304
23305 #. type: =head2
23306 #: ../fish/guestfish-actions.pod:1664
23307 msgid "inotify-read"
23308 msgstr ""
23309
23310 #. type: verbatim
23311 #: ../fish/guestfish-actions.pod:1666
23312 #, no-wrap
23313 msgid ""
23314 " inotify-read\n"
23315 "\n"
23316 msgstr ""
23317
23318 #. type: =head2
23319 #: ../fish/guestfish-actions.pod:1679
23320 msgid "inotify-rm-watch"
23321 msgstr ""
23322
23323 #. type: verbatim
23324 #: ../fish/guestfish-actions.pod:1681
23325 #, no-wrap
23326 msgid ""
23327 " inotify-rm-watch wd\n"
23328 "\n"
23329 msgstr ""
23330
23331 #. type: textblock
23332 #: ../fish/guestfish-actions.pod:1683
23333 msgid "Remove a previously defined inotify watch.  See L</inotify-add-watch>."
23334 msgstr ""
23335
23336 #. type: =head2
23337 #: ../fish/guestfish-actions.pod:1686
23338 msgid "inspect-get-arch"
23339 msgstr ""
23340
23341 #. type: verbatim
23342 #: ../fish/guestfish-actions.pod:1688
23343 #, no-wrap
23344 msgid ""
23345 " inspect-get-arch root\n"
23346 "\n"
23347 msgstr ""
23348
23349 #. type: textblock
23350 #: ../fish/guestfish-actions.pod:1690 ../fish/guestfish-actions.pod:1706 ../fish/guestfish-actions.pod:1792 ../fish/guestfish-actions.pod:1828 ../fish/guestfish-actions.pod:1846 ../fish/guestfish-actions.pod:1880 ../fish/guestfish-actions.pod:1895 ../fish/guestfish-actions.pod:1916 ../fish/guestfish-actions.pod:1931 ../fish/guestfish-actions.pod:1964 ../fish/guestfish-actions.pod:1986 ../fish/guestfish-actions.pod:2010 ../fish/guestfish-actions.pod:2027 ../fish/guestfish-actions.pod:2070 ../fish/guestfish-actions.pod:2105 ../fish/guestfish-actions.pod:2121 ../fish/guestfish-actions.pod:2137 ../fish/guestfish-actions.pod:2150 ../fish/guestfish-actions.pod:2163 ../fish/guestfish-actions.pod:2178
23351 msgid ""
23352 "This function should only be called with a root device string as returned by "
23353 "L</inspect-os>."
23354 msgstr ""
23355
23356 #. type: textblock
23357 #: ../fish/guestfish-actions.pod:1693
23358 msgid ""
23359 "This returns the architecture of the inspected operating system.  The "
23360 "possible return values are listed under L</file-architecture>."
23361 msgstr ""
23362
23363 #. type: =head2
23364 #: ../fish/guestfish-actions.pod:1702
23365 msgid "inspect-get-distro"
23366 msgstr ""
23367
23368 #. type: verbatim
23369 #: ../fish/guestfish-actions.pod:1704
23370 #, no-wrap
23371 msgid ""
23372 " inspect-get-distro root\n"
23373 "\n"
23374 msgstr ""
23375
23376 #. type: =head2
23377 #: ../fish/guestfish-actions.pod:1788
23378 msgid "inspect-get-drive-mappings"
23379 msgstr ""
23380
23381 #. type: verbatim
23382 #: ../fish/guestfish-actions.pod:1790
23383 #, no-wrap
23384 msgid ""
23385 " inspect-get-drive-mappings root\n"
23386 "\n"
23387 msgstr ""
23388
23389 #. type: textblock
23390 #: ../fish/guestfish-actions.pod:1820
23391 msgid ""
23392 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
23393 "L</inspect-get-mountpoints>, L</inspect-get-filesystems>."
23394 msgstr ""
23395
23396 #. type: =head2
23397 #: ../fish/guestfish-actions.pod:1824
23398 msgid "inspect-get-filesystems"
23399 msgstr ""
23400
23401 #. type: verbatim
23402 #: ../fish/guestfish-actions.pod:1826
23403 #, no-wrap
23404 msgid ""
23405 " inspect-get-filesystems root\n"
23406 "\n"
23407 msgstr ""
23408
23409 #. type: textblock
23410 #: ../fish/guestfish-actions.pod:1839
23411 msgid ""
23412 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
23413 "L</inspect-get-mountpoints>."
23414 msgstr ""
23415
23416 #. type: =head2
23417 #: ../fish/guestfish-actions.pod:1842
23418 msgid "inspect-get-format"
23419 msgstr ""
23420
23421 #. type: verbatim
23422 #: ../fish/guestfish-actions.pod:1844
23423 #, no-wrap
23424 msgid ""
23425 " inspect-get-format root\n"
23426 "\n"
23427 msgstr ""
23428
23429 #. type: =head2
23430 #: ../fish/guestfish-actions.pod:1876
23431 msgid "inspect-get-hostname"
23432 msgstr ""
23433
23434 #. type: verbatim
23435 #: ../fish/guestfish-actions.pod:1878
23436 #, no-wrap
23437 msgid ""
23438 " inspect-get-hostname root\n"
23439 "\n"
23440 msgstr ""
23441
23442 #. type: =head2
23443 #: ../fish/guestfish-actions.pod:1891
23444 msgid "inspect-get-major-version"
23445 msgstr ""
23446
23447 #. type: verbatim
23448 #: ../fish/guestfish-actions.pod:1893
23449 #, no-wrap
23450 msgid ""
23451 " inspect-get-major-version root\n"
23452 "\n"
23453 msgstr ""
23454
23455 #. type: =head2
23456 #: ../fish/guestfish-actions.pod:1912
23457 msgid "inspect-get-minor-version"
23458 msgstr ""
23459
23460 #. type: verbatim
23461 #: ../fish/guestfish-actions.pod:1914
23462 #, no-wrap
23463 msgid ""
23464 " inspect-get-minor-version root\n"
23465 "\n"
23466 msgstr ""
23467
23468 #. type: textblock
23469 #: ../fish/guestfish-actions.pod:1924
23470 msgid ""
23471 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
23472 "L</inspect-get-major-version>."
23473 msgstr ""
23474
23475 #. type: =head2
23476 #: ../fish/guestfish-actions.pod:1927
23477 msgid "inspect-get-mountpoints"
23478 msgstr ""
23479
23480 #. type: verbatim
23481 #: ../fish/guestfish-actions.pod:1929
23482 #, no-wrap
23483 msgid ""
23484 " inspect-get-mountpoints root\n"
23485 "\n"
23486 msgstr ""
23487
23488 #. type: textblock
23489 #: ../fish/guestfish-actions.pod:1951
23490 msgid ""
23491 "For operating systems like Windows which still use drive letters, this call "
23492 "will only return an entry for the first drive \"mounted on\" C</>.  For "
23493 "information about the mapping of drive letters to partitions, see "
23494 "L</inspect-get-drive-mappings>."
23495 msgstr ""
23496
23497 #. type: textblock
23498 #: ../fish/guestfish-actions.pod:1957
23499 msgid ""
23500 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
23501 "L</inspect-get-filesystems>."
23502 msgstr ""
23503
23504 #. type: =head2
23505 #: ../fish/guestfish-actions.pod:1960
23506 msgid "inspect-get-package-format"
23507 msgstr ""
23508
23509 #. type: verbatim
23510 #: ../fish/guestfish-actions.pod:1962
23511 #, no-wrap
23512 msgid ""
23513 " inspect-get-package-format root\n"
23514 "\n"
23515 msgstr ""
23516
23517 #. type: textblock
23518 #: ../fish/guestfish-actions.pod:1967
23519 msgid ""
23520 "This function and L</inspect-get-package-management> return the package "
23521 "format and package management tool used by the inspected operating system.  "
23522 "For example for Fedora these functions would return C<rpm> (package format) "
23523 "and C<yum> (package management)."
23524 msgstr ""
23525
23526 #. type: =head2
23527 #: ../fish/guestfish-actions.pod:1982
23528 msgid "inspect-get-package-management"
23529 msgstr ""
23530
23531 #. type: verbatim
23532 #: ../fish/guestfish-actions.pod:1984
23533 #, no-wrap
23534 msgid ""
23535 " inspect-get-package-management root\n"
23536 "\n"
23537 msgstr ""
23538
23539 #. type: textblock
23540 #: ../fish/guestfish-actions.pod:1989
23541 msgid ""
23542 "L</inspect-get-package-format> and this function return the package format "
23543 "and package management tool used by the inspected operating system.  For "
23544 "example for Fedora these functions would return C<rpm> (package format) and "
23545 "C<yum> (package management)."
23546 msgstr ""
23547
23548 #. type: =head2
23549 #: ../fish/guestfish-actions.pod:2006
23550 msgid "inspect-get-product-name"
23551 msgstr ""
23552
23553 #. type: verbatim
23554 #: ../fish/guestfish-actions.pod:2008
23555 #, no-wrap
23556 msgid ""
23557 " inspect-get-product-name root\n"
23558 "\n"
23559 msgstr ""
23560
23561 #. type: =head2
23562 #: ../fish/guestfish-actions.pod:2023
23563 msgid "inspect-get-product-variant"
23564 msgstr ""
23565
23566 #. type: verbatim
23567 #: ../fish/guestfish-actions.pod:2025
23568 #, no-wrap
23569 msgid ""
23570 " inspect-get-product-variant root\n"
23571 "\n"
23572 msgstr ""
23573
23574 #. type: textblock
23575 #: ../fish/guestfish-actions.pod:2049
23576 msgid ""
23577 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
23578 "L</inspect-get-product-name>, L</inspect-get-major-version>."
23579 msgstr ""
23580
23581 #. type: =head2
23582 #: ../fish/guestfish-actions.pod:2053
23583 msgid "inspect-get-roots"
23584 msgstr ""
23585
23586 #. type: verbatim
23587 #: ../fish/guestfish-actions.pod:2055
23588 #, no-wrap
23589 msgid ""
23590 " inspect-get-roots\n"
23591 "\n"
23592 msgstr ""
23593
23594 #. type: textblock
23595 #: ../fish/guestfish-actions.pod:2057
23596 msgid ""
23597 "This function is a convenient way to get the list of root devices, as "
23598 "returned from a previous call to L</inspect-os>, but without redoing the "
23599 "whole inspection process."
23600 msgstr ""
23601
23602 #. type: textblock
23603 #: ../fish/guestfish-actions.pod:2061
23604 msgid ""
23605 "This returns an empty list if either no root devices were found or the "
23606 "caller has not called L</inspect-os>."
23607 msgstr ""
23608
23609 #. type: =head2
23610 #: ../fish/guestfish-actions.pod:2066
23611 msgid "inspect-get-type"
23612 msgstr ""
23613
23614 #. type: verbatim
23615 #: ../fish/guestfish-actions.pod:2068
23616 #, no-wrap
23617 msgid ""
23618 " inspect-get-type root\n"
23619 "\n"
23620 msgstr ""
23621
23622 #. type: =head2
23623 #: ../fish/guestfish-actions.pod:2101
23624 msgid "inspect-get-windows-current-control-set"
23625 msgstr ""
23626
23627 #. type: verbatim
23628 #: ../fish/guestfish-actions.pod:2103
23629 #, no-wrap
23630 msgid ""
23631 " inspect-get-windows-current-control-set root\n"
23632 "\n"
23633 msgstr ""
23634
23635 #. type: =head2
23636 #: ../fish/guestfish-actions.pod:2117
23637 msgid "inspect-get-windows-systemroot"
23638 msgstr ""
23639
23640 #. type: verbatim
23641 #: ../fish/guestfish-actions.pod:2119
23642 #, no-wrap
23643 msgid ""
23644 " inspect-get-windows-systemroot root\n"
23645 "\n"
23646 msgstr ""
23647
23648 #. type: =head2
23649 #: ../fish/guestfish-actions.pod:2133
23650 msgid "inspect-is-live"
23651 msgstr ""
23652
23653 #. type: verbatim
23654 #: ../fish/guestfish-actions.pod:2135
23655 #, no-wrap
23656 msgid ""
23657 " inspect-is-live root\n"
23658 "\n"
23659 msgstr ""
23660
23661 #. type: textblock
23662 #: ../fish/guestfish-actions.pod:2140
23663 msgid ""
23664 "If L</inspect-get-format> returns C<installer> (this is an install disk), "
23665 "then this returns true if a live image was detected on the disk."
23666 msgstr ""
23667
23668 #. type: =head2
23669 #: ../fish/guestfish-actions.pod:2146
23670 msgid "inspect-is-multipart"
23671 msgstr ""
23672
23673 #. type: verbatim
23674 #: ../fish/guestfish-actions.pod:2148
23675 #, no-wrap
23676 msgid ""
23677 " inspect-is-multipart root\n"
23678 "\n"
23679 msgstr ""
23680
23681 #. type: textblock
23682 #: ../fish/guestfish-actions.pod:2153
23683 msgid ""
23684 "If L</inspect-get-format> returns C<installer> (this is an install disk), "
23685 "then this returns true if the disk is part of a set."
23686 msgstr ""
23687
23688 #. type: =head2
23689 #: ../fish/guestfish-actions.pod:2159
23690 msgid "inspect-is-netinst"
23691 msgstr ""
23692
23693 #. type: verbatim
23694 #: ../fish/guestfish-actions.pod:2161
23695 #, no-wrap
23696 msgid ""
23697 " inspect-is-netinst root\n"
23698 "\n"
23699 msgstr ""
23700
23701 #. type: textblock
23702 #: ../fish/guestfish-actions.pod:2166
23703 msgid ""
23704 "If L</inspect-get-format> returns C<installer> (this is an install disk), "
23705 "then this returns true if the disk is a network installer, ie. not a "
23706 "self-contained install CD but one which is likely to require network access "
23707 "to complete the install."
23708 msgstr ""
23709
23710 #. type: =head2
23711 #: ../fish/guestfish-actions.pod:2174
23712 msgid "inspect-list-applications"
23713 msgstr ""
23714
23715 #. type: verbatim
23716 #: ../fish/guestfish-actions.pod:2176
23717 #, no-wrap
23718 msgid ""
23719 " inspect-list-applications root\n"
23720 "\n"
23721 msgstr ""
23722
23723 #. type: textblock
23724 #: ../fish/guestfish-actions.pod:2183
23725 msgid ""
23726 "I<Note:> This call works differently from other parts of the inspection "
23727 "API.  You have to call L</inspect-os>, then L</inspect-get-mountpoints>, "
23728 "then mount up the disks, before calling this.  Listing applications is a "
23729 "significantly more difficult operation which requires access to the full "
23730 "filesystem.  Also note that unlike the other L</inspect-get-*> calls which "
23731 "are just returning data cached in the libguestfs handle, this call actually "
23732 "reads parts of the mounted filesystems during the call."
23733 msgstr ""
23734
23735 #. type: =head2
23736 #: ../fish/guestfish-actions.pod:2273
23737 msgid "inspect-os"
23738 msgstr ""
23739
23740 #. type: verbatim
23741 #: ../fish/guestfish-actions.pod:2275
23742 #, no-wrap
23743 msgid ""
23744 " inspect-os\n"
23745 "\n"
23746 msgstr ""
23747
23748 #. type: textblock
23749 #: ../fish/guestfish-actions.pod:2290
23750 msgid ""
23751 "You can pass the root string(s) returned to other L</inspect-get-*> "
23752 "functions in order to query further information about each operating system, "
23753 "such as the name and version."
23754 msgstr ""
23755
23756 #. type: textblock
23757 #: ../fish/guestfish-actions.pod:2295
23758 msgid ""
23759 "This function uses other libguestfs features such as L</mount-ro> and "
23760 "L</umount-all> in order to mount and unmount filesystems and look at the "
23761 "contents.  This should be called with no disks currently mounted.  The "
23762 "function may also use Augeas, so any existing Augeas handle will be closed."
23763 msgstr ""
23764
23765 #. type: textblock
23766 #: ../fish/guestfish-actions.pod:2307 ../fish/guestfish-actions.pod:2483 ../fish/guestfish-actions.pod:2529
23767 msgid "See also L</list-filesystems>."
23768 msgstr ""
23769
23770 #. type: =head2
23771 #: ../fish/guestfish-actions.pod:2309
23772 msgid "is-blockdev"
23773 msgstr ""
23774
23775 #. type: verbatim
23776 #: ../fish/guestfish-actions.pod:2311
23777 #, no-wrap
23778 msgid ""
23779 " is-blockdev path\n"
23780 "\n"
23781 msgstr ""
23782
23783 #. type: textblock
23784 #: ../fish/guestfish-actions.pod:2316 ../fish/guestfish-actions.pod:2334 ../fish/guestfish-actions.pod:2353 ../fish/guestfish-actions.pod:2362 ../fish/guestfish-actions.pod:2372 ../fish/guestfish-actions.pod:2406 ../fish/guestfish-actions.pod:2415
23785 msgid "See also L</stat>."
23786 msgstr ""
23787
23788 #. type: =head2
23789 #: ../fish/guestfish-actions.pod:2318
23790 msgid "is-busy"
23791 msgstr ""
23792
23793 #. type: verbatim
23794 #: ../fish/guestfish-actions.pod:2320
23795 #, no-wrap
23796 msgid ""
23797 " is-busy\n"
23798 "\n"
23799 msgstr ""
23800
23801 #. type: =head2
23802 #: ../fish/guestfish-actions.pod:2327
23803 msgid "is-chardev"
23804 msgstr ""
23805
23806 #. type: verbatim
23807 #: ../fish/guestfish-actions.pod:2329
23808 #, no-wrap
23809 msgid ""
23810 " is-chardev path\n"
23811 "\n"
23812 msgstr ""
23813
23814 #. type: =head2
23815 #: ../fish/guestfish-actions.pod:2336
23816 msgid "is-config"
23817 msgstr ""
23818
23819 #. type: verbatim
23820 #: ../fish/guestfish-actions.pod:2338
23821 #, no-wrap
23822 msgid ""
23823 " is-config\n"
23824 "\n"
23825 msgstr ""
23826
23827 #. type: =head2
23828 #: ../fish/guestfish-actions.pod:2345
23829 msgid "is-dir"
23830 msgstr ""
23831
23832 #. type: verbatim
23833 #: ../fish/guestfish-actions.pod:2347
23834 #, no-wrap
23835 msgid ""
23836 " is-dir path\n"
23837 "\n"
23838 msgstr ""
23839
23840 #. type: =head2
23841 #: ../fish/guestfish-actions.pod:2355
23842 msgid "is-fifo"
23843 msgstr ""
23844
23845 #. type: verbatim
23846 #: ../fish/guestfish-actions.pod:2357
23847 #, no-wrap
23848 msgid ""
23849 " is-fifo path\n"
23850 "\n"
23851 msgstr ""
23852
23853 #. type: =head2
23854 #: ../fish/guestfish-actions.pod:2364
23855 msgid "is-file"
23856 msgstr ""
23857
23858 #. type: verbatim
23859 #: ../fish/guestfish-actions.pod:2366
23860 #, no-wrap
23861 msgid ""
23862 " is-file path\n"
23863 "\n"
23864 msgstr ""
23865
23866 #. type: =head2
23867 #: ../fish/guestfish-actions.pod:2374
23868 msgid "is-launching"
23869 msgstr ""
23870
23871 #. type: verbatim
23872 #: ../fish/guestfish-actions.pod:2376
23873 #, no-wrap
23874 msgid ""
23875 " is-launching\n"
23876 "\n"
23877 msgstr ""
23878
23879 #. type: =head2
23880 #: ../fish/guestfish-actions.pod:2383
23881 msgid "is-lv"
23882 msgstr ""
23883
23884 #. type: verbatim
23885 #: ../fish/guestfish-actions.pod:2385
23886 #, no-wrap
23887 msgid ""
23888 " is-lv device\n"
23889 "\n"
23890 msgstr ""
23891
23892 #. type: =head2
23893 #: ../fish/guestfish-actions.pod:2390
23894 msgid "is-ready"
23895 msgstr ""
23896
23897 #. type: verbatim
23898 #: ../fish/guestfish-actions.pod:2392
23899 #, no-wrap
23900 msgid ""
23901 " is-ready\n"
23902 "\n"
23903 msgstr ""
23904
23905 #. type: =head2
23906 #: ../fish/guestfish-actions.pod:2399
23907 msgid "is-socket"
23908 msgstr ""
23909
23910 #. type: verbatim
23911 #: ../fish/guestfish-actions.pod:2401
23912 #, no-wrap
23913 msgid ""
23914 " is-socket path\n"
23915 "\n"
23916 msgstr ""
23917
23918 #. type: =head2
23919 #: ../fish/guestfish-actions.pod:2408
23920 msgid "is-symlink"
23921 msgstr ""
23922
23923 #. type: verbatim
23924 #: ../fish/guestfish-actions.pod:2410
23925 #, no-wrap
23926 msgid ""
23927 " is-symlink path\n"
23928 "\n"
23929 msgstr ""
23930
23931 #. type: =head2
23932 #: ../fish/guestfish-actions.pod:2417
23933 msgid "kill-subprocess"
23934 msgstr ""
23935
23936 #. type: verbatim
23937 #: ../fish/guestfish-actions.pod:2419
23938 #, no-wrap
23939 msgid ""
23940 " kill-subprocess\n"
23941 "\n"
23942 msgstr ""
23943
23944 #. type: =head2
23945 #: ../fish/guestfish-actions.pod:2423
23946 msgid "launch"
23947 msgstr ""
23948
23949 #. type: =head2
23950 #: ../fish/guestfish-actions.pod:2425
23951 msgid "run"
23952 msgstr ""
23953
23954 #. type: verbatim
23955 #: ../fish/guestfish-actions.pod:2427
23956 #, no-wrap
23957 msgid ""
23958 " launch\n"
23959 "\n"
23960 msgstr ""
23961
23962 #. type: =head2
23963 #: ../fish/guestfish-actions.pod:2435
23964 msgid "lchown"
23965 msgstr ""
23966
23967 #. type: verbatim
23968 #: ../fish/guestfish-actions.pod:2437
23969 #, no-wrap
23970 msgid ""
23971 " lchown owner group path\n"
23972 "\n"
23973 msgstr ""
23974
23975 #. type: textblock
23976 #: ../fish/guestfish-actions.pod:2439
23977 msgid ""
23978 "Change the file owner to C<owner> and group to C<group>.  This is like "
23979 "L</chown> but if C<path> is a symlink then the link itself is changed, not "
23980 "the target."
23981 msgstr ""
23982
23983 #. type: =head2
23984 #: ../fish/guestfish-actions.pod:2447
23985 msgid "lgetxattr"
23986 msgstr ""
23987
23988 #. type: verbatim
23989 #: ../fish/guestfish-actions.pod:2449
23990 #, no-wrap
23991 msgid ""
23992 " lgetxattr path name\n"
23993 "\n"
23994 msgstr ""
23995
23996 #. type: textblock
23997 #: ../fish/guestfish-actions.pod:2465
23998 msgid "See also: L</lgetxattrs>, L</getxattr>, L<attr(5)>."
23999 msgstr ""
24000
24001 #. type: =head2
24002 #: ../fish/guestfish-actions.pod:2467
24003 msgid "lgetxattrs"
24004 msgstr ""
24005
24006 #. type: verbatim
24007 #: ../fish/guestfish-actions.pod:2469
24008 #, no-wrap
24009 msgid ""
24010 " lgetxattrs path\n"
24011 "\n"
24012 msgstr ""
24013
24014 #. type: textblock
24015 #: ../fish/guestfish-actions.pod:2471
24016 msgid ""
24017 "This is the same as L</getxattrs>, but if C<path> is a symbolic link, then "
24018 "it returns the extended attributes of the link itself."
24019 msgstr ""
24020
24021 #. type: =head2
24022 #: ../fish/guestfish-actions.pod:2475
24023 msgid "list-devices"
24024 msgstr ""
24025
24026 #. type: verbatim
24027 #: ../fish/guestfish-actions.pod:2477
24028 #, no-wrap
24029 msgid ""
24030 " list-devices\n"
24031 "\n"
24032 msgstr ""
24033
24034 #. type: =head2
24035 #: ../fish/guestfish-actions.pod:2485
24036 msgid "list-filesystems"
24037 msgstr ""
24038
24039 #. type: verbatim
24040 #: ../fish/guestfish-actions.pod:2487
24041 #, no-wrap
24042 msgid ""
24043 " list-filesystems\n"
24044 "\n"
24045 msgstr ""
24046
24047 #. type: textblock
24048 #: ../fish/guestfish-actions.pod:2506
24049 msgid ""
24050 "This command runs other libguestfs commands, which might include L</mount> "
24051 "and L</umount>, and therefore you should use this soon after launch and only "
24052 "when nothing is mounted."
24053 msgstr ""
24054
24055 #. type: textblock
24056 #: ../fish/guestfish-actions.pod:2510
24057 msgid ""
24058 "Not all of the filesystems returned will be mountable.  In particular, swap "
24059 "partitions are returned in the list.  Also this command does not check that "
24060 "each filesystem found is valid and mountable, and some filesystems might be "
24061 "mountable but require special options.  Filesystems may not all belong to a "
24062 "single logical operating system (use L</inspect-os> to look for OSes)."
24063 msgstr ""
24064
24065 #. type: =head2
24066 #: ../fish/guestfish-actions.pod:2518
24067 msgid "list-partitions"
24068 msgstr ""
24069
24070 #. type: verbatim
24071 #: ../fish/guestfish-actions.pod:2520
24072 #, no-wrap
24073 msgid ""
24074 " list-partitions\n"
24075 "\n"
24076 msgstr ""
24077
24078 #. type: textblock
24079 #: ../fish/guestfish-actions.pod:2526
24080 msgid ""
24081 "This does not return logical volumes.  For that you will need to call "
24082 "L</lvs>."
24083 msgstr ""
24084
24085 #. type: =head2
24086 #: ../fish/guestfish-actions.pod:2531
24087 msgid "ll"
24088 msgstr ""
24089
24090 #. type: verbatim
24091 #: ../fish/guestfish-actions.pod:2533
24092 #, no-wrap
24093 msgid ""
24094 " ll directory\n"
24095 "\n"
24096 msgstr ""
24097
24098 #. type: =head2
24099 #: ../fish/guestfish-actions.pod:2541
24100 msgid "ln"
24101 msgstr ""
24102
24103 #. type: verbatim
24104 #: ../fish/guestfish-actions.pod:2543
24105 #, no-wrap
24106 msgid ""
24107 " ln target linkname\n"
24108 "\n"
24109 msgstr ""
24110
24111 #. type: =head2
24112 #: ../fish/guestfish-actions.pod:2547
24113 msgid "ln-f"
24114 msgstr ""
24115
24116 #. type: verbatim
24117 #: ../fish/guestfish-actions.pod:2549
24118 #, no-wrap
24119 msgid ""
24120 " ln-f target linkname\n"
24121 "\n"
24122 msgstr ""
24123
24124 #. type: =head2
24125 #: ../fish/guestfish-actions.pod:2554
24126 msgid "ln-s"
24127 msgstr ""
24128
24129 #. type: verbatim
24130 #: ../fish/guestfish-actions.pod:2556
24131 #, no-wrap
24132 msgid ""
24133 " ln-s target linkname\n"
24134 "\n"
24135 msgstr ""
24136
24137 #. type: =head2
24138 #: ../fish/guestfish-actions.pod:2560
24139 msgid "ln-sf"
24140 msgstr ""
24141
24142 #. type: verbatim
24143 #: ../fish/guestfish-actions.pod:2562
24144 #, no-wrap
24145 msgid ""
24146 " ln-sf target linkname\n"
24147 "\n"
24148 msgstr ""
24149
24150 #. type: =head2
24151 #: ../fish/guestfish-actions.pod:2567
24152 msgid "lremovexattr"
24153 msgstr ""
24154
24155 #. type: verbatim
24156 #: ../fish/guestfish-actions.pod:2569
24157 #, no-wrap
24158 msgid ""
24159 " lremovexattr xattr path\n"
24160 "\n"
24161 msgstr ""
24162
24163 #. type: textblock
24164 #: ../fish/guestfish-actions.pod:2571
24165 msgid ""
24166 "This is the same as L</removexattr>, but if C<path> is a symbolic link, then "
24167 "it removes an extended attribute of the link itself."
24168 msgstr ""
24169
24170 #. type: =head2
24171 #: ../fish/guestfish-actions.pod:2575
24172 msgid "ls"
24173 msgstr ""
24174
24175 #. type: verbatim
24176 #: ../fish/guestfish-actions.pod:2577
24177 #, no-wrap
24178 msgid ""
24179 " ls directory\n"
24180 "\n"
24181 msgstr ""
24182
24183 #. type: textblock
24184 #: ../fish/guestfish-actions.pod:2583
24185 msgid ""
24186 "This command is mostly useful for interactive sessions.  Programs should "
24187 "probably use L</readdir> instead."
24188 msgstr ""
24189
24190 #. type: =head2
24191 #: ../fish/guestfish-actions.pod:2586
24192 msgid "lsetxattr"
24193 msgstr ""
24194
24195 #. type: verbatim
24196 #: ../fish/guestfish-actions.pod:2588
24197 #, no-wrap
24198 msgid ""
24199 " lsetxattr xattr val vallen path\n"
24200 "\n"
24201 msgstr ""
24202
24203 #. type: textblock
24204 #: ../fish/guestfish-actions.pod:2590
24205 msgid ""
24206 "This is the same as L</setxattr>, but if C<path> is a symbolic link, then it "
24207 "sets an extended attribute of the link itself."
24208 msgstr ""
24209
24210 #. type: =head2
24211 #: ../fish/guestfish-actions.pod:2594
24212 msgid "lstat"
24213 msgstr ""
24214
24215 #. type: verbatim
24216 #: ../fish/guestfish-actions.pod:2596
24217 #, no-wrap
24218 msgid ""
24219 " lstat path\n"
24220 "\n"
24221 msgstr ""
24222
24223 #. type: textblock
24224 #: ../fish/guestfish-actions.pod:2600
24225 msgid ""
24226 "This is the same as L</stat> except that if C<path> is a symbolic link, then "
24227 "the link is stat-ed, not the file it refers to."
24228 msgstr ""
24229
24230 #. type: =head2
24231 #: ../fish/guestfish-actions.pod:2606
24232 msgid "lstatlist"
24233 msgstr ""
24234
24235 #. type: verbatim
24236 #: ../fish/guestfish-actions.pod:2608
24237 #, no-wrap
24238 msgid ""
24239 " lstatlist path 'names ...'\n"
24240 "\n"
24241 msgstr ""
24242
24243 #. type: textblock
24244 #: ../fish/guestfish-actions.pod:2610
24245 msgid ""
24246 "This call allows you to perform the L</lstat> operation on multiple files, "
24247 "where all files are in the directory C<path>.  C<names> is the list of files "
24248 "from this directory."
24249 msgstr ""
24250
24251 #. type: textblock
24252 #: ../fish/guestfish-actions.pod:2619
24253 msgid ""
24254 "This call is intended for programs that want to efficiently list a directory "
24255 "contents without making many round-trips.  See also L</lxattrlist> for a "
24256 "similarly efficient call for getting extended attributes.  Very long "
24257 "directory listings might cause the protocol message size to be exceeded, "
24258 "causing this call to fail.  The caller must split up such requests into "
24259 "smaller groups of names."
24260 msgstr ""
24261
24262 #. type: =head2
24263 #: ../fish/guestfish-actions.pod:2627
24264 msgid "luks-add-key"
24265 msgstr ""
24266
24267 #. type: verbatim
24268 #: ../fish/guestfish-actions.pod:2629
24269 #, no-wrap
24270 msgid ""
24271 " luks-add-key device keyslot\n"
24272 "\n"
24273 msgstr ""
24274
24275 #. type: textblock
24276 #: ../fish/guestfish-actions.pod:2636
24277 msgid ""
24278 "Note that if C<keyslot> already contains a key, then this command will "
24279 "fail.  You have to use L</luks-kill-slot> first to remove that key."
24280 msgstr ""
24281
24282 #. type: textblock
24283 #: ../fish/guestfish-actions.pod:2640 ../fish/guestfish-actions.pod:2662 ../fish/guestfish-actions.pod:2675 ../fish/guestfish-actions.pod:2689 ../fish/guestfish-actions.pod:2712 ../fish/guestfish-actions.pod:2722
24284 msgid ""
24285 "This command has one or more key or passphrase parameters.  Guestfish will "
24286 "prompt for these separately."
24287 msgstr ""
24288
24289 #. type: =head2
24290 #: ../fish/guestfish-actions.pod:2643
24291 msgid "luks-close"
24292 msgstr ""
24293
24294 #. type: verbatim
24295 #: ../fish/guestfish-actions.pod:2645
24296 #, no-wrap
24297 msgid ""
24298 " luks-close device\n"
24299 "\n"
24300 msgstr ""
24301
24302 #. type: textblock
24303 #: ../fish/guestfish-actions.pod:2647
24304 msgid ""
24305 "This closes a LUKS device that was created earlier by L</luks-open> or "
24306 "L</luks-open-ro>.  The C<device> parameter must be the name of the LUKS "
24307 "mapping device (ie. C</dev/mapper/mapname>) and I<not> the name of the "
24308 "underlying block device."
24309 msgstr ""
24310
24311 #. type: =head2
24312 #: ../fish/guestfish-actions.pod:2653
24313 msgid "luks-format"
24314 msgstr ""
24315
24316 #. type: verbatim
24317 #: ../fish/guestfish-actions.pod:2655
24318 #, no-wrap
24319 msgid ""
24320 " luks-format device keyslot\n"
24321 "\n"
24322 msgstr ""
24323
24324 #. type: =head2
24325 #: ../fish/guestfish-actions.pod:2668
24326 msgid "luks-format-cipher"
24327 msgstr ""
24328
24329 #. type: verbatim
24330 #: ../fish/guestfish-actions.pod:2670
24331 #, no-wrap
24332 msgid ""
24333 " luks-format-cipher device keyslot cipher\n"
24334 "\n"
24335 msgstr ""
24336
24337 #. type: textblock
24338 #: ../fish/guestfish-actions.pod:2672
24339 msgid ""
24340 "This command is the same as L</luks-format> but it also allows you to set "
24341 "the C<cipher> used."
24342 msgstr ""
24343
24344 #. type: =head2
24345 #: ../fish/guestfish-actions.pod:2681
24346 msgid "luks-kill-slot"
24347 msgstr ""
24348
24349 #. type: verbatim
24350 #: ../fish/guestfish-actions.pod:2683
24351 #, no-wrap
24352 msgid ""
24353 " luks-kill-slot device keyslot\n"
24354 "\n"
24355 msgstr ""
24356
24357 #. type: =head2
24358 #: ../fish/guestfish-actions.pod:2692
24359 msgid "luks-open"
24360 msgstr ""
24361
24362 #. type: verbatim
24363 #: ../fish/guestfish-actions.pod:2694
24364 #, no-wrap
24365 msgid ""
24366 " luks-open device mapname\n"
24367 "\n"
24368 msgstr ""
24369
24370 #. type: textblock
24371 #: ../fish/guestfish-actions.pod:2708
24372 msgid ""
24373 "If this block device contains LVM volume groups, then calling L</vgscan> "
24374 "followed by L</vg-activate-all> will make them visible."
24375 msgstr ""
24376
24377 #. type: =head2
24378 #: ../fish/guestfish-actions.pod:2715
24379 msgid "luks-open-ro"
24380 msgstr ""
24381
24382 #. type: verbatim
24383 #: ../fish/guestfish-actions.pod:2717
24384 #, no-wrap
24385 msgid ""
24386 " luks-open-ro device mapname\n"
24387 "\n"
24388 msgstr ""
24389
24390 #. type: textblock
24391 #: ../fish/guestfish-actions.pod:2719
24392 msgid ""
24393 "This is the same as L</luks-open> except that a read-only mapping is "
24394 "created."
24395 msgstr ""
24396
24397 #. type: =head2
24398 #: ../fish/guestfish-actions.pod:2725
24399 msgid "lvcreate"
24400 msgstr ""
24401
24402 #. type: verbatim
24403 #: ../fish/guestfish-actions.pod:2727
24404 #, no-wrap
24405 msgid ""
24406 " lvcreate logvol volgroup mbytes\n"
24407 "\n"
24408 msgstr ""
24409
24410 #. type: =head2
24411 #: ../fish/guestfish-actions.pod:2732
24412 msgid "lvm-canonical-lv-name"
24413 msgstr ""
24414
24415 #. type: verbatim
24416 #: ../fish/guestfish-actions.pod:2734
24417 #, no-wrap
24418 msgid ""
24419 " lvm-canonical-lv-name lvname\n"
24420 "\n"
24421 msgstr ""
24422
24423 #. type: textblock
24424 #: ../fish/guestfish-actions.pod:2743
24425 msgid "See also L</is-lv>."
24426 msgstr ""
24427
24428 #. type: =head2
24429 #: ../fish/guestfish-actions.pod:2745
24430 msgid "lvm-clear-filter"
24431 msgstr ""
24432
24433 #. type: verbatim
24434 #: ../fish/guestfish-actions.pod:2747
24435 #, no-wrap
24436 msgid ""
24437 " lvm-clear-filter\n"
24438 "\n"
24439 msgstr ""
24440
24441 #. type: textblock
24442 #: ../fish/guestfish-actions.pod:2749
24443 msgid ""
24444 "This undoes the effect of L</lvm-set-filter>.  LVM will be able to see every "
24445 "block device."
24446 msgstr ""
24447
24448 #. type: =head2
24449 #: ../fish/guestfish-actions.pod:2755
24450 msgid "lvm-remove-all"
24451 msgstr ""
24452
24453 #. type: verbatim
24454 #: ../fish/guestfish-actions.pod:2757
24455 #, no-wrap
24456 msgid ""
24457 " lvm-remove-all\n"
24458 "\n"
24459 msgstr ""
24460
24461 #. type: =head2
24462 #: ../fish/guestfish-actions.pod:2765
24463 msgid "lvm-set-filter"
24464 msgstr ""
24465
24466 #. type: verbatim
24467 #: ../fish/guestfish-actions.pod:2767
24468 #, no-wrap
24469 msgid ""
24470 " lvm-set-filter 'devices ...'\n"
24471 "\n"
24472 msgstr ""
24473
24474 #. type: =head2
24475 #: ../fish/guestfish-actions.pod:2792
24476 msgid "lvremove"
24477 msgstr ""
24478
24479 #. type: verbatim
24480 #: ../fish/guestfish-actions.pod:2794
24481 #, no-wrap
24482 msgid ""
24483 " lvremove device\n"
24484 "\n"
24485 msgstr ""
24486
24487 #. type: =head2
24488 #: ../fish/guestfish-actions.pod:2802
24489 msgid "lvrename"
24490 msgstr ""
24491
24492 #. type: verbatim
24493 #: ../fish/guestfish-actions.pod:2804
24494 #, no-wrap
24495 msgid ""
24496 " lvrename logvol newlogvol\n"
24497 "\n"
24498 msgstr ""
24499
24500 #. type: =head2
24501 #: ../fish/guestfish-actions.pod:2808
24502 msgid "lvresize"
24503 msgstr ""
24504
24505 #. type: verbatim
24506 #: ../fish/guestfish-actions.pod:2810
24507 #, no-wrap
24508 msgid ""
24509 " lvresize device mbytes\n"
24510 "\n"
24511 msgstr ""
24512
24513 #. type: =head2
24514 #: ../fish/guestfish-actions.pod:2816
24515 msgid "lvresize-free"
24516 msgstr ""
24517
24518 #. type: verbatim
24519 #: ../fish/guestfish-actions.pod:2818
24520 #, no-wrap
24521 msgid ""
24522 " lvresize-free lv percent\n"
24523 "\n"
24524 msgstr ""
24525
24526 #. type: =head2
24527 #: ../fish/guestfish-actions.pod:2826
24528 msgid "lvs"
24529 msgstr ""
24530
24531 #. type: verbatim
24532 #: ../fish/guestfish-actions.pod:2828
24533 #, no-wrap
24534 msgid ""
24535 " lvs\n"
24536 "\n"
24537 msgstr ""
24538
24539 #. type: textblock
24540 #: ../fish/guestfish-actions.pod:2836
24541 msgid "See also L</lvs-full>, L</list-filesystems>."
24542 msgstr ""
24543
24544 #. type: =head2
24545 #: ../fish/guestfish-actions.pod:2838
24546 msgid "lvs-full"
24547 msgstr ""
24548
24549 #. type: verbatim
24550 #: ../fish/guestfish-actions.pod:2840
24551 #, no-wrap
24552 msgid ""
24553 " lvs-full\n"
24554 "\n"
24555 msgstr ""
24556
24557 #. type: =head2
24558 #: ../fish/guestfish-actions.pod:2845
24559 msgid "lvuuid"
24560 msgstr ""
24561
24562 #. type: verbatim
24563 #: ../fish/guestfish-actions.pod:2847
24564 #, no-wrap
24565 msgid ""
24566 " lvuuid device\n"
24567 "\n"
24568 msgstr ""
24569
24570 #. type: =head2
24571 #: ../fish/guestfish-actions.pod:2851
24572 msgid "lxattrlist"
24573 msgstr ""
24574
24575 #. type: verbatim
24576 #: ../fish/guestfish-actions.pod:2853
24577 #, no-wrap
24578 msgid ""
24579 " lxattrlist path 'names ...'\n"
24580 "\n"
24581 msgstr ""
24582
24583 #. type: textblock
24584 #: ../fish/guestfish-actions.pod:2869
24585 msgid ""
24586 "This call is intended for programs that want to efficiently list a directory "
24587 "contents without making many round-trips.  See also L</lstatlist> for a "
24588 "similarly efficient call for getting standard stats.  Very long directory "
24589 "listings might cause the protocol message size to be exceeded, causing this "
24590 "call to fail.  The caller must split up such requests into smaller groups of "
24591 "names."
24592 msgstr ""
24593
24594 #. type: =head2
24595 #: ../fish/guestfish-actions.pod:2877
24596 msgid "mkdir"
24597 msgstr ""
24598
24599 #. type: verbatim
24600 #: ../fish/guestfish-actions.pod:2879
24601 #, no-wrap
24602 msgid ""
24603 " mkdir path\n"
24604 "\n"
24605 msgstr ""
24606
24607 #. type: =head2
24608 #: ../fish/guestfish-actions.pod:2883
24609 msgid "mkdir-mode"
24610 msgstr ""
24611
24612 #. type: verbatim
24613 #: ../fish/guestfish-actions.pod:2885
24614 #, no-wrap
24615 msgid ""
24616 " mkdir-mode path mode\n"
24617 "\n"
24618 msgstr ""
24619
24620 #. type: textblock
24621 #: ../fish/guestfish-actions.pod:2894
24622 msgid "See also L</mkdir>, L</umask>"
24623 msgstr ""
24624
24625 #. type: =head2
24626 #: ../fish/guestfish-actions.pod:2896
24627 msgid "mkdir-p"
24628 msgstr ""
24629
24630 #. type: verbatim
24631 #: ../fish/guestfish-actions.pod:2898
24632 #, no-wrap
24633 msgid ""
24634 " mkdir-p path\n"
24635 "\n"
24636 msgstr ""
24637
24638 #. type: =head2
24639 #: ../fish/guestfish-actions.pod:2903
24640 msgid "mkdtemp"
24641 msgstr ""
24642
24643 #. type: verbatim
24644 #: ../fish/guestfish-actions.pod:2905
24645 #, no-wrap
24646 msgid ""
24647 " mkdtemp template\n"
24648 "\n"
24649 msgstr ""
24650
24651 #. type: =head2
24652 #: ../fish/guestfish-actions.pod:2926
24653 msgid "mke2fs-J"
24654 msgstr ""
24655
24656 #. type: verbatim
24657 #: ../fish/guestfish-actions.pod:2928
24658 #, no-wrap
24659 msgid ""
24660 " mke2fs-J fstype blocksize device journal\n"
24661 "\n"
24662 msgstr ""
24663
24664 #. type: textblock
24665 #: ../fish/guestfish-actions.pod:2936
24666 msgid "See also L</mke2journal>."
24667 msgstr ""
24668
24669 #. type: =head2
24670 #: ../fish/guestfish-actions.pod:2938
24671 msgid "mke2fs-JL"
24672 msgstr ""
24673
24674 #. type: verbatim
24675 #: ../fish/guestfish-actions.pod:2940
24676 #, no-wrap
24677 msgid ""
24678 " mke2fs-JL fstype blocksize device label\n"
24679 "\n"
24680 msgstr ""
24681
24682 #. type: textblock
24683 #: ../fish/guestfish-actions.pod:2945
24684 msgid "See also L</mke2journal-L>."
24685 msgstr ""
24686
24687 #. type: =head2
24688 #: ../fish/guestfish-actions.pod:2947
24689 msgid "mke2fs-JU"
24690 msgstr ""
24691
24692 #. type: verbatim
24693 #: ../fish/guestfish-actions.pod:2949
24694 #, no-wrap
24695 msgid ""
24696 " mke2fs-JU fstype blocksize device uuid\n"
24697 "\n"
24698 msgstr ""
24699
24700 #. type: textblock
24701 #: ../fish/guestfish-actions.pod:2954
24702 msgid "See also L</mke2journal-U>."
24703 msgstr ""
24704
24705 #. type: =head2
24706 #: ../fish/guestfish-actions.pod:2956
24707 msgid "mke2journal"
24708 msgstr ""
24709
24710 #. type: verbatim
24711 #: ../fish/guestfish-actions.pod:2958
24712 #, no-wrap
24713 msgid ""
24714 " mke2journal blocksize device\n"
24715 "\n"
24716 msgstr ""
24717
24718 #. type: =head2
24719 #: ../fish/guestfish-actions.pod:2965
24720 msgid "mke2journal-L"
24721 msgstr ""
24722
24723 #. type: verbatim
24724 #: ../fish/guestfish-actions.pod:2967
24725 #, no-wrap
24726 msgid ""
24727 " mke2journal-L blocksize label device\n"
24728 "\n"
24729 msgstr ""
24730
24731 #. type: =head2
24732 #: ../fish/guestfish-actions.pod:2971
24733 msgid "mke2journal-U"
24734 msgstr ""
24735
24736 #. type: verbatim
24737 #: ../fish/guestfish-actions.pod:2973
24738 #, no-wrap
24739 msgid ""
24740 " mke2journal-U blocksize uuid device\n"
24741 "\n"
24742 msgstr ""
24743
24744 #. type: =head2
24745 #: ../fish/guestfish-actions.pod:2977
24746 msgid "mkfifo"
24747 msgstr ""
24748
24749 #. type: verbatim
24750 #: ../fish/guestfish-actions.pod:2979
24751 #, no-wrap
24752 msgid ""
24753 " mkfifo mode path\n"
24754 "\n"
24755 msgstr ""
24756
24757 #. type: textblock
24758 #: ../fish/guestfish-actions.pod:2981
24759 msgid ""
24760 "This call creates a FIFO (named pipe) called C<path> with mode C<mode>.  It "
24761 "is just a convenient wrapper around L</mknod>."
24762 msgstr ""
24763
24764 #. type: =head2
24765 #: ../fish/guestfish-actions.pod:2987
24766 msgid "mkfs"
24767 msgstr ""
24768
24769 #. type: verbatim
24770 #: ../fish/guestfish-actions.pod:2989
24771 #, no-wrap
24772 msgid ""
24773 " mkfs fstype device\n"
24774 "\n"
24775 msgstr ""
24776
24777 #. type: =head2
24778 #: ../fish/guestfish-actions.pod:2995
24779 msgid "mkfs-b"
24780 msgstr ""
24781
24782 #. type: verbatim
24783 #: ../fish/guestfish-actions.pod:2997
24784 #, no-wrap
24785 msgid ""
24786 " mkfs-b fstype blocksize device\n"
24787 "\n"
24788 msgstr ""
24789
24790 #. type: textblock
24791 #: ../fish/guestfish-actions.pod:2999
24792 msgid ""
24793 "This call is similar to L</mkfs>, but it allows you to control the block "
24794 "size of the resulting filesystem.  Supported block sizes depend on the "
24795 "filesystem type, but typically they are C<1024>, C<2048> or C<4096> only."
24796 msgstr ""
24797
24798 #. type: textblock
24799 #: ../fish/guestfish-actions.pod:3007
24800 msgid ""
24801 "This function is deprecated.  In new code, use the L</mkfs_opts> call "
24802 "instead."
24803 msgstr ""
24804
24805 #. type: =head2
24806 #: ../fish/guestfish-actions.pod:3014
24807 msgid "mkfs-opts"
24808 msgstr ""
24809
24810 #. type: verbatim
24811 #: ../fish/guestfish-actions.pod:3016
24812 #, no-wrap
24813 msgid ""
24814 " mkfs-opts fstype device [blocksize:..] [features:..]\n"
24815 "\n"
24816 msgstr ""
24817
24818 #. type: =head2
24819 #: ../fish/guestfish-actions.pod:3051
24820 msgid "mkmountpoint"
24821 msgstr ""
24822
24823 #. type: verbatim
24824 #: ../fish/guestfish-actions.pod:3053
24825 #, no-wrap
24826 msgid ""
24827 " mkmountpoint exemptpath\n"
24828 "\n"
24829 msgstr ""
24830
24831 #. type: textblock
24832 #: ../fish/guestfish-actions.pod:3055
24833 msgid ""
24834 "L</mkmountpoint> and L</rmmountpoint> are specialized calls that can be used "
24835 "to create extra mountpoints before mounting the first filesystem."
24836 msgstr ""
24837
24838 #. type: textblock
24839 #: ../fish/guestfish-actions.pod:3079
24840 msgid ""
24841 "L</mkmountpoint> is not compatible with L</umount-all>.  You may get "
24842 "unexpected errors if you try to mix these calls.  It is safest to manually "
24843 "unmount filesystems and remove mountpoints after use."
24844 msgstr ""
24845
24846 #. type: textblock
24847 #: ../fish/guestfish-actions.pod:3083
24848 msgid ""
24849 "L</umount-all> unmounts filesystems by sorting the paths longest first, so "
24850 "for this to work for manual mountpoints, you must ensure that the innermost "
24851 "mountpoints have the longest pathnames, as in the example code above."
24852 msgstr ""
24853
24854 #. type: textblock
24855 #: ../fish/guestfish-actions.pod:3090
24856 msgid ""
24857 "Autosync [see L</set-autosync>, this is set by default on handles] can cause "
24858 "L</umount-all> to be called when the handle is closed which can also trigger "
24859 "these issues."
24860 msgstr ""
24861
24862 #. type: =head2
24863 #: ../fish/guestfish-actions.pod:3094
24864 msgid "mknod"
24865 msgstr ""
24866
24867 #. type: verbatim
24868 #: ../fish/guestfish-actions.pod:3096
24869 #, no-wrap
24870 msgid ""
24871 " mknod mode devmajor devminor path\n"
24872 "\n"
24873 msgstr ""
24874
24875 #. type: textblock
24876 #: ../fish/guestfish-actions.pod:3106
24877 msgid ""
24878 "Note that, just like L<mknod(2)>, the mode must be bitwise OR'd with "
24879 "S_IFBLK, S_IFCHR, S_IFIFO or S_IFSOCK (otherwise this call just creates a "
24880 "regular file).  These constants are available in the standard Linux header "
24881 "files, or you can use L</mknod-b>, L</mknod-c> or L</mkfifo> which are "
24882 "wrappers around this command which bitwise OR in the appropriate constant "
24883 "for you."
24884 msgstr ""
24885
24886 #. type: =head2
24887 #: ../fish/guestfish-actions.pod:3116
24888 msgid "mknod-b"
24889 msgstr ""
24890
24891 #. type: verbatim
24892 #: ../fish/guestfish-actions.pod:3118
24893 #, no-wrap
24894 msgid ""
24895 " mknod-b mode devmajor devminor path\n"
24896 "\n"
24897 msgstr ""
24898
24899 #. type: textblock
24900 #: ../fish/guestfish-actions.pod:3120
24901 msgid ""
24902 "This call creates a block device node called C<path> with mode C<mode> and "
24903 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
24904 "wrapper around L</mknod>."
24905 msgstr ""
24906
24907 #. type: =head2
24908 #: ../fish/guestfish-actions.pod:3126
24909 msgid "mknod-c"
24910 msgstr ""
24911
24912 #. type: verbatim
24913 #: ../fish/guestfish-actions.pod:3128
24914 #, no-wrap
24915 msgid ""
24916 " mknod-c mode devmajor devminor path\n"
24917 "\n"
24918 msgstr ""
24919
24920 #. type: textblock
24921 #: ../fish/guestfish-actions.pod:3130
24922 msgid ""
24923 "This call creates a char device node called C<path> with mode C<mode> and "
24924 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
24925 "wrapper around L</mknod>."
24926 msgstr ""
24927
24928 #. type: =head2
24929 #: ../fish/guestfish-actions.pod:3136
24930 msgid "mkswap"
24931 msgstr ""
24932
24933 #. type: verbatim
24934 #: ../fish/guestfish-actions.pod:3138
24935 #, no-wrap
24936 msgid ""
24937 " mkswap device\n"
24938 "\n"
24939 msgstr ""
24940
24941 #. type: =head2
24942 #: ../fish/guestfish-actions.pod:3142
24943 msgid "mkswap-L"
24944 msgstr ""
24945
24946 #. type: verbatim
24947 #: ../fish/guestfish-actions.pod:3144
24948 #, no-wrap
24949 msgid ""
24950 " mkswap-L label device\n"
24951 "\n"
24952 msgstr ""
24953
24954 #. type: =head2
24955 #: ../fish/guestfish-actions.pod:3152
24956 msgid "mkswap-U"
24957 msgstr ""
24958
24959 #. type: verbatim
24960 #: ../fish/guestfish-actions.pod:3154
24961 #, no-wrap
24962 msgid ""
24963 " mkswap-U uuid device\n"
24964 "\n"
24965 msgstr ""
24966
24967 #. type: =head2
24968 #: ../fish/guestfish-actions.pod:3158
24969 msgid "mkswap-file"
24970 msgstr ""
24971
24972 #. type: verbatim
24973 #: ../fish/guestfish-actions.pod:3160
24974 #, no-wrap
24975 msgid ""
24976 " mkswap-file path\n"
24977 "\n"
24978 msgstr ""
24979
24980 #. type: textblock
24981 #: ../fish/guestfish-actions.pod:3164
24982 msgid ""
24983 "This command just writes a swap file signature to an existing file.  To "
24984 "create the file itself, use something like L</fallocate>."
24985 msgstr ""
24986
24987 #. type: =head2
24988 #: ../fish/guestfish-actions.pod:3167
24989 msgid "modprobe"
24990 msgstr ""
24991
24992 #. type: verbatim
24993 #: ../fish/guestfish-actions.pod:3169
24994 #, no-wrap
24995 msgid ""
24996 " modprobe modulename\n"
24997 "\n"
24998 msgstr ""
24999
25000 #. type: =head2
25001 #: ../fish/guestfish-actions.pod:3176
25002 msgid "mount"
25003 msgstr ""
25004
25005 #. type: verbatim
25006 #: ../fish/guestfish-actions.pod:3178
25007 #, no-wrap
25008 msgid ""
25009 " mount device mountpoint\n"
25010 "\n"
25011 msgstr ""
25012
25013 #. type: textblock
25014 #: ../fish/guestfish-actions.pod:3194
25015 msgid ""
25016 "B<Important note:> When you use this call, the filesystem options C<sync> "
25017 "and C<noatime> are set implicitly.  This was originally done because we "
25018 "thought it would improve reliability, but it turns out that I<-o sync> has a "
25019 "very large negative performance impact and negligible effect on "
25020 "reliability.  Therefore we recommend that you avoid using L</mount> in any "
25021 "code that needs performance, and instead use L</mount-options> (use an empty "
25022 "string for the first parameter if you don't want any options)."
25023 msgstr ""
25024
25025 #. type: textblock
25026 #: ../fish/guestfish-actions.pod:3204
25027 msgid ""
25028 "This function is deprecated.  In new code, use the L</mount_options> call "
25029 "instead."
25030 msgstr ""
25031
25032 #. type: =head2
25033 #: ../fish/guestfish-actions.pod:3211
25034 msgid "mount-loop"
25035 msgstr ""
25036
25037 #. type: verbatim
25038 #: ../fish/guestfish-actions.pod:3213
25039 #, no-wrap
25040 msgid ""
25041 " mount-loop file mountpoint\n"
25042 "\n"
25043 msgstr ""
25044
25045 #. type: =head2
25046 #: ../fish/guestfish-actions.pod:3219
25047 msgid "mount-options"
25048 msgstr ""
25049
25050 #. type: verbatim
25051 #: ../fish/guestfish-actions.pod:3221
25052 #, no-wrap
25053 msgid ""
25054 " mount-options options device mountpoint\n"
25055 "\n"
25056 msgstr ""
25057
25058 #. type: textblock
25059 #: ../fish/guestfish-actions.pod:3223
25060 msgid ""
25061 "This is the same as the L</mount> command, but it allows you to set the "
25062 "mount options as for the L<mount(8)> I<-o> flag."
25063 msgstr ""
25064
25065 #. type: =head2
25066 #: ../fish/guestfish-actions.pod:3231
25067 msgid "mount-ro"
25068 msgstr ""
25069
25070 #. type: verbatim
25071 #: ../fish/guestfish-actions.pod:3233
25072 #, no-wrap
25073 msgid ""
25074 " mount-ro device mountpoint\n"
25075 "\n"
25076 msgstr ""
25077
25078 #. type: textblock
25079 #: ../fish/guestfish-actions.pod:3235
25080 msgid ""
25081 "This is the same as the L</mount> command, but it mounts the filesystem with "
25082 "the read-only (I<-o ro>) flag."
25083 msgstr ""
25084
25085 #. type: =head2
25086 #: ../fish/guestfish-actions.pod:3238
25087 msgid "mount-vfs"
25088 msgstr ""
25089
25090 #. type: verbatim
25091 #: ../fish/guestfish-actions.pod:3240
25092 #, no-wrap
25093 msgid ""
25094 " mount-vfs options vfstype device mountpoint\n"
25095 "\n"
25096 msgstr ""
25097
25098 #. type: textblock
25099 #: ../fish/guestfish-actions.pod:3242
25100 msgid ""
25101 "This is the same as the L</mount> command, but it allows you to set both the "
25102 "mount options and the vfstype as for the L<mount(8)> I<-o> and I<-t> flags."
25103 msgstr ""
25104
25105 #. type: =head2
25106 #: ../fish/guestfish-actions.pod:3246
25107 msgid "mountpoints"
25108 msgstr ""
25109
25110 #. type: verbatim
25111 #: ../fish/guestfish-actions.pod:3248
25112 #, no-wrap
25113 msgid ""
25114 " mountpoints\n"
25115 "\n"
25116 msgstr ""
25117
25118 #. type: textblock
25119 #: ../fish/guestfish-actions.pod:3250
25120 msgid ""
25121 "This call is similar to L</mounts>.  That call returns a list of devices.  "
25122 "This one returns a hash table (map) of device name to directory where the "
25123 "device is mounted."
25124 msgstr ""
25125
25126 #. type: =head2
25127 #: ../fish/guestfish-actions.pod:3254
25128 msgid "mounts"
25129 msgstr ""
25130
25131 #. type: verbatim
25132 #: ../fish/guestfish-actions.pod:3256
25133 #, no-wrap
25134 msgid ""
25135 " mounts\n"
25136 "\n"
25137 msgstr ""
25138
25139 #. type: textblock
25140 #: ../fish/guestfish-actions.pod:3263
25141 msgid "See also: L</mountpoints>"
25142 msgstr ""
25143
25144 #. type: =head2
25145 #: ../fish/guestfish-actions.pod:3265
25146 msgid "mv"
25147 msgstr ""
25148
25149 #. type: verbatim
25150 #: ../fish/guestfish-actions.pod:3267
25151 #, no-wrap
25152 msgid ""
25153 " mv src dest\n"
25154 "\n"
25155 msgstr ""
25156
25157 #. type: =head2
25158 #: ../fish/guestfish-actions.pod:3272
25159 msgid "ntfs-3g-probe"
25160 msgstr ""
25161
25162 #. type: verbatim
25163 #: ../fish/guestfish-actions.pod:3274
25164 #, no-wrap
25165 msgid ""
25166 " ntfs-3g-probe true|false device\n"
25167 "\n"
25168 msgstr ""
25169
25170 #. type: =head2
25171 #: ../fish/guestfish-actions.pod:3288
25172 msgid "ntfsresize"
25173 msgstr ""
25174
25175 #. type: verbatim
25176 #: ../fish/guestfish-actions.pod:3290
25177 #, no-wrap
25178 msgid ""
25179 " ntfsresize device\n"
25180 "\n"
25181 msgstr ""
25182
25183 #. type: =head2
25184 #: ../fish/guestfish-actions.pod:3305
25185 msgid "ntfsresize-size"
25186 msgstr ""
25187
25188 #. type: verbatim
25189 #: ../fish/guestfish-actions.pod:3307
25190 #, no-wrap
25191 msgid ""
25192 " ntfsresize-size device size\n"
25193 "\n"
25194 msgstr ""
25195
25196 #. type: textblock
25197 #: ../fish/guestfish-actions.pod:3309
25198 msgid ""
25199 "This command is the same as L</ntfsresize> except that it allows you to "
25200 "specify the new size (in bytes) explicitly."
25201 msgstr ""
25202
25203 #. type: =head2
25204 #: ../fish/guestfish-actions.pod:3312
25205 msgid "part-add"
25206 msgstr ""
25207
25208 #. type: verbatim
25209 #: ../fish/guestfish-actions.pod:3314
25210 #, no-wrap
25211 msgid ""
25212 " part-add device prlogex startsect endsect\n"
25213 "\n"
25214 msgstr ""
25215
25216 #. type: textblock
25217 #: ../fish/guestfish-actions.pod:3316
25218 msgid ""
25219 "This command adds a partition to C<device>.  If there is no partition table "
25220 "on the device, call L</part-init> first."
25221 msgstr ""
25222
25223 #. type: textblock
25224 #: ../fish/guestfish-actions.pod:3328
25225 msgid ""
25226 "Creating a partition which covers the whole disk is not so easy.  Use "
25227 "L</part-disk> to do that."
25228 msgstr ""
25229
25230 #. type: =head2
25231 #: ../fish/guestfish-actions.pod:3331
25232 msgid "part-del"
25233 msgstr ""
25234
25235 #. type: verbatim
25236 #: ../fish/guestfish-actions.pod:3333
25237 #, no-wrap
25238 msgid ""
25239 " part-del device partnum\n"
25240 "\n"
25241 msgstr ""
25242
25243 #. type: =head2
25244 #: ../fish/guestfish-actions.pod:3341
25245 msgid "part-disk"
25246 msgstr ""
25247
25248 #. type: verbatim
25249 #: ../fish/guestfish-actions.pod:3343
25250 #, no-wrap
25251 msgid ""
25252 " part-disk device parttype\n"
25253 "\n"
25254 msgstr ""
25255
25256 #. type: textblock
25257 #: ../fish/guestfish-actions.pod:3345
25258 msgid ""
25259 "This command is simply a combination of L</part-init> followed by "
25260 "L</part-add> to create a single primary partition covering the whole disk."
25261 msgstr ""
25262
25263 #. type: textblock
25264 #: ../fish/guestfish-actions.pod:3349
25265 msgid ""
25266 "C<parttype> is the partition table type, usually C<mbr> or C<gpt>, but other "
25267 "possible values are described in L</part-init>."
25268 msgstr ""
25269
25270 #. type: =head2
25271 #: ../fish/guestfish-actions.pod:3355
25272 msgid "part-get-bootable"
25273 msgstr ""
25274
25275 #. type: verbatim
25276 #: ../fish/guestfish-actions.pod:3357
25277 #, no-wrap
25278 msgid ""
25279 " part-get-bootable device partnum\n"
25280 "\n"
25281 msgstr ""
25282
25283 #. type: textblock
25284 #: ../fish/guestfish-actions.pod:3362
25285 msgid "See also L</part-set-bootable>."
25286 msgstr ""
25287
25288 #. type: =head2
25289 #: ../fish/guestfish-actions.pod:3364
25290 msgid "part-get-mbr-id"
25291 msgstr ""
25292
25293 #. type: verbatim
25294 #: ../fish/guestfish-actions.pod:3366
25295 #, no-wrap
25296 msgid ""
25297 " part-get-mbr-id device partnum\n"
25298 "\n"
25299 msgstr ""
25300
25301 #. type: textblock
25302 #: ../fish/guestfish-actions.pod:3371 ../fish/guestfish-actions.pod:3509
25303 msgid ""
25304 "Note that only MBR (old DOS-style) partitions have type bytes.  You will get "
25305 "undefined results for other partition table types (see "
25306 "L</part-get-parttype>)."
25307 msgstr ""
25308
25309 #. type: =head2
25310 #: ../fish/guestfish-actions.pod:3375
25311 msgid "part-get-parttype"
25312 msgstr ""
25313
25314 #. type: verbatim
25315 #: ../fish/guestfish-actions.pod:3377
25316 #, no-wrap
25317 msgid ""
25318 " part-get-parttype device\n"
25319 "\n"
25320 msgstr ""
25321
25322 #. type: textblock
25323 #: ../fish/guestfish-actions.pod:3382
25324 msgid ""
25325 "Common return values include: C<msdos> (a DOS/Windows style MBR partition "
25326 "table), C<gpt> (a GPT/EFI-style partition table).  Other values are "
25327 "possible, although unusual.  See L</part-init> for a full list."
25328 msgstr ""
25329
25330 #. type: =head2
25331 #: ../fish/guestfish-actions.pod:3387
25332 msgid "part-init"
25333 msgstr ""
25334
25335 #. type: verbatim
25336 #: ../fish/guestfish-actions.pod:3389
25337 #, no-wrap
25338 msgid ""
25339 " part-init device parttype\n"
25340 "\n"
25341 msgstr ""
25342
25343 #. type: textblock
25344 #: ../fish/guestfish-actions.pod:3395
25345 msgid ""
25346 "Initially there are no partitions.  Following this, you should call "
25347 "L</part-add> for each partition required."
25348 msgstr ""
25349
25350 #. type: =head2
25351 #: ../fish/guestfish-actions.pod:3458
25352 msgid "part-list"
25353 msgstr ""
25354
25355 #. type: verbatim
25356 #: ../fish/guestfish-actions.pod:3460
25357 #, no-wrap
25358 msgid ""
25359 " part-list device\n"
25360 "\n"
25361 msgstr ""
25362
25363 #. type: textblock
25364 #: ../fish/guestfish-actions.pod:3475
25365 msgid ""
25366 "Start of the partition I<in bytes>.  To get sectors you have to divide by "
25367 "the device's sector size, see L</blockdev-getss>."
25368 msgstr ""
25369
25370 #. type: =head2
25371 #: ../fish/guestfish-actions.pod:3488
25372 msgid "part-set-bootable"
25373 msgstr ""
25374
25375 #. type: verbatim
25376 #: ../fish/guestfish-actions.pod:3490
25377 #, no-wrap
25378 msgid ""
25379 " part-set-bootable device partnum true|false\n"
25380 "\n"
25381 msgstr ""
25382
25383 #. type: =head2
25384 #: ../fish/guestfish-actions.pod:3499
25385 msgid "part-set-mbr-id"
25386 msgstr ""
25387
25388 #. type: verbatim
25389 #: ../fish/guestfish-actions.pod:3501
25390 #, no-wrap
25391 msgid ""
25392 " part-set-mbr-id device partnum idbyte\n"
25393 "\n"
25394 msgstr ""
25395
25396 #. type: =head2
25397 #: ../fish/guestfish-actions.pod:3513
25398 msgid "part-set-name"
25399 msgstr ""
25400
25401 #. type: verbatim
25402 #: ../fish/guestfish-actions.pod:3515
25403 #, no-wrap
25404 msgid ""
25405 " part-set-name device partnum name\n"
25406 "\n"
25407 msgstr ""
25408
25409 #. type: =head2
25410 #: ../fish/guestfish-actions.pod:3523
25411 msgid "part-to-dev"
25412 msgstr ""
25413
25414 #. type: verbatim
25415 #: ../fish/guestfish-actions.pod:3525
25416 #, no-wrap
25417 msgid ""
25418 " part-to-dev partition\n"
25419 "\n"
25420 msgstr ""
25421
25422 #. type: textblock
25423 #: ../fish/guestfish-actions.pod:3531
25424 msgid ""
25425 "The named partition must exist, for example as a string returned from "
25426 "L</list-partitions>."
25427 msgstr ""
25428
25429 #. type: =head2
25430 #: ../fish/guestfish-actions.pod:3534
25431 msgid "ping-daemon"
25432 msgstr ""
25433
25434 #. type: verbatim
25435 #: ../fish/guestfish-actions.pod:3536
25436 #, no-wrap
25437 msgid ""
25438 " ping-daemon\n"
25439 "\n"
25440 msgstr ""
25441
25442 #. type: =head2
25443 #: ../fish/guestfish-actions.pod:3543
25444 msgid "pread"
25445 msgstr ""
25446
25447 #. type: verbatim
25448 #: ../fish/guestfish-actions.pod:3545
25449 #, no-wrap
25450 msgid ""
25451 " pread path count offset\n"
25452 "\n"
25453 msgstr ""
25454
25455 #. type: textblock
25456 #: ../fish/guestfish-actions.pod:3553
25457 msgid "See also L</pwrite>, L</pread-device>."
25458 msgstr ""
25459
25460 #. type: =head2
25461 #: ../fish/guestfish-actions.pod:3558
25462 msgid "pread-device"
25463 msgstr ""
25464
25465 #. type: verbatim
25466 #: ../fish/guestfish-actions.pod:3560
25467 #, no-wrap
25468 msgid ""
25469 " pread-device device count offset\n"
25470 "\n"
25471 msgstr ""
25472
25473 #. type: textblock
25474 #: ../fish/guestfish-actions.pod:3568
25475 msgid "See also L</pread>."
25476 msgstr ""
25477
25478 #. type: =head2
25479 #: ../fish/guestfish-actions.pod:3573
25480 msgid "pvcreate"
25481 msgstr ""
25482
25483 #. type: verbatim
25484 #: ../fish/guestfish-actions.pod:3575
25485 #, no-wrap
25486 msgid ""
25487 " pvcreate device\n"
25488 "\n"
25489 msgstr ""
25490
25491 #. type: =head2
25492 #: ../fish/guestfish-actions.pod:3581
25493 msgid "pvremove"
25494 msgstr ""
25495
25496 #. type: verbatim
25497 #: ../fish/guestfish-actions.pod:3583
25498 #, no-wrap
25499 msgid ""
25500 " pvremove device\n"
25501 "\n"
25502 msgstr ""
25503
25504 #. type: =head2
25505 #: ../fish/guestfish-actions.pod:3592
25506 msgid "pvresize"
25507 msgstr ""
25508
25509 #. type: verbatim
25510 #: ../fish/guestfish-actions.pod:3594
25511 #, no-wrap
25512 msgid ""
25513 " pvresize device\n"
25514 "\n"
25515 msgstr ""
25516
25517 #. type: =head2
25518 #: ../fish/guestfish-actions.pod:3599
25519 msgid "pvresize-size"
25520 msgstr ""
25521
25522 #. type: verbatim
25523 #: ../fish/guestfish-actions.pod:3601
25524 #, no-wrap
25525 msgid ""
25526 " pvresize-size device size\n"
25527 "\n"
25528 msgstr ""
25529
25530 #. type: textblock
25531 #: ../fish/guestfish-actions.pod:3603
25532 msgid ""
25533 "This command is the same as L</pvresize> except that it allows you to "
25534 "specify the new size (in bytes) explicitly."
25535 msgstr ""
25536
25537 #. type: =head2
25538 #: ../fish/guestfish-actions.pod:3606
25539 msgid "pvs"
25540 msgstr ""
25541
25542 #. type: verbatim
25543 #: ../fish/guestfish-actions.pod:3608
25544 #, no-wrap
25545 msgid ""
25546 " pvs\n"
25547 "\n"
25548 msgstr ""
25549
25550 #. type: textblock
25551 #: ../fish/guestfish-actions.pod:3616
25552 msgid "See also L</pvs-full>."
25553 msgstr ""
25554
25555 #. type: =head2
25556 #: ../fish/guestfish-actions.pod:3618
25557 msgid "pvs-full"
25558 msgstr ""
25559
25560 #. type: verbatim
25561 #: ../fish/guestfish-actions.pod:3620
25562 #, no-wrap
25563 msgid ""
25564 " pvs-full\n"
25565 "\n"
25566 msgstr ""
25567
25568 #. type: =head2
25569 #: ../fish/guestfish-actions.pod:3625
25570 msgid "pvuuid"
25571 msgstr ""
25572
25573 #. type: verbatim
25574 #: ../fish/guestfish-actions.pod:3627
25575 #, no-wrap
25576 msgid ""
25577 " pvuuid device\n"
25578 "\n"
25579 msgstr ""
25580
25581 #. type: =head2
25582 #: ../fish/guestfish-actions.pod:3631
25583 msgid "pwrite"
25584 msgstr ""
25585
25586 #. type: verbatim
25587 #: ../fish/guestfish-actions.pod:3633
25588 #, no-wrap
25589 msgid ""
25590 " pwrite path content offset\n"
25591 "\n"
25592 msgstr ""
25593
25594 #. type: textblock
25595 #: ../fish/guestfish-actions.pod:3644
25596 msgid "See also L</pread>, L</pwrite-device>."
25597 msgstr ""
25598
25599 #. type: =head2
25600 #: ../fish/guestfish-actions.pod:3649
25601 msgid "pwrite-device"
25602 msgstr ""
25603
25604 #. type: verbatim
25605 #: ../fish/guestfish-actions.pod:3651
25606 #, no-wrap
25607 msgid ""
25608 " pwrite-device device content offset\n"
25609 "\n"
25610 msgstr ""
25611
25612 #. type: textblock
25613 #: ../fish/guestfish-actions.pod:3661
25614 msgid "See also L</pwrite>."
25615 msgstr ""
25616
25617 #. type: =head2
25618 #: ../fish/guestfish-actions.pod:3666
25619 msgid "read-file"
25620 msgstr ""
25621
25622 #. type: verbatim
25623 #: ../fish/guestfish-actions.pod:3668
25624 #, no-wrap
25625 msgid ""
25626 " read-file path\n"
25627 "\n"
25628 msgstr ""
25629
25630 #. type: textblock
25631 #: ../fish/guestfish-actions.pod:3673
25632 msgid ""
25633 "Unlike L</cat>, this function can correctly handle files that contain "
25634 "embedded ASCII NUL characters.  However unlike L</download>, this function "
25635 "is limited in the total size of file that can be handled."
25636 msgstr ""
25637
25638 #. type: =head2
25639 #: ../fish/guestfish-actions.pod:3681
25640 msgid "read-lines"
25641 msgstr ""
25642
25643 #. type: verbatim
25644 #: ../fish/guestfish-actions.pod:3683
25645 #, no-wrap
25646 msgid ""
25647 " read-lines path\n"
25648 "\n"
25649 msgstr ""
25650
25651 #. type: textblock
25652 #: ../fish/guestfish-actions.pod:3690
25653 msgid ""
25654 "Note that this function cannot correctly handle binary files (specifically, "
25655 "files containing C<\\0> character which is treated as end of line).  For "
25656 "those you need to use the L</read-file> function which has a more complex "
25657 "interface."
25658 msgstr ""
25659
25660 #. type: =head2
25661 #: ../fish/guestfish-actions.pod:3695
25662 msgid "readdir"
25663 msgstr ""
25664
25665 #. type: verbatim
25666 #: ../fish/guestfish-actions.pod:3697
25667 #, no-wrap
25668 msgid ""
25669 " readdir dir\n"
25670 "\n"
25671 msgstr ""
25672
25673 #. type: textblock
25674 #: ../fish/guestfish-actions.pod:3749
25675 msgid ""
25676 "This function is primarily intended for use by programs.  To get a simple "
25677 "list of names, use L</ls>.  To get a printable directory for human "
25678 "consumption, use L</ll>."
25679 msgstr ""
25680
25681 #. type: =head2
25682 #: ../fish/guestfish-actions.pod:3753
25683 msgid "readlink"
25684 msgstr ""
25685
25686 #. type: verbatim
25687 #: ../fish/guestfish-actions.pod:3755
25688 #, no-wrap
25689 msgid ""
25690 " readlink path\n"
25691 "\n"
25692 msgstr ""
25693
25694 #. type: =head2
25695 #: ../fish/guestfish-actions.pod:3759
25696 msgid "readlinklist"
25697 msgstr ""
25698
25699 #. type: verbatim
25700 #: ../fish/guestfish-actions.pod:3761
25701 #, no-wrap
25702 msgid ""
25703 " readlinklist path 'names ...'\n"
25704 "\n"
25705 msgstr ""
25706
25707 #. type: =head2
25708 #: ../fish/guestfish-actions.pod:3785
25709 msgid "realpath"
25710 msgstr ""
25711
25712 #. type: verbatim
25713 #: ../fish/guestfish-actions.pod:3787
25714 #, no-wrap
25715 msgid ""
25716 " realpath path\n"
25717 "\n"
25718 msgstr ""
25719
25720 #. type: =head2
25721 #: ../fish/guestfish-actions.pod:3792
25722 msgid "removexattr"
25723 msgstr ""
25724
25725 #. type: verbatim
25726 #: ../fish/guestfish-actions.pod:3794
25727 #, no-wrap
25728 msgid ""
25729 " removexattr xattr path\n"
25730 "\n"
25731 msgstr ""
25732
25733 #. type: textblock
25734 #: ../fish/guestfish-actions.pod:3799
25735 msgid "See also: L</lremovexattr>, L<attr(5)>."
25736 msgstr ""
25737
25738 #. type: =head2
25739 #: ../fish/guestfish-actions.pod:3801
25740 msgid "resize2fs"
25741 msgstr ""
25742
25743 #. type: verbatim
25744 #: ../fish/guestfish-actions.pod:3803
25745 #, no-wrap
25746 msgid ""
25747 " resize2fs device\n"
25748 "\n"
25749 msgstr ""
25750
25751 #. type: textblock
25752 #: ../fish/guestfish-actions.pod:3808
25753 msgid ""
25754 "I<Note:> It is sometimes required that you run L</e2fsck-f> on the C<device> "
25755 "before calling this command.  For unknown reasons C<resize2fs> sometimes "
25756 "gives an error about this and sometimes not.  In any case, it is always safe "
25757 "to call L</e2fsck-f> before calling this function."
25758 msgstr ""
25759
25760 #. type: =head2
25761 #: ../fish/guestfish-actions.pod:3814
25762 msgid "resize2fs-M"
25763 msgstr ""
25764
25765 #. type: verbatim
25766 #: ../fish/guestfish-actions.pod:3816
25767 #, no-wrap
25768 msgid ""
25769 " resize2fs-M device\n"
25770 "\n"
25771 msgstr ""
25772
25773 #. type: textblock
25774 #: ../fish/guestfish-actions.pod:3818
25775 msgid ""
25776 "This command is the same as L</resize2fs>, but the filesystem is resized to "
25777 "its minimum size.  This works like the I<-M> option to the C<resize2fs> "
25778 "command."
25779 msgstr ""
25780
25781 #. type: textblock
25782 #: ../fish/guestfish-actions.pod:3822
25783 msgid ""
25784 "To get the resulting size of the filesystem you should call L</tune2fs-l> "
25785 "and read the C<Block size> and C<Block count> values.  These two numbers, "
25786 "multiplied together, give the resulting size of the minimal filesystem in "
25787 "bytes."
25788 msgstr ""
25789
25790 #. type: =head2
25791 #: ../fish/guestfish-actions.pod:3827
25792 msgid "resize2fs-size"
25793 msgstr ""
25794
25795 #. type: verbatim
25796 #: ../fish/guestfish-actions.pod:3829
25797 #, no-wrap
25798 msgid ""
25799 " resize2fs-size device size\n"
25800 "\n"
25801 msgstr ""
25802
25803 #. type: textblock
25804 #: ../fish/guestfish-actions.pod:3831
25805 msgid ""
25806 "This command is the same as L</resize2fs> except that it allows you to "
25807 "specify the new size (in bytes) explicitly."
25808 msgstr ""
25809
25810 #. type: =head2
25811 #: ../fish/guestfish-actions.pod:3834
25812 msgid "rm"
25813 msgstr ""
25814
25815 #. type: verbatim
25816 #: ../fish/guestfish-actions.pod:3836
25817 #, no-wrap
25818 msgid ""
25819 " rm path\n"
25820 "\n"
25821 msgstr ""
25822
25823 #. type: =head2
25824 #: ../fish/guestfish-actions.pod:3840
25825 msgid "rm-rf"
25826 msgstr ""
25827
25828 #. type: verbatim
25829 #: ../fish/guestfish-actions.pod:3842
25830 #, no-wrap
25831 msgid ""
25832 " rm-rf path\n"
25833 "\n"
25834 msgstr ""
25835
25836 #. type: =head2
25837 #: ../fish/guestfish-actions.pod:3848
25838 msgid "rmdir"
25839 msgstr ""
25840
25841 #. type: verbatim
25842 #: ../fish/guestfish-actions.pod:3850
25843 #, no-wrap
25844 msgid ""
25845 " rmdir path\n"
25846 "\n"
25847 msgstr ""
25848
25849 #. type: =head2
25850 #: ../fish/guestfish-actions.pod:3854
25851 msgid "rmmountpoint"
25852 msgstr ""
25853
25854 #. type: verbatim
25855 #: ../fish/guestfish-actions.pod:3856
25856 #, no-wrap
25857 msgid ""
25858 " rmmountpoint exemptpath\n"
25859 "\n"
25860 msgstr ""
25861
25862 #. type: textblock
25863 #: ../fish/guestfish-actions.pod:3858
25864 msgid ""
25865 "This calls removes a mountpoint that was previously created with "
25866 "L</mkmountpoint>.  See L</mkmountpoint> for full details."
25867 msgstr ""
25868
25869 #. type: =head2
25870 #: ../fish/guestfish-actions.pod:3862
25871 msgid "scrub-device"
25872 msgstr ""
25873
25874 #. type: verbatim
25875 #: ../fish/guestfish-actions.pod:3864
25876 #, no-wrap
25877 msgid ""
25878 " scrub-device device\n"
25879 "\n"
25880 msgstr ""
25881
25882 #. type: =head2
25883 #: ../fish/guestfish-actions.pod:3875
25884 msgid "scrub-file"
25885 msgstr ""
25886
25887 #. type: verbatim
25888 #: ../fish/guestfish-actions.pod:3877
25889 #, no-wrap
25890 msgid ""
25891 " scrub-file file\n"
25892 "\n"
25893 msgstr ""
25894
25895 #. type: =head2
25896 #: ../fish/guestfish-actions.pod:3887
25897 msgid "scrub-freespace"
25898 msgstr ""
25899
25900 #. type: verbatim
25901 #: ../fish/guestfish-actions.pod:3889
25902 #, no-wrap
25903 msgid ""
25904 " scrub-freespace dir\n"
25905 "\n"
25906 msgstr ""
25907
25908 #. type: textblock
25909 #: ../fish/guestfish-actions.pod:3891
25910 msgid ""
25911 "This command creates the directory C<dir> and then fills it with files until "
25912 "the filesystem is full, and scrubs the files as for L</scrub-file>, and "
25913 "deletes them.  The intention is to scrub any free space on the partition "
25914 "containing C<dir>."
25915 msgstr ""
25916
25917 #. type: =head2
25918 #: ../fish/guestfish-actions.pod:3900
25919 msgid "set-append"
25920 msgstr ""
25921
25922 #. type: =head2
25923 #: ../fish/guestfish-actions.pod:3902
25924 msgid "append"
25925 msgstr ""
25926
25927 #. type: verbatim
25928 #: ../fish/guestfish-actions.pod:3904
25929 #, no-wrap
25930 msgid ""
25931 " set-append append\n"
25932 "\n"
25933 msgstr ""
25934
25935 #. type: =head2
25936 #: ../fish/guestfish-actions.pod:3915
25937 msgid "set-attach-method"
25938 msgstr ""
25939
25940 #. type: =head2
25941 #: ../fish/guestfish-actions.pod:3917
25942 msgid "attach-method"
25943 msgstr ""
25944
25945 #. type: verbatim
25946 #: ../fish/guestfish-actions.pod:3919
25947 #, no-wrap
25948 msgid ""
25949 " set-attach-method attachmethod\n"
25950 "\n"
25951 msgstr ""
25952
25953 #. type: =head2
25954 #: ../fish/guestfish-actions.pod:3941
25955 msgid "set-autosync"
25956 msgstr ""
25957
25958 #. type: =head2
25959 #: ../fish/guestfish-actions.pod:3943
25960 msgid "autosync"
25961 msgstr ""
25962
25963 #. type: verbatim
25964 #: ../fish/guestfish-actions.pod:3945
25965 #, no-wrap
25966 msgid ""
25967 " set-autosync true|false\n"
25968 "\n"
25969 msgstr ""
25970
25971 #. type: =head2
25972 #: ../fish/guestfish-actions.pod:3955
25973 msgid "set-direct"
25974 msgstr ""
25975
25976 #. type: =head2
25977 #: ../fish/guestfish-actions.pod:3957
25978 msgid "direct"
25979 msgstr ""
25980
25981 #. type: verbatim
25982 #: ../fish/guestfish-actions.pod:3959
25983 #, no-wrap
25984 msgid ""
25985 " set-direct true|false\n"
25986 "\n"
25987 msgstr ""
25988
25989 #. type: textblock
25990 #: ../fish/guestfish-actions.pod:3965
25991 msgid ""
25992 "One consequence of this is that log messages aren't caught by the library "
25993 "and handled by L</set-log-message-callback>, but go straight to stdout."
25994 msgstr ""
25995
25996 #. type: =head2
25997 #: ../fish/guestfish-actions.pod:3974
25998 msgid "set-e2label"
25999 msgstr ""
26000
26001 #. type: verbatim
26002 #: ../fish/guestfish-actions.pod:3976
26003 #, no-wrap
26004 msgid ""
26005 " set-e2label device label\n"
26006 "\n"
26007 msgstr ""
26008
26009 #. type: textblock
26010 #: ../fish/guestfish-actions.pod:3982
26011 msgid ""
26012 "You can use either L</tune2fs-l> or L</get-e2label> to return the existing "
26013 "label on a filesystem."
26014 msgstr ""
26015
26016 #. type: =head2
26017 #: ../fish/guestfish-actions.pod:3985
26018 msgid "set-e2uuid"
26019 msgstr ""
26020
26021 #. type: verbatim
26022 #: ../fish/guestfish-actions.pod:3987
26023 #, no-wrap
26024 msgid ""
26025 " set-e2uuid device uuid\n"
26026 "\n"
26027 msgstr ""
26028
26029 #. type: textblock
26030 #: ../fish/guestfish-actions.pod:3994
26031 msgid ""
26032 "You can use either L</tune2fs-l> or L</get-e2uuid> to return the existing "
26033 "UUID of a filesystem."
26034 msgstr ""
26035
26036 #. type: =head2
26037 #: ../fish/guestfish-actions.pod:3997
26038 msgid "set-memsize"
26039 msgstr ""
26040
26041 #. type: =head2
26042 #: ../fish/guestfish-actions.pod:3999
26043 msgid "memsize"
26044 msgstr ""
26045
26046 #. type: verbatim
26047 #: ../fish/guestfish-actions.pod:4001
26048 #, no-wrap
26049 msgid ""
26050 " set-memsize memsize\n"
26051 "\n"
26052 msgstr ""
26053
26054 #. type: textblock
26055 #: ../fish/guestfish-actions.pod:4003
26056 msgid ""
26057 "This sets the memory size in megabytes allocated to the qemu subprocess.  "
26058 "This only has any effect if called before L</launch>."
26059 msgstr ""
26060
26061 #. type: =head2
26062 #: ../fish/guestfish-actions.pod:4014
26063 msgid "set-network"
26064 msgstr ""
26065
26066 #. type: =head2
26067 #: ../fish/guestfish-actions.pod:4016
26068 msgid "network"
26069 msgstr ""
26070
26071 #. type: verbatim
26072 #: ../fish/guestfish-actions.pod:4018
26073 #, no-wrap
26074 msgid ""
26075 " set-network true|false\n"
26076 "\n"
26077 msgstr ""
26078
26079 #. type: textblock
26080 #: ../fish/guestfish-actions.pod:4026
26081 msgid "You must call this before calling L</launch>, otherwise it has no effect."
26082 msgstr ""
26083
26084 #. type: =head2
26085 #: ../fish/guestfish-actions.pod:4029
26086 msgid "set-path"
26087 msgstr ""
26088
26089 #. type: =head2
26090 #: ../fish/guestfish-actions.pod:4031
26091 msgid "path"
26092 msgstr ""
26093
26094 #. type: verbatim
26095 #: ../fish/guestfish-actions.pod:4033
26096 #, no-wrap
26097 msgid ""
26098 " set-path searchpath\n"
26099 "\n"
26100 msgstr ""
26101
26102 #. type: =head2
26103 #: ../fish/guestfish-actions.pod:4042
26104 msgid "set-qemu"
26105 msgstr ""
26106
26107 #. type: =head2
26108 #: ../fish/guestfish-actions.pod:4044
26109 msgid "qemu"
26110 msgstr ""
26111
26112 #. type: verbatim
26113 #: ../fish/guestfish-actions.pod:4046
26114 #, no-wrap
26115 msgid ""
26116 " set-qemu qemu\n"
26117 "\n"
26118 msgstr ""
26119
26120 #. type: =head2
26121 #: ../fish/guestfish-actions.pod:4066
26122 msgid "set-recovery-proc"
26123 msgstr ""
26124
26125 #. type: =head2
26126 #: ../fish/guestfish-actions.pod:4068
26127 msgid "recovery-proc"
26128 msgstr ""
26129
26130 #. type: verbatim
26131 #: ../fish/guestfish-actions.pod:4070
26132 #, no-wrap
26133 msgid ""
26134 " set-recovery-proc true|false\n"
26135 "\n"
26136 msgstr ""
26137
26138 #. type: textblock
26139 #: ../fish/guestfish-actions.pod:4072
26140 msgid ""
26141 "If this is called with the parameter C<false> then L</launch> does not "
26142 "create a recovery process.  The purpose of the recovery process is to stop "
26143 "runaway qemu processes in the case where the main program aborts abruptly."
26144 msgstr ""
26145
26146 #. type: textblock
26147 #: ../fish/guestfish-actions.pod:4077
26148 msgid ""
26149 "This only has any effect if called before L</launch>, and the default is "
26150 "true."
26151 msgstr ""
26152
26153 #. type: =head2
26154 #: ../fish/guestfish-actions.pod:4086
26155 msgid "set-selinux"
26156 msgstr ""
26157
26158 #. type: =head2
26159 #: ../fish/guestfish-actions.pod:4088
26160 msgid "selinux"
26161 msgstr ""
26162
26163 #. type: verbatim
26164 #: ../fish/guestfish-actions.pod:4090
26165 #, no-wrap
26166 msgid ""
26167 " set-selinux true|false\n"
26168 "\n"
26169 msgstr ""
26170
26171 #. type: =head2
26172 #: ../fish/guestfish-actions.pod:4101
26173 msgid "set-trace"
26174 msgstr ""
26175
26176 #. type: =head2
26177 #: ../fish/guestfish-actions.pod:4103
26178 msgid "trace"
26179 msgstr ""
26180
26181 #. type: verbatim
26182 #: ../fish/guestfish-actions.pod:4105
26183 #, no-wrap
26184 msgid ""
26185 " set-trace true|false\n"
26186 "\n"
26187 msgstr ""
26188
26189 #. type: textblock
26190 #: ../fish/guestfish-actions.pod:4117
26191 msgid ""
26192 "Trace messages are normally sent to C<stderr>, unless you register a "
26193 "callback to send them somewhere else (see L</set-event-callback>)."
26194 msgstr ""
26195
26196 #. type: =head2
26197 #: ../fish/guestfish-actions.pod:4121
26198 msgid "set-verbose"
26199 msgstr ""
26200
26201 #. type: =head2
26202 #: ../fish/guestfish-actions.pod:4123
26203 msgid "verbose"
26204 msgstr ""
26205
26206 #. type: verbatim
26207 #: ../fish/guestfish-actions.pod:4125
26208 #, no-wrap
26209 msgid ""
26210 " set-verbose true|false\n"
26211 "\n"
26212 msgstr ""
26213
26214 #. type: textblock
26215 #: ../fish/guestfish-actions.pod:4132
26216 msgid ""
26217 "Verbose messages are normally sent to C<stderr>, unless you register a "
26218 "callback to send them somewhere else (see L</set-event-callback>)."
26219 msgstr ""
26220
26221 #. type: =head2
26222 #: ../fish/guestfish-actions.pod:4136
26223 msgid "setcon"
26224 msgstr ""
26225
26226 #. type: verbatim
26227 #: ../fish/guestfish-actions.pod:4138
26228 #, no-wrap
26229 msgid ""
26230 " setcon context\n"
26231 "\n"
26232 msgstr ""
26233
26234 #. type: =head2
26235 #: ../fish/guestfish-actions.pod:4145
26236 msgid "setxattr"
26237 msgstr ""
26238
26239 #. type: verbatim
26240 #: ../fish/guestfish-actions.pod:4147
26241 #, no-wrap
26242 msgid ""
26243 " setxattr xattr val vallen path\n"
26244 "\n"
26245 msgstr ""
26246
26247 #. type: textblock
26248 #: ../fish/guestfish-actions.pod:4153
26249 msgid "See also: L</lsetxattr>, L<attr(5)>."
26250 msgstr ""
26251
26252 #. type: =head2
26253 #: ../fish/guestfish-actions.pod:4155
26254 msgid "sfdisk"
26255 msgstr ""
26256
26257 #. type: verbatim
26258 #: ../fish/guestfish-actions.pod:4157
26259 #, no-wrap
26260 msgid ""
26261 " sfdisk device cyls heads sectors 'lines ...'\n"
26262 "\n"
26263 msgstr ""
26264
26265 #. type: textblock
26266 #: ../fish/guestfish-actions.pod:4179
26267 msgid "See also: L</sfdisk-l>, L</sfdisk-N>, L</part-init>"
26268 msgstr ""
26269
26270 #. type: textblock
26271 #: ../fish/guestfish-actions.pod:4185 ../fish/guestfish-actions.pod:4208 ../fish/guestfish-actions.pod:4230
26272 msgid ""
26273 "This function is deprecated.  In new code, use the L</part_add> call "
26274 "instead."
26275 msgstr ""
26276
26277 #. type: =head2
26278 #: ../fish/guestfish-actions.pod:4192
26279 msgid "sfdiskM"
26280 msgstr ""
26281
26282 #. type: verbatim
26283 #: ../fish/guestfish-actions.pod:4194
26284 #, no-wrap
26285 msgid ""
26286 " sfdiskM device 'lines ...'\n"
26287 "\n"
26288 msgstr ""
26289
26290 #. type: textblock
26291 #: ../fish/guestfish-actions.pod:4196
26292 msgid ""
26293 "This is a simplified interface to the L</sfdisk> command, where partition "
26294 "sizes are specified in megabytes only (rounded to the nearest cylinder) and "
26295 "you don't need to specify the cyls, heads and sectors parameters which were "
26296 "rarely if ever used anyway."
26297 msgstr ""
26298
26299 #. type: textblock
26300 #: ../fish/guestfish-actions.pod:4202
26301 msgid "See also: L</sfdisk>, the L<sfdisk(8)> manpage and L</part-disk>"
26302 msgstr ""
26303
26304 #. type: =head2
26305 #: ../fish/guestfish-actions.pod:4215
26306 msgid "sfdisk-N"
26307 msgstr ""
26308
26309 #. type: verbatim
26310 #: ../fish/guestfish-actions.pod:4217
26311 #, no-wrap
26312 msgid ""
26313 " sfdisk-N device partnum cyls heads sectors line\n"
26314 "\n"
26315 msgstr ""
26316
26317 #. type: textblock
26318 #: ../fish/guestfish-actions.pod:4222
26319 msgid ""
26320 "For other parameters, see L</sfdisk>.  You should usually pass C<0> for the "
26321 "cyls/heads/sectors parameters."
26322 msgstr ""
26323
26324 #. type: textblock
26325 #: ../fish/guestfish-actions.pod:4225
26326 msgid "See also: L</part-add>"
26327 msgstr ""
26328
26329 #. type: =head2
26330 #: ../fish/guestfish-actions.pod:4237
26331 msgid "sfdisk-disk-geometry"
26332 msgstr ""
26333
26334 #. type: verbatim
26335 #: ../fish/guestfish-actions.pod:4239
26336 #, no-wrap
26337 msgid ""
26338 " sfdisk-disk-geometry device\n"
26339 "\n"
26340 msgstr ""
26341
26342 #. type: textblock
26343 #: ../fish/guestfish-actions.pod:4241
26344 msgid ""
26345 "This displays the disk geometry of C<device> read from the partition table.  "
26346 "Especially in the case where the underlying block device has been resized, "
26347 "this can be different from the kernel's idea of the geometry (see "
26348 "L</sfdisk-kernel-geometry>)."
26349 msgstr ""
26350
26351 #. type: =head2
26352 #: ../fish/guestfish-actions.pod:4249
26353 msgid "sfdisk-kernel-geometry"
26354 msgstr ""
26355
26356 #. type: verbatim
26357 #: ../fish/guestfish-actions.pod:4251
26358 #, no-wrap
26359 msgid ""
26360 " sfdisk-kernel-geometry device\n"
26361 "\n"
26362 msgstr ""
26363
26364 #. type: =head2
26365 #: ../fish/guestfish-actions.pod:4258
26366 msgid "sfdisk-l"
26367 msgstr ""
26368
26369 #. type: verbatim
26370 #: ../fish/guestfish-actions.pod:4260
26371 #, no-wrap
26372 msgid ""
26373 " sfdisk-l device\n"
26374 "\n"
26375 msgstr ""
26376
26377 #. type: textblock
26378 #: ../fish/guestfish-actions.pod:4266
26379 msgid "See also: L</part-list>"
26380 msgstr ""
26381
26382 #. type: textblock
26383 #: ../fish/guestfish-actions.pod:4268
26384 msgid ""
26385 "This function is deprecated.  In new code, use the L</part_list> call "
26386 "instead."
26387 msgstr ""
26388
26389 #. type: =head2
26390 #: ../fish/guestfish-actions.pod:4275
26391 msgid "sh"
26392 msgstr ""
26393
26394 #. type: verbatim
26395 #: ../fish/guestfish-actions.pod:4277
26396 #, no-wrap
26397 msgid ""
26398 " sh command\n"
26399 "\n"
26400 msgstr ""
26401
26402 #. type: textblock
26403 #: ../fish/guestfish-actions.pod:4282
26404 msgid "This is like L</command>, but passes the command to:"
26405 msgstr ""
26406
26407 #. type: textblock
26408 #: ../fish/guestfish-actions.pod:4290
26409 msgid "All the provisos about L</command> apply to this call."
26410 msgstr ""
26411
26412 #. type: =head2
26413 #: ../fish/guestfish-actions.pod:4292
26414 msgid "sh-lines"
26415 msgstr ""
26416
26417 #. type: verbatim
26418 #: ../fish/guestfish-actions.pod:4294
26419 #, no-wrap
26420 msgid ""
26421 " sh-lines command\n"
26422 "\n"
26423 msgstr ""
26424
26425 #. type: textblock
26426 #: ../fish/guestfish-actions.pod:4296
26427 msgid "This is the same as L</sh>, but splits the result into a list of lines."
26428 msgstr ""
26429
26430 #. type: textblock
26431 #: ../fish/guestfish-actions.pod:4299
26432 msgid "See also: L</command-lines>"
26433 msgstr ""
26434
26435 #. type: =head2
26436 #: ../fish/guestfish-actions.pod:4301
26437 msgid "sleep"
26438 msgstr ""
26439
26440 #. type: verbatim
26441 #: ../fish/guestfish-actions.pod:4303
26442 #, no-wrap
26443 msgid ""
26444 " sleep secs\n"
26445 "\n"
26446 msgstr ""
26447
26448 #. type: =head2
26449 #: ../fish/guestfish-actions.pod:4307
26450 msgid "stat"
26451 msgstr ""
26452
26453 #. type: verbatim
26454 #: ../fish/guestfish-actions.pod:4309
26455 #, no-wrap
26456 msgid ""
26457 " stat path\n"
26458 "\n"
26459 msgstr ""
26460
26461 #. type: =head2
26462 #: ../fish/guestfish-actions.pod:4315
26463 msgid "statvfs"
26464 msgstr ""
26465
26466 #. type: verbatim
26467 #: ../fish/guestfish-actions.pod:4317
26468 #, no-wrap
26469 msgid ""
26470 " statvfs path\n"
26471 "\n"
26472 msgstr ""
26473
26474 #. type: =head2
26475 #: ../fish/guestfish-actions.pod:4325
26476 msgid "strings"
26477 msgstr ""
26478
26479 #. type: verbatim
26480 #: ../fish/guestfish-actions.pod:4327
26481 #, no-wrap
26482 msgid ""
26483 " strings path\n"
26484 "\n"
26485 msgstr ""
26486
26487 #. type: =head2
26488 #: ../fish/guestfish-actions.pod:4335
26489 msgid "strings-e"
26490 msgstr ""
26491
26492 #. type: verbatim
26493 #: ../fish/guestfish-actions.pod:4337
26494 #, no-wrap
26495 msgid ""
26496 " strings-e encoding path\n"
26497 "\n"
26498 msgstr ""
26499
26500 #. type: textblock
26501 #: ../fish/guestfish-actions.pod:4339
26502 msgid ""
26503 "This is like the L</strings> command, but allows you to specify the encoding "
26504 "of strings that are looked for in the source file C<path>."
26505 msgstr ""
26506
26507 #. type: textblock
26508 #: ../fish/guestfish-actions.pod:4349
26509 msgid ""
26510 "Single 7-bit-byte characters like ASCII and the ASCII-compatible parts of "
26511 "ISO-8859-X (this is what L</strings> uses)."
26512 msgstr ""
26513
26514 #. type: =head2
26515 #: ../fish/guestfish-actions.pod:4381
26516 msgid "swapoff-device"
26517 msgstr ""
26518
26519 #. type: verbatim
26520 #: ../fish/guestfish-actions.pod:4383
26521 #, no-wrap
26522 msgid ""
26523 " swapoff-device device\n"
26524 "\n"
26525 msgstr ""
26526
26527 #. type: textblock
26528 #: ../fish/guestfish-actions.pod:4385
26529 msgid ""
26530 "This command disables the libguestfs appliance swap device or partition "
26531 "named C<device>.  See L</swapon-device>."
26532 msgstr ""
26533
26534 #. type: =head2
26535 #: ../fish/guestfish-actions.pod:4389
26536 msgid "swapoff-file"
26537 msgstr ""
26538
26539 #. type: verbatim
26540 #: ../fish/guestfish-actions.pod:4391
26541 #, no-wrap
26542 msgid ""
26543 " swapoff-file file\n"
26544 "\n"
26545 msgstr ""
26546
26547 #. type: =head2
26548 #: ../fish/guestfish-actions.pod:4395
26549 msgid "swapoff-label"
26550 msgstr ""
26551
26552 #. type: verbatim
26553 #: ../fish/guestfish-actions.pod:4397
26554 #, no-wrap
26555 msgid ""
26556 " swapoff-label label\n"
26557 "\n"
26558 msgstr ""
26559
26560 #. type: =head2
26561 #: ../fish/guestfish-actions.pod:4402
26562 msgid "swapoff-uuid"
26563 msgstr ""
26564
26565 #. type: verbatim
26566 #: ../fish/guestfish-actions.pod:4404
26567 #, no-wrap
26568 msgid ""
26569 " swapoff-uuid uuid\n"
26570 "\n"
26571 msgstr ""
26572
26573 #. type: =head2
26574 #: ../fish/guestfish-actions.pod:4409
26575 msgid "swapon-device"
26576 msgstr ""
26577
26578 #. type: verbatim
26579 #: ../fish/guestfish-actions.pod:4411
26580 #, no-wrap
26581 msgid ""
26582 " swapon-device device\n"
26583 "\n"
26584 msgstr ""
26585
26586 #. type: textblock
26587 #: ../fish/guestfish-actions.pod:4413
26588 msgid ""
26589 "This command enables the libguestfs appliance to use the swap device or "
26590 "partition named C<device>.  The increased memory is made available for all "
26591 "commands, for example those run using L</command> or L</sh>."
26592 msgstr ""
26593
26594 #. type: =head2
26595 #: ../fish/guestfish-actions.pod:4425
26596 msgid "swapon-file"
26597 msgstr ""
26598
26599 #. type: verbatim
26600 #: ../fish/guestfish-actions.pod:4427
26601 #, no-wrap
26602 msgid ""
26603 " swapon-file file\n"
26604 "\n"
26605 msgstr ""
26606
26607 #. type: textblock
26608 #: ../fish/guestfish-actions.pod:4429
26609 msgid "This command enables swap to a file.  See L</swapon-device> for other notes."
26610 msgstr ""
26611
26612 #. type: =head2
26613 #: ../fish/guestfish-actions.pod:4432
26614 msgid "swapon-label"
26615 msgstr ""
26616
26617 #. type: verbatim
26618 #: ../fish/guestfish-actions.pod:4434
26619 #, no-wrap
26620 msgid ""
26621 " swapon-label label\n"
26622 "\n"
26623 msgstr ""
26624
26625 #. type: textblock
26626 #: ../fish/guestfish-actions.pod:4436
26627 msgid ""
26628 "This command enables swap to a labeled swap partition.  See "
26629 "L</swapon-device> for other notes."
26630 msgstr ""
26631
26632 #. type: =head2
26633 #: ../fish/guestfish-actions.pod:4439
26634 msgid "swapon-uuid"
26635 msgstr ""
26636
26637 #. type: verbatim
26638 #: ../fish/guestfish-actions.pod:4441
26639 #, no-wrap
26640 msgid ""
26641 " swapon-uuid uuid\n"
26642 "\n"
26643 msgstr ""
26644
26645 #. type: textblock
26646 #: ../fish/guestfish-actions.pod:4443
26647 msgid ""
26648 "This command enables swap to a swap partition with the given UUID.  See "
26649 "L</swapon-device> for other notes."
26650 msgstr ""
26651
26652 #. type: =head2
26653 #: ../fish/guestfish-actions.pod:4446
26654 msgid "sync"
26655 msgstr ""
26656
26657 #. type: verbatim
26658 #: ../fish/guestfish-actions.pod:4448
26659 #, no-wrap
26660 msgid ""
26661 " sync\n"
26662 "\n"
26663 msgstr ""
26664
26665 #. type: =head2
26666 #: ../fish/guestfish-actions.pod:4456
26667 msgid "tail"
26668 msgstr ""
26669
26670 #. type: verbatim
26671 #: ../fish/guestfish-actions.pod:4458
26672 #, no-wrap
26673 msgid ""
26674 " tail path\n"
26675 "\n"
26676 msgstr ""
26677
26678 #. type: =head2
26679 #: ../fish/guestfish-actions.pod:4466
26680 msgid "tail-n"
26681 msgstr ""
26682
26683 #. type: verbatim
26684 #: ../fish/guestfish-actions.pod:4468
26685 #, no-wrap
26686 msgid ""
26687 " tail-n nrlines path\n"
26688 "\n"
26689 msgstr ""
26690
26691 #. type: =head2
26692 #: ../fish/guestfish-actions.pod:4481
26693 msgid "tar-in"
26694 msgstr ""
26695
26696 #. type: verbatim
26697 #: ../fish/guestfish-actions.pod:4483
26698 #, no-wrap
26699 msgid ""
26700 " tar-in (tarfile|-) directory\n"
26701 "\n"
26702 msgstr ""
26703
26704 #. type: textblock
26705 #: ../fish/guestfish-actions.pod:4488
26706 msgid "To upload a compressed tarball, use L</tgz-in> or L</txz-in>."
26707 msgstr ""
26708
26709 #. type: =head2
26710 #: ../fish/guestfish-actions.pod:4493
26711 msgid "tar-out"
26712 msgstr ""
26713
26714 #. type: verbatim
26715 #: ../fish/guestfish-actions.pod:4495
26716 #, no-wrap
26717 msgid ""
26718 " tar-out directory (tarfile|-)\n"
26719 "\n"
26720 msgstr ""
26721
26722 #. type: textblock
26723 #: ../fish/guestfish-actions.pod:4500
26724 msgid "To download a compressed tarball, use L</tgz-out> or L</txz-out>."
26725 msgstr ""
26726
26727 #. type: =head2
26728 #: ../fish/guestfish-actions.pod:4505
26729 msgid "tgz-in"
26730 msgstr ""
26731
26732 #. type: verbatim
26733 #: ../fish/guestfish-actions.pod:4507
26734 #, no-wrap
26735 msgid ""
26736 " tgz-in (tarball|-) directory\n"
26737 "\n"
26738 msgstr ""
26739
26740 #. type: textblock
26741 #: ../fish/guestfish-actions.pod:4512
26742 msgid "To upload an uncompressed tarball, use L</tar-in>."
26743 msgstr ""
26744
26745 #. type: =head2
26746 #: ../fish/guestfish-actions.pod:4516
26747 msgid "tgz-out"
26748 msgstr ""
26749
26750 #. type: verbatim
26751 #: ../fish/guestfish-actions.pod:4518
26752 #, no-wrap
26753 msgid ""
26754 " tgz-out directory (tarball|-)\n"
26755 "\n"
26756 msgstr ""
26757
26758 #. type: textblock
26759 #: ../fish/guestfish-actions.pod:4523
26760 msgid "To download an uncompressed tarball, use L</tar-out>."
26761 msgstr ""
26762
26763 #. type: =head2
26764 #: ../fish/guestfish-actions.pod:4527
26765 msgid "touch"
26766 msgstr ""
26767
26768 #. type: verbatim
26769 #: ../fish/guestfish-actions.pod:4529
26770 #, no-wrap
26771 msgid ""
26772 " touch path\n"
26773 "\n"
26774 msgstr ""
26775
26776 #. type: =head2
26777 #: ../fish/guestfish-actions.pod:4538
26778 msgid "truncate"
26779 msgstr ""
26780
26781 #. type: verbatim
26782 #: ../fish/guestfish-actions.pod:4540
26783 #, no-wrap
26784 msgid ""
26785 " truncate path\n"
26786 "\n"
26787 msgstr ""
26788
26789 #. type: =head2
26790 #: ../fish/guestfish-actions.pod:4545
26791 msgid "truncate-size"
26792 msgstr ""
26793
26794 #. type: verbatim
26795 #: ../fish/guestfish-actions.pod:4547
26796 #, no-wrap
26797 msgid ""
26798 " truncate-size path size\n"
26799 "\n"
26800 msgstr ""
26801
26802 #. type: textblock
26803 #: ../fish/guestfish-actions.pod:4552
26804 msgid ""
26805 "If the current file size is less than C<size> then the file is extended to "
26806 "the required size with zero bytes.  This creates a sparse file (ie. disk "
26807 "blocks are not allocated for the file until you write to it).  To create a "
26808 "non-sparse file of zeroes, use L</fallocate64> instead."
26809 msgstr ""
26810
26811 #. type: =head2
26812 #: ../fish/guestfish-actions.pod:4558
26813 msgid "tune2fs-l"
26814 msgstr ""
26815
26816 #. type: verbatim
26817 #: ../fish/guestfish-actions.pod:4560
26818 #, no-wrap
26819 msgid ""
26820 " tune2fs-l device\n"
26821 "\n"
26822 msgstr ""
26823
26824 #. type: =head2
26825 #: ../fish/guestfish-actions.pod:4570
26826 msgid "txz-in"
26827 msgstr ""
26828
26829 #. type: verbatim
26830 #: ../fish/guestfish-actions.pod:4572
26831 #, no-wrap
26832 msgid ""
26833 " txz-in (tarball|-) directory\n"
26834 "\n"
26835 msgstr ""
26836
26837 #. type: =head2
26838 #: ../fish/guestfish-actions.pod:4579
26839 msgid "txz-out"
26840 msgstr ""
26841
26842 #. type: verbatim
26843 #: ../fish/guestfish-actions.pod:4581
26844 #, no-wrap
26845 msgid ""
26846 " txz-out directory (tarball|-)\n"
26847 "\n"
26848 msgstr ""
26849
26850 #. type: =head2
26851 #: ../fish/guestfish-actions.pod:4588
26852 msgid "umask"
26853 msgstr ""
26854
26855 #. type: verbatim
26856 #: ../fish/guestfish-actions.pod:4590
26857 #, no-wrap
26858 msgid ""
26859 " umask mask\n"
26860 "\n"
26861 msgstr ""
26862
26863 #. type: textblock
26864 #: ../fish/guestfish-actions.pod:4604
26865 msgid "See also L</get-umask>, L<umask(2)>, L</mknod>, L</mkdir>."
26866 msgstr ""
26867
26868 #. type: =head2
26869 #: ../fish/guestfish-actions.pod:4609
26870 msgid "umount"
26871 msgstr ""
26872
26873 #. type: =head2
26874 #: ../fish/guestfish-actions.pod:4611
26875 msgid "unmount"
26876 msgstr ""
26877
26878 #. type: verbatim
26879 #: ../fish/guestfish-actions.pod:4613
26880 #, no-wrap
26881 msgid ""
26882 " umount pathordevice\n"
26883 "\n"
26884 msgstr ""
26885
26886 #. type: =head2
26887 #: ../fish/guestfish-actions.pod:4619
26888 msgid "umount-all"
26889 msgstr ""
26890
26891 #. type: =head2
26892 #: ../fish/guestfish-actions.pod:4621
26893 msgid "unmount-all"
26894 msgstr ""
26895
26896 #. type: verbatim
26897 #: ../fish/guestfish-actions.pod:4623
26898 #, no-wrap
26899 msgid ""
26900 " umount-all\n"
26901 "\n"
26902 msgstr ""
26903
26904 #. type: =head2
26905 #: ../fish/guestfish-actions.pod:4629
26906 msgid "upload"
26907 msgstr ""
26908
26909 #. type: verbatim
26910 #: ../fish/guestfish-actions.pod:4631
26911 #, no-wrap
26912 msgid ""
26913 " upload (filename|-) remotefilename\n"
26914 "\n"
26915 msgstr ""
26916
26917 #. type: textblock
26918 #: ../fish/guestfish-actions.pod:4638
26919 msgid "See also L</download>."
26920 msgstr ""
26921
26922 #. type: =head2
26923 #: ../fish/guestfish-actions.pod:4642
26924 msgid "upload-offset"
26925 msgstr ""
26926
26927 #. type: verbatim
26928 #: ../fish/guestfish-actions.pod:4644
26929 #, no-wrap
26930 msgid ""
26931 " upload-offset (filename|-) remotefilename offset\n"
26932 "\n"
26933 msgstr ""
26934
26935 #. type: textblock
26936 #: ../fish/guestfish-actions.pod:4656
26937 msgid ""
26938 "Note that there is no limit on the amount of data that can be uploaded with "
26939 "this call, unlike with L</pwrite>, and this call always writes the full "
26940 "amount unless an error occurs."
26941 msgstr ""
26942
26943 #. type: textblock
26944 #: ../fish/guestfish-actions.pod:4661
26945 msgid "See also L</upload>, L</pwrite>."
26946 msgstr ""
26947
26948 #. type: =head2
26949 #: ../fish/guestfish-actions.pod:4665
26950 msgid "utimens"
26951 msgstr ""
26952
26953 #. type: verbatim
26954 #: ../fish/guestfish-actions.pod:4667
26955 #, no-wrap
26956 msgid ""
26957 " utimens path atsecs atnsecs mtsecs mtnsecs\n"
26958 "\n"
26959 msgstr ""
26960
26961 #. type: =head2
26962 #: ../fish/guestfish-actions.pod:4686
26963 msgid "version"
26964 msgstr ""
26965
26966 #. type: verbatim
26967 #: ../fish/guestfish-actions.pod:4688
26968 #, no-wrap
26969 msgid ""
26970 " version\n"
26971 "\n"
26972 msgstr ""
26973
26974 #. type: textblock
26975 #: ../fish/guestfish-actions.pod:4715
26976 msgid ""
26977 "I<Note:> Don't use this call to test for availability of features.  In "
26978 "enterprise distributions we backport features from later versions into "
26979 "earlier versions, making this an unreliable way to test for features.  Use "
26980 "L</available> instead."
26981 msgstr ""
26982
26983 #. type: =head2
26984 #: ../fish/guestfish-actions.pod:4721
26985 msgid "vfs-label"
26986 msgstr ""
26987
26988 #. type: verbatim
26989 #: ../fish/guestfish-actions.pod:4723
26990 #, no-wrap
26991 msgid ""
26992 " vfs-label device\n"
26993 "\n"
26994 msgstr ""
26995
26996 #. type: textblock
26997 #: ../fish/guestfish-actions.pod:4730
26998 msgid "To find a filesystem from the label, use L</findfs-label>."
26999 msgstr ""
27000
27001 #. type: =head2
27002 #: ../fish/guestfish-actions.pod:4732
27003 msgid "vfs-type"
27004 msgstr ""
27005
27006 #. type: verbatim
27007 #: ../fish/guestfish-actions.pod:4734
27008 #, no-wrap
27009 msgid ""
27010 " vfs-type device\n"
27011 "\n"
27012 msgstr ""
27013
27014 #. type: =head2
27015 #: ../fish/guestfish-actions.pod:4744
27016 msgid "vfs-uuid"
27017 msgstr ""
27018
27019 #. type: verbatim
27020 #: ../fish/guestfish-actions.pod:4746
27021 #, no-wrap
27022 msgid ""
27023 " vfs-uuid device\n"
27024 "\n"
27025 msgstr ""
27026
27027 #. type: textblock
27028 #: ../fish/guestfish-actions.pod:4753
27029 msgid "To find a filesystem from the UUID, use L</findfs-uuid>."
27030 msgstr ""
27031
27032 #. type: =head2
27033 #: ../fish/guestfish-actions.pod:4755
27034 msgid "vg-activate"
27035 msgstr ""
27036
27037 #. type: verbatim
27038 #: ../fish/guestfish-actions.pod:4757
27039 #, no-wrap
27040 msgid ""
27041 " vg-activate true|false 'volgroups ...'\n"
27042 "\n"
27043 msgstr ""
27044
27045 #. type: =head2
27046 #: ../fish/guestfish-actions.pod:4770
27047 msgid "vg-activate-all"
27048 msgstr ""
27049
27050 #. type: verbatim
27051 #: ../fish/guestfish-actions.pod:4772
27052 #, no-wrap
27053 msgid ""
27054 " vg-activate-all true|false\n"
27055 "\n"
27056 msgstr ""
27057
27058 #. type: =head2
27059 #: ../fish/guestfish-actions.pod:4782
27060 msgid "vgcreate"
27061 msgstr ""
27062
27063 #. type: verbatim
27064 #: ../fish/guestfish-actions.pod:4784
27065 #, no-wrap
27066 msgid ""
27067 " vgcreate volgroup 'physvols ...'\n"
27068 "\n"
27069 msgstr ""
27070
27071 #. type: =head2
27072 #: ../fish/guestfish-actions.pod:4789
27073 msgid "vglvuuids"
27074 msgstr ""
27075
27076 #. type: verbatim
27077 #: ../fish/guestfish-actions.pod:4791
27078 #, no-wrap
27079 msgid ""
27080 " vglvuuids vgname\n"
27081 "\n"
27082 msgstr ""
27083
27084 #. type: textblock
27085 #: ../fish/guestfish-actions.pod:4796
27086 msgid ""
27087 "You can use this along with L</lvs> and L</lvuuid> calls to associate "
27088 "logical volumes and volume groups."
27089 msgstr ""
27090
27091 #. type: textblock
27092 #: ../fish/guestfish-actions.pod:4799
27093 msgid "See also L</vgpvuuids>."
27094 msgstr ""
27095
27096 #. type: =head2
27097 #: ../fish/guestfish-actions.pod:4801
27098 msgid "vgpvuuids"
27099 msgstr ""
27100
27101 #. type: verbatim
27102 #: ../fish/guestfish-actions.pod:4803
27103 #, no-wrap
27104 msgid ""
27105 " vgpvuuids vgname\n"
27106 "\n"
27107 msgstr ""
27108
27109 #. type: textblock
27110 #: ../fish/guestfish-actions.pod:4808
27111 msgid ""
27112 "You can use this along with L</pvs> and L</pvuuid> calls to associate "
27113 "physical volumes and volume groups."
27114 msgstr ""
27115
27116 #. type: textblock
27117 #: ../fish/guestfish-actions.pod:4811
27118 msgid "See also L</vglvuuids>."
27119 msgstr ""
27120
27121 #. type: =head2
27122 #: ../fish/guestfish-actions.pod:4813
27123 msgid "vgremove"
27124 msgstr ""
27125
27126 #. type: verbatim
27127 #: ../fish/guestfish-actions.pod:4815
27128 #, no-wrap
27129 msgid ""
27130 " vgremove vgname\n"
27131 "\n"
27132 msgstr ""
27133
27134 #. type: =head2
27135 #: ../fish/guestfish-actions.pod:4822
27136 msgid "vgrename"
27137 msgstr ""
27138
27139 #. type: verbatim
27140 #: ../fish/guestfish-actions.pod:4824
27141 #, no-wrap
27142 msgid ""
27143 " vgrename volgroup newvolgroup\n"
27144 "\n"
27145 msgstr ""
27146
27147 #. type: =head2
27148 #: ../fish/guestfish-actions.pod:4828
27149 msgid "vgs"
27150 msgstr ""
27151
27152 #. type: verbatim
27153 #: ../fish/guestfish-actions.pod:4830
27154 #, no-wrap
27155 msgid ""
27156 " vgs\n"
27157 "\n"
27158 msgstr ""
27159
27160 #. type: textblock
27161 #: ../fish/guestfish-actions.pod:4838
27162 msgid "See also L</vgs-full>."
27163 msgstr ""
27164
27165 #. type: =head2
27166 #: ../fish/guestfish-actions.pod:4840
27167 msgid "vgs-full"
27168 msgstr ""
27169
27170 #. type: verbatim
27171 #: ../fish/guestfish-actions.pod:4842
27172 #, no-wrap
27173 msgid ""
27174 " vgs-full\n"
27175 "\n"
27176 msgstr ""
27177
27178 #. type: =head2
27179 #: ../fish/guestfish-actions.pod:4847
27180 msgid "vgscan"
27181 msgstr ""
27182
27183 #. type: verbatim
27184 #: ../fish/guestfish-actions.pod:4849
27185 #, no-wrap
27186 msgid ""
27187 " vgscan\n"
27188 "\n"
27189 msgstr ""
27190
27191 #. type: =head2
27192 #: ../fish/guestfish-actions.pod:4854
27193 msgid "vguuid"
27194 msgstr ""
27195
27196 #. type: verbatim
27197 #: ../fish/guestfish-actions.pod:4856
27198 #, no-wrap
27199 msgid ""
27200 " vguuid vgname\n"
27201 "\n"
27202 msgstr ""
27203
27204 #. type: =head2
27205 #: ../fish/guestfish-actions.pod:4860
27206 msgid "wc-c"
27207 msgstr ""
27208
27209 #. type: verbatim
27210 #: ../fish/guestfish-actions.pod:4862
27211 #, no-wrap
27212 msgid ""
27213 " wc-c path\n"
27214 "\n"
27215 msgstr ""
27216
27217 #. type: =head2
27218 #: ../fish/guestfish-actions.pod:4867
27219 msgid "wc-l"
27220 msgstr ""
27221
27222 #. type: verbatim
27223 #: ../fish/guestfish-actions.pod:4869
27224 #, no-wrap
27225 msgid ""
27226 " wc-l path\n"
27227 "\n"
27228 msgstr ""
27229
27230 #. type: =head2
27231 #: ../fish/guestfish-actions.pod:4874
27232 msgid "wc-w"
27233 msgstr ""
27234
27235 #. type: verbatim
27236 #: ../fish/guestfish-actions.pod:4876
27237 #, no-wrap
27238 msgid ""
27239 " wc-w path\n"
27240 "\n"
27241 msgstr ""
27242
27243 #. type: =head2
27244 #: ../fish/guestfish-actions.pod:4881
27245 msgid "write"
27246 msgstr ""
27247
27248 #. type: verbatim
27249 #: ../fish/guestfish-actions.pod:4883
27250 #, no-wrap
27251 msgid ""
27252 " write path content\n"
27253 "\n"
27254 msgstr ""
27255
27256 #. type: =head2
27257 #: ../fish/guestfish-actions.pod:4891
27258 msgid "write-file"
27259 msgstr ""
27260
27261 #. type: verbatim
27262 #: ../fish/guestfish-actions.pod:4893
27263 #, no-wrap
27264 msgid ""
27265 " write-file path content size\n"
27266 "\n"
27267 msgstr ""
27268
27269 #. type: textblock
27270 #: ../fish/guestfish-actions.pod:4909
27271 msgid "This function is deprecated.  In new code, use the L</write> call instead."
27272 msgstr ""
27273
27274 #. type: =head2
27275 #: ../fish/guestfish-actions.pod:4916
27276 msgid "zegrep"
27277 msgstr ""
27278
27279 #. type: verbatim
27280 #: ../fish/guestfish-actions.pod:4918
27281 #, no-wrap
27282 msgid ""
27283 " zegrep regex path\n"
27284 "\n"
27285 msgstr ""
27286
27287 #. type: =head2
27288 #: ../fish/guestfish-actions.pod:4926
27289 msgid "zegrepi"
27290 msgstr ""
27291
27292 #. type: verbatim
27293 #: ../fish/guestfish-actions.pod:4928
27294 #, no-wrap
27295 msgid ""
27296 " zegrepi regex path\n"
27297 "\n"
27298 msgstr ""
27299
27300 #. type: =head2
27301 #: ../fish/guestfish-actions.pod:4936
27302 msgid "zero"
27303 msgstr ""
27304
27305 #. type: verbatim
27306 #: ../fish/guestfish-actions.pod:4938
27307 #, no-wrap
27308 msgid ""
27309 " zero device\n"
27310 "\n"
27311 msgstr ""
27312
27313 #. type: textblock
27314 #: ../fish/guestfish-actions.pod:4946
27315 msgid "See also: L</zero-device>, L</scrub-device>."
27316 msgstr ""
27317
27318 #. type: =head2
27319 #: ../fish/guestfish-actions.pod:4948
27320 msgid "zero-device"
27321 msgstr ""
27322
27323 #. type: verbatim
27324 #: ../fish/guestfish-actions.pod:4950
27325 #, no-wrap
27326 msgid ""
27327 " zero-device device\n"
27328 "\n"
27329 msgstr ""
27330
27331 #. type: textblock
27332 #: ../fish/guestfish-actions.pod:4952
27333 msgid ""
27334 "This command writes zeroes over the entire C<device>.  Compare with L</zero> "
27335 "which just zeroes the first few blocks of a device."
27336 msgstr ""
27337
27338 #. type: =head2
27339 #: ../fish/guestfish-actions.pod:4959
27340 msgid "zerofree"
27341 msgstr ""
27342
27343 #. type: verbatim
27344 #: ../fish/guestfish-actions.pod:4961
27345 #, no-wrap
27346 msgid ""
27347 " zerofree device\n"
27348 "\n"
27349 msgstr ""
27350
27351 #. type: =head2
27352 #: ../fish/guestfish-actions.pod:4974
27353 msgid "zfgrep"
27354 msgstr ""
27355
27356 #. type: verbatim
27357 #: ../fish/guestfish-actions.pod:4976
27358 #, no-wrap
27359 msgid ""
27360 " zfgrep pattern path\n"
27361 "\n"
27362 msgstr ""
27363
27364 #. type: =head2
27365 #: ../fish/guestfish-actions.pod:4984
27366 msgid "zfgrepi"
27367 msgstr ""
27368
27369 #. type: verbatim
27370 #: ../fish/guestfish-actions.pod:4986
27371 #, no-wrap
27372 msgid ""
27373 " zfgrepi pattern path\n"
27374 "\n"
27375 msgstr ""
27376
27377 #. type: =head2
27378 #: ../fish/guestfish-actions.pod:4994
27379 msgid "zfile"
27380 msgstr ""
27381
27382 #. type: verbatim
27383 #: ../fish/guestfish-actions.pod:4996
27384 #, no-wrap
27385 msgid ""
27386 " zfile meth path\n"
27387 "\n"
27388 msgstr ""
27389
27390 #. type: textblock
27391 #: ../fish/guestfish-actions.pod:5003
27392 msgid "Since 1.0.63, use L</file> instead which can now process compressed files."
27393 msgstr ""
27394
27395 #. type: textblock
27396 #: ../fish/guestfish-actions.pod:5006
27397 msgid "This function is deprecated.  In new code, use the L</file> call instead."
27398 msgstr ""
27399
27400 #. type: =head2
27401 #: ../fish/guestfish-actions.pod:5013
27402 msgid "zgrep"
27403 msgstr ""
27404
27405 #. type: verbatim
27406 #: ../fish/guestfish-actions.pod:5015
27407 #, no-wrap
27408 msgid ""
27409 " zgrep regex path\n"
27410 "\n"
27411 msgstr ""
27412
27413 #. type: =head2
27414 #: ../fish/guestfish-actions.pod:5023
27415 msgid "zgrepi"
27416 msgstr ""
27417
27418 #. type: verbatim
27419 #: ../fish/guestfish-actions.pod:5025
27420 #, no-wrap
27421 msgid ""
27422 " zgrepi regex path\n"
27423 "\n"
27424 msgstr ""
27425
27426 #. type: =head2
27427 #: ../fish/guestfish-commands.pod:1
27428 msgid "alloc"
27429 msgstr ""
27430
27431 #. type: =head2
27432 #: ../fish/guestfish-commands.pod:3
27433 msgid "allocate"
27434 msgstr ""
27435
27436 #. type: verbatim
27437 #: ../fish/guestfish-commands.pod:5
27438 #, no-wrap
27439 msgid ""
27440 " alloc filename size\n"
27441 "\n"
27442 msgstr ""
27443
27444 #. type: textblock
27445 #: ../fish/guestfish-commands.pod:7
27446 msgid ""
27447 "This creates an empty (zeroed) file of the given size, and then adds so it "
27448 "can be further examined."
27449 msgstr ""
27450
27451 #. type: textblock
27452 #: ../fish/guestfish-commands.pod:10 ../fish/guestfish-commands.pod:168
27453 msgid "For more advanced image creation, see L<qemu-img(1)> utility."
27454 msgstr ""
27455
27456 #. type: textblock
27457 #: ../fish/guestfish-commands.pod:12 ../fish/guestfish-commands.pod:170
27458 msgid "Size can be specified using standard suffixes, eg. C<1M>."
27459 msgstr ""
27460
27461 #. type: textblock
27462 #: ../fish/guestfish-commands.pod:14
27463 msgid ""
27464 "To create a sparse file, use L</sparse> instead.  To create a prepared disk "
27465 "image, see L</PREPARED DISK IMAGES>."
27466 msgstr ""
27467
27468 #. type: =head2
27469 #: ../fish/guestfish-commands.pod:17
27470 msgid "copy-in"
27471 msgstr ""
27472
27473 #. type: verbatim
27474 #: ../fish/guestfish-commands.pod:19
27475 #, no-wrap
27476 msgid ""
27477 " copy-in local [local ...] /remotedir\n"
27478 "\n"
27479 msgstr ""
27480
27481 #. type: textblock
27482 #: ../fish/guestfish-commands.pod:21
27483 msgid ""
27484 "C<copy-in> copies local files or directories recursively into the disk "
27485 "image, placing them in the directory called C</remotedir> (which must "
27486 "exist).  This guestfish meta-command turns into a sequence of L</tar-in> and "
27487 "other commands as necessary."
27488 msgstr ""
27489
27490 #. type: textblock
27491 #: ../fish/guestfish-commands.pod:26
27492 msgid ""
27493 "Multiple local files and directories can be specified, but the last "
27494 "parameter must always be a remote directory.  Wildcards cannot be used."
27495 msgstr ""
27496
27497 #. type: =head2
27498 #: ../fish/guestfish-commands.pod:30
27499 msgid "copy-out"
27500 msgstr ""
27501
27502 #. type: verbatim
27503 #: ../fish/guestfish-commands.pod:32
27504 #, no-wrap
27505 msgid ""
27506 " copy-out remote [remote ...] localdir\n"
27507 "\n"
27508 msgstr ""
27509
27510 #. type: textblock
27511 #: ../fish/guestfish-commands.pod:34
27512 msgid ""
27513 "C<copy-out> copies remote files or directories recursively out of the disk "
27514 "image, placing them on the host disk in a local directory called C<localdir> "
27515 "(which must exist).  This guestfish meta-command turns into a sequence of "
27516 "L</download>, L</tar-out> and other commands as necessary."
27517 msgstr ""
27518
27519 #. type: textblock
27520 #: ../fish/guestfish-commands.pod:40
27521 msgid ""
27522 "Multiple remote files and directories can be specified, but the last "
27523 "parameter must always be a local directory.  To download to the current "
27524 "directory, use C<.> as in:"
27525 msgstr ""
27526
27527 #. type: verbatim
27528 #: ../fish/guestfish-commands.pod:44
27529 #, no-wrap
27530 msgid ""
27531 " copy-out /home .\n"
27532 "\n"
27533 msgstr ""
27534
27535 #. type: textblock
27536 #: ../fish/guestfish-commands.pod:46
27537 msgid ""
27538 "Wildcards cannot be used in the ordinary command, but you can use them with "
27539 "the help of L</glob> like this:"
27540 msgstr ""
27541
27542 #. type: verbatim
27543 #: ../fish/guestfish-commands.pod:49
27544 #, no-wrap
27545 msgid ""
27546 " glob copy-out /home/* .\n"
27547 "\n"
27548 msgstr ""
27549
27550 #. type: =head2
27551 #: ../fish/guestfish-commands.pod:51
27552 msgid "echo"
27553 msgstr ""
27554
27555 #. type: verbatim
27556 #: ../fish/guestfish-commands.pod:53
27557 #, no-wrap
27558 msgid ""
27559 " echo [params ...]\n"
27560 "\n"
27561 msgstr ""
27562
27563 #. type: textblock
27564 #: ../fish/guestfish-commands.pod:55
27565 msgid "This echos the parameters to the terminal."
27566 msgstr ""
27567
27568 #. type: =head2
27569 #: ../fish/guestfish-commands.pod:57
27570 msgid "edit"
27571 msgstr ""
27572
27573 #. type: =head2
27574 #: ../fish/guestfish-commands.pod:59
27575 msgid "vi"
27576 msgstr ""
27577
27578 #. type: =head2
27579 #: ../fish/guestfish-commands.pod:61
27580 msgid "emacs"
27581 msgstr ""
27582
27583 #. type: verbatim
27584 #: ../fish/guestfish-commands.pod:63
27585 #, no-wrap
27586 msgid ""
27587 " edit filename\n"
27588 "\n"
27589 msgstr ""
27590
27591 #. type: textblock
27592 #: ../fish/guestfish-commands.pod:65
27593 msgid ""
27594 "This is used to edit a file.  It downloads the file, edits it locally using "
27595 "your editor, then uploads the result."
27596 msgstr ""
27597
27598 #. type: textblock
27599 #: ../fish/guestfish-commands.pod:68
27600 msgid ""
27601 "The editor is C<$EDITOR>.  However if you use the alternate commands C<vi> "
27602 "or C<emacs> you will get those corresponding editors."
27603 msgstr ""
27604
27605 #. type: =head2
27606 #: ../fish/guestfish-commands.pod:72
27607 msgid "glob"
27608 msgstr ""
27609
27610 #. type: verbatim
27611 #: ../fish/guestfish-commands.pod:74
27612 #, no-wrap
27613 msgid ""
27614 " glob command args...\n"
27615 "\n"
27616 msgstr ""
27617
27618 #. type: textblock
27619 #: ../fish/guestfish-commands.pod:76
27620 msgid ""
27621 "Expand wildcards in any paths in the args list, and run C<command> "
27622 "repeatedly on each matching path."
27623 msgstr ""
27624
27625 #. type: textblock
27626 #: ../fish/guestfish-commands.pod:79
27627 msgid "See L</WILDCARDS AND GLOBBING>."
27628 msgstr ""
27629
27630 #. type: =head2
27631 #: ../fish/guestfish-commands.pod:81
27632 msgid "hexedit"
27633 msgstr ""
27634
27635 #. type: verbatim
27636 #: ../fish/guestfish-commands.pod:83
27637 #, no-wrap
27638 msgid ""
27639 " hexedit <filename|device>\n"
27640 " hexedit <filename|device> <max>\n"
27641 " hexedit <filename|device> <start> <max>\n"
27642 "\n"
27643 msgstr ""
27644
27645 #. type: textblock
27646 #: ../fish/guestfish-commands.pod:87
27647 msgid ""
27648 "Use hexedit (a hex editor) to edit all or part of a binary file or block "
27649 "device."
27650 msgstr ""
27651
27652 #. type: textblock
27653 #: ../fish/guestfish-commands.pod:90
27654 msgid ""
27655 "This command works by downloading potentially the whole file or device, "
27656 "editing it locally, then uploading it.  If the file or device is large, you "
27657 "have to specify which part you wish to edit by using C<max> and/or C<start> "
27658 "C<max> parameters.  C<start> and C<max> are specified in bytes, with the "
27659 "usual modifiers allowed such as C<1M> (1 megabyte)."
27660 msgstr ""
27661
27662 #. type: textblock
27663 #: ../fish/guestfish-commands.pod:97
27664 msgid "For example to edit the first few sectors of a disk you might do:"
27665 msgstr ""
27666
27667 #. type: verbatim
27668 #: ../fish/guestfish-commands.pod:100
27669 #, no-wrap
27670 msgid ""
27671 " hexedit /dev/sda 1M\n"
27672 "\n"
27673 msgstr ""
27674
27675 #. type: textblock
27676 #: ../fish/guestfish-commands.pod:102
27677 msgid ""
27678 "which would allow you to edit anywhere within the first megabyte of the "
27679 "disk."
27680 msgstr ""
27681
27682 #. type: textblock
27683 #: ../fish/guestfish-commands.pod:105
27684 msgid "To edit the superblock of an ext2 filesystem on C</dev/sda1>, do:"
27685 msgstr ""
27686
27687 #. type: verbatim
27688 #: ../fish/guestfish-commands.pod:107
27689 #, no-wrap
27690 msgid ""
27691 " hexedit /dev/sda1 0x400 0x400\n"
27692 "\n"
27693 msgstr ""
27694
27695 #. type: textblock
27696 #: ../fish/guestfish-commands.pod:109
27697 msgid "(assuming the superblock is in the standard location)."
27698 msgstr ""
27699
27700 #. type: textblock
27701 #: ../fish/guestfish-commands.pod:111
27702 msgid ""
27703 "This command requires the external L<hexedit(1)> program.  You can specify "
27704 "another program to use by setting the C<HEXEDITOR> environment variable."
27705 msgstr ""
27706
27707 #. type: textblock
27708 #: ../fish/guestfish-commands.pod:115
27709 msgid "See also L</hexdump>."
27710 msgstr ""
27711
27712 #. type: =head2
27713 #: ../fish/guestfish-commands.pod:117
27714 msgid "lcd"
27715 msgstr ""
27716
27717 #. type: verbatim
27718 #: ../fish/guestfish-commands.pod:119
27719 #, no-wrap
27720 msgid ""
27721 " lcd directory\n"
27722 "\n"
27723 msgstr ""
27724
27725 #. type: textblock
27726 #: ../fish/guestfish-commands.pod:121
27727 msgid "Change the local directory, ie. the current directory of guestfish itself."
27728 msgstr ""
27729
27730 #. type: textblock
27731 #: ../fish/guestfish-commands.pod:124
27732 msgid "Note that C<!cd> won't do what you might expect."
27733 msgstr ""
27734
27735 #. type: =head2
27736 #: ../fish/guestfish-commands.pod:126
27737 msgid "man"
27738 msgstr ""
27739
27740 #. type: =head2
27741 #: ../fish/guestfish-commands.pod:128
27742 msgid "manual"
27743 msgstr ""
27744
27745 #. type: verbatim
27746 #: ../fish/guestfish-commands.pod:130
27747 #, no-wrap
27748 msgid ""
27749 "  man\n"
27750 "\n"
27751 msgstr ""
27752
27753 #. type: textblock
27754 #: ../fish/guestfish-commands.pod:132
27755 msgid "Opens the manual page for guestfish."
27756 msgstr ""
27757
27758 #. type: =head2
27759 #: ../fish/guestfish-commands.pod:134
27760 msgid "more"
27761 msgstr ""
27762
27763 #. type: =head2
27764 #: ../fish/guestfish-commands.pod:136
27765 msgid "less"
27766 msgstr ""
27767
27768 #. type: verbatim
27769 #: ../fish/guestfish-commands.pod:138
27770 #, no-wrap
27771 msgid ""
27772 " more filename\n"
27773 "\n"
27774 msgstr ""
27775
27776 #. type: verbatim
27777 #: ../fish/guestfish-commands.pod:140
27778 #, no-wrap
27779 msgid ""
27780 " less filename\n"
27781 "\n"
27782 msgstr ""
27783
27784 #. type: textblock
27785 #: ../fish/guestfish-commands.pod:142
27786 msgid "This is used to view a file."
27787 msgstr ""
27788
27789 #. type: textblock
27790 #: ../fish/guestfish-commands.pod:144
27791 msgid ""
27792 "The default viewer is C<$PAGER>.  However if you use the alternate command "
27793 "C<less> you will get the C<less> command specifically."
27794 msgstr ""
27795
27796 #. type: =head2
27797 #: ../fish/guestfish-commands.pod:147
27798 msgid "reopen"
27799 msgstr ""
27800
27801 #. type: verbatim
27802 #: ../fish/guestfish-commands.pod:149
27803 #, no-wrap
27804 msgid ""
27805 "  reopen\n"
27806 "\n"
27807 msgstr ""
27808
27809 #. type: textblock
27810 #: ../fish/guestfish-commands.pod:151
27811 msgid ""
27812 "Close and reopen the libguestfs handle.  It is not necessary to use this "
27813 "normally, because the handle is closed properly when guestfish exits.  "
27814 "However this is occasionally useful for testing."
27815 msgstr ""
27816
27817 #. type: =head2
27818 #: ../fish/guestfish-commands.pod:155
27819 msgid "sparse"
27820 msgstr ""
27821
27822 #. type: verbatim
27823 #: ../fish/guestfish-commands.pod:157
27824 #, no-wrap
27825 msgid ""
27826 " sparse filename size\n"
27827 "\n"
27828 msgstr ""
27829
27830 #. type: textblock
27831 #: ../fish/guestfish-commands.pod:159
27832 msgid ""
27833 "This creates an empty sparse file of the given size, and then adds so it can "
27834 "be further examined."
27835 msgstr ""
27836
27837 #. type: textblock
27838 #: ../fish/guestfish-commands.pod:162
27839 msgid ""
27840 "In all respects it works the same as the L</alloc> command, except that the "
27841 "image file is allocated sparsely, which means that disk blocks are not "
27842 "assigned to the file until they are needed.  Sparse disk files only use "
27843 "space when written to, but they are slower and there is a danger you could "
27844 "run out of real disk space during a write operation."
27845 msgstr ""
27846
27847 #. type: =head2
27848 #: ../fish/guestfish-commands.pod:172
27849 msgid "supported"
27850 msgstr ""
27851
27852 #. type: verbatim
27853 #: ../fish/guestfish-commands.pod:174
27854 #, no-wrap
27855 msgid ""
27856 " supported\n"
27857 "\n"
27858 msgstr ""
27859
27860 #. type: textblock
27861 #: ../fish/guestfish-commands.pod:176
27862 msgid ""
27863 "This command returns a list of the optional groups known to the daemon, and "
27864 "indicates which ones are supported by this build of the libguestfs "
27865 "appliance."
27866 msgstr ""
27867
27868 #. type: textblock
27869 #: ../fish/guestfish-commands.pod:180
27870 msgid "See also L<guestfs(3)/AVAILABILITY>."
27871 msgstr ""
27872
27873 #. type: =head2
27874 #: ../fish/guestfish-commands.pod:182
27875 msgid "time"
27876 msgstr ""
27877
27878 #. type: verbatim
27879 #: ../fish/guestfish-commands.pod:184
27880 #, no-wrap
27881 msgid ""
27882 " time command args...\n"
27883 "\n"
27884 msgstr ""
27885
27886 #. type: textblock
27887 #: ../fish/guestfish-commands.pod:186
27888 msgid ""
27889 "Run the command as usual, but print the elapsed time afterwards.  This can "
27890 "be useful for benchmarking operations."
27891 msgstr ""
27892
27893 #. type: textblock
27894 #: ../test-tool/libguestfs-test-tool.pod:5
27895 msgid "libguestfs-test-tool - End user tests for libguestfs"
27896 msgstr ""
27897
27898 #. type: verbatim
27899 #: ../test-tool/libguestfs-test-tool.pod:9
27900 #, no-wrap
27901 msgid ""
27902 " libguestfs-test-tool [--options]\n"
27903 "\n"
27904 msgstr ""
27905
27906 #. type: textblock
27907 #: ../test-tool/libguestfs-test-tool.pod:13
27908 msgid ""
27909 "libguestfs-test-tool is a test program shipped with libguestfs to end users "
27910 "and developers, to allow them to check basic libguestfs functionality is "
27911 "working.  This is needed because libguestfs occasionally breaks for reasons "
27912 "beyond our control: usually because of changes in the underlying qemu or "
27913 "kernel packages, or the host environment."
27914 msgstr ""
27915
27916 #. type: textblock
27917 #: ../test-tool/libguestfs-test-tool.pod:20
27918 msgid "If you suspect a problem in libguestfs, then just run:"
27919 msgstr ""
27920
27921 #. type: verbatim
27922 #: ../test-tool/libguestfs-test-tool.pod:22
27923 #, no-wrap
27924 msgid ""
27925 " libguestfs-test-tool\n"
27926 "\n"
27927 msgstr ""
27928
27929 #. type: textblock
27930 #: ../test-tool/libguestfs-test-tool.pod:24
27931 msgid "It will print lots of diagnostic messages."
27932 msgstr ""
27933
27934 #. type: textblock
27935 #: ../test-tool/libguestfs-test-tool.pod:26
27936 msgid "If it runs to completion successfully, you will see this near the end:"
27937 msgstr ""
27938
27939 #. type: verbatim
27940 #: ../test-tool/libguestfs-test-tool.pod:28
27941 #, no-wrap
27942 msgid ""
27943 " ===== TEST FINISHED OK =====\n"
27944 "\n"
27945 msgstr ""
27946
27947 #. type: textblock
27948 #: ../test-tool/libguestfs-test-tool.pod:30
27949 msgid "and the test tool will exit with code 0."
27950 msgstr ""
27951
27952 #. type: textblock
27953 #: ../test-tool/libguestfs-test-tool.pod:32
27954 msgid ""
27955 "If it fails (and/or exits with non-zero error code), please paste the "
27956 "B<complete, unedited> output of the test tool into a bug report.  More "
27957 "information about reporting bugs can be found on the "
27958 "L<http://libguestfs.org/> website."
27959 msgstr ""
27960
27961 #. type: =item
27962 #: ../test-tool/libguestfs-test-tool.pod:41
27963 msgid "I<--help>"
27964 msgstr ""
27965
27966 #. type: textblock
27967 #: ../test-tool/libguestfs-test-tool.pod:43
27968 msgid "Display short usage information and exit."
27969 msgstr ""
27970
27971 #. type: =item
27972 #: ../test-tool/libguestfs-test-tool.pod:45
27973 msgid "I<--qemu qemu_binary>"
27974 msgstr ""
27975
27976 #. type: textblock
27977 #: ../test-tool/libguestfs-test-tool.pod:47
27978 msgid ""
27979 "If you have downloaded another qemu binary, point this option at the full "
27980 "path of the binary to try it."
27981 msgstr ""
27982
27983 #. type: =item
27984 #: ../test-tool/libguestfs-test-tool.pod:50
27985 msgid "I<--qemudir qemu_source_dir>"
27986 msgstr ""
27987
27988 #. type: textblock
27989 #: ../test-tool/libguestfs-test-tool.pod:52
27990 msgid ""
27991 "If you have compiled qemu from source, point this option at the source "
27992 "directory to try it."
27993 msgstr ""
27994
27995 #. type: =item
27996 #: ../test-tool/libguestfs-test-tool.pod:55
27997 msgid "I<--timeout N>"
27998 msgstr ""
27999
28000 #. type: textblock
28001 #: ../test-tool/libguestfs-test-tool.pod:57
28002 msgid ""
28003 "Set the launch timeout to C<N> seconds.  The default is 120 seconds which "
28004 "does not usually need to be adjusted unless your machine is very slow."
28005 msgstr ""
28006
28007 #. type: =head1
28008 #: ../test-tool/libguestfs-test-tool.pod:63
28009 msgid "TRYING OUT A DIFFERENT VERSION OF QEMU"
28010 msgstr ""
28011
28012 #. type: textblock
28013 #: ../test-tool/libguestfs-test-tool.pod:65
28014 msgid ""
28015 "If you have compiled another version of qemu from source and would like to "
28016 "try that, then you can use the I<--qemudir> option to point to the qemu "
28017 "source directory."
28018 msgstr ""
28019
28020 #. type: textblock
28021 #: ../test-tool/libguestfs-test-tool.pod:69
28022 msgid ""
28023 "If you have downloaded a qemu binary from somewhere, use the I<--qemu> "
28024 "option to point to the binary."
28025 msgstr ""
28026
28027 #. type: textblock
28028 #: ../test-tool/libguestfs-test-tool.pod:72
28029 msgid ""
28030 "When using an alternate qemu with libguestfs, usually you would need to "
28031 "write a qemu wrapper script (see section I<QEMU WRAPPERS> in "
28032 "L<guestfs(3)>).  libguestfs-test-tool writes a temporary qemu wrapper script "
28033 "when you use either of the I<--qemudir> or I<--qemu> options."
28034 msgstr ""
28035
28036 #. type: textblock
28037 #: ../test-tool/libguestfs-test-tool.pod:79
28038 msgid ""
28039 "libguestfs-test-tool returns I<0> if the tests completed without error, or "
28040 "I<1> if there was an error."
28041 msgstr ""
28042
28043 #. type: textblock
28044 #: ../test-tool/libguestfs-test-tool.pod:84
28045 msgid ""
28046 "For the full list of environment variables which may affect libguestfs, "
28047 "please see the L<guestfs(3)> manual page."
28048 msgstr ""
28049
28050 #. type: textblock
28051 #: ../test-tool/libguestfs-test-tool.pod:89
28052 msgid "L<guestfs(3)>, L<http://libguestfs.org/>, L<http://qemu.org/>."
28053 msgstr ""
28054
28055 #. type: textblock
28056 #: ../fuse/guestmount.pod:5
28057 msgid "guestmount - Mount a guest filesystem on the host using FUSE and libguestfs"
28058 msgstr ""
28059
28060 #. type: verbatim
28061 #: ../fuse/guestmount.pod:9
28062 #, no-wrap
28063 msgid ""
28064 " guestmount [--options] -a disk.img -m device [--ro] mountpoint\n"
28065 "\n"
28066 msgstr ""
28067
28068 #. type: verbatim
28069 #: ../fuse/guestmount.pod:11
28070 #, no-wrap
28071 msgid ""
28072 " guestmount [--options] -a disk.img -i [--ro] mountpoint\n"
28073 "\n"
28074 msgstr ""
28075
28076 #. type: verbatim
28077 #: ../fuse/guestmount.pod:13
28078 #, no-wrap
28079 msgid ""
28080 " guestmount [--options] -d Guest -i [--ro] mountpoint\n"
28081 "\n"
28082 msgstr ""
28083
28084 #. type: textblock
28085 #: ../fuse/guestmount.pod:17
28086 msgid ""
28087 "You must I<not> use C<guestmount> in read-write mode on live virtual "
28088 "machines.  If you do this, you risk disk corruption in the VM."
28089 msgstr ""
28090
28091 #. type: textblock
28092 #: ../fuse/guestmount.pod:22
28093 msgid ""
28094 "The guestmount program can be used to mount virtual machine filesystems and "
28095 "other disk images on the host.  It uses libguestfs for access to the guest "
28096 "filesystem, and FUSE (the \"filesystem in userspace\") to make it appear as "
28097 "a mountable device."
28098 msgstr ""
28099
28100 #. type: textblock
28101 #: ../fuse/guestmount.pod:27
28102 msgid ""
28103 "Along with other options, you have to give at least one device (I<-a> "
28104 "option) or libvirt domain (I<-d> option), and at least one mountpoint (I<-m> "
28105 "option) or use the I<-i> inspection option.  How this works is better "
28106 "explained in the L<guestfish(1)> manual page, or by looking at the examples "
28107 "below."
28108 msgstr ""
28109
28110 #. type: textblock
28111 #: ../fuse/guestmount.pod:33
28112 msgid ""
28113 "FUSE lets you mount filesystems as non-root.  The mountpoint must be owned "
28114 "by you, and the filesystem will not be visible to any other users unless you "
28115 "make certain global configuration changes to C</etc/fuse.conf>.  To unmount "
28116 "the filesystem, use the C<fusermount -u> command."
28117 msgstr ""
28118
28119 #. type: textblock
28120 #: ../fuse/guestmount.pod:41
28121 msgid ""
28122 "For a typical Windows guest which has its main filesystem on the first "
28123 "partition:"
28124 msgstr ""
28125
28126 #. type: verbatim
28127 #: ../fuse/guestmount.pod:44
28128 #, no-wrap
28129 msgid ""
28130 " guestmount -a windows.img -m /dev/sda1 --ro /mnt\n"
28131 "\n"
28132 msgstr ""
28133
28134 #. type: textblock
28135 #: ../fuse/guestmount.pod:46
28136 msgid ""
28137 "For a typical Linux guest which has a /boot filesystem on the first "
28138 "partition, and the root filesystem on a logical volume:"
28139 msgstr ""
28140
28141 #. type: verbatim
28142 #: ../fuse/guestmount.pod:49
28143 #, no-wrap
28144 msgid ""
28145 " guestmount -a linux.img -m /dev/VG/LV -m /dev/sda1:/boot --ro /mnt\n"
28146 "\n"
28147 msgstr ""
28148
28149 #. type: textblock
28150 #: ../fuse/guestmount.pod:51
28151 msgid "To get libguestfs to detect guest mountpoints for you:"
28152 msgstr ""
28153
28154 #. type: verbatim
28155 #: ../fuse/guestmount.pod:53
28156 #, no-wrap
28157 msgid ""
28158 " guestmount -a guest.img -i --ro /mnt\n"
28159 "\n"
28160 msgstr ""
28161
28162 #. type: textblock
28163 #: ../fuse/guestmount.pod:55
28164 msgid "For a libvirt guest called \"Guest\" you could do:"
28165 msgstr ""
28166
28167 #. type: verbatim
28168 #: ../fuse/guestmount.pod:57
28169 #, no-wrap
28170 msgid ""
28171 " guestmount -d Guest -i --ro /mnt\n"
28172 "\n"
28173 msgstr ""
28174
28175 #. type: textblock
28176 #: ../fuse/guestmount.pod:59
28177 msgid ""
28178 "If you don't know what filesystems are contained in a guest or disk image, "
28179 "use L<virt-filesystems(1)> first:"
28180 msgstr ""
28181
28182 #. type: verbatim
28183 #: ../fuse/guestmount.pod:62
28184 #, no-wrap
28185 msgid ""
28186 " virt-filesystems MyGuest\n"
28187 "\n"
28188 msgstr ""
28189
28190 #. type: textblock
28191 #: ../fuse/guestmount.pod:64
28192 msgid ""
28193 "If you want to trace the libguestfs calls but without excessive debugging "
28194 "information, we recommend:"
28195 msgstr ""
28196
28197 #. type: verbatim
28198 #: ../fuse/guestmount.pod:67
28199 #, no-wrap
28200 msgid ""
28201 " guestmount [...] --trace /mnt\n"
28202 "\n"
28203 msgstr ""
28204
28205 #. type: textblock
28206 #: ../fuse/guestmount.pod:69
28207 msgid "If you want to debug the program, we recommend:"
28208 msgstr ""
28209
28210 #. type: verbatim
28211 #: ../fuse/guestmount.pod:71
28212 #, no-wrap
28213 msgid ""
28214 " guestmount [...] --trace --verbose /mnt\n"
28215 "\n"
28216 msgstr ""
28217
28218 #. type: =head1
28219 #: ../fuse/guestmount.pod:73
28220 msgid "NOTES"
28221 msgstr ""
28222
28223 #. type: =head2
28224 #: ../fuse/guestmount.pod:75
28225 msgid "Other users cannot see the filesystem by default"
28226 msgstr ""
28227
28228 #. type: textblock
28229 #: ../fuse/guestmount.pod:77
28230 msgid ""
28231 "If you mount a filesystem as one user (eg. root), then other users will not "
28232 "be able to see it by default.  The fix is to add the FUSE C<allow_other> "
28233 "option when mounting:"
28234 msgstr ""
28235
28236 #. type: verbatim
28237 #: ../fuse/guestmount.pod:81
28238 #, no-wrap
28239 msgid ""
28240 " sudo guestmount [...] -o allow_other /mnt\n"
28241 "\n"
28242 msgstr ""
28243
28244 #. type: =item
28245 #: ../fuse/guestmount.pod:87
28246 msgid "B<-a image> | B<--add image>"
28247 msgstr ""
28248
28249 #. type: textblock
28250 #: ../fuse/guestmount.pod:89
28251 msgid "Add a block device or virtual machine image."
28252 msgstr ""
28253
28254 #. type: =item
28255 #: ../fuse/guestmount.pod:94
28256 msgid "B<-c URI> | B<--connect URI>"
28257 msgstr ""
28258
28259 #. type: =item
28260 #: ../fuse/guestmount.pod:100
28261 msgid "B<-d libvirt-domain> | B<--domain libvirt-domain>"
28262 msgstr ""
28263
28264 #. type: =item
28265 #: ../fuse/guestmount.pod:106
28266 msgid "B<--dir-cache-timeout N>"
28267 msgstr ""
28268
28269 #. type: textblock
28270 #: ../fuse/guestmount.pod:108
28271 msgid ""
28272 "Set the readdir cache timeout to I<N> seconds, the default being 60 "
28273 "seconds.  The readdir cache [actually, there are several semi-independent "
28274 "caches] is populated after a readdir(2) call with the stat and extended "
28275 "attributes of the files in the directory, in anticipation that they will be "
28276 "requested soon after."
28277 msgstr ""
28278
28279 #. type: textblock
28280 #: ../fuse/guestmount.pod:114
28281 msgid ""
28282 "There is also a different attribute cache implemented by FUSE (see the FUSE "
28283 "option I<-o attr_timeout>), but the FUSE cache does not anticipate future "
28284 "requests, only cache existing ones."
28285 msgstr ""
28286
28287 #. type: =item
28288 #: ../fuse/guestmount.pod:125
28289 msgid "B<--format=raw|qcow2|..> | B<--format>"
28290 msgstr ""
28291
28292 #. type: textblock
28293 #: ../fuse/guestmount.pod:132
28294 msgid ""
28295 "If you have untrusted raw-format guest disk images, you should use this "
28296 "option to specify the disk format.  This avoids a possible security problem "
28297 "with malicious guests (CVE-2010-3851).  See also "
28298 "L<guestfs(3)/guestfs_add_drive_opts>."
28299 msgstr ""
28300
28301 #. type: =item
28302 #: ../fuse/guestmount.pod:137
28303 msgid "B<--fuse-help>"
28304 msgstr ""
28305
28306 #. type: textblock
28307 #: ../fuse/guestmount.pod:139
28308 msgid "Display help on special FUSE options (see I<-o> below)."
28309 msgstr ""
28310
28311 #. type: textblock
28312 #: ../fuse/guestmount.pod:143
28313 msgid "Display brief help and exit."
28314 msgstr ""
28315
28316 #. type: =item
28317 #: ../fuse/guestmount.pod:145
28318 msgid "B<-i> | B<--inspector>"
28319 msgstr ""
28320
28321 #. type: textblock
28322 #: ../fuse/guestmount.pod:165
28323 msgid ""
28324 "Mount the named partition or logical volume on the given mountpoint B<in the "
28325 "guest> (this has nothing to do with mountpoints in the host)."
28326 msgstr ""
28327
28328 #. type: textblock
28329 #: ../fuse/guestmount.pod:168
28330 msgid ""
28331 "If the mountpoint is omitted, it defaults to C</>.  You have to mount "
28332 "something on C</>."
28333 msgstr ""
28334
28335 #. type: =item
28336 #: ../fuse/guestmount.pod:181
28337 msgid "B<-n> | B<--no-sync>"
28338 msgstr ""
28339
28340 #. type: textblock
28341 #: ../fuse/guestmount.pod:183
28342 msgid ""
28343 "By default, we attempt to sync the guest disk when the FUSE mountpoint is "
28344 "unmounted.  If you specify this option, then we don't attempt to sync the "
28345 "disk.  See the discussion of autosync in the L<guestfs(3)> manpage."
28346 msgstr ""
28347
28348 #. type: =item
28349 #: ../fuse/guestmount.pod:188
28350 msgid "B<-o option> | B<--option option>"
28351 msgstr ""
28352
28353 #. type: textblock
28354 #: ../fuse/guestmount.pod:190
28355 msgid "Pass extra options to FUSE."
28356 msgstr ""
28357
28358 #. type: textblock
28359 #: ../fuse/guestmount.pod:192
28360 msgid ""
28361 "To get a list of all the extra options supported by FUSE, use the command "
28362 "below.  Note that only the FUSE I<-o> options can be passed, and only some "
28363 "of them are a good idea."
28364 msgstr ""
28365
28366 #. type: verbatim
28367 #: ../fuse/guestmount.pod:196
28368 #, no-wrap
28369 msgid ""
28370 " guestmount --fuse-help\n"
28371 "\n"
28372 msgstr ""
28373
28374 #. type: textblock
28375 #: ../fuse/guestmount.pod:198
28376 msgid "Some potentially useful FUSE options:"
28377 msgstr ""
28378
28379 #. type: =item
28380 #: ../fuse/guestmount.pod:202
28381 msgid "B<-o allow_other>"
28382 msgstr ""
28383
28384 #. type: textblock
28385 #: ../fuse/guestmount.pod:204
28386 msgid "Allow other users to see the filesystem."
28387 msgstr ""
28388
28389 #. type: =item
28390 #: ../fuse/guestmount.pod:206
28391 msgid "B<-o attr_timeout=N>"
28392 msgstr ""
28393
28394 #. type: textblock
28395 #: ../fuse/guestmount.pod:208
28396 msgid "Enable attribute caching by FUSE, and set the timeout to I<N> seconds."
28397 msgstr ""
28398
28399 #. type: =item
28400 #: ../fuse/guestmount.pod:210
28401 msgid "B<-o kernel_cache>"
28402 msgstr ""
28403
28404 #. type: textblock
28405 #: ../fuse/guestmount.pod:212
28406 msgid ""
28407 "Allow the kernel to cache files (reduces the number of reads that have to go "
28408 "through the L<guestfs(3)> API).  This is generally a good idea if you can "
28409 "afford the extra memory usage."
28410 msgstr ""
28411
28412 #. type: =item
28413 #: ../fuse/guestmount.pod:216
28414 msgid "B<-o uid=N> B<-o gid=N>"
28415 msgstr ""
28416
28417 #. type: textblock
28418 #: ../fuse/guestmount.pod:218
28419 msgid ""
28420 "Use these options to map all UIDs and GIDs inside the guest filesystem to "
28421 "the chosen values."
28422 msgstr ""
28423
28424 #. type: =item
28425 #: ../fuse/guestmount.pod:223
28426 msgid "B<-r> | B<--ro>"
28427 msgstr ""
28428
28429 #. type: textblock
28430 #: ../fuse/guestmount.pod:225
28431 msgid ""
28432 "Add devices and mount everything read-only.  Also disallow writes and make "
28433 "the disk appear read-only to FUSE."
28434 msgstr ""
28435
28436 #. type: textblock
28437 #: ../fuse/guestmount.pod:228
28438 msgid ""
28439 "This is highly recommended if you are not going to edit the guest disk.  If "
28440 "the guest is running and this option is I<not> supplied, then there is a "
28441 "strong risk of disk corruption in the guest.  We try to prevent this from "
28442 "happening, but it is not always possible."
28443 msgstr ""
28444
28445 #. type: textblock
28446 #: ../fuse/guestmount.pod:233
28447 msgid "See also L<guestfish(1)/OPENING DISKS FOR READ AND WRITE>."
28448 msgstr ""
28449
28450 #. type: textblock
28451 #: ../fuse/guestmount.pod:237
28452 msgid "Enable SELinux support for the guest."
28453 msgstr ""
28454
28455 #. type: =item
28456 #: ../fuse/guestmount.pod:239
28457 msgid "B<-v> | B<--verbose>"
28458 msgstr ""
28459
28460 #. type: textblock
28461 #: ../fuse/guestmount.pod:241
28462 msgid "Enable verbose messages from underlying libguestfs."
28463 msgstr ""
28464
28465 #. type: =item
28466 #: ../fuse/guestmount.pod:243
28467 msgid "B<-V> | B<--version>"
28468 msgstr ""
28469
28470 #. type: textblock
28471 #: ../fuse/guestmount.pod:245
28472 msgid "Display the program version and exit."
28473 msgstr ""
28474
28475 #. type: =item
28476 #: ../fuse/guestmount.pod:247
28477 msgid "B<-w> | B<--rw>"
28478 msgstr ""
28479
28480 #. type: textblock
28481 #: ../fuse/guestmount.pod:252 ../fuse/guestmount.pod:273
28482 msgid "See L<guestfish(1)/OPENING DISKS FOR READ AND WRITE>."
28483 msgstr ""
28484
28485 #. type: =item
28486 #: ../fuse/guestmount.pod:254
28487 msgid "B<-x> | B<--trace>"
28488 msgstr ""
28489
28490 #. type: textblock
28491 #: ../fuse/guestmount.pod:256
28492 msgid "Trace libguestfs calls and entry into each FUSE function."
28493 msgstr ""
28494
28495 #. type: textblock
28496 #: ../fuse/guestmount.pod:258
28497 msgid "This also stops the daemon from forking into the background."
28498 msgstr ""
28499
28500 #. type: textblock
28501 #: ../fuse/guestmount.pod:279
28502 msgid ""
28503 "L<guestfish(1)>, L<virt-inspector(1)>, L<virt-cat(1)>, L<virt-edit(1)>, "
28504 "L<virt-tar(1)>, L<guestfs(3)>, L<http://libguestfs.org/>, "
28505 "L<http://fuse.sf.net/>."
28506 msgstr ""
28507
28508 #. type: textblock
28509 #: ../fuse/guestmount.pod:294
28510 msgid "Copyright (C) 2009-2010 Red Hat Inc.  L<http://libguestfs.org/>"
28511 msgstr ""
28512
28513 #. type: textblock
28514 #: ../tools/virt-edit.pl:34
28515 msgid "virt-edit - Edit a file in a virtual machine"
28516 msgstr ""
28517
28518 #. type: verbatim
28519 #: ../tools/virt-edit.pl:38
28520 #, no-wrap
28521 msgid ""
28522 " virt-edit [--options] domname file\n"
28523 "\n"
28524 msgstr ""
28525
28526 #. type: verbatim
28527 #: ../tools/virt-edit.pl:40
28528 #, no-wrap
28529 msgid ""
28530 " virt-edit [--options] disk.img [disk.img ...] file\n"
28531 "\n"
28532 msgstr ""
28533
28534 #. type: verbatim
28535 #: ../tools/virt-edit.pl:42
28536 #, no-wrap
28537 msgid ""
28538 " virt-edit [domname|disk.img] file -e 'expr'\n"
28539 "\n"
28540 msgstr ""
28541
28542 #. type: textblock
28543 #: ../tools/virt-edit.pl:46
28544 msgid ""
28545 "You must I<not> use C<virt-edit> on live virtual machines.  If you do this, "
28546 "you risk disk corruption in the VM.  C<virt-edit> tries to stop you from "
28547 "doing this, but doesn't catch all cases."
28548 msgstr ""
28549
28550 #. type: textblock
28551 #: ../tools/virt-edit.pl:52
28552 msgid ""
28553 "C<virt-edit> is a command line tool to edit C<file> where C<file> exists in "
28554 "the named virtual machine (or disk image)."
28555 msgstr ""
28556
28557 #. type: textblock
28558 #: ../tools/virt-edit.pl:55
28559 msgid "If you want to just view a file, use L<virt-cat(1)>."
28560 msgstr ""
28561
28562 #. type: textblock
28563 #: ../tools/virt-edit.pl:57
28564 msgid ""
28565 "For more complex cases you should look at the L<guestfish(1)> tool (see "
28566 "L</USING GUESTFISH> below)."
28567 msgstr ""
28568
28569 #. type: textblock
28570 #: ../tools/virt-edit.pl:60
28571 msgid ""
28572 "C<virt-edit> cannot be used to create a new file, nor to edit multiple "
28573 "files.  L<guestfish(1)> can do that and much more."
28574 msgstr ""
28575
28576 #. type: textblock
28577 #: ../tools/virt-edit.pl:65
28578 msgid "Edit the named files interactively:"
28579 msgstr ""
28580
28581 #. type: verbatim
28582 #: ../tools/virt-edit.pl:67
28583 #, no-wrap
28584 msgid ""
28585 " virt-edit mydomain /boot/grub/grub.conf\n"
28586 "\n"
28587 msgstr ""
28588
28589 #. type: verbatim
28590 #: ../tools/virt-edit.pl:69
28591 #, no-wrap
28592 msgid ""
28593 " virt-edit mydomain /etc/passwd\n"
28594 "\n"
28595 msgstr ""
28596
28597 #. type: textblock
28598 #: ../tools/virt-edit.pl:71
28599 msgid "For Windows guests, some Windows paths are understood:"
28600 msgstr ""
28601
28602 #. type: verbatim
28603 #: ../tools/virt-edit.pl:73
28604 #, no-wrap
28605 msgid ""
28606 " virt-edit mywindomain 'c:\\autoexec.bat'\n"
28607 "\n"
28608 msgstr ""
28609
28610 #. type: textblock
28611 #: ../tools/virt-edit.pl:75
28612 msgid ""
28613 "You can also edit files non-interactively (see L</NON-INTERACTIVE EDITING> "
28614 "below).  To change the init default level to 5:"
28615 msgstr ""
28616
28617 #. type: verbatim
28618 #: ../tools/virt-edit.pl:79
28619 #, no-wrap
28620 msgid ""
28621 " virt-edit mydomain /etc/inittab -e 's/^id:.*/id:5:initdefault:/'\n"
28622 "\n"
28623 msgstr ""
28624
28625 #. type: textblock
28626 #: ../tools/virt-edit.pl:91 ../tools/virt-win-reg.pl:106 ../tools/virt-list-filesystems.pl:63 ../tools/virt-tar.pl:113 ../tools/virt-make-fs.pl:163 ../tools/virt-list-partitions.pl:64
28627 msgid "Display brief help."
28628 msgstr ""
28629
28630 #. type: textblock
28631 #: ../tools/virt-edit.pl:99 ../tools/virt-win-reg.pl:114 ../tools/virt-list-filesystems.pl:71 ../tools/virt-tar.pl:121 ../tools/virt-make-fs.pl:171 ../tools/virt-list-partitions.pl:72
28632 msgid "Display version number and exit."
28633 msgstr ""
28634
28635 #. type: =item
28636 #: ../tools/virt-edit.pl:105
28637 msgid "B<--backup extension> | B<-b extension>"
28638 msgstr ""
28639
28640 #. type: textblock
28641 #: ../tools/virt-edit.pl:107
28642 msgid ""
28643 "Create a backup of the original file I<in the guest disk image>.  The backup "
28644 "has the original filename with C<extension> added."
28645 msgstr ""
28646
28647 #. type: textblock
28648 #: ../tools/virt-edit.pl:110
28649 msgid ""
28650 "Usually the first character of C<extension> would be a dot C<.> so you would "
28651 "write:"
28652 msgstr ""
28653
28654 #. type: verbatim
28655 #: ../tools/virt-edit.pl:113
28656 #, no-wrap
28657 msgid ""
28658 " virt-edit -b .orig [etc]\n"
28659 "\n"
28660 msgstr ""
28661
28662 #. type: textblock
28663 #: ../tools/virt-edit.pl:115
28664 msgid "By default, no backup file is made."
28665 msgstr ""
28666
28667 #. type: =item
28668 #: ../tools/virt-edit.pl:121 ../tools/virt-win-reg.pl:128 ../tools/virt-list-filesystems.pl:77 ../tools/virt-tar.pl:127 ../tools/virt-list-partitions.pl:78
28669 msgid "B<--connect URI> | B<-c URI>"
28670 msgstr ""
28671
28672 #. type: textblock
28673 #: ../tools/virt-edit.pl:123 ../tools/virt-win-reg.pl:130 ../tools/virt-list-filesystems.pl:79 ../tools/virt-tar.pl:129 ../tools/virt-list-partitions.pl:80
28674 msgid ""
28675 "If using libvirt, connect to the given I<URI>.  If omitted, then we connect "
28676 "to the default libvirt hypervisor."
28677 msgstr ""
28678
28679 #. type: textblock
28680 #: ../tools/virt-edit.pl:126 ../tools/virt-win-reg.pl:133 ../tools/virt-list-filesystems.pl:82 ../tools/virt-tar.pl:132 ../tools/virt-list-partitions.pl:83
28681 msgid ""
28682 "If you specify guest block devices directly, then libvirt is not used at "
28683 "all."
28684 msgstr ""
28685
28686 #. type: =item
28687 #: ../tools/virt-edit.pl:133 ../tools/virt-win-reg.pl:140 ../tools/virt-list-filesystems.pl:89 ../tools/virt-tar.pl:139 ../tools/virt-list-partitions.pl:90
28688 msgid "B<--format> raw"
28689 msgstr ""
28690
28691 #. type: textblock
28692 #: ../tools/virt-edit.pl:135 ../tools/virt-win-reg.pl:142 ../tools/virt-list-filesystems.pl:91 ../tools/virt-tar.pl:141 ../tools/virt-list-partitions.pl:92
28693 msgid ""
28694 "Specify the format of disk images given on the command line.  If this is "
28695 "omitted then the format is autodetected from the content of the disk image."
28696 msgstr ""
28697
28698 #. type: textblock
28699 #: ../tools/virt-edit.pl:139 ../tools/virt-win-reg.pl:146 ../tools/virt-list-filesystems.pl:95 ../tools/virt-tar.pl:145 ../tools/virt-list-partitions.pl:96
28700 msgid ""
28701 "If disk images are requested from libvirt, then this program asks libvirt "
28702 "for this information.  In this case, the value of the format parameter is "
28703 "ignored."
28704 msgstr ""
28705
28706 #. type: textblock
28707 #: ../tools/virt-edit.pl:143 ../tools/virt-win-reg.pl:150 ../tools/virt-list-filesystems.pl:99 ../tools/virt-tar.pl:149 ../tools/virt-list-partitions.pl:100
28708 msgid ""
28709 "If working with untrusted raw-format guest disk images, you should ensure "
28710 "the format is always specified."
28711 msgstr ""
28712
28713 #. type: =item
28714 #: ../tools/virt-edit.pl:150
28715 msgid "B<--expr EXPR> | B<-e EXPR>"
28716 msgstr ""
28717
28718 #. type: textblock
28719 #: ../tools/virt-edit.pl:152
28720 msgid ""
28721 "Instead of launching the external editor, non-interactively apply the Perl "
28722 "expression C<EXPR> to each line in the file.  See L</NON-INTERACTIVE "
28723 "EDITING> below."
28724 msgstr ""
28725
28726 #. type: textblock
28727 #: ../tools/virt-edit.pl:156
28728 msgid ""
28729 "Be careful to properly quote the expression to prevent it from being altered "
28730 "by the shell."
28731 msgstr ""
28732
28733 #. type: =head1
28734 #: ../tools/virt-edit.pl:280
28735 msgid "NON-INTERACTIVE EDITING"
28736 msgstr ""
28737
28738 #. type: textblock
28739 #: ../tools/virt-edit.pl:282
28740 msgid ""
28741 "C<virt-edit> normally calls out to C<$EDITOR> (or vi) so the system "
28742 "administrator can interactively edit the file."
28743 msgstr ""
28744
28745 #. type: textblock
28746 #: ../tools/virt-edit.pl:285
28747 msgid ""
28748 "There are two ways also to use C<virt-edit> from scripts in order to make "
28749 "automated edits to files.  (Note that although you I<can> use C<virt-edit> "
28750 "like this, it's less error-prone to write scripts directly using the "
28751 "libguestfs API and Augeas for configuration file editing.)"
28752 msgstr ""
28753
28754 #. type: textblock
28755 #: ../tools/virt-edit.pl:291
28756 msgid ""
28757 "The first method is to temporarily set C<$EDITOR> to any script or program "
28758 "you want to run.  The script is invoked as C<$EDITOR tmpfile> and it should "
28759 "update C<tmpfile> in place however it likes."
28760 msgstr ""
28761
28762 #. type: textblock
28763 #: ../tools/virt-edit.pl:295
28764 msgid ""
28765 "The second method is to use the I<-e> parameter of C<virt-edit> to run a "
28766 "short Perl snippet in the style of L<sed(1)>.  For example to replace all "
28767 "instances of C<foo> with C<bar> in a file:"
28768 msgstr ""
28769
28770 #. type: verbatim
28771 #: ../tools/virt-edit.pl:299
28772 #, no-wrap
28773 msgid ""
28774 " virt-edit domname filename -e 's/foo/bar/'\n"
28775 "\n"
28776 msgstr ""
28777
28778 #. type: textblock
28779 #: ../tools/virt-edit.pl:301
28780 msgid ""
28781 "The full power of Perl regular expressions can be used (see L<perlre(1)>).  "
28782 "For example to delete root's password you could do:"
28783 msgstr ""
28784
28785 #. type: verbatim
28786 #: ../tools/virt-edit.pl:304
28787 #, no-wrap
28788 msgid ""
28789 " virt-edit domname /etc/passwd -e 's/^root:.*?:/root::/'\n"
28790 "\n"
28791 msgstr ""
28792
28793 #. type: textblock
28794 #: ../tools/virt-edit.pl:306
28795 msgid ""
28796 "What really happens is that the snippet is evaluated as a Perl expression "
28797 "for each line of the file.  The line, including the final C<\\n>, is passed "
28798 "in C<$_> and the expression should update C<$_> or leave it unchanged."
28799 msgstr ""
28800
28801 #. type: textblock
28802 #: ../tools/virt-edit.pl:311
28803 msgid ""
28804 "To delete a line, set C<$_> to the empty string.  For example, to delete the "
28805 "C<apache> user account from the password file you can do:"
28806 msgstr ""
28807
28808 #. type: verbatim
28809 #: ../tools/virt-edit.pl:314
28810 #, no-wrap
28811 msgid ""
28812 " virt-edit mydomain /etc/passwd -e '$_ = \"\" if /^apache:/'\n"
28813 "\n"
28814 msgstr ""
28815
28816 #. type: textblock
28817 #: ../tools/virt-edit.pl:316
28818 msgid ""
28819 "To insert a line, prepend or append it to C<$_>.  However appending lines to "
28820 "the end of the file is rather difficult this way since there is no concept "
28821 "of \"last line of the file\" - your expression just doesn't get called "
28822 "again.  You might want to use the first method (setting C<$EDITOR>) if you "
28823 "want to do this."
28824 msgstr ""
28825
28826 #. type: textblock
28827 #: ../tools/virt-edit.pl:322
28828 msgid ""
28829 "The variable C<$lineno> contains the current line number.  As is "
28830 "traditional, the first line in the file is number C<1>."
28831 msgstr ""
28832
28833 #. type: textblock
28834 #: ../tools/virt-edit.pl:325
28835 msgid ""
28836 "The return value from the expression is ignored, but the expression may call "
28837 "C<die> in order to abort the whole program, leaving the original file "
28838 "untouched."
28839 msgstr ""
28840
28841 #. type: textblock
28842 #: ../tools/virt-edit.pl:329
28843 msgid ""
28844 "Remember when matching the end of a line that C<$_> may contain the final "
28845 "C<\\n>, or (for DOS files) C<\\r\\n>, or if the file does not end with a "
28846 "newline then neither of these.  Thus to match or substitute some text at the "
28847 "end of a line, use this regular expression:"
28848 msgstr ""
28849
28850 #. type: verbatim
28851 #: ../tools/virt-edit.pl:334
28852 #, no-wrap
28853 msgid ""
28854 " /some text(\\r?\\n)?$/\n"
28855 "\n"
28856 msgstr ""
28857
28858 #. type: textblock
28859 #: ../tools/virt-edit.pl:336
28860 msgid ""
28861 "Alternately, use the perl C<chomp> function, being careful not to chomp "
28862 "C<$_> itself (since that would remove all newlines from the file):"
28863 msgstr ""
28864
28865 #. type: verbatim
28866 #: ../tools/virt-edit.pl:340
28867 #, no-wrap
28868 msgid ""
28869 " my $m = $_; chomp $m; $m =~ /some text$/\n"
28870 "\n"
28871 msgstr ""
28872
28873 #. type: textblock
28874 #: ../tools/virt-edit.pl:344
28875 msgid ""
28876 "C<virt-edit> has a limited ability to understand Windows drive letters and "
28877 "paths (eg. C<E:\\foo\\bar.txt>)."
28878 msgstr ""
28879
28880 #. type: textblock
28881 #: ../tools/virt-edit.pl:347
28882 msgid "If and only if the guest is running Windows then:"
28883 msgstr ""
28884
28885 #. type: textblock
28886 #: ../tools/virt-edit.pl:353
28887 msgid ""
28888 "Drive letter prefixes like C<C:> are resolved against the Windows Registry "
28889 "to the correct filesystem."
28890 msgstr ""
28891
28892 #. type: textblock
28893 #: ../tools/virt-edit.pl:358
28894 msgid ""
28895 "Any backslash (C<\\>) characters in the path are replaced with forward "
28896 "slashes so that libguestfs can process it."
28897 msgstr ""
28898
28899 #. type: textblock
28900 #: ../tools/virt-edit.pl:363
28901 msgid ""
28902 "The path is resolved case insensitively to locate the file that should be "
28903 "edited."
28904 msgstr ""
28905
28906 #. type: textblock
28907 #: ../tools/virt-edit.pl:368
28908 msgid "There are some known shortcomings:"
28909 msgstr ""
28910
28911 #. type: textblock
28912 #: ../tools/virt-edit.pl:374
28913 msgid "Some NTFS symbolic links may not be followed correctly."
28914 msgstr ""
28915
28916 #. type: textblock
28917 #: ../tools/virt-edit.pl:378
28918 msgid "NTFS junction points that cross filesystems are not followed."
28919 msgstr ""
28920
28921 #. type: =head1
28922 #: ../tools/virt-edit.pl:435
28923 msgid "USING GUESTFISH"
28924 msgstr ""
28925
28926 #. type: textblock
28927 #: ../tools/virt-edit.pl:437
28928 msgid ""
28929 "L<guestfish(1)> is a more powerful, lower level tool which you can use when "
28930 "C<virt-edit> doesn't work."
28931 msgstr ""
28932
28933 #. type: textblock
28934 #: ../tools/virt-edit.pl:440
28935 msgid "Using C<virt-edit> is approximately equivalent to doing:"
28936 msgstr ""
28937
28938 #. type: verbatim
28939 #: ../tools/virt-edit.pl:442
28940 #, no-wrap
28941 msgid ""
28942 " guestfish --rw -i -d domname edit /file\n"
28943 "\n"
28944 msgstr ""
28945
28946 #. type: textblock
28947 #: ../tools/virt-edit.pl:444
28948 msgid ""
28949 "where C<domname> is the name of the libvirt guest, and C</file> is the full "
28950 "path to the file."
28951 msgstr ""
28952
28953 #. type: textblock
28954 #: ../tools/virt-edit.pl:447
28955 msgid ""
28956 "The command above uses libguestfs's guest inspection feature and so does not "
28957 "work on guests that libguestfs cannot inspect, or on things like arbitrary "
28958 "disk images that don't contain guests.  To edit a file on a disk image "
28959 "directly, use:"
28960 msgstr ""
28961
28962 #. type: verbatim
28963 #: ../tools/virt-edit.pl:452
28964 #, no-wrap
28965 msgid ""
28966 " guestfish --rw -a disk.img -m /dev/sda1 edit /file\n"
28967 "\n"
28968 msgstr ""
28969
28970 #. type: textblock
28971 #: ../tools/virt-edit.pl:454
28972 msgid ""
28973 "where C<disk.img> is the disk image, C</dev/sda1> is the filesystem within "
28974 "the disk image to edit, and C</file> is the full path to the file."
28975 msgstr ""
28976
28977 #. type: textblock
28978 #: ../tools/virt-edit.pl:458
28979 msgid ""
28980 "C<virt-edit> cannot create new files.  Use the guestfish commands C<touch>, "
28981 "C<write> or C<upload> instead:"
28982 msgstr ""
28983
28984 #. type: verbatim
28985 #: ../tools/virt-edit.pl:461
28986 #, no-wrap
28987 msgid ""
28988 " guestfish --rw -i -d domname touch /newfile\n"
28989 "\n"
28990 msgstr ""
28991
28992 #. type: verbatim
28993 #: ../tools/virt-edit.pl:463
28994 #, no-wrap
28995 msgid ""
28996 " guestfish --rw -i -d domname write /newfile \"new content\"\n"
28997 "\n"
28998 msgstr ""
28999
29000 #. type: verbatim
29001 #: ../tools/virt-edit.pl:465
29002 #, no-wrap
29003 msgid ""
29004 " guestfish --rw -i -d domname upload localfile /newfile\n"
29005 "\n"
29006 msgstr ""
29007
29008 #. type: textblock
29009 #: ../tools/virt-edit.pl:467
29010 msgid "C<virt-edit> cannot edit multiple files, but guestfish can do it like this:"
29011 msgstr ""
29012
29013 #. type: verbatim
29014 #: ../tools/virt-edit.pl:470
29015 #, no-wrap
29016 msgid ""
29017 " guestfish --rw -i -d domname edit /file1 : edit /file2\n"
29018 "\n"
29019 msgstr ""
29020
29021 #. type: =item
29022 #: ../tools/virt-edit.pl:480
29023 msgid "C<EDITOR>"
29024 msgstr ""
29025
29026 #. type: textblock
29027 #: ../tools/virt-edit.pl:482
29028 msgid ""
29029 "If set, this string is used as the editor.  It may contain arguments, "
29030 "eg. C<\"emacs -nw\">"
29031 msgstr ""
29032
29033 #. type: textblock
29034 #: ../tools/virt-edit.pl:485
29035 msgid "If not set, C<vi> is used."
29036 msgstr ""
29037
29038 #. type: =head1
29039 #: ../tools/virt-edit.pl:489 ../tools/virt-win-reg.pl:559 ../tools/virt-list-filesystems.pl:182 ../tools/virt-tar.pl:279 ../tools/virt-make-fs.pl:532 ../tools/virt-list-partitions.pl:250
29040 msgid "SHELL QUOTING"
29041 msgstr ""
29042
29043 #. type: textblock
29044 #: ../tools/virt-edit.pl:491 ../tools/virt-win-reg.pl:567 ../tools/virt-list-filesystems.pl:184 ../tools/virt-tar.pl:281 ../tools/virt-make-fs.pl:534 ../tools/virt-list-partitions.pl:252
29045 msgid ""
29046 "Libvirt guest names can contain arbitrary characters, some of which have "
29047 "meaning to the shell such as C<#> and space.  You may need to quote or "
29048 "escape these characters on the command line.  See the shell manual page "
29049 "L<sh(1)> for details."
29050 msgstr ""
29051
29052 #. type: textblock
29053 #: ../tools/virt-edit.pl:498
29054 msgid ""
29055 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-copy-in(1)>, "
29056 "L<virt-tar-in(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, "
29057 "L<Sys::Virt(3)>, L<http://libguestfs.org/>, L<perl(1)>, L<perlre(1)>."
29058 msgstr ""
29059
29060 #. type: =head1
29061 #: ../tools/virt-edit.pl:510 ../tools/virt-win-reg.pl:598 ../tools/virt-list-filesystems.pl:202 ../tools/virt-tar.pl:301 ../tools/virt-make-fs.pl:564 ../tools/virt-list-partitions.pl:269
29062 msgid "AUTHOR"
29063 msgstr ""
29064
29065 #. type: textblock
29066 #: ../tools/virt-edit.pl:512 ../tools/virt-win-reg.pl:600 ../tools/virt-list-filesystems.pl:204 ../tools/virt-tar.pl:303 ../tools/virt-make-fs.pl:566 ../tools/virt-list-partitions.pl:271
29067 msgid "Richard W.M. Jones L<http://people.redhat.com/~rjones/>"
29068 msgstr ""
29069
29070 #. type: textblock
29071 #: ../tools/virt-edit.pl:516
29072 msgid "Copyright (C) 2009-2011 Red Hat Inc."
29073 msgstr ""
29074
29075 #. type: textblock
29076 #: ../tools/virt-win-reg.pl:37
29077 msgid ""
29078 "virt-win-reg - Export and merge Windows Registry entries from a Windows "
29079 "guest"
29080 msgstr ""
29081
29082 #. type: verbatim
29083 #: ../tools/virt-win-reg.pl:41
29084 #, no-wrap
29085 msgid ""
29086 " virt-win-reg domname 'HKLM\\Path\\To\\Subkey'\n"
29087 "\n"
29088 msgstr ""
29089
29090 #. type: verbatim
29091 #: ../tools/virt-win-reg.pl:43
29092 #, no-wrap
29093 msgid ""
29094 " virt-win-reg domname 'HKLM\\Path\\To\\Subkey' name\n"
29095 "\n"
29096 msgstr ""
29097
29098 #. type: verbatim
29099 #: ../tools/virt-win-reg.pl:45
29100 #, no-wrap
29101 msgid ""
29102 " virt-win-reg domname 'HKLM\\Path\\To\\Subkey' @\n"
29103 "\n"
29104 msgstr ""
29105
29106 #. type: verbatim
29107 #: ../tools/virt-win-reg.pl:47
29108 #, no-wrap
29109 msgid ""
29110 " virt-win-reg --merge domname [input.reg ...]\n"
29111 "\n"
29112 msgstr ""
29113
29114 #. type: verbatim
29115 #: ../tools/virt-win-reg.pl:49
29116 #, no-wrap
29117 msgid ""
29118 " virt-win-reg [--options] disk.img ... # instead of domname\n"
29119 "\n"
29120 msgstr ""
29121
29122 #. type: textblock
29123 #: ../tools/virt-win-reg.pl:53
29124 msgid ""
29125 "You must I<not> use C<virt-win-reg> with the I<--merge> option on live "
29126 "virtual machines.  If you do this, you I<will> get irreversible disk "
29127 "corruption in the VM.  C<virt-win-reg> tries to stop you from doing this, "
29128 "but doesn't catch all cases."
29129 msgstr ""
29130
29131 #. type: textblock
29132 #: ../tools/virt-win-reg.pl:58
29133 msgid ""
29134 "Modifying the Windows Registry is an inherently risky operation.  The format "
29135 "is deliberately obscure and undocumented, and Registry changes can leave the "
29136 "system unbootable.  Therefore when using the I<--merge> option, make sure "
29137 "you have a reliable backup first."
29138 msgstr ""
29139
29140 #. type: textblock
29141 #: ../tools/virt-win-reg.pl:65
29142 msgid ""
29143 "This program can export and merge Windows Registry entries from a Windows "
29144 "guest."
29145 msgstr ""
29146
29147 #. type: textblock
29148 #: ../tools/virt-win-reg.pl:68
29149 msgid ""
29150 "The first parameter is the libvirt guest name or the raw disk image of a "
29151 "Windows guest."
29152 msgstr ""
29153
29154 #. type: textblock
29155 #: ../tools/virt-win-reg.pl:71
29156 msgid ""
29157 "If I<--merge> is I<not> specified, then the chosen registry key is "
29158 "displayed/exported (recursively).  For example:"
29159 msgstr ""
29160
29161 #. type: verbatim
29162 #: ../tools/virt-win-reg.pl:74
29163 #, no-wrap
29164 msgid ""
29165 " $ virt-win-reg Windows7 'HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft'\n"
29166 "\n"
29167 msgstr ""
29168
29169 #. type: textblock
29170 #: ../tools/virt-win-reg.pl:76
29171 msgid "You can also display single values from within registry keys, for example:"
29172 msgstr ""
29173
29174 #. type: verbatim
29175 #: ../tools/virt-win-reg.pl:79
29176 #, no-wrap
29177 msgid ""
29178 " $ cvkey='HKLM\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion'\n"
29179 " $ virt-win-reg Windows7 $cvkey ProductName\n"
29180 " Windows 7 Enterprise\n"
29181 "\n"
29182 msgstr ""
29183
29184 #. type: textblock
29185 #: ../tools/virt-win-reg.pl:83
29186 msgid ""
29187 "With I<--merge>, you can merge a textual regedit file into the Windows "
29188 "Registry:"
29189 msgstr ""
29190
29191 #. type: verbatim
29192 #: ../tools/virt-win-reg.pl:86
29193 #, no-wrap
29194 msgid ""
29195 " $ virt-win-reg --merge Windows7 changes.reg\n"
29196 "\n"
29197 msgstr ""
29198
29199 #. type: =head1
29200 #: ../tools/virt-win-reg.pl:88 ../tools/virt-tar.pl:45
29201 msgid "NOTE"
29202 msgstr ""
29203
29204 #. type: textblock
29205 #: ../tools/virt-win-reg.pl:90
29206 msgid ""
29207 "This program is only meant for simple access to the registry.  If you want "
29208 "to do complicated things with the registry, we suggest you download the "
29209 "Registry hive files from the guest using L<libguestfs(3)> or L<guestfish(1)> "
29210 "and access them locally, eg. using L<hivex(3)>, L<hivexsh(1)> or "
29211 "L<hivexregedit(1)>."
29212 msgstr ""
29213
29214 #. type: =item
29215 #: ../tools/virt-win-reg.pl:120 ../tools/virt-make-fs.pl:177
29216 msgid "B<--debug>"
29217 msgstr ""
29218
29219 #. type: textblock
29220 #: ../tools/virt-win-reg.pl:122
29221 msgid "Enable debugging messages."
29222 msgstr ""
29223
29224 #. type: =item
29225 #: ../tools/virt-win-reg.pl:157
29226 msgid "B<--merge>"
29227 msgstr ""
29228
29229 #. type: textblock
29230 #: ../tools/virt-win-reg.pl:159
29231 msgid ""
29232 "In merge mode, this merges a textual regedit file into the Windows Registry "
29233 "of the virtual machine.  If this flag is I<not> given then virt-win-reg "
29234 "displays or exports Registry entries instead."
29235 msgstr ""
29236
29237 #. type: textblock
29238 #: ../tools/virt-win-reg.pl:163
29239 msgid ""
29240 "Note that I<--merge> is I<unsafe> to use on live virtual machines, and will "
29241 "result in disk corruption.  However exporting (without this flag)  is always "
29242 "safe."
29243 msgstr ""
29244
29245 #. type: =item
29246 #: ../tools/virt-win-reg.pl:171
29247 msgid "B<--encoding> UTF-16LE|ASCII"
29248 msgstr ""
29249
29250 #. type: textblock
29251 #: ../tools/virt-win-reg.pl:173
29252 msgid ""
29253 "When merging (only), you may need to specify the encoding for strings to be "
29254 "used in the hive file.  This is explained in detail in "
29255 "L<Win::Hivex::Regedit(3)/ENCODING STRINGS>."
29256 msgstr ""
29257
29258 #. type: textblock
29259 #: ../tools/virt-win-reg.pl:177
29260 msgid ""
29261 "The default is to use UTF-16LE, which should work with recent versions of "
29262 "Windows."
29263 msgstr ""
29264
29265 #. type: =head1
29266 #: ../tools/virt-win-reg.pl:402
29267 msgid "SUPPORTED SYSTEMS"
29268 msgstr ""
29269
29270 #. type: textblock
29271 #: ../tools/virt-win-reg.pl:404
29272 msgid ""
29273 "The program currently supports Windows NT-derived guests starting with "
29274 "Windows XP through to at least Windows 7."
29275 msgstr ""
29276
29277 #. type: textblock
29278 #: ../tools/virt-win-reg.pl:407
29279 msgid ""
29280 "Registry support is done for C<HKEY_LOCAL_MACHINE\\SAM>, "
29281 "C<HKEY_LOCAL_MACHINE\\SECURITY>, C<HKEY_LOCAL_MACHINE\\SOFTWARE>, "
29282 "C<HKEY_LOCAL_MACHINE\\SYSTEM> and C<HKEY_USERS\\.DEFAULT>."
29283 msgstr ""
29284
29285 #. type: textblock
29286 #: ../tools/virt-win-reg.pl:411
29287 msgid ""
29288 "You can use C<HKLM> as a shorthand for C<HKEY_LOCAL_MACHINE>, and C<HKU> for "
29289 "C<HKEY_USERS>."
29290 msgstr ""
29291
29292 #. type: textblock
29293 #: ../tools/virt-win-reg.pl:414
29294 msgid ""
29295 "C<HKEY_USERS\\$SID> and C<HKEY_CURRENT_USER> are B<not> supported at this "
29296 "time."
29297 msgstr ""
29298
29299 #. type: =head1
29300 #: ../tools/virt-win-reg.pl:417
29301 msgid "ENCODING"
29302 msgstr ""
29303
29304 #. type: textblock
29305 #: ../tools/virt-win-reg.pl:419
29306 msgid ""
29307 "C<virt-win-reg> expects that regedit files have already been reencoded in "
29308 "the local encoding.  Usually on Linux hosts, this means UTF-8 with "
29309 "Unix-style line endings.  Since Windows regedit files are often in UTF-16LE "
29310 "with Windows-style line endings, you may need to reencode the whole file "
29311 "before or after processing."
29312 msgstr ""
29313
29314 #. type: textblock
29315 #: ../tools/virt-win-reg.pl:425
29316 msgid ""
29317 "To reencode a file from Windows format to Linux (before processing it with "
29318 "the I<--merge> option), you would do something like this:"
29319 msgstr ""
29320
29321 #. type: verbatim
29322 #: ../tools/virt-win-reg.pl:428
29323 #, no-wrap
29324 msgid ""
29325 " iconv -f utf-16le -t utf-8 < win.reg | dos2unix > linux.reg\n"
29326 "\n"
29327 msgstr ""
29328
29329 #. type: textblock
29330 #: ../tools/virt-win-reg.pl:430
29331 msgid ""
29332 "To go in the opposite direction, after exporting and before sending the file "
29333 "to a Windows user, do something like this:"
29334 msgstr ""
29335
29336 #. type: verbatim
29337 #: ../tools/virt-win-reg.pl:433
29338 #, no-wrap
29339 msgid ""
29340 " unix2dos linux.reg | iconv -f utf-8 -t utf-16le > win.reg\n"
29341 "\n"
29342 msgstr ""
29343
29344 #. type: textblock
29345 #: ../tools/virt-win-reg.pl:435
29346 msgid "For more information about encoding, see L<Win::Hivex::Regedit(3)>."
29347 msgstr ""
29348
29349 #. type: textblock
29350 #: ../tools/virt-win-reg.pl:437
29351 msgid ""
29352 "If you are unsure about the current encoding, use the L<file(1)> command.  "
29353 "Recent versions of Windows regedit.exe produce a UTF-16LE file with "
29354 "Windows-style (CRLF) line endings, like this:"
29355 msgstr ""
29356
29357 #. type: verbatim
29358 #: ../tools/virt-win-reg.pl:441
29359 #, no-wrap
29360 msgid ""
29361 " $ file software.reg\n"
29362 " software.reg: Little-endian UTF-16 Unicode text, with very long lines,\n"
29363 " with CRLF line terminators\n"
29364 "\n"
29365 msgstr ""
29366
29367 #. type: textblock
29368 #: ../tools/virt-win-reg.pl:445
29369 msgid "This file would need conversion before you could I<--merge> it."
29370 msgstr ""
29371
29372 #. type: =head1
29373 #: ../tools/virt-win-reg.pl:447
29374 msgid "CurrentControlSet etc."
29375 msgstr ""
29376
29377 #. type: textblock
29378 #: ../tools/virt-win-reg.pl:449
29379 msgid ""
29380 "Registry keys like C<CurrentControlSet> don't really exist in the Windows "
29381 "Registry at the level of the hive file, and therefore you cannot modify "
29382 "these."
29383 msgstr ""
29384
29385 #. type: textblock
29386 #: ../tools/virt-win-reg.pl:453
29387 msgid ""
29388 "C<CurrentControlSet> is usually an alias for C<ControlSet001>.  In some "
29389 "circumstances it might refer to another control set.  The way to find out is "
29390 "to look at the C<HKLM\\SYSTEM\\Select> key:"
29391 msgstr ""
29392
29393 #. type: verbatim
29394 #: ../tools/virt-win-reg.pl:457
29395 #, no-wrap
29396 msgid ""
29397 " # virt-win-reg WindowsGuest 'HKLM\\SYSTEM\\Select'\n"
29398 " [HKEY_LOCAL_MACHINE\\SYSTEM\\Select]\n"
29399 " \"Current\"=dword:00000001\n"
29400 " \"Default\"=dword:00000001\n"
29401 " \"Failed\"=dword:00000000\n"
29402 " \"LastKnownGood\"=dword:00000002\n"
29403 "\n"
29404 msgstr ""
29405
29406 #. type: textblock
29407 #: ../tools/virt-win-reg.pl:464
29408 msgid "\"Current\" is the one which Windows will choose when it boots."
29409 msgstr ""
29410
29411 #. type: textblock
29412 #: ../tools/virt-win-reg.pl:466
29413 msgid "Similarly, other C<Current...> keys in the path may need to be replaced."
29414 msgstr ""
29415
29416 #. type: =head1
29417 #: ../tools/virt-win-reg.pl:469
29418 msgid "WINDOWS TIPS"
29419 msgstr ""
29420
29421 #. type: textblock
29422 #: ../tools/virt-win-reg.pl:471
29423 msgid ""
29424 "Note that some of these tips modify the guest disk image.  The guest I<must> "
29425 "be shut off, else you will get disk corruption."
29426 msgstr ""
29427
29428 #. type: =head2
29429 #: ../tools/virt-win-reg.pl:474
29430 msgid "RUNNING A BATCH SCRIPT WHEN A USER LOGS IN"
29431 msgstr ""
29432
29433 #. type: textblock
29434 #: ../tools/virt-win-reg.pl:476
29435 msgid ""
29436 "Prepare a DOS batch script, VBScript or executable.  Upload this using "
29437 "L<guestfish(1)>.  For this example the script is called C<test.bat> and it "
29438 "is uploaded into C<C:\\>:"
29439 msgstr ""
29440
29441 #. type: verbatim
29442 #: ../tools/virt-win-reg.pl:480
29443 #, no-wrap
29444 msgid ""
29445 " guestfish -i -d WindowsGuest upload test.bat /test.bat\n"
29446 "\n"
29447 msgstr ""
29448
29449 #. type: textblock
29450 #: ../tools/virt-win-reg.pl:482
29451 msgid "Prepare a regedit file containing the registry change:"
29452 msgstr ""
29453
29454 #. type: verbatim
29455 #: ../tools/virt-win-reg.pl:484
29456 #, no-wrap
29457 msgid ""
29458 " cat > test.reg <<'EOF'\n"
29459 " [HKLM\\Software\\Microsoft\\Windows\\CurrentVersion\\RunOnce]\n"
29460 " \"Test\"=\"c:\\\\test.bat\"\n"
29461 " EOF\n"
29462 "\n"
29463 msgstr ""
29464
29465 #. type: textblock
29466 #: ../tools/virt-win-reg.pl:489
29467 msgid ""
29468 "In this example we use the key C<RunOnce> which means that the script will "
29469 "run precisely once when the first user logs in.  If you want it to run every "
29470 "time a user logs in, replace C<RunOnce> with C<Run>."
29471 msgstr ""
29472
29473 #. type: textblock
29474 #: ../tools/virt-win-reg.pl:493
29475 msgid "Now update the registry:"
29476 msgstr ""
29477
29478 #. type: verbatim
29479 #: ../tools/virt-win-reg.pl:495
29480 #, no-wrap
29481 msgid ""
29482 " virt-win-reg --merge WindowsGuest test.reg\n"
29483 "\n"
29484 msgstr ""
29485
29486 #. type: =head2
29487 #: ../tools/virt-win-reg.pl:497
29488 msgid "INSTALLING A SERVICE"
29489 msgstr ""
29490
29491 #. type: textblock
29492 #: ../tools/virt-win-reg.pl:499
29493 msgid ""
29494 "This section assumes you are familiar with Windows services, and you either "
29495 "have a program which handles the Windows Service Control Protocol directly "
29496 "or you want to run any program using a service wrapper like SrvAny or the "
29497 "free RHSrvAny."
29498 msgstr ""
29499
29500 #. type: textblock
29501 #: ../tools/virt-win-reg.pl:504
29502 msgid ""
29503 "First upload the program and optionally the service wrapper.  In this case "
29504 "the test program is called C<test.exe> and we are using the RHSrvAny "
29505 "wrapper:"
29506 msgstr ""
29507
29508 #. type: verbatim
29509 #: ../tools/virt-win-reg.pl:508
29510 #, no-wrap
29511 msgid ""
29512 " guestfish -i -d WindowsGuest <<EOF\n"
29513 "   upload rhsrvany.exe /rhsrvany.exe\n"
29514 "   upload test.exe /test.exe\n"
29515 " EOF\n"
29516 "\n"
29517 msgstr ""
29518
29519 #. type: textblock
29520 #: ../tools/virt-win-reg.pl:513
29521 msgid ""
29522 "Prepare a regedit file containing the registry changes.  In this example, "
29523 "the first registry change is needed for the service itself or the service "
29524 "wrapper (if used).  The second registry change is only needed because I am "
29525 "using the RHSrvAny service wrapper."
29526 msgstr ""
29527
29528 #. type: verbatim
29529 #: ../tools/virt-win-reg.pl:518
29530 #, no-wrap
29531 msgid ""
29532 " cat > service.reg <<'EOF'\n"
29533 " [HKLM\\SYSTEM\\ControlSet001\\services\\RHSrvAny]\n"
29534 " \"Type\"=dword:00000010\n"
29535 " \"Start\"=dword:00000002\n"
29536 " \"ErrorControl\"=dword:00000001\n"
29537 " \"ImagePath\"=\"c:\\\\rhsrvany.exe\"\n"
29538 " \"DisplayName\"=\"RHSrvAny\"\n"
29539 " \"ObjectName\"=\"NetworkService\"\n"
29540 " \n"
29541 msgstr ""
29542
29543 #. type: verbatim
29544 #: ../tools/virt-win-reg.pl:527
29545 #, no-wrap
29546 msgid ""
29547 " [HKLM\\SYSTEM\\ControlSet001\\services\\RHSrvAny\\Parameters]\n"
29548 " \"CommandLine\"=\"c:\\\\test.exe\"\n"
29549 " \"PWD\"=\"c:\\\\Temp\"\n"
29550 " EOF\n"
29551 "\n"
29552 msgstr ""
29553
29554 #. type: textblock
29555 #: ../tools/virt-win-reg.pl:538
29556 msgid ""
29557 "For use of C<ControlSet001> see the section above in this manual page.  You "
29558 "may need to adjust this according to the control set that is in use by the "
29559 "guest."
29560 msgstr ""
29561
29562 #. type: textblock
29563 #: ../tools/virt-win-reg.pl:544
29564 msgid ""
29565 "C<\"ObjectName\"> controls the privileges that the service will have.  An "
29566 "alternative is C<\"ObjectName\"=\"LocalSystem\"> which would be the most "
29567 "privileged account."
29568 msgstr ""
29569
29570 #. type: textblock
29571 #: ../tools/virt-win-reg.pl:550
29572 msgid ""
29573 "For the meaning of the magic numbers, see this Microsoft KB article: "
29574 "L<http://support.microsoft.com/kb/103000>."
29575 msgstr ""
29576
29577 #. type: textblock
29578 #: ../tools/virt-win-reg.pl:555
29579 msgid "Update the registry:"
29580 msgstr ""
29581
29582 #. type: verbatim
29583 #: ../tools/virt-win-reg.pl:557
29584 #, no-wrap
29585 msgid ""
29586 " virt-win-reg --merge WindowsGuest service.reg\n"
29587 "\n"
29588 msgstr ""
29589
29590 #. type: textblock
29591 #: ../tools/virt-win-reg.pl:561
29592 msgid ""
29593 "Be careful when passing parameters containing C<\\> (backslash) in the "
29594 "shell.  Usually you will have to use 'single quotes' or double backslashes "
29595 "(but not both) to protect them from the shell."
29596 msgstr ""
29597
29598 #. type: textblock
29599 #: ../tools/virt-win-reg.pl:565
29600 msgid "Paths and value names are case-insensitive."
29601 msgstr ""
29602
29603 #. type: textblock
29604 #: ../tools/virt-win-reg.pl:574
29605 msgid ""
29606 "L<hivex(3)>, L<hivexsh(1)>, L<hivexregedit(1)>, L<guestfs(3)>, "
29607 "L<guestfish(1)>, L<virt-cat(1)>, L<Sys::Guestfs(3)>, "
29608 "L<Sys::Guestfs::Lib(3)>, L<Win::Hivex(3)>, L<Win::Hivex::Regedit(3)>, "
29609 "L<Sys::Virt(3)>, L<http://libguestfs.org/>."
29610 msgstr ""
29611
29612 #. type: textblock
29613 #: ../tools/virt-win-reg.pl:589 ../tools/virt-make-fs.pl:555
29614 msgid ""
29615 "When reporting bugs, please enable debugging and capture the I<complete> "
29616 "output:"
29617 msgstr ""
29618
29619 #. type: verbatim
29620 #: ../tools/virt-win-reg.pl:592
29621 #, no-wrap
29622 msgid ""
29623 " export LIBGUESTFS_DEBUG=1\n"
29624 " virt-win-reg --debug [... rest ...] > /tmp/virt-win-reg.log 2>&1\n"
29625 "\n"
29626 msgstr ""
29627
29628 #. type: textblock
29629 #: ../tools/virt-win-reg.pl:595
29630 msgid ""
29631 "Attach /tmp/virt-win-reg.log to a new bug report at "
29632 "L<https://bugzilla.redhat.com/>"
29633 msgstr ""
29634
29635 #. type: textblock
29636 #: ../tools/virt-win-reg.pl:604 ../tools/virt-make-fs.pl:570
29637 msgid "Copyright (C) 2010 Red Hat Inc."
29638 msgstr ""
29639
29640 #. type: textblock
29641 #: ../tools/virt-list-filesystems.pl:32
29642 msgid "virt-list-filesystems - List filesystems in a virtual machine or disk image"
29643 msgstr ""
29644
29645 #. type: verbatim
29646 #: ../tools/virt-list-filesystems.pl:36
29647 #, no-wrap
29648 msgid ""
29649 " virt-list-filesystems [--options] domname\n"
29650 "\n"
29651 msgstr ""
29652
29653 #. type: verbatim
29654 #: ../tools/virt-list-filesystems.pl:38
29655 #, no-wrap
29656 msgid ""
29657 " virt-list-filesystems [--options] disk.img [disk.img ...]\n"
29658 "\n"
29659 msgstr ""
29660
29661 #. type: textblock
29662 #: ../tools/virt-list-filesystems.pl:42 ../tools/virt-list-partitions.pl:42
29663 msgid ""
29664 "This tool is obsolete.  Use L<virt-filesystems(1)> as a more flexible "
29665 "replacement."
29666 msgstr ""
29667
29668 #. type: textblock
29669 #: ../tools/virt-list-filesystems.pl:45
29670 msgid ""
29671 "C<virt-list-filesystems> is a command line tool to list the filesystems that "
29672 "are contained in a virtual machine or disk image."
29673 msgstr ""
29674
29675 #. type: textblock
29676 #: ../tools/virt-list-filesystems.pl:49
29677 msgid ""
29678 "C<virt-list-filesystems> is just a simple wrapper around L<libguestfs(3)> "
29679 "functionality.  For more complex cases you should look at the "
29680 "L<guestfish(1)> tool."
29681 msgstr ""
29682
29683 #. type: =item
29684 #: ../tools/virt-list-filesystems.pl:106 ../tools/virt-list-partitions.pl:115
29685 msgid "B<-l> | B<--long>"
29686 msgstr ""
29687
29688 #. type: textblock
29689 #: ../tools/virt-list-filesystems.pl:108
29690 msgid ""
29691 "With this option, C<virt-list-filesystems> displays the type of each "
29692 "filesystem too (where \"type\" means C<ext3>, C<xfs> etc.)"
29693 msgstr ""
29694
29695 #. type: =item
29696 #: ../tools/virt-list-filesystems.pl:115
29697 msgid "B<-a> | B<--all>"
29698 msgstr ""
29699
29700 #. type: textblock
29701 #: ../tools/virt-list-filesystems.pl:117
29702 msgid ""
29703 "Normally we only show mountable filesystems.  If this option is given then "
29704 "swap devices are shown too."
29705 msgstr ""
29706
29707 #. type: textblock
29708 #: ../tools/virt-list-filesystems.pl:191
29709 msgid ""
29710 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-tar(1)>, "
29711 "L<virt-filesystems(1)>, L<virt-list-partitions(1)>, L<Sys::Guestfs(3)>, "
29712 "L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
29713 msgstr ""
29714
29715 #. type: textblock
29716 #: ../tools/virt-list-filesystems.pl:208 ../tools/virt-tar.pl:307
29717 msgid "Copyright (C) 2009 Red Hat Inc."
29718 msgstr ""
29719
29720 #. type: textblock
29721 #: ../tools/virt-tar.pl:33
29722 msgid "virt-tar - Extract or upload files to a virtual machine"
29723 msgstr ""
29724
29725 #. type: verbatim
29726 #: ../tools/virt-tar.pl:37
29727 #, no-wrap
29728 msgid ""
29729 " virt-tar [--options] -x domname directory tarball\n"
29730 "\n"
29731 msgstr ""
29732
29733 #. type: verbatim
29734 #: ../tools/virt-tar.pl:39
29735 #, no-wrap
29736 msgid ""
29737 " virt-tar [--options] -u domname tarball directory\n"
29738 "\n"
29739 msgstr ""
29740
29741 #. type: verbatim
29742 #: ../tools/virt-tar.pl:41
29743 #, no-wrap
29744 msgid ""
29745 " virt-tar [--options] disk.img [disk.img ...] -x directory tarball\n"
29746 "\n"
29747 msgstr ""
29748
29749 #. type: verbatim
29750 #: ../tools/virt-tar.pl:43
29751 #, no-wrap
29752 msgid ""
29753 " virt-tar [--options] disk.img [disk.img ...] -u tarball directory\n"
29754 "\n"
29755 msgstr ""
29756
29757 #. type: textblock
29758 #: ../tools/virt-tar.pl:47
29759 msgid ""
29760 "This tool is obsolete.  Use L<virt-copy-in(1)>, L<virt-copy-out(1)>, "
29761 "L<virt-tar-in(1)>, L<virt-tar-out(1)> as replacements."
29762 msgstr ""
29763
29764 #. type: textblock
29765 #: ../tools/virt-tar.pl:52
29766 msgid "Download C</home> from the VM into a local tarball:"
29767 msgstr ""
29768
29769 #. type: verbatim
29770 #: ../tools/virt-tar.pl:54
29771 #, no-wrap
29772 msgid ""
29773 " virt-tar -x domname /home home.tar\n"
29774 "\n"
29775 msgstr ""
29776
29777 #. type: verbatim
29778 #: ../tools/virt-tar.pl:56
29779 #, no-wrap
29780 msgid ""
29781 " virt-tar -zx domname /home home.tar.gz\n"
29782 "\n"
29783 msgstr ""
29784
29785 #. type: textblock
29786 #: ../tools/virt-tar.pl:58
29787 msgid "Upload a local tarball and unpack it inside C</tmp> in the VM:"
29788 msgstr ""
29789
29790 #. type: verbatim
29791 #: ../tools/virt-tar.pl:60
29792 #, no-wrap
29793 msgid ""
29794 " virt-tar -u domname uploadstuff.tar /tmp\n"
29795 "\n"
29796 msgstr ""
29797
29798 #. type: verbatim
29799 #: ../tools/virt-tar.pl:62
29800 #, no-wrap
29801 msgid ""
29802 " virt-tar -zu domname uploadstuff.tar.gz /tmp\n"
29803 "\n"
29804 msgstr ""
29805
29806 #. type: textblock
29807 #: ../tools/virt-tar.pl:66
29808 msgid ""
29809 "You must I<not> use C<virt-tar> with the I<-u> option (upload) on live "
29810 "virtual machines.  If you do this, you risk disk corruption in the VM.  "
29811 "C<virt-tar> tries to stop you from doing this, but doesn't catch all cases."
29812 msgstr ""
29813
29814 #. type: textblock
29815 #: ../tools/virt-tar.pl:71
29816 msgid ""
29817 "You can use I<-x> (extract) on live virtual machines, but you might get "
29818 "inconsistent results or errors if there is filesystem activity inside the "
29819 "VM.  If the live VM is synched and quiescent, then C<virt-tar> will usually "
29820 "work, but the only way to guarantee consistent results is if the virtual "
29821 "machine is shut down."
29822 msgstr ""
29823
29824 #. type: textblock
29825 #: ../tools/virt-tar.pl:79
29826 msgid ""
29827 "C<virt-tar> is a general purpose archive tool for downloading and uploading "
29828 "parts of a guest filesystem.  There are many possibilities: making backups, "
29829 "uploading data files, snooping on guest activity, fixing or customizing "
29830 "guests, etc."
29831 msgstr ""
29832
29833 #. type: textblock
29834 #: ../tools/virt-tar.pl:84
29835 msgid ""
29836 "If you want to just view a single file, use L<virt-cat(1)>.  If you just "
29837 "want to edit a single file, use L<virt-edit(1)>.  For more complex cases you "
29838 "should look at the L<guestfish(1)> tool."
29839 msgstr ""
29840
29841 #. type: textblock
29842 #: ../tools/virt-tar.pl:88
29843 msgid ""
29844 "There are two modes of operation: I<-x> (eXtract) downloads a directory and "
29845 "its contents (recursively) from the virtual machine into a local tarball.  "
29846 "I<-u> uploads from a local tarball, unpacking it into a directory inside the "
29847 "virtual machine.  You cannot use these two options together."
29848 msgstr ""
29849
29850 #. type: textblock
29851 #: ../tools/virt-tar.pl:94
29852 msgid ""
29853 "In addition, you may need to use the I<-z> (gZip) option to enable "
29854 "compression.  When uploading, you have to specify I<-z> if the upload file "
29855 "is compressed because virt-tar won't detect this on its own."
29856 msgstr ""
29857
29858 #. type: textblock
29859 #: ../tools/virt-tar.pl:98
29860 msgid ""
29861 "C<virt-tar> can only handle tar (optionally gzipped) format tarballs.  For "
29862 "example it cannot do PKZip files or bzip2 compression.  If you want that "
29863 "then you'll have to rebuild the tarballs yourself.  (This is a limitation of "
29864 "the L<libguestfs(3)> API)."
29865 msgstr ""
29866
29867 #. type: =item
29868 #: ../tools/virt-tar.pl:156
29869 msgid "B<-x> | B<--extract> | B<--download>"
29870 msgstr ""
29871
29872 #. type: =item
29873 #: ../tools/virt-tar.pl:158
29874 msgid "B<-u> | B<--upload>"
29875 msgstr ""
29876
29877 #. type: textblock
29878 #: ../tools/virt-tar.pl:160
29879 msgid ""
29880 "Use I<-x> to extract (download) a directory from a virtual machine to a "
29881 "local tarball."
29882 msgstr ""
29883
29884 #. type: textblock
29885 #: ../tools/virt-tar.pl:163
29886 msgid ""
29887 "Use I<-u> to upload and unpack from a local tarball into a virtual machine.  "
29888 "Please read the L</WARNING> section above before using this option."
29889 msgstr ""
29890
29891 #. type: textblock
29892 #: ../tools/virt-tar.pl:167
29893 msgid "You must specify exactly one of these options."
29894 msgstr ""
29895
29896 #. type: =item
29897 #: ../tools/virt-tar.pl:173
29898 msgid "B<-z> | B<--gzip>"
29899 msgstr ""
29900
29901 #. type: textblock
29902 #: ../tools/virt-tar.pl:175
29903 msgid "Specify that the input or output tarball is gzip-compressed."
29904 msgstr ""
29905
29906 #. type: textblock
29907 #: ../tools/virt-tar.pl:288
29908 msgid ""
29909 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-edit(1)>, "
29910 "L<virt-copy-in(1)>, L<virt-copy-out(1)>, L<virt-tar-in(1)>, "
29911 "L<virt-tar-out(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, "
29912 "L<Sys::Virt(3)>, L<http://libguestfs.org/>."
29913 msgstr ""
29914
29915 #. type: textblock
29916 #: ../tools/virt-make-fs.pl:37
29917 msgid "virt-make-fs - Make a filesystem from a tar archive or files"
29918 msgstr ""
29919
29920 #. type: verbatim
29921 #: ../tools/virt-make-fs.pl:41
29922 #, no-wrap
29923 msgid ""
29924 " virt-make-fs [--options] input.tar output.img\n"
29925 "\n"
29926 msgstr ""
29927
29928 #. type: verbatim
29929 #: ../tools/virt-make-fs.pl:43
29930 #, no-wrap
29931 msgid ""
29932 " virt-make-fs [--options] input.tar.gz output.img\n"
29933 "\n"
29934 msgstr ""
29935
29936 #. type: verbatim
29937 #: ../tools/virt-make-fs.pl:45
29938 #, no-wrap
29939 msgid ""
29940 " virt-make-fs [--options] directory output.img\n"
29941 "\n"
29942 msgstr ""
29943
29944 #. type: textblock
29945 #: ../tools/virt-make-fs.pl:49
29946 msgid ""
29947 "Virt-make-fs is a command line tool for creating a filesystem from a tar "
29948 "archive or some files in a directory.  It is similar to tools like "
29949 "L<mkisofs(1)>, L<genisoimage(1)> and L<mksquashfs(1)>.  Unlike those tools, "
29950 "it can create common filesystem types like ext2/3 or NTFS, which can be "
29951 "useful if you want to attach these filesystems to existing virtual machines "
29952 "(eg. to import large amounts of read-only data to a VM)."
29953 msgstr ""
29954
29955 #. type: textblock
29956 #: ../tools/virt-make-fs.pl:57
29957 msgid "Basic usage is:"
29958 msgstr ""
29959
29960 #. type: verbatim
29961 #: ../tools/virt-make-fs.pl:59
29962 #, no-wrap
29963 msgid ""
29964 " virt-make-fs input output\n"
29965 "\n"
29966 msgstr ""
29967
29968 #. type: textblock
29969 #: ../tools/virt-make-fs.pl:61
29970 msgid ""
29971 "where C<input> is either a directory containing files that you want to add, "
29972 "or a tar archive (either uncompressed tar or gzip-compressed tar); and "
29973 "C<output> is a disk image.  The input type is detected automatically.  The "
29974 "output disk image defaults to a raw ext2 image unless you specify extra "
29975 "flags (see L</OPTIONS> below)."
29976 msgstr ""
29977
29978 #. type: =head2
29979 #: ../tools/virt-make-fs.pl:67
29980 msgid "EXTRA SPACE"
29981 msgstr ""
29982
29983 #. type: textblock
29984 #: ../tools/virt-make-fs.pl:69
29985 msgid ""
29986 "Unlike formats such as tar and squashfs, a filesystem does not \"just fit\" "
29987 "the files that it contains, but might have extra space.  Depending on how "
29988 "you are going to use the output, you might think this extra space is wasted "
29989 "and want to minimize it, or you might want to leave space so that more files "
29990 "can be added later.  Virt-make-fs defaults to minimizing the extra space, "
29991 "but you can use the I<--size> flag to leave space in the filesystem if you "
29992 "want it."
29993 msgstr ""
29994
29995 #. type: textblock
29996 #: ../tools/virt-make-fs.pl:77
29997 msgid ""
29998 "An alternative way to leave extra space but not make the output image any "
29999 "bigger is to use an alternative disk image format (instead of the default "
30000 "\"raw\" format).  Using I<--format=qcow2> will use the native QEmu/KVM qcow2 "
30001 "image format (check your hypervisor supports this before using it).  This "
30002 "allows you to choose a large I<--size> but the extra space won't actually be "
30003 "allocated in the image until you try to store something in it."
30004 msgstr ""
30005
30006 #. type: textblock
30007 #: ../tools/virt-make-fs.pl:85
30008 msgid ""
30009 "Don't forget that you can also use local commands including L<resize2fs(8)> "
30010 "and L<virt-resize(1)> to resize existing filesystems, or rerun virt-make-fs "
30011 "to build another image from scratch."
30012 msgstr ""
30013
30014 #. type: =head3
30015 #: ../tools/virt-make-fs.pl:89 ../tools/virt-make-fs.pl:123 ../tools/virt-make-fs.pl:142
30016 msgid "EXAMPLE"
30017 msgstr ""
30018
30019 #. type: verbatim
30020 #: ../tools/virt-make-fs.pl:91
30021 #, no-wrap
30022 msgid ""
30023 " virt-make-fs --format=qcow2 --size=+200M input output.img\n"
30024 "\n"
30025 msgstr ""
30026
30027 #. type: =head2
30028 #: ../tools/virt-make-fs.pl:93
30029 msgid "FILESYSTEM TYPE"
30030 msgstr ""
30031
30032 #. type: textblock
30033 #: ../tools/virt-make-fs.pl:95
30034 msgid ""
30035 "The default filesystem type is C<ext2>.  Just about any filesystem type that "
30036 "libguestfs supports can be used (but I<not> read-only formats like "
30037 "ISO9660).  Here are some of the more common choices:"
30038 msgstr ""
30039
30040 #. type: =item
30041 #: ../tools/virt-make-fs.pl:101
30042 msgid "I<ext3>"
30043 msgstr ""
30044
30045 #. type: textblock
30046 #: ../tools/virt-make-fs.pl:103
30047 msgid ""
30048 "Note that ext3 filesystems contain a journal, typically 1-32 MB in size.  If "
30049 "you are not going to use the filesystem in a way that requires the journal, "
30050 "then this is just wasted overhead."
30051 msgstr ""
30052
30053 #. type: =item
30054 #: ../tools/virt-make-fs.pl:107
30055 msgid "I<ntfs> or I<vfat>"
30056 msgstr ""
30057
30058 #. type: textblock
30059 #: ../tools/virt-make-fs.pl:109
30060 msgid "Useful if exporting data to a Windows guest."
30061 msgstr ""
30062
30063 #. type: textblock
30064 #: ../tools/virt-make-fs.pl:111
30065 msgid ""
30066 "I<Note for vfat>: The tar archive or local directory must only contain files "
30067 "which are owned by root (ie. UID:GID = 0:0).  The reason is that the tar "
30068 "program running within libguestfs is unable to change the ownership of "
30069 "non-root files, since vfat itself does not support this."
30070 msgstr ""
30071
30072 #. type: =item
30073 #: ../tools/virt-make-fs.pl:116
30074 msgid "I<minix>"
30075 msgstr ""
30076
30077 #. type: textblock
30078 #: ../tools/virt-make-fs.pl:118
30079 msgid ""
30080 "Lower overhead than C<ext2>, but certain limitations on filename length and "
30081 "total filesystem size."
30082 msgstr ""
30083
30084 #. type: verbatim
30085 #: ../tools/virt-make-fs.pl:125
30086 #, no-wrap
30087 msgid ""
30088 " virt-make-fs --type=minix input minixfs.img\n"
30089 "\n"
30090 msgstr ""
30091
30092 #. type: =head2
30093 #: ../tools/virt-make-fs.pl:127
30094 msgid "TO PARTITION OR NOT TO PARTITION"
30095 msgstr ""
30096
30097 #. type: textblock
30098 #: ../tools/virt-make-fs.pl:129
30099 msgid "Optionally virt-make-fs can add a partition table to the output disk."
30100 msgstr ""
30101
30102 #. type: textblock
30103 #: ../tools/virt-make-fs.pl:131
30104 msgid ""
30105 "Adding a partition can make the disk image more compatible with certain "
30106 "virtualized operating systems which don't expect to see a filesystem "
30107 "directly located on a block device (Linux doesn't care and will happily "
30108 "handle both types)."
30109 msgstr ""
30110
30111 #. type: textblock
30112 #: ../tools/virt-make-fs.pl:136
30113 msgid ""
30114 "On the other hand, if you have a partition table then the output image is no "
30115 "longer a straight filesystem.  For example you cannot run L<fsck(8)> "
30116 "directly on a partitioned disk image.  (However libguestfs tools such as "
30117 "L<guestfish(1)> and L<virt-resize(1)> can still be used)."
30118 msgstr ""
30119
30120 #. type: textblock
30121 #: ../tools/virt-make-fs.pl:144
30122 msgid "Add an MBR partition:"
30123 msgstr ""
30124
30125 #. type: verbatim
30126 #: ../tools/virt-make-fs.pl:146
30127 #, no-wrap
30128 msgid ""
30129 " virt-make-fs --partition -- input disk.img\n"
30130 "\n"
30131 msgstr ""
30132
30133 #. type: textblock
30134 #: ../tools/virt-make-fs.pl:148
30135 msgid ""
30136 "If the output disk image could be terabyte-sized or larger, it's better to "
30137 "use an EFI/GPT-compatible partition table:"
30138 msgstr ""
30139
30140 #. type: verbatim
30141 #: ../tools/virt-make-fs.pl:151
30142 #, no-wrap
30143 msgid ""
30144 " virt-make-fs --partition=gpt --size=+4T --format=qcow2 input disk.img\n"
30145 "\n"
30146 msgstr ""
30147
30148 #. type: textblock
30149 #: ../tools/virt-make-fs.pl:179
30150 msgid "Enable debugging information."
30151 msgstr ""
30152
30153 #. type: =item
30154 #: ../tools/virt-make-fs.pl:185
30155 msgid "B<--size=E<lt>NE<gt>>"
30156 msgstr ""
30157
30158 #. type: =item
30159 #: ../tools/virt-make-fs.pl:187
30160 msgid "B<--size=+E<lt>NE<gt>>"
30161 msgstr ""
30162
30163 #. type: =item
30164 #: ../tools/virt-make-fs.pl:189
30165 msgid "B<-s E<lt>NE<gt>>"
30166 msgstr ""
30167
30168 #. type: =item
30169 #: ../tools/virt-make-fs.pl:191
30170 msgid "B<-s +E<lt>NE<gt>>"
30171 msgstr ""
30172
30173 #. type: textblock
30174 #: ../tools/virt-make-fs.pl:193
30175 msgid "Use the I<--size> (or I<-s>) option to choose the size of the output image."
30176 msgstr ""
30177
30178 #. type: textblock
30179 #: ../tools/virt-make-fs.pl:196
30180 msgid ""
30181 "If this option is I<not> given, then the output image will be just large "
30182 "enough to contain all the files, with not much wasted space."
30183 msgstr ""
30184
30185 #. type: textblock
30186 #: ../tools/virt-make-fs.pl:199
30187 msgid ""
30188 "To choose a fixed size output disk, specify an absolute number followed by "
30189 "b/K/M/G/T/P/E to mean bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, "
30190 "Petabytes or Exabytes.  This must be large enough to contain all the input "
30191 "files, else you will get an error."
30192 msgstr ""
30193
30194 #. type: textblock
30195 #: ../tools/virt-make-fs.pl:204
30196 msgid ""
30197 "To leave extra space, specify C<+> (plus sign) and a number followed by "
30198 "b/K/M/G/T/P/E to mean bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, "
30199 "Petabytes or Exabytes.  For example: I<--size=+200M> means enough space for "
30200 "the input files, and (approximately) an extra 200 MB free space."
30201 msgstr ""
30202
30203 #. type: textblock
30204 #: ../tools/virt-make-fs.pl:210
30205 msgid ""
30206 "Note that virt-make-fs estimates free space, and therefore will not produce "
30207 "filesystems containing precisely the free space requested.  (It is much more "
30208 "expensive and time-consuming to produce a filesystem which has precisely the "
30209 "desired free space)."
30210 msgstr ""
30211
30212 #. type: =item
30213 #: ../tools/virt-make-fs.pl:219
30214 msgid "B<--format=E<lt>fmtE<gt>>"
30215 msgstr ""
30216
30217 #. type: =item
30218 #: ../tools/virt-make-fs.pl:221
30219 msgid "B<-F E<lt>fmtE<gt>>"
30220 msgstr ""
30221
30222 #. type: textblock
30223 #: ../tools/virt-make-fs.pl:223
30224 msgid "Choose the output disk image format."
30225 msgstr ""
30226
30227 #. type: textblock
30228 #: ../tools/virt-make-fs.pl:225
30229 msgid "The default is C<raw> (raw disk image)."
30230 msgstr ""
30231
30232 #. type: textblock
30233 #: ../tools/virt-make-fs.pl:227
30234 msgid ""
30235 "For other choices, see the L<qemu-img(1)> manpage.  The only other choice "
30236 "that would really make sense here is C<qcow2>."
30237 msgstr ""
30238
30239 #. type: =item
30240 #: ../tools/virt-make-fs.pl:234
30241 msgid "B<--type=E<lt>fsE<gt>>"
30242 msgstr ""
30243
30244 #. type: =item
30245 #: ../tools/virt-make-fs.pl:236
30246 msgid "B<-t E<lt>fsE<gt>>"
30247 msgstr ""
30248
30249 #. type: textblock
30250 #: ../tools/virt-make-fs.pl:238
30251 msgid "Choose the output filesystem type."
30252 msgstr ""
30253
30254 #. type: textblock
30255 #: ../tools/virt-make-fs.pl:240
30256 msgid "The default is C<ext2>."
30257 msgstr ""
30258
30259 #. type: textblock
30260 #: ../tools/virt-make-fs.pl:242
30261 msgid "Any filesystem which is supported read-write by libguestfs can be used here."
30262 msgstr ""
30263
30264 #. type: =item
30265 #: ../tools/virt-make-fs.pl:249
30266 msgid "B<--partition>"
30267 msgstr ""
30268
30269 #. type: =item
30270 #: ../tools/virt-make-fs.pl:251
30271 msgid "B<--partition=E<lt>parttypeE<gt>>"
30272 msgstr ""
30273
30274 #. type: textblock
30275 #: ../tools/virt-make-fs.pl:253
30276 msgid ""
30277 "If specified, this flag adds an MBR partition table to the output disk "
30278 "image."
30279 msgstr ""
30280
30281 #. type: textblock
30282 #: ../tools/virt-make-fs.pl:256
30283 msgid ""
30284 "You can change the partition table type, eg. I<--partition=gpt> for large "
30285 "disks."
30286 msgstr ""
30287
30288 #. type: textblock
30289 #: ../tools/virt-make-fs.pl:259
30290 msgid ""
30291 "Note that if you just use a lonesome I<--partition>, the Perl option parser "
30292 "might consider the next parameter to be the partition type.  For example:"
30293 msgstr ""
30294
30295 #. type: verbatim
30296 #: ../tools/virt-make-fs.pl:263
30297 #, no-wrap
30298 msgid ""
30299 " virt-make-fs --partition input.tar ...\n"
30300 "\n"
30301 msgstr ""
30302
30303 #. type: textblock
30304 #: ../tools/virt-make-fs.pl:265
30305 msgid ""
30306 "would cause virt-make-fs to think you wanted to use a partition type of "
30307 "C<input.tar> which is completely wrong.  To avoid this, use I<--> (a double "
30308 "dash) between options and the input file argument:"
30309 msgstr ""
30310
30311 #. type: verbatim
30312 #: ../tools/virt-make-fs.pl:269
30313 #, no-wrap
30314 msgid ""
30315 " virt-make-fs --partition -- input.tar ...\n"
30316 "\n"
30317 msgstr ""
30318
30319 #. type: textblock
30320 #: ../tools/virt-make-fs.pl:541
30321 msgid ""
30322 "L<guestfish(1)>, L<virt-resize(1)>, L<virt-tar-in(1)>, L<mkisofs(1)>, "
30323 "L<genisoimage(1)>, L<mksquashfs(1)>, L<mke2fs(8)>, L<resize2fs(8)>, "
30324 "L<guestfs(3)>, L<Sys::Guestfs(3)>, L<http://libguestfs.org/>."
30325 msgstr ""
30326
30327 #. type: verbatim
30328 #: ../tools/virt-make-fs.pl:558
30329 #, no-wrap
30330 msgid ""
30331 " export LIBGUESTFS_DEBUG=1\n"
30332 " virt-make-fs --debug [...] > /tmp/virt-make-fs.log 2>&1\n"
30333 "\n"
30334 msgstr ""
30335
30336 #. type: textblock
30337 #: ../tools/virt-make-fs.pl:561
30338 msgid ""
30339 "Attach /tmp/virt-make-fs.log to a new bug report at "
30340 "L<https://bugzilla.redhat.com/>"
30341 msgstr ""
30342
30343 #. type: textblock
30344 #: ../tools/virt-list-partitions.pl:32
30345 msgid "virt-list-partitions - List partitions in a virtual machine or disk image"
30346 msgstr ""
30347
30348 #. type: verbatim
30349 #: ../tools/virt-list-partitions.pl:36
30350 #, no-wrap
30351 msgid ""
30352 " virt-list-partitions [--options] domname\n"
30353 "\n"
30354 msgstr ""
30355
30356 #. type: verbatim
30357 #: ../tools/virt-list-partitions.pl:38
30358 #, no-wrap
30359 msgid ""
30360 " virt-list-partitions [--options] disk.img [disk.img ...]\n"
30361 "\n"
30362 msgstr ""
30363
30364 #. type: textblock
30365 #: ../tools/virt-list-partitions.pl:45
30366 msgid ""
30367 "C<virt-list-partitions> is a command line tool to list the partitions that "
30368 "are contained in a virtual machine or disk image.  It is mainly useful as a "
30369 "first step to using L<virt-resize(1)>."
30370 msgstr ""
30371
30372 #. type: textblock
30373 #: ../tools/virt-list-partitions.pl:50
30374 msgid ""
30375 "C<virt-list-partitions> is just a simple wrapper around L<libguestfs(3)> "
30376 "functionality.  For more complex cases you should look at the "
30377 "L<guestfish(1)> tool."
30378 msgstr ""
30379
30380 #. type: =item
30381 #: ../tools/virt-list-partitions.pl:107
30382 msgid "B<-h> | B<--human-readable>"
30383 msgstr ""
30384
30385 #. type: textblock
30386 #: ../tools/virt-list-partitions.pl:109
30387 msgid "Show sizes in human-readable form (eg. \"1G\")."
30388 msgstr ""
30389
30390 #. type: textblock
30391 #: ../tools/virt-list-partitions.pl:117
30392 msgid ""
30393 "With this option, C<virt-list-partitions> displays the type and size of each "
30394 "partition too (where \"type\" means C<ext3>, C<pv> etc.)"
30395 msgstr ""
30396
30397 #. type: =item
30398 #: ../tools/virt-list-partitions.pl:124
30399 msgid "B<-t> | B<--total>"
30400 msgstr ""
30401
30402 #. type: textblock
30403 #: ../tools/virt-list-partitions.pl:126
30404 msgid "Display the total size of each block device (as a separate row or rows)."
30405 msgstr ""
30406
30407 #. type: textblock
30408 #: ../tools/virt-list-partitions.pl:259
30409 msgid ""
30410 "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, "
30411 "L<virt-list-filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, "
30412 "L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
30413 msgstr ""
30414
30415 #. type: textblock
30416 #: ../tools/virt-list-partitions.pl:275
30417 msgid "Copyright (C) 2009-2010 Red Hat Inc."
30418 msgstr ""