b633503dcb8fd41b83017b7c3e5ea604b2138bb6
[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.8.13\n"
10 "Report-Msgid-Bugs-To: libguestfs@redhat.com\n"
11 "POT-Creation-Date: 2011-09-16 16:37+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-resize.pl:40 ../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-resize.pl:44 ../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-resize.pl:50 ../tools/virt-list-filesystems.pl:40 ../tools/virt-tar.pl:72 ../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 pipe 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:1011 ../src/guestfs.pod:1015 ../src/guestfs.pod:1019 ../src/guestfs.pod:1024 ../src/guestfs.pod:1032 ../src/guestfs.pod:1051 ../src/guestfs.pod:1059 ../src/guestfs.pod:1081 ../src/guestfs.pod:1085 ../src/guestfs.pod:1089 ../src/guestfs.pod:1093 ../src/guestfs.pod:1097 ../src/guestfs.pod:1101 ../src/guestfs.pod:1583 ../src/guestfs.pod:1588 ../src/guestfs.pod:1592 ../src/guestfs.pod:1702 ../src/guestfs.pod:1707 ../src/guestfs.pod:1711 ../src/guestfs.pod:2064 ../src/guestfs.pod:2070 ../src/guestfs.pod:2075 ../src/guestfs.pod:2081 ../src/guestfs.pod:2540 ../src/guestfs.pod:2544 ../src/guestfs.pod:2548 ../src/guestfs.pod:2552 ../src/guestfs-actions.pod:15 ../src/guestfs-actions.pod:22 ../src/guestfs-actions.pod:574 ../src/guestfs-actions.pod:582 ../src/guestfs-actions.pod:589 ../src/guestfs-actions.pod:596 ../src/guestfs-actions.pod:1589 ../src/guestfs-actions.pod:1593 ../src/guestfs-actions.pod:1597 ../src/guestfs-actions.pod:1601 ../src/guestfs-actions.pod:1609 ../src/guestfs-actions.pod:1613 ../src/guestfs-actions.pod:1617 ../src/guestfs-actions.pod:1627 ../src/guestfs-actions.pod:1631 ../src/guestfs-actions.pod:1635 ../src/guestfs-actions.pod:1773 ../src/guestfs-actions.pod:1777 ../src/guestfs-actions.pod:1782 ../src/guestfs-actions.pod:1787 ../src/guestfs-actions.pod:1848 ../src/guestfs-actions.pod:1852 ../src/guestfs-actions.pod:1857 ../src/guestfs-actions.pod:2238 ../src/guestfs-actions.pod:2245 ../src/guestfs-actions.pod:2252 ../fish/guestfish.pod:427 ../fish/guestfish.pod:431 ../fish/guestfish.pod:435 ../fish/guestfish.pod:439 ../fish/guestfish-actions.pod:13 ../fish/guestfish-actions.pod:20 ../fish/guestfish-actions.pod:378 ../fish/guestfish-actions.pod:386 ../fish/guestfish-actions.pod:393 ../fish/guestfish-actions.pod:400 ../fish/guestfish-actions.pod:1067 ../fish/guestfish-actions.pod:1071 ../fish/guestfish-actions.pod:1075 ../fish/guestfish-actions.pod:1079 ../fish/guestfish-actions.pod:1087 ../fish/guestfish-actions.pod:1091 ../fish/guestfish-actions.pod:1095 ../fish/guestfish-actions.pod:1105 ../fish/guestfish-actions.pod:1109 ../fish/guestfish-actions.pod:1113 ../fish/guestfish-actions.pod:1203 ../fish/guestfish-actions.pod:1207 ../fish/guestfish-actions.pod:1212 ../fish/guestfish-actions.pod:1217 ../fish/guestfish-actions.pod:1259 ../fish/guestfish-actions.pod:1263 ../fish/guestfish-actions.pod:1268 ../fish/guestfish-actions.pod:1506 ../fish/guestfish-actions.pod:1513 ../fish/guestfish-actions.pod:1520 ../tools/virt-win-reg.pl:536 ../tools/virt-win-reg.pl:542 ../tools/virt-win-reg.pl:548 ../tools/virt-resize.pl:345 ../tools/virt-resize.pl:350 ../tools/virt-resize.pl:360
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:1204 ../src/guestfs.pod:1335 ../src/guestfs.pod:2109
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:1208 ../src/guestfs.pod:1339 ../src/guestfs.pod:2134
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:1345
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:720
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.  (These APIs used to be in a separate Perl-only "
1112 "library called L<Sys::Guestfs::Lib(3)> but since version 1.5.3 the most "
1113 "frequently used part of this library has been rewritten in C and moved into "
1114 "the core code)."
1115 msgstr ""
1116
1117 #. type: textblock
1118 #: ../src/guestfs.pod:558
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:561
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:570
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:576
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:583
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:587
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:590
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:594
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:598
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:602
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: =head2
1212 #: ../src/guestfs.pod:611
1213 msgid "SPECIAL CONSIDERATIONS FOR WINDOWS GUESTS"
1214 msgstr ""
1215
1216 #. type: textblock
1217 #: ../src/guestfs.pod:613
1218 msgid ""
1219 "Libguestfs can mount NTFS partitions.  It does this using the "
1220 "L<http://www.ntfs-3g.org/> driver."
1221 msgstr ""
1222
1223 #. type: =head3
1224 #: ../src/guestfs.pod:616
1225 msgid "DRIVE LETTERS AND PATHS"
1226 msgstr ""
1227
1228 #. type: textblock
1229 #: ../src/guestfs.pod:618
1230 msgid ""
1231 "DOS and Windows still use drive letters, and the filesystems are always "
1232 "treated as case insensitive by Windows itself, and therefore you might find "
1233 "a Windows configuration file referring to a path like "
1234 "C<c:\\windows\\system32>.  When the filesystem is mounted in libguestfs, "
1235 "that directory might be referred to as C</WINDOWS/System32>."
1236 msgstr ""
1237
1238 #. type: textblock
1239 #: ../src/guestfs.pod:624
1240 msgid ""
1241 "Drive letter mappings are outside the scope of libguestfs.  You have to use "
1242 "libguestfs to read the appropriate Windows Registry and configuration files, "
1243 "to determine yourself how drives are mapped (see also L<hivex(3)> and "
1244 "L<virt-inspector(1)>)."
1245 msgstr ""
1246
1247 #. type: textblock
1248 #: ../src/guestfs.pod:629
1249 msgid ""
1250 "Replacing backslash characters with forward slash characters is also outside "
1251 "the scope of libguestfs, but something that you can easily do."
1252 msgstr ""
1253
1254 #. type: textblock
1255 #: ../src/guestfs.pod:632
1256 msgid ""
1257 "Where we can help is in resolving the case insensitivity of paths.  For "
1258 "this, call L</guestfs_case_sensitive_path>."
1259 msgstr ""
1260
1261 #. type: =head3
1262 #: ../src/guestfs.pod:635
1263 msgid "ACCESSING THE WINDOWS REGISTRY"
1264 msgstr ""
1265
1266 #. type: textblock
1267 #: ../src/guestfs.pod:637
1268 msgid ""
1269 "Libguestfs also provides some help for decoding Windows Registry \"hive\" "
1270 "files, through the library C<hivex> which is part of the libguestfs project "
1271 "although ships as a separate tarball.  You have to locate and download the "
1272 "hive file(s) yourself, and then pass them to C<hivex> functions.  See also "
1273 "the programs L<hivexml(1)>, L<hivexsh(1)>, L<hivexregedit(1)> and "
1274 "L<virt-win-reg(1)> for more help on this issue."
1275 msgstr ""
1276
1277 #. type: =head3
1278 #: ../src/guestfs.pod:645
1279 msgid "SYMLINKS ON NTFS-3G FILESYSTEMS"
1280 msgstr ""
1281
1282 #. type: textblock
1283 #: ../src/guestfs.pod:647
1284 msgid ""
1285 "Ntfs-3g tries to rewrite \"Junction Points\" and NTFS \"symbolic links\" to "
1286 "provide something which looks like a Linux symlink.  The way it tries to do "
1287 "the rewriting is described here:"
1288 msgstr ""
1289
1290 #. type: textblock
1291 #: ../src/guestfs.pod:651
1292 msgid "L<http://www.tuxera.com/community/ntfs-3g-advanced/junction-points-and-symbolic-links/>"
1293 msgstr ""
1294
1295 #. type: textblock
1296 #: ../src/guestfs.pod:653
1297 msgid ""
1298 "The essential problem is that ntfs-3g simply does not have enough "
1299 "information to do a correct job.  NTFS links can contain drive letters and "
1300 "references to external device GUIDs that ntfs-3g has no way of resolving.  "
1301 "It is almost certainly the case that libguestfs callers should ignore what "
1302 "ntfs-3g does (ie. don't use L</guestfs_readlink> on NTFS volumes)."
1303 msgstr ""
1304
1305 #. type: textblock
1306 #: ../src/guestfs.pod:660
1307 msgid ""
1308 "Instead if you encounter a symbolic link on an ntfs-3g filesystem, use "
1309 "L</guestfs_lgetxattr> to read the C<system.ntfs_reparse_data> extended "
1310 "attribute, and read the raw reparse data from that (you can find the format "
1311 "documented in various places around the web)."
1312 msgstr ""
1313
1314 #. type: =head3
1315 #: ../src/guestfs.pod:665
1316 msgid "EXTENDED ATTRIBUTES ON NTFS-3G FILESYSTEMS"
1317 msgstr ""
1318
1319 #. type: textblock
1320 #: ../src/guestfs.pod:667
1321 msgid ""
1322 "There are other useful extended attributes that can be read from ntfs-3g "
1323 "filesystems (using L</guestfs_getxattr>).  See:"
1324 msgstr ""
1325
1326 #. type: textblock
1327 #: ../src/guestfs.pod:670
1328 msgid "L<http://www.tuxera.com/community/ntfs-3g-advanced/extended-attributes/>"
1329 msgstr ""
1330
1331 #. type: =head2
1332 #: ../src/guestfs.pod:672
1333 msgid "USING LIBGUESTFS WITH OTHER PROGRAMMING LANGUAGES"
1334 msgstr ""
1335
1336 #. type: textblock
1337 #: ../src/guestfs.pod:674
1338 msgid ""
1339 "Although we don't want to discourage you from using the C API, we will "
1340 "mention here that the same API is also available in other languages."
1341 msgstr ""
1342
1343 #. type: textblock
1344 #: ../src/guestfs.pod:677
1345 msgid ""
1346 "The API is broadly identical in all supported languages.  This means that "
1347 "the C call C<guestfs_add_drive_ro(g,file)> is C<$g-E<gt>add_drive_ro($file)> "
1348 "in Perl, C<g.add_drive_ro(file)> in Python, and C<g#add_drive_ro file> in "
1349 "OCaml.  In other words, a straightforward, predictable isomorphism between "
1350 "each language."
1351 msgstr ""
1352
1353 #. type: textblock
1354 #: ../src/guestfs.pod:683
1355 msgid ""
1356 "Error messages are automatically transformed into exceptions if the language "
1357 "supports it."
1358 msgstr ""
1359
1360 #. type: textblock
1361 #: ../src/guestfs.pod:686
1362 msgid ""
1363 "We don't try to \"object orientify\" parts of the API in OO languages, "
1364 "although contributors are welcome to write higher level APIs above what we "
1365 "provide in their favourite languages if they wish."
1366 msgstr ""
1367
1368 #. type: =item
1369 #: ../src/guestfs.pod:692
1370 msgid "B<C++>"
1371 msgstr ""
1372
1373 #. type: textblock
1374 #: ../src/guestfs.pod:694
1375 msgid ""
1376 "You can use the I<guestfs.h> header file from C++ programs.  The C++ API is "
1377 "identical to the C API.  C++ classes and exceptions are not used."
1378 msgstr ""
1379
1380 #. type: =item
1381 #: ../src/guestfs.pod:698
1382 msgid "B<C#>"
1383 msgstr ""
1384
1385 #. type: textblock
1386 #: ../src/guestfs.pod:700
1387 msgid ""
1388 "The C# bindings are highly experimental.  Please read the warnings at the "
1389 "top of C<csharp/Libguestfs.cs>."
1390 msgstr ""
1391
1392 #. type: =item
1393 #: ../src/guestfs.pod:703
1394 msgid "B<Haskell>"
1395 msgstr ""
1396
1397 #. type: textblock
1398 #: ../src/guestfs.pod:705
1399 msgid ""
1400 "This is the only language binding that is working but incomplete.  Only "
1401 "calls which return simple integers have been bound in Haskell, and we are "
1402 "looking for help to complete this binding."
1403 msgstr ""
1404
1405 #. type: =item
1406 #: ../src/guestfs.pod:709
1407 msgid "B<Java>"
1408 msgstr ""
1409
1410 #. type: textblock
1411 #: ../src/guestfs.pod:711
1412 msgid ""
1413 "Full documentation is contained in the Javadoc which is distributed with "
1414 "libguestfs."
1415 msgstr ""
1416
1417 #. type: =item
1418 #: ../src/guestfs.pod:714
1419 msgid "B<OCaml>"
1420 msgstr ""
1421
1422 #. type: textblock
1423 #: ../src/guestfs.pod:716
1424 msgid "See L<guestfs-ocaml(3)>."
1425 msgstr ""
1426
1427 #. type: =item
1428 #: ../src/guestfs.pod:718
1429 msgid "B<Perl>"
1430 msgstr ""
1431
1432 #. type: textblock
1433 #: ../src/guestfs.pod:720
1434 msgid "See L<Sys::Guestfs(3)>."
1435 msgstr ""
1436
1437 #. type: =item
1438 #: ../src/guestfs.pod:722
1439 msgid "B<PHP>"
1440 msgstr ""
1441
1442 #. type: textblock
1443 #: ../src/guestfs.pod:724
1444 msgid ""
1445 "For documentation see C<README-PHP> supplied with libguestfs sources or in "
1446 "the php-libguestfs package for your distribution."
1447 msgstr ""
1448
1449 #. type: textblock
1450 #: ../src/guestfs.pod:727
1451 msgid "The PHP binding only works correctly on 64 bit machines."
1452 msgstr ""
1453
1454 #. type: =item
1455 #: ../src/guestfs.pod:729
1456 msgid "B<Python>"
1457 msgstr ""
1458
1459 #. type: textblock
1460 #: ../src/guestfs.pod:731
1461 msgid "See L<guestfs-python(3)>."
1462 msgstr ""
1463
1464 #. type: =item
1465 #: ../src/guestfs.pod:733
1466 msgid "B<Ruby>"
1467 msgstr ""
1468
1469 #. type: textblock
1470 #: ../src/guestfs.pod:735
1471 msgid "See L<guestfs-ruby(3)>."
1472 msgstr ""
1473
1474 #. type: =item
1475 #: ../src/guestfs.pod:737
1476 msgid "B<shell scripts>"
1477 msgstr ""
1478
1479 #. type: textblock
1480 #: ../src/guestfs.pod:739
1481 msgid "See L<guestfish(1)>."
1482 msgstr ""
1483
1484 #. type: =head2
1485 #: ../src/guestfs.pod:743
1486 msgid "LIBGUESTFS GOTCHAS"
1487 msgstr ""
1488
1489 #. type: textblock
1490 #: ../src/guestfs.pod:745
1491 msgid ""
1492 "L<http://en.wikipedia.org/wiki/Gotcha_(programming)>: \"A feature of a "
1493 "system [...] that works in the way it is documented but is counterintuitive "
1494 "and almost invites mistakes.\""
1495 msgstr ""
1496
1497 #. type: textblock
1498 #: ../src/guestfs.pod:749
1499 msgid ""
1500 "Since we developed libguestfs and the associated tools, there are several "
1501 "things we would have designed differently, but are now stuck with for "
1502 "backwards compatibility or other reasons.  If there is ever a libguestfs 2.0 "
1503 "release, you can expect these to change.  Beware of them."
1504 msgstr ""
1505
1506 #. type: =item
1507 #: ../src/guestfs.pod:757
1508 msgid "Autosync / forgetting to sync."
1509 msgstr ""
1510
1511 #. type: textblock
1512 #: ../src/guestfs.pod:759
1513 msgid ""
1514 "When modifying a filesystem from C or another language, you B<must> unmount "
1515 "all filesystems and call L</guestfs_sync> explicitly before you close the "
1516 "libguestfs handle.  You can also call:"
1517 msgstr ""
1518
1519 #. type: verbatim
1520 #: ../src/guestfs.pod:763
1521 #, no-wrap
1522 msgid ""
1523 " guestfs_set_autosync (g, 1);\n"
1524 "\n"
1525 msgstr ""
1526
1527 #. type: textblock
1528 #: ../src/guestfs.pod:765
1529 msgid ""
1530 "to have the unmount/sync done automatically for you when the handle 'g' is "
1531 "closed.  (This feature is called \"autosync\", L</guestfs_set_autosync> "
1532 "q.v.)"
1533 msgstr ""
1534
1535 #. type: textblock
1536 #: ../src/guestfs.pod:769
1537 msgid ""
1538 "If you forget to do this, then it is entirely possible that your changes "
1539 "won't be written out, or will be partially written, or (very rarely) that "
1540 "you'll get disk corruption."
1541 msgstr ""
1542
1543 #. type: textblock
1544 #: ../src/guestfs.pod:773
1545 msgid ""
1546 "Note that in L<guestfish(3)> autosync is the default.  So quick and dirty "
1547 "guestfish scripts that forget to sync will work just fine, which can make "
1548 "this very puzzling if you are trying to debug a problem."
1549 msgstr ""
1550
1551 #. type: textblock
1552 #: ../src/guestfs.pod:777
1553 msgid ""
1554 "Update: Autosync is enabled by default for all API users starting from "
1555 "libguestfs 1.5.24."
1556 msgstr ""
1557
1558 #. type: =item
1559 #: ../src/guestfs.pod:780
1560 msgid "Mount option C<-o sync> should not be the default."
1561 msgstr ""
1562
1563 #. type: textblock
1564 #: ../src/guestfs.pod:782
1565 msgid ""
1566 "If you use L</guestfs_mount>, then C<-o sync,noatime> are added implicitly.  "
1567 "However C<-o sync> does not add any reliability benefit, but does have a "
1568 "very large performance impact."
1569 msgstr ""
1570
1571 #. type: textblock
1572 #: ../src/guestfs.pod:786
1573 msgid ""
1574 "The work around is to use L</guestfs_mount_options> and set the mount "
1575 "options that you actually want to use."
1576 msgstr ""
1577
1578 #. type: =item
1579 #: ../src/guestfs.pod:789
1580 msgid "Read-only should be the default."
1581 msgstr ""
1582
1583 #. type: textblock
1584 #: ../src/guestfs.pod:791
1585 msgid ""
1586 "In L<guestfish(3)>, I<--ro> should be the default, and you should have to "
1587 "specify I<--rw> if you want to make changes to the image."
1588 msgstr ""
1589
1590 #. type: textblock
1591 #: ../src/guestfs.pod:794
1592 msgid "This would reduce the potential to corrupt live VM images."
1593 msgstr ""
1594
1595 #. type: textblock
1596 #: ../src/guestfs.pod:796
1597 msgid ""
1598 "Note that many filesystems change the disk when you just mount and unmount, "
1599 "even if you didn't perform any writes.  You need to use "
1600 "L</guestfs_add_drive_ro> to guarantee that the disk is not changed."
1601 msgstr ""
1602
1603 #. type: =item
1604 #: ../src/guestfs.pod:800
1605 msgid "guestfish command line is hard to use."
1606 msgstr ""
1607
1608 #. type: textblock
1609 #: ../src/guestfs.pod:802
1610 msgid ""
1611 "C<guestfish disk.img> doesn't do what people expect (open C<disk.img> for "
1612 "examination).  It tries to run a guestfish command C<disk.img> which doesn't "
1613 "exist, so it fails.  In earlier versions of guestfish the error message was "
1614 "also unintuitive, but we have corrected this since.  Like the Bourne shell, "
1615 "we should have used C<guestfish -c command> to run commands."
1616 msgstr ""
1617
1618 #. type: =item
1619 #: ../src/guestfs.pod:809
1620 msgid "guestfish megabyte modifiers don't work right on all commands"
1621 msgstr ""
1622
1623 #. type: textblock
1624 #: ../src/guestfs.pod:811
1625 msgid ""
1626 "In recent guestfish you can use C<1M> to mean 1 megabyte (and similarly for "
1627 "other modifiers).  What guestfish actually does is to multiply the number "
1628 "part by the modifier part and pass the result to the C API.  However this "
1629 "doesn't work for a few APIs which aren't expecting bytes, but are already "
1630 "expecting some other unit (eg. megabytes)."
1631 msgstr ""
1632
1633 #. type: textblock
1634 #: ../src/guestfs.pod:818
1635 msgid "The most common is L</guestfs_lvcreate>.  The guestfish command:"
1636 msgstr ""
1637
1638 #. type: verbatim
1639 #: ../src/guestfs.pod:820
1640 #, no-wrap
1641 msgid ""
1642 " lvcreate LV VG 100M\n"
1643 "\n"
1644 msgstr ""
1645
1646 #. type: textblock
1647 #: ../src/guestfs.pod:822
1648 msgid ""
1649 "does not do what you might expect.  Instead because L</guestfs_lvcreate> is "
1650 "already expecting megabytes, this tries to create a 100 I<terabyte> (100 "
1651 "megabytes * megabytes) logical volume.  The error message you get from this "
1652 "is also a little obscure."
1653 msgstr ""
1654
1655 #. type: textblock
1656 #: ../src/guestfs.pod:827
1657 msgid ""
1658 "This could be fixed in the generator by specially marking parameters and "
1659 "return values which take bytes or other units."
1660 msgstr ""
1661
1662 #. type: =item
1663 #: ../src/guestfs.pod:830
1664 msgid "Ambiguity between devices and paths"
1665 msgstr ""
1666
1667 #. type: textblock
1668 #: ../src/guestfs.pod:832
1669 msgid ""
1670 "There is a subtle ambiguity in the API between a device name "
1671 "(eg. C</dev/sdb2>) and a similar pathname.  A file might just happen to be "
1672 "called C<sdb2> in the directory C</dev> (consider some non-Unix VM image)."
1673 msgstr ""
1674
1675 #. type: textblock
1676 #: ../src/guestfs.pod:837
1677 msgid ""
1678 "In the current API we usually resolve this ambiguity by having two separate "
1679 "calls, for example L</guestfs_checksum> and L</guestfs_checksum_device>.  "
1680 "Some API calls are ambiguous and (incorrectly) resolve the problem by "
1681 "detecting if the path supplied begins with C</dev/>."
1682 msgstr ""
1683
1684 #. type: textblock
1685 #: ../src/guestfs.pod:843
1686 msgid ""
1687 "To avoid both the ambiguity and the need to duplicate some calls, we could "
1688 "make paths/devices into structured names.  One way to do this would be to "
1689 "use a notation like grub (C<hd(0,0)>), although nobody really likes this "
1690 "aspect of grub.  Another way would be to use a structured type, equivalent "
1691 "to this OCaml type:"
1692 msgstr ""
1693
1694 #. type: verbatim
1695 #: ../src/guestfs.pod:849
1696 #, no-wrap
1697 msgid ""
1698 " type path = Path of string | Device of int | Partition of int * int\n"
1699 "\n"
1700 msgstr ""
1701
1702 #. type: textblock
1703 #: ../src/guestfs.pod:851
1704 msgid "which would allow you to pass arguments like:"
1705 msgstr ""
1706
1707 #. type: verbatim
1708 #: ../src/guestfs.pod:853
1709 #, no-wrap
1710 msgid ""
1711 " Path \"/foo/bar\"\n"
1712 " Device 1            (* /dev/sdb, or perhaps /dev/sda *)\n"
1713 " Partition (1, 2)    (* /dev/sdb2 (or is it /dev/sda2 or /dev/sdb3?) *)\n"
1714 " Path \"/dev/sdb2\"    (* not a device *)\n"
1715 "\n"
1716 msgstr ""
1717
1718 #. type: textblock
1719 #: ../src/guestfs.pod:858
1720 msgid ""
1721 "As you can see there are still problems to resolve even with this "
1722 "representation.  Also consider how it might work in guestfish."
1723 msgstr ""
1724
1725 #. type: =head2
1726 #: ../src/guestfs.pod:863
1727 msgid "PROTOCOL LIMITS"
1728 msgstr ""
1729
1730 #. type: textblock
1731 #: ../src/guestfs.pod:865
1732 msgid ""
1733 "Internally libguestfs uses a message-based protocol to pass API calls and "
1734 "their responses to and from a small \"appliance\" (see L</INTERNALS> for "
1735 "plenty more detail about this).  The maximum message size used by the "
1736 "protocol is slightly less than 4 MB.  For some API calls you may need to be "
1737 "aware of this limit.  The API calls which may be affected are individually "
1738 "documented, with a link back to this section of the documentation."
1739 msgstr ""
1740
1741 #. type: textblock
1742 #: ../src/guestfs.pod:873
1743 msgid ""
1744 "A simple call such as L</guestfs_cat> returns its result (the file data) in "
1745 "a simple string.  Because this string is at some point internally encoded as "
1746 "a message, the maximum size that it can return is slightly under 4 MB.  If "
1747 "the requested file is larger than this then you will get an error."
1748 msgstr ""
1749
1750 #. type: textblock
1751 #: ../src/guestfs.pod:879
1752 msgid ""
1753 "In order to transfer large files into and out of the guest filesystem, you "
1754 "need to use particular calls that support this.  The sections L</UPLOADING> "
1755 "and L</DOWNLOADING> document how to do this."
1756 msgstr ""
1757
1758 #. type: textblock
1759 #: ../src/guestfs.pod:883
1760 msgid ""
1761 "You might also consider mounting the disk image using our FUSE filesystem "
1762 "support (L<guestmount(1)>)."
1763 msgstr ""
1764
1765 #. type: =head2
1766 #: ../src/guestfs.pod:886
1767 msgid "KEYS AND PASSPHRASES"
1768 msgstr ""
1769
1770 #. type: textblock
1771 #: ../src/guestfs.pod:888
1772 msgid ""
1773 "Certain libguestfs calls take a parameter that contains sensitive key "
1774 "material, passed in as a C string."
1775 msgstr ""
1776
1777 #. type: textblock
1778 #: ../src/guestfs.pod:891
1779 msgid ""
1780 "In the future we would hope to change the libguestfs implementation so that "
1781 "keys are L<mlock(2)>-ed into physical RAM, and thus can never end up in "
1782 "swap.  However this is I<not> done at the moment, because of the complexity "
1783 "of such an implementation."
1784 msgstr ""
1785
1786 #. type: textblock
1787 #: ../src/guestfs.pod:896
1788 msgid ""
1789 "Therefore you should be aware that any key parameter you pass to libguestfs "
1790 "might end up being written out to the swap partition.  If this is a concern, "
1791 "scrub the swap partition or don't use libguestfs on encrypted devices."
1792 msgstr ""
1793
1794 #. type: =head2
1795 #: ../src/guestfs.pod:901
1796 msgid "MULTIPLE HANDLES AND MULTIPLE THREADS"
1797 msgstr ""
1798
1799 #. type: textblock
1800 #: ../src/guestfs.pod:903
1801 msgid ""
1802 "All high-level libguestfs actions are synchronous.  If you want to use "
1803 "libguestfs asynchronously then you must create a thread."
1804 msgstr ""
1805
1806 #. type: textblock
1807 #: ../src/guestfs.pod:906
1808 msgid ""
1809 "Only use the handle from a single thread.  Either use the handle exclusively "
1810 "from one thread, or provide your own mutex so that two threads cannot issue "
1811 "calls on the same handle at the same time."
1812 msgstr ""
1813
1814 #. type: textblock
1815 #: ../src/guestfs.pod:910
1816 msgid ""
1817 "See the graphical program guestfs-browser for one possible architecture for "
1818 "multithreaded programs using libvirt and libguestfs."
1819 msgstr ""
1820
1821 #. type: =head2
1822 #: ../src/guestfs.pod:913
1823 msgid "PATH"
1824 msgstr ""
1825
1826 #. type: textblock
1827 #: ../src/guestfs.pod:915
1828 msgid ""
1829 "Libguestfs needs a supermin appliance, which it finds by looking along an "
1830 "internal path."
1831 msgstr ""
1832
1833 #. type: textblock
1834 #: ../src/guestfs.pod:918
1835 msgid ""
1836 "By default it looks for these in the directory C<$libdir/guestfs> "
1837 "(eg. C</usr/local/lib/guestfs> or C</usr/lib64/guestfs>)."
1838 msgstr ""
1839
1840 #. type: textblock
1841 #: ../src/guestfs.pod:921
1842 msgid ""
1843 "Use L</guestfs_set_path> or set the environment variable L</LIBGUESTFS_PATH> "
1844 "to change the directories that libguestfs will search in.  The value is a "
1845 "colon-separated list of paths.  The current directory is I<not> searched "
1846 "unless the path contains an empty element or C<.>.  For example "
1847 "C<LIBGUESTFS_PATH=:/usr/lib/guestfs> would search the current directory and "
1848 "then C</usr/lib/guestfs>."
1849 msgstr ""
1850
1851 #. type: =head2
1852 #: ../src/guestfs.pod:928
1853 msgid "QEMU WRAPPERS"
1854 msgstr ""
1855
1856 #. type: textblock
1857 #: ../src/guestfs.pod:930
1858 msgid ""
1859 "If you want to compile your own qemu, run qemu from a non-standard location, "
1860 "or pass extra arguments to qemu, then you can write a shell-script wrapper "
1861 "around qemu."
1862 msgstr ""
1863
1864 #. type: textblock
1865 #: ../src/guestfs.pod:934
1866 msgid ""
1867 "There is one important rule to remember: you I<must C<exec qemu>> as the "
1868 "last command in the shell script (so that qemu replaces the shell and "
1869 "becomes the direct child of the libguestfs-using program).  If you don't do "
1870 "this, then the qemu process won't be cleaned up correctly."
1871 msgstr ""
1872
1873 #. type: textblock
1874 #: ../src/guestfs.pod:939
1875 msgid ""
1876 "Here is an example of a wrapper, where I have built my own copy of qemu from "
1877 "source:"
1878 msgstr ""
1879
1880 #. type: verbatim
1881 #: ../src/guestfs.pod:942
1882 #, no-wrap
1883 msgid ""
1884 " #!/bin/sh -\n"
1885 " qemudir=/home/rjones/d/qemu\n"
1886 " exec $qemudir/x86_64-softmmu/qemu-system-x86_64 -L $qemudir/pc-bios "
1887 "\"$@\"\n"
1888 "\n"
1889 msgstr ""
1890
1891 #. type: textblock
1892 #: ../src/guestfs.pod:946
1893 msgid ""
1894 "Save this script as C</tmp/qemu.wrapper> (or wherever), C<chmod +x>, and "
1895 "then use it by setting the LIBGUESTFS_QEMU environment variable.  For "
1896 "example:"
1897 msgstr ""
1898
1899 #. type: verbatim
1900 #: ../src/guestfs.pod:950
1901 #, no-wrap
1902 msgid ""
1903 " LIBGUESTFS_QEMU=/tmp/qemu.wrapper guestfish\n"
1904 "\n"
1905 msgstr ""
1906
1907 #. type: textblock
1908 #: ../src/guestfs.pod:952
1909 msgid ""
1910 "Note that libguestfs also calls qemu with the -help and -version options in "
1911 "order to determine features."
1912 msgstr ""
1913
1914 #. type: =head2
1915 #: ../src/guestfs.pod:955
1916 msgid "ABI GUARANTEE"
1917 msgstr ""
1918
1919 #. type: textblock
1920 #: ../src/guestfs.pod:957
1921 msgid ""
1922 "We guarantee the libguestfs ABI (binary interface), for public, high-level "
1923 "actions as outlined in this section.  Although we will deprecate some "
1924 "actions, for example if they get replaced by newer calls, we will keep the "
1925 "old actions forever.  This allows you the developer to program in confidence "
1926 "against the libguestfs API."
1927 msgstr ""
1928
1929 #. type: =head2
1930 #: ../src/guestfs.pod:963
1931 msgid "BLOCK DEVICE NAMING"
1932 msgstr ""
1933
1934 #. type: textblock
1935 #: ../src/guestfs.pod:965
1936 msgid ""
1937 "In the kernel there is now quite a profusion of schemata for naming block "
1938 "devices (in this context, by I<block device> I mean a physical or virtual "
1939 "hard drive).  The original Linux IDE driver used names starting with "
1940 "C</dev/hd*>.  SCSI devices have historically used a different naming scheme, "
1941 "C</dev/sd*>.  When the Linux kernel I<libata> driver became a popular "
1942 "replacement for the old IDE driver (particularly for SATA devices) those "
1943 "devices also used the C</dev/sd*> scheme.  Additionally we now have virtual "
1944 "machines with paravirtualized drivers.  This has created several different "
1945 "naming systems, such as C</dev/vd*> for virtio disks and C</dev/xvd*> for "
1946 "Xen PV disks."
1947 msgstr ""
1948
1949 #. type: textblock
1950 #: ../src/guestfs.pod:977
1951 msgid ""
1952 "As discussed above, libguestfs uses a qemu appliance running an embedded "
1953 "Linux kernel to access block devices.  We can run a variety of appliances "
1954 "based on a variety of Linux kernels."
1955 msgstr ""
1956
1957 #. type: textblock
1958 #: ../src/guestfs.pod:981
1959 msgid ""
1960 "This causes a problem for libguestfs because many API calls use device or "
1961 "partition names.  Working scripts and the recipe (example) scripts that we "
1962 "make available over the internet could fail if the naming scheme changes."
1963 msgstr ""
1964
1965 #. type: textblock
1966 #: ../src/guestfs.pod:986
1967 msgid ""
1968 "Therefore libguestfs defines C</dev/sd*> as the I<standard naming scheme>.  "
1969 "Internally C</dev/sd*> names are translated, if necessary, to other names as "
1970 "required.  For example, under RHEL 5 which uses the C</dev/hd*> scheme, any "
1971 "device parameter C</dev/sda2> is translated to C</dev/hda2> transparently."
1972 msgstr ""
1973
1974 #. type: textblock
1975 #: ../src/guestfs.pod:992
1976 msgid ""
1977 "Note that this I<only> applies to parameters.  The L</guestfs_list_devices>, "
1978 "L</guestfs_list_partitions> and similar calls return the true names of the "
1979 "devices and partitions as known to the appliance."
1980 msgstr ""
1981
1982 #. type: =head3
1983 #: ../src/guestfs.pod:997
1984 msgid "ALGORITHM FOR BLOCK DEVICE NAME TRANSLATION"
1985 msgstr ""
1986
1987 #. type: textblock
1988 #: ../src/guestfs.pod:999
1989 msgid ""
1990 "Usually this translation is transparent.  However in some (very rare)  cases "
1991 "you may need to know the exact algorithm.  Such cases include where you use "
1992 "L</guestfs_config> to add a mixture of virtio and IDE devices to the "
1993 "qemu-based appliance, so have a mixture of C</dev/sd*> and C</dev/vd*> "
1994 "devices."
1995 msgstr ""
1996
1997 #. type: textblock
1998 #: ../src/guestfs.pod:1005
1999 msgid ""
2000 "The algorithm is applied only to I<parameters> which are known to be either "
2001 "device or partition names.  Return values from functions such as "
2002 "L</guestfs_list_devices> are never changed."
2003 msgstr ""
2004
2005 #. type: textblock
2006 #: ../src/guestfs.pod:1013
2007 msgid "Is the string a parameter which is a device or partition name?"
2008 msgstr ""
2009
2010 #. type: textblock
2011 #: ../src/guestfs.pod:1017
2012 msgid "Does the string begin with C</dev/sd>?"
2013 msgstr ""
2014
2015 #. type: textblock
2016 #: ../src/guestfs.pod:1021
2017 msgid ""
2018 "Does the named device exist? If so, we use that device.  However if I<not> "
2019 "then we continue with this algorithm."
2020 msgstr ""
2021
2022 #. type: textblock
2023 #: ../src/guestfs.pod:1026
2024 msgid "Replace initial C</dev/sd> string with C</dev/hd>."
2025 msgstr ""
2026
2027 #. type: textblock
2028 #: ../src/guestfs.pod:1028
2029 msgid "For example, change C</dev/sda2> to C</dev/hda2>."
2030 msgstr ""
2031
2032 #. type: textblock
2033 #: ../src/guestfs.pod:1030
2034 msgid "If that named device exists, use it.  If not, continue."
2035 msgstr ""
2036
2037 #. type: textblock
2038 #: ../src/guestfs.pod:1034
2039 msgid "Replace initial C</dev/sd> string with C</dev/vd>."
2040 msgstr ""
2041
2042 #. type: textblock
2043 #: ../src/guestfs.pod:1036
2044 msgid "If that named device exists, use it.  If not, return an error."
2045 msgstr ""
2046
2047 #. type: =head3
2048 #: ../src/guestfs.pod:1040
2049 msgid "PORTABILITY CONCERNS WITH BLOCK DEVICE NAMING"
2050 msgstr ""
2051
2052 #. type: textblock
2053 #: ../src/guestfs.pod:1042
2054 msgid ""
2055 "Although the standard naming scheme and automatic translation is useful for "
2056 "simple programs and guestfish scripts, for larger programs it is best not to "
2057 "rely on this mechanism."
2058 msgstr ""
2059
2060 #. type: textblock
2061 #: ../src/guestfs.pod:1046
2062 msgid ""
2063 "Where possible for maximum future portability programs using libguestfs "
2064 "should use these future-proof techniques:"
2065 msgstr ""
2066
2067 #. type: textblock
2068 #: ../src/guestfs.pod:1053
2069 msgid ""
2070 "Use L</guestfs_list_devices> or L</guestfs_list_partitions> to list actual "
2071 "device names, and then use those names directly."
2072 msgstr ""
2073
2074 #. type: textblock
2075 #: ../src/guestfs.pod:1056
2076 msgid "Since those device names exist by definition, they will never be translated."
2077 msgstr ""
2078
2079 #. type: textblock
2080 #: ../src/guestfs.pod:1061
2081 msgid ""
2082 "Use higher level ways to identify filesystems, such as LVM names, UUIDs and "
2083 "filesystem labels."
2084 msgstr ""
2085
2086 #. type: =head1
2087 #: ../src/guestfs.pod:1066
2088 msgid "SECURITY"
2089 msgstr ""
2090
2091 #. type: textblock
2092 #: ../src/guestfs.pod:1068
2093 msgid ""
2094 "This section discusses security implications of using libguestfs, "
2095 "particularly with untrusted or malicious guests or disk images."
2096 msgstr ""
2097
2098 #. type: =head2
2099 #: ../src/guestfs.pod:1071
2100 msgid "GENERAL SECURITY CONSIDERATIONS"
2101 msgstr ""
2102
2103 #. type: textblock
2104 #: ../src/guestfs.pod:1073
2105 msgid ""
2106 "Be careful with any files or data that you download from a guest (by "
2107 "\"download\" we mean not just the L</guestfs_download> command but any "
2108 "command that reads files, filenames, directories or anything else from a "
2109 "disk image).  An attacker could manipulate the data to fool your program "
2110 "into doing the wrong thing.  Consider cases such as:"
2111 msgstr ""
2112
2113 #. type: textblock
2114 #: ../src/guestfs.pod:1083
2115 msgid "the data (file etc) not being present"
2116 msgstr ""
2117
2118 #. type: textblock
2119 #: ../src/guestfs.pod:1087
2120 msgid "being present but empty"
2121 msgstr ""
2122
2123 #. type: textblock
2124 #: ../src/guestfs.pod:1091
2125 msgid "being much larger than normal"
2126 msgstr ""
2127
2128 #. type: textblock
2129 #: ../src/guestfs.pod:1095
2130 msgid "containing arbitrary 8 bit data"
2131 msgstr ""
2132
2133 #. type: textblock
2134 #: ../src/guestfs.pod:1099
2135 msgid "being in an unexpected character encoding"
2136 msgstr ""
2137
2138 #. type: textblock
2139 #: ../src/guestfs.pod:1103
2140 msgid "containing homoglyphs."
2141 msgstr ""
2142
2143 #. type: =head2
2144 #: ../src/guestfs.pod:1107
2145 msgid "SECURITY OF MOUNTING FILESYSTEMS"
2146 msgstr ""
2147
2148 #. type: textblock
2149 #: ../src/guestfs.pod:1109
2150 msgid ""
2151 "When you mount a filesystem under Linux, mistakes in the kernel filesystem "
2152 "(VFS) module can sometimes be escalated into exploits by deliberately "
2153 "creating a malicious, malformed filesystem.  These exploits are very severe "
2154 "for two reasons.  Firstly there are very many filesystem drivers in the "
2155 "kernel, and many of them are infrequently used and not much developer "
2156 "attention has been paid to the code.  Linux userspace helps potential "
2157 "crackers by detecting the filesystem type and automatically choosing the "
2158 "right VFS driver, even if that filesystem type is obscure or unexpected for "
2159 "the administrator.  Secondly, a kernel-level exploit is like a local root "
2160 "exploit (worse in some ways), giving immediate and total access to the "
2161 "system right down to the hardware level."
2162 msgstr ""
2163
2164 #. type: textblock
2165 #: ../src/guestfs.pod:1122
2166 msgid ""
2167 "That explains why you should never mount a filesystem from an untrusted "
2168 "guest on your host kernel.  How about libguestfs? We run a Linux kernel "
2169 "inside a qemu virtual machine, usually running as a non-root user.  The "
2170 "attacker would need to write a filesystem which first exploited the kernel, "
2171 "and then exploited either qemu virtualization (eg. a faulty qemu driver) or "
2172 "the libguestfs protocol, and finally to be as serious as the host kernel "
2173 "exploit it would need to escalate its privileges to root.  This multi-step "
2174 "escalation, performed by a static piece of data, is thought to be extremely "
2175 "hard to do, although we never say 'never' about security issues."
2176 msgstr ""
2177
2178 #. type: textblock
2179 #: ../src/guestfs.pod:1133
2180 msgid ""
2181 "In any case callers can reduce the attack surface by forcing the filesystem "
2182 "type when mounting (use L</guestfs_mount_vfs>)."
2183 msgstr ""
2184
2185 #. type: =head2
2186 #: ../src/guestfs.pod:1136
2187 msgid "PROTOCOL SECURITY"
2188 msgstr ""
2189
2190 #. type: textblock
2191 #: ../src/guestfs.pod:1138
2192 msgid ""
2193 "The protocol is designed to be secure, being based on RFC 4506 (XDR)  with a "
2194 "defined upper message size.  However a program that uses libguestfs must "
2195 "also take care - for example you can write a program that downloads a binary "
2196 "from a disk image and executes it locally, and no amount of protocol "
2197 "security will save you from the consequences."
2198 msgstr ""
2199
2200 #. type: =head2
2201 #: ../src/guestfs.pod:1144
2202 msgid "INSPECTION SECURITY"
2203 msgstr ""
2204
2205 #. type: textblock
2206 #: ../src/guestfs.pod:1146
2207 msgid ""
2208 "Parts of the inspection API (see L</INSPECTION>) return untrusted strings "
2209 "directly from the guest, and these could contain any 8 bit data.  Callers "
2210 "should be careful to escape these before printing them to a structured file "
2211 "(for example, use HTML escaping if creating a web page)."
2212 msgstr ""
2213
2214 #. type: textblock
2215 #: ../src/guestfs.pod:1152
2216 msgid ""
2217 "Guest configuration may be altered in unusual ways by the administrator of "
2218 "the virtual machine, and may not reflect reality (particularly for untrusted "
2219 "or actively malicious guests).  For example we parse the hostname from "
2220 "configuration files like C</etc/sysconfig/network> that we find in the "
2221 "guest, but the guest administrator can easily manipulate these files to "
2222 "provide the wrong hostname."
2223 msgstr ""
2224
2225 #. type: textblock
2226 #: ../src/guestfs.pod:1160
2227 msgid ""
2228 "The inspection API parses guest configuration using two external libraries: "
2229 "Augeas (Linux configuration) and hivex (Windows Registry).  Both are "
2230 "designed to be robust in the face of malicious data, although denial of "
2231 "service attacks are still possible, for example with oversized configuration "
2232 "files."
2233 msgstr ""
2234
2235 #. type: =head2
2236 #: ../src/guestfs.pod:1166
2237 msgid "RUNNING UNTRUSTED GUEST COMMANDS"
2238 msgstr ""
2239
2240 #. type: textblock
2241 #: ../src/guestfs.pod:1168
2242 msgid ""
2243 "Be very cautious about running commands from the guest.  By running a "
2244 "command in the guest, you are giving CPU time to a binary that you do not "
2245 "control, under the same user account as the library, albeit wrapped in qemu "
2246 "virtualization.  More information and alternatives can be found in the "
2247 "section L</RUNNING COMMANDS>."
2248 msgstr ""
2249
2250 #. type: =head2
2251 #: ../src/guestfs.pod:1174
2252 msgid "CVE-2010-3851"
2253 msgstr ""
2254
2255 #. type: textblock
2256 #: ../src/guestfs.pod:1176
2257 msgid "https://bugzilla.redhat.com/642934"
2258 msgstr ""
2259
2260 #. type: textblock
2261 #: ../src/guestfs.pod:1178
2262 msgid ""
2263 "This security bug concerns the automatic disk format detection that qemu "
2264 "does on disk images."
2265 msgstr ""
2266
2267 #. type: textblock
2268 #: ../src/guestfs.pod:1181
2269 msgid ""
2270 "A raw disk image is just the raw bytes, there is no header.  Other disk "
2271 "images like qcow2 contain a special header.  Qemu deals with this by looking "
2272 "for one of the known headers, and if none is found then assuming the disk "
2273 "image must be raw."
2274 msgstr ""
2275
2276 #. type: textblock
2277 #: ../src/guestfs.pod:1186
2278 msgid ""
2279 "This allows a guest which has been given a raw disk image to write some "
2280 "other header.  At next boot (or when the disk image is accessed by "
2281 "libguestfs) qemu would do autodetection and think the disk image format was, "
2282 "say, qcow2 based on the header written by the guest."
2283 msgstr ""
2284
2285 #. type: textblock
2286 #: ../src/guestfs.pod:1191
2287 msgid ""
2288 "This in itself would not be a problem, but qcow2 offers many features, one "
2289 "of which is to allow a disk image to refer to another image (called the "
2290 "\"backing disk\").  It does this by placing the path to the backing disk "
2291 "into the qcow2 header.  This path is not validated and could point to any "
2292 "host file (eg. \"/etc/passwd\").  The backing disk is then exposed through "
2293 "\"holes\" in the qcow2 disk image, which of course is completely under the "
2294 "control of the attacker."
2295 msgstr ""
2296
2297 #. type: textblock
2298 #: ../src/guestfs.pod:1199
2299 msgid "In libguestfs this is rather hard to exploit except under two circumstances:"
2300 msgstr ""
2301
2302 #. type: textblock
2303 #: ../src/guestfs.pod:1206
2304 msgid "You have enabled the network or have opened the disk in write mode."
2305 msgstr ""
2306
2307 #. type: textblock
2308 #: ../src/guestfs.pod:1210
2309 msgid ""
2310 "You are also running untrusted code from the guest (see L</RUNNING "
2311 "COMMANDS>)."
2312 msgstr ""
2313
2314 #. type: textblock
2315 #: ../src/guestfs.pod:1215
2316 msgid ""
2317 "The way to avoid this is to specify the expected disk format when adding "
2318 "disks (the optional C<format> option to L</guestfs_add_drive_opts>).  You "
2319 "should always do this if the disk is raw format, and it's a good idea for "
2320 "other cases too."
2321 msgstr ""
2322
2323 #. type: textblock
2324 #: ../src/guestfs.pod:1220
2325 msgid ""
2326 "For disks added from libvirt using calls like L</guestfs_add_domain>, the "
2327 "format is fetched from libvirt and passed through."
2328 msgstr ""
2329
2330 #. type: textblock
2331 #: ../src/guestfs.pod:1223
2332 msgid ""
2333 "For libguestfs tools, use the I<--format> command line parameter as "
2334 "appropriate."
2335 msgstr ""
2336
2337 #. type: =head1
2338 #: ../src/guestfs.pod:1226
2339 msgid "CONNECTION MANAGEMENT"
2340 msgstr ""
2341
2342 #. type: =head2
2343 #: ../src/guestfs.pod:1228
2344 msgid "guestfs_h *"
2345 msgstr ""
2346
2347 #. type: textblock
2348 #: ../src/guestfs.pod:1230
2349 msgid ""
2350 "C<guestfs_h> is the opaque type representing a connection handle.  Create a "
2351 "handle by calling L</guestfs_create>.  Call L</guestfs_close> to free the "
2352 "handle and release all resources used."
2353 msgstr ""
2354
2355 #. type: textblock
2356 #: ../src/guestfs.pod:1234
2357 msgid ""
2358 "For information on using multiple handles and threads, see the section "
2359 "L</MULTIPLE HANDLES AND MULTIPLE THREADS> below."
2360 msgstr ""
2361
2362 #. type: =head2
2363 #: ../src/guestfs.pod:1237
2364 msgid "guestfs_create"
2365 msgstr ""
2366
2367 #. type: verbatim
2368 #: ../src/guestfs.pod:1239
2369 #, no-wrap
2370 msgid ""
2371 " guestfs_h *guestfs_create (void);\n"
2372 "\n"
2373 msgstr ""
2374
2375 #. type: textblock
2376 #: ../src/guestfs.pod:1241
2377 msgid "Create a connection handle."
2378 msgstr ""
2379
2380 #. type: textblock
2381 #: ../src/guestfs.pod:1243
2382 msgid ""
2383 "You have to call L</guestfs_add_drive_opts> (or one of the equivalent calls) "
2384 "on the handle at least once."
2385 msgstr ""
2386
2387 #. type: textblock
2388 #: ../src/guestfs.pod:1246
2389 msgid ""
2390 "This function returns a non-NULL pointer to a handle on success or NULL on "
2391 "error."
2392 msgstr ""
2393
2394 #. type: textblock
2395 #: ../src/guestfs.pod:1249
2396 msgid "After configuring the handle, you have to call L</guestfs_launch>."
2397 msgstr ""
2398
2399 #. type: textblock
2400 #: ../src/guestfs.pod:1251
2401 msgid ""
2402 "You may also want to configure error handling for the handle.  See L</ERROR "
2403 "HANDLING> section below."
2404 msgstr ""
2405
2406 #. type: =head2
2407 #: ../src/guestfs.pod:1254
2408 msgid "guestfs_close"
2409 msgstr ""
2410
2411 #. type: verbatim
2412 #: ../src/guestfs.pod:1256
2413 #, no-wrap
2414 msgid ""
2415 " void guestfs_close (guestfs_h *g);\n"
2416 "\n"
2417 msgstr ""
2418
2419 #. type: textblock
2420 #: ../src/guestfs.pod:1258
2421 msgid "This closes the connection handle and frees up all resources used."
2422 msgstr ""
2423
2424 #. type: =head1
2425 #: ../src/guestfs.pod:1260
2426 msgid "ERROR HANDLING"
2427 msgstr ""
2428
2429 #. type: textblock
2430 #: ../src/guestfs.pod:1262
2431 msgid ""
2432 "API functions can return errors.  For example, almost all functions that "
2433 "return C<int> will return C<-1> to indicate an error."
2434 msgstr ""
2435
2436 #. type: textblock
2437 #: ../src/guestfs.pod:1265
2438 msgid ""
2439 "Additional information is available for errors: an error message string and "
2440 "optionally an error number (errno) if the thing that failed was a system "
2441 "call."
2442 msgstr ""
2443
2444 #. type: textblock
2445 #: ../src/guestfs.pod:1269
2446 msgid ""
2447 "You can get at the additional information about the last error on the handle "
2448 "by calling L</guestfs_last_error>, L</guestfs_last_errno>, and/or by setting "
2449 "up an error handler with L</guestfs_set_error_handler>."
2450 msgstr ""
2451
2452 #. type: textblock
2453 #: ../src/guestfs.pod:1274
2454 msgid ""
2455 "When the handle is created, a default error handler is installed which "
2456 "prints the error message string to C<stderr>.  For small short-running "
2457 "command line programs it is sufficient to do:"
2458 msgstr ""
2459
2460 #. type: verbatim
2461 #: ../src/guestfs.pod:1278
2462 #, no-wrap
2463 msgid ""
2464 " if (guestfs_launch (g) == -1)\n"
2465 "   exit (EXIT_FAILURE);\n"
2466 "\n"
2467 msgstr ""
2468
2469 #. type: textblock
2470 #: ../src/guestfs.pod:1281
2471 msgid ""
2472 "since the default error handler will ensure that an error message has been "
2473 "printed to C<stderr> before the program exits."
2474 msgstr ""
2475
2476 #. type: textblock
2477 #: ../src/guestfs.pod:1284
2478 msgid ""
2479 "For other programs the caller will almost certainly want to install an "
2480 "alternate error handler or do error handling in-line like this:"
2481 msgstr ""
2482
2483 #. type: verbatim
2484 #: ../src/guestfs.pod:1287
2485 #, no-wrap
2486 msgid ""
2487 " g = guestfs_create ();\n"
2488 " \n"
2489 msgstr ""
2490
2491 #. type: verbatim
2492 #: ../src/guestfs.pod:1289
2493 #, no-wrap
2494 msgid ""
2495 " /* This disables the default behaviour of printing errors\n"
2496 "    on stderr. */\n"
2497 " guestfs_set_error_handler (g, NULL, NULL);\n"
2498 " \n"
2499 msgstr ""
2500
2501 #. type: verbatim
2502 #: ../src/guestfs.pod:1293
2503 #, no-wrap
2504 msgid ""
2505 " if (guestfs_launch (g) == -1) {\n"
2506 "   /* Examine the error message and print it etc. */\n"
2507 "   char *msg = guestfs_last_error (g);\n"
2508 "   int errnum = guestfs_last_errno (g);\n"
2509 "   fprintf (stderr, \"%s\\n\", msg);\n"
2510 "   /* ... */\n"
2511 "  }\n"
2512 "\n"
2513 msgstr ""
2514
2515 #. type: textblock
2516 #: ../src/guestfs.pod:1301
2517 msgid ""
2518 "Out of memory errors are handled differently.  The default action is to call "
2519 "L<abort(3)>.  If this is undesirable, then you can set a handler using "
2520 "L</guestfs_set_out_of_memory_handler>."
2521 msgstr ""
2522
2523 #. type: textblock
2524 #: ../src/guestfs.pod:1305
2525 msgid ""
2526 "L</guestfs_create> returns C<NULL> if the handle cannot be created, and "
2527 "because there is no handle if this happens there is no way to get additional "
2528 "error information.  However L</guestfs_create> is supposed to be a "
2529 "lightweight operation which can only fail because of insufficient memory (it "
2530 "returns NULL in this case)."
2531 msgstr ""
2532
2533 #. type: =head2
2534 #: ../src/guestfs.pod:1311
2535 msgid "guestfs_last_error"
2536 msgstr ""
2537
2538 #. type: verbatim
2539 #: ../src/guestfs.pod:1313
2540 #, no-wrap
2541 msgid ""
2542 " const char *guestfs_last_error (guestfs_h *g);\n"
2543 "\n"
2544 msgstr ""
2545
2546 #. type: textblock
2547 #: ../src/guestfs.pod:1315
2548 msgid ""
2549 "This returns the last error message that happened on C<g>.  If there has not "
2550 "been an error since the handle was created, then this returns C<NULL>."
2551 msgstr ""
2552
2553 #. type: textblock
2554 #: ../src/guestfs.pod:1319
2555 msgid ""
2556 "The lifetime of the returned string is until the next error occurs, or "
2557 "L</guestfs_close> is called."
2558 msgstr ""
2559
2560 #. type: =head2
2561 #: ../src/guestfs.pod:1322
2562 msgid "guestfs_last_errno"
2563 msgstr ""
2564
2565 #. type: verbatim
2566 #: ../src/guestfs.pod:1324
2567 #, no-wrap
2568 msgid ""
2569 " int guestfs_last_errno (guestfs_h *g);\n"
2570 "\n"
2571 msgstr ""
2572
2573 #. type: textblock
2574 #: ../src/guestfs.pod:1326
2575 msgid "This returns the last error number (errno) that happened on C<g>."
2576 msgstr ""
2577
2578 #. type: textblock
2579 #: ../src/guestfs.pod:1328
2580 msgid "If successful, an errno integer not equal to zero is returned."
2581 msgstr ""
2582
2583 #. type: textblock
2584 #: ../src/guestfs.pod:1330
2585 msgid "If no error, this returns 0.  This call can return 0 in three situations:"
2586 msgstr ""
2587
2588 #. type: textblock
2589 #: ../src/guestfs.pod:1337
2590 msgid "There has not been any error on the handle."
2591 msgstr ""
2592
2593 #. type: textblock
2594 #: ../src/guestfs.pod:1341
2595 msgid ""
2596 "There has been an error but the errno was meaningless.  This corresponds to "
2597 "the case where the error did not come from a failed system call, but for "
2598 "some other reason."
2599 msgstr ""
2600
2601 #. type: textblock
2602 #: ../src/guestfs.pod:1347
2603 msgid ""
2604 "There was an error from a failed system call, but for some reason the errno "
2605 "was not captured and returned.  This usually indicates a bug in libguestfs."
2606 msgstr ""
2607
2608 #. type: textblock
2609 #: ../src/guestfs.pod:1353
2610 msgid ""
2611 "Libguestfs tries to convert the errno from inside the applicance into a "
2612 "corresponding errno for the caller (not entirely trivial: the appliance "
2613 "might be running a completely different operating system from the library "
2614 "and error numbers are not standardized across Un*xen).  If this could not be "
2615 "done, then the error is translated to C<EINVAL>.  In practice this should "
2616 "only happen in very rare circumstances."
2617 msgstr ""
2618
2619 #. type: =head2
2620 #: ../src/guestfs.pod:1361
2621 msgid "guestfs_set_error_handler"
2622 msgstr ""
2623
2624 #. type: verbatim
2625 #: ../src/guestfs.pod:1363
2626 #, no-wrap
2627 msgid ""
2628 " typedef void (*guestfs_error_handler_cb) (guestfs_h *g,\n"
2629 "                                           void *opaque,\n"
2630 "                                           const char *msg);\n"
2631 " void guestfs_set_error_handler (guestfs_h *g,\n"
2632 "                                 guestfs_error_handler_cb cb,\n"
2633 "                                 void *opaque);\n"
2634 "\n"
2635 msgstr ""
2636
2637 #. type: textblock
2638 #: ../src/guestfs.pod:1370
2639 msgid ""
2640 "The callback C<cb> will be called if there is an error.  The parameters "
2641 "passed to the callback are an opaque data pointer and the error message "
2642 "string."
2643 msgstr ""
2644
2645 #. type: textblock
2646 #: ../src/guestfs.pod:1374
2647 msgid ""
2648 "C<errno> is not passed to the callback.  To get that the callback must call "
2649 "L</guestfs_last_errno>."
2650 msgstr ""
2651
2652 #. type: textblock
2653 #: ../src/guestfs.pod:1377
2654 msgid ""
2655 "Note that the message string C<msg> is freed as soon as the callback "
2656 "function returns, so if you want to stash it somewhere you must make your "
2657 "own copy."
2658 msgstr ""
2659
2660 #. type: textblock
2661 #: ../src/guestfs.pod:1381
2662 msgid "The default handler prints messages on C<stderr>."
2663 msgstr ""
2664
2665 #. type: textblock
2666 #: ../src/guestfs.pod:1383
2667 msgid "If you set C<cb> to C<NULL> then I<no> handler is called."
2668 msgstr ""
2669
2670 #. type: =head2
2671 #: ../src/guestfs.pod:1385
2672 msgid "guestfs_get_error_handler"
2673 msgstr ""
2674
2675 #. type: verbatim
2676 #: ../src/guestfs.pod:1387
2677 #, no-wrap
2678 msgid ""
2679 " guestfs_error_handler_cb guestfs_get_error_handler (guestfs_h *g,\n"
2680 "                                                     void **opaque_rtn);\n"
2681 "\n"
2682 msgstr ""
2683
2684 #. type: textblock
2685 #: ../src/guestfs.pod:1390
2686 msgid "Returns the current error handler callback."
2687 msgstr ""
2688
2689 #. type: =head2
2690 #: ../src/guestfs.pod:1392
2691 msgid "guestfs_set_out_of_memory_handler"
2692 msgstr ""
2693
2694 #. type: verbatim
2695 #: ../src/guestfs.pod:1394
2696 #, no-wrap
2697 msgid ""
2698 " typedef void (*guestfs_abort_cb) (void);\n"
2699 " void guestfs_set_out_of_memory_handler (guestfs_h *g,\n"
2700 "                                         guestfs_abort_cb);\n"
2701 "\n"
2702 msgstr ""
2703
2704 #. type: textblock
2705 #: ../src/guestfs.pod:1398
2706 msgid ""
2707 "The callback C<cb> will be called if there is an out of memory situation.  "
2708 "I<Note this callback must not return>."
2709 msgstr ""
2710
2711 #. type: textblock
2712 #: ../src/guestfs.pod:1401
2713 msgid "The default is to call L<abort(3)>."
2714 msgstr ""
2715
2716 #. type: textblock
2717 #: ../src/guestfs.pod:1403
2718 msgid "You cannot set C<cb> to C<NULL>.  You can't ignore out of memory situations."
2719 msgstr ""
2720
2721 #. type: =head2
2722 #: ../src/guestfs.pod:1406
2723 msgid "guestfs_get_out_of_memory_handler"
2724 msgstr ""
2725
2726 #. type: verbatim
2727 #: ../src/guestfs.pod:1408
2728 #, no-wrap
2729 msgid ""
2730 " guestfs_abort_fn guestfs_get_out_of_memory_handler (guestfs_h *g);\n"
2731 "\n"
2732 msgstr ""
2733
2734 #. type: textblock
2735 #: ../src/guestfs.pod:1410
2736 msgid "This returns the current out of memory handler."
2737 msgstr ""
2738
2739 #. type: =head1
2740 #: ../src/guestfs.pod:1412
2741 msgid "API CALLS"
2742 msgstr ""
2743
2744 #. type: textblock
2745 #: ../src/guestfs.pod:1414 ../fish/guestfish.pod:969
2746 msgid "@ACTIONS@"
2747 msgstr ""
2748
2749 #. type: =head1
2750 #: ../src/guestfs.pod:1416
2751 msgid "STRUCTURES"
2752 msgstr ""
2753
2754 #. type: textblock
2755 #: ../src/guestfs.pod:1418
2756 msgid "@STRUCTS@"
2757 msgstr ""
2758
2759 #. type: =head1
2760 #: ../src/guestfs.pod:1420
2761 msgid "AVAILABILITY"
2762 msgstr ""
2763
2764 #. type: =head2
2765 #: ../src/guestfs.pod:1422
2766 msgid "GROUPS OF FUNCTIONALITY IN THE APPLIANCE"
2767 msgstr ""
2768
2769 #. type: textblock
2770 #: ../src/guestfs.pod:1424
2771 msgid ""
2772 "Using L</guestfs_available> you can test availability of the following "
2773 "groups of functions.  This test queries the appliance to see if the "
2774 "appliance you are currently using supports the functionality."
2775 msgstr ""
2776
2777 #. type: textblock
2778 #: ../src/guestfs.pod:1429
2779 msgid "@AVAILABILITY@"
2780 msgstr ""
2781
2782 #. type: =head2
2783 #: ../src/guestfs.pod:1431
2784 msgid "GUESTFISH supported COMMAND"
2785 msgstr ""
2786
2787 #. type: textblock
2788 #: ../src/guestfs.pod:1433
2789 msgid ""
2790 "In L<guestfish(3)> there is a handy interactive command C<supported> which "
2791 "prints out the available groups and whether they are supported by this build "
2792 "of libguestfs.  Note however that you have to do C<run> first."
2793 msgstr ""
2794
2795 #. type: =head2
2796 #: ../src/guestfs.pod:1438
2797 msgid "SINGLE CALLS AT COMPILE TIME"
2798 msgstr ""
2799
2800 #. type: textblock
2801 #: ../src/guestfs.pod:1440
2802 msgid ""
2803 "Since version 1.5.8, C<E<lt>guestfs.hE<gt>> defines symbols for each C API "
2804 "function, such as:"
2805 msgstr ""
2806
2807 #. type: verbatim
2808 #: ../src/guestfs.pod:1443
2809 #, no-wrap
2810 msgid ""
2811 " #define LIBGUESTFS_HAVE_DD 1\n"
2812 "\n"
2813 msgstr ""
2814
2815 #. type: textblock
2816 #: ../src/guestfs.pod:1445
2817 msgid "if L</guestfs_dd> is available."
2818 msgstr ""
2819
2820 #. type: textblock
2821 #: ../src/guestfs.pod:1447
2822 msgid ""
2823 "Before version 1.5.8, if you needed to test whether a single libguestfs "
2824 "function is available at compile time, we recommended using build tools such "
2825 "as autoconf or cmake.  For example in autotools you could use:"
2826 msgstr ""
2827
2828 #. type: verbatim
2829 #: ../src/guestfs.pod:1452
2830 #, no-wrap
2831 msgid ""
2832 " AC_CHECK_LIB([guestfs],[guestfs_create])\n"
2833 " AC_CHECK_FUNCS([guestfs_dd])\n"
2834 "\n"
2835 msgstr ""
2836
2837 #. type: textblock
2838 #: ../src/guestfs.pod:1455
2839 msgid ""
2840 "which would result in C<HAVE_GUESTFS_DD> being either defined or not defined "
2841 "in your program."
2842 msgstr ""
2843
2844 #. type: =head2
2845 #: ../src/guestfs.pod:1458
2846 msgid "SINGLE CALLS AT RUN TIME"
2847 msgstr ""
2848
2849 #. type: textblock
2850 #: ../src/guestfs.pod:1460
2851 msgid ""
2852 "Testing at compile time doesn't guarantee that a function really exists in "
2853 "the library.  The reason is that you might be dynamically linked against a "
2854 "previous I<libguestfs.so> (dynamic library)  which doesn't have the call.  "
2855 "This situation unfortunately results in a segmentation fault, which is a "
2856 "shortcoming of the C dynamic linking system itself."
2857 msgstr ""
2858
2859 #. type: textblock
2860 #: ../src/guestfs.pod:1467
2861 msgid ""
2862 "You can use L<dlopen(3)> to test if a function is available at run time, as "
2863 "in this example program (note that you still need the compile time check as "
2864 "well):"
2865 msgstr ""
2866
2867 #. type: verbatim
2868 #: ../src/guestfs.pod:1471
2869 #, no-wrap
2870 msgid ""
2871 " #include <stdio.h>\n"
2872 " #include <stdlib.h>\n"
2873 " #include <unistd.h>\n"
2874 " #include <dlfcn.h>\n"
2875 " #include <guestfs.h>\n"
2876 " \n"
2877 msgstr ""
2878
2879 #. type: verbatim
2880 #: ../src/guestfs.pod:1477
2881 #, no-wrap
2882 msgid ""
2883 " main ()\n"
2884 " {\n"
2885 " #ifdef LIBGUESTFS_HAVE_DD\n"
2886 "   void *dl;\n"
2887 "   int has_function;\n"
2888 " \n"
2889 msgstr ""
2890
2891 #. type: verbatim
2892 #: ../src/guestfs.pod:1483
2893 #, no-wrap
2894 msgid ""
2895 "   /* Test if the function guestfs_dd is really available. */\n"
2896 "   dl = dlopen (NULL, RTLD_LAZY);\n"
2897 "   if (!dl) {\n"
2898 "     fprintf (stderr, \"dlopen: %s\\n\", dlerror ());\n"
2899 "     exit (EXIT_FAILURE);\n"
2900 "   }\n"
2901 "   has_function = dlsym (dl, \"guestfs_dd\") != NULL;\n"
2902 "   dlclose (dl);\n"
2903 " \n"
2904 msgstr ""
2905
2906 #. type: verbatim
2907 #: ../src/guestfs.pod:1492
2908 #, no-wrap
2909 msgid ""
2910 "   if (!has_function)\n"
2911 "     printf (\"this libguestfs.so does NOT have guestfs_dd function\\n\");\n"
2912 "   else {\n"
2913 "     printf (\"this libguestfs.so has guestfs_dd function\\n\");\n"
2914 "     /* Now it's safe to call\n"
2915 "     guestfs_dd (g, \"foo\", \"bar\");\n"
2916 "     */\n"
2917 "   }\n"
2918 " #else\n"
2919 "   printf (\"guestfs_dd function was not found at compile time\\n\");\n"
2920 " #endif\n"
2921 "  }\n"
2922 "\n"
2923 msgstr ""
2924
2925 #. type: textblock
2926 #: ../src/guestfs.pod:1505
2927 msgid ""
2928 "You may think the above is an awful lot of hassle, and it is.  There are "
2929 "other ways outside of the C linking system to ensure that this kind of "
2930 "incompatibility never arises, such as using package versioning:"
2931 msgstr ""
2932
2933 #. type: verbatim
2934 #: ../src/guestfs.pod:1510
2935 #, no-wrap
2936 msgid ""
2937 " Requires: libguestfs >= 1.0.80\n"
2938 "\n"
2939 msgstr ""
2940
2941 #. type: =head1
2942 #: ../src/guestfs.pod:1512
2943 msgid "CALLS WITH OPTIONAL ARGUMENTS"
2944 msgstr ""
2945
2946 #. type: textblock
2947 #: ../src/guestfs.pod:1514
2948 msgid ""
2949 "A recent feature of the API is the introduction of calls which take optional "
2950 "arguments.  In C these are declared 3 ways.  The main way is as a call which "
2951 "takes variable arguments (ie. C<...>), as in this example:"
2952 msgstr ""
2953
2954 #. type: verbatim
2955 #: ../src/guestfs.pod:1519
2956 #, no-wrap
2957 msgid ""
2958 " int guestfs_add_drive_opts (guestfs_h *g, const char *filename, ...);\n"
2959 "\n"
2960 msgstr ""
2961
2962 #. type: textblock
2963 #: ../src/guestfs.pod:1521
2964 msgid ""
2965 "Call this with a list of optional arguments, terminated by C<-1>.  So to "
2966 "call with no optional arguments specified:"
2967 msgstr ""
2968
2969 #. type: verbatim
2970 #: ../src/guestfs.pod:1524
2971 #, no-wrap
2972 msgid ""
2973 " guestfs_add_drive_opts (g, filename, -1);\n"
2974 "\n"
2975 msgstr ""
2976
2977 #. type: textblock
2978 #: ../src/guestfs.pod:1526
2979 msgid "With a single optional argument:"
2980 msgstr ""
2981
2982 #. type: verbatim
2983 #: ../src/guestfs.pod:1528
2984 #, no-wrap
2985 msgid ""
2986 " guestfs_add_drive_opts (g, filename,\n"
2987 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"qcow2\",\n"
2988 "                         -1);\n"
2989 "\n"
2990 msgstr ""
2991
2992 #. type: textblock
2993 #: ../src/guestfs.pod:1532
2994 msgid "With two:"
2995 msgstr ""
2996
2997 #. type: verbatim
2998 #: ../src/guestfs.pod:1534
2999 #, no-wrap
3000 msgid ""
3001 " guestfs_add_drive_opts (g, filename,\n"
3002 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"qcow2\",\n"
3003 "                         GUESTFS_ADD_DRIVE_OPTS_READONLY, 1,\n"
3004 "                         -1);\n"
3005 "\n"
3006 msgstr ""
3007
3008 #. type: textblock
3009 #: ../src/guestfs.pod:1539
3010 msgid ""
3011 "and so forth.  Don't forget the terminating C<-1> otherwise Bad Things will "
3012 "happen!"
3013 msgstr ""
3014
3015 #. type: =head2
3016 #: ../src/guestfs.pod:1542
3017 msgid "USING va_list FOR OPTIONAL ARGUMENTS"
3018 msgstr ""
3019
3020 #. type: textblock
3021 #: ../src/guestfs.pod:1544
3022 msgid ""
3023 "The second variant has the same name with the suffix C<_va>, which works the "
3024 "same way but takes a C<va_list>.  See the C manual for details.  For the "
3025 "example function, this is declared:"
3026 msgstr ""
3027
3028 #. type: verbatim
3029 #: ../src/guestfs.pod:1548
3030 #, no-wrap
3031 msgid ""
3032 " int guestfs_add_drive_opts_va (guestfs_h *g, const char *filename,\n"
3033 "                                va_list args);\n"
3034 "\n"
3035 msgstr ""
3036
3037 #. type: =head2
3038 #: ../src/guestfs.pod:1551
3039 msgid "CONSTRUCTING OPTIONAL ARGUMENTS"
3040 msgstr ""
3041
3042 #. type: textblock
3043 #: ../src/guestfs.pod:1553
3044 msgid ""
3045 "The third variant is useful where you need to construct these calls.  You "
3046 "pass in a structure where you fill in the optional fields.  The structure "
3047 "has a bitmask as the first element which you must set to indicate which "
3048 "fields you have filled in.  For our example function the structure and call "
3049 "are declared:"
3050 msgstr ""
3051
3052 #. type: verbatim
3053 #: ../src/guestfs.pod:1559
3054 #, no-wrap
3055 msgid ""
3056 " struct guestfs_add_drive_opts_argv {\n"
3057 "   uint64_t bitmask;\n"
3058 "   int readonly;\n"
3059 "   const char *format;\n"
3060 "   /* ... */\n"
3061 " };\n"
3062 " int guestfs_add_drive_opts_argv (guestfs_h *g, const char *filename,\n"
3063 "              const struct guestfs_add_drive_opts_argv *optargs);\n"
3064 "\n"
3065 msgstr ""
3066
3067 #. type: textblock
3068 #: ../src/guestfs.pod:1568
3069 msgid "You could call it like this:"
3070 msgstr ""
3071
3072 #. type: verbatim
3073 #: ../src/guestfs.pod:1570
3074 #, no-wrap
3075 msgid ""
3076 " struct guestfs_add_drive_opts_argv optargs = {\n"
3077 "   .bitmask = GUESTFS_ADD_DRIVE_OPTS_READONLY_BITMASK |\n"
3078 "              GUESTFS_ADD_DRIVE_OPTS_FORMAT_BITMASK,\n"
3079 "   .readonly = 1,\n"
3080 "   .format = \"qcow2\"\n"
3081 " };\n"
3082 " \n"
3083 msgstr ""
3084
3085 #. type: verbatim
3086 #: ../src/guestfs.pod:1577
3087 #, no-wrap
3088 msgid ""
3089 " guestfs_add_drive_opts_argv (g, filename, &optargs);\n"
3090 "\n"
3091 msgstr ""
3092
3093 #. type: textblock
3094 #: ../src/guestfs.pod:1579 ../src/guestfs-actions.pod:11 ../src/guestfs-actions.pod:1844 ../src/guestfs-actions.pod:2234 ../fish/guestfish-actions.pod:9 ../fish/guestfish-actions.pod:1255 ../fish/guestfish-actions.pod:1502 ../tools/virt-win-reg.pl:532
3095 msgid "Notes:"
3096 msgstr ""
3097
3098 #. type: textblock
3099 #: ../src/guestfs.pod:1585
3100 msgid "The C<_BITMASK> suffix on each option name when specifying the bitmask."
3101 msgstr ""
3102
3103 #. type: textblock
3104 #: ../src/guestfs.pod:1590
3105 msgid "You do not need to fill in all fields of the structure."
3106 msgstr ""
3107
3108 #. type: textblock
3109 #: ../src/guestfs.pod:1594
3110 msgid ""
3111 "There must be a one-to-one correspondence between fields of the structure "
3112 "that are filled in, and bits set in the bitmask."
3113 msgstr ""
3114
3115 #. type: =head2
3116 #: ../src/guestfs.pod:1599
3117 msgid "OPTIONAL ARGUMENTS IN OTHER LANGUAGES"
3118 msgstr ""
3119
3120 #. type: textblock
3121 #: ../src/guestfs.pod:1601
3122 msgid ""
3123 "In other languages, optional arguments are expressed in the way that is "
3124 "natural for that language.  We refer you to the language-specific "
3125 "documentation for more details on that."
3126 msgstr ""
3127
3128 #. type: textblock
3129 #: ../src/guestfs.pod:1605
3130 msgid "For guestfish, see L<guestfish(1)/OPTIONAL ARGUMENTS>."
3131 msgstr ""
3132
3133 #. type: =head2
3134 #: ../src/guestfs.pod:1607
3135 msgid "SETTING CALLBACKS TO HANDLE EVENTS"
3136 msgstr ""
3137
3138 #. type: textblock
3139 #: ../src/guestfs.pod:1609
3140 msgid ""
3141 "The child process generates events in some situations.  Current events "
3142 "include: receiving a log message, the child process exits."
3143 msgstr ""
3144
3145 #. type: textblock
3146 #: ../src/guestfs.pod:1612
3147 msgid ""
3148 "Use the C<guestfs_set_*_callback> functions to set a callback for different "
3149 "types of events."
3150 msgstr ""
3151
3152 #. type: textblock
3153 #: ../src/guestfs.pod:1615
3154 msgid ""
3155 "Only I<one callback of each type> can be registered for each handle.  "
3156 "Calling C<guestfs_set_*_callback> again overwrites the previous callback of "
3157 "that type.  Cancel all callbacks of this type by calling this function with "
3158 "C<cb> set to C<NULL>."
3159 msgstr ""
3160
3161 #. type: =head2
3162 #: ../src/guestfs.pod:1620
3163 msgid "guestfs_set_log_message_callback"
3164 msgstr ""
3165
3166 #. type: verbatim
3167 #: ../src/guestfs.pod:1622
3168 #, no-wrap
3169 msgid ""
3170 " typedef void (*guestfs_log_message_cb) (guestfs_h *g, void *opaque,\n"
3171 "                                         char *buf, int len);\n"
3172 " void guestfs_set_log_message_callback (guestfs_h *g,\n"
3173 "                                        guestfs_log_message_cb cb,\n"
3174 "                                        void *opaque);\n"
3175 "\n"
3176 msgstr ""
3177
3178 #. type: textblock
3179 #: ../src/guestfs.pod:1628
3180 msgid ""
3181 "The callback function C<cb> will be called whenever qemu or the guest writes "
3182 "anything to the console."
3183 msgstr ""
3184
3185 #. type: textblock
3186 #: ../src/guestfs.pod:1631
3187 msgid "Use this function to capture kernel messages and similar."
3188 msgstr ""
3189
3190 #. type: textblock
3191 #: ../src/guestfs.pod:1633
3192 msgid ""
3193 "Normally there is no log message handler, and log messages are just "
3194 "discarded."
3195 msgstr ""
3196
3197 #. type: =head2
3198 #: ../src/guestfs.pod:1636
3199 msgid "guestfs_set_subprocess_quit_callback"
3200 msgstr ""
3201
3202 #. type: verbatim
3203 #: ../src/guestfs.pod:1638
3204 #, no-wrap
3205 msgid ""
3206 " typedef void (*guestfs_subprocess_quit_cb) (guestfs_h *g, void *opaque);\n"
3207 " void guestfs_set_subprocess_quit_callback (guestfs_h *g,\n"
3208 "                                            guestfs_subprocess_quit_cb cb,\n"
3209 "                                            void *opaque);\n"
3210 "\n"
3211 msgstr ""
3212
3213 #. type: textblock
3214 #: ../src/guestfs.pod:1643
3215 msgid ""
3216 "The callback function C<cb> will be called when the child process quits, "
3217 "either asynchronously or if killed by L</guestfs_kill_subprocess>.  (This "
3218 "corresponds to a transition from any state to the CONFIG state)."
3219 msgstr ""
3220
3221 #. type: =head2
3222 #: ../src/guestfs.pod:1648
3223 msgid "guestfs_set_launch_done_callback"
3224 msgstr ""
3225
3226 #. type: verbatim
3227 #: ../src/guestfs.pod:1650
3228 #, no-wrap
3229 msgid ""
3230 " typedef void (*guestfs_launch_done_cb) (guestfs_h *g, void *opaque);\n"
3231 " void guestfs_set_launch_done_callback (guestfs_h *g,\n"
3232 "                                        guestfs_launch_done_cb cb,\n"
3233 "                                        void *opaque);\n"
3234 "\n"
3235 msgstr ""
3236
3237 #. type: textblock
3238 #: ../src/guestfs.pod:1655
3239 msgid ""
3240 "The callback function C<cb> will be called when the child process becomes "
3241 "ready first time after it has been launched.  (This corresponds to a "
3242 "transition from LAUNCHING to the READY state)."
3243 msgstr ""
3244
3245 #. type: =head2
3246 #: ../src/guestfs.pod:1659
3247 msgid "guestfs_set_close_callback"
3248 msgstr ""
3249
3250 #. type: verbatim
3251 #: ../src/guestfs.pod:1661
3252 #, no-wrap
3253 msgid ""
3254 " typedef void (*guestfs_close_cb) (guestfs_h *g, void *opaque);\n"
3255 " void guestfs_set_close_callback (guestfs_h *g,\n"
3256 "                                  guestfs_close_cb cb,\n"
3257 "                                  void *opaque);\n"
3258 "\n"
3259 msgstr ""
3260
3261 #. type: textblock
3262 #: ../src/guestfs.pod:1666
3263 msgid ""
3264 "The callback function C<cb> will be called while the handle is being closed "
3265 "(synchronously from L</guestfs_close>)."
3266 msgstr ""
3267
3268 #. type: textblock
3269 #: ../src/guestfs.pod:1669
3270 msgid ""
3271 "Note that libguestfs installs an L<atexit(3)> handler to try to clean up "
3272 "handles that are open when the program exits.  This means that this callback "
3273 "might be called indirectly from L<exit(3)>, which can cause unexpected "
3274 "problems in higher-level languages (eg. if your HLL interpreter has already "
3275 "been cleaned up by the time this is called, and if your callback then jumps "
3276 "into some HLL function)."
3277 msgstr ""
3278
3279 #. type: =head2
3280 #: ../src/guestfs.pod:1677
3281 msgid "guestfs_set_progress_callback"
3282 msgstr ""
3283
3284 #. type: verbatim
3285 #: ../src/guestfs.pod:1679
3286 #, no-wrap
3287 msgid ""
3288 " typedef void (*guestfs_progress_cb) (guestfs_h *g, void *opaque,\n"
3289 "                                      int proc_nr, int serial,\n"
3290 "                                      uint64_t position, uint64_t total);\n"
3291 " void guestfs_set_progress_callback (guestfs_h *g,\n"
3292 "                                     guestfs_progress_cb cb,\n"
3293 "                                     void *opaque);\n"
3294 "\n"
3295 msgstr ""
3296
3297 #. type: textblock
3298 #: ../src/guestfs.pod:1686
3299 msgid ""
3300 "Some long-running operations can generate progress messages.  If this "
3301 "callback is registered, then it will be called each time a progress message "
3302 "is generated (usually two seconds after the operation started, and three "
3303 "times per second thereafter until it completes, although the frequency may "
3304 "change in future versions)."
3305 msgstr ""
3306
3307 #. type: textblock
3308 #: ../src/guestfs.pod:1692
3309 msgid ""
3310 "The callback receives two numbers: C<position> and C<total>.  The units of "
3311 "C<total> are not defined, although for some operations C<total> may relate "
3312 "in some way to the amount of data to be transferred (eg. in bytes or "
3313 "megabytes), and C<position> may be the portion which has been transferred."
3314 msgstr ""
3315
3316 #. type: textblock
3317 #: ../src/guestfs.pod:1698
3318 msgid "The only defined and stable parts of the API are:"
3319 msgstr ""
3320
3321 #. type: textblock
3322 #: ../src/guestfs.pod:1704
3323 msgid ""
3324 "The callback can display to the user some type of progress bar or indicator "
3325 "which shows the ratio of C<position>:C<total>."
3326 msgstr ""
3327
3328 #. type: textblock
3329 #: ../src/guestfs.pod:1709
3330 msgid "0 E<lt>= C<position> E<lt>= C<total>"
3331 msgstr ""
3332
3333 #. type: textblock
3334 #: ../src/guestfs.pod:1713
3335 msgid ""
3336 "If any progress notification is sent during a call, then a final progress "
3337 "notification is always sent when C<position> = C<total> (I<unless> the call "
3338 "fails with an error)."
3339 msgstr ""
3340
3341 #. type: textblock
3342 #: ../src/guestfs.pod:1717
3343 msgid ""
3344 "This is to simplify caller code, so callers can easily set the progress "
3345 "indicator to \"100%\" at the end of the operation, without requiring special "
3346 "code to detect this case."
3347 msgstr ""
3348
3349 #. type: textblock
3350 #: ../src/guestfs.pod:1723
3351 msgid ""
3352 "The callback also receives the procedure number and serial number of the "
3353 "call.  These are only useful for debugging protocol issues, and the callback "
3354 "can normally ignore them.  The callback may want to print these numbers in "
3355 "error messages or debugging messages."
3356 msgstr ""
3357
3358 #. type: =head1
3359 #: ../src/guestfs.pod:1728
3360 msgid "PRIVATE DATA AREA"
3361 msgstr ""
3362
3363 #. type: textblock
3364 #: ../src/guestfs.pod:1730
3365 msgid ""
3366 "You can attach named pieces of private data to the libguestfs handle, and "
3367 "fetch them by name for the lifetime of the handle.  This is called the "
3368 "private data area and is only available from the C API."
3369 msgstr ""
3370
3371 #. type: textblock
3372 #: ../src/guestfs.pod:1734
3373 msgid "To attach a named piece of data, use the following call:"
3374 msgstr ""
3375
3376 #. type: verbatim
3377 #: ../src/guestfs.pod:1736
3378 #, no-wrap
3379 msgid ""
3380 " void guestfs_set_private (guestfs_h *g, const char *key, void *data);\n"
3381 "\n"
3382 msgstr ""
3383
3384 #. type: textblock
3385 #: ../src/guestfs.pod:1738
3386 msgid ""
3387 "C<key> is the name to associate with this data, and C<data> is an arbitrary "
3388 "pointer (which can be C<NULL>).  Any previous item with the same name is "
3389 "overwritten."
3390 msgstr ""
3391
3392 #. type: textblock
3393 #: ../src/guestfs.pod:1742
3394 msgid ""
3395 "You can use any C<key> you want, but names beginning with an underscore "
3396 "character are reserved for internal libguestfs purposes (for implementing "
3397 "language bindings).  It is recommended to prefix the name with some unique "
3398 "string to avoid collisions with other users."
3399 msgstr ""
3400
3401 #. type: textblock
3402 #: ../src/guestfs.pod:1747
3403 msgid "To retrieve the pointer, use:"
3404 msgstr ""
3405
3406 #. type: verbatim
3407 #: ../src/guestfs.pod:1749
3408 #, no-wrap
3409 msgid ""
3410 " void *guestfs_get_private (guestfs_h *g, const char *key);\n"
3411 "\n"
3412 msgstr ""
3413
3414 #. type: textblock
3415 #: ../src/guestfs.pod:1751
3416 msgid ""
3417 "This function returns C<NULL> if either no data is found associated with "
3418 "C<key>, or if the user previously set the C<key>'s C<data> pointer to "
3419 "C<NULL>."
3420 msgstr ""
3421
3422 #. type: textblock
3423 #: ../src/guestfs.pod:1755
3424 msgid ""
3425 "Libguestfs does not try to look at or interpret the C<data> pointer in any "
3426 "way.  As far as libguestfs is concerned, it need not be a valid pointer at "
3427 "all.  In particular, libguestfs does I<not> try to free the data when the "
3428 "handle is closed.  If the data must be freed, then the caller must either "
3429 "free it before calling L</guestfs_close> or must set up a close callback to "
3430 "do it (see L</guestfs_set_close_callback>, and note that only one callback "
3431 "can be registered for a handle)."
3432 msgstr ""
3433
3434 #. type: textblock
3435 #: ../src/guestfs.pod:1763
3436 msgid ""
3437 "The private data area is implemented using a hash table, and should be "
3438 "reasonably efficient for moderate numbers of keys."
3439 msgstr ""
3440
3441 #. type: =end
3442 #: ../src/guestfs.pod:1766 ../src/guestfs.pod:1771
3443 msgid "html"
3444 msgstr ""
3445
3446 #. type: textblock
3447 #: ../src/guestfs.pod:1768
3448 msgid ""
3449 "<!-- old anchor for the next section --> <a "
3450 "name=\"state_machine_and_low_level_event_api\"/>"
3451 msgstr ""
3452
3453 #. type: =head1
3454 #: ../src/guestfs.pod:1773
3455 msgid "ARCHITECTURE"
3456 msgstr ""
3457
3458 #. type: textblock
3459 #: ../src/guestfs.pod:1775
3460 msgid ""
3461 "Internally, libguestfs is implemented by running an appliance (a special "
3462 "type of small virtual machine) using L<qemu(1)>.  Qemu runs as a child "
3463 "process of the main program."
3464 msgstr ""
3465
3466 #. type: verbatim
3467 #: ../src/guestfs.pod:1779
3468 #, no-wrap
3469 msgid ""
3470 "  ___________________\n"
3471 " /                   \\\n"
3472 " | main program      |\n"
3473 " |                   |\n"
3474 " |                   |           child process / appliance\n"
3475 " |                   |           __________________________\n"
3476 " |                   |          / qemu                     \\\n"
3477 " +-------------------+   RPC    |      +-----------------+ |\n"
3478 " | libguestfs     <--------------------> guestfsd        | |\n"
3479 " |                   |          |      +-----------------+ |\n"
3480 " \\___________________/          |      | Linux kernel    | |\n"
3481 "                                |      +--^--------------+ |\n"
3482 "                                \\_________|________________/\n"
3483 "                                          |\n"
3484 "                                   _______v______\n"
3485 "                                  /              \\\n"
3486 "                                  | Device or    |\n"
3487 "                                  | disk image   |\n"
3488 "                                  \\______________/\n"
3489 "\n"
3490 msgstr ""
3491
3492 #. type: textblock
3493 #: ../src/guestfs.pod:1799
3494 msgid ""
3495 "The library, linked to the main program, creates the child process and hence "
3496 "the appliance in the L</guestfs_launch> function."
3497 msgstr ""
3498
3499 #. type: textblock
3500 #: ../src/guestfs.pod:1802
3501 msgid ""
3502 "Inside the appliance is a Linux kernel and a complete stack of userspace "
3503 "tools (such as LVM and ext2 programs) and a small controlling daemon called "
3504 "L</guestfsd>.  The library talks to L</guestfsd> using remote procedure "
3505 "calls (RPC).  There is a mostly one-to-one correspondence between libguestfs "
3506 "API calls and RPC calls to the daemon.  Lastly the disk image(s) are "
3507 "attached to the qemu process which translates device access by the "
3508 "appliance's Linux kernel into accesses to the image."
3509 msgstr ""
3510
3511 #. type: textblock
3512 #: ../src/guestfs.pod:1811
3513 msgid ""
3514 "A common misunderstanding is that the appliance \"is\" the virtual machine.  "
3515 "Although the disk image you are attached to might also be used by some "
3516 "virtual machine, libguestfs doesn't know or care about this.  (But you will "
3517 "care if both libguestfs's qemu process and your virtual machine are trying "
3518 "to update the disk image at the same time, since these usually results in "
3519 "massive disk corruption)."
3520 msgstr ""
3521
3522 #. type: =head1
3523 #: ../src/guestfs.pod:1818
3524 msgid "STATE MACHINE"
3525 msgstr ""
3526
3527 #. type: textblock
3528 #: ../src/guestfs.pod:1820
3529 msgid "libguestfs uses a state machine to model the child process:"
3530 msgstr ""
3531
3532 #. type: verbatim
3533 #: ../src/guestfs.pod:1822
3534 #, no-wrap
3535 msgid ""
3536 "                         |\n"
3537 "                    guestfs_create\n"
3538 "                         |\n"
3539 "                         |\n"
3540 "                     ____V_____\n"
3541 "                    /          \\\n"
3542 "                    |  CONFIG  |\n"
3543 "                    \\__________/\n"
3544 "                     ^ ^   ^  \\\n"
3545 "                    /  |    \\  \\ guestfs_launch\n"
3546 "                   /   |    _\\__V______\n"
3547 "                  /    |   /           \\\n"
3548 "                 /     |   | LAUNCHING |\n"
3549 "                /      |   \\___________/\n"
3550 "               /       |       /\n"
3551 "              /        |  guestfs_launch\n"
3552 "             /         |     /\n"
3553 "    ______  /        __|____V\n"
3554 "   /      \\ ------> /        \\\n"
3555 "   | BUSY |         | READY  |\n"
3556 "   \\______/ <------ \\________/\n"
3557 "\n"
3558 msgstr ""
3559
3560 #. type: textblock
3561 #: ../src/guestfs.pod:1844
3562 msgid ""
3563 "The normal transitions are (1) CONFIG (when the handle is created, but there "
3564 "is no child process), (2) LAUNCHING (when the child process is booting up), "
3565 "(3) alternating between READY and BUSY as commands are issued to, and "
3566 "carried out by, the child process."
3567 msgstr ""
3568
3569 #. type: textblock
3570 #: ../src/guestfs.pod:1849
3571 msgid ""
3572 "The guest may be killed by L</guestfs_kill_subprocess>, or may die "
3573 "asynchronously at any time (eg. due to some internal error), and that causes "
3574 "the state to transition back to CONFIG."
3575 msgstr ""
3576
3577 #. type: textblock
3578 #: ../src/guestfs.pod:1853
3579 msgid ""
3580 "Configuration commands for qemu such as L</guestfs_add_drive> can only be "
3581 "issued when in the CONFIG state."
3582 msgstr ""
3583
3584 #. type: textblock
3585 #: ../src/guestfs.pod:1856
3586 msgid ""
3587 "The API offers one call that goes from CONFIG through LAUNCHING to READY.  "
3588 "L</guestfs_launch> blocks until the child process is READY to accept "
3589 "commands (or until some failure or timeout).  L</guestfs_launch> internally "
3590 "moves the state from CONFIG to LAUNCHING while it is running."
3591 msgstr ""
3592
3593 #. type: textblock
3594 #: ../src/guestfs.pod:1862
3595 msgid ""
3596 "API actions such as L</guestfs_mount> can only be issued when in the READY "
3597 "state.  These API calls block waiting for the command to be carried out "
3598 "(ie. the state to transition to BUSY and then back to READY).  There are no "
3599 "non-blocking versions, and no way to issue more than one command per handle "
3600 "at the same time."
3601 msgstr ""
3602
3603 #. type: textblock
3604 #: ../src/guestfs.pod:1868
3605 msgid ""
3606 "Finally, the child process sends asynchronous messages back to the main "
3607 "program, such as kernel log messages.  You can register a callback to "
3608 "receive these messages."
3609 msgstr ""
3610
3611 #. type: =head1
3612 #: ../src/guestfs.pod:1872
3613 msgid "INTERNALS"
3614 msgstr ""
3615
3616 #. type: =head2
3617 #: ../src/guestfs.pod:1874
3618 msgid "COMMUNICATION PROTOCOL"
3619 msgstr ""
3620
3621 #. type: textblock
3622 #: ../src/guestfs.pod:1876
3623 msgid ""
3624 "Don't rely on using this protocol directly.  This section documents how it "
3625 "currently works, but it may change at any time."
3626 msgstr ""
3627
3628 #. type: textblock
3629 #: ../src/guestfs.pod:1879
3630 msgid ""
3631 "The protocol used to talk between the library and the daemon running inside "
3632 "the qemu virtual machine is a simple RPC mechanism built on top of XDR (RFC "
3633 "1014, RFC 1832, RFC 4506)."
3634 msgstr ""
3635
3636 #. type: textblock
3637 #: ../src/guestfs.pod:1883
3638 msgid ""
3639 "The detailed format of structures is in C<src/guestfs_protocol.x> (note: "
3640 "this file is automatically generated)."
3641 msgstr ""
3642
3643 #. type: textblock
3644 #: ../src/guestfs.pod:1886
3645 msgid ""
3646 "There are two broad cases, ordinary functions that don't have any C<FileIn> "
3647 "and C<FileOut> parameters, which are handled with very simple request/reply "
3648 "messages.  Then there are functions that have any C<FileIn> or C<FileOut> "
3649 "parameters, which use the same request and reply messages, but they may also "
3650 "be followed by files sent using a chunked encoding."
3651 msgstr ""
3652
3653 #. type: =head3
3654 #: ../src/guestfs.pod:1893
3655 msgid "ORDINARY FUNCTIONS (NO FILEIN/FILEOUT PARAMS)"
3656 msgstr ""
3657
3658 #. type: textblock
3659 #: ../src/guestfs.pod:1895
3660 msgid "For ordinary functions, the request message is:"
3661 msgstr ""
3662
3663 #. type: verbatim
3664 #: ../src/guestfs.pod:1897
3665 #, no-wrap
3666 msgid ""
3667 " total length (header + arguments,\n"
3668 "      but not including the length word itself)\n"
3669 " struct guestfs_message_header (encoded as XDR)\n"
3670 " struct guestfs_<foo>_args (encoded as XDR)\n"
3671 "\n"
3672 msgstr ""
3673
3674 #. type: textblock
3675 #: ../src/guestfs.pod:1902
3676 msgid ""
3677 "The total length field allows the daemon to allocate a fixed size buffer "
3678 "into which it slurps the rest of the message.  As a result, the total length "
3679 "is limited to C<GUESTFS_MESSAGE_MAX> bytes (currently 4MB), which means the "
3680 "effective size of any request is limited to somewhere under this size."
3681 msgstr ""
3682
3683 #. type: textblock
3684 #: ../src/guestfs.pod:1908
3685 msgid ""
3686 "Note also that many functions don't take any arguments, in which case the "
3687 "C<guestfs_I<foo>_args> is completely omitted."
3688 msgstr ""
3689
3690 #. type: textblock
3691 #: ../src/guestfs.pod:1911
3692 msgid ""
3693 "The header contains the procedure number (C<guestfs_proc>) which is how the "
3694 "receiver knows what type of args structure to expect, or none at all."
3695 msgstr ""
3696
3697 #. type: textblock
3698 #: ../src/guestfs.pod:1915
3699 msgid ""
3700 "For functions that take optional arguments, the optional arguments are "
3701 "encoded in the C<guestfs_I<foo>_args> structure in the same way as ordinary "
3702 "arguments.  A bitmask in the header indicates which optional arguments are "
3703 "meaningful.  The bitmask is also checked to see if it contains bits set "
3704 "which the daemon does not know about (eg. if more optional arguments were "
3705 "added in a later version of the library), and this causes the call to be "
3706 "rejected."
3707 msgstr ""
3708
3709 #. type: textblock
3710 #: ../src/guestfs.pod:1923
3711 msgid "The reply message for ordinary functions is:"
3712 msgstr ""
3713
3714 #. type: verbatim
3715 #: ../src/guestfs.pod:1925
3716 #, no-wrap
3717 msgid ""
3718 " total length (header + ret,\n"
3719 "      but not including the length word itself)\n"
3720 " struct guestfs_message_header (encoded as XDR)\n"
3721 " struct guestfs_<foo>_ret (encoded as XDR)\n"
3722 "\n"
3723 msgstr ""
3724
3725 #. type: textblock
3726 #: ../src/guestfs.pod:1930
3727 msgid ""
3728 "As above the C<guestfs_I<foo>_ret> structure may be completely omitted for "
3729 "functions that return no formal return values."
3730 msgstr ""
3731
3732 #. type: textblock
3733 #: ../src/guestfs.pod:1933
3734 msgid "As above the total length of the reply is limited to C<GUESTFS_MESSAGE_MAX>."
3735 msgstr ""
3736
3737 #. type: textblock
3738 #: ../src/guestfs.pod:1936
3739 msgid ""
3740 "In the case of an error, a flag is set in the header, and the reply message "
3741 "is slightly changed:"
3742 msgstr ""
3743
3744 #. type: verbatim
3745 #: ../src/guestfs.pod:1939
3746 #, no-wrap
3747 msgid ""
3748 " total length (header + error,\n"
3749 "      but not including the length word itself)\n"
3750 " struct guestfs_message_header (encoded as XDR)\n"
3751 " struct guestfs_message_error (encoded as XDR)\n"
3752 "\n"
3753 msgstr ""
3754
3755 #. type: textblock
3756 #: ../src/guestfs.pod:1944
3757 msgid ""
3758 "The C<guestfs_message_error> structure contains the error message as a "
3759 "string."
3760 msgstr ""
3761
3762 #. type: =head3
3763 #: ../src/guestfs.pod:1947
3764 msgid "FUNCTIONS THAT HAVE FILEIN PARAMETERS"
3765 msgstr ""
3766
3767 #. type: textblock
3768 #: ../src/guestfs.pod:1949
3769 msgid ""
3770 "A C<FileIn> parameter indicates that we transfer a file I<into> the guest.  "
3771 "The normal request message is sent (see above).  However this is followed by "
3772 "a sequence of file chunks."
3773 msgstr ""
3774
3775 #. type: verbatim
3776 #: ../src/guestfs.pod:1953
3777 #, no-wrap
3778 msgid ""
3779 " total length (header + arguments,\n"
3780 "      but not including the length word itself,\n"
3781 "      and not including the chunks)\n"
3782 " struct guestfs_message_header (encoded as XDR)\n"
3783 " struct guestfs_<foo>_args (encoded as XDR)\n"
3784 " sequence of chunks for FileIn param #0\n"
3785 " sequence of chunks for FileIn param #1 etc.\n"
3786 "\n"
3787 msgstr ""
3788
3789 #. type: textblock
3790 #: ../src/guestfs.pod:1961
3791 msgid "The \"sequence of chunks\" is:"
3792 msgstr ""
3793
3794 #. type: verbatim
3795 #: ../src/guestfs.pod:1963
3796 #, no-wrap
3797 msgid ""
3798 " length of chunk (not including length word itself)\n"
3799 " struct guestfs_chunk (encoded as XDR)\n"
3800 " length of chunk\n"
3801 " struct guestfs_chunk (encoded as XDR)\n"
3802 "   ...\n"
3803 " length of chunk\n"
3804 " struct guestfs_chunk (with data.data_len == 0)\n"
3805 "\n"
3806 msgstr ""
3807
3808 #. type: textblock
3809 #: ../src/guestfs.pod:1971
3810 msgid ""
3811 "The final chunk has the C<data_len> field set to zero.  Additionally a flag "
3812 "is set in the final chunk to indicate either successful completion or early "
3813 "cancellation."
3814 msgstr ""
3815
3816 #. type: textblock
3817 #: ../src/guestfs.pod:1975
3818 msgid ""
3819 "At time of writing there are no functions that have more than one FileIn "
3820 "parameter.  However this is (theoretically) supported, by sending the "
3821 "sequence of chunks for each FileIn parameter one after another (from left to "
3822 "right)."
3823 msgstr ""
3824
3825 #. type: textblock
3826 #: ../src/guestfs.pod:1980
3827 msgid ""
3828 "Both the library (sender) I<and> the daemon (receiver) may cancel the "
3829 "transfer.  The library does this by sending a chunk with a special flag set "
3830 "to indicate cancellation.  When the daemon sees this, it cancels the whole "
3831 "RPC, does I<not> send any reply, and goes back to reading the next request."
3832 msgstr ""
3833
3834 #. type: textblock
3835 #: ../src/guestfs.pod:1986
3836 msgid ""
3837 "The daemon may also cancel.  It does this by writing a special word "
3838 "C<GUESTFS_CANCEL_FLAG> to the socket.  The library listens for this during "
3839 "the transfer, and if it gets it, it will cancel the transfer (it sends a "
3840 "cancel chunk).  The special word is chosen so that even if cancellation "
3841 "happens right at the end of the transfer (after the library has finished "
3842 "writing and has started listening for the reply), the \"spurious\" cancel "
3843 "flag will not be confused with the reply message."
3844 msgstr ""
3845
3846 #. type: textblock
3847 #: ../src/guestfs.pod:1995
3848 msgid ""
3849 "This protocol allows the transfer of arbitrary sized files (no 32 bit "
3850 "limit), and also files where the size is not known in advance (eg. from "
3851 "pipes or sockets).  However the chunks are rather small "
3852 "(C<GUESTFS_MAX_CHUNK_SIZE>), so that neither the library nor the daemon need "
3853 "to keep much in memory."
3854 msgstr ""
3855
3856 #. type: =head3
3857 #: ../src/guestfs.pod:2001
3858 msgid "FUNCTIONS THAT HAVE FILEOUT PARAMETERS"
3859 msgstr ""
3860
3861 #. type: textblock
3862 #: ../src/guestfs.pod:2003
3863 msgid ""
3864 "The protocol for FileOut parameters is exactly the same as for FileIn "
3865 "parameters, but with the roles of daemon and library reversed."
3866 msgstr ""
3867
3868 #. type: verbatim
3869 #: ../src/guestfs.pod:2006
3870 #, no-wrap
3871 msgid ""
3872 " total length (header + ret,\n"
3873 "      but not including the length word itself,\n"
3874 "      and not including the chunks)\n"
3875 " struct guestfs_message_header (encoded as XDR)\n"
3876 " struct guestfs_<foo>_ret (encoded as XDR)\n"
3877 " sequence of chunks for FileOut param #0\n"
3878 " sequence of chunks for FileOut param #1 etc.\n"
3879 "\n"
3880 msgstr ""
3881
3882 #. type: =head3
3883 #: ../src/guestfs.pod:2014
3884 msgid "INITIAL MESSAGE"
3885 msgstr ""
3886
3887 #. type: textblock
3888 #: ../src/guestfs.pod:2016
3889 msgid ""
3890 "When the daemon launches it sends an initial word (C<GUESTFS_LAUNCH_FLAG>) "
3891 "which indicates that the guest and daemon is alive.  This is what "
3892 "L</guestfs_launch> waits for."
3893 msgstr ""
3894
3895 #. type: =head3
3896 #: ../src/guestfs.pod:2020
3897 msgid "PROGRESS NOTIFICATION MESSAGES"
3898 msgstr ""
3899
3900 #. type: textblock
3901 #: ../src/guestfs.pod:2022
3902 msgid ""
3903 "The daemon may send progress notification messages at any time.  These are "
3904 "distinguished by the normal length word being replaced by "
3905 "C<GUESTFS_PROGRESS_FLAG>, followed by a fixed size progress message."
3906 msgstr ""
3907
3908 #. type: textblock
3909 #: ../src/guestfs.pod:2026
3910 msgid ""
3911 "The library turns them into progress callbacks (see "
3912 "C<guestfs_set_progress_callback>) if there is a callback registered, or "
3913 "discards them if not."
3914 msgstr ""
3915
3916 #. type: textblock
3917 #: ../src/guestfs.pod:2030
3918 msgid ""
3919 "The daemon self-limits the frequency of progress messages it sends (see "
3920 "C<daemon/proto.c:notify_progress>).  Not all calls generate progress "
3921 "messages."
3922 msgstr ""
3923
3924 #. type: =head1
3925 #: ../src/guestfs.pod:2034
3926 msgid "LIBGUESTFS VERSION NUMBERS"
3927 msgstr ""
3928
3929 #. type: textblock
3930 #: ../src/guestfs.pod:2036
3931 msgid ""
3932 "Since April 2010, libguestfs has started to make separate development and "
3933 "stable releases, along with corresponding branches in our git repository.  "
3934 "These separate releases can be identified by version number:"
3935 msgstr ""
3936
3937 #. type: verbatim
3938 #: ../src/guestfs.pod:2041
3939 #, no-wrap
3940 msgid ""
3941 "                 even numbers for stable: 1.2.x, 1.4.x, ...\n"
3942 "       .-------- odd numbers for development: 1.3.x, 1.5.x, ...\n"
3943 "       |\n"
3944 "       v\n"
3945 " 1  .  3  .  5\n"
3946 " ^           ^\n"
3947 " |           |\n"
3948 " |           `-------- sub-version\n"
3949 " |\n"
3950 " `------ always '1' because we don't change the ABI\n"
3951 "\n"
3952 msgstr ""
3953
3954 #. type: textblock
3955 #: ../src/guestfs.pod:2052
3956 msgid "Thus \"1.3.5\" is the 5th update to the development branch \"1.3\"."
3957 msgstr ""
3958
3959 #. type: textblock
3960 #: ../src/guestfs.pod:2054
3961 msgid ""
3962 "As time passes we cherry pick fixes from the development branch and backport "
3963 "those into the stable branch, the effect being that the stable branch should "
3964 "get more stable and less buggy over time.  So the stable releases are ideal "
3965 "for people who don't need new features but would just like the software to "
3966 "work."
3967 msgstr ""
3968
3969 #. type: textblock
3970 #: ../src/guestfs.pod:2060
3971 msgid "Our criteria for backporting changes are:"
3972 msgstr ""
3973
3974 #. type: textblock
3975 #: ../src/guestfs.pod:2066
3976 msgid ""
3977 "Documentation changes which don't affect any code are backported unless the "
3978 "documentation refers to a future feature which is not in stable."
3979 msgstr ""
3980
3981 #. type: textblock
3982 #: ../src/guestfs.pod:2072
3983 msgid ""
3984 "Bug fixes which are not controversial, fix obvious problems, and have been "
3985 "well tested are backported."
3986 msgstr ""
3987
3988 #. type: textblock
3989 #: ../src/guestfs.pod:2077
3990 msgid ""
3991 "Simple rearrangements of code which shouldn't affect how it works get "
3992 "backported.  This is so that the code in the two branches doesn't get too "
3993 "far out of step, allowing us to backport future fixes more easily."
3994 msgstr ""
3995
3996 #. type: textblock
3997 #: ../src/guestfs.pod:2083
3998 msgid ""
3999 "We I<don't> backport new features, new APIs, new tools etc, except in one "
4000 "exceptional case: the new feature is required in order to implement an "
4001 "important bug fix."
4002 msgstr ""
4003
4004 #. type: textblock
4005 #: ../src/guestfs.pod:2089
4006 msgid ""
4007 "A new stable branch starts when we think the new features in development are "
4008 "substantial and compelling enough over the current stable branch to warrant "
4009 "it.  When that happens we create new stable and development versions 1.N.0 "
4010 "and 1.(N+1).0 [N is even].  The new dot-oh release won't necessarily be so "
4011 "stable at this point, but by backporting fixes from development, that branch "
4012 "will stabilize over time."
4013 msgstr ""
4014
4015 #. type: =head1
4016 #: ../src/guestfs.pod:2097
4017 msgid "EXTENDING LIBGUESTFS"
4018 msgstr ""
4019
4020 #. type: =head2
4021 #: ../src/guestfs.pod:2099
4022 msgid "ADDING A NEW API ACTION"
4023 msgstr ""
4024
4025 #. type: textblock
4026 #: ../src/guestfs.pod:2101
4027 msgid ""
4028 "Large amounts of boilerplate code in libguestfs (RPC, bindings, "
4029 "documentation) are generated, and this makes it easy to extend the "
4030 "libguestfs API."
4031 msgstr ""
4032
4033 #. type: textblock
4034 #: ../src/guestfs.pod:2105
4035 msgid "To add a new API action there are two changes:"
4036 msgstr ""
4037
4038 #. type: textblock
4039 #: ../src/guestfs.pod:2111
4040 msgid ""
4041 "You need to add a description of the call (name, parameters, return type, "
4042 "tests, documentation) to C<generator/generator_actions.ml>."
4043 msgstr ""
4044
4045 #. type: textblock
4046 #: ../src/guestfs.pod:2114
4047 msgid ""
4048 "There are two sorts of API action, depending on whether the call goes "
4049 "through to the daemon in the appliance, or is serviced entirely by the "
4050 "library (see L</ARCHITECTURE> above).  L</guestfs_sync> is an example of the "
4051 "former, since the sync is done in the appliance.  L</guestfs_set_trace> is "
4052 "an example of the latter, since a trace flag is maintained in the handle and "
4053 "all tracing is done on the library side."
4054 msgstr ""
4055
4056 #. type: textblock
4057 #: ../src/guestfs.pod:2122
4058 msgid ""
4059 "Most new actions are of the first type, and get added to the "
4060 "C<daemon_functions> list.  Each function has a unique procedure number used "
4061 "in the RPC protocol which is assigned to that action when we publish "
4062 "libguestfs and cannot be reused.  Take the latest procedure number and "
4063 "increment it."
4064 msgstr ""
4065
4066 #. type: textblock
4067 #: ../src/guestfs.pod:2128
4068 msgid ""
4069 "For library-only actions of the second type, add to the "
4070 "C<non_daemon_functions> list.  Since these functions are serviced by the "
4071 "library and do not travel over the RPC mechanism to the daemon, these "
4072 "functions do not need a procedure number, and so the procedure number is set "
4073 "to C<-1>."
4074 msgstr ""
4075
4076 #. type: textblock
4077 #: ../src/guestfs.pod:2136
4078 msgid "Implement the action (in C):"
4079 msgstr ""
4080
4081 #. type: textblock
4082 #: ../src/guestfs.pod:2138
4083 msgid ""
4084 "For daemon actions, implement the function C<do_E<lt>nameE<gt>> in the "
4085 "C<daemon/> directory."
4086 msgstr ""
4087
4088 #. type: textblock
4089 #: ../src/guestfs.pod:2141
4090 msgid ""
4091 "For library actions, implement the function C<guestfs__E<lt>nameE<gt>> "
4092 "(note: double underscore) in the C<src/> directory."
4093 msgstr ""
4094
4095 #. type: textblock
4096 #: ../src/guestfs.pod:2144
4097 msgid "In either case, use another function as an example of what to do."
4098 msgstr ""
4099
4100 #. type: textblock
4101 #: ../src/guestfs.pod:2148
4102 msgid "After making these changes, use C<make> to compile."
4103 msgstr ""
4104
4105 #. type: textblock
4106 #: ../src/guestfs.pod:2150
4107 msgid ""
4108 "Note that you don't need to implement the RPC, language bindings, manual "
4109 "pages or anything else.  It's all automatically generated from the OCaml "
4110 "description."
4111 msgstr ""
4112
4113 #. type: =head2
4114 #: ../src/guestfs.pod:2154
4115 msgid "ADDING TESTS FOR AN API ACTION"
4116 msgstr ""
4117
4118 #. type: textblock
4119 #: ../src/guestfs.pod:2156
4120 msgid ""
4121 "You can supply zero or as many tests as you want per API call.  The tests "
4122 "can either be added as part of the API description "
4123 "(C<generator/generator_actions.ml>), or in some rarer cases you may want to "
4124 "drop a script into C<regressions/>.  Note that adding a script to "
4125 "C<regressions/> is slower, so if possible use the first method."
4126 msgstr ""
4127
4128 #. type: textblock
4129 #: ../src/guestfs.pod:2162
4130 msgid ""
4131 "The following describes the test environment used when you add an API test "
4132 "in C<generator_actions.ml>."
4133 msgstr ""
4134
4135 #. type: textblock
4136 #: ../src/guestfs.pod:2165
4137 msgid "The test environment has 4 block devices:"
4138 msgstr ""
4139
4140 #. type: =item
4141 #: ../src/guestfs.pod:2169
4142 msgid "C</dev/sda> 500MB"
4143 msgstr ""
4144
4145 #. type: textblock
4146 #: ../src/guestfs.pod:2171
4147 msgid "General block device for testing."
4148 msgstr ""
4149
4150 #. type: =item
4151 #: ../src/guestfs.pod:2173
4152 msgid "C</dev/sdb> 50MB"
4153 msgstr ""
4154
4155 #. type: textblock
4156 #: ../src/guestfs.pod:2175
4157 msgid ""
4158 "C</dev/sdb1> is an ext2 filesystem used for testing filesystem write "
4159 "operations."
4160 msgstr ""
4161
4162 #. type: =item
4163 #: ../src/guestfs.pod:2178
4164 msgid "C</dev/sdc> 10MB"
4165 msgstr ""
4166
4167 #. type: textblock
4168 #: ../src/guestfs.pod:2180
4169 msgid "Used in a few tests where two block devices are needed."
4170 msgstr ""
4171
4172 #. type: =item
4173 #: ../src/guestfs.pod:2182
4174 msgid "C</dev/sdd>"
4175 msgstr ""
4176
4177 #. type: textblock
4178 #: ../src/guestfs.pod:2184
4179 msgid "ISO with fixed content (see C<images/test.iso>)."
4180 msgstr ""
4181
4182 #. type: textblock
4183 #: ../src/guestfs.pod:2188
4184 msgid ""
4185 "To be able to run the tests in a reasonable amount of time, the libguestfs "
4186 "appliance and block devices are reused between tests.  So don't try testing "
4187 "L</guestfs_kill_subprocess> :-x"
4188 msgstr ""
4189
4190 #. type: textblock
4191 #: ../src/guestfs.pod:2192
4192 msgid ""
4193 "Each test starts with an initial scenario, selected using one of the "
4194 "C<Init*> expressions, described in C<generator/generator_types.ml>.  These "
4195 "initialize the disks mentioned above in a particular way as documented in "
4196 "C<generator_types.ml>.  You should not assume anything about the previous "
4197 "contents of other disks that are not initialized."
4198 msgstr ""
4199
4200 #. type: textblock
4201 #: ../src/guestfs.pod:2198
4202 msgid ""
4203 "You can add a prerequisite clause to any individual test.  This is a "
4204 "run-time check, which, if it fails, causes the test to be skipped.  Useful "
4205 "if testing a command which might not work on all variations of libguestfs "
4206 "builds.  A test that has prerequisite of C<Always> means to run "
4207 "unconditionally."
4208 msgstr ""
4209
4210 #. type: textblock
4211 #: ../src/guestfs.pod:2204
4212 msgid ""
4213 "In addition, packagers can skip individual tests by setting environment "
4214 "variables before running C<make check>."
4215 msgstr ""
4216
4217 #. type: verbatim
4218 #: ../src/guestfs.pod:2207
4219 #, no-wrap
4220 msgid ""
4221 " SKIP_TEST_<CMD>_<NUM>=1\n"
4222 "\n"
4223 msgstr ""
4224
4225 #. type: textblock
4226 #: ../src/guestfs.pod:2209
4227 msgid "eg: C<SKIP_TEST_COMMAND_3=1> skips test #3 of L</guestfs_command>."
4228 msgstr ""
4229
4230 #. type: textblock
4231 #: ../src/guestfs.pod:2211
4232 msgid "or:"
4233 msgstr ""
4234
4235 #. type: verbatim
4236 #: ../src/guestfs.pod:2213
4237 #, no-wrap
4238 msgid ""
4239 " SKIP_TEST_<CMD>=1\n"
4240 "\n"
4241 msgstr ""
4242
4243 #. type: textblock
4244 #: ../src/guestfs.pod:2215
4245 msgid "eg: C<SKIP_TEST_ZEROFREE=1> skips all L</guestfs_zerofree> tests."
4246 msgstr ""
4247
4248 #. type: textblock
4249 #: ../src/guestfs.pod:2217
4250 msgid "Packagers can run only certain tests by setting for example:"
4251 msgstr ""
4252
4253 #. type: verbatim
4254 #: ../src/guestfs.pod:2219
4255 #, no-wrap
4256 msgid ""
4257 " TEST_ONLY=\"vfs_type zerofree\"\n"
4258 "\n"
4259 msgstr ""
4260
4261 #. type: textblock
4262 #: ../src/guestfs.pod:2221
4263 msgid ""
4264 "See C<capitests/tests.c> for more details of how these environment variables "
4265 "work."
4266 msgstr ""
4267
4268 #. type: =head2
4269 #: ../src/guestfs.pod:2224
4270 msgid "DEBUGGING NEW API ACTIONS"
4271 msgstr ""
4272
4273 #. type: textblock
4274 #: ../src/guestfs.pod:2226
4275 msgid "Test new actions work before submitting them."
4276 msgstr ""
4277
4278 #. type: textblock
4279 #: ../src/guestfs.pod:2228
4280 msgid "You can use guestfish to try out new commands."
4281 msgstr ""
4282
4283 #. type: textblock
4284 #: ../src/guestfs.pod:2230
4285 msgid ""
4286 "Debugging the daemon is a problem because it runs inside a minimal "
4287 "environment.  However you can fprintf messages in the daemon to stderr, and "
4288 "they will show up if you use C<guestfish -v>."
4289 msgstr ""
4290
4291 #. type: =head2
4292 #: ../src/guestfs.pod:2234
4293 msgid "FORMATTING CODE AND OTHER CONVENTIONS"
4294 msgstr ""
4295
4296 #. type: textblock
4297 #: ../src/guestfs.pod:2236
4298 msgid ""
4299 "Our C source code generally adheres to some basic code-formatting "
4300 "conventions.  The existing code base is not totally consistent on this "
4301 "front, but we do prefer that contributed code be formatted similarly.  In "
4302 "short, use spaces-not-TABs for indentation, use 2 spaces for each "
4303 "indentation level, and other than that, follow the K&R style."
4304 msgstr ""
4305
4306 #. type: textblock
4307 #: ../src/guestfs.pod:2242
4308 msgid ""
4309 "If you use Emacs, add the following to one of one of your start-up files "
4310 "(e.g., ~/.emacs), to help ensure that you get indentation right:"
4311 msgstr ""
4312
4313 #. type: verbatim
4314 #: ../src/guestfs.pod:2245
4315 #, no-wrap
4316 msgid ""
4317 " ;;; In libguestfs, indent with spaces everywhere (not TABs).\n"
4318 " ;;; Exceptions: Makefile and ChangeLog modes.\n"
4319 " (add-hook 'find-file-hook\n"
4320 "     '(lambda () (if (and buffer-file-name\n"
4321 "                          (string-match \"/libguestfs\\\\>\"\n"
4322 "                              (buffer-file-name))\n"
4323 "                          (not (string-equal mode-name \"Change Log\"))\n"
4324 "                          (not (string-equal mode-name \"Makefile\")))\n"
4325 "                     (setq indent-tabs-mode nil))))\n"
4326 " \n"
4327 msgstr ""
4328
4329 #. type: verbatim
4330 #: ../src/guestfs.pod:2255
4331 #, no-wrap
4332 msgid ""
4333 " ;;; When editing C sources in libguestfs, use this style.\n"
4334 " (defun libguestfs-c-mode ()\n"
4335 "   \"C mode with adjusted defaults for use with libguestfs.\"\n"
4336 "   (interactive)\n"
4337 "   (c-set-style \"K&R\")\n"
4338 "   (setq c-indent-level 2)\n"
4339 "   (setq c-basic-offset 2))\n"
4340 " (add-hook 'c-mode-hook\n"
4341 "           '(lambda () (if (string-match \"/libguestfs\\\\>\"\n"
4342 "                               (buffer-file-name))\n"
4343 "                           (libguestfs-c-mode))))\n"
4344 "\n"
4345 msgstr ""
4346
4347 #. type: textblock
4348 #: ../src/guestfs.pod:2267
4349 msgid "Enable warnings when compiling (and fix any problems this finds):"
4350 msgstr ""
4351
4352 #. type: verbatim
4353 #: ../src/guestfs.pod:2270
4354 #, no-wrap
4355 msgid ""
4356 " ./configure --enable-gcc-warnings\n"
4357 "\n"
4358 msgstr ""
4359
4360 #. type: textblock
4361 #: ../src/guestfs.pod:2272
4362 msgid "Useful targets are:"
4363 msgstr ""
4364
4365 #. type: verbatim
4366 #: ../src/guestfs.pod:2274
4367 #, no-wrap
4368 msgid ""
4369 " make syntax-check  # checks the syntax of the C code\n"
4370 " make check         # runs the test suite\n"
4371 "\n"
4372 msgstr ""
4373
4374 #. type: =head2
4375 #: ../src/guestfs.pod:2277
4376 msgid "DAEMON CUSTOM PRINTF FORMATTERS"
4377 msgstr ""
4378
4379 #. type: textblock
4380 #: ../src/guestfs.pod:2279
4381 msgid ""
4382 "In the daemon code we have created custom printf formatters C<%Q> and C<%R>, "
4383 "which are used to do shell quoting."
4384 msgstr ""
4385
4386 #. type: =item
4387 #: ../src/guestfs.pod:2284
4388 msgid "%Q"
4389 msgstr ""
4390
4391 #. type: textblock
4392 #: ../src/guestfs.pod:2286
4393 msgid ""
4394 "Simple shell quoted string.  Any spaces or other shell characters are "
4395 "escaped for you."
4396 msgstr ""
4397
4398 #. type: =item
4399 #: ../src/guestfs.pod:2289
4400 msgid "%R"
4401 msgstr ""
4402
4403 #. type: textblock
4404 #: ../src/guestfs.pod:2291
4405 msgid ""
4406 "Same as C<%Q> except the string is treated as a path which is prefixed by "
4407 "the sysroot."
4408 msgstr ""
4409
4410 #. type: textblock
4411 #: ../src/guestfs.pod:2296 ../fish/guestfish.pod:240 ../fish/guestfish.pod:594
4412 msgid "For example:"
4413 msgstr ""
4414
4415 #. type: verbatim
4416 #: ../src/guestfs.pod:2298
4417 #, no-wrap
4418 msgid ""
4419 " asprintf (&cmd, \"cat %R\", path);\n"
4420 "\n"
4421 msgstr ""
4422
4423 #. type: textblock
4424 #: ../src/guestfs.pod:2300
4425 msgid "would produce C<cat /sysroot/some\\ path\\ with\\ spaces>"
4426 msgstr ""
4427
4428 #. type: textblock
4429 #: ../src/guestfs.pod:2302
4430 msgid ""
4431 "I<Note:> Do I<not> use these when you are passing parameters to the "
4432 "C<command{,r,v,rv}()> functions.  These parameters do NOT need to be quoted "
4433 "because they are not passed via the shell (instead, straight to exec).  You "
4434 "probably want to use the C<sysroot_path()> function however."
4435 msgstr ""
4436
4437 #. type: =head2
4438 #: ../src/guestfs.pod:2308
4439 msgid "SUBMITTING YOUR NEW API ACTIONS"
4440 msgstr ""
4441
4442 #. type: textblock
4443 #: ../src/guestfs.pod:2310
4444 msgid ""
4445 "Submit patches to the mailing list: "
4446 "L<http://www.redhat.com/mailman/listinfo/libguestfs> and CC to "
4447 "L<rjones@redhat.com>."
4448 msgstr ""
4449
4450 #. type: =head2
4451 #: ../src/guestfs.pod:2314
4452 msgid "INTERNATIONALIZATION (I18N) SUPPORT"
4453 msgstr ""
4454
4455 #. type: textblock
4456 #: ../src/guestfs.pod:2316
4457 msgid "We support i18n (gettext anyhow) in the library."
4458 msgstr ""
4459
4460 #. type: textblock
4461 #: ../src/guestfs.pod:2318
4462 msgid ""
4463 "However many messages come from the daemon, and we don't translate those at "
4464 "the moment.  One reason is that the appliance generally has all locale files "
4465 "removed from it, because they take up a lot of space.  So we'd have to readd "
4466 "some of those, as well as copying our PO files into the appliance."
4467 msgstr ""
4468
4469 #. type: textblock
4470 #: ../src/guestfs.pod:2324
4471 msgid ""
4472 "Debugging messages are never translated, since they are intended for the "
4473 "programmers."
4474 msgstr ""
4475
4476 #. type: =head2
4477 #: ../src/guestfs.pod:2327
4478 msgid "SOURCE CODE SUBDIRECTORIES"
4479 msgstr ""
4480
4481 #. type: =item
4482 #: ../src/guestfs.pod:2331
4483 msgid "C<appliance>"
4484 msgstr ""
4485
4486 #. type: textblock
4487 #: ../src/guestfs.pod:2333
4488 msgid "The libguestfs appliance, build scripts and so on."
4489 msgstr ""
4490
4491 #. type: =item
4492 #: ../src/guestfs.pod:2335
4493 msgid "C<capitests>"
4494 msgstr ""
4495
4496 #. type: textblock
4497 #: ../src/guestfs.pod:2337
4498 msgid "Automated tests of the C API."
4499 msgstr ""
4500
4501 #. type: =item
4502 #: ../src/guestfs.pod:2339
4503 msgid "C<cat>"
4504 msgstr ""
4505
4506 #. type: textblock
4507 #: ../src/guestfs.pod:2341
4508 msgid ""
4509 "The L<virt-cat(1)>, L<virt-filesystems(1)> and L<virt-ls(1)> commands and "
4510 "documentation."
4511 msgstr ""
4512
4513 #. type: =item
4514 #: ../src/guestfs.pod:2344
4515 msgid "C<caution>"
4516 msgstr ""
4517
4518 #. type: textblock
4519 #: ../src/guestfs.pod:2346
4520 msgid ""
4521 "Safety and liveness tests of components that libguestfs depends upon (not of "
4522 "libguestfs itself).  Mainly this is for qemu and the kernel."
4523 msgstr ""
4524
4525 #. type: =item
4526 #: ../src/guestfs.pod:2349
4527 msgid "C<contrib>"
4528 msgstr ""
4529
4530 #. type: textblock
4531 #: ../src/guestfs.pod:2351
4532 msgid "Outside contributions, experimental parts."
4533 msgstr ""
4534
4535 #. type: =item
4536 #: ../src/guestfs.pod:2353
4537 msgid "C<daemon>"
4538 msgstr ""
4539
4540 #. type: textblock
4541 #: ../src/guestfs.pod:2355
4542 msgid ""
4543 "The daemon that runs inside the libguestfs appliance and carries out "
4544 "actions."
4545 msgstr ""
4546
4547 #. type: =item
4548 #: ../src/guestfs.pod:2358
4549 msgid "C<df>"
4550 msgstr ""
4551
4552 #. type: textblock
4553 #: ../src/guestfs.pod:2360
4554 msgid "L<virt-df(1)> command and documentation."
4555 msgstr ""
4556
4557 #. type: =item
4558 #: ../src/guestfs.pod:2362
4559 msgid "C<examples>"
4560 msgstr ""
4561
4562 #. type: textblock
4563 #: ../src/guestfs.pod:2364
4564 msgid "C API example code."
4565 msgstr ""
4566
4567 #. type: =item
4568 #: ../src/guestfs.pod:2366
4569 msgid "C<fish>"
4570 msgstr ""
4571
4572 #. type: textblock
4573 #: ../src/guestfs.pod:2368
4574 msgid "L<guestfish(1)>, the command-line shell."
4575 msgstr ""
4576
4577 #. type: =item
4578 #: ../src/guestfs.pod:2370
4579 msgid "C<fuse>"
4580 msgstr ""
4581
4582 #. type: textblock
4583 #: ../src/guestfs.pod:2372
4584 msgid "L<guestmount(1)>, FUSE (userspace filesystem) built on top of libguestfs."
4585 msgstr ""
4586
4587 #. type: =item
4588 #: ../src/guestfs.pod:2374
4589 msgid "C<generator>"
4590 msgstr ""
4591
4592 #. type: textblock
4593 #: ../src/guestfs.pod:2376
4594 msgid ""
4595 "The crucially important generator, used to automatically generate large "
4596 "amounts of boilerplate C code for things like RPC and bindings."
4597 msgstr ""
4598
4599 #. type: =item
4600 #: ../src/guestfs.pod:2379
4601 msgid "C<images>"
4602 msgstr ""
4603
4604 #. type: textblock
4605 #: ../src/guestfs.pod:2381
4606 msgid "Files used by the test suite."
4607 msgstr ""
4608
4609 #. type: textblock
4610 #: ../src/guestfs.pod:2383
4611 msgid "Some \"phony\" guest images which we test against."
4612 msgstr ""
4613
4614 #. type: =item
4615 #: ../src/guestfs.pod:2385
4616 msgid "C<inspector>"
4617 msgstr ""
4618
4619 #. type: textblock
4620 #: ../src/guestfs.pod:2387
4621 msgid "L<virt-inspector(1)>, the virtual machine image inspector."
4622 msgstr ""
4623
4624 #. type: =item
4625 #: ../src/guestfs.pod:2389
4626 msgid "C<m4>"
4627 msgstr ""
4628
4629 #. type: textblock
4630 #: ../src/guestfs.pod:2391
4631 msgid "M4 macros used by autoconf."
4632 msgstr ""
4633
4634 #. type: =item
4635 #: ../src/guestfs.pod:2393
4636 msgid "C<po>"
4637 msgstr ""
4638
4639 #. type: textblock
4640 #: ../src/guestfs.pod:2395
4641 msgid "Translations of simple gettext strings."
4642 msgstr ""
4643
4644 #. type: =item
4645 #: ../src/guestfs.pod:2397
4646 msgid "C<po-docs>"
4647 msgstr ""
4648
4649 #. type: textblock
4650 #: ../src/guestfs.pod:2399
4651 msgid ""
4652 "The build infrastructure and PO files for translations of manpages and POD "
4653 "files.  Eventually this will be combined with the C<po> directory, but that "
4654 "is rather complicated."
4655 msgstr ""
4656
4657 #. type: =item
4658 #: ../src/guestfs.pod:2403
4659 msgid "C<regressions>"
4660 msgstr ""
4661
4662 #. type: textblock
4663 #: ../src/guestfs.pod:2405
4664 msgid "Regression tests."
4665 msgstr ""
4666
4667 #. type: =item
4668 #: ../src/guestfs.pod:2407
4669 msgid "C<rescue>"
4670 msgstr ""
4671
4672 #. type: textblock
4673 #: ../src/guestfs.pod:2409
4674 msgid "L<virt-rescue(1)> command and documentation."
4675 msgstr ""
4676
4677 #. type: =item
4678 #: ../src/guestfs.pod:2411
4679 msgid "C<src>"
4680 msgstr ""
4681
4682 #. type: textblock
4683 #: ../src/guestfs.pod:2413
4684 msgid "Source code to the C library."
4685 msgstr ""
4686
4687 #. type: =item
4688 #: ../src/guestfs.pod:2415
4689 msgid "C<tools>"
4690 msgstr ""
4691
4692 #. type: textblock
4693 #: ../src/guestfs.pod:2417
4694 msgid "Command line tools written in Perl (L<virt-resize(1)> and many others)."
4695 msgstr ""
4696
4697 #. type: =item
4698 #: ../src/guestfs.pod:2419
4699 msgid "C<test-tool>"
4700 msgstr ""
4701
4702 #. type: textblock
4703 #: ../src/guestfs.pod:2421
4704 msgid ""
4705 "Test tool for end users to test if their qemu/kernel combination will work "
4706 "with libguestfs."
4707 msgstr ""
4708
4709 #. type: =item
4710 #: ../src/guestfs.pod:2424
4711 msgid "C<csharp>"
4712 msgstr ""
4713
4714 #. type: =item
4715 #: ../src/guestfs.pod:2426
4716 msgid "C<haskell>"
4717 msgstr ""
4718
4719 #. type: =item
4720 #: ../src/guestfs.pod:2428
4721 msgid "C<java>"
4722 msgstr ""
4723
4724 #. type: =item
4725 #: ../src/guestfs.pod:2430
4726 msgid "C<ocaml>"
4727 msgstr ""
4728
4729 #. type: =item
4730 #: ../src/guestfs.pod:2432
4731 msgid "C<php>"
4732 msgstr ""
4733
4734 #. type: =item
4735 #: ../src/guestfs.pod:2434
4736 msgid "C<perl>"
4737 msgstr ""
4738
4739 #. type: =item
4740 #: ../src/guestfs.pod:2436
4741 msgid "C<python>"
4742 msgstr ""
4743
4744 #. type: =item
4745 #: ../src/guestfs.pod:2438
4746 msgid "C<ruby>"
4747 msgstr ""
4748
4749 #. type: textblock
4750 #: ../src/guestfs.pod:2440
4751 msgid "Language bindings."
4752 msgstr ""
4753
4754 #. type: =head1
4755 #: ../src/guestfs.pod:2444 ../fish/guestfish.pod:976 ../test-tool/libguestfs-test-tool.pod:104 ../tools/virt-edit.pl:375
4756 msgid "ENVIRONMENT VARIABLES"
4757 msgstr ""
4758
4759 #. type: =item
4760 #: ../src/guestfs.pod:2448 ../fish/guestfish.pod:1002
4761 msgid "LIBGUESTFS_APPEND"
4762 msgstr ""
4763
4764 #. type: textblock
4765 #: ../src/guestfs.pod:2450 ../fish/guestfish.pod:1004
4766 msgid "Pass additional options to the guest kernel."
4767 msgstr ""
4768
4769 #. type: =item
4770 #: ../src/guestfs.pod:2452 ../fish/guestfish.pod:1006
4771 msgid "LIBGUESTFS_DEBUG"
4772 msgstr ""
4773
4774 #. type: textblock
4775 #: ../src/guestfs.pod:2454
4776 msgid ""
4777 "Set C<LIBGUESTFS_DEBUG=1> to enable verbose messages.  This has the same "
4778 "effect as calling C<guestfs_set_verbose (g, 1)>."
4779 msgstr ""
4780
4781 #. type: =item
4782 #: ../src/guestfs.pod:2457 ../fish/guestfish.pod:1011
4783 msgid "LIBGUESTFS_MEMSIZE"
4784 msgstr ""
4785
4786 #. type: textblock
4787 #: ../src/guestfs.pod:2459 ../fish/guestfish.pod:1013
4788 msgid "Set the memory allocated to the qemu process, in megabytes.  For example:"
4789 msgstr ""
4790
4791 #. type: verbatim
4792 #: ../src/guestfs.pod:2462 ../fish/guestfish.pod:1016
4793 #, no-wrap
4794 msgid ""
4795 " LIBGUESTFS_MEMSIZE=700\n"
4796 "\n"
4797 msgstr ""
4798
4799 #. type: =item
4800 #: ../src/guestfs.pod:2464 ../fish/guestfish.pod:1018
4801 msgid "LIBGUESTFS_PATH"
4802 msgstr ""
4803
4804 #. type: textblock
4805 #: ../src/guestfs.pod:2466
4806 msgid ""
4807 "Set the path that libguestfs uses to search for a supermin appliance.  See "
4808 "the discussion of paths in section L</PATH> above."
4809 msgstr ""
4810
4811 #. type: =item
4812 #: ../src/guestfs.pod:2469 ../fish/guestfish.pod:1023
4813 msgid "LIBGUESTFS_QEMU"
4814 msgstr ""
4815
4816 #. type: textblock
4817 #: ../src/guestfs.pod:2471 ../fish/guestfish.pod:1025
4818 msgid ""
4819 "Set the default qemu binary that libguestfs uses.  If not set, then the qemu "
4820 "which was found at compile time by the configure script is used."
4821 msgstr ""
4822
4823 #. type: textblock
4824 #: ../src/guestfs.pod:2475
4825 msgid "See also L</QEMU WRAPPERS> above."
4826 msgstr ""
4827
4828 #. type: =item
4829 #: ../src/guestfs.pod:2477 ../fish/guestfish.pod:1029
4830 msgid "LIBGUESTFS_TRACE"
4831 msgstr ""
4832
4833 #. type: textblock
4834 #: ../src/guestfs.pod:2479
4835 msgid ""
4836 "Set C<LIBGUESTFS_TRACE=1> to enable command traces.  This has the same "
4837 "effect as calling C<guestfs_set_trace (g, 1)>."
4838 msgstr ""
4839
4840 #. type: =item
4841 #: ../src/guestfs.pod:2482 ../fish/guestfish.pod:1038
4842 msgid "TMPDIR"
4843 msgstr ""
4844
4845 #. type: textblock
4846 #: ../src/guestfs.pod:2484 ../fish/guestfish.pod:1040
4847 msgid "Location of temporary directory, defaults to C</tmp>."
4848 msgstr ""
4849
4850 #. type: textblock
4851 #: ../src/guestfs.pod:2486 ../fish/guestfish.pod:1042
4852 msgid ""
4853 "If libguestfs was compiled to use the supermin appliance then the real "
4854 "appliance is cached in this directory, shared between all handles belonging "
4855 "to the same EUID.  You can use C<$TMPDIR> to configure another directory to "
4856 "use in case C</tmp> is not large enough."
4857 msgstr ""
4858
4859 #. type: =head1
4860 #: ../src/guestfs.pod:2494 ../fish/guestfish.pod:1100 ../test-tool/libguestfs-test-tool.pod:109 ../fuse/guestmount.pod:233 ../tools/virt-edit.pl:395 ../tools/virt-win-reg.pl:572 ../tools/virt-resize.pl:1483 ../tools/virt-list-filesystems.pl:189 ../tools/virt-tar.pl:281 ../tools/virt-make-fs.pl:539 ../tools/virt-list-partitions.pl:257
4861 msgid "SEE ALSO"
4862 msgstr ""
4863
4864 #. type: textblock
4865 #: ../src/guestfs.pod:2496
4866 msgid ""
4867 "L<guestfs-examples(3)>, L<guestfs-ocaml(3)>, L<guestfs-python(3)>, "
4868 "L<guestfs-ruby(3)>, L<guestfish(1)>, L<guestmount(1)>, L<virt-cat(1)>, "
4869 "L<virt-df(1)>, L<virt-edit(1)>, L<virt-filesystems(1)>, "
4870 "L<virt-inspector(1)>, L<virt-list-filesystems(1)>, "
4871 "L<virt-list-partitions(1)>, L<virt-ls(1)>, L<virt-make-fs(1)>, "
4872 "L<virt-rescue(1)>, L<virt-tar(1)>, L<virt-win-reg(1)>, L<qemu(1)>, "
4873 "L<febootstrap(1)>, L<hivex(3)>, L<http://libguestfs.org/>."
4874 msgstr ""
4875
4876 #. type: textblock
4877 #: ../src/guestfs.pod:2519
4878 msgid ""
4879 "Tools with a similar purpose: L<fdisk(8)>, L<parted(8)>, L<kpartx(8)>, "
4880 "L<lvm(8)>, L<disktype(1)>."
4881 msgstr ""
4882
4883 #. type: =head1
4884 #: ../src/guestfs.pod:2526 ../tools/virt-win-reg.pl:587 ../tools/virt-make-fs.pl:553
4885 msgid "BUGS"
4886 msgstr ""
4887
4888 #. type: textblock
4889 #: ../src/guestfs.pod:2528
4890 msgid "To get a list of bugs against libguestfs use this link:"
4891 msgstr ""
4892
4893 #. type: textblock
4894 #: ../src/guestfs.pod:2530
4895 msgid "L<https://bugzilla.redhat.com/buglist.cgi?component=libguestfs&product=Virtualization+Tools>"
4896 msgstr ""
4897
4898 #. type: textblock
4899 #: ../src/guestfs.pod:2532
4900 msgid "To report a new bug against libguestfs use this link:"
4901 msgstr ""
4902
4903 #. type: textblock
4904 #: ../src/guestfs.pod:2534
4905 msgid "L<https://bugzilla.redhat.com/enter_bug.cgi?component=libguestfs&product=Virtualization+Tools>"
4906 msgstr ""
4907
4908 #. type: textblock
4909 #: ../src/guestfs.pod:2536
4910 msgid "When reporting a bug, please check:"
4911 msgstr ""
4912
4913 #. type: textblock
4914 #: ../src/guestfs.pod:2542
4915 msgid "That the bug hasn't been reported already."
4916 msgstr ""
4917
4918 #. type: textblock
4919 #: ../src/guestfs.pod:2546
4920 msgid "That you are testing a recent version."
4921 msgstr ""
4922
4923 #. type: textblock
4924 #: ../src/guestfs.pod:2550
4925 msgid "Describe the bug accurately, and give a way to reproduce it."
4926 msgstr ""
4927
4928 #. type: textblock
4929 #: ../src/guestfs.pod:2554
4930 msgid ""
4931 "Run libguestfs-test-tool and paste the B<complete, unedited> output into the "
4932 "bug report."
4933 msgstr ""
4934
4935 #. type: =head1
4936 #: ../src/guestfs.pod:2559 ../fish/guestfish.pod:1119 ../test-tool/libguestfs-test-tool.pod:115 ../fuse/guestmount.pod:244
4937 msgid "AUTHORS"
4938 msgstr ""
4939
4940 #. type: textblock
4941 #: ../src/guestfs.pod:2561 ../fish/guestfish.pod:1121 ../test-tool/libguestfs-test-tool.pod:117 ../fuse/guestmount.pod:246
4942 msgid "Richard W.M. Jones (C<rjones at redhat dot com>)"
4943 msgstr ""
4944
4945 #. type: =head1
4946 #: ../src/guestfs.pod:2563 ../fish/guestfish.pod:1123 ../test-tool/libguestfs-test-tool.pod:119 ../fuse/guestmount.pod:248 ../tools/virt-edit.pl:411 ../tools/virt-win-reg.pl:602 ../tools/virt-resize.pl:1508 ../tools/virt-list-filesystems.pl:206 ../tools/virt-tar.pl:296 ../tools/virt-make-fs.pl:568 ../tools/virt-list-partitions.pl:273
4947 msgid "COPYRIGHT"
4948 msgstr ""
4949
4950 #. type: textblock
4951 #: ../src/guestfs.pod:2565 ../fish/guestfish.pod:1125 ../fuse/guestmount.pod:250
4952 msgid "Copyright (C) 2009-2010 Red Hat Inc.  L<http://libguestfs.org/>"
4953 msgstr ""
4954
4955 #. type: textblock
4956 #: ../src/guestfs.pod:2568
4957 msgid ""
4958 "This library is free software; you can redistribute it and/or modify it "
4959 "under the terms of the GNU Lesser General Public License as published by the "
4960 "Free Software Foundation; either version 2 of the License, or (at your "
4961 "option) any later version."
4962 msgstr ""
4963
4964 #. type: textblock
4965 #: ../src/guestfs.pod:2573
4966 msgid ""
4967 "This library is distributed in the hope that it will be useful, but WITHOUT "
4968 "ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or "
4969 "FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public License "
4970 "for more details."
4971 msgstr ""
4972
4973 #. type: textblock
4974 #: ../src/guestfs.pod:2578
4975 msgid ""
4976 "You should have received a copy of the GNU Lesser General Public License "
4977 "along with this library; if not, write to the Free Software Foundation, "
4978 "Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA"
4979 msgstr ""
4980
4981 #. type: =head2
4982 #: ../src/guestfs-actions.pod:1
4983 msgid "guestfs_add_cdrom"
4984 msgstr ""
4985
4986 #. type: verbatim
4987 #: ../src/guestfs-actions.pod:3
4988 #, no-wrap
4989 msgid ""
4990 " int\n"
4991 " guestfs_add_cdrom (guestfs_h *g,\n"
4992 "                    const char *filename);\n"
4993 "\n"
4994 msgstr ""
4995
4996 #. type: textblock
4997 #: ../src/guestfs-actions.pod:7 ../fish/guestfish-actions.pod:5
4998 msgid "This function adds a virtual CD-ROM disk image to the guest."
4999 msgstr ""
5000
5001 #. type: textblock
5002 #: ../src/guestfs-actions.pod:9 ../fish/guestfish-actions.pod:7
5003 msgid "This is equivalent to the qemu parameter C<-cdrom filename>."
5004 msgstr ""
5005
5006 #. type: textblock
5007 #: ../src/guestfs-actions.pod:17
5008 msgid ""
5009 "This call checks for the existence of C<filename>.  This stops you from "
5010 "specifying other types of drive which are supported by qemu such as C<nbd:> "
5011 "and C<http:> URLs.  To specify those, use the general C<guestfs_config> call "
5012 "instead."
5013 msgstr ""
5014
5015 #. type: textblock
5016 #: ../src/guestfs-actions.pod:24
5017 msgid ""
5018 "If you just want to add an ISO file (often you use this as an efficient way "
5019 "to transfer large files into the guest), then you should probably use "
5020 "C<guestfs_add_drive_ro> instead."
5021 msgstr ""
5022
5023 #. type: textblock
5024 #: ../src/guestfs-actions.pod:30 ../src/guestfs-actions.pod:126 ../src/guestfs-actions.pod:187 ../src/guestfs-actions.pod:224 ../src/guestfs-actions.pod:238 ../src/guestfs-actions.pod:259 ../src/guestfs-actions.pod:279 ../src/guestfs-actions.pod:293 ../src/guestfs-actions.pod:413 ../src/guestfs-actions.pod:433 ../src/guestfs-actions.pod:447 ../src/guestfs-actions.pod:492 ../src/guestfs-actions.pod:520 ../src/guestfs-actions.pod:538 ../src/guestfs-actions.pod:605 ../src/guestfs-actions.pod:638 ../src/guestfs-actions.pod:652 ../src/guestfs-actions.pod:667 ../src/guestfs-actions.pod:766 ../src/guestfs-actions.pod:784 ../src/guestfs-actions.pod:798 ../src/guestfs-actions.pod:812 ../src/guestfs-actions.pod:973 ../src/guestfs-actions.pod:993 ../src/guestfs-actions.pod:1011 ../src/guestfs-actions.pod:1095 ../src/guestfs-actions.pod:1113 ../src/guestfs-actions.pod:1132 ../src/guestfs-actions.pod:1146 ../src/guestfs-actions.pod:1166 ../src/guestfs-actions.pod:1236 ../src/guestfs-actions.pod:1267 ../src/guestfs-actions.pod:1292 ../src/guestfs-actions.pod:1329 ../src/guestfs-actions.pod:1435 ../src/guestfs-actions.pod:1469 ../src/guestfs-actions.pod:1684 ../src/guestfs-actions.pod:1706 ../src/guestfs-actions.pod:1793 ../src/guestfs-actions.pod:2267 ../src/guestfs-actions.pod:2411 ../src/guestfs-actions.pod:2472 ../src/guestfs-actions.pod:2507 ../src/guestfs-actions.pod:3250 ../src/guestfs-actions.pod:3265 ../src/guestfs-actions.pod:3285 ../src/guestfs-actions.pod:3440 ../src/guestfs-actions.pod:3454 ../src/guestfs-actions.pod:3467 ../src/guestfs-actions.pod:3481 ../src/guestfs-actions.pod:3496 ../src/guestfs-actions.pod:3532 ../src/guestfs-actions.pod:3604 ../src/guestfs-actions.pod:3624 ../src/guestfs-actions.pod:3641 ../src/guestfs-actions.pod:3664 ../src/guestfs-actions.pod:3687 ../src/guestfs-actions.pod:3719 ../src/guestfs-actions.pod:3738 ../src/guestfs-actions.pod:3757 ../src/guestfs-actions.pod:3792 ../src/guestfs-actions.pod:3804 ../src/guestfs-actions.pod:3840 ../src/guestfs-actions.pod:3856 ../src/guestfs-actions.pod:3869 ../src/guestfs-actions.pod:3884 ../src/guestfs-actions.pod:3901 ../src/guestfs-actions.pod:3994 ../src/guestfs-actions.pod:4014 ../src/guestfs-actions.pod:4027 ../src/guestfs-actions.pod:4078 ../src/guestfs-actions.pod:4096 ../src/guestfs-actions.pod:4114 ../src/guestfs-actions.pod:4130 ../src/guestfs-actions.pod:4144 ../src/guestfs-actions.pod:4158 ../src/guestfs-actions.pod:4175 ../src/guestfs-actions.pod:4190 ../src/guestfs-actions.pod:4210 ../src/guestfs-actions.pod:4256 ../src/guestfs-actions.pod:4329 ../src/guestfs-actions.pod:4360 ../src/guestfs-actions.pod:4379 ../src/guestfs-actions.pod:4398 ../src/guestfs-actions.pod:4410 ../src/guestfs-actions.pod:4427 ../src/guestfs-actions.pod:4440 ../src/guestfs-actions.pod:4455 ../src/guestfs-actions.pod:4470 ../src/guestfs-actions.pod:4505 ../src/guestfs-actions.pod:4520 ../src/guestfs-actions.pod:4540 ../src/guestfs-actions.pod:4554 ../src/guestfs-actions.pod:4571 ../src/guestfs-actions.pod:4620 ../src/guestfs-actions.pod:4666 ../src/guestfs-actions.pod:4680 ../src/guestfs-actions.pod:4708 ../src/guestfs-actions.pod:4725 ../src/guestfs-actions.pod:4743 ../src/guestfs-actions.pod:4877 ../src/guestfs-actions.pod:4934 ../src/guestfs-actions.pod:4956 ../src/guestfs-actions.pod:4974 ../src/guestfs-actions.pod:5006 ../src/guestfs-actions.pod:5072 ../src/guestfs-actions.pod:5089 ../src/guestfs-actions.pod:5102 ../src/guestfs-actions.pod:5116 ../src/guestfs-actions.pod:5405 ../src/guestfs-actions.pod:5424 ../src/guestfs-actions.pod:5438 ../src/guestfs-actions.pod:5450 ../src/guestfs-actions.pod:5464 ../src/guestfs-actions.pod:5476 ../src/guestfs-actions.pod:5490 ../src/guestfs-actions.pod:5506 ../src/guestfs-actions.pod:5527 ../src/guestfs-actions.pod:5546 ../src/guestfs-actions.pod:5565 ../src/guestfs-actions.pod:5583 ../src/guestfs-actions.pod:5606 ../src/guestfs-actions.pod:5624 ../src/guestfs-actions.pod:5643 ../src/guestfs-actions.pod:5664 ../src/guestfs-actions.pod:5683 ../src/guestfs-actions.pod:5700 ../src/guestfs-actions.pod:5728 ../src/guestfs-actions.pod:5752 ../src/guestfs-actions.pod:5771 ../src/guestfs-actions.pod:5795 ../src/guestfs-actions.pod:5810 ../src/guestfs-actions.pod:5825 ../src/guestfs-actions.pod:5844 ../src/guestfs-actions.pod:5881 ../src/guestfs-actions.pod:5904 ../src/guestfs-actions.pod:5930 ../src/guestfs-actions.pod:6038 ../src/guestfs-actions.pod:6159 ../src/guestfs-actions.pod:6171 ../src/guestfs-actions.pod:6184 ../src/guestfs-actions.pod:6197 ../src/guestfs-actions.pod:6219 ../src/guestfs-actions.pod:6232 ../src/guestfs-actions.pod:6245 ../src/guestfs-actions.pod:6258 ../src/guestfs-actions.pod:6273 ../src/guestfs-actions.pod:6332 ../src/guestfs-actions.pod:6349 ../src/guestfs-actions.pod:6365 ../src/guestfs-actions.pod:6381 ../src/guestfs-actions.pod:6398 ../src/guestfs-actions.pod:6411 ../src/guestfs-actions.pod:6431 ../src/guestfs-actions.pod:6467 ../src/guestfs-actions.pod:6481 ../src/guestfs-actions.pod:6522 ../src/guestfs-actions.pod:6535 ../src/guestfs-actions.pod:6553 ../src/guestfs-actions.pod:6587 ../src/guestfs-actions.pod:6623 ../src/guestfs-actions.pod:6742 ../src/guestfs-actions.pod:6760 ../src/guestfs-actions.pod:6774 ../src/guestfs-actions.pod:6829 ../src/guestfs-actions.pod:6842 ../src/guestfs-actions.pod:6887 ../src/guestfs-actions.pod:6920 ../src/guestfs-actions.pod:6974 ../src/guestfs-actions.pod:7000 ../src/guestfs-actions.pod:7066 ../src/guestfs-actions.pod:7085 ../src/guestfs-actions.pod:7114
5025 msgid "This function returns 0 on success or -1 on error."
5026 msgstr ""
5027
5028 #. type: textblock
5029 #: ../src/guestfs-actions.pod:32 ../src/guestfs-actions.pod:240 ../src/guestfs-actions.pod:261
5030 msgid ""
5031 "This function is deprecated.  In new code, use the "
5032 "L</guestfs_add_drive_opts> call instead."
5033 msgstr ""
5034
5035 #. type: textblock
5036 #: ../src/guestfs-actions.pod:35 ../src/guestfs-actions.pod:243 ../src/guestfs-actions.pod:264 ../src/guestfs-actions.pod:1440 ../src/guestfs-actions.pod:1923 ../src/guestfs-actions.pod:1944 ../src/guestfs-actions.pod:4215 ../src/guestfs-actions.pod:7008 ../src/guestfs-actions.pod:7177 ../fish/guestfish-actions.pod:31 ../fish/guestfish-actions.pod:154 ../fish/guestfish-actions.pod:168 ../fish/guestfish-actions.pod:954 ../fish/guestfish-actions.pod:1308 ../fish/guestfish-actions.pod:1322 ../fish/guestfish-actions.pod:2844 ../fish/guestfish-actions.pod:4657 ../fish/guestfish-actions.pod:4754
5037 msgid ""
5038 "Deprecated functions will not be removed from the API, but the fact that "
5039 "they are deprecated indicates that there are problems with correct use of "
5040 "these functions."
5041 msgstr ""
5042
5043 #. type: textblock
5044 #: ../src/guestfs-actions.pod:39 ../src/guestfs-actions.pod:128 ../src/guestfs-actions.pod:1097 ../src/guestfs-actions.pod:1895 ../src/guestfs-actions.pod:1993 ../src/guestfs-actions.pod:2096 ../src/guestfs-actions.pod:3252 ../src/guestfs-actions.pod:3267 ../src/guestfs-actions.pod:4507 ../src/guestfs-actions.pod:5585 ../src/guestfs-actions.pod:5702 ../src/guestfs-actions.pod:5812 ../src/guestfs-actions.pod:6275 ../src/guestfs-actions.pod:6400 ../src/guestfs-actions.pod:6922
5045 msgid "(Added in 0.3)"
5046 msgstr ""
5047
5048 #. type: =head2
5049 #: ../src/guestfs-actions.pod:41
5050 msgid "guestfs_add_domain"
5051 msgstr ""
5052
5053 #. type: verbatim
5054 #: ../src/guestfs-actions.pod:43
5055 #, no-wrap
5056 msgid ""
5057 " int\n"
5058 " guestfs_add_domain (guestfs_h *g,\n"
5059 "                     const char *dom,\n"
5060 "                     ...);\n"
5061 "\n"
5062 msgstr ""
5063
5064 #. type: textblock
5065 #: ../src/guestfs-actions.pod:48 ../src/guestfs-actions.pod:137 ../src/guestfs-actions.pod:4229
5066 msgid ""
5067 "You may supply a list of optional arguments to this call.  Use zero or more "
5068 "of the following pairs of parameters, and terminate the list with C<-1> on "
5069 "its own.  See L</CALLS WITH OPTIONAL ARGUMENTS>."
5070 msgstr ""
5071
5072 #. type: verbatim
5073 #: ../src/guestfs-actions.pod:53
5074 #, no-wrap
5075 msgid ""
5076 " GUESTFS_ADD_DOMAIN_LIBVIRTURI, const char *libvirturi,\n"
5077 " GUESTFS_ADD_DOMAIN_READONLY, int readonly,\n"
5078 " GUESTFS_ADD_DOMAIN_IFACE, const char *iface,\n"
5079 "\n"
5080 msgstr ""
5081
5082 #. type: textblock
5083 #: ../src/guestfs-actions.pod:57
5084 msgid ""
5085 "This function adds the disk(s) attached to the named libvirt domain C<dom>.  "
5086 "It works by connecting to libvirt, requesting the domain and domain XML from "
5087 "libvirt, parsing it for disks, and calling C<guestfs_add_drive_opts> on each "
5088 "one."
5089 msgstr ""
5090
5091 #. type: textblock
5092 #: ../src/guestfs-actions.pod:62 ../fish/guestfish-actions.pod:46
5093 msgid ""
5094 "The number of disks added is returned.  This operation is atomic: if an "
5095 "error is returned, then no disks are added."
5096 msgstr ""
5097
5098 #. type: textblock
5099 #: ../src/guestfs-actions.pod:65 ../fish/guestfish-actions.pod:49
5100 msgid ""
5101 "This function does some minimal checks to make sure the libvirt domain is "
5102 "not running (unless C<readonly> is true).  In a future version we will try "
5103 "to acquire the libvirt lock on each disk."
5104 msgstr ""
5105
5106 #. type: textblock
5107 #: ../src/guestfs-actions.pod:69 ../fish/guestfish-actions.pod:53
5108 msgid ""
5109 "Disks must be accessible locally.  This often means that adding disks from a "
5110 "remote libvirt connection (see L<http://libvirt.org/remote.html>)  will fail "
5111 "unless those disks are accessible via the same device path locally too."
5112 msgstr ""
5113
5114 #. type: textblock
5115 #: ../src/guestfs-actions.pod:74 ../fish/guestfish-actions.pod:58
5116 msgid ""
5117 "The optional C<libvirturi> parameter sets the libvirt URI (see "
5118 "L<http://libvirt.org/uri.html>).  If this is not set then we connect to the "
5119 "default libvirt URI (or one set through an environment variable, see the "
5120 "libvirt documentation for full details)."
5121 msgstr ""
5122
5123 #. type: textblock
5124 #: ../src/guestfs-actions.pod:80
5125 msgid ""
5126 "The other optional parameters are passed directly through to "
5127 "C<guestfs_add_drive_opts>."
5128 msgstr ""
5129
5130 #. type: textblock
5131 #: ../src/guestfs-actions.pod:83 ../src/guestfs-actions.pod:336 ../src/guestfs-actions.pod:506 ../src/guestfs-actions.pod:684 ../src/guestfs-actions.pod:715 ../src/guestfs-actions.pod:733 ../src/guestfs-actions.pod:752 ../src/guestfs-actions.pod:1312 ../src/guestfs-actions.pod:1663 ../src/guestfs-actions.pod:1866 ../src/guestfs-actions.pod:1965 ../src/guestfs-actions.pod:2005 ../src/guestfs-actions.pod:2060 ../src/guestfs-actions.pod:2083 ../src/guestfs-actions.pod:2398 ../src/guestfs-actions.pod:2686 ../src/guestfs-actions.pod:2707 ../src/guestfs-actions.pod:4643 ../src/guestfs-actions.pod:4780 ../src/guestfs-actions.pod:5186 ../src/guestfs-actions.pod:5212 ../src/guestfs-actions.pod:6508 ../src/guestfs-actions.pod:6933 ../src/guestfs-actions.pod:6946 ../src/guestfs-actions.pod:6959
5132 msgid "On error this function returns -1."
5133 msgstr ""
5134
5135 #. type: textblock
5136 #: ../src/guestfs-actions.pod:85
5137 msgid "(Added in 1.7.4)"
5138 msgstr ""
5139
5140 #. type: =head2
5141 #: ../src/guestfs-actions.pod:87
5142 msgid "guestfs_add_domain_va"
5143 msgstr ""
5144
5145 #. type: verbatim
5146 #: ../src/guestfs-actions.pod:89
5147 #, no-wrap
5148 msgid ""
5149 " int\n"
5150 " guestfs_add_domain_va (guestfs_h *g,\n"
5151 "                        const char *dom,\n"
5152 "                        va_list args);\n"
5153 "\n"
5154 msgstr ""
5155
5156 #. type: textblock
5157 #: ../src/guestfs-actions.pod:94
5158 msgid "This is the \"va_list variant\" of L</guestfs_add_domain>."
5159 msgstr ""
5160
5161 #. type: textblock
5162 #: ../src/guestfs-actions.pod:96 ../src/guestfs-actions.pod:107 ../src/guestfs-actions.pod:200 ../src/guestfs-actions.pod:211 ../src/guestfs-actions.pod:4270 ../src/guestfs-actions.pod:4282
5163 msgid "See L</CALLS WITH OPTIONAL ARGUMENTS>."
5164 msgstr ""
5165
5166 #. type: =head2
5167 #: ../src/guestfs-actions.pod:98
5168 msgid "guestfs_add_domain_argv"
5169 msgstr ""
5170
5171 #. type: verbatim
5172 #: ../src/guestfs-actions.pod:100
5173 #, no-wrap
5174 msgid ""
5175 " int\n"
5176 " guestfs_add_domain_argv (guestfs_h *g,\n"
5177 "                          const char *dom,\n"
5178 "                          const struct guestfs_add_domain_argv *optargs);\n"
5179 "\n"
5180 msgstr ""
5181
5182 #. type: textblock
5183 #: ../src/guestfs-actions.pod:105
5184 msgid "This is the \"argv variant\" of L</guestfs_add_domain>."
5185 msgstr ""
5186
5187 #. type: =head2
5188 #: ../src/guestfs-actions.pod:109
5189 msgid "guestfs_add_drive"
5190 msgstr ""
5191
5192 #. type: verbatim
5193 #: ../src/guestfs-actions.pod:111
5194 #, no-wrap
5195 msgid ""
5196 " int\n"
5197 " guestfs_add_drive (guestfs_h *g,\n"
5198 "                    const char *filename);\n"
5199 "\n"
5200 msgstr ""
5201
5202 #. type: textblock
5203 #: ../src/guestfs-actions.pod:115
5204 msgid ""
5205 "This function is the equivalent of calling C<guestfs_add_drive_opts> with no "
5206 "optional parameters, so the disk is added writable, with the format being "
5207 "detected automatically."
5208 msgstr ""
5209
5210 #. type: textblock
5211 #: ../src/guestfs-actions.pod:119
5212 msgid ""
5213 "Automatic detection of the format opens you up to a potential security hole "
5214 "when dealing with untrusted raw-format images.  See CVE-2010-3851 and "
5215 "RHBZ#642934.  Specifying the format closes this security hole.  Therefore "
5216 "you should think about replacing calls to this function with calls to "
5217 "C<guestfs_add_drive_opts>, and specifying the format."
5218 msgstr ""
5219
5220 #. type: =head2
5221 #: ../src/guestfs-actions.pod:130
5222 msgid "guestfs_add_drive_opts"
5223 msgstr ""
5224
5225 #. type: verbatim
5226 #: ../src/guestfs-actions.pod:132
5227 #, no-wrap
5228 msgid ""
5229 " int\n"
5230 " guestfs_add_drive_opts (guestfs_h *g,\n"
5231 "                         const char *filename,\n"
5232 "                         ...);\n"
5233 "\n"
5234 msgstr ""
5235
5236 #. type: verbatim
5237 #: ../src/guestfs-actions.pod:142
5238 #, no-wrap
5239 msgid ""
5240 " GUESTFS_ADD_DRIVE_OPTS_READONLY, int readonly,\n"
5241 " GUESTFS_ADD_DRIVE_OPTS_FORMAT, const char *format,\n"
5242 " GUESTFS_ADD_DRIVE_OPTS_IFACE, const char *iface,\n"
5243 "\n"
5244 msgstr ""
5245
5246 #. type: textblock
5247 #: ../src/guestfs-actions.pod:146 ../fish/guestfish-actions.pod:90
5248 msgid ""
5249 "This function adds a virtual machine disk image C<filename> to libguestfs.  "
5250 "The first time you call this function, the disk appears as C</dev/sda>, the "
5251 "second time as C</dev/sdb>, and so on."
5252 msgstr ""
5253
5254 #. type: textblock
5255 #: ../src/guestfs-actions.pod:151 ../fish/guestfish-actions.pod:95
5256 msgid ""
5257 "You don't necessarily need to be root when using libguestfs.  However you "
5258 "obviously do need sufficient permissions to access the filename for whatever "
5259 "operations you want to perform (ie. read access if you just want to read the "
5260 "image or write access if you want to modify the image)."
5261 msgstr ""
5262
5263 #. type: textblock
5264 #: ../src/guestfs-actions.pod:157 ../fish/guestfish-actions.pod:101
5265 msgid "This call checks that C<filename> exists."
5266 msgstr ""
5267
5268 #. type: textblock
5269 #: ../src/guestfs-actions.pod:159 ../src/guestfs-actions.pod:4239 ../fish/guestfish-actions.pod:103 ../fish/guestfish-actions.pod:2855
5270 msgid "The optional arguments are:"
5271 msgstr ""
5272
5273 #. type: =item
5274 #: ../src/guestfs-actions.pod:163 ../fish/guestfish-actions.pod:107
5275 msgid "C<readonly>"
5276 msgstr ""
5277
5278 #. type: textblock
5279 #: ../src/guestfs-actions.pod:165 ../fish/guestfish-actions.pod:109
5280 msgid ""
5281 "If true then the image is treated as read-only.  Writes are still allowed, "
5282 "but they are stored in a temporary snapshot overlay which is discarded at "
5283 "the end.  The disk that you add is not modified."
5284 msgstr ""
5285
5286 #. type: =item
5287 #: ../src/guestfs-actions.pod:169 ../fish/guestfish-actions.pod:113
5288 msgid "C<format>"
5289 msgstr ""
5290
5291 #. type: textblock
5292 #: ../src/guestfs-actions.pod:171
5293 msgid ""
5294 "This forces the image format.  If you omit this (or use C<guestfs_add_drive> "
5295 "or C<guestfs_add_drive_ro>) then the format is automatically detected.  "
5296 "Possible formats include C<raw> and C<qcow2>."
5297 msgstr ""
5298
5299 #. type: textblock
5300 #: ../src/guestfs-actions.pod:175 ../fish/guestfish-actions.pod:119
5301 msgid ""
5302 "Automatic detection of the format opens you up to a potential security hole "
5303 "when dealing with untrusted raw-format images.  See CVE-2010-3851 and "
5304 "RHBZ#642934.  Specifying the format closes this security hole."
5305 msgstr ""
5306
5307 #. type: =item
5308 #: ../src/guestfs-actions.pod:180 ../fish/guestfish-actions.pod:124
5309 msgid "C<iface>"
5310 msgstr ""
5311
5312 #. type: textblock
5313 #: ../src/guestfs-actions.pod:182
5314 msgid ""
5315 "This rarely-used option lets you emulate the behaviour of the deprecated "
5316 "C<guestfs_add_drive_with_if> call (q.v.)"
5317 msgstr ""
5318
5319 #. type: textblock
5320 #: ../src/guestfs-actions.pod:189
5321 msgid "(Added in 1.5.23)"
5322 msgstr ""
5323
5324 #. type: =head2
5325 #: ../src/guestfs-actions.pod:191
5326 msgid "guestfs_add_drive_opts_va"
5327 msgstr ""
5328
5329 #. type: verbatim
5330 #: ../src/guestfs-actions.pod:193
5331 #, no-wrap
5332 msgid ""
5333 " int\n"
5334 " guestfs_add_drive_opts_va (guestfs_h *g,\n"
5335 "                            const char *filename,\n"
5336 "                            va_list args);\n"
5337 "\n"
5338 msgstr ""
5339
5340 #. type: textblock
5341 #: ../src/guestfs-actions.pod:198
5342 msgid "This is the \"va_list variant\" of L</guestfs_add_drive_opts>."
5343 msgstr ""
5344
5345 #. type: =head2
5346 #: ../src/guestfs-actions.pod:202
5347 msgid "guestfs_add_drive_opts_argv"
5348 msgstr ""
5349
5350 #. type: verbatim
5351 #: ../src/guestfs-actions.pod:204
5352 #, no-wrap
5353 msgid ""
5354 " int\n"
5355 " guestfs_add_drive_opts_argv (guestfs_h *g,\n"
5356 "                              const char *filename,\n"
5357 "                              const struct guestfs_add_drive_opts_argv "
5358 "*optargs);\n"
5359 "\n"
5360 msgstr ""
5361
5362 #. type: textblock
5363 #: ../src/guestfs-actions.pod:209
5364 msgid "This is the \"argv variant\" of L</guestfs_add_drive_opts>."
5365 msgstr ""
5366
5367 #. type: =head2
5368 #: ../src/guestfs-actions.pod:213
5369 msgid "guestfs_add_drive_ro"
5370 msgstr ""
5371
5372 #. type: verbatim
5373 #: ../src/guestfs-actions.pod:215
5374 #, no-wrap
5375 msgid ""
5376 " int\n"
5377 " guestfs_add_drive_ro (guestfs_h *g,\n"
5378 "                       const char *filename);\n"
5379 "\n"
5380 msgstr ""
5381
5382 #. type: textblock
5383 #: ../src/guestfs-actions.pod:219
5384 msgid ""
5385 "This function is the equivalent of calling C<guestfs_add_drive_opts> with "
5386 "the optional parameter C<GUESTFS_ADD_DRIVE_OPTS_READONLY> set to 1, so the "
5387 "disk is added read-only, with the format being detected automatically."
5388 msgstr ""
5389
5390 #. type: textblock
5391 #: ../src/guestfs-actions.pod:226
5392 msgid "(Added in 1.0.38)"
5393 msgstr ""
5394
5395 #. type: =head2
5396 #: ../src/guestfs-actions.pod:228
5397 msgid "guestfs_add_drive_ro_with_if"
5398 msgstr ""
5399
5400 #. type: verbatim
5401 #: ../src/guestfs-actions.pod:230
5402 #, no-wrap
5403 msgid ""
5404 " int\n"
5405 " guestfs_add_drive_ro_with_if (guestfs_h *g,\n"
5406 "                               const char *filename,\n"
5407 "                               const char *iface);\n"
5408 "\n"
5409 msgstr ""
5410
5411 #. type: textblock
5412 #: ../src/guestfs-actions.pod:235
5413 msgid ""
5414 "This is the same as C<guestfs_add_drive_ro> but it allows you to specify the "
5415 "QEMU interface emulation to use at run time."
5416 msgstr ""
5417
5418 #. type: textblock
5419 #: ../src/guestfs-actions.pod:247 ../src/guestfs-actions.pod:268 ../src/guestfs-actions.pod:2357
5420 msgid "(Added in 1.0.84)"
5421 msgstr ""
5422
5423 #. type: =head2
5424 #: ../src/guestfs-actions.pod:249
5425 msgid "guestfs_add_drive_with_if"
5426 msgstr ""
5427
5428 #. type: verbatim
5429 #: ../src/guestfs-actions.pod:251
5430 #, no-wrap
5431 msgid ""
5432 " int\n"
5433 " guestfs_add_drive_with_if (guestfs_h *g,\n"
5434 "                            const char *filename,\n"
5435 "                            const char *iface);\n"
5436 "\n"
5437 msgstr ""
5438
5439 #. type: textblock
5440 #: ../src/guestfs-actions.pod:256
5441 msgid ""
5442 "This is the same as C<guestfs_add_drive> but it allows you to specify the "
5443 "QEMU interface emulation to use at run time."
5444 msgstr ""
5445
5446 #. type: =head2
5447 #: ../src/guestfs-actions.pod:270
5448 msgid "guestfs_aug_clear"
5449 msgstr ""
5450
5451 #. type: verbatim
5452 #: ../src/guestfs-actions.pod:272
5453 #, no-wrap
5454 msgid ""
5455 " int\n"
5456 " guestfs_aug_clear (guestfs_h *g,\n"
5457 "                    const char *augpath);\n"
5458 "\n"
5459 msgstr ""
5460
5461 #. type: textblock
5462 #: ../src/guestfs-actions.pod:276 ../fish/guestfish-actions.pod:176
5463 msgid ""
5464 "Set the value associated with C<path> to C<NULL>.  This is the same as the "
5465 "L<augtool(1)> C<clear> command."
5466 msgstr ""
5467
5468 #. type: textblock
5469 #: ../src/guestfs-actions.pod:281 ../src/guestfs-actions.pod:2085
5470 msgid "(Added in 1.3.4)"
5471 msgstr ""
5472
5473 #. type: =head2
5474 #: ../src/guestfs-actions.pod:283
5475 msgid "guestfs_aug_close"
5476 msgstr ""
5477
5478 #. type: verbatim
5479 #: ../src/guestfs-actions.pod:285
5480 #, no-wrap
5481 msgid ""
5482 " int\n"
5483 " guestfs_aug_close (guestfs_h *g);\n"
5484 "\n"
5485 msgstr ""
5486
5487 #. type: textblock
5488 #: ../src/guestfs-actions.pod:288
5489 msgid ""
5490 "Close the current Augeas handle and free up any resources used by it.  After "
5491 "calling this, you have to call C<guestfs_aug_init> again before you can use "
5492 "any other Augeas functions."
5493 msgstr ""
5494
5495 #. type: textblock
5496 #: ../src/guestfs-actions.pod:295 ../src/guestfs-actions.pod:320 ../src/guestfs-actions.pod:338 ../src/guestfs-actions.pod:352 ../src/guestfs-actions.pod:415 ../src/guestfs-actions.pod:435 ../src/guestfs-actions.pod:449 ../src/guestfs-actions.pod:480 ../src/guestfs-actions.pod:494 ../src/guestfs-actions.pod:508 ../src/guestfs-actions.pod:522 ../src/guestfs-actions.pod:540 ../src/guestfs-actions.pod:5263
5497 msgid "(Added in 0.7)"
5498 msgstr ""
5499
5500 #. type: =head2
5501 #: ../src/guestfs-actions.pod:297
5502 msgid "guestfs_aug_defnode"
5503 msgstr ""
5504
5505 #. type: verbatim
5506 #: ../src/guestfs-actions.pod:299
5507 #, no-wrap
5508 msgid ""
5509 " struct guestfs_int_bool *\n"
5510 " guestfs_aug_defnode (guestfs_h *g,\n"
5511 "                      const char *name,\n"
5512 "                      const char *expr,\n"
5513 "                      const char *val);\n"
5514 "\n"
5515 msgstr ""
5516
5517 #. type: textblock
5518 #: ../src/guestfs-actions.pod:305 ../fish/guestfish-actions.pod:192
5519 msgid "Defines a variable C<name> whose value is the result of evaluating C<expr>."
5520 msgstr ""
5521
5522 #. type: textblock
5523 #: ../src/guestfs-actions.pod:308
5524 msgid ""
5525 "If C<expr> evaluates to an empty nodeset, a node is created, equivalent to "
5526 "calling C<guestfs_aug_set> C<expr>, C<value>.  C<name> will be the nodeset "
5527 "containing that single node."
5528 msgstr ""
5529
5530 #. type: textblock
5531 #: ../src/guestfs-actions.pod:312 ../fish/guestfish-actions.pod:199
5532 msgid ""
5533 "On success this returns a pair containing the number of nodes in the "
5534 "nodeset, and a boolean flag if a node was created."
5535 msgstr ""
5536
5537 #. type: textblock
5538 #: ../src/guestfs-actions.pod:316
5539 msgid ""
5540 "This function returns a C<struct guestfs_int_bool *>, or NULL if there was "
5541 "an error.  I<The caller must call C<guestfs_free_int_bool> after use>."
5542 msgstr ""
5543
5544 #. type: =head2
5545 #: ../src/guestfs-actions.pod:322
5546 msgid "guestfs_aug_defvar"
5547 msgstr ""
5548
5549 #. type: verbatim
5550 #: ../src/guestfs-actions.pod:324
5551 #, no-wrap
5552 msgid ""
5553 " int\n"
5554 " guestfs_aug_defvar (guestfs_h *g,\n"
5555 "                     const char *name,\n"
5556 "                     const char *expr);\n"
5557 "\n"
5558 msgstr ""
5559
5560 #. type: textblock
5561 #: ../src/guestfs-actions.pod:329 ../fish/guestfish-actions.pod:207
5562 msgid ""
5563 "Defines an Augeas variable C<name> whose value is the result of evaluating "
5564 "C<expr>.  If C<expr> is NULL, then C<name> is undefined."
5565 msgstr ""
5566
5567 #. type: textblock
5568 #: ../src/guestfs-actions.pod:333 ../fish/guestfish-actions.pod:211
5569 msgid ""
5570 "On success this returns the number of nodes in C<expr>, or C<0> if C<expr> "
5571 "evaluates to something which is not a nodeset."
5572 msgstr ""
5573
5574 #. type: =head2
5575 #: ../src/guestfs-actions.pod:340
5576 msgid "guestfs_aug_get"
5577 msgstr ""
5578
5579 #. type: verbatim
5580 #: ../src/guestfs-actions.pod:342
5581 #, no-wrap
5582 msgid ""
5583 " char *\n"
5584 " guestfs_aug_get (guestfs_h *g,\n"
5585 "                  const char *augpath);\n"
5586 "\n"
5587 msgstr ""
5588
5589 #. type: textblock
5590 #: ../src/guestfs-actions.pod:346 ../fish/guestfish-actions.pod:218
5591 msgid ""
5592 "Look up the value associated with C<path>.  If C<path> matches exactly one "
5593 "node, the C<value> is returned."
5594 msgstr ""
5595
5596 #. type: textblock
5597 #: ../src/guestfs-actions.pod:349 ../src/guestfs-actions.pod:854 ../src/guestfs-actions.pod:872 ../src/guestfs-actions.pod:932 ../src/guestfs-actions.pod:948 ../src/guestfs-actions.pod:1051 ../src/guestfs-actions.pod:1181 ../src/guestfs-actions.pod:1198 ../src/guestfs-actions.pod:1217 ../src/guestfs-actions.pod:1346 ../src/guestfs-actions.pod:1534 ../src/guestfs-actions.pod:1646 ../src/guestfs-actions.pod:1809 ../src/guestfs-actions.pod:1826 ../src/guestfs-actions.pod:1917 ../src/guestfs-actions.pod:1938 ../src/guestfs-actions.pod:2108 ../src/guestfs-actions.pod:2322 ../src/guestfs-actions.pod:2529 ../src/guestfs-actions.pod:2610 ../src/guestfs-actions.pod:2658 ../src/guestfs-actions.pod:2772 ../src/guestfs-actions.pod:2803 ../src/guestfs-actions.pod:2827 ../src/guestfs-actions.pod:2889 ../src/guestfs-actions.pod:2912 ../src/guestfs-actions.pod:3426 ../src/guestfs-actions.pod:3776 ../src/guestfs-actions.pod:3946 ../src/guestfs-actions.pod:4056 ../src/guestfs-actions.pod:4798 ../src/guestfs-actions.pod:4991 ../src/guestfs-actions.pod:5161 ../src/guestfs-actions.pod:5339 ../src/guestfs-actions.pod:5388 ../src/guestfs-actions.pod:5951 ../src/guestfs-actions.pod:5967 ../src/guestfs-actions.pod:5984 ../src/guestfs-actions.pod:6008 ../src/guestfs-actions.pod:6682 ../src/guestfs-actions.pod:6701 ../src/guestfs-actions.pod:6719 ../src/guestfs-actions.pod:6899 ../src/guestfs-actions.pod:7171
5598 msgid ""
5599 "This function returns a string, or NULL on error.  I<The caller must free "
5600 "the returned string after use>."
5601 msgstr ""
5602
5603 #. type: =head2
5604 #: ../src/guestfs-actions.pod:354
5605 msgid "guestfs_aug_init"
5606 msgstr ""
5607
5608 #. type: verbatim
5609 #: ../src/guestfs-actions.pod:356
5610 #, no-wrap
5611 msgid ""
5612 " int\n"
5613 " guestfs_aug_init (guestfs_h *g,\n"
5614 "                   const char *root,\n"
5615 "                   int flags);\n"
5616 "\n"
5617 msgstr ""
5618
5619 #. type: textblock
5620 #: ../src/guestfs-actions.pod:361 ../fish/guestfish-actions.pod:225
5621 msgid ""
5622 "Create a new Augeas handle for editing configuration files.  If there was "
5623 "any previous Augeas handle associated with this guestfs session, then it is "
5624 "closed."
5625 msgstr ""
5626
5627 #. type: textblock
5628 #: ../src/guestfs-actions.pod:365
5629 msgid "You must call this before using any other C<guestfs_aug_*> commands."
5630 msgstr ""
5631
5632 #. type: textblock
5633 #: ../src/guestfs-actions.pod:368 ../fish/guestfish-actions.pod:232
5634 msgid "C<root> is the filesystem root.  C<root> must not be NULL, use C</> instead."
5635 msgstr ""
5636
5637 #. type: textblock
5638 #: ../src/guestfs-actions.pod:371 ../fish/guestfish-actions.pod:235
5639 msgid ""
5640 "The flags are the same as the flags defined in E<lt>augeas.hE<gt>, the "
5641 "logical I<or> of the following integers:"
5642 msgstr ""
5643
5644 #. type: =item
5645 #: ../src/guestfs-actions.pod:377 ../fish/guestfish-actions.pod:241
5646 msgid "C<AUG_SAVE_BACKUP> = 1"
5647 msgstr ""
5648
5649 #. type: textblock
5650 #: ../src/guestfs-actions.pod:379 ../fish/guestfish-actions.pod:243
5651 msgid "Keep the original file with a C<.augsave> extension."
5652 msgstr ""
5653
5654 #. type: =item
5655 #: ../src/guestfs-actions.pod:381 ../fish/guestfish-actions.pod:245
5656 msgid "C<AUG_SAVE_NEWFILE> = 2"
5657 msgstr ""
5658
5659 #. type: textblock
5660 #: ../src/guestfs-actions.pod:383 ../fish/guestfish-actions.pod:247
5661 msgid ""
5662 "Save changes into a file with extension C<.augnew>, and do not overwrite "
5663 "original.  Overrides C<AUG_SAVE_BACKUP>."
5664 msgstr ""
5665
5666 #. type: =item
5667 #: ../src/guestfs-actions.pod:386 ../fish/guestfish-actions.pod:250
5668 msgid "C<AUG_TYPE_CHECK> = 4"
5669 msgstr ""
5670
5671 #. type: textblock
5672 #: ../src/guestfs-actions.pod:388 ../fish/guestfish-actions.pod:252
5673 msgid "Typecheck lenses."
5674 msgstr ""
5675
5676 #. type: textblock
5677 #: ../src/guestfs-actions.pod:390
5678 msgid ""
5679 "This option is only useful when debugging Augeas lenses.  Use of this option "
5680 "may require additional memory for the libguestfs appliance.  You may need to "
5681 "set the C<LIBGUESTFS_MEMSIZE> environment variable or call "
5682 "C<guestfs_set_memsize>."
5683 msgstr ""
5684
5685 #. type: =item
5686 #: ../src/guestfs-actions.pod:395 ../fish/guestfish-actions.pod:259
5687 msgid "C<AUG_NO_STDINC> = 8"
5688 msgstr ""
5689
5690 #. type: textblock
5691 #: ../src/guestfs-actions.pod:397 ../fish/guestfish-actions.pod:261
5692 msgid "Do not use standard load path for modules."
5693 msgstr ""
5694
5695 #. type: =item
5696 #: ../src/guestfs-actions.pod:399 ../fish/guestfish-actions.pod:263
5697 msgid "C<AUG_SAVE_NOOP> = 16"
5698 msgstr ""
5699
5700 #. type: textblock
5701 #: ../src/guestfs-actions.pod:401 ../fish/guestfish-actions.pod:265
5702 msgid "Make save a no-op, just record what would have been changed."
5703 msgstr ""
5704
5705 #. type: =item
5706 #: ../src/guestfs-actions.pod:403 ../fish/guestfish-actions.pod:267
5707 msgid "C<AUG_NO_LOAD> = 32"
5708 msgstr ""
5709
5710 #. type: textblock
5711 #: ../src/guestfs-actions.pod:405
5712 msgid "Do not load the tree in C<guestfs_aug_init>."
5713 msgstr ""
5714
5715 #. type: textblock
5716 #: ../src/guestfs-actions.pod:409
5717 msgid "To close the handle, you can call C<guestfs_aug_close>."
5718 msgstr ""
5719
5720 #. type: textblock
5721 #: ../src/guestfs-actions.pod:411 ../fish/guestfish-actions.pod:275
5722 msgid "To find out more about Augeas, see L<http://augeas.net/>."
5723 msgstr ""
5724
5725 #. type: =head2
5726 #: ../src/guestfs-actions.pod:417
5727 msgid "guestfs_aug_insert"
5728 msgstr ""
5729
5730 #. type: verbatim
5731 #: ../src/guestfs-actions.pod:419
5732 #, no-wrap
5733 msgid ""
5734 " int\n"
5735 " guestfs_aug_insert (guestfs_h *g,\n"
5736 "                     const char *augpath,\n"
5737 "                     const char *label,\n"
5738 "                     int before);\n"
5739 "\n"
5740 msgstr ""
5741
5742 #. type: textblock
5743 #: ../src/guestfs-actions.pod:425 ../fish/guestfish-actions.pod:281
5744 msgid ""
5745 "Create a new sibling C<label> for C<path>, inserting it into the tree before "
5746 "or after C<path> (depending on the boolean flag C<before>)."
5747 msgstr ""
5748
5749 #. type: textblock
5750 #: ../src/guestfs-actions.pod:429 ../fish/guestfish-actions.pod:285
5751 msgid ""
5752 "C<path> must match exactly one existing node in the tree, and C<label> must "
5753 "be a label, ie. not contain C</>, C<*> or end with a bracketed index C<[N]>."
5754 msgstr ""
5755
5756 #. type: =head2
5757 #: ../src/guestfs-actions.pod:437
5758 msgid "guestfs_aug_load"
5759 msgstr ""
5760
5761 #. type: verbatim
5762 #: ../src/guestfs-actions.pod:439
5763 #, no-wrap
5764 msgid ""
5765 " int\n"
5766 " guestfs_aug_load (guestfs_h *g);\n"
5767 "\n"
5768 msgstr ""
5769
5770 #. type: textblock
5771 #: ../src/guestfs-actions.pod:442 ../fish/guestfish-actions.pod:293
5772 msgid "Load files into the tree."
5773 msgstr ""
5774
5775 #. type: textblock
5776 #: ../src/guestfs-actions.pod:444 ../fish/guestfish-actions.pod:295
5777 msgid "See C<aug_load> in the Augeas documentation for the full gory details."
5778 msgstr ""
5779
5780 #. type: =head2
5781 #: ../src/guestfs-actions.pod:451
5782 msgid "guestfs_aug_ls"
5783 msgstr ""
5784
5785 #. type: verbatim
5786 #: ../src/guestfs-actions.pod:453
5787 #, no-wrap
5788 msgid ""
5789 " char **\n"
5790 " guestfs_aug_ls (guestfs_h *g,\n"
5791 "                 const char *augpath);\n"
5792 "\n"
5793 msgstr ""
5794
5795 #. type: textblock
5796 #: ../src/guestfs-actions.pod:457
5797 msgid ""
5798 "This is just a shortcut for listing C<guestfs_aug_match> C<path/*> and "
5799 "sorting the resulting nodes into alphabetical order."
5800 msgstr ""
5801
5802 #. type: textblock
5803 #: ../src/guestfs-actions.pod:460 ../src/guestfs-actions.pod:476 ../src/guestfs-actions.pod:622 ../src/guestfs-actions.pod:1070 ../src/guestfs-actions.pod:1361 ../src/guestfs-actions.pod:1380 ../src/guestfs-actions.pod:1483 ../src/guestfs-actions.pod:1502 ../src/guestfs-actions.pod:1748 ../src/guestfs-actions.pod:2180 ../src/guestfs-actions.pod:2196 ../src/guestfs-actions.pod:2215 ../src/guestfs-actions.pod:2280 ../src/guestfs-actions.pod:2304 ../src/guestfs-actions.pod:2375 ../src/guestfs-actions.pod:2424 ../src/guestfs-actions.pod:2635 ../src/guestfs-actions.pod:2846 ../src/guestfs-actions.pod:3061 ../src/guestfs-actions.pod:3346 ../src/guestfs-actions.pod:3408 ../src/guestfs-actions.pod:3513 ../src/guestfs-actions.pod:3918 ../src/guestfs-actions.pod:4604 ../src/guestfs-actions.pod:5133 ../src/guestfs-actions.pod:5259 ../src/guestfs-actions.pod:5373 ../src/guestfs-actions.pod:6024 ../src/guestfs-actions.pod:6085 ../src/guestfs-actions.pod:6140 ../src/guestfs-actions.pod:6286 ../src/guestfs-actions.pod:6310 ../src/guestfs-actions.pod:6792 ../src/guestfs-actions.pod:6812 ../src/guestfs-actions.pod:6859 ../src/guestfs-actions.pod:7024 ../src/guestfs-actions.pod:7043 ../src/guestfs-actions.pod:7128 ../src/guestfs-actions.pod:7147 ../src/guestfs-actions.pod:7193 ../src/guestfs-actions.pod:7212
5804 msgid ""
5805 "This function returns a NULL-terminated array of strings (like "
5806 "L<environ(3)>), or NULL if there was an error.  I<The caller must free the "
5807 "strings and the array after use>."
5808 msgstr ""
5809
5810 #. type: textblock
5811 #: ../src/guestfs-actions.pod:464 ../src/guestfs-actions.pod:995 ../src/guestfs-actions.pod:1013 ../src/guestfs-actions.pod:1418 ../src/guestfs-actions.pod:3139 ../src/guestfs-actions.pod:3170 ../src/guestfs-actions.pod:3759 ../src/guestfs-actions.pod:3809 ../src/guestfs-actions.pod:3996 ../src/guestfs-actions.pod:4029 ../src/guestfs-actions.pod:4192 ../src/guestfs-actions.pod:4608 ../src/guestfs-actions.pod:5074 ../src/guestfs-actions.pod:5452 ../src/guestfs-actions.pod:5466 ../src/guestfs-actions.pod:5478 ../src/guestfs-actions.pod:5886 ../src/guestfs-actions.pod:6524 ../src/guestfs-actions.pod:6537 ../src/guestfs-actions.pod:6776 ../src/guestfs-actions.pod:7012
5812 msgid "(Added in 0.8)"
5813 msgstr ""
5814
5815 #. type: =head2
5816 #: ../src/guestfs-actions.pod:466
5817 msgid "guestfs_aug_match"
5818 msgstr ""
5819
5820 #. type: verbatim
5821 #: ../src/guestfs-actions.pod:468
5822 #, no-wrap
5823 msgid ""
5824 " char **\n"
5825 " guestfs_aug_match (guestfs_h *g,\n"
5826 "                    const char *augpath);\n"
5827 "\n"
5828 msgstr ""
5829
5830 #. type: textblock
5831 #: ../src/guestfs-actions.pod:472 ../fish/guestfish-actions.pod:309
5832 msgid ""
5833 "Returns a list of paths which match the path expression C<path>.  The "
5834 "returned paths are sufficiently qualified so that they match exactly one "
5835 "node in the current tree."
5836 msgstr ""
5837
5838 #. type: =head2
5839 #: ../src/guestfs-actions.pod:482
5840 msgid "guestfs_aug_mv"
5841 msgstr ""
5842
5843 #. type: verbatim
5844 #: ../src/guestfs-actions.pod:484
5845 #, no-wrap
5846 msgid ""
5847 " int\n"
5848 " guestfs_aug_mv (guestfs_h *g,\n"
5849 "                 const char *src,\n"
5850 "                 const char *dest);\n"
5851 "\n"
5852 msgstr ""
5853
5854 #. type: textblock
5855 #: ../src/guestfs-actions.pod:489 ../fish/guestfish-actions.pod:317
5856 msgid ""
5857 "Move the node C<src> to C<dest>.  C<src> must match exactly one node.  "
5858 "C<dest> is overwritten if it exists."
5859 msgstr ""
5860
5861 #. type: =head2
5862 #: ../src/guestfs-actions.pod:496
5863 msgid "guestfs_aug_rm"
5864 msgstr ""
5865
5866 #. type: verbatim
5867 #: ../src/guestfs-actions.pod:498
5868 #, no-wrap
5869 msgid ""
5870 " int\n"
5871 " guestfs_aug_rm (guestfs_h *g,\n"
5872 "                 const char *augpath);\n"
5873 "\n"
5874 msgstr ""
5875
5876 #. type: textblock
5877 #: ../src/guestfs-actions.pod:502 ../fish/guestfish-actions.pod:324
5878 msgid "Remove C<path> and all of its children."
5879 msgstr ""
5880
5881 #. type: textblock
5882 #: ../src/guestfs-actions.pod:504 ../fish/guestfish-actions.pod:326
5883 msgid "On success this returns the number of entries which were removed."
5884 msgstr ""
5885
5886 #. type: =head2
5887 #: ../src/guestfs-actions.pod:510
5888 msgid "guestfs_aug_save"
5889 msgstr ""
5890
5891 #. type: verbatim
5892 #: ../src/guestfs-actions.pod:512
5893 #, no-wrap
5894 msgid ""
5895 " int\n"
5896 " guestfs_aug_save (guestfs_h *g);\n"
5897 "\n"
5898 msgstr ""
5899
5900 #. type: textblock
5901 #: ../src/guestfs-actions.pod:515 ../fish/guestfish-actions.pod:332
5902 msgid "This writes all pending changes to disk."
5903 msgstr ""
5904
5905 #. type: textblock
5906 #: ../src/guestfs-actions.pod:517
5907 msgid ""
5908 "The flags which were passed to C<guestfs_aug_init> affect exactly how files "
5909 "are saved."
5910 msgstr ""
5911
5912 #. type: =head2
5913 #: ../src/guestfs-actions.pod:524
5914 msgid "guestfs_aug_set"
5915 msgstr ""
5916
5917 #. type: verbatim
5918 #: ../src/guestfs-actions.pod:526
5919 #, no-wrap
5920 msgid ""
5921 " int\n"
5922 " guestfs_aug_set (guestfs_h *g,\n"
5923 "                  const char *augpath,\n"
5924 "                  const char *val);\n"
5925 "\n"
5926 msgstr ""
5927
5928 #. type: textblock
5929 #: ../src/guestfs-actions.pod:531 ../fish/guestfish-actions.pod:341
5930 msgid "Set the value associated with C<path> to C<val>."
5931 msgstr ""
5932
5933 #. type: textblock
5934 #: ../src/guestfs-actions.pod:533
5935 msgid ""
5936 "In the Augeas API, it is possible to clear a node by setting the value to "
5937 "NULL.  Due to an oversight in the libguestfs API you cannot do that with "
5938 "this call.  Instead you must use the C<guestfs_aug_clear> call."
5939 msgstr ""
5940
5941 #. type: =head2
5942 #: ../src/guestfs-actions.pod:542
5943 msgid "guestfs_available"
5944 msgstr ""
5945
5946 #. type: verbatim
5947 #: ../src/guestfs-actions.pod:544
5948 #, no-wrap
5949 msgid ""
5950 " int\n"
5951 " guestfs_available (guestfs_h *g,\n"
5952 "                    char *const *groups);\n"
5953 "\n"
5954 msgstr ""
5955
5956 #. type: textblock
5957 #: ../src/guestfs-actions.pod:548 ../fish/guestfish-actions.pod:352
5958 msgid ""
5959 "This command is used to check the availability of some groups of "
5960 "functionality in the appliance, which not all builds of the libguestfs "
5961 "appliance will be able to provide."
5962 msgstr ""
5963
5964 #. type: textblock
5965 #: ../src/guestfs-actions.pod:552
5966 msgid ""
5967 "The libguestfs groups, and the functions that those groups correspond to, "
5968 "are listed in L<guestfs(3)/AVAILABILITY>.  You can also fetch this list at "
5969 "runtime by calling C<guestfs_available_all_groups>."
5970 msgstr ""
5971
5972 #. type: textblock
5973 #: ../src/guestfs-actions.pod:557 ../fish/guestfish-actions.pod:361
5974 msgid ""
5975 "The argument C<groups> is a list of group names, eg: C<[\"inotify\", "
5976 "\"augeas\"]> would check for the availability of the Linux inotify functions "
5977 "and Augeas (configuration file editing) functions."
5978 msgstr ""
5979
5980 #. type: textblock
5981 #: ../src/guestfs-actions.pod:562 ../fish/guestfish-actions.pod:366
5982 msgid "The command returns no error if I<all> requested groups are available."
5983 msgstr ""
5984
5985 #. type: textblock
5986 #: ../src/guestfs-actions.pod:564 ../fish/guestfish-actions.pod:368
5987 msgid ""
5988 "It fails with an error if one or more of the requested groups is unavailable "
5989 "in the appliance."
5990 msgstr ""
5991
5992 #. type: textblock
5993 #: ../src/guestfs-actions.pod:567 ../fish/guestfish-actions.pod:371
5994 msgid ""
5995 "If an unknown group name is included in the list of groups then an error is "
5996 "always returned."
5997 msgstr ""
5998
5999 #. type: textblock
6000 #: ../src/guestfs-actions.pod:570 ../fish/guestfish-actions.pod:374
6001 msgid "I<Notes:>"
6002 msgstr ""
6003
6004 #. type: textblock
6005 #: ../src/guestfs-actions.pod:576
6006 msgid "You must call C<guestfs_launch> before calling this function."
6007 msgstr ""
6008
6009 #. type: textblock
6010 #: ../src/guestfs-actions.pod:578 ../fish/guestfish-actions.pod:382
6011 msgid ""
6012 "The reason is because we don't know what groups are supported by the "
6013 "appliance/daemon until it is running and can be queried."
6014 msgstr ""
6015
6016 #. type: textblock
6017 #: ../src/guestfs-actions.pod:584 ../fish/guestfish-actions.pod:388
6018 msgid ""
6019 "If a group of functions is available, this does not necessarily mean that "
6020 "they will work.  You still have to check for errors when calling individual "
6021 "API functions even if they are available."
6022 msgstr ""
6023
6024 #. type: textblock
6025 #: ../src/guestfs-actions.pod:591 ../fish/guestfish-actions.pod:395
6026 msgid ""
6027 "It is usually the job of distro packagers to build complete functionality "
6028 "into the libguestfs appliance.  Upstream libguestfs, if built from source "
6029 "with all requirements satisfied, will support everything."
6030 msgstr ""
6031
6032 #. type: textblock
6033 #: ../src/guestfs-actions.pod:598
6034 msgid ""
6035 "This call was added in version C<1.0.80>.  In previous versions of "
6036 "libguestfs all you could do would be to speculatively execute a command to "
6037 "find out if the daemon implemented it.  See also C<guestfs_version>."
6038 msgstr ""
6039
6040 #. type: textblock
6041 #: ../src/guestfs-actions.pod:607 ../src/guestfs-actions.pod:1168
6042 msgid "(Added in 1.0.80)"
6043 msgstr ""
6044
6045 #. type: =head2
6046 #: ../src/guestfs-actions.pod:609
6047 msgid "guestfs_available_all_groups"
6048 msgstr ""
6049
6050 #. type: verbatim
6051 #: ../src/guestfs-actions.pod:611
6052 #, no-wrap
6053 msgid ""
6054 " char **\n"
6055 " guestfs_available_all_groups (guestfs_h *g);\n"
6056 "\n"
6057 msgstr ""
6058
6059 #. type: textblock
6060 #: ../src/guestfs-actions.pod:614
6061 msgid ""
6062 "This command returns a list of all optional groups that this daemon knows "
6063 "about.  Note this returns both supported and unsupported groups.  To find "
6064 "out which ones the daemon can actually support you have to call "
6065 "C<guestfs_available> on each member of the returned list."
6066 msgstr ""
6067
6068 #. type: textblock
6069 #: ../src/guestfs-actions.pod:620
6070 msgid "See also C<guestfs_available> and L<guestfs(3)/AVAILABILITY>."
6071 msgstr ""
6072
6073 #. type: textblock
6074 #: ../src/guestfs-actions.pod:626
6075 msgid "(Added in 1.3.15)"
6076 msgstr ""
6077
6078 #. type: =head2
6079 #: ../src/guestfs-actions.pod:628
6080 msgid "guestfs_base64_in"
6081 msgstr ""
6082
6083 #. type: verbatim
6084 #: ../src/guestfs-actions.pod:630
6085 #, no-wrap
6086 msgid ""
6087 " int\n"
6088 " guestfs_base64_in (guestfs_h *g,\n"
6089 "                    const char *base64file,\n"
6090 "                    const char *filename);\n"
6091 "\n"
6092 msgstr ""
6093
6094 #. type: textblock
6095 #: ../src/guestfs-actions.pod:635 ../fish/guestfish-actions.pod:425
6096 msgid "This command uploads base64-encoded data from C<base64file> to C<filename>."
6097 msgstr ""
6098
6099 #. type: textblock
6100 #: ../src/guestfs-actions.pod:640 ../src/guestfs-actions.pod:654
6101 msgid "(Added in 1.3.5)"
6102 msgstr ""
6103
6104 #. type: =head2
6105 #: ../src/guestfs-actions.pod:642
6106 msgid "guestfs_base64_out"
6107 msgstr ""
6108
6109 #. type: verbatim
6110 #: ../src/guestfs-actions.pod:644
6111 #, no-wrap
6112 msgid ""
6113 " int\n"
6114 " guestfs_base64_out (guestfs_h *g,\n"
6115 "                     const char *filename,\n"
6116 "                     const char *base64file);\n"
6117 "\n"
6118 msgstr ""
6119
6120 #. type: textblock
6121 #: ../src/guestfs-actions.pod:649 ../fish/guestfish-actions.pod:434
6122 msgid ""
6123 "This command downloads the contents of C<filename>, writing it out to local "
6124 "file C<base64file> encoded as base64."
6125 msgstr ""
6126
6127 #. type: =head2
6128 #: ../src/guestfs-actions.pod:656
6129 msgid "guestfs_blockdev_flushbufs"
6130 msgstr ""
6131
6132 #. type: verbatim
6133 #: ../src/guestfs-actions.pod:658
6134 #, no-wrap
6135 msgid ""
6136 " int\n"
6137 " guestfs_blockdev_flushbufs (guestfs_h *g,\n"
6138 "                             const char *device);\n"
6139 "\n"
6140 msgstr ""
6141
6142 #. type: textblock
6143 #: ../src/guestfs-actions.pod:662 ../fish/guestfish-actions.pod:443
6144 msgid "This tells the kernel to flush internal buffers associated with C<device>."
6145 msgstr ""
6146
6147 #. type: textblock
6148 #: ../src/guestfs-actions.pod:665 ../src/guestfs-actions.pod:682 ../src/guestfs-actions.pod:697 ../src/guestfs-actions.pod:713 ../src/guestfs-actions.pod:731 ../src/guestfs-actions.pod:750 ../src/guestfs-actions.pod:764 ../src/guestfs-actions.pod:782 ../src/guestfs-actions.pod:796 ../src/guestfs-actions.pod:810 ../fish/guestfish-actions.pod:446 ../fish/guestfish-actions.pod:457 ../fish/guestfish-actions.pod:466 ../fish/guestfish-actions.pod:476 ../fish/guestfish-actions.pod:488 ../fish/guestfish-actions.pod:501 ../fish/guestfish-actions.pod:509 ../fish/guestfish-actions.pod:520 ../fish/guestfish-actions.pod:528 ../fish/guestfish-actions.pod:536
6149 msgid "This uses the L<blockdev(8)> command."
6150 msgstr ""
6151
6152 #. type: textblock
6153 #: ../src/guestfs-actions.pod:669 ../src/guestfs-actions.pod:686 ../src/guestfs-actions.pod:701 ../src/guestfs-actions.pod:717 ../src/guestfs-actions.pod:735 ../src/guestfs-actions.pod:754 ../src/guestfs-actions.pod:768 ../src/guestfs-actions.pod:786 ../src/guestfs-actions.pod:800 ../src/guestfs-actions.pod:814
6154 msgid "(Added in 0.9.3)"
6155 msgstr ""
6156
6157 #. type: =head2
6158 #: ../src/guestfs-actions.pod:671
6159 msgid "guestfs_blockdev_getbsz"
6160 msgstr ""
6161
6162 #. type: verbatim
6163 #: ../src/guestfs-actions.pod:673
6164 #, no-wrap
6165 msgid ""
6166 " int\n"
6167 " guestfs_blockdev_getbsz (guestfs_h *g,\n"
6168 "                          const char *device);\n"
6169 "\n"
6170 msgstr ""
6171
6172 #. type: textblock
6173 #: ../src/guestfs-actions.pod:677 ../fish/guestfish-actions.pod:452
6174 msgid "This returns the block size of a device."
6175 msgstr ""
6176
6177 #. type: textblock
6178 #: ../src/guestfs-actions.pod:679 ../src/guestfs-actions.pod:779 ../fish/guestfish-actions.pod:454 ../fish/guestfish-actions.pod:517
6179 msgid ""
6180 "(Note this is different from both I<size in blocks> and I<filesystem block "
6181 "size>)."
6182 msgstr ""
6183
6184 #. type: =head2
6185 #: ../src/guestfs-actions.pod:688
6186 msgid "guestfs_blockdev_getro"
6187 msgstr ""
6188
6189 #. type: verbatim
6190 #: ../src/guestfs-actions.pod:690
6191 #, no-wrap
6192 msgid ""
6193 " int\n"
6194 " guestfs_blockdev_getro (guestfs_h *g,\n"
6195 "                         const char *device);\n"
6196 "\n"
6197 msgstr ""
6198
6199 #. type: textblock
6200 #: ../src/guestfs-actions.pod:694 ../fish/guestfish-actions.pod:463
6201 msgid ""
6202 "Returns a boolean indicating if the block device is read-only (true if "
6203 "read-only, false if not)."
6204 msgstr ""
6205
6206 #. type: textblock
6207 #: ../src/guestfs-actions.pod:699 ../src/guestfs-actions.pod:1401 ../src/guestfs-actions.pod:1416 ../src/guestfs-actions.pod:1893 ../src/guestfs-actions.pod:1904 ../src/guestfs-actions.pod:1976 ../src/guestfs-actions.pod:2031 ../src/guestfs-actions.pod:2046 ../src/guestfs-actions.pod:2071 ../src/guestfs-actions.pod:2094 ../src/guestfs-actions.pod:3078 ../src/guestfs-actions.pod:3092 ../src/guestfs-actions.pod:3107 ../src/guestfs-actions.pod:3121 ../src/guestfs-actions.pod:3137 ../src/guestfs-actions.pod:3152 ../src/guestfs-actions.pod:3168 ../src/guestfs-actions.pod:3182 ../src/guestfs-actions.pod:3195 ../src/guestfs-actions.pod:3209 ../src/guestfs-actions.pod:3224 ../src/guestfs-actions.pod:3239 ../src/guestfs-actions.pod:4762
6208 msgid "This function returns a C truth value on success or -1 on error."
6209 msgstr ""
6210
6211 #. type: =head2
6212 #: ../src/guestfs-actions.pod:703
6213 msgid "guestfs_blockdev_getsize64"
6214 msgstr ""
6215
6216 #. type: verbatim
6217 #: ../src/guestfs-actions.pod:705
6218 #, no-wrap
6219 msgid ""
6220 " int64_t\n"
6221 " guestfs_blockdev_getsize64 (guestfs_h *g,\n"
6222 "                             const char *device);\n"
6223 "\n"
6224 msgstr ""
6225
6226 #. type: textblock
6227 #: ../src/guestfs-actions.pod:709 ../fish/guestfish-actions.pod:472
6228 msgid "This returns the size of the device in bytes."
6229 msgstr ""
6230
6231 #. type: textblock
6232 #: ../src/guestfs-actions.pod:711
6233 msgid "See also C<guestfs_blockdev_getsz>."
6234 msgstr ""
6235
6236 #. type: =head2
6237 #: ../src/guestfs-actions.pod:719
6238 msgid "guestfs_blockdev_getss"
6239 msgstr ""
6240
6241 #. type: verbatim
6242 #: ../src/guestfs-actions.pod:721
6243 #, no-wrap
6244 msgid ""
6245 " int\n"
6246 " guestfs_blockdev_getss (guestfs_h *g,\n"
6247 "                         const char *device);\n"
6248 "\n"
6249 msgstr ""
6250
6251 #. type: textblock
6252 #: ../src/guestfs-actions.pod:725 ../fish/guestfish-actions.pod:482
6253 msgid ""
6254 "This returns the size of sectors on a block device.  Usually 512, but can be "
6255 "larger for modern devices."
6256 msgstr ""
6257
6258 #. type: textblock
6259 #: ../src/guestfs-actions.pod:728
6260 msgid ""
6261 "(Note, this is not the size in sectors, use C<guestfs_blockdev_getsz> for "
6262 "that)."
6263 msgstr ""
6264
6265 #. type: =head2
6266 #: ../src/guestfs-actions.pod:737
6267 msgid "guestfs_blockdev_getsz"
6268 msgstr ""
6269
6270 #. type: verbatim
6271 #: ../src/guestfs-actions.pod:739
6272 #, no-wrap
6273 msgid ""
6274 " int64_t\n"
6275 " guestfs_blockdev_getsz (guestfs_h *g,\n"
6276 "                         const char *device);\n"
6277 "\n"
6278 msgstr ""
6279
6280 #. type: textblock
6281 #: ../src/guestfs-actions.pod:743 ../fish/guestfish-actions.pod:494
6282 msgid ""
6283 "This returns the size of the device in units of 512-byte sectors (even if "
6284 "the sectorsize isn't 512 bytes ... weird)."
6285 msgstr ""
6286
6287 #. type: textblock
6288 #: ../src/guestfs-actions.pod:746
6289 msgid ""
6290 "See also C<guestfs_blockdev_getss> for the real sector size of the device, "
6291 "and C<guestfs_blockdev_getsize64> for the more useful I<size in bytes>."
6292 msgstr ""
6293
6294 #. type: =head2
6295 #: ../src/guestfs-actions.pod:756
6296 msgid "guestfs_blockdev_rereadpt"
6297 msgstr ""
6298
6299 #. type: verbatim
6300 #: ../src/guestfs-actions.pod:758
6301 #, no-wrap
6302 msgid ""
6303 " int\n"
6304 " guestfs_blockdev_rereadpt (guestfs_h *g,\n"
6305 "                            const char *device);\n"
6306 "\n"
6307 msgstr ""
6308
6309 #. type: textblock
6310 #: ../src/guestfs-actions.pod:762 ../fish/guestfish-actions.pod:507
6311 msgid "Reread the partition table on C<device>."
6312 msgstr ""
6313
6314 #. type: =head2
6315 #: ../src/guestfs-actions.pod:770
6316 msgid "guestfs_blockdev_setbsz"
6317 msgstr ""
6318
6319 #. type: verbatim
6320 #: ../src/guestfs-actions.pod:772
6321 #, no-wrap
6322 msgid ""
6323 " int\n"
6324 " guestfs_blockdev_setbsz (guestfs_h *g,\n"
6325 "                          const char *device,\n"
6326 "                          int blocksize);\n"
6327 "\n"
6328 msgstr ""
6329
6330 #. type: textblock
6331 #: ../src/guestfs-actions.pod:777 ../fish/guestfish-actions.pod:515
6332 msgid "This sets the block size of a device."
6333 msgstr ""
6334
6335 #. type: =head2
6336 #: ../src/guestfs-actions.pod:788
6337 msgid "guestfs_blockdev_setro"
6338 msgstr ""
6339
6340 #. type: verbatim
6341 #: ../src/guestfs-actions.pod:790
6342 #, no-wrap
6343 msgid ""
6344 " int\n"
6345 " guestfs_blockdev_setro (guestfs_h *g,\n"
6346 "                         const char *device);\n"
6347 "\n"
6348 msgstr ""
6349
6350 #. type: textblock
6351 #: ../src/guestfs-actions.pod:794 ../fish/guestfish-actions.pod:526
6352 msgid "Sets the block device named C<device> to read-only."
6353 msgstr ""
6354
6355 #. type: =head2
6356 #: ../src/guestfs-actions.pod:802
6357 msgid "guestfs_blockdev_setrw"
6358 msgstr ""
6359
6360 #. type: verbatim
6361 #: ../src/guestfs-actions.pod:804
6362 #, no-wrap
6363 msgid ""
6364 " int\n"
6365 " guestfs_blockdev_setrw (guestfs_h *g,\n"
6366 "                         const char *device);\n"
6367 "\n"
6368 msgstr ""
6369
6370 #. type: textblock
6371 #: ../src/guestfs-actions.pod:808 ../fish/guestfish-actions.pod:534
6372 msgid "Sets the block device named C<device> to read-write."
6373 msgstr ""
6374
6375 #. type: =head2
6376 #: ../src/guestfs-actions.pod:816
6377 msgid "guestfs_case_sensitive_path"
6378 msgstr ""
6379
6380 #. type: verbatim
6381 #: ../src/guestfs-actions.pod:818
6382 #, no-wrap
6383 msgid ""
6384 " char *\n"
6385 " guestfs_case_sensitive_path (guestfs_h *g,\n"
6386 "                              const char *path);\n"
6387 "\n"
6388 msgstr ""
6389
6390 #. type: textblock
6391 #: ../src/guestfs-actions.pod:822 ../fish/guestfish-actions.pod:542
6392 msgid ""
6393 "This can be used to resolve case insensitive paths on a filesystem which is "
6394 "case sensitive.  The use case is to resolve paths which you have read from "
6395 "Windows configuration files or the Windows Registry, to the true path."
6396 msgstr ""
6397
6398 #. type: textblock
6399 #: ../src/guestfs-actions.pod:827 ../fish/guestfish-actions.pod:547
6400 msgid ""
6401 "The command handles a peculiarity of the Linux ntfs-3g filesystem driver "
6402 "(and probably others), which is that although the underlying filesystem is "
6403 "case-insensitive, the driver exports the filesystem to Linux as "
6404 "case-sensitive."
6405 msgstr ""
6406
6407 #. type: textblock
6408 #: ../src/guestfs-actions.pod:832 ../fish/guestfish-actions.pod:552
6409 msgid ""
6410 "One consequence of this is that special directories such as C<c:\\windows> "
6411 "may appear as C</WINDOWS> or C</windows> (or other things) depending on the "
6412 "precise details of how they were created.  In Windows itself this would not "
6413 "be a problem."
6414 msgstr ""
6415
6416 #. type: textblock
6417 #: ../src/guestfs-actions.pod:838 ../fish/guestfish-actions.pod:558
6418 msgid ""
6419 "Bug or feature? You decide: "
6420 "L<http://www.tuxera.com/community/ntfs-3g-faq/#posixfilenames1>"
6421 msgstr ""
6422
6423 #. type: textblock
6424 #: ../src/guestfs-actions.pod:841 ../fish/guestfish-actions.pod:561
6425 msgid ""
6426 "This function resolves the true case of each element in the path and returns "
6427 "the case-sensitive path."
6428 msgstr ""
6429
6430 #. type: textblock
6431 #: ../src/guestfs-actions.pod:844
6432 msgid ""
6433 "Thus C<guestfs_case_sensitive_path> (\"/Windows/System32\")  might return "
6434 "C<\"/WINDOWS/system32\"> (the exact return value would depend on details of "
6435 "how the directories were originally created under Windows)."
6436 msgstr ""
6437
6438 #. type: textblock
6439 #: ../src/guestfs-actions.pod:849 ../fish/guestfish-actions.pod:569
6440 msgid "I<Note>: This function does not handle drive names, backslashes etc."
6441 msgstr ""
6442
6443 #. type: textblock
6444 #: ../src/guestfs-actions.pod:852
6445 msgid "See also C<guestfs_realpath>."
6446 msgstr ""
6447
6448 #. type: textblock
6449 #: ../src/guestfs-actions.pod:857 ../src/guestfs-actions.pod:6704
6450 msgid "(Added in 1.0.75)"
6451 msgstr ""
6452
6453 #. type: =head2
6454 #: ../src/guestfs-actions.pod:859
6455 msgid "guestfs_cat"
6456 msgstr ""
6457
6458 #. type: verbatim
6459 #: ../src/guestfs-actions.pod:861
6460 #, no-wrap
6461 msgid ""
6462 " char *\n"
6463 " guestfs_cat (guestfs_h *g,\n"
6464 "              const char *path);\n"
6465 "\n"
6466 msgstr ""
6467
6468 #. type: textblock
6469 #: ../src/guestfs-actions.pod:865 ../src/guestfs-actions.pod:5249 ../fish/guestfish-actions.pod:578 ../fish/guestfish-actions.pod:3501
6470 msgid "Return the contents of the file named C<path>."
6471 msgstr ""
6472
6473 #. type: textblock
6474 #: ../src/guestfs-actions.pod:867
6475 msgid ""
6476 "Note that this function cannot correctly handle binary files (specifically, "
6477 "files containing C<\\0> character which is treated as end of string).  For "
6478 "those you need to use the C<guestfs_read_file> or C<guestfs_download> "
6479 "functions which have a more complex interface."
6480 msgstr ""
6481
6482 #. type: textblock
6483 #: ../src/guestfs-actions.pod:875 ../src/guestfs-actions.pod:1054 ../src/guestfs-actions.pod:1074 ../src/guestfs-actions.pod:1365 ../src/guestfs-actions.pod:1384 ../src/guestfs-actions.pod:1487 ../src/guestfs-actions.pod:1506 ../src/guestfs-actions.pod:1752 ../src/guestfs-actions.pod:2200 ../src/guestfs-actions.pod:2219 ../src/guestfs-actions.pod:2284 ../src/guestfs-actions.pod:2308 ../src/guestfs-actions.pod:2325 ../src/guestfs-actions.pod:2354 ../src/guestfs-actions.pod:5031 ../src/guestfs-actions.pod:5057 ../src/guestfs-actions.pod:5188 ../src/guestfs-actions.pod:5214 ../src/guestfs-actions.pod:5238 ../src/guestfs-actions.pod:6089 ../src/guestfs-actions.pod:6144 ../src/guestfs-actions.pod:6290 ../src/guestfs-actions.pod:6314 ../src/guestfs-actions.pod:6976 ../src/guestfs-actions.pod:7002 ../src/guestfs-actions.pod:7028 ../src/guestfs-actions.pod:7047 ../src/guestfs-actions.pod:7132 ../src/guestfs-actions.pod:7151 ../src/guestfs-actions.pod:7197 ../src/guestfs-actions.pod:7216 ../fish/guestfish-actions.pod:585 ../fish/guestfish-actions.pod:720 ../fish/guestfish-actions.pod:732 ../fish/guestfish-actions.pod:908 ../fish/guestfish-actions.pod:918 ../fish/guestfish-actions.pod:985 ../fish/guestfish-actions.pod:995 ../fish/guestfish-actions.pod:1187 ../fish/guestfish-actions.pod:1482 ../fish/guestfish-actions.pod:1492 ../fish/guestfish-actions.pod:1542 ../fish/guestfish-actions.pod:1557 ../fish/guestfish-actions.pod:1567 ../fish/guestfish-actions.pod:1586 ../fish/guestfish-actions.pod:3371 ../fish/guestfish-actions.pod:3386 ../fish/guestfish-actions.pod:3462 ../fish/guestfish-actions.pod:3479 ../fish/guestfish-actions.pod:3494 ../fish/guestfish-actions.pod:4077 ../fish/guestfish-actions.pod:4123 ../fish/guestfish-actions.pod:4208 ../fish/guestfish-actions.pod:4223 ../fish/guestfish-actions.pod:4633 ../fish/guestfish-actions.pod:4651 ../fish/guestfish-actions.pod:4668 ../fish/guestfish-actions.pod:4678 ../fish/guestfish-actions.pod:4726 ../fish/guestfish-actions.pod:4736 ../fish/guestfish-actions.pod:4765 ../fish/guestfish-actions.pod:4775
6484 msgid ""
6485 "Because of the message protocol, there is a transfer limit of somewhere "
6486 "between 2MB and 4MB.  See L<guestfs(3)/PROTOCOL LIMITS>."
6487 msgstr ""
6488
6489 #. type: textblock
6490 #: ../src/guestfs-actions.pod:878 ../src/guestfs-actions.pod:3350 ../src/guestfs-actions.pod:3412 ../src/guestfs-actions.pod:3429 ../src/guestfs-actions.pod:3517 ../src/guestfs-actions.pod:3922 ../src/guestfs-actions.pod:3936 ../src/guestfs-actions.pod:5137 ../src/guestfs-actions.pod:5151 ../src/guestfs-actions.pod:6863 ../src/guestfs-actions.pod:6877
6491 msgid "(Added in 0.4)"
6492 msgstr ""
6493
6494 #. type: =head2
6495 #: ../src/guestfs-actions.pod:880
6496 msgid "guestfs_checksum"
6497 msgstr ""
6498
6499 #. type: verbatim
6500 #: ../src/guestfs-actions.pod:882
6501 #, no-wrap
6502 msgid ""
6503 " char *\n"
6504 " guestfs_checksum (guestfs_h *g,\n"
6505 "                   const char *csumtype,\n"
6506 "                   const char *path);\n"
6507 "\n"
6508 msgstr ""
6509
6510 #. type: textblock
6511 #: ../src/guestfs-actions.pod:887 ../fish/guestfish-actions.pod:592
6512 msgid "This call computes the MD5, SHAx or CRC checksum of the file named C<path>."
6513 msgstr ""
6514
6515 #. type: textblock
6516 #: ../src/guestfs-actions.pod:890 ../fish/guestfish-actions.pod:595
6517 msgid ""
6518 "The type of checksum to compute is given by the C<csumtype> parameter which "
6519 "must have one of the following values:"
6520 msgstr ""
6521
6522 #. type: =item
6523 #: ../src/guestfs-actions.pod:895 ../fish/guestfish-actions.pod:600
6524 msgid "C<crc>"
6525 msgstr ""
6526
6527 #. type: textblock
6528 #: ../src/guestfs-actions.pod:897 ../fish/guestfish-actions.pod:602
6529 msgid ""
6530 "Compute the cyclic redundancy check (CRC) specified by POSIX for the "
6531 "C<cksum> command."
6532 msgstr ""
6533
6534 #. type: =item
6535 #: ../src/guestfs-actions.pod:900 ../fish/guestfish-actions.pod:605
6536 msgid "C<md5>"
6537 msgstr ""
6538
6539 #. type: textblock
6540 #: ../src/guestfs-actions.pod:902 ../fish/guestfish-actions.pod:607
6541 msgid "Compute the MD5 hash (using the C<md5sum> program)."
6542 msgstr ""
6543
6544 #. type: =item
6545 #: ../src/guestfs-actions.pod:904 ../fish/guestfish-actions.pod:609
6546 msgid "C<sha1>"
6547 msgstr ""
6548
6549 #. type: textblock
6550 #: ../src/guestfs-actions.pod:906 ../fish/guestfish-actions.pod:611
6551 msgid "Compute the SHA1 hash (using the C<sha1sum> program)."
6552 msgstr ""
6553
6554 #. type: =item
6555 #: ../src/guestfs-actions.pod:908 ../fish/guestfish-actions.pod:613
6556 msgid "C<sha224>"
6557 msgstr ""
6558
6559 #. type: textblock
6560 #: ../src/guestfs-actions.pod:910 ../fish/guestfish-actions.pod:615
6561 msgid "Compute the SHA224 hash (using the C<sha224sum> program)."
6562 msgstr ""
6563
6564 #. type: =item
6565 #: ../src/guestfs-actions.pod:912 ../fish/guestfish-actions.pod:617
6566 msgid "C<sha256>"
6567 msgstr ""
6568
6569 #. type: textblock
6570 #: ../src/guestfs-actions.pod:914 ../fish/guestfish-actions.pod:619
6571 msgid "Compute the SHA256 hash (using the C<sha256sum> program)."
6572 msgstr ""
6573
6574 #. type: =item
6575 #: ../src/guestfs-actions.pod:916 ../fish/guestfish-actions.pod:621
6576 msgid "C<sha384>"
6577 msgstr ""
6578
6579 #. type: textblock
6580 #: ../src/guestfs-actions.pod:918 ../fish/guestfish-actions.pod:623
6581 msgid "Compute the SHA384 hash (using the C<sha384sum> program)."
6582 msgstr ""
6583
6584 #. type: =item
6585 #: ../src/guestfs-actions.pod:920 ../fish/guestfish-actions.pod:625
6586 msgid "C<sha512>"
6587 msgstr ""
6588
6589 #. type: textblock
6590 #: ../src/guestfs-actions.pod:922 ../fish/guestfish-actions.pod:627
6591 msgid "Compute the SHA512 hash (using the C<sha512sum> program)."
6592 msgstr ""
6593
6594 #. type: textblock
6595 #: ../src/guestfs-actions.pod:926 ../fish/guestfish-actions.pod:631
6596 msgid "The checksum is returned as a printable string."
6597 msgstr ""
6598
6599 #. type: textblock
6600 #: ../src/guestfs-actions.pod:928
6601 msgid "To get the checksum for a device, use C<guestfs_checksum_device>."
6602 msgstr ""
6603
6604 #. type: textblock
6605 #: ../src/guestfs-actions.pod:930
6606 msgid "To get the checksums for many files, use C<guestfs_checksums_out>."
6607 msgstr ""
6608
6609 #. type: textblock
6610 #: ../src/guestfs-actions.pod:935 ../src/guestfs-actions.pod:1243 ../src/guestfs-actions.pod:2062 ../src/guestfs-actions.pod:3094 ../src/guestfs-actions.pod:3123 ../src/guestfs-actions.pod:3184 ../src/guestfs-actions.pod:3211 ../src/guestfs-actions.pod:6560
6611 msgid "(Added in 1.0.2)"
6612 msgstr ""
6613
6614 #. type: =head2
6615 #: ../src/guestfs-actions.pod:937
6616 msgid "guestfs_checksum_device"
6617 msgstr ""
6618
6619 #. type: verbatim
6620 #: ../src/guestfs-actions.pod:939
6621 #, no-wrap
6622 msgid ""
6623 " char *\n"
6624 " guestfs_checksum_device (guestfs_h *g,\n"
6625 "                          const char *csumtype,\n"
6626 "                          const char *device);\n"
6627 "\n"
6628 msgstr ""
6629
6630 #. type: textblock
6631 #: ../src/guestfs-actions.pod:944
6632 msgid ""
6633 "This call computes the MD5, SHAx or CRC checksum of the contents of the "
6634 "device named C<device>.  For the types of checksums supported see the "
6635 "C<guestfs_checksum> command."
6636 msgstr ""
6637
6638 #. type: textblock
6639 #: ../src/guestfs-actions.pod:951 ../src/guestfs-actions.pod:4668 ../src/guestfs-actions.pod:4727 ../src/guestfs-actions.pod:4764 ../src/guestfs-actions.pod:4782 ../src/guestfs-actions.pod:4958 ../src/guestfs-actions.pod:6469 ../src/guestfs-actions.pod:6483 ../src/guestfs-actions.pod:6889
6640 msgid "(Added in 1.3.2)"
6641 msgstr ""
6642
6643 #. type: =head2
6644 #: ../src/guestfs-actions.pod:953
6645 msgid "guestfs_checksums_out"
6646 msgstr ""
6647
6648 #. type: verbatim
6649 #: ../src/guestfs-actions.pod:955
6650 #, no-wrap
6651 msgid ""
6652 " int\n"
6653 " guestfs_checksums_out (guestfs_h *g,\n"
6654 "                        const char *csumtype,\n"
6655 "                        const char *directory,\n"
6656 "                        const char *sumsfile);\n"
6657 "\n"
6658 msgstr ""
6659
6660 #. type: textblock
6661 #: ../src/guestfs-actions.pod:961 ../fish/guestfish-actions.pod:649
6662 msgid ""
6663 "This command computes the checksums of all regular files in C<directory> and "
6664 "then emits a list of those checksums to the local output file C<sumsfile>."
6665 msgstr ""
6666
6667 #. type: textblock
6668 #: ../src/guestfs-actions.pod:965 ../fish/guestfish-actions.pod:653
6669 msgid ""
6670 "This can be used for verifying the integrity of a virtual machine.  However "
6671 "to be properly secure you should pay attention to the output of the checksum "
6672 "command (it uses the ones from GNU coreutils).  In particular when the "
6673 "filename is not printable, coreutils uses a special backslash syntax.  For "
6674 "more information, see the GNU coreutils info file."
6675 msgstr ""
6676
6677 #. type: textblock
6678 #: ../src/guestfs-actions.pod:975
6679 msgid "(Added in 1.3.7)"
6680 msgstr ""
6681
6682 #. type: =head2
6683 #: ../src/guestfs-actions.pod:977
6684 msgid "guestfs_chmod"
6685 msgstr ""
6686
6687 #. type: verbatim
6688 #: ../src/guestfs-actions.pod:979
6689 #, no-wrap
6690 msgid ""
6691 " int\n"
6692 " guestfs_chmod (guestfs_h *g,\n"
6693 "                int mode,\n"
6694 "                const char *path);\n"
6695 "\n"
6696 msgstr ""
6697
6698 #. type: textblock
6699 #: ../src/guestfs-actions.pod:984 ../fish/guestfish-actions.pod:667
6700 msgid ""
6701 "Change the mode (permissions) of C<path> to C<mode>.  Only numeric modes are "
6702 "supported."
6703 msgstr ""
6704
6705 #. type: textblock
6706 #: ../src/guestfs-actions.pod:987 ../fish/guestfish-actions.pod:670
6707 msgid ""
6708 "I<Note>: When using this command from guestfish, C<mode> by default would be "
6709 "decimal, unless you prefix it with C<0> to get octal, ie. use C<0700> not "
6710 "C<700>."
6711 msgstr ""
6712
6713 #. type: textblock
6714 #: ../src/guestfs-actions.pod:991 ../src/guestfs-actions.pod:4173 ../src/guestfs-actions.pod:4358 ../src/guestfs-actions.pod:4377 ../src/guestfs-actions.pod:4396 ../fish/guestfish-actions.pod:674 ../fish/guestfish-actions.pod:2819 ../fish/guestfish-actions.pod:2937 ../fish/guestfish-actions.pod:2947 ../fish/guestfish-actions.pod:2957
6715 msgid "The mode actually set is affected by the umask."
6716 msgstr ""
6717
6718 #. type: =head2
6719 #: ../src/guestfs-actions.pod:997
6720 msgid "guestfs_chown"
6721 msgstr ""
6722
6723 #. type: verbatim
6724 #: ../src/guestfs-actions.pod:999
6725 #, no-wrap
6726 msgid ""
6727 " int\n"
6728 " guestfs_chown (guestfs_h *g,\n"
6729 "                int owner,\n"
6730 "                int group,\n"
6731 "                const char *path);\n"
6732 "\n"
6733 msgstr ""
6734
6735 #. type: textblock
6736 #: ../src/guestfs-actions.pod:1005 ../fish/guestfish-actions.pod:680
6737 msgid "Change the file owner to C<owner> and group to C<group>."
6738 msgstr ""
6739
6740 #. type: textblock
6741 #: ../src/guestfs-actions.pod:1007 ../src/guestfs-actions.pod:3281 ../fish/guestfish-actions.pod:682 ../fish/guestfish-actions.pod:2277
6742 msgid ""
6743 "Only numeric uid and gid are supported.  If you want to use names, you will "
6744 "need to locate and parse the password file yourself (Augeas support makes "
6745 "this relatively easy)."
6746 msgstr ""
6747
6748 #. type: =head2
6749 #: ../src/guestfs-actions.pod:1015
6750 msgid "guestfs_command"
6751 msgstr ""
6752
6753 #. type: verbatim
6754 #: ../src/guestfs-actions.pod:1017
6755 #, no-wrap
6756 msgid ""
6757 " char *\n"
6758 " guestfs_command (guestfs_h *g,\n"
6759 "                  char *const *arguments);\n"
6760 "\n"
6761 msgstr ""
6762
6763 #. type: textblock
6764 #: ../src/guestfs-actions.pod:1021 ../fish/guestfish-actions.pod:690
6765 msgid ""
6766 "This call runs a command from the guest filesystem.  The filesystem must be "
6767 "mounted, and must contain a compatible operating system (ie. something "
6768 "Linux, with the same or compatible processor architecture)."
6769 msgstr ""
6770
6771 #. type: textblock
6772 #: ../src/guestfs-actions.pod:1026
6773 msgid ""
6774 "The single parameter is an argv-style list of arguments.  The first element "
6775 "is the name of the program to run.  Subsequent elements are parameters.  The "
6776 "list must be non-empty (ie. must contain a program name).  Note that the "
6777 "command runs directly, and is I<not> invoked via the shell (see "
6778 "C<guestfs_sh>)."
6779 msgstr ""
6780
6781 #. type: textblock
6782 #: ../src/guestfs-actions.pod:1033 ../fish/guestfish-actions.pod:702
6783 msgid "The return value is anything printed to I<stdout> by the command."
6784 msgstr ""
6785
6786 #. type: textblock
6787 #: ../src/guestfs-actions.pod:1036 ../fish/guestfish-actions.pod:705
6788 msgid ""
6789 "If the command returns a non-zero exit status, then this function returns an "
6790 "error message.  The error message string is the content of I<stderr> from "
6791 "the command."
6792 msgstr ""
6793
6794 #. type: textblock
6795 #: ../src/guestfs-actions.pod:1040 ../fish/guestfish-actions.pod:709
6796 msgid ""
6797 "The C<$PATH> environment variable will contain at least C</usr/bin> and "
6798 "C</bin>.  If you require a program from another location, you should provide "
6799 "the full path in the first parameter."
6800 msgstr ""
6801
6802 #. type: textblock
6803 #: ../src/guestfs-actions.pod:1045 ../fish/guestfish-actions.pod:714
6804 msgid ""
6805 "Shared libraries and data files required by the program must be available on "
6806 "filesystems which are mounted in the correct places.  It is the caller's "
6807 "responsibility to ensure all filesystems that are needed are mounted at the "
6808 "right locations."
6809 msgstr ""
6810
6811 #. type: textblock
6812 #: ../src/guestfs-actions.pod:1057 ../src/guestfs-actions.pod:1077 ../src/guestfs-actions.pod:1537
6813 msgid "(Added in 0.9.1)"
6814 msgstr ""
6815
6816 #. type: =head2
6817 #: ../src/guestfs-actions.pod:1059
6818 msgid "guestfs_command_lines"
6819 msgstr ""
6820
6821 #. type: verbatim
6822 #: ../src/guestfs-actions.pod:1061
6823 #, no-wrap
6824 msgid ""
6825 " char **\n"
6826 " guestfs_command_lines (guestfs_h *g,\n"
6827 "                        char *const *arguments);\n"
6828 "\n"
6829 msgstr ""
6830
6831 #. type: textblock
6832 #: ../src/guestfs-actions.pod:1065
6833 msgid ""
6834 "This is the same as C<guestfs_command>, but splits the result into a list of "
6835 "lines."
6836 msgstr ""
6837
6838 #. type: textblock
6839 #: ../src/guestfs-actions.pod:1068
6840 msgid "See also: C<guestfs_sh_lines>"
6841 msgstr ""
6842
6843 #. type: =head2
6844 #: ../src/guestfs-actions.pod:1079
6845 msgid "guestfs_config"
6846 msgstr ""
6847
6848 #. type: verbatim
6849 #: ../src/guestfs-actions.pod:1081
6850 #, no-wrap
6851 msgid ""
6852 " int\n"
6853 " guestfs_config (guestfs_h *g,\n"
6854 "                 const char *qemuparam,\n"
6855 "                 const char *qemuvalue);\n"
6856 "\n"
6857 msgstr ""
6858
6859 #. type: textblock
6860 #: ../src/guestfs-actions.pod:1086 ../fish/guestfish-actions.pod:739
6861 msgid ""
6862 "This can be used to add arbitrary qemu command line parameters of the form "
6863 "C<-param value>.  Actually it's not quite arbitrary - we prevent you from "
6864 "setting some parameters which would interfere with parameters that we use."
6865 msgstr ""
6866
6867 #. type: textblock
6868 #: ../src/guestfs-actions.pod:1091 ../fish/guestfish-actions.pod:744
6869 msgid "The first character of C<param> string must be a C<-> (dash)."
6870 msgstr ""
6871
6872 #. type: textblock
6873 #: ../src/guestfs-actions.pod:1093 ../fish/guestfish-actions.pod:746
6874 msgid "C<value> can be NULL."
6875 msgstr ""
6876
6877 #. type: =head2
6878 #: ../src/guestfs-actions.pod:1099
6879 msgid "guestfs_copy_size"
6880 msgstr ""
6881
6882 #. type: verbatim
6883 #: ../src/guestfs-actions.pod:1101
6884 #, no-wrap
6885 msgid ""
6886 " int\n"
6887 " guestfs_copy_size (guestfs_h *g,\n"
6888 "                    const char *src,\n"
6889 "                    const char *dest,\n"
6890 "                    int64_t size);\n"
6891 "\n"
6892 msgstr ""
6893
6894 #. type: textblock
6895 #: ../src/guestfs-actions.pod:1107 ../fish/guestfish-actions.pod:752
6896 msgid ""
6897 "This command copies exactly C<size> bytes from one source device or file "
6898 "C<src> to another destination device or file C<dest>."
6899 msgstr ""
6900
6901 #. type: textblock
6902 #: ../src/guestfs-actions.pod:1110 ../fish/guestfish-actions.pod:755
6903 msgid ""
6904 "Note this will fail if the source is too short or if the destination is not "
6905 "large enough."
6906 msgstr ""
6907
6908 #. type: textblock
6909 #: ../src/guestfs-actions.pod:1115 ../src/guestfs-actions.pod:1238 ../src/guestfs-actions.pod:1269 ../src/guestfs-actions.pod:1686 ../src/guestfs-actions.pod:1708 ../src/guestfs-actions.pod:6555 ../src/guestfs-actions.pod:6589 ../src/guestfs-actions.pod:7068 ../src/guestfs-actions.pod:7087
6910 msgid ""
6911 "This long-running command can generate progress notification messages so "
6912 "that the caller can display a progress bar or indicator.  To receive these "
6913 "messages, the caller must register a progress callback.  See "
6914 "L<guestfs(3)/guestfs_set_progress_callback>."
6915 msgstr ""
6916
6917 #. type: textblock
6918 #: ../src/guestfs-actions.pod:1120 ../src/guestfs-actions.pod:3949 ../src/guestfs-actions.pod:5164 ../src/guestfs-actions.pod:6796 ../src/guestfs-actions.pod:6816 ../src/guestfs-actions.pod:6902
6919 msgid "(Added in 1.0.87)"
6920 msgstr ""
6921
6922 #. type: =head2
6923 #: ../src/guestfs-actions.pod:1122
6924 msgid "guestfs_cp"
6925 msgstr ""
6926
6927 #. type: verbatim
6928 #: ../src/guestfs-actions.pod:1124
6929 #, no-wrap
6930 msgid ""
6931 " int\n"
6932 " guestfs_cp (guestfs_h *g,\n"
6933 "             const char *src,\n"
6934 "             const char *dest);\n"
6935 "\n"
6936 msgstr ""
6937
6938 #. type: textblock
6939 #: ../src/guestfs-actions.pod:1129 ../fish/guestfish-actions.pod:762
6940 msgid ""
6941 "This copies a file from C<src> to C<dest> where C<dest> is either a "
6942 "destination filename or destination directory."
6943 msgstr ""
6944
6945 #. type: textblock
6946 #: ../src/guestfs-actions.pod:1134 ../src/guestfs-actions.pod:1148 ../src/guestfs-actions.pod:1220 ../src/guestfs-actions.pod:1294 ../src/guestfs-actions.pod:1403 ../src/guestfs-actions.pod:4622 ../src/guestfs-actions.pod:5008
6947 msgid "(Added in 1.0.18)"
6948 msgstr ""
6949
6950 #. type: =head2
6951 #: ../src/guestfs-actions.pod:1136
6952 msgid "guestfs_cp_a"
6953 msgstr ""
6954
6955 #. type: verbatim
6956 #: ../src/guestfs-actions.pod:1138
6957 #, no-wrap
6958 msgid ""
6959 " int\n"
6960 " guestfs_cp_a (guestfs_h *g,\n"
6961 "               const char *src,\n"
6962 "               const char *dest);\n"
6963 "\n"
6964 msgstr ""
6965
6966 #. type: textblock
6967 #: ../src/guestfs-actions.pod:1143 ../fish/guestfish-actions.pod:769
6968 msgid ""
6969 "This copies a file or directory from C<src> to C<dest> recursively using the "
6970 "C<cp -a> command."
6971 msgstr ""
6972
6973 #. type: =head2
6974 #: ../src/guestfs-actions.pod:1150
6975 msgid "guestfs_dd"
6976 msgstr ""
6977
6978 #. type: verbatim
6979 #: ../src/guestfs-actions.pod:1152
6980 #, no-wrap
6981 msgid ""
6982 " int\n"
6983 " guestfs_dd (guestfs_h *g,\n"
6984 "             const char *src,\n"
6985 "             const char *dest);\n"
6986 "\n"
6987 msgstr ""
6988
6989 #. type: textblock
6990 #: ../src/guestfs-actions.pod:1157 ../fish/guestfish-actions.pod:776
6991 msgid ""
6992 "This command copies from one source device or file C<src> to another "
6993 "destination device or file C<dest>.  Normally you would use this to copy to "
6994 "or from a device or partition, for example to duplicate a filesystem."
6995 msgstr ""
6996
6997 #. type: textblock
6998 #: ../src/guestfs-actions.pod:1162
6999 msgid ""
7000 "If the destination is a device, it must be as large or larger than the "
7001 "source file or device, otherwise the copy will fail.  This command cannot do "
7002 "partial copies (see C<guestfs_copy_size>)."
7003 msgstr ""
7004
7005 #. type: =head2
7006 #: ../src/guestfs-actions.pod:1170
7007 msgid "guestfs_df"
7008 msgstr ""
7009
7010 #. type: verbatim
7011 #: ../src/guestfs-actions.pod:1172
7012 #, no-wrap
7013 msgid ""
7014 " char *\n"
7015 " guestfs_df (guestfs_h *g);\n"
7016 "\n"
7017 msgstr ""
7018
7019 #. type: textblock
7020 #: ../src/guestfs-actions.pod:1175 ../fish/guestfish-actions.pod:789
7021 msgid "This command runs the C<df> command to report disk space used."
7022 msgstr ""
7023
7024 #. type: textblock
7025 #: ../src/guestfs-actions.pod:1177 ../src/guestfs-actions.pod:1194
7026 msgid ""
7027 "This command is mostly useful for interactive sessions.  It is I<not> "
7028 "intended that you try to parse the output string.  Use C<guestfs_statvfs> "
7029 "from programs."
7030 msgstr ""
7031
7032 #. type: textblock
7033 #: ../src/guestfs-actions.pod:1184 ../src/guestfs-actions.pod:1201 ../src/guestfs-actions.pod:1314 ../src/guestfs-actions.pod:2287 ../src/guestfs-actions.pod:2311 ../src/guestfs-actions.pod:2379 ../src/guestfs-actions.pod:4059 ../src/guestfs-actions.pod:4522 ../src/guestfs-actions.pod:6293 ../src/guestfs-actions.pod:6317 ../src/guestfs-actions.pod:6935 ../src/guestfs-actions.pod:6948 ../src/guestfs-actions.pod:6961
7034 msgid "(Added in 1.0.54)"
7035 msgstr ""
7036
7037 #. type: =head2
7038 #: ../src/guestfs-actions.pod:1186
7039 msgid "guestfs_df_h"
7040 msgstr ""
7041
7042 #. type: verbatim
7043 #: ../src/guestfs-actions.pod:1188
7044 #, no-wrap
7045 msgid ""
7046 " char *\n"
7047 " guestfs_df_h (guestfs_h *g);\n"
7048 "\n"
7049 msgstr ""
7050
7051 #. type: textblock
7052 #: ../src/guestfs-actions.pod:1191 ../fish/guestfish-actions.pod:799
7053 msgid ""
7054 "This command runs the C<df -h> command to report disk space used in "
7055 "human-readable format."
7056 msgstr ""
7057
7058 #. type: =head2
7059 #: ../src/guestfs-actions.pod:1203
7060 msgid "guestfs_dmesg"
7061 msgstr ""
7062
7063 #. type: verbatim
7064 #: ../src/guestfs-actions.pod:1205
7065 #, no-wrap
7066 msgid ""
7067 " char *\n"
7068 " guestfs_dmesg (guestfs_h *g);\n"
7069 "\n"
7070 msgstr ""
7071
7072 #. type: textblock
7073 #: ../src/guestfs-actions.pod:1208 ../fish/guestfish-actions.pod:810
7074 msgid ""
7075 "This returns the kernel messages (C<dmesg> output) from the guest kernel.  "
7076 "This is sometimes useful for extended debugging of problems."
7077 msgstr ""
7078
7079 #. type: textblock
7080 #: ../src/guestfs-actions.pod:1212
7081 msgid ""
7082 "Another way to get the same information is to enable verbose messages with "
7083 "C<guestfs_set_verbose> or by setting the environment variable "
7084 "C<LIBGUESTFS_DEBUG=1> before running the program."
7085 msgstr ""
7086
7087 #. type: =head2
7088 #: ../src/guestfs-actions.pod:1222
7089 msgid "guestfs_download"
7090 msgstr ""
7091
7092 #. type: verbatim
7093 #: ../src/guestfs-actions.pod:1224
7094 #, no-wrap
7095 msgid ""
7096 " int\n"
7097 " guestfs_download (guestfs_h *g,\n"
7098 "                   const char *remotefilename,\n"
7099 "                   const char *filename);\n"
7100 "\n"
7101 msgstr ""
7102
7103 #. type: textblock
7104 #: ../src/guestfs-actions.pod:1229 ../src/guestfs-actions.pod:1254 ../fish/guestfish-actions.pod:823 ../fish/guestfish-actions.pod:836
7105 msgid ""
7106 "Download file C<remotefilename> and save it as C<filename> on the local "
7107 "machine."
7108 msgstr ""
7109
7110 #. type: textblock
7111 #: ../src/guestfs-actions.pod:1232 ../src/guestfs-actions.pod:6549 ../fish/guestfish-actions.pod:826 ../fish/guestfish-actions.pod:4381
7112 msgid "C<filename> can also be a named pipe."
7113 msgstr ""
7114
7115 #. type: textblock
7116 #: ../src/guestfs-actions.pod:1234
7117 msgid "See also C<guestfs_upload>, C<guestfs_cat>."
7118 msgstr ""
7119
7120 #. type: =head2
7121 #: ../src/guestfs-actions.pod:1245
7122 msgid "guestfs_download_offset"
7123 msgstr ""
7124
7125 #. type: verbatim
7126 #: ../src/guestfs-actions.pod:1247
7127 #, no-wrap
7128 msgid ""
7129 " int\n"
7130 " guestfs_download_offset (guestfs_h *g,\n"
7131 "                          const char *remotefilename,\n"
7132 "                          const char *filename,\n"
7133 "                          int64_t offset,\n"
7134 "                          int64_t size);\n"
7135 "\n"
7136 msgstr ""
7137
7138 #. type: textblock
7139 #: ../src/guestfs-actions.pod:1257 ../fish/guestfish-actions.pod:839
7140 msgid ""
7141 "C<remotefilename> is read for C<size> bytes starting at C<offset> (this "
7142 "region must be within the file or device)."
7143 msgstr ""
7144
7145 #. type: textblock
7146 #: ../src/guestfs-actions.pod:1260
7147 msgid ""
7148 "Note that there is no limit on the amount of data that can be downloaded "
7149 "with this call, unlike with C<guestfs_pread>, and this call always reads the "
7150 "full amount unless an error occurs."
7151 msgstr ""
7152
7153 #. type: textblock
7154 #: ../src/guestfs-actions.pod:1265
7155 msgid "See also C<guestfs_download>, C<guestfs_pread>."
7156 msgstr ""
7157
7158 #. type: textblock
7159 #: ../src/guestfs-actions.pod:1274 ../src/guestfs-actions.pod:6594
7160 msgid "(Added in 1.5.17)"
7161 msgstr ""
7162
7163 #. type: =head2
7164 #: ../src/guestfs-actions.pod:1276
7165 msgid "guestfs_drop_caches"
7166 msgstr ""
7167
7168 #. type: verbatim
7169 #: ../src/guestfs-actions.pod:1278
7170 #, no-wrap
7171 msgid ""
7172 " int\n"
7173 " guestfs_drop_caches (guestfs_h *g,\n"
7174 "                      int whattodrop);\n"
7175 "\n"
7176 msgstr ""
7177
7178 #. type: textblock
7179 #: ../src/guestfs-actions.pod:1282 ../fish/guestfish-actions.pod:855
7180 msgid ""
7181 "This instructs the guest kernel to drop its page cache, and/or dentries and "
7182 "inode caches.  The parameter C<whattodrop> tells the kernel what precisely "
7183 "to drop, see L<http://linux-mm.org/Drop_Caches>"
7184 msgstr ""
7185
7186 #. type: textblock
7187 #: ../src/guestfs-actions.pod:1287 ../fish/guestfish-actions.pod:860
7188 msgid "Setting C<whattodrop> to 3 should drop everything."
7189 msgstr ""
7190
7191 #. type: textblock
7192 #: ../src/guestfs-actions.pod:1289 ../fish/guestfish-actions.pod:862
7193 msgid ""
7194 "This automatically calls L<sync(2)> before the operation, so that the "
7195 "maximum guest memory is freed."
7196 msgstr ""
7197
7198 #. type: =head2
7199 #: ../src/guestfs-actions.pod:1296
7200 msgid "guestfs_du"
7201 msgstr ""
7202
7203 #. type: verbatim
7204 #: ../src/guestfs-actions.pod:1298
7205 #, no-wrap
7206 msgid ""
7207 " int64_t\n"
7208 " guestfs_du (guestfs_h *g,\n"
7209 "             const char *path);\n"
7210 "\n"
7211 msgstr ""
7212
7213 #. type: textblock
7214 #: ../src/guestfs-actions.pod:1302 ../fish/guestfish-actions.pod:869
7215 msgid ""
7216 "This command runs the C<du -s> command to estimate file space usage for "
7217 "C<path>."
7218 msgstr ""
7219
7220 #. type: textblock
7221 #: ../src/guestfs-actions.pod:1305 ../fish/guestfish-actions.pod:872
7222 msgid ""
7223 "C<path> can be a file or a directory.  If C<path> is a directory then the "
7224 "estimate includes the contents of the directory and all subdirectories "
7225 "(recursively)."
7226 msgstr ""
7227
7228 #. type: textblock
7229 #: ../src/guestfs-actions.pod:1309 ../fish/guestfish-actions.pod:876
7230 msgid "The result is the estimated size in I<kilobytes> (ie. units of 1024 bytes)."
7231 msgstr ""
7232
7233 #. type: =head2
7234 #: ../src/guestfs-actions.pod:1316
7235 msgid "guestfs_e2fsck_f"
7236 msgstr ""
7237
7238 #. type: verbatim
7239 #: ../src/guestfs-actions.pod:1318
7240 #, no-wrap
7241 msgid ""
7242 " int\n"
7243 " guestfs_e2fsck_f (guestfs_h *g,\n"
7244 "                   const char *device);\n"
7245 "\n"
7246 msgstr ""
7247
7248 #. type: textblock
7249 #: ../src/guestfs-actions.pod:1322 ../fish/guestfish-actions.pod:883
7250 msgid ""
7251 "This runs C<e2fsck -p -f device>, ie. runs the ext2/ext3 filesystem checker "
7252 "on C<device>, noninteractively (C<-p>), even if the filesystem appears to be "
7253 "clean (C<-f>)."
7254 msgstr ""
7255
7256 #. type: textblock
7257 #: ../src/guestfs-actions.pod:1326
7258 msgid ""
7259 "This command is only needed because of C<guestfs_resize2fs> (q.v.).  "
7260 "Normally you should use C<guestfs_fsck>."
7261 msgstr ""
7262
7263 #. type: textblock
7264 #: ../src/guestfs-actions.pod:1331
7265 msgid "(Added in 1.0.29)"
7266 msgstr ""
7267
7268 #. type: =head2
7269 #: ../src/guestfs-actions.pod:1333
7270 msgid "guestfs_echo_daemon"
7271 msgstr ""
7272
7273 #. type: verbatim
7274 #: ../src/guestfs-actions.pod:1335
7275 #, no-wrap
7276 msgid ""
7277 " char *\n"
7278 " guestfs_echo_daemon (guestfs_h *g,\n"
7279 "                      char *const *words);\n"
7280 "\n"
7281 msgstr ""
7282
7283 #. type: textblock
7284 #: ../src/guestfs-actions.pod:1339 ../fish/guestfish-actions.pod:894
7285 msgid ""
7286 "This command concatenates the list of C<words> passed with single spaces "
7287 "between them and returns the resulting string."
7288 msgstr ""
7289
7290 #. type: textblock
7291 #: ../src/guestfs-actions.pod:1342 ../fish/guestfish-actions.pod:897
7292 msgid "You can use this command to test the connection through to the daemon."
7293 msgstr ""
7294
7295 #. type: textblock
7296 #: ../src/guestfs-actions.pod:1344
7297 msgid "See also C<guestfs_ping_daemon>."
7298 msgstr ""
7299
7300 #. type: textblock
7301 #: ../src/guestfs-actions.pod:1349 ../src/guestfs-actions.pod:2073 ../src/guestfs-actions.pod:5797
7302 msgid "(Added in 1.0.69)"
7303 msgstr ""
7304
7305 #. type: =head2
7306 #: ../src/guestfs-actions.pod:1351
7307 msgid "guestfs_egrep"
7308 msgstr ""
7309
7310 #. type: verbatim
7311 #: ../src/guestfs-actions.pod:1353
7312 #, no-wrap
7313 msgid ""
7314 " char **\n"
7315 " guestfs_egrep (guestfs_h *g,\n"
7316 "                const char *regex,\n"
7317 "                const char *path);\n"
7318 "\n"
7319 msgstr ""
7320
7321 #. type: textblock
7322 #: ../src/guestfs-actions.pod:1358 ../fish/guestfish-actions.pod:905
7323 msgid "This calls the external C<egrep> program and returns the matching lines."
7324 msgstr ""
7325
7326 #. type: textblock
7327 #: ../src/guestfs-actions.pod:1368 ../src/guestfs-actions.pod:1387 ../src/guestfs-actions.pod:1444 ../src/guestfs-actions.pod:1490 ../src/guestfs-actions.pod:1509 ../src/guestfs-actions.pod:2203 ../src/guestfs-actions.pod:2222 ../src/guestfs-actions.pod:2400 ../src/guestfs-actions.pod:2413 ../src/guestfs-actions.pod:2428 ../src/guestfs-actions.pod:2474 ../src/guestfs-actions.pod:2496 ../src/guestfs-actions.pod:2509 ../src/guestfs-actions.pod:3442 ../src/guestfs-actions.pod:3456 ../src/guestfs-actions.pod:3469 ../src/guestfs-actions.pod:3483 ../src/guestfs-actions.pod:4457 ../src/guestfs-actions.pod:5342 ../src/guestfs-actions.pod:5391 ../src/guestfs-actions.pod:6161 ../src/guestfs-actions.pod:6173 ../src/guestfs-actions.pod:6186 ../src/guestfs-actions.pod:6199 ../src/guestfs-actions.pod:6221 ../src/guestfs-actions.pod:6234 ../src/guestfs-actions.pod:6247 ../src/guestfs-actions.pod:6260 ../src/guestfs-actions.pod:7031 ../src/guestfs-actions.pod:7050 ../src/guestfs-actions.pod:7135 ../src/guestfs-actions.pod:7154 ../src/guestfs-actions.pod:7200 ../src/guestfs-actions.pod:7219
7328 msgid "(Added in 1.0.66)"
7329 msgstr ""
7330
7331 #. type: =head2
7332 #: ../src/guestfs-actions.pod:1370
7333 msgid "guestfs_egrepi"
7334 msgstr ""
7335
7336 #. type: verbatim
7337 #: ../src/guestfs-actions.pod:1372
7338 #, no-wrap
7339 msgid ""
7340 " char **\n"
7341 " guestfs_egrepi (guestfs_h *g,\n"
7342 "                 const char *regex,\n"
7343 "                 const char *path);\n"
7344 "\n"
7345 msgstr ""
7346
7347 #. type: textblock
7348 #: ../src/guestfs-actions.pod:1377 ../fish/guestfish-actions.pod:915
7349 msgid "This calls the external C<egrep -i> program and returns the matching lines."
7350 msgstr ""
7351
7352 #. type: =head2
7353 #: ../src/guestfs-actions.pod:1389
7354 msgid "guestfs_equal"
7355 msgstr ""
7356
7357 #. type: verbatim
7358 #: ../src/guestfs-actions.pod:1391
7359 #, no-wrap
7360 msgid ""
7361 " int\n"
7362 " guestfs_equal (guestfs_h *g,\n"
7363 "                const char *file1,\n"
7364 "                const char *file2);\n"
7365 "\n"
7366 msgstr ""
7367
7368 #. type: textblock
7369 #: ../src/guestfs-actions.pod:1396 ../fish/guestfish-actions.pod:925
7370 msgid ""
7371 "This compares the two files C<file1> and C<file2> and returns true if their "
7372 "content is exactly equal, or false otherwise."
7373 msgstr ""
7374
7375 #. type: textblock
7376 #: ../src/guestfs-actions.pod:1399 ../fish/guestfish-actions.pod:928
7377 msgid "The external L<cmp(1)> program is used for the comparison."
7378 msgstr ""
7379
7380 #. type: =head2
7381 #: ../src/guestfs-actions.pod:1405
7382 msgid "guestfs_exists"
7383 msgstr ""
7384
7385 #. type: verbatim
7386 #: ../src/guestfs-actions.pod:1407
7387 #, no-wrap
7388 msgid ""
7389 " int\n"
7390 " guestfs_exists (guestfs_h *g,\n"
7391 "                 const char *path);\n"
7392 "\n"
7393 msgstr ""
7394
7395 #. type: textblock
7396 #: ../src/guestfs-actions.pod:1411 ../fish/guestfish-actions.pod:934
7397 msgid ""
7398 "This returns C<true> if and only if there is a file, directory (or anything) "
7399 "with the given C<path> name."
7400 msgstr ""
7401
7402 #. type: textblock
7403 #: ../src/guestfs-actions.pod:1414
7404 msgid "See also C<guestfs_is_file>, C<guestfs_is_dir>, C<guestfs_stat>."
7405 msgstr ""
7406
7407 #. type: =head2
7408 #: ../src/guestfs-actions.pod:1420
7409 msgid "guestfs_fallocate"
7410 msgstr ""
7411
7412 #. type: verbatim
7413 #: ../src/guestfs-actions.pod:1422
7414 #, no-wrap
7415 msgid ""
7416 " int\n"
7417 " guestfs_fallocate (guestfs_h *g,\n"
7418 "                    const char *path,\n"
7419 "                    int len);\n"
7420 "\n"
7421 msgstr ""
7422
7423 #. type: textblock
7424 #: ../src/guestfs-actions.pod:1427 ../src/guestfs-actions.pod:1453 ../fish/guestfish-actions.pod:943 ../fish/guestfish-actions.pod:962
7425 msgid ""
7426 "This command preallocates a file (containing zero bytes) named C<path> of "
7427 "size C<len> bytes.  If the file exists already, it is overwritten."
7428 msgstr ""
7429
7430 #. type: textblock
7431 #: ../src/guestfs-actions.pod:1431 ../fish/guestfish-actions.pod:947
7432 msgid ""
7433 "Do not confuse this with the guestfish-specific C<alloc> command which "
7434 "allocates a file in the host and attaches it as a device."
7435 msgstr ""
7436
7437 #. type: textblock
7438 #: ../src/guestfs-actions.pod:1437
7439 msgid ""
7440 "This function is deprecated.  In new code, use the L</guestfs_fallocate64> "
7441 "call instead."
7442 msgstr ""
7443
7444 #. type: =head2
7445 #: ../src/guestfs-actions.pod:1446
7446 msgid "guestfs_fallocate64"
7447 msgstr ""
7448
7449 #. type: verbatim
7450 #: ../src/guestfs-actions.pod:1448
7451 #, no-wrap
7452 msgid ""
7453 " int\n"
7454 " guestfs_fallocate64 (guestfs_h *g,\n"
7455 "                      const char *path,\n"
7456 "                      int64_t len);\n"
7457 "\n"
7458 msgstr ""
7459
7460 #. type: textblock
7461 #: ../src/guestfs-actions.pod:1457
7462 msgid ""
7463 "Note that this call allocates disk blocks for the file.  To create a sparse "
7464 "file use C<guestfs_truncate_size> instead."
7465 msgstr ""
7466
7467 #. type: textblock
7468 #: ../src/guestfs-actions.pod:1460
7469 msgid ""
7470 "The deprecated call C<guestfs_fallocate> does the same, but owing to an "
7471 "oversight it only allowed 30 bit lengths to be specified, effectively "
7472 "limiting the maximum size of files created through that call to 1GB."
7473 msgstr ""
7474
7475 #. type: textblock
7476 #: ../src/guestfs-actions.pod:1465 ../fish/guestfish-actions.pod:974
7477 msgid ""
7478 "Do not confuse this with the guestfish-specific C<alloc> and C<sparse> "
7479 "commands which create a file in the host and attach it as a device."
7480 msgstr ""
7481
7482 #. type: textblock
7483 #: ../src/guestfs-actions.pod:1471
7484 msgid "(Added in 1.3.17)"
7485 msgstr ""
7486
7487 #. type: =head2
7488 #: ../src/guestfs-actions.pod:1473
7489 msgid "guestfs_fgrep"
7490 msgstr ""
7491
7492 #. type: verbatim
7493 #: ../src/guestfs-actions.pod:1475
7494 #, no-wrap
7495 msgid ""
7496 " char **\n"
7497 " guestfs_fgrep (guestfs_h *g,\n"
7498 "                const char *pattern,\n"
7499 "                const char *path);\n"
7500 "\n"
7501 msgstr ""
7502
7503 #. type: textblock
7504 #: ../src/guestfs-actions.pod:1480 ../fish/guestfish-actions.pod:982
7505 msgid "This calls the external C<fgrep> program and returns the matching lines."
7506 msgstr ""
7507
7508 #. type: =head2
7509 #: ../src/guestfs-actions.pod:1492
7510 msgid "guestfs_fgrepi"
7511 msgstr ""
7512
7513 #. type: verbatim
7514 #: ../src/guestfs-actions.pod:1494
7515 #, no-wrap
7516 msgid ""
7517 " char **\n"
7518 " guestfs_fgrepi (guestfs_h *g,\n"
7519 "                 const char *pattern,\n"
7520 "                 const char *path);\n"
7521 "\n"
7522 msgstr ""
7523
7524 #. type: textblock
7525 #: ../src/guestfs-actions.pod:1499 ../fish/guestfish-actions.pod:992
7526 msgid "This calls the external C<fgrep -i> program and returns the matching lines."
7527 msgstr ""
7528
7529 #. type: =head2
7530 #: ../src/guestfs-actions.pod:1511
7531 msgid "guestfs_file"
7532 msgstr ""
7533
7534 #. type: verbatim
7535 #: ../src/guestfs-actions.pod:1513
7536 #, no-wrap
7537 msgid ""
7538 " char *\n"
7539 " guestfs_file (guestfs_h *g,\n"
7540 "               const char *path);\n"
7541 "\n"
7542 msgstr ""
7543
7544 #. type: textblock
7545 #: ../src/guestfs-actions.pod:1517 ../fish/guestfish-actions.pod:1002
7546 msgid ""
7547 "This call uses the standard L<file(1)> command to determine the type or "
7548 "contents of the file."
7549 msgstr ""
7550
7551 #. type: textblock
7552 #: ../src/guestfs-actions.pod:1520 ../fish/guestfish-actions.pod:1005
7553 msgid ""
7554 "This call will also transparently look inside various types of compressed "
7555 "file."
7556 msgstr ""
7557
7558 #. type: textblock
7559 #: ../src/guestfs-actions.pod:1523 ../fish/guestfish-actions.pod:1008
7560 msgid ""
7561 "The exact command which runs is C<file -zb path>.  Note in particular that "
7562 "the filename is not prepended to the output (the C<-b> option)."
7563 msgstr ""
7564
7565 #. type: textblock
7566 #: ../src/guestfs-actions.pod:1527 ../fish/guestfish-actions.pod:1012
7567 msgid ""
7568 "The output depends on the output of the underlying L<file(1)> command and it "
7569 "can change in future in ways beyond our control.  In other words, the output "
7570 "is not guaranteed by the ABI."
7571 msgstr ""
7572
7573 #. type: textblock
7574 #: ../src/guestfs-actions.pod:1531
7575 msgid ""
7576 "See also: L<file(1)>, C<guestfs_vfs_type>, C<guestfs_lstat>, "
7577 "C<guestfs_is_file>, C<guestfs_is_blockdev> (etc)."
7578 msgstr ""
7579
7580 #. type: =head2
7581 #: ../src/guestfs-actions.pod:1539
7582 msgid "guestfs_file_architecture"
7583 msgstr ""
7584
7585 #. type: verbatim
7586 #: ../src/guestfs-actions.pod:1541
7587 #, no-wrap
7588 msgid ""
7589 " char *\n"
7590 " guestfs_file_architecture (guestfs_h *g,\n"
7591 "                            const char *filename);\n"
7592 "\n"
7593 msgstr ""
7594
7595 #. type: textblock
7596 #: ../src/guestfs-actions.pod:1545 ../fish/guestfish-actions.pod:1023
7597 msgid ""
7598 "This detects the architecture of the binary C<filename>, and returns it if "
7599 "known."
7600 msgstr ""
7601
7602 #. type: textblock
7603 #: ../src/guestfs-actions.pod:1548 ../fish/guestfish-actions.pod:1026
7604 msgid "Currently defined architectures are:"
7605 msgstr ""
7606
7607 #. type: =item
7608 #: ../src/guestfs-actions.pod:1552 ../fish/guestfish-actions.pod:1030
7609 msgid "\"i386\""
7610 msgstr ""
7611
7612 #. type: textblock
7613 #: ../src/guestfs-actions.pod:1554 ../fish/guestfish-actions.pod:1032
7614 msgid ""
7615 "This string is returned for all 32 bit i386, i486, i586, i686 binaries "
7616 "irrespective of the precise processor requirements of the binary."
7617 msgstr ""
7618
7619 #. type: =item
7620 #: ../src/guestfs-actions.pod:1557 ../fish/guestfish-actions.pod:1035
7621 msgid "\"x86_64\""
7622 msgstr ""
7623
7624 #. type: textblock
7625 #: ../src/guestfs-actions.pod:1559 ../fish/guestfish-actions.pod:1037
7626 msgid "64 bit x86-64."
7627 msgstr ""
7628
7629 #. type: =item
7630 #: ../src/guestfs-actions.pod:1561 ../fish/guestfish-actions.pod:1039
7631 msgid "\"sparc\""
7632 msgstr ""
7633
7634 #. type: textblock
7635 #: ../src/guestfs-actions.pod:1563 ../fish/guestfish-actions.pod:1041
7636 msgid "32 bit SPARC."
7637 msgstr ""
7638
7639 #. type: =item
7640 #: ../src/guestfs-actions.pod:1565 ../fish/guestfish-actions.pod:1043
7641 msgid "\"sparc64\""
7642 msgstr ""
7643
7644 #. type: textblock
7645 #: ../src/guestfs-actions.pod:1567 ../fish/guestfish-actions.pod:1045
7646 msgid "64 bit SPARC V9 and above."
7647 msgstr ""
7648
7649 #. type: =item
7650 #: ../src/guestfs-actions.pod:1569 ../fish/guestfish-actions.pod:1047
7651 msgid "\"ia64\""
7652 msgstr ""
7653
7654 #. type: textblock
7655 #: ../src/guestfs-actions.pod:1571 ../fish/guestfish-actions.pod:1049
7656 msgid "Intel Itanium."
7657 msgstr ""
7658
7659 #. type: =item
7660 #: ../src/guestfs-actions.pod:1573 ../fish/guestfish-actions.pod:1051
7661 msgid "\"ppc\""
7662 msgstr ""
7663
7664 #. type: textblock
7665 #: ../src/guestfs-actions.pod:1575 ../fish/guestfish-actions.pod:1053
7666 msgid "32 bit Power PC."
7667 msgstr ""
7668
7669 #. type: =item
7670 #: ../src/guestfs-actions.pod:1577 ../fish/guestfish-actions.pod:1055
7671 msgid "\"ppc64\""
7672 msgstr ""
7673
7674 #. type: textblock
7675 #: ../src/guestfs-actions.pod:1579 ../fish/guestfish-actions.pod:1057
7676 msgid "64 bit Power PC."
7677 msgstr ""
7678
7679 #. type: textblock
7680 #: ../src/guestfs-actions.pod:1583 ../fish/guestfish-actions.pod:1061
7681 msgid "Libguestfs may return other architecture strings in future."
7682 msgstr ""
7683
7684 #. type: textblock
7685 #: ../src/guestfs-actions.pod:1585 ../fish/guestfish-actions.pod:1063
7686 msgid "The function works on at least the following types of files:"
7687 msgstr ""
7688
7689 #. type: textblock
7690 #: ../src/guestfs-actions.pod:1591 ../fish/guestfish-actions.pod:1069
7691 msgid "many types of Un*x and Linux binary"
7692 msgstr ""
7693
7694 #. type: textblock
7695 #: ../src/guestfs-actions.pod:1595 ../fish/guestfish-actions.pod:1073
7696 msgid "many types of Un*x and Linux shared library"
7697 msgstr ""
7698
7699 #. type: textblock
7700 #: ../src/guestfs-actions.pod:1599 ../fish/guestfish-actions.pod:1077
7701 msgid "Windows Win32 and Win64 binaries"
7702 msgstr ""
7703
7704 #. type: textblock
7705 #: ../src/guestfs-actions.pod:1603 ../fish/guestfish-actions.pod:1081
7706 msgid "Windows Win32 and Win64 DLLs"
7707 msgstr ""
7708
7709 #. type: textblock
7710 #: ../src/guestfs-actions.pod:1605 ../fish/guestfish-actions.pod:1083
7711 msgid "Win32 binaries and DLLs return C<i386>."
7712 msgstr ""
7713
7714 #. type: textblock
7715 #: ../src/guestfs-actions.pod:1607 ../fish/guestfish-actions.pod:1085
7716 msgid "Win64 binaries and DLLs return C<x86_64>."
7717 msgstr ""
7718
7719 #. type: textblock
7720 #: ../src/guestfs-actions.pod:1611 ../fish/guestfish-actions.pod:1089
7721 msgid "Linux kernel modules"
7722 msgstr ""
7723
7724 #. type: textblock
7725 #: ../src/guestfs-actions.pod:1615 ../fish/guestfish-actions.pod:1093
7726 msgid "Linux new-style initrd images"
7727 msgstr ""
7728
7729 #. type: textblock
7730 #: ../src/guestfs-actions.pod:1619 ../fish/guestfish-actions.pod:1097
7731 msgid "some non-x86 Linux vmlinuz kernels"
7732 msgstr ""
7733
7734 #. type: textblock
7735 #: ../src/guestfs-actions.pod:1623 ../fish/guestfish-actions.pod:1101
7736 msgid "What it can't do currently:"
7737 msgstr ""
7738
7739 #. type: textblock
7740 #: ../src/guestfs-actions.pod:1629 ../fish/guestfish-actions.pod:1107
7741 msgid "static libraries (libfoo.a)"
7742 msgstr ""
7743
7744 #. type: textblock
7745 #: ../src/guestfs-actions.pod:1633 ../fish/guestfish-actions.pod:1111
7746 msgid "Linux old-style initrd as compressed ext2 filesystem (RHEL 3)"
7747 msgstr ""
7748
7749 #. type: textblock
7750 #: ../src/guestfs-actions.pod:1637 ../fish/guestfish-actions.pod:1115
7751 msgid "x86 Linux vmlinuz kernels"
7752 msgstr ""
7753
7754 #. type: textblock
7755 #: ../src/guestfs-actions.pod:1639 ../fish/guestfish-actions.pod:1117
7756 msgid ""
7757 "x86 vmlinuz images (bzImage format) consist of a mix of 16-, 32- and "
7758 "compressed code, and are horribly hard to unpack.  If you want to find the "
7759 "architecture of a kernel, use the architecture of the associated initrd or "
7760 "kernel module(s) instead."
7761 msgstr ""
7762
7763 #. type: textblock
7764 #: ../src/guestfs-actions.pod:1649 ../src/guestfs-actions.pod:1812 ../src/guestfs-actions.pod:1829 ../src/guestfs-actions.pod:2532 ../src/guestfs-actions.pod:2613 ../src/guestfs-actions.pod:2639 ../src/guestfs-actions.pod:2688 ../src/guestfs-actions.pod:2709 ../src/guestfs-actions.pod:2746 ../src/guestfs-actions.pod:2830 ../src/guestfs-actions.pod:2892 ../src/guestfs-actions.pod:3065 ../src/guestfs-actions.pod:3197
7765 msgid "(Added in 1.5.3)"
7766 msgstr ""
7767
7768 #. type: =head2
7769 #: ../src/guestfs-actions.pod:1651
7770 msgid "guestfs_filesize"
7771 msgstr ""
7772
7773 #. type: verbatim
7774 #: ../src/guestfs-actions.pod:1653
7775 #, no-wrap
7776 msgid ""
7777 " int64_t\n"
7778 " guestfs_filesize (guestfs_h *g,\n"
7779 "                   const char *file);\n"
7780 "\n"
7781 msgstr ""
7782
7783 #. type: textblock
7784 #: ../src/guestfs-actions.pod:1657 ../fish/guestfish-actions.pod:1128
7785 msgid "This command returns the size of C<file> in bytes."
7786 msgstr ""
7787
7788 #. type: textblock
7789 #: ../src/guestfs-actions.pod:1659
7790 msgid ""
7791 "To get other stats about a file, use C<guestfs_stat>, C<guestfs_lstat>, "
7792 "C<guestfs_is_dir>, C<guestfs_is_file> etc.  To get the size of block "
7793 "devices, use C<guestfs_blockdev_getsize64>."
7794 msgstr ""
7795
7796 #. type: textblock
7797 #: ../src/guestfs-actions.pod:1665
7798 msgid "(Added in 1.0.82)"
7799 msgstr ""
7800
7801 #. type: =head2
7802 #: ../src/guestfs-actions.pod:1667
7803 msgid "guestfs_fill"
7804 msgstr ""
7805
7806 #. type: verbatim
7807 #: ../src/guestfs-actions.pod:1669
7808 #, no-wrap
7809 msgid ""
7810 " int\n"
7811 " guestfs_fill (guestfs_h *g,\n"
7812 "               int c,\n"
7813 "               int len,\n"
7814 "               const char *path);\n"
7815 "\n"
7816 msgstr ""
7817
7818 #. type: textblock
7819 #: ../src/guestfs-actions.pod:1675 ../fish/guestfish-actions.pod:1138
7820 msgid ""
7821 "This command creates a new file called C<path>.  The initial content of the "
7822 "file is C<len> octets of C<c>, where C<c> must be a number in the range "
7823 "C<[0..255]>."
7824 msgstr ""
7825
7826 #. type: textblock
7827 #: ../src/guestfs-actions.pod:1679
7828 msgid ""
7829 "To fill a file with zero bytes (sparsely), it is much more efficient to use "
7830 "C<guestfs_truncate_size>.  To create a file with a pattern of repeating "
7831 "bytes use C<guestfs_fill_pattern>."
7832 msgstr ""
7833
7834 #. type: textblock
7835 #: ../src/guestfs-actions.pod:1691
7836 msgid "(Added in 1.0.79)"
7837 msgstr ""
7838
7839 #. type: =head2
7840 #: ../src/guestfs-actions.pod:1693
7841 msgid "guestfs_fill_pattern"
7842 msgstr ""
7843
7844 #. type: verbatim
7845 #: ../src/guestfs-actions.pod:1695
7846 #, no-wrap
7847 msgid ""
7848 " int\n"
7849 " guestfs_fill_pattern (guestfs_h *g,\n"
7850 "                       const char *pattern,\n"
7851 "                       int len,\n"
7852 "                       const char *path);\n"
7853 "\n"
7854 msgstr ""
7855
7856 #. type: textblock
7857 #: ../src/guestfs-actions.pod:1701
7858 msgid ""
7859 "This function is like C<guestfs_fill> except that it creates a new file of "
7860 "length C<len> containing the repeating pattern of bytes in C<pattern>.  The "
7861 "pattern is truncated if necessary to ensure the length of the file is "
7862 "exactly C<len> bytes."
7863 msgstr ""
7864
7865 #. type: textblock
7866 #: ../src/guestfs-actions.pod:1713
7867 msgid "(Added in 1.3.12)"
7868 msgstr ""
7869
7870 #. type: =head2
7871 #: ../src/guestfs-actions.pod:1715
7872 msgid "guestfs_find"
7873 msgstr ""
7874
7875 #. type: verbatim
7876 #: ../src/guestfs-actions.pod:1717
7877 #, no-wrap
7878 msgid ""
7879 " char **\n"
7880 " guestfs_find (guestfs_h *g,\n"
7881 "               const char *directory);\n"
7882 "\n"
7883 msgstr ""
7884
7885 #. type: textblock
7886 #: ../src/guestfs-actions.pod:1721 ../fish/guestfish-actions.pod:1160
7887 msgid ""
7888 "This command lists out all files and directories, recursively, starting at "
7889 "C<directory>.  It is essentially equivalent to running the shell command "
7890 "C<find directory -print> but some post-processing happens on the output, "
7891 "described below."
7892 msgstr ""
7893
7894 #. type: textblock
7895 #: ../src/guestfs-actions.pod:1726 ../fish/guestfish-actions.pod:1165
7896 msgid ""
7897 "This returns a list of strings I<without any prefix>.  Thus if the directory "
7898 "structure was:"
7899 msgstr ""
7900
7901 #. type: verbatim
7902 #: ../src/guestfs-actions.pod:1729 ../fish/guestfish-actions.pod:1168
7903 #, no-wrap
7904 msgid ""
7905 " /tmp/a\n"
7906 " /tmp/b\n"
7907 " /tmp/c/d\n"
7908 "\n"
7909 msgstr ""
7910
7911 #. type: textblock
7912 #: ../src/guestfs-actions.pod:1733
7913 msgid "then the returned list from C<guestfs_find> C</tmp> would be 4 elements:"
7914 msgstr ""
7915
7916 #. type: verbatim
7917 #: ../src/guestfs-actions.pod:1736 ../fish/guestfish-actions.pod:1175
7918 #, no-wrap
7919 msgid ""
7920 " a\n"
7921 " b\n"
7922 " c\n"
7923 " c/d\n"
7924 "\n"
7925 msgstr ""
7926
7927 #. type: textblock
7928 #: ../src/guestfs-actions.pod:1741 ../fish/guestfish-actions.pod:1180
7929 msgid "If C<directory> is not a directory, then this command returns an error."
7930 msgstr ""
7931
7932 #. type: textblock
7933 #: ../src/guestfs-actions.pod:1744 ../fish/guestfish-actions.pod:1183
7934 msgid "The returned list is sorted."
7935 msgstr ""
7936
7937 #. type: textblock
7938 #: ../src/guestfs-actions.pod:1746
7939 msgid "See also C<guestfs_find0>."
7940 msgstr ""
7941
7942 #. type: textblock
7943 #: ../src/guestfs-actions.pod:1755 ../src/guestfs-actions.pod:3886 ../src/guestfs-actions.pod:5426
7944 msgid "(Added in 1.0.27)"
7945 msgstr ""
7946
7947 #. type: =head2
7948 #: ../src/guestfs-actions.pod:1757
7949 msgid "guestfs_find0"
7950 msgstr ""
7951
7952 #. type: verbatim
7953 #: ../src/guestfs-actions.pod:1759
7954 #, no-wrap
7955 msgid ""
7956 " int\n"
7957 " guestfs_find0 (guestfs_h *g,\n"
7958 "                const char *directory,\n"
7959 "                const char *files);\n"
7960 "\n"
7961 msgstr ""
7962
7963 #. type: textblock
7964 #: ../src/guestfs-actions.pod:1764 ../fish/guestfish-actions.pod:1194
7965 msgid ""
7966 "This command lists out all files and directories, recursively, starting at "
7967 "C<directory>, placing the resulting list in the external file called "
7968 "C<files>."
7969 msgstr ""
7970
7971 #. type: textblock
7972 #: ../src/guestfs-actions.pod:1768
7973 msgid ""
7974 "This command works the same way as C<guestfs_find> with the following "
7975 "exceptions:"
7976 msgstr ""
7977
7978 #. type: textblock
7979 #: ../src/guestfs-actions.pod:1775 ../fish/guestfish-actions.pod:1205
7980 msgid "The resulting list is written to an external file."
7981 msgstr ""
7982
7983 #. type: textblock
7984 #: ../src/guestfs-actions.pod:1779 ../fish/guestfish-actions.pod:1209
7985 msgid ""
7986 "Items (filenames) in the result are separated by C<\\0> characters.  See "
7987 "L<find(1)> option I<-print0>."
7988 msgstr ""
7989
7990 #. type: textblock
7991 #: ../src/guestfs-actions.pod:1784 ../fish/guestfish-actions.pod:1214
7992 msgid "This command is not limited in the number of names that it can return."
7993 msgstr ""
7994
7995 #. type: textblock
7996 #: ../src/guestfs-actions.pod:1789 ../fish/guestfish-actions.pod:1219
7997 msgid "The result list is not sorted."
7998 msgstr ""
7999
8000 #. type: textblock
8001 #: ../src/guestfs-actions.pod:1795
8002 msgid "(Added in 1.0.74)"
8003 msgstr ""
8004
8005 #. type: =head2
8006 #: ../src/guestfs-actions.pod:1797
8007 msgid "guestfs_findfs_label"
8008 msgstr ""
8009
8010 #. type: verbatim
8011 #: ../src/guestfs-actions.pod:1799
8012 #, no-wrap
8013 msgid ""
8014 " char *\n"
8015 " guestfs_findfs_label (guestfs_h *g,\n"
8016 "                       const char *label);\n"
8017 "\n"
8018 msgstr ""
8019
8020 #. type: textblock
8021 #: ../src/guestfs-actions.pod:1803 ../fish/guestfish-actions.pod:1229
8022 msgid ""
8023 "This command searches the filesystems and returns the one which has the "
8024 "given label.  An error is returned if no such filesystem can be found."
8025 msgstr ""
8026
8027 #. type: textblock
8028 #: ../src/guestfs-actions.pod:1807
8029 msgid "To find the label of a filesystem, use C<guestfs_vfs_label>."
8030 msgstr ""
8031
8032 #. type: =head2
8033 #: ../src/guestfs-actions.pod:1814
8034 msgid "guestfs_findfs_uuid"
8035 msgstr ""
8036
8037 #. type: verbatim
8038 #: ../src/guestfs-actions.pod:1816
8039 #, no-wrap
8040 msgid ""
8041 " char *\n"
8042 " guestfs_findfs_uuid (guestfs_h *g,\n"
8043 "                      const char *uuid);\n"
8044 "\n"
8045 msgstr ""
8046
8047 #. type: textblock
8048 #: ../src/guestfs-actions.pod:1820 ../fish/guestfish-actions.pod:1239
8049 msgid ""
8050 "This command searches the filesystems and returns the one which has the "
8051 "given UUID.  An error is returned if no such filesystem can be found."
8052 msgstr ""
8053
8054 #. type: textblock
8055 #: ../src/guestfs-actions.pod:1824
8056 msgid "To find the UUID of a filesystem, use C<guestfs_vfs_uuid>."
8057 msgstr ""
8058
8059 #. type: =head2
8060 #: ../src/guestfs-actions.pod:1831
8061 msgid "guestfs_fsck"
8062 msgstr ""
8063
8064 #. type: verbatim
8065 #: ../src/guestfs-actions.pod:1833
8066 #, no-wrap
8067 msgid ""
8068 " int\n"
8069 " guestfs_fsck (guestfs_h *g,\n"
8070 "               const char *fstype,\n"
8071 "               const char *device);\n"
8072 "\n"
8073 msgstr ""
8074
8075 #. type: textblock
8076 #: ../src/guestfs-actions.pod:1838 ../fish/guestfish-actions.pod:1249
8077 msgid ""
8078 "This runs the filesystem checker (fsck) on C<device> which should have "
8079 "filesystem type C<fstype>."
8080 msgstr ""
8081
8082 #. type: textblock
8083 #: ../src/guestfs-actions.pod:1841 ../fish/guestfish-actions.pod:1252
8084 msgid ""
8085 "The returned integer is the status.  See L<fsck(8)> for the list of status "
8086 "codes from C<fsck>."
8087 msgstr ""
8088
8089 #. type: textblock
8090 #: ../src/guestfs-actions.pod:1850 ../fish/guestfish-actions.pod:1261
8091 msgid "Multiple status codes can be summed together."
8092 msgstr ""
8093
8094 #. type: textblock
8095 #: ../src/guestfs-actions.pod:1854 ../fish/guestfish-actions.pod:1265
8096 msgid ""
8097 "A non-zero return code can mean \"success\", for example if errors have been "
8098 "corrected on the filesystem."
8099 msgstr ""
8100
8101 #. type: textblock
8102 #: ../src/guestfs-actions.pod:1859 ../fish/guestfish-actions.pod:1270
8103 msgid "Checking or repairing NTFS volumes is not supported (by linux-ntfs)."
8104 msgstr ""
8105
8106 #. type: textblock
8107 #: ../src/guestfs-actions.pod:1864 ../fish/guestfish-actions.pod:1275
8108 msgid "This command is entirely equivalent to running C<fsck -a -t fstype device>."
8109 msgstr ""
8110
8111 #. type: textblock
8112 #: ../src/guestfs-actions.pod:1868 ../src/guestfs-actions.pod:7073
8113 msgid "(Added in 1.0.16)"
8114 msgstr ""
8115
8116 #. type: =head2
8117 #: ../src/guestfs-actions.pod:1870
8118 msgid "guestfs_get_append"
8119 msgstr ""
8120
8121 #. type: verbatim
8122 #: ../src/guestfs-actions.pod:1872
8123 #, no-wrap
8124 msgid ""
8125 " const char *\n"
8126 " guestfs_get_append (guestfs_h *g);\n"
8127 "\n"
8128 msgstr ""
8129
8130 #. type: textblock
8131 #: ../src/guestfs-actions.pod:1875 ../fish/guestfish-actions.pod:1281
8132 msgid ""
8133 "Return the additional kernel options which are added to the guest kernel "
8134 "command line."
8135 msgstr ""
8136
8137 #. type: textblock
8138 #: ../src/guestfs-actions.pod:1878 ../fish/guestfish-actions.pod:1284
8139 msgid "If C<NULL> then no options are added."
8140 msgstr ""
8141
8142 #. type: textblock
8143 #: ../src/guestfs-actions.pod:1880
8144 msgid ""
8145 "This function returns a string which may be NULL.  There is no way to return "
8146 "an error from this function.  The string is owned by the guest handle and "
8147 "must I<not> be freed."
8148 msgstr ""
8149
8150 #. type: textblock
8151 #: ../src/guestfs-actions.pod:1884 ../src/guestfs-actions.pod:5104 ../src/guestfs-actions.pod:5567 ../src/guestfs-actions.pod:5935 ../src/guestfs-actions.pod:5954 ../src/guestfs-actions.pod:5970 ../src/guestfs-actions.pod:5987 ../src/guestfs-actions.pod:6744 ../src/guestfs-actions.pod:6762 ../src/guestfs-actions.pod:7116
8152 msgid "(Added in 1.0.26)"
8153 msgstr ""
8154
8155 #. type: =head2
8156 #: ../src/guestfs-actions.pod:1886
8157 msgid "guestfs_get_autosync"
8158 msgstr ""
8159
8160 #. type: verbatim
8161 #: ../src/guestfs-actions.pod:1888
8162 #, no-wrap
8163 msgid ""
8164 " int\n"
8165 " guestfs_get_autosync (guestfs_h *g);\n"
8166 "\n"
8167 msgstr ""
8168
8169 #. type: textblock
8170 #: ../src/guestfs-actions.pod:1891 ../fish/guestfish-actions.pod:1290
8171 msgid "Get the autosync flag."
8172 msgstr ""
8173
8174 #. type: =head2
8175 #: ../src/guestfs-actions.pod:1897
8176 msgid "guestfs_get_direct"
8177 msgstr ""
8178
8179 #. type: verbatim
8180 #: ../src/guestfs-actions.pod:1899
8181 #, no-wrap
8182 msgid ""
8183 " int\n"
8184 " guestfs_get_direct (guestfs_h *g);\n"
8185 "\n"
8186 msgstr ""
8187
8188 #. type: textblock
8189 #: ../src/guestfs-actions.pod:1902 ../fish/guestfish-actions.pod:1296
8190 msgid "Return the direct appliance mode flag."
8191 msgstr ""
8192
8193 #. type: textblock
8194 #: ../src/guestfs-actions.pod:1906 ../src/guestfs-actions.pod:5608
8195 msgid "(Added in 1.0.72)"
8196 msgstr ""
8197
8198 #. type: =head2
8199 #: ../src/guestfs-actions.pod:1908
8200 msgid "guestfs_get_e2label"
8201 msgstr ""
8202
8203 #. type: verbatim
8204 #: ../src/guestfs-actions.pod:1910
8205 #, no-wrap
8206 msgid ""
8207 " char *\n"
8208 " guestfs_get_e2label (guestfs_h *g,\n"
8209 "                      const char *device);\n"
8210 "\n"
8211 msgstr ""
8212
8213 #. type: textblock
8214 #: ../src/guestfs-actions.pod:1914 ../fish/guestfish-actions.pod:1302
8215 msgid "This returns the ext2/3/4 filesystem label of the filesystem on C<device>."
8216 msgstr ""
8217
8218 #. type: textblock
8219 #: ../src/guestfs-actions.pod:1920
8220 msgid ""
8221 "This function is deprecated.  In new code, use the L</guestfs_vfs_label> "
8222 "call instead."
8223 msgstr ""
8224
8225 #. type: textblock
8226 #: ../src/guestfs-actions.pod:1927 ../src/guestfs-actions.pod:1948 ../src/guestfs-actions.pod:5626 ../src/guestfs-actions.pod:5645
8227 msgid "(Added in 1.0.15)"
8228 msgstr ""
8229
8230 #. type: =head2
8231 #: ../src/guestfs-actions.pod:1929
8232 msgid "guestfs_get_e2uuid"
8233 msgstr ""
8234
8235 #. type: verbatim
8236 #: ../src/guestfs-actions.pod:1931
8237 #, no-wrap
8238 msgid ""
8239 " char *\n"
8240 " guestfs_get_e2uuid (guestfs_h *g,\n"
8241 "                     const char *device);\n"
8242 "\n"
8243 msgstr ""
8244
8245 #. type: textblock
8246 #: ../src/guestfs-actions.pod:1935 ../fish/guestfish-actions.pod:1316
8247 msgid "This returns the ext2/3/4 filesystem UUID of the filesystem on C<device>."
8248 msgstr ""
8249
8250 #. type: textblock
8251 #: ../src/guestfs-actions.pod:1941
8252 msgid ""
8253 "This function is deprecated.  In new code, use the L</guestfs_vfs_uuid> call "
8254 "instead."
8255 msgstr ""
8256
8257 #. type: =head2
8258 #: ../src/guestfs-actions.pod:1950
8259 msgid "guestfs_get_memsize"
8260 msgstr ""
8261
8262 #. type: verbatim
8263 #: ../src/guestfs-actions.pod:1952
8264 #, no-wrap
8265 msgid ""
8266 " int\n"
8267 " guestfs_get_memsize (guestfs_h *g);\n"
8268 "\n"
8269 msgstr ""
8270
8271 #. type: textblock
8272 #: ../src/guestfs-actions.pod:1955 ../fish/guestfish-actions.pod:1330
8273 msgid "This gets the memory size in megabytes allocated to the qemu subprocess."
8274 msgstr ""
8275
8276 #. type: textblock
8277 #: ../src/guestfs-actions.pod:1958
8278 msgid ""
8279 "If C<guestfs_set_memsize> was not called on this handle, and if "
8280 "C<LIBGUESTFS_MEMSIZE> was not set, then this returns the compiled-in default "
8281 "value for memsize."
8282 msgstr ""
8283
8284 #. type: textblock
8285 #: ../src/guestfs-actions.pod:1962 ../src/guestfs-actions.pod:2043 ../src/guestfs-actions.pod:5661 ../src/guestfs-actions.pod:5768 ../fish/guestfish-actions.pod:1337 ../fish/guestfish-actions.pod:1388 ../fish/guestfish-actions.pod:3788 ../fish/guestfish-actions.pod:3875
8286 msgid "For more information on the architecture of libguestfs, see L<guestfs(3)>."
8287 msgstr ""
8288
8289 #. type: textblock
8290 #: ../src/guestfs-actions.pod:1967 ../src/guestfs-actions.pod:4177 ../src/guestfs-actions.pod:4362 ../src/guestfs-actions.pod:4381 ../src/guestfs-actions.pod:4400 ../src/guestfs-actions.pod:4412 ../src/guestfs-actions.pod:4429 ../src/guestfs-actions.pod:4442 ../src/guestfs-actions.pod:5329 ../src/guestfs-actions.pod:5666 ../src/guestfs-actions.pod:5909 ../src/guestfs-actions.pod:6510
8291 msgid "(Added in 1.0.55)"
8292 msgstr ""
8293
8294 #. type: =head2
8295 #: ../src/guestfs-actions.pod:1969
8296 msgid "guestfs_get_network"
8297 msgstr ""
8298
8299 #. type: verbatim
8300 #: ../src/guestfs-actions.pod:1971
8301 #, no-wrap
8302 msgid ""
8303 " int\n"
8304 " guestfs_get_network (guestfs_h *g);\n"
8305 "\n"
8306 msgstr ""
8307
8308 #. type: textblock
8309 #: ../src/guestfs-actions.pod:1974 ../fish/guestfish-actions.pod:1344
8310 msgid "This returns the enable network flag."
8311 msgstr ""
8312
8313 #. type: textblock
8314 #: ../src/guestfs-actions.pod:1978 ../src/guestfs-actions.pod:5685
8315 msgid "(Added in 1.5.4)"
8316 msgstr ""
8317
8318 #. type: =head2
8319 #: ../src/guestfs-actions.pod:1980
8320 msgid "guestfs_get_path"
8321 msgstr ""
8322
8323 #. type: verbatim
8324 #: ../src/guestfs-actions.pod:1982
8325 #, no-wrap
8326 msgid ""
8327 " const char *\n"
8328 " guestfs_get_path (guestfs_h *g);\n"
8329 "\n"
8330 msgstr ""
8331
8332 #. type: textblock
8333 #: ../src/guestfs-actions.pod:1985 ../fish/guestfish-actions.pod:1350
8334 msgid "Return the current search path."
8335 msgstr ""
8336
8337 #. type: textblock
8338 #: ../src/guestfs-actions.pod:1987 ../fish/guestfish-actions.pod:1352
8339 msgid ""
8340 "This is always non-NULL.  If it wasn't set already, then this will return "
8341 "the default path."
8342 msgstr ""
8343
8344 #. type: textblock
8345 #: ../src/guestfs-actions.pod:1990 ../src/guestfs-actions.pod:2019
8346 msgid ""
8347 "This function returns a string, or NULL on error.  The string is owned by "
8348 "the guest handle and must I<not> be freed."
8349 msgstr ""
8350
8351 #. type: =head2
8352 #: ../src/guestfs-actions.pod:1995
8353 msgid "guestfs_get_pid"
8354 msgstr ""
8355
8356 #. type: verbatim
8357 #: ../src/guestfs-actions.pod:1997
8358 #, no-wrap
8359 msgid ""
8360 " int\n"
8361 " guestfs_get_pid (guestfs_h *g);\n"
8362 "\n"
8363 msgstr ""
8364
8365 #. type: textblock
8366 #: ../src/guestfs-actions.pod:2000 ../fish/guestfish-actions.pod:1361
8367 msgid ""
8368 "Return the process ID of the qemu subprocess.  If there is no qemu "
8369 "subprocess, then this will return an error."
8370 msgstr ""
8371
8372 #. type: textblock
8373 #: ../src/guestfs-actions.pod:2003 ../fish/guestfish-actions.pod:1364
8374 msgid "This is an internal call used for debugging and testing."
8375 msgstr ""
8376
8377 #. type: textblock
8378 #: ../src/guestfs-actions.pod:2007
8379 msgid "(Added in 1.0.56)"
8380 msgstr ""
8381
8382 #. type: =head2
8383 #: ../src/guestfs-actions.pod:2009
8384 msgid "guestfs_get_qemu"
8385 msgstr ""
8386
8387 #. type: verbatim
8388 #: ../src/guestfs-actions.pod:2011
8389 #, no-wrap
8390 msgid ""
8391 " const char *\n"
8392 " guestfs_get_qemu (guestfs_h *g);\n"
8393 "\n"
8394 msgstr ""
8395
8396 #. type: textblock
8397 #: ../src/guestfs-actions.pod:2014 ../fish/guestfish-actions.pod:1370
8398 msgid "Return the current qemu binary."
8399 msgstr ""
8400
8401 #. type: textblock
8402 #: ../src/guestfs-actions.pod:2016 ../fish/guestfish-actions.pod:1372
8403 msgid ""
8404 "This is always non-NULL.  If it wasn't set already, then this will return "
8405 "the default qemu binary name."
8406 msgstr ""
8407
8408 #. type: textblock
8409 #: ../src/guestfs-actions.pod:2022 ../src/guestfs-actions.pod:5730
8410 msgid "(Added in 1.0.6)"
8411 msgstr ""
8412
8413 #. type: =head2
8414 #: ../src/guestfs-actions.pod:2024
8415 msgid "guestfs_get_recovery_proc"
8416 msgstr ""
8417
8418 #. type: verbatim
8419 #: ../src/guestfs-actions.pod:2026
8420 #, no-wrap
8421 msgid ""
8422 " int\n"
8423 " guestfs_get_recovery_proc (guestfs_h *g);\n"
8424 "\n"
8425 msgstr ""
8426
8427 #. type: textblock
8428 #: ../src/guestfs-actions.pod:2029 ../fish/guestfish-actions.pod:1379
8429 msgid "Return the recovery process enabled flag."
8430 msgstr ""
8431
8432 #. type: textblock
8433 #: ../src/guestfs-actions.pod:2033 ../src/guestfs-actions.pod:3287 ../src/guestfs-actions.pod:3584 ../src/guestfs-actions.pod:3984 ../src/guestfs-actions.pod:4016 ../src/guestfs-actions.pod:5034 ../src/guestfs-actions.pod:5377 ../src/guestfs-actions.pod:5754 ../src/guestfs-actions.pod:6413 ../src/guestfs-actions.pod:6433 ../src/guestfs-actions.pod:6625
8434 msgid "(Added in 1.0.77)"
8435 msgstr ""
8436
8437 #. type: =head2
8438 #: ../src/guestfs-actions.pod:2035
8439 msgid "guestfs_get_selinux"
8440 msgstr ""
8441
8442 #. type: verbatim
8443 #: ../src/guestfs-actions.pod:2037
8444 #, no-wrap
8445 msgid ""
8446 " int\n"
8447 " guestfs_get_selinux (guestfs_h *g);\n"
8448 "\n"
8449 msgstr ""
8450
8451 #. type: textblock
8452 #: ../src/guestfs-actions.pod:2040
8453 msgid ""
8454 "This returns the current setting of the selinux flag which is passed to the "
8455 "appliance at boot time.  See C<guestfs_set_selinux>."
8456 msgstr ""
8457
8458 #. type: textblock
8459 #: ../src/guestfs-actions.pod:2048 ../src/guestfs-actions.pod:2111 ../src/guestfs-actions.pod:5773 ../src/guestfs-actions.pod:5827
8460 msgid "(Added in 1.0.67)"
8461 msgstr ""
8462
8463 #. type: =head2
8464 #: ../src/guestfs-actions.pod:2050
8465 msgid "guestfs_get_state"
8466 msgstr ""
8467
8468 #. type: verbatim
8469 #: ../src/guestfs-actions.pod:2052
8470 #, no-wrap
8471 msgid ""
8472 " int\n"
8473 " guestfs_get_state (guestfs_h *g);\n"
8474 "\n"
8475 msgstr ""
8476
8477 #. type: textblock
8478 #: ../src/guestfs-actions.pod:2055 ../fish/guestfish-actions.pod:1395
8479 msgid ""
8480 "This returns the current state as an opaque integer.  This is only useful "
8481 "for printing debug and internal error messages."
8482 msgstr ""
8483
8484 #. type: textblock
8485 #: ../src/guestfs-actions.pod:2058 ../src/guestfs-actions.pod:3090 ../src/guestfs-actions.pod:3119 ../src/guestfs-actions.pod:3180 ../src/guestfs-actions.pod:3207 ../fish/guestfish-actions.pod:1398 ../fish/guestfish-actions.pod:2159 ../fish/guestfish-actions.pod:2177 ../fish/guestfish-actions.pod:2215 ../fish/guestfish-actions.pod:2231
8486 msgid "For more information on states, see L<guestfs(3)>."
8487 msgstr ""
8488
8489 #. type: =head2
8490 #: ../src/guestfs-actions.pod:2064
8491 msgid "guestfs_get_trace"
8492 msgstr ""
8493
8494 #. type: verbatim
8495 #: ../src/guestfs-actions.pod:2066
8496 #, no-wrap
8497 msgid ""
8498 " int\n"
8499 " guestfs_get_trace (guestfs_h *g);\n"
8500 "\n"
8501 msgstr ""
8502
8503 #. type: textblock
8504 #: ../src/guestfs-actions.pod:2069 ../fish/guestfish-actions.pod:1404
8505 msgid "Return the command trace flag."
8506 msgstr ""
8507
8508 #. type: =head2
8509 #: ../src/guestfs-actions.pod:2075
8510 msgid "guestfs_get_umask"
8511 msgstr ""
8512
8513 #. type: verbatim
8514 #: ../src/guestfs-actions.pod:2077
8515 #, no-wrap
8516 msgid ""
8517 " int\n"
8518 " guestfs_get_umask (guestfs_h *g);\n"
8519 "\n"
8520 msgstr ""
8521
8522 #. type: textblock
8523 #: ../src/guestfs-actions.pod:2080
8524 msgid ""
8525 "Return the current umask.  By default the umask is C<022> unless it has been "
8526 "set by calling C<guestfs_umask>."
8527 msgstr ""
8528
8529 #. type: =head2
8530 #: ../src/guestfs-actions.pod:2087
8531 msgid "guestfs_get_verbose"
8532 msgstr ""
8533
8534 #. type: verbatim
8535 #: ../src/guestfs-actions.pod:2089
8536 #, no-wrap
8537 msgid ""
8538 " int\n"
8539 " guestfs_get_verbose (guestfs_h *g);\n"
8540 "\n"
8541 msgstr ""
8542
8543 #. type: textblock
8544 #: ../src/guestfs-actions.pod:2092 ../fish/guestfish-actions.pod:1417
8545 msgid "This returns the verbose messages flag."
8546 msgstr ""
8547
8548 #. type: =head2
8549 #: ../src/guestfs-actions.pod:2098
8550 msgid "guestfs_getcon"
8551 msgstr ""
8552
8553 #. type: verbatim
8554 #: ../src/guestfs-actions.pod:2100
8555 #, no-wrap
8556 msgid ""
8557 " char *\n"
8558 " guestfs_getcon (guestfs_h *g);\n"
8559 "\n"
8560 msgstr ""
8561
8562 #. type: textblock
8563 #: ../src/guestfs-actions.pod:2103 ../fish/guestfish-actions.pod:1423
8564 msgid "This gets the SELinux security context of the daemon."
8565 msgstr ""
8566
8567 #. type: textblock
8568 #: ../src/guestfs-actions.pod:2105
8569 msgid "See the documentation about SELINUX in L<guestfs(3)>, and C<guestfs_setcon>"
8570 msgstr ""
8571
8572 #. type: =head2
8573 #: ../src/guestfs-actions.pod:2113
8574 msgid "guestfs_getxattr"
8575 msgstr ""
8576
8577 #. type: verbatim
8578 #: ../src/guestfs-actions.pod:2115
8579 #, no-wrap
8580 msgid ""
8581 " char *\n"
8582 " guestfs_getxattr (guestfs_h *g,\n"
8583 "                   const char *path,\n"
8584 "                   const char *name,\n"
8585 "                   size_t *size_r);\n"
8586 "\n"
8587 msgstr ""
8588
8589 #. type: textblock
8590 #: ../src/guestfs-actions.pod:2121
8591 msgid ""
8592 "Get a single extended attribute from file C<path> named C<name>.  This call "
8593 "follows symlinks.  If you want to lookup an extended attribute for the "
8594 "symlink itself, use C<guestfs_lgetxattr>."
8595 msgstr ""
8596
8597 #. type: textblock
8598 #: ../src/guestfs-actions.pod:2125 ../src/guestfs-actions.pod:3301
8599 msgid ""
8600 "Normally it is better to get all extended attributes from a file in one go "
8601 "by calling C<guestfs_getxattrs>.  However some Linux filesystem "
8602 "implementations are buggy and do not provide a way to list out attributes.  "
8603 "For these filesystems (notably ntfs-3g)  you have to know the names of the "
8604 "extended attributes you want in advance and call this function."
8605 msgstr ""
8606
8607 #. type: textblock
8608 #: ../src/guestfs-actions.pod:2132 ../src/guestfs-actions.pod:3308 ../fish/guestfish-actions.pod:1443 ../fish/guestfish-actions.pod:2296
8609 msgid ""
8610 "Extended attribute values are blobs of binary data.  If there is no extended "
8611 "attribute named C<name>, this returns an error."
8612 msgstr ""
8613
8614 #. type: textblock
8615 #: ../src/guestfs-actions.pod:2135
8616 msgid "See also: C<guestfs_getxattrs>, C<guestfs_lgetxattr>, L<attr(5)>."
8617 msgstr ""
8618
8619 #. type: textblock
8620 #: ../src/guestfs-actions.pod:2137 ../src/guestfs-actions.pod:2350 ../src/guestfs-actions.pod:3313 ../src/guestfs-actions.pod:5027 ../src/guestfs-actions.pod:5053 ../src/guestfs-actions.pod:5234
8621 msgid ""
8622 "This function returns a buffer, or NULL on error.  The size of the returned "
8623 "buffer is written to C<*size_r>.  I<The caller must free the returned buffer "
8624 "after use>."
8625 msgstr ""
8626
8627 #. type: textblock
8628 #: ../src/guestfs-actions.pod:2141 ../src/guestfs-actions.pod:3317
8629 msgid "(Added in 1.7.24)"
8630 msgstr ""
8631
8632 #. type: =head2
8633 #: ../src/guestfs-actions.pod:2143
8634 msgid "guestfs_getxattrs"
8635 msgstr ""
8636
8637 #. type: verbatim
8638 #: ../src/guestfs-actions.pod:2145
8639 #, no-wrap
8640 msgid ""
8641 " struct guestfs_xattr_list *\n"
8642 " guestfs_getxattrs (guestfs_h *g,\n"
8643 "                    const char *path);\n"
8644 "\n"
8645 msgstr ""
8646
8647 #. type: textblock
8648 #: ../src/guestfs-actions.pod:2149 ../fish/guestfish-actions.pod:1452
8649 msgid "This call lists the extended attributes of the file or directory C<path>."
8650 msgstr ""
8651
8652 #. type: textblock
8653 #: ../src/guestfs-actions.pod:2152 ../fish/guestfish-actions.pod:1455
8654 msgid ""
8655 "At the system call level, this is a combination of the L<listxattr(2)> and "
8656 "L<getxattr(2)> calls."
8657 msgstr ""
8658
8659 #. type: textblock
8660 #: ../src/guestfs-actions.pod:2155
8661 msgid "See also: C<guestfs_lgetxattrs>, L<attr(5)>."
8662 msgstr ""
8663
8664 #. type: textblock
8665 #: ../src/guestfs-actions.pod:2157 ../src/guestfs-actions.pod:3329 ../src/guestfs-actions.pod:3980
8666 msgid ""
8667 "This function returns a C<struct guestfs_xattr_list *>, or NULL if there was "
8668 "an error.  I<The caller must call C<guestfs_free_xattr_list> after use>."
8669 msgstr ""
8670
8671 #. type: textblock
8672 #: ../src/guestfs-actions.pod:2161 ../src/guestfs-actions.pod:3333 ../src/guestfs-actions.pod:3498 ../src/guestfs-actions.pod:3534 ../src/guestfs-actions.pod:5407 ../src/guestfs-actions.pod:5846 ../src/guestfs-actions.pod:7181
8673 msgid "(Added in 1.0.59)"
8674 msgstr ""
8675
8676 #. type: =head2
8677 #: ../src/guestfs-actions.pod:2163
8678 msgid "guestfs_glob_expand"
8679 msgstr ""
8680
8681 #. type: verbatim
8682 #: ../src/guestfs-actions.pod:2165
8683 #, no-wrap
8684 msgid ""
8685 " char **\n"
8686 " guestfs_glob_expand (guestfs_h *g,\n"
8687 "                      const char *pattern);\n"
8688 "\n"
8689 msgstr ""
8690
8691 #. type: textblock
8692 #: ../src/guestfs-actions.pod:2169 ../fish/guestfish-actions.pod:1464
8693 msgid ""
8694 "This command searches for all the pathnames matching C<pattern> according to "
8695 "the wildcard expansion rules used by the shell."
8696 msgstr ""
8697
8698 #. type: textblock
8699 #: ../src/guestfs-actions.pod:2173 ../fish/guestfish-actions.pod:1468
8700 msgid "If no paths match, then this returns an empty list (note: not an error)."
8701 msgstr ""
8702
8703 #. type: textblock
8704 #: ../src/guestfs-actions.pod:2176 ../fish/guestfish-actions.pod:1471
8705 msgid ""
8706 "It is just a wrapper around the C L<glob(3)> function with flags "
8707 "C<GLOB_MARK|GLOB_BRACE>.  See that manual page for more details."
8708 msgstr ""
8709
8710 #. type: textblock
8711 #: ../src/guestfs-actions.pod:2184 ../src/guestfs-actions.pod:6011 ../src/guestfs-actions.pod:6028
8712 msgid "(Added in 1.0.50)"
8713 msgstr ""
8714
8715 #. type: =head2
8716 #: ../src/guestfs-actions.pod:2186
8717 msgid "guestfs_grep"
8718 msgstr ""
8719
8720 #. type: verbatim
8721 #: ../src/guestfs-actions.pod:2188
8722 #, no-wrap
8723 msgid ""
8724 " char **\n"
8725 " guestfs_grep (guestfs_h *g,\n"
8726 "               const char *regex,\n"
8727 "               const char *path);\n"
8728 "\n"
8729 msgstr ""
8730
8731 #. type: textblock
8732 #: ../src/guestfs-actions.pod:2193 ../fish/guestfish-actions.pod:1479
8733 msgid "This calls the external C<grep> program and returns the matching lines."
8734 msgstr ""
8735
8736 #. type: =head2
8737 #: ../src/guestfs-actions.pod:2205
8738 msgid "guestfs_grepi"
8739 msgstr ""
8740
8741 #. type: verbatim
8742 #: ../src/guestfs-actions.pod:2207
8743 #, no-wrap
8744 msgid ""
8745 " char **\n"
8746 " guestfs_grepi (guestfs_h *g,\n"
8747 "                const char *regex,\n"
8748 "                const char *path);\n"
8749 "\n"
8750 msgstr ""
8751
8752 #. type: textblock
8753 #: ../src/guestfs-actions.pod:2212 ../fish/guestfish-actions.pod:1489
8754 msgid "This calls the external C<grep -i> program and returns the matching lines."
8755 msgstr ""
8756
8757 #. type: =head2
8758 #: ../src/guestfs-actions.pod:2224
8759 msgid "guestfs_grub_install"
8760 msgstr ""
8761
8762 #. type: verbatim
8763 #: ../src/guestfs-actions.pod:2226
8764 #, no-wrap
8765 msgid ""
8766 " int\n"
8767 " guestfs_grub_install (guestfs_h *g,\n"
8768 "                       const char *root,\n"
8769 "                       const char *device);\n"
8770 "\n"
8771 msgstr ""
8772
8773 #. type: textblock
8774 #: ../src/guestfs-actions.pod:2231 ../fish/guestfish-actions.pod:1499
8775 msgid ""
8776 "This command installs GRUB 1 (the Grand Unified Bootloader) on C<device>, "
8777 "with the root directory being C<root>."
8778 msgstr ""
8779
8780 #. type: textblock
8781 #: ../src/guestfs-actions.pod:2240 ../fish/guestfish-actions.pod:1508
8782 msgid ""
8783 "There is currently no way in the API to install grub2, which is used by most "
8784 "modern Linux guests.  It is possible to run the grub2 command from the "
8785 "guest, although see the caveats in L<guestfs(3)/RUNNING COMMANDS>."
8786 msgstr ""
8787
8788 #. type: textblock
8789 #: ../src/guestfs-actions.pod:2247 ../fish/guestfish-actions.pod:1515
8790 msgid ""
8791 "This uses C<grub-install> from the host.  Unfortunately grub is not always "
8792 "compatible with itself, so this only works in rather narrow circumstances.  "
8793 "Careful testing with each guest version is advisable."
8794 msgstr ""
8795
8796 #. type: textblock
8797 #: ../src/guestfs-actions.pod:2254 ../fish/guestfish-actions.pod:1522
8798 msgid ""
8799 "If grub-install reports the error \"No suitable drive was found in the "
8800 "generated device map.\" it may be that you need to create a "
8801 "C</boot/grub/device.map> file first that contains the mapping between grub "
8802 "device names and Linux device names.  It is usually sufficient to create a "
8803 "file containing:"
8804 msgstr ""
8805
8806 #. type: verbatim
8807 #: ../src/guestfs-actions.pod:2261 ../fish/guestfish-actions.pod:1529
8808 #, no-wrap
8809 msgid ""
8810 " (hd0) /dev/vda\n"
8811 "\n"
8812 msgstr ""
8813
8814 #. type: textblock
8815 #: ../src/guestfs-actions.pod:2263 ../fish/guestfish-actions.pod:1531
8816 msgid "replacing C</dev/vda> with the name of the installation device."
8817 msgstr ""
8818
8819 #. type: textblock
8820 #: ../src/guestfs-actions.pod:2269
8821 msgid "(Added in 1.0.17)"
8822 msgstr ""
8823
8824 #. type: =head2
8825 #: ../src/guestfs-actions.pod:2271
8826 msgid "guestfs_head"
8827 msgstr ""
8828
8829 #. type: verbatim
8830 #: ../src/guestfs-actions.pod:2273
8831 #, no-wrap
8832 msgid ""
8833 " char **\n"
8834 " guestfs_head (guestfs_h *g,\n"
8835 "               const char *path);\n"
8836 "\n"
8837 msgstr ""
8838
8839 #. type: textblock
8840 #: ../src/guestfs-actions.pod:2277 ../fish/guestfish-actions.pod:1539
8841 msgid ""
8842 "This command returns up to the first 10 lines of a file as a list of "
8843 "strings."
8844 msgstr ""
8845
8846 #. type: =head2
8847 #: ../src/guestfs-actions.pod:2289
8848 msgid "guestfs_head_n"
8849 msgstr ""
8850
8851 #. type: verbatim
8852 #: ../src/guestfs-actions.pod:2291
8853 #, no-wrap
8854 msgid ""
8855 " char **\n"
8856 " guestfs_head_n (guestfs_h *g,\n"
8857 "                 int nrlines,\n"
8858 "                 const char *path);\n"
8859 "\n"
8860 msgstr ""
8861
8862 #. type: textblock
8863 #: ../src/guestfs-actions.pod:2296 ../fish/guestfish-actions.pod:1549
8864 msgid ""
8865 "If the parameter C<nrlines> is a positive number, this returns the first "
8866 "C<nrlines> lines of the file C<path>."
8867 msgstr ""
8868
8869 #. type: textblock
8870 #: ../src/guestfs-actions.pod:2299 ../fish/guestfish-actions.pod:1552
8871 msgid ""
8872 "If the parameter C<nrlines> is a negative number, this returns lines from "
8873 "the file C<path>, excluding the last C<nrlines> lines."
8874 msgstr ""
8875
8876 #. type: textblock
8877 #: ../src/guestfs-actions.pod:2302 ../src/guestfs-actions.pod:6308 ../fish/guestfish-actions.pod:1555 ../fish/guestfish-actions.pod:4221
8878 msgid "If the parameter C<nrlines> is zero, this returns an empty list."
8879 msgstr ""
8880
8881 #. type: =head2
8882 #: ../src/guestfs-actions.pod:2313
8883 msgid "guestfs_hexdump"
8884 msgstr ""
8885
8886 #. type: verbatim
8887 #: ../src/guestfs-actions.pod:2315
8888 #, no-wrap
8889 msgid ""
8890 " char *\n"
8891 " guestfs_hexdump (guestfs_h *g,\n"
8892 "                  const char *path);\n"
8893 "\n"
8894 msgstr ""
8895
8896 #. type: textblock
8897 #: ../src/guestfs-actions.pod:2319 ../fish/guestfish-actions.pod:1564
8898 msgid ""
8899 "This runs C<hexdump -C> on the given C<path>.  The result is the "
8900 "human-readable, canonical hex dump of the file."
8901 msgstr ""
8902
8903 #. type: textblock
8904 #: ../src/guestfs-actions.pod:2328 ../src/guestfs-actions.pod:6092 ../src/guestfs-actions.pod:6147
8905 msgid "(Added in 1.0.22)"
8906 msgstr ""
8907
8908 #. type: =head2
8909 #: ../src/guestfs-actions.pod:2330
8910 msgid "guestfs_initrd_cat"
8911 msgstr ""
8912
8913 #. type: verbatim
8914 #: ../src/guestfs-actions.pod:2332
8915 #, no-wrap
8916 msgid ""
8917 " char *\n"
8918 " guestfs_initrd_cat (guestfs_h *g,\n"
8919 "                     const char *initrdpath,\n"
8920 "                     const char *filename,\n"
8921 "                     size_t *size_r);\n"
8922 "\n"
8923 msgstr ""
8924
8925 #. type: textblock
8926 #: ../src/guestfs-actions.pod:2338 ../fish/guestfish-actions.pod:1574
8927 msgid ""
8928 "This command unpacks the file C<filename> from the initrd file called "
8929 "C<initrdpath>.  The filename must be given I<without> the initial C</> "
8930 "character."
8931 msgstr ""
8932
8933 #. type: textblock
8934 #: ../src/guestfs-actions.pod:2342 ../fish/guestfish-actions.pod:1578
8935 msgid ""
8936 "For example, in guestfish you could use the following command to examine the "
8937 "boot script (usually called C</init>)  contained in a Linux initrd or "
8938 "initramfs image:"
8939 msgstr ""
8940
8941 #. type: verbatim
8942 #: ../src/guestfs-actions.pod:2346 ../fish/guestfish-actions.pod:1582
8943 #, no-wrap
8944 msgid ""
8945 " initrd-cat /boot/initrd-<version>.img init\n"
8946 "\n"
8947 msgstr ""
8948
8949 #. type: textblock
8950 #: ../src/guestfs-actions.pod:2348
8951 msgid "See also C<guestfs_initrd_list>."
8952 msgstr ""
8953
8954 #. type: =head2
8955 #: ../src/guestfs-actions.pod:2359
8956 msgid "guestfs_initrd_list"
8957 msgstr ""
8958
8959 #. type: verbatim
8960 #: ../src/guestfs-actions.pod:2361
8961 #, no-wrap
8962 msgid ""
8963 " char **\n"
8964 " guestfs_initrd_list (guestfs_h *g,\n"
8965 "                      const char *path);\n"
8966 "\n"
8967 msgstr ""
8968
8969 #. type: textblock
8970 #: ../src/guestfs-actions.pod:2365 ../fish/guestfish-actions.pod:1593
8971 msgid "This command lists out files contained in an initrd."
8972 msgstr ""
8973
8974 #. type: textblock
8975 #: ../src/guestfs-actions.pod:2367 ../fish/guestfish-actions.pod:1595
8976 msgid ""
8977 "The files are listed without any initial C</> character.  The files are "
8978 "listed in the order they appear (not necessarily alphabetical).  Directory "
8979 "names are listed as separate items."
8980 msgstr ""
8981
8982 #. type: textblock
8983 #: ../src/guestfs-actions.pod:2371 ../fish/guestfish-actions.pod:1599
8984 msgid ""
8985 "Old Linux kernels (2.4 and earlier) used a compressed ext2 filesystem as "
8986 "initrd.  We I<only> support the newer initramfs format (compressed cpio "
8987 "files)."
8988 msgstr ""
8989
8990 #. type: =head2
8991 #: ../src/guestfs-actions.pod:2381
8992 msgid "guestfs_inotify_add_watch"
8993 msgstr ""
8994
8995 #. type: verbatim
8996 #: ../src/guestfs-actions.pod:2383
8997 #, no-wrap
8998 msgid ""
8999 " int64_t\n"
9000 " guestfs_inotify_add_watch (guestfs_h *g,\n"
9001 "                            const char *path,\n"
9002 "                            int mask);\n"
9003 "\n"
9004 msgstr ""
9005
9006 #. type: textblock
9007 #: ../src/guestfs-actions.pod:2388 ../fish/guestfish-actions.pod:1607
9008 msgid "Watch C<path> for the events listed in C<mask>."
9009 msgstr ""
9010
9011 #. type: textblock
9012 #: ../src/guestfs-actions.pod:2390 ../fish/guestfish-actions.pod:1609
9013 msgid ""
9014 "Note that if C<path> is a directory then events within that directory are "
9015 "watched, but this does I<not> happen recursively (in subdirectories)."
9016 msgstr ""
9017
9018 #. type: textblock
9019 #: ../src/guestfs-actions.pod:2394 ../fish/guestfish-actions.pod:1613
9020 msgid ""
9021 "Note for non-C or non-Linux callers: the inotify events are defined by the "
9022 "Linux kernel ABI and are listed in C</usr/include/sys/inotify.h>."
9023 msgstr ""
9024
9025 #. type: =head2
9026 #: ../src/guestfs-actions.pod:2402
9027 msgid "guestfs_inotify_close"
9028 msgstr ""
9029
9030 #. type: verbatim
9031 #: ../src/guestfs-actions.pod:2404
9032 #, no-wrap
9033 msgid ""
9034 " int\n"
9035 " guestfs_inotify_close (guestfs_h *g);\n"
9036 "\n"
9037 msgstr ""
9038
9039 #. type: textblock
9040 #: ../src/guestfs-actions.pod:2407 ../fish/guestfish-actions.pod:1621
9041 msgid ""
9042 "This closes the inotify handle which was previously opened by inotify_init.  "
9043 "It removes all watches, throws away any pending events, and deallocates all "
9044 "resources."
9045 msgstr ""
9046
9047 #. type: =head2
9048 #: ../src/guestfs-actions.pod:2415
9049 msgid "guestfs_inotify_files"
9050 msgstr ""
9051
9052 #. type: verbatim
9053 #: ../src/guestfs-actions.pod:2417
9054 #, no-wrap
9055 msgid ""
9056 " char **\n"
9057 " guestfs_inotify_files (guestfs_h *g);\n"
9058 "\n"
9059 msgstr ""
9060
9061 #. type: textblock
9062 #: ../src/guestfs-actions.pod:2420
9063 msgid ""
9064 "This function is a helpful wrapper around C<guestfs_inotify_read> which just "
9065 "returns a list of pathnames of objects that were touched.  The returned "
9066 "pathnames are sorted and deduplicated."
9067 msgstr ""
9068
9069 #. type: =head2
9070 #: ../src/guestfs-actions.pod:2430
9071 msgid "guestfs_inotify_init"
9072 msgstr ""
9073
9074 #. type: verbatim
9075 #: ../src/guestfs-actions.pod:2432
9076 #, no-wrap
9077 msgid ""
9078 " int\n"
9079 " guestfs_inotify_init (guestfs_h *g,\n"
9080 "                       int maxevents);\n"
9081 "\n"
9082 msgstr ""
9083
9084 #. type: textblock
9085 #: ../src/guestfs-actions.pod:2436 ../fish/guestfish-actions.pod:1637
9086 msgid ""
9087 "This command creates a new inotify handle.  The inotify subsystem can be "
9088 "used to notify events which happen to objects in the guest filesystem."
9089 msgstr ""
9090
9091 #. type: textblock
9092 #: ../src/guestfs-actions.pod:2440
9093 msgid ""
9094 "C<maxevents> is the maximum number of events which will be queued up between "
9095 "calls to C<guestfs_inotify_read> or C<guestfs_inotify_files>.  If this is "
9096 "passed as C<0>, then the kernel (or previously set)  default is used.  For "
9097 "Linux 2.6.29 the default was 16384 events.  Beyond this limit, the kernel "
9098 "throws away events, but records the fact that it threw them away by setting "
9099 "a flag C<IN_Q_OVERFLOW> in the returned structure list (see "
9100 "C<guestfs_inotify_read>)."
9101 msgstr ""
9102
9103 #. type: textblock
9104 #: ../src/guestfs-actions.pod:2450
9105 msgid ""
9106 "Before any events are generated, you have to add some watches to the "
9107 "internal watch list.  See: C<guestfs_inotify_add_watch>, "
9108 "C<guestfs_inotify_rm_watch> and C<guestfs_inotify_watch_all>."
9109 msgstr ""
9110
9111 #. type: textblock
9112 #: ../src/guestfs-actions.pod:2456
9113 msgid ""
9114 "Queued up events should be read periodically by calling "
9115 "C<guestfs_inotify_read> (or C<guestfs_inotify_files> which is just a helpful "
9116 "wrapper around C<guestfs_inotify_read>).  If you don't read the events out "
9117 "often enough then you risk the internal queue overflowing."
9118 msgstr ""
9119
9120 #. type: textblock
9121 #: ../src/guestfs-actions.pod:2463
9122 msgid ""
9123 "The handle should be closed after use by calling C<guestfs_inotify_close>.  "
9124 "This also removes any watches automatically."
9125 msgstr ""
9126
9127 #. type: textblock
9128 #: ../src/guestfs-actions.pod:2467 ../fish/guestfish-actions.pod:1668
9129 msgid ""
9130 "See also L<inotify(7)> for an overview of the inotify interface as exposed "
9131 "by the Linux kernel, which is roughly what we expose via libguestfs.  Note "
9132 "that there is one global inotify handle per libguestfs instance."
9133 msgstr ""
9134
9135 #. type: =head2
9136 #: ../src/guestfs-actions.pod:2476
9137 msgid "guestfs_inotify_read"
9138 msgstr ""
9139
9140 #. type: verbatim
9141 #: ../src/guestfs-actions.pod:2478
9142 #, no-wrap
9143 msgid ""
9144 " struct guestfs_inotify_event_list *\n"
9145 " guestfs_inotify_read (guestfs_h *g);\n"
9146 "\n"
9147 msgstr ""
9148
9149 #. type: textblock
9150 #: ../src/guestfs-actions.pod:2481 ../fish/guestfish-actions.pod:1677
9151 msgid ""
9152 "Return the complete queue of events that have happened since the previous "
9153 "read call."
9154 msgstr ""
9155
9156 #. type: textblock
9157 #: ../src/guestfs-actions.pod:2484 ../fish/guestfish-actions.pod:1680
9158 msgid "If no events have happened, this returns an empty list."
9159 msgstr ""
9160
9161 #. type: textblock
9162 #: ../src/guestfs-actions.pod:2486 ../fish/guestfish-actions.pod:1682
9163 msgid ""
9164 "I<Note>: In order to make sure that all events have been read, you must call "
9165 "this function repeatedly until it returns an empty list.  The reason is that "
9166 "the call will read events up to the maximum appliance-to-host message size "
9167 "and leave remaining events in the queue."
9168 msgstr ""
9169
9170 #. type: textblock
9171 #: ../src/guestfs-actions.pod:2492
9172 msgid ""
9173 "This function returns a C<struct guestfs_inotify_event_list *>, or NULL if "
9174 "there was an error.  I<The caller must call "
9175 "C<guestfs_free_inotify_event_list> after use>."
9176 msgstr ""
9177
9178 #. type: =head2
9179 #: ../src/guestfs-actions.pod:2498
9180 msgid "guestfs_inotify_rm_watch"
9181 msgstr ""
9182
9183 #. type: verbatim
9184 #: ../src/guestfs-actions.pod:2500
9185 #, no-wrap
9186 msgid ""
9187 " int\n"
9188 " guestfs_inotify_rm_watch (guestfs_h *g,\n"
9189 "                           int wd);\n"
9190 "\n"
9191 msgstr ""
9192
9193 #. type: textblock
9194 #: ../src/guestfs-actions.pod:2504
9195 msgid ""
9196 "Remove a previously defined inotify watch.  See "
9197 "C<guestfs_inotify_add_watch>."
9198 msgstr ""
9199
9200 #. type: =head2
9201 #: ../src/guestfs-actions.pod:2511
9202 msgid "guestfs_inspect_get_arch"
9203 msgstr ""
9204
9205 #. type: verbatim
9206 #: ../src/guestfs-actions.pod:2513
9207 #, no-wrap
9208 msgid ""
9209 " char *\n"
9210 " guestfs_inspect_get_arch (guestfs_h *g,\n"
9211 "                           const char *root);\n"
9212 "\n"
9213 msgstr ""
9214
9215 #. type: textblock
9216 #: ../src/guestfs-actions.pod:2517 ../src/guestfs-actions.pod:2540 ../src/guestfs-actions.pod:2621 ../src/guestfs-actions.pod:2647 ../src/guestfs-actions.pod:2669 ../src/guestfs-actions.pod:2696 ../src/guestfs-actions.pod:2717 ../src/guestfs-actions.pod:2754 ../src/guestfs-actions.pod:2783 ../src/guestfs-actions.pod:2814 ../src/guestfs-actions.pod:2858 ../src/guestfs-actions.pod:2900 ../src/guestfs-actions.pod:2923
9217 msgid ""
9218 "This function should only be called with a root device string as returned by "
9219 "C<guestfs_inspect_os>."
9220 msgstr ""
9221
9222 #. type: textblock
9223 #: ../src/guestfs-actions.pod:2520
9224 msgid ""
9225 "This returns the architecture of the inspected operating system.  The "
9226 "possible return values are listed under C<guestfs_file_architecture>."
9227 msgstr ""
9228
9229 #. type: textblock
9230 #: ../src/guestfs-actions.pod:2524 ../fish/guestfish-actions.pod:1706
9231 msgid ""
9232 "If the architecture could not be determined, then the string C<unknown> is "
9233 "returned."
9234 msgstr ""
9235
9236 #. type: textblock
9237 #: ../src/guestfs-actions.pod:2527 ../src/guestfs-actions.pod:2608 ../src/guestfs-actions.pod:2656 ../src/guestfs-actions.pod:2684 ../src/guestfs-actions.pod:2770 ../src/guestfs-actions.pod:2801 ../src/guestfs-actions.pod:2825 ../src/guestfs-actions.pod:2844 ../src/guestfs-actions.pod:2887 ../src/guestfs-actions.pod:2910 ../src/guestfs-actions.pod:3016 ../src/guestfs-actions.pod:3057 ../fish/guestfish-actions.pod:1709 ../fish/guestfish-actions.pod:1783 ../fish/guestfish-actions.pod:1816 ../fish/guestfish-actions.pod:1837 ../fish/guestfish-actions.pod:1901 ../fish/guestfish-actions.pod:1925 ../fish/guestfish-actions.pod:1942 ../fish/guestfish-actions.pod:1955 ../fish/guestfish-actions.pod:1990 ../fish/guestfish-actions.pod:2006 ../fish/guestfish-actions.pod:2105 ../fish/guestfish-actions.pod:2139
9238 msgid "Please read L<guestfs(3)/INSPECTION> for more details."
9239 msgstr ""
9240
9241 #. type: =head2
9242 #: ../src/guestfs-actions.pod:2534
9243 msgid "guestfs_inspect_get_distro"
9244 msgstr ""
9245
9246 #. type: verbatim
9247 #: ../src/guestfs-actions.pod:2536
9248 #, no-wrap
9249 msgid ""
9250 " char *\n"
9251 " guestfs_inspect_get_distro (guestfs_h *g,\n"
9252 "                             const char *root);\n"
9253 "\n"
9254 msgstr ""
9255
9256 #. type: textblock
9257 #: ../src/guestfs-actions.pod:2543 ../fish/guestfish-actions.pod:1718
9258 msgid "This returns the distro (distribution) of the inspected operating system."
9259 msgstr ""
9260
9261 #. type: textblock
9262 #: ../src/guestfs-actions.pod:2546 ../fish/guestfish-actions.pod:1721
9263 msgid "Currently defined distros are:"
9264 msgstr ""
9265
9266 #. type: =item
9267 #: ../src/guestfs-actions.pod:2550 ../fish/guestfish-actions.pod:1725
9268 msgid "\"archlinux\""
9269 msgstr ""
9270
9271 #. type: textblock
9272 #: ../src/guestfs-actions.pod:2552 ../fish/guestfish-actions.pod:1727
9273 msgid "Arch Linux."
9274 msgstr ""
9275
9276 #. type: =item
9277 #: ../src/guestfs-actions.pod:2554 ../fish/guestfish-actions.pod:1729
9278 msgid "\"debian\""
9279 msgstr ""
9280
9281 #. type: textblock
9282 #: ../src/guestfs-actions.pod:2556 ../fish/guestfish-actions.pod:1731
9283 msgid "Debian."
9284 msgstr ""
9285
9286 #. type: =item
9287 #: ../src/guestfs-actions.pod:2558 ../fish/guestfish-actions.pod:1733
9288 msgid "\"fedora\""
9289 msgstr ""
9290
9291 #. type: textblock
9292 #: ../src/guestfs-actions.pod:2560 ../fish/guestfish-actions.pod:1735
9293 msgid "Fedora."
9294 msgstr ""
9295
9296 #. type: =item
9297 #: ../src/guestfs-actions.pod:2562 ../fish/guestfish-actions.pod:1737
9298 msgid "\"gentoo\""
9299 msgstr ""
9300
9301 #. type: textblock
9302 #: ../src/guestfs-actions.pod:2564 ../fish/guestfish-actions.pod:1739
9303 msgid "Gentoo."
9304 msgstr ""
9305
9306 #. type: =item
9307 #: ../src/guestfs-actions.pod:2566 ../fish/guestfish-actions.pod:1741
9308 msgid "\"linuxmint\""
9309 msgstr ""
9310
9311 #. type: textblock
9312 #: ../src/guestfs-actions.pod:2568 ../fish/guestfish-actions.pod:1743
9313 msgid "Linux Mint."
9314 msgstr ""
9315
9316 #. type: =item
9317 #: ../src/guestfs-actions.pod:2570 ../fish/guestfish-actions.pod:1745
9318 msgid "\"mandriva\""
9319 msgstr ""
9320
9321 #. type: textblock
9322 #: ../src/guestfs-actions.pod:2572 ../fish/guestfish-actions.pod:1747
9323 msgid "Mandriva."
9324 msgstr ""
9325
9326 #. type: =item
9327 #: ../src/guestfs-actions.pod:2574 ../fish/guestfish-actions.pod:1749
9328 msgid "\"meego\""
9329 msgstr ""
9330
9331 #. type: textblock
9332 #: ../src/guestfs-actions.pod:2576 ../fish/guestfish-actions.pod:1751
9333 msgid "MeeGo."
9334 msgstr ""
9335
9336 #. type: =item
9337 #: ../src/guestfs-actions.pod:2578 ../fish/guestfish-actions.pod:1753
9338 msgid "\"pardus\""
9339 msgstr ""
9340
9341 #. type: textblock
9342 #: ../src/guestfs-actions.pod:2580 ../fish/guestfish-actions.pod:1755
9343 msgid "Pardus."
9344 msgstr ""
9345
9346 #. type: =item
9347 #: ../src/guestfs-actions.pod:2582 ../fish/guestfish-actions.pod:1757
9348 msgid "\"redhat-based\""
9349 msgstr ""
9350
9351 #. type: textblock
9352 #: ../src/guestfs-actions.pod:2584 ../fish/guestfish-actions.pod:1759
9353 msgid "Some Red Hat-derived distro."
9354 msgstr ""
9355
9356 #. type: =item
9357 #: ../src/guestfs-actions.pod:2586 ../fish/guestfish-actions.pod:1761
9358 msgid "\"rhel\""
9359 msgstr ""
9360
9361 #. type: textblock
9362 #: ../src/guestfs-actions.pod:2588 ../fish/guestfish-actions.pod:1763
9363 msgid "Red Hat Enterprise Linux and some derivatives."
9364 msgstr ""
9365
9366 #. type: =item
9367 #: ../src/guestfs-actions.pod:2590 ../fish/guestfish-actions.pod:1765
9368 msgid "\"ubuntu\""
9369 msgstr ""
9370
9371 #. type: textblock
9372 #: ../src/guestfs-actions.pod:2592 ../fish/guestfish-actions.pod:1767
9373 msgid "Ubuntu."
9374 msgstr ""
9375
9376 #. type: =item
9377 #: ../src/guestfs-actions.pod:2594 ../src/guestfs-actions.pod:2878 ../fish/guestfish-actions.pod:1769 ../fish/guestfish-actions.pod:1981
9378 msgid "\"unknown\""
9379 msgstr ""
9380
9381 #. type: textblock
9382 #: ../src/guestfs-actions.pod:2596 ../fish/guestfish-actions.pod:1771
9383 msgid "The distro could not be determined."
9384 msgstr ""
9385
9386 #. type: =item
9387 #: ../src/guestfs-actions.pod:2598 ../src/guestfs-actions.pod:2870 ../fish/guestfish-actions.pod:1773 ../fish/guestfish-actions.pod:1973
9388 msgid "\"windows\""
9389 msgstr ""
9390
9391 #. type: textblock
9392 #: ../src/guestfs-actions.pod:2600 ../fish/guestfish-actions.pod:1775
9393 msgid ""
9394 "Windows does not have distributions.  This string is returned if the OS type "
9395 "is Windows."
9396 msgstr ""
9397
9398 #. type: textblock
9399 #: ../src/guestfs-actions.pod:2605 ../src/guestfs-actions.pod:2884 ../fish/guestfish-actions.pod:1780 ../fish/guestfish-actions.pod:1987
9400 msgid ""
9401 "Future versions of libguestfs may return other strings here.  The caller "
9402 "should be prepared to handle any string."
9403 msgstr ""
9404
9405 #. type: =head2
9406 #: ../src/guestfs-actions.pod:2615
9407 msgid "guestfs_inspect_get_filesystems"
9408 msgstr ""
9409
9410 #. type: verbatim
9411 #: ../src/guestfs-actions.pod:2617
9412 #, no-wrap
9413 msgid ""
9414 " char **\n"
9415 " guestfs_inspect_get_filesystems (guestfs_h *g,\n"
9416 "                                  const char *root);\n"
9417 "\n"
9418 msgstr ""
9419
9420 #. type: textblock
9421 #: ../src/guestfs-actions.pod:2624 ../fish/guestfish-actions.pod:1792
9422 msgid ""
9423 "This returns a list of all the filesystems that we think are associated with "
9424 "this operating system.  This includes the root filesystem, other ordinary "
9425 "filesystems, and non-mounted devices like swap partitions."
9426 msgstr ""
9427
9428 #. type: textblock
9429 #: ../src/guestfs-actions.pod:2629 ../fish/guestfish-actions.pod:1797
9430 msgid ""
9431 "In the case of a multi-boot virtual machine, it is possible for a filesystem "
9432 "to be shared between operating systems."
9433 msgstr ""
9434
9435 #. type: textblock
9436 #: ../src/guestfs-actions.pod:2632
9437 msgid ""
9438 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
9439 "C<guestfs_inspect_get_mountpoints>."
9440 msgstr ""
9441
9442 #. type: =head2
9443 #: ../src/guestfs-actions.pod:2641
9444 msgid "guestfs_inspect_get_hostname"
9445 msgstr ""
9446
9447 #. type: verbatim
9448 #: ../src/guestfs-actions.pod:2643
9449 #, no-wrap
9450 msgid ""
9451 " char *\n"
9452 " guestfs_inspect_get_hostname (guestfs_h *g,\n"
9453 "                               const char *root);\n"
9454 "\n"
9455 msgstr ""
9456
9457 #. type: textblock
9458 #: ../src/guestfs-actions.pod:2650 ../fish/guestfish-actions.pod:1810
9459 msgid ""
9460 "This function returns the hostname of the operating system as found by "
9461 "inspection of the guest's configuration files."
9462 msgstr ""
9463
9464 #. type: textblock
9465 #: ../src/guestfs-actions.pod:2653 ../fish/guestfish-actions.pod:1813
9466 msgid ""
9467 "If the hostname could not be determined, then the string C<unknown> is "
9468 "returned."
9469 msgstr ""
9470
9471 #. type: textblock
9472 #: ../src/guestfs-actions.pod:2661
9473 msgid "(Added in 1.7.9)"
9474 msgstr ""
9475
9476 #. type: =head2
9477 #: ../src/guestfs-actions.pod:2663
9478 msgid "guestfs_inspect_get_major_version"
9479 msgstr ""
9480
9481 #. type: verbatim
9482 #: ../src/guestfs-actions.pod:2665
9483 #, no-wrap
9484 msgid ""
9485 " int\n"
9486 " guestfs_inspect_get_major_version (guestfs_h *g,\n"
9487 "                                    const char *root);\n"
9488 "\n"
9489 msgstr ""
9490
9491 #. type: textblock
9492 #: ../src/guestfs-actions.pod:2672 ../fish/guestfish-actions.pod:1825
9493 msgid "This returns the major version number of the inspected operating system."
9494 msgstr ""
9495
9496 #. type: textblock
9497 #: ../src/guestfs-actions.pod:2675 ../fish/guestfish-actions.pod:1828
9498 msgid ""
9499 "Windows uses a consistent versioning scheme which is I<not> reflected in the "
9500 "popular public names used by the operating system.  Notably the operating "
9501 "system known as \"Windows 7\" is really version 6.1 (ie. major = 6, minor = "
9502 "1).  You can find out the real versions corresponding to releases of Windows "
9503 "by consulting Wikipedia or MSDN."
9504 msgstr ""
9505
9506 #. type: textblock
9507 #: ../src/guestfs-actions.pod:2682 ../src/guestfs-actions.pod:2702 ../fish/guestfish-actions.pod:1835 ../fish/guestfish-actions.pod:1849
9508 msgid "If the version could not be determined, then C<0> is returned."
9509 msgstr ""
9510
9511 #. type: =head2
9512 #: ../src/guestfs-actions.pod:2690
9513 msgid "guestfs_inspect_get_minor_version"
9514 msgstr ""
9515
9516 #. type: verbatim
9517 #: ../src/guestfs-actions.pod:2692
9518 #, no-wrap
9519 msgid ""
9520 " int\n"
9521 " guestfs_inspect_get_minor_version (guestfs_h *g,\n"
9522 "                                    const char *root);\n"
9523 "\n"
9524 msgstr ""
9525
9526 #. type: textblock
9527 #: ../src/guestfs-actions.pod:2699 ../fish/guestfish-actions.pod:1846
9528 msgid "This returns the minor version number of the inspected operating system."
9529 msgstr ""
9530
9531 #. type: textblock
9532 #: ../src/guestfs-actions.pod:2704
9533 msgid ""
9534 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
9535 "C<guestfs_inspect_get_major_version>."
9536 msgstr ""
9537
9538 #. type: =head2
9539 #: ../src/guestfs-actions.pod:2711
9540 msgid "guestfs_inspect_get_mountpoints"
9541 msgstr ""
9542
9543 #. type: verbatim
9544 #: ../src/guestfs-actions.pod:2713
9545 #, no-wrap
9546 msgid ""
9547 " char **\n"
9548 " guestfs_inspect_get_mountpoints (guestfs_h *g,\n"
9549 "                                  const char *root);\n"
9550 "\n"
9551 msgstr ""
9552
9553 #. type: textblock
9554 #: ../src/guestfs-actions.pod:2720 ../fish/guestfish-actions.pod:1861
9555 msgid ""
9556 "This returns a hash of where we think the filesystems associated with this "
9557 "operating system should be mounted.  Callers should note that this is at "
9558 "best an educated guess made by reading configuration files such as "
9559 "C</etc/fstab>.  I<In particular note> that this may return filesystems which "
9560 "are non-existent or not mountable and callers should be prepared to handle "
9561 "or ignore failures if they try to mount them."
9562 msgstr ""
9563
9564 #. type: textblock
9565 #: ../src/guestfs-actions.pod:2729 ../fish/guestfish-actions.pod:1870
9566 msgid ""
9567 "Each element in the returned hashtable has a key which is the path of the "
9568 "mountpoint (eg. C</boot>) and a value which is the filesystem that would be "
9569 "mounted there (eg. C</dev/sda1>)."
9570 msgstr ""
9571
9572 #. type: textblock
9573 #: ../src/guestfs-actions.pod:2734 ../fish/guestfish-actions.pod:1875
9574 msgid "Non-mounted devices such as swap devices are I<not> returned in this list."
9575 msgstr ""
9576
9577 #. type: textblock
9578 #: ../src/guestfs-actions.pod:2737
9579 msgid ""
9580 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
9581 "C<guestfs_inspect_get_filesystems>."
9582 msgstr ""
9583
9584 #. type: textblock
9585 #: ../src/guestfs-actions.pod:2740 ../src/guestfs-actions.pod:3386 ../src/guestfs-actions.pod:4584 ../src/guestfs-actions.pod:6449
9586 msgid ""
9587 "This function returns a NULL-terminated array of strings, or NULL if there "
9588 "was an error.  The array of strings will always have length C<2n+1>, where "
9589 "C<n> keys and values alternate, followed by the trailing NULL entry.  I<The "
9590 "caller must free the strings and the array after use>."
9591 msgstr ""
9592
9593 #. type: =head2
9594 #: ../src/guestfs-actions.pod:2748
9595 msgid "guestfs_inspect_get_package_format"
9596 msgstr ""
9597
9598 #. type: verbatim
9599 #: ../src/guestfs-actions.pod:2750
9600 #, no-wrap
9601 msgid ""
9602 " char *\n"
9603 " guestfs_inspect_get_package_format (guestfs_h *g,\n"
9604 "                                     const char *root);\n"
9605 "\n"
9606 msgstr ""
9607
9608 #. type: textblock
9609 #: ../src/guestfs-actions.pod:2757
9610 msgid ""
9611 "This function and C<guestfs_inspect_get_package_management> return the "
9612 "package format and package management tool used by the inspected operating "
9613 "system.  For example for Fedora these functions would return C<rpm> (package "
9614 "format) and C<yum> (package management)."
9615 msgstr ""
9616
9617 #. type: textblock
9618 #: ../src/guestfs-actions.pod:2763 ../fish/guestfish-actions.pod:1894
9619 msgid ""
9620 "This returns the string C<unknown> if we could not determine the package "
9621 "format I<or> if the operating system does not have a real packaging system "
9622 "(eg. Windows)."
9623 msgstr ""
9624
9625 #. type: textblock
9626 #: ../src/guestfs-actions.pod:2767 ../fish/guestfish-actions.pod:1898
9627 msgid ""
9628 "Possible strings include: C<rpm>, C<deb>, C<ebuild>, C<pisi>, C<pacman>.  "
9629 "Future versions of libguestfs may return other strings."
9630 msgstr ""
9631
9632 #. type: textblock
9633 #: ../src/guestfs-actions.pod:2775 ../src/guestfs-actions.pod:2806
9634 msgid "(Added in 1.7.5)"
9635 msgstr ""
9636
9637 #. type: =head2
9638 #: ../src/guestfs-actions.pod:2777
9639 msgid "guestfs_inspect_get_package_management"
9640 msgstr ""
9641
9642 #. type: verbatim
9643 #: ../src/guestfs-actions.pod:2779
9644 #, no-wrap
9645 msgid ""
9646 " char *\n"
9647 " guestfs_inspect_get_package_management (guestfs_h *g,\n"
9648 "                                         const char *root);\n"
9649 "\n"
9650 msgstr ""
9651
9652 #. type: textblock
9653 #: ../src/guestfs-actions.pod:2786
9654 msgid ""
9655 "C<guestfs_inspect_get_package_format> and this function return the package "
9656 "format and package management tool used by the inspected operating system.  "
9657 "For example for Fedora these functions would return C<rpm> (package format) "
9658 "and C<yum> (package management)."
9659 msgstr ""
9660
9661 #. type: textblock
9662 #: ../src/guestfs-actions.pod:2792 ../fish/guestfish-actions.pod:1916
9663 msgid ""
9664 "This returns the string C<unknown> if we could not determine the package "
9665 "management tool I<or> if the operating system does not have a real packaging "
9666 "system (eg. Windows)."
9667 msgstr ""
9668
9669 #. type: textblock
9670 #: ../src/guestfs-actions.pod:2796 ../fish/guestfish-actions.pod:1920
9671 msgid ""
9672 "Possible strings include: C<yum>, C<up2date>, C<apt> (for all Debian "
9673 "derivatives), C<portage>, C<pisi>, C<pacman>, C<urpmi>.  Future versions of "
9674 "libguestfs may return other strings."
9675 msgstr ""
9676
9677 #. type: =head2
9678 #: ../src/guestfs-actions.pod:2808
9679 msgid "guestfs_inspect_get_product_name"
9680 msgstr ""
9681
9682 #. type: verbatim
9683 #: ../src/guestfs-actions.pod:2810
9684 #, no-wrap
9685 msgid ""
9686 " char *\n"
9687 " guestfs_inspect_get_product_name (guestfs_h *g,\n"
9688 "                                   const char *root);\n"
9689 "\n"
9690 msgstr ""
9691
9692 #. type: textblock
9693 #: ../src/guestfs-actions.pod:2817 ../fish/guestfish-actions.pod:1934
9694 msgid ""
9695 "This returns the product name of the inspected operating system.  The "
9696 "product name is generally some freeform string which can be displayed to the "
9697 "user, but should not be parsed by programs."
9698 msgstr ""
9699
9700 #. type: textblock
9701 #: ../src/guestfs-actions.pod:2822 ../fish/guestfish-actions.pod:1939
9702 msgid ""
9703 "If the product name could not be determined, then the string C<unknown> is "
9704 "returned."
9705 msgstr ""
9706
9707 #. type: =head2
9708 #: ../src/guestfs-actions.pod:2832
9709 msgid "guestfs_inspect_get_roots"
9710 msgstr ""
9711
9712 #. type: verbatim
9713 #: ../src/guestfs-actions.pod:2834
9714 #, no-wrap
9715 msgid ""
9716 " char **\n"
9717 " guestfs_inspect_get_roots (guestfs_h *g);\n"
9718 "\n"
9719 msgstr ""
9720
9721 #. type: textblock
9722 #: ../src/guestfs-actions.pod:2837
9723 msgid ""
9724 "This function is a convenient way to get the list of root devices, as "
9725 "returned from a previous call to C<guestfs_inspect_os>, but without redoing "
9726 "the whole inspection process."
9727 msgstr ""
9728
9729 #. type: textblock
9730 #: ../src/guestfs-actions.pod:2841
9731 msgid ""
9732 "This returns an empty list if either no root devices were found or the "
9733 "caller has not called C<guestfs_inspect_os>."
9734 msgstr ""
9735
9736 #. type: textblock
9737 #: ../src/guestfs-actions.pod:2850
9738 msgid "(Added in 1.7.3)"
9739 msgstr ""
9740
9741 #. type: =head2
9742 #: ../src/guestfs-actions.pod:2852
9743 msgid "guestfs_inspect_get_type"
9744 msgstr ""
9745
9746 #. type: verbatim
9747 #: ../src/guestfs-actions.pod:2854
9748 #, no-wrap
9749 msgid ""
9750 " char *\n"
9751 " guestfs_inspect_get_type (guestfs_h *g,\n"
9752 "                           const char *root);\n"
9753 "\n"
9754 msgstr ""
9755
9756 #. type: textblock
9757 #: ../src/guestfs-actions.pod:2861 ../fish/guestfish-actions.pod:1964
9758 msgid ""
9759 "This returns the type of the inspected operating system.  Currently defined "
9760 "types are:"
9761 msgstr ""
9762
9763 #. type: =item
9764 #: ../src/guestfs-actions.pod:2866 ../fish/guestfish-actions.pod:1969
9765 msgid "\"linux\""
9766 msgstr ""
9767
9768 #. type: textblock
9769 #: ../src/guestfs-actions.pod:2868 ../fish/guestfish-actions.pod:1971
9770 msgid "Any Linux-based operating system."
9771 msgstr ""
9772
9773 #. type: textblock
9774 #: ../src/guestfs-actions.pod:2872 ../fish/guestfish-actions.pod:1975
9775 msgid "Any Microsoft Windows operating system."
9776 msgstr ""
9777
9778 #. type: =item
9779 #: ../src/guestfs-actions.pod:2874 ../fish/guestfish-actions.pod:1977
9780 msgid "\"freebsd\""
9781 msgstr ""
9782
9783 #. type: textblock
9784 #: ../src/guestfs-actions.pod:2876 ../fish/guestfish-actions.pod:1979
9785 msgid "FreeBSD."
9786 msgstr ""
9787
9788 #. type: textblock
9789 #: ../src/guestfs-actions.pod:2880 ../fish/guestfish-actions.pod:1983
9790 msgid "The operating system type could not be determined."
9791 msgstr ""
9792
9793 #. type: =head2
9794 #: ../src/guestfs-actions.pod:2894
9795 msgid "guestfs_inspect_get_windows_systemroot"
9796 msgstr ""
9797
9798 #. type: verbatim
9799 #: ../src/guestfs-actions.pod:2896
9800 #, no-wrap
9801 msgid ""
9802 " char *\n"
9803 " guestfs_inspect_get_windows_systemroot (guestfs_h *g,\n"
9804 "                                         const char *root);\n"
9805 "\n"
9806 msgstr ""
9807
9808 #. type: textblock
9809 #: ../src/guestfs-actions.pod:2903 ../fish/guestfish-actions.pod:1999
9810 msgid ""
9811 "This returns the Windows systemroot of the inspected guest.  The systemroot "
9812 "is a directory path such as C</WINDOWS>."
9813 msgstr ""
9814
9815 #. type: textblock
9816 #: ../src/guestfs-actions.pod:2906 ../fish/guestfish-actions.pod:2002
9817 msgid ""
9818 "This call assumes that the guest is Windows and that the systemroot could be "
9819 "determined by inspection.  If this is not the case then an error is "
9820 "returned."
9821 msgstr ""
9822
9823 #. type: textblock
9824 #: ../src/guestfs-actions.pod:2915
9825 msgid "(Added in 1.5.25)"
9826 msgstr ""
9827
9828 #. type: =head2
9829 #: ../src/guestfs-actions.pod:2917
9830 msgid "guestfs_inspect_list_applications"
9831 msgstr ""
9832
9833 #. type: verbatim
9834 #: ../src/guestfs-actions.pod:2919
9835 #, no-wrap
9836 msgid ""
9837 " struct guestfs_application_list *\n"
9838 " guestfs_inspect_list_applications (guestfs_h *g,\n"
9839 "                                    const char *root);\n"
9840 "\n"
9841 msgstr ""
9842
9843 #. type: textblock
9844 #: ../src/guestfs-actions.pod:2926 ../fish/guestfish-actions.pod:2015
9845 msgid "Return the list of applications installed in the operating system."
9846 msgstr ""
9847
9848 #. type: textblock
9849 #: ../src/guestfs-actions.pod:2928
9850 msgid ""
9851 "I<Note:> This call works differently from other parts of the inspection "
9852 "API.  You have to call C<guestfs_inspect_os>, then "
9853 "C<guestfs_inspect_get_mountpoints>, then mount up the disks, before calling "
9854 "this.  Listing applications is a significantly more difficult operation "
9855 "which requires access to the full filesystem.  Also note that unlike the "
9856 "other C<guestfs_inspect_get_*> calls which are just returning data cached in "
9857 "the libguestfs handle, this call actually reads parts of the mounted "
9858 "filesystems during the call."
9859 msgstr ""
9860
9861 #. type: textblock
9862 #: ../src/guestfs-actions.pod:2938 ../fish/guestfish-actions.pod:2027
9863 msgid ""
9864 "This returns an empty list if the inspection code was not able to determine "
9865 "the list of applications."
9866 msgstr ""
9867
9868 #. type: textblock
9869 #: ../src/guestfs-actions.pod:2941 ../fish/guestfish-actions.pod:2030
9870 msgid "The application structure contains the following fields:"
9871 msgstr ""
9872
9873 #. type: =item
9874 #: ../src/guestfs-actions.pod:2945 ../fish/guestfish-actions.pod:2034
9875 msgid "C<app_name>"
9876 msgstr ""
9877
9878 #. type: textblock
9879 #: ../src/guestfs-actions.pod:2947 ../fish/guestfish-actions.pod:2036
9880 msgid ""
9881 "The name of the application.  For Red Hat-derived and Debian-derived Linux "
9882 "guests, this is the package name."
9883 msgstr ""
9884
9885 #. type: =item
9886 #: ../src/guestfs-actions.pod:2950 ../fish/guestfish-actions.pod:2039
9887 msgid "C<app_display_name>"
9888 msgstr ""
9889
9890 #. type: textblock
9891 #: ../src/guestfs-actions.pod:2952 ../fish/guestfish-actions.pod:2041
9892 msgid ""
9893 "The display name of the application, sometimes localized to the install "
9894 "language of the guest operating system."
9895 msgstr ""
9896
9897 #. type: textblock
9898 #: ../src/guestfs-actions.pod:2955 ../fish/guestfish-actions.pod:2044
9899 msgid ""
9900 "If unavailable this is returned as an empty string C<\"\">.  Callers needing "
9901 "to display something can use C<app_name> instead."
9902 msgstr ""
9903
9904 #. type: =item
9905 #: ../src/guestfs-actions.pod:2958 ../fish/guestfish-actions.pod:2047
9906 msgid "C<app_epoch>"
9907 msgstr ""
9908
9909 #. type: textblock
9910 #: ../src/guestfs-actions.pod:2960 ../fish/guestfish-actions.pod:2049
9911 msgid ""
9912 "For package managers which use epochs, this contains the epoch of the "
9913 "package (an integer).  If unavailable, this is returned as C<0>."
9914 msgstr ""
9915
9916 #. type: =item
9917 #: ../src/guestfs-actions.pod:2963 ../fish/guestfish-actions.pod:2052
9918 msgid "C<app_version>"
9919 msgstr ""
9920
9921 #. type: textblock
9922 #: ../src/guestfs-actions.pod:2965 ../fish/guestfish-actions.pod:2054
9923 msgid ""
9924 "The version string of the application or package.  If unavailable this is "
9925 "returned as an empty string C<\"\">."
9926 msgstr ""
9927
9928 #. type: =item
9929 #: ../src/guestfs-actions.pod:2968 ../fish/guestfish-actions.pod:2057
9930 msgid "C<app_release>"
9931 msgstr ""
9932
9933 #. type: textblock
9934 #: ../src/guestfs-actions.pod:2970 ../fish/guestfish-actions.pod:2059
9935 msgid ""
9936 "The release string of the application or package, for package managers that "
9937 "use this.  If unavailable this is returned as an empty string C<\"\">."
9938 msgstr ""
9939
9940 #. type: =item
9941 #: ../src/guestfs-actions.pod:2974 ../fish/guestfish-actions.pod:2063
9942 msgid "C<app_install_path>"
9943 msgstr ""
9944
9945 #. type: textblock
9946 #: ../src/guestfs-actions.pod:2976 ../fish/guestfish-actions.pod:2065
9947 msgid ""
9948 "The installation path of the application (on operating systems such as "
9949 "Windows which use installation paths).  This path is in the format used by "
9950 "the guest operating system, it is not a libguestfs path."
9951 msgstr ""
9952
9953 #. type: textblock
9954 #: ../src/guestfs-actions.pod:2981 ../fish/guestfish-actions.pod:2070
9955 msgid "If unavailable this is returned as an empty string C<\"\">."
9956 msgstr ""
9957
9958 #. type: =item
9959 #: ../src/guestfs-actions.pod:2983 ../fish/guestfish-actions.pod:2072
9960 msgid "C<app_trans_path>"
9961 msgstr ""
9962
9963 #. type: textblock
9964 #: ../src/guestfs-actions.pod:2985 ../fish/guestfish-actions.pod:2074
9965 msgid ""
9966 "The install path translated into a libguestfs path.  If unavailable this is "
9967 "returned as an empty string C<\"\">."
9968 msgstr ""
9969
9970 #. type: =item
9971 #: ../src/guestfs-actions.pod:2988 ../fish/guestfish-actions.pod:2077
9972 msgid "C<app_publisher>"
9973 msgstr ""
9974
9975 #. type: textblock
9976 #: ../src/guestfs-actions.pod:2990 ../fish/guestfish-actions.pod:2079
9977 msgid ""
9978 "The name of the publisher of the application, for package managers that use "
9979 "this.  If unavailable this is returned as an empty string C<\"\">."
9980 msgstr ""
9981
9982 #. type: =item
9983 #: ../src/guestfs-actions.pod:2994 ../fish/guestfish-actions.pod:2083
9984 msgid "C<app_url>"
9985 msgstr ""
9986
9987 #. type: textblock
9988 #: ../src/guestfs-actions.pod:2996 ../fish/guestfish-actions.pod:2085
9989 msgid ""
9990 "The URL (eg. upstream URL) of the application.  If unavailable this is "
9991 "returned as an empty string C<\"\">."
9992 msgstr ""
9993
9994 #. type: =item
9995 #: ../src/guestfs-actions.pod:2999 ../fish/guestfish-actions.pod:2088
9996 msgid "C<app_source_package>"
9997 msgstr ""
9998
9999 #. type: textblock
10000 #: ../src/guestfs-actions.pod:3001 ../fish/guestfish-actions.pod:2090
10001 msgid ""
10002 "For packaging systems which support this, the name of the source package.  "
10003 "If unavailable this is returned as an empty string C<\"\">."
10004 msgstr ""
10005
10006 #. type: =item
10007 #: ../src/guestfs-actions.pod:3004 ../fish/guestfish-actions.pod:2093
10008 msgid "C<app_summary>"
10009 msgstr ""
10010
10011 #. type: textblock
10012 #: ../src/guestfs-actions.pod:3006 ../fish/guestfish-actions.pod:2095
10013 msgid ""
10014 "A short (usually one line) description of the application or package.  If "
10015 "unavailable this is returned as an empty string C<\"\">."
10016 msgstr ""
10017
10018 #. type: =item
10019 #: ../src/guestfs-actions.pod:3009 ../fish/guestfish-actions.pod:2098
10020 msgid "C<app_description>"
10021 msgstr ""
10022
10023 #. type: textblock
10024 #: ../src/guestfs-actions.pod:3011 ../fish/guestfish-actions.pod:2100
10025 msgid ""
10026 "A longer description of the application or package.  If unavailable this is "
10027 "returned as an empty string C<\"\">."
10028 msgstr ""
10029
10030 #. type: textblock
10031 #: ../src/guestfs-actions.pod:3018
10032 msgid ""
10033 "This function returns a C<struct guestfs_application_list *>, or NULL if "
10034 "there was an error.  I<The caller must call C<guestfs_free_application_list> "
10035 "after use>."
10036 msgstr ""
10037
10038 #. type: textblock
10039 #: ../src/guestfs-actions.pod:3022
10040 msgid "(Added in 1.7.8)"
10041 msgstr ""
10042
10043 #. type: =head2
10044 #: ../src/guestfs-actions.pod:3024
10045 msgid "guestfs_inspect_os"
10046 msgstr ""
10047
10048 #. type: verbatim
10049 #: ../src/guestfs-actions.pod:3026
10050 #, no-wrap
10051 msgid ""
10052 " char **\n"
10053 " guestfs_inspect_os (guestfs_h *g);\n"
10054 "\n"
10055 msgstr ""
10056
10057 #. type: textblock
10058 #: ../src/guestfs-actions.pod:3029 ../fish/guestfish-actions.pod:2111
10059 msgid ""
10060 "This function uses other libguestfs functions and certain heuristics to "
10061 "inspect the disk(s) (usually disks belonging to a virtual machine), looking "
10062 "for operating systems."
10063 msgstr ""
10064
10065 #. type: textblock
10066 #: ../src/guestfs-actions.pod:3033 ../fish/guestfish-actions.pod:2115
10067 msgid "The list returned is empty if no operating systems were found."
10068 msgstr ""
10069
10070 #. type: textblock
10071 #: ../src/guestfs-actions.pod:3035 ../fish/guestfish-actions.pod:2117
10072 msgid ""
10073 "If one operating system was found, then this returns a list with a single "
10074 "element, which is the name of the root filesystem of this operating system.  "
10075 "It is also possible for this function to return a list containing more than "
10076 "one element, indicating a dual-boot or multi-boot virtual machine, with each "
10077 "element being the root filesystem of one of the operating systems."
10078 msgstr ""
10079
10080 #. type: textblock
10081 #: ../src/guestfs-actions.pod:3042
10082 msgid ""
10083 "You can pass the root string(s) returned to other C<guestfs_inspect_get_*> "
10084 "functions in order to query further information about each operating system, "
10085 "such as the name and version."
10086 msgstr ""
10087
10088 #. type: textblock
10089 #: ../src/guestfs-actions.pod:3047
10090 msgid ""
10091 "This function uses other libguestfs features such as C<guestfs_mount_ro> and "
10092 "C<guestfs_umount_all> in order to mount and unmount filesystems and look at "
10093 "the contents.  This should be called with no disks currently mounted.  The "
10094 "function may also use Augeas, so any existing Augeas handle will be closed."
10095 msgstr ""
10096
10097 #. type: textblock
10098 #: ../src/guestfs-actions.pod:3053 ../fish/guestfish-actions.pod:2135
10099 msgid ""
10100 "This function cannot decrypt encrypted disks.  The caller must do that first "
10101 "(supplying the necessary keys) if the disk is encrypted."
10102 msgstr ""
10103
10104 #. type: textblock
10105 #: ../src/guestfs-actions.pod:3059 ../src/guestfs-actions.pod:3344 ../src/guestfs-actions.pod:3406
10106 msgid "See also C<guestfs_list_filesystems>."
10107 msgstr ""
10108
10109 #. type: =head2
10110 #: ../src/guestfs-actions.pod:3067
10111 msgid "guestfs_is_blockdev"
10112 msgstr ""
10113
10114 #. type: verbatim
10115 #: ../src/guestfs-actions.pod:3069
10116 #, no-wrap
10117 msgid ""
10118 " int\n"
10119 " guestfs_is_blockdev (guestfs_h *g,\n"
10120 "                      const char *path);\n"
10121 "\n"
10122 msgstr ""
10123
10124 #. type: textblock
10125 #: ../src/guestfs-actions.pod:3073 ../fish/guestfish-actions.pod:2147
10126 msgid ""
10127 "This returns C<true> if and only if there is a block device with the given "
10128 "C<path> name."
10129 msgstr ""
10130
10131 #. type: textblock
10132 #: ../src/guestfs-actions.pod:3076 ../src/guestfs-actions.pod:3105 ../src/guestfs-actions.pod:3135 ../src/guestfs-actions.pod:3150 ../src/guestfs-actions.pod:3166 ../src/guestfs-actions.pod:3222 ../src/guestfs-actions.pod:3237
10133 msgid "See also C<guestfs_stat>."
10134 msgstr ""
10135
10136 #. type: textblock
10137 #: ../src/guestfs-actions.pod:3080 ../src/guestfs-actions.pod:3109 ../src/guestfs-actions.pod:3154 ../src/guestfs-actions.pod:3226 ../src/guestfs-actions.pod:3241
10138 msgid "(Added in 1.5.10)"
10139 msgstr ""
10140
10141 #. type: =head2
10142 #: ../src/guestfs-actions.pod:3082
10143 msgid "guestfs_is_busy"
10144 msgstr ""
10145
10146 #. type: verbatim
10147 #: ../src/guestfs-actions.pod:3084
10148 #, no-wrap
10149 msgid ""
10150 " int\n"
10151 " guestfs_is_busy (guestfs_h *g);\n"
10152 "\n"
10153 msgstr ""
10154
10155 #. type: textblock
10156 #: ../src/guestfs-actions.pod:3087 ../fish/guestfish-actions.pod:2156
10157 msgid ""
10158 "This returns true iff this handle is busy processing a command (in the "
10159 "C<BUSY> state)."
10160 msgstr ""
10161
10162 #. type: =head2
10163 #: ../src/guestfs-actions.pod:3096
10164 msgid "guestfs_is_chardev"
10165 msgstr ""
10166
10167 #. type: verbatim
10168 #: ../src/guestfs-actions.pod:3098
10169 #, no-wrap
10170 msgid ""
10171 " int\n"
10172 " guestfs_is_chardev (guestfs_h *g,\n"
10173 "                     const char *path);\n"
10174 "\n"
10175 msgstr ""
10176
10177 #. type: textblock
10178 #: ../src/guestfs-actions.pod:3102 ../fish/guestfish-actions.pod:2165
10179 msgid ""
10180 "This returns C<true> if and only if there is a character device with the "
10181 "given C<path> name."
10182 msgstr ""
10183
10184 #. type: =head2
10185 #: ../src/guestfs-actions.pod:3111
10186 msgid "guestfs_is_config"
10187 msgstr ""
10188
10189 #. type: verbatim
10190 #: ../src/guestfs-actions.pod:3113
10191 #, no-wrap
10192 msgid ""
10193 " int\n"
10194 " guestfs_is_config (guestfs_h *g);\n"
10195 "\n"
10196 msgstr ""
10197
10198 #. type: textblock
10199 #: ../src/guestfs-actions.pod:3116 ../fish/guestfish-actions.pod:2174
10200 msgid ""
10201 "This returns true iff this handle is being configured (in the C<CONFIG> "
10202 "state)."
10203 msgstr ""
10204
10205 #. type: =head2
10206 #: ../src/guestfs-actions.pod:3125
10207 msgid "guestfs_is_dir"
10208 msgstr ""
10209
10210 #. type: verbatim
10211 #: ../src/guestfs-actions.pod:3127
10212 #, no-wrap
10213 msgid ""
10214 " int\n"
10215 " guestfs_is_dir (guestfs_h *g,\n"
10216 "                 const char *path);\n"
10217 "\n"
10218 msgstr ""
10219
10220 #. type: textblock
10221 #: ../src/guestfs-actions.pod:3131 ../fish/guestfish-actions.pod:2183
10222 msgid ""
10223 "This returns C<true> if and only if there is a directory with the given "
10224 "C<path> name.  Note that it returns false for other objects like files."
10225 msgstr ""
10226
10227 #. type: =head2
10228 #: ../src/guestfs-actions.pod:3141
10229 msgid "guestfs_is_fifo"
10230 msgstr ""
10231
10232 #. type: verbatim
10233 #: ../src/guestfs-actions.pod:3143
10234 #, no-wrap
10235 msgid ""
10236 " int\n"
10237 " guestfs_is_fifo (guestfs_h *g,\n"
10238 "                  const char *path);\n"
10239 "\n"
10240 msgstr ""
10241
10242 #. type: textblock
10243 #: ../src/guestfs-actions.pod:3147 ../fish/guestfish-actions.pod:2193
10244 msgid ""
10245 "This returns C<true> if and only if there is a FIFO (named pipe)  with the "
10246 "given C<path> name."
10247 msgstr ""
10248
10249 #. type: =head2
10250 #: ../src/guestfs-actions.pod:3156
10251 msgid "guestfs_is_file"
10252 msgstr ""
10253
10254 #. type: verbatim
10255 #: ../src/guestfs-actions.pod:3158
10256 #, no-wrap
10257 msgid ""
10258 " int\n"
10259 " guestfs_is_file (guestfs_h *g,\n"
10260 "                  const char *path);\n"
10261 "\n"
10262 msgstr ""
10263
10264 #. type: textblock
10265 #: ../src/guestfs-actions.pod:3162 ../fish/guestfish-actions.pod:2202
10266 msgid ""
10267 "This returns C<true> if and only if there is a regular file with the given "
10268 "C<path> name.  Note that it returns false for other objects like "
10269 "directories."
10270 msgstr ""
10271
10272 #. type: =head2
10273 #: ../src/guestfs-actions.pod:3172
10274 msgid "guestfs_is_launching"
10275 msgstr ""
10276
10277 #. type: verbatim
10278 #: ../src/guestfs-actions.pod:3174
10279 #, no-wrap
10280 msgid ""
10281 " int\n"
10282 " guestfs_is_launching (guestfs_h *g);\n"
10283 "\n"
10284 msgstr ""
10285
10286 #. type: textblock
10287 #: ../src/guestfs-actions.pod:3177 ../fish/guestfish-actions.pod:2212
10288 msgid ""
10289 "This returns true iff this handle is launching the subprocess (in the "
10290 "C<LAUNCHING> state)."
10291 msgstr ""
10292
10293 #. type: =head2
10294 #: ../src/guestfs-actions.pod:3186
10295 msgid "guestfs_is_lv"
10296 msgstr ""
10297
10298 #. type: verbatim
10299 #: ../src/guestfs-actions.pod:3188
10300 #, no-wrap
10301 msgid ""
10302 " int\n"
10303 " guestfs_is_lv (guestfs_h *g,\n"
10304 "                const char *device);\n"
10305 "\n"
10306 msgstr ""
10307
10308 #. type: textblock
10309 #: ../src/guestfs-actions.pod:3192 ../fish/guestfish-actions.pod:2221
10310 msgid ""
10311 "This command tests whether C<device> is a logical volume, and returns true "
10312 "iff this is the case."
10313 msgstr ""
10314
10315 #. type: =head2
10316 #: ../src/guestfs-actions.pod:3199
10317 msgid "guestfs_is_ready"
10318 msgstr ""
10319
10320 #. type: verbatim
10321 #: ../src/guestfs-actions.pod:3201
10322 #, no-wrap
10323 msgid ""
10324 " int\n"
10325 " guestfs_is_ready (guestfs_h *g);\n"
10326 "\n"
10327 msgstr ""
10328
10329 #. type: textblock
10330 #: ../src/guestfs-actions.pod:3204 ../fish/guestfish-actions.pod:2228
10331 msgid ""
10332 "This returns true iff this handle is ready to accept commands (in the "
10333 "C<READY> state)."
10334 msgstr ""
10335
10336 #. type: =head2
10337 #: ../src/guestfs-actions.pod:3213
10338 msgid "guestfs_is_socket"
10339 msgstr ""
10340
10341 #. type: verbatim
10342 #: ../src/guestfs-actions.pod:3215
10343 #, no-wrap
10344 msgid ""
10345 " int\n"
10346 " guestfs_is_socket (guestfs_h *g,\n"
10347 "                    const char *path);\n"
10348 "\n"
10349 msgstr ""
10350
10351 #. type: textblock
10352 #: ../src/guestfs-actions.pod:3219 ../fish/guestfish-actions.pod:2237
10353 msgid ""
10354 "This returns C<true> if and only if there is a Unix domain socket with the "
10355 "given C<path> name."
10356 msgstr ""
10357
10358 #. type: =head2
10359 #: ../src/guestfs-actions.pod:3228
10360 msgid "guestfs_is_symlink"
10361 msgstr ""
10362
10363 #. type: verbatim
10364 #: ../src/guestfs-actions.pod:3230
10365 #, no-wrap
10366 msgid ""
10367 " int\n"
10368 " guestfs_is_symlink (guestfs_h *g,\n"
10369 "                     const char *path);\n"
10370 "\n"
10371 msgstr ""
10372
10373 #. type: textblock
10374 #: ../src/guestfs-actions.pod:3234 ../fish/guestfish-actions.pod:2246
10375 msgid ""
10376 "This returns C<true> if and only if there is a symbolic link with the given "
10377 "C<path> name."
10378 msgstr ""
10379
10380 #. type: =head2
10381 #: ../src/guestfs-actions.pod:3243
10382 msgid "guestfs_kill_subprocess"
10383 msgstr ""
10384
10385 #. type: verbatim
10386 #: ../src/guestfs-actions.pod:3245
10387 #, no-wrap
10388 msgid ""
10389 " int\n"
10390 " guestfs_kill_subprocess (guestfs_h *g);\n"
10391 "\n"
10392 msgstr ""
10393
10394 #. type: textblock
10395 #: ../src/guestfs-actions.pod:3248 ../fish/guestfish-actions.pod:2255
10396 msgid "This kills the qemu subprocess.  You should never need to call this."
10397 msgstr ""
10398
10399 #. type: =head2
10400 #: ../src/guestfs-actions.pod:3254
10401 msgid "guestfs_launch"
10402 msgstr ""
10403
10404 #. type: verbatim
10405 #: ../src/guestfs-actions.pod:3256
10406 #, no-wrap
10407 msgid ""
10408 " int\n"
10409 " guestfs_launch (guestfs_h *g);\n"
10410 "\n"
10411 msgstr ""
10412
10413 #. type: textblock
10414 #: ../src/guestfs-actions.pod:3259 ../fish/guestfish-actions.pod:2263
10415 msgid ""
10416 "Internally libguestfs is implemented by running a virtual machine using "
10417 "L<qemu(1)>."
10418 msgstr ""
10419
10420 #. type: textblock
10421 #: ../src/guestfs-actions.pod:3262 ../fish/guestfish-actions.pod:2266
10422 msgid ""
10423 "You should call this after configuring the handle (eg. adding drives) but "
10424 "before performing any actions."
10425 msgstr ""
10426
10427 #. type: =head2
10428 #: ../src/guestfs-actions.pod:3269
10429 msgid "guestfs_lchown"
10430 msgstr ""
10431
10432 #. type: verbatim
10433 #: ../src/guestfs-actions.pod:3271
10434 #, no-wrap
10435 msgid ""
10436 " int\n"
10437 " guestfs_lchown (guestfs_h *g,\n"
10438 "                 int owner,\n"
10439 "                 int group,\n"
10440 "                 const char *path);\n"
10441 "\n"
10442 msgstr ""
10443
10444 #. type: textblock
10445 #: ../src/guestfs-actions.pod:3277
10446 msgid ""
10447 "Change the file owner to C<owner> and group to C<group>.  This is like "
10448 "C<guestfs_chown> but if C<path> is a symlink then the link itself is "
10449 "changed, not the target."
10450 msgstr ""
10451
10452 #. type: =head2
10453 #: ../src/guestfs-actions.pod:3289
10454 msgid "guestfs_lgetxattr"
10455 msgstr ""
10456
10457 #. type: verbatim
10458 #: ../src/guestfs-actions.pod:3291
10459 #, no-wrap
10460 msgid ""
10461 " char *\n"
10462 " guestfs_lgetxattr (guestfs_h *g,\n"
10463 "                    const char *path,\n"
10464 "                    const char *name,\n"
10465 "                    size_t *size_r);\n"
10466 "\n"
10467 msgstr ""
10468
10469 #. type: textblock
10470 #: ../src/guestfs-actions.pod:3297 ../fish/guestfish-actions.pod:2285
10471 msgid ""
10472 "Get a single extended attribute from file C<path> named C<name>.  If C<path> "
10473 "is a symlink, then this call returns an extended attribute from the symlink."
10474 msgstr ""
10475
10476 #. type: textblock
10477 #: ../src/guestfs-actions.pod:3311
10478 msgid "See also: C<guestfs_lgetxattrs>, C<guestfs_getxattr>, L<attr(5)>."
10479 msgstr ""
10480
10481 #. type: =head2
10482 #: ../src/guestfs-actions.pod:3319
10483 msgid "guestfs_lgetxattrs"
10484 msgstr ""
10485
10486 #. type: verbatim
10487 #: ../src/guestfs-actions.pod:3321
10488 #, no-wrap
10489 msgid ""
10490 " struct guestfs_xattr_list *\n"
10491 " guestfs_lgetxattrs (guestfs_h *g,\n"
10492 "                     const char *path);\n"
10493 "\n"
10494 msgstr ""
10495
10496 #. type: textblock
10497 #: ../src/guestfs-actions.pod:3325
10498 msgid ""
10499 "This is the same as C<guestfs_getxattrs>, but if C<path> is a symbolic link, "
10500 "then it returns the extended attributes of the link itself."
10501 msgstr ""
10502
10503 #. type: =head2
10504 #: ../src/guestfs-actions.pod:3335
10505 msgid "guestfs_list_devices"
10506 msgstr ""
10507
10508 #. type: verbatim
10509 #: ../src/guestfs-actions.pod:3337
10510 #, no-wrap
10511 msgid ""
10512 " char **\n"
10513 " guestfs_list_devices (guestfs_h *g);\n"
10514 "\n"
10515 msgstr ""
10516
10517 #. type: textblock
10518 #: ../src/guestfs-actions.pod:3340 ../fish/guestfish-actions.pod:2313
10519 msgid "List all the block devices."
10520 msgstr ""
10521
10522 #. type: textblock
10523 #: ../src/guestfs-actions.pod:3342 ../fish/guestfish-actions.pod:2315
10524 msgid "The full block device names are returned, eg. C</dev/sda>."
10525 msgstr ""
10526
10527 #. type: =head2
10528 #: ../src/guestfs-actions.pod:3352
10529 msgid "guestfs_list_filesystems"
10530 msgstr ""
10531
10532 #. type: verbatim
10533 #: ../src/guestfs-actions.pod:3354
10534 #, no-wrap
10535 msgid ""
10536 " char **\n"
10537 " guestfs_list_filesystems (guestfs_h *g);\n"
10538 "\n"
10539 msgstr ""
10540
10541 #. type: textblock
10542 #: ../src/guestfs-actions.pod:3357 ../fish/guestfish-actions.pod:2323
10543 msgid ""
10544 "This inspection command looks for filesystems on partitions, block devices "
10545 "and logical volumes, returning a list of devices containing filesystems and "
10546 "their type."
10547 msgstr ""
10548
10549 #. type: textblock
10550 #: ../src/guestfs-actions.pod:3361 ../fish/guestfish-actions.pod:2327
10551 msgid ""
10552 "The return value is a hash, where the keys are the devices containing "
10553 "filesystems, and the values are the filesystem types.  For example:"
10554 msgstr ""
10555
10556 #. type: verbatim
10557 #: ../src/guestfs-actions.pod:3365 ../fish/guestfish-actions.pod:2331
10558 #, no-wrap
10559 msgid ""
10560 " \"/dev/sda1\" => \"ntfs\"\n"
10561 " \"/dev/sda2\" => \"ext2\"\n"
10562 " \"/dev/vg_guest/lv_root\" => \"ext4\"\n"
10563 " \"/dev/vg_guest/lv_swap\" => \"swap\"\n"
10564 "\n"
10565 msgstr ""
10566
10567 #. type: textblock
10568 #: ../src/guestfs-actions.pod:3370 ../fish/guestfish-actions.pod:2336
10569 msgid ""
10570 "The value can have the special value \"unknown\", meaning the content of the "
10571 "device is undetermined or empty.  \"swap\" means a Linux swap partition."
10572 msgstr ""
10573
10574 #. type: textblock
10575 #: ../src/guestfs-actions.pod:3374
10576 msgid ""
10577 "This command runs other libguestfs commands, which might include "
10578 "C<guestfs_mount> and C<guestfs_umount>, and therefore you should use this "
10579 "soon after launch and only when nothing is mounted."
10580 msgstr ""
10581
10582 #. type: textblock
10583 #: ../src/guestfs-actions.pod:3378
10584 msgid ""
10585 "Not all of the filesystems returned will be mountable.  In particular, swap "
10586 "partitions are returned in the list.  Also this command does not check that "
10587 "each filesystem found is valid and mountable, and some filesystems might be "
10588 "mountable but require special options.  Filesystems may not all belong to a "
10589 "single logical operating system (use C<guestfs_inspect_os> to look for "
10590 "OSes)."
10591 msgstr ""
10592
10593 #. type: textblock
10594 #: ../src/guestfs-actions.pod:3392 ../src/guestfs-actions.pod:4994
10595 msgid "(Added in 1.5.15)"
10596 msgstr ""
10597
10598 #. type: =head2
10599 #: ../src/guestfs-actions.pod:3394
10600 msgid "guestfs_list_partitions"
10601 msgstr ""
10602
10603 #. type: verbatim
10604 #: ../src/guestfs-actions.pod:3396
10605 #, no-wrap
10606 msgid ""
10607 " char **\n"
10608 " guestfs_list_partitions (guestfs_h *g);\n"
10609 "\n"
10610 msgstr ""
10611
10612 #. type: textblock
10613 #: ../src/guestfs-actions.pod:3399 ../fish/guestfish-actions.pod:2356
10614 msgid "List all the partitions detected on all block devices."
10615 msgstr ""
10616
10617 #. type: textblock
10618 #: ../src/guestfs-actions.pod:3401 ../fish/guestfish-actions.pod:2358
10619 msgid "The full partition device names are returned, eg. C</dev/sda1>"
10620 msgstr ""
10621
10622 #. type: textblock
10623 #: ../src/guestfs-actions.pod:3403
10624 msgid ""
10625 "This does not return logical volumes.  For that you will need to call "
10626 "C<guestfs_lvs>."
10627 msgstr ""
10628
10629 #. type: =head2
10630 #: ../src/guestfs-actions.pod:3414
10631 msgid "guestfs_ll"
10632 msgstr ""
10633
10634 #. type: verbatim
10635 #: ../src/guestfs-actions.pod:3416
10636 #, no-wrap
10637 msgid ""
10638 " char *\n"
10639 " guestfs_ll (guestfs_h *g,\n"
10640 "             const char *directory);\n"
10641 "\n"
10642 msgstr ""
10643
10644 #. type: textblock
10645 #: ../src/guestfs-actions.pod:3420 ../fish/guestfish-actions.pod:2369
10646 msgid ""
10647 "List the files in C<directory> (relative to the root directory, there is no "
10648 "cwd) in the format of 'ls -la'."
10649 msgstr ""
10650
10651 #. type: textblock
10652 #: ../src/guestfs-actions.pod:3423 ../fish/guestfish-actions.pod:2372
10653 msgid ""
10654 "This command is mostly useful for interactive sessions.  It is I<not> "
10655 "intended that you try to parse the output string."
10656 msgstr ""
10657
10658 #. type: =head2
10659 #: ../src/guestfs-actions.pod:3431
10660 msgid "guestfs_ln"
10661 msgstr ""
10662
10663 #. type: verbatim
10664 #: ../src/guestfs-actions.pod:3433
10665 #, no-wrap
10666 msgid ""
10667 " int\n"
10668 " guestfs_ln (guestfs_h *g,\n"
10669 "             const char *target,\n"
10670 "             const char *linkname);\n"
10671 "\n"
10672 msgstr ""
10673
10674 #. type: textblock
10675 #: ../src/guestfs-actions.pod:3438 ../fish/guestfish-actions.pod:2379
10676 msgid "This command creates a hard link using the C<ln> command."
10677 msgstr ""
10678
10679 #. type: =head2
10680 #: ../src/guestfs-actions.pod:3444
10681 msgid "guestfs_ln_f"
10682 msgstr ""
10683
10684 #. type: verbatim
10685 #: ../src/guestfs-actions.pod:3446
10686 #, no-wrap
10687 msgid ""
10688 " int\n"
10689 " guestfs_ln_f (guestfs_h *g,\n"
10690 "               const char *target,\n"
10691 "               const char *linkname);\n"
10692 "\n"
10693 msgstr ""
10694
10695 #. type: textblock
10696 #: ../src/guestfs-actions.pod:3451 ../fish/guestfish-actions.pod:2385
10697 msgid ""
10698 "This command creates a hard link using the C<ln -f> command.  The C<-f> "
10699 "option removes the link (C<linkname>) if it exists already."
10700 msgstr ""
10701
10702 #. type: =head2
10703 #: ../src/guestfs-actions.pod:3458
10704 msgid "guestfs_ln_s"
10705 msgstr ""
10706
10707 #. type: verbatim
10708 #: ../src/guestfs-actions.pod:3460
10709 #, no-wrap
10710 msgid ""
10711 " int\n"
10712 " guestfs_ln_s (guestfs_h *g,\n"
10713 "               const char *target,\n"
10714 "               const char *linkname);\n"
10715 "\n"
10716 msgstr ""
10717
10718 #. type: textblock
10719 #: ../src/guestfs-actions.pod:3465 ../fish/guestfish-actions.pod:2392
10720 msgid "This command creates a symbolic link using the C<ln -s> command."
10721 msgstr ""
10722
10723 #. type: =head2
10724 #: ../src/guestfs-actions.pod:3471
10725 msgid "guestfs_ln_sf"
10726 msgstr ""
10727
10728 #. type: verbatim
10729 #: ../src/guestfs-actions.pod:3473
10730 #, no-wrap
10731 msgid ""
10732 " int\n"
10733 " guestfs_ln_sf (guestfs_h *g,\n"
10734 "                const char *target,\n"
10735 "                const char *linkname);\n"
10736 "\n"
10737 msgstr ""
10738
10739 #. type: textblock
10740 #: ../src/guestfs-actions.pod:3478 ../fish/guestfish-actions.pod:2398
10741 msgid ""
10742 "This command creates a symbolic link using the C<ln -sf> command, The C<-f> "
10743 "option removes the link (C<linkname>) if it exists already."
10744 msgstr ""
10745
10746 #. type: =head2
10747 #: ../src/guestfs-actions.pod:3485
10748 msgid "guestfs_lremovexattr"
10749 msgstr ""
10750
10751 #. type: verbatim
10752 #: ../src/guestfs-actions.pod:3487
10753 #, no-wrap
10754 msgid ""
10755 " int\n"
10756 " guestfs_lremovexattr (guestfs_h *g,\n"
10757 "                       const char *xattr,\n"
10758 "                       const char *path);\n"
10759 "\n"
10760 msgstr ""
10761
10762 #. type: textblock
10763 #: ../src/guestfs-actions.pod:3492
10764 msgid ""
10765 "This is the same as C<guestfs_removexattr>, but if C<path> is a symbolic "
10766 "link, then it removes an extended attribute of the link itself."
10767 msgstr ""
10768
10769 #. type: =head2
10770 #: ../src/guestfs-actions.pod:3500
10771 msgid "guestfs_ls"
10772 msgstr ""
10773
10774 #. type: verbatim
10775 #: ../src/guestfs-actions.pod:3502
10776 #, no-wrap
10777 msgid ""
10778 " char **\n"
10779 " guestfs_ls (guestfs_h *g,\n"
10780 "             const char *directory);\n"
10781 "\n"
10782 msgstr ""
10783
10784 #. type: textblock
10785 #: ../src/guestfs-actions.pod:3506 ../fish/guestfish-actions.pod:2413
10786 msgid ""
10787 "List the files in C<directory> (relative to the root directory, there is no "
10788 "cwd).  The '.' and '..' entries are not returned, but hidden files are "
10789 "shown."
10790 msgstr ""
10791
10792 #. type: textblock
10793 #: ../src/guestfs-actions.pod:3510
10794 msgid ""
10795 "This command is mostly useful for interactive sessions.  Programs should "
10796 "probably use C<guestfs_readdir> instead."
10797 msgstr ""
10798
10799 #. type: =head2
10800 #: ../src/guestfs-actions.pod:3519
10801 msgid "guestfs_lsetxattr"
10802 msgstr ""
10803
10804 #. type: verbatim
10805 #: ../src/guestfs-actions.pod:3521
10806 #, no-wrap
10807 msgid ""
10808 " int\n"
10809 " guestfs_lsetxattr (guestfs_h *g,\n"
10810 "                    const char *xattr,\n"
10811 "                    const char *val,\n"
10812 "                    int vallen,\n"
10813 "                    const char *path);\n"
10814 "\n"
10815 msgstr ""
10816
10817 #. type: textblock
10818 #: ../src/guestfs-actions.pod:3528
10819 msgid ""
10820 "This is the same as C<guestfs_setxattr>, but if C<path> is a symbolic link, "
10821 "then it sets an extended attribute of the link itself."
10822 msgstr ""
10823
10824 #. type: =head2
10825 #: ../src/guestfs-actions.pod:3536
10826 msgid "guestfs_lstat"
10827 msgstr ""
10828
10829 #. type: verbatim
10830 #: ../src/guestfs-actions.pod:3538
10831 #, no-wrap
10832 msgid ""
10833 " struct guestfs_stat *\n"
10834 " guestfs_lstat (guestfs_h *g,\n"
10835 "                const char *path);\n"
10836 "\n"
10837 msgstr ""
10838
10839 #. type: textblock
10840 #: ../src/guestfs-actions.pod:3542 ../src/guestfs-actions.pod:6048 ../fish/guestfish-actions.pod:2432 ../fish/guestfish-actions.pod:4056
10841 msgid "Returns file information for the given C<path>."
10842 msgstr ""
10843
10844 #. type: textblock
10845 #: ../src/guestfs-actions.pod:3544
10846 msgid ""
10847 "This is the same as C<guestfs_stat> except that if C<path> is a symbolic "
10848 "link, then the link is stat-ed, not the file it refers to."
10849 msgstr ""
10850
10851 #. type: textblock
10852 #: ../src/guestfs-actions.pod:3548 ../fish/guestfish-actions.pod:2438
10853 msgid "This is the same as the C<lstat(2)> system call."
10854 msgstr ""
10855
10856 #. type: textblock
10857 #: ../src/guestfs-actions.pod:3550 ../src/guestfs-actions.pod:6052
10858 msgid ""
10859 "This function returns a C<struct guestfs_stat *>, or NULL if there was an "
10860 "error.  I<The caller must call C<guestfs_free_stat> after use>."
10861 msgstr ""
10862
10863 #. type: textblock
10864 #: ../src/guestfs-actions.pod:3554 ../src/guestfs-actions.pod:6056 ../src/guestfs-actions.pod:6074 ../src/guestfs-actions.pod:6455
10865 msgid "(Added in 0.9.2)"
10866 msgstr ""
10867
10868 #. type: =head2
10869 #: ../src/guestfs-actions.pod:3556
10870 msgid "guestfs_lstatlist"
10871 msgstr ""
10872
10873 #. type: verbatim
10874 #: ../src/guestfs-actions.pod:3558
10875 #, no-wrap
10876 msgid ""
10877 " struct guestfs_stat_list *\n"
10878 " guestfs_lstatlist (guestfs_h *g,\n"
10879 "                    const char *path,\n"
10880 "                    char *const *names);\n"
10881 "\n"
10882 msgstr ""
10883
10884 #. type: textblock
10885 #: ../src/guestfs-actions.pod:3563
10886 msgid ""
10887 "This call allows you to perform the C<guestfs_lstat> operation on multiple "
10888 "files, where all files are in the directory C<path>.  C<names> is the list "
10889 "of files from this directory."
10890 msgstr ""
10891
10892 #. type: textblock
10893 #: ../src/guestfs-actions.pod:3567 ../fish/guestfish-actions.pod:2448
10894 msgid ""
10895 "On return you get a list of stat structs, with a one-to-one correspondence "
10896 "to the C<names> list.  If any name did not exist or could not be lstat'd, "
10897 "then the C<ino> field of that structure is set to C<-1>."
10898 msgstr ""
10899
10900 #. type: textblock
10901 #: ../src/guestfs-actions.pod:3572
10902 msgid ""
10903 "This call is intended for programs that want to efficiently list a directory "
10904 "contents without making many round-trips.  See also C<guestfs_lxattrlist> "
10905 "for a similarly efficient call for getting extended attributes.  Very long "
10906 "directory listings might cause the protocol message size to be exceeded, "
10907 "causing this call to fail.  The caller must split up such requests into "
10908 "smaller groups of names."
10909 msgstr ""
10910
10911 #. type: textblock
10912 #: ../src/guestfs-actions.pod:3580
10913 msgid ""
10914 "This function returns a C<struct guestfs_stat_list *>, or NULL if there was "
10915 "an error.  I<The caller must call C<guestfs_free_stat_list> after use>."
10916 msgstr ""
10917
10918 #. type: =head2
10919 #: ../src/guestfs-actions.pod:3586
10920 msgid "guestfs_luks_add_key"
10921 msgstr ""
10922
10923 #. type: verbatim
10924 #: ../src/guestfs-actions.pod:3588
10925 #, no-wrap
10926 msgid ""
10927 " int\n"
10928 " guestfs_luks_add_key (guestfs_h *g,\n"
10929 "                       const char *device,\n"
10930 "                       const char *key,\n"
10931 "                       const char *newkey,\n"
10932 "                       int keyslot);\n"
10933 "\n"
10934 msgstr ""
10935
10936 #. type: textblock
10937 #: ../src/guestfs-actions.pod:3595 ../fish/guestfish-actions.pod:2465
10938 msgid ""
10939 "This command adds a new key on LUKS device C<device>.  C<key> is any "
10940 "existing key, and is used to access the device.  C<newkey> is the new key to "
10941 "add.  C<keyslot> is the key slot that will be replaced."
10942 msgstr ""
10943
10944 #. type: textblock
10945 #: ../src/guestfs-actions.pod:3600
10946 msgid ""
10947 "Note that if C<keyslot> already contains a key, then this command will "
10948 "fail.  You have to use C<guestfs_luks_kill_slot> first to remove that key."
10949 msgstr ""
10950
10951 #. type: textblock
10952 #: ../src/guestfs-actions.pod:3606 ../src/guestfs-actions.pod:3646 ../src/guestfs-actions.pod:3669 ../src/guestfs-actions.pod:3689 ../src/guestfs-actions.pod:3721 ../src/guestfs-actions.pod:3740
10953 msgid ""
10954 "This function takes a key or passphrase parameter which could contain "
10955 "sensitive material.  Read the section L</KEYS AND PASSPHRASES> for more "
10956 "information."
10957 msgstr ""
10958
10959 #. type: textblock
10960 #: ../src/guestfs-actions.pod:3610 ../src/guestfs-actions.pod:3650 ../src/guestfs-actions.pod:3673 ../src/guestfs-actions.pod:3693
10961 msgid "(Added in 1.5.2)"
10962 msgstr ""
10963
10964 #. type: =head2
10965 #: ../src/guestfs-actions.pod:3612
10966 msgid "guestfs_luks_close"
10967 msgstr ""
10968
10969 #. type: verbatim
10970 #: ../src/guestfs-actions.pod:3614
10971 #, no-wrap
10972 msgid ""
10973 " int\n"
10974 " guestfs_luks_close (guestfs_h *g,\n"
10975 "                     const char *device);\n"
10976 "\n"
10977 msgstr ""
10978
10979 #. type: textblock
10980 #: ../src/guestfs-actions.pod:3618
10981 msgid ""
10982 "This closes a LUKS device that was created earlier by C<guestfs_luks_open> "
10983 "or C<guestfs_luks_open_ro>.  The C<device> parameter must be the name of the "
10984 "LUKS mapping device (ie. C</dev/mapper/mapname>) and I<not> the name of the "
10985 "underlying block device."
10986 msgstr ""
10987
10988 #. type: textblock
10989 #: ../src/guestfs-actions.pod:3626 ../src/guestfs-actions.pod:3725 ../src/guestfs-actions.pod:3744 ../src/guestfs-actions.pod:3794 ../src/guestfs-actions.pod:3842
10990 msgid "(Added in 1.5.1)"
10991 msgstr ""
10992
10993 #. type: =head2
10994 #: ../src/guestfs-actions.pod:3628
10995 msgid "guestfs_luks_format"
10996 msgstr ""
10997
10998 #. type: verbatim
10999 #: ../src/guestfs-actions.pod:3630
11000 #, no-wrap
11001 msgid ""
11002 " int\n"
11003 " guestfs_luks_format (guestfs_h *g,\n"
11004 "                      const char *device,\n"
11005 "                      const char *key,\n"
11006 "                      int keyslot);\n"
11007 "\n"
11008 msgstr ""
11009
11010 #. type: textblock
11011 #: ../src/guestfs-actions.pod:3636 ../fish/guestfish-actions.pod:2491
11012 msgid ""
11013 "This command erases existing data on C<device> and formats the device as a "
11014 "LUKS encrypted device.  C<key> is the initial key, which is added to key "
11015 "slot C<slot>.  (LUKS supports 8 key slots, numbered 0-7)."
11016 msgstr ""
11017
11018 #. type: textblock
11019 #: ../src/guestfs-actions.pod:3643 ../src/guestfs-actions.pod:3666 ../src/guestfs-actions.pod:3806 ../src/guestfs-actions.pod:4745 ../src/guestfs-actions.pod:5508 ../src/guestfs-actions.pod:5883 ../src/guestfs-actions.pod:5906 ../src/guestfs-actions.pod:5932 ../src/guestfs-actions.pod:7092 ../fish/guestfish-actions.pod:2499 ../fish/guestfish-actions.pod:2512 ../fish/guestfish-actions.pod:2596 ../fish/guestfish-actions.pod:3168 ../fish/guestfish-actions.pod:3675 ../fish/guestfish-actions.pod:3955 ../fish/guestfish-actions.pod:3971 ../fish/guestfish-actions.pod:3986 ../fish/guestfish-actions.pod:4701
11020 msgid ""
11021 "B<This command is dangerous.  Without careful use you can easily destroy all "
11022 "your data>."
11023 msgstr ""
11024
11025 #. type: =head2
11026 #: ../src/guestfs-actions.pod:3652
11027 msgid "guestfs_luks_format_cipher"
11028 msgstr ""
11029
11030 #. type: verbatim
11031 #: ../src/guestfs-actions.pod:3654
11032 #, no-wrap
11033 msgid ""
11034 " int\n"
11035 " guestfs_luks_format_cipher (guestfs_h *g,\n"
11036 "                             const char *device,\n"
11037 "                             const char *key,\n"
11038 "                             int keyslot,\n"
11039 "                             const char *cipher);\n"
11040 "\n"
11041 msgstr ""
11042
11043 #. type: textblock
11044 #: ../src/guestfs-actions.pod:3661
11045 msgid ""
11046 "This command is the same as C<guestfs_luks_format> but it also allows you to "
11047 "set the C<cipher> used."
11048 msgstr ""
11049
11050 #. type: =head2
11051 #: ../src/guestfs-actions.pod:3675
11052 msgid "guestfs_luks_kill_slot"
11053 msgstr ""
11054
11055 #. type: verbatim
11056 #: ../src/guestfs-actions.pod:3677
11057 #, no-wrap
11058 msgid ""
11059 " int\n"
11060 " guestfs_luks_kill_slot (guestfs_h *g,\n"
11061 "                         const char *device,\n"
11062 "                         const char *key,\n"
11063 "                         int keyslot);\n"
11064 "\n"
11065 msgstr ""
11066
11067 #. type: textblock
11068 #: ../src/guestfs-actions.pod:3683 ../fish/guestfish-actions.pod:2519
11069 msgid ""
11070 "This command deletes the key in key slot C<keyslot> from the encrypted LUKS "
11071 "device C<device>.  C<key> must be one of the I<other> keys."
11072 msgstr ""
11073
11074 #. type: =head2
11075 #: ../src/guestfs-actions.pod:3695
11076 msgid "guestfs_luks_open"
11077 msgstr ""
11078
11079 #. type: verbatim
11080 #: ../src/guestfs-actions.pod:3697
11081 #, no-wrap
11082 msgid ""
11083 " int\n"
11084 " guestfs_luks_open (guestfs_h *g,\n"
11085 "                    const char *device,\n"
11086 "                    const char *key,\n"
11087 "                    const char *mapname);\n"
11088 "\n"
11089 msgstr ""
11090
11091 #. type: textblock
11092 #: ../src/guestfs-actions.pod:3703 ../fish/guestfish-actions.pod:2530
11093 msgid ""
11094 "This command opens a block device which has been encrypted according to the "
11095 "Linux Unified Key Setup (LUKS) standard."
11096 msgstr ""
11097
11098 #. type: textblock
11099 #: ../src/guestfs-actions.pod:3706 ../fish/guestfish-actions.pod:2533
11100 msgid "C<device> is the encrypted block device or partition."
11101 msgstr ""
11102
11103 #. type: textblock
11104 #: ../src/guestfs-actions.pod:3708 ../fish/guestfish-actions.pod:2535
11105 msgid ""
11106 "The caller must supply one of the keys associated with the LUKS block "
11107 "device, in the C<key> parameter."
11108 msgstr ""
11109
11110 #. type: textblock
11111 #: ../src/guestfs-actions.pod:3711 ../fish/guestfish-actions.pod:2538
11112 msgid ""
11113 "This creates a new block device called C</dev/mapper/mapname>.  Reads and "
11114 "writes to this block device are decrypted from and encrypted to the "
11115 "underlying C<device> respectively."
11116 msgstr ""
11117
11118 #. type: textblock
11119 #: ../src/guestfs-actions.pod:3715
11120 msgid ""
11121 "If this block device contains LVM volume groups, then calling "
11122 "C<guestfs_vgscan> followed by C<guestfs_vg_activate_all> will make them "
11123 "visible."
11124 msgstr ""
11125
11126 #. type: =head2
11127 #: ../src/guestfs-actions.pod:3727
11128 msgid "guestfs_luks_open_ro"
11129 msgstr ""
11130
11131 #. type: verbatim
11132 #: ../src/guestfs-actions.pod:3729
11133 #, no-wrap
11134 msgid ""
11135 " int\n"
11136 " guestfs_luks_open_ro (guestfs_h *g,\n"
11137 "                       const char *device,\n"
11138 "                       const char *key,\n"
11139 "                       const char *mapname);\n"
11140 "\n"
11141 msgstr ""
11142
11143 #. type: textblock
11144 #: ../src/guestfs-actions.pod:3735
11145 msgid ""
11146 "This is the same as C<guestfs_luks_open> except that a read-only mapping is "
11147 "created."
11148 msgstr ""
11149
11150 #. type: =head2
11151 #: ../src/guestfs-actions.pod:3746
11152 msgid "guestfs_lvcreate"
11153 msgstr ""
11154
11155 #. type: verbatim
11156 #: ../src/guestfs-actions.pod:3748
11157 #, no-wrap
11158 msgid ""
11159 " int\n"
11160 " guestfs_lvcreate (guestfs_h *g,\n"
11161 "                   const char *logvol,\n"
11162 "                   const char *volgroup,\n"
11163 "                   int mbytes);\n"
11164 "\n"
11165 msgstr ""
11166
11167 #. type: textblock
11168 #: ../src/guestfs-actions.pod:3754 ../fish/guestfish-actions.pod:2563
11169 msgid ""
11170 "This creates an LVM logical volume called C<logvol> on the volume group "
11171 "C<volgroup>, with C<size> megabytes."
11172 msgstr ""
11173
11174 #. type: =head2
11175 #: ../src/guestfs-actions.pod:3761
11176 msgid "guestfs_lvm_canonical_lv_name"
11177 msgstr ""
11178
11179 #. type: verbatim
11180 #: ../src/guestfs-actions.pod:3763
11181 #, no-wrap
11182 msgid ""
11183 " char *\n"
11184 " guestfs_lvm_canonical_lv_name (guestfs_h *g,\n"
11185 "                                const char *lvname);\n"
11186 "\n"
11187 msgstr ""
11188
11189 #. type: textblock
11190 #: ../src/guestfs-actions.pod:3767 ../fish/guestfish-actions.pod:2570
11191 msgid ""
11192 "This converts alternative naming schemes for LVs that you might find to the "
11193 "canonical name.  For example, C</dev/mapper/VG-LV> is converted to "
11194 "C</dev/VG/LV>."
11195 msgstr ""
11196
11197 #. type: textblock
11198 #: ../src/guestfs-actions.pod:3771 ../fish/guestfish-actions.pod:2574
11199 msgid ""
11200 "This command returns an error if the C<lvname> parameter does not refer to a "
11201 "logical volume."
11202 msgstr ""
11203
11204 #. type: textblock
11205 #: ../src/guestfs-actions.pod:3774
11206 msgid "See also C<guestfs_is_lv>."
11207 msgstr ""
11208
11209 #. type: textblock
11210 #: ../src/guestfs-actions.pod:3779
11211 msgid "(Added in 1.5.24)"
11212 msgstr ""
11213
11214 #. type: =head2
11215 #: ../src/guestfs-actions.pod:3781
11216 msgid "guestfs_lvm_clear_filter"
11217 msgstr ""
11218
11219 #. type: verbatim
11220 #: ../src/guestfs-actions.pod:3783
11221 #, no-wrap
11222 msgid ""
11223 " int\n"
11224 " guestfs_lvm_clear_filter (guestfs_h *g);\n"
11225 "\n"
11226 msgstr ""
11227
11228 #. type: textblock
11229 #: ../src/guestfs-actions.pod:3786
11230 msgid ""
11231 "This undoes the effect of C<guestfs_lvm_set_filter>.  LVM will be able to "
11232 "see every block device."
11233 msgstr ""
11234
11235 #. type: textblock
11236 #: ../src/guestfs-actions.pod:3789 ../src/guestfs-actions.pod:3831 ../fish/guestfish-actions.pod:2586 ../fish/guestfish-actions.pod:2617
11237 msgid "This command also clears the LVM cache and performs a volume group scan."
11238 msgstr ""
11239
11240 #. type: =head2
11241 #: ../src/guestfs-actions.pod:3796
11242 msgid "guestfs_lvm_remove_all"
11243 msgstr ""
11244
11245 #. type: verbatim
11246 #: ../src/guestfs-actions.pod:3798
11247 #, no-wrap
11248 msgid ""
11249 " int\n"
11250 " guestfs_lvm_remove_all (guestfs_h *g);\n"
11251 "\n"
11252 msgstr ""
11253
11254 #. type: textblock
11255 #: ../src/guestfs-actions.pod:3801 ../fish/guestfish-actions.pod:2593
11256 msgid ""
11257 "This command removes all LVM logical volumes, volume groups and physical "
11258 "volumes."
11259 msgstr ""
11260
11261 #. type: =head2
11262 #: ../src/guestfs-actions.pod:3811
11263 msgid "guestfs_lvm_set_filter"
11264 msgstr ""
11265
11266 #. type: verbatim
11267 #: ../src/guestfs-actions.pod:3813
11268 #, no-wrap
11269 msgid ""
11270 " int\n"
11271 " guestfs_lvm_set_filter (guestfs_h *g,\n"
11272 "                         char *const *devices);\n"
11273 "\n"
11274 msgstr ""
11275
11276 #. type: textblock
11277 #: ../src/guestfs-actions.pod:3817 ../fish/guestfish-actions.pod:2603
11278 msgid ""
11279 "This sets the LVM device filter so that LVM will only be able to \"see\" the "
11280 "block devices in the list C<devices>, and will ignore all other attached "
11281 "block devices."
11282 msgstr ""
11283
11284 #. type: textblock
11285 #: ../src/guestfs-actions.pod:3821 ../fish/guestfish-actions.pod:2607
11286 msgid ""
11287 "Where disk image(s) contain duplicate PVs or VGs, this command is useful to "
11288 "get LVM to ignore the duplicates, otherwise LVM can get confused.  Note also "
11289 "there are two types of duplication possible: either cloned PVs/VGs which "
11290 "have identical UUIDs; or VGs that are not cloned but just happen to have the "
11291 "same name.  In normal operation you cannot create this situation, but you "
11292 "can do it outside LVM, eg.  by cloning disk images or by bit twiddling "
11293 "inside the LVM metadata."
11294 msgstr ""
11295
11296 #. type: textblock
11297 #: ../src/guestfs-actions.pod:3834 ../fish/guestfish-actions.pod:2620
11298 msgid "You can filter whole block devices or individual partitions."
11299 msgstr ""
11300
11301 #. type: textblock
11302 #: ../src/guestfs-actions.pod:3836 ../fish/guestfish-actions.pod:2622
11303 msgid ""
11304 "You cannot use this if any VG is currently in use (eg.  contains a mounted "
11305 "filesystem), even if you are not filtering out that VG."
11306 msgstr ""
11307
11308 #. type: =head2
11309 #: ../src/guestfs-actions.pod:3844
11310 msgid "guestfs_lvremove"
11311 msgstr ""
11312
11313 #. type: verbatim
11314 #: ../src/guestfs-actions.pod:3846
11315 #, no-wrap
11316 msgid ""
11317 " int\n"
11318 " guestfs_lvremove (guestfs_h *g,\n"
11319 "                   const char *device);\n"
11320 "\n"
11321 msgstr ""
11322
11323 #. type: textblock
11324 #: ../src/guestfs-actions.pod:3850 ../fish/guestfish-actions.pod:2630
11325 msgid ""
11326 "Remove an LVM logical volume C<device>, where C<device> is the path to the "
11327 "LV, such as C</dev/VG/LV>."
11328 msgstr ""
11329
11330 #. type: textblock
11331 #: ../src/guestfs-actions.pod:3853 ../fish/guestfish-actions.pod:2633
11332 msgid ""
11333 "You can also remove all LVs in a volume group by specifying the VG name, "
11334 "C</dev/VG>."
11335 msgstr ""
11336
11337 #. type: textblock
11338 #: ../src/guestfs-actions.pod:3858 ../src/guestfs-actions.pod:5091 ../src/guestfs-actions.pod:6831
11339 msgid "(Added in 1.0.13)"
11340 msgstr ""
11341
11342 #. type: =head2
11343 #: ../src/guestfs-actions.pod:3860
11344 msgid "guestfs_lvrename"
11345 msgstr ""
11346
11347 #. type: verbatim
11348 #: ../src/guestfs-actions.pod:3862
11349 #, no-wrap
11350 msgid ""
11351 " int\n"
11352 " guestfs_lvrename (guestfs_h *g,\n"
11353 "                   const char *logvol,\n"
11354 "                   const char *newlogvol);\n"
11355 "\n"
11356 msgstr ""
11357
11358 #. type: textblock
11359 #: ../src/guestfs-actions.pod:3867 ../fish/guestfish-actions.pod:2640
11360 msgid "Rename a logical volume C<logvol> with the new name C<newlogvol>."
11361 msgstr ""
11362
11363 #. type: textblock
11364 #: ../src/guestfs-actions.pod:3871 ../src/guestfs-actions.pod:6844
11365 msgid "(Added in 1.0.83)"
11366 msgstr ""
11367
11368 #. type: =head2
11369 #: ../src/guestfs-actions.pod:3873
11370 msgid "guestfs_lvresize"
11371 msgstr ""
11372
11373 #. type: verbatim
11374 #: ../src/guestfs-actions.pod:3875
11375 #, no-wrap
11376 msgid ""
11377 " int\n"
11378 " guestfs_lvresize (guestfs_h *g,\n"
11379 "                   const char *device,\n"
11380 "                   int mbytes);\n"
11381 "\n"
11382 msgstr ""
11383
11384 #. type: textblock
11385 #: ../src/guestfs-actions.pod:3880 ../fish/guestfish-actions.pod:2646
11386 msgid ""
11387 "This resizes (expands or shrinks) an existing LVM logical volume to "
11388 "C<mbytes>.  When reducing, data in the reduced part is lost."
11389 msgstr ""
11390
11391 #. type: =head2
11392 #: ../src/guestfs-actions.pod:3888
11393 msgid "guestfs_lvresize_free"
11394 msgstr ""
11395
11396 #. type: verbatim
11397 #: ../src/guestfs-actions.pod:3890
11398 #, no-wrap
11399 msgid ""
11400 " int\n"
11401 " guestfs_lvresize_free (guestfs_h *g,\n"
11402 "                        const char *lv,\n"
11403 "                        int percent);\n"
11404 "\n"
11405 msgstr ""
11406
11407 #. type: textblock
11408 #: ../src/guestfs-actions.pod:3895 ../fish/guestfish-actions.pod:2654
11409 msgid ""
11410 "This expands an existing logical volume C<lv> so that it fills C<pc>% of the "
11411 "remaining free space in the volume group.  Commonly you would call this with "
11412 "pc = 100 which expands the logical volume as much as possible, using all "
11413 "remaining free space in the volume group."
11414 msgstr ""
11415
11416 #. type: textblock
11417 #: ../src/guestfs-actions.pod:3903
11418 msgid "(Added in 1.3.3)"
11419 msgstr ""
11420
11421 #. type: =head2
11422 #: ../src/guestfs-actions.pod:3905
11423 msgid "guestfs_lvs"
11424 msgstr ""
11425
11426 #. type: verbatim
11427 #: ../src/guestfs-actions.pod:3907
11428 #, no-wrap
11429 msgid ""
11430 " char **\n"
11431 " guestfs_lvs (guestfs_h *g);\n"
11432 "\n"
11433 msgstr ""
11434
11435 #. type: textblock
11436 #: ../src/guestfs-actions.pod:3910 ../fish/guestfish-actions.pod:2664
11437 msgid ""
11438 "List all the logical volumes detected.  This is the equivalent of the "
11439 "L<lvs(8)> command."
11440 msgstr ""
11441
11442 #. type: textblock
11443 #: ../src/guestfs-actions.pod:3913 ../fish/guestfish-actions.pod:2667
11444 msgid ""
11445 "This returns a list of the logical volume device names "
11446 "(eg. C</dev/VolGroup00/LogVol00>)."
11447 msgstr ""
11448
11449 #. type: textblock
11450 #: ../src/guestfs-actions.pod:3916
11451 msgid "See also C<guestfs_lvs_full>, C<guestfs_list_filesystems>."
11452 msgstr ""
11453
11454 #. type: =head2
11455 #: ../src/guestfs-actions.pod:3924
11456 msgid "guestfs_lvs_full"
11457 msgstr ""
11458
11459 #. type: verbatim
11460 #: ../src/guestfs-actions.pod:3926
11461 #, no-wrap
11462 msgid ""
11463 " struct guestfs_lvm_lv_list *\n"
11464 " guestfs_lvs_full (guestfs_h *g);\n"
11465 "\n"
11466 msgstr ""
11467
11468 #. type: textblock
11469 #: ../src/guestfs-actions.pod:3929 ../fish/guestfish-actions.pod:2676
11470 msgid ""
11471 "List all the logical volumes detected.  This is the equivalent of the "
11472 "L<lvs(8)> command.  The \"full\" version includes all fields."
11473 msgstr ""
11474
11475 #. type: textblock
11476 #: ../src/guestfs-actions.pod:3932
11477 msgid ""
11478 "This function returns a C<struct guestfs_lvm_lv_list *>, or NULL if there "
11479 "was an error.  I<The caller must call C<guestfs_free_lvm_lv_list> after "
11480 "use>."
11481 msgstr ""
11482
11483 #. type: =head2
11484 #: ../src/guestfs-actions.pod:3938
11485 msgid "guestfs_lvuuid"
11486 msgstr ""
11487
11488 #. type: verbatim
11489 #: ../src/guestfs-actions.pod:3940
11490 #, no-wrap
11491 msgid ""
11492 " char *\n"
11493 " guestfs_lvuuid (guestfs_h *g,\n"
11494 "                 const char *device);\n"
11495 "\n"
11496 msgstr ""
11497
11498 #. type: textblock
11499 #: ../src/guestfs-actions.pod:3944 ../fish/guestfish-actions.pod:2683
11500 msgid "This command returns the UUID of the LVM LV C<device>."
11501 msgstr ""
11502
11503 #. type: =head2
11504 #: ../src/guestfs-actions.pod:3951
11505 msgid "guestfs_lxattrlist"
11506 msgstr ""
11507
11508 #. type: verbatim
11509 #: ../src/guestfs-actions.pod:3953
11510 #, no-wrap
11511 msgid ""
11512 " struct guestfs_xattr_list *\n"
11513 " guestfs_lxattrlist (guestfs_h *g,\n"
11514 "                     const char *path,\n"
11515 "                     char *const *names);\n"
11516 "\n"
11517 msgstr ""
11518
11519 #. type: textblock
11520 #: ../src/guestfs-actions.pod:3958 ../fish/guestfish-actions.pod:2689
11521 msgid ""
11522 "This call allows you to get the extended attributes of multiple files, where "
11523 "all files are in the directory C<path>.  C<names> is the list of files from "
11524 "this directory."
11525 msgstr ""
11526
11527 #. type: textblock
11528 #: ../src/guestfs-actions.pod:3962 ../fish/guestfish-actions.pod:2693
11529 msgid ""
11530 "On return you get a flat list of xattr structs which must be interpreted "
11531 "sequentially.  The first xattr struct always has a zero-length C<attrname>.  "
11532 "C<attrval> in this struct is zero-length to indicate there was an error "
11533 "doing C<lgetxattr> for this file, I<or> is a C string which is a decimal "
11534 "number (the number of following attributes for this file, which could be "
11535 "C<\"0\">).  Then after the first xattr struct are the zero or more "
11536 "attributes for the first named file.  This repeats for the second and "
11537 "subsequent files."
11538 msgstr ""
11539
11540 #. type: textblock
11541 #: ../src/guestfs-actions.pod:3972
11542 msgid ""
11543 "This call is intended for programs that want to efficiently list a directory "
11544 "contents without making many round-trips.  See also C<guestfs_lstatlist> for "
11545 "a similarly efficient call for getting standard stats.  Very long directory "
11546 "listings might cause the protocol message size to be exceeded, causing this "
11547 "call to fail.  The caller must split up such requests into smaller groups of "
11548 "names."
11549 msgstr ""
11550
11551 #. type: =head2
11552 #: ../src/guestfs-actions.pod:3986
11553 msgid "guestfs_mkdir"
11554 msgstr ""
11555
11556 #. type: verbatim
11557 #: ../src/guestfs-actions.pod:3988
11558 #, no-wrap
11559 msgid ""
11560 " int\n"
11561 " guestfs_mkdir (guestfs_h *g,\n"
11562 "                const char *path);\n"
11563 "\n"
11564 msgstr ""
11565
11566 #. type: textblock
11567 #: ../src/guestfs-actions.pod:3992 ../fish/guestfish-actions.pod:2715
11568 msgid "Create a directory named C<path>."
11569 msgstr ""
11570
11571 #. type: =head2
11572 #: ../src/guestfs-actions.pod:3998
11573 msgid "guestfs_mkdir_mode"
11574 msgstr ""
11575
11576 #. type: verbatim
11577 #: ../src/guestfs-actions.pod:4000
11578 #, no-wrap
11579 msgid ""
11580 " int\n"
11581 " guestfs_mkdir_mode (guestfs_h *g,\n"
11582 "                     const char *path,\n"
11583 "                     int mode);\n"
11584 "\n"
11585 msgstr ""
11586
11587 #. type: textblock
11588 #: ../src/guestfs-actions.pod:4005 ../fish/guestfish-actions.pod:2721
11589 msgid ""
11590 "This command creates a directory, setting the initial permissions of the "
11591 "directory to C<mode>."
11592 msgstr ""
11593
11594 #. type: textblock
11595 #: ../src/guestfs-actions.pod:4008 ../fish/guestfish-actions.pod:2724
11596 msgid ""
11597 "For common Linux filesystems, the actual mode which is set will be C<mode & "
11598 "~umask & 01777>.  Non-native-Linux filesystems may interpret the mode in "
11599 "other ways."
11600 msgstr ""
11601
11602 #. type: textblock
11603 #: ../src/guestfs-actions.pod:4012
11604 msgid "See also C<guestfs_mkdir>, C<guestfs_umask>"
11605 msgstr ""
11606
11607 #. type: =head2
11608 #: ../src/guestfs-actions.pod:4018
11609 msgid "guestfs_mkdir_p"
11610 msgstr ""
11611
11612 #. type: verbatim
11613 #: ../src/guestfs-actions.pod:4020
11614 #, no-wrap
11615 msgid ""
11616 " int\n"
11617 " guestfs_mkdir_p (guestfs_h *g,\n"
11618 "                  const char *path);\n"
11619 "\n"
11620 msgstr ""
11621
11622 #. type: textblock
11623 #: ../src/guestfs-actions.pod:4024 ../fish/guestfish-actions.pod:2734
11624 msgid ""
11625 "Create a directory named C<path>, creating any parent directories as "
11626 "necessary.  This is like the C<mkdir -p> shell command."
11627 msgstr ""
11628
11629 #. type: =head2
11630 #: ../src/guestfs-actions.pod:4031
11631 msgid "guestfs_mkdtemp"
11632 msgstr ""
11633
11634 #. type: verbatim
11635 #: ../src/guestfs-actions.pod:4033
11636 #, no-wrap
11637 msgid ""
11638 " char *\n"
11639 " guestfs_mkdtemp (guestfs_h *g,\n"
11640 "                  const char *template);\n"
11641 "\n"
11642 msgstr ""
11643
11644 #. type: textblock
11645 #: ../src/guestfs-actions.pod:4037 ../fish/guestfish-actions.pod:2741
11646 msgid ""
11647 "This command creates a temporary directory.  The C<template> parameter "
11648 "should be a full pathname for the temporary directory name with the final "
11649 "six characters being \"XXXXXX\"."
11650 msgstr ""
11651
11652 #. type: textblock
11653 #: ../src/guestfs-actions.pod:4042 ../fish/guestfish-actions.pod:2746
11654 msgid ""
11655 "For example: \"/tmp/myprogXXXXXX\" or \"/Temp/myprogXXXXXX\", the second one "
11656 "being suitable for Windows filesystems."
11657 msgstr ""
11658
11659 #. type: textblock
11660 #: ../src/guestfs-actions.pod:4045 ../fish/guestfish-actions.pod:2749
11661 msgid "The name of the temporary directory that was created is returned."
11662 msgstr ""
11663
11664 #. type: textblock
11665 #: ../src/guestfs-actions.pod:4048 ../fish/guestfish-actions.pod:2752
11666 msgid "The temporary directory is created with mode 0700 and is owned by root."
11667 msgstr ""
11668
11669 #. type: textblock
11670 #: ../src/guestfs-actions.pod:4051 ../fish/guestfish-actions.pod:2755
11671 msgid ""
11672 "The caller is responsible for deleting the temporary directory and its "
11673 "contents after use."
11674 msgstr ""
11675
11676 #. type: textblock
11677 #: ../src/guestfs-actions.pod:4054 ../fish/guestfish-actions.pod:2758
11678 msgid "See also: L<mkdtemp(3)>"
11679 msgstr ""
11680
11681 #. type: =head2
11682 #: ../src/guestfs-actions.pod:4061
11683 msgid "guestfs_mke2fs_J"
11684 msgstr ""
11685
11686 #. type: verbatim
11687 #: ../src/guestfs-actions.pod:4063
11688 #, no-wrap
11689 msgid ""
11690 " int\n"
11691 " guestfs_mke2fs_J (guestfs_h *g,\n"
11692 "                   const char *fstype,\n"
11693 "                   int blocksize,\n"
11694 "                   const char *device,\n"
11695 "                   const char *journal);\n"
11696 "\n"
11697 msgstr ""
11698
11699 #. type: textblock
11700 #: ../src/guestfs-actions.pod:4070 ../fish/guestfish-actions.pod:2764
11701 msgid ""
11702 "This creates an ext2/3/4 filesystem on C<device> with an external journal on "
11703 "C<journal>.  It is equivalent to the command:"
11704 msgstr ""
11705
11706 #. type: verbatim
11707 #: ../src/guestfs-actions.pod:4074 ../fish/guestfish-actions.pod:2768
11708 #, no-wrap
11709 msgid ""
11710 " mke2fs -t fstype -b blocksize -J device=<journal> <device>\n"
11711 "\n"
11712 msgstr ""
11713
11714 #. type: textblock
11715 #: ../src/guestfs-actions.pod:4076
11716 msgid "See also C<guestfs_mke2journal>."
11717 msgstr ""
11718
11719 #. type: textblock
11720 #: ../src/guestfs-actions.pod:4080 ../src/guestfs-actions.pod:4098 ../src/guestfs-actions.pod:4116 ../src/guestfs-actions.pod:4132 ../src/guestfs-actions.pod:4146 ../src/guestfs-actions.pod:4160 ../src/guestfs-actions.pod:4219 ../src/guestfs-actions.pod:4472
11721 msgid "(Added in 1.0.68)"
11722 msgstr ""
11723
11724 #. type: =head2
11725 #: ../src/guestfs-actions.pod:4082
11726 msgid "guestfs_mke2fs_JL"
11727 msgstr ""
11728
11729 #. type: verbatim
11730 #: ../src/guestfs-actions.pod:4084
11731 #, no-wrap
11732 msgid ""
11733 " int\n"
11734 " guestfs_mke2fs_JL (guestfs_h *g,\n"
11735 "                    const char *fstype,\n"
11736 "                    int blocksize,\n"
11737 "                    const char *device,\n"
11738 "                    const char *label);\n"
11739 "\n"
11740 msgstr ""
11741
11742 #. type: textblock
11743 #: ../src/guestfs-actions.pod:4091 ../fish/guestfish-actions.pod:2776
11744 msgid ""
11745 "This creates an ext2/3/4 filesystem on C<device> with an external journal on "
11746 "the journal labeled C<label>."
11747 msgstr ""
11748
11749 #. type: textblock
11750 #: ../src/guestfs-actions.pod:4094
11751 msgid "See also C<guestfs_mke2journal_L>."
11752 msgstr ""
11753
11754 #. type: =head2
11755 #: ../src/guestfs-actions.pod:4100
11756 msgid "guestfs_mke2fs_JU"
11757 msgstr ""
11758
11759 #. type: verbatim
11760 #: ../src/guestfs-actions.pod:4102
11761 #, no-wrap
11762 msgid ""
11763 " int\n"
11764 " guestfs_mke2fs_JU (guestfs_h *g,\n"
11765 "                    const char *fstype,\n"
11766 "                    int blocksize,\n"
11767 "                    const char *device,\n"
11768 "                    const char *uuid);\n"
11769 "\n"
11770 msgstr ""
11771
11772 #. type: textblock
11773 #: ../src/guestfs-actions.pod:4109 ../fish/guestfish-actions.pod:2785
11774 msgid ""
11775 "This creates an ext2/3/4 filesystem on C<device> with an external journal on "
11776 "the journal with UUID C<uuid>."
11777 msgstr ""
11778
11779 #. type: textblock
11780 #: ../src/guestfs-actions.pod:4112
11781 msgid "See also C<guestfs_mke2journal_U>."
11782 msgstr ""
11783
11784 #. type: =head2
11785 #: ../src/guestfs-actions.pod:4118
11786 msgid "guestfs_mke2journal"
11787 msgstr ""
11788
11789 #. type: verbatim
11790 #: ../src/guestfs-actions.pod:4120
11791 #, no-wrap
11792 msgid ""
11793 " int\n"
11794 " guestfs_mke2journal (guestfs_h *g,\n"
11795 "                      int blocksize,\n"
11796 "                      const char *device);\n"
11797 "\n"
11798 msgstr ""
11799
11800 #. type: textblock
11801 #: ../src/guestfs-actions.pod:4125 ../fish/guestfish-actions.pod:2794
11802 msgid ""
11803 "This creates an ext2 external journal on C<device>.  It is equivalent to the "
11804 "command:"
11805 msgstr ""
11806
11807 #. type: verbatim
11808 #: ../src/guestfs-actions.pod:4128 ../fish/guestfish-actions.pod:2797
11809 #, no-wrap
11810 msgid ""
11811 " mke2fs -O journal_dev -b blocksize device\n"
11812 "\n"
11813 msgstr ""
11814
11815 #. type: =head2
11816 #: ../src/guestfs-actions.pod:4134
11817 msgid "guestfs_mke2journal_L"
11818 msgstr ""
11819
11820 #. type: verbatim
11821 #: ../src/guestfs-actions.pod:4136
11822 #, no-wrap
11823 msgid ""
11824 " int\n"
11825 " guestfs_mke2journal_L (guestfs_h *g,\n"
11826 "                        int blocksize,\n"
11827 "                        const char *label,\n"
11828 "                        const char *device);\n"
11829 "\n"
11830 msgstr ""
11831
11832 #. type: textblock
11833 #: ../src/guestfs-actions.pod:4142 ../fish/guestfish-actions.pod:2803
11834 msgid "This creates an ext2 external journal on C<device> with label C<label>."
11835 msgstr ""
11836
11837 #. type: =head2
11838 #: ../src/guestfs-actions.pod:4148
11839 msgid "guestfs_mke2journal_U"
11840 msgstr ""
11841
11842 #. type: verbatim
11843 #: ../src/guestfs-actions.pod:4150
11844 #, no-wrap
11845 msgid ""
11846 " int\n"
11847 " guestfs_mke2journal_U (guestfs_h *g,\n"
11848 "                        int blocksize,\n"
11849 "                        const char *uuid,\n"
11850 "                        const char *device);\n"
11851 "\n"
11852 msgstr ""
11853
11854 #. type: textblock
11855 #: ../src/guestfs-actions.pod:4156 ../fish/guestfish-actions.pod:2809
11856 msgid "This creates an ext2 external journal on C<device> with UUID C<uuid>."
11857 msgstr ""
11858
11859 #. type: =head2
11860 #: ../src/guestfs-actions.pod:4162
11861 msgid "guestfs_mkfifo"
11862 msgstr ""
11863
11864 #. type: verbatim
11865 #: ../src/guestfs-actions.pod:4164
11866 #, no-wrap
11867 msgid ""
11868 " int\n"
11869 " guestfs_mkfifo (guestfs_h *g,\n"
11870 "                 int mode,\n"
11871 "                 const char *path);\n"
11872 "\n"
11873 msgstr ""
11874
11875 #. type: textblock
11876 #: ../src/guestfs-actions.pod:4169
11877 msgid ""
11878 "This call creates a FIFO (named pipe) called C<path> with mode C<mode>.  It "
11879 "is just a convenient wrapper around C<guestfs_mknod>."
11880 msgstr ""
11881
11882 #. type: =head2
11883 #: ../src/guestfs-actions.pod:4179
11884 msgid "guestfs_mkfs"
11885 msgstr ""
11886
11887 #. type: verbatim
11888 #: ../src/guestfs-actions.pod:4181
11889 #, no-wrap
11890 msgid ""
11891 " int\n"
11892 " guestfs_mkfs (guestfs_h *g,\n"
11893 "               const char *fstype,\n"
11894 "               const char *device);\n"
11895 "\n"
11896 msgstr ""
11897
11898 #. type: textblock
11899 #: ../src/guestfs-actions.pod:4186 ../fish/guestfish-actions.pod:2825
11900 msgid ""
11901 "This creates a filesystem on C<device> (usually a partition or LVM logical "
11902 "volume).  The filesystem type is C<fstype>, for example C<ext3>."
11903 msgstr ""
11904
11905 #. type: =head2
11906 #: ../src/guestfs-actions.pod:4194
11907 msgid "guestfs_mkfs_b"
11908 msgstr ""
11909
11910 #. type: verbatim
11911 #: ../src/guestfs-actions.pod:4196
11912 #, no-wrap
11913 msgid ""
11914 " int\n"
11915 " guestfs_mkfs_b (guestfs_h *g,\n"
11916 "                 const char *fstype,\n"
11917 "                 int blocksize,\n"
11918 "                 const char *device);\n"
11919 "\n"
11920 msgstr ""
11921
11922 #. type: textblock
11923 #: ../src/guestfs-actions.pod:4202
11924 msgid ""
11925 "This call is similar to C<guestfs_mkfs>, but it allows you to control the "
11926 "block size of the resulting filesystem.  Supported block sizes depend on the "
11927 "filesystem type, but typically they are C<1024>, C<2048> or C<4096> only."
11928 msgstr ""
11929
11930 #. type: textblock
11931 #: ../src/guestfs-actions.pod:4207 ../src/guestfs-actions.pod:4249 ../fish/guestfish-actions.pod:2838 ../fish/guestfish-actions.pod:2865
11932 msgid ""
11933 "For VFAT and NTFS the C<blocksize> parameter is treated as the requested "
11934 "cluster size."
11935 msgstr ""
11936
11937 #. type: textblock
11938 #: ../src/guestfs-actions.pod:4212
11939 msgid ""
11940 "This function is deprecated.  In new code, use the L</guestfs_mkfs_opts> "
11941 "call instead."
11942 msgstr ""
11943
11944 #. type: =head2
11945 #: ../src/guestfs-actions.pod:4221
11946 msgid "guestfs_mkfs_opts"
11947 msgstr ""
11948
11949 #. type: verbatim
11950 #: ../src/guestfs-actions.pod:4223
11951 #, no-wrap
11952 msgid ""
11953 " int\n"
11954 " guestfs_mkfs_opts (guestfs_h *g,\n"
11955 "                    const char *fstype,\n"
11956 "                    const char *device,\n"
11957 "                    ...);\n"
11958 "\n"
11959 msgstr ""
11960
11961 #. type: verbatim
11962 #: ../src/guestfs-actions.pod:4234
11963 #, no-wrap
11964 msgid ""
11965 " GUESTFS_MKFS_OPTS_BLOCKSIZE, int blocksize,\n"
11966 "\n"
11967 msgstr ""
11968
11969 #. type: textblock
11970 #: ../src/guestfs-actions.pod:4236 ../fish/guestfish-actions.pod:2852
11971 msgid ""
11972 "This function creates a filesystem on C<device>.  The filesystem type is "
11973 "C<fstype>, for example C<ext3>."
11974 msgstr ""
11975
11976 #. type: =item
11977 #: ../src/guestfs-actions.pod:4243 ../fish/guestfish-actions.pod:2859
11978 msgid "C<blocksize>"
11979 msgstr ""
11980
11981 #. type: textblock
11982 #: ../src/guestfs-actions.pod:4245 ../fish/guestfish-actions.pod:2861
11983 msgid ""
11984 "The filesystem block size.  Supported block sizes depend on the filesystem "
11985 "type, but typically they are C<1024>, C<2048> or C<4096> for Linux ext2/3 "
11986 "filesystems."
11987 msgstr ""
11988
11989 #. type: textblock
11990 #: ../src/guestfs-actions.pod:4252 ../fish/guestfish-actions.pod:2868
11991 msgid "For UFS block sizes, please see L<mkfs.ufs(8)>."
11992 msgstr ""
11993
11994 #. type: textblock
11995 #: ../src/guestfs-actions.pod:4258
11996 msgid "(Added in 1.7.19)"
11997 msgstr ""
11998
11999 #. type: =head2
12000 #: ../src/guestfs-actions.pod:4260
12001 msgid "guestfs_mkfs_opts_va"
12002 msgstr ""
12003
12004 #. type: verbatim
12005 #: ../src/guestfs-actions.pod:4262
12006 #, no-wrap
12007 msgid ""
12008 " int\n"
12009 " guestfs_mkfs_opts_va (guestfs_h *g,\n"
12010 "                       const char *fstype,\n"
12011 "                       const char *device,\n"
12012 "                       va_list args);\n"
12013 "\n"
12014 msgstr ""
12015
12016 #. type: textblock
12017 #: ../src/guestfs-actions.pod:4268
12018 msgid "This is the \"va_list variant\" of L</guestfs_mkfs_opts>."
12019 msgstr ""
12020
12021 #. type: =head2
12022 #: ../src/guestfs-actions.pod:4272
12023 msgid "guestfs_mkfs_opts_argv"
12024 msgstr ""
12025
12026 #. type: verbatim
12027 #: ../src/guestfs-actions.pod:4274
12028 #, no-wrap
12029 msgid ""
12030 " int\n"
12031 " guestfs_mkfs_opts_argv (guestfs_h *g,\n"
12032 "                         const char *fstype,\n"
12033 "                         const char *device,\n"
12034 "                         const struct guestfs_mkfs_opts_argv *optargs);\n"
12035 "\n"
12036 msgstr ""
12037
12038 #. type: textblock
12039 #: ../src/guestfs-actions.pod:4280
12040 msgid "This is the \"argv variant\" of L</guestfs_mkfs_opts>."
12041 msgstr ""
12042
12043 #. type: =head2
12044 #: ../src/guestfs-actions.pod:4284
12045 msgid "guestfs_mkmountpoint"
12046 msgstr ""
12047
12048 #. type: verbatim
12049 #: ../src/guestfs-actions.pod:4286
12050 #, no-wrap
12051 msgid ""
12052 " int\n"
12053 " guestfs_mkmountpoint (guestfs_h *g,\n"
12054 "                       const char *exemptpath);\n"
12055 "\n"
12056 msgstr ""
12057
12058 #. type: textblock
12059 #: ../src/guestfs-actions.pod:4290
12060 msgid ""
12061 "C<guestfs_mkmountpoint> and C<guestfs_rmmountpoint> are specialized calls "
12062 "that can be used to create extra mountpoints before mounting the first "
12063 "filesystem."
12064 msgstr ""
12065
12066 #. type: textblock
12067 #: ../src/guestfs-actions.pod:4294 ../fish/guestfish-actions.pod:2882
12068 msgid ""
12069 "These calls are I<only> necessary in some very limited circumstances, mainly "
12070 "the case where you want to mount a mix of unrelated and/or read-only "
12071 "filesystems together."
12072 msgstr ""
12073
12074 #. type: textblock
12075 #: ../src/guestfs-actions.pod:4298 ../fish/guestfish-actions.pod:2886
12076 msgid ""
12077 "For example, live CDs often contain a \"Russian doll\" nest of filesystems, "
12078 "an ISO outer layer, with a squashfs image inside, with an ext2/3 image "
12079 "inside that.  You can unpack this as follows in guestfish:"
12080 msgstr ""
12081
12082 #. type: verbatim
12083 #: ../src/guestfs-actions.pod:4303 ../fish/guestfish-actions.pod:2891
12084 #, no-wrap
12085 msgid ""
12086 " add-ro Fedora-11-i686-Live.iso\n"
12087 " run\n"
12088 " mkmountpoint /cd\n"
12089 " mkmountpoint /sqsh\n"
12090 " mkmountpoint /ext3fs\n"
12091 " mount /dev/sda /cd\n"
12092 " mount-loop /cd/LiveOS/squashfs.img /sqsh\n"
12093 " mount-loop /sqsh/LiveOS/ext3fs.img /ext3fs\n"
12094 "\n"
12095 msgstr ""
12096
12097 #. type: textblock
12098 #: ../src/guestfs-actions.pod:4312 ../fish/guestfish-actions.pod:2900
12099 msgid "The inner filesystem is now unpacked under the /ext3fs mountpoint."
12100 msgstr ""
12101
12102 #. type: textblock
12103 #: ../src/guestfs-actions.pod:4314
12104 msgid ""
12105 "C<guestfs_mkmountpoint> is not compatible with C<guestfs_umount_all>.  You "
12106 "may get unexpected errors if you try to mix these calls.  It is safest to "
12107 "manually unmount filesystems and remove mountpoints after use."
12108 msgstr ""
12109
12110 #. type: textblock
12111 #: ../src/guestfs-actions.pod:4318
12112 msgid ""
12113 "C<guestfs_umount_all> unmounts filesystems by sorting the paths longest "
12114 "first, so for this to work for manual mountpoints, you must ensure that the "
12115 "innermost mountpoints have the longest pathnames, as in the example code "
12116 "above."
12117 msgstr ""
12118
12119 #. type: textblock
12120 #: ../src/guestfs-actions.pod:4323 ../fish/guestfish-actions.pod:2911
12121 msgid "For more details see L<https://bugzilla.redhat.com/show_bug.cgi?id=599503>"
12122 msgstr ""
12123
12124 #. type: textblock
12125 #: ../src/guestfs-actions.pod:4325
12126 msgid ""
12127 "Autosync [see C<guestfs_set_autosync>, this is set by default on handles] "
12128 "means that C<guestfs_umount_all> is called when the handle is closed which "
12129 "can also trigger these issues."
12130 msgstr ""
12131
12132 #. type: textblock
12133 #: ../src/guestfs-actions.pod:4331 ../src/guestfs-actions.pod:4590 ../src/guestfs-actions.pod:5492
12134 msgid "(Added in 1.0.62)"
12135 msgstr ""
12136
12137 #. type: =head2
12138 #: ../src/guestfs-actions.pod:4333
12139 msgid "guestfs_mknod"
12140 msgstr ""
12141
12142 #. type: verbatim
12143 #: ../src/guestfs-actions.pod:4335
12144 #, no-wrap
12145 msgid ""
12146 " int\n"
12147 " guestfs_mknod (guestfs_h *g,\n"
12148 "                int mode,\n"
12149 "                int devmajor,\n"
12150 "                int devminor,\n"
12151 "                const char *path);\n"
12152 "\n"
12153 msgstr ""
12154
12155 #. type: textblock
12156 #: ../src/guestfs-actions.pod:4342 ../fish/guestfish-actions.pod:2921
12157 msgid ""
12158 "This call creates block or character special devices, or named pipes "
12159 "(FIFOs)."
12160 msgstr ""
12161
12162 #. type: textblock
12163 #: ../src/guestfs-actions.pod:4345 ../fish/guestfish-actions.pod:2924
12164 msgid ""
12165 "The C<mode> parameter should be the mode, using the standard constants.  "
12166 "C<devmajor> and C<devminor> are the device major and minor numbers, only "
12167 "used when creating block and character special devices."
12168 msgstr ""
12169
12170 #. type: textblock
12171 #: ../src/guestfs-actions.pod:4350
12172 msgid ""
12173 "Note that, just like L<mknod(2)>, the mode must be bitwise OR'd with "
12174 "S_IFBLK, S_IFCHR, S_IFIFO or S_IFSOCK (otherwise this call just creates a "
12175 "regular file).  These constants are available in the standard Linux header "
12176 "files, or you can use C<guestfs_mknod_b>, C<guestfs_mknod_c> or "
12177 "C<guestfs_mkfifo> which are wrappers around this command which bitwise OR in "
12178 "the appropriate constant for you."
12179 msgstr ""
12180
12181 #. type: =head2
12182 #: ../src/guestfs-actions.pod:4364
12183 msgid "guestfs_mknod_b"
12184 msgstr ""
12185
12186 #. type: verbatim
12187 #: ../src/guestfs-actions.pod:4366
12188 #, no-wrap
12189 msgid ""
12190 " int\n"
12191 " guestfs_mknod_b (guestfs_h *g,\n"
12192 "                  int mode,\n"
12193 "                  int devmajor,\n"
12194 "                  int devminor,\n"
12195 "                  const char *path);\n"
12196 "\n"
12197 msgstr ""
12198
12199 #. type: textblock
12200 #: ../src/guestfs-actions.pod:4373
12201 msgid ""
12202 "This call creates a block device node called C<path> with mode C<mode> and "
12203 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
12204 "wrapper around C<guestfs_mknod>."
12205 msgstr ""
12206
12207 #. type: =head2
12208 #: ../src/guestfs-actions.pod:4383
12209 msgid "guestfs_mknod_c"
12210 msgstr ""
12211
12212 #. type: verbatim
12213 #: ../src/guestfs-actions.pod:4385
12214 #, no-wrap
12215 msgid ""
12216 " int\n"
12217 " guestfs_mknod_c (guestfs_h *g,\n"
12218 "                  int mode,\n"
12219 "                  int devmajor,\n"
12220 "                  int devminor,\n"
12221 "                  const char *path);\n"
12222 "\n"
12223 msgstr ""
12224
12225 #. type: textblock
12226 #: ../src/guestfs-actions.pod:4392
12227 msgid ""
12228 "This call creates a char device node called C<path> with mode C<mode> and "
12229 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
12230 "wrapper around C<guestfs_mknod>."
12231 msgstr ""
12232
12233 #. type: =head2
12234 #: ../src/guestfs-actions.pod:4402
12235 msgid "guestfs_mkswap"
12236 msgstr ""
12237
12238 #. type: verbatim
12239 #: ../src/guestfs-actions.pod:4404
12240 #, no-wrap
12241 msgid ""
12242 " int\n"
12243 " guestfs_mkswap (guestfs_h *g,\n"
12244 "                 const char *device);\n"
12245 "\n"
12246 msgstr ""
12247
12248 #. type: textblock
12249 #: ../src/guestfs-actions.pod:4408 ../fish/guestfish-actions.pod:2963
12250 msgid "Create a swap partition on C<device>."
12251 msgstr ""
12252
12253 #. type: =head2
12254 #: ../src/guestfs-actions.pod:4414
12255 msgid "guestfs_mkswap_L"
12256 msgstr ""
12257
12258 #. type: verbatim
12259 #: ../src/guestfs-actions.pod:4416
12260 #, no-wrap
12261 msgid ""
12262 " int\n"
12263 " guestfs_mkswap_L (guestfs_h *g,\n"
12264 "                   const char *label,\n"
12265 "                   const char *device);\n"
12266 "\n"
12267 msgstr ""
12268
12269 #. type: textblock
12270 #: ../src/guestfs-actions.pod:4421 ../fish/guestfish-actions.pod:2969
12271 msgid "Create a swap partition on C<device> with label C<label>."
12272 msgstr ""
12273
12274 #. type: textblock
12275 #: ../src/guestfs-actions.pod:4423 ../fish/guestfish-actions.pod:2971
12276 msgid ""
12277 "Note that you cannot attach a swap label to a block device "
12278 "(eg. C</dev/sda>), just to a partition.  This appears to be a limitation of "
12279 "the kernel or swap tools."
12280 msgstr ""
12281
12282 #. type: =head2
12283 #: ../src/guestfs-actions.pod:4431
12284 msgid "guestfs_mkswap_U"
12285 msgstr ""
12286
12287 #. type: verbatim
12288 #: ../src/guestfs-actions.pod:4433
12289 #, no-wrap
12290 msgid ""
12291 " int\n"
12292 " guestfs_mkswap_U (guestfs_h *g,\n"
12293 "                   const char *uuid,\n"
12294 "                   const char *device);\n"
12295 "\n"
12296 msgstr ""
12297
12298 #. type: textblock
12299 #: ../src/guestfs-actions.pod:4438 ../fish/guestfish-actions.pod:2979
12300 msgid "Create a swap partition on C<device> with UUID C<uuid>."
12301 msgstr ""
12302
12303 #. type: =head2
12304 #: ../src/guestfs-actions.pod:4444
12305 msgid "guestfs_mkswap_file"
12306 msgstr ""
12307
12308 #. type: verbatim
12309 #: ../src/guestfs-actions.pod:4446
12310 #, no-wrap
12311 msgid ""
12312 " int\n"
12313 " guestfs_mkswap_file (guestfs_h *g,\n"
12314 "                      const char *path);\n"
12315 "\n"
12316 msgstr ""
12317
12318 #. type: textblock
12319 #: ../src/guestfs-actions.pod:4450 ../fish/guestfish-actions.pod:2985
12320 msgid "Create a swap file."
12321 msgstr ""
12322
12323 #. type: textblock
12324 #: ../src/guestfs-actions.pod:4452
12325 msgid ""
12326 "This command just writes a swap file signature to an existing file.  To "
12327 "create the file itself, use something like C<guestfs_fallocate>."
12328 msgstr ""
12329
12330 #. type: =head2
12331 #: ../src/guestfs-actions.pod:4459
12332 msgid "guestfs_modprobe"
12333 msgstr ""
12334
12335 #. type: verbatim
12336 #: ../src/guestfs-actions.pod:4461
12337 #, no-wrap
12338 msgid ""
12339 " int\n"
12340 " guestfs_modprobe (guestfs_h *g,\n"
12341 "                   const char *modulename);\n"
12342 "\n"
12343 msgstr ""
12344
12345 #. type: textblock
12346 #: ../src/guestfs-actions.pod:4465 ../fish/guestfish-actions.pod:2994
12347 msgid "This loads a kernel module in the appliance."
12348 msgstr ""
12349
12350 #. type: textblock
12351 #: ../src/guestfs-actions.pod:4467 ../fish/guestfish-actions.pod:2996
12352 msgid ""
12353 "The kernel module must have been whitelisted when libguestfs was built (see "
12354 "C<appliance/kmod.whitelist.in> in the source)."
12355 msgstr ""
12356
12357 #. type: =head2
12358 #: ../src/guestfs-actions.pod:4474
12359 msgid "guestfs_mount"
12360 msgstr ""
12361
12362 #. type: verbatim
12363 #: ../src/guestfs-actions.pod:4476
12364 #, no-wrap
12365 msgid ""
12366 " int\n"
12367 " guestfs_mount (guestfs_h *g,\n"
12368 "                const char *device,\n"
12369 "                const char *mountpoint);\n"
12370 "\n"
12371 msgstr ""
12372
12373 #. type: textblock
12374 #: ../src/guestfs-actions.pod:4481 ../fish/guestfish-actions.pod:3003
12375 msgid ""
12376 "Mount a guest disk at a position in the filesystem.  Block devices are named "
12377 "C</dev/sda>, C</dev/sdb> and so on, as they were added to the guest.  If "
12378 "those block devices contain partitions, they will have the usual names "
12379 "(eg. C</dev/sda1>).  Also LVM C</dev/VG/LV>-style names can be used."
12380 msgstr ""
12381
12382 #. type: textblock
12383 #: ../src/guestfs-actions.pod:4487 ../fish/guestfish-actions.pod:3009
12384 msgid ""
12385 "The rules are the same as for L<mount(2)>: A filesystem must first be "
12386 "mounted on C</> before others can be mounted.  Other filesystems can only be "
12387 "mounted on directories which already exist."
12388 msgstr ""
12389
12390 #. type: textblock
12391 #: ../src/guestfs-actions.pod:4492 ../fish/guestfish-actions.pod:3014
12392 msgid ""
12393 "The mounted filesystem is writable, if we have sufficient permissions on the "
12394 "underlying device."
12395 msgstr ""
12396
12397 #. type: textblock
12398 #: ../src/guestfs-actions.pod:4495
12399 msgid ""
12400 "B<Important note:> When you use this call, the filesystem options C<sync> "
12401 "and C<noatime> are set implicitly.  This was originally done because we "
12402 "thought it would improve reliability, but it turns out that I<-o sync> has a "
12403 "very large negative performance impact and negligible effect on "
12404 "reliability.  Therefore we recommend that you avoid using C<guestfs_mount> "
12405 "in any code that needs performance, and instead use C<guestfs_mount_options> "
12406 "(use an empty string for the first parameter if you don't want any options)."
12407 msgstr ""
12408
12409 #. type: =head2
12410 #: ../src/guestfs-actions.pod:4509
12411 msgid "guestfs_mount_loop"
12412 msgstr ""
12413
12414 #. type: verbatim
12415 #: ../src/guestfs-actions.pod:4511
12416 #, no-wrap
12417 msgid ""
12418 " int\n"
12419 " guestfs_mount_loop (guestfs_h *g,\n"
12420 "                     const char *file,\n"
12421 "                     const char *mountpoint);\n"
12422 "\n"
12423 msgstr ""
12424
12425 #. type: textblock
12426 #: ../src/guestfs-actions.pod:4516 ../fish/guestfish-actions.pod:3031
12427 msgid ""
12428 "This command lets you mount C<file> (a filesystem image in a file) on a "
12429 "mount point.  It is entirely equivalent to the command C<mount -o loop file "
12430 "mountpoint>."
12431 msgstr ""
12432
12433 #. type: =head2
12434 #: ../src/guestfs-actions.pod:4524
12435 msgid "guestfs_mount_options"
12436 msgstr ""
12437
12438 #. type: verbatim
12439 #: ../src/guestfs-actions.pod:4526
12440 #, no-wrap
12441 msgid ""
12442 " int\n"
12443 " guestfs_mount_options (guestfs_h *g,\n"
12444 "                        const char *options,\n"
12445 "                        const char *device,\n"
12446 "                        const char *mountpoint);\n"
12447 "\n"
12448 msgstr ""
12449
12450 #. type: textblock
12451 #: ../src/guestfs-actions.pod:4532
12452 msgid ""
12453 "This is the same as the C<guestfs_mount> command, but it allows you to set "
12454 "the mount options as for the L<mount(8)> I<-o> flag."
12455 msgstr ""
12456
12457 #. type: textblock
12458 #: ../src/guestfs-actions.pod:4536 ../fish/guestfish-actions.pod:3043
12459 msgid ""
12460 "If the C<options> parameter is an empty string, then no options are passed "
12461 "(all options default to whatever the filesystem uses)."
12462 msgstr ""
12463
12464 #. type: textblock
12465 #: ../src/guestfs-actions.pod:4542 ../src/guestfs-actions.pod:4556 ../src/guestfs-actions.pod:4573
12466 msgid "(Added in 1.0.10)"
12467 msgstr ""
12468
12469 #. type: =head2
12470 #: ../src/guestfs-actions.pod:4544
12471 msgid "guestfs_mount_ro"
12472 msgstr ""
12473
12474 #. type: verbatim
12475 #: ../src/guestfs-actions.pod:4546
12476 #, no-wrap
12477 msgid ""
12478 " int\n"
12479 " guestfs_mount_ro (guestfs_h *g,\n"
12480 "                   const char *device,\n"
12481 "                   const char *mountpoint);\n"
12482 "\n"
12483 msgstr ""
12484
12485 #. type: textblock
12486 #: ../src/guestfs-actions.pod:4551
12487 msgid ""
12488 "This is the same as the C<guestfs_mount> command, but it mounts the "
12489 "filesystem with the read-only (I<-o ro>) flag."
12490 msgstr ""
12491
12492 #. type: =head2
12493 #: ../src/guestfs-actions.pod:4558
12494 msgid "guestfs_mount_vfs"
12495 msgstr ""
12496
12497 #. type: verbatim
12498 #: ../src/guestfs-actions.pod:4560
12499 #, no-wrap
12500 msgid ""
12501 " int\n"
12502 " guestfs_mount_vfs (guestfs_h *g,\n"
12503 "                    const char *options,\n"
12504 "                    const char *vfstype,\n"
12505 "                    const char *device,\n"
12506 "                    const char *mountpoint);\n"
12507 "\n"
12508 msgstr ""
12509
12510 #. type: textblock
12511 #: ../src/guestfs-actions.pod:4567
12512 msgid ""
12513 "This is the same as the C<guestfs_mount> command, but it allows you to set "
12514 "both the mount options and the vfstype as for the L<mount(8)> I<-o> and "
12515 "I<-t> flags."
12516 msgstr ""
12517
12518 #. type: =head2
12519 #: ../src/guestfs-actions.pod:4575
12520 msgid "guestfs_mountpoints"
12521 msgstr ""
12522
12523 #. type: verbatim
12524 #: ../src/guestfs-actions.pod:4577
12525 #, no-wrap
12526 msgid ""
12527 " char **\n"
12528 " guestfs_mountpoints (guestfs_h *g);\n"
12529 "\n"
12530 msgstr ""
12531
12532 #. type: textblock
12533 #: ../src/guestfs-actions.pod:4580
12534 msgid ""
12535 "This call is similar to C<guestfs_mounts>.  That call returns a list of "
12536 "devices.  This one returns a hash table (map) of device name to directory "
12537 "where the device is mounted."
12538 msgstr ""
12539
12540 #. type: =head2
12541 #: ../src/guestfs-actions.pod:4592
12542 msgid "guestfs_mounts"
12543 msgstr ""
12544
12545 #. type: verbatim
12546 #: ../src/guestfs-actions.pod:4594
12547 #, no-wrap
12548 msgid ""
12549 " char **\n"
12550 " guestfs_mounts (guestfs_h *g);\n"
12551 "\n"
12552 msgstr ""
12553
12554 #. type: textblock
12555 #: ../src/guestfs-actions.pod:4597 ../fish/guestfish-actions.pod:3074
12556 msgid ""
12557 "This returns the list of currently mounted filesystems.  It returns the list "
12558 "of devices (eg. C</dev/sda1>, C</dev/VG/LV>)."
12559 msgstr ""
12560
12561 #. type: textblock
12562 #: ../src/guestfs-actions.pod:4600 ../fish/guestfish-actions.pod:3077
12563 msgid "Some internal mounts are not shown."
12564 msgstr ""
12565
12566 #. type: textblock
12567 #: ../src/guestfs-actions.pod:4602
12568 msgid "See also: C<guestfs_mountpoints>"
12569 msgstr ""
12570
12571 #. type: =head2
12572 #: ../src/guestfs-actions.pod:4610
12573 msgid "guestfs_mv"
12574 msgstr ""
12575
12576 #. type: verbatim
12577 #: ../src/guestfs-actions.pod:4612
12578 #, no-wrap
12579 msgid ""
12580 " int\n"
12581 " guestfs_mv (guestfs_h *g,\n"
12582 "             const char *src,\n"
12583 "             const char *dest);\n"
12584 "\n"
12585 msgstr ""
12586
12587 #. type: textblock
12588 #: ../src/guestfs-actions.pod:4617 ../fish/guestfish-actions.pod:3085
12589 msgid ""
12590 "This moves a file from C<src> to C<dest> where C<dest> is either a "
12591 "destination filename or destination directory."
12592 msgstr ""
12593
12594 #. type: =head2
12595 #: ../src/guestfs-actions.pod:4624
12596 msgid "guestfs_ntfs_3g_probe"
12597 msgstr ""
12598
12599 #. type: verbatim
12600 #: ../src/guestfs-actions.pod:4626
12601 #, no-wrap
12602 msgid ""
12603 " int\n"
12604 " guestfs_ntfs_3g_probe (guestfs_h *g,\n"
12605 "                        int rw,\n"
12606 "                        const char *device);\n"
12607 "\n"
12608 msgstr ""
12609
12610 #. type: textblock
12611 #: ../src/guestfs-actions.pod:4631 ../fish/guestfish-actions.pod:3092
12612 msgid ""
12613 "This command runs the L<ntfs-3g.probe(8)> command which probes an NTFS "
12614 "C<device> for mountability.  (Not all NTFS volumes can be mounted "
12615 "read-write, and some cannot be mounted at all)."
12616 msgstr ""
12617
12618 #. type: textblock
12619 #: ../src/guestfs-actions.pod:4635 ../fish/guestfish-actions.pod:3096
12620 msgid ""
12621 "C<rw> is a boolean flag.  Set it to true if you want to test if the volume "
12622 "can be mounted read-write.  Set it to false if you want to test if the "
12623 "volume can be mounted read-only."
12624 msgstr ""
12625
12626 #. type: textblock
12627 #: ../src/guestfs-actions.pod:4639 ../fish/guestfish-actions.pod:3100
12628 msgid ""
12629 "The return value is an integer which C<0> if the operation would succeed, or "
12630 "some non-zero value documented in the L<ntfs-3g.probe(8)> manual page."
12631 msgstr ""
12632
12633 #. type: textblock
12634 #: ../src/guestfs-actions.pod:4645
12635 msgid "(Added in 1.0.43)"
12636 msgstr ""
12637
12638 #. type: =head2
12639 #: ../src/guestfs-actions.pod:4647
12640 msgid "guestfs_ntfsresize"
12641 msgstr ""
12642
12643 #. type: verbatim
12644 #: ../src/guestfs-actions.pod:4649
12645 #, no-wrap
12646 msgid ""
12647 " int\n"
12648 " guestfs_ntfsresize (guestfs_h *g,\n"
12649 "                     const char *device);\n"
12650 "\n"
12651 msgstr ""
12652
12653 #. type: textblock
12654 #: ../src/guestfs-actions.pod:4653 ../fish/guestfish-actions.pod:3108
12655 msgid ""
12656 "This command resizes an NTFS filesystem, expanding or shrinking it to the "
12657 "size of the underlying device."
12658 msgstr ""
12659
12660 #. type: textblock
12661 #: ../src/guestfs-actions.pod:4656 ../fish/guestfish-actions.pod:3111
12662 msgid ""
12663 "I<Note:> After the resize operation, the filesystem is marked as requiring a "
12664 "consistency check (for safety).  You have to boot into Windows to perform "
12665 "this check and clear this condition.  Furthermore, ntfsresize refuses to "
12666 "resize filesystems which have been marked in this way.  So in effect it is "
12667 "not possible to call ntfsresize multiple times on a single filesystem "
12668 "without booting into Windows between each resize."
12669 msgstr ""
12670
12671 #. type: textblock
12672 #: ../src/guestfs-actions.pod:4664 ../fish/guestfish-actions.pod:3119
12673 msgid "See also L<ntfsresize(8)>."
12674 msgstr ""
12675
12676 #. type: =head2
12677 #: ../src/guestfs-actions.pod:4670
12678 msgid "guestfs_ntfsresize_size"
12679 msgstr ""
12680
12681 #. type: verbatim
12682 #: ../src/guestfs-actions.pod:4672
12683 #, no-wrap
12684 msgid ""
12685 " int\n"
12686 " guestfs_ntfsresize_size (guestfs_h *g,\n"
12687 "                          const char *device,\n"
12688 "                          int64_t size);\n"
12689 "\n"
12690 msgstr ""
12691
12692 #. type: textblock
12693 #: ../src/guestfs-actions.pod:4677
12694 msgid ""
12695 "This command is the same as C<guestfs_ntfsresize> except that it allows you "
12696 "to specify the new size (in bytes) explicitly."
12697 msgstr ""
12698
12699 #. type: textblock
12700 #: ../src/guestfs-actions.pod:4682 ../src/guestfs-actions.pod:5118 ../src/guestfs-actions.pod:5191 ../src/guestfs-actions.pod:5440 ../src/guestfs-actions.pod:6979
12701 msgid "(Added in 1.3.14)"
12702 msgstr ""
12703
12704 #. type: =head2
12705 #: ../src/guestfs-actions.pod:4684
12706 msgid "guestfs_part_add"
12707 msgstr ""
12708
12709 #. type: verbatim
12710 #: ../src/guestfs-actions.pod:4686
12711 #, no-wrap
12712 msgid ""
12713 " int\n"
12714 " guestfs_part_add (guestfs_h *g,\n"
12715 "                   const char *device,\n"
12716 "                   const char *prlogex,\n"
12717 "                   int64_t startsect,\n"
12718 "                   int64_t endsect);\n"
12719 "\n"
12720 msgstr ""
12721
12722 #. type: textblock
12723 #: ../src/guestfs-actions.pod:4693
12724 msgid ""
12725 "This command adds a partition to C<device>.  If there is no partition table "
12726 "on the device, call C<guestfs_part_init> first."
12727 msgstr ""
12728
12729 #. type: textblock
12730 #: ../src/guestfs-actions.pod:4696 ../fish/guestfish-actions.pod:3135
12731 msgid ""
12732 "The C<prlogex> parameter is the type of partition.  Normally you should pass "
12733 "C<p> or C<primary> here, but MBR partition tables also support C<l> (or "
12734 "C<logical>) and C<e> (or C<extended>) partition types."
12735 msgstr ""
12736
12737 #. type: textblock
12738 #: ../src/guestfs-actions.pod:4701 ../fish/guestfish-actions.pod:3140
12739 msgid ""
12740 "C<startsect> and C<endsect> are the start and end of the partition in "
12741 "I<sectors>.  C<endsect> may be negative, which means it counts backwards "
12742 "from the end of the disk (C<-1> is the last sector)."
12743 msgstr ""
12744
12745 #. type: textblock
12746 #: ../src/guestfs-actions.pod:4705
12747 msgid ""
12748 "Creating a partition which covers the whole disk is not so easy.  Use "
12749 "C<guestfs_part_disk> to do that."
12750 msgstr ""
12751
12752 #. type: textblock
12753 #: ../src/guestfs-actions.pod:4710 ../src/guestfs-actions.pod:4748 ../src/guestfs-actions.pod:4801 ../src/guestfs-actions.pod:4879 ../src/guestfs-actions.pod:4917 ../src/guestfs-actions.pod:4936 ../src/guestfs-actions.pod:4976
12754 msgid "(Added in 1.0.78)"
12755 msgstr ""
12756
12757 #. type: =head2
12758 #: ../src/guestfs-actions.pod:4712
12759 msgid "guestfs_part_del"
12760 msgstr ""
12761
12762 #. type: verbatim
12763 #: ../src/guestfs-actions.pod:4714
12764 #, no-wrap
12765 msgid ""
12766 " int\n"
12767 " guestfs_part_del (guestfs_h *g,\n"
12768 "                   const char *device,\n"
12769 "                   int partnum);\n"
12770 "\n"
12771 msgstr ""
12772
12773 #. type: textblock
12774 #: ../src/guestfs-actions.pod:4719 ../fish/guestfish-actions.pod:3151
12775 msgid "This command deletes the partition numbered C<partnum> on C<device>."
12776 msgstr ""
12777
12778 #. type: textblock
12779 #: ../src/guestfs-actions.pod:4721 ../fish/guestfish-actions.pod:3153
12780 msgid ""
12781 "Note that in the case of MBR partitioning, deleting an extended partition "
12782 "also deletes any logical partitions it contains."
12783 msgstr ""
12784
12785 #. type: =head2
12786 #: ../src/guestfs-actions.pod:4729
12787 msgid "guestfs_part_disk"
12788 msgstr ""
12789
12790 #. type: verbatim
12791 #: ../src/guestfs-actions.pod:4731
12792 #, no-wrap
12793 msgid ""
12794 " int\n"
12795 " guestfs_part_disk (guestfs_h *g,\n"
12796 "                    const char *device,\n"
12797 "                    const char *parttype);\n"
12798 "\n"
12799 msgstr ""
12800
12801 #. type: textblock
12802 #: ../src/guestfs-actions.pod:4736
12803 msgid ""
12804 "This command is simply a combination of C<guestfs_part_init> followed by "
12805 "C<guestfs_part_add> to create a single primary partition covering the whole "
12806 "disk."
12807 msgstr ""
12808
12809 #. type: textblock
12810 #: ../src/guestfs-actions.pod:4740
12811 msgid ""
12812 "C<parttype> is the partition table type, usually C<mbr> or C<gpt>, but other "
12813 "possible values are described in C<guestfs_part_init>."
12814 msgstr ""
12815
12816 #. type: =head2
12817 #: ../src/guestfs-actions.pod:4750
12818 msgid "guestfs_part_get_bootable"
12819 msgstr ""
12820
12821 #. type: verbatim
12822 #: ../src/guestfs-actions.pod:4752
12823 #, no-wrap
12824 msgid ""
12825 " int\n"
12826 " guestfs_part_get_bootable (guestfs_h *g,\n"
12827 "                            const char *device,\n"
12828 "                            int partnum);\n"
12829 "\n"
12830 msgstr ""
12831
12832 #. type: textblock
12833 #: ../src/guestfs-actions.pod:4757 ../fish/guestfish-actions.pod:3175
12834 msgid ""
12835 "This command returns true if the partition C<partnum> on C<device> has the "
12836 "bootable flag set."
12837 msgstr ""
12838
12839 #. type: textblock
12840 #: ../src/guestfs-actions.pod:4760
12841 msgid "See also C<guestfs_part_set_bootable>."
12842 msgstr ""
12843
12844 #. type: =head2
12845 #: ../src/guestfs-actions.pod:4766
12846 msgid "guestfs_part_get_mbr_id"
12847 msgstr ""
12848
12849 #. type: verbatim
12850 #: ../src/guestfs-actions.pod:4768
12851 #, no-wrap
12852 msgid ""
12853 " int\n"
12854 " guestfs_part_get_mbr_id (guestfs_h *g,\n"
12855 "                          const char *device,\n"
12856 "                          int partnum);\n"
12857 "\n"
12858 msgstr ""
12859
12860 #. type: textblock
12861 #: ../src/guestfs-actions.pod:4773 ../fish/guestfish-actions.pod:3184
12862 msgid ""
12863 "Returns the MBR type byte (also known as the ID byte) from the numbered "
12864 "partition C<partnum>."
12865 msgstr ""
12866
12867 #. type: textblock
12868 #: ../src/guestfs-actions.pod:4776 ../src/guestfs-actions.pod:4952
12869 msgid ""
12870 "Note that only MBR (old DOS-style) partitions have type bytes.  You will get "
12871 "undefined results for other partition table types (see "
12872 "C<guestfs_part_get_parttype>)."
12873 msgstr ""
12874
12875 #. type: =head2
12876 #: ../src/guestfs-actions.pod:4784
12877 msgid "guestfs_part_get_parttype"
12878 msgstr ""
12879
12880 #. type: verbatim
12881 #: ../src/guestfs-actions.pod:4786
12882 #, no-wrap
12883 msgid ""
12884 " char *\n"
12885 " guestfs_part_get_parttype (guestfs_h *g,\n"
12886 "                            const char *device);\n"
12887 "\n"
12888 msgstr ""
12889
12890 #. type: textblock
12891 #: ../src/guestfs-actions.pod:4790 ../fish/guestfish-actions.pod:3195
12892 msgid ""
12893 "This command examines the partition table on C<device> and returns the "
12894 "partition table type (format) being used."
12895 msgstr ""
12896
12897 #. type: textblock
12898 #: ../src/guestfs-actions.pod:4793
12899 msgid ""
12900 "Common return values include: C<msdos> (a DOS/Windows style MBR partition "
12901 "table), C<gpt> (a GPT/EFI-style partition table).  Other values are "
12902 "possible, although unusual.  See C<guestfs_part_init> for a full list."
12903 msgstr ""
12904
12905 #. type: =head2
12906 #: ../src/guestfs-actions.pod:4803
12907 msgid "guestfs_part_init"
12908 msgstr ""
12909
12910 #. type: verbatim
12911 #: ../src/guestfs-actions.pod:4805
12912 #, no-wrap
12913 msgid ""
12914 " int\n"
12915 " guestfs_part_init (guestfs_h *g,\n"
12916 "                    const char *device,\n"
12917 "                    const char *parttype);\n"
12918 "\n"
12919 msgstr ""
12920
12921 #. type: textblock
12922 #: ../src/guestfs-actions.pod:4810 ../fish/guestfish-actions.pod:3207
12923 msgid ""
12924 "This creates an empty partition table on C<device> of one of the partition "
12925 "types listed below.  Usually C<parttype> should be either C<msdos> or C<gpt> "
12926 "(for large disks)."
12927 msgstr ""
12928
12929 #. type: textblock
12930 #: ../src/guestfs-actions.pod:4814
12931 msgid ""
12932 "Initially there are no partitions.  Following this, you should call "
12933 "C<guestfs_part_add> for each partition required."
12934 msgstr ""
12935
12936 #. type: textblock
12937 #: ../src/guestfs-actions.pod:4817 ../fish/guestfish-actions.pod:3214
12938 msgid "Possible values for C<parttype> are:"
12939 msgstr ""
12940
12941 #. type: =item
12942 #: ../src/guestfs-actions.pod:4821 ../fish/guestfish-actions.pod:3218
12943 msgid "B<efi> | B<gpt>"
12944 msgstr ""
12945
12946 #. type: textblock
12947 #: ../src/guestfs-actions.pod:4823 ../fish/guestfish-actions.pod:3220
12948 msgid "Intel EFI / GPT partition table."
12949 msgstr ""
12950
12951 #. type: textblock
12952 #: ../src/guestfs-actions.pod:4825 ../fish/guestfish-actions.pod:3222
12953 msgid ""
12954 "This is recommended for >= 2 TB partitions that will be accessed from Linux "
12955 "and Intel-based Mac OS X.  It also has limited backwards compatibility with "
12956 "the C<mbr> format."
12957 msgstr ""
12958
12959 #. type: =item
12960 #: ../src/guestfs-actions.pod:4829 ../fish/guestfish-actions.pod:3226
12961 msgid "B<mbr> | B<msdos>"
12962 msgstr ""
12963
12964 #. type: textblock
12965 #: ../src/guestfs-actions.pod:4831 ../fish/guestfish-actions.pod:3228
12966 msgid ""
12967 "The standard PC \"Master Boot Record\" (MBR) format used by MS-DOS and "
12968 "Windows.  This partition type will B<only> work for device sizes up to 2 "
12969 "TB.  For large disks we recommend using C<gpt>."
12970 msgstr ""
12971
12972 #. type: textblock
12973 #: ../src/guestfs-actions.pod:4838 ../fish/guestfish-actions.pod:3235
12974 msgid "Other partition table types that may work but are not supported include:"
12975 msgstr ""
12976
12977 #. type: =item
12978 #: ../src/guestfs-actions.pod:4843 ../fish/guestfish-actions.pod:3240
12979 msgid "B<aix>"
12980 msgstr ""
12981
12982 #. type: textblock
12983 #: ../src/guestfs-actions.pod:4845 ../fish/guestfish-actions.pod:3242
12984 msgid "AIX disk labels."
12985 msgstr ""
12986
12987 #. type: =item
12988 #: ../src/guestfs-actions.pod:4847 ../fish/guestfish-actions.pod:3244
12989 msgid "B<amiga> | B<rdb>"
12990 msgstr ""
12991
12992 #. type: textblock
12993 #: ../src/guestfs-actions.pod:4849 ../fish/guestfish-actions.pod:3246
12994 msgid "Amiga \"Rigid Disk Block\" format."
12995 msgstr ""
12996
12997 #. type: =item
12998 #: ../src/guestfs-actions.pod:4851 ../fish/guestfish-actions.pod:3248
12999 msgid "B<bsd>"
13000 msgstr ""
13001
13002 #. type: textblock
13003 #: ../src/guestfs-actions.pod:4853 ../fish/guestfish-actions.pod:3250
13004 msgid "BSD disk labels."
13005 msgstr ""
13006
13007 #. type: =item
13008 #: ../src/guestfs-actions.pod:4855 ../fish/guestfish-actions.pod:3252
13009 msgid "B<dasd>"
13010 msgstr ""
13011
13012 #. type: textblock
13013 #: ../src/guestfs-actions.pod:4857 ../fish/guestfish-actions.pod:3254
13014 msgid "DASD, used on IBM mainframes."
13015 msgstr ""
13016
13017 #. type: =item
13018 #: ../src/guestfs-actions.pod:4859 ../fish/guestfish-actions.pod:3256
13019 msgid "B<dvh>"
13020 msgstr ""
13021
13022 #. type: textblock
13023 #: ../src/guestfs-actions.pod:4861 ../fish/guestfish-actions.pod:3258
13024 msgid "MIPS/SGI volumes."
13025 msgstr ""
13026
13027 #. type: =item
13028 #: ../src/guestfs-actions.pod:4863 ../fish/guestfish-actions.pod:3260
13029 msgid "B<mac>"
13030 msgstr ""
13031
13032 #. type: textblock
13033 #: ../src/guestfs-actions.pod:4865 ../fish/guestfish-actions.pod:3262
13034 msgid "Old Mac partition format.  Modern Macs use C<gpt>."
13035 msgstr ""
13036
13037 #. type: =item
13038 #: ../src/guestfs-actions.pod:4867 ../fish/guestfish-actions.pod:3264
13039 msgid "B<pc98>"
13040 msgstr ""
13041
13042 #. type: textblock
13043 #: ../src/guestfs-actions.pod:4869 ../fish/guestfish-actions.pod:3266
13044 msgid "NEC PC-98 format, common in Japan apparently."
13045 msgstr ""
13046
13047 #. type: =item
13048 #: ../src/guestfs-actions.pod:4871 ../fish/guestfish-actions.pod:3268
13049 msgid "B<sun>"
13050 msgstr ""
13051
13052 #. type: textblock
13053 #: ../src/guestfs-actions.pod:4873 ../fish/guestfish-actions.pod:3270
13054 msgid "Sun disk labels."
13055 msgstr ""
13056
13057 #. type: =head2
13058 #: ../src/guestfs-actions.pod:4881
13059 msgid "guestfs_part_list"
13060 msgstr ""
13061
13062 #. type: verbatim
13063 #: ../src/guestfs-actions.pod:4883
13064 #, no-wrap
13065 msgid ""
13066 " struct guestfs_partition_list *\n"
13067 " guestfs_part_list (guestfs_h *g,\n"
13068 "                    const char *device);\n"
13069 "\n"
13070 msgstr ""
13071
13072 #. type: textblock
13073 #: ../src/guestfs-actions.pod:4887 ../fish/guestfish-actions.pod:3278
13074 msgid ""
13075 "This command parses the partition table on C<device> and returns the list of "
13076 "partitions found."
13077 msgstr ""
13078
13079 #. type: textblock
13080 #: ../src/guestfs-actions.pod:4890 ../fish/guestfish-actions.pod:3281
13081 msgid "The fields in the returned structure are:"
13082 msgstr ""
13083
13084 #. type: =item
13085 #: ../src/guestfs-actions.pod:4894 ../fish/guestfish-actions.pod:3285
13086 msgid "B<part_num>"
13087 msgstr ""
13088
13089 #. type: textblock
13090 #: ../src/guestfs-actions.pod:4896 ../fish/guestfish-actions.pod:3287
13091 msgid "Partition number, counting from 1."
13092 msgstr ""
13093
13094 #. type: =item
13095 #: ../src/guestfs-actions.pod:4898 ../fish/guestfish-actions.pod:3289
13096 msgid "B<part_start>"
13097 msgstr ""
13098
13099 #. type: textblock
13100 #: ../src/guestfs-actions.pod:4900
13101 msgid ""
13102 "Start of the partition I<in bytes>.  To get sectors you have to divide by "
13103 "the device's sector size, see C<guestfs_blockdev_getss>."
13104 msgstr ""
13105
13106 #. type: =item
13107 #: ../src/guestfs-actions.pod:4903 ../fish/guestfish-actions.pod:3294
13108 msgid "B<part_end>"
13109 msgstr ""
13110
13111 #. type: textblock
13112 #: ../src/guestfs-actions.pod:4905 ../fish/guestfish-actions.pod:3296
13113 msgid "End of the partition in bytes."
13114 msgstr ""
13115
13116 #. type: =item
13117 #: ../src/guestfs-actions.pod:4907 ../fish/guestfish-actions.pod:3298
13118 msgid "B<part_size>"
13119 msgstr ""
13120
13121 #. type: textblock
13122 #: ../src/guestfs-actions.pod:4909 ../fish/guestfish-actions.pod:3300
13123 msgid "Size of the partition in bytes."
13124 msgstr ""
13125
13126 #. type: textblock
13127 #: ../src/guestfs-actions.pod:4913
13128 msgid ""
13129 "This function returns a C<struct guestfs_partition_list *>, or NULL if there "
13130 "was an error.  I<The caller must call C<guestfs_free_partition_list> after "
13131 "use>."
13132 msgstr ""
13133
13134 #. type: =head2
13135 #: ../src/guestfs-actions.pod:4919
13136 msgid "guestfs_part_set_bootable"
13137 msgstr ""
13138
13139 #. type: verbatim
13140 #: ../src/guestfs-actions.pod:4921
13141 #, no-wrap
13142 msgid ""
13143 " int\n"
13144 " guestfs_part_set_bootable (guestfs_h *g,\n"
13145 "                            const char *device,\n"
13146 "                            int partnum,\n"
13147 "                            int bootable);\n"
13148 "\n"
13149 msgstr ""
13150
13151 #. type: textblock
13152 #: ../src/guestfs-actions.pod:4927 ../fish/guestfish-actions.pod:3308
13153 msgid ""
13154 "This sets the bootable flag on partition numbered C<partnum> on device "
13155 "C<device>.  Note that partitions are numbered from 1."
13156 msgstr ""
13157
13158 #. type: textblock
13159 #: ../src/guestfs-actions.pod:4930 ../fish/guestfish-actions.pod:3311
13160 msgid ""
13161 "The bootable flag is used by some operating systems (notably Windows) to "
13162 "determine which partition to boot from.  It is by no means universally "
13163 "recognized."
13164 msgstr ""
13165
13166 #. type: =head2
13167 #: ../src/guestfs-actions.pod:4938
13168 msgid "guestfs_part_set_mbr_id"
13169 msgstr ""
13170
13171 #. type: verbatim
13172 #: ../src/guestfs-actions.pod:4940
13173 #, no-wrap
13174 msgid ""
13175 " int\n"
13176 " guestfs_part_set_mbr_id (guestfs_h *g,\n"
13177 "                          const char *device,\n"
13178 "                          int partnum,\n"
13179 "                          int idbyte);\n"
13180 "\n"
13181 msgstr ""
13182
13183 #. type: textblock
13184 #: ../src/guestfs-actions.pod:4946 ../fish/guestfish-actions.pod:3319
13185 msgid ""
13186 "Sets the MBR type byte (also known as the ID byte) of the numbered partition "
13187 "C<partnum> to C<idbyte>.  Note that the type bytes quoted in most "
13188 "documentation are in fact hexadecimal numbers, but usually documented "
13189 "without any leading \"0x\" which might be confusing."
13190 msgstr ""
13191
13192 #. type: =head2
13193 #: ../src/guestfs-actions.pod:4960
13194 msgid "guestfs_part_set_name"
13195 msgstr ""
13196
13197 #. type: verbatim
13198 #: ../src/guestfs-actions.pod:4962
13199 #, no-wrap
13200 msgid ""
13201 " int\n"
13202 " guestfs_part_set_name (guestfs_h *g,\n"
13203 "                        const char *device,\n"
13204 "                        int partnum,\n"
13205 "                        const char *name);\n"
13206 "\n"
13207 msgstr ""
13208
13209 #. type: textblock
13210 #: ../src/guestfs-actions.pod:4968 ../fish/guestfish-actions.pod:3333
13211 msgid ""
13212 "This sets the partition name on partition numbered C<partnum> on device "
13213 "C<device>.  Note that partitions are numbered from 1."
13214 msgstr ""
13215
13216 #. type: textblock
13217 #: ../src/guestfs-actions.pod:4971 ../fish/guestfish-actions.pod:3336
13218 msgid ""
13219 "The partition name can only be set on certain types of partition table.  "
13220 "This works on C<gpt> but not on C<mbr> partitions."
13221 msgstr ""
13222
13223 #. type: =head2
13224 #: ../src/guestfs-actions.pod:4978
13225 msgid "guestfs_part_to_dev"
13226 msgstr ""
13227
13228 #. type: verbatim
13229 #: ../src/guestfs-actions.pod:4980
13230 #, no-wrap
13231 msgid ""
13232 " char *\n"
13233 " guestfs_part_to_dev (guestfs_h *g,\n"
13234 "                      const char *partition);\n"
13235 "\n"
13236 msgstr ""
13237
13238 #. type: textblock
13239 #: ../src/guestfs-actions.pod:4984 ../fish/guestfish-actions.pod:3343
13240 msgid ""
13241 "This function takes a partition name (eg. \"/dev/sdb1\") and removes the "
13242 "partition number, returning the device name (eg. \"/dev/sdb\")."
13243 msgstr ""
13244
13245 #. type: textblock
13246 #: ../src/guestfs-actions.pod:4988
13247 msgid ""
13248 "The named partition must exist, for example as a string returned from "
13249 "C<guestfs_list_partitions>."
13250 msgstr ""
13251
13252 #. type: =head2
13253 #: ../src/guestfs-actions.pod:4996
13254 msgid "guestfs_ping_daemon"
13255 msgstr ""
13256
13257 #. type: verbatim
13258 #: ../src/guestfs-actions.pod:4998
13259 #, no-wrap
13260 msgid ""
13261 " int\n"
13262 " guestfs_ping_daemon (guestfs_h *g);\n"
13263 "\n"
13264 msgstr ""
13265
13266 #. type: textblock
13267 #: ../src/guestfs-actions.pod:5001 ../fish/guestfish-actions.pod:3354
13268 msgid ""
13269 "This is a test probe into the guestfs daemon running inside the qemu "
13270 "subprocess.  Calling this function checks that the daemon responds to the "
13271 "ping message, without affecting the daemon or attached block device(s) in "
13272 "any other way."
13273 msgstr ""
13274
13275 #. type: =head2
13276 #: ../src/guestfs-actions.pod:5010
13277 msgid "guestfs_pread"
13278 msgstr ""
13279
13280 #. type: verbatim
13281 #: ../src/guestfs-actions.pod:5012
13282 #, no-wrap
13283 msgid ""
13284 " char *\n"
13285 " guestfs_pread (guestfs_h *g,\n"
13286 "                const char *path,\n"
13287 "                int count,\n"
13288 "                int64_t offset,\n"
13289 "                size_t *size_r);\n"
13290 "\n"
13291 msgstr ""
13292
13293 #. type: textblock
13294 #: ../src/guestfs-actions.pod:5019 ../fish/guestfish-actions.pod:3363
13295 msgid ""
13296 "This command lets you read part of a file.  It reads C<count> bytes of the "
13297 "file, starting at C<offset>, from file C<path>."
13298 msgstr ""
13299
13300 #. type: textblock
13301 #: ../src/guestfs-actions.pod:5022 ../src/guestfs-actions.pod:5048 ../fish/guestfish-actions.pod:3366 ../fish/guestfish-actions.pod:3381
13302 msgid ""
13303 "This may read fewer bytes than requested.  For further details see the "
13304 "L<pread(2)> system call."
13305 msgstr ""
13306
13307 #. type: textblock
13308 #: ../src/guestfs-actions.pod:5025
13309 msgid "See also C<guestfs_pwrite>, C<guestfs_pread_device>."
13310 msgstr ""
13311
13312 #. type: =head2
13313 #: ../src/guestfs-actions.pod:5036
13314 msgid "guestfs_pread_device"
13315 msgstr ""
13316
13317 #. type: verbatim
13318 #: ../src/guestfs-actions.pod:5038
13319 #, no-wrap
13320 msgid ""
13321 " char *\n"
13322 " guestfs_pread_device (guestfs_h *g,\n"
13323 "                       const char *device,\n"
13324 "                       int count,\n"
13325 "                       int64_t offset,\n"
13326 "                       size_t *size_r);\n"
13327 "\n"
13328 msgstr ""
13329
13330 #. type: textblock
13331 #: ../src/guestfs-actions.pod:5045 ../fish/guestfish-actions.pod:3378
13332 msgid ""
13333 "This command lets you read part of a file.  It reads C<count> bytes of "
13334 "C<device>, starting at C<offset>."
13335 msgstr ""
13336
13337 #. type: textblock
13338 #: ../src/guestfs-actions.pod:5051
13339 msgid "See also C<guestfs_pread>."
13340 msgstr ""
13341
13342 #. type: textblock
13343 #: ../src/guestfs-actions.pod:5060
13344 msgid "(Added in 1.5.21)"
13345 msgstr ""
13346
13347 #. type: =head2
13348 #: ../src/guestfs-actions.pod:5062
13349 msgid "guestfs_pvcreate"
13350 msgstr ""
13351
13352 #. type: verbatim
13353 #: ../src/guestfs-actions.pod:5064
13354 #, no-wrap
13355 msgid ""
13356 " int\n"
13357 " guestfs_pvcreate (guestfs_h *g,\n"
13358 "                   const char *device);\n"
13359 "\n"
13360 msgstr ""
13361
13362 #. type: textblock
13363 #: ../src/guestfs-actions.pod:5068 ../fish/guestfish-actions.pod:3393
13364 msgid ""
13365 "This creates an LVM physical volume on the named C<device>, where C<device> "
13366 "should usually be a partition name such as C</dev/sda1>."
13367 msgstr ""
13368
13369 #. type: =head2
13370 #: ../src/guestfs-actions.pod:5076
13371 msgid "guestfs_pvremove"
13372 msgstr ""
13373
13374 #. type: verbatim
13375 #: ../src/guestfs-actions.pod:5078
13376 #, no-wrap
13377 msgid ""
13378 " int\n"
13379 " guestfs_pvremove (guestfs_h *g,\n"
13380 "                   const char *device);\n"
13381 "\n"
13382 msgstr ""
13383
13384 #. type: textblock
13385 #: ../src/guestfs-actions.pod:5082 ../fish/guestfish-actions.pod:3401
13386 msgid ""
13387 "This wipes a physical volume C<device> so that LVM will no longer recognise "
13388 "it."
13389 msgstr ""
13390
13391 #. type: textblock
13392 #: ../src/guestfs-actions.pod:5085 ../fish/guestfish-actions.pod:3404
13393 msgid ""
13394 "The implementation uses the C<pvremove> command which refuses to wipe "
13395 "physical volumes that contain any volume groups, so you have to remove those "
13396 "first."
13397 msgstr ""
13398
13399 #. type: =head2
13400 #: ../src/guestfs-actions.pod:5093
13401 msgid "guestfs_pvresize"
13402 msgstr ""
13403
13404 #. type: verbatim
13405 #: ../src/guestfs-actions.pod:5095
13406 #, no-wrap
13407 msgid ""
13408 " int\n"
13409 " guestfs_pvresize (guestfs_h *g,\n"
13410 "                   const char *device);\n"
13411 "\n"
13412 msgstr ""
13413
13414 #. type: textblock
13415 #: ../src/guestfs-actions.pod:5099 ../fish/guestfish-actions.pod:3412
13416 msgid ""
13417 "This resizes (expands or shrinks) an existing LVM physical volume to match "
13418 "the new size of the underlying device."
13419 msgstr ""
13420
13421 #. type: =head2
13422 #: ../src/guestfs-actions.pod:5106
13423 msgid "guestfs_pvresize_size"
13424 msgstr ""
13425
13426 #. type: verbatim
13427 #: ../src/guestfs-actions.pod:5108
13428 #, no-wrap
13429 msgid ""
13430 " int\n"
13431 " guestfs_pvresize_size (guestfs_h *g,\n"
13432 "                        const char *device,\n"
13433 "                        int64_t size);\n"
13434 "\n"
13435 msgstr ""
13436
13437 #. type: textblock
13438 #: ../src/guestfs-actions.pod:5113
13439 msgid ""
13440 "This command is the same as C<guestfs_pvresize> except that it allows you to "
13441 "specify the new size (in bytes) explicitly."
13442 msgstr ""
13443
13444 #. type: =head2
13445 #: ../src/guestfs-actions.pod:5120
13446 msgid "guestfs_pvs"
13447 msgstr ""
13448
13449 #. type: verbatim
13450 #: ../src/guestfs-actions.pod:5122
13451 #, no-wrap
13452 msgid ""
13453 " char **\n"
13454 " guestfs_pvs (guestfs_h *g);\n"
13455 "\n"
13456 msgstr ""
13457
13458 #. type: textblock
13459 #: ../src/guestfs-actions.pod:5125 ../fish/guestfish-actions.pod:3426
13460 msgid ""
13461 "List all the physical volumes detected.  This is the equivalent of the "
13462 "L<pvs(8)> command."
13463 msgstr ""
13464
13465 #. type: textblock
13466 #: ../src/guestfs-actions.pod:5128 ../fish/guestfish-actions.pod:3429
13467 msgid ""
13468 "This returns a list of just the device names that contain PVs "
13469 "(eg. C</dev/sda2>)."
13470 msgstr ""
13471
13472 #. type: textblock
13473 #: ../src/guestfs-actions.pod:5131
13474 msgid "See also C<guestfs_pvs_full>."
13475 msgstr ""
13476
13477 #. type: =head2
13478 #: ../src/guestfs-actions.pod:5139
13479 msgid "guestfs_pvs_full"
13480 msgstr ""
13481
13482 #. type: verbatim
13483 #: ../src/guestfs-actions.pod:5141
13484 #, no-wrap
13485 msgid ""
13486 " struct guestfs_lvm_pv_list *\n"
13487 " guestfs_pvs_full (guestfs_h *g);\n"
13488 "\n"
13489 msgstr ""
13490
13491 #. type: textblock
13492 #: ../src/guestfs-actions.pod:5144 ../fish/guestfish-actions.pod:3438
13493 msgid ""
13494 "List all the physical volumes detected.  This is the equivalent of the "
13495 "L<pvs(8)> command.  The \"full\" version includes all fields."
13496 msgstr ""
13497
13498 #. type: textblock
13499 #: ../src/guestfs-actions.pod:5147
13500 msgid ""
13501 "This function returns a C<struct guestfs_lvm_pv_list *>, or NULL if there "
13502 "was an error.  I<The caller must call C<guestfs_free_lvm_pv_list> after "
13503 "use>."
13504 msgstr ""
13505
13506 #. type: =head2
13507 #: ../src/guestfs-actions.pod:5153
13508 msgid "guestfs_pvuuid"
13509 msgstr ""
13510
13511 #. type: verbatim
13512 #: ../src/guestfs-actions.pod:5155
13513 #, no-wrap
13514 msgid ""
13515 " char *\n"
13516 " guestfs_pvuuid (guestfs_h *g,\n"
13517 "                 const char *device);\n"
13518 "\n"
13519 msgstr ""
13520
13521 #. type: textblock
13522 #: ../src/guestfs-actions.pod:5159 ../fish/guestfish-actions.pod:3445
13523 msgid "This command returns the UUID of the LVM PV C<device>."
13524 msgstr ""
13525
13526 #. type: =head2
13527 #: ../src/guestfs-actions.pod:5166
13528 msgid "guestfs_pwrite"
13529 msgstr ""
13530
13531 #. type: verbatim
13532 #: ../src/guestfs-actions.pod:5168
13533 #, no-wrap
13534 msgid ""
13535 " int\n"
13536 " guestfs_pwrite (guestfs_h *g,\n"
13537 "                 const char *path,\n"
13538 "                 const char *content,\n"
13539 "                 size_t content_size,\n"
13540 "                 int64_t offset);\n"
13541 "\n"
13542 msgstr ""
13543
13544 #. type: textblock
13545 #: ../src/guestfs-actions.pod:5175 ../fish/guestfish-actions.pod:3451
13546 msgid ""
13547 "This command writes to part of a file.  It writes the data buffer C<content> "
13548 "to the file C<path> starting at offset C<offset>."
13549 msgstr ""
13550
13551 #. type: textblock
13552 #: ../src/guestfs-actions.pod:5178 ../fish/guestfish-actions.pod:3454
13553 msgid ""
13554 "This command implements the L<pwrite(2)> system call, and like that system "
13555 "call it may not write the full data requested.  The return value is the "
13556 "number of bytes that were actually written to the file.  This could even be "
13557 "0, although short writes are unlikely for regular files in ordinary "
13558 "circumstances."
13559 msgstr ""
13560
13561 #. type: textblock
13562 #: ../src/guestfs-actions.pod:5184
13563 msgid "See also C<guestfs_pread>, C<guestfs_pwrite_device>."
13564 msgstr ""
13565
13566 #. type: =head2
13567 #: ../src/guestfs-actions.pod:5193
13568 msgid "guestfs_pwrite_device"
13569 msgstr ""
13570
13571 #. type: verbatim
13572 #: ../src/guestfs-actions.pod:5195
13573 #, no-wrap
13574 msgid ""
13575 " int\n"
13576 " guestfs_pwrite_device (guestfs_h *g,\n"
13577 "                        const char *device,\n"
13578 "                        const char *content,\n"
13579 "                        size_t content_size,\n"
13580 "                        int64_t offset);\n"
13581 "\n"
13582 msgstr ""
13583
13584 #. type: textblock
13585 #: ../src/guestfs-actions.pod:5202 ../fish/guestfish-actions.pod:3469
13586 msgid ""
13587 "This command writes to part of a device.  It writes the data buffer "
13588 "C<content> to C<device> starting at offset C<offset>."
13589 msgstr ""
13590
13591 #. type: textblock
13592 #: ../src/guestfs-actions.pod:5205 ../fish/guestfish-actions.pod:3472
13593 msgid ""
13594 "This command implements the L<pwrite(2)> system call, and like that system "
13595 "call it may not write the full data requested (although short writes to disk "
13596 "devices and partitions are probably impossible with standard Linux kernels)."
13597 msgstr ""
13598
13599 #. type: textblock
13600 #: ../src/guestfs-actions.pod:5210
13601 msgid "See also C<guestfs_pwrite>."
13602 msgstr ""
13603
13604 #. type: textblock
13605 #: ../src/guestfs-actions.pod:5217
13606 msgid "(Added in 1.5.20)"
13607 msgstr ""
13608
13609 #. type: =head2
13610 #: ../src/guestfs-actions.pod:5219
13611 msgid "guestfs_read_file"
13612 msgstr ""
13613
13614 #. type: verbatim
13615 #: ../src/guestfs-actions.pod:5221
13616 #, no-wrap
13617 msgid ""
13618 " char *\n"
13619 " guestfs_read_file (guestfs_h *g,\n"
13620 "                    const char *path,\n"
13621 "                    size_t *size_r);\n"
13622 "\n"
13623 msgstr ""
13624
13625 #. type: textblock
13626 #: ../src/guestfs-actions.pod:5226 ../fish/guestfish-actions.pod:3486
13627 msgid "This calls returns the contents of the file C<path> as a buffer."
13628 msgstr ""
13629
13630 #. type: textblock
13631 #: ../src/guestfs-actions.pod:5229
13632 msgid ""
13633 "Unlike C<guestfs_cat>, this function can correctly handle files that contain "
13634 "embedded ASCII NUL characters.  However unlike C<guestfs_download>, this "
13635 "function is limited in the total size of file that can be handled."
13636 msgstr ""
13637
13638 #. type: textblock
13639 #: ../src/guestfs-actions.pod:5241
13640 msgid "(Added in 1.0.63)"
13641 msgstr ""
13642
13643 #. type: =head2
13644 #: ../src/guestfs-actions.pod:5243
13645 msgid "guestfs_read_lines"
13646 msgstr ""
13647
13648 #. type: verbatim
13649 #: ../src/guestfs-actions.pod:5245
13650 #, no-wrap
13651 msgid ""
13652 " char **\n"
13653 " guestfs_read_lines (guestfs_h *g,\n"
13654 "                     const char *path);\n"
13655 "\n"
13656 msgstr ""
13657
13658 #. type: textblock
13659 #: ../src/guestfs-actions.pod:5251 ../fish/guestfish-actions.pod:3503
13660 msgid ""
13661 "The file contents are returned as a list of lines.  Trailing C<LF> and "
13662 "C<CRLF> character sequences are I<not> returned."
13663 msgstr ""
13664
13665 #. type: textblock
13666 #: ../src/guestfs-actions.pod:5254
13667 msgid ""
13668 "Note that this function cannot correctly handle binary files (specifically, "
13669 "files containing C<\\0> character which is treated as end of line).  For "
13670 "those you need to use the C<guestfs_read_file> function which has a more "
13671 "complex interface."
13672 msgstr ""
13673
13674 #. type: =head2
13675 #: ../src/guestfs-actions.pod:5265
13676 msgid "guestfs_readdir"
13677 msgstr ""
13678
13679 #. type: verbatim
13680 #: ../src/guestfs-actions.pod:5267
13681 #, no-wrap
13682 msgid ""
13683 " struct guestfs_dirent_list *\n"
13684 " guestfs_readdir (guestfs_h *g,\n"
13685 "                  const char *dir);\n"
13686 "\n"
13687 msgstr ""
13688
13689 #. type: textblock
13690 #: ../src/guestfs-actions.pod:5271 ../fish/guestfish-actions.pod:3515
13691 msgid "This returns the list of directory entries in directory C<dir>."
13692 msgstr ""
13693
13694 #. type: textblock
13695 #: ../src/guestfs-actions.pod:5273 ../fish/guestfish-actions.pod:3517
13696 msgid ""
13697 "All entries in the directory are returned, including C<.> and C<..>.  The "
13698 "entries are I<not> sorted, but returned in the same order as the underlying "
13699 "filesystem."
13700 msgstr ""
13701
13702 #. type: textblock
13703 #: ../src/guestfs-actions.pod:5277 ../fish/guestfish-actions.pod:3521
13704 msgid ""
13705 "Also this call returns basic file type information about each file.  The "
13706 "C<ftyp> field will contain one of the following characters:"
13707 msgstr ""
13708
13709 #. type: =item
13710 #: ../src/guestfs-actions.pod:5282 ../fish/guestfish-actions.pod:3526
13711 msgid "'b'"
13712 msgstr ""
13713
13714 #. type: textblock
13715 #: ../src/guestfs-actions.pod:5284 ../fish/guestfish-actions.pod:3528
13716 msgid "Block special"
13717 msgstr ""
13718
13719 #. type: =item
13720 #: ../src/guestfs-actions.pod:5286 ../fish/guestfish-actions.pod:3530
13721 msgid "'c'"
13722 msgstr ""
13723
13724 #. type: textblock
13725 #: ../src/guestfs-actions.pod:5288 ../fish/guestfish-actions.pod:3532
13726 msgid "Char special"
13727 msgstr ""
13728
13729 #. type: =item
13730 #: ../src/guestfs-actions.pod:5290 ../fish/guestfish-actions.pod:3534
13731 msgid "'d'"
13732 msgstr ""
13733
13734 #. type: textblock
13735 #: ../src/guestfs-actions.pod:5292 ../fish/guestfish-actions.pod:3536
13736 msgid "Directory"
13737 msgstr ""
13738
13739 #. type: =item
13740 #: ../src/guestfs-actions.pod:5294 ../fish/guestfish-actions.pod:3538
13741 msgid "'f'"
13742 msgstr ""
13743
13744 #. type: textblock
13745 #: ../src/guestfs-actions.pod:5296 ../fish/guestfish-actions.pod:3540
13746 msgid "FIFO (named pipe)"
13747 msgstr ""
13748
13749 #. type: =item
13750 #: ../src/guestfs-actions.pod:5298 ../fish/guestfish-actions.pod:3542
13751 msgid "'l'"
13752 msgstr ""
13753
13754 #. type: textblock
13755 #: ../src/guestfs-actions.pod:5300 ../fish/guestfish-actions.pod:3544
13756 msgid "Symbolic link"
13757 msgstr ""
13758
13759 #. type: =item
13760 #: ../src/guestfs-actions.pod:5302 ../fish/guestfish-actions.pod:3546
13761 msgid "'r'"
13762 msgstr ""
13763
13764 #. type: textblock
13765 #: ../src/guestfs-actions.pod:5304 ../fish/guestfish-actions.pod:3548
13766 msgid "Regular file"
13767 msgstr ""
13768
13769 #. type: =item
13770 #: ../src/guestfs-actions.pod:5306 ../fish/guestfish-actions.pod:3550
13771 msgid "'s'"
13772 msgstr ""
13773
13774 #. type: textblock
13775 #: ../src/guestfs-actions.pod:5308 ../fish/guestfish-actions.pod:3552
13776 msgid "Socket"
13777 msgstr ""
13778
13779 #. type: =item
13780 #: ../src/guestfs-actions.pod:5310 ../fish/guestfish-actions.pod:3554
13781 msgid "'u'"
13782 msgstr ""
13783
13784 #. type: textblock
13785 #: ../src/guestfs-actions.pod:5312 ../fish/guestfish-actions.pod:3556
13786 msgid "Unknown file type"
13787 msgstr ""
13788
13789 #. type: =item
13790 #: ../src/guestfs-actions.pod:5314 ../fish/guestfish-actions.pod:3558
13791 msgid "'?'"
13792 msgstr ""
13793
13794 #. type: textblock
13795 #: ../src/guestfs-actions.pod:5316 ../fish/guestfish-actions.pod:3560
13796 msgid "The L<readdir(3)> call returned a C<d_type> field with an unexpected value"
13797 msgstr ""
13798
13799 #. type: textblock
13800 #: ../src/guestfs-actions.pod:5321
13801 msgid ""
13802 "This function is primarily intended for use by programs.  To get a simple "
13803 "list of names, use C<guestfs_ls>.  To get a printable directory for human "
13804 "consumption, use C<guestfs_ll>."
13805 msgstr ""
13806
13807 #. type: textblock
13808 #: ../src/guestfs-actions.pod:5325
13809 msgid ""
13810 "This function returns a C<struct guestfs_dirent_list *>, or NULL if there "
13811 "was an error.  I<The caller must call C<guestfs_free_dirent_list> after "
13812 "use>."
13813 msgstr ""
13814
13815 #. type: =head2
13816 #: ../src/guestfs-actions.pod:5331
13817 msgid "guestfs_readlink"
13818 msgstr ""
13819
13820 #. type: verbatim
13821 #: ../src/guestfs-actions.pod:5333
13822 #, no-wrap
13823 msgid ""
13824 " char *\n"
13825 " guestfs_readlink (guestfs_h *g,\n"
13826 "                   const char *path);\n"
13827 "\n"
13828 msgstr ""
13829
13830 #. type: textblock
13831 #: ../src/guestfs-actions.pod:5337 ../fish/guestfish-actions.pod:3573
13832 msgid "This command reads the target of a symbolic link."
13833 msgstr ""
13834
13835 #. type: =head2
13836 #: ../src/guestfs-actions.pod:5344
13837 msgid "guestfs_readlinklist"
13838 msgstr ""
13839
13840 #. type: verbatim
13841 #: ../src/guestfs-actions.pod:5346
13842 #, no-wrap
13843 msgid ""
13844 " char **\n"
13845 " guestfs_readlinklist (guestfs_h *g,\n"
13846 "                       const char *path,\n"
13847 "                       char *const *names);\n"
13848 "\n"
13849 msgstr ""
13850
13851 #. type: textblock
13852 #: ../src/guestfs-actions.pod:5351 ../fish/guestfish-actions.pod:3579
13853 msgid ""
13854 "This call allows you to do a C<readlink> operation on multiple files, where "
13855 "all files are in the directory C<path>.  C<names> is the list of files from "
13856 "this directory."
13857 msgstr ""
13858
13859 #. type: textblock
13860 #: ../src/guestfs-actions.pod:5355 ../fish/guestfish-actions.pod:3583
13861 msgid ""
13862 "On return you get a list of strings, with a one-to-one correspondence to the "
13863 "C<names> list.  Each string is the value of the symbolic link."
13864 msgstr ""
13865
13866 #. type: textblock
13867 #: ../src/guestfs-actions.pod:5359 ../fish/guestfish-actions.pod:3587
13868 msgid ""
13869 "If the C<readlink(2)> operation fails on any name, then the corresponding "
13870 "result string is the empty string C<\"\">.  However the whole operation is "
13871 "completed even if there were C<readlink(2)> errors, and so you can call this "
13872 "function with names where you don't know if they are symbolic links already "
13873 "(albeit slightly less efficient)."
13874 msgstr ""
13875
13876 #. type: textblock
13877 #: ../src/guestfs-actions.pod:5366 ../fish/guestfish-actions.pod:3594
13878 msgid ""
13879 "This call is intended for programs that want to efficiently list a directory "
13880 "contents without making many round-trips.  Very long directory listings "
13881 "might cause the protocol message size to be exceeded, causing this call to "
13882 "fail.  The caller must split up such requests into smaller groups of names."
13883 msgstr ""
13884
13885 #. type: =head2
13886 #: ../src/guestfs-actions.pod:5379
13887 msgid "guestfs_realpath"
13888 msgstr ""
13889
13890 #. type: verbatim
13891 #: ../src/guestfs-actions.pod:5381
13892 #, no-wrap
13893 msgid ""
13894 " char *\n"
13895 " guestfs_realpath (guestfs_h *g,\n"
13896 "                   const char *path);\n"
13897 "\n"
13898 msgstr ""
13899
13900 #. type: textblock
13901 #: ../src/guestfs-actions.pod:5385 ../fish/guestfish-actions.pod:3605
13902 msgid ""
13903 "Return the canonicalized absolute pathname of C<path>.  The returned path "
13904 "has no C<.>, C<..> or symbolic link path elements."
13905 msgstr ""
13906
13907 #. type: =head2
13908 #: ../src/guestfs-actions.pod:5393
13909 msgid "guestfs_removexattr"
13910 msgstr ""
13911
13912 #. type: verbatim
13913 #: ../src/guestfs-actions.pod:5395
13914 #, no-wrap
13915 msgid ""
13916 " int\n"
13917 " guestfs_removexattr (guestfs_h *g,\n"
13918 "                      const char *xattr,\n"
13919 "                      const char *path);\n"
13920 "\n"
13921 msgstr ""
13922
13923 #. type: textblock
13924 #: ../src/guestfs-actions.pod:5400 ../fish/guestfish-actions.pod:3612
13925 msgid "This call removes the extended attribute named C<xattr> of the file C<path>."
13926 msgstr ""
13927
13928 #. type: textblock
13929 #: ../src/guestfs-actions.pod:5403
13930 msgid "See also: C<guestfs_lremovexattr>, L<attr(5)>."
13931 msgstr ""
13932
13933 #. type: =head2
13934 #: ../src/guestfs-actions.pod:5409
13935 msgid "guestfs_resize2fs"
13936 msgstr ""
13937
13938 #. type: verbatim
13939 #: ../src/guestfs-actions.pod:5411
13940 #, no-wrap
13941 msgid ""
13942 " int\n"
13943 " guestfs_resize2fs (guestfs_h *g,\n"
13944 "                    const char *device);\n"
13945 "\n"
13946 msgstr ""
13947
13948 #. type: textblock
13949 #: ../src/guestfs-actions.pod:5415 ../fish/guestfish-actions.pod:3621
13950 msgid ""
13951 "This resizes an ext2, ext3 or ext4 filesystem to match the size of the "
13952 "underlying device."
13953 msgstr ""
13954
13955 #. type: textblock
13956 #: ../src/guestfs-actions.pod:5418
13957 msgid ""
13958 "I<Note:> It is sometimes required that you run C<guestfs_e2fsck_f> on the "
13959 "C<device> before calling this command.  For unknown reasons C<resize2fs> "
13960 "sometimes gives an error about this and sometimes not.  In any case, it is "
13961 "always safe to call C<guestfs_e2fsck_f> before calling this function."
13962 msgstr ""
13963
13964 #. type: =head2
13965 #: ../src/guestfs-actions.pod:5428
13966 msgid "guestfs_resize2fs_size"
13967 msgstr ""
13968
13969 #. type: verbatim
13970 #: ../src/guestfs-actions.pod:5430
13971 #, no-wrap
13972 msgid ""
13973 " int\n"
13974 " guestfs_resize2fs_size (guestfs_h *g,\n"
13975 "                         const char *device,\n"
13976 "                         int64_t size);\n"
13977 "\n"
13978 msgstr ""
13979
13980 #. type: textblock
13981 #: ../src/guestfs-actions.pod:5435
13982 msgid ""
13983 "This command is the same as C<guestfs_resize2fs> except that it allows you "
13984 "to specify the new size (in bytes) explicitly."
13985 msgstr ""
13986
13987 #. type: =head2
13988 #: ../src/guestfs-actions.pod:5442
13989 msgid "guestfs_rm"
13990 msgstr ""
13991
13992 #. type: verbatim
13993 #: ../src/guestfs-actions.pod:5444
13994 #, no-wrap
13995 msgid ""
13996 " int\n"
13997 " guestfs_rm (guestfs_h *g,\n"
13998 "             const char *path);\n"
13999 "\n"
14000 msgstr ""
14001
14002 #. type: textblock
14003 #: ../src/guestfs-actions.pod:5448 ../fish/guestfish-actions.pod:3641
14004 msgid "Remove the single file C<path>."
14005 msgstr ""
14006
14007 #. type: =head2
14008 #: ../src/guestfs-actions.pod:5454
14009 msgid "guestfs_rm_rf"
14010 msgstr ""
14011
14012 #. type: verbatim
14013 #: ../src/guestfs-actions.pod:5456
14014 #, no-wrap
14015 msgid ""
14016 " int\n"
14017 " guestfs_rm_rf (guestfs_h *g,\n"
14018 "                const char *path);\n"
14019 "\n"
14020 msgstr ""
14021
14022 #. type: textblock
14023 #: ../src/guestfs-actions.pod:5460 ../fish/guestfish-actions.pod:3647
14024 msgid ""
14025 "Remove the file or directory C<path>, recursively removing the contents if "
14026 "its a directory.  This is like the C<rm -rf> shell command."
14027 msgstr ""
14028
14029 #. type: =head2
14030 #: ../src/guestfs-actions.pod:5468
14031 msgid "guestfs_rmdir"
14032 msgstr ""
14033
14034 #. type: verbatim
14035 #: ../src/guestfs-actions.pod:5470
14036 #, no-wrap
14037 msgid ""
14038 " int\n"
14039 " guestfs_rmdir (guestfs_h *g,\n"
14040 "                const char *path);\n"
14041 "\n"
14042 msgstr ""
14043
14044 #. type: textblock
14045 #: ../src/guestfs-actions.pod:5474 ../fish/guestfish-actions.pod:3655
14046 msgid "Remove the single directory C<path>."
14047 msgstr ""
14048
14049 #. type: =head2
14050 #: ../src/guestfs-actions.pod:5480
14051 msgid "guestfs_rmmountpoint"
14052 msgstr ""
14053
14054 #. type: verbatim
14055 #: ../src/guestfs-actions.pod:5482
14056 #, no-wrap
14057 msgid ""
14058 " int\n"
14059 " guestfs_rmmountpoint (guestfs_h *g,\n"
14060 "                       const char *exemptpath);\n"
14061 "\n"
14062 msgstr ""
14063
14064 #. type: textblock
14065 #: ../src/guestfs-actions.pod:5486
14066 msgid ""
14067 "This calls removes a mountpoint that was previously created with "
14068 "C<guestfs_mkmountpoint>.  See C<guestfs_mkmountpoint> for full details."
14069 msgstr ""
14070
14071 #. type: =head2
14072 #: ../src/guestfs-actions.pod:5494
14073 msgid "guestfs_scrub_device"
14074 msgstr ""
14075
14076 #. type: verbatim
14077 #: ../src/guestfs-actions.pod:5496
14078 #, no-wrap
14079 msgid ""
14080 " int\n"
14081 " guestfs_scrub_device (guestfs_h *g,\n"
14082 "                       const char *device);\n"
14083 "\n"
14084 msgstr ""
14085
14086 #. type: textblock
14087 #: ../src/guestfs-actions.pod:5500 ../fish/guestfish-actions.pod:3669
14088 msgid ""
14089 "This command writes patterns over C<device> to make data retrieval more "
14090 "difficult."
14091 msgstr ""
14092
14093 #. type: textblock
14094 #: ../src/guestfs-actions.pod:5503 ../src/guestfs-actions.pod:5524 ../src/guestfs-actions.pod:5543 ../fish/guestfish-actions.pod:3672 ../fish/guestfish-actions.pod:3687 ../fish/guestfish-actions.pod:3700
14095 msgid ""
14096 "It is an interface to the L<scrub(1)> program.  See that manual page for "
14097 "more details."
14098 msgstr ""
14099
14100 #. type: textblock
14101 #: ../src/guestfs-actions.pod:5511 ../src/guestfs-actions.pod:5529 ../src/guestfs-actions.pod:5548
14102 msgid "(Added in 1.0.52)"
14103 msgstr ""
14104
14105 #. type: =head2
14106 #: ../src/guestfs-actions.pod:5513
14107 msgid "guestfs_scrub_file"
14108 msgstr ""
14109
14110 #. type: verbatim
14111 #: ../src/guestfs-actions.pod:5515
14112 #, no-wrap
14113 msgid ""
14114 " int\n"
14115 " guestfs_scrub_file (guestfs_h *g,\n"
14116 "                     const char *file);\n"
14117 "\n"
14118 msgstr ""
14119
14120 #. type: textblock
14121 #: ../src/guestfs-actions.pod:5519 ../fish/guestfish-actions.pod:3682
14122 msgid ""
14123 "This command writes patterns over a file to make data retrieval more "
14124 "difficult."
14125 msgstr ""
14126
14127 #. type: textblock
14128 #: ../src/guestfs-actions.pod:5522 ../fish/guestfish-actions.pod:3685
14129 msgid "The file is I<removed> after scrubbing."
14130 msgstr ""
14131
14132 #. type: =head2
14133 #: ../src/guestfs-actions.pod:5531
14134 msgid "guestfs_scrub_freespace"
14135 msgstr ""
14136
14137 #. type: verbatim
14138 #: ../src/guestfs-actions.pod:5533
14139 #, no-wrap
14140 msgid ""
14141 " int\n"
14142 " guestfs_scrub_freespace (guestfs_h *g,\n"
14143 "                          const char *dir);\n"
14144 "\n"
14145 msgstr ""
14146
14147 #. type: textblock
14148 #: ../src/guestfs-actions.pod:5537
14149 msgid ""
14150 "This command creates the directory C<dir> and then fills it with files until "
14151 "the filesystem is full, and scrubs the files as for C<guestfs_scrub_file>, "
14152 "and deletes them.  The intention is to scrub any free space on the partition "
14153 "containing C<dir>."
14154 msgstr ""
14155
14156 #. type: =head2
14157 #: ../src/guestfs-actions.pod:5550
14158 msgid "guestfs_set_append"
14159 msgstr ""
14160
14161 #. type: verbatim
14162 #: ../src/guestfs-actions.pod:5552
14163 #, no-wrap
14164 msgid ""
14165 " int\n"
14166 " guestfs_set_append (guestfs_h *g,\n"
14167 "                     const char *append);\n"
14168 "\n"
14169 msgstr ""
14170
14171 #. type: textblock
14172 #: ../src/guestfs-actions.pod:5556 ../fish/guestfish-actions.pod:3709
14173 msgid ""
14174 "This function is used to add additional options to the guest kernel command "
14175 "line."
14176 msgstr ""
14177
14178 #. type: textblock
14179 #: ../src/guestfs-actions.pod:5559 ../fish/guestfish-actions.pod:3712
14180 msgid ""
14181 "The default is C<NULL> unless overridden by setting C<LIBGUESTFS_APPEND> "
14182 "environment variable."
14183 msgstr ""
14184
14185 #. type: textblock
14186 #: ../src/guestfs-actions.pod:5562 ../fish/guestfish-actions.pod:3715
14187 msgid ""
14188 "Setting C<append> to C<NULL> means I<no> additional options are passed "
14189 "(libguestfs always adds a few of its own)."
14190 msgstr ""
14191
14192 #. type: =head2
14193 #: ../src/guestfs-actions.pod:5569
14194 msgid "guestfs_set_autosync"
14195 msgstr ""
14196
14197 #. type: verbatim
14198 #: ../src/guestfs-actions.pod:5571
14199 #, no-wrap
14200 msgid ""
14201 " int\n"
14202 " guestfs_set_autosync (guestfs_h *g,\n"
14203 "                       int autosync);\n"
14204 "\n"
14205 msgstr ""
14206
14207 #. type: textblock
14208 #: ../src/guestfs-actions.pod:5575
14209 msgid ""
14210 "If C<autosync> is true, this enables autosync.  Libguestfs will make a best "
14211 "effort attempt to run C<guestfs_umount_all> followed by C<guestfs_sync> when "
14212 "the handle is closed (also if the program exits without closing handles)."
14213 msgstr ""
14214
14215 #. type: textblock
14216 #: ../src/guestfs-actions.pod:5580 ../fish/guestfish-actions.pod:3729
14217 msgid ""
14218 "This is enabled by default (since libguestfs 1.5.24, previously it was "
14219 "disabled by default)."
14220 msgstr ""
14221
14222 #. type: =head2
14223 #: ../src/guestfs-actions.pod:5587
14224 msgid "guestfs_set_direct"
14225 msgstr ""
14226
14227 #. type: verbatim
14228 #: ../src/guestfs-actions.pod:5589
14229 #, no-wrap
14230 msgid ""
14231 " int\n"
14232 " guestfs_set_direct (guestfs_h *g,\n"
14233 "                     int direct);\n"
14234 "\n"
14235 msgstr ""
14236
14237 #. type: textblock
14238 #: ../src/guestfs-actions.pod:5593 ../fish/guestfish-actions.pod:3738
14239 msgid ""
14240 "If the direct appliance mode flag is enabled, then stdin and stdout are "
14241 "passed directly through to the appliance once it is launched."
14242 msgstr ""
14243
14244 #. type: textblock
14245 #: ../src/guestfs-actions.pod:5597
14246 msgid ""
14247 "One consequence of this is that log messages aren't caught by the library "
14248 "and handled by C<guestfs_set_log_message_callback>, but go straight to "
14249 "stdout."
14250 msgstr ""
14251
14252 #. type: textblock
14253 #: ../src/guestfs-actions.pod:5601 ../fish/guestfish-actions.pod:3746
14254 msgid "You probably don't want to use this unless you know what you are doing."
14255 msgstr ""
14256
14257 #. type: textblock
14258 #: ../src/guestfs-actions.pod:5604 ../fish/guestfish-actions.pod:3749
14259 msgid "The default is disabled."
14260 msgstr ""
14261
14262 #. type: =head2
14263 #: ../src/guestfs-actions.pod:5610
14264 msgid "guestfs_set_e2label"
14265 msgstr ""
14266
14267 #. type: verbatim
14268 #: ../src/guestfs-actions.pod:5612
14269 #, no-wrap
14270 msgid ""
14271 " int\n"
14272 " guestfs_set_e2label (guestfs_h *g,\n"
14273 "                      const char *device,\n"
14274 "                      const char *label);\n"
14275 "\n"
14276 msgstr ""
14277
14278 #. type: textblock
14279 #: ../src/guestfs-actions.pod:5617 ../fish/guestfish-actions.pod:3755
14280 msgid ""
14281 "This sets the ext2/3/4 filesystem label of the filesystem on C<device> to "
14282 "C<label>.  Filesystem labels are limited to 16 characters."
14283 msgstr ""
14284
14285 #. type: textblock
14286 #: ../src/guestfs-actions.pod:5621
14287 msgid ""
14288 "You can use either C<guestfs_tune2fs_l> or C<guestfs_get_e2label> to return "
14289 "the existing label on a filesystem."
14290 msgstr ""
14291
14292 #. type: =head2
14293 #: ../src/guestfs-actions.pod:5628
14294 msgid "guestfs_set_e2uuid"
14295 msgstr ""
14296
14297 #. type: verbatim
14298 #: ../src/guestfs-actions.pod:5630
14299 #, no-wrap
14300 msgid ""
14301 " int\n"
14302 " guestfs_set_e2uuid (guestfs_h *g,\n"
14303 "                     const char *device,\n"
14304 "                     const char *uuid);\n"
14305 "\n"
14306 msgstr ""
14307
14308 #. type: textblock
14309 #: ../src/guestfs-actions.pod:5635 ../fish/guestfish-actions.pod:3766
14310 msgid ""
14311 "This sets the ext2/3/4 filesystem UUID of the filesystem on C<device> to "
14312 "C<uuid>.  The format of the UUID and alternatives such as C<clear>, "
14313 "C<random> and C<time> are described in the L<tune2fs(8)> manpage."
14314 msgstr ""
14315
14316 #. type: textblock
14317 #: ../src/guestfs-actions.pod:5640
14318 msgid ""
14319 "You can use either C<guestfs_tune2fs_l> or C<guestfs_get_e2uuid> to return "
14320 "the existing UUID of a filesystem."
14321 msgstr ""
14322
14323 #. type: =head2
14324 #: ../src/guestfs-actions.pod:5647
14325 msgid "guestfs_set_memsize"
14326 msgstr ""
14327
14328 #. type: verbatim
14329 #: ../src/guestfs-actions.pod:5649
14330 #, no-wrap
14331 msgid ""
14332 " int\n"
14333 " guestfs_set_memsize (guestfs_h *g,\n"
14334 "                      int memsize);\n"
14335 "\n"
14336 msgstr ""
14337
14338 #. type: textblock
14339 #: ../src/guestfs-actions.pod:5653
14340 msgid ""
14341 "This sets the memory size in megabytes allocated to the qemu subprocess.  "
14342 "This only has any effect if called before C<guestfs_launch>."
14343 msgstr ""
14344
14345 #. type: textblock
14346 #: ../src/guestfs-actions.pod:5657 ../fish/guestfish-actions.pod:3784
14347 msgid ""
14348 "You can also change this by setting the environment variable "
14349 "C<LIBGUESTFS_MEMSIZE> before the handle is created."
14350 msgstr ""
14351
14352 #. type: =head2
14353 #: ../src/guestfs-actions.pod:5668
14354 msgid "guestfs_set_network"
14355 msgstr ""
14356
14357 #. type: verbatim
14358 #: ../src/guestfs-actions.pod:5670
14359 #, no-wrap
14360 msgid ""
14361 " int\n"
14362 " guestfs_set_network (guestfs_h *g,\n"
14363 "                      int network);\n"
14364 "\n"
14365 msgstr ""
14366
14367 #. type: textblock
14368 #: ../src/guestfs-actions.pod:5674 ../fish/guestfish-actions.pod:3797
14369 msgid ""
14370 "If C<network> is true, then the network is enabled in the libguestfs "
14371 "appliance.  The default is false."
14372 msgstr ""
14373
14374 #. type: textblock
14375 #: ../src/guestfs-actions.pod:5677 ../fish/guestfish-actions.pod:3800
14376 msgid ""
14377 "This affects whether commands are able to access the network (see "
14378 "L<guestfs(3)/RUNNING COMMANDS>)."
14379 msgstr ""
14380
14381 #. type: textblock
14382 #: ../src/guestfs-actions.pod:5680
14383 msgid ""
14384 "You must call this before calling C<guestfs_launch>, otherwise it has no "
14385 "effect."
14386 msgstr ""
14387
14388 #. type: =head2
14389 #: ../src/guestfs-actions.pod:5687
14390 msgid "guestfs_set_path"
14391 msgstr ""
14392
14393 #. type: verbatim
14394 #: ../src/guestfs-actions.pod:5689
14395 #, no-wrap
14396 msgid ""
14397 " int\n"
14398 " guestfs_set_path (guestfs_h *g,\n"
14399 "                   const char *searchpath);\n"
14400 "\n"
14401 msgstr ""
14402
14403 #. type: textblock
14404 #: ../src/guestfs-actions.pod:5693 ../fish/guestfish-actions.pod:3812
14405 msgid "Set the path that libguestfs searches for kernel and initrd.img."
14406 msgstr ""
14407
14408 #. type: textblock
14409 #: ../src/guestfs-actions.pod:5695 ../fish/guestfish-actions.pod:3814
14410 msgid ""
14411 "The default is C<$libdir/guestfs> unless overridden by setting "
14412 "C<LIBGUESTFS_PATH> environment variable."
14413 msgstr ""
14414
14415 #. type: textblock
14416 #: ../src/guestfs-actions.pod:5698 ../fish/guestfish-actions.pod:3817
14417 msgid "Setting C<path> to C<NULL> restores the default path."
14418 msgstr ""
14419
14420 #. type: =head2
14421 #: ../src/guestfs-actions.pod:5704
14422 msgid "guestfs_set_qemu"
14423 msgstr ""
14424
14425 #. type: verbatim
14426 #: ../src/guestfs-actions.pod:5706
14427 #, no-wrap
14428 msgid ""
14429 " int\n"
14430 " guestfs_set_qemu (guestfs_h *g,\n"
14431 "                   const char *qemu);\n"
14432 "\n"
14433 msgstr ""
14434
14435 #. type: textblock
14436 #: ../src/guestfs-actions.pod:5710 ../fish/guestfish-actions.pod:3825
14437 msgid "Set the qemu binary that we will use."
14438 msgstr ""
14439
14440 #. type: textblock
14441 #: ../src/guestfs-actions.pod:5712 ../fish/guestfish-actions.pod:3827
14442 msgid "The default is chosen when the library was compiled by the configure script."
14443 msgstr ""
14444
14445 #. type: textblock
14446 #: ../src/guestfs-actions.pod:5715 ../fish/guestfish-actions.pod:3830
14447 msgid ""
14448 "You can also override this by setting the C<LIBGUESTFS_QEMU> environment "
14449 "variable."
14450 msgstr ""
14451
14452 #. type: textblock
14453 #: ../src/guestfs-actions.pod:5718 ../fish/guestfish-actions.pod:3833
14454 msgid "Setting C<qemu> to C<NULL> restores the default qemu binary."
14455 msgstr ""
14456
14457 #. type: textblock
14458 #: ../src/guestfs-actions.pod:5720 ../fish/guestfish-actions.pod:3835
14459 msgid ""
14460 "Note that you should call this function as early as possible after creating "
14461 "the handle.  This is because some pre-launch operations depend on testing "
14462 "qemu features (by running C<qemu -help>).  If the qemu binary changes, we "
14463 "don't retest features, and so you might see inconsistent results.  Using the "
14464 "environment variable C<LIBGUESTFS_QEMU> is safest of all since that picks "
14465 "the qemu binary at the same time as the handle is created."
14466 msgstr ""
14467
14468 #. type: =head2
14469 #: ../src/guestfs-actions.pod:5732
14470 msgid "guestfs_set_recovery_proc"
14471 msgstr ""
14472
14473 #. type: verbatim
14474 #: ../src/guestfs-actions.pod:5734
14475 #, no-wrap
14476 msgid ""
14477 " int\n"
14478 " guestfs_set_recovery_proc (guestfs_h *g,\n"
14479 "                            int recoveryproc);\n"
14480 "\n"
14481 msgstr ""
14482
14483 #. type: textblock
14484 #: ../src/guestfs-actions.pod:5738
14485 msgid ""
14486 "If this is called with the parameter C<false> then C<guestfs_launch> does "
14487 "not create a recovery process.  The purpose of the recovery process is to "
14488 "stop runaway qemu processes in the case where the main program aborts "
14489 "abruptly."
14490 msgstr ""
14491
14492 #. type: textblock
14493 #: ../src/guestfs-actions.pod:5743
14494 msgid ""
14495 "This only has any effect if called before C<guestfs_launch>, and the default "
14496 "is true."
14497 msgstr ""
14498
14499 #. type: textblock
14500 #: ../src/guestfs-actions.pod:5746 ../fish/guestfish-actions.pod:3857
14501 msgid ""
14502 "About the only time when you would want to disable this is if the main "
14503 "process will fork itself into the background (\"daemonize\" itself).  In "
14504 "this case the recovery process thinks that the main program has disappeared "
14505 "and so kills qemu, which is not very helpful."
14506 msgstr ""
14507
14508 #. type: =head2
14509 #: ../src/guestfs-actions.pod:5756
14510 msgid "guestfs_set_selinux"
14511 msgstr ""
14512
14513 #. type: verbatim
14514 #: ../src/guestfs-actions.pod:5758
14515 #, no-wrap
14516 msgid ""
14517 " int\n"
14518 " guestfs_set_selinux (guestfs_h *g,\n"
14519 "                      int selinux);\n"
14520 "\n"
14521 msgstr ""
14522
14523 #. type: textblock
14524 #: ../src/guestfs-actions.pod:5762 ../fish/guestfish-actions.pod:3869
14525 msgid ""
14526 "This sets the selinux flag that is passed to the appliance at boot time.  "
14527 "The default is C<selinux=0> (disabled)."
14528 msgstr ""
14529
14530 #. type: textblock
14531 #: ../src/guestfs-actions.pod:5765 ../fish/guestfish-actions.pod:3872
14532 msgid ""
14533 "Note that if SELinux is enabled, it is always in Permissive mode "
14534 "(C<enforcing=0>)."
14535 msgstr ""
14536
14537 #. type: =head2
14538 #: ../src/guestfs-actions.pod:5775
14539 msgid "guestfs_set_trace"
14540 msgstr ""
14541
14542 #. type: verbatim
14543 #: ../src/guestfs-actions.pod:5777
14544 #, no-wrap
14545 msgid ""
14546 " int\n"
14547 " guestfs_set_trace (guestfs_h *g,\n"
14548 "                    int trace);\n"
14549 "\n"
14550 msgstr ""
14551
14552 #. type: textblock
14553 #: ../src/guestfs-actions.pod:5781 ../fish/guestfish-actions.pod:3884
14554 msgid ""
14555 "If the command trace flag is set to 1, then commands are printed on stderr "
14556 "before they are executed in a format which is very similar to the one used "
14557 "by guestfish.  In other words, you can run a program with this enabled, and "
14558 "you will get out a script which you can feed to guestfish to perform the "
14559 "same set of actions."
14560 msgstr ""
14561
14562 #. type: textblock
14563 #: ../src/guestfs-actions.pod:5788 ../fish/guestfish-actions.pod:3891
14564 msgid ""
14565 "If you want to trace C API calls into libguestfs (and other libraries) then "
14566 "possibly a better way is to use the external ltrace(1) command."
14567 msgstr ""
14568
14569 #. type: textblock
14570 #: ../src/guestfs-actions.pod:5792 ../fish/guestfish-actions.pod:3895
14571 msgid ""
14572 "Command traces are disabled unless the environment variable "
14573 "C<LIBGUESTFS_TRACE> is defined and set to C<1>."
14574 msgstr ""
14575
14576 #. type: =head2
14577 #: ../src/guestfs-actions.pod:5799
14578 msgid "guestfs_set_verbose"
14579 msgstr ""
14580
14581 #. type: verbatim
14582 #: ../src/guestfs-actions.pod:5801
14583 #, no-wrap
14584 msgid ""
14585 " int\n"
14586 " guestfs_set_verbose (guestfs_h *g,\n"
14587 "                      int verbose);\n"
14588 "\n"
14589 msgstr ""
14590
14591 #. type: textblock
14592 #: ../src/guestfs-actions.pod:5805 ../fish/guestfish-actions.pod:3904
14593 msgid "If C<verbose> is true, this turns on verbose messages (to C<stderr>)."
14594 msgstr ""
14595
14596 #. type: textblock
14597 #: ../src/guestfs-actions.pod:5807 ../fish/guestfish-actions.pod:3906
14598 msgid ""
14599 "Verbose messages are disabled unless the environment variable "
14600 "C<LIBGUESTFS_DEBUG> is defined and set to C<1>."
14601 msgstr ""
14602
14603 #. type: =head2
14604 #: ../src/guestfs-actions.pod:5814
14605 msgid "guestfs_setcon"
14606 msgstr ""
14607
14608 #. type: verbatim
14609 #: ../src/guestfs-actions.pod:5816
14610 #, no-wrap
14611 msgid ""
14612 " int\n"
14613 " guestfs_setcon (guestfs_h *g,\n"
14614 "                 const char *context);\n"
14615 "\n"
14616 msgstr ""
14617
14618 #. type: textblock
14619 #: ../src/guestfs-actions.pod:5820 ../fish/guestfish-actions.pod:3913
14620 msgid ""
14621 "This sets the SELinux security context of the daemon to the string "
14622 "C<context>."
14623 msgstr ""
14624
14625 #. type: textblock
14626 #: ../src/guestfs-actions.pod:5823 ../fish/guestfish-actions.pod:3916
14627 msgid "See the documentation about SELINUX in L<guestfs(3)>."
14628 msgstr ""
14629
14630 #. type: =head2
14631 #: ../src/guestfs-actions.pod:5829
14632 msgid "guestfs_setxattr"
14633 msgstr ""
14634
14635 #. type: verbatim
14636 #: ../src/guestfs-actions.pod:5831
14637 #, no-wrap
14638 msgid ""
14639 " int\n"
14640 " guestfs_setxattr (guestfs_h *g,\n"
14641 "                   const char *xattr,\n"
14642 "                   const char *val,\n"
14643 "                   int vallen,\n"
14644 "                   const char *path);\n"
14645 "\n"
14646 msgstr ""
14647
14648 #. type: textblock
14649 #: ../src/guestfs-actions.pod:5838 ../fish/guestfish-actions.pod:3922
14650 msgid ""
14651 "This call sets the extended attribute named C<xattr> of the file C<path> to "
14652 "the value C<val> (of length C<vallen>).  The value is arbitrary 8 bit data."
14653 msgstr ""
14654
14655 #. type: textblock
14656 #: ../src/guestfs-actions.pod:5842
14657 msgid "See also: C<guestfs_lsetxattr>, L<attr(5)>."
14658 msgstr ""
14659
14660 #. type: =head2
14661 #: ../src/guestfs-actions.pod:5848
14662 msgid "guestfs_sfdisk"
14663 msgstr ""
14664
14665 #. type: verbatim
14666 #: ../src/guestfs-actions.pod:5850
14667 #, no-wrap
14668 msgid ""
14669 " int\n"
14670 " guestfs_sfdisk (guestfs_h *g,\n"
14671 "                 const char *device,\n"
14672 "                 int cyls,\n"
14673 "                 int heads,\n"
14674 "                 int sectors,\n"
14675 "                 char *const *lines);\n"
14676 "\n"
14677 msgstr ""
14678
14679 #. type: textblock
14680 #: ../src/guestfs-actions.pod:5858 ../fish/guestfish-actions.pod:3932
14681 msgid ""
14682 "This is a direct interface to the L<sfdisk(8)> program for creating "
14683 "partitions on block devices."
14684 msgstr ""
14685
14686 #. type: textblock
14687 #: ../src/guestfs-actions.pod:5861 ../fish/guestfish-actions.pod:3935
14688 msgid "C<device> should be a block device, for example C</dev/sda>."
14689 msgstr ""
14690
14691 #. type: textblock
14692 #: ../src/guestfs-actions.pod:5863 ../fish/guestfish-actions.pod:3937
14693 msgid ""
14694 "C<cyls>, C<heads> and C<sectors> are the number of cylinders, heads and "
14695 "sectors on the device, which are passed directly to sfdisk as the I<-C>, "
14696 "I<-H> and I<-S> parameters.  If you pass C<0> for any of these, then the "
14697 "corresponding parameter is omitted.  Usually for 'large' disks, you can just "
14698 "pass C<0> for these, but for small (floppy-sized) disks, sfdisk (or rather, "
14699 "the kernel) cannot work out the right geometry and you will need to tell it."
14700 msgstr ""
14701
14702 #. type: textblock
14703 #: ../src/guestfs-actions.pod:5871 ../fish/guestfish-actions.pod:3945
14704 msgid ""
14705 "C<lines> is a list of lines that we feed to C<sfdisk>.  For more information "
14706 "refer to the L<sfdisk(8)> manpage."
14707 msgstr ""
14708
14709 #. type: textblock
14710 #: ../src/guestfs-actions.pod:5874 ../fish/guestfish-actions.pod:3948
14711 msgid ""
14712 "To create a single partition occupying the whole disk, you would pass "
14713 "C<lines> as a single element list, when the single element being the string "
14714 "C<,> (comma)."
14715 msgstr ""
14716
14717 #. type: textblock
14718 #: ../src/guestfs-actions.pod:5878
14719 msgid "See also: C<guestfs_sfdisk_l>, C<guestfs_sfdisk_N>, C<guestfs_part_init>"
14720 msgstr ""
14721
14722 #. type: =head2
14723 #: ../src/guestfs-actions.pod:5888
14724 msgid "guestfs_sfdiskM"
14725 msgstr ""
14726
14727 #. type: verbatim
14728 #: ../src/guestfs-actions.pod:5890
14729 #, no-wrap
14730 msgid ""
14731 " int\n"
14732 " guestfs_sfdiskM (guestfs_h *g,\n"
14733 "                  const char *device,\n"
14734 "                  char *const *lines);\n"
14735 "\n"
14736 msgstr ""
14737
14738 #. type: textblock
14739 #: ../src/guestfs-actions.pod:5895
14740 msgid ""
14741 "This is a simplified interface to the C<guestfs_sfdisk> command, where "
14742 "partition sizes are specified in megabytes only (rounded to the nearest "
14743 "cylinder) and you don't need to specify the cyls, heads and sectors "
14744 "parameters which were rarely if ever used anyway."
14745 msgstr ""
14746
14747 #. type: textblock
14748 #: ../src/guestfs-actions.pod:5901
14749 msgid ""
14750 "See also: C<guestfs_sfdisk>, the L<sfdisk(8)> manpage and "
14751 "C<guestfs_part_disk>"
14752 msgstr ""
14753
14754 #. type: =head2
14755 #: ../src/guestfs-actions.pod:5911
14756 msgid "guestfs_sfdisk_N"
14757 msgstr ""
14758
14759 #. type: verbatim
14760 #: ../src/guestfs-actions.pod:5913
14761 #, no-wrap
14762 msgid ""
14763 " int\n"
14764 " guestfs_sfdisk_N (guestfs_h *g,\n"
14765 "                   const char *device,\n"
14766 "                   int partnum,\n"
14767 "                   int cyls,\n"
14768 "                   int heads,\n"
14769 "                   int sectors,\n"
14770 "                   const char *line);\n"
14771 "\n"
14772 msgstr ""
14773
14774 #. type: textblock
14775 #: ../src/guestfs-actions.pod:5922 ../fish/guestfish-actions.pod:3978
14776 msgid ""
14777 "This runs L<sfdisk(8)> option to modify just the single partition C<n> "
14778 "(note: C<n> counts from 1)."
14779 msgstr ""
14780
14781 #. type: textblock
14782 #: ../src/guestfs-actions.pod:5925
14783 msgid ""
14784 "For other parameters, see C<guestfs_sfdisk>.  You should usually pass C<0> "
14785 "for the cyls/heads/sectors parameters."
14786 msgstr ""
14787
14788 #. type: textblock
14789 #: ../src/guestfs-actions.pod:5928
14790 msgid "See also: C<guestfs_part_add>"
14791 msgstr ""
14792
14793 #. type: =head2
14794 #: ../src/guestfs-actions.pod:5937
14795 msgid "guestfs_sfdisk_disk_geometry"
14796 msgstr ""
14797
14798 #. type: verbatim
14799 #: ../src/guestfs-actions.pod:5939
14800 #, no-wrap
14801 msgid ""
14802 " char *\n"
14803 " guestfs_sfdisk_disk_geometry (guestfs_h *g,\n"
14804 "                               const char *device);\n"
14805 "\n"
14806 msgstr ""
14807
14808 #. type: textblock
14809 #: ../src/guestfs-actions.pod:5943
14810 msgid ""
14811 "This displays the disk geometry of C<device> read from the partition table.  "
14812 "Especially in the case where the underlying block device has been resized, "
14813 "this can be different from the kernel's idea of the geometry (see "
14814 "C<guestfs_sfdisk_kernel_geometry>)."
14815 msgstr ""
14816
14817 #. type: textblock
14818 #: ../src/guestfs-actions.pod:5948 ../src/guestfs-actions.pod:5964 ../fish/guestfish-actions.pod:3998 ../fish/guestfish-actions.pod:4007
14819 msgid "The result is in human-readable format, and not designed to be parsed."
14820 msgstr ""
14821
14822 #. type: =head2
14823 #: ../src/guestfs-actions.pod:5956
14824 msgid "guestfs_sfdisk_kernel_geometry"
14825 msgstr ""
14826
14827 #. type: verbatim
14828 #: ../src/guestfs-actions.pod:5958
14829 #, no-wrap
14830 msgid ""
14831 " char *\n"
14832 " guestfs_sfdisk_kernel_geometry (guestfs_h *g,\n"
14833 "                                 const char *device);\n"
14834 "\n"
14835 msgstr ""
14836
14837 #. type: textblock
14838 #: ../src/guestfs-actions.pod:5962 ../fish/guestfish-actions.pod:4005
14839 msgid "This displays the kernel's idea of the geometry of C<device>."
14840 msgstr ""
14841
14842 #. type: =head2
14843 #: ../src/guestfs-actions.pod:5972
14844 msgid "guestfs_sfdisk_l"
14845 msgstr ""
14846
14847 #. type: verbatim
14848 #: ../src/guestfs-actions.pod:5974
14849 #, no-wrap
14850 msgid ""
14851 " char *\n"
14852 " guestfs_sfdisk_l (guestfs_h *g,\n"
14853 "                   const char *device);\n"
14854 "\n"
14855 msgstr ""
14856
14857 #. type: textblock
14858 #: ../src/guestfs-actions.pod:5978 ../fish/guestfish-actions.pod:4014
14859 msgid ""
14860 "This displays the partition table on C<device>, in the human-readable output "
14861 "of the L<sfdisk(8)> command.  It is not intended to be parsed."
14862 msgstr ""
14863
14864 #. type: textblock
14865 #: ../src/guestfs-actions.pod:5982
14866 msgid "See also: C<guestfs_part_list>"
14867 msgstr ""
14868
14869 #. type: =head2
14870 #: ../src/guestfs-actions.pod:5989
14871 msgid "guestfs_sh"
14872 msgstr ""
14873
14874 #. type: verbatim
14875 #: ../src/guestfs-actions.pod:5991
14876 #, no-wrap
14877 msgid ""
14878 " char *\n"
14879 " guestfs_sh (guestfs_h *g,\n"
14880 "             const char *command);\n"
14881 "\n"
14882 msgstr ""
14883
14884 #. type: textblock
14885 #: ../src/guestfs-actions.pod:5995 ../fish/guestfish-actions.pod:4024
14886 msgid ""
14887 "This call runs a command from the guest filesystem via the guest's "
14888 "C</bin/sh>."
14889 msgstr ""
14890
14891 #. type: textblock
14892 #: ../src/guestfs-actions.pod:5998
14893 msgid "This is like C<guestfs_command>, but passes the command to:"
14894 msgstr ""
14895
14896 #. type: verbatim
14897 #: ../src/guestfs-actions.pod:6000 ../fish/guestfish-actions.pod:4029
14898 #, no-wrap
14899 msgid ""
14900 " /bin/sh -c \"command\"\n"
14901 "\n"
14902 msgstr ""
14903
14904 #. type: textblock
14905 #: ../src/guestfs-actions.pod:6002 ../fish/guestfish-actions.pod:4031
14906 msgid ""
14907 "Depending on the guest's shell, this usually results in wildcards being "
14908 "expanded, shell expressions being interpolated and so on."
14909 msgstr ""
14910
14911 #. type: textblock
14912 #: ../src/guestfs-actions.pod:6006
14913 msgid "All the provisos about C<guestfs_command> apply to this call."
14914 msgstr ""
14915
14916 #. type: =head2
14917 #: ../src/guestfs-actions.pod:6013
14918 msgid "guestfs_sh_lines"
14919 msgstr ""
14920
14921 #. type: verbatim
14922 #: ../src/guestfs-actions.pod:6015
14923 #, no-wrap
14924 msgid ""
14925 " char **\n"
14926 " guestfs_sh_lines (guestfs_h *g,\n"
14927 "                   const char *command);\n"
14928 "\n"
14929 msgstr ""
14930
14931 #. type: textblock
14932 #: ../src/guestfs-actions.pod:6019
14933 msgid ""
14934 "This is the same as C<guestfs_sh>, but splits the result into a list of "
14935 "lines."
14936 msgstr ""
14937
14938 #. type: textblock
14939 #: ../src/guestfs-actions.pod:6022
14940 msgid "See also: C<guestfs_command_lines>"
14941 msgstr ""
14942
14943 #. type: =head2
14944 #: ../src/guestfs-actions.pod:6030
14945 msgid "guestfs_sleep"
14946 msgstr ""
14947
14948 #. type: verbatim
14949 #: ../src/guestfs-actions.pod:6032
14950 #, no-wrap
14951 msgid ""
14952 " int\n"
14953 " guestfs_sleep (guestfs_h *g,\n"
14954 "                int secs);\n"
14955 "\n"
14956 msgstr ""
14957
14958 #. type: textblock
14959 #: ../src/guestfs-actions.pod:6036 ../fish/guestfish-actions.pod:4050
14960 msgid "Sleep for C<secs> seconds."
14961 msgstr ""
14962
14963 #. type: textblock
14964 #: ../src/guestfs-actions.pod:6040
14965 msgid "(Added in 1.0.41)"
14966 msgstr ""
14967
14968 #. type: =head2
14969 #: ../src/guestfs-actions.pod:6042 ../src/guestfs-structs.pod:109
14970 msgid "guestfs_stat"
14971 msgstr ""
14972
14973 #. type: verbatim
14974 #: ../src/guestfs-actions.pod:6044
14975 #, no-wrap
14976 msgid ""
14977 " struct guestfs_stat *\n"
14978 " guestfs_stat (guestfs_h *g,\n"
14979 "               const char *path);\n"
14980 "\n"
14981 msgstr ""
14982
14983 #. type: textblock
14984 #: ../src/guestfs-actions.pod:6050 ../fish/guestfish-actions.pod:4058
14985 msgid "This is the same as the C<stat(2)> system call."
14986 msgstr ""
14987
14988 #. type: =head2
14989 #: ../src/guestfs-actions.pod:6058 ../src/guestfs-structs.pod:135
14990 msgid "guestfs_statvfs"
14991 msgstr ""
14992
14993 #. type: verbatim
14994 #: ../src/guestfs-actions.pod:6060
14995 #, no-wrap
14996 msgid ""
14997 " struct guestfs_statvfs *\n"
14998 " guestfs_statvfs (guestfs_h *g,\n"
14999 "                  const char *path);\n"
15000 "\n"
15001 msgstr ""
15002
15003 #. type: textblock
15004 #: ../src/guestfs-actions.pod:6064 ../fish/guestfish-actions.pod:4064
15005 msgid ""
15006 "Returns file system statistics for any mounted file system.  C<path> should "
15007 "be a file or directory in the mounted file system (typically it is the mount "
15008 "point itself, but it doesn't need to be)."
15009 msgstr ""
15010
15011 #. type: textblock
15012 #: ../src/guestfs-actions.pod:6068 ../fish/guestfish-actions.pod:4068
15013 msgid "This is the same as the C<statvfs(2)> system call."
15014 msgstr ""
15015
15016 #. type: textblock
15017 #: ../src/guestfs-actions.pod:6070
15018 msgid ""
15019 "This function returns a C<struct guestfs_statvfs *>, or NULL if there was an "
15020 "error.  I<The caller must call C<guestfs_free_statvfs> after use>."
15021 msgstr ""
15022
15023 #. type: =head2
15024 #: ../src/guestfs-actions.pod:6076
15025 msgid "guestfs_strings"
15026 msgstr ""
15027
15028 #. type: verbatim
15029 #: ../src/guestfs-actions.pod:6078
15030 #, no-wrap
15031 msgid ""
15032 " char **\n"
15033 " guestfs_strings (guestfs_h *g,\n"
15034 "                  const char *path);\n"
15035 "\n"
15036 msgstr ""
15037
15038 #. type: textblock
15039 #: ../src/guestfs-actions.pod:6082 ../fish/guestfish-actions.pod:4074
15040 msgid ""
15041 "This runs the L<strings(1)> command on a file and returns the list of "
15042 "printable strings found."
15043 msgstr ""
15044
15045 #. type: =head2
15046 #: ../src/guestfs-actions.pod:6094
15047 msgid "guestfs_strings_e"
15048 msgstr ""
15049
15050 #. type: verbatim
15051 #: ../src/guestfs-actions.pod:6096
15052 #, no-wrap
15053 msgid ""
15054 " char **\n"
15055 " guestfs_strings_e (guestfs_h *g,\n"
15056 "                    const char *encoding,\n"
15057 "                    const char *path);\n"
15058 "\n"
15059 msgstr ""
15060
15061 #. type: textblock
15062 #: ../src/guestfs-actions.pod:6101
15063 msgid ""
15064 "This is like the C<guestfs_strings> command, but allows you to specify the "
15065 "encoding of strings that are looked for in the source file C<path>."
15066 msgstr ""
15067
15068 #. type: textblock
15069 #: ../src/guestfs-actions.pod:6105 ../fish/guestfish-actions.pod:4088
15070 msgid "Allowed encodings are:"
15071 msgstr ""
15072
15073 #. type: =item
15074 #: ../src/guestfs-actions.pod:6109 ../fish/guestfish-actions.pod:4092
15075 msgid "s"
15076 msgstr ""
15077
15078 #. type: textblock
15079 #: ../src/guestfs-actions.pod:6111
15080 msgid ""
15081 "Single 7-bit-byte characters like ASCII and the ASCII-compatible parts of "
15082 "ISO-8859-X (this is what C<guestfs_strings> uses)."
15083 msgstr ""
15084
15085 #. type: =item
15086 #: ../src/guestfs-actions.pod:6114 ../fish/guestfish-actions.pod:4097
15087 msgid "S"
15088 msgstr ""
15089
15090 #. type: textblock
15091 #: ../src/guestfs-actions.pod:6116 ../fish/guestfish-actions.pod:4099
15092 msgid "Single 8-bit-byte characters."
15093 msgstr ""
15094
15095 #. type: =item
15096 #: ../src/guestfs-actions.pod:6118 ../fish/guestfish-actions.pod:4101
15097 msgid "b"
15098 msgstr ""
15099
15100 #. type: textblock
15101 #: ../src/guestfs-actions.pod:6120 ../fish/guestfish-actions.pod:4103
15102 msgid "16-bit big endian strings such as those encoded in UTF-16BE or UCS-2BE."
15103 msgstr ""
15104
15105 #. type: =item
15106 #: ../src/guestfs-actions.pod:6123 ../fish/guestfish-actions.pod:4106
15107 msgid "l (lower case letter L)"
15108 msgstr ""
15109
15110 #. type: textblock
15111 #: ../src/guestfs-actions.pod:6125 ../fish/guestfish-actions.pod:4108
15112 msgid ""
15113 "16-bit little endian such as UTF-16LE and UCS-2LE.  This is useful for "
15114 "examining binaries in Windows guests."
15115 msgstr ""
15116
15117 #. type: =item
15118 #: ../src/guestfs-actions.pod:6128 ../fish/guestfish-actions.pod:4111
15119 msgid "B"
15120 msgstr ""
15121
15122 #. type: textblock
15123 #: ../src/guestfs-actions.pod:6130 ../fish/guestfish-actions.pod:4113
15124 msgid "32-bit big endian such as UCS-4BE."
15125 msgstr ""
15126
15127 #. type: =item
15128 #: ../src/guestfs-actions.pod:6132 ../fish/guestfish-actions.pod:4115
15129 msgid "L"
15130 msgstr ""
15131
15132 #. type: textblock
15133 #: ../src/guestfs-actions.pod:6134 ../fish/guestfish-actions.pod:4117
15134 msgid "32-bit little endian such as UCS-4LE."
15135 msgstr ""
15136
15137 #. type: textblock
15138 #: ../src/guestfs-actions.pod:6138 ../fish/guestfish-actions.pod:4121
15139 msgid "The returned strings are transcoded to UTF-8."
15140 msgstr ""
15141
15142 #. type: =head2
15143 #: ../src/guestfs-actions.pod:6149
15144 msgid "guestfs_swapoff_device"
15145 msgstr ""
15146
15147 #. type: verbatim
15148 #: ../src/guestfs-actions.pod:6151
15149 #, no-wrap
15150 msgid ""
15151 " int\n"
15152 " guestfs_swapoff_device (guestfs_h *g,\n"
15153 "                         const char *device);\n"
15154 "\n"
15155 msgstr ""
15156
15157 #. type: textblock
15158 #: ../src/guestfs-actions.pod:6155
15159 msgid ""
15160 "This command disables the libguestfs appliance swap device or partition "
15161 "named C<device>.  See C<guestfs_swapon_device>."
15162 msgstr ""
15163
15164 #. type: =head2
15165 #: ../src/guestfs-actions.pod:6163
15166 msgid "guestfs_swapoff_file"
15167 msgstr ""
15168
15169 #. type: verbatim
15170 #: ../src/guestfs-actions.pod:6165
15171 #, no-wrap
15172 msgid ""
15173 " int\n"
15174 " guestfs_swapoff_file (guestfs_h *g,\n"
15175 "                       const char *file);\n"
15176 "\n"
15177 msgstr ""
15178
15179 #. type: textblock
15180 #: ../src/guestfs-actions.pod:6169 ../fish/guestfish-actions.pod:4138
15181 msgid "This command disables the libguestfs appliance swap on file."
15182 msgstr ""
15183
15184 #. type: =head2
15185 #: ../src/guestfs-actions.pod:6175
15186 msgid "guestfs_swapoff_label"
15187 msgstr ""
15188
15189 #. type: verbatim
15190 #: ../src/guestfs-actions.pod:6177
15191 #, no-wrap
15192 msgid ""
15193 " int\n"
15194 " guestfs_swapoff_label (guestfs_h *g,\n"
15195 "                        const char *label);\n"
15196 "\n"
15197 msgstr ""
15198
15199 #. type: textblock
15200 #: ../src/guestfs-actions.pod:6181 ../fish/guestfish-actions.pod:4144
15201 msgid ""
15202 "This command disables the libguestfs appliance swap on labeled swap "
15203 "partition."
15204 msgstr ""
15205
15206 #. type: =head2
15207 #: ../src/guestfs-actions.pod:6188
15208 msgid "guestfs_swapoff_uuid"
15209 msgstr ""
15210
15211 #. type: verbatim
15212 #: ../src/guestfs-actions.pod:6190
15213 #, no-wrap
15214 msgid ""
15215 " int\n"
15216 " guestfs_swapoff_uuid (guestfs_h *g,\n"
15217 "                       const char *uuid);\n"
15218 "\n"
15219 msgstr ""
15220
15221 #. type: textblock
15222 #: ../src/guestfs-actions.pod:6194 ../fish/guestfish-actions.pod:4151
15223 msgid ""
15224 "This command disables the libguestfs appliance swap partition with the given "
15225 "UUID."
15226 msgstr ""
15227
15228 #. type: =head2
15229 #: ../src/guestfs-actions.pod:6201
15230 msgid "guestfs_swapon_device"
15231 msgstr ""
15232
15233 #. type: verbatim
15234 #: ../src/guestfs-actions.pod:6203
15235 #, no-wrap
15236 msgid ""
15237 " int\n"
15238 " guestfs_swapon_device (guestfs_h *g,\n"
15239 "                        const char *device);\n"
15240 "\n"
15241 msgstr ""
15242
15243 #. type: textblock
15244 #: ../src/guestfs-actions.pod:6207
15245 msgid ""
15246 "This command enables the libguestfs appliance to use the swap device or "
15247 "partition named C<device>.  The increased memory is made available for all "
15248 "commands, for example those run using C<guestfs_command> or C<guestfs_sh>."
15249 msgstr ""
15250
15251 #. type: textblock
15252 #: ../src/guestfs-actions.pod:6212 ../fish/guestfish-actions.pod:4163
15253 msgid ""
15254 "Note that you should not swap to existing guest swap partitions unless you "
15255 "know what you are doing.  They may contain hibernation information, or other "
15256 "information that the guest doesn't want you to trash.  You also risk leaking "
15257 "information about the host to the guest this way.  Instead, attach a new "
15258 "host device to the guest and swap on that."
15259 msgstr ""
15260
15261 #. type: =head2
15262 #: ../src/guestfs-actions.pod:6223
15263 msgid "guestfs_swapon_file"
15264 msgstr ""
15265
15266 #. type: verbatim
15267 #: ../src/guestfs-actions.pod:6225
15268 #, no-wrap
15269 msgid ""
15270 " int\n"
15271 " guestfs_swapon_file (guestfs_h *g,\n"
15272 "                      const char *file);\n"
15273 "\n"
15274 msgstr ""
15275
15276 #. type: textblock
15277 #: ../src/guestfs-actions.pod:6229
15278 msgid ""
15279 "This command enables swap to a file.  See C<guestfs_swapon_device> for other "
15280 "notes."
15281 msgstr ""
15282
15283 #. type: =head2
15284 #: ../src/guestfs-actions.pod:6236
15285 msgid "guestfs_swapon_label"
15286 msgstr ""
15287
15288 #. type: verbatim
15289 #: ../src/guestfs-actions.pod:6238
15290 #, no-wrap
15291 msgid ""
15292 " int\n"
15293 " guestfs_swapon_label (guestfs_h *g,\n"
15294 "                       const char *label);\n"
15295 "\n"
15296 msgstr ""
15297
15298 #. type: textblock
15299 #: ../src/guestfs-actions.pod:6242
15300 msgid ""
15301 "This command enables swap to a labeled swap partition.  See "
15302 "C<guestfs_swapon_device> for other notes."
15303 msgstr ""
15304
15305 #. type: =head2
15306 #: ../src/guestfs-actions.pod:6249
15307 msgid "guestfs_swapon_uuid"
15308 msgstr ""
15309
15310 #. type: verbatim
15311 #: ../src/guestfs-actions.pod:6251
15312 #, no-wrap
15313 msgid ""
15314 " int\n"
15315 " guestfs_swapon_uuid (guestfs_h *g,\n"
15316 "                      const char *uuid);\n"
15317 "\n"
15318 msgstr ""
15319
15320 #. type: textblock
15321 #: ../src/guestfs-actions.pod:6255
15322 msgid ""
15323 "This command enables swap to a swap partition with the given UUID.  See "
15324 "C<guestfs_swapon_device> for other notes."
15325 msgstr ""
15326
15327 #. type: =head2
15328 #: ../src/guestfs-actions.pod:6262
15329 msgid "guestfs_sync"
15330 msgstr ""
15331
15332 #. type: verbatim
15333 #: ../src/guestfs-actions.pod:6264
15334 #, no-wrap
15335 msgid ""
15336 " int\n"
15337 " guestfs_sync (guestfs_h *g);\n"
15338 "\n"
15339 msgstr ""
15340
15341 #. type: textblock
15342 #: ../src/guestfs-actions.pod:6267 ../fish/guestfish-actions.pod:4195
15343 msgid ""
15344 "This syncs the disk, so that any writes are flushed through to the "
15345 "underlying disk image."
15346 msgstr ""
15347
15348 #. type: textblock
15349 #: ../src/guestfs-actions.pod:6270 ../fish/guestfish-actions.pod:4198
15350 msgid ""
15351 "You should always call this if you have modified a disk image, before "
15352 "closing the handle."
15353 msgstr ""
15354
15355 #. type: =head2
15356 #: ../src/guestfs-actions.pod:6277
15357 msgid "guestfs_tail"
15358 msgstr ""
15359
15360 #. type: verbatim
15361 #: ../src/guestfs-actions.pod:6279
15362 #, no-wrap
15363 msgid ""
15364 " char **\n"
15365 " guestfs_tail (guestfs_h *g,\n"
15366 "               const char *path);\n"
15367 "\n"
15368 msgstr ""
15369
15370 #. type: textblock
15371 #: ../src/guestfs-actions.pod:6283 ../fish/guestfish-actions.pod:4205
15372 msgid "This command returns up to the last 10 lines of a file as a list of strings."
15373 msgstr ""
15374
15375 #. type: =head2
15376 #: ../src/guestfs-actions.pod:6295
15377 msgid "guestfs_tail_n"
15378 msgstr ""
15379
15380 #. type: verbatim
15381 #: ../src/guestfs-actions.pod:6297
15382 #, no-wrap
15383 msgid ""
15384 " char **\n"
15385 " guestfs_tail_n (guestfs_h *g,\n"
15386 "                 int nrlines,\n"
15387 "                 const char *path);\n"
15388 "\n"
15389 msgstr ""
15390
15391 #. type: textblock
15392 #: ../src/guestfs-actions.pod:6302 ../fish/guestfish-actions.pod:4215
15393 msgid ""
15394 "If the parameter C<nrlines> is a positive number, this returns the last "
15395 "C<nrlines> lines of the file C<path>."
15396 msgstr ""
15397
15398 #. type: textblock
15399 #: ../src/guestfs-actions.pod:6305 ../fish/guestfish-actions.pod:4218
15400 msgid ""
15401 "If the parameter C<nrlines> is a negative number, this returns lines from "
15402 "the file C<path>, starting with the C<-nrlines>th line."
15403 msgstr ""
15404
15405 #. type: =head2
15406 #: ../src/guestfs-actions.pod:6319
15407 msgid "guestfs_tar_in"
15408 msgstr ""
15409
15410 #. type: verbatim
15411 #: ../src/guestfs-actions.pod:6321
15412 #, no-wrap
15413 msgid ""
15414 " int\n"
15415 " guestfs_tar_in (guestfs_h *g,\n"
15416 "                 const char *tarfile,\n"
15417 "                 const char *directory);\n"
15418 "\n"
15419 msgstr ""
15420
15421 #. type: textblock
15422 #: ../src/guestfs-actions.pod:6326 ../fish/guestfish-actions.pod:4230
15423 msgid ""
15424 "This command uploads and unpacks local file C<tarfile> (an I<uncompressed> "
15425 "tar file) into C<directory>."
15426 msgstr ""
15427
15428 #. type: textblock
15429 #: ../src/guestfs-actions.pod:6329
15430 msgid "To upload a compressed tarball, use C<guestfs_tgz_in> or C<guestfs_txz_in>."
15431 msgstr ""
15432
15433 #. type: textblock
15434 #: ../src/guestfs-actions.pod:6334 ../src/guestfs-actions.pod:6351 ../src/guestfs-actions.pod:6367 ../src/guestfs-actions.pod:6383
15435 msgid "(Added in 1.0.3)"
15436 msgstr ""
15437
15438 #. type: =head2
15439 #: ../src/guestfs-actions.pod:6336
15440 msgid "guestfs_tar_out"
15441 msgstr ""
15442
15443 #. type: verbatim
15444 #: ../src/guestfs-actions.pod:6338
15445 #, no-wrap
15446 msgid ""
15447 " int\n"
15448 " guestfs_tar_out (guestfs_h *g,\n"
15449 "                  const char *directory,\n"
15450 "                  const char *tarfile);\n"
15451 "\n"
15452 msgstr ""
15453
15454 #. type: textblock
15455 #: ../src/guestfs-actions.pod:6343 ../fish/guestfish-actions.pod:4242
15456 msgid ""
15457 "This command packs the contents of C<directory> and downloads it to local "
15458 "file C<tarfile>."
15459 msgstr ""
15460
15461 #. type: textblock
15462 #: ../src/guestfs-actions.pod:6346
15463 msgid ""
15464 "To download a compressed tarball, use C<guestfs_tgz_out> or "
15465 "C<guestfs_txz_out>."
15466 msgstr ""
15467
15468 #. type: =head2
15469 #: ../src/guestfs-actions.pod:6353
15470 msgid "guestfs_tgz_in"
15471 msgstr ""
15472
15473 #. type: verbatim
15474 #: ../src/guestfs-actions.pod:6355
15475 #, no-wrap
15476 msgid ""
15477 " int\n"
15478 " guestfs_tgz_in (guestfs_h *g,\n"
15479 "                 const char *tarball,\n"
15480 "                 const char *directory);\n"
15481 "\n"
15482 msgstr ""
15483
15484 #. type: textblock
15485 #: ../src/guestfs-actions.pod:6360 ../fish/guestfish-actions.pod:4254
15486 msgid ""
15487 "This command uploads and unpacks local file C<tarball> (a I<gzip compressed> "
15488 "tar file) into C<directory>."
15489 msgstr ""
15490
15491 #. type: textblock
15492 #: ../src/guestfs-actions.pod:6363
15493 msgid "To upload an uncompressed tarball, use C<guestfs_tar_in>."
15494 msgstr ""
15495
15496 #. type: =head2
15497 #: ../src/guestfs-actions.pod:6369
15498 msgid "guestfs_tgz_out"
15499 msgstr ""
15500
15501 #. type: verbatim
15502 #: ../src/guestfs-actions.pod:6371
15503 #, no-wrap
15504 msgid ""
15505 " int\n"
15506 " guestfs_tgz_out (guestfs_h *g,\n"
15507 "                  const char *directory,\n"
15508 "                  const char *tarball);\n"
15509 "\n"
15510 msgstr ""
15511
15512 #. type: textblock
15513 #: ../src/guestfs-actions.pod:6376 ../fish/guestfish-actions.pod:4265
15514 msgid ""
15515 "This command packs the contents of C<directory> and downloads it to local "
15516 "file C<tarball>."
15517 msgstr ""
15518
15519 #. type: textblock
15520 #: ../src/guestfs-actions.pod:6379
15521 msgid "To download an uncompressed tarball, use C<guestfs_tar_out>."
15522 msgstr ""
15523
15524 #. type: =head2
15525 #: ../src/guestfs-actions.pod:6385
15526 msgid "guestfs_touch"
15527 msgstr ""
15528
15529 #. type: verbatim
15530 #: ../src/guestfs-actions.pod:6387
15531 #, no-wrap
15532 msgid ""
15533 " int\n"
15534 " guestfs_touch (guestfs_h *g,\n"
15535 "                const char *path);\n"
15536 "\n"
15537 msgstr ""
15538
15539 #. type: textblock
15540 #: ../src/guestfs-actions.pod:6391 ../fish/guestfish-actions.pod:4276
15541 msgid ""
15542 "Touch acts like the L<touch(1)> command.  It can be used to update the "
15543 "timestamps on a file, or, if the file does not exist, to create a new "
15544 "zero-length file."
15545 msgstr ""
15546
15547 #. type: textblock
15548 #: ../src/guestfs-actions.pod:6395 ../fish/guestfish-actions.pod:4280
15549 msgid ""
15550 "This command only works on regular files, and will fail on other file types "
15551 "such as directories, symbolic links, block special etc."
15552 msgstr ""
15553
15554 #. type: =head2
15555 #: ../src/guestfs-actions.pod:6402
15556 msgid "guestfs_truncate"
15557 msgstr ""
15558
15559 #. type: verbatim
15560 #: ../src/guestfs-actions.pod:6404
15561 #, no-wrap
15562 msgid ""
15563 " int\n"
15564 " guestfs_truncate (guestfs_h *g,\n"
15565 "                   const char *path);\n"
15566 "\n"
15567 msgstr ""
15568
15569 #. type: textblock
15570 #: ../src/guestfs-actions.pod:6408 ../fish/guestfish-actions.pod:4287
15571 msgid ""
15572 "This command truncates C<path> to a zero-length file.  The file must exist "
15573 "already."
15574 msgstr ""
15575
15576 #. type: =head2
15577 #: ../src/guestfs-actions.pod:6415
15578 msgid "guestfs_truncate_size"
15579 msgstr ""
15580
15581 #. type: verbatim
15582 #: ../src/guestfs-actions.pod:6417
15583 #, no-wrap
15584 msgid ""
15585 " int\n"
15586 " guestfs_truncate_size (guestfs_h *g,\n"
15587 "                        const char *path,\n"
15588 "                        int64_t size);\n"
15589 "\n"
15590 msgstr ""
15591
15592 #. type: textblock
15593 #: ../src/guestfs-actions.pod:6422 ../fish/guestfish-actions.pod:4294
15594 msgid ""
15595 "This command truncates C<path> to size C<size> bytes.  The file must exist "
15596 "already."
15597 msgstr ""
15598
15599 #. type: textblock
15600 #: ../src/guestfs-actions.pod:6425
15601 msgid ""
15602 "If the current file size is less than C<size> then the file is extended to "
15603 "the required size with zero bytes.  This creates a sparse file (ie. disk "
15604 "blocks are not allocated for the file until you write to it).  To create a "
15605 "non-sparse file of zeroes, use C<guestfs_fallocate64> instead."
15606 msgstr ""
15607
15608 #. type: =head2
15609 #: ../src/guestfs-actions.pod:6435
15610 msgid "guestfs_tune2fs_l"
15611 msgstr ""
15612
15613 #. type: verbatim
15614 #: ../src/guestfs-actions.pod:6437
15615 #, no-wrap
15616 msgid ""
15617 " char **\n"
15618 " guestfs_tune2fs_l (guestfs_h *g,\n"
15619 "                    const char *device);\n"
15620 "\n"
15621 msgstr ""
15622
15623 #. type: textblock
15624 #: ../src/guestfs-actions.pod:6441 ../fish/guestfish-actions.pod:4307
15625 msgid ""
15626 "This returns the contents of the ext2, ext3 or ext4 filesystem superblock on "
15627 "C<device>."
15628 msgstr ""
15629
15630 #. type: textblock
15631 #: ../src/guestfs-actions.pod:6444 ../fish/guestfish-actions.pod:4310
15632 msgid ""
15633 "It is the same as running C<tune2fs -l device>.  See L<tune2fs(8)> manpage "
15634 "for more details.  The list of fields returned isn't clearly defined, and "
15635 "depends on both the version of C<tune2fs> that libguestfs was built against, "
15636 "and the filesystem itself."
15637 msgstr ""
15638
15639 #. type: =head2
15640 #: ../src/guestfs-actions.pod:6457
15641 msgid "guestfs_txz_in"
15642 msgstr ""
15643
15644 #. type: verbatim
15645 #: ../src/guestfs-actions.pod:6459
15646 #, no-wrap
15647 msgid ""
15648 " int\n"
15649 " guestfs_txz_in (guestfs_h *g,\n"
15650 "                 const char *tarball,\n"
15651 "                 const char *directory);\n"
15652 "\n"
15653 msgstr ""
15654
15655 #. type: textblock
15656 #: ../src/guestfs-actions.pod:6464 ../fish/guestfish-actions.pod:4319
15657 msgid ""
15658 "This command uploads and unpacks local file C<tarball> (an I<xz compressed> "
15659 "tar file) into C<directory>."
15660 msgstr ""
15661
15662 #. type: =head2
15663 #: ../src/guestfs-actions.pod:6471
15664 msgid "guestfs_txz_out"
15665 msgstr ""
15666
15667 #. type: verbatim
15668 #: ../src/guestfs-actions.pod:6473
15669 #, no-wrap
15670 msgid ""
15671 " int\n"
15672 " guestfs_txz_out (guestfs_h *g,\n"
15673 "                  const char *directory,\n"
15674 "                  const char *tarball);\n"
15675 "\n"
15676 msgstr ""
15677
15678 #. type: textblock
15679 #: ../src/guestfs-actions.pod:6478 ../fish/guestfish-actions.pod:4328
15680 msgid ""
15681 "This command packs the contents of C<directory> and downloads it to local "
15682 "file C<tarball> (as an xz compressed tar archive)."
15683 msgstr ""
15684
15685 #. type: =head2
15686 #: ../src/guestfs-actions.pod:6485
15687 msgid "guestfs_umask"
15688 msgstr ""
15689
15690 #. type: verbatim
15691 #: ../src/guestfs-actions.pod:6487
15692 #, no-wrap
15693 msgid ""
15694 " int\n"
15695 " guestfs_umask (guestfs_h *g,\n"
15696 "                int mask);\n"
15697 "\n"
15698 msgstr ""
15699
15700 #. type: textblock
15701 #: ../src/guestfs-actions.pod:6491 ../fish/guestfish-actions.pod:4337
15702 msgid ""
15703 "This function sets the mask used for creating new files and device nodes to "
15704 "C<mask & 0777>."
15705 msgstr ""
15706
15707 #. type: textblock
15708 #: ../src/guestfs-actions.pod:6494 ../fish/guestfish-actions.pod:4340
15709 msgid ""
15710 "Typical umask values would be C<022> which creates new files with "
15711 "permissions like \"-rw-r--r--\" or \"-rwxr-xr-x\", and C<002> which creates "
15712 "new files with permissions like \"-rw-rw-r--\" or \"-rwxrwxr-x\"."
15713 msgstr ""
15714
15715 #. type: textblock
15716 #: ../src/guestfs-actions.pod:6499 ../fish/guestfish-actions.pod:4345
15717 msgid ""
15718 "The default umask is C<022>.  This is important because it means that "
15719 "directories and device nodes will be created with C<0644> or C<0755> mode "
15720 "even if you specify C<0777>."
15721 msgstr ""
15722
15723 #. type: textblock
15724 #: ../src/guestfs-actions.pod:6503
15725 msgid ""
15726 "See also C<guestfs_get_umask>, L<umask(2)>, C<guestfs_mknod>, "
15727 "C<guestfs_mkdir>."
15728 msgstr ""
15729
15730 #. type: textblock
15731 #: ../src/guestfs-actions.pod:6506 ../fish/guestfish-actions.pod:4352
15732 msgid "This call returns the previous umask."
15733 msgstr ""
15734
15735 #. type: =head2
15736 #: ../src/guestfs-actions.pod:6512
15737 msgid "guestfs_umount"
15738 msgstr ""
15739
15740 #. type: verbatim
15741 #: ../src/guestfs-actions.pod:6514
15742 #, no-wrap
15743 msgid ""
15744 " int\n"
15745 " guestfs_umount (guestfs_h *g,\n"
15746 "                 const char *pathordevice);\n"
15747 "\n"
15748 msgstr ""
15749
15750 #. type: textblock
15751 #: ../src/guestfs-actions.pod:6518 ../fish/guestfish-actions.pod:4360
15752 msgid ""
15753 "This unmounts the given filesystem.  The filesystem may be specified either "
15754 "by its mountpoint (path) or the device which contains the filesystem."
15755 msgstr ""
15756
15757 #. type: =head2
15758 #: ../src/guestfs-actions.pod:6526
15759 msgid "guestfs_umount_all"
15760 msgstr ""
15761
15762 #. type: verbatim
15763 #: ../src/guestfs-actions.pod:6528
15764 #, no-wrap
15765 msgid ""
15766 " int\n"
15767 " guestfs_umount_all (guestfs_h *g);\n"
15768 "\n"
15769 msgstr ""
15770
15771 #. type: textblock
15772 #: ../src/guestfs-actions.pod:6531 ../fish/guestfish-actions.pod:4370
15773 msgid "This unmounts all mounted filesystems."
15774 msgstr ""
15775
15776 #. type: textblock
15777 #: ../src/guestfs-actions.pod:6533 ../fish/guestfish-actions.pod:4372
15778 msgid "Some internal mounts are not unmounted by this call."
15779 msgstr ""
15780
15781 #. type: =head2
15782 #: ../src/guestfs-actions.pod:6539
15783 msgid "guestfs_upload"
15784 msgstr ""
15785
15786 #. type: verbatim
15787 #: ../src/guestfs-actions.pod:6541
15788 #, no-wrap
15789 msgid ""
15790 " int\n"
15791 " guestfs_upload (guestfs_h *g,\n"
15792 "                 const char *filename,\n"
15793 "                 const char *remotefilename);\n"
15794 "\n"
15795 msgstr ""
15796
15797 #. type: textblock
15798 #: ../src/guestfs-actions.pod:6546 ../src/guestfs-actions.pod:6570 ../fish/guestfish-actions.pod:4378 ../fish/guestfish-actions.pod:4391
15799 msgid "Upload local file C<filename> to C<remotefilename> on the filesystem."
15800 msgstr ""
15801
15802 #. type: textblock
15803 #: ../src/guestfs-actions.pod:6551
15804 msgid "See also C<guestfs_download>."
15805 msgstr ""
15806
15807 #. type: =head2
15808 #: ../src/guestfs-actions.pod:6562
15809 msgid "guestfs_upload_offset"
15810 msgstr ""
15811
15812 #. type: verbatim
15813 #: ../src/guestfs-actions.pod:6564
15814 #, no-wrap
15815 msgid ""
15816 " int\n"
15817 " guestfs_upload_offset (guestfs_h *g,\n"
15818 "                        const char *filename,\n"
15819 "                        const char *remotefilename,\n"
15820 "                        int64_t offset);\n"
15821 "\n"
15822 msgstr ""
15823
15824 #. type: textblock
15825 #: ../src/guestfs-actions.pod:6573 ../fish/guestfish-actions.pod:4394
15826 msgid ""
15827 "C<remotefilename> is overwritten starting at the byte C<offset> specified.  "
15828 "The intention is to overwrite parts of existing files or devices, although "
15829 "if a non-existant file is specified then it is created with a \"hole\" "
15830 "before C<offset>.  The size of the data written is implicit in the size of "
15831 "the source C<filename>."
15832 msgstr ""
15833
15834 #. type: textblock
15835 #: ../src/guestfs-actions.pod:6580
15836 msgid ""
15837 "Note that there is no limit on the amount of data that can be uploaded with "
15838 "this call, unlike with C<guestfs_pwrite>, and this call always writes the "
15839 "full amount unless an error occurs."
15840 msgstr ""
15841
15842 #. type: textblock
15843 #: ../src/guestfs-actions.pod:6585
15844 msgid "See also C<guestfs_upload>, C<guestfs_pwrite>."
15845 msgstr ""
15846
15847 #. type: =head2
15848 #: ../src/guestfs-actions.pod:6596
15849 msgid "guestfs_utimens"
15850 msgstr ""
15851
15852 #. type: verbatim
15853 #: ../src/guestfs-actions.pod:6598
15854 #, no-wrap
15855 msgid ""
15856 " int\n"
15857 " guestfs_utimens (guestfs_h *g,\n"
15858 "                  const char *path,\n"
15859 "                  int64_t atsecs,\n"
15860 "                  int64_t atnsecs,\n"
15861 "                  int64_t mtsecs,\n"
15862 "                  int64_t mtnsecs);\n"
15863 "\n"
15864 msgstr ""
15865
15866 #. type: textblock
15867 #: ../src/guestfs-actions.pod:6606 ../fish/guestfish-actions.pod:4414
15868 msgid "This command sets the timestamps of a file with nanosecond precision."
15869 msgstr ""
15870
15871 #. type: textblock
15872 #: ../src/guestfs-actions.pod:6609 ../fish/guestfish-actions.pod:4417
15873 msgid ""
15874 "C<atsecs, atnsecs> are the last access time (atime) in secs and nanoseconds "
15875 "from the epoch."
15876 msgstr ""
15877
15878 #. type: textblock
15879 #: ../src/guestfs-actions.pod:6612 ../fish/guestfish-actions.pod:4420
15880 msgid ""
15881 "C<mtsecs, mtnsecs> are the last modification time (mtime) in secs and "
15882 "nanoseconds from the epoch."
15883 msgstr ""
15884
15885 #. type: textblock
15886 #: ../src/guestfs-actions.pod:6615 ../fish/guestfish-actions.pod:4423
15887 msgid ""
15888 "If the C<*nsecs> field contains the special value C<-1> then the "
15889 "corresponding timestamp is set to the current time.  (The C<*secs> field is "
15890 "ignored in this case)."
15891 msgstr ""
15892
15893 #. type: textblock
15894 #: ../src/guestfs-actions.pod:6619 ../fish/guestfish-actions.pod:4427
15895 msgid ""
15896 "If the C<*nsecs> field contains the special value C<-2> then the "
15897 "corresponding timestamp is left unchanged.  (The C<*secs> field is ignored "
15898 "in this case)."
15899 msgstr ""
15900
15901 #. type: =head2
15902 #: ../src/guestfs-actions.pod:6627 ../src/guestfs-structs.pod:175
15903 msgid "guestfs_version"
15904 msgstr ""
15905
15906 #. type: verbatim
15907 #: ../src/guestfs-actions.pod:6629
15908 #, no-wrap
15909 msgid ""
15910 " struct guestfs_version *\n"
15911 " guestfs_version (guestfs_h *g);\n"
15912 "\n"
15913 msgstr ""
15914
15915 #. type: textblock
15916 #: ../src/guestfs-actions.pod:6632 ../fish/guestfish-actions.pod:4435
15917 msgid "Return the libguestfs version number that the program is linked against."
15918 msgstr ""
15919
15920 #. type: textblock
15921 #: ../src/guestfs-actions.pod:6635 ../fish/guestfish-actions.pod:4438
15922 msgid ""
15923 "Note that because of dynamic linking this is not necessarily the version of "
15924 "libguestfs that you compiled against.  You can compile the program, and then "
15925 "at runtime dynamically link against a completely different C<libguestfs.so> "
15926 "library."
15927 msgstr ""
15928
15929 #. type: textblock
15930 #: ../src/guestfs-actions.pod:6640 ../fish/guestfish-actions.pod:4443
15931 msgid ""
15932 "This call was added in version C<1.0.58>.  In previous versions of "
15933 "libguestfs there was no way to get the version number.  From C code you can "
15934 "use dynamic linker functions to find out if this symbol exists (if it "
15935 "doesn't, then it's an earlier version)."
15936 msgstr ""
15937
15938 #. type: textblock
15939 #: ../src/guestfs-actions.pod:6646 ../fish/guestfish-actions.pod:4449
15940 msgid ""
15941 "The call returns a structure with four elements.  The first three (C<major>, "
15942 "C<minor> and C<release>) are numbers and correspond to the usual version "
15943 "triplet.  The fourth element (C<extra>) is a string and is normally empty, "
15944 "but may be used for distro-specific information."
15945 msgstr ""
15946
15947 #. type: textblock
15948 #: ../src/guestfs-actions.pod:6652 ../fish/guestfish-actions.pod:4455
15949 msgid "To construct the original version string: C<$major.$minor.$release$extra>"
15950 msgstr ""
15951
15952 #. type: textblock
15953 #: ../src/guestfs-actions.pod:6655 ../fish/guestfish-actions.pod:4458
15954 msgid "See also: L<guestfs(3)/LIBGUESTFS VERSION NUMBERS>."
15955 msgstr ""
15956
15957 #. type: textblock
15958 #: ../src/guestfs-actions.pod:6657
15959 msgid ""
15960 "I<Note:> Don't use this call to test for availability of features.  In "
15961 "enterprise distributions we backport features from later versions into "
15962 "earlier versions, making this an unreliable way to test for features.  Use "
15963 "C<guestfs_available> instead."
15964 msgstr ""
15965
15966 #. type: textblock
15967 #: ../src/guestfs-actions.pod:6663
15968 msgid ""
15969 "This function returns a C<struct guestfs_version *>, or NULL if there was an "
15970 "error.  I<The caller must call C<guestfs_free_version> after use>."
15971 msgstr ""
15972
15973 #. type: textblock
15974 #: ../src/guestfs-actions.pod:6667
15975 msgid "(Added in 1.0.58)"
15976 msgstr ""
15977
15978 #. type: =head2
15979 #: ../src/guestfs-actions.pod:6669
15980 msgid "guestfs_vfs_label"
15981 msgstr ""
15982
15983 #. type: verbatim
15984 #: ../src/guestfs-actions.pod:6671
15985 #, no-wrap
15986 msgid ""
15987 " char *\n"
15988 " guestfs_vfs_label (guestfs_h *g,\n"
15989 "                    const char *device);\n"
15990 "\n"
15991 msgstr ""
15992
15993 #. type: textblock
15994 #: ../src/guestfs-actions.pod:6675 ../fish/guestfish-actions.pod:4470
15995 msgid "This returns the filesystem label of the filesystem on C<device>."
15996 msgstr ""
15997
15998 #. type: textblock
15999 #: ../src/guestfs-actions.pod:6678 ../fish/guestfish-actions.pod:4473
16000 msgid "If the filesystem is unlabeled, this returns the empty string."
16001 msgstr ""
16002
16003 #. type: textblock
16004 #: ../src/guestfs-actions.pod:6680
16005 msgid "To find a filesystem from the label, use C<guestfs_findfs_label>."
16006 msgstr ""
16007
16008 #. type: textblock
16009 #: ../src/guestfs-actions.pod:6685 ../src/guestfs-actions.pod:6722
16010 msgid "(Added in 1.3.18)"
16011 msgstr ""
16012
16013 #. type: =head2
16014 #: ../src/guestfs-actions.pod:6687
16015 msgid "guestfs_vfs_type"
16016 msgstr ""
16017
16018 #. type: verbatim
16019 #: ../src/guestfs-actions.pod:6689
16020 #, no-wrap
16021 msgid ""
16022 " char *\n"
16023 " guestfs_vfs_type (guestfs_h *g,\n"
16024 "                   const char *device);\n"
16025 "\n"
16026 msgstr ""
16027
16028 #. type: textblock
16029 #: ../src/guestfs-actions.pod:6693 ../fish/guestfish-actions.pod:4481
16030 msgid ""
16031 "This command gets the filesystem type corresponding to the filesystem on "
16032 "C<device>."
16033 msgstr ""
16034
16035 #. type: textblock
16036 #: ../src/guestfs-actions.pod:6696 ../fish/guestfish-actions.pod:4484
16037 msgid ""
16038 "For most filesystems, the result is the name of the Linux VFS module which "
16039 "would be used to mount this filesystem if you mounted it without specifying "
16040 "the filesystem type.  For example a string such as C<ext3> or C<ntfs>."
16041 msgstr ""
16042
16043 #. type: =head2
16044 #: ../src/guestfs-actions.pod:6706
16045 msgid "guestfs_vfs_uuid"
16046 msgstr ""
16047
16048 #. type: verbatim
16049 #: ../src/guestfs-actions.pod:6708
16050 #, no-wrap
16051 msgid ""
16052 " char *\n"
16053 " guestfs_vfs_uuid (guestfs_h *g,\n"
16054 "                   const char *device);\n"
16055 "\n"
16056 msgstr ""
16057
16058 #. type: textblock
16059 #: ../src/guestfs-actions.pod:6712 ../fish/guestfish-actions.pod:4493
16060 msgid "This returns the filesystem UUID of the filesystem on C<device>."
16061 msgstr ""
16062
16063 #. type: textblock
16064 #: ../src/guestfs-actions.pod:6715 ../fish/guestfish-actions.pod:4496
16065 msgid "If the filesystem does not have a UUID, this returns the empty string."
16066 msgstr ""
16067
16068 #. type: textblock
16069 #: ../src/guestfs-actions.pod:6717
16070 msgid "To find a filesystem from the UUID, use C<guestfs_findfs_uuid>."
16071 msgstr ""
16072
16073 #. type: =head2
16074 #: ../src/guestfs-actions.pod:6724
16075 msgid "guestfs_vg_activate"
16076 msgstr ""
16077
16078 #. type: verbatim
16079 #: ../src/guestfs-actions.pod:6726
16080 #, no-wrap
16081 msgid ""
16082 " int\n"
16083 " guestfs_vg_activate (guestfs_h *g,\n"
16084 "                      int activate,\n"
16085 "                      char *const *volgroups);\n"
16086 "\n"
16087 msgstr ""
16088
16089 #. type: textblock
16090 #: ../src/guestfs-actions.pod:6731 ../fish/guestfish-actions.pod:4504
16091 msgid ""
16092 "This command activates or (if C<activate> is false) deactivates all logical "
16093 "volumes in the listed volume groups C<volgroups>.  If activated, then they "
16094 "are made known to the kernel, ie. they appear as C</dev/mapper> devices.  If "
16095 "deactivated, then those devices disappear."
16096 msgstr ""
16097
16098 #. type: textblock
16099 #: ../src/guestfs-actions.pod:6737 ../fish/guestfish-actions.pod:4510
16100 msgid "This command is the same as running C<vgchange -a y|n volgroups...>"
16101 msgstr ""
16102
16103 #. type: textblock
16104 #: ../src/guestfs-actions.pod:6739 ../fish/guestfish-actions.pod:4512
16105 msgid ""
16106 "Note that if C<volgroups> is an empty list then B<all> volume groups are "
16107 "activated or deactivated."
16108 msgstr ""
16109
16110 #. type: =head2
16111 #: ../src/guestfs-actions.pod:6746
16112 msgid "guestfs_vg_activate_all"
16113 msgstr ""
16114
16115 #. type: verbatim
16116 #: ../src/guestfs-actions.pod:6748
16117 #, no-wrap
16118 msgid ""
16119 " int\n"
16120 " guestfs_vg_activate_all (guestfs_h *g,\n"
16121 "                          int activate);\n"
16122 "\n"
16123 msgstr ""
16124
16125 #. type: textblock
16126 #: ../src/guestfs-actions.pod:6752 ../fish/guestfish-actions.pod:4519
16127 msgid ""
16128 "This command activates or (if C<activate> is false) deactivates all logical "
16129 "volumes in all volume groups.  If activated, then they are made known to the "
16130 "kernel, ie. they appear as C</dev/mapper> devices.  If deactivated, then "
16131 "those devices disappear."
16132 msgstr ""
16133
16134 #. type: textblock
16135 #: ../src/guestfs-actions.pod:6758 ../fish/guestfish-actions.pod:4525
16136 msgid "This command is the same as running C<vgchange -a y|n>"
16137 msgstr ""
16138
16139 #. type: =head2
16140 #: ../src/guestfs-actions.pod:6764
16141 msgid "guestfs_vgcreate"
16142 msgstr ""
16143
16144 #. type: verbatim
16145 #: ../src/guestfs-actions.pod:6766
16146 #, no-wrap
16147 msgid ""
16148 " int\n"
16149 " guestfs_vgcreate (guestfs_h *g,\n"
16150 "                   const char *volgroup,\n"
16151 "                   char *const *physvols);\n"
16152 "\n"
16153 msgstr ""
16154
16155 #. type: textblock
16156 #: ../src/guestfs-actions.pod:6771 ../fish/guestfish-actions.pod:4531
16157 msgid ""
16158 "This creates an LVM volume group called C<volgroup> from the non-empty list "
16159 "of physical volumes C<physvols>."
16160 msgstr ""
16161
16162 #. type: =head2
16163 #: ../src/guestfs-actions.pod:6778
16164 msgid "guestfs_vglvuuids"
16165 msgstr ""
16166
16167 #. type: verbatim
16168 #: ../src/guestfs-actions.pod:6780
16169 #, no-wrap
16170 msgid ""
16171 " char **\n"
16172 " guestfs_vglvuuids (guestfs_h *g,\n"
16173 "                    const char *vgname);\n"
16174 "\n"
16175 msgstr ""
16176
16177 #. type: textblock
16178 #: ../src/guestfs-actions.pod:6784 ../fish/guestfish-actions.pod:4538
16179 msgid ""
16180 "Given a VG called C<vgname>, this returns the UUIDs of all the logical "
16181 "volumes created in this volume group."
16182 msgstr ""
16183
16184 #. type: textblock
16185 #: ../src/guestfs-actions.pod:6787
16186 msgid ""
16187 "You can use this along with C<guestfs_lvs> and C<guestfs_lvuuid> calls to "
16188 "associate logical volumes and volume groups."
16189 msgstr ""
16190
16191 #. type: textblock
16192 #: ../src/guestfs-actions.pod:6790
16193 msgid "See also C<guestfs_vgpvuuids>."
16194 msgstr ""
16195
16196 #. type: =head2
16197 #: ../src/guestfs-actions.pod:6798
16198 msgid "guestfs_vgpvuuids"
16199 msgstr ""
16200
16201 #. type: verbatim
16202 #: ../src/guestfs-actions.pod:6800
16203 #, no-wrap
16204 msgid ""
16205 " char **\n"
16206 " guestfs_vgpvuuids (guestfs_h *g,\n"
16207 "                    const char *vgname);\n"
16208 "\n"
16209 msgstr ""
16210
16211 #. type: textblock
16212 #: ../src/guestfs-actions.pod:6804 ../fish/guestfish-actions.pod:4550
16213 msgid ""
16214 "Given a VG called C<vgname>, this returns the UUIDs of all the physical "
16215 "volumes that this volume group resides on."
16216 msgstr ""
16217
16218 #. type: textblock
16219 #: ../src/guestfs-actions.pod:6807
16220 msgid ""
16221 "You can use this along with C<guestfs_pvs> and C<guestfs_pvuuid> calls to "
16222 "associate physical volumes and volume groups."
16223 msgstr ""
16224
16225 #. type: textblock
16226 #: ../src/guestfs-actions.pod:6810
16227 msgid "See also C<guestfs_vglvuuids>."
16228 msgstr ""
16229
16230 #. type: =head2
16231 #: ../src/guestfs-actions.pod:6818
16232 msgid "guestfs_vgremove"
16233 msgstr ""
16234
16235 #. type: verbatim
16236 #: ../src/guestfs-actions.pod:6820
16237 #, no-wrap
16238 msgid ""
16239 " int\n"
16240 " guestfs_vgremove (guestfs_h *g,\n"
16241 "                   const char *vgname);\n"
16242 "\n"
16243 msgstr ""
16244
16245 #. type: textblock
16246 #: ../src/guestfs-actions.pod:6824 ../fish/guestfish-actions.pod:4562
16247 msgid "Remove an LVM volume group C<vgname>, (for example C<VG>)."
16248 msgstr ""
16249
16250 #. type: textblock
16251 #: ../src/guestfs-actions.pod:6826 ../fish/guestfish-actions.pod:4564
16252 msgid "This also forcibly removes all logical volumes in the volume group (if any)."
16253 msgstr ""
16254
16255 #. type: =head2
16256 #: ../src/guestfs-actions.pod:6833
16257 msgid "guestfs_vgrename"
16258 msgstr ""
16259
16260 #. type: verbatim
16261 #: ../src/guestfs-actions.pod:6835
16262 #, no-wrap
16263 msgid ""
16264 " int\n"
16265 " guestfs_vgrename (guestfs_h *g,\n"
16266 "                   const char *volgroup,\n"
16267 "                   const char *newvolgroup);\n"
16268 "\n"
16269 msgstr ""
16270
16271 #. type: textblock
16272 #: ../src/guestfs-actions.pod:6840 ../fish/guestfish-actions.pod:4571
16273 msgid "Rename a volume group C<volgroup> with the new name C<newvolgroup>."
16274 msgstr ""
16275
16276 #. type: =head2
16277 #: ../src/guestfs-actions.pod:6846
16278 msgid "guestfs_vgs"
16279 msgstr ""
16280
16281 #. type: verbatim
16282 #: ../src/guestfs-actions.pod:6848
16283 #, no-wrap
16284 msgid ""
16285 " char **\n"
16286 " guestfs_vgs (guestfs_h *g);\n"
16287 "\n"
16288 msgstr ""
16289
16290 #. type: textblock
16291 #: ../src/guestfs-actions.pod:6851 ../fish/guestfish-actions.pod:4577
16292 msgid ""
16293 "List all the volumes groups detected.  This is the equivalent of the "
16294 "L<vgs(8)> command."
16295 msgstr ""
16296
16297 #. type: textblock
16298 #: ../src/guestfs-actions.pod:6854 ../fish/guestfish-actions.pod:4580
16299 msgid ""
16300 "This returns a list of just the volume group names that were detected "
16301 "(eg. C<VolGroup00>)."
16302 msgstr ""
16303
16304 #. type: textblock
16305 #: ../src/guestfs-actions.pod:6857
16306 msgid "See also C<guestfs_vgs_full>."
16307 msgstr ""
16308
16309 #. type: =head2
16310 #: ../src/guestfs-actions.pod:6865
16311 msgid "guestfs_vgs_full"
16312 msgstr ""
16313
16314 #. type: verbatim
16315 #: ../src/guestfs-actions.pod:6867
16316 #, no-wrap
16317 msgid ""
16318 " struct guestfs_lvm_vg_list *\n"
16319 " guestfs_vgs_full (guestfs_h *g);\n"
16320 "\n"
16321 msgstr ""
16322
16323 #. type: textblock
16324 #: ../src/guestfs-actions.pod:6870 ../fish/guestfish-actions.pod:4589
16325 msgid ""
16326 "List all the volumes groups detected.  This is the equivalent of the "
16327 "L<vgs(8)> command.  The \"full\" version includes all fields."
16328 msgstr ""
16329
16330 #. type: textblock
16331 #: ../src/guestfs-actions.pod:6873
16332 msgid ""
16333 "This function returns a C<struct guestfs_lvm_vg_list *>, or NULL if there "
16334 "was an error.  I<The caller must call C<guestfs_free_lvm_vg_list> after "
16335 "use>."
16336 msgstr ""
16337
16338 #. type: =head2
16339 #: ../src/guestfs-actions.pod:6879
16340 msgid "guestfs_vgscan"
16341 msgstr ""
16342
16343 #. type: verbatim
16344 #: ../src/guestfs-actions.pod:6881
16345 #, no-wrap
16346 msgid ""
16347 " int\n"
16348 " guestfs_vgscan (guestfs_h *g);\n"
16349 "\n"
16350 msgstr ""
16351
16352 #. type: textblock
16353 #: ../src/guestfs-actions.pod:6884 ../fish/guestfish-actions.pod:4596
16354 msgid ""
16355 "This rescans all block devices and rebuilds the list of LVM physical "
16356 "volumes, volume groups and logical volumes."
16357 msgstr ""
16358
16359 #. type: =head2
16360 #: ../src/guestfs-actions.pod:6891
16361 msgid "guestfs_vguuid"
16362 msgstr ""
16363
16364 #. type: verbatim
16365 #: ../src/guestfs-actions.pod:6893
16366 #, no-wrap
16367 msgid ""
16368 " char *\n"
16369 " guestfs_vguuid (guestfs_h *g,\n"
16370 "                 const char *vgname);\n"
16371 "\n"
16372 msgstr ""
16373
16374 #. type: textblock
16375 #: ../src/guestfs-actions.pod:6897 ../fish/guestfish-actions.pod:4603
16376 msgid "This command returns the UUID of the LVM VG named C<vgname>."
16377 msgstr ""
16378
16379 #. type: =head2
16380 #: ../src/guestfs-actions.pod:6904
16381 msgid "guestfs_wait_ready"
16382 msgstr ""
16383
16384 #. type: verbatim
16385 #: ../src/guestfs-actions.pod:6906
16386 #, no-wrap
16387 msgid ""
16388 " int\n"
16389 " guestfs_wait_ready (guestfs_h *g);\n"
16390 "\n"
16391 msgstr ""
16392
16393 #. type: textblock
16394 #: ../src/guestfs-actions.pod:6909
16395 msgid "This function is a no op."
16396 msgstr ""
16397
16398 #. type: textblock
16399 #: ../src/guestfs-actions.pod:6911
16400 msgid ""
16401 "In versions of the API E<lt> 1.0.71 you had to call this function just after "
16402 "calling C<guestfs_launch> to wait for the launch to complete.  However this "
16403 "is no longer necessary because C<guestfs_launch> now does the waiting."
16404 msgstr ""
16405
16406 #. type: textblock
16407 #: ../src/guestfs-actions.pod:6916
16408 msgid ""
16409 "If you see any calls to this function in code then you can just remove them, "
16410 "unless you want to retain compatibility with older versions of the API."
16411 msgstr ""
16412
16413 #. type: =head2
16414 #: ../src/guestfs-actions.pod:6924
16415 msgid "guestfs_wc_c"
16416 msgstr ""
16417
16418 #. type: verbatim
16419 #: ../src/guestfs-actions.pod:6926
16420 #, no-wrap
16421 msgid ""
16422 " int\n"
16423 " guestfs_wc_c (guestfs_h *g,\n"
16424 "               const char *path);\n"
16425 "\n"
16426 msgstr ""
16427
16428 #. type: textblock
16429 #: ../src/guestfs-actions.pod:6930 ../fish/guestfish-actions.pod:4609
16430 msgid ""
16431 "This command counts the characters in a file, using the C<wc -c> external "
16432 "command."
16433 msgstr ""
16434
16435 #. type: =head2
16436 #: ../src/guestfs-actions.pod:6937
16437 msgid "guestfs_wc_l"
16438 msgstr ""
16439
16440 #. type: verbatim
16441 #: ../src/guestfs-actions.pod:6939
16442 #, no-wrap
16443 msgid ""
16444 " int\n"
16445 " guestfs_wc_l (guestfs_h *g,\n"
16446 "               const char *path);\n"
16447 "\n"
16448 msgstr ""
16449
16450 #. type: textblock
16451 #: ../src/guestfs-actions.pod:6943 ../fish/guestfish-actions.pod:4616
16452 msgid ""
16453 "This command counts the lines in a file, using the C<wc -l> external "
16454 "command."
16455 msgstr ""
16456
16457 #. type: =head2
16458 #: ../src/guestfs-actions.pod:6950
16459 msgid "guestfs_wc_w"
16460 msgstr ""
16461
16462 #. type: verbatim
16463 #: ../src/guestfs-actions.pod:6952
16464 #, no-wrap
16465 msgid ""
16466 " int\n"
16467 " guestfs_wc_w (guestfs_h *g,\n"
16468 "               const char *path);\n"
16469 "\n"
16470 msgstr ""
16471
16472 #. type: textblock
16473 #: ../src/guestfs-actions.pod:6956 ../fish/guestfish-actions.pod:4623
16474 msgid ""
16475 "This command counts the words in a file, using the C<wc -w> external "
16476 "command."
16477 msgstr ""
16478
16479 #. type: =head2
16480 #: ../src/guestfs-actions.pod:6963
16481 msgid "guestfs_write"
16482 msgstr ""
16483
16484 #. type: verbatim
16485 #: ../src/guestfs-actions.pod:6965
16486 #, no-wrap
16487 msgid ""
16488 " int\n"
16489 " guestfs_write (guestfs_h *g,\n"
16490 "                const char *path,\n"
16491 "                const char *content,\n"
16492 "                size_t content_size);\n"
16493 "\n"
16494 msgstr ""
16495
16496 #. type: textblock
16497 #: ../src/guestfs-actions.pod:6971 ../fish/guestfish-actions.pod:4630
16498 msgid ""
16499 "This call creates a file called C<path>.  The content of the file is the "
16500 "string C<content> (which can contain any 8 bit data)."
16501 msgstr ""
16502
16503 #. type: =head2
16504 #: ../src/guestfs-actions.pod:6981
16505 msgid "guestfs_write_file"
16506 msgstr ""
16507
16508 #. type: verbatim
16509 #: ../src/guestfs-actions.pod:6983
16510 #, no-wrap
16511 msgid ""
16512 " int\n"
16513 " guestfs_write_file (guestfs_h *g,\n"
16514 "                     const char *path,\n"
16515 "                     const char *content,\n"
16516 "                     int size);\n"
16517 "\n"
16518 msgstr ""
16519
16520 #. type: textblock
16521 #: ../src/guestfs-actions.pod:6989 ../fish/guestfish-actions.pod:4640
16522 msgid ""
16523 "This call creates a file called C<path>.  The contents of the file is the "
16524 "string C<content> (which can contain any 8 bit data), with length C<size>."
16525 msgstr ""
16526
16527 #. type: textblock
16528 #: ../src/guestfs-actions.pod:6993 ../fish/guestfish-actions.pod:4644
16529 msgid ""
16530 "As a special case, if C<size> is C<0> then the length is calculated using "
16531 "C<strlen> (so in this case the content cannot contain embedded ASCII NULs)."
16532 msgstr ""
16533
16534 #. type: textblock
16535 #: ../src/guestfs-actions.pod:6997 ../fish/guestfish-actions.pod:4648
16536 msgid ""
16537 "I<NB.> Owing to a bug, writing content containing ASCII NUL characters does "
16538 "I<not> work, even if the length is specified."
16539 msgstr ""
16540
16541 #. type: textblock
16542 #: ../src/guestfs-actions.pod:7005
16543 msgid ""
16544 "This function is deprecated.  In new code, use the L</guestfs_write> call "
16545 "instead."
16546 msgstr ""
16547
16548 #. type: =head2
16549 #: ../src/guestfs-actions.pod:7014
16550 msgid "guestfs_zegrep"
16551 msgstr ""
16552
16553 #. type: verbatim
16554 #: ../src/guestfs-actions.pod:7016
16555 #, no-wrap
16556 msgid ""
16557 " char **\n"
16558 " guestfs_zegrep (guestfs_h *g,\n"
16559 "                 const char *regex,\n"
16560 "                 const char *path);\n"
16561 "\n"
16562 msgstr ""
16563
16564 #. type: textblock
16565 #: ../src/guestfs-actions.pod:7021 ../fish/guestfish-actions.pod:4665
16566 msgid "This calls the external C<zegrep> program and returns the matching lines."
16567 msgstr ""
16568
16569 #. type: =head2
16570 #: ../src/guestfs-actions.pod:7033
16571 msgid "guestfs_zegrepi"
16572 msgstr ""
16573
16574 #. type: verbatim
16575 #: ../src/guestfs-actions.pod:7035
16576 #, no-wrap
16577 msgid ""
16578 " char **\n"
16579 " guestfs_zegrepi (guestfs_h *g,\n"
16580 "                  const char *regex,\n"
16581 "                  const char *path);\n"
16582 "\n"
16583 msgstr ""
16584
16585 #. type: textblock
16586 #: ../src/guestfs-actions.pod:7040 ../fish/guestfish-actions.pod:4675
16587 msgid "This calls the external C<zegrep -i> program and returns the matching lines."
16588 msgstr ""
16589
16590 #. type: =head2
16591 #: ../src/guestfs-actions.pod:7052
16592 msgid "guestfs_zero"
16593 msgstr ""
16594
16595 #. type: verbatim
16596 #: ../src/guestfs-actions.pod:7054
16597 #, no-wrap
16598 msgid ""
16599 " int\n"
16600 " guestfs_zero (guestfs_h *g,\n"
16601 "               const char *device);\n"
16602 "\n"
16603 msgstr ""
16604
16605 #. type: textblock
16606 #: ../src/guestfs-actions.pod:7058 ../fish/guestfish-actions.pod:4685
16607 msgid "This command writes zeroes over the first few blocks of C<device>."
16608 msgstr ""
16609
16610 #. type: textblock
16611 #: ../src/guestfs-actions.pod:7060 ../fish/guestfish-actions.pod:4687
16612 msgid ""
16613 "How many blocks are zeroed isn't specified (but it's I<not> enough to "
16614 "securely wipe the device).  It should be sufficient to remove any partition "
16615 "tables, filesystem superblocks and so on."
16616 msgstr ""
16617
16618 #. type: textblock
16619 #: ../src/guestfs-actions.pod:7064
16620 msgid "See also: C<guestfs_zero_device>, C<guestfs_scrub_device>."
16621 msgstr ""
16622
16623 #. type: =head2
16624 #: ../src/guestfs-actions.pod:7075
16625 msgid "guestfs_zero_device"
16626 msgstr ""
16627
16628 #. type: verbatim
16629 #: ../src/guestfs-actions.pod:7077
16630 #, no-wrap
16631 msgid ""
16632 " int\n"
16633 " guestfs_zero_device (guestfs_h *g,\n"
16634 "                      const char *device);\n"
16635 "\n"
16636 msgstr ""
16637
16638 #. type: textblock
16639 #: ../src/guestfs-actions.pod:7081
16640 msgid ""
16641 "This command writes zeroes over the entire C<device>.  Compare with "
16642 "C<guestfs_zero> which just zeroes the first few blocks of a device."
16643 msgstr ""
16644
16645 #. type: textblock
16646 #: ../src/guestfs-actions.pod:7095
16647 msgid "(Added in 1.3.1)"
16648 msgstr ""
16649
16650 #. type: =head2
16651 #: ../src/guestfs-actions.pod:7097
16652 msgid "guestfs_zerofree"
16653 msgstr ""
16654
16655 #. type: verbatim
16656 #: ../src/guestfs-actions.pod:7099
16657 #, no-wrap
16658 msgid ""
16659 " int\n"
16660 " guestfs_zerofree (guestfs_h *g,\n"
16661 "                   const char *device);\n"
16662 "\n"
16663 msgstr ""
16664
16665 #. type: textblock
16666 #: ../src/guestfs-actions.pod:7103 ../fish/guestfish-actions.pod:4708
16667 msgid ""
16668 "This runs the I<zerofree> program on C<device>.  This program claims to zero "
16669 "unused inodes and disk blocks on an ext2/3 filesystem, thus making it "
16670 "possible to compress the filesystem more effectively."
16671 msgstr ""
16672
16673 #. type: textblock
16674 #: ../src/guestfs-actions.pod:7108 ../fish/guestfish-actions.pod:4713
16675 msgid "You should B<not> run this program if the filesystem is mounted."
16676 msgstr ""
16677
16678 #. type: textblock
16679 #: ../src/guestfs-actions.pod:7111 ../fish/guestfish-actions.pod:4716
16680 msgid ""
16681 "It is possible that using this program can damage the filesystem or data on "
16682 "the filesystem."
16683 msgstr ""
16684
16685 #. type: =head2
16686 #: ../src/guestfs-actions.pod:7118
16687 msgid "guestfs_zfgrep"
16688 msgstr ""
16689
16690 #. type: verbatim
16691 #: ../src/guestfs-actions.pod:7120
16692 #, no-wrap
16693 msgid ""
16694 " char **\n"
16695 " guestfs_zfgrep (guestfs_h *g,\n"
16696 "                 const char *pattern,\n"
16697 "                 const char *path);\n"
16698 "\n"
16699 msgstr ""
16700
16701 #. type: textblock
16702 #: ../src/guestfs-actions.pod:7125 ../fish/guestfish-actions.pod:4723
16703 msgid "This calls the external C<zfgrep> program and returns the matching lines."
16704 msgstr ""
16705
16706 #. type: =head2
16707 #: ../src/guestfs-actions.pod:7137
16708 msgid "guestfs_zfgrepi"
16709 msgstr ""
16710
16711 #. type: verbatim
16712 #: ../src/guestfs-actions.pod:7139
16713 #, no-wrap
16714 msgid ""
16715 " char **\n"
16716 " guestfs_zfgrepi (guestfs_h *g,\n"
16717 "                  const char *pattern,\n"
16718 "                  const char *path);\n"
16719 "\n"
16720 msgstr ""
16721
16722 #. type: textblock
16723 #: ../src/guestfs-actions.pod:7144 ../fish/guestfish-actions.pod:4733
16724 msgid "This calls the external C<zfgrep -i> program and returns the matching lines."
16725 msgstr ""
16726
16727 #. type: =head2
16728 #: ../src/guestfs-actions.pod:7156
16729 msgid "guestfs_zfile"
16730 msgstr ""
16731
16732 #. type: verbatim
16733 #: ../src/guestfs-actions.pod:7158
16734 #, no-wrap
16735 msgid ""
16736 " char *\n"
16737 " guestfs_zfile (guestfs_h *g,\n"
16738 "                const char *meth,\n"
16739 "                const char *path);\n"
16740 "\n"
16741 msgstr ""
16742
16743 #. type: textblock
16744 #: ../src/guestfs-actions.pod:7163 ../fish/guestfish-actions.pod:4743
16745 msgid "This command runs C<file> after first decompressing C<path> using C<method>."
16746 msgstr ""
16747
16748 #. type: textblock
16749 #: ../src/guestfs-actions.pod:7166 ../fish/guestfish-actions.pod:4746
16750 msgid "C<method> must be one of C<gzip>, C<compress> or C<bzip2>."
16751 msgstr ""
16752
16753 #. type: textblock
16754 #: ../src/guestfs-actions.pod:7168
16755 msgid ""
16756 "Since 1.0.63, use C<guestfs_file> instead which can now process compressed "
16757 "files."
16758 msgstr ""
16759
16760 #. type: textblock
16761 #: ../src/guestfs-actions.pod:7174
16762 msgid ""
16763 "This function is deprecated.  In new code, use the L</guestfs_file> call "
16764 "instead."
16765 msgstr ""
16766
16767 #. type: =head2
16768 #: ../src/guestfs-actions.pod:7183
16769 msgid "guestfs_zgrep"
16770 msgstr ""
16771
16772 #. type: verbatim
16773 #: ../src/guestfs-actions.pod:7185
16774 #, no-wrap
16775 msgid ""
16776 " char **\n"
16777 " guestfs_zgrep (guestfs_h *g,\n"
16778 "                const char *regex,\n"
16779 "                const char *path);\n"
16780 "\n"
16781 msgstr ""
16782
16783 #. type: textblock
16784 #: ../src/guestfs-actions.pod:7190 ../fish/guestfish-actions.pod:4762
16785 msgid "This calls the external C<zgrep> program and returns the matching lines."
16786 msgstr ""
16787
16788 #. type: =head2
16789 #: ../src/guestfs-actions.pod:7202
16790 msgid "guestfs_zgrepi"
16791 msgstr ""
16792
16793 #. type: verbatim
16794 #: ../src/guestfs-actions.pod:7204
16795 #, no-wrap
16796 msgid ""
16797 " char **\n"
16798 " guestfs_zgrepi (guestfs_h *g,\n"
16799 "                 const char *regex,\n"
16800 "                 const char *path);\n"
16801 "\n"
16802 msgstr ""
16803
16804 #. type: textblock
16805 #: ../src/guestfs-actions.pod:7209 ../fish/guestfish-actions.pod:4772
16806 msgid "This calls the external C<zgrep -i> program and returns the matching lines."
16807 msgstr ""
16808
16809 #. type: =item
16810 #: ../src/guestfs-availability.pod:3
16811 msgid "B<augeas>"
16812 msgstr ""
16813
16814 #. type: textblock
16815 #: ../src/guestfs-availability.pod:5
16816 msgid ""
16817 "The following functions: L</guestfs_aug_clear> L</guestfs_aug_close> "
16818 "L</guestfs_aug_defnode> L</guestfs_aug_defvar> L</guestfs_aug_get> "
16819 "L</guestfs_aug_init> L</guestfs_aug_insert> L</guestfs_aug_load> "
16820 "L</guestfs_aug_ls> L</guestfs_aug_match> L</guestfs_aug_mv> "
16821 "L</guestfs_aug_rm> L</guestfs_aug_save> L</guestfs_aug_set>"
16822 msgstr ""
16823
16824 #. type: =item
16825 #: ../src/guestfs-availability.pod:21
16826 msgid "B<grub>"
16827 msgstr ""
16828
16829 #. type: textblock
16830 #: ../src/guestfs-availability.pod:23
16831 msgid "The following functions: L</guestfs_grub_install>"
16832 msgstr ""
16833
16834 #. type: =item
16835 #: ../src/guestfs-availability.pod:26
16836 msgid "B<inotify>"
16837 msgstr ""
16838
16839 #. type: textblock
16840 #: ../src/guestfs-availability.pod:28
16841 msgid ""
16842 "The following functions: L</guestfs_inotify_add_watch> "
16843 "L</guestfs_inotify_close> L</guestfs_inotify_files> L</guestfs_inotify_init> "
16844 "L</guestfs_inotify_read> L</guestfs_inotify_rm_watch>"
16845 msgstr ""
16846
16847 #. type: =item
16848 #: ../src/guestfs-availability.pod:36
16849 msgid "B<linuxfsuuid>"
16850 msgstr ""
16851
16852 #. type: textblock
16853 #: ../src/guestfs-availability.pod:38
16854 msgid ""
16855 "The following functions: L</guestfs_mke2fs_JU> L</guestfs_mke2journal_U> "
16856 "L</guestfs_mkswap_U> L</guestfs_swapoff_uuid> L</guestfs_swapon_uuid>"
16857 msgstr ""
16858
16859 #. type: =item
16860 #: ../src/guestfs-availability.pod:45
16861 msgid "B<linuxmodules>"
16862 msgstr ""
16863
16864 #. type: textblock
16865 #: ../src/guestfs-availability.pod:47
16866 msgid "The following functions: L</guestfs_modprobe>"
16867 msgstr ""
16868
16869 #. type: =item
16870 #: ../src/guestfs-availability.pod:50
16871 msgid "B<linuxxattrs>"
16872 msgstr ""
16873
16874 #. type: textblock
16875 #: ../src/guestfs-availability.pod:52
16876 msgid ""
16877 "The following functions: L</guestfs_getxattr> L</guestfs_getxattrs> "
16878 "L</guestfs_lgetxattr> L</guestfs_lgetxattrs> L</guestfs_lremovexattr> "
16879 "L</guestfs_lsetxattr> L</guestfs_lxattrlist> L</guestfs_removexattr> "
16880 "L</guestfs_setxattr>"
16881 msgstr ""
16882
16883 #. type: =item
16884 #: ../src/guestfs-availability.pod:63
16885 msgid "B<luks>"
16886 msgstr ""
16887
16888 #. type: textblock
16889 #: ../src/guestfs-availability.pod:65
16890 msgid ""
16891 "The following functions: L</guestfs_luks_add_key> L</guestfs_luks_close> "
16892 "L</guestfs_luks_format> L</guestfs_luks_format_cipher> "
16893 "L</guestfs_luks_kill_slot> L</guestfs_luks_open> L</guestfs_luks_open_ro>"
16894 msgstr ""
16895
16896 #. type: =item
16897 #: ../src/guestfs-availability.pod:74
16898 msgid "B<lvm2>"
16899 msgstr ""
16900
16901 #. type: textblock
16902 #: ../src/guestfs-availability.pod:76
16903 msgid ""
16904 "The following functions: L</guestfs_is_lv> L</guestfs_lvcreate> "
16905 "L</guestfs_lvm_remove_all> L</guestfs_lvm_set_filter> L</guestfs_lvremove> "
16906 "L</guestfs_lvresize> L</guestfs_lvresize_free> L</guestfs_lvs> "
16907 "L</guestfs_lvs_full> L</guestfs_pvcreate> L</guestfs_pvremove> "
16908 "L</guestfs_pvresize> L</guestfs_pvresize_size> L</guestfs_pvs> "
16909 "L</guestfs_pvs_full> L</guestfs_vg_activate> L</guestfs_vg_activate_all> "
16910 "L</guestfs_vgcreate> L</guestfs_vgremove> L</guestfs_vgs> "
16911 "L</guestfs_vgs_full>"
16912 msgstr ""
16913
16914 #. type: =item
16915 #: ../src/guestfs-availability.pod:99
16916 msgid "B<mknod>"
16917 msgstr ""
16918
16919 #. type: textblock
16920 #: ../src/guestfs-availability.pod:101
16921 msgid ""
16922 "The following functions: L</guestfs_mkfifo> L</guestfs_mknod> "
16923 "L</guestfs_mknod_b> L</guestfs_mknod_c>"
16924 msgstr ""
16925
16926 #. type: =item
16927 #: ../src/guestfs-availability.pod:107
16928 msgid "B<ntfs3g>"
16929 msgstr ""
16930
16931 #. type: textblock
16932 #: ../src/guestfs-availability.pod:109
16933 msgid "The following functions: L</guestfs_ntfs_3g_probe>"
16934 msgstr ""
16935
16936 #. type: =item
16937 #: ../src/guestfs-availability.pod:112
16938 msgid "B<ntfsprogs>"
16939 msgstr ""
16940
16941 #. type: textblock
16942 #: ../src/guestfs-availability.pod:114
16943 msgid "The following functions: L</guestfs_ntfsresize> L</guestfs_ntfsresize_size>"
16944 msgstr ""
16945
16946 #. type: =item
16947 #: ../src/guestfs-availability.pod:118
16948 msgid "B<realpath>"
16949 msgstr ""
16950
16951 #. type: textblock
16952 #: ../src/guestfs-availability.pod:120
16953 msgid "The following functions: L</guestfs_realpath>"
16954 msgstr ""
16955
16956 #. type: =item
16957 #: ../src/guestfs-availability.pod:123
16958 msgid "B<scrub>"
16959 msgstr ""
16960
16961 #. type: textblock
16962 #: ../src/guestfs-availability.pod:125
16963 msgid ""
16964 "The following functions: L</guestfs_scrub_device> L</guestfs_scrub_file> "
16965 "L</guestfs_scrub_freespace>"
16966 msgstr ""
16967
16968 #. type: =item
16969 #: ../src/guestfs-availability.pod:130
16970 msgid "B<selinux>"
16971 msgstr ""
16972
16973 #. type: textblock
16974 #: ../src/guestfs-availability.pod:132
16975 msgid "The following functions: L</guestfs_getcon> L</guestfs_setcon>"
16976 msgstr ""
16977
16978 #. type: =item
16979 #: ../src/guestfs-availability.pod:136
16980 msgid "B<xz>"
16981 msgstr ""
16982
16983 #. type: textblock
16984 #: ../src/guestfs-availability.pod:138
16985 msgid "The following functions: L</guestfs_txz_in> L</guestfs_txz_out>"
16986 msgstr ""
16987
16988 #. type: =item
16989 #: ../src/guestfs-availability.pod:142
16990 msgid "B<zerofree>"
16991 msgstr ""
16992
16993 #. type: textblock
16994 #: ../src/guestfs-availability.pod:144
16995 msgid "The following functions: L</guestfs_zerofree>"
16996 msgstr ""
16997
16998 #. type: =head2
16999 #: ../src/guestfs-structs.pod:1
17000 msgid "guestfs_int_bool"
17001 msgstr ""
17002
17003 #. type: verbatim
17004 #: ../src/guestfs-structs.pod:3
17005 #, no-wrap
17006 msgid ""
17007 " struct guestfs_int_bool {\n"
17008 "   int32_t i;\n"
17009 "   int32_t b;\n"
17010 " };\n"
17011 " \n"
17012 msgstr ""
17013
17014 #. type: verbatim
17015 #: ../src/guestfs-structs.pod:8
17016 #, no-wrap
17017 msgid ""
17018 " struct guestfs_int_bool_list {\n"
17019 "   uint32_t len; /* Number of elements in list. */\n"
17020 "   struct guestfs_int_bool *val; /* Elements. */\n"
17021 " };\n"
17022 " \n"
17023 msgstr ""
17024
17025 #. type: verbatim
17026 #: ../src/guestfs-structs.pod:13
17027 #, no-wrap
17028 msgid ""
17029 " void guestfs_free_int_bool (struct guestfs_free_int_bool *);\n"
17030 " void guestfs_free_int_bool_list (struct guestfs_free_int_bool_list *);\n"
17031 "\n"
17032 msgstr ""
17033
17034 #. type: =head2
17035 #: ../src/guestfs-structs.pod:16
17036 msgid "guestfs_lvm_pv"
17037 msgstr ""
17038
17039 #. type: verbatim
17040 #: ../src/guestfs-structs.pod:18
17041 #, no-wrap
17042 msgid ""
17043 " struct guestfs_lvm_pv {\n"
17044 "   char *pv_name;\n"
17045 "   /* The next field is NOT nul-terminated, be careful when printing it: "
17046 "*/\n"
17047 "   char pv_uuid[32];\n"
17048 "   char *pv_fmt;\n"
17049 "   uint64_t pv_size;\n"
17050 "   uint64_t dev_size;\n"
17051 "   uint64_t pv_free;\n"
17052 "   uint64_t pv_used;\n"
17053 "   char *pv_attr;\n"
17054 "   int64_t pv_pe_count;\n"
17055 "   int64_t pv_pe_alloc_count;\n"
17056 "   char *pv_tags;\n"
17057 "   uint64_t pe_start;\n"
17058 "   int64_t pv_mda_count;\n"
17059 "   uint64_t pv_mda_free;\n"
17060 " };\n"
17061 " \n"
17062 msgstr ""
17063
17064 #. type: verbatim
17065 #: ../src/guestfs-structs.pod:36
17066 #, no-wrap
17067 msgid ""
17068 " struct guestfs_lvm_pv_list {\n"
17069 "   uint32_t len; /* Number of elements in list. */\n"
17070 "   struct guestfs_lvm_pv *val; /* Elements. */\n"
17071 " };\n"
17072 " \n"
17073 msgstr ""
17074
17075 #. type: verbatim
17076 #: ../src/guestfs-structs.pod:41
17077 #, no-wrap
17078 msgid ""
17079 " void guestfs_free_lvm_pv (struct guestfs_free_lvm_pv *);\n"
17080 " void guestfs_free_lvm_pv_list (struct guestfs_free_lvm_pv_list *);\n"
17081 "\n"
17082 msgstr ""
17083
17084 #. type: =head2
17085 #: ../src/guestfs-structs.pod:44
17086 msgid "guestfs_lvm_vg"
17087 msgstr ""
17088
17089 #. type: verbatim
17090 #: ../src/guestfs-structs.pod:46
17091 #, no-wrap
17092 msgid ""
17093 " struct guestfs_lvm_vg {\n"
17094 "   char *vg_name;\n"
17095 "   /* The next field is NOT nul-terminated, be careful when printing it: "
17096 "*/\n"
17097 "   char vg_uuid[32];\n"
17098 "   char *vg_fmt;\n"
17099 "   char *vg_attr;\n"
17100 "   uint64_t vg_size;\n"
17101 "   uint64_t vg_free;\n"
17102 "   char *vg_sysid;\n"
17103 "   uint64_t vg_extent_size;\n"
17104 "   int64_t vg_extent_count;\n"
17105 "   int64_t vg_free_count;\n"
17106 "   int64_t max_lv;\n"
17107 "   int64_t max_pv;\n"
17108 "   int64_t pv_count;\n"
17109 "   int64_t lv_count;\n"
17110 "   int64_t snap_count;\n"
17111 "   int64_t vg_seqno;\n"
17112 "   char *vg_tags;\n"
17113 "   int64_t vg_mda_count;\n"
17114 "   uint64_t vg_mda_free;\n"
17115 " };\n"
17116 " \n"
17117 msgstr ""
17118
17119 #. type: verbatim
17120 #: ../src/guestfs-structs.pod:69
17121 #, no-wrap
17122 msgid ""
17123 " struct guestfs_lvm_vg_list {\n"
17124 "   uint32_t len; /* Number of elements in list. */\n"
17125 "   struct guestfs_lvm_vg *val; /* Elements. */\n"
17126 " };\n"
17127 " \n"
17128 msgstr ""
17129
17130 #. type: verbatim
17131 #: ../src/guestfs-structs.pod:74
17132 #, no-wrap
17133 msgid ""
17134 " void guestfs_free_lvm_vg (struct guestfs_free_lvm_vg *);\n"
17135 " void guestfs_free_lvm_vg_list (struct guestfs_free_lvm_vg_list *);\n"
17136 "\n"
17137 msgstr ""
17138
17139 #. type: =head2
17140 #: ../src/guestfs-structs.pod:77
17141 msgid "guestfs_lvm_lv"
17142 msgstr ""
17143
17144 #. type: verbatim
17145 #: ../src/guestfs-structs.pod:79
17146 #, no-wrap
17147 msgid ""
17148 " struct guestfs_lvm_lv {\n"
17149 "   char *lv_name;\n"
17150 "   /* The next field is NOT nul-terminated, be careful when printing it: "
17151 "*/\n"
17152 "   char lv_uuid[32];\n"
17153 "   char *lv_attr;\n"
17154 "   int64_t lv_major;\n"
17155 "   int64_t lv_minor;\n"
17156 "   int64_t lv_kernel_major;\n"
17157 "   int64_t lv_kernel_minor;\n"
17158 "   uint64_t lv_size;\n"
17159 "   int64_t seg_count;\n"
17160 "   char *origin;\n"
17161 "   /* The next field is [0..100] or -1 meaning 'not present': */\n"
17162 "   float snap_percent;\n"
17163 "   /* The next field is [0..100] or -1 meaning 'not present': */\n"
17164 "   float copy_percent;\n"
17165 "   char *move_pv;\n"
17166 "   char *lv_tags;\n"
17167 "   char *mirror_log;\n"
17168 "   char *modules;\n"
17169 " };\n"
17170 " \n"
17171 msgstr ""
17172
17173 #. type: verbatim
17174 #: ../src/guestfs-structs.pod:101
17175 #, no-wrap
17176 msgid ""
17177 " struct guestfs_lvm_lv_list {\n"
17178 "   uint32_t len; /* Number of elements in list. */\n"
17179 "   struct guestfs_lvm_lv *val; /* Elements. */\n"
17180 " };\n"
17181 " \n"
17182 msgstr ""
17183
17184 #. type: verbatim
17185 #: ../src/guestfs-structs.pod:106
17186 #, no-wrap
17187 msgid ""
17188 " void guestfs_free_lvm_lv (struct guestfs_free_lvm_lv *);\n"
17189 " void guestfs_free_lvm_lv_list (struct guestfs_free_lvm_lv_list *);\n"
17190 "\n"
17191 msgstr ""
17192
17193 #. type: verbatim
17194 #: ../src/guestfs-structs.pod:111
17195 #, no-wrap
17196 msgid ""
17197 " struct guestfs_stat {\n"
17198 "   int64_t dev;\n"
17199 "   int64_t ino;\n"
17200 "   int64_t mode;\n"
17201 "   int64_t nlink;\n"
17202 "   int64_t uid;\n"
17203 "   int64_t gid;\n"
17204 "   int64_t rdev;\n"
17205 "   int64_t size;\n"
17206 "   int64_t blksize;\n"
17207 "   int64_t blocks;\n"
17208 "   int64_t atime;\n"
17209 "   int64_t mtime;\n"
17210 "   int64_t ctime;\n"
17211 " };\n"
17212 " \n"
17213 msgstr ""
17214
17215 #. type: verbatim
17216 #: ../src/guestfs-structs.pod:127
17217 #, no-wrap
17218 msgid ""
17219 " struct guestfs_stat_list {\n"
17220 "   uint32_t len; /* Number of elements in list. */\n"
17221 "   struct guestfs_stat *val; /* Elements. */\n"
17222 " };\n"
17223 " \n"
17224 msgstr ""
17225
17226 #. type: verbatim
17227 #: ../src/guestfs-structs.pod:132
17228 #, no-wrap
17229 msgid ""
17230 " void guestfs_free_stat (struct guestfs_free_stat *);\n"
17231 " void guestfs_free_stat_list (struct guestfs_free_stat_list *);\n"
17232 "\n"
17233 msgstr ""
17234
17235 #. type: verbatim
17236 #: ../src/guestfs-structs.pod:137
17237 #, no-wrap
17238 msgid ""
17239 " struct guestfs_statvfs {\n"
17240 "   int64_t bsize;\n"
17241 "   int64_t frsize;\n"
17242 "   int64_t blocks;\n"
17243 "   int64_t bfree;\n"
17244 "   int64_t bavail;\n"
17245 "   int64_t files;\n"
17246 "   int64_t ffree;\n"
17247 "   int64_t favail;\n"
17248 "   int64_t fsid;\n"
17249 "   int64_t flag;\n"
17250 "   int64_t namemax;\n"
17251 " };\n"
17252 " \n"
17253 msgstr ""
17254
17255 #. type: verbatim
17256 #: ../src/guestfs-structs.pod:151
17257 #, no-wrap
17258 msgid ""
17259 " struct guestfs_statvfs_list {\n"
17260 "   uint32_t len; /* Number of elements in list. */\n"
17261 "   struct guestfs_statvfs *val; /* Elements. */\n"
17262 " };\n"
17263 " \n"
17264 msgstr ""
17265
17266 #. type: verbatim
17267 #: ../src/guestfs-structs.pod:156
17268 #, no-wrap
17269 msgid ""
17270 " void guestfs_free_statvfs (struct guestfs_free_statvfs *);\n"
17271 " void guestfs_free_statvfs_list (struct guestfs_free_statvfs_list *);\n"
17272 "\n"
17273 msgstr ""
17274
17275 #. type: =head2
17276 #: ../src/guestfs-structs.pod:159
17277 msgid "guestfs_dirent"
17278 msgstr ""
17279
17280 #. type: verbatim
17281 #: ../src/guestfs-structs.pod:161
17282 #, no-wrap
17283 msgid ""
17284 " struct guestfs_dirent {\n"
17285 "   int64_t ino;\n"
17286 "   char ftyp;\n"
17287 "   char *name;\n"
17288 " };\n"
17289 " \n"
17290 msgstr ""
17291
17292 #. type: verbatim
17293 #: ../src/guestfs-structs.pod:167
17294 #, no-wrap
17295 msgid ""
17296 " struct guestfs_dirent_list {\n"
17297 "   uint32_t len; /* Number of elements in list. */\n"
17298 "   struct guestfs_dirent *val; /* Elements. */\n"
17299 " };\n"
17300 " \n"
17301 msgstr ""
17302
17303 #. type: verbatim
17304 #: ../src/guestfs-structs.pod:172
17305 #, no-wrap
17306 msgid ""
17307 " void guestfs_free_dirent (struct guestfs_free_dirent *);\n"
17308 " void guestfs_free_dirent_list (struct guestfs_free_dirent_list *);\n"
17309 "\n"
17310 msgstr ""
17311
17312 #. type: verbatim
17313 #: ../src/guestfs-structs.pod:177
17314 #, no-wrap
17315 msgid ""
17316 " struct guestfs_version {\n"
17317 "   int64_t major;\n"
17318 "   int64_t minor;\n"
17319 "   int64_t release;\n"
17320 "   char *extra;\n"
17321 " };\n"
17322 " \n"
17323 msgstr ""
17324
17325 #. type: verbatim
17326 #: ../src/guestfs-structs.pod:184
17327 #, no-wrap
17328 msgid ""
17329 " struct guestfs_version_list {\n"
17330 "   uint32_t len; /* Number of elements in list. */\n"
17331 "   struct guestfs_version *val; /* Elements. */\n"
17332 " };\n"
17333 " \n"
17334 msgstr ""
17335
17336 #. type: verbatim
17337 #: ../src/guestfs-structs.pod:189
17338 #, no-wrap
17339 msgid ""
17340 " void guestfs_free_version (struct guestfs_free_version *);\n"
17341 " void guestfs_free_version_list (struct guestfs_free_version_list *);\n"
17342 "\n"
17343 msgstr ""
17344
17345 #. type: =head2
17346 #: ../src/guestfs-structs.pod:192
17347 msgid "guestfs_xattr"
17348 msgstr ""
17349
17350 #. type: verbatim
17351 #: ../src/guestfs-structs.pod:194
17352 #, no-wrap
17353 msgid ""
17354 " struct guestfs_xattr {\n"
17355 "   char *attrname;\n"
17356 "   /* The next two fields describe a byte array. */\n"
17357 "   uint32_t attrval_len;\n"
17358 "   char *attrval;\n"
17359 " };\n"
17360 " \n"
17361 msgstr ""
17362
17363 #. type: verbatim
17364 #: ../src/guestfs-structs.pod:201
17365 #, no-wrap
17366 msgid ""
17367 " struct guestfs_xattr_list {\n"
17368 "   uint32_t len; /* Number of elements in list. */\n"
17369 "   struct guestfs_xattr *val; /* Elements. */\n"
17370 " };\n"
17371 " \n"
17372 msgstr ""
17373
17374 #. type: verbatim
17375 #: ../src/guestfs-structs.pod:206
17376 #, no-wrap
17377 msgid ""
17378 " void guestfs_free_xattr (struct guestfs_free_xattr *);\n"
17379 " void guestfs_free_xattr_list (struct guestfs_free_xattr_list *);\n"
17380 "\n"
17381 msgstr ""
17382
17383 #. type: =head2
17384 #: ../src/guestfs-structs.pod:209
17385 msgid "guestfs_inotify_event"
17386 msgstr ""
17387
17388 #. type: verbatim
17389 #: ../src/guestfs-structs.pod:211
17390 #, no-wrap
17391 msgid ""
17392 " struct guestfs_inotify_event {\n"
17393 "   int64_t in_wd;\n"
17394 "   uint32_t in_mask;\n"
17395 "   uint32_t in_cookie;\n"
17396 "   char *in_name;\n"
17397 " };\n"
17398 " \n"
17399 msgstr ""
17400
17401 #. type: verbatim
17402 #: ../src/guestfs-structs.pod:218
17403 #, no-wrap
17404 msgid ""
17405 " struct guestfs_inotify_event_list {\n"
17406 "   uint32_t len; /* Number of elements in list. */\n"
17407 "   struct guestfs_inotify_event *val; /* Elements. */\n"
17408 " };\n"
17409 " \n"
17410 msgstr ""
17411
17412 #. type: verbatim
17413 #: ../src/guestfs-structs.pod:223
17414 #, no-wrap
17415 msgid ""
17416 " void guestfs_free_inotify_event (struct guestfs_free_inotify_event *);\n"
17417 " void guestfs_free_inotify_event_list (struct "
17418 "guestfs_free_inotify_event_list *);\n"
17419 "\n"
17420 msgstr ""
17421
17422 #. type: =head2
17423 #: ../src/guestfs-structs.pod:226
17424 msgid "guestfs_partition"
17425 msgstr ""
17426
17427 #. type: verbatim
17428 #: ../src/guestfs-structs.pod:228
17429 #, no-wrap
17430 msgid ""
17431 " struct guestfs_partition {\n"
17432 "   int32_t part_num;\n"
17433 "   uint64_t part_start;\n"
17434 "   uint64_t part_end;\n"
17435 "   uint64_t part_size;\n"
17436 " };\n"
17437 " \n"
17438 msgstr ""
17439
17440 #. type: verbatim
17441 #: ../src/guestfs-structs.pod:235
17442 #, no-wrap
17443 msgid ""
17444 " struct guestfs_partition_list {\n"
17445 "   uint32_t len; /* Number of elements in list. */\n"
17446 "   struct guestfs_partition *val; /* Elements. */\n"
17447 " };\n"
17448 " \n"
17449 msgstr ""
17450
17451 #. type: verbatim
17452 #: ../src/guestfs-structs.pod:240
17453 #, no-wrap
17454 msgid ""
17455 " void guestfs_free_partition (struct guestfs_free_partition *);\n"
17456 " void guestfs_free_partition_list (struct guestfs_free_partition_list *);\n"
17457 "\n"
17458 msgstr ""
17459
17460 #. type: =head2
17461 #: ../src/guestfs-structs.pod:243
17462 msgid "guestfs_application"
17463 msgstr ""
17464
17465 #. type: verbatim
17466 #: ../src/guestfs-structs.pod:245
17467 #, no-wrap
17468 msgid ""
17469 " struct guestfs_application {\n"
17470 "   char *app_name;\n"
17471 "   char *app_display_name;\n"
17472 "   int32_t app_epoch;\n"
17473 "   char *app_version;\n"
17474 "   char *app_release;\n"
17475 "   char *app_install_path;\n"
17476 "   char *app_trans_path;\n"
17477 "   char *app_publisher;\n"
17478 "   char *app_url;\n"
17479 "   char *app_source_package;\n"
17480 "   char *app_summary;\n"
17481 "   char *app_description;\n"
17482 " };\n"
17483 " \n"
17484 msgstr ""
17485
17486 #. type: verbatim
17487 #: ../src/guestfs-structs.pod:260
17488 #, no-wrap
17489 msgid ""
17490 " struct guestfs_application_list {\n"
17491 "   uint32_t len; /* Number of elements in list. */\n"
17492 "   struct guestfs_application *val; /* Elements. */\n"
17493 " };\n"
17494 " \n"
17495 msgstr ""
17496
17497 #. type: verbatim
17498 #: ../src/guestfs-structs.pod:265
17499 #, no-wrap
17500 msgid ""
17501 " void guestfs_free_application (struct guestfs_free_application *);\n"
17502 " void guestfs_free_application_list (struct guestfs_free_application_list "
17503 "*);\n"
17504 "\n"
17505 msgstr ""
17506
17507 #. type: textblock
17508 #: ../fish/guestfish.pod:5
17509 msgid "guestfish - the libguestfs Filesystem Interactive SHell"
17510 msgstr ""
17511
17512 #. type: verbatim
17513 #: ../fish/guestfish.pod:9
17514 #, no-wrap
17515 msgid ""
17516 " guestfish [--options] [commands]\n"
17517 "\n"
17518 msgstr ""
17519
17520 #. type: verbatim
17521 #: ../fish/guestfish.pod:11
17522 #, no-wrap
17523 msgid ""
17524 " guestfish\n"
17525 "\n"
17526 msgstr ""
17527
17528 #. type: verbatim
17529 #: ../fish/guestfish.pod:13
17530 #, no-wrap
17531 msgid ""
17532 " guestfish [--ro|--rw] -a disk.img\n"
17533 "\n"
17534 msgstr ""
17535
17536 #. type: verbatim
17537 #: ../fish/guestfish.pod:15
17538 #, no-wrap
17539 msgid ""
17540 " guestfish [--ro|--rw] -a disk.img -m dev[:mountpoint]\n"
17541 "\n"
17542 msgstr ""
17543
17544 #. type: verbatim
17545 #: ../fish/guestfish.pod:17
17546 #, no-wrap
17547 msgid ""
17548 " guestfish -d libvirt-domain\n"
17549 "\n"
17550 msgstr ""
17551
17552 #. type: verbatim
17553 #: ../fish/guestfish.pod:19
17554 #, no-wrap
17555 msgid ""
17556 " guestfish [--ro|--rw] -a disk.img -i\n"
17557 "\n"
17558 msgstr ""
17559
17560 #. type: verbatim
17561 #: ../fish/guestfish.pod:21
17562 #, no-wrap
17563 msgid ""
17564 " guestfish -d libvirt-domain -i\n"
17565 "\n"
17566 msgstr ""
17567
17568 #. type: =head1
17569 #: ../fish/guestfish.pod:23 ../fuse/guestmount.pod:15 ../tools/virt-edit.pl:44 ../tools/virt-win-reg.pl:51 ../tools/virt-tar.pl:59
17570 msgid "WARNING"
17571 msgstr ""
17572
17573 #. type: textblock
17574 #: ../fish/guestfish.pod:25
17575 msgid ""
17576 "Using guestfish in read/write mode on live virtual machines can be "
17577 "dangerous, potentially causing disk corruption.  Use the I<--ro> (read-only) "
17578 "option to use guestfish safely if the disk image or virtual machine might be "
17579 "live."
17580 msgstr ""
17581
17582 #. type: textblock
17583 #: ../fish/guestfish.pod:32
17584 msgid ""
17585 "Guestfish is a shell and command-line tool for examining and modifying "
17586 "virtual machine filesystems.  It uses libguestfs and exposes all of the "
17587 "functionality of the guestfs API, see L<guestfs(3)>."
17588 msgstr ""
17589
17590 #. type: textblock
17591 #: ../fish/guestfish.pod:36
17592 msgid ""
17593 "Guestfish gives you structured access to the libguestfs API, from shell "
17594 "scripts or the command line or interactively.  If you want to rescue a "
17595 "broken virtual machine image, you should look at the L<virt-rescue(1)> "
17596 "command."
17597 msgstr ""
17598
17599 #. type: =head1
17600 #: ../fish/guestfish.pod:41 ../fish/guestfish.pod:908 ../fuse/guestmount.pod:39 ../tools/virt-edit.pl:63 ../tools/virt-resize.pl:64 ../tools/virt-tar.pl:45
17601 msgid "EXAMPLES"
17602 msgstr ""
17603
17604 #. type: =head2
17605 #: ../fish/guestfish.pod:43
17606 msgid "As an interactive shell"
17607 msgstr ""
17608
17609 #. type: verbatim
17610 #: ../fish/guestfish.pod:45
17611 #, no-wrap
17612 msgid ""
17613 " $ guestfish\n"
17614 " \n"
17615 msgstr ""
17616
17617 #. type: verbatim
17618 #: ../fish/guestfish.pod:47
17619 #, no-wrap
17620 msgid ""
17621 " Welcome to guestfish, the libguestfs filesystem interactive shell for\n"
17622 " editing virtual machine filesystems.\n"
17623 " \n"
17624 msgstr ""
17625
17626 #. type: verbatim
17627 #: ../fish/guestfish.pod:50
17628 #, no-wrap
17629 msgid ""
17630 " Type: 'help' for a list of commands\n"
17631 "       'man' to read the manual\n"
17632 "       'quit' to quit the shell\n"
17633 " \n"
17634 msgstr ""
17635
17636 #. type: verbatim
17637 #: ../fish/guestfish.pod:54
17638 #, no-wrap
17639 msgid ""
17640 " ><fs> add-ro disk.img\n"
17641 " ><fs> run\n"
17642 " ><fs> list-filesystems\n"
17643 " /dev/sda1: ext4\n"
17644 " /dev/vg_guest/lv_root: ext4\n"
17645 " /dev/vg_guest/lv_swap: swap\n"
17646 " ><fs> mount /dev/vg_guest/lv_root /\n"
17647 " ><fs> cat /etc/fstab\n"
17648 " # /etc/fstab\n"
17649 " # Created by anaconda\n"
17650 " [...]\n"
17651 " ><fs> exit\n"
17652 "\n"
17653 msgstr ""
17654
17655 #. type: =head2
17656 #: ../fish/guestfish.pod:67
17657 msgid "From shell scripts"
17658 msgstr ""
17659
17660 #. type: textblock
17661 #: ../fish/guestfish.pod:69
17662 msgid "Create a new C</etc/motd> file in a guest or disk image:"
17663 msgstr ""
17664
17665 #. type: verbatim
17666 #: ../fish/guestfish.pod:71
17667 #, no-wrap
17668 msgid ""
17669 " guestfish <<_EOF_\n"
17670 " add disk.img\n"
17671 " run\n"
17672 " mount /dev/vg_guest/lv_root /\n"
17673 " write /etc/motd \"Welcome, new users\"\n"
17674 " _EOF_\n"
17675 "\n"
17676 msgstr ""
17677
17678 #. type: textblock
17679 #: ../fish/guestfish.pod:78
17680 msgid "List the LVM logical volumes in a disk image:"
17681 msgstr ""
17682
17683 #. type: verbatim
17684 #: ../fish/guestfish.pod:80
17685 #, no-wrap
17686 msgid ""
17687 " guestfish -a disk.img --ro <<_EOF_\n"
17688 " run\n"
17689 " lvs\n"
17690 " _EOF_\n"
17691 "\n"
17692 msgstr ""
17693
17694 #. type: textblock
17695 #: ../fish/guestfish.pod:85
17696 msgid "List all the filesystems in a disk image:"
17697 msgstr ""
17698
17699 #. type: verbatim
17700 #: ../fish/guestfish.pod:87
17701 #, no-wrap
17702 msgid ""
17703 " guestfish -a disk.img --ro <<_EOF_\n"
17704 " run\n"
17705 " list-filesystems\n"
17706 " _EOF_\n"
17707 "\n"
17708 msgstr ""
17709
17710 #. type: =head2
17711 #: ../fish/guestfish.pod:92
17712 msgid "On one command line"
17713 msgstr ""
17714
17715 #. type: textblock
17716 #: ../fish/guestfish.pod:94
17717 msgid "Update C</etc/resolv.conf> in a guest:"
17718 msgstr ""
17719
17720 #. type: verbatim
17721 #: ../fish/guestfish.pod:96
17722 #, no-wrap
17723 msgid ""
17724 " guestfish \\\n"
17725 "   add disk.img : run : mount /dev/vg_guest/lv_root / : \\\n"
17726 "   write /etc/resolv.conf \"nameserver 1.2.3.4\"\n"
17727 "\n"
17728 msgstr ""
17729
17730 #. type: textblock
17731 #: ../fish/guestfish.pod:100
17732 msgid "Edit C</boot/grub/grub.conf> interactively:"
17733 msgstr ""
17734
17735 #. type: verbatim
17736 #: ../fish/guestfish.pod:102
17737 #, no-wrap
17738 msgid ""
17739 " guestfish --rw --add disk.img \\\n"
17740 "   --mount /dev/vg_guest/lv_root \\\n"
17741 "   --mount /dev/sda1:/boot \\\n"
17742 "   edit /boot/grub/grub.conf\n"
17743 "\n"
17744 msgstr ""
17745
17746 #. type: =head2
17747 #: ../fish/guestfish.pod:107
17748 msgid "Mount disks automatically"
17749 msgstr ""
17750
17751 #. type: textblock
17752 #: ../fish/guestfish.pod:109
17753 msgid ""
17754 "Use the I<-i> option to automatically mount the disks from a virtual "
17755 "machine:"
17756 msgstr ""
17757
17758 #. type: verbatim
17759 #: ../fish/guestfish.pod:112
17760 #, no-wrap
17761 msgid ""
17762 " guestfish --ro -a disk.img -i cat /etc/group\n"
17763 "\n"
17764 msgstr ""
17765
17766 #. type: verbatim
17767 #: ../fish/guestfish.pod:114
17768 #, no-wrap
17769 msgid ""
17770 " guestfish --ro -d libvirt-domain -i cat /etc/group\n"
17771 "\n"
17772 msgstr ""
17773
17774 #. type: textblock
17775 #: ../fish/guestfish.pod:116
17776 msgid "Another way to edit C</boot/grub/grub.conf> interactively is:"
17777 msgstr ""
17778
17779 #. type: verbatim
17780 #: ../fish/guestfish.pod:118
17781 #, no-wrap
17782 msgid ""
17783 " guestfish --rw -a disk.img -i edit /boot/grub/grub.conf\n"
17784 "\n"
17785 msgstr ""
17786
17787 #. type: =head2
17788 #: ../fish/guestfish.pod:120
17789 msgid "As a script interpreter"
17790 msgstr ""
17791
17792 #. type: textblock
17793 #: ../fish/guestfish.pod:122
17794 msgid "Create a 100MB disk containing an ext2-formatted partition:"
17795 msgstr ""
17796
17797 #. type: verbatim
17798 #: ../fish/guestfish.pod:124
17799 #, no-wrap
17800 msgid ""
17801 " #!/usr/bin/guestfish -f\n"
17802 " sparse test1.img 100M\n"
17803 " run\n"
17804 " part-disk /dev/sda mbr\n"
17805 " mkfs ext2 /dev/sda1\n"
17806 "\n"
17807 msgstr ""
17808
17809 #. type: =head2
17810 #: ../fish/guestfish.pod:130
17811 msgid "Start with a prepared disk"
17812 msgstr ""
17813
17814 #. type: textblock
17815 #: ../fish/guestfish.pod:132
17816 msgid ""
17817 "An alternate way to create a 100MB disk called C<test1.img> containing a "
17818 "single ext2-formatted partition:"
17819 msgstr ""
17820
17821 #. type: verbatim
17822 #: ../fish/guestfish.pod:135
17823 #, no-wrap
17824 msgid ""
17825 " guestfish -N fs\n"
17826 "\n"
17827 msgstr ""
17828
17829 #. type: textblock
17830 #: ../fish/guestfish.pod:137
17831 msgid "To list what is available do:"
17832 msgstr ""
17833
17834 #. type: verbatim
17835 #: ../fish/guestfish.pod:139 ../fish/guestfish.pod:899
17836 #, no-wrap
17837 msgid ""
17838 " guestfish -N help | less\n"
17839 "\n"
17840 msgstr ""
17841
17842 #. type: =head2
17843 #: ../fish/guestfish.pod:141
17844 msgid "Remote control"
17845 msgstr ""
17846
17847 #. type: verbatim
17848 #: ../fish/guestfish.pod:143
17849 #, no-wrap
17850 msgid ""
17851 " eval \"`guestfish --listen`\"\n"
17852 " guestfish --remote add-ro disk.img\n"
17853 " guestfish --remote run\n"
17854 " guestfish --remote lvs\n"
17855 "\n"
17856 msgstr ""
17857
17858 #. type: =head1
17859 #: ../fish/guestfish.pod:148 ../test-tool/libguestfs-test-tool.pod:37 ../fuse/guestmount.pod:73 ../tools/virt-edit.pl:77 ../tools/virt-win-reg.pl:96 ../tools/virt-resize.pl:254 ../tools/virt-list-filesystems.pl:53 ../tools/virt-tar.pl:98 ../tools/virt-make-fs.pl:153 ../tools/virt-list-partitions.pl:54
17860 msgid "OPTIONS"
17861 msgstr ""
17862
17863 #. type: =item
17864 #: ../fish/guestfish.pod:152 ../fuse/guestmount.pod:131 ../tools/virt-edit.pl:85 ../tools/virt-win-reg.pl:104 ../tools/virt-resize.pl:262 ../tools/virt-list-filesystems.pl:61 ../tools/virt-tar.pl:106 ../tools/virt-make-fs.pl:161 ../tools/virt-list-partitions.pl:62
17865 msgid "B<--help>"
17866 msgstr ""
17867
17868 #. type: textblock
17869 #: ../fish/guestfish.pod:154
17870 msgid "Displays general help on options."
17871 msgstr ""
17872
17873 #. type: =item
17874 #: ../fish/guestfish.pod:156
17875 msgid "B<-h>"
17876 msgstr ""
17877
17878 #. type: =item
17879 #: ../fish/guestfish.pod:158
17880 msgid "B<--cmd-help>"
17881 msgstr ""
17882
17883 #. type: textblock
17884 #: ../fish/guestfish.pod:160
17885 msgid "Lists all available guestfish commands."
17886 msgstr ""
17887
17888 #. type: =item
17889 #: ../fish/guestfish.pod:162
17890 msgid "B<-h cmd>"
17891 msgstr ""
17892
17893 #. type: =item
17894 #: ../fish/guestfish.pod:164
17895 msgid "B<--cmd-help cmd>"
17896 msgstr ""
17897
17898 #. type: textblock
17899 #: ../fish/guestfish.pod:166
17900 msgid "Displays detailed help on a single command C<cmd>."
17901 msgstr ""
17902
17903 #. type: =item
17904 #: ../fish/guestfish.pod:168
17905 msgid "B<-a image>"
17906 msgstr ""
17907
17908 #. type: =item
17909 #: ../fish/guestfish.pod:170
17910 msgid "B<--add image>"
17911 msgstr ""
17912
17913 #. type: textblock
17914 #: ../fish/guestfish.pod:172
17915 msgid "Add a block device or virtual machine image to the shell."
17916 msgstr ""
17917
17918 #. type: textblock
17919 #: ../fish/guestfish.pod:174 ../fuse/guestmount.pod:81
17920 msgid ""
17921 "The format of the disk image is auto-detected.  To override this and force a "
17922 "particular format use the I<--format=..> option."
17923 msgstr ""
17924
17925 #. type: textblock
17926 #: ../fish/guestfish.pod:177
17927 msgid ""
17928 "Using this flag is mostly equivalent to using the C<add> command, with "
17929 "C<readonly:true> if the I<--ro> flag was given, and with C<format:...> if "
17930 "the I<--format=...> flag was given."
17931 msgstr ""
17932
17933 #. type: =item
17934 #: ../fish/guestfish.pod:181
17935 msgid "B<-c URI>"
17936 msgstr ""
17937
17938 #. type: =item
17939 #: ../fish/guestfish.pod:183
17940 msgid "B<--connect URI>"
17941 msgstr ""
17942
17943 #. type: textblock
17944 #: ../fish/guestfish.pod:185 ../fuse/guestmount.pod:86
17945 msgid ""
17946 "When used in conjunction with the I<-d> option, this specifies the libvirt "
17947 "URI to use.  The default is to use the default libvirt connection."
17948 msgstr ""
17949
17950 #. type: =item
17951 #: ../fish/guestfish.pod:189
17952 msgid "B<--csh>"
17953 msgstr ""
17954
17955 #. type: textblock
17956 #: ../fish/guestfish.pod:191
17957 msgid ""
17958 "If using the I<--listen> option and a csh-like shell, use this option.  See "
17959 "section L</REMOTE CONTROL AND CSH> below."
17960 msgstr ""
17961
17962 #. type: =item
17963 #: ../fish/guestfish.pod:194
17964 msgid "B<-d libvirt-domain>"
17965 msgstr ""
17966
17967 #. type: =item
17968 #: ../fish/guestfish.pod:196
17969 msgid "B<--domain libvirt-domain>"
17970 msgstr ""
17971
17972 #. type: textblock
17973 #: ../fish/guestfish.pod:198 ../fuse/guestmount.pod:92
17974 msgid ""
17975 "Add disks from the named libvirt domain.  If the I<--ro> option is also "
17976 "used, then any libvirt domain can be used.  However in write mode, only "
17977 "libvirt domains which are shut down can be named here."
17978 msgstr ""
17979
17980 #. type: textblock
17981 #: ../fish/guestfish.pod:202
17982 msgid ""
17983 "Using this flag is mostly equivalent to using the C<add-domain> command, "
17984 "with C<readonly:true> if the I<--ro> flag was given, and with C<format:...> "
17985 "if the I<--format:...> flag was given."
17986 msgstr ""
17987
17988 #. type: =item
17989 #: ../fish/guestfish.pod:206
17990 msgid "B<-D>"
17991 msgstr ""
17992
17993 #. type: =item
17994 #: ../fish/guestfish.pod:208
17995 msgid "B<--no-dest-paths>"
17996 msgstr ""
17997
17998 #. type: textblock
17999 #: ../fish/guestfish.pod:210
18000 msgid ""
18001 "Don't tab-complete paths on the guest filesystem.  It is useful to be able "
18002 "to hit the tab key to complete paths on the guest filesystem, but this "
18003 "causes extra \"hidden\" guestfs calls to be made, so this option is here to "
18004 "allow this feature to be disabled."
18005 msgstr ""
18006
18007 #. type: =item
18008 #: ../fish/guestfish.pod:215 ../fuse/guestmount.pod:108
18009 msgid "B<--echo-keys>"
18010 msgstr ""
18011
18012 #. type: textblock
18013 #: ../fish/guestfish.pod:217 ../fuse/guestmount.pod:110
18014 msgid ""
18015 "When prompting for keys and passphrases, guestfish normally turns echoing "
18016 "off so you cannot see what you are typing.  If you are not worried about "
18017 "Tempest attacks and there is no one else in the room you can specify this "
18018 "flag to see what you are typing."
18019 msgstr ""
18020
18021 #. type: =item
18022 #: ../fish/guestfish.pod:222
18023 msgid "B<-f file>"
18024 msgstr ""
18025
18026 #. type: =item
18027 #: ../fish/guestfish.pod:224
18028 msgid "B<--file file>"
18029 msgstr ""
18030
18031 #. type: textblock
18032 #: ../fish/guestfish.pod:226
18033 msgid "Read commands from C<file>.  To write pure guestfish scripts, use:"
18034 msgstr ""
18035
18036 #. type: verbatim
18037 #: ../fish/guestfish.pod:229
18038 #, no-wrap
18039 msgid ""
18040 " #!/usr/bin/guestfish -f\n"
18041 "\n"
18042 msgstr ""
18043
18044 #. type: =item
18045 #: ../fish/guestfish.pod:231
18046 msgid "B<--format=raw|qcow2|..>"
18047 msgstr ""
18048
18049 #. type: =item
18050 #: ../fish/guestfish.pod:233
18051 msgid "B<--format>"
18052 msgstr ""
18053
18054 #. type: textblock
18055 #: ../fish/guestfish.pod:235 ../fuse/guestmount.pod:117
18056 msgid ""
18057 "The default for the I<-a> option is to auto-detect the format of the disk "
18058 "image.  Using this forces the disk format for I<-a> options which follow on "
18059 "the command line.  Using I<--format> with no argument switches back to "
18060 "auto-detection for subsequent I<-a> options."
18061 msgstr ""
18062
18063 #. type: verbatim
18064 #: ../fish/guestfish.pod:242
18065 #, no-wrap
18066 msgid ""
18067 " guestfish --format=raw -a disk.img\n"
18068 "\n"
18069 msgstr ""
18070
18071 #. type: textblock
18072 #: ../fish/guestfish.pod:244
18073 msgid "forces raw format (no auto-detection) for C<disk.img>."
18074 msgstr ""
18075
18076 #. type: verbatim
18077 #: ../fish/guestfish.pod:246
18078 #, no-wrap
18079 msgid ""
18080 " guestfish --format=raw -a disk.img --format -a another.img\n"
18081 "\n"
18082 msgstr ""
18083
18084 #. type: textblock
18085 #: ../fish/guestfish.pod:248
18086 msgid ""
18087 "forces raw format (no auto-detection) for C<disk.img> and reverts to "
18088 "auto-detection for C<another.img>."
18089 msgstr ""
18090
18091 #. type: textblock
18092 #: ../fish/guestfish.pod:251
18093 msgid ""
18094 "If you have untrusted raw-format guest disk images, you should use this "
18095 "option to specify the disk format.  This avoids a possible security problem "
18096 "with malicious guests (CVE-2010-3851).  See also L</add-drive-opts>."
18097 msgstr ""
18098
18099 #. type: =item
18100 #: ../fish/guestfish.pod:256
18101 msgid "B<-i>"
18102 msgstr ""
18103
18104 #. type: =item
18105 #: ../fish/guestfish.pod:258
18106 msgid "B<--inspector>"
18107 msgstr ""
18108
18109 #. type: textblock
18110 #: ../fish/guestfish.pod:260 ../fuse/guestmount.pod:137
18111 msgid ""
18112 "Using L<virt-inspector(1)> code, inspect the disks looking for an operating "
18113 "system and mount filesystems as they would be mounted on the real virtual "
18114 "machine."
18115 msgstr ""
18116
18117 #. type: textblock
18118 #: ../fish/guestfish.pod:264
18119 msgid "Typical usage is either:"
18120 msgstr ""
18121
18122 #. type: verbatim
18123 #: ../fish/guestfish.pod:266
18124 #, no-wrap
18125 msgid ""
18126 " guestfish -d myguest -i\n"
18127 "\n"
18128 msgstr ""
18129
18130 #. type: textblock
18131 #: ../fish/guestfish.pod:268
18132 msgid "(for an inactive libvirt domain called I<myguest>), or:"
18133 msgstr ""
18134
18135 #. type: verbatim
18136 #: ../fish/guestfish.pod:270
18137 #, no-wrap
18138 msgid ""
18139 " guestfish --ro -d myguest -i\n"
18140 "\n"
18141 msgstr ""
18142
18143 #. type: textblock
18144 #: ../fish/guestfish.pod:272
18145 msgid "(for active domains, readonly), or specify the block device directly:"
18146 msgstr ""
18147
18148 #. type: verbatim
18149 #: ../fish/guestfish.pod:274
18150 #, no-wrap
18151 msgid ""
18152 " guestfish --rw -a /dev/Guests/MyGuest -i\n"
18153 "\n"
18154 msgstr ""
18155
18156 #. type: textblock
18157 #: ../fish/guestfish.pod:276
18158 msgid ""
18159 "Note that the command line syntax changed slightly over older versions of "
18160 "guestfish.  You can still use the old syntax:"
18161 msgstr ""
18162
18163 #. type: verbatim
18164 #: ../fish/guestfish.pod:279
18165 #, no-wrap
18166 msgid ""
18167 " guestfish [--ro] -i disk.img\n"
18168 "\n"
18169 msgstr ""
18170
18171 #. type: verbatim
18172 #: ../fish/guestfish.pod:281
18173 #, no-wrap
18174 msgid ""
18175 " guestfish [--ro] -i libvirt-domain\n"
18176 "\n"
18177 msgstr ""
18178
18179 #. type: textblock
18180 #: ../fish/guestfish.pod:283
18181 msgid ""
18182 "Using this flag is mostly equivalent to using the C<inspect-os> command and "
18183 "then using other commands to mount the filesystems that were found."
18184 msgstr ""
18185
18186 #. type: =item
18187 #: ../fish/guestfish.pod:287 ../fuse/guestmount.pod:141
18188 msgid "B<--keys-from-stdin>"
18189 msgstr ""
18190
18191 #. type: textblock
18192 #: ../fish/guestfish.pod:289 ../fuse/guestmount.pod:143
18193 msgid ""
18194 "Read key or passphrase parameters from stdin.  The default is to try to read "
18195 "passphrases from the user by opening C</dev/tty>."
18196 msgstr ""
18197
18198 #. type: =item
18199 #: ../fish/guestfish.pod:292
18200 msgid "B<--listen>"
18201 msgstr ""
18202
18203 #. type: textblock
18204 #: ../fish/guestfish.pod:294
18205 msgid ""
18206 "Fork into the background and listen for remote commands.  See section "
18207 "L</REMOTE CONTROL GUESTFISH OVER A SOCKET> below."
18208 msgstr ""
18209
18210 #. type: =item
18211 #: ../fish/guestfish.pod:297
18212 msgid "B<-m dev[:mountpoint]>"
18213 msgstr ""
18214
18215 #. type: =item
18216 #: ../fish/guestfish.pod:299
18217 msgid "B<--mount dev[:mountpoint]>"
18218 msgstr ""
18219
18220 #. type: textblock
18221 #: ../fish/guestfish.pod:301
18222 msgid "Mount the named partition or logical volume on the given mountpoint."
18223 msgstr ""
18224
18225 #. type: textblock
18226 #: ../fish/guestfish.pod:303
18227 msgid "If the mountpoint is omitted, it defaults to C</>."
18228 msgstr ""
18229
18230 #. type: textblock
18231 #: ../fish/guestfish.pod:305
18232 msgid "You have to mount something on C</> before most commands will work."
18233 msgstr ""
18234
18235 #. type: textblock
18236 #: ../fish/guestfish.pod:307
18237 msgid ""
18238 "If any I<-m> or I<--mount> options are given, the guest is automatically "
18239 "launched."
18240 msgstr ""
18241
18242 #. type: textblock
18243 #: ../fish/guestfish.pod:310
18244 msgid ""
18245 "If you don't know what filesystems a disk image contains, you can either run "
18246 "guestfish without this option, then list the partitions, filesystems and LVs "
18247 "available (see L</list-partitions>, L</list-filesystems> and L</lvs> "
18248 "commands), or you can use the L<virt-filesystems(1)> program."
18249 msgstr ""
18250
18251 #. type: textblock
18252 #: ../fish/guestfish.pod:316
18253 msgid ""
18254 "Using this flag is mostly equivalent to using the C<mount-options> command "
18255 "or the C<mount-ro> command if the I<--ro> flag was given."
18256 msgstr ""
18257
18258 #. type: =item
18259 #: ../fish/guestfish.pod:319
18260 msgid "B<-n>"
18261 msgstr ""
18262
18263 #. type: =item
18264 #: ../fish/guestfish.pod:321
18265 msgid "B<--no-sync>"
18266 msgstr ""
18267
18268 #. type: textblock
18269 #: ../fish/guestfish.pod:323
18270 msgid ""
18271 "Disable autosync.  This is enabled by default.  See the discussion of "
18272 "autosync in the L<guestfs(3)> manpage."
18273 msgstr ""
18274
18275 #. type: =item
18276 #: ../fish/guestfish.pod:326
18277 msgid "B<-N type>"
18278 msgstr ""
18279
18280 #. type: =item
18281 #: ../fish/guestfish.pod:328
18282 msgid "B<--new type>"
18283 msgstr ""
18284
18285 #. type: =item
18286 #: ../fish/guestfish.pod:330
18287 msgid "B<-N help>"
18288 msgstr ""
18289
18290 #. type: textblock
18291 #: ../fish/guestfish.pod:332
18292 msgid ""
18293 "Prepare a fresh disk image formatted as \"type\".  This is an alternative to "
18294 "the I<-a> option: whereas I<-a> adds an existing disk, I<-N> creates a "
18295 "preformatted disk with a filesystem and adds it.  See L</PREPARED DISK "
18296 "IMAGES> below."
18297 msgstr ""
18298
18299 #. type: =item
18300 #: ../fish/guestfish.pod:337
18301 msgid "B<--progress-bars>"
18302 msgstr ""
18303
18304 #. type: textblock
18305 #: ../fish/guestfish.pod:339
18306 msgid "Enable progress bars, even when guestfish is used non-interactively."
18307 msgstr ""
18308
18309 #. type: textblock
18310 #: ../fish/guestfish.pod:341
18311 msgid ""
18312 "Progress bars are enabled by default when guestfish is used as an "
18313 "interactive shell."
18314 msgstr ""
18315
18316 #. type: =item
18317 #: ../fish/guestfish.pod:344
18318 msgid "B<--no-progress-bars>"
18319 msgstr ""
18320
18321 #. type: textblock
18322 #: ../fish/guestfish.pod:346
18323 msgid "Disable progress bars."
18324 msgstr ""
18325
18326 #. type: =item
18327 #: ../fish/guestfish.pod:348
18328 msgid "B<--remote[=pid]>"
18329 msgstr ""
18330
18331 #. type: textblock
18332 #: ../fish/guestfish.pod:350
18333 msgid ""
18334 "Send remote commands to C<$GUESTFISH_PID> or C<pid>.  See section L</REMOTE "
18335 "CONTROL GUESTFISH OVER A SOCKET> below."
18336 msgstr ""
18337
18338 #. type: =item
18339 #: ../fish/guestfish.pod:353
18340 msgid "B<-r>"
18341 msgstr ""
18342
18343 #. type: =item
18344 #: ../fish/guestfish.pod:355
18345 msgid "B<--ro>"
18346 msgstr ""
18347
18348 #. type: textblock
18349 #: ../fish/guestfish.pod:357
18350 msgid ""
18351 "This changes the I<-a>, I<-d> and I<-m> options so that disks are added and "
18352 "mounts are done read-only."
18353 msgstr ""
18354
18355 #. type: textblock
18356 #: ../fish/guestfish.pod:360
18357 msgid ""
18358 "The option must always be used if the disk image or virtual machine might be "
18359 "running, and is generally recommended in cases where you don't need write "
18360 "access to the disk."
18361 msgstr ""
18362
18363 #. type: textblock
18364 #: ../fish/guestfish.pod:364
18365 msgid ""
18366 "Note that prepared disk images created with I<-N> are not affected by this "
18367 "option.  Also commands like C<add> are not affected - you have to specify "
18368 "the C<readonly:true> option explicitly if you need it."
18369 msgstr ""
18370
18371 #. type: textblock
18372 #: ../fish/guestfish.pod:368
18373 msgid "See also L</OPENING DISKS FOR READ AND WRITE> below."
18374 msgstr ""
18375
18376 #. type: =item
18377 #: ../fish/guestfish.pod:370 ../fuse/guestmount.pod:208
18378 msgid "B<--selinux>"
18379 msgstr ""
18380
18381 #. type: textblock
18382 #: ../fish/guestfish.pod:372
18383 msgid "Enable SELinux support for the guest.  See L<guestfs(3)/SELINUX>."
18384 msgstr ""
18385
18386 #. type: =item
18387 #: ../fish/guestfish.pod:374
18388 msgid "B<-v>"
18389 msgstr ""
18390
18391 #. type: =item
18392 #: ../fish/guestfish.pod:376
18393 msgid "B<--verbose>"
18394 msgstr ""
18395
18396 #. type: textblock
18397 #: ../fish/guestfish.pod:378
18398 msgid ""
18399 "Enable very verbose messages.  This is particularly useful if you find a "
18400 "bug."
18401 msgstr ""
18402
18403 #. type: =item
18404 #: ../fish/guestfish.pod:381
18405 msgid "B<-V>"
18406 msgstr ""
18407
18408 #. type: =item
18409 #: ../fish/guestfish.pod:383 ../tools/virt-edit.pl:93 ../tools/virt-win-reg.pl:112 ../tools/virt-resize.pl:270 ../tools/virt-list-filesystems.pl:69 ../tools/virt-tar.pl:114 ../tools/virt-make-fs.pl:169 ../tools/virt-list-partitions.pl:70
18410 msgid "B<--version>"
18411 msgstr ""
18412
18413 #. type: textblock
18414 #: ../fish/guestfish.pod:385
18415 msgid "Display the guestfish / libguestfs version number and exit."
18416 msgstr ""
18417
18418 #. type: =item
18419 #: ../fish/guestfish.pod:387
18420 msgid "B<-w>"
18421 msgstr ""
18422
18423 #. type: =item
18424 #: ../fish/guestfish.pod:389
18425 msgid "B<--rw>"
18426 msgstr ""
18427
18428 #. type: textblock
18429 #: ../fish/guestfish.pod:391
18430 msgid ""
18431 "This option does nothing at the moment.  See L</OPENING DISKS FOR READ AND "
18432 "WRITE> below."
18433 msgstr ""
18434
18435 #. type: =item
18436 #: ../fish/guestfish.pod:394
18437 msgid "B<-x>"
18438 msgstr ""
18439
18440 #. type: textblock
18441 #: ../fish/guestfish.pod:396
18442 msgid "Echo each command before executing it."
18443 msgstr ""
18444
18445 #. type: =head1
18446 #: ../fish/guestfish.pod:400
18447 msgid "COMMANDS ON COMMAND LINE"
18448 msgstr ""
18449
18450 #. type: textblock
18451 #: ../fish/guestfish.pod:402
18452 msgid "Any additional (non-option) arguments are treated as commands to execute."
18453 msgstr ""
18454
18455 #. type: textblock
18456 #: ../fish/guestfish.pod:405
18457 msgid ""
18458 "Commands to execute should be separated by a colon (C<:>), where the colon "
18459 "is a separate parameter.  Thus:"
18460 msgstr ""
18461
18462 #. type: verbatim
18463 #: ../fish/guestfish.pod:408
18464 #, no-wrap
18465 msgid ""
18466 " guestfish cmd [args...] : cmd [args...] : cmd [args...] ...\n"
18467 "\n"
18468 msgstr ""
18469
18470 #. type: textblock
18471 #: ../fish/guestfish.pod:410
18472 msgid ""
18473 "If there are no additional arguments, then we enter a shell, either an "
18474 "interactive shell with a prompt (if the input is a terminal) or a "
18475 "non-interactive shell."
18476 msgstr ""
18477
18478 #. type: textblock
18479 #: ../fish/guestfish.pod:414
18480 msgid ""
18481 "In either command line mode or non-interactive shell, the first command that "
18482 "gives an error causes the whole shell to exit.  In interactive mode (with a "
18483 "prompt) if a command fails, you can continue to enter commands."
18484 msgstr ""
18485
18486 #. type: =head1
18487 #: ../fish/guestfish.pod:419
18488 msgid "USING launch (OR run)"
18489 msgstr ""
18490
18491 #. type: textblock
18492 #: ../fish/guestfish.pod:421
18493 msgid ""
18494 "As with L<guestfs(3)>, you must first configure your guest by adding disks, "
18495 "then launch it, then mount any disks you need, and finally issue "
18496 "actions/commands.  So the general order of the day is:"
18497 msgstr ""
18498
18499 #. type: textblock
18500 #: ../fish/guestfish.pod:429
18501 msgid "add or -a/--add"
18502 msgstr ""
18503
18504 #. type: textblock
18505 #: ../fish/guestfish.pod:433
18506 msgid "launch (aka run)"
18507 msgstr ""
18508
18509 #. type: textblock
18510 #: ../fish/guestfish.pod:437
18511 msgid "mount or -m/--mount"
18512 msgstr ""
18513
18514 #. type: textblock
18515 #: ../fish/guestfish.pod:441
18516 msgid "any other commands"
18517 msgstr ""
18518
18519 #. type: textblock
18520 #: ../fish/guestfish.pod:445
18521 msgid ""
18522 "C<run> is a synonym for C<launch>.  You must C<launch> (or C<run>)  your "
18523 "guest before mounting or performing any other commands."
18524 msgstr ""
18525
18526 #. type: textblock
18527 #: ../fish/guestfish.pod:448
18528 msgid ""
18529 "The only exception is that if any of the I<-i>, I<-m>, I<--mount>, I<-N> or "
18530 "I<--new> options were given then C<run> is done automatically, simply "
18531 "because guestfish can't perform the action you asked for without doing this."
18532 msgstr ""
18533
18534 #. type: =head1
18535 #: ../fish/guestfish.pod:453
18536 msgid "OPENING DISKS FOR READ AND WRITE"
18537 msgstr ""
18538
18539 #. type: textblock
18540 #: ../fish/guestfish.pod:455
18541 msgid ""
18542 "The guestfish (and L<guestmount(1)>) options I<--ro> and I<--rw> affect "
18543 "whether the other command line options I<-a>, I<-c>, I<-d>, I<-i> and I<-m> "
18544 "open disk images read-only or for writing."
18545 msgstr ""
18546
18547 #. type: textblock
18548 #: ../fish/guestfish.pod:459
18549 msgid ""
18550 "In libguestfs E<lt> 1.6.2, guestfish and guestmount defaulted to opening "
18551 "disk images supplied on the command line for write.  To open a disk image "
18552 "read-only you have to do I<-a image --ro>."
18553 msgstr ""
18554
18555 #. type: textblock
18556 #: ../fish/guestfish.pod:463
18557 msgid ""
18558 "This matters: If you accidentally open a live VM disk image writable then "
18559 "you will cause irreversible disk corruption."
18560 msgstr ""
18561
18562 #. type: textblock
18563 #: ../fish/guestfish.pod:466
18564 msgid ""
18565 "By libguestfs 1.10 we intend to change the default the other way.  Disk "
18566 "images will be opened read-only.  You will have to either specify "
18567 "I<guestfish --rw> or change a configuration file in order to get write "
18568 "access for disk images specified by those other command line options."
18569 msgstr ""
18570
18571 #. type: textblock
18572 #: ../fish/guestfish.pod:471
18573 msgid ""
18574 "This version of guestfish has a I<--rw> option which does nothing (it is "
18575 "already the default).  However it is highly recommended that you use this "
18576 "option to indicate that guestfish needs write access, and to prepare your "
18577 "scripts for the day when this option will be required for write access."
18578 msgstr ""
18579
18580 #. type: textblock
18581 #: ../fish/guestfish.pod:477
18582 msgid ""
18583 "B<Note:> This does I<not> affect commands like L</add> and L</mount>, or any "
18584 "other libguestfs program apart from guestfish and guestmount."
18585 msgstr ""
18586
18587 #. type: =head1
18588 #: ../fish/guestfish.pod:480
18589 msgid "QUOTING"
18590 msgstr ""
18591
18592 #. type: textblock
18593 #: ../fish/guestfish.pod:482
18594 msgid ""
18595 "You can quote ordinary parameters using either single or double quotes.  For "
18596 "example:"
18597 msgstr ""
18598
18599 #. type: verbatim
18600 #: ../fish/guestfish.pod:485
18601 #, no-wrap
18602 msgid ""
18603 " add \"file with a space.img\"\n"
18604 "\n"
18605 msgstr ""
18606
18607 #. type: verbatim
18608 #: ../fish/guestfish.pod:487
18609 #, no-wrap
18610 msgid ""
18611 " rm '/file name'\n"
18612 "\n"
18613 msgstr ""
18614
18615 #. type: verbatim
18616 #: ../fish/guestfish.pod:489
18617 #, no-wrap
18618 msgid ""
18619 " rm '/\"'\n"
18620 "\n"
18621 msgstr ""
18622
18623 #. type: textblock
18624 #: ../fish/guestfish.pod:491
18625 msgid ""
18626 "A few commands require a list of strings to be passed.  For these, use a "
18627 "whitespace-separated list, enclosed in quotes.  Strings containing "
18628 "whitespace to be passed through must be enclosed in single quotes.  A "
18629 "literal single quote must be escaped with a backslash."
18630 msgstr ""
18631
18632 #. type: verbatim
18633 #: ../fish/guestfish.pod:496
18634 #, no-wrap
18635 msgid ""
18636 " vgcreate VG \"/dev/sda1 /dev/sdb1\"\n"
18637 " command \"/bin/echo 'foo      bar'\"\n"
18638 " command \"/bin/echo \\'foo\\'\"\n"
18639 "\n"
18640 msgstr ""
18641
18642 #. type: =head1
18643 #: ../fish/guestfish.pod:500
18644 msgid "OPTIONAL ARGUMENTS"
18645 msgstr ""
18646
18647 #. type: textblock
18648 #: ../fish/guestfish.pod:502
18649 msgid ""
18650 "Some commands take optional arguments.  These arguments appear in this "
18651 "documentation as C<[argname:..]>.  You can use them as in these examples:"
18652 msgstr ""
18653
18654 #. type: verbatim
18655 #: ../fish/guestfish.pod:506
18656 #, no-wrap
18657 msgid ""
18658 " add-drive-opts filename\n"
18659 "\n"
18660 msgstr ""
18661
18662 #. type: verbatim
18663 #: ../fish/guestfish.pod:508
18664 #, no-wrap
18665 msgid ""
18666 " add-drive-opts filename readonly:true\n"
18667 "\n"
18668 msgstr ""
18669
18670 #. type: verbatim
18671 #: ../fish/guestfish.pod:510
18672 #, no-wrap
18673 msgid ""
18674 " add-drive-opts filename format:qcow2 readonly:false\n"
18675 "\n"
18676 msgstr ""
18677
18678 #. type: textblock
18679 #: ../fish/guestfish.pod:512
18680 msgid ""
18681 "Each optional argument can appear at most once.  All optional arguments must "
18682 "appear after the required ones."
18683 msgstr ""
18684
18685 #. type: =head1
18686 #: ../fish/guestfish.pod:515
18687 msgid "NUMBERS"
18688 msgstr ""
18689
18690 #. type: textblock
18691 #: ../fish/guestfish.pod:517
18692 msgid "This section applies to all commands which can take integers as parameters."
18693 msgstr ""
18694
18695 #. type: =head2
18696 #: ../fish/guestfish.pod:520
18697 msgid "SIZE SUFFIX"
18698 msgstr ""
18699
18700 #. type: textblock
18701 #: ../fish/guestfish.pod:522
18702 msgid ""
18703 "When the command takes a parameter measured in bytes, you can use one of the "
18704 "following suffixes to specify kilobytes, megabytes and larger sizes:"
18705 msgstr ""
18706
18707 #. type: =item
18708 #: ../fish/guestfish.pod:528
18709 msgid "B<k> or B<K> or B<KiB>"
18710 msgstr ""
18711
18712 #. type: textblock
18713 #: ../fish/guestfish.pod:530
18714 msgid "The size in kilobytes (multiplied by 1024)."
18715 msgstr ""
18716
18717 #. type: =item
18718 #: ../fish/guestfish.pod:532
18719 msgid "B<KB>"
18720 msgstr ""
18721
18722 #. type: textblock
18723 #: ../fish/guestfish.pod:534
18724 msgid "The size in SI 1000 byte units."
18725 msgstr ""
18726
18727 #. type: =item
18728 #: ../fish/guestfish.pod:536
18729 msgid "B<M> or B<MiB>"
18730 msgstr ""
18731
18732 #. type: textblock
18733 #: ../fish/guestfish.pod:538
18734 msgid "The size in megabytes (multiplied by 1048576)."
18735 msgstr ""
18736
18737 #. type: =item
18738 #: ../fish/guestfish.pod:540
18739 msgid "B<MB>"
18740 msgstr ""
18741
18742 #. type: textblock
18743 #: ../fish/guestfish.pod:542
18744 msgid "The size in SI 1000000 byte units."
18745 msgstr ""
18746
18747 #. type: =item
18748 #: ../fish/guestfish.pod:544
18749 msgid "B<G> or B<GiB>"
18750 msgstr ""
18751
18752 #. type: textblock
18753 #: ../fish/guestfish.pod:546
18754 msgid "The size in gigabytes (multiplied by 2**30)."
18755 msgstr ""
18756
18757 #. type: =item
18758 #: ../fish/guestfish.pod:548
18759 msgid "B<GB>"
18760 msgstr ""
18761
18762 #. type: textblock
18763 #: ../fish/guestfish.pod:550
18764 msgid "The size in SI 10**9 byte units."
18765 msgstr ""
18766
18767 #. type: =item
18768 #: ../fish/guestfish.pod:552
18769 msgid "B<T> or B<TiB>"
18770 msgstr ""
18771
18772 #. type: textblock
18773 #: ../fish/guestfish.pod:554
18774 msgid "The size in terabytes (multiplied by 2**40)."
18775 msgstr ""
18776
18777 #. type: =item
18778 #: ../fish/guestfish.pod:556
18779 msgid "B<TB>"
18780 msgstr ""
18781
18782 #. type: textblock
18783 #: ../fish/guestfish.pod:558
18784 msgid "The size in SI 10**12 byte units."
18785 msgstr ""
18786
18787 #. type: =item
18788 #: ../fish/guestfish.pod:560
18789 msgid "B<P> or B<PiB>"
18790 msgstr ""
18791
18792 #. type: textblock
18793 #: ../fish/guestfish.pod:562
18794 msgid "The size in petabytes (multiplied by 2**50)."
18795 msgstr ""
18796
18797 #. type: =item
18798 #: ../fish/guestfish.pod:564
18799 msgid "B<PB>"
18800 msgstr ""
18801
18802 #. type: textblock
18803 #: ../fish/guestfish.pod:566
18804 msgid "The size in SI 10**15 byte units."
18805 msgstr ""
18806
18807 #. type: =item
18808 #: ../fish/guestfish.pod:568
18809 msgid "B<E> or B<EiB>"
18810 msgstr ""
18811
18812 #. type: textblock
18813 #: ../fish/guestfish.pod:570
18814 msgid "The size in exabytes (multiplied by 2**60)."
18815 msgstr ""
18816
18817 #. type: =item
18818 #: ../fish/guestfish.pod:572
18819 msgid "B<EB>"
18820 msgstr ""
18821
18822 #. type: textblock
18823 #: ../fish/guestfish.pod:574
18824 msgid "The size in SI 10**18 byte units."
18825 msgstr ""
18826
18827 #. type: =item
18828 #: ../fish/guestfish.pod:576
18829 msgid "B<Z> or B<ZiB>"
18830 msgstr ""
18831
18832 #. type: textblock
18833 #: ../fish/guestfish.pod:578
18834 msgid "The size in zettabytes (multiplied by 2**70)."
18835 msgstr ""
18836
18837 #. type: =item
18838 #: ../fish/guestfish.pod:580
18839 msgid "B<ZB>"
18840 msgstr ""
18841
18842 #. type: textblock
18843 #: ../fish/guestfish.pod:582
18844 msgid "The size in SI 10**21 byte units."
18845 msgstr ""
18846
18847 #. type: =item
18848 #: ../fish/guestfish.pod:584
18849 msgid "B<Y> or B<YiB>"
18850 msgstr ""
18851
18852 #. type: textblock
18853 #: ../fish/guestfish.pod:586
18854 msgid "The size in yottabytes (multiplied by 2**80)."
18855 msgstr ""
18856
18857 #. type: =item
18858 #: ../fish/guestfish.pod:588
18859 msgid "B<YB>"
18860 msgstr ""
18861
18862 #. type: textblock
18863 #: ../fish/guestfish.pod:590
18864 msgid "The size in SI 10**24 byte units."
18865 msgstr ""
18866
18867 #. type: verbatim
18868 #: ../fish/guestfish.pod:596
18869 #, no-wrap
18870 msgid ""
18871 " truncate-size /file 1G\n"
18872 "\n"
18873 msgstr ""
18874
18875 #. type: textblock
18876 #: ../fish/guestfish.pod:598
18877 msgid "would truncate the file to 1 gigabyte."
18878 msgstr ""
18879
18880 #. type: textblock
18881 #: ../fish/guestfish.pod:600
18882 msgid ""
18883 "Be careful because a few commands take sizes in kilobytes or megabytes "
18884 "(eg. the parameter to L</memsize> is specified in megabytes already).  "
18885 "Adding a suffix will probably not do what you expect."
18886 msgstr ""
18887
18888 #. type: =head2
18889 #: ../fish/guestfish.pod:604
18890 msgid "OCTAL AND HEXADECIMAL NUMBERS"
18891 msgstr ""
18892
18893 #. type: textblock
18894 #: ../fish/guestfish.pod:606
18895 msgid ""
18896 "For specifying the radix (base) use the C convention: C<0> to prefix an "
18897 "octal number or C<0x> to prefix a hexadecimal number.  For example:"
18898 msgstr ""
18899
18900 #. type: verbatim
18901 #: ../fish/guestfish.pod:609
18902 #, no-wrap
18903 msgid ""
18904 " 1234      decimal number 1234\n"
18905 " 02322     octal number, equivalent to decimal 1234\n"
18906 " 0x4d2     hexadecimal number, equivalent to decimal 1234\n"
18907 "\n"
18908 msgstr ""
18909
18910 #. type: textblock
18911 #: ../fish/guestfish.pod:613
18912 msgid ""
18913 "When using the C<chmod> command, you almost always want to specify an octal "
18914 "number for the mode, and you must prefix it with C<0> (unlike the Unix "
18915 "L<chmod(1)> program):"
18916 msgstr ""
18917
18918 #. type: verbatim
18919 #: ../fish/guestfish.pod:617
18920 #, no-wrap
18921 msgid ""
18922 " chmod 0777 /public  # OK\n"
18923 " chmod 777 /public   # WRONG! This is mode 777 decimal = 01411 octal.\n"
18924 "\n"
18925 msgstr ""
18926
18927 #. type: textblock
18928 #: ../fish/guestfish.pod:620
18929 msgid ""
18930 "Commands that return numbers usually print them in decimal, but some "
18931 "commands print numbers in other radices (eg. C<umask> prints the mode in "
18932 "octal, preceeded by C<0>)."
18933 msgstr ""
18934
18935 #. type: =head1
18936 #: ../fish/guestfish.pod:624
18937 msgid "WILDCARDS AND GLOBBING"
18938 msgstr ""
18939
18940 #. type: textblock
18941 #: ../fish/guestfish.pod:626
18942 msgid ""
18943 "Neither guestfish nor the underlying guestfs API performs wildcard expansion "
18944 "(globbing) by default.  So for example the following will not do what you "
18945 "expect:"
18946 msgstr ""
18947
18948 #. type: verbatim
18949 #: ../fish/guestfish.pod:630
18950 #, no-wrap
18951 msgid ""
18952 " rm-rf /home/*\n"
18953 "\n"
18954 msgstr ""
18955
18956 #. type: textblock
18957 #: ../fish/guestfish.pod:632
18958 msgid ""
18959 "Assuming you don't have a directory called literally C</home/*> then the "
18960 "above command will return an error."
18961 msgstr ""
18962
18963 #. type: textblock
18964 #: ../fish/guestfish.pod:635
18965 msgid "To perform wildcard expansion, use the C<glob> command."
18966 msgstr ""
18967
18968 #. type: verbatim
18969 #: ../fish/guestfish.pod:637
18970 #, no-wrap
18971 msgid ""
18972 " glob rm-rf /home/*\n"
18973 "\n"
18974 msgstr ""
18975
18976 #. type: textblock
18977 #: ../fish/guestfish.pod:639
18978 msgid ""
18979 "runs C<rm-rf> on each path that matches (ie. potentially running the command "
18980 "many times), equivalent to:"
18981 msgstr ""
18982
18983 #. type: verbatim
18984 #: ../fish/guestfish.pod:642
18985 #, no-wrap
18986 msgid ""
18987 " rm-rf /home/jim\n"
18988 " rm-rf /home/joe\n"
18989 " rm-rf /home/mary\n"
18990 "\n"
18991 msgstr ""
18992
18993 #. type: textblock
18994 #: ../fish/guestfish.pod:646
18995 msgid "C<glob> only works on simple guest paths and not on device names."
18996 msgstr ""
18997
18998 #. type: textblock
18999 #: ../fish/guestfish.pod:648
19000 msgid ""
19001 "If you have several parameters, each containing a wildcard, then glob will "
19002 "perform a Cartesian product."
19003 msgstr ""
19004
19005 #. type: =head1
19006 #: ../fish/guestfish.pod:651
19007 msgid "COMMENTS"
19008 msgstr ""
19009
19010 #. type: textblock
19011 #: ../fish/guestfish.pod:653
19012 msgid ""
19013 "Any line which starts with a I<#> character is treated as a comment and "
19014 "ignored.  The I<#> can optionally be preceeded by whitespace, but B<not> by "
19015 "a command.  For example:"
19016 msgstr ""
19017
19018 #. type: verbatim
19019 #: ../fish/guestfish.pod:657
19020 #, no-wrap
19021 msgid ""
19022 " # this is a comment\n"
19023 "         # this is a comment\n"
19024 " foo # NOT a comment\n"
19025 "\n"
19026 msgstr ""
19027
19028 #. type: textblock
19029 #: ../fish/guestfish.pod:661
19030 msgid "Blank lines are also ignored."
19031 msgstr ""
19032
19033 #. type: =head1
19034 #: ../fish/guestfish.pod:663
19035 msgid "RUNNING COMMANDS LOCALLY"
19036 msgstr ""
19037
19038 #. type: textblock
19039 #: ../fish/guestfish.pod:665
19040 msgid ""
19041 "Any line which starts with a I<!> character is treated as a command sent to "
19042 "the local shell (C</bin/sh> or whatever L<system(3)> uses).  For example:"
19043 msgstr ""
19044
19045 #. type: verbatim
19046 #: ../fish/guestfish.pod:669
19047 #, no-wrap
19048 msgid ""
19049 " !mkdir local\n"
19050 " tgz-out /remote local/remote-data.tar.gz\n"
19051 "\n"
19052 msgstr ""
19053
19054 #. type: textblock
19055 #: ../fish/guestfish.pod:672
19056 msgid ""
19057 "will create a directory C<local> on the host, and then export the contents "
19058 "of C</remote> on the mounted filesystem to C<local/remote-data.tar.gz>.  "
19059 "(See C<tgz-out>)."
19060 msgstr ""
19061
19062 #. type: textblock
19063 #: ../fish/guestfish.pod:676
19064 msgid ""
19065 "To change the local directory, use the C<lcd> command.  C<!cd> will have no "
19066 "effect, due to the way that subprocesses work in Unix."
19067 msgstr ""
19068
19069 #. type: =head1
19070 #: ../fish/guestfish.pod:679
19071 msgid "PIPES"
19072 msgstr ""
19073
19074 #. type: textblock
19075 #: ../fish/guestfish.pod:681
19076 msgid ""
19077 "Use C<command E<lt>spaceE<gt> | command> to pipe the output of the first "
19078 "command (a guestfish command) to the second command (any host command).  For "
19079 "example:"
19080 msgstr ""
19081
19082 #. type: verbatim
19083 #: ../fish/guestfish.pod:685
19084 #, no-wrap
19085 msgid ""
19086 " cat /etc/passwd | awk -F: '$3 == 0 { print }'\n"
19087 "\n"
19088 msgstr ""
19089
19090 #. type: textblock
19091 #: ../fish/guestfish.pod:687
19092 msgid ""
19093 "(where C<cat> is the guestfish cat command, but C<awk> is the host awk "
19094 "program).  The above command would list all accounts in the guest filesystem "
19095 "which have UID 0, ie. root accounts including backdoors.  Other examples:"
19096 msgstr ""
19097
19098 #. type: verbatim
19099 #: ../fish/guestfish.pod:692
19100 #, no-wrap
19101 msgid ""
19102 " hexdump /bin/ls | head\n"
19103 " list-devices | tail -1\n"
19104 " tgz-out / - | tar ztf -\n"
19105 "\n"
19106 msgstr ""
19107
19108 #. type: textblock
19109 #: ../fish/guestfish.pod:696
19110 msgid ""
19111 "The space before the pipe symbol is required, any space after the pipe "
19112 "symbol is optional.  Everything after the pipe symbol is just passed "
19113 "straight to the host shell, so it can contain redirections, globs and "
19114 "anything else that makes sense on the host side."
19115 msgstr ""
19116
19117 #. type: textblock
19118 #: ../fish/guestfish.pod:701
19119 msgid ""
19120 "To use a literal argument which begins with a pipe symbol, you have to quote "
19121 "it, eg:"
19122 msgstr ""
19123
19124 #. type: verbatim
19125 #: ../fish/guestfish.pod:704
19126 #, no-wrap
19127 msgid ""
19128 " echo \"|\"\n"
19129 "\n"
19130 msgstr ""
19131
19132 #. type: =head1
19133 #: ../fish/guestfish.pod:706
19134 msgid "HOME DIRECTORIES"
19135 msgstr ""
19136
19137 #. type: textblock
19138 #: ../fish/guestfish.pod:708
19139 msgid ""
19140 "If a parameter starts with the character C<~> then the tilde may be expanded "
19141 "as a home directory path (either C<~> for the current user's home directory, "
19142 "or C<~user> for another user)."
19143 msgstr ""
19144
19145 #. type: textblock
19146 #: ../fish/guestfish.pod:712
19147 msgid ""
19148 "Note that home directory expansion happens for users known I<on the host>, "
19149 "not in the guest filesystem."
19150 msgstr ""
19151
19152 #. type: textblock
19153 #: ../fish/guestfish.pod:715
19154 msgid ""
19155 "To use a literal argument which begins with a tilde, you have to quote it, "
19156 "eg:"
19157 msgstr ""
19158
19159 #. type: verbatim
19160 #: ../fish/guestfish.pod:718
19161 #, no-wrap
19162 msgid ""
19163 " echo \"~\"\n"
19164 "\n"
19165 msgstr ""
19166
19167 #. type: textblock
19168 #: ../fish/guestfish.pod:722
19169 msgid ""
19170 "Libguestfs has some support for Linux guests encrypted according to the "
19171 "Linux Unified Key Setup (LUKS) standard, which includes nearly all whole "
19172 "disk encryption systems used by modern Linux guests.  Currently only "
19173 "LVM-on-LUKS is supported."
19174 msgstr ""
19175
19176 #. type: textblock
19177 #: ../fish/guestfish.pod:727
19178 msgid "Identify encrypted block devices and partitions using L</vfs-type>:"
19179 msgstr ""
19180
19181 #. type: verbatim
19182 #: ../fish/guestfish.pod:729
19183 #, no-wrap
19184 msgid ""
19185 " ><fs> vfs-type /dev/sda2\n"
19186 " crypto_LUKS\n"
19187 "\n"
19188 msgstr ""
19189
19190 #. type: textblock
19191 #: ../fish/guestfish.pod:732
19192 msgid ""
19193 "Then open those devices using L</luks-open>.  This creates a device-mapper "
19194 "device called C</dev/mapper/luksdev>."
19195 msgstr ""
19196
19197 #. type: verbatim
19198 #: ../fish/guestfish.pod:735
19199 #, no-wrap
19200 msgid ""
19201 " ><fs> luks-open /dev/sda2 luksdev\n"
19202 " Enter key or passphrase (\"key\"): <enter the passphrase>\n"
19203 "\n"
19204 msgstr ""
19205
19206 #. type: textblock
19207 #: ../fish/guestfish.pod:738
19208 msgid ""
19209 "Finally you have to tell LVM to scan for volume groups on the newly created "
19210 "mapper device:"
19211 msgstr ""
19212
19213 #. type: verbatim
19214 #: ../fish/guestfish.pod:741
19215 #, no-wrap
19216 msgid ""
19217 " vgscan\n"
19218 " vg-activate-all true\n"
19219 "\n"
19220 msgstr ""
19221
19222 #. type: textblock
19223 #: ../fish/guestfish.pod:744
19224 msgid "The logical volume(s) can now be mounted in the usual way."
19225 msgstr ""
19226
19227 #. type: textblock
19228 #: ../fish/guestfish.pod:746
19229 msgid ""
19230 "Before closing a LUKS device you must unmount any logical volumes on it and "
19231 "deactivate the volume groups by calling C<vg-activate false VG> on each "
19232 "one.  Then you can close the mapper device:"
19233 msgstr ""
19234
19235 #. type: verbatim
19236 #: ../fish/guestfish.pod:750
19237 #, no-wrap
19238 msgid ""
19239 " vg-activate false /dev/VG\n"
19240 " luks-close /dev/mapper/luksdev\n"
19241 "\n"
19242 msgstr ""
19243
19244 #. type: =head1
19245 #: ../fish/guestfish.pod:753
19246 msgid "WINDOWS PATHS"
19247 msgstr ""
19248
19249 #. type: textblock
19250 #: ../fish/guestfish.pod:755
19251 msgid ""
19252 "If a path is prefixed with C<win:> then you can use Windows-style paths "
19253 "(with some limitations).  The following commands are equivalent:"
19254 msgstr ""
19255
19256 #. type: verbatim
19257 #: ../fish/guestfish.pod:758
19258 #, no-wrap
19259 msgid ""
19260 " file /WINDOWS/system32/config/system.LOG\n"
19261 "\n"
19262 msgstr ""
19263
19264 #. type: verbatim
19265 #: ../fish/guestfish.pod:760
19266 #, no-wrap
19267 msgid ""
19268 " file win:/windows/system32/config/system.log\n"
19269 "\n"
19270 msgstr ""
19271
19272 #. type: verbatim
19273 #: ../fish/guestfish.pod:762
19274 #, no-wrap
19275 msgid ""
19276 " file win:\\windows\\system32\\config\\system.log\n"
19277 "\n"
19278 msgstr ""
19279
19280 #. type: verbatim
19281 #: ../fish/guestfish.pod:764
19282 #, no-wrap
19283 msgid ""
19284 " file WIN:C:\\Windows\\SYSTEM32\\conFIG\\SYSTEM.LOG\n"
19285 "\n"
19286 msgstr ""
19287
19288 #. type: textblock
19289 #: ../fish/guestfish.pod:766
19290 msgid ""
19291 "This syntax implicitly calls C<case-sensitive-path> (q.v.) so it also "
19292 "handles case insensitivity like Windows would.  This only works in argument "
19293 "positions that expect a path."
19294 msgstr ""
19295
19296 #. type: =head1
19297 #: ../fish/guestfish.pod:770
19298 msgid "UPLOADING AND DOWNLOADING FILES"
19299 msgstr ""
19300
19301 #. type: textblock
19302 #: ../fish/guestfish.pod:772
19303 msgid ""
19304 "For commands such as C<upload>, C<download>, C<tar-in>, C<tar-out> and "
19305 "others which upload from or download to a local file, you can use the "
19306 "special filename C<-> to mean \"from stdin\" or \"to stdout\".  For example:"
19307 msgstr ""
19308
19309 #. type: verbatim
19310 #: ../fish/guestfish.pod:776
19311 #, no-wrap
19312 msgid ""
19313 " upload - /foo\n"
19314 "\n"
19315 msgstr ""
19316
19317 #. type: textblock
19318 #: ../fish/guestfish.pod:778
19319 msgid "reads stdin and creates from that a file C</foo> in the disk image, and:"
19320 msgstr ""
19321
19322 #. type: verbatim
19323 #: ../fish/guestfish.pod:781
19324 #, no-wrap
19325 msgid ""
19326 " tar-out /etc - | tar tf -\n"
19327 "\n"
19328 msgstr ""
19329
19330 #. type: textblock
19331 #: ../fish/guestfish.pod:783
19332 msgid ""
19333 "writes the tarball to stdout and then pipes that into the external \"tar\" "
19334 "command (see L</PIPES>)."
19335 msgstr ""
19336
19337 #. type: textblock
19338 #: ../fish/guestfish.pod:786
19339 msgid ""
19340 "When using C<-> to read from stdin, the input is read up to the end of "
19341 "stdin.  You can also use a special \"heredoc\"-like syntax to read up to "
19342 "some arbitrary end marker:"
19343 msgstr ""
19344
19345 #. type: verbatim
19346 #: ../fish/guestfish.pod:790
19347 #, no-wrap
19348 msgid ""
19349 " upload -<<END /foo\n"
19350 " input line 1\n"
19351 " input line 2\n"
19352 " input line 3\n"
19353 " END\n"
19354 "\n"
19355 msgstr ""
19356
19357 #. type: textblock
19358 #: ../fish/guestfish.pod:796
19359 msgid ""
19360 "Any string of characters can be used instead of C<END>.  The end marker must "
19361 "appear on a line of its own, without any preceeding or following characters "
19362 "(not even spaces)."
19363 msgstr ""
19364
19365 #. type: textblock
19366 #: ../fish/guestfish.pod:800
19367 msgid ""
19368 "Note that the C<-E<lt>E<lt>> syntax only applies to parameters used to "
19369 "upload local files (so-called \"FileIn\" parameters in the generator)."
19370 msgstr ""
19371
19372 #. type: =head1
19373 #: ../fish/guestfish.pod:803
19374 msgid "EXIT ON ERROR BEHAVIOUR"
19375 msgstr ""
19376
19377 #. type: textblock
19378 #: ../fish/guestfish.pod:805
19379 msgid ""
19380 "By default, guestfish will ignore any errors when in interactive mode "
19381 "(ie. taking commands from a human over a tty), and will exit on the first "
19382 "error in non-interactive mode (scripts, commands given on the command line)."
19383 msgstr ""
19384
19385 #. type: textblock
19386 #: ../fish/guestfish.pod:810
19387 msgid ""
19388 "If you prefix a command with a I<-> character, then that command will not "
19389 "cause guestfish to exit, even if that (one) command returns an error."
19390 msgstr ""
19391
19392 #. type: =head1
19393 #: ../fish/guestfish.pod:814
19394 msgid "REMOTE CONTROL GUESTFISH OVER A SOCKET"
19395 msgstr ""
19396
19397 #. type: textblock
19398 #: ../fish/guestfish.pod:816
19399 msgid ""
19400 "Guestfish can be remote-controlled over a socket.  This is useful "
19401 "particularly in shell scripts where you want to make several different "
19402 "changes to a filesystem, but you don't want the overhead of starting up a "
19403 "guestfish process each time."
19404 msgstr ""
19405
19406 #. type: textblock
19407 #: ../fish/guestfish.pod:821
19408 msgid "Start a guestfish server process using:"
19409 msgstr ""
19410
19411 #. type: verbatim
19412 #: ../fish/guestfish.pod:823
19413 #, no-wrap
19414 msgid ""
19415 " eval \"`guestfish --listen`\"\n"
19416 "\n"
19417 msgstr ""
19418
19419 #. type: textblock
19420 #: ../fish/guestfish.pod:825
19421 msgid "and then send it commands by doing:"
19422 msgstr ""
19423
19424 #. type: verbatim
19425 #: ../fish/guestfish.pod:827
19426 #, no-wrap
19427 msgid ""
19428 " guestfish --remote cmd [...]\n"
19429 "\n"
19430 msgstr ""
19431
19432 #. type: textblock
19433 #: ../fish/guestfish.pod:829
19434 msgid "To cause the server to exit, send it the exit command:"
19435 msgstr ""
19436
19437 #. type: verbatim
19438 #: ../fish/guestfish.pod:831
19439 #, no-wrap
19440 msgid ""
19441 " guestfish --remote exit\n"
19442 "\n"
19443 msgstr ""
19444
19445 #. type: textblock
19446 #: ../fish/guestfish.pod:833
19447 msgid ""
19448 "Note that the server will normally exit if there is an error in a command.  "
19449 "You can change this in the usual way.  See section L</EXIT ON ERROR "
19450 "BEHAVIOUR>."
19451 msgstr ""
19452
19453 #. type: =head2
19454 #: ../fish/guestfish.pod:837
19455 msgid "CONTROLLING MULTIPLE GUESTFISH PROCESSES"
19456 msgstr ""
19457
19458 #. type: textblock
19459 #: ../fish/guestfish.pod:839
19460 msgid ""
19461 "The C<eval> statement sets the environment variable C<$GUESTFISH_PID>, which "
19462 "is how the I<--remote> option knows where to send the commands.  You can "
19463 "have several guestfish listener processes running using:"
19464 msgstr ""
19465
19466 #. type: verbatim
19467 #: ../fish/guestfish.pod:843
19468 #, no-wrap
19469 msgid ""
19470 " eval \"`guestfish --listen`\"\n"
19471 " pid1=$GUESTFISH_PID\n"
19472 " eval \"`guestfish --listen`\"\n"
19473 " pid2=$GUESTFISH_PID\n"
19474 " ...\n"
19475 " guestfish --remote=$pid1 cmd\n"
19476 " guestfish --remote=$pid2 cmd\n"
19477 "\n"
19478 msgstr ""
19479
19480 #. type: =head2
19481 #: ../fish/guestfish.pod:851
19482 msgid "REMOTE CONTROL AND CSH"
19483 msgstr ""
19484
19485 #. type: textblock
19486 #: ../fish/guestfish.pod:853
19487 msgid ""
19488 "When using csh-like shells (csh, tcsh etc) you have to add the I<--csh> "
19489 "option:"
19490 msgstr ""
19491
19492 #. type: verbatim
19493 #: ../fish/guestfish.pod:856
19494 #, no-wrap
19495 msgid ""
19496 " eval \"`guestfish --listen --csh`\"\n"
19497 "\n"
19498 msgstr ""
19499
19500 #. type: =head2
19501 #: ../fish/guestfish.pod:858
19502 msgid "REMOTE CONTROL DETAILS"
19503 msgstr ""
19504
19505 #. type: textblock
19506 #: ../fish/guestfish.pod:860
19507 msgid ""
19508 "Remote control happens over a Unix domain socket called "
19509 "C</tmp/.guestfish-$UID/socket-$PID>, where C<$UID> is the effective user ID "
19510 "of the process, and C<$PID> is the process ID of the server."
19511 msgstr ""
19512
19513 #. type: textblock
19514 #: ../fish/guestfish.pod:864
19515 msgid "Guestfish client and server versions must match exactly."
19516 msgstr ""
19517
19518 #. type: =head2
19519 #: ../fish/guestfish.pod:866
19520 msgid "REMOTE CONTROL RUN COMMAND HANGING"
19521 msgstr ""
19522
19523 #. type: textblock
19524 #: ../fish/guestfish.pod:868
19525 msgid ""
19526 "Using the C<run> (or C<launch>) command remotely in a command substitution "
19527 "context hangs, ie. don't do (note the backquotes):"
19528 msgstr ""
19529
19530 #. type: verbatim
19531 #: ../fish/guestfish.pod:871
19532 #, no-wrap
19533 msgid ""
19534 " a=`guestfish --remote run`\n"
19535 "\n"
19536 msgstr ""
19537
19538 #. type: textblock
19539 #: ../fish/guestfish.pod:873
19540 msgid ""
19541 "Since the C<run> command produces no output on stdout, this is not useful "
19542 "anyway.  For further information see "
19543 "L<https://bugzilla.redhat.com/show_bug.cgi?id=592910>."
19544 msgstr ""
19545
19546 #. type: =head1
19547 #: ../fish/guestfish.pod:877
19548 msgid "PREPARED DISK IMAGES"
19549 msgstr ""
19550
19551 #. type: textblock
19552 #: ../fish/guestfish.pod:879
19553 msgid ""
19554 "Use the I<-N type> or I<--new type> parameter to select one of a set of "
19555 "preformatted disk images that guestfish can make for you to save typing.  "
19556 "This is particularly useful for testing purposes.  This option is used "
19557 "instead of the I<-a> option, and like I<-a> can appear multiple times (and "
19558 "can be mixed with I<-a>)."
19559 msgstr ""
19560
19561 #. type: textblock
19562 #: ../fish/guestfish.pod:885
19563 msgid ""
19564 "The new disk is called C<test1.img> for the first I<-N>, C<test2.img> for "
19565 "the second and so on.  Existing files in the current directory are "
19566 "I<overwritten>."
19567 msgstr ""
19568
19569 #. type: textblock
19570 #: ../fish/guestfish.pod:889
19571 msgid ""
19572 "The type briefly describes how the disk should be sized, partitioned, how "
19573 "filesystem(s) should be created, and how content should be added.  "
19574 "Optionally the type can be followed by extra parameters, separated by C<:> "
19575 "(colon) characters.  For example, I<-N fs> creates a default 100MB, "
19576 "sparsely-allocated disk, containing a single partition, with the partition "
19577 "formatted as ext2.  I<-N fs:ext4:1G> is the same, but for an ext4 filesystem "
19578 "on a 1GB disk instead."
19579 msgstr ""
19580
19581 #. type: textblock
19582 #: ../fish/guestfish.pod:897
19583 msgid "To list the available types and any extra parameters they take, run:"
19584 msgstr ""
19585
19586 #. type: textblock
19587 #: ../fish/guestfish.pod:901
19588 msgid ""
19589 "Note that the prepared filesystem is not mounted.  You would usually have to "
19590 "use the C<mount /dev/sda1 /> command or add the I<-m /dev/sda1> option."
19591 msgstr ""
19592
19593 #. type: textblock
19594 #: ../fish/guestfish.pod:905
19595 msgid ""
19596 "If any I<-N> or I<--new> options are given, the guest is automatically "
19597 "launched."
19598 msgstr ""
19599
19600 #. type: textblock
19601 #: ../fish/guestfish.pod:910
19602 msgid "Create a 100MB disk with an ext4-formatted partition:"
19603 msgstr ""
19604
19605 #. type: verbatim
19606 #: ../fish/guestfish.pod:912
19607 #, no-wrap
19608 msgid ""
19609 " guestfish -N fs:ext4\n"
19610 "\n"
19611 msgstr ""
19612
19613 #. type: textblock
19614 #: ../fish/guestfish.pod:914
19615 msgid "Create a 32MB disk with a VFAT-formatted partition, and mount it:"
19616 msgstr ""
19617
19618 #. type: verbatim
19619 #: ../fish/guestfish.pod:916
19620 #, no-wrap
19621 msgid ""
19622 " guestfish -N fs:vfat:32M -m /dev/sda1\n"
19623 "\n"
19624 msgstr ""
19625
19626 #. type: textblock
19627 #: ../fish/guestfish.pod:918
19628 msgid "Create a blank 200MB disk:"
19629 msgstr ""
19630
19631 #. type: verbatim
19632 #: ../fish/guestfish.pod:920
19633 #, no-wrap
19634 msgid ""
19635 " guestfish -N disk:200M\n"
19636 "\n"
19637 msgstr ""
19638
19639 #. type: =head1
19640 #: ../fish/guestfish.pod:922
19641 msgid "PROGRESS BARS"
19642 msgstr ""
19643
19644 #. type: textblock
19645 #: ../fish/guestfish.pod:924
19646 msgid ""
19647 "Some (not all) long-running commands send progress notification messages as "
19648 "they are running.  Guestfish turns these messages into progress bars."
19649 msgstr ""
19650
19651 #. type: textblock
19652 #: ../fish/guestfish.pod:928
19653 msgid ""
19654 "When a command that supports progress bars takes longer than two seconds to "
19655 "run, and if progress bars are enabled, then you will see one appearing below "
19656 "the command:"
19657 msgstr ""
19658
19659 #. type: verbatim
19660 #: ../fish/guestfish.pod:932
19661 #, no-wrap
19662 msgid ""
19663 " ><fs> copy-size /large-file /another-file 2048M\n"
19664 " / 10% [#####-----------------------------------------] 00:30\n"
19665 "\n"
19666 msgstr ""
19667
19668 #. type: textblock
19669 #: ../fish/guestfish.pod:935
19670 msgid ""
19671 "The spinner on the left hand side moves round once for every progress "
19672 "notification received from the backend.  This is a (reasonably) golden "
19673 "assurance that the command is \"doing something\" even if the progress bar "
19674 "is not moving, because the command is able to send the progress "
19675 "notifications.  When the bar reaches 100% and the command finishes, the "
19676 "spinner disappears."
19677 msgstr ""
19678
19679 #. type: textblock
19680 #: ../fish/guestfish.pod:942
19681 msgid ""
19682 "Progress bars are enabled by default when guestfish is used interactively.  "
19683 "You can enable them even for non-interactive modes using I<--progress-bars>, "
19684 "and you can disable them completely using I<--no-progress-bars>."
19685 msgstr ""
19686
19687 #. type: =head1
19688 #: ../fish/guestfish.pod:947
19689 msgid "GUESTFISH COMMANDS"
19690 msgstr ""
19691
19692 #. type: textblock
19693 #: ../fish/guestfish.pod:949
19694 msgid ""
19695 "The commands in this section are guestfish convenience commands, in other "
19696 "words, they are not part of the L<guestfs(3)> API."
19697 msgstr ""
19698
19699 #. type: =head2
19700 #: ../fish/guestfish.pod:952
19701 msgid "help"
19702 msgstr ""
19703
19704 #. type: verbatim
19705 #: ../fish/guestfish.pod:954
19706 #, no-wrap
19707 msgid ""
19708 " help\n"
19709 " help cmd\n"
19710 "\n"
19711 msgstr ""
19712
19713 #. type: textblock
19714 #: ../fish/guestfish.pod:957
19715 msgid "Without any parameter, this provides general help."
19716 msgstr ""
19717
19718 #. type: textblock
19719 #: ../fish/guestfish.pod:959
19720 msgid "With a C<cmd> parameter, this displays detailed help for that command."
19721 msgstr ""
19722
19723 #. type: =head2
19724 #: ../fish/guestfish.pod:961
19725 msgid "quit | exit"
19726 msgstr ""
19727
19728 #. type: textblock
19729 #: ../fish/guestfish.pod:963
19730 msgid "This exits guestfish.  You can also use C<^D> key."
19731 msgstr ""
19732
19733 #. type: textblock
19734 #: ../fish/guestfish.pod:965
19735 msgid "@FISH_COMMANDS@"
19736 msgstr ""
19737
19738 #. type: =head1
19739 #: ../fish/guestfish.pod:967
19740 msgid "COMMANDS"
19741 msgstr ""
19742
19743 #. type: =head1
19744 #: ../fish/guestfish.pod:971 ../test-tool/libguestfs-test-tool.pod:83
19745 msgid "EXIT CODE"
19746 msgstr ""
19747
19748 #. type: textblock
19749 #: ../fish/guestfish.pod:973
19750 msgid ""
19751 "guestfish returns 0 if the commands completed without error, or 1 if there "
19752 "was an error."
19753 msgstr ""
19754
19755 #. type: =item
19756 #: ../fish/guestfish.pod:980
19757 msgid "EDITOR"
19758 msgstr ""
19759
19760 #. type: textblock
19761 #: ../fish/guestfish.pod:982
19762 msgid ""
19763 "The C<edit> command uses C<$EDITOR> as the editor.  If not set, it uses "
19764 "C<vi>."
19765 msgstr ""
19766
19767 #. type: =item
19768 #: ../fish/guestfish.pod:985
19769 msgid "GUESTFISH_PID"
19770 msgstr ""
19771
19772 #. type: textblock
19773 #: ../fish/guestfish.pod:987
19774 msgid ""
19775 "Used with the I<--remote> option to specify the remote guestfish process to "
19776 "control.  See section L</REMOTE CONTROL GUESTFISH OVER A SOCKET>."
19777 msgstr ""
19778
19779 #. type: =item
19780 #: ../fish/guestfish.pod:991
19781 msgid "HEXEDITOR"
19782 msgstr ""
19783
19784 #. type: textblock
19785 #: ../fish/guestfish.pod:993
19786 msgid ""
19787 "The L</hexedit> command uses C<$HEXEDITOR> as the external hex editor.  If "
19788 "not specified, the external L<hexedit(1)> program is used."
19789 msgstr ""
19790
19791 #. type: =item
19792 #: ../fish/guestfish.pod:997
19793 msgid "HOME"
19794 msgstr ""
19795
19796 #. type: textblock
19797 #: ../fish/guestfish.pod:999
19798 msgid ""
19799 "If compiled with GNU readline support, various files in the home directory "
19800 "can be used.  See L</FILES>."
19801 msgstr ""
19802
19803 #. type: textblock
19804 #: ../fish/guestfish.pod:1008
19805 msgid ""
19806 "Set C<LIBGUESTFS_DEBUG=1> to enable verbose messages.  This has the same "
19807 "effect as using the B<-v> option."
19808 msgstr ""
19809
19810 #. type: textblock
19811 #: ../fish/guestfish.pod:1020
19812 msgid ""
19813 "Set the path that guestfish uses to search for kernel and initrd.img.  See "
19814 "the discussion of paths in L<guestfs(3)>."
19815 msgstr ""
19816
19817 #. type: textblock
19818 #: ../fish/guestfish.pod:1031
19819 msgid "Set C<LIBGUESTFS_TRACE=1> to enable command traces."
19820 msgstr ""
19821
19822 #. type: =item
19823 #: ../fish/guestfish.pod:1033
19824 msgid "PAGER"
19825 msgstr ""
19826
19827 #. type: textblock
19828 #: ../fish/guestfish.pod:1035
19829 msgid ""
19830 "The C<more> command uses C<$PAGER> as the pager.  If not set, it uses "
19831 "C<more>."
19832 msgstr ""
19833
19834 #. type: =head1
19835 #: ../fish/guestfish.pod:1050 ../test-tool/libguestfs-test-tool.pod:88
19836 msgid "FILES"
19837 msgstr ""
19838
19839 #. type: =item
19840 #: ../fish/guestfish.pod:1054
19841 msgid "$HOME/.guestfish"
19842 msgstr ""
19843
19844 #. type: textblock
19845 #: ../fish/guestfish.pod:1056
19846 msgid ""
19847 "If compiled with GNU readline support, then the command history is saved in "
19848 "this file."
19849 msgstr ""
19850
19851 #. type: =item
19852 #: ../fish/guestfish.pod:1059
19853 msgid "$HOME/.inputrc"
19854 msgstr ""
19855
19856 #. type: =item
19857 #: ../fish/guestfish.pod:1061
19858 msgid "/etc/inputrc"
19859 msgstr ""
19860
19861 #. type: textblock
19862 #: ../fish/guestfish.pod:1063
19863 msgid ""
19864 "If compiled with GNU readline support, then these files can be used to "
19865 "configure readline.  For further information, please see "
19866 "L<readline(3)/INITIALIZATION FILE>."
19867 msgstr ""
19868
19869 #. type: textblock
19870 #: ../fish/guestfish.pod:1067
19871 msgid "To write rules which only apply to guestfish, use:"
19872 msgstr ""
19873
19874 #. type: verbatim
19875 #: ../fish/guestfish.pod:1069
19876 #, no-wrap
19877 msgid ""
19878 " $if guestfish\n"
19879 " ...\n"
19880 " $endif\n"
19881 "\n"
19882 msgstr ""
19883
19884 #. type: textblock
19885 #: ../fish/guestfish.pod:1073
19886 msgid ""
19887 "Variables that you can set in inputrc that change the behaviour of guestfish "
19888 "in useful ways include:"
19889 msgstr ""
19890
19891 #. type: =item
19892 #: ../fish/guestfish.pod:1078
19893 msgid "completion-ignore-case (default: on)"
19894 msgstr ""
19895
19896 #. type: textblock
19897 #: ../fish/guestfish.pod:1080
19898 msgid ""
19899 "By default, guestfish will ignore case when tab-completing paths on the "
19900 "disk.  Use:"
19901 msgstr ""
19902
19903 #. type: verbatim
19904 #: ../fish/guestfish.pod:1083
19905 #, no-wrap
19906 msgid ""
19907 " set completion-ignore-case off\n"
19908 "\n"
19909 msgstr ""
19910
19911 #. type: textblock
19912 #: ../fish/guestfish.pod:1085
19913 msgid "to make guestfish case sensitive."
19914 msgstr ""
19915
19916 #. type: =item
19917 #: ../fish/guestfish.pod:1089
19918 msgid "test1.img"
19919 msgstr ""
19920
19921 #. type: =item
19922 #: ../fish/guestfish.pod:1091
19923 msgid "test2.img (etc)"
19924 msgstr ""
19925
19926 #. type: textblock
19927 #: ../fish/guestfish.pod:1093
19928 msgid ""
19929 "When using the C<-N> or C<--new> option, the prepared disk or filesystem "
19930 "will be created in the file C<test1.img> in the current directory.  The "
19931 "second use of C<-N> will use C<test2.img> and so on.  Any existing file with "
19932 "the same name will be overwritten."
19933 msgstr ""
19934
19935 #. type: textblock
19936 #: ../fish/guestfish.pod:1102
19937 msgid ""
19938 "L<guestfs(3)>, L<http://libguestfs.org/>, L<virt-cat(1)>, L<virt-df(1)>, "
19939 "L<virt-edit(1)>, L<virt-filesystems(1)>, L<virt-inspector(1)>, "
19940 "L<virt-list-filesystems(1)>, L<virt-list-partitions(1)>, L<virt-ls(1)>, "
19941 "L<virt-make-fs(1)>, L<virt-rescue(1)>, L<virt-resize(1)>, L<virt-tar(1)>, "
19942 "L<virt-win-reg(1)>, L<hexedit(1)>."
19943 msgstr ""
19944
19945 #. type: textblock
19946 #: ../fish/guestfish.pod:1128 ../test-tool/libguestfs-test-tool.pod:124 ../fuse/guestmount.pod:253 ../tools/virt-edit.pl:415 ../tools/virt-win-reg.pl:606 ../tools/virt-resize.pl:1512 ../tools/virt-list-filesystems.pl:210 ../tools/virt-tar.pl:300 ../tools/virt-make-fs.pl:572 ../tools/virt-list-partitions.pl:277
19947 msgid ""
19948 "This program is free software; you can redistribute it and/or modify it "
19949 "under the terms of the GNU General Public License as published by the Free "
19950 "Software Foundation; either version 2 of the License, or (at your option) "
19951 "any later version."
19952 msgstr ""
19953
19954 #. type: textblock
19955 #: ../fish/guestfish.pod:1133 ../test-tool/libguestfs-test-tool.pod:129 ../fuse/guestmount.pod:258 ../tools/virt-edit.pl:420 ../tools/virt-win-reg.pl:611 ../tools/virt-resize.pl:1517 ../tools/virt-list-filesystems.pl:215 ../tools/virt-tar.pl:305 ../tools/virt-make-fs.pl:577 ../tools/virt-list-partitions.pl:282
19956 msgid ""
19957 "This program is distributed in the hope that it will be useful, but WITHOUT "
19958 "ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or "
19959 "FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for "
19960 "more details."
19961 msgstr ""
19962
19963 #. type: textblock
19964 #: ../fish/guestfish.pod:1138 ../test-tool/libguestfs-test-tool.pod:134 ../fuse/guestmount.pod:263 ../tools/virt-edit.pl:425 ../tools/virt-win-reg.pl:616 ../tools/virt-resize.pl:1522 ../tools/virt-list-filesystems.pl:220 ../tools/virt-tar.pl:310 ../tools/virt-make-fs.pl:582 ../tools/virt-list-partitions.pl:287
19965 msgid ""
19966 "You should have received a copy of the GNU General Public License along with "
19967 "this program; if not, write to the Free Software Foundation, Inc., 675 Mass "
19968 "Ave, Cambridge, MA 02139, USA."
19969 msgstr ""
19970
19971 #. type: =head2
19972 #: ../fish/guestfish-actions.pod:1
19973 msgid "add-cdrom"
19974 msgstr ""
19975
19976 #. type: verbatim
19977 #: ../fish/guestfish-actions.pod:3
19978 #, no-wrap
19979 msgid ""
19980 " add-cdrom filename\n"
19981 "\n"
19982 msgstr ""
19983
19984 #. type: textblock
19985 #: ../fish/guestfish-actions.pod:15
19986 msgid ""
19987 "This call checks for the existence of C<filename>.  This stops you from "
19988 "specifying other types of drive which are supported by qemu such as C<nbd:> "
19989 "and C<http:> URLs.  To specify those, use the general L</config> call "
19990 "instead."
19991 msgstr ""
19992
19993 #. type: textblock
19994 #: ../fish/guestfish-actions.pod:22
19995 msgid ""
19996 "If you just want to add an ISO file (often you use this as an efficient way "
19997 "to transfer large files into the guest), then you should probably use "
19998 "L</add-drive-ro> instead."
19999 msgstr ""
20000
20001 #. type: textblock
20002 #: ../fish/guestfish-actions.pod:28 ../fish/guestfish-actions.pod:151 ../fish/guestfish-actions.pod:165
20003 msgid ""
20004 "This function is deprecated.  In new code, use the L</add_drive_opts> call "
20005 "instead."
20006 msgstr ""
20007
20008 #. type: =head2
20009 #: ../fish/guestfish-actions.pod:35
20010 msgid "add-domain"
20011 msgstr ""
20012
20013 #. type: =head2
20014 #: ../fish/guestfish-actions.pod:37
20015 msgid "domain"
20016 msgstr ""
20017
20018 #. type: verbatim
20019 #: ../fish/guestfish-actions.pod:39
20020 #, no-wrap
20021 msgid ""
20022 " add-domain dom [libvirturi:..] [readonly:..] [iface:..]\n"
20023 "\n"
20024 msgstr ""
20025
20026 #. type: textblock
20027 #: ../fish/guestfish-actions.pod:41
20028 msgid ""
20029 "This function adds the disk(s) attached to the named libvirt domain C<dom>.  "
20030 "It works by connecting to libvirt, requesting the domain and domain XML from "
20031 "libvirt, parsing it for disks, and calling L</add-drive-opts> on each one."
20032 msgstr ""
20033
20034 #. type: textblock
20035 #: ../fish/guestfish-actions.pod:64
20036 msgid ""
20037 "The other optional parameters are passed directly through to "
20038 "L</add-drive-opts>."
20039 msgstr ""
20040
20041 #. type: textblock
20042 #: ../fish/guestfish-actions.pod:67 ../fish/guestfish-actions.pod:131 ../fish/guestfish-actions.pod:2872
20043 msgid ""
20044 "This command has one or more optional arguments.  See L</OPTIONAL "
20045 "ARGUMENTS>."
20046 msgstr ""
20047
20048 #. type: =head2
20049 #: ../fish/guestfish-actions.pod:69
20050 msgid "add-drive"
20051 msgstr ""
20052
20053 #. type: verbatim
20054 #: ../fish/guestfish-actions.pod:71
20055 #, no-wrap
20056 msgid ""
20057 " add-drive filename\n"
20058 "\n"
20059 msgstr ""
20060
20061 #. type: textblock
20062 #: ../fish/guestfish-actions.pod:73
20063 msgid ""
20064 "This function is the equivalent of calling L</add-drive-opts> with no "
20065 "optional parameters, so the disk is added writable, with the format being "
20066 "detected automatically."
20067 msgstr ""
20068
20069 #. type: textblock
20070 #: ../fish/guestfish-actions.pod:77
20071 msgid ""
20072 "Automatic detection of the format opens you up to a potential security hole "
20073 "when dealing with untrusted raw-format images.  See CVE-2010-3851 and "
20074 "RHBZ#642934.  Specifying the format closes this security hole.  Therefore "
20075 "you should think about replacing calls to this function with calls to "
20076 "L</add-drive-opts>, and specifying the format."
20077 msgstr ""
20078
20079 #. type: =head2
20080 #: ../fish/guestfish-actions.pod:84
20081 msgid "add-drive-opts"
20082 msgstr ""
20083
20084 #. type: =head2
20085 #: ../fish/guestfish-actions.pod:86
20086 msgid "add"
20087 msgstr ""
20088
20089 #. type: verbatim
20090 #: ../fish/guestfish-actions.pod:88
20091 #, no-wrap
20092 msgid ""
20093 " add-drive-opts filename [readonly:..] [format:..] [iface:..]\n"
20094 "\n"
20095 msgstr ""
20096
20097 #. type: textblock
20098 #: ../fish/guestfish-actions.pod:115
20099 msgid ""
20100 "This forces the image format.  If you omit this (or use L</add-drive> or "
20101 "L</add-drive-ro>) then the format is automatically detected.  Possible "
20102 "formats include C<raw> and C<qcow2>."
20103 msgstr ""
20104
20105 #. type: textblock
20106 #: ../fish/guestfish-actions.pod:126
20107 msgid ""
20108 "This rarely-used option lets you emulate the behaviour of the deprecated "
20109 "L</add-drive-with-if> call (q.v.)"
20110 msgstr ""
20111
20112 #. type: =head2
20113 #: ../fish/guestfish-actions.pod:133
20114 msgid "add-drive-ro"
20115 msgstr ""
20116
20117 #. type: =head2
20118 #: ../fish/guestfish-actions.pod:135
20119 msgid "add-ro"
20120 msgstr ""
20121
20122 #. type: verbatim
20123 #: ../fish/guestfish-actions.pod:137
20124 #, no-wrap
20125 msgid ""
20126 " add-drive-ro filename\n"
20127 "\n"
20128 msgstr ""
20129
20130 #. type: textblock
20131 #: ../fish/guestfish-actions.pod:139
20132 msgid ""
20133 "This function is the equivalent of calling L</add-drive-opts> with the "
20134 "optional parameter C<GUESTFS_ADD_DRIVE_OPTS_READONLY> set to 1, so the disk "
20135 "is added read-only, with the format being detected automatically."
20136 msgstr ""
20137
20138 #. type: =head2
20139 #: ../fish/guestfish-actions.pod:144
20140 msgid "add-drive-ro-with-if"
20141 msgstr ""
20142
20143 #. type: verbatim
20144 #: ../fish/guestfish-actions.pod:146
20145 #, no-wrap
20146 msgid ""
20147 " add-drive-ro-with-if filename iface\n"
20148 "\n"
20149 msgstr ""
20150
20151 #. type: textblock
20152 #: ../fish/guestfish-actions.pod:148
20153 msgid ""
20154 "This is the same as L</add-drive-ro> but it allows you to specify the QEMU "
20155 "interface emulation to use at run time."
20156 msgstr ""
20157
20158 #. type: =head2
20159 #: ../fish/guestfish-actions.pod:158
20160 msgid "add-drive-with-if"
20161 msgstr ""
20162
20163 #. type: verbatim
20164 #: ../fish/guestfish-actions.pod:160
20165 #, no-wrap
20166 msgid ""
20167 " add-drive-with-if filename iface\n"
20168 "\n"
20169 msgstr ""
20170
20171 #. type: textblock
20172 #: ../fish/guestfish-actions.pod:162
20173 msgid ""
20174 "This is the same as L</add-drive> but it allows you to specify the QEMU "
20175 "interface emulation to use at run time."
20176 msgstr ""
20177
20178 #. type: =head2
20179 #: ../fish/guestfish-actions.pod:172
20180 msgid "aug-clear"
20181 msgstr ""
20182
20183 #. type: verbatim
20184 #: ../fish/guestfish-actions.pod:174
20185 #, no-wrap
20186 msgid ""
20187 " aug-clear augpath\n"
20188 "\n"
20189 msgstr ""
20190
20191 #. type: =head2
20192 #: ../fish/guestfish-actions.pod:179
20193 msgid "aug-close"
20194 msgstr ""
20195
20196 #. type: verbatim
20197 #: ../fish/guestfish-actions.pod:181
20198 #, no-wrap
20199 msgid ""
20200 " aug-close\n"
20201 "\n"
20202 msgstr ""
20203
20204 #. type: textblock
20205 #: ../fish/guestfish-actions.pod:183
20206 msgid ""
20207 "Close the current Augeas handle and free up any resources used by it.  After "
20208 "calling this, you have to call L</aug-init> again before you can use any "
20209 "other Augeas functions."
20210 msgstr ""
20211
20212 #. type: =head2
20213 #: ../fish/guestfish-actions.pod:188
20214 msgid "aug-defnode"
20215 msgstr ""
20216
20217 #. type: verbatim
20218 #: ../fish/guestfish-actions.pod:190
20219 #, no-wrap
20220 msgid ""
20221 " aug-defnode name expr val\n"
20222 "\n"
20223 msgstr ""
20224
20225 #. type: textblock
20226 #: ../fish/guestfish-actions.pod:195
20227 msgid ""
20228 "If C<expr> evaluates to an empty nodeset, a node is created, equivalent to "
20229 "calling L</aug-set> C<expr>, C<value>.  C<name> will be the nodeset "
20230 "containing that single node."
20231 msgstr ""
20232
20233 #. type: =head2
20234 #: ../fish/guestfish-actions.pod:203
20235 msgid "aug-defvar"
20236 msgstr ""
20237
20238 #. type: verbatim
20239 #: ../fish/guestfish-actions.pod:205
20240 #, no-wrap
20241 msgid ""
20242 " aug-defvar name expr\n"
20243 "\n"
20244 msgstr ""
20245
20246 #. type: =head2
20247 #: ../fish/guestfish-actions.pod:214
20248 msgid "aug-get"
20249 msgstr ""
20250
20251 #. type: verbatim
20252 #: ../fish/guestfish-actions.pod:216
20253 #, no-wrap
20254 msgid ""
20255 " aug-get augpath\n"
20256 "\n"
20257 msgstr ""
20258
20259 #. type: =head2
20260 #: ../fish/guestfish-actions.pod:221
20261 msgid "aug-init"
20262 msgstr ""
20263
20264 #. type: verbatim
20265 #: ../fish/guestfish-actions.pod:223
20266 #, no-wrap
20267 msgid ""
20268 " aug-init root flags\n"
20269 "\n"
20270 msgstr ""
20271
20272 #. type: textblock
20273 #: ../fish/guestfish-actions.pod:229
20274 msgid "You must call this before using any other L</aug-*> commands."
20275 msgstr ""
20276
20277 #. type: textblock
20278 #: ../fish/guestfish-actions.pod:254
20279 msgid ""
20280 "This option is only useful when debugging Augeas lenses.  Use of this option "
20281 "may require additional memory for the libguestfs appliance.  You may need to "
20282 "set the C<LIBGUESTFS_MEMSIZE> environment variable or call L</set-memsize>."
20283 msgstr ""
20284
20285 #. type: textblock
20286 #: ../fish/guestfish-actions.pod:269
20287 msgid "Do not load the tree in L</aug-init>."
20288 msgstr ""
20289
20290 #. type: textblock
20291 #: ../fish/guestfish-actions.pod:273
20292 msgid "To close the handle, you can call L</aug-close>."
20293 msgstr ""
20294
20295 #. type: =head2
20296 #: ../fish/guestfish-actions.pod:277
20297 msgid "aug-insert"
20298 msgstr ""
20299
20300 #. type: verbatim
20301 #: ../fish/guestfish-actions.pod:279
20302 #, no-wrap
20303 msgid ""
20304 " aug-insert augpath label true|false\n"
20305 "\n"
20306 msgstr ""
20307
20308 #. type: =head2
20309 #: ../fish/guestfish-actions.pod:289
20310 msgid "aug-load"
20311 msgstr ""
20312
20313 #. type: verbatim
20314 #: ../fish/guestfish-actions.pod:291
20315 #, no-wrap
20316 msgid ""
20317 " aug-load\n"
20318 "\n"
20319 msgstr ""
20320
20321 #. type: =head2
20322 #: ../fish/guestfish-actions.pod:298
20323 msgid "aug-ls"
20324 msgstr ""
20325
20326 #. type: verbatim
20327 #: ../fish/guestfish-actions.pod:300
20328 #, no-wrap
20329 msgid ""
20330 " aug-ls augpath\n"
20331 "\n"
20332 msgstr ""
20333
20334 #. type: textblock
20335 #: ../fish/guestfish-actions.pod:302
20336 msgid ""
20337 "This is just a shortcut for listing L</aug-match> C<path/*> and sorting the "
20338 "resulting nodes into alphabetical order."
20339 msgstr ""
20340
20341 #. type: =head2
20342 #: ../fish/guestfish-actions.pod:305
20343 msgid "aug-match"
20344 msgstr ""
20345
20346 #. type: verbatim
20347 #: ../fish/guestfish-actions.pod:307
20348 #, no-wrap
20349 msgid ""
20350 " aug-match augpath\n"
20351 "\n"
20352 msgstr ""
20353
20354 #. type: =head2
20355 #: ../fish/guestfish-actions.pod:313
20356 msgid "aug-mv"
20357 msgstr ""
20358
20359 #. type: verbatim
20360 #: ../fish/guestfish-actions.pod:315
20361 #, no-wrap
20362 msgid ""
20363 " aug-mv src dest\n"
20364 "\n"
20365 msgstr ""
20366
20367 #. type: =head2
20368 #: ../fish/guestfish-actions.pod:320
20369 msgid "aug-rm"
20370 msgstr ""
20371
20372 #. type: verbatim
20373 #: ../fish/guestfish-actions.pod:322
20374 #, no-wrap
20375 msgid ""
20376 " aug-rm augpath\n"
20377 "\n"
20378 msgstr ""
20379
20380 #. type: =head2
20381 #: ../fish/guestfish-actions.pod:328
20382 msgid "aug-save"
20383 msgstr ""
20384
20385 #. type: verbatim
20386 #: ../fish/guestfish-actions.pod:330
20387 #, no-wrap
20388 msgid ""
20389 " aug-save\n"
20390 "\n"
20391 msgstr ""
20392
20393 #. type: textblock
20394 #: ../fish/guestfish-actions.pod:334
20395 msgid ""
20396 "The flags which were passed to L</aug-init> affect exactly how files are "
20397 "saved."
20398 msgstr ""
20399
20400 #. type: =head2
20401 #: ../fish/guestfish-actions.pod:337
20402 msgid "aug-set"
20403 msgstr ""
20404
20405 #. type: verbatim
20406 #: ../fish/guestfish-actions.pod:339
20407 #, no-wrap
20408 msgid ""
20409 " aug-set augpath val\n"
20410 "\n"
20411 msgstr ""
20412
20413 #. type: textblock
20414 #: ../fish/guestfish-actions.pod:343
20415 msgid ""
20416 "In the Augeas API, it is possible to clear a node by setting the value to "
20417 "NULL.  Due to an oversight in the libguestfs API you cannot do that with "
20418 "this call.  Instead you must use the L</aug-clear> call."
20419 msgstr ""
20420
20421 #. type: =head2
20422 #: ../fish/guestfish-actions.pod:348
20423 msgid "available"
20424 msgstr ""
20425
20426 #. type: verbatim
20427 #: ../fish/guestfish-actions.pod:350
20428 #, no-wrap
20429 msgid ""
20430 " available 'groups ...'\n"
20431 "\n"
20432 msgstr ""
20433
20434 #. type: textblock
20435 #: ../fish/guestfish-actions.pod:356
20436 msgid ""
20437 "The libguestfs groups, and the functions that those groups correspond to, "
20438 "are listed in L<guestfs(3)/AVAILABILITY>.  You can also fetch this list at "
20439 "runtime by calling L</available-all-groups>."
20440 msgstr ""
20441
20442 #. type: textblock
20443 #: ../fish/guestfish-actions.pod:380
20444 msgid "You must call L</launch> before calling this function."
20445 msgstr ""
20446
20447 #. type: textblock
20448 #: ../fish/guestfish-actions.pod:402
20449 msgid ""
20450 "This call was added in version C<1.0.80>.  In previous versions of "
20451 "libguestfs all you could do would be to speculatively execute a command to "
20452 "find out if the daemon implemented it.  See also L</version>."
20453 msgstr ""
20454
20455 #. type: =head2
20456 #: ../fish/guestfish-actions.pod:409
20457 msgid "available-all-groups"
20458 msgstr ""
20459
20460 #. type: verbatim
20461 #: ../fish/guestfish-actions.pod:411
20462 #, no-wrap
20463 msgid ""
20464 " available-all-groups\n"
20465 "\n"
20466 msgstr ""
20467
20468 #. type: textblock
20469 #: ../fish/guestfish-actions.pod:413
20470 msgid ""
20471 "This command returns a list of all optional groups that this daemon knows "
20472 "about.  Note this returns both supported and unsupported groups.  To find "
20473 "out which ones the daemon can actually support you have to call "
20474 "L</available> on each member of the returned list."
20475 msgstr ""
20476
20477 #. type: textblock
20478 #: ../fish/guestfish-actions.pod:419
20479 msgid "See also L</available> and L<guestfs(3)/AVAILABILITY>."
20480 msgstr ""
20481
20482 #. type: =head2
20483 #: ../fish/guestfish-actions.pod:421
20484 msgid "base64-in"
20485 msgstr ""
20486
20487 #. type: verbatim
20488 #: ../fish/guestfish-actions.pod:423
20489 #, no-wrap
20490 msgid ""
20491 " base64-in (base64file|-) filename\n"
20492 "\n"
20493 msgstr ""
20494
20495 #. type: textblock
20496 #: ../fish/guestfish-actions.pod:428 ../fish/guestfish-actions.pod:437 ../fish/guestfish-actions.pod:661 ../fish/guestfish-actions.pod:830 ../fish/guestfish-actions.pod:849 ../fish/guestfish-actions.pod:1223 ../fish/guestfish-actions.pod:4236 ../fish/guestfish-actions.pod:4248 ../fish/guestfish-actions.pod:4259 ../fish/guestfish-actions.pod:4270 ../fish/guestfish-actions.pod:4322 ../fish/guestfish-actions.pod:4331 ../fish/guestfish-actions.pod:4385 ../fish/guestfish-actions.pod:4408
20497 msgid "Use C<-> instead of a filename to read/write from stdin/stdout."
20498 msgstr ""
20499
20500 #. type: =head2
20501 #: ../fish/guestfish-actions.pod:430
20502 msgid "base64-out"
20503 msgstr ""
20504
20505 #. type: verbatim
20506 #: ../fish/guestfish-actions.pod:432
20507 #, no-wrap
20508 msgid ""
20509 " base64-out filename (base64file|-)\n"
20510 "\n"
20511 msgstr ""
20512
20513 #. type: =head2
20514 #: ../fish/guestfish-actions.pod:439
20515 msgid "blockdev-flushbufs"
20516 msgstr ""
20517
20518 #. type: verbatim
20519 #: ../fish/guestfish-actions.pod:441
20520 #, no-wrap
20521 msgid ""
20522 " blockdev-flushbufs device\n"
20523 "\n"
20524 msgstr ""
20525
20526 #. type: =head2
20527 #: ../fish/guestfish-actions.pod:448
20528 msgid "blockdev-getbsz"
20529 msgstr ""
20530
20531 #. type: verbatim
20532 #: ../fish/guestfish-actions.pod:450
20533 #, no-wrap
20534 msgid ""
20535 " blockdev-getbsz device\n"
20536 "\n"
20537 msgstr ""
20538
20539 #. type: =head2
20540 #: ../fish/guestfish-actions.pod:459
20541 msgid "blockdev-getro"
20542 msgstr ""
20543
20544 #. type: verbatim
20545 #: ../fish/guestfish-actions.pod:461
20546 #, no-wrap
20547 msgid ""
20548 " blockdev-getro device\n"
20549 "\n"
20550 msgstr ""
20551
20552 #. type: =head2
20553 #: ../fish/guestfish-actions.pod:468
20554 msgid "blockdev-getsize64"
20555 msgstr ""
20556
20557 #. type: verbatim
20558 #: ../fish/guestfish-actions.pod:470
20559 #, no-wrap
20560 msgid ""
20561 " blockdev-getsize64 device\n"
20562 "\n"
20563 msgstr ""
20564
20565 #. type: textblock
20566 #: ../fish/guestfish-actions.pod:474
20567 msgid "See also L</blockdev-getsz>."
20568 msgstr ""
20569
20570 #. type: =head2
20571 #: ../fish/guestfish-actions.pod:478
20572 msgid "blockdev-getss"
20573 msgstr ""
20574
20575 #. type: verbatim
20576 #: ../fish/guestfish-actions.pod:480
20577 #, no-wrap
20578 msgid ""
20579 " blockdev-getss device\n"
20580 "\n"
20581 msgstr ""
20582
20583 #. type: textblock
20584 #: ../fish/guestfish-actions.pod:485
20585 msgid "(Note, this is not the size in sectors, use L</blockdev-getsz> for that)."
20586 msgstr ""
20587
20588 #. type: =head2
20589 #: ../fish/guestfish-actions.pod:490
20590 msgid "blockdev-getsz"
20591 msgstr ""
20592
20593 #. type: verbatim
20594 #: ../fish/guestfish-actions.pod:492
20595 #, no-wrap
20596 msgid ""
20597 " blockdev-getsz device\n"
20598 "\n"
20599 msgstr ""
20600
20601 #. type: textblock
20602 #: ../fish/guestfish-actions.pod:497
20603 msgid ""
20604 "See also L</blockdev-getss> for the real sector size of the device, and "
20605 "L</blockdev-getsize64> for the more useful I<size in bytes>."
20606 msgstr ""
20607
20608 #. type: =head2
20609 #: ../fish/guestfish-actions.pod:503
20610 msgid "blockdev-rereadpt"
20611 msgstr ""
20612
20613 #. type: verbatim
20614 #: ../fish/guestfish-actions.pod:505
20615 #, no-wrap
20616 msgid ""
20617 " blockdev-rereadpt device\n"
20618 "\n"
20619 msgstr ""
20620
20621 #. type: =head2
20622 #: ../fish/guestfish-actions.pod:511
20623 msgid "blockdev-setbsz"
20624 msgstr ""
20625
20626 #. type: verbatim
20627 #: ../fish/guestfish-actions.pod:513
20628 #, no-wrap
20629 msgid ""
20630 " blockdev-setbsz device blocksize\n"
20631 "\n"
20632 msgstr ""
20633
20634 #. type: =head2
20635 #: ../fish/guestfish-actions.pod:522
20636 msgid "blockdev-setro"
20637 msgstr ""
20638
20639 #. type: verbatim
20640 #: ../fish/guestfish-actions.pod:524
20641 #, no-wrap
20642 msgid ""
20643 " blockdev-setro device\n"
20644 "\n"
20645 msgstr ""
20646
20647 #. type: =head2
20648 #: ../fish/guestfish-actions.pod:530
20649 msgid "blockdev-setrw"
20650 msgstr ""
20651
20652 #. type: verbatim
20653 #: ../fish/guestfish-actions.pod:532
20654 #, no-wrap
20655 msgid ""
20656 " blockdev-setrw device\n"
20657 "\n"
20658 msgstr ""
20659
20660 #. type: =head2
20661 #: ../fish/guestfish-actions.pod:538
20662 msgid "case-sensitive-path"
20663 msgstr ""
20664
20665 #. type: verbatim
20666 #: ../fish/guestfish-actions.pod:540
20667 #, no-wrap
20668 msgid ""
20669 " case-sensitive-path path\n"
20670 "\n"
20671 msgstr ""
20672
20673 #. type: textblock
20674 #: ../fish/guestfish-actions.pod:564
20675 msgid ""
20676 "Thus L</case-sensitive-path> (\"/Windows/System32\")  might return "
20677 "C<\"/WINDOWS/system32\"> (the exact return value would depend on details of "
20678 "how the directories were originally created under Windows)."
20679 msgstr ""
20680
20681 #. type: textblock
20682 #: ../fish/guestfish-actions.pod:572
20683 msgid "See also L</realpath>."
20684 msgstr ""
20685
20686 #. type: =head2
20687 #: ../fish/guestfish-actions.pod:574
20688 msgid "cat"
20689 msgstr ""
20690
20691 #. type: verbatim
20692 #: ../fish/guestfish-actions.pod:576
20693 #, no-wrap
20694 msgid ""
20695 " cat path\n"
20696 "\n"
20697 msgstr ""
20698
20699 #. type: textblock
20700 #: ../fish/guestfish-actions.pod:580
20701 msgid ""
20702 "Note that this function cannot correctly handle binary files (specifically, "
20703 "files containing C<\\0> character which is treated as end of string).  For "
20704 "those you need to use the L</read-file> or L</download> functions which have "
20705 "a more complex interface."
20706 msgstr ""
20707
20708 #. type: =head2
20709 #: ../fish/guestfish-actions.pod:588
20710 msgid "checksum"
20711 msgstr ""
20712
20713 #. type: verbatim
20714 #: ../fish/guestfish-actions.pod:590
20715 #, no-wrap
20716 msgid ""
20717 " checksum csumtype path\n"
20718 "\n"
20719 msgstr ""
20720
20721 #. type: textblock
20722 #: ../fish/guestfish-actions.pod:633
20723 msgid "To get the checksum for a device, use L</checksum-device>."
20724 msgstr ""
20725
20726 #. type: textblock
20727 #: ../fish/guestfish-actions.pod:635
20728 msgid "To get the checksums for many files, use L</checksums-out>."
20729 msgstr ""
20730
20731 #. type: =head2
20732 #: ../fish/guestfish-actions.pod:637
20733 msgid "checksum-device"
20734 msgstr ""
20735
20736 #. type: verbatim
20737 #: ../fish/guestfish-actions.pod:639
20738 #, no-wrap
20739 msgid ""
20740 " checksum-device csumtype device\n"
20741 "\n"
20742 msgstr ""
20743
20744 #. type: textblock
20745 #: ../fish/guestfish-actions.pod:641
20746 msgid ""
20747 "This call computes the MD5, SHAx or CRC checksum of the contents of the "
20748 "device named C<device>.  For the types of checksums supported see the "
20749 "L</checksum> command."
20750 msgstr ""
20751
20752 #. type: =head2
20753 #: ../fish/guestfish-actions.pod:645
20754 msgid "checksums-out"
20755 msgstr ""
20756
20757 #. type: verbatim
20758 #: ../fish/guestfish-actions.pod:647
20759 #, no-wrap
20760 msgid ""
20761 " checksums-out csumtype directory (sumsfile|-)\n"
20762 "\n"
20763 msgstr ""
20764
20765 #. type: =head2
20766 #: ../fish/guestfish-actions.pod:663
20767 msgid "chmod"
20768 msgstr ""
20769
20770 #. type: verbatim
20771 #: ../fish/guestfish-actions.pod:665
20772 #, no-wrap
20773 msgid ""
20774 " chmod mode path\n"
20775 "\n"
20776 msgstr ""
20777
20778 #. type: =head2
20779 #: ../fish/guestfish-actions.pod:676
20780 msgid "chown"
20781 msgstr ""
20782
20783 #. type: verbatim
20784 #: ../fish/guestfish-actions.pod:678
20785 #, no-wrap
20786 msgid ""
20787 " chown owner group path\n"
20788 "\n"
20789 msgstr ""
20790
20791 #. type: =head2
20792 #: ../fish/guestfish-actions.pod:686
20793 msgid "command"
20794 msgstr ""
20795
20796 #. type: verbatim
20797 #: ../fish/guestfish-actions.pod:688
20798 #, no-wrap
20799 msgid ""
20800 " command 'arguments ...'\n"
20801 "\n"
20802 msgstr ""
20803
20804 #. type: textblock
20805 #: ../fish/guestfish-actions.pod:695
20806 msgid ""
20807 "The single parameter is an argv-style list of arguments.  The first element "
20808 "is the name of the program to run.  Subsequent elements are parameters.  The "
20809 "list must be non-empty (ie. must contain a program name).  Note that the "
20810 "command runs directly, and is I<not> invoked via the shell (see L</sh>)."
20811 msgstr ""
20812
20813 #. type: =head2
20814 #: ../fish/guestfish-actions.pod:723
20815 msgid "command-lines"
20816 msgstr ""
20817
20818 #. type: verbatim
20819 #: ../fish/guestfish-actions.pod:725
20820 #, no-wrap
20821 msgid ""
20822 " command-lines 'arguments ...'\n"
20823 "\n"
20824 msgstr ""
20825
20826 #. type: textblock
20827 #: ../fish/guestfish-actions.pod:727
20828 msgid "This is the same as L</command>, but splits the result into a list of lines."
20829 msgstr ""
20830
20831 #. type: textblock
20832 #: ../fish/guestfish-actions.pod:730
20833 msgid "See also: L</sh-lines>"
20834 msgstr ""
20835
20836 #. type: =head2
20837 #: ../fish/guestfish-actions.pod:735
20838 msgid "config"
20839 msgstr ""
20840
20841 #. type: verbatim
20842 #: ../fish/guestfish-actions.pod:737
20843 #, no-wrap
20844 msgid ""
20845 " config qemuparam qemuvalue\n"
20846 "\n"
20847 msgstr ""
20848
20849 #. type: =head2
20850 #: ../fish/guestfish-actions.pod:748
20851 msgid "copy-size"
20852 msgstr ""
20853
20854 #. type: verbatim
20855 #: ../fish/guestfish-actions.pod:750
20856 #, no-wrap
20857 msgid ""
20858 " copy-size src dest size\n"
20859 "\n"
20860 msgstr ""
20861
20862 #. type: =head2
20863 #: ../fish/guestfish-actions.pod:758
20864 msgid "cp"
20865 msgstr ""
20866
20867 #. type: verbatim
20868 #: ../fish/guestfish-actions.pod:760
20869 #, no-wrap
20870 msgid ""
20871 " cp src dest\n"
20872 "\n"
20873 msgstr ""
20874
20875 #. type: =head2
20876 #: ../fish/guestfish-actions.pod:765
20877 msgid "cp-a"
20878 msgstr ""
20879
20880 #. type: verbatim
20881 #: ../fish/guestfish-actions.pod:767
20882 #, no-wrap
20883 msgid ""
20884 " cp-a src dest\n"
20885 "\n"
20886 msgstr ""
20887
20888 #. type: =head2
20889 #: ../fish/guestfish-actions.pod:772
20890 msgid "dd"
20891 msgstr ""
20892
20893 #. type: verbatim
20894 #: ../fish/guestfish-actions.pod:774
20895 #, no-wrap
20896 msgid ""
20897 " dd src dest\n"
20898 "\n"
20899 msgstr ""
20900
20901 #. type: textblock
20902 #: ../fish/guestfish-actions.pod:781
20903 msgid ""
20904 "If the destination is a device, it must be as large or larger than the "
20905 "source file or device, otherwise the copy will fail.  This command cannot do "
20906 "partial copies (see L</copy-size>)."
20907 msgstr ""
20908
20909 #. type: =head2
20910 #: ../fish/guestfish-actions.pod:785
20911 msgid "df"
20912 msgstr ""
20913
20914 #. type: verbatim
20915 #: ../fish/guestfish-actions.pod:787
20916 #, no-wrap
20917 msgid ""
20918 " df\n"
20919 "\n"
20920 msgstr ""
20921
20922 #. type: textblock
20923 #: ../fish/guestfish-actions.pod:791 ../fish/guestfish-actions.pod:802
20924 msgid ""
20925 "This command is mostly useful for interactive sessions.  It is I<not> "
20926 "intended that you try to parse the output string.  Use L</statvfs> from "
20927 "programs."
20928 msgstr ""
20929
20930 #. type: =head2
20931 #: ../fish/guestfish-actions.pod:795
20932 msgid "df-h"
20933 msgstr ""
20934
20935 #. type: verbatim
20936 #: ../fish/guestfish-actions.pod:797
20937 #, no-wrap
20938 msgid ""
20939 " df-h\n"
20940 "\n"
20941 msgstr ""
20942
20943 #. type: =head2
20944 #: ../fish/guestfish-actions.pod:806
20945 msgid "dmesg"
20946 msgstr ""
20947
20948 #. type: verbatim
20949 #: ../fish/guestfish-actions.pod:808
20950 #, no-wrap
20951 msgid ""
20952 " dmesg\n"
20953 "\n"
20954 msgstr ""
20955
20956 #. type: textblock
20957 #: ../fish/guestfish-actions.pod:814
20958 msgid ""
20959 "Another way to get the same information is to enable verbose messages with "
20960 "L</set-verbose> or by setting the environment variable C<LIBGUESTFS_DEBUG=1> "
20961 "before running the program."
20962 msgstr ""
20963
20964 #. type: =head2
20965 #: ../fish/guestfish-actions.pod:819
20966 msgid "download"
20967 msgstr ""
20968
20969 #. type: verbatim
20970 #: ../fish/guestfish-actions.pod:821
20971 #, no-wrap
20972 msgid ""
20973 " download remotefilename (filename|-)\n"
20974 "\n"
20975 msgstr ""
20976
20977 #. type: textblock
20978 #: ../fish/guestfish-actions.pod:828
20979 msgid "See also L</upload>, L</cat>."
20980 msgstr ""
20981
20982 #. type: =head2
20983 #: ../fish/guestfish-actions.pod:832
20984 msgid "download-offset"
20985 msgstr ""
20986
20987 #. type: verbatim
20988 #: ../fish/guestfish-actions.pod:834
20989 #, no-wrap
20990 msgid ""
20991 " download-offset remotefilename (filename|-) offset size\n"
20992 "\n"
20993 msgstr ""
20994
20995 #. type: textblock
20996 #: ../fish/guestfish-actions.pod:842
20997 msgid ""
20998 "Note that there is no limit on the amount of data that can be downloaded "
20999 "with this call, unlike with L</pread>, and this call always reads the full "
21000 "amount unless an error occurs."
21001 msgstr ""
21002
21003 #. type: textblock
21004 #: ../fish/guestfish-actions.pod:847
21005 msgid "See also L</download>, L</pread>."
21006 msgstr ""
21007
21008 #. type: =head2
21009 #: ../fish/guestfish-actions.pod:851
21010 msgid "drop-caches"
21011 msgstr ""
21012
21013 #. type: verbatim
21014 #: ../fish/guestfish-actions.pod:853
21015 #, no-wrap
21016 msgid ""
21017 " drop-caches whattodrop\n"
21018 "\n"
21019 msgstr ""
21020
21021 #. type: =head2
21022 #: ../fish/guestfish-actions.pod:865
21023 msgid "du"
21024 msgstr ""
21025
21026 #. type: verbatim
21027 #: ../fish/guestfish-actions.pod:867
21028 #, no-wrap
21029 msgid ""
21030 " du path\n"
21031 "\n"
21032 msgstr ""
21033
21034 #. type: =head2
21035 #: ../fish/guestfish-actions.pod:879
21036 msgid "e2fsck-f"
21037 msgstr ""
21038
21039 #. type: verbatim
21040 #: ../fish/guestfish-actions.pod:881
21041 #, no-wrap
21042 msgid ""
21043 " e2fsck-f device\n"
21044 "\n"
21045 msgstr ""
21046
21047 #. type: textblock
21048 #: ../fish/guestfish-actions.pod:887
21049 msgid ""
21050 "This command is only needed because of L</resize2fs> (q.v.).  Normally you "
21051 "should use L</fsck>."
21052 msgstr ""
21053
21054 #. type: =head2
21055 #: ../fish/guestfish-actions.pod:890
21056 msgid "echo-daemon"
21057 msgstr ""
21058
21059 #. type: verbatim
21060 #: ../fish/guestfish-actions.pod:892
21061 #, no-wrap
21062 msgid ""
21063 " echo-daemon 'words ...'\n"
21064 "\n"
21065 msgstr ""
21066
21067 #. type: textblock
21068 #: ../fish/guestfish-actions.pod:899
21069 msgid "See also L</ping-daemon>."
21070 msgstr ""
21071
21072 #. type: =head2
21073 #: ../fish/guestfish-actions.pod:901
21074 msgid "egrep"
21075 msgstr ""
21076
21077 #. type: verbatim
21078 #: ../fish/guestfish-actions.pod:903
21079 #, no-wrap
21080 msgid ""
21081 " egrep regex path\n"
21082 "\n"
21083 msgstr ""
21084
21085 #. type: =head2
21086 #: ../fish/guestfish-actions.pod:911
21087 msgid "egrepi"
21088 msgstr ""
21089
21090 #. type: verbatim
21091 #: ../fish/guestfish-actions.pod:913
21092 #, no-wrap
21093 msgid ""
21094 " egrepi regex path\n"
21095 "\n"
21096 msgstr ""
21097
21098 #. type: =head2
21099 #: ../fish/guestfish-actions.pod:921
21100 msgid "equal"
21101 msgstr ""
21102
21103 #. type: verbatim
21104 #: ../fish/guestfish-actions.pod:923
21105 #, no-wrap
21106 msgid ""
21107 " equal file1 file2\n"
21108 "\n"
21109 msgstr ""
21110
21111 #. type: =head2
21112 #: ../fish/guestfish-actions.pod:930
21113 msgid "exists"
21114 msgstr ""
21115
21116 #. type: verbatim
21117 #: ../fish/guestfish-actions.pod:932
21118 #, no-wrap
21119 msgid ""
21120 " exists path\n"
21121 "\n"
21122 msgstr ""
21123
21124 #. type: textblock
21125 #: ../fish/guestfish-actions.pod:937
21126 msgid "See also L</is-file>, L</is-dir>, L</stat>."
21127 msgstr ""
21128
21129 #. type: =head2
21130 #: ../fish/guestfish-actions.pod:939
21131 msgid "fallocate"
21132 msgstr ""
21133
21134 #. type: verbatim
21135 #: ../fish/guestfish-actions.pod:941
21136 #, no-wrap
21137 msgid ""
21138 " fallocate path len\n"
21139 "\n"
21140 msgstr ""
21141
21142 #. type: textblock
21143 #: ../fish/guestfish-actions.pod:951
21144 msgid ""
21145 "This function is deprecated.  In new code, use the L</fallocate64> call "
21146 "instead."
21147 msgstr ""
21148
21149 #. type: =head2
21150 #: ../fish/guestfish-actions.pod:958
21151 msgid "fallocate64"
21152 msgstr ""
21153
21154 #. type: verbatim
21155 #: ../fish/guestfish-actions.pod:960
21156 #, no-wrap
21157 msgid ""
21158 " fallocate64 path len\n"
21159 "\n"
21160 msgstr ""
21161
21162 #. type: textblock
21163 #: ../fish/guestfish-actions.pod:966
21164 msgid ""
21165 "Note that this call allocates disk blocks for the file.  To create a sparse "
21166 "file use L</truncate-size> instead."
21167 msgstr ""
21168
21169 #. type: textblock
21170 #: ../fish/guestfish-actions.pod:969
21171 msgid ""
21172 "The deprecated call L</fallocate> does the same, but owing to an oversight "
21173 "it only allowed 30 bit lengths to be specified, effectively limiting the "
21174 "maximum size of files created through that call to 1GB."
21175 msgstr ""
21176
21177 #. type: =head2
21178 #: ../fish/guestfish-actions.pod:978
21179 msgid "fgrep"
21180 msgstr ""
21181
21182 #. type: verbatim
21183 #: ../fish/guestfish-actions.pod:980
21184 #, no-wrap
21185 msgid ""
21186 " fgrep pattern path\n"
21187 "\n"
21188 msgstr ""
21189
21190 #. type: =head2
21191 #: ../fish/guestfish-actions.pod:988
21192 msgid "fgrepi"
21193 msgstr ""
21194
21195 #. type: verbatim
21196 #: ../fish/guestfish-actions.pod:990
21197 #, no-wrap
21198 msgid ""
21199 " fgrepi pattern path\n"
21200 "\n"
21201 msgstr ""
21202
21203 #. type: =head2
21204 #: ../fish/guestfish-actions.pod:998
21205 msgid "file"
21206 msgstr ""
21207
21208 #. type: verbatim
21209 #: ../fish/guestfish-actions.pod:1000
21210 #, no-wrap
21211 msgid ""
21212 " file path\n"
21213 "\n"
21214 msgstr ""
21215
21216 #. type: textblock
21217 #: ../fish/guestfish-actions.pod:1016
21218 msgid ""
21219 "See also: L<file(1)>, L</vfs-type>, L</lstat>, L</is-file>, L</is-blockdev> "
21220 "(etc)."
21221 msgstr ""
21222
21223 #. type: =head2
21224 #: ../fish/guestfish-actions.pod:1019
21225 msgid "file-architecture"
21226 msgstr ""
21227
21228 #. type: verbatim
21229 #: ../fish/guestfish-actions.pod:1021
21230 #, no-wrap
21231 msgid ""
21232 " file-architecture filename\n"
21233 "\n"
21234 msgstr ""
21235
21236 #. type: =head2
21237 #: ../fish/guestfish-actions.pod:1124
21238 msgid "filesize"
21239 msgstr ""
21240
21241 #. type: verbatim
21242 #: ../fish/guestfish-actions.pod:1126
21243 #, no-wrap
21244 msgid ""
21245 " filesize file\n"
21246 "\n"
21247 msgstr ""
21248
21249 #. type: textblock
21250 #: ../fish/guestfish-actions.pod:1130
21251 msgid ""
21252 "To get other stats about a file, use L</stat>, L</lstat>, L</is-dir>, "
21253 "L</is-file> etc.  To get the size of block devices, use "
21254 "L</blockdev-getsize64>."
21255 msgstr ""
21256
21257 #. type: =head2
21258 #: ../fish/guestfish-actions.pod:1134
21259 msgid "fill"
21260 msgstr ""
21261
21262 #. type: verbatim
21263 #: ../fish/guestfish-actions.pod:1136
21264 #, no-wrap
21265 msgid ""
21266 " fill c len path\n"
21267 "\n"
21268 msgstr ""
21269
21270 #. type: textblock
21271 #: ../fish/guestfish-actions.pod:1142
21272 msgid ""
21273 "To fill a file with zero bytes (sparsely), it is much more efficient to use "
21274 "L</truncate-size>.  To create a file with a pattern of repeating bytes use "
21275 "L</fill-pattern>."
21276 msgstr ""
21277
21278 #. type: =head2
21279 #: ../fish/guestfish-actions.pod:1147
21280 msgid "fill-pattern"
21281 msgstr ""
21282
21283 #. type: verbatim
21284 #: ../fish/guestfish-actions.pod:1149
21285 #, no-wrap
21286 msgid ""
21287 " fill-pattern pattern len path\n"
21288 "\n"
21289 msgstr ""
21290
21291 #. type: textblock
21292 #: ../fish/guestfish-actions.pod:1151
21293 msgid ""
21294 "This function is like L</fill> except that it creates a new file of length "
21295 "C<len> containing the repeating pattern of bytes in C<pattern>.  The pattern "
21296 "is truncated if necessary to ensure the length of the file is exactly C<len> "
21297 "bytes."
21298 msgstr ""
21299
21300 #. type: =head2
21301 #: ../fish/guestfish-actions.pod:1156
21302 msgid "find"
21303 msgstr ""
21304
21305 #. type: verbatim
21306 #: ../fish/guestfish-actions.pod:1158
21307 #, no-wrap
21308 msgid ""
21309 " find directory\n"
21310 "\n"
21311 msgstr ""
21312
21313 #. type: textblock
21314 #: ../fish/guestfish-actions.pod:1172
21315 msgid "then the returned list from L</find> C</tmp> would be 4 elements:"
21316 msgstr ""
21317
21318 #. type: textblock
21319 #: ../fish/guestfish-actions.pod:1185
21320 msgid "See also L</find0>."
21321 msgstr ""
21322
21323 #. type: =head2
21324 #: ../fish/guestfish-actions.pod:1190
21325 msgid "find0"
21326 msgstr ""
21327
21328 #. type: verbatim
21329 #: ../fish/guestfish-actions.pod:1192
21330 #, no-wrap
21331 msgid ""
21332 " find0 directory (files|-)\n"
21333 "\n"
21334 msgstr ""
21335
21336 #. type: textblock
21337 #: ../fish/guestfish-actions.pod:1198
21338 msgid "This command works the same way as L</find> with the following exceptions:"
21339 msgstr ""
21340
21341 #. type: =head2
21342 #: ../fish/guestfish-actions.pod:1225
21343 msgid "findfs-label"
21344 msgstr ""
21345
21346 #. type: verbatim
21347 #: ../fish/guestfish-actions.pod:1227
21348 #, no-wrap
21349 msgid ""
21350 " findfs-label label\n"
21351 "\n"
21352 msgstr ""
21353
21354 #. type: textblock
21355 #: ../fish/guestfish-actions.pod:1233
21356 msgid "To find the label of a filesystem, use L</vfs-label>."
21357 msgstr ""
21358
21359 #. type: =head2
21360 #: ../fish/guestfish-actions.pod:1235
21361 msgid "findfs-uuid"
21362 msgstr ""
21363
21364 #. type: verbatim
21365 #: ../fish/guestfish-actions.pod:1237
21366 #, no-wrap
21367 msgid ""
21368 " findfs-uuid uuid\n"
21369 "\n"
21370 msgstr ""
21371
21372 #. type: textblock
21373 #: ../fish/guestfish-actions.pod:1243
21374 msgid "To find the UUID of a filesystem, use L</vfs-uuid>."
21375 msgstr ""
21376
21377 #. type: =head2
21378 #: ../fish/guestfish-actions.pod:1245
21379 msgid "fsck"
21380 msgstr ""
21381
21382 #. type: verbatim
21383 #: ../fish/guestfish-actions.pod:1247
21384 #, no-wrap
21385 msgid ""
21386 " fsck fstype device\n"
21387 "\n"
21388 msgstr ""
21389
21390 #. type: =head2
21391 #: ../fish/guestfish-actions.pod:1277
21392 msgid "get-append"
21393 msgstr ""
21394
21395 #. type: verbatim
21396 #: ../fish/guestfish-actions.pod:1279
21397 #, no-wrap
21398 msgid ""
21399 " get-append\n"
21400 "\n"
21401 msgstr ""
21402
21403 #. type: =head2
21404 #: ../fish/guestfish-actions.pod:1286
21405 msgid "get-autosync"
21406 msgstr ""
21407
21408 #. type: verbatim
21409 #: ../fish/guestfish-actions.pod:1288
21410 #, no-wrap
21411 msgid ""
21412 " get-autosync\n"
21413 "\n"
21414 msgstr ""
21415
21416 #. type: =head2
21417 #: ../fish/guestfish-actions.pod:1292
21418 msgid "get-direct"
21419 msgstr ""
21420
21421 #. type: verbatim
21422 #: ../fish/guestfish-actions.pod:1294
21423 #, no-wrap
21424 msgid ""
21425 " get-direct\n"
21426 "\n"
21427 msgstr ""
21428
21429 #. type: =head2
21430 #: ../fish/guestfish-actions.pod:1298
21431 msgid "get-e2label"
21432 msgstr ""
21433
21434 #. type: verbatim
21435 #: ../fish/guestfish-actions.pod:1300
21436 #, no-wrap
21437 msgid ""
21438 " get-e2label device\n"
21439 "\n"
21440 msgstr ""
21441
21442 #. type: textblock
21443 #: ../fish/guestfish-actions.pod:1305
21444 msgid ""
21445 "This function is deprecated.  In new code, use the L</vfs_label> call "
21446 "instead."
21447 msgstr ""
21448
21449 #. type: =head2
21450 #: ../fish/guestfish-actions.pod:1312
21451 msgid "get-e2uuid"
21452 msgstr ""
21453
21454 #. type: verbatim
21455 #: ../fish/guestfish-actions.pod:1314
21456 #, no-wrap
21457 msgid ""
21458 " get-e2uuid device\n"
21459 "\n"
21460 msgstr ""
21461
21462 #. type: textblock
21463 #: ../fish/guestfish-actions.pod:1319
21464 msgid ""
21465 "This function is deprecated.  In new code, use the L</vfs_uuid> call "
21466 "instead."
21467 msgstr ""
21468
21469 #. type: =head2
21470 #: ../fish/guestfish-actions.pod:1326
21471 msgid "get-memsize"
21472 msgstr ""
21473
21474 #. type: verbatim
21475 #: ../fish/guestfish-actions.pod:1328
21476 #, no-wrap
21477 msgid ""
21478 " get-memsize\n"
21479 "\n"
21480 msgstr ""
21481
21482 #. type: textblock
21483 #: ../fish/guestfish-actions.pod:1333
21484 msgid ""
21485 "If L</set-memsize> was not called on this handle, and if "
21486 "C<LIBGUESTFS_MEMSIZE> was not set, then this returns the compiled-in default "
21487 "value for memsize."
21488 msgstr ""
21489
21490 #. type: =head2
21491 #: ../fish/guestfish-actions.pod:1340
21492 msgid "get-network"
21493 msgstr ""
21494
21495 #. type: verbatim
21496 #: ../fish/guestfish-actions.pod:1342
21497 #, no-wrap
21498 msgid ""
21499 " get-network\n"
21500 "\n"
21501 msgstr ""
21502
21503 #. type: =head2
21504 #: ../fish/guestfish-actions.pod:1346
21505 msgid "get-path"
21506 msgstr ""
21507
21508 #. type: verbatim
21509 #: ../fish/guestfish-actions.pod:1348
21510 #, no-wrap
21511 msgid ""
21512 " get-path\n"
21513 "\n"
21514 msgstr ""
21515
21516 #. type: =head2
21517 #: ../fish/guestfish-actions.pod:1355
21518 msgid "get-pid"
21519 msgstr ""
21520
21521 #. type: =head2
21522 #: ../fish/guestfish-actions.pod:1357
21523 msgid "pid"
21524 msgstr ""
21525
21526 #. type: verbatim
21527 #: ../fish/guestfish-actions.pod:1359
21528 #, no-wrap
21529 msgid ""
21530 " get-pid\n"
21531 "\n"
21532 msgstr ""
21533
21534 #. type: =head2
21535 #: ../fish/guestfish-actions.pod:1366
21536 msgid "get-qemu"
21537 msgstr ""
21538
21539 #. type: verbatim
21540 #: ../fish/guestfish-actions.pod:1368
21541 #, no-wrap
21542 msgid ""
21543 " get-qemu\n"
21544 "\n"
21545 msgstr ""
21546
21547 #. type: =head2
21548 #: ../fish/guestfish-actions.pod:1375
21549 msgid "get-recovery-proc"
21550 msgstr ""
21551
21552 #. type: verbatim
21553 #: ../fish/guestfish-actions.pod:1377
21554 #, no-wrap
21555 msgid ""
21556 " get-recovery-proc\n"
21557 "\n"
21558 msgstr ""
21559
21560 #. type: =head2
21561 #: ../fish/guestfish-actions.pod:1381
21562 msgid "get-selinux"
21563 msgstr ""
21564
21565 #. type: verbatim
21566 #: ../fish/guestfish-actions.pod:1383
21567 #, no-wrap
21568 msgid ""
21569 " get-selinux\n"
21570 "\n"
21571 msgstr ""
21572
21573 #. type: textblock
21574 #: ../fish/guestfish-actions.pod:1385
21575 msgid ""
21576 "This returns the current setting of the selinux flag which is passed to the "
21577 "appliance at boot time.  See L</set-selinux>."
21578 msgstr ""
21579
21580 #. type: =head2
21581 #: ../fish/guestfish-actions.pod:1391
21582 msgid "get-state"
21583 msgstr ""
21584
21585 #. type: verbatim
21586 #: ../fish/guestfish-actions.pod:1393
21587 #, no-wrap
21588 msgid ""
21589 " get-state\n"
21590 "\n"
21591 msgstr ""
21592
21593 #. type: =head2
21594 #: ../fish/guestfish-actions.pod:1400
21595 msgid "get-trace"
21596 msgstr ""
21597
21598 #. type: verbatim
21599 #: ../fish/guestfish-actions.pod:1402
21600 #, no-wrap
21601 msgid ""
21602 " get-trace\n"
21603 "\n"
21604 msgstr ""
21605
21606 #. type: =head2
21607 #: ../fish/guestfish-actions.pod:1406
21608 msgid "get-umask"
21609 msgstr ""
21610
21611 #. type: verbatim
21612 #: ../fish/guestfish-actions.pod:1408
21613 #, no-wrap
21614 msgid ""
21615 " get-umask\n"
21616 "\n"
21617 msgstr ""
21618
21619 #. type: textblock
21620 #: ../fish/guestfish-actions.pod:1410
21621 msgid ""
21622 "Return the current umask.  By default the umask is C<022> unless it has been "
21623 "set by calling L</umask>."
21624 msgstr ""
21625
21626 #. type: =head2
21627 #: ../fish/guestfish-actions.pod:1413
21628 msgid "get-verbose"
21629 msgstr ""
21630
21631 #. type: verbatim
21632 #: ../fish/guestfish-actions.pod:1415
21633 #, no-wrap
21634 msgid ""
21635 " get-verbose\n"
21636 "\n"
21637 msgstr ""
21638
21639 #. type: =head2
21640 #: ../fish/guestfish-actions.pod:1419
21641 msgid "getcon"
21642 msgstr ""
21643
21644 #. type: verbatim
21645 #: ../fish/guestfish-actions.pod:1421
21646 #, no-wrap
21647 msgid ""
21648 " getcon\n"
21649 "\n"
21650 msgstr ""
21651
21652 #. type: textblock
21653 #: ../fish/guestfish-actions.pod:1425
21654 msgid "See the documentation about SELINUX in L<guestfs(3)>, and L</setcon>"
21655 msgstr ""
21656
21657 #. type: =head2
21658 #: ../fish/guestfish-actions.pod:1428
21659 msgid "getxattr"
21660 msgstr ""
21661
21662 #. type: verbatim
21663 #: ../fish/guestfish-actions.pod:1430
21664 #, no-wrap
21665 msgid ""
21666 " getxattr path name\n"
21667 "\n"
21668 msgstr ""
21669
21670 #. type: textblock
21671 #: ../fish/guestfish-actions.pod:1432
21672 msgid ""
21673 "Get a single extended attribute from file C<path> named C<name>.  This call "
21674 "follows symlinks.  If you want to lookup an extended attribute for the "
21675 "symlink itself, use L</lgetxattr>."
21676 msgstr ""
21677
21678 #. type: textblock
21679 #: ../fish/guestfish-actions.pod:1436 ../fish/guestfish-actions.pod:2289
21680 msgid ""
21681 "Normally it is better to get all extended attributes from a file in one go "
21682 "by calling L</getxattrs>.  However some Linux filesystem implementations are "
21683 "buggy and do not provide a way to list out attributes.  For these "
21684 "filesystems (notably ntfs-3g)  you have to know the names of the extended "
21685 "attributes you want in advance and call this function."
21686 msgstr ""
21687
21688 #. type: textblock
21689 #: ../fish/guestfish-actions.pod:1446
21690 msgid "See also: L</getxattrs>, L</lgetxattr>, L<attr(5)>."
21691 msgstr ""
21692
21693 #. type: =head2
21694 #: ../fish/guestfish-actions.pod:1448
21695 msgid "getxattrs"
21696 msgstr ""
21697
21698 #. type: verbatim
21699 #: ../fish/guestfish-actions.pod:1450
21700 #, no-wrap
21701 msgid ""
21702 " getxattrs path\n"
21703 "\n"
21704 msgstr ""
21705
21706 #. type: textblock
21707 #: ../fish/guestfish-actions.pod:1458
21708 msgid "See also: L</lgetxattrs>, L<attr(5)>."
21709 msgstr ""
21710
21711 #. type: =head2
21712 #: ../fish/guestfish-actions.pod:1460
21713 msgid "glob-expand"
21714 msgstr ""
21715
21716 #. type: verbatim
21717 #: ../fish/guestfish-actions.pod:1462
21718 #, no-wrap
21719 msgid ""
21720 " glob-expand pattern\n"
21721 "\n"
21722 msgstr ""
21723
21724 #. type: =head2
21725 #: ../fish/guestfish-actions.pod:1475
21726 msgid "grep"
21727 msgstr ""
21728
21729 #. type: verbatim
21730 #: ../fish/guestfish-actions.pod:1477
21731 #, no-wrap
21732 msgid ""
21733 " grep regex path\n"
21734 "\n"
21735 msgstr ""
21736
21737 #. type: =head2
21738 #: ../fish/guestfish-actions.pod:1485
21739 msgid "grepi"
21740 msgstr ""
21741
21742 #. type: verbatim
21743 #: ../fish/guestfish-actions.pod:1487
21744 #, no-wrap
21745 msgid ""
21746 " grepi regex path\n"
21747 "\n"
21748 msgstr ""
21749
21750 #. type: =head2
21751 #: ../fish/guestfish-actions.pod:1495
21752 msgid "grub-install"
21753 msgstr ""
21754
21755 #. type: verbatim
21756 #: ../fish/guestfish-actions.pod:1497
21757 #, no-wrap
21758 msgid ""
21759 " grub-install root device\n"
21760 "\n"
21761 msgstr ""
21762
21763 #. type: =head2
21764 #: ../fish/guestfish-actions.pod:1535
21765 msgid "head"
21766 msgstr ""
21767
21768 #. type: verbatim
21769 #: ../fish/guestfish-actions.pod:1537
21770 #, no-wrap
21771 msgid ""
21772 " head path\n"
21773 "\n"
21774 msgstr ""
21775
21776 #. type: =head2
21777 #: ../fish/guestfish-actions.pod:1545
21778 msgid "head-n"
21779 msgstr ""
21780
21781 #. type: verbatim
21782 #: ../fish/guestfish-actions.pod:1547
21783 #, no-wrap
21784 msgid ""
21785 " head-n nrlines path\n"
21786 "\n"
21787 msgstr ""
21788
21789 #. type: =head2
21790 #: ../fish/guestfish-actions.pod:1560
21791 msgid "hexdump"
21792 msgstr ""
21793
21794 #. type: verbatim
21795 #: ../fish/guestfish-actions.pod:1562
21796 #, no-wrap
21797 msgid ""
21798 " hexdump path\n"
21799 "\n"
21800 msgstr ""
21801
21802 #. type: =head2
21803 #: ../fish/guestfish-actions.pod:1570
21804 msgid "initrd-cat"
21805 msgstr ""
21806
21807 #. type: verbatim
21808 #: ../fish/guestfish-actions.pod:1572
21809 #, no-wrap
21810 msgid ""
21811 " initrd-cat initrdpath filename\n"
21812 "\n"
21813 msgstr ""
21814
21815 #. type: textblock
21816 #: ../fish/guestfish-actions.pod:1584
21817 msgid "See also L</initrd-list>."
21818 msgstr ""
21819
21820 #. type: =head2
21821 #: ../fish/guestfish-actions.pod:1589
21822 msgid "initrd-list"
21823 msgstr ""
21824
21825 #. type: verbatim
21826 #: ../fish/guestfish-actions.pod:1591
21827 #, no-wrap
21828 msgid ""
21829 " initrd-list path\n"
21830 "\n"
21831 msgstr ""
21832
21833 #. type: =head2
21834 #: ../fish/guestfish-actions.pod:1603
21835 msgid "inotify-add-watch"
21836 msgstr ""
21837
21838 #. type: verbatim
21839 #: ../fish/guestfish-actions.pod:1605
21840 #, no-wrap
21841 msgid ""
21842 " inotify-add-watch path mask\n"
21843 "\n"
21844 msgstr ""
21845
21846 #. type: =head2
21847 #: ../fish/guestfish-actions.pod:1617
21848 msgid "inotify-close"
21849 msgstr ""
21850
21851 #. type: verbatim
21852 #: ../fish/guestfish-actions.pod:1619
21853 #, no-wrap
21854 msgid ""
21855 " inotify-close\n"
21856 "\n"
21857 msgstr ""
21858
21859 #. type: =head2
21860 #: ../fish/guestfish-actions.pod:1625
21861 msgid "inotify-files"
21862 msgstr ""
21863
21864 #. type: verbatim
21865 #: ../fish/guestfish-actions.pod:1627
21866 #, no-wrap
21867 msgid ""
21868 " inotify-files\n"
21869 "\n"
21870 msgstr ""
21871
21872 #. type: textblock
21873 #: ../fish/guestfish-actions.pod:1629
21874 msgid ""
21875 "This function is a helpful wrapper around L</inotify-read> which just "
21876 "returns a list of pathnames of objects that were touched.  The returned "
21877 "pathnames are sorted and deduplicated."
21878 msgstr ""
21879
21880 #. type: =head2
21881 #: ../fish/guestfish-actions.pod:1633
21882 msgid "inotify-init"
21883 msgstr ""
21884
21885 #. type: verbatim
21886 #: ../fish/guestfish-actions.pod:1635
21887 #, no-wrap
21888 msgid ""
21889 " inotify-init maxevents\n"
21890 "\n"
21891 msgstr ""
21892
21893 #. type: textblock
21894 #: ../fish/guestfish-actions.pod:1641
21895 msgid ""
21896 "C<maxevents> is the maximum number of events which will be queued up between "
21897 "calls to L</inotify-read> or L</inotify-files>.  If this is passed as C<0>, "
21898 "then the kernel (or previously set)  default is used.  For Linux 2.6.29 the "
21899 "default was 16384 events.  Beyond this limit, the kernel throws away events, "
21900 "but records the fact that it threw them away by setting a flag "
21901 "C<IN_Q_OVERFLOW> in the returned structure list (see L</inotify-read>)."
21902 msgstr ""
21903
21904 #. type: textblock
21905 #: ../fish/guestfish-actions.pod:1651
21906 msgid ""
21907 "Before any events are generated, you have to add some watches to the "
21908 "internal watch list.  See: L</inotify-add-watch>, L</inotify-rm-watch> and "
21909 "L</inotify-watch-all>."
21910 msgstr ""
21911
21912 #. type: textblock
21913 #: ../fish/guestfish-actions.pod:1657
21914 msgid ""
21915 "Queued up events should be read periodically by calling L</inotify-read> (or "
21916 "L</inotify-files> which is just a helpful wrapper around L</inotify-read>).  "
21917 "If you don't read the events out often enough then you risk the internal "
21918 "queue overflowing."
21919 msgstr ""
21920
21921 #. type: textblock
21922 #: ../fish/guestfish-actions.pod:1664
21923 msgid ""
21924 "The handle should be closed after use by calling L</inotify-close>.  This "
21925 "also removes any watches automatically."
21926 msgstr ""
21927
21928 #. type: =head2
21929 #: ../fish/guestfish-actions.pod:1673
21930 msgid "inotify-read"
21931 msgstr ""
21932
21933 #. type: verbatim
21934 #: ../fish/guestfish-actions.pod:1675
21935 #, no-wrap
21936 msgid ""
21937 " inotify-read\n"
21938 "\n"
21939 msgstr ""
21940
21941 #. type: =head2
21942 #: ../fish/guestfish-actions.pod:1688
21943 msgid "inotify-rm-watch"
21944 msgstr ""
21945
21946 #. type: verbatim
21947 #: ../fish/guestfish-actions.pod:1690
21948 #, no-wrap
21949 msgid ""
21950 " inotify-rm-watch wd\n"
21951 "\n"
21952 msgstr ""
21953
21954 #. type: textblock
21955 #: ../fish/guestfish-actions.pod:1692
21956 msgid "Remove a previously defined inotify watch.  See L</inotify-add-watch>."
21957 msgstr ""
21958
21959 #. type: =head2
21960 #: ../fish/guestfish-actions.pod:1695
21961 msgid "inspect-get-arch"
21962 msgstr ""
21963
21964 #. type: verbatim
21965 #: ../fish/guestfish-actions.pod:1697
21966 #, no-wrap
21967 msgid ""
21968 " inspect-get-arch root\n"
21969 "\n"
21970 msgstr ""
21971
21972 #. type: textblock
21973 #: ../fish/guestfish-actions.pod:1699 ../fish/guestfish-actions.pod:1715 ../fish/guestfish-actions.pod:1789 ../fish/guestfish-actions.pod:1807 ../fish/guestfish-actions.pod:1822 ../fish/guestfish-actions.pod:1843 ../fish/guestfish-actions.pod:1858 ../fish/guestfish-actions.pod:1885 ../fish/guestfish-actions.pod:1907 ../fish/guestfish-actions.pod:1931 ../fish/guestfish-actions.pod:1961 ../fish/guestfish-actions.pod:1996 ../fish/guestfish-actions.pod:2012
21974 msgid ""
21975 "This function should only be called with a root device string as returned by "
21976 "L</inspect-os>."
21977 msgstr ""
21978
21979 #. type: textblock
21980 #: ../fish/guestfish-actions.pod:1702
21981 msgid ""
21982 "This returns the architecture of the inspected operating system.  The "
21983 "possible return values are listed under L</file-architecture>."
21984 msgstr ""
21985
21986 #. type: =head2
21987 #: ../fish/guestfish-actions.pod:1711
21988 msgid "inspect-get-distro"
21989 msgstr ""
21990
21991 #. type: verbatim
21992 #: ../fish/guestfish-actions.pod:1713
21993 #, no-wrap
21994 msgid ""
21995 " inspect-get-distro root\n"
21996 "\n"
21997 msgstr ""
21998
21999 #. type: =head2
22000 #: ../fish/guestfish-actions.pod:1785
22001 msgid "inspect-get-filesystems"
22002 msgstr ""
22003
22004 #. type: verbatim
22005 #: ../fish/guestfish-actions.pod:1787
22006 #, no-wrap
22007 msgid ""
22008 " inspect-get-filesystems root\n"
22009 "\n"
22010 msgstr ""
22011
22012 #. type: textblock
22013 #: ../fish/guestfish-actions.pod:1800
22014 msgid ""
22015 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
22016 "L</inspect-get-mountpoints>."
22017 msgstr ""
22018
22019 #. type: =head2
22020 #: ../fish/guestfish-actions.pod:1803
22021 msgid "inspect-get-hostname"
22022 msgstr ""
22023
22024 #. type: verbatim
22025 #: ../fish/guestfish-actions.pod:1805
22026 #, no-wrap
22027 msgid ""
22028 " inspect-get-hostname root\n"
22029 "\n"
22030 msgstr ""
22031
22032 #. type: =head2
22033 #: ../fish/guestfish-actions.pod:1818
22034 msgid "inspect-get-major-version"
22035 msgstr ""
22036
22037 #. type: verbatim
22038 #: ../fish/guestfish-actions.pod:1820
22039 #, no-wrap
22040 msgid ""
22041 " inspect-get-major-version root\n"
22042 "\n"
22043 msgstr ""
22044
22045 #. type: =head2
22046 #: ../fish/guestfish-actions.pod:1839
22047 msgid "inspect-get-minor-version"
22048 msgstr ""
22049
22050 #. type: verbatim
22051 #: ../fish/guestfish-actions.pod:1841
22052 #, no-wrap
22053 msgid ""
22054 " inspect-get-minor-version root\n"
22055 "\n"
22056 msgstr ""
22057
22058 #. type: textblock
22059 #: ../fish/guestfish-actions.pod:1851
22060 msgid ""
22061 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
22062 "L</inspect-get-major-version>."
22063 msgstr ""
22064
22065 #. type: =head2
22066 #: ../fish/guestfish-actions.pod:1854
22067 msgid "inspect-get-mountpoints"
22068 msgstr ""
22069
22070 #. type: verbatim
22071 #: ../fish/guestfish-actions.pod:1856
22072 #, no-wrap
22073 msgid ""
22074 " inspect-get-mountpoints root\n"
22075 "\n"
22076 msgstr ""
22077
22078 #. type: textblock
22079 #: ../fish/guestfish-actions.pod:1878
22080 msgid ""
22081 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
22082 "L</inspect-get-filesystems>."
22083 msgstr ""
22084
22085 #. type: =head2
22086 #: ../fish/guestfish-actions.pod:1881
22087 msgid "inspect-get-package-format"
22088 msgstr ""
22089
22090 #. type: verbatim
22091 #: ../fish/guestfish-actions.pod:1883
22092 #, no-wrap
22093 msgid ""
22094 " inspect-get-package-format root\n"
22095 "\n"
22096 msgstr ""
22097
22098 #. type: textblock
22099 #: ../fish/guestfish-actions.pod:1888
22100 msgid ""
22101 "This function and L</inspect-get-package-management> return the package "
22102 "format and package management tool used by the inspected operating system.  "
22103 "For example for Fedora these functions would return C<rpm> (package format) "
22104 "and C<yum> (package management)."
22105 msgstr ""
22106
22107 #. type: =head2
22108 #: ../fish/guestfish-actions.pod:1903
22109 msgid "inspect-get-package-management"
22110 msgstr ""
22111
22112 #. type: verbatim
22113 #: ../fish/guestfish-actions.pod:1905
22114 #, no-wrap
22115 msgid ""
22116 " inspect-get-package-management root\n"
22117 "\n"
22118 msgstr ""
22119
22120 #. type: textblock
22121 #: ../fish/guestfish-actions.pod:1910
22122 msgid ""
22123 "L</inspect-get-package-format> and this function return the package format "
22124 "and package management tool used by the inspected operating system.  For "
22125 "example for Fedora these functions would return C<rpm> (package format) and "
22126 "C<yum> (package management)."
22127 msgstr ""
22128
22129 #. type: =head2
22130 #: ../fish/guestfish-actions.pod:1927
22131 msgid "inspect-get-product-name"
22132 msgstr ""
22133
22134 #. type: verbatim
22135 #: ../fish/guestfish-actions.pod:1929
22136 #, no-wrap
22137 msgid ""
22138 " inspect-get-product-name root\n"
22139 "\n"
22140 msgstr ""
22141
22142 #. type: =head2
22143 #: ../fish/guestfish-actions.pod:1944
22144 msgid "inspect-get-roots"
22145 msgstr ""
22146
22147 #. type: verbatim
22148 #: ../fish/guestfish-actions.pod:1946
22149 #, no-wrap
22150 msgid ""
22151 " inspect-get-roots\n"
22152 "\n"
22153 msgstr ""
22154
22155 #. type: textblock
22156 #: ../fish/guestfish-actions.pod:1948
22157 msgid ""
22158 "This function is a convenient way to get the list of root devices, as "
22159 "returned from a previous call to L</inspect-os>, but without redoing the "
22160 "whole inspection process."
22161 msgstr ""
22162
22163 #. type: textblock
22164 #: ../fish/guestfish-actions.pod:1952
22165 msgid ""
22166 "This returns an empty list if either no root devices were found or the "
22167 "caller has not called L</inspect-os>."
22168 msgstr ""
22169
22170 #. type: =head2
22171 #: ../fish/guestfish-actions.pod:1957
22172 msgid "inspect-get-type"
22173 msgstr ""
22174
22175 #. type: verbatim
22176 #: ../fish/guestfish-actions.pod:1959
22177 #, no-wrap
22178 msgid ""
22179 " inspect-get-type root\n"
22180 "\n"
22181 msgstr ""
22182
22183 #. type: =head2
22184 #: ../fish/guestfish-actions.pod:1992
22185 msgid "inspect-get-windows-systemroot"
22186 msgstr ""
22187
22188 #. type: verbatim
22189 #: ../fish/guestfish-actions.pod:1994
22190 #, no-wrap
22191 msgid ""
22192 " inspect-get-windows-systemroot root\n"
22193 "\n"
22194 msgstr ""
22195
22196 #. type: =head2
22197 #: ../fish/guestfish-actions.pod:2008
22198 msgid "inspect-list-applications"
22199 msgstr ""
22200
22201 #. type: verbatim
22202 #: ../fish/guestfish-actions.pod:2010
22203 #, no-wrap
22204 msgid ""
22205 " inspect-list-applications root\n"
22206 "\n"
22207 msgstr ""
22208
22209 #. type: textblock
22210 #: ../fish/guestfish-actions.pod:2017
22211 msgid ""
22212 "I<Note:> This call works differently from other parts of the inspection "
22213 "API.  You have to call L</inspect-os>, then L</inspect-get-mountpoints>, "
22214 "then mount up the disks, before calling this.  Listing applications is a "
22215 "significantly more difficult operation which requires access to the full "
22216 "filesystem.  Also note that unlike the other L</inspect-get-*> calls which "
22217 "are just returning data cached in the libguestfs handle, this call actually "
22218 "reads parts of the mounted filesystems during the call."
22219 msgstr ""
22220
22221 #. type: =head2
22222 #: ../fish/guestfish-actions.pod:2107
22223 msgid "inspect-os"
22224 msgstr ""
22225
22226 #. type: verbatim
22227 #: ../fish/guestfish-actions.pod:2109
22228 #, no-wrap
22229 msgid ""
22230 " inspect-os\n"
22231 "\n"
22232 msgstr ""
22233
22234 #. type: textblock
22235 #: ../fish/guestfish-actions.pod:2124
22236 msgid ""
22237 "You can pass the root string(s) returned to other L</inspect-get-*> "
22238 "functions in order to query further information about each operating system, "
22239 "such as the name and version."
22240 msgstr ""
22241
22242 #. type: textblock
22243 #: ../fish/guestfish-actions.pod:2129
22244 msgid ""
22245 "This function uses other libguestfs features such as L</mount-ro> and "
22246 "L</umount-all> in order to mount and unmount filesystems and look at the "
22247 "contents.  This should be called with no disks currently mounted.  The "
22248 "function may also use Augeas, so any existing Augeas handle will be closed."
22249 msgstr ""
22250
22251 #. type: textblock
22252 #: ../fish/guestfish-actions.pod:2141 ../fish/guestfish-actions.pod:2317 ../fish/guestfish-actions.pod:2363
22253 msgid "See also L</list-filesystems>."
22254 msgstr ""
22255
22256 #. type: =head2
22257 #: ../fish/guestfish-actions.pod:2143
22258 msgid "is-blockdev"
22259 msgstr ""
22260
22261 #. type: verbatim
22262 #: ../fish/guestfish-actions.pod:2145
22263 #, no-wrap
22264 msgid ""
22265 " is-blockdev path\n"
22266 "\n"
22267 msgstr ""
22268
22269 #. type: textblock
22270 #: ../fish/guestfish-actions.pod:2150 ../fish/guestfish-actions.pod:2168 ../fish/guestfish-actions.pod:2187 ../fish/guestfish-actions.pod:2196 ../fish/guestfish-actions.pod:2206 ../fish/guestfish-actions.pod:2240 ../fish/guestfish-actions.pod:2249
22271 msgid "See also L</stat>."
22272 msgstr ""
22273
22274 #. type: =head2
22275 #: ../fish/guestfish-actions.pod:2152
22276 msgid "is-busy"
22277 msgstr ""
22278
22279 #. type: verbatim
22280 #: ../fish/guestfish-actions.pod:2154
22281 #, no-wrap
22282 msgid ""
22283 " is-busy\n"
22284 "\n"
22285 msgstr ""
22286
22287 #. type: =head2
22288 #: ../fish/guestfish-actions.pod:2161
22289 msgid "is-chardev"
22290 msgstr ""
22291
22292 #. type: verbatim
22293 #: ../fish/guestfish-actions.pod:2163
22294 #, no-wrap
22295 msgid ""
22296 " is-chardev path\n"
22297 "\n"
22298 msgstr ""
22299
22300 #. type: =head2
22301 #: ../fish/guestfish-actions.pod:2170
22302 msgid "is-config"
22303 msgstr ""
22304
22305 #. type: verbatim
22306 #: ../fish/guestfish-actions.pod:2172
22307 #, no-wrap
22308 msgid ""
22309 " is-config\n"
22310 "\n"
22311 msgstr ""
22312
22313 #. type: =head2
22314 #: ../fish/guestfish-actions.pod:2179
22315 msgid "is-dir"
22316 msgstr ""
22317
22318 #. type: verbatim
22319 #: ../fish/guestfish-actions.pod:2181
22320 #, no-wrap
22321 msgid ""
22322 " is-dir path\n"
22323 "\n"
22324 msgstr ""
22325
22326 #. type: =head2
22327 #: ../fish/guestfish-actions.pod:2189
22328 msgid "is-fifo"
22329 msgstr ""
22330
22331 #. type: verbatim
22332 #: ../fish/guestfish-actions.pod:2191
22333 #, no-wrap
22334 msgid ""
22335 " is-fifo path\n"
22336 "\n"
22337 msgstr ""
22338
22339 #. type: =head2
22340 #: ../fish/guestfish-actions.pod:2198
22341 msgid "is-file"
22342 msgstr ""
22343
22344 #. type: verbatim
22345 #: ../fish/guestfish-actions.pod:2200
22346 #, no-wrap
22347 msgid ""
22348 " is-file path\n"
22349 "\n"
22350 msgstr ""
22351
22352 #. type: =head2
22353 #: ../fish/guestfish-actions.pod:2208
22354 msgid "is-launching"
22355 msgstr ""
22356
22357 #. type: verbatim
22358 #: ../fish/guestfish-actions.pod:2210
22359 #, no-wrap
22360 msgid ""
22361 " is-launching\n"
22362 "\n"
22363 msgstr ""
22364
22365 #. type: =head2
22366 #: ../fish/guestfish-actions.pod:2217
22367 msgid "is-lv"
22368 msgstr ""
22369
22370 #. type: verbatim
22371 #: ../fish/guestfish-actions.pod:2219
22372 #, no-wrap
22373 msgid ""
22374 " is-lv device\n"
22375 "\n"
22376 msgstr ""
22377
22378 #. type: =head2
22379 #: ../fish/guestfish-actions.pod:2224
22380 msgid "is-ready"
22381 msgstr ""
22382
22383 #. type: verbatim
22384 #: ../fish/guestfish-actions.pod:2226
22385 #, no-wrap
22386 msgid ""
22387 " is-ready\n"
22388 "\n"
22389 msgstr ""
22390
22391 #. type: =head2
22392 #: ../fish/guestfish-actions.pod:2233
22393 msgid "is-socket"
22394 msgstr ""
22395
22396 #. type: verbatim
22397 #: ../fish/guestfish-actions.pod:2235
22398 #, no-wrap
22399 msgid ""
22400 " is-socket path\n"
22401 "\n"
22402 msgstr ""
22403
22404 #. type: =head2
22405 #: ../fish/guestfish-actions.pod:2242
22406 msgid "is-symlink"
22407 msgstr ""
22408
22409 #. type: verbatim
22410 #: ../fish/guestfish-actions.pod:2244
22411 #, no-wrap
22412 msgid ""
22413 " is-symlink path\n"
22414 "\n"
22415 msgstr ""
22416
22417 #. type: =head2
22418 #: ../fish/guestfish-actions.pod:2251
22419 msgid "kill-subprocess"
22420 msgstr ""
22421
22422 #. type: verbatim
22423 #: ../fish/guestfish-actions.pod:2253
22424 #, no-wrap
22425 msgid ""
22426 " kill-subprocess\n"
22427 "\n"
22428 msgstr ""
22429
22430 #. type: =head2
22431 #: ../fish/guestfish-actions.pod:2257
22432 msgid "launch"
22433 msgstr ""
22434
22435 #. type: =head2
22436 #: ../fish/guestfish-actions.pod:2259
22437 msgid "run"
22438 msgstr ""
22439
22440 #. type: verbatim
22441 #: ../fish/guestfish-actions.pod:2261
22442 #, no-wrap
22443 msgid ""
22444 " launch\n"
22445 "\n"
22446 msgstr ""
22447
22448 #. type: =head2
22449 #: ../fish/guestfish-actions.pod:2269
22450 msgid "lchown"
22451 msgstr ""
22452
22453 #. type: verbatim
22454 #: ../fish/guestfish-actions.pod:2271
22455 #, no-wrap
22456 msgid ""
22457 " lchown owner group path\n"
22458 "\n"
22459 msgstr ""
22460
22461 #. type: textblock
22462 #: ../fish/guestfish-actions.pod:2273
22463 msgid ""
22464 "Change the file owner to C<owner> and group to C<group>.  This is like "
22465 "L</chown> but if C<path> is a symlink then the link itself is changed, not "
22466 "the target."
22467 msgstr ""
22468
22469 #. type: =head2
22470 #: ../fish/guestfish-actions.pod:2281
22471 msgid "lgetxattr"
22472 msgstr ""
22473
22474 #. type: verbatim
22475 #: ../fish/guestfish-actions.pod:2283
22476 #, no-wrap
22477 msgid ""
22478 " lgetxattr path name\n"
22479 "\n"
22480 msgstr ""
22481
22482 #. type: textblock
22483 #: ../fish/guestfish-actions.pod:2299
22484 msgid "See also: L</lgetxattrs>, L</getxattr>, L<attr(5)>."
22485 msgstr ""
22486
22487 #. type: =head2
22488 #: ../fish/guestfish-actions.pod:2301
22489 msgid "lgetxattrs"
22490 msgstr ""
22491
22492 #. type: verbatim
22493 #: ../fish/guestfish-actions.pod:2303
22494 #, no-wrap
22495 msgid ""
22496 " lgetxattrs path\n"
22497 "\n"
22498 msgstr ""
22499
22500 #. type: textblock
22501 #: ../fish/guestfish-actions.pod:2305
22502 msgid ""
22503 "This is the same as L</getxattrs>, but if C<path> is a symbolic link, then "
22504 "it returns the extended attributes of the link itself."
22505 msgstr ""
22506
22507 #. type: =head2
22508 #: ../fish/guestfish-actions.pod:2309
22509 msgid "list-devices"
22510 msgstr ""
22511
22512 #. type: verbatim
22513 #: ../fish/guestfish-actions.pod:2311
22514 #, no-wrap
22515 msgid ""
22516 " list-devices\n"
22517 "\n"
22518 msgstr ""
22519
22520 #. type: =head2
22521 #: ../fish/guestfish-actions.pod:2319
22522 msgid "list-filesystems"
22523 msgstr ""
22524
22525 #. type: verbatim
22526 #: ../fish/guestfish-actions.pod:2321
22527 #, no-wrap
22528 msgid ""
22529 " list-filesystems\n"
22530 "\n"
22531 msgstr ""
22532
22533 #. type: textblock
22534 #: ../fish/guestfish-actions.pod:2340
22535 msgid ""
22536 "This command runs other libguestfs commands, which might include L</mount> "
22537 "and L</umount>, and therefore you should use this soon after launch and only "
22538 "when nothing is mounted."
22539 msgstr ""
22540
22541 #. type: textblock
22542 #: ../fish/guestfish-actions.pod:2344
22543 msgid ""
22544 "Not all of the filesystems returned will be mountable.  In particular, swap "
22545 "partitions are returned in the list.  Also this command does not check that "
22546 "each filesystem found is valid and mountable, and some filesystems might be "
22547 "mountable but require special options.  Filesystems may not all belong to a "
22548 "single logical operating system (use L</inspect-os> to look for OSes)."
22549 msgstr ""
22550
22551 #. type: =head2
22552 #: ../fish/guestfish-actions.pod:2352
22553 msgid "list-partitions"
22554 msgstr ""
22555
22556 #. type: verbatim
22557 #: ../fish/guestfish-actions.pod:2354
22558 #, no-wrap
22559 msgid ""
22560 " list-partitions\n"
22561 "\n"
22562 msgstr ""
22563
22564 #. type: textblock
22565 #: ../fish/guestfish-actions.pod:2360
22566 msgid ""
22567 "This does not return logical volumes.  For that you will need to call "
22568 "L</lvs>."
22569 msgstr ""
22570
22571 #. type: =head2
22572 #: ../fish/guestfish-actions.pod:2365
22573 msgid "ll"
22574 msgstr ""
22575
22576 #. type: verbatim
22577 #: ../fish/guestfish-actions.pod:2367
22578 #, no-wrap
22579 msgid ""
22580 " ll directory\n"
22581 "\n"
22582 msgstr ""
22583
22584 #. type: =head2
22585 #: ../fish/guestfish-actions.pod:2375
22586 msgid "ln"
22587 msgstr ""
22588
22589 #. type: verbatim
22590 #: ../fish/guestfish-actions.pod:2377
22591 #, no-wrap
22592 msgid ""
22593 " ln target linkname\n"
22594 "\n"
22595 msgstr ""
22596
22597 #. type: =head2
22598 #: ../fish/guestfish-actions.pod:2381
22599 msgid "ln-f"
22600 msgstr ""
22601
22602 #. type: verbatim
22603 #: ../fish/guestfish-actions.pod:2383
22604 #, no-wrap
22605 msgid ""
22606 " ln-f target linkname\n"
22607 "\n"
22608 msgstr ""
22609
22610 #. type: =head2
22611 #: ../fish/guestfish-actions.pod:2388
22612 msgid "ln-s"
22613 msgstr ""
22614
22615 #. type: verbatim
22616 #: ../fish/guestfish-actions.pod:2390
22617 #, no-wrap
22618 msgid ""
22619 " ln-s target linkname\n"
22620 "\n"
22621 msgstr ""
22622
22623 #. type: =head2
22624 #: ../fish/guestfish-actions.pod:2394
22625 msgid "ln-sf"
22626 msgstr ""
22627
22628 #. type: verbatim
22629 #: ../fish/guestfish-actions.pod:2396
22630 #, no-wrap
22631 msgid ""
22632 " ln-sf target linkname\n"
22633 "\n"
22634 msgstr ""
22635
22636 #. type: =head2
22637 #: ../fish/guestfish-actions.pod:2401
22638 msgid "lremovexattr"
22639 msgstr ""
22640
22641 #. type: verbatim
22642 #: ../fish/guestfish-actions.pod:2403
22643 #, no-wrap
22644 msgid ""
22645 " lremovexattr xattr path\n"
22646 "\n"
22647 msgstr ""
22648
22649 #. type: textblock
22650 #: ../fish/guestfish-actions.pod:2405
22651 msgid ""
22652 "This is the same as L</removexattr>, but if C<path> is a symbolic link, then "
22653 "it removes an extended attribute of the link itself."
22654 msgstr ""
22655
22656 #. type: =head2
22657 #: ../fish/guestfish-actions.pod:2409
22658 msgid "ls"
22659 msgstr ""
22660
22661 #. type: verbatim
22662 #: ../fish/guestfish-actions.pod:2411
22663 #, no-wrap
22664 msgid ""
22665 " ls directory\n"
22666 "\n"
22667 msgstr ""
22668
22669 #. type: textblock
22670 #: ../fish/guestfish-actions.pod:2417
22671 msgid ""
22672 "This command is mostly useful for interactive sessions.  Programs should "
22673 "probably use L</readdir> instead."
22674 msgstr ""
22675
22676 #. type: =head2
22677 #: ../fish/guestfish-actions.pod:2420
22678 msgid "lsetxattr"
22679 msgstr ""
22680
22681 #. type: verbatim
22682 #: ../fish/guestfish-actions.pod:2422
22683 #, no-wrap
22684 msgid ""
22685 " lsetxattr xattr val vallen path\n"
22686 "\n"
22687 msgstr ""
22688
22689 #. type: textblock
22690 #: ../fish/guestfish-actions.pod:2424
22691 msgid ""
22692 "This is the same as L</setxattr>, but if C<path> is a symbolic link, then it "
22693 "sets an extended attribute of the link itself."
22694 msgstr ""
22695
22696 #. type: =head2
22697 #: ../fish/guestfish-actions.pod:2428
22698 msgid "lstat"
22699 msgstr ""
22700
22701 #. type: verbatim
22702 #: ../fish/guestfish-actions.pod:2430
22703 #, no-wrap
22704 msgid ""
22705 " lstat path\n"
22706 "\n"
22707 msgstr ""
22708
22709 #. type: textblock
22710 #: ../fish/guestfish-actions.pod:2434
22711 msgid ""
22712 "This is the same as L</stat> except that if C<path> is a symbolic link, then "
22713 "the link is stat-ed, not the file it refers to."
22714 msgstr ""
22715
22716 #. type: =head2
22717 #: ../fish/guestfish-actions.pod:2440
22718 msgid "lstatlist"
22719 msgstr ""
22720
22721 #. type: verbatim
22722 #: ../fish/guestfish-actions.pod:2442
22723 #, no-wrap
22724 msgid ""
22725 " lstatlist path 'names ...'\n"
22726 "\n"
22727 msgstr ""
22728
22729 #. type: textblock
22730 #: ../fish/guestfish-actions.pod:2444
22731 msgid ""
22732 "This call allows you to perform the L</lstat> operation on multiple files, "
22733 "where all files are in the directory C<path>.  C<names> is the list of files "
22734 "from this directory."
22735 msgstr ""
22736
22737 #. type: textblock
22738 #: ../fish/guestfish-actions.pod:2453
22739 msgid ""
22740 "This call is intended for programs that want to efficiently list a directory "
22741 "contents without making many round-trips.  See also L</lxattrlist> for a "
22742 "similarly efficient call for getting extended attributes.  Very long "
22743 "directory listings might cause the protocol message size to be exceeded, "
22744 "causing this call to fail.  The caller must split up such requests into "
22745 "smaller groups of names."
22746 msgstr ""
22747
22748 #. type: =head2
22749 #: ../fish/guestfish-actions.pod:2461
22750 msgid "luks-add-key"
22751 msgstr ""
22752
22753 #. type: verbatim
22754 #: ../fish/guestfish-actions.pod:2463
22755 #, no-wrap
22756 msgid ""
22757 " luks-add-key device keyslot\n"
22758 "\n"
22759 msgstr ""
22760
22761 #. type: textblock
22762 #: ../fish/guestfish-actions.pod:2470
22763 msgid ""
22764 "Note that if C<keyslot> already contains a key, then this command will "
22765 "fail.  You have to use L</luks-kill-slot> first to remove that key."
22766 msgstr ""
22767
22768 #. type: textblock
22769 #: ../fish/guestfish-actions.pod:2474 ../fish/guestfish-actions.pod:2496 ../fish/guestfish-actions.pod:2509 ../fish/guestfish-actions.pod:2523 ../fish/guestfish-actions.pod:2546 ../fish/guestfish-actions.pod:2556
22770 msgid ""
22771 "This command has one or more key or passphrase parameters.  Guestfish will "
22772 "prompt for these separately."
22773 msgstr ""
22774
22775 #. type: =head2
22776 #: ../fish/guestfish-actions.pod:2477
22777 msgid "luks-close"
22778 msgstr ""
22779
22780 #. type: verbatim
22781 #: ../fish/guestfish-actions.pod:2479
22782 #, no-wrap
22783 msgid ""
22784 " luks-close device\n"
22785 "\n"
22786 msgstr ""
22787
22788 #. type: textblock
22789 #: ../fish/guestfish-actions.pod:2481
22790 msgid ""
22791 "This closes a LUKS device that was created earlier by L</luks-open> or "
22792 "L</luks-open-ro>.  The C<device> parameter must be the name of the LUKS "
22793 "mapping device (ie. C</dev/mapper/mapname>) and I<not> the name of the "
22794 "underlying block device."
22795 msgstr ""
22796
22797 #. type: =head2
22798 #: ../fish/guestfish-actions.pod:2487
22799 msgid "luks-format"
22800 msgstr ""
22801
22802 #. type: verbatim
22803 #: ../fish/guestfish-actions.pod:2489
22804 #, no-wrap
22805 msgid ""
22806 " luks-format device keyslot\n"
22807 "\n"
22808 msgstr ""
22809
22810 #. type: =head2
22811 #: ../fish/guestfish-actions.pod:2502
22812 msgid "luks-format-cipher"
22813 msgstr ""
22814
22815 #. type: verbatim
22816 #: ../fish/guestfish-actions.pod:2504
22817 #, no-wrap
22818 msgid ""
22819 " luks-format-cipher device keyslot cipher\n"
22820 "\n"
22821 msgstr ""
22822
22823 #. type: textblock
22824 #: ../fish/guestfish-actions.pod:2506
22825 msgid ""
22826 "This command is the same as L</luks-format> but it also allows you to set "
22827 "the C<cipher> used."
22828 msgstr ""
22829
22830 #. type: =head2
22831 #: ../fish/guestfish-actions.pod:2515
22832 msgid "luks-kill-slot"
22833 msgstr ""
22834
22835 #. type: verbatim
22836 #: ../fish/guestfish-actions.pod:2517
22837 #, no-wrap
22838 msgid ""
22839 " luks-kill-slot device keyslot\n"
22840 "\n"
22841 msgstr ""
22842
22843 #. type: =head2
22844 #: ../fish/guestfish-actions.pod:2526
22845 msgid "luks-open"
22846 msgstr ""
22847
22848 #. type: verbatim
22849 #: ../fish/guestfish-actions.pod:2528
22850 #, no-wrap
22851 msgid ""
22852 " luks-open device mapname\n"
22853 "\n"
22854 msgstr ""
22855
22856 #. type: textblock
22857 #: ../fish/guestfish-actions.pod:2542
22858 msgid ""
22859 "If this block device contains LVM volume groups, then calling L</vgscan> "
22860 "followed by L</vg-activate-all> will make them visible."
22861 msgstr ""
22862
22863 #. type: =head2
22864 #: ../fish/guestfish-actions.pod:2549
22865 msgid "luks-open-ro"
22866 msgstr ""
22867
22868 #. type: verbatim
22869 #: ../fish/guestfish-actions.pod:2551
22870 #, no-wrap
22871 msgid ""
22872 " luks-open-ro device mapname\n"
22873 "\n"
22874 msgstr ""
22875
22876 #. type: textblock
22877 #: ../fish/guestfish-actions.pod:2553
22878 msgid ""
22879 "This is the same as L</luks-open> except that a read-only mapping is "
22880 "created."
22881 msgstr ""
22882
22883 #. type: =head2
22884 #: ../fish/guestfish-actions.pod:2559
22885 msgid "lvcreate"
22886 msgstr ""
22887
22888 #. type: verbatim
22889 #: ../fish/guestfish-actions.pod:2561
22890 #, no-wrap
22891 msgid ""
22892 " lvcreate logvol volgroup mbytes\n"
22893 "\n"
22894 msgstr ""
22895
22896 #. type: =head2
22897 #: ../fish/guestfish-actions.pod:2566
22898 msgid "lvm-canonical-lv-name"
22899 msgstr ""
22900
22901 #. type: verbatim
22902 #: ../fish/guestfish-actions.pod:2568
22903 #, no-wrap
22904 msgid ""
22905 " lvm-canonical-lv-name lvname\n"
22906 "\n"
22907 msgstr ""
22908
22909 #. type: textblock
22910 #: ../fish/guestfish-actions.pod:2577
22911 msgid "See also L</is-lv>."
22912 msgstr ""
22913
22914 #. type: =head2
22915 #: ../fish/guestfish-actions.pod:2579
22916 msgid "lvm-clear-filter"
22917 msgstr ""
22918
22919 #. type: verbatim
22920 #: ../fish/guestfish-actions.pod:2581
22921 #, no-wrap
22922 msgid ""
22923 " lvm-clear-filter\n"
22924 "\n"
22925 msgstr ""
22926
22927 #. type: textblock
22928 #: ../fish/guestfish-actions.pod:2583
22929 msgid ""
22930 "This undoes the effect of L</lvm-set-filter>.  LVM will be able to see every "
22931 "block device."
22932 msgstr ""
22933
22934 #. type: =head2
22935 #: ../fish/guestfish-actions.pod:2589
22936 msgid "lvm-remove-all"
22937 msgstr ""
22938
22939 #. type: verbatim
22940 #: ../fish/guestfish-actions.pod:2591
22941 #, no-wrap
22942 msgid ""
22943 " lvm-remove-all\n"
22944 "\n"
22945 msgstr ""
22946
22947 #. type: =head2
22948 #: ../fish/guestfish-actions.pod:2599
22949 msgid "lvm-set-filter"
22950 msgstr ""
22951
22952 #. type: verbatim
22953 #: ../fish/guestfish-actions.pod:2601
22954 #, no-wrap
22955 msgid ""
22956 " lvm-set-filter 'devices ...'\n"
22957 "\n"
22958 msgstr ""
22959
22960 #. type: =head2
22961 #: ../fish/guestfish-actions.pod:2626
22962 msgid "lvremove"
22963 msgstr ""
22964
22965 #. type: verbatim
22966 #: ../fish/guestfish-actions.pod:2628
22967 #, no-wrap
22968 msgid ""
22969 " lvremove device\n"
22970 "\n"
22971 msgstr ""
22972
22973 #. type: =head2
22974 #: ../fish/guestfish-actions.pod:2636
22975 msgid "lvrename"
22976 msgstr ""
22977
22978 #. type: verbatim
22979 #: ../fish/guestfish-actions.pod:2638
22980 #, no-wrap
22981 msgid ""
22982 " lvrename logvol newlogvol\n"
22983 "\n"
22984 msgstr ""
22985
22986 #. type: =head2
22987 #: ../fish/guestfish-actions.pod:2642
22988 msgid "lvresize"
22989 msgstr ""
22990
22991 #. type: verbatim
22992 #: ../fish/guestfish-actions.pod:2644
22993 #, no-wrap
22994 msgid ""
22995 " lvresize device mbytes\n"
22996 "\n"
22997 msgstr ""
22998
22999 #. type: =head2
23000 #: ../fish/guestfish-actions.pod:2650
23001 msgid "lvresize-free"
23002 msgstr ""
23003
23004 #. type: verbatim
23005 #: ../fish/guestfish-actions.pod:2652
23006 #, no-wrap
23007 msgid ""
23008 " lvresize-free lv percent\n"
23009 "\n"
23010 msgstr ""
23011
23012 #. type: =head2
23013 #: ../fish/guestfish-actions.pod:2660
23014 msgid "lvs"
23015 msgstr ""
23016
23017 #. type: verbatim
23018 #: ../fish/guestfish-actions.pod:2662
23019 #, no-wrap
23020 msgid ""
23021 " lvs\n"
23022 "\n"
23023 msgstr ""
23024
23025 #. type: textblock
23026 #: ../fish/guestfish-actions.pod:2670
23027 msgid "See also L</lvs-full>, L</list-filesystems>."
23028 msgstr ""
23029
23030 #. type: =head2
23031 #: ../fish/guestfish-actions.pod:2672
23032 msgid "lvs-full"
23033 msgstr ""
23034
23035 #. type: verbatim
23036 #: ../fish/guestfish-actions.pod:2674
23037 #, no-wrap
23038 msgid ""
23039 " lvs-full\n"
23040 "\n"
23041 msgstr ""
23042
23043 #. type: =head2
23044 #: ../fish/guestfish-actions.pod:2679
23045 msgid "lvuuid"
23046 msgstr ""
23047
23048 #. type: verbatim
23049 #: ../fish/guestfish-actions.pod:2681
23050 #, no-wrap
23051 msgid ""
23052 " lvuuid device\n"
23053 "\n"
23054 msgstr ""
23055
23056 #. type: =head2
23057 #: ../fish/guestfish-actions.pod:2685
23058 msgid "lxattrlist"
23059 msgstr ""
23060
23061 #. type: verbatim
23062 #: ../fish/guestfish-actions.pod:2687
23063 #, no-wrap
23064 msgid ""
23065 " lxattrlist path 'names ...'\n"
23066 "\n"
23067 msgstr ""
23068
23069 #. type: textblock
23070 #: ../fish/guestfish-actions.pod:2703
23071 msgid ""
23072 "This call is intended for programs that want to efficiently list a directory "
23073 "contents without making many round-trips.  See also L</lstatlist> for a "
23074 "similarly efficient call for getting standard stats.  Very long directory "
23075 "listings might cause the protocol message size to be exceeded, causing this "
23076 "call to fail.  The caller must split up such requests into smaller groups of "
23077 "names."
23078 msgstr ""
23079
23080 #. type: =head2
23081 #: ../fish/guestfish-actions.pod:2711
23082 msgid "mkdir"
23083 msgstr ""
23084
23085 #. type: verbatim
23086 #: ../fish/guestfish-actions.pod:2713
23087 #, no-wrap
23088 msgid ""
23089 " mkdir path\n"
23090 "\n"
23091 msgstr ""
23092
23093 #. type: =head2
23094 #: ../fish/guestfish-actions.pod:2717
23095 msgid "mkdir-mode"
23096 msgstr ""
23097
23098 #. type: verbatim
23099 #: ../fish/guestfish-actions.pod:2719
23100 #, no-wrap
23101 msgid ""
23102 " mkdir-mode path mode\n"
23103 "\n"
23104 msgstr ""
23105
23106 #. type: textblock
23107 #: ../fish/guestfish-actions.pod:2728
23108 msgid "See also L</mkdir>, L</umask>"
23109 msgstr ""
23110
23111 #. type: =head2
23112 #: ../fish/guestfish-actions.pod:2730
23113 msgid "mkdir-p"
23114 msgstr ""
23115
23116 #. type: verbatim
23117 #: ../fish/guestfish-actions.pod:2732
23118 #, no-wrap
23119 msgid ""
23120 " mkdir-p path\n"
23121 "\n"
23122 msgstr ""
23123
23124 #. type: =head2
23125 #: ../fish/guestfish-actions.pod:2737
23126 msgid "mkdtemp"
23127 msgstr ""
23128
23129 #. type: verbatim
23130 #: ../fish/guestfish-actions.pod:2739
23131 #, no-wrap
23132 msgid ""
23133 " mkdtemp template\n"
23134 "\n"
23135 msgstr ""
23136
23137 #. type: =head2
23138 #: ../fish/guestfish-actions.pod:2760
23139 msgid "mke2fs-J"
23140 msgstr ""
23141
23142 #. type: verbatim
23143 #: ../fish/guestfish-actions.pod:2762
23144 #, no-wrap
23145 msgid ""
23146 " mke2fs-J fstype blocksize device journal\n"
23147 "\n"
23148 msgstr ""
23149
23150 #. type: textblock
23151 #: ../fish/guestfish-actions.pod:2770
23152 msgid "See also L</mke2journal>."
23153 msgstr ""
23154
23155 #. type: =head2
23156 #: ../fish/guestfish-actions.pod:2772
23157 msgid "mke2fs-JL"
23158 msgstr ""
23159
23160 #. type: verbatim
23161 #: ../fish/guestfish-actions.pod:2774
23162 #, no-wrap
23163 msgid ""
23164 " mke2fs-JL fstype blocksize device label\n"
23165 "\n"
23166 msgstr ""
23167
23168 #. type: textblock
23169 #: ../fish/guestfish-actions.pod:2779
23170 msgid "See also L</mke2journal-L>."
23171 msgstr ""
23172
23173 #. type: =head2
23174 #: ../fish/guestfish-actions.pod:2781
23175 msgid "mke2fs-JU"
23176 msgstr ""
23177
23178 #. type: verbatim
23179 #: ../fish/guestfish-actions.pod:2783
23180 #, no-wrap
23181 msgid ""
23182 " mke2fs-JU fstype blocksize device uuid\n"
23183 "\n"
23184 msgstr ""
23185
23186 #. type: textblock
23187 #: ../fish/guestfish-actions.pod:2788
23188 msgid "See also L</mke2journal-U>."
23189 msgstr ""
23190
23191 #. type: =head2
23192 #: ../fish/guestfish-actions.pod:2790
23193 msgid "mke2journal"
23194 msgstr ""
23195
23196 #. type: verbatim
23197 #: ../fish/guestfish-actions.pod:2792
23198 #, no-wrap
23199 msgid ""
23200 " mke2journal blocksize device\n"
23201 "\n"
23202 msgstr ""
23203
23204 #. type: =head2
23205 #: ../fish/guestfish-actions.pod:2799
23206 msgid "mke2journal-L"
23207 msgstr ""
23208
23209 #. type: verbatim
23210 #: ../fish/guestfish-actions.pod:2801
23211 #, no-wrap
23212 msgid ""
23213 " mke2journal-L blocksize label device\n"
23214 "\n"
23215 msgstr ""
23216
23217 #. type: =head2
23218 #: ../fish/guestfish-actions.pod:2805
23219 msgid "mke2journal-U"
23220 msgstr ""
23221
23222 #. type: verbatim
23223 #: ../fish/guestfish-actions.pod:2807
23224 #, no-wrap
23225 msgid ""
23226 " mke2journal-U blocksize uuid device\n"
23227 "\n"
23228 msgstr ""
23229
23230 #. type: =head2
23231 #: ../fish/guestfish-actions.pod:2811
23232 msgid "mkfifo"
23233 msgstr ""
23234
23235 #. type: verbatim
23236 #: ../fish/guestfish-actions.pod:2813
23237 #, no-wrap
23238 msgid ""
23239 " mkfifo mode path\n"
23240 "\n"
23241 msgstr ""
23242
23243 #. type: textblock
23244 #: ../fish/guestfish-actions.pod:2815
23245 msgid ""
23246 "This call creates a FIFO (named pipe) called C<path> with mode C<mode>.  It "
23247 "is just a convenient wrapper around L</mknod>."
23248 msgstr ""
23249
23250 #. type: =head2
23251 #: ../fish/guestfish-actions.pod:2821
23252 msgid "mkfs"
23253 msgstr ""
23254
23255 #. type: verbatim
23256 #: ../fish/guestfish-actions.pod:2823
23257 #, no-wrap
23258 msgid ""
23259 " mkfs fstype device\n"
23260 "\n"
23261 msgstr ""
23262
23263 #. type: =head2
23264 #: ../fish/guestfish-actions.pod:2829
23265 msgid "mkfs-b"
23266 msgstr ""
23267
23268 #. type: verbatim
23269 #: ../fish/guestfish-actions.pod:2831
23270 #, no-wrap
23271 msgid ""
23272 " mkfs-b fstype blocksize device\n"
23273 "\n"
23274 msgstr ""
23275
23276 #. type: textblock
23277 #: ../fish/guestfish-actions.pod:2833
23278 msgid ""
23279 "This call is similar to L</mkfs>, but it allows you to control the block "
23280 "size of the resulting filesystem.  Supported block sizes depend on the "
23281 "filesystem type, but typically they are C<1024>, C<2048> or C<4096> only."
23282 msgstr ""
23283
23284 #. type: textblock
23285 #: ../fish/guestfish-actions.pod:2841
23286 msgid ""
23287 "This function is deprecated.  In new code, use the L</mkfs_opts> call "
23288 "instead."
23289 msgstr ""
23290
23291 #. type: =head2
23292 #: ../fish/guestfish-actions.pod:2848
23293 msgid "mkfs-opts"
23294 msgstr ""
23295
23296 #. type: verbatim
23297 #: ../fish/guestfish-actions.pod:2850
23298 #, no-wrap
23299 msgid ""
23300 " mkfs-opts fstype device [blocksize:..]\n"
23301 "\n"
23302 msgstr ""
23303
23304 #. type: =head2
23305 #: ../fish/guestfish-actions.pod:2874
23306 msgid "mkmountpoint"
23307 msgstr ""
23308
23309 #. type: verbatim
23310 #: ../fish/guestfish-actions.pod:2876
23311 #, no-wrap
23312 msgid ""
23313 " mkmountpoint exemptpath\n"
23314 "\n"
23315 msgstr ""
23316
23317 #. type: textblock
23318 #: ../fish/guestfish-actions.pod:2878
23319 msgid ""
23320 "L</mkmountpoint> and L</rmmountpoint> are specialized calls that can be used "
23321 "to create extra mountpoints before mounting the first filesystem."
23322 msgstr ""
23323
23324 #. type: textblock
23325 #: ../fish/guestfish-actions.pod:2902
23326 msgid ""
23327 "L</mkmountpoint> is not compatible with L</umount-all>.  You may get "
23328 "unexpected errors if you try to mix these calls.  It is safest to manually "
23329 "unmount filesystems and remove mountpoints after use."
23330 msgstr ""
23331
23332 #. type: textblock
23333 #: ../fish/guestfish-actions.pod:2906
23334 msgid ""
23335 "L</umount-all> unmounts filesystems by sorting the paths longest first, so "
23336 "for this to work for manual mountpoints, you must ensure that the innermost "
23337 "mountpoints have the longest pathnames, as in the example code above."
23338 msgstr ""
23339
23340 #. type: textblock
23341 #: ../fish/guestfish-actions.pod:2913
23342 msgid ""
23343 "Autosync [see L</set-autosync>, this is set by default on handles] means "
23344 "that L</umount-all> is called when the handle is closed which can also "
23345 "trigger these issues."
23346 msgstr ""
23347
23348 #. type: =head2
23349 #: ../fish/guestfish-actions.pod:2917
23350 msgid "mknod"
23351 msgstr ""
23352
23353 #. type: verbatim
23354 #: ../fish/guestfish-actions.pod:2919
23355 #, no-wrap
23356 msgid ""
23357 " mknod mode devmajor devminor path\n"
23358 "\n"
23359 msgstr ""
23360
23361 #. type: textblock
23362 #: ../fish/guestfish-actions.pod:2929
23363 msgid ""
23364 "Note that, just like L<mknod(2)>, the mode must be bitwise OR'd with "
23365 "S_IFBLK, S_IFCHR, S_IFIFO or S_IFSOCK (otherwise this call just creates a "
23366 "regular file).  These constants are available in the standard Linux header "
23367 "files, or you can use L</mknod-b>, L</mknod-c> or L</mkfifo> which are "
23368 "wrappers around this command which bitwise OR in the appropriate constant "
23369 "for you."
23370 msgstr ""
23371
23372 #. type: =head2
23373 #: ../fish/guestfish-actions.pod:2939
23374 msgid "mknod-b"
23375 msgstr ""
23376
23377 #. type: verbatim
23378 #: ../fish/guestfish-actions.pod:2941
23379 #, no-wrap
23380 msgid ""
23381 " mknod-b mode devmajor devminor path\n"
23382 "\n"
23383 msgstr ""
23384
23385 #. type: textblock
23386 #: ../fish/guestfish-actions.pod:2943
23387 msgid ""
23388 "This call creates a block device node called C<path> with mode C<mode> and "
23389 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
23390 "wrapper around L</mknod>."
23391 msgstr ""
23392
23393 #. type: =head2
23394 #: ../fish/guestfish-actions.pod:2949
23395 msgid "mknod-c"
23396 msgstr ""
23397
23398 #. type: verbatim
23399 #: ../fish/guestfish-actions.pod:2951
23400 #, no-wrap
23401 msgid ""
23402 " mknod-c mode devmajor devminor path\n"
23403 "\n"
23404 msgstr ""
23405
23406 #. type: textblock
23407 #: ../fish/guestfish-actions.pod:2953
23408 msgid ""
23409 "This call creates a char device node called C<path> with mode C<mode> and "
23410 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
23411 "wrapper around L</mknod>."
23412 msgstr ""
23413
23414 #. type: =head2
23415 #: ../fish/guestfish-actions.pod:2959
23416 msgid "mkswap"
23417 msgstr ""
23418
23419 #. type: verbatim
23420 #: ../fish/guestfish-actions.pod:2961
23421 #, no-wrap
23422 msgid ""
23423 " mkswap device\n"
23424 "\n"
23425 msgstr ""
23426
23427 #. type: =head2
23428 #: ../fish/guestfish-actions.pod:2965
23429 msgid "mkswap-L"
23430 msgstr ""
23431
23432 #. type: verbatim
23433 #: ../fish/guestfish-actions.pod:2967
23434 #, no-wrap
23435 msgid ""
23436 " mkswap-L label device\n"
23437 "\n"
23438 msgstr ""
23439
23440 #. type: =head2
23441 #: ../fish/guestfish-actions.pod:2975
23442 msgid "mkswap-U"
23443 msgstr ""
23444
23445 #. type: verbatim
23446 #: ../fish/guestfish-actions.pod:2977
23447 #, no-wrap
23448 msgid ""
23449 " mkswap-U uuid device\n"
23450 "\n"
23451 msgstr ""
23452
23453 #. type: =head2
23454 #: ../fish/guestfish-actions.pod:2981
23455 msgid "mkswap-file"
23456 msgstr ""
23457
23458 #. type: verbatim
23459 #: ../fish/guestfish-actions.pod:2983
23460 #, no-wrap
23461 msgid ""
23462 " mkswap-file path\n"
23463 "\n"
23464 msgstr ""
23465
23466 #. type: textblock
23467 #: ../fish/guestfish-actions.pod:2987
23468 msgid ""
23469 "This command just writes a swap file signature to an existing file.  To "
23470 "create the file itself, use something like L</fallocate>."
23471 msgstr ""
23472
23473 #. type: =head2
23474 #: ../fish/guestfish-actions.pod:2990
23475 msgid "modprobe"
23476 msgstr ""
23477
23478 #. type: verbatim
23479 #: ../fish/guestfish-actions.pod:2992
23480 #, no-wrap
23481 msgid ""
23482 " modprobe modulename\n"
23483 "\n"
23484 msgstr ""
23485
23486 #. type: =head2
23487 #: ../fish/guestfish-actions.pod:2999
23488 msgid "mount"
23489 msgstr ""
23490
23491 #. type: verbatim
23492 #: ../fish/guestfish-actions.pod:3001
23493 #, no-wrap
23494 msgid ""
23495 " mount device mountpoint\n"
23496 "\n"
23497 msgstr ""
23498
23499 #. type: textblock
23500 #: ../fish/guestfish-actions.pod:3017
23501 msgid ""
23502 "B<Important note:> When you use this call, the filesystem options C<sync> "
23503 "and C<noatime> are set implicitly.  This was originally done because we "
23504 "thought it would improve reliability, but it turns out that I<-o sync> has a "
23505 "very large negative performance impact and negligible effect on "
23506 "reliability.  Therefore we recommend that you avoid using L</mount> in any "
23507 "code that needs performance, and instead use L</mount-options> (use an empty "
23508 "string for the first parameter if you don't want any options)."
23509 msgstr ""
23510
23511 #. type: =head2
23512 #: ../fish/guestfish-actions.pod:3027
23513 msgid "mount-loop"
23514 msgstr ""
23515
23516 #. type: verbatim
23517 #: ../fish/guestfish-actions.pod:3029
23518 #, no-wrap
23519 msgid ""
23520 " mount-loop file mountpoint\n"
23521 "\n"
23522 msgstr ""
23523
23524 #. type: =head2
23525 #: ../fish/guestfish-actions.pod:3035
23526 msgid "mount-options"
23527 msgstr ""
23528
23529 #. type: verbatim
23530 #: ../fish/guestfish-actions.pod:3037
23531 #, no-wrap
23532 msgid ""
23533 " mount-options options device mountpoint\n"
23534 "\n"
23535 msgstr ""
23536
23537 #. type: textblock
23538 #: ../fish/guestfish-actions.pod:3039
23539 msgid ""
23540 "This is the same as the L</mount> command, but it allows you to set the "
23541 "mount options as for the L<mount(8)> I<-o> flag."
23542 msgstr ""
23543
23544 #. type: =head2
23545 #: ../fish/guestfish-actions.pod:3047
23546 msgid "mount-ro"
23547 msgstr ""
23548
23549 #. type: verbatim
23550 #: ../fish/guestfish-actions.pod:3049
23551 #, no-wrap
23552 msgid ""
23553 " mount-ro device mountpoint\n"
23554 "\n"
23555 msgstr ""
23556
23557 #. type: textblock
23558 #: ../fish/guestfish-actions.pod:3051
23559 msgid ""
23560 "This is the same as the L</mount> command, but it mounts the filesystem with "
23561 "the read-only (I<-o ro>) flag."
23562 msgstr ""
23563
23564 #. type: =head2
23565 #: ../fish/guestfish-actions.pod:3054
23566 msgid "mount-vfs"
23567 msgstr ""
23568
23569 #. type: verbatim
23570 #: ../fish/guestfish-actions.pod:3056
23571 #, no-wrap
23572 msgid ""
23573 " mount-vfs options vfstype device mountpoint\n"
23574 "\n"
23575 msgstr ""
23576
23577 #. type: textblock
23578 #: ../fish/guestfish-actions.pod:3058
23579 msgid ""
23580 "This is the same as the L</mount> command, but it allows you to set both the "
23581 "mount options and the vfstype as for the L<mount(8)> I<-o> and I<-t> flags."
23582 msgstr ""
23583
23584 #. type: =head2
23585 #: ../fish/guestfish-actions.pod:3062
23586 msgid "mountpoints"
23587 msgstr ""
23588
23589 #. type: verbatim
23590 #: ../fish/guestfish-actions.pod:3064
23591 #, no-wrap
23592 msgid ""
23593 " mountpoints\n"
23594 "\n"
23595 msgstr ""
23596
23597 #. type: textblock
23598 #: ../fish/guestfish-actions.pod:3066
23599 msgid ""
23600 "This call is similar to L</mounts>.  That call returns a list of devices.  "
23601 "This one returns a hash table (map) of device name to directory where the "
23602 "device is mounted."
23603 msgstr ""
23604
23605 #. type: =head2
23606 #: ../fish/guestfish-actions.pod:3070
23607 msgid "mounts"
23608 msgstr ""
23609
23610 #. type: verbatim
23611 #: ../fish/guestfish-actions.pod:3072
23612 #, no-wrap
23613 msgid ""
23614 " mounts\n"
23615 "\n"
23616 msgstr ""
23617
23618 #. type: textblock
23619 #: ../fish/guestfish-actions.pod:3079
23620 msgid "See also: L</mountpoints>"
23621 msgstr ""
23622
23623 #. type: =head2
23624 #: ../fish/guestfish-actions.pod:3081
23625 msgid "mv"
23626 msgstr ""
23627
23628 #. type: verbatim
23629 #: ../fish/guestfish-actions.pod:3083
23630 #, no-wrap
23631 msgid ""
23632 " mv src dest\n"
23633 "\n"
23634 msgstr ""
23635
23636 #. type: =head2
23637 #: ../fish/guestfish-actions.pod:3088
23638 msgid "ntfs-3g-probe"
23639 msgstr ""
23640
23641 #. type: verbatim
23642 #: ../fish/guestfish-actions.pod:3090
23643 #, no-wrap
23644 msgid ""
23645 " ntfs-3g-probe true|false device\n"
23646 "\n"
23647 msgstr ""
23648
23649 #. type: =head2
23650 #: ../fish/guestfish-actions.pod:3104
23651 msgid "ntfsresize"
23652 msgstr ""
23653
23654 #. type: verbatim
23655 #: ../fish/guestfish-actions.pod:3106
23656 #, no-wrap
23657 msgid ""
23658 " ntfsresize device\n"
23659 "\n"
23660 msgstr ""
23661
23662 #. type: =head2
23663 #: ../fish/guestfish-actions.pod:3121
23664 msgid "ntfsresize-size"
23665 msgstr ""
23666
23667 #. type: verbatim
23668 #: ../fish/guestfish-actions.pod:3123
23669 #, no-wrap
23670 msgid ""
23671 " ntfsresize-size device size\n"
23672 "\n"
23673 msgstr ""
23674
23675 #. type: textblock
23676 #: ../fish/guestfish-actions.pod:3125
23677 msgid ""
23678 "This command is the same as L</ntfsresize> except that it allows you to "
23679 "specify the new size (in bytes) explicitly."
23680 msgstr ""
23681
23682 #. type: =head2
23683 #: ../fish/guestfish-actions.pod:3128
23684 msgid "part-add"
23685 msgstr ""
23686
23687 #. type: verbatim
23688 #: ../fish/guestfish-actions.pod:3130
23689 #, no-wrap
23690 msgid ""
23691 " part-add device prlogex startsect endsect\n"
23692 "\n"
23693 msgstr ""
23694
23695 #. type: textblock
23696 #: ../fish/guestfish-actions.pod:3132
23697 msgid ""
23698 "This command adds a partition to C<device>.  If there is no partition table "
23699 "on the device, call L</part-init> first."
23700 msgstr ""
23701
23702 #. type: textblock
23703 #: ../fish/guestfish-actions.pod:3144
23704 msgid ""
23705 "Creating a partition which covers the whole disk is not so easy.  Use "
23706 "L</part-disk> to do that."
23707 msgstr ""
23708
23709 #. type: =head2
23710 #: ../fish/guestfish-actions.pod:3147
23711 msgid "part-del"
23712 msgstr ""
23713
23714 #. type: verbatim
23715 #: ../fish/guestfish-actions.pod:3149
23716 #, no-wrap
23717 msgid ""
23718 " part-del device partnum\n"
23719 "\n"
23720 msgstr ""
23721
23722 #. type: =head2
23723 #: ../fish/guestfish-actions.pod:3157
23724 msgid "part-disk"
23725 msgstr ""
23726
23727 #. type: verbatim
23728 #: ../fish/guestfish-actions.pod:3159
23729 #, no-wrap
23730 msgid ""
23731 " part-disk device parttype\n"
23732 "\n"
23733 msgstr ""
23734
23735 #. type: textblock
23736 #: ../fish/guestfish-actions.pod:3161
23737 msgid ""
23738 "This command is simply a combination of L</part-init> followed by "
23739 "L</part-add> to create a single primary partition covering the whole disk."
23740 msgstr ""
23741
23742 #. type: textblock
23743 #: ../fish/guestfish-actions.pod:3165
23744 msgid ""
23745 "C<parttype> is the partition table type, usually C<mbr> or C<gpt>, but other "
23746 "possible values are described in L</part-init>."
23747 msgstr ""
23748
23749 #. type: =head2
23750 #: ../fish/guestfish-actions.pod:3171
23751 msgid "part-get-bootable"
23752 msgstr ""
23753
23754 #. type: verbatim
23755 #: ../fish/guestfish-actions.pod:3173
23756 #, no-wrap
23757 msgid ""
23758 " part-get-bootable device partnum\n"
23759 "\n"
23760 msgstr ""
23761
23762 #. type: textblock
23763 #: ../fish/guestfish-actions.pod:3178
23764 msgid "See also L</part-set-bootable>."
23765 msgstr ""
23766
23767 #. type: =head2
23768 #: ../fish/guestfish-actions.pod:3180
23769 msgid "part-get-mbr-id"
23770 msgstr ""
23771
23772 #. type: verbatim
23773 #: ../fish/guestfish-actions.pod:3182
23774 #, no-wrap
23775 msgid ""
23776 " part-get-mbr-id device partnum\n"
23777 "\n"
23778 msgstr ""
23779
23780 #. type: textblock
23781 #: ../fish/guestfish-actions.pod:3187 ../fish/guestfish-actions.pod:3325
23782 msgid ""
23783 "Note that only MBR (old DOS-style) partitions have type bytes.  You will get "
23784 "undefined results for other partition table types (see "
23785 "L</part-get-parttype>)."
23786 msgstr ""
23787
23788 #. type: =head2
23789 #: ../fish/guestfish-actions.pod:3191
23790 msgid "part-get-parttype"
23791 msgstr ""
23792
23793 #. type: verbatim
23794 #: ../fish/guestfish-actions.pod:3193
23795 #, no-wrap
23796 msgid ""
23797 " part-get-parttype device\n"
23798 "\n"
23799 msgstr ""
23800
23801 #. type: textblock
23802 #: ../fish/guestfish-actions.pod:3198
23803 msgid ""
23804 "Common return values include: C<msdos> (a DOS/Windows style MBR partition "
23805 "table), C<gpt> (a GPT/EFI-style partition table).  Other values are "
23806 "possible, although unusual.  See L</part-init> for a full list."
23807 msgstr ""
23808
23809 #. type: =head2
23810 #: ../fish/guestfish-actions.pod:3203
23811 msgid "part-init"
23812 msgstr ""
23813
23814 #. type: verbatim
23815 #: ../fish/guestfish-actions.pod:3205
23816 #, no-wrap
23817 msgid ""
23818 " part-init device parttype\n"
23819 "\n"
23820 msgstr ""
23821
23822 #. type: textblock
23823 #: ../fish/guestfish-actions.pod:3211
23824 msgid ""
23825 "Initially there are no partitions.  Following this, you should call "
23826 "L</part-add> for each partition required."
23827 msgstr ""
23828
23829 #. type: =head2
23830 #: ../fish/guestfish-actions.pod:3274
23831 msgid "part-list"
23832 msgstr ""
23833
23834 #. type: verbatim
23835 #: ../fish/guestfish-actions.pod:3276
23836 #, no-wrap
23837 msgid ""
23838 " part-list device\n"
23839 "\n"
23840 msgstr ""
23841
23842 #. type: textblock
23843 #: ../fish/guestfish-actions.pod:3291
23844 msgid ""
23845 "Start of the partition I<in bytes>.  To get sectors you have to divide by "
23846 "the device's sector size, see L</blockdev-getss>."
23847 msgstr ""
23848
23849 #. type: =head2
23850 #: ../fish/guestfish-actions.pod:3304
23851 msgid "part-set-bootable"
23852 msgstr ""
23853
23854 #. type: verbatim
23855 #: ../fish/guestfish-actions.pod:3306
23856 #, no-wrap
23857 msgid ""
23858 " part-set-bootable device partnum true|false\n"
23859 "\n"
23860 msgstr ""
23861
23862 #. type: =head2
23863 #: ../fish/guestfish-actions.pod:3315
23864 msgid "part-set-mbr-id"
23865 msgstr ""
23866
23867 #. type: verbatim
23868 #: ../fish/guestfish-actions.pod:3317
23869 #, no-wrap
23870 msgid ""
23871 " part-set-mbr-id device partnum idbyte\n"
23872 "\n"
23873 msgstr ""
23874
23875 #. type: =head2
23876 #: ../fish/guestfish-actions.pod:3329
23877 msgid "part-set-name"
23878 msgstr ""
23879
23880 #. type: verbatim
23881 #: ../fish/guestfish-actions.pod:3331
23882 #, no-wrap
23883 msgid ""
23884 " part-set-name device partnum name\n"
23885 "\n"
23886 msgstr ""
23887
23888 #. type: =head2
23889 #: ../fish/guestfish-actions.pod:3339
23890 msgid "part-to-dev"
23891 msgstr ""
23892
23893 #. type: verbatim
23894 #: ../fish/guestfish-actions.pod:3341
23895 #, no-wrap
23896 msgid ""
23897 " part-to-dev partition\n"
23898 "\n"
23899 msgstr ""
23900
23901 #. type: textblock
23902 #: ../fish/guestfish-actions.pod:3347
23903 msgid ""
23904 "The named partition must exist, for example as a string returned from "
23905 "L</list-partitions>."
23906 msgstr ""
23907
23908 #. type: =head2
23909 #: ../fish/guestfish-actions.pod:3350
23910 msgid "ping-daemon"
23911 msgstr ""
23912
23913 #. type: verbatim
23914 #: ../fish/guestfish-actions.pod:3352
23915 #, no-wrap
23916 msgid ""
23917 " ping-daemon\n"
23918 "\n"
23919 msgstr ""
23920
23921 #. type: =head2
23922 #: ../fish/guestfish-actions.pod:3359
23923 msgid "pread"
23924 msgstr ""
23925
23926 #. type: verbatim
23927 #: ../fish/guestfish-actions.pod:3361
23928 #, no-wrap
23929 msgid ""
23930 " pread path count offset\n"
23931 "\n"
23932 msgstr ""
23933
23934 #. type: textblock
23935 #: ../fish/guestfish-actions.pod:3369
23936 msgid "See also L</pwrite>, L</pread-device>."
23937 msgstr ""
23938
23939 #. type: =head2
23940 #: ../fish/guestfish-actions.pod:3374
23941 msgid "pread-device"
23942 msgstr ""
23943
23944 #. type: verbatim
23945 #: ../fish/guestfish-actions.pod:3376
23946 #, no-wrap
23947 msgid ""
23948 " pread-device device count offset\n"
23949 "\n"
23950 msgstr ""
23951
23952 #. type: textblock
23953 #: ../fish/guestfish-actions.pod:3384
23954 msgid "See also L</pread>."
23955 msgstr ""
23956
23957 #. type: =head2
23958 #: ../fish/guestfish-actions.pod:3389
23959 msgid "pvcreate"
23960 msgstr ""
23961
23962 #. type: verbatim
23963 #: ../fish/guestfish-actions.pod:3391
23964 #, no-wrap
23965 msgid ""
23966 " pvcreate device\n"
23967 "\n"
23968 msgstr ""
23969
23970 #. type: =head2
23971 #: ../fish/guestfish-actions.pod:3397
23972 msgid "pvremove"
23973 msgstr ""
23974
23975 #. type: verbatim
23976 #: ../fish/guestfish-actions.pod:3399
23977 #, no-wrap
23978 msgid ""
23979 " pvremove device\n"
23980 "\n"
23981 msgstr ""
23982
23983 #. type: =head2
23984 #: ../fish/guestfish-actions.pod:3408
23985 msgid "pvresize"
23986 msgstr ""
23987
23988 #. type: verbatim
23989 #: ../fish/guestfish-actions.pod:3410
23990 #, no-wrap
23991 msgid ""
23992 " pvresize device\n"
23993 "\n"
23994 msgstr ""
23995
23996 #. type: =head2
23997 #: ../fish/guestfish-actions.pod:3415
23998 msgid "pvresize-size"
23999 msgstr ""
24000
24001 #. type: verbatim
24002 #: ../fish/guestfish-actions.pod:3417
24003 #, no-wrap
24004 msgid ""
24005 " pvresize-size device size\n"
24006 "\n"
24007 msgstr ""
24008
24009 #. type: textblock
24010 #: ../fish/guestfish-actions.pod:3419
24011 msgid ""
24012 "This command is the same as L</pvresize> except that it allows you to "
24013 "specify the new size (in bytes) explicitly."
24014 msgstr ""
24015
24016 #. type: =head2
24017 #: ../fish/guestfish-actions.pod:3422
24018 msgid "pvs"
24019 msgstr ""
24020
24021 #. type: verbatim
24022 #: ../fish/guestfish-actions.pod:3424
24023 #, no-wrap
24024 msgid ""
24025 " pvs\n"
24026 "\n"
24027 msgstr ""
24028
24029 #. type: textblock
24030 #: ../fish/guestfish-actions.pod:3432
24031 msgid "See also L</pvs-full>."
24032 msgstr ""
24033
24034 #. type: =head2
24035 #: ../fish/guestfish-actions.pod:3434
24036 msgid "pvs-full"
24037 msgstr ""
24038
24039 #. type: verbatim
24040 #: ../fish/guestfish-actions.pod:3436
24041 #, no-wrap
24042 msgid ""
24043 " pvs-full\n"
24044 "\n"
24045 msgstr ""
24046
24047 #. type: =head2
24048 #: ../fish/guestfish-actions.pod:3441
24049 msgid "pvuuid"
24050 msgstr ""
24051
24052 #. type: verbatim
24053 #: ../fish/guestfish-actions.pod:3443
24054 #, no-wrap
24055 msgid ""
24056 " pvuuid device\n"
24057 "\n"
24058 msgstr ""
24059
24060 #. type: =head2
24061 #: ../fish/guestfish-actions.pod:3447
24062 msgid "pwrite"
24063 msgstr ""
24064
24065 #. type: verbatim
24066 #: ../fish/guestfish-actions.pod:3449
24067 #, no-wrap
24068 msgid ""
24069 " pwrite path content offset\n"
24070 "\n"
24071 msgstr ""
24072
24073 #. type: textblock
24074 #: ../fish/guestfish-actions.pod:3460
24075 msgid "See also L</pread>, L</pwrite-device>."
24076 msgstr ""
24077
24078 #. type: =head2
24079 #: ../fish/guestfish-actions.pod:3465
24080 msgid "pwrite-device"
24081 msgstr ""
24082
24083 #. type: verbatim
24084 #: ../fish/guestfish-actions.pod:3467
24085 #, no-wrap
24086 msgid ""
24087 " pwrite-device device content offset\n"
24088 "\n"
24089 msgstr ""
24090
24091 #. type: textblock
24092 #: ../fish/guestfish-actions.pod:3477
24093 msgid "See also L</pwrite>."
24094 msgstr ""
24095
24096 #. type: =head2
24097 #: ../fish/guestfish-actions.pod:3482
24098 msgid "read-file"
24099 msgstr ""
24100
24101 #. type: verbatim
24102 #: ../fish/guestfish-actions.pod:3484
24103 #, no-wrap
24104 msgid ""
24105 " read-file path\n"
24106 "\n"
24107 msgstr ""
24108
24109 #. type: textblock
24110 #: ../fish/guestfish-actions.pod:3489
24111 msgid ""
24112 "Unlike L</cat>, this function can correctly handle files that contain "
24113 "embedded ASCII NUL characters.  However unlike L</download>, this function "
24114 "is limited in the total size of file that can be handled."
24115 msgstr ""
24116
24117 #. type: =head2
24118 #: ../fish/guestfish-actions.pod:3497
24119 msgid "read-lines"
24120 msgstr ""
24121
24122 #. type: verbatim
24123 #: ../fish/guestfish-actions.pod:3499
24124 #, no-wrap
24125 msgid ""
24126 " read-lines path\n"
24127 "\n"
24128 msgstr ""
24129
24130 #. type: textblock
24131 #: ../fish/guestfish-actions.pod:3506
24132 msgid ""
24133 "Note that this function cannot correctly handle binary files (specifically, "
24134 "files containing C<\\0> character which is treated as end of line).  For "
24135 "those you need to use the L</read-file> function which has a more complex "
24136 "interface."
24137 msgstr ""
24138
24139 #. type: =head2
24140 #: ../fish/guestfish-actions.pod:3511
24141 msgid "readdir"
24142 msgstr ""
24143
24144 #. type: verbatim
24145 #: ../fish/guestfish-actions.pod:3513
24146 #, no-wrap
24147 msgid ""
24148 " readdir dir\n"
24149 "\n"
24150 msgstr ""
24151
24152 #. type: textblock
24153 #: ../fish/guestfish-actions.pod:3565
24154 msgid ""
24155 "This function is primarily intended for use by programs.  To get a simple "
24156 "list of names, use L</ls>.  To get a printable directory for human "
24157 "consumption, use L</ll>."
24158 msgstr ""
24159
24160 #. type: =head2
24161 #: ../fish/guestfish-actions.pod:3569
24162 msgid "readlink"
24163 msgstr ""
24164
24165 #. type: verbatim
24166 #: ../fish/guestfish-actions.pod:3571
24167 #, no-wrap
24168 msgid ""
24169 " readlink path\n"
24170 "\n"
24171 msgstr ""
24172
24173 #. type: =head2
24174 #: ../fish/guestfish-actions.pod:3575
24175 msgid "readlinklist"
24176 msgstr ""
24177
24178 #. type: verbatim
24179 #: ../fish/guestfish-actions.pod:3577
24180 #, no-wrap
24181 msgid ""
24182 " readlinklist path 'names ...'\n"
24183 "\n"
24184 msgstr ""
24185
24186 #. type: =head2
24187 #: ../fish/guestfish-actions.pod:3601
24188 msgid "realpath"
24189 msgstr ""
24190
24191 #. type: verbatim
24192 #: ../fish/guestfish-actions.pod:3603
24193 #, no-wrap
24194 msgid ""
24195 " realpath path\n"
24196 "\n"
24197 msgstr ""
24198
24199 #. type: =head2
24200 #: ../fish/guestfish-actions.pod:3608
24201 msgid "removexattr"
24202 msgstr ""
24203
24204 #. type: verbatim
24205 #: ../fish/guestfish-actions.pod:3610
24206 #, no-wrap
24207 msgid ""
24208 " removexattr xattr path\n"
24209 "\n"
24210 msgstr ""
24211
24212 #. type: textblock
24213 #: ../fish/guestfish-actions.pod:3615
24214 msgid "See also: L</lremovexattr>, L<attr(5)>."
24215 msgstr ""
24216
24217 #. type: =head2
24218 #: ../fish/guestfish-actions.pod:3617
24219 msgid "resize2fs"
24220 msgstr ""
24221
24222 #. type: verbatim
24223 #: ../fish/guestfish-actions.pod:3619
24224 #, no-wrap
24225 msgid ""
24226 " resize2fs device\n"
24227 "\n"
24228 msgstr ""
24229
24230 #. type: textblock
24231 #: ../fish/guestfish-actions.pod:3624
24232 msgid ""
24233 "I<Note:> It is sometimes required that you run L</e2fsck-f> on the C<device> "
24234 "before calling this command.  For unknown reasons C<resize2fs> sometimes "
24235 "gives an error about this and sometimes not.  In any case, it is always safe "
24236 "to call L</e2fsck-f> before calling this function."
24237 msgstr ""
24238
24239 #. type: =head2
24240 #: ../fish/guestfish-actions.pod:3630
24241 msgid "resize2fs-size"
24242 msgstr ""
24243
24244 #. type: verbatim
24245 #: ../fish/guestfish-actions.pod:3632
24246 #, no-wrap
24247 msgid ""
24248 " resize2fs-size device size\n"
24249 "\n"
24250 msgstr ""
24251
24252 #. type: textblock
24253 #: ../fish/guestfish-actions.pod:3634
24254 msgid ""
24255 "This command is the same as L</resize2fs> except that it allows you to "
24256 "specify the new size (in bytes) explicitly."
24257 msgstr ""
24258
24259 #. type: =head2
24260 #: ../fish/guestfish-actions.pod:3637
24261 msgid "rm"
24262 msgstr ""
24263
24264 #. type: verbatim
24265 #: ../fish/guestfish-actions.pod:3639
24266 #, no-wrap
24267 msgid ""
24268 " rm path\n"
24269 "\n"
24270 msgstr ""
24271
24272 #. type: =head2
24273 #: ../fish/guestfish-actions.pod:3643
24274 msgid "rm-rf"
24275 msgstr ""
24276
24277 #. type: verbatim
24278 #: ../fish/guestfish-actions.pod:3645
24279 #, no-wrap
24280 msgid ""
24281 " rm-rf path\n"
24282 "\n"
24283 msgstr ""
24284
24285 #. type: =head2
24286 #: ../fish/guestfish-actions.pod:3651
24287 msgid "rmdir"
24288 msgstr ""
24289
24290 #. type: verbatim
24291 #: ../fish/guestfish-actions.pod:3653
24292 #, no-wrap
24293 msgid ""
24294 " rmdir path\n"
24295 "\n"
24296 msgstr ""
24297
24298 #. type: =head2
24299 #: ../fish/guestfish-actions.pod:3657
24300 msgid "rmmountpoint"
24301 msgstr ""
24302
24303 #. type: verbatim
24304 #: ../fish/guestfish-actions.pod:3659
24305 #, no-wrap
24306 msgid ""
24307 " rmmountpoint exemptpath\n"
24308 "\n"
24309 msgstr ""
24310
24311 #. type: textblock
24312 #: ../fish/guestfish-actions.pod:3661
24313 msgid ""
24314 "This calls removes a mountpoint that was previously created with "
24315 "L</mkmountpoint>.  See L</mkmountpoint> for full details."
24316 msgstr ""
24317
24318 #. type: =head2
24319 #: ../fish/guestfish-actions.pod:3665
24320 msgid "scrub-device"
24321 msgstr ""
24322
24323 #. type: verbatim
24324 #: ../fish/guestfish-actions.pod:3667
24325 #, no-wrap
24326 msgid ""
24327 " scrub-device device\n"
24328 "\n"
24329 msgstr ""
24330
24331 #. type: =head2
24332 #: ../fish/guestfish-actions.pod:3678
24333 msgid "scrub-file"
24334 msgstr ""
24335
24336 #. type: verbatim
24337 #: ../fish/guestfish-actions.pod:3680
24338 #, no-wrap
24339 msgid ""
24340 " scrub-file file\n"
24341 "\n"
24342 msgstr ""
24343
24344 #. type: =head2
24345 #: ../fish/guestfish-actions.pod:3690
24346 msgid "scrub-freespace"
24347 msgstr ""
24348
24349 #. type: verbatim
24350 #: ../fish/guestfish-actions.pod:3692
24351 #, no-wrap
24352 msgid ""
24353 " scrub-freespace dir\n"
24354 "\n"
24355 msgstr ""
24356
24357 #. type: textblock
24358 #: ../fish/guestfish-actions.pod:3694
24359 msgid ""
24360 "This command creates the directory C<dir> and then fills it with files until "
24361 "the filesystem is full, and scrubs the files as for L</scrub-file>, and "
24362 "deletes them.  The intention is to scrub any free space on the partition "
24363 "containing C<dir>."
24364 msgstr ""
24365
24366 #. type: =head2
24367 #: ../fish/guestfish-actions.pod:3703
24368 msgid "set-append"
24369 msgstr ""
24370
24371 #. type: =head2
24372 #: ../fish/guestfish-actions.pod:3705
24373 msgid "append"
24374 msgstr ""
24375
24376 #. type: verbatim
24377 #: ../fish/guestfish-actions.pod:3707
24378 #, no-wrap
24379 msgid ""
24380 " set-append append\n"
24381 "\n"
24382 msgstr ""
24383
24384 #. type: =head2
24385 #: ../fish/guestfish-actions.pod:3718
24386 msgid "set-autosync"
24387 msgstr ""
24388
24389 #. type: =head2
24390 #: ../fish/guestfish-actions.pod:3720
24391 msgid "autosync"
24392 msgstr ""
24393
24394 #. type: verbatim
24395 #: ../fish/guestfish-actions.pod:3722
24396 #, no-wrap
24397 msgid ""
24398 " set-autosync true|false\n"
24399 "\n"
24400 msgstr ""
24401
24402 #. type: textblock
24403 #: ../fish/guestfish-actions.pod:3724
24404 msgid ""
24405 "If C<autosync> is true, this enables autosync.  Libguestfs will make a best "
24406 "effort attempt to run L</umount-all> followed by L</sync> when the handle is "
24407 "closed (also if the program exits without closing handles)."
24408 msgstr ""
24409
24410 #. type: =head2
24411 #: ../fish/guestfish-actions.pod:3732
24412 msgid "set-direct"
24413 msgstr ""
24414
24415 #. type: =head2
24416 #: ../fish/guestfish-actions.pod:3734
24417 msgid "direct"
24418 msgstr ""
24419
24420 #. type: verbatim
24421 #: ../fish/guestfish-actions.pod:3736
24422 #, no-wrap
24423 msgid ""
24424 " set-direct true|false\n"
24425 "\n"
24426 msgstr ""
24427
24428 #. type: textblock
24429 #: ../fish/guestfish-actions.pod:3742
24430 msgid ""
24431 "One consequence of this is that log messages aren't caught by the library "
24432 "and handled by L</set-log-message-callback>, but go straight to stdout."
24433 msgstr ""
24434
24435 #. type: =head2
24436 #: ../fish/guestfish-actions.pod:3751
24437 msgid "set-e2label"
24438 msgstr ""
24439
24440 #. type: verbatim
24441 #: ../fish/guestfish-actions.pod:3753
24442 #, no-wrap
24443 msgid ""
24444 " set-e2label device label\n"
24445 "\n"
24446 msgstr ""
24447
24448 #. type: textblock
24449 #: ../fish/guestfish-actions.pod:3759
24450 msgid ""
24451 "You can use either L</tune2fs-l> or L</get-e2label> to return the existing "
24452 "label on a filesystem."
24453 msgstr ""
24454
24455 #. type: =head2
24456 #: ../fish/guestfish-actions.pod:3762
24457 msgid "set-e2uuid"
24458 msgstr ""
24459
24460 #. type: verbatim
24461 #: ../fish/guestfish-actions.pod:3764
24462 #, no-wrap
24463 msgid ""
24464 " set-e2uuid device uuid\n"
24465 "\n"
24466 msgstr ""
24467
24468 #. type: textblock
24469 #: ../fish/guestfish-actions.pod:3771
24470 msgid ""
24471 "You can use either L</tune2fs-l> or L</get-e2uuid> to return the existing "
24472 "UUID of a filesystem."
24473 msgstr ""
24474
24475 #. type: =head2
24476 #: ../fish/guestfish-actions.pod:3774
24477 msgid "set-memsize"
24478 msgstr ""
24479
24480 #. type: =head2
24481 #: ../fish/guestfish-actions.pod:3776
24482 msgid "memsize"
24483 msgstr ""
24484
24485 #. type: verbatim
24486 #: ../fish/guestfish-actions.pod:3778
24487 #, no-wrap
24488 msgid ""
24489 " set-memsize memsize\n"
24490 "\n"
24491 msgstr ""
24492
24493 #. type: textblock
24494 #: ../fish/guestfish-actions.pod:3780
24495 msgid ""
24496 "This sets the memory size in megabytes allocated to the qemu subprocess.  "
24497 "This only has any effect if called before L</launch>."
24498 msgstr ""
24499
24500 #. type: =head2
24501 #: ../fish/guestfish-actions.pod:3791
24502 msgid "set-network"
24503 msgstr ""
24504
24505 #. type: =head2
24506 #: ../fish/guestfish-actions.pod:3793
24507 msgid "network"
24508 msgstr ""
24509
24510 #. type: verbatim
24511 #: ../fish/guestfish-actions.pod:3795
24512 #, no-wrap
24513 msgid ""
24514 " set-network true|false\n"
24515 "\n"
24516 msgstr ""
24517
24518 #. type: textblock
24519 #: ../fish/guestfish-actions.pod:3803
24520 msgid "You must call this before calling L</launch>, otherwise it has no effect."
24521 msgstr ""
24522
24523 #. type: =head2
24524 #: ../fish/guestfish-actions.pod:3806
24525 msgid "set-path"
24526 msgstr ""
24527
24528 #. type: =head2
24529 #: ../fish/guestfish-actions.pod:3808
24530 msgid "path"
24531 msgstr ""
24532
24533 #. type: verbatim
24534 #: ../fish/guestfish-actions.pod:3810
24535 #, no-wrap
24536 msgid ""
24537 " set-path searchpath\n"
24538 "\n"
24539 msgstr ""
24540
24541 #. type: =head2
24542 #: ../fish/guestfish-actions.pod:3819
24543 msgid "set-qemu"
24544 msgstr ""
24545
24546 #. type: =head2
24547 #: ../fish/guestfish-actions.pod:3821
24548 msgid "qemu"
24549 msgstr ""
24550
24551 #. type: verbatim
24552 #: ../fish/guestfish-actions.pod:3823
24553 #, no-wrap
24554 msgid ""
24555 " set-qemu qemu\n"
24556 "\n"
24557 msgstr ""
24558
24559 #. type: =head2
24560 #: ../fish/guestfish-actions.pod:3843
24561 msgid "set-recovery-proc"
24562 msgstr ""
24563
24564 #. type: =head2
24565 #: ../fish/guestfish-actions.pod:3845
24566 msgid "recovery-proc"
24567 msgstr ""
24568
24569 #. type: verbatim
24570 #: ../fish/guestfish-actions.pod:3847
24571 #, no-wrap
24572 msgid ""
24573 " set-recovery-proc true|false\n"
24574 "\n"
24575 msgstr ""
24576
24577 #. type: textblock
24578 #: ../fish/guestfish-actions.pod:3849
24579 msgid ""
24580 "If this is called with the parameter C<false> then L</launch> does not "
24581 "create a recovery process.  The purpose of the recovery process is to stop "
24582 "runaway qemu processes in the case where the main program aborts abruptly."
24583 msgstr ""
24584
24585 #. type: textblock
24586 #: ../fish/guestfish-actions.pod:3854
24587 msgid ""
24588 "This only has any effect if called before L</launch>, and the default is "
24589 "true."
24590 msgstr ""
24591
24592 #. type: =head2
24593 #: ../fish/guestfish-actions.pod:3863
24594 msgid "set-selinux"
24595 msgstr ""
24596
24597 #. type: =head2
24598 #: ../fish/guestfish-actions.pod:3865
24599 msgid "selinux"
24600 msgstr ""
24601
24602 #. type: verbatim
24603 #: ../fish/guestfish-actions.pod:3867
24604 #, no-wrap
24605 msgid ""
24606 " set-selinux true|false\n"
24607 "\n"
24608 msgstr ""
24609
24610 #. type: =head2
24611 #: ../fish/guestfish-actions.pod:3878
24612 msgid "set-trace"
24613 msgstr ""
24614
24615 #. type: =head2
24616 #: ../fish/guestfish-actions.pod:3880
24617 msgid "trace"
24618 msgstr ""
24619
24620 #. type: verbatim
24621 #: ../fish/guestfish-actions.pod:3882
24622 #, no-wrap
24623 msgid ""
24624 " set-trace true|false\n"
24625 "\n"
24626 msgstr ""
24627
24628 #. type: =head2
24629 #: ../fish/guestfish-actions.pod:3898
24630 msgid "set-verbose"
24631 msgstr ""
24632
24633 #. type: =head2
24634 #: ../fish/guestfish-actions.pod:3900
24635 msgid "verbose"
24636 msgstr ""
24637
24638 #. type: verbatim
24639 #: ../fish/guestfish-actions.pod:3902
24640 #, no-wrap
24641 msgid ""
24642 " set-verbose true|false\n"
24643 "\n"
24644 msgstr ""
24645
24646 #. type: =head2
24647 #: ../fish/guestfish-actions.pod:3909
24648 msgid "setcon"
24649 msgstr ""
24650
24651 #. type: verbatim
24652 #: ../fish/guestfish-actions.pod:3911
24653 #, no-wrap
24654 msgid ""
24655 " setcon context\n"
24656 "\n"
24657 msgstr ""
24658
24659 #. type: =head2
24660 #: ../fish/guestfish-actions.pod:3918
24661 msgid "setxattr"
24662 msgstr ""
24663
24664 #. type: verbatim
24665 #: ../fish/guestfish-actions.pod:3920
24666 #, no-wrap
24667 msgid ""
24668 " setxattr xattr val vallen path\n"
24669 "\n"
24670 msgstr ""
24671
24672 #. type: textblock
24673 #: ../fish/guestfish-actions.pod:3926
24674 msgid "See also: L</lsetxattr>, L<attr(5)>."
24675 msgstr ""
24676
24677 #. type: =head2
24678 #: ../fish/guestfish-actions.pod:3928
24679 msgid "sfdisk"
24680 msgstr ""
24681
24682 #. type: verbatim
24683 #: ../fish/guestfish-actions.pod:3930
24684 #, no-wrap
24685 msgid ""
24686 " sfdisk device cyls heads sectors 'lines ...'\n"
24687 "\n"
24688 msgstr ""
24689
24690 #. type: textblock
24691 #: ../fish/guestfish-actions.pod:3952
24692 msgid "See also: L</sfdisk-l>, L</sfdisk-N>, L</part-init>"
24693 msgstr ""
24694
24695 #. type: =head2
24696 #: ../fish/guestfish-actions.pod:3958
24697 msgid "sfdiskM"
24698 msgstr ""
24699
24700 #. type: verbatim
24701 #: ../fish/guestfish-actions.pod:3960
24702 #, no-wrap
24703 msgid ""
24704 " sfdiskM device 'lines ...'\n"
24705 "\n"
24706 msgstr ""
24707
24708 #. type: textblock
24709 #: ../fish/guestfish-actions.pod:3962
24710 msgid ""
24711 "This is a simplified interface to the L</sfdisk> command, where partition "
24712 "sizes are specified in megabytes only (rounded to the nearest cylinder) and "
24713 "you don't need to specify the cyls, heads and sectors parameters which were "
24714 "rarely if ever used anyway."
24715 msgstr ""
24716
24717 #. type: textblock
24718 #: ../fish/guestfish-actions.pod:3968
24719 msgid "See also: L</sfdisk>, the L<sfdisk(8)> manpage and L</part-disk>"
24720 msgstr ""
24721
24722 #. type: =head2
24723 #: ../fish/guestfish-actions.pod:3974
24724 msgid "sfdisk-N"
24725 msgstr ""
24726
24727 #. type: verbatim
24728 #: ../fish/guestfish-actions.pod:3976
24729 #, no-wrap
24730 msgid ""
24731 " sfdisk-N device partnum cyls heads sectors line\n"
24732 "\n"
24733 msgstr ""
24734
24735 #. type: textblock
24736 #: ../fish/guestfish-actions.pod:3981
24737 msgid ""
24738 "For other parameters, see L</sfdisk>.  You should usually pass C<0> for the "
24739 "cyls/heads/sectors parameters."
24740 msgstr ""
24741
24742 #. type: textblock
24743 #: ../fish/guestfish-actions.pod:3984
24744 msgid "See also: L</part-add>"
24745 msgstr ""
24746
24747 #. type: =head2
24748 #: ../fish/guestfish-actions.pod:3989
24749 msgid "sfdisk-disk-geometry"
24750 msgstr ""
24751
24752 #. type: verbatim
24753 #: ../fish/guestfish-actions.pod:3991
24754 #, no-wrap
24755 msgid ""
24756 " sfdisk-disk-geometry device\n"
24757 "\n"
24758 msgstr ""
24759
24760 #. type: textblock
24761 #: ../fish/guestfish-actions.pod:3993
24762 msgid ""
24763 "This displays the disk geometry of C<device> read from the partition table.  "
24764 "Especially in the case where the underlying block device has been resized, "
24765 "this can be different from the kernel's idea of the geometry (see "
24766 "L</sfdisk-kernel-geometry>)."
24767 msgstr ""
24768
24769 #. type: =head2
24770 #: ../fish/guestfish-actions.pod:4001
24771 msgid "sfdisk-kernel-geometry"
24772 msgstr ""
24773
24774 #. type: verbatim
24775 #: ../fish/guestfish-actions.pod:4003
24776 #, no-wrap
24777 msgid ""
24778 " sfdisk-kernel-geometry device\n"
24779 "\n"
24780 msgstr ""
24781
24782 #. type: =head2
24783 #: ../fish/guestfish-actions.pod:4010
24784 msgid "sfdisk-l"
24785 msgstr ""
24786
24787 #. type: verbatim
24788 #: ../fish/guestfish-actions.pod:4012
24789 #, no-wrap
24790 msgid ""
24791 " sfdisk-l device\n"
24792 "\n"
24793 msgstr ""
24794
24795 #. type: textblock
24796 #: ../fish/guestfish-actions.pod:4018
24797 msgid "See also: L</part-list>"
24798 msgstr ""
24799
24800 #. type: =head2
24801 #: ../fish/guestfish-actions.pod:4020
24802 msgid "sh"
24803 msgstr ""
24804
24805 #. type: verbatim
24806 #: ../fish/guestfish-actions.pod:4022
24807 #, no-wrap
24808 msgid ""
24809 " sh command\n"
24810 "\n"
24811 msgstr ""
24812
24813 #. type: textblock
24814 #: ../fish/guestfish-actions.pod:4027
24815 msgid "This is like L</command>, but passes the command to:"
24816 msgstr ""
24817
24818 #. type: textblock
24819 #: ../fish/guestfish-actions.pod:4035
24820 msgid "All the provisos about L</command> apply to this call."
24821 msgstr ""
24822
24823 #. type: =head2
24824 #: ../fish/guestfish-actions.pod:4037
24825 msgid "sh-lines"
24826 msgstr ""
24827
24828 #. type: verbatim
24829 #: ../fish/guestfish-actions.pod:4039
24830 #, no-wrap
24831 msgid ""
24832 " sh-lines command\n"
24833 "\n"
24834 msgstr ""
24835
24836 #. type: textblock
24837 #: ../fish/guestfish-actions.pod:4041
24838 msgid "This is the same as L</sh>, but splits the result into a list of lines."
24839 msgstr ""
24840
24841 #. type: textblock
24842 #: ../fish/guestfish-actions.pod:4044
24843 msgid "See also: L</command-lines>"
24844 msgstr ""
24845
24846 #. type: =head2
24847 #: ../fish/guestfish-actions.pod:4046
24848 msgid "sleep"
24849 msgstr ""
24850
24851 #. type: verbatim
24852 #: ../fish/guestfish-actions.pod:4048
24853 #, no-wrap
24854 msgid ""
24855 " sleep secs\n"
24856 "\n"
24857 msgstr ""
24858
24859 #. type: =head2
24860 #: ../fish/guestfish-actions.pod:4052
24861 msgid "stat"
24862 msgstr ""
24863
24864 #. type: verbatim
24865 #: ../fish/guestfish-actions.pod:4054
24866 #, no-wrap
24867 msgid ""
24868 " stat path\n"
24869 "\n"
24870 msgstr ""
24871
24872 #. type: =head2
24873 #: ../fish/guestfish-actions.pod:4060
24874 msgid "statvfs"
24875 msgstr ""
24876
24877 #. type: verbatim
24878 #: ../fish/guestfish-actions.pod:4062
24879 #, no-wrap
24880 msgid ""
24881 " statvfs path\n"
24882 "\n"
24883 msgstr ""
24884
24885 #. type: =head2
24886 #: ../fish/guestfish-actions.pod:4070
24887 msgid "strings"
24888 msgstr ""
24889
24890 #. type: verbatim
24891 #: ../fish/guestfish-actions.pod:4072
24892 #, no-wrap
24893 msgid ""
24894 " strings path\n"
24895 "\n"
24896 msgstr ""
24897
24898 #. type: =head2
24899 #: ../fish/guestfish-actions.pod:4080
24900 msgid "strings-e"
24901 msgstr ""
24902
24903 #. type: verbatim
24904 #: ../fish/guestfish-actions.pod:4082
24905 #, no-wrap
24906 msgid ""
24907 " strings-e encoding path\n"
24908 "\n"
24909 msgstr ""
24910
24911 #. type: textblock
24912 #: ../fish/guestfish-actions.pod:4084
24913 msgid ""
24914 "This is like the L</strings> command, but allows you to specify the encoding "
24915 "of strings that are looked for in the source file C<path>."
24916 msgstr ""
24917
24918 #. type: textblock
24919 #: ../fish/guestfish-actions.pod:4094
24920 msgid ""
24921 "Single 7-bit-byte characters like ASCII and the ASCII-compatible parts of "
24922 "ISO-8859-X (this is what L</strings> uses)."
24923 msgstr ""
24924
24925 #. type: =head2
24926 #: ../fish/guestfish-actions.pod:4126
24927 msgid "swapoff-device"
24928 msgstr ""
24929
24930 #. type: verbatim
24931 #: ../fish/guestfish-actions.pod:4128
24932 #, no-wrap
24933 msgid ""
24934 " swapoff-device device\n"
24935 "\n"
24936 msgstr ""
24937
24938 #. type: textblock
24939 #: ../fish/guestfish-actions.pod:4130
24940 msgid ""
24941 "This command disables the libguestfs appliance swap device or partition "
24942 "named C<device>.  See L</swapon-device>."
24943 msgstr ""
24944
24945 #. type: =head2
24946 #: ../fish/guestfish-actions.pod:4134
24947 msgid "swapoff-file"
24948 msgstr ""
24949
24950 #. type: verbatim
24951 #: ../fish/guestfish-actions.pod:4136
24952 #, no-wrap
24953 msgid ""
24954 " swapoff-file file\n"
24955 "\n"
24956 msgstr ""
24957
24958 #. type: =head2
24959 #: ../fish/guestfish-actions.pod:4140
24960 msgid "swapoff-label"
24961 msgstr ""
24962
24963 #. type: verbatim
24964 #: ../fish/guestfish-actions.pod:4142
24965 #, no-wrap
24966 msgid ""
24967 " swapoff-label label\n"
24968 "\n"
24969 msgstr ""
24970
24971 #. type: =head2
24972 #: ../fish/guestfish-actions.pod:4147
24973 msgid "swapoff-uuid"
24974 msgstr ""
24975
24976 #. type: verbatim
24977 #: ../fish/guestfish-actions.pod:4149
24978 #, no-wrap
24979 msgid ""
24980 " swapoff-uuid uuid\n"
24981 "\n"
24982 msgstr ""
24983
24984 #. type: =head2
24985 #: ../fish/guestfish-actions.pod:4154
24986 msgid "swapon-device"
24987 msgstr ""
24988
24989 #. type: verbatim
24990 #: ../fish/guestfish-actions.pod:4156
24991 #, no-wrap
24992 msgid ""
24993 " swapon-device device\n"
24994 "\n"
24995 msgstr ""
24996
24997 #. type: textblock
24998 #: ../fish/guestfish-actions.pod:4158
24999 msgid ""
25000 "This command enables the libguestfs appliance to use the swap device or "
25001 "partition named C<device>.  The increased memory is made available for all "
25002 "commands, for example those run using L</command> or L</sh>."
25003 msgstr ""
25004
25005 #. type: =head2
25006 #: ../fish/guestfish-actions.pod:4170
25007 msgid "swapon-file"
25008 msgstr ""
25009
25010 #. type: verbatim
25011 #: ../fish/guestfish-actions.pod:4172
25012 #, no-wrap
25013 msgid ""
25014 " swapon-file file\n"
25015 "\n"
25016 msgstr ""
25017
25018 #. type: textblock
25019 #: ../fish/guestfish-actions.pod:4174
25020 msgid "This command enables swap to a file.  See L</swapon-device> for other notes."
25021 msgstr ""
25022
25023 #. type: =head2
25024 #: ../fish/guestfish-actions.pod:4177
25025 msgid "swapon-label"
25026 msgstr ""
25027
25028 #. type: verbatim
25029 #: ../fish/guestfish-actions.pod:4179
25030 #, no-wrap
25031 msgid ""
25032 " swapon-label label\n"
25033 "\n"
25034 msgstr ""
25035
25036 #. type: textblock
25037 #: ../fish/guestfish-actions.pod:4181
25038 msgid ""
25039 "This command enables swap to a labeled swap partition.  See "
25040 "L</swapon-device> for other notes."
25041 msgstr ""
25042
25043 #. type: =head2
25044 #: ../fish/guestfish-actions.pod:4184
25045 msgid "swapon-uuid"
25046 msgstr ""
25047
25048 #. type: verbatim
25049 #: ../fish/guestfish-actions.pod:4186
25050 #, no-wrap
25051 msgid ""
25052 " swapon-uuid uuid\n"
25053 "\n"
25054 msgstr ""
25055
25056 #. type: textblock
25057 #: ../fish/guestfish-actions.pod:4188
25058 msgid ""
25059 "This command enables swap to a swap partition with the given UUID.  See "
25060 "L</swapon-device> for other notes."
25061 msgstr ""
25062
25063 #. type: =head2
25064 #: ../fish/guestfish-actions.pod:4191
25065 msgid "sync"
25066 msgstr ""
25067
25068 #. type: verbatim
25069 #: ../fish/guestfish-actions.pod:4193
25070 #, no-wrap
25071 msgid ""
25072 " sync\n"
25073 "\n"
25074 msgstr ""
25075
25076 #. type: =head2
25077 #: ../fish/guestfish-actions.pod:4201
25078 msgid "tail"
25079 msgstr ""
25080
25081 #. type: verbatim
25082 #: ../fish/guestfish-actions.pod:4203
25083 #, no-wrap
25084 msgid ""
25085 " tail path\n"
25086 "\n"
25087 msgstr ""
25088
25089 #. type: =head2
25090 #: ../fish/guestfish-actions.pod:4211
25091 msgid "tail-n"
25092 msgstr ""
25093
25094 #. type: verbatim
25095 #: ../fish/guestfish-actions.pod:4213
25096 #, no-wrap
25097 msgid ""
25098 " tail-n nrlines path\n"
25099 "\n"
25100 msgstr ""
25101
25102 #. type: =head2
25103 #: ../fish/guestfish-actions.pod:4226
25104 msgid "tar-in"
25105 msgstr ""
25106
25107 #. type: verbatim
25108 #: ../fish/guestfish-actions.pod:4228
25109 #, no-wrap
25110 msgid ""
25111 " tar-in (tarfile|-) directory\n"
25112 "\n"
25113 msgstr ""
25114
25115 #. type: textblock
25116 #: ../fish/guestfish-actions.pod:4233
25117 msgid "To upload a compressed tarball, use L</tgz-in> or L</txz-in>."
25118 msgstr ""
25119
25120 #. type: =head2
25121 #: ../fish/guestfish-actions.pod:4238
25122 msgid "tar-out"
25123 msgstr ""
25124
25125 #. type: verbatim
25126 #: ../fish/guestfish-actions.pod:4240
25127 #, no-wrap
25128 msgid ""
25129 " tar-out directory (tarfile|-)\n"
25130 "\n"
25131 msgstr ""
25132
25133 #. type: textblock
25134 #: ../fish/guestfish-actions.pod:4245
25135 msgid "To download a compressed tarball, use L</tgz-out> or L</txz-out>."
25136 msgstr ""
25137
25138 #. type: =head2
25139 #: ../fish/guestfish-actions.pod:4250
25140 msgid "tgz-in"
25141 msgstr ""
25142
25143 #. type: verbatim
25144 #: ../fish/guestfish-actions.pod:4252
25145 #, no-wrap
25146 msgid ""
25147 " tgz-in (tarball|-) directory\n"
25148 "\n"
25149 msgstr ""
25150
25151 #. type: textblock
25152 #: ../fish/guestfish-actions.pod:4257
25153 msgid "To upload an uncompressed tarball, use L</tar-in>."
25154 msgstr ""
25155
25156 #. type: =head2
25157 #: ../fish/guestfish-actions.pod:4261
25158 msgid "tgz-out"
25159 msgstr ""
25160
25161 #. type: verbatim
25162 #: ../fish/guestfish-actions.pod:4263
25163 #, no-wrap
25164 msgid ""
25165 " tgz-out directory (tarball|-)\n"
25166 "\n"
25167 msgstr ""
25168
25169 #. type: textblock
25170 #: ../fish/guestfish-actions.pod:4268
25171 msgid "To download an uncompressed tarball, use L</tar-out>."
25172 msgstr ""
25173
25174 #. type: =head2
25175 #: ../fish/guestfish-actions.pod:4272
25176 msgid "touch"
25177 msgstr ""
25178
25179 #. type: verbatim
25180 #: ../fish/guestfish-actions.pod:4274
25181 #, no-wrap
25182 msgid ""
25183 " touch path\n"
25184 "\n"
25185 msgstr ""
25186
25187 #. type: =head2
25188 #: ../fish/guestfish-actions.pod:4283
25189 msgid "truncate"
25190 msgstr ""
25191
25192 #. type: verbatim
25193 #: ../fish/guestfish-actions.pod:4285
25194 #, no-wrap
25195 msgid ""
25196 " truncate path\n"
25197 "\n"
25198 msgstr ""
25199
25200 #. type: =head2
25201 #: ../fish/guestfish-actions.pod:4290
25202 msgid "truncate-size"
25203 msgstr ""
25204
25205 #. type: verbatim
25206 #: ../fish/guestfish-actions.pod:4292
25207 #, no-wrap
25208 msgid ""
25209 " truncate-size path size\n"
25210 "\n"
25211 msgstr ""
25212
25213 #. type: textblock
25214 #: ../fish/guestfish-actions.pod:4297
25215 msgid ""
25216 "If the current file size is less than C<size> then the file is extended to "
25217 "the required size with zero bytes.  This creates a sparse file (ie. disk "
25218 "blocks are not allocated for the file until you write to it).  To create a "
25219 "non-sparse file of zeroes, use L</fallocate64> instead."
25220 msgstr ""
25221
25222 #. type: =head2
25223 #: ../fish/guestfish-actions.pod:4303
25224 msgid "tune2fs-l"
25225 msgstr ""
25226
25227 #. type: verbatim
25228 #: ../fish/guestfish-actions.pod:4305
25229 #, no-wrap
25230 msgid ""
25231 " tune2fs-l device\n"
25232 "\n"
25233 msgstr ""
25234
25235 #. type: =head2
25236 #: ../fish/guestfish-actions.pod:4315
25237 msgid "txz-in"
25238 msgstr ""
25239
25240 #. type: verbatim
25241 #: ../fish/guestfish-actions.pod:4317
25242 #, no-wrap
25243 msgid ""
25244 " txz-in (tarball|-) directory\n"
25245 "\n"
25246 msgstr ""
25247
25248 #. type: =head2
25249 #: ../fish/guestfish-actions.pod:4324
25250 msgid "txz-out"
25251 msgstr ""
25252
25253 #. type: verbatim
25254 #: ../fish/guestfish-actions.pod:4326
25255 #, no-wrap
25256 msgid ""
25257 " txz-out directory (tarball|-)\n"
25258 "\n"
25259 msgstr ""
25260
25261 #. type: =head2
25262 #: ../fish/guestfish-actions.pod:4333
25263 msgid "umask"
25264 msgstr ""
25265
25266 #. type: verbatim
25267 #: ../fish/guestfish-actions.pod:4335
25268 #, no-wrap
25269 msgid ""
25270 " umask mask\n"
25271 "\n"
25272 msgstr ""
25273
25274 #. type: textblock
25275 #: ../fish/guestfish-actions.pod:4349
25276 msgid "See also L</get-umask>, L<umask(2)>, L</mknod>, L</mkdir>."
25277 msgstr ""
25278
25279 #. type: =head2
25280 #: ../fish/guestfish-actions.pod:4354
25281 msgid "umount"
25282 msgstr ""
25283
25284 #. type: =head2
25285 #: ../fish/guestfish-actions.pod:4356
25286 msgid "unmount"
25287 msgstr ""
25288
25289 #. type: verbatim
25290 #: ../fish/guestfish-actions.pod:4358
25291 #, no-wrap
25292 msgid ""
25293 " umount pathordevice\n"
25294 "\n"
25295 msgstr ""
25296
25297 #. type: =head2
25298 #: ../fish/guestfish-actions.pod:4364
25299 msgid "umount-all"
25300 msgstr ""
25301
25302 #. type: =head2
25303 #: ../fish/guestfish-actions.pod:4366
25304 msgid "unmount-all"
25305 msgstr ""
25306
25307 #. type: verbatim
25308 #: ../fish/guestfish-actions.pod:4368
25309 #, no-wrap
25310 msgid ""
25311 " umount-all\n"
25312 "\n"
25313 msgstr ""
25314
25315 #. type: =head2
25316 #: ../fish/guestfish-actions.pod:4374
25317 msgid "upload"
25318 msgstr ""
25319
25320 #. type: verbatim
25321 #: ../fish/guestfish-actions.pod:4376
25322 #, no-wrap
25323 msgid ""
25324 " upload (filename|-) remotefilename\n"
25325 "\n"
25326 msgstr ""
25327
25328 #. type: textblock
25329 #: ../fish/guestfish-actions.pod:4383
25330 msgid "See also L</download>."
25331 msgstr ""
25332
25333 #. type: =head2
25334 #: ../fish/guestfish-actions.pod:4387
25335 msgid "upload-offset"
25336 msgstr ""
25337
25338 #. type: verbatim
25339 #: ../fish/guestfish-actions.pod:4389
25340 #, no-wrap
25341 msgid ""
25342 " upload-offset (filename|-) remotefilename offset\n"
25343 "\n"
25344 msgstr ""
25345
25346 #. type: textblock
25347 #: ../fish/guestfish-actions.pod:4401
25348 msgid ""
25349 "Note that there is no limit on the amount of data that can be uploaded with "
25350 "this call, unlike with L</pwrite>, and this call always writes the full "
25351 "amount unless an error occurs."
25352 msgstr ""
25353
25354 #. type: textblock
25355 #: ../fish/guestfish-actions.pod:4406
25356 msgid "See also L</upload>, L</pwrite>."
25357 msgstr ""
25358
25359 #. type: =head2
25360 #: ../fish/guestfish-actions.pod:4410
25361 msgid "utimens"
25362 msgstr ""
25363
25364 #. type: verbatim
25365 #: ../fish/guestfish-actions.pod:4412
25366 #, no-wrap
25367 msgid ""
25368 " utimens path atsecs atnsecs mtsecs mtnsecs\n"
25369 "\n"
25370 msgstr ""
25371
25372 #. type: =head2
25373 #: ../fish/guestfish-actions.pod:4431
25374 msgid "version"
25375 msgstr ""
25376
25377 #. type: verbatim
25378 #: ../fish/guestfish-actions.pod:4433
25379 #, no-wrap
25380 msgid ""
25381 " version\n"
25382 "\n"
25383 msgstr ""
25384
25385 #. type: textblock
25386 #: ../fish/guestfish-actions.pod:4460
25387 msgid ""
25388 "I<Note:> Don't use this call to test for availability of features.  In "
25389 "enterprise distributions we backport features from later versions into "
25390 "earlier versions, making this an unreliable way to test for features.  Use "
25391 "L</available> instead."
25392 msgstr ""
25393
25394 #. type: =head2
25395 #: ../fish/guestfish-actions.pod:4466
25396 msgid "vfs-label"
25397 msgstr ""
25398
25399 #. type: verbatim
25400 #: ../fish/guestfish-actions.pod:4468
25401 #, no-wrap
25402 msgid ""
25403 " vfs-label device\n"
25404 "\n"
25405 msgstr ""
25406
25407 #. type: textblock
25408 #: ../fish/guestfish-actions.pod:4475
25409 msgid "To find a filesystem from the label, use L</findfs-label>."
25410 msgstr ""
25411
25412 #. type: =head2
25413 #: ../fish/guestfish-actions.pod:4477
25414 msgid "vfs-type"
25415 msgstr ""
25416
25417 #. type: verbatim
25418 #: ../fish/guestfish-actions.pod:4479
25419 #, no-wrap
25420 msgid ""
25421 " vfs-type device\n"
25422 "\n"
25423 msgstr ""
25424
25425 #. type: =head2
25426 #: ../fish/guestfish-actions.pod:4489
25427 msgid "vfs-uuid"
25428 msgstr ""
25429
25430 #. type: verbatim
25431 #: ../fish/guestfish-actions.pod:4491
25432 #, no-wrap
25433 msgid ""
25434 " vfs-uuid device\n"
25435 "\n"
25436 msgstr ""
25437
25438 #. type: textblock
25439 #: ../fish/guestfish-actions.pod:4498
25440 msgid "To find a filesystem from the UUID, use L</findfs-uuid>."
25441 msgstr ""
25442
25443 #. type: =head2
25444 #: ../fish/guestfish-actions.pod:4500
25445 msgid "vg-activate"
25446 msgstr ""
25447
25448 #. type: verbatim
25449 #: ../fish/guestfish-actions.pod:4502
25450 #, no-wrap
25451 msgid ""
25452 " vg-activate true|false 'volgroups ...'\n"
25453 "\n"
25454 msgstr ""
25455
25456 #. type: =head2
25457 #: ../fish/guestfish-actions.pod:4515
25458 msgid "vg-activate-all"
25459 msgstr ""
25460
25461 #. type: verbatim
25462 #: ../fish/guestfish-actions.pod:4517
25463 #, no-wrap
25464 msgid ""
25465 " vg-activate-all true|false\n"
25466 "\n"
25467 msgstr ""
25468
25469 #. type: =head2
25470 #: ../fish/guestfish-actions.pod:4527
25471 msgid "vgcreate"
25472 msgstr ""
25473
25474 #. type: verbatim
25475 #: ../fish/guestfish-actions.pod:4529
25476 #, no-wrap
25477 msgid ""
25478 " vgcreate volgroup 'physvols ...'\n"
25479 "\n"
25480 msgstr ""
25481
25482 #. type: =head2
25483 #: ../fish/guestfish-actions.pod:4534
25484 msgid "vglvuuids"
25485 msgstr ""
25486
25487 #. type: verbatim
25488 #: ../fish/guestfish-actions.pod:4536
25489 #, no-wrap
25490 msgid ""
25491 " vglvuuids vgname\n"
25492 "\n"
25493 msgstr ""
25494
25495 #. type: textblock
25496 #: ../fish/guestfish-actions.pod:4541
25497 msgid ""
25498 "You can use this along with L</lvs> and L</lvuuid> calls to associate "
25499 "logical volumes and volume groups."
25500 msgstr ""
25501
25502 #. type: textblock
25503 #: ../fish/guestfish-actions.pod:4544
25504 msgid "See also L</vgpvuuids>."
25505 msgstr ""
25506
25507 #. type: =head2
25508 #: ../fish/guestfish-actions.pod:4546
25509 msgid "vgpvuuids"
25510 msgstr ""
25511
25512 #. type: verbatim
25513 #: ../fish/guestfish-actions.pod:4548
25514 #, no-wrap
25515 msgid ""
25516 " vgpvuuids vgname\n"
25517 "\n"
25518 msgstr ""
25519
25520 #. type: textblock
25521 #: ../fish/guestfish-actions.pod:4553
25522 msgid ""
25523 "You can use this along with L</pvs> and L</pvuuid> calls to associate "
25524 "physical volumes and volume groups."
25525 msgstr ""
25526
25527 #. type: textblock
25528 #: ../fish/guestfish-actions.pod:4556
25529 msgid "See also L</vglvuuids>."
25530 msgstr ""
25531
25532 #. type: =head2
25533 #: ../fish/guestfish-actions.pod:4558
25534 msgid "vgremove"
25535 msgstr ""
25536
25537 #. type: verbatim
25538 #: ../fish/guestfish-actions.pod:4560
25539 #, no-wrap
25540 msgid ""
25541 " vgremove vgname\n"
25542 "\n"
25543 msgstr ""
25544
25545 #. type: =head2
25546 #: ../fish/guestfish-actions.pod:4567
25547 msgid "vgrename"
25548 msgstr ""
25549
25550 #. type: verbatim
25551 #: ../fish/guestfish-actions.pod:4569
25552 #, no-wrap
25553 msgid ""
25554 " vgrename volgroup newvolgroup\n"
25555 "\n"
25556 msgstr ""
25557
25558 #. type: =head2
25559 #: ../fish/guestfish-actions.pod:4573
25560 msgid "vgs"
25561 msgstr ""
25562
25563 #. type: verbatim
25564 #: ../fish/guestfish-actions.pod:4575
25565 #, no-wrap
25566 msgid ""
25567 " vgs\n"
25568 "\n"
25569 msgstr ""
25570
25571 #. type: textblock
25572 #: ../fish/guestfish-actions.pod:4583
25573 msgid "See also L</vgs-full>."
25574 msgstr ""
25575
25576 #. type: =head2
25577 #: ../fish/guestfish-actions.pod:4585
25578 msgid "vgs-full"
25579 msgstr ""
25580
25581 #. type: verbatim
25582 #: ../fish/guestfish-actions.pod:4587
25583 #, no-wrap
25584 msgid ""
25585 " vgs-full\n"
25586 "\n"
25587 msgstr ""
25588
25589 #. type: =head2
25590 #: ../fish/guestfish-actions.pod:4592
25591 msgid "vgscan"
25592 msgstr ""
25593
25594 #. type: verbatim
25595 #: ../fish/guestfish-actions.pod:4594
25596 #, no-wrap
25597 msgid ""
25598 " vgscan\n"
25599 "\n"
25600 msgstr ""
25601
25602 #. type: =head2
25603 #: ../fish/guestfish-actions.pod:4599
25604 msgid "vguuid"
25605 msgstr ""
25606
25607 #. type: verbatim
25608 #: ../fish/guestfish-actions.pod:4601
25609 #, no-wrap
25610 msgid ""
25611 " vguuid vgname\n"
25612 "\n"
25613 msgstr ""
25614
25615 #. type: =head2
25616 #: ../fish/guestfish-actions.pod:4605
25617 msgid "wc-c"
25618 msgstr ""
25619
25620 #. type: verbatim
25621 #: ../fish/guestfish-actions.pod:4607
25622 #, no-wrap
25623 msgid ""
25624 " wc-c path\n"
25625 "\n"
25626 msgstr ""
25627
25628 #. type: =head2
25629 #: ../fish/guestfish-actions.pod:4612
25630 msgid "wc-l"
25631 msgstr ""
25632
25633 #. type: verbatim
25634 #: ../fish/guestfish-actions.pod:4614
25635 #, no-wrap
25636 msgid ""
25637 " wc-l path\n"
25638 "\n"
25639 msgstr ""
25640
25641 #. type: =head2
25642 #: ../fish/guestfish-actions.pod:4619
25643 msgid "wc-w"
25644 msgstr ""
25645
25646 #. type: verbatim
25647 #: ../fish/guestfish-actions.pod:4621
25648 #, no-wrap
25649 msgid ""
25650 " wc-w path\n"
25651 "\n"
25652 msgstr ""
25653
25654 #. type: =head2
25655 #: ../fish/guestfish-actions.pod:4626
25656 msgid "write"
25657 msgstr ""
25658
25659 #. type: verbatim
25660 #: ../fish/guestfish-actions.pod:4628
25661 #, no-wrap
25662 msgid ""
25663 " write path content\n"
25664 "\n"
25665 msgstr ""
25666
25667 #. type: =head2
25668 #: ../fish/guestfish-actions.pod:4636
25669 msgid "write-file"
25670 msgstr ""
25671
25672 #. type: verbatim
25673 #: ../fish/guestfish-actions.pod:4638
25674 #, no-wrap
25675 msgid ""
25676 " write-file path content size\n"
25677 "\n"
25678 msgstr ""
25679
25680 #. type: textblock
25681 #: ../fish/guestfish-actions.pod:4654
25682 msgid "This function is deprecated.  In new code, use the L</write> call instead."
25683 msgstr ""
25684
25685 #. type: =head2
25686 #: ../fish/guestfish-actions.pod:4661
25687 msgid "zegrep"
25688 msgstr ""
25689
25690 #. type: verbatim
25691 #: ../fish/guestfish-actions.pod:4663
25692 #, no-wrap
25693 msgid ""
25694 " zegrep regex path\n"
25695 "\n"
25696 msgstr ""
25697
25698 #. type: =head2
25699 #: ../fish/guestfish-actions.pod:4671
25700 msgid "zegrepi"
25701 msgstr ""
25702
25703 #. type: verbatim
25704 #: ../fish/guestfish-actions.pod:4673
25705 #, no-wrap
25706 msgid ""
25707 " zegrepi regex path\n"
25708 "\n"
25709 msgstr ""
25710
25711 #. type: =head2
25712 #: ../fish/guestfish-actions.pod:4681
25713 msgid "zero"
25714 msgstr ""
25715
25716 #. type: verbatim
25717 #: ../fish/guestfish-actions.pod:4683
25718 #, no-wrap
25719 msgid ""
25720 " zero device\n"
25721 "\n"
25722 msgstr ""
25723
25724 #. type: textblock
25725 #: ../fish/guestfish-actions.pod:4691
25726 msgid "See also: L</zero-device>, L</scrub-device>."
25727 msgstr ""
25728
25729 #. type: =head2
25730 #: ../fish/guestfish-actions.pod:4693
25731 msgid "zero-device"
25732 msgstr ""
25733
25734 #. type: verbatim
25735 #: ../fish/guestfish-actions.pod:4695
25736 #, no-wrap
25737 msgid ""
25738 " zero-device device\n"
25739 "\n"
25740 msgstr ""
25741
25742 #. type: textblock
25743 #: ../fish/guestfish-actions.pod:4697
25744 msgid ""
25745 "This command writes zeroes over the entire C<device>.  Compare with L</zero> "
25746 "which just zeroes the first few blocks of a device."
25747 msgstr ""
25748
25749 #. type: =head2
25750 #: ../fish/guestfish-actions.pod:4704
25751 msgid "zerofree"
25752 msgstr ""
25753
25754 #. type: verbatim
25755 #: ../fish/guestfish-actions.pod:4706
25756 #, no-wrap
25757 msgid ""
25758 " zerofree device\n"
25759 "\n"
25760 msgstr ""
25761
25762 #. type: =head2
25763 #: ../fish/guestfish-actions.pod:4719
25764 msgid "zfgrep"
25765 msgstr ""
25766
25767 #. type: verbatim
25768 #: ../fish/guestfish-actions.pod:4721
25769 #, no-wrap
25770 msgid ""
25771 " zfgrep pattern path\n"
25772 "\n"
25773 msgstr ""
25774
25775 #. type: =head2
25776 #: ../fish/guestfish-actions.pod:4729
25777 msgid "zfgrepi"
25778 msgstr ""
25779
25780 #. type: verbatim
25781 #: ../fish/guestfish-actions.pod:4731
25782 #, no-wrap
25783 msgid ""
25784 " zfgrepi pattern path\n"
25785 "\n"
25786 msgstr ""
25787
25788 #. type: =head2
25789 #: ../fish/guestfish-actions.pod:4739
25790 msgid "zfile"
25791 msgstr ""
25792
25793 #. type: verbatim
25794 #: ../fish/guestfish-actions.pod:4741
25795 #, no-wrap
25796 msgid ""
25797 " zfile meth path\n"
25798 "\n"
25799 msgstr ""
25800
25801 #. type: textblock
25802 #: ../fish/guestfish-actions.pod:4748
25803 msgid "Since 1.0.63, use L</file> instead which can now process compressed files."
25804 msgstr ""
25805
25806 #. type: textblock
25807 #: ../fish/guestfish-actions.pod:4751
25808 msgid "This function is deprecated.  In new code, use the L</file> call instead."
25809 msgstr ""
25810
25811 #. type: =head2
25812 #: ../fish/guestfish-actions.pod:4758
25813 msgid "zgrep"
25814 msgstr ""
25815
25816 #. type: verbatim
25817 #: ../fish/guestfish-actions.pod:4760
25818 #, no-wrap
25819 msgid ""
25820 " zgrep regex path\n"
25821 "\n"
25822 msgstr ""
25823
25824 #. type: =head2
25825 #: ../fish/guestfish-actions.pod:4768
25826 msgid "zgrepi"
25827 msgstr ""
25828
25829 #. type: verbatim
25830 #: ../fish/guestfish-actions.pod:4770
25831 #, no-wrap
25832 msgid ""
25833 " zgrepi regex path\n"
25834 "\n"
25835 msgstr ""
25836
25837 #. type: =head2
25838 #: ../fish/guestfish-commands.pod:1
25839 msgid "alloc"
25840 msgstr ""
25841
25842 #. type: =head2
25843 #: ../fish/guestfish-commands.pod:3
25844 msgid "allocate"
25845 msgstr ""
25846
25847 #. type: verbatim
25848 #: ../fish/guestfish-commands.pod:5
25849 #, no-wrap
25850 msgid ""
25851 " alloc filename size\n"
25852 "\n"
25853 msgstr ""
25854
25855 #. type: textblock
25856 #: ../fish/guestfish-commands.pod:7
25857 msgid ""
25858 "This creates an empty (zeroed) file of the given size, and then adds so it "
25859 "can be further examined."
25860 msgstr ""
25861
25862 #. type: textblock
25863 #: ../fish/guestfish-commands.pod:10 ../fish/guestfish-commands.pod:168
25864 msgid "For more advanced image creation, see L<qemu-img(1)> utility."
25865 msgstr ""
25866
25867 #. type: textblock
25868 #: ../fish/guestfish-commands.pod:12 ../fish/guestfish-commands.pod:170
25869 msgid "Size can be specified using standard suffixes, eg. C<1M>."
25870 msgstr ""
25871
25872 #. type: textblock
25873 #: ../fish/guestfish-commands.pod:14
25874 msgid ""
25875 "To create a sparse file, use L</sparse> instead.  To create a prepared disk "
25876 "image, see L</PREPARED DISK IMAGES>."
25877 msgstr ""
25878
25879 #. type: =head2
25880 #: ../fish/guestfish-commands.pod:17
25881 msgid "copy-in"
25882 msgstr ""
25883
25884 #. type: verbatim
25885 #: ../fish/guestfish-commands.pod:19
25886 #, no-wrap
25887 msgid ""
25888 " copy-in local [local ...] /remotedir\n"
25889 "\n"
25890 msgstr ""
25891
25892 #. type: textblock
25893 #: ../fish/guestfish-commands.pod:21
25894 msgid ""
25895 "C<copy-in> copies local files or directories recursively into the disk "
25896 "image, placing them in the directory called C</remotedir> (which must "
25897 "exist).  This guestfish meta-command turns into a sequence of L</tar-in> and "
25898 "other commands as necessary."
25899 msgstr ""
25900
25901 #. type: textblock
25902 #: ../fish/guestfish-commands.pod:26
25903 msgid ""
25904 "Multiple local files and directories can be specified, but the last "
25905 "parameter must always be a remote directory.  Wildcards cannot be used."
25906 msgstr ""
25907
25908 #. type: =head2
25909 #: ../fish/guestfish-commands.pod:30
25910 msgid "copy-out"
25911 msgstr ""
25912
25913 #. type: verbatim
25914 #: ../fish/guestfish-commands.pod:32
25915 #, no-wrap
25916 msgid ""
25917 " copy-out remote [remote ...] localdir\n"
25918 "\n"
25919 msgstr ""
25920
25921 #. type: textblock
25922 #: ../fish/guestfish-commands.pod:34
25923 msgid ""
25924 "C<copy-out> copies remote files or directories recursively out of the disk "
25925 "image, placing them on the host disk in a local directory called C<localdir> "
25926 "(which must exist).  This guestfish meta-command turns into a sequence of "
25927 "L</download>, L</tar-out> and other commands as necessary."
25928 msgstr ""
25929
25930 #. type: textblock
25931 #: ../fish/guestfish-commands.pod:40
25932 msgid ""
25933 "Multiple remote files and directories can be specified, but the last "
25934 "parameter must always be a local directory.  To download to the current "
25935 "directory, use C<.> as in:"
25936 msgstr ""
25937
25938 #. type: verbatim
25939 #: ../fish/guestfish-commands.pod:44
25940 #, no-wrap
25941 msgid ""
25942 " copy-out /home .\n"
25943 "\n"
25944 msgstr ""
25945
25946 #. type: textblock
25947 #: ../fish/guestfish-commands.pod:46
25948 msgid ""
25949 "Wildcards cannot be used in the ordinary command, but you can use them with "
25950 "the help of L</glob> like this:"
25951 msgstr ""
25952
25953 #. type: verbatim
25954 #: ../fish/guestfish-commands.pod:49
25955 #, no-wrap
25956 msgid ""
25957 " glob copy-out /home/* .\n"
25958 "\n"
25959 msgstr ""
25960
25961 #. type: =head2
25962 #: ../fish/guestfish-commands.pod:51
25963 msgid "echo"
25964 msgstr ""
25965
25966 #. type: verbatim
25967 #: ../fish/guestfish-commands.pod:53
25968 #, no-wrap
25969 msgid ""
25970 " echo [params ...]\n"
25971 "\n"
25972 msgstr ""
25973
25974 #. type: textblock
25975 #: ../fish/guestfish-commands.pod:55
25976 msgid "This echos the parameters to the terminal."
25977 msgstr ""
25978
25979 #. type: =head2
25980 #: ../fish/guestfish-commands.pod:57
25981 msgid "edit"
25982 msgstr ""
25983
25984 #. type: =head2
25985 #: ../fish/guestfish-commands.pod:59
25986 msgid "vi"
25987 msgstr ""
25988
25989 #. type: =head2
25990 #: ../fish/guestfish-commands.pod:61
25991 msgid "emacs"
25992 msgstr ""
25993
25994 #. type: verbatim
25995 #: ../fish/guestfish-commands.pod:63
25996 #, no-wrap
25997 msgid ""
25998 " edit filename\n"
25999 "\n"
26000 msgstr ""
26001
26002 #. type: textblock
26003 #: ../fish/guestfish-commands.pod:65
26004 msgid ""
26005 "This is used to edit a file.  It downloads the file, edits it locally using "
26006 "your editor, then uploads the result."
26007 msgstr ""
26008
26009 #. type: textblock
26010 #: ../fish/guestfish-commands.pod:68
26011 msgid ""
26012 "The editor is C<$EDITOR>.  However if you use the alternate commands C<vi> "
26013 "or C<emacs> you will get those corresponding editors."
26014 msgstr ""
26015
26016 #. type: =head2
26017 #: ../fish/guestfish-commands.pod:72
26018 msgid "glob"
26019 msgstr ""
26020
26021 #. type: verbatim
26022 #: ../fish/guestfish-commands.pod:74
26023 #, no-wrap
26024 msgid ""
26025 " glob command args...\n"
26026 "\n"
26027 msgstr ""
26028
26029 #. type: textblock
26030 #: ../fish/guestfish-commands.pod:76
26031 msgid ""
26032 "Expand wildcards in any paths in the args list, and run C<command> "
26033 "repeatedly on each matching path."
26034 msgstr ""
26035
26036 #. type: textblock
26037 #: ../fish/guestfish-commands.pod:79
26038 msgid "See L</WILDCARDS AND GLOBBING>."
26039 msgstr ""
26040
26041 #. type: =head2
26042 #: ../fish/guestfish-commands.pod:81
26043 msgid "hexedit"
26044 msgstr ""
26045
26046 #. type: verbatim
26047 #: ../fish/guestfish-commands.pod:83
26048 #, no-wrap
26049 msgid ""
26050 " hexedit <filename|device>\n"
26051 " hexedit <filename|device> <max>\n"
26052 " hexedit <filename|device> <start> <max>\n"
26053 "\n"
26054 msgstr ""
26055
26056 #. type: textblock
26057 #: ../fish/guestfish-commands.pod:87
26058 msgid ""
26059 "Use hexedit (a hex editor) to edit all or part of a binary file or block "
26060 "device."
26061 msgstr ""
26062
26063 #. type: textblock
26064 #: ../fish/guestfish-commands.pod:90
26065 msgid ""
26066 "This command works by downloading potentially the whole file or device, "
26067 "editing it locally, then uploading it.  If the file or device is large, you "
26068 "have to specify which part you wish to edit by using C<max> and/or C<start> "
26069 "C<max> parameters.  C<start> and C<max> are specified in bytes, with the "
26070 "usual modifiers allowed such as C<1M> (1 megabyte)."
26071 msgstr ""
26072
26073 #. type: textblock
26074 #: ../fish/guestfish-commands.pod:97
26075 msgid "For example to edit the first few sectors of a disk you might do:"
26076 msgstr ""
26077
26078 #. type: verbatim
26079 #: ../fish/guestfish-commands.pod:100
26080 #, no-wrap
26081 msgid ""
26082 " hexedit /dev/sda 1M\n"
26083 "\n"
26084 msgstr ""
26085
26086 #. type: textblock
26087 #: ../fish/guestfish-commands.pod:102
26088 msgid ""
26089 "which would allow you to edit anywhere within the first megabyte of the "
26090 "disk."
26091 msgstr ""
26092
26093 #. type: textblock
26094 #: ../fish/guestfish-commands.pod:105
26095 msgid "To edit the superblock of an ext2 filesystem on C</dev/sda1>, do:"
26096 msgstr ""
26097
26098 #. type: verbatim
26099 #: ../fish/guestfish-commands.pod:107
26100 #, no-wrap
26101 msgid ""
26102 " hexedit /dev/sda1 0x400 0x400\n"
26103 "\n"
26104 msgstr ""
26105
26106 #. type: textblock
26107 #: ../fish/guestfish-commands.pod:109
26108 msgid "(assuming the superblock is in the standard location)."
26109 msgstr ""
26110
26111 #. type: textblock
26112 #: ../fish/guestfish-commands.pod:111
26113 msgid ""
26114 "This command requires the external L<hexedit(1)> program.  You can specify "
26115 "another program to use by setting the C<HEXEDITOR> environment variable."
26116 msgstr ""
26117
26118 #. type: textblock
26119 #: ../fish/guestfish-commands.pod:115
26120 msgid "See also L</hexdump>."
26121 msgstr ""
26122
26123 #. type: =head2
26124 #: ../fish/guestfish-commands.pod:117
26125 msgid "lcd"
26126 msgstr ""
26127
26128 #. type: verbatim
26129 #: ../fish/guestfish-commands.pod:119
26130 #, no-wrap
26131 msgid ""
26132 " lcd directory\n"
26133 "\n"
26134 msgstr ""
26135
26136 #. type: textblock
26137 #: ../fish/guestfish-commands.pod:121
26138 msgid "Change the local directory, ie. the current directory of guestfish itself."
26139 msgstr ""
26140
26141 #. type: textblock
26142 #: ../fish/guestfish-commands.pod:124
26143 msgid "Note that C<!cd> won't do what you might expect."
26144 msgstr ""
26145
26146 #. type: =head2
26147 #: ../fish/guestfish-commands.pod:126
26148 msgid "man"
26149 msgstr ""
26150
26151 #. type: =head2
26152 #: ../fish/guestfish-commands.pod:128
26153 msgid "manual"
26154 msgstr ""
26155
26156 #. type: verbatim
26157 #: ../fish/guestfish-commands.pod:130
26158 #, no-wrap
26159 msgid ""
26160 "  man\n"
26161 "\n"
26162 msgstr ""
26163
26164 #. type: textblock
26165 #: ../fish/guestfish-commands.pod:132
26166 msgid "Opens the manual page for guestfish."
26167 msgstr ""
26168
26169 #. type: =head2
26170 #: ../fish/guestfish-commands.pod:134
26171 msgid "more"
26172 msgstr ""
26173
26174 #. type: =head2
26175 #: ../fish/guestfish-commands.pod:136
26176 msgid "less"
26177 msgstr ""
26178
26179 #. type: verbatim
26180 #: ../fish/guestfish-commands.pod:138
26181 #, no-wrap
26182 msgid ""
26183 " more filename\n"
26184 "\n"
26185 msgstr ""
26186
26187 #. type: verbatim
26188 #: ../fish/guestfish-commands.pod:140
26189 #, no-wrap
26190 msgid ""
26191 " less filename\n"
26192 "\n"
26193 msgstr ""
26194
26195 #. type: textblock
26196 #: ../fish/guestfish-commands.pod:142
26197 msgid "This is used to view a file."
26198 msgstr ""
26199
26200 #. type: textblock
26201 #: ../fish/guestfish-commands.pod:144
26202 msgid ""
26203 "The default viewer is C<$PAGER>.  However if you use the alternate command "
26204 "C<less> you will get the C<less> command specifically."
26205 msgstr ""
26206
26207 #. type: =head2
26208 #: ../fish/guestfish-commands.pod:147
26209 msgid "reopen"
26210 msgstr ""
26211
26212 #. type: verbatim
26213 #: ../fish/guestfish-commands.pod:149
26214 #, no-wrap
26215 msgid ""
26216 "  reopen\n"
26217 "\n"
26218 msgstr ""
26219
26220 #. type: textblock
26221 #: ../fish/guestfish-commands.pod:151
26222 msgid ""
26223 "Close and reopen the libguestfs handle.  It is not necessary to use this "
26224 "normally, because the handle is closed properly when guestfish exits.  "
26225 "However this is occasionally useful for testing."
26226 msgstr ""
26227
26228 #. type: =head2
26229 #: ../fish/guestfish-commands.pod:155
26230 msgid "sparse"
26231 msgstr ""
26232
26233 #. type: verbatim
26234 #: ../fish/guestfish-commands.pod:157
26235 #, no-wrap
26236 msgid ""
26237 " sparse filename size\n"
26238 "\n"
26239 msgstr ""
26240
26241 #. type: textblock
26242 #: ../fish/guestfish-commands.pod:159
26243 msgid ""
26244 "This creates an empty sparse file of the given size, and then adds so it can "
26245 "be further examined."
26246 msgstr ""
26247
26248 #. type: textblock
26249 #: ../fish/guestfish-commands.pod:162
26250 msgid ""
26251 "In all respects it works the same as the L</alloc> command, except that the "
26252 "image file is allocated sparsely, which means that disk blocks are not "
26253 "assigned to the file until they are needed.  Sparse disk files only use "
26254 "space when written to, but they are slower and there is a danger you could "
26255 "run out of real disk space during a write operation."
26256 msgstr ""
26257
26258 #. type: =head2
26259 #: ../fish/guestfish-commands.pod:172
26260 msgid "supported"
26261 msgstr ""
26262
26263 #. type: verbatim
26264 #: ../fish/guestfish-commands.pod:174
26265 #, no-wrap
26266 msgid ""
26267 " supported\n"
26268 "\n"
26269 msgstr ""
26270
26271 #. type: textblock
26272 #: ../fish/guestfish-commands.pod:176
26273 msgid ""
26274 "This command returns a list of the optional groups known to the daemon, and "
26275 "indicates which ones are supported by this build of the libguestfs "
26276 "appliance."
26277 msgstr ""
26278
26279 #. type: textblock
26280 #: ../fish/guestfish-commands.pod:180
26281 msgid "See also L<guestfs(3)/AVAILABILITY>."
26282 msgstr ""
26283
26284 #. type: =head2
26285 #: ../fish/guestfish-commands.pod:182
26286 msgid "time"
26287 msgstr ""
26288
26289 #. type: verbatim
26290 #: ../fish/guestfish-commands.pod:184
26291 #, no-wrap
26292 msgid ""
26293 " time command args...\n"
26294 "\n"
26295 msgstr ""
26296
26297 #. type: textblock
26298 #: ../fish/guestfish-commands.pod:186
26299 msgid ""
26300 "Run the command as usual, but print the elapsed time afterwards.  This can "
26301 "be useful for benchmarking operations."
26302 msgstr ""
26303
26304 #. type: textblock
26305 #: ../test-tool/libguestfs-test-tool.pod:5
26306 msgid "libguestfs-test-tool - End user tests for libguestfs"
26307 msgstr ""
26308
26309 #. type: verbatim
26310 #: ../test-tool/libguestfs-test-tool.pod:9
26311 #, no-wrap
26312 msgid ""
26313 " libguestfs-test-tool [--options]\n"
26314 "\n"
26315 msgstr ""
26316
26317 #. type: textblock
26318 #: ../test-tool/libguestfs-test-tool.pod:13
26319 msgid ""
26320 "libguestfs-test-tool is a test program shipped with libguestfs to end users "
26321 "and developers, to allow them to check basic libguestfs functionality is "
26322 "working.  This is needed because libguestfs occasionally breaks for reasons "
26323 "beyond our control: usually because of changes in the underlying qemu or "
26324 "kernel packages, or the host environment."
26325 msgstr ""
26326
26327 #. type: textblock
26328 #: ../test-tool/libguestfs-test-tool.pod:20
26329 msgid "If you suspect a problem in libguestfs, then just run:"
26330 msgstr ""
26331
26332 #. type: verbatim
26333 #: ../test-tool/libguestfs-test-tool.pod:22
26334 #, no-wrap
26335 msgid ""
26336 " libguestfs-test-tool\n"
26337 "\n"
26338 msgstr ""
26339
26340 #. type: textblock
26341 #: ../test-tool/libguestfs-test-tool.pod:24
26342 msgid "It will print lots of diagnostic messages."
26343 msgstr ""
26344
26345 #. type: textblock
26346 #: ../test-tool/libguestfs-test-tool.pod:26
26347 msgid "If it runs to completion successfully, you will see this near the end:"
26348 msgstr ""
26349
26350 #. type: verbatim
26351 #: ../test-tool/libguestfs-test-tool.pod:28
26352 #, no-wrap
26353 msgid ""
26354 " ===== TEST FINISHED OK =====\n"
26355 "\n"
26356 msgstr ""
26357
26358 #. type: textblock
26359 #: ../test-tool/libguestfs-test-tool.pod:30
26360 msgid "and the test tool will exit with code 0."
26361 msgstr ""
26362
26363 #. type: textblock
26364 #: ../test-tool/libguestfs-test-tool.pod:32
26365 msgid ""
26366 "If it fails (and/or exits with non-zero error code), please paste the "
26367 "B<complete, unedited> output of the test tool into a bug report.  More "
26368 "information about reporting bugs can be found on the "
26369 "L<http://libguestfs.org/> website."
26370 msgstr ""
26371
26372 #. type: =item
26373 #: ../test-tool/libguestfs-test-tool.pod:41
26374 msgid "I<--help>"
26375 msgstr ""
26376
26377 #. type: textblock
26378 #: ../test-tool/libguestfs-test-tool.pod:43
26379 msgid "Display short usage information and exit."
26380 msgstr ""
26381
26382 #. type: =item
26383 #: ../test-tool/libguestfs-test-tool.pod:45
26384 msgid "I<--helper /path/to/libguestfs-test-tool-helper>"
26385 msgstr ""
26386
26387 #. type: textblock
26388 #: ../test-tool/libguestfs-test-tool.pod:47
26389 msgid ""
26390 "Pass an alternate name for the helper program.  libguestfs-test-tool will "
26391 "normally look in the C<$libexec> directory that was configured when the tool "
26392 "was built."
26393 msgstr ""
26394
26395 #. type: =item
26396 #: ../test-tool/libguestfs-test-tool.pod:51
26397 msgid "I<--qemu qemu_binary>"
26398 msgstr ""
26399
26400 #. type: textblock
26401 #: ../test-tool/libguestfs-test-tool.pod:53
26402 msgid ""
26403 "If you have downloaded another qemu binary, point this option at the full "
26404 "path of the binary to try it."
26405 msgstr ""
26406
26407 #. type: =item
26408 #: ../test-tool/libguestfs-test-tool.pod:56
26409 msgid "I<--qemudir qemu_source_dir>"
26410 msgstr ""
26411
26412 #. type: textblock
26413 #: ../test-tool/libguestfs-test-tool.pod:58
26414 msgid ""
26415 "If you have compiled qemu from source, point this option at the source "
26416 "directory to try it."
26417 msgstr ""
26418
26419 #. type: =item
26420 #: ../test-tool/libguestfs-test-tool.pod:61
26421 msgid "I<--timeout N>"
26422 msgstr ""
26423
26424 #. type: textblock
26425 #: ../test-tool/libguestfs-test-tool.pod:63
26426 msgid ""
26427 "Set the launch timeout to C<N> seconds.  The default is 120 seconds which "
26428 "does not usually need to be adjusted unless your machine is very slow."
26429 msgstr ""
26430
26431 #. type: =head1
26432 #: ../test-tool/libguestfs-test-tool.pod:69
26433 msgid "TRYING OUT A DIFFERENT VERSION OF QEMU"
26434 msgstr ""
26435
26436 #. type: textblock
26437 #: ../test-tool/libguestfs-test-tool.pod:71
26438 msgid ""
26439 "If you have compiled another version of qemu from source and would like to "
26440 "try that, then you can use the I<--qemudir> option to point to the qemu "
26441 "source directory."
26442 msgstr ""
26443
26444 #. type: textblock
26445 #: ../test-tool/libguestfs-test-tool.pod:75
26446 msgid ""
26447 "If you have downloaded a qemu binary from somewhere, use the I<--qemu> "
26448 "option to point to the binary."
26449 msgstr ""
26450
26451 #. type: textblock
26452 #: ../test-tool/libguestfs-test-tool.pod:78
26453 msgid ""
26454 "When using an alternate qemu with libguestfs, usually you would need to "
26455 "write a qemu wrapper script (see section I<QEMU WRAPPERS> in "
26456 "L<guestfs(3)>).  libguestfs-test-tool writes a temporary qemu wrapper script "
26457 "when you use either of the I<--qemudir> or I<--qemu> options."
26458 msgstr ""
26459
26460 #. type: textblock
26461 #: ../test-tool/libguestfs-test-tool.pod:85
26462 msgid ""
26463 "libguestfs-test-tool returns I<0> if the tests completed without error, or "
26464 "I<1> if there was an error."
26465 msgstr ""
26466
26467 #. type: =item
26468 #: ../test-tool/libguestfs-test-tool.pod:92
26469 msgid "/usr/libexec/libguestfs-test-tool-helper"
26470 msgstr ""
26471
26472 #. type: textblock
26473 #: ../test-tool/libguestfs-test-tool.pod:94
26474 msgid ""
26475 "This helper program is run inside the appliance and provides additional "
26476 "tests."
26477 msgstr ""
26478
26479 #. type: =item
26480 #: ../test-tool/libguestfs-test-tool.pod:97
26481 msgid "/usr/bin/mkisofs"
26482 msgstr ""
26483
26484 #. type: textblock
26485 #: ../test-tool/libguestfs-test-tool.pod:99
26486 msgid ""
26487 "The C<mkisofs> command is required in order to construct a CD-ROM ISO file "
26488 "which is used as part of the tests."
26489 msgstr ""
26490
26491 #. type: textblock
26492 #: ../test-tool/libguestfs-test-tool.pod:106
26493 msgid ""
26494 "For the full list of environment variables which may affect libguestfs, "
26495 "please see the L<guestfs(3)> manual page."
26496 msgstr ""
26497
26498 #. type: textblock
26499 #: ../test-tool/libguestfs-test-tool.pod:111
26500 msgid "L<guestfs(3)>, L<http://libguestfs.org/>, L<http://qemu.org/>."
26501 msgstr ""
26502
26503 #. type: textblock
26504 #: ../test-tool/libguestfs-test-tool.pod:121
26505 msgid "Copyright (C) 2009 Red Hat Inc.  L<http://libguestfs.org/>"
26506 msgstr ""
26507
26508 #. type: textblock
26509 #: ../fuse/guestmount.pod:5
26510 msgid "guestmount - Mount a guest filesystem on the host using FUSE and libguestfs"
26511 msgstr ""
26512
26513 #. type: verbatim
26514 #: ../fuse/guestmount.pod:9
26515 #, no-wrap
26516 msgid ""
26517 " guestmount [--options] -a disk.img -m device [--ro] mountpoint\n"
26518 "\n"
26519 msgstr ""
26520
26521 #. type: verbatim
26522 #: ../fuse/guestmount.pod:11
26523 #, no-wrap
26524 msgid ""
26525 " guestmount [--options] -a disk.img -i [--ro] mountpoint\n"
26526 "\n"
26527 msgstr ""
26528
26529 #. type: verbatim
26530 #: ../fuse/guestmount.pod:13
26531 #, no-wrap
26532 msgid ""
26533 " guestmount [--options] -d Guest -i [--ro] mountpoint\n"
26534 "\n"
26535 msgstr ""
26536
26537 #. type: textblock
26538 #: ../fuse/guestmount.pod:17
26539 msgid ""
26540 "You must I<not> use C<guestmount> in read-write mode on live virtual "
26541 "machines.  If you do this, you risk disk corruption in the VM."
26542 msgstr ""
26543
26544 #. type: textblock
26545 #: ../fuse/guestmount.pod:22
26546 msgid ""
26547 "The guestmount program can be used to mount virtual machine filesystems and "
26548 "other disk images on the host.  It uses libguestfs for access to the guest "
26549 "filesystem, and FUSE (the \"filesystem in userspace\") to make it appear as "
26550 "a mountable device."
26551 msgstr ""
26552
26553 #. type: textblock
26554 #: ../fuse/guestmount.pod:27
26555 msgid ""
26556 "Along with other options, you have to give at least one device (I<-a> "
26557 "option) or libvirt domain (I<-d> option), and at least one mountpoint (I<-m> "
26558 "option) or use the I<-i> inspection option.  How this works is better "
26559 "explained in the L<guestfish(1)> manual page, or by looking at the examples "
26560 "below."
26561 msgstr ""
26562
26563 #. type: textblock
26564 #: ../fuse/guestmount.pod:33
26565 msgid ""
26566 "FUSE lets you mount filesystems as non-root.  The mountpoint must be owned "
26567 "by you, and the filesystem will not be visible to any other users unless you "
26568 "make certain global configuration changes to C</etc/fuse.conf>.  To unmount "
26569 "the filesystem, use the C<fusermount -u> command."
26570 msgstr ""
26571
26572 #. type: textblock
26573 #: ../fuse/guestmount.pod:41
26574 msgid ""
26575 "For a typical Windows guest which has its main filesystem on the first "
26576 "partition:"
26577 msgstr ""
26578
26579 #. type: verbatim
26580 #: ../fuse/guestmount.pod:44
26581 #, no-wrap
26582 msgid ""
26583 " guestmount -a windows.img -m /dev/sda1 --ro /mnt\n"
26584 "\n"
26585 msgstr ""
26586
26587 #. type: textblock
26588 #: ../fuse/guestmount.pod:46
26589 msgid ""
26590 "For a typical Linux guest which has a /boot filesystem on the first "
26591 "partition, and the root filesystem on a logical volume:"
26592 msgstr ""
26593
26594 #. type: verbatim
26595 #: ../fuse/guestmount.pod:49
26596 #, no-wrap
26597 msgid ""
26598 " guestmount -a linux.img -m /dev/VG/LV -m /dev/sda1:/boot --ro /mnt\n"
26599 "\n"
26600 msgstr ""
26601
26602 #. type: textblock
26603 #: ../fuse/guestmount.pod:51
26604 msgid "To get libguestfs to detect guest mountpoints for you:"
26605 msgstr ""
26606
26607 #. type: verbatim
26608 #: ../fuse/guestmount.pod:53
26609 #, no-wrap
26610 msgid ""
26611 " guestmount -a guest.img -i --ro /mnt\n"
26612 "\n"
26613 msgstr ""
26614
26615 #. type: textblock
26616 #: ../fuse/guestmount.pod:55
26617 msgid "For a libvirt guest called \"Guest\" you could do:"
26618 msgstr ""
26619
26620 #. type: verbatim
26621 #: ../fuse/guestmount.pod:57
26622 #, no-wrap
26623 msgid ""
26624 " guestmount -d Guest -i --ro /mnt\n"
26625 "\n"
26626 msgstr ""
26627
26628 #. type: textblock
26629 #: ../fuse/guestmount.pod:59
26630 msgid ""
26631 "If you don't know what filesystems are contained in a guest or disk image, "
26632 "use L<virt-filesystems(1)> first:"
26633 msgstr ""
26634
26635 #. type: verbatim
26636 #: ../fuse/guestmount.pod:62
26637 #, no-wrap
26638 msgid ""
26639 " virt-filesystems MyGuest\n"
26640 "\n"
26641 msgstr ""
26642
26643 #. type: textblock
26644 #: ../fuse/guestmount.pod:64
26645 msgid ""
26646 "If you want to trace the libguestfs calls but without excessive debugging "
26647 "information, we recommend:"
26648 msgstr ""
26649
26650 #. type: verbatim
26651 #: ../fuse/guestmount.pod:67
26652 #, no-wrap
26653 msgid ""
26654 " guestmount [...] --trace /mnt\n"
26655 "\n"
26656 msgstr ""
26657
26658 #. type: textblock
26659 #: ../fuse/guestmount.pod:69
26660 msgid "If you want to debug the program, we recommend:"
26661 msgstr ""
26662
26663 #. type: verbatim
26664 #: ../fuse/guestmount.pod:71
26665 #, no-wrap
26666 msgid ""
26667 " guestmount [...] --trace --verbose /mnt\n"
26668 "\n"
26669 msgstr ""
26670
26671 #. type: =item
26672 #: ../fuse/guestmount.pod:77
26673 msgid "B<-a image> | B<--add image>"
26674 msgstr ""
26675
26676 #. type: textblock
26677 #: ../fuse/guestmount.pod:79
26678 msgid "Add a block device or virtual machine image."
26679 msgstr ""
26680
26681 #. type: =item
26682 #: ../fuse/guestmount.pod:84
26683 msgid "B<-c URI> | B<--connect URI>"
26684 msgstr ""
26685
26686 #. type: =item
26687 #: ../fuse/guestmount.pod:90
26688 msgid "B<-d libvirt-domain> | B<--domain libvirt-domain>"
26689 msgstr ""
26690
26691 #. type: =item
26692 #: ../fuse/guestmount.pod:96
26693 msgid "B<--dir-cache-timeout N>"
26694 msgstr ""
26695
26696 #. type: textblock
26697 #: ../fuse/guestmount.pod:98
26698 msgid ""
26699 "Set the readdir cache timeout to I<N> seconds, the default being 60 "
26700 "seconds.  The readdir cache [actually, there are several semi-independent "
26701 "caches] is populated after a readdir(2) call with the stat and extended "
26702 "attributes of the files in the directory, in anticipation that they will be "
26703 "requested soon after."
26704 msgstr ""
26705
26706 #. type: textblock
26707 #: ../fuse/guestmount.pod:104
26708 msgid ""
26709 "There is also a different attribute cache implemented by FUSE (see the FUSE "
26710 "option I<-o attr_timeout>), but the FUSE cache does not anticipate future "
26711 "requests, only cache existing ones."
26712 msgstr ""
26713
26714 #. type: =item
26715 #: ../fuse/guestmount.pod:115
26716 msgid "B<--format=raw|qcow2|..> | B<--format>"
26717 msgstr ""
26718
26719 #. type: textblock
26720 #: ../fuse/guestmount.pod:122
26721 msgid ""
26722 "If you have untrusted raw-format guest disk images, you should use this "
26723 "option to specify the disk format.  This avoids a possible security problem "
26724 "with malicious guests (CVE-2010-3851).  See also "
26725 "L<guestfs(3)/guestfs_add_drive_opts>."
26726 msgstr ""
26727
26728 #. type: =item
26729 #: ../fuse/guestmount.pod:127
26730 msgid "B<--fuse-help>"
26731 msgstr ""
26732
26733 #. type: textblock
26734 #: ../fuse/guestmount.pod:129
26735 msgid "Display help on special FUSE options (see I<-o> below)."
26736 msgstr ""
26737
26738 #. type: textblock
26739 #: ../fuse/guestmount.pod:133
26740 msgid "Display brief help and exit."
26741 msgstr ""
26742
26743 #. type: =item
26744 #: ../fuse/guestmount.pod:135
26745 msgid "B<-i> | B<--inspector>"
26746 msgstr ""
26747
26748 #. type: =item
26749 #: ../fuse/guestmount.pod:146
26750 msgid "B<-m dev[:mnt]> | B<--mount dev[:mnt]>"
26751 msgstr ""
26752
26753 #. type: textblock
26754 #: ../fuse/guestmount.pod:148
26755 msgid ""
26756 "Mount the named partition or logical volume on the given mountpoint B<in the "
26757 "guest> (this has nothing to do with mountpoints in the host)."
26758 msgstr ""
26759
26760 #. type: textblock
26761 #: ../fuse/guestmount.pod:151
26762 msgid ""
26763 "If the mountpoint is omitted, it defaults to C</>.  You have to mount "
26764 "something on C</>."
26765 msgstr ""
26766
26767 #. type: =item
26768 #: ../fuse/guestmount.pod:154
26769 msgid "B<-n> | B<--no-sync>"
26770 msgstr ""
26771
26772 #. type: textblock
26773 #: ../fuse/guestmount.pod:156
26774 msgid ""
26775 "By default, we attempt to sync the guest disk when the FUSE mountpoint is "
26776 "unmounted.  If you specify this option, then we don't attempt to sync the "
26777 "disk.  See the discussion of autosync in the L<guestfs(3)> manpage."
26778 msgstr ""
26779
26780 #. type: =item
26781 #: ../fuse/guestmount.pod:161
26782 msgid "B<-o option> | B<--option option>"
26783 msgstr ""
26784
26785 #. type: textblock
26786 #: ../fuse/guestmount.pod:163
26787 msgid "Pass extra options to FUSE."
26788 msgstr ""
26789
26790 #. type: textblock
26791 #: ../fuse/guestmount.pod:165
26792 msgid ""
26793 "To get a list of all the extra options supported by FUSE, use the command "
26794 "below.  Note that only the FUSE I<-o> options can be passed, and only some "
26795 "of them are a good idea."
26796 msgstr ""
26797
26798 #. type: verbatim
26799 #: ../fuse/guestmount.pod:169
26800 #, no-wrap
26801 msgid ""
26802 " guestmount --fuse-help\n"
26803 "\n"
26804 msgstr ""
26805
26806 #. type: textblock
26807 #: ../fuse/guestmount.pod:171
26808 msgid "Some potentially useful FUSE options:"
26809 msgstr ""
26810
26811 #. type: =item
26812 #: ../fuse/guestmount.pod:175
26813 msgid "B<-o allow_other>"
26814 msgstr ""
26815
26816 #. type: textblock
26817 #: ../fuse/guestmount.pod:177
26818 msgid "Allow other users to see the filesystem."
26819 msgstr ""
26820
26821 #. type: =item
26822 #: ../fuse/guestmount.pod:179
26823 msgid "B<-o attr_timeout=N>"
26824 msgstr ""
26825
26826 #. type: textblock
26827 #: ../fuse/guestmount.pod:181
26828 msgid "Enable attribute caching by FUSE, and set the timeout to I<N> seconds."
26829 msgstr ""
26830
26831 #. type: =item
26832 #: ../fuse/guestmount.pod:183
26833 msgid "B<-o kernel_cache>"
26834 msgstr ""
26835
26836 #. type: textblock
26837 #: ../fuse/guestmount.pod:185
26838 msgid ""
26839 "Allow the kernel to cache files (reduces the number of reads that have to go "
26840 "through the L<guestfs(3)> API).  This is generally a good idea if you can "
26841 "afford the extra memory usage."
26842 msgstr ""
26843
26844 #. type: =item
26845 #: ../fuse/guestmount.pod:189
26846 msgid "B<-o uid=N> B<-o gid=N>"
26847 msgstr ""
26848
26849 #. type: textblock
26850 #: ../fuse/guestmount.pod:191
26851 msgid ""
26852 "Use these options to map all UIDs and GIDs inside the guest filesystem to "
26853 "the chosen values."
26854 msgstr ""
26855
26856 #. type: =item
26857 #: ../fuse/guestmount.pod:196
26858 msgid "B<-r> | B<--ro>"
26859 msgstr ""
26860
26861 #. type: textblock
26862 #: ../fuse/guestmount.pod:198
26863 msgid ""
26864 "Add devices and mount everything read-only.  Also disallow writes and make "
26865 "the disk appear read-only to FUSE."
26866 msgstr ""
26867
26868 #. type: textblock
26869 #: ../fuse/guestmount.pod:201
26870 msgid ""
26871 "This is highly recommended if you are not going to edit the guest disk.  If "
26872 "the guest is running and this option is I<not> supplied, then there is a "
26873 "strong risk of disk corruption in the guest.  We try to prevent this from "
26874 "happening, but it is not always possible."
26875 msgstr ""
26876
26877 #. type: textblock
26878 #: ../fuse/guestmount.pod:206
26879 msgid "See also L<guestfish(1)/OPENING DISKS FOR READ AND WRITE>."
26880 msgstr ""
26881
26882 #. type: textblock
26883 #: ../fuse/guestmount.pod:210
26884 msgid "Enable SELinux support for the guest."
26885 msgstr ""
26886
26887 #. type: =item
26888 #: ../fuse/guestmount.pod:212
26889 msgid "B<-v> | B<--verbose>"
26890 msgstr ""
26891
26892 #. type: textblock
26893 #: ../fuse/guestmount.pod:214
26894 msgid "Enable verbose messages from underlying libguestfs."
26895 msgstr ""
26896
26897 #. type: =item
26898 #: ../fuse/guestmount.pod:216
26899 msgid "B<-V> | B<--version>"
26900 msgstr ""
26901
26902 #. type: textblock
26903 #: ../fuse/guestmount.pod:218
26904 msgid "Display the program version and exit."
26905 msgstr ""
26906
26907 #. type: =item
26908 #: ../fuse/guestmount.pod:220
26909 msgid "B<-w> | B<--rw>"
26910 msgstr ""
26911
26912 #. type: textblock
26913 #: ../fuse/guestmount.pod:222
26914 msgid ""
26915 "This option does nothing at the moment.  See L<guestfish(1)/OPENING DISKS "
26916 "FOR READ AND WRITE>."
26917 msgstr ""
26918
26919 #. type: =item
26920 #: ../fuse/guestmount.pod:225
26921 msgid "B<-x> | B<--trace>"
26922 msgstr ""
26923
26924 #. type: textblock
26925 #: ../fuse/guestmount.pod:227
26926 msgid "Trace libguestfs calls and entry into each FUSE function."
26927 msgstr ""
26928
26929 #. type: textblock
26930 #: ../fuse/guestmount.pod:229
26931 msgid "This also stops the daemon from forking into the background."
26932 msgstr ""
26933
26934 #. type: textblock
26935 #: ../fuse/guestmount.pod:235
26936 msgid ""
26937 "L<guestfish(1)>, L<virt-inspector(1)>, L<virt-cat(1)>, L<virt-edit(1)>, "
26938 "L<virt-tar(1)>, L<guestfs(3)>, L<http://libguestfs.org/>, "
26939 "L<http://fuse.sf.net/>."
26940 msgstr ""
26941
26942 #. type: textblock
26943 #: ../tools/virt-edit.pl:34
26944 msgid "virt-edit - Edit a file in a virtual machine"
26945 msgstr ""
26946
26947 #. type: verbatim
26948 #: ../tools/virt-edit.pl:38
26949 #, no-wrap
26950 msgid ""
26951 " virt-edit [--options] domname file\n"
26952 "\n"
26953 msgstr ""
26954
26955 #. type: verbatim
26956 #: ../tools/virt-edit.pl:40
26957 #, no-wrap
26958 msgid ""
26959 " virt-edit [--options] disk.img [disk.img ...] file\n"
26960 "\n"
26961 msgstr ""
26962
26963 #. type: verbatim
26964 #: ../tools/virt-edit.pl:42
26965 #, no-wrap
26966 msgid ""
26967 " virt-edit [domname|disk.img] file -e 'expr'\n"
26968 "\n"
26969 msgstr ""
26970
26971 #. type: textblock
26972 #: ../tools/virt-edit.pl:46
26973 msgid ""
26974 "You must I<not> use C<virt-edit> on live virtual machines.  If you do this, "
26975 "you risk disk corruption in the VM.  C<virt-edit> tries to stop you from "
26976 "doing this, but doesn't catch all cases."
26977 msgstr ""
26978
26979 #. type: textblock
26980 #: ../tools/virt-edit.pl:52
26981 msgid ""
26982 "C<virt-edit> is a command line tool to edit C<file> where C<file> exists in "
26983 "the named virtual machine (or disk image)."
26984 msgstr ""
26985
26986 #. type: textblock
26987 #: ../tools/virt-edit.pl:55
26988 msgid "If you want to just view a file, use L<virt-cat(1)>."
26989 msgstr ""
26990
26991 #. type: textblock
26992 #: ../tools/virt-edit.pl:57
26993 msgid ""
26994 "For more complex cases you should look at the L<guestfish(1)> tool (see "
26995 "L</USING GUESTFISH> below)."
26996 msgstr ""
26997
26998 #. type: textblock
26999 #: ../tools/virt-edit.pl:60
27000 msgid ""
27001 "C<virt-edit> cannot be used to create a new file, nor to edit multiple "
27002 "files.  L<guestfish(1)> can do that and much more."
27003 msgstr ""
27004
27005 #. type: textblock
27006 #: ../tools/virt-edit.pl:65
27007 msgid "Edit the named files interactively:"
27008 msgstr ""
27009
27010 #. type: verbatim
27011 #: ../tools/virt-edit.pl:67
27012 #, no-wrap
27013 msgid ""
27014 " virt-edit mydomain /boot/grub/grub.conf\n"
27015 "\n"
27016 msgstr ""
27017
27018 #. type: verbatim
27019 #: ../tools/virt-edit.pl:69
27020 #, no-wrap
27021 msgid ""
27022 " virt-edit mydomain /etc/passwd\n"
27023 "\n"
27024 msgstr ""
27025
27026 #. type: textblock
27027 #: ../tools/virt-edit.pl:71
27028 msgid ""
27029 "You can also edit files non-interactively (see L</NON-INTERACTIVE EDITING> "
27030 "below).  To change the init default level to 5:"
27031 msgstr ""
27032
27033 #. type: verbatim
27034 #: ../tools/virt-edit.pl:75
27035 #, no-wrap
27036 msgid ""
27037 " virt-edit mydomain /etc/inittab -e 's/^id:.*/id:5:initdefault:/'\n"
27038 "\n"
27039 msgstr ""
27040
27041 #. type: textblock
27042 #: ../tools/virt-edit.pl:87 ../tools/virt-win-reg.pl:106 ../tools/virt-list-filesystems.pl:63 ../tools/virt-tar.pl:108 ../tools/virt-make-fs.pl:163 ../tools/virt-list-partitions.pl:64
27043 msgid "Display brief help."
27044 msgstr ""
27045
27046 #. type: textblock
27047 #: ../tools/virt-edit.pl:95 ../tools/virt-win-reg.pl:114 ../tools/virt-resize.pl:272 ../tools/virt-list-filesystems.pl:71 ../tools/virt-tar.pl:116 ../tools/virt-make-fs.pl:171 ../tools/virt-list-partitions.pl:72
27048 msgid "Display version number and exit."
27049 msgstr ""
27050
27051 #. type: =item
27052 #: ../tools/virt-edit.pl:101
27053 msgid "B<--backup extension> | B<-b extension>"
27054 msgstr ""
27055
27056 #. type: textblock
27057 #: ../tools/virt-edit.pl:103
27058 msgid ""
27059 "Create a backup of the original file I<in the guest disk image>.  The backup "
27060 "has the original filename with C<extension> added."
27061 msgstr ""
27062
27063 #. type: textblock
27064 #: ../tools/virt-edit.pl:106
27065 msgid ""
27066 "Usually the first character of C<extension> would be a dot C<.> so you would "
27067 "write:"
27068 msgstr ""
27069
27070 #. type: verbatim
27071 #: ../tools/virt-edit.pl:109
27072 #, no-wrap
27073 msgid ""
27074 " virt-edit -b .orig [etc]\n"
27075 "\n"
27076 msgstr ""
27077
27078 #. type: textblock
27079 #: ../tools/virt-edit.pl:111
27080 msgid "By default, no backup file is made."
27081 msgstr ""
27082
27083 #. type: =item
27084 #: ../tools/virt-edit.pl:117 ../tools/virt-win-reg.pl:128 ../tools/virt-list-filesystems.pl:77 ../tools/virt-tar.pl:122 ../tools/virt-list-partitions.pl:78
27085 msgid "B<--connect URI> | B<-c URI>"
27086 msgstr ""
27087
27088 #. type: textblock
27089 #: ../tools/virt-edit.pl:119 ../tools/virt-win-reg.pl:130 ../tools/virt-list-filesystems.pl:79 ../tools/virt-tar.pl:124 ../tools/virt-list-partitions.pl:80
27090 msgid ""
27091 "If using libvirt, connect to the given I<URI>.  If omitted, then we connect "
27092 "to the default libvirt hypervisor."
27093 msgstr ""
27094
27095 #. type: textblock
27096 #: ../tools/virt-edit.pl:122 ../tools/virt-win-reg.pl:133 ../tools/virt-list-filesystems.pl:82 ../tools/virt-tar.pl:127 ../tools/virt-list-partitions.pl:83
27097 msgid ""
27098 "If you specify guest block devices directly, then libvirt is not used at "
27099 "all."
27100 msgstr ""
27101
27102 #. type: =item
27103 #: ../tools/virt-edit.pl:129 ../tools/virt-win-reg.pl:140 ../tools/virt-resize.pl:520 ../tools/virt-list-filesystems.pl:89 ../tools/virt-tar.pl:134 ../tools/virt-list-partitions.pl:90
27104 msgid "B<--format> raw"
27105 msgstr ""
27106
27107 #. type: textblock
27108 #: ../tools/virt-edit.pl:131 ../tools/virt-win-reg.pl:142 ../tools/virt-list-filesystems.pl:91 ../tools/virt-tar.pl:136 ../tools/virt-list-partitions.pl:92
27109 msgid ""
27110 "Specify the format of disk images given on the command line.  If this is "
27111 "omitted then the format is autodetected from the content of the disk image."
27112 msgstr ""
27113
27114 #. type: textblock
27115 #: ../tools/virt-edit.pl:135 ../tools/virt-win-reg.pl:146 ../tools/virt-list-filesystems.pl:95 ../tools/virt-tar.pl:140 ../tools/virt-list-partitions.pl:96
27116 msgid ""
27117 "If disk images are requested from libvirt, then this program asks libvirt "
27118 "for this information.  In this case, the value of the format parameter is "
27119 "ignored."
27120 msgstr ""
27121
27122 #. type: textblock
27123 #: ../tools/virt-edit.pl:139 ../tools/virt-win-reg.pl:150 ../tools/virt-resize.pl:525 ../tools/virt-resize.pl:540 ../tools/virt-list-filesystems.pl:99 ../tools/virt-tar.pl:144 ../tools/virt-list-partitions.pl:100
27124 msgid ""
27125 "If working with untrusted raw-format guest disk images, you should ensure "
27126 "the format is always specified."
27127 msgstr ""
27128
27129 #. type: =item
27130 #: ../tools/virt-edit.pl:146
27131 msgid "B<--expr EXPR> | B<-e EXPR>"
27132 msgstr ""
27133
27134 #. type: textblock
27135 #: ../tools/virt-edit.pl:148
27136 msgid ""
27137 "Instead of launching the external editor, non-interactively apply the Perl "
27138 "expression C<EXPR> to each line in the file.  See L</NON-INTERACTIVE "
27139 "EDITING> below."
27140 msgstr ""
27141
27142 #. type: textblock
27143 #: ../tools/virt-edit.pl:152
27144 msgid ""
27145 "Be careful to properly quote the expression to prevent it from being altered "
27146 "by the shell."
27147 msgstr ""
27148
27149 #. type: =head1
27150 #: ../tools/virt-edit.pl:272
27151 msgid "NON-INTERACTIVE EDITING"
27152 msgstr ""
27153
27154 #. type: textblock
27155 #: ../tools/virt-edit.pl:274
27156 msgid ""
27157 "C<virt-edit> normally calls out to C<$EDITOR> (or vi) so the system "
27158 "administrator can interactively edit the file."
27159 msgstr ""
27160
27161 #. type: textblock
27162 #: ../tools/virt-edit.pl:277
27163 msgid ""
27164 "There are two ways also to use C<virt-edit> from scripts in order to make "
27165 "automated edits to files.  (Note that although you I<can> use C<virt-edit> "
27166 "like this, it's less error-prone to write scripts directly using the "
27167 "libguestfs API and Augeas for configuration file editing.)"
27168 msgstr ""
27169
27170 #. type: textblock
27171 #: ../tools/virt-edit.pl:283
27172 msgid ""
27173 "The first method is to temporarily set C<$EDITOR> to any script or program "
27174 "you want to run.  The script is invoked as C<$EDITOR tmpfile> and it should "
27175 "update C<tmpfile> in place however it likes."
27176 msgstr ""
27177
27178 #. type: textblock
27179 #: ../tools/virt-edit.pl:287
27180 msgid ""
27181 "The second method is to use the C<-e> parameter of C<virt-edit> to run a "
27182 "short Perl snippet in the style of L<sed(1)>.  For example to replace all "
27183 "instances of C<foo> with C<bar> in a file:"
27184 msgstr ""
27185
27186 #. type: verbatim
27187 #: ../tools/virt-edit.pl:291
27188 #, no-wrap
27189 msgid ""
27190 " virt-edit domname filename -e 's/foo/bar/'\n"
27191 "\n"
27192 msgstr ""
27193
27194 #. type: textblock
27195 #: ../tools/virt-edit.pl:293
27196 msgid ""
27197 "The full power of Perl regular expressions can be used (see L<perlre(1)>).  "
27198 "For example to delete root's password you could do:"
27199 msgstr ""
27200
27201 #. type: verbatim
27202 #: ../tools/virt-edit.pl:296
27203 #, no-wrap
27204 msgid ""
27205 " virt-edit domname /etc/passwd -e 's/^root:.*?:/root::/'\n"
27206 "\n"
27207 msgstr ""
27208
27209 #. type: textblock
27210 #: ../tools/virt-edit.pl:298
27211 msgid ""
27212 "What really happens is that the snippet is evaluated as a Perl expression "
27213 "for each line of the file.  The line, including the final C<\\n>, is passed "
27214 "in C<$_> and the expression should update C<$_> or leave it unchanged."
27215 msgstr ""
27216
27217 #. type: textblock
27218 #: ../tools/virt-edit.pl:303
27219 msgid ""
27220 "To delete a line, set C<$_> to the empty string.  For example, to delete the "
27221 "C<apache> user account from the password file you can do:"
27222 msgstr ""
27223
27224 #. type: verbatim
27225 #: ../tools/virt-edit.pl:306
27226 #, no-wrap
27227 msgid ""
27228 " virt-edit mydomain /etc/passwd -e '$_ = \"\" if /^apache:/'\n"
27229 "\n"
27230 msgstr ""
27231
27232 #. type: textblock
27233 #: ../tools/virt-edit.pl:308
27234 msgid ""
27235 "To insert a line, prepend or append it to C<$_>.  However appending lines to "
27236 "the end of the file is rather difficult this way since there is no concept "
27237 "of \"last line of the file\" - your expression just doesn't get called "
27238 "again.  You might want to use the first method (setting C<$EDITOR>) if you "
27239 "want to do this."
27240 msgstr ""
27241
27242 #. type: textblock
27243 #: ../tools/virt-edit.pl:314
27244 msgid ""
27245 "The variable C<$lineno> contains the current line number.  As is "
27246 "traditional, the first line in the file is number C<1>."
27247 msgstr ""
27248
27249 #. type: textblock
27250 #: ../tools/virt-edit.pl:317
27251 msgid ""
27252 "The return value from the expression is ignored, but the expression may call "
27253 "C<die> in order to abort the whole program, leaving the original file "
27254 "untouched."
27255 msgstr ""
27256
27257 #. type: textblock
27258 #: ../tools/virt-edit.pl:321
27259 msgid ""
27260 "Remember when matching the end of a line that C<$_> may contain the final "
27261 "C<\\n>, or (for DOS files) C<\\r\\n>, or if the file does not end with a "
27262 "newline then neither of these.  Thus to match or substitute some text at the "
27263 "end of a line, use this regular expression:"
27264 msgstr ""
27265
27266 #. type: verbatim
27267 #: ../tools/virt-edit.pl:326
27268 #, no-wrap
27269 msgid ""
27270 " /some text(\\r?\\n)?$/\n"
27271 "\n"
27272 msgstr ""
27273
27274 #. type: textblock
27275 #: ../tools/virt-edit.pl:328
27276 msgid ""
27277 "Alternately, use the perl C<chomp> function, being careful not to chomp "
27278 "C<$_> itself (since that would remove all newlines from the file):"
27279 msgstr ""
27280
27281 #. type: verbatim
27282 #: ../tools/virt-edit.pl:332
27283 #, no-wrap
27284 msgid ""
27285 " my $m = $_; chomp $m; $m =~ /some text$/\n"
27286 "\n"
27287 msgstr ""
27288
27289 #. type: =head1
27290 #: ../tools/virt-edit.pl:334
27291 msgid "USING GUESTFISH"
27292 msgstr ""
27293
27294 #. type: textblock
27295 #: ../tools/virt-edit.pl:336
27296 msgid ""
27297 "L<guestfish(1)> is a more powerful, lower level tool which you can use when "
27298 "C<virt-edit> doesn't work."
27299 msgstr ""
27300
27301 #. type: textblock
27302 #: ../tools/virt-edit.pl:339
27303 msgid "Using C<virt-edit> is approximately equivalent to doing:"
27304 msgstr ""
27305
27306 #. type: verbatim
27307 #: ../tools/virt-edit.pl:341
27308 #, no-wrap
27309 msgid ""
27310 " guestfish --rw -i -d domname edit /file\n"
27311 "\n"
27312 msgstr ""
27313
27314 #. type: textblock
27315 #: ../tools/virt-edit.pl:343
27316 msgid ""
27317 "where C<domname> is the name of the libvirt guest, and C</file> is the full "
27318 "path to the file."
27319 msgstr ""
27320
27321 #. type: textblock
27322 #: ../tools/virt-edit.pl:346
27323 msgid ""
27324 "The command above uses libguestfs's guest inspection feature and so does not "
27325 "work on guests that libguestfs cannot inspect, or on things like arbitrary "
27326 "disk images that don't contain guests.  To edit a file on a disk image "
27327 "directly, use:"
27328 msgstr ""
27329
27330 #. type: verbatim
27331 #: ../tools/virt-edit.pl:351
27332 #, no-wrap
27333 msgid ""
27334 " guestfish --rw -a disk.img -m /dev/sda1 edit /file\n"
27335 "\n"
27336 msgstr ""
27337
27338 #. type: textblock
27339 #: ../tools/virt-edit.pl:353
27340 msgid ""
27341 "where C<disk.img> is the disk image, C</dev/sda1> is the filesystem within "
27342 "the disk image to edit, and C</file> is the full path to the file."
27343 msgstr ""
27344
27345 #. type: textblock
27346 #: ../tools/virt-edit.pl:357
27347 msgid ""
27348 "C<virt-edit> cannot create new files.  Use the guestfish commands C<touch>, "
27349 "C<write> or C<upload> instead:"
27350 msgstr ""
27351
27352 #. type: verbatim
27353 #: ../tools/virt-edit.pl:360
27354 #, no-wrap
27355 msgid ""
27356 " guestfish --rw -i -d domname touch /newfile\n"
27357 "\n"
27358 msgstr ""
27359
27360 #. type: verbatim
27361 #: ../tools/virt-edit.pl:362
27362 #, no-wrap
27363 msgid ""
27364 " guestfish --rw -i -d domname write /newfile \"new content\"\n"
27365 "\n"
27366 msgstr ""
27367
27368 #. type: verbatim
27369 #: ../tools/virt-edit.pl:364
27370 #, no-wrap
27371 msgid ""
27372 " guestfish --rw -i -d domname upload localfile /newfile\n"
27373 "\n"
27374 msgstr ""
27375
27376 #. type: textblock
27377 #: ../tools/virt-edit.pl:366
27378 msgid "C<virt-edit> cannot edit multiple files, but guestfish can do it like this:"
27379 msgstr ""
27380
27381 #. type: verbatim
27382 #: ../tools/virt-edit.pl:369
27383 #, no-wrap
27384 msgid ""
27385 " guestfish --rw -i -d domname edit /file1 : edit /file2\n"
27386 "\n"
27387 msgstr ""
27388
27389 #. type: =item
27390 #: ../tools/virt-edit.pl:379
27391 msgid "C<EDITOR>"
27392 msgstr ""
27393
27394 #. type: textblock
27395 #: ../tools/virt-edit.pl:381
27396 msgid ""
27397 "If set, this string is used as the editor.  It may contain arguments, "
27398 "eg. C<\"emacs -nw\">"
27399 msgstr ""
27400
27401 #. type: textblock
27402 #: ../tools/virt-edit.pl:384
27403 msgid "If not set, C<vi> is used."
27404 msgstr ""
27405
27406 #. type: =head1
27407 #: ../tools/virt-edit.pl:388 ../tools/virt-win-reg.pl:559 ../tools/virt-resize.pl:1476 ../tools/virt-list-filesystems.pl:182 ../tools/virt-tar.pl:274 ../tools/virt-make-fs.pl:532 ../tools/virt-list-partitions.pl:250
27408 msgid "SHELL QUOTING"
27409 msgstr ""
27410
27411 #. type: textblock
27412 #: ../tools/virt-edit.pl:390 ../tools/virt-win-reg.pl:567 ../tools/virt-resize.pl:1478 ../tools/virt-list-filesystems.pl:184 ../tools/virt-tar.pl:276 ../tools/virt-make-fs.pl:534 ../tools/virt-list-partitions.pl:252
27413 msgid ""
27414 "Libvirt guest names can contain arbitrary characters, some of which have "
27415 "meaning to the shell such as C<#> and space.  You may need to quote or "
27416 "escape these characters on the command line.  See the shell manual page "
27417 "L<sh(1)> for details."
27418 msgstr ""
27419
27420 #. type: textblock
27421 #: ../tools/virt-edit.pl:397
27422 msgid ""
27423 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<Sys::Guestfs(3)>, "
27424 "L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>, "
27425 "L<perl(1)>, L<perlre(1)>."
27426 msgstr ""
27427
27428 #. type: =head1
27429 #: ../tools/virt-edit.pl:407 ../tools/virt-win-reg.pl:598 ../tools/virt-resize.pl:1504 ../tools/virt-list-filesystems.pl:202 ../tools/virt-tar.pl:292 ../tools/virt-make-fs.pl:564 ../tools/virt-list-partitions.pl:269
27430 msgid "AUTHOR"
27431 msgstr ""
27432
27433 #. type: textblock
27434 #: ../tools/virt-edit.pl:409 ../tools/virt-win-reg.pl:600 ../tools/virt-resize.pl:1506 ../tools/virt-list-filesystems.pl:204 ../tools/virt-tar.pl:294 ../tools/virt-make-fs.pl:566 ../tools/virt-list-partitions.pl:271
27435 msgid "Richard W.M. Jones L<http://people.redhat.com/~rjones/>"
27436 msgstr ""
27437
27438 #. type: textblock
27439 #: ../tools/virt-edit.pl:413
27440 msgid "Copyright (C) 2009-2011 Red Hat Inc."
27441 msgstr ""
27442
27443 #. type: textblock
27444 #: ../tools/virt-win-reg.pl:37
27445 msgid ""
27446 "virt-win-reg - Export and merge Windows Registry entries from a Windows "
27447 "guest"
27448 msgstr ""
27449
27450 #. type: verbatim
27451 #: ../tools/virt-win-reg.pl:41
27452 #, no-wrap
27453 msgid ""
27454 " virt-win-reg domname 'HKLM\\Path\\To\\Subkey'\n"
27455 "\n"
27456 msgstr ""
27457
27458 #. type: verbatim
27459 #: ../tools/virt-win-reg.pl:43
27460 #, no-wrap
27461 msgid ""
27462 " virt-win-reg domname 'HKLM\\Path\\To\\Subkey' name\n"
27463 "\n"
27464 msgstr ""
27465
27466 #. type: verbatim
27467 #: ../tools/virt-win-reg.pl:45
27468 #, no-wrap
27469 msgid ""
27470 " virt-win-reg domname 'HKLM\\Path\\To\\Subkey' @\n"
27471 "\n"
27472 msgstr ""
27473
27474 #. type: verbatim
27475 #: ../tools/virt-win-reg.pl:47
27476 #, no-wrap
27477 msgid ""
27478 " virt-win-reg --merge domname [input.reg ...]\n"
27479 "\n"
27480 msgstr ""
27481
27482 #. type: verbatim
27483 #: ../tools/virt-win-reg.pl:49
27484 #, no-wrap
27485 msgid ""
27486 " virt-win-reg [--options] disk.img ... # instead of domname\n"
27487 "\n"
27488 msgstr ""
27489
27490 #. type: textblock
27491 #: ../tools/virt-win-reg.pl:53
27492 msgid ""
27493 "You must I<not> use C<virt-win-reg> with the C<--merge> option on live "
27494 "virtual machines.  If you do this, you I<will> get irreversible disk "
27495 "corruption in the VM.  C<virt-win-reg> tries to stop you from doing this, "
27496 "but doesn't catch all cases."
27497 msgstr ""
27498
27499 #. type: textblock
27500 #: ../tools/virt-win-reg.pl:58
27501 msgid ""
27502 "Modifying the Windows Registry is an inherently risky operation.  The format "
27503 "is deliberately obscure and undocumented, and Registry changes can leave the "
27504 "system unbootable.  Therefore when using the C<--merge> option, make sure "
27505 "you have a reliable backup first."
27506 msgstr ""
27507
27508 #. type: textblock
27509 #: ../tools/virt-win-reg.pl:65
27510 msgid ""
27511 "This program can export and merge Windows Registry entries from a Windows "
27512 "guest."
27513 msgstr ""
27514
27515 #. type: textblock
27516 #: ../tools/virt-win-reg.pl:68
27517 msgid ""
27518 "The first parameter is the libvirt guest name or the raw disk image of a "
27519 "Windows guest."
27520 msgstr ""
27521
27522 #. type: textblock
27523 #: ../tools/virt-win-reg.pl:71
27524 msgid ""
27525 "If C<--merge> is I<not> specified, then the chosen registry key is "
27526 "displayed/exported (recursively).  For example:"
27527 msgstr ""
27528
27529 #. type: verbatim
27530 #: ../tools/virt-win-reg.pl:74
27531 #, no-wrap
27532 msgid ""
27533 " $ virt-win-reg Windows7 'HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft'\n"
27534 "\n"
27535 msgstr ""
27536
27537 #. type: textblock
27538 #: ../tools/virt-win-reg.pl:76
27539 msgid "You can also display single values from within registry keys, for example:"
27540 msgstr ""
27541
27542 #. type: verbatim
27543 #: ../tools/virt-win-reg.pl:79
27544 #, no-wrap
27545 msgid ""
27546 " $ cvkey='HKLM\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion'\n"
27547 " $ virt-win-reg Windows7 $cvkey ProductName\n"
27548 " Windows 7 Enterprise\n"
27549 "\n"
27550 msgstr ""
27551
27552 #. type: textblock
27553 #: ../tools/virt-win-reg.pl:83
27554 msgid ""
27555 "With C<--merge>, you can merge a textual regedit file into the Windows "
27556 "Registry:"
27557 msgstr ""
27558
27559 #. type: verbatim
27560 #: ../tools/virt-win-reg.pl:86
27561 #, no-wrap
27562 msgid ""
27563 " $ virt-win-reg --merge Windows7 changes.reg\n"
27564 "\n"
27565 msgstr ""
27566
27567 #. type: =head2
27568 #: ../tools/virt-win-reg.pl:88
27569 msgid "NOTE"
27570 msgstr ""
27571
27572 #. type: textblock
27573 #: ../tools/virt-win-reg.pl:90
27574 msgid ""
27575 "This program is only meant for simple access to the registry.  If you want "
27576 "to do complicated things with the registry, we suggest you download the "
27577 "Registry hive files from the guest using L<libguestfs(3)> or L<guestfish(1)> "
27578 "and access them locally, eg. using L<hivex(3)>, L<hivexsh(1)> or "
27579 "L<hivexregedit(1)>."
27580 msgstr ""
27581
27582 #. type: =item
27583 #: ../tools/virt-win-reg.pl:120 ../tools/virt-make-fs.pl:177
27584 msgid "B<--debug>"
27585 msgstr ""
27586
27587 #. type: textblock
27588 #: ../tools/virt-win-reg.pl:122 ../tools/virt-resize.pl:498
27589 msgid "Enable debugging messages."
27590 msgstr ""
27591
27592 #. type: =item
27593 #: ../tools/virt-win-reg.pl:157
27594 msgid "B<--merge>"
27595 msgstr ""
27596
27597 #. type: textblock
27598 #: ../tools/virt-win-reg.pl:159
27599 msgid ""
27600 "In merge mode, this merges a textual regedit file into the Windows Registry "
27601 "of the virtual machine.  If this flag is I<not> given then virt-win-reg "
27602 "displays or exports Registry entries instead."
27603 msgstr ""
27604
27605 #. type: textblock
27606 #: ../tools/virt-win-reg.pl:163
27607 msgid ""
27608 "Note that C<--merge> is I<unsafe> to use on live virtual machines, and will "
27609 "result in disk corruption.  However exporting (without this flag)  is always "
27610 "safe."
27611 msgstr ""
27612
27613 #. type: =item
27614 #: ../tools/virt-win-reg.pl:171
27615 msgid "B<--encoding> UTF-16LE|ASCII"
27616 msgstr ""
27617
27618 #. type: textblock
27619 #: ../tools/virt-win-reg.pl:173
27620 msgid ""
27621 "When merging (only), you may need to specify the encoding for strings to be "
27622 "used in the hive file.  This is explained in detail in "
27623 "L<Win::Hivex::Regedit(3)/ENCODING STRINGS>."
27624 msgstr ""
27625
27626 #. type: textblock
27627 #: ../tools/virt-win-reg.pl:177
27628 msgid ""
27629 "The default is to use UTF-16LE, which should work with recent versions of "
27630 "Windows."
27631 msgstr ""
27632
27633 #. type: =head1
27634 #: ../tools/virt-win-reg.pl:402
27635 msgid "SUPPORTED SYSTEMS"
27636 msgstr ""
27637
27638 #. type: textblock
27639 #: ../tools/virt-win-reg.pl:404
27640 msgid ""
27641 "The program currently supports Windows NT-derived guests starting with "
27642 "Windows XP through to at least Windows 7."
27643 msgstr ""
27644
27645 #. type: textblock
27646 #: ../tools/virt-win-reg.pl:407
27647 msgid ""
27648 "Registry support is done for C<HKEY_LOCAL_MACHINE\\SAM>, "
27649 "C<HKEY_LOCAL_MACHINE\\SECURITY>, C<HKEY_LOCAL_MACHINE\\SOFTWARE>, "
27650 "C<HKEY_LOCAL_MACHINE\\SYSTEM> and C<HKEY_USERS\\.DEFAULT>."
27651 msgstr ""
27652
27653 #. type: textblock
27654 #: ../tools/virt-win-reg.pl:411
27655 msgid ""
27656 "You can use C<HKLM> as a shorthand for C<HKEY_LOCAL_MACHINE>, and C<HKU> for "
27657 "C<HKEY_USERS>."
27658 msgstr ""
27659
27660 #. type: textblock
27661 #: ../tools/virt-win-reg.pl:414
27662 msgid ""
27663 "C<HKEY_USERS\\$SID> and C<HKEY_CURRENT_USER> are B<not> supported at this "
27664 "time."
27665 msgstr ""
27666
27667 #. type: =head1
27668 #: ../tools/virt-win-reg.pl:417
27669 msgid "ENCODING"
27670 msgstr ""
27671
27672 #. type: textblock
27673 #: ../tools/virt-win-reg.pl:419
27674 msgid ""
27675 "C<virt-win-reg> expects that regedit files have already been reencoded in "
27676 "the local encoding.  Usually on Linux hosts, this means UTF-8 with "
27677 "Unix-style line endings.  Since Windows regedit files are often in UTF-16LE "
27678 "with Windows-style line endings, you may need to reencode the whole file "
27679 "before or after processing."
27680 msgstr ""
27681
27682 #. type: textblock
27683 #: ../tools/virt-win-reg.pl:425
27684 msgid ""
27685 "To reencode a file from Windows format to Linux (before processing it with "
27686 "the C<--merge> option), you would do something like this:"
27687 msgstr ""
27688
27689 #. type: verbatim
27690 #: ../tools/virt-win-reg.pl:428
27691 #, no-wrap
27692 msgid ""
27693 " iconv -f utf-16le -t utf-8 < win.reg | dos2unix > linux.reg\n"
27694 "\n"
27695 msgstr ""
27696
27697 #. type: textblock
27698 #: ../tools/virt-win-reg.pl:430
27699 msgid ""
27700 "To go in the opposite direction, after exporting and before sending the file "
27701 "to a Windows user, do something like this:"
27702 msgstr ""
27703
27704 #. type: verbatim
27705 #: ../tools/virt-win-reg.pl:433
27706 #, no-wrap
27707 msgid ""
27708 " unix2dos linux.reg | iconv -f utf-8 -t utf-16le > win.reg\n"
27709 "\n"
27710 msgstr ""
27711
27712 #. type: textblock
27713 #: ../tools/virt-win-reg.pl:435
27714 msgid "For more information about encoding, see L<Win::Hivex::Regedit(3)>."
27715 msgstr ""
27716
27717 #. type: textblock
27718 #: ../tools/virt-win-reg.pl:437
27719 msgid ""
27720 "If you are unsure about the current encoding, use the L<file(1)> command.  "
27721 "Recent versions of Windows regedit.exe produce a UTF-16LE file with "
27722 "Windows-style (CRLF) line endings, like this:"
27723 msgstr ""
27724
27725 #. type: verbatim
27726 #: ../tools/virt-win-reg.pl:441
27727 #, no-wrap
27728 msgid ""
27729 " $ file software.reg\n"
27730 " software.reg: Little-endian UTF-16 Unicode text, with very long lines,\n"
27731 " with CRLF line terminators\n"
27732 "\n"
27733 msgstr ""
27734
27735 #. type: textblock
27736 #: ../tools/virt-win-reg.pl:445
27737 msgid "This file would need conversion before you could C<--merge> it."
27738 msgstr ""
27739
27740 #. type: =head1
27741 #: ../tools/virt-win-reg.pl:447
27742 msgid "CurrentControlSet etc."
27743 msgstr ""
27744
27745 #. type: textblock
27746 #: ../tools/virt-win-reg.pl:449
27747 msgid ""
27748 "Registry keys like C<CurrentControlSet> don't really exist in the Windows "
27749 "Registry at the level of the hive file, and therefore you cannot modify "
27750 "these."
27751 msgstr ""
27752
27753 #. type: textblock
27754 #: ../tools/virt-win-reg.pl:453
27755 msgid ""
27756 "C<CurrentControlSet> is usually an alias for C<ControlSet001>.  In some "
27757 "circumstances it might refer to another control set.  The way to find out is "
27758 "to look at the C<HKLM\\SYSTEM\\Select> key:"
27759 msgstr ""
27760
27761 #. type: verbatim
27762 #: ../tools/virt-win-reg.pl:457
27763 #, no-wrap
27764 msgid ""
27765 " # virt-win-reg WindowsGuest 'HKLM\\SYSTEM\\Select'\n"
27766 " [HKEY_LOCAL_MACHINE\\SYSTEM\\Select]\n"
27767 " \"Current\"=dword:00000001\n"
27768 " \"Default\"=dword:00000001\n"
27769 " \"Failed\"=dword:00000000\n"
27770 " \"LastKnownGood\"=dword:00000002\n"
27771 "\n"
27772 msgstr ""
27773
27774 #. type: textblock
27775 #: ../tools/virt-win-reg.pl:464
27776 msgid "\"Current\" is the one which Windows will choose when it boots."
27777 msgstr ""
27778
27779 #. type: textblock
27780 #: ../tools/virt-win-reg.pl:466
27781 msgid "Similarly, other C<Current...> keys in the path may need to be replaced."
27782 msgstr ""
27783
27784 #. type: =head1
27785 #: ../tools/virt-win-reg.pl:469
27786 msgid "WINDOWS TIPS"
27787 msgstr ""
27788
27789 #. type: textblock
27790 #: ../tools/virt-win-reg.pl:471
27791 msgid ""
27792 "Note that some of these tips modify the guest disk image.  The guest I<must> "
27793 "be shut off, else you will get disk corruption."
27794 msgstr ""
27795
27796 #. type: =head2
27797 #: ../tools/virt-win-reg.pl:474
27798 msgid "RUNNING A BATCH SCRIPT WHEN A USER LOGS IN"
27799 msgstr ""
27800
27801 #. type: textblock
27802 #: ../tools/virt-win-reg.pl:476
27803 msgid ""
27804 "Prepare a DOS batch script, VBScript or executable.  Upload this using "
27805 "L<guestfish(1)>.  For this example the script is called C<test.bat> and it "
27806 "is uploaded into C<C:\\>:"
27807 msgstr ""
27808
27809 #. type: verbatim
27810 #: ../tools/virt-win-reg.pl:480
27811 #, no-wrap
27812 msgid ""
27813 " guestfish -i -d WindowsGuest upload test.bat /test.bat\n"
27814 "\n"
27815 msgstr ""
27816
27817 #. type: textblock
27818 #: ../tools/virt-win-reg.pl:482
27819 msgid "Prepare a regedit file containing the registry change:"
27820 msgstr ""
27821
27822 #. type: verbatim
27823 #: ../tools/virt-win-reg.pl:484
27824 #, no-wrap
27825 msgid ""
27826 " cat > test.reg <<'EOF'\n"
27827 " [HKLM\\Software\\Microsoft\\Windows\\CurrentVersion\\RunOnce]\n"
27828 " \"Test\"=\"c:\\\\test.bat\"\n"
27829 " EOF\n"
27830 "\n"
27831 msgstr ""
27832
27833 #. type: textblock
27834 #: ../tools/virt-win-reg.pl:489
27835 msgid ""
27836 "In this example we use the key C<RunOnce> which means that the script will "
27837 "run precisely once when the first user logs in.  If you want it to run every "
27838 "time a user logs in, replace C<RunOnce> with C<Run>."
27839 msgstr ""
27840
27841 #. type: textblock
27842 #: ../tools/virt-win-reg.pl:493
27843 msgid "Now update the registry:"
27844 msgstr ""
27845
27846 #. type: verbatim
27847 #: ../tools/virt-win-reg.pl:495
27848 #, no-wrap
27849 msgid ""
27850 " virt-win-reg --merge WindowsGuest test.reg\n"
27851 "\n"
27852 msgstr ""
27853
27854 #. type: =head2
27855 #: ../tools/virt-win-reg.pl:497
27856 msgid "INSTALLING A SERVICE"
27857 msgstr ""
27858
27859 #. type: textblock
27860 #: ../tools/virt-win-reg.pl:499
27861 msgid ""
27862 "This section assumes you are familiar with Windows services, and you either "
27863 "have a program which handles the Windows Service Control Protocol directly "
27864 "or you want to run any program using a service wrapper like SrvAny or the "
27865 "free RHSrvAny."
27866 msgstr ""
27867
27868 #. type: textblock
27869 #: ../tools/virt-win-reg.pl:504
27870 msgid ""
27871 "First upload the program and optionally the service wrapper.  In this case "
27872 "the test program is called C<test.exe> and we are using the RHSrvAny "
27873 "wrapper:"
27874 msgstr ""
27875
27876 #. type: verbatim
27877 #: ../tools/virt-win-reg.pl:508
27878 #, no-wrap
27879 msgid ""
27880 " guestfish -i -d WindowsGuest <<EOF\n"
27881 "   upload rhsrvany.exe /rhsrvany.exe\n"
27882 "   upload test.exe /test.exe\n"
27883 " EOF\n"
27884 "\n"
27885 msgstr ""
27886
27887 #. type: textblock
27888 #: ../tools/virt-win-reg.pl:513
27889 msgid ""
27890 "Prepare a regedit file containing the registry changes.  In this example, "
27891 "the first registry change is needed for the service itself or the service "
27892 "wrapper (if used).  The second registry change is only needed because I am "
27893 "using the RHSrvAny service wrapper."
27894 msgstr ""
27895
27896 #. type: verbatim
27897 #: ../tools/virt-win-reg.pl:518
27898 #, no-wrap
27899 msgid ""
27900 " cat > service.reg <<'EOF'\n"
27901 " [HKLM\\SYSTEM\\ControlSet001\\services\\RHSrvAny]\n"
27902 " \"Type\"=dword:00000010\n"
27903 " \"Start\"=dword:00000002\n"
27904 " \"ErrorControl\"=dword:00000001\n"
27905 " \"ImagePath\"=\"c:\\\\rhsrvany.exe\"\n"
27906 " \"DisplayName\"=\"RHSrvAny\"\n"
27907 " \"ObjectName\"=\"NetworkService\"\n"
27908 " \n"
27909 msgstr ""
27910
27911 #. type: verbatim
27912 #: ../tools/virt-win-reg.pl:527
27913 #, no-wrap
27914 msgid ""
27915 " [HKLM\\SYSTEM\\ControlSet001\\services\\RHSrvAny\\Parameters]\n"
27916 " \"CommandLine\"=\"c:\\\\test.exe\"\n"
27917 " \"PWD\"=\"c:\\\\Temp\"\n"
27918 " EOF\n"
27919 "\n"
27920 msgstr ""
27921
27922 #. type: textblock
27923 #: ../tools/virt-win-reg.pl:538
27924 msgid ""
27925 "For use of C<ControlSet001> see the section above in this manual page.  You "
27926 "may need to adjust this according to the control set that is in use by the "
27927 "guest."
27928 msgstr ""
27929
27930 #. type: textblock
27931 #: ../tools/virt-win-reg.pl:544
27932 msgid ""
27933 "C<\"ObjectName\"> controls the privileges that the service will have.  An "
27934 "alternative is C<\"ObjectName\"=\"LocalSystem\"> which would be the most "
27935 "privileged account."
27936 msgstr ""
27937
27938 #. type: textblock
27939 #: ../tools/virt-win-reg.pl:550
27940 msgid ""
27941 "For the meaning of the magic numbers, see this Microsoft KB article: "
27942 "L<http://support.microsoft.com/kb/103000>."
27943 msgstr ""
27944
27945 #. type: textblock
27946 #: ../tools/virt-win-reg.pl:555
27947 msgid "Update the registry:"
27948 msgstr ""
27949
27950 #. type: verbatim
27951 #: ../tools/virt-win-reg.pl:557
27952 #, no-wrap
27953 msgid ""
27954 " virt-win-reg --merge WindowsGuest service.reg\n"
27955 "\n"
27956 msgstr ""
27957
27958 #. type: textblock
27959 #: ../tools/virt-win-reg.pl:561
27960 msgid ""
27961 "Be careful when passing parameters containing C<\\> (backslash) in the "
27962 "shell.  Usually you will have to use 'single quotes' or double backslashes "
27963 "(but not both) to protect them from the shell."
27964 msgstr ""
27965
27966 #. type: textblock
27967 #: ../tools/virt-win-reg.pl:565
27968 msgid "Paths and value names are case-insensitive."
27969 msgstr ""
27970
27971 #. type: textblock
27972 #: ../tools/virt-win-reg.pl:574
27973 msgid ""
27974 "L<hivex(3)>, L<hivexsh(1)>, L<hivexregedit(1)>, L<guestfs(3)>, "
27975 "L<guestfish(1)>, L<virt-cat(1)>, L<Sys::Guestfs(3)>, "
27976 "L<Sys::Guestfs::Lib(3)>, L<Win::Hivex(3)>, L<Win::Hivex::Regedit(3)>, "
27977 "L<Sys::Virt(3)>, L<http://libguestfs.org/>."
27978 msgstr ""
27979
27980 #. type: textblock
27981 #: ../tools/virt-win-reg.pl:589 ../tools/virt-make-fs.pl:555
27982 msgid ""
27983 "When reporting bugs, please enable debugging and capture the I<complete> "
27984 "output:"
27985 msgstr ""
27986
27987 #. type: verbatim
27988 #: ../tools/virt-win-reg.pl:592
27989 #, no-wrap
27990 msgid ""
27991 " export LIBGUESTFS_DEBUG=1\n"
27992 " virt-win-reg --debug [... rest ...] > /tmp/virt-win-reg.log 2>&1\n"
27993 "\n"
27994 msgstr ""
27995
27996 #. type: textblock
27997 #: ../tools/virt-win-reg.pl:595
27998 msgid ""
27999 "Attach /tmp/virt-win-reg.log to a new bug report at "
28000 "L<https://bugzilla.redhat.com/>"
28001 msgstr ""
28002
28003 #. type: textblock
28004 #: ../tools/virt-win-reg.pl:604 ../tools/virt-resize.pl:1510 ../tools/virt-make-fs.pl:570
28005 msgid "Copyright (C) 2010 Red Hat Inc."
28006 msgstr ""
28007
28008 #. type: textblock
28009 #: ../tools/virt-resize.pl:42
28010 msgid "virt-resize - Resize a virtual machine disk"
28011 msgstr ""
28012
28013 #. type: verbatim
28014 #: ../tools/virt-resize.pl:46
28015 #, no-wrap
28016 msgid ""
28017 " virt-resize [--resize /dev/sdaN=[+/-]<size>[%]]\n"
28018 "   [--expand /dev/sdaN] [--shrink /dev/sdaN]\n"
28019 "   [--ignore /dev/sdaN] [--delete /dev/sdaN] [...] indisk outdisk\n"
28020 "\n"
28021 msgstr ""
28022
28023 #. type: textblock
28024 #: ../tools/virt-resize.pl:52
28025 msgid ""
28026 "Virt-resize is a tool which can resize a virtual machine disk, making it "
28027 "larger or smaller overall, and resizing or deleting any partitions contained "
28028 "within."
28029 msgstr ""
28030
28031 #. type: textblock
28032 #: ../tools/virt-resize.pl:56
28033 msgid ""
28034 "Virt-resize B<cannot> resize disk images in-place.  Virt-resize B<should "
28035 "not> be used on live virtual machines - for consistent results, shut the "
28036 "virtual machine down before resizing it."
28037 msgstr ""
28038
28039 #. type: textblock
28040 #: ../tools/virt-resize.pl:60
28041 msgid ""
28042 "If you are not familiar with the associated tools: L<virt-filesystems(1)> "
28043 "and L<virt-df(1)>, we recommend you go and read those manual pages first."
28044 msgstr ""
28045
28046 #. type: textblock
28047 #: ../tools/virt-resize.pl:66
28048 msgid ""
28049 "Copy C<olddisk> to C<newdisk>, extending one of the guest's partitions to "
28050 "fill the extra 5GB of space."
28051 msgstr ""
28052
28053 #. type: verbatim
28054 #: ../tools/virt-resize.pl:69
28055 #, no-wrap
28056 msgid ""
28057 " truncate -r olddisk newdisk; truncate -s +5G newdisk\n"
28058 " virt-filesystems --long -h --all -a olddisk\n"
28059 " # Note \"/dev/sda2\" is a partition inside the \"olddisk\" file.\n"
28060 " virt-resize --expand /dev/sda2 olddisk newdisk\n"
28061 "\n"
28062 msgstr ""
28063
28064 #. type: textblock
28065 #: ../tools/virt-resize.pl:74
28066 msgid ""
28067 "As above, but make the /boot partition 200MB bigger, while giving the "
28068 "remaining space to /dev/sda2:"
28069 msgstr ""
28070
28071 #. type: verbatim
28072 #: ../tools/virt-resize.pl:77
28073 #, no-wrap
28074 msgid ""
28075 " virt-resize --resize /dev/sda1=+200M --expand /dev/sda2 olddisk newdisk\n"
28076 "\n"
28077 msgstr ""
28078
28079 #. type: textblock
28080 #: ../tools/virt-resize.pl:79
28081 msgid "As above, but the output format will be uncompressed qcow2:"
28082 msgstr ""
28083
28084 #. type: verbatim
28085 #: ../tools/virt-resize.pl:81
28086 #, no-wrap
28087 msgid ""
28088 " qemu-img create -f qcow2 newdisk.qcow2 15G\n"
28089 " virt-resize --expand /dev/sda2 olddisk newdisk.qcow2\n"
28090 "\n"
28091 msgstr ""
28092
28093 #. type: =head1
28094 #: ../tools/virt-resize.pl:84
28095 msgid "DETAILED USAGE"
28096 msgstr ""
28097
28098 #. type: =head2
28099 #: ../tools/virt-resize.pl:86
28100 msgid "EXPANDING A VIRTUAL MACHINE DISK"
28101 msgstr ""
28102
28103 #. type: =item
28104 #: ../tools/virt-resize.pl:90
28105 msgid "1. Shut down the virtual machine"
28106 msgstr ""
28107
28108 #. type: =item
28109 #: ../tools/virt-resize.pl:92
28110 msgid "2. Locate input disk image"
28111 msgstr ""
28112
28113 #. type: textblock
28114 #: ../tools/virt-resize.pl:94
28115 msgid ""
28116 "Locate the input disk image (ie. the file or device on the host containing "
28117 "the guest's disk).  If the guest is managed by libvirt, you can use C<virsh "
28118 "dumpxml> like this to find the disk image name:"
28119 msgstr ""
28120
28121 #. type: verbatim
28122 #: ../tools/virt-resize.pl:98
28123 #, no-wrap
28124 msgid ""
28125 " # virsh dumpxml guestname | xpath /domain/devices/disk/source\n"
28126 " Found 1 nodes:\n"
28127 " -- NODE --\n"
28128 " <source dev=\"/dev/vg/lv_guest\" />\n"
28129 "\n"
28130 msgstr ""
28131
28132 #. type: =item
28133 #: ../tools/virt-resize.pl:103
28134 msgid "3. Look at current sizing"
28135 msgstr ""
28136
28137 #. type: textblock
28138 #: ../tools/virt-resize.pl:105
28139 msgid "Use L<virt-filesystems(1)> to display the current partitions and sizes:"
28140 msgstr ""
28141
28142 #. type: verbatim
28143 #: ../tools/virt-resize.pl:108
28144 #, no-wrap
28145 msgid ""
28146 " # virt-filesystems --long --parts --blkdevs -h -a /dev/vg/lv_guest\n"
28147 " Name       Type       Size  Parent\n"
28148 " /dev/sda1  partition  101M  /dev/sda\n"
28149 " /dev/sda2  partition  7.9G  /dev/sda\n"
28150 " /dev/sda   device     8.0G  -\n"
28151 "\n"
28152 msgstr ""
28153
28154 #. type: textblock
28155 #: ../tools/virt-resize.pl:114
28156 msgid ""
28157 "(This example is a virtual machine with an 8 GB disk which we would like to "
28158 "expand up to 10 GB)."
28159 msgstr ""
28160
28161 #. type: =item
28162 #: ../tools/virt-resize.pl:117
28163 msgid "4. Create output disk"
28164 msgstr ""
28165
28166 #. type: textblock
28167 #: ../tools/virt-resize.pl:119
28168 msgid ""
28169 "Virt-resize cannot do in-place disk modifications.  You have to have space "
28170 "to store the resized output disk."
28171 msgstr ""
28172
28173 #. type: textblock
28174 #: ../tools/virt-resize.pl:122
28175 msgid "To store the resized disk image in a file, create a file of a suitable size:"
28176 msgstr ""
28177
28178 #. type: verbatim
28179 #: ../tools/virt-resize.pl:125
28180 #, no-wrap
28181 msgid ""
28182 " # rm -f outdisk\n"
28183 " # truncate -s 10G outdisk\n"
28184 "\n"
28185 msgstr ""
28186
28187 #. type: textblock
28188 #: ../tools/virt-resize.pl:128
28189 msgid "Or use L<lvcreate(1)> to create a logical volume:"
28190 msgstr ""
28191
28192 #. type: verbatim
28193 #: ../tools/virt-resize.pl:130
28194 #, no-wrap
28195 msgid ""
28196 " # lvcreate -L 10G -n lv_name vg_name\n"
28197 "\n"
28198 msgstr ""
28199
28200 #. type: textblock
28201 #: ../tools/virt-resize.pl:132
28202 msgid "Or use L<virsh(1)> vol-create-as to create a libvirt storage volume:"
28203 msgstr ""
28204
28205 #. type: verbatim
28206 #: ../tools/virt-resize.pl:134
28207 #, no-wrap
28208 msgid ""
28209 " # virsh pool-list\n"
28210 " # virsh vol-create-as poolname newvol 10G\n"
28211 "\n"
28212 msgstr ""
28213
28214 #. type: =item
28215 #: ../tools/virt-resize.pl:137
28216 msgid "5. Resize"
28217 msgstr ""
28218
28219 #. type: textblock
28220 #: ../tools/virt-resize.pl:139
28221 msgid ""
28222 "virt-resize takes two mandatory parameters, the input disk (eg. device or "
28223 "file) and the output disk.  The output disk is the one created in the "
28224 "previous step."
28225 msgstr ""
28226
28227 #. type: verbatim
28228 #: ../tools/virt-resize.pl:143
28229 #, no-wrap
28230 msgid ""
28231 " # virt-resize indisk outdisk\n"
28232 "\n"
28233 msgstr ""
28234
28235 #. type: textblock
28236 #: ../tools/virt-resize.pl:145
28237 msgid ""
28238 "This command just copies disk image C<indisk> to disk image C<outdisk> "
28239 "I<without> resizing or changing any existing partitions.  If C<outdisk> is "
28240 "larger, then an extra, empty partition is created at the end of the disk "
28241 "covering the extra space.  If C<outdisk> is smaller, then it will give an "
28242 "error."
28243 msgstr ""
28244
28245 #. type: textblock
28246 #: ../tools/virt-resize.pl:151
28247 msgid ""
28248 "More realistically you'd want to expand existing partitions in the disk "
28249 "image by passing extra options (for the full list see the L</OPTIONS> "
28250 "section below)."
28251 msgstr ""
28252
28253 #. type: textblock
28254 #: ../tools/virt-resize.pl:155
28255 msgid ""
28256 "L</--expand> is the most useful option.  It expands the named partition "
28257 "within the disk to fill any extra space:"
28258 msgstr ""
28259
28260 #. type: verbatim
28261 #: ../tools/virt-resize.pl:158
28262 #, no-wrap
28263 msgid ""
28264 " # virt-resize --expand /dev/sda2 indisk outdisk\n"
28265 "\n"
28266 msgstr ""
28267
28268 #. type: textblock
28269 #: ../tools/virt-resize.pl:160
28270 msgid ""
28271 "(In this case, an extra partition is I<not> created at the end of the disk, "
28272 "because there will be no unused space)."
28273 msgstr ""
28274
28275 #. type: textblock
28276 #: ../tools/virt-resize.pl:163
28277 msgid ""
28278 "L</--resize> is the other commonly used option.  The following would "
28279 "increase the size of /dev/sda1 by 200M, and expand /dev/sda2 to fill the "
28280 "rest of the available space:"
28281 msgstr ""
28282
28283 #. type: verbatim
28284 #: ../tools/virt-resize.pl:167
28285 #, no-wrap
28286 msgid ""
28287 " # virt-resize --resize /dev/sda1=+200M --expand /dev/sda2 \\\n"
28288 "     indisk outdisk\n"
28289 "\n"
28290 msgstr ""
28291
28292 #. type: textblock
28293 #: ../tools/virt-resize.pl:170
28294 msgid ""
28295 "If the expanded partition in the image contains a filesystem or LVM PV, then "
28296 "if virt-resize knows how, it will resize the contents, the equivalent of "
28297 "calling a command such as L<pvresize(8)>, L<resize2fs(8)> or "
28298 "L<ntfsresize(8)>.  However virt-resize does not know how to resize some "
28299 "filesystems, so you would have to online resize them after booting the "
28300 "guest."
28301 msgstr ""
28302
28303 #. type: textblock
28304 #: ../tools/virt-resize.pl:177
28305 msgid "Other options are covered below."
28306 msgstr ""
28307
28308 #. type: =item
28309 #: ../tools/virt-resize.pl:179
28310 msgid "6. Test"
28311 msgstr ""
28312
28313 #. type: textblock
28314 #: ../tools/virt-resize.pl:181
28315 msgid "Thoroughly test the new disk image I<before> discarding the old one."
28316 msgstr ""
28317
28318 #. type: textblock
28319 #: ../tools/virt-resize.pl:183
28320 msgid "If you are using libvirt, edit the XML to point at the new disk:"
28321 msgstr ""
28322
28323 #. type: verbatim
28324 #: ../tools/virt-resize.pl:185
28325 #, no-wrap
28326 msgid ""
28327 " # virsh edit guestname\n"
28328 "\n"
28329 msgstr ""
28330
28331 #. type: textblock
28332 #: ../tools/virt-resize.pl:187
28333 msgid ""
28334 "Change E<lt>source ...E<gt>, see "
28335 "L<http://libvirt.org/formatdomain.html#elementsDisks>"
28336 msgstr ""
28337
28338 #. type: textblock
28339 #: ../tools/virt-resize.pl:190
28340 msgid "Then start up the domain with the new, resized disk:"
28341 msgstr ""
28342
28343 #. type: verbatim
28344 #: ../tools/virt-resize.pl:192
28345 #, no-wrap
28346 msgid ""
28347 " # virsh start guestname\n"
28348 "\n"
28349 msgstr ""
28350
28351 #. type: textblock
28352 #: ../tools/virt-resize.pl:194
28353 msgid ""
28354 "and check that it still works.  See also the L</NOTES> section below for "
28355 "additional information."
28356 msgstr ""
28357
28358 #. type: =item
28359 #: ../tools/virt-resize.pl:197
28360 msgid "7. Resize LVs etc inside the guest"
28361 msgstr ""
28362
28363 #. type: textblock
28364 #: ../tools/virt-resize.pl:199
28365 msgid "(This can also be done offline using L<guestfish(1)>)"
28366 msgstr ""
28367
28368 #. type: textblock
28369 #: ../tools/virt-resize.pl:201
28370 msgid ""
28371 "Once the guest has booted you should see the new space available, at least "
28372 "for filesystems that virt-resize knows how to resize, and for PVs.  The user "
28373 "may need to resize LVs inside PVs, and also resize filesystem types that "
28374 "virt-resize does not know how to expand."
28375 msgstr ""
28376
28377 #. type: =head2
28378 #: ../tools/virt-resize.pl:208
28379 msgid "SHRINKING A VIRTUAL MACHINE DISK"
28380 msgstr ""
28381
28382 #. type: textblock
28383 #: ../tools/virt-resize.pl:210
28384 msgid ""
28385 "Shrinking is somewhat more complex than expanding, and only an overview is "
28386 "given here."
28387 msgstr ""
28388
28389 #. type: textblock
28390 #: ../tools/virt-resize.pl:213
28391 msgid ""
28392 "Firstly virt-resize will not attempt to shrink any partition content (PVs, "
28393 "filesystems).  The user has to shrink content before passing the disk image "
28394 "to virt-resize, and virt-resize will check that the content has been shrunk "
28395 "properly."
28396 msgstr ""
28397
28398 #. type: textblock
28399 #: ../tools/virt-resize.pl:218
28400 msgid "(Shrinking can also be done offline using L<guestfish(1)>)"
28401 msgstr ""
28402
28403 #. type: textblock
28404 #: ../tools/virt-resize.pl:220
28405 msgid ""
28406 "After shrinking PVs and filesystems, shut down the guest, and proceed with "
28407 "steps 3 and 4 above to allocate a new disk image."
28408 msgstr ""
28409
28410 #. type: textblock
28411 #: ../tools/virt-resize.pl:223
28412 msgid "Then run virt-resize with any of the C<--shrink> and/or C<--resize> options."
28413 msgstr ""
28414
28415 #. type: =head2
28416 #: ../tools/virt-resize.pl:226
28417 msgid "IGNORING OR DELETING PARTITIONS"
28418 msgstr ""
28419
28420 #. type: textblock
28421 #: ../tools/virt-resize.pl:228
28422 msgid ""
28423 "virt-resize also gives a convenient way to ignore or delete partitions when "
28424 "copying from the input disk to the output disk.  Ignoring a partition speeds "
28425 "up the copy where you don't care about the existing contents of a "
28426 "partition.  Deleting a partition removes it completely, but note that it "
28427 "also renumbers any partitions after the one which is deleted, which can "
28428 "leave some guests unbootable."
28429 msgstr ""
28430
28431 #. type: =head2
28432 #: ../tools/virt-resize.pl:235
28433 msgid "QCOW2 AND NON-SPARSE RAW FORMATS"
28434 msgstr ""
28435
28436 #. type: textblock
28437 #: ../tools/virt-resize.pl:237
28438 msgid ""
28439 "If the input disk is in qcow2 format, then you may prefer that the output is "
28440 "in qcow2 format as well.  Alternately, virt-resize can convert the format on "
28441 "the fly.  The output format is simply determined by the format of the empty "
28442 "output container that you provide.  Thus to create qcow2 output, use:"
28443 msgstr ""
28444
28445 #. type: verbatim
28446 #: ../tools/virt-resize.pl:243
28447 #, no-wrap
28448 msgid ""
28449 " qemu-img create [-c] -f qcow2 outdisk [size]\n"
28450 "\n"
28451 msgstr ""
28452
28453 #. type: textblock
28454 #: ../tools/virt-resize.pl:245
28455 msgid "instead of the truncate command (use C<-c> for a compressed disk)."
28456 msgstr ""
28457
28458 #. type: textblock
28459 #: ../tools/virt-resize.pl:247
28460 msgid "Similarly, to get non-sparse raw output use:"
28461 msgstr ""
28462
28463 #. type: verbatim
28464 #: ../tools/virt-resize.pl:249
28465 #, no-wrap
28466 msgid ""
28467 " fallocate -l size outdisk\n"
28468 "\n"
28469 msgstr ""
28470
28471 #. type: textblock
28472 #: ../tools/virt-resize.pl:251
28473 msgid ""
28474 "(on older systems that don't have the L<fallocate(1)> command use C<dd "
28475 "if=/dev/zero of=outdisk bs=1M count=..>)"
28476 msgstr ""
28477
28478 #. type: textblock
28479 #: ../tools/virt-resize.pl:264
28480 msgid "Display help."
28481 msgstr ""
28482
28483 #. type: =item
28484 #: ../tools/virt-resize.pl:278
28485 msgid "B<--resize part=size>"
28486 msgstr ""
28487
28488 #. type: textblock
28489 #: ../tools/virt-resize.pl:280
28490 msgid ""
28491 "Resize the named partition (expanding or shrinking it) so that it has the "
28492 "given size."
28493 msgstr ""
28494
28495 #. type: textblock
28496 #: ../tools/virt-resize.pl:283
28497 msgid ""
28498 "C<size> can be expressed as an absolute number followed by b/K/M/G/T/P/E to "
28499 "mean bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, Petabytes or "
28500 "Exabytes; or as a percentage of the current size; or as a relative number or "
28501 "percentage.  For example:"
28502 msgstr ""
28503
28504 #. type: verbatim
28505 #: ../tools/virt-resize.pl:288
28506 #, no-wrap
28507 msgid ""
28508 " --resize /dev/sda2=10G\n"
28509 "\n"
28510 msgstr ""
28511
28512 #. type: verbatim
28513 #: ../tools/virt-resize.pl:290
28514 #, no-wrap
28515 msgid ""
28516 " --resize /dev/sda4=90%\n"
28517 "\n"
28518 msgstr ""
28519
28520 #. type: verbatim
28521 #: ../tools/virt-resize.pl:292
28522 #, no-wrap
28523 msgid ""
28524 " --resize /dev/sda2=+1G\n"
28525 "\n"
28526 msgstr ""
28527
28528 #. type: verbatim
28529 #: ../tools/virt-resize.pl:294
28530 #, no-wrap
28531 msgid ""
28532 " --resize /dev/sda2=-200M\n"
28533 "\n"
28534 msgstr ""
28535
28536 #. type: verbatim
28537 #: ../tools/virt-resize.pl:296
28538 #, no-wrap
28539 msgid ""
28540 " --resize /dev/sda1=+128K\n"
28541 "\n"
28542 msgstr ""
28543
28544 #. type: verbatim
28545 #: ../tools/virt-resize.pl:298
28546 #, no-wrap
28547 msgid ""
28548 " --resize /dev/sda1=+10%\n"
28549 "\n"
28550 msgstr ""
28551
28552 #. type: verbatim
28553 #: ../tools/virt-resize.pl:300
28554 #, no-wrap
28555 msgid ""
28556 " --resize /dev/sda1=-10%\n"
28557 "\n"
28558 msgstr ""
28559
28560 #. type: textblock
28561 #: ../tools/virt-resize.pl:302
28562 msgid ""
28563 "You can increase the size of any partition.  Virt-resize will expand the "
28564 "direct content of the partition if it knows how (see C<--expand> below)."
28565 msgstr ""
28566
28567 #. type: textblock
28568 #: ../tools/virt-resize.pl:306
28569 msgid ""
28570 "You can only I<decrease> the size of partitions that contain filesystems or "
28571 "PVs which have already been shrunk.  Virt-resize will check this has been "
28572 "done before proceeding, or else will print an error (see also "
28573 "C<--resize-force>)."
28574 msgstr ""
28575
28576 #. type: textblock
28577 #: ../tools/virt-resize.pl:311 ../tools/virt-resize.pl:403 ../tools/virt-resize.pl:420
28578 msgid "You can give this option multiple times."
28579 msgstr ""
28580
28581 #. type: =item
28582 #: ../tools/virt-resize.pl:317
28583 msgid "B<--resize-force part=size>"
28584 msgstr ""
28585
28586 #. type: textblock
28587 #: ../tools/virt-resize.pl:319
28588 msgid ""
28589 "This is the same as C<--resize> except that it will let you decrease the "
28590 "size of any partition.  Generally this means you will lose any data which "
28591 "was at the end of the partition you shrink, but you may not care about that "
28592 "(eg. if shrinking an unused partition, or if you can easily recreate it such "
28593 "as a swap partition)."
28594 msgstr ""
28595
28596 #. type: textblock
28597 #: ../tools/virt-resize.pl:325
28598 msgid "See also the C<--ignore> option."
28599 msgstr ""
28600
28601 #. type: =item
28602 #: ../tools/virt-resize.pl:331
28603 msgid "B<--expand part>"
28604 msgstr ""
28605
28606 #. type: textblock
28607 #: ../tools/virt-resize.pl:333
28608 msgid ""
28609 "Expand the named partition so it uses up all extra space (space left over "
28610 "after any other resize changes that you request have been done)."
28611 msgstr ""
28612
28613 #. type: textblock
28614 #: ../tools/virt-resize.pl:336
28615 msgid ""
28616 "If virt-resize knows how, it will expand the direct content of the "
28617 "partition.  For example, if the partition is an LVM PV, it will expand the "
28618 "PV to fit (like calling L<pvresize(8)>).  Virt-resize leaves any other "
28619 "content it doesn't know about alone."
28620 msgstr ""
28621
28622 #. type: textblock
28623 #: ../tools/virt-resize.pl:341
28624 msgid "Currently virt-resize can resize:"
28625 msgstr ""
28626
28627 #. type: textblock
28628 #: ../tools/virt-resize.pl:347
28629 msgid ""
28630 "ext2, ext3 and ext4 filesystems when they are contained directly inside a "
28631 "partition."
28632 msgstr ""
28633
28634 #. type: textblock
28635 #: ../tools/virt-resize.pl:352
28636 msgid ""
28637 "NTFS filesystems contained directly in a partition, if libguestfs was "
28638 "compiled with support for NTFS."
28639 msgstr ""
28640
28641 #. type: textblock
28642 #: ../tools/virt-resize.pl:355
28643 msgid ""
28644 "The filesystem must have been shut down consistently last time it was used.  "
28645 "Additionally, L<ntfsresize(8)> marks the resized filesystem as requiring a "
28646 "consistency check, so at the first boot after resizing Windows will check "
28647 "the disk."
28648 msgstr ""
28649
28650 #. type: textblock
28651 #: ../tools/virt-resize.pl:362
28652 msgid ""
28653 "LVM PVs (physical volumes).  virt-resize does not usually resize anything "
28654 "inside the PV, but see the C<--LV-expand> option.  The user could also "
28655 "resize LVs as desired after boot."
28656 msgstr ""
28657
28658 #. type: textblock
28659 #: ../tools/virt-resize.pl:368 ../tools/virt-resize.pl:390
28660 msgid "Note that you cannot use C<--expand> and C<--shrink> together."
28661 msgstr ""
28662
28663 #. type: =item
28664 #: ../tools/virt-resize.pl:374
28665 msgid "B<--shrink part>"
28666 msgstr ""
28667
28668 #. type: textblock
28669 #: ../tools/virt-resize.pl:376
28670 msgid ""
28671 "Shrink the named partition until the overall disk image fits in the "
28672 "destination.  The named partition B<must> contain a filesystem or PV which "
28673 "has already been shrunk using another tool (eg. L<guestfish(1)> or other "
28674 "online tools).  Virt-resize will check this and give an error if it has not "
28675 "been done."
28676 msgstr ""
28677
28678 #. type: textblock
28679 #: ../tools/virt-resize.pl:382
28680 msgid ""
28681 "The amount by which the overall disk must be shrunk (after carrying out all "
28682 "other operations requested by the user) is called the \"deficit\".  For "
28683 "example, a straight copy (assume no other operations)  from a 5GB disk image "
28684 "to a 4GB disk image results in a 1GB deficit.  In this case, virt-resize "
28685 "would give an error unless the user specified a partition to shrink and that "
28686 "partition had more than a gigabyte of free space."
28687 msgstr ""
28688
28689 #. type: =item
28690 #: ../tools/virt-resize.pl:396
28691 msgid "B<--ignore part>"
28692 msgstr ""
28693
28694 #. type: textblock
28695 #: ../tools/virt-resize.pl:398
28696 msgid ""
28697 "Ignore the named partition.  Effectively this means the partition is "
28698 "allocated on the destination disk, but the content is not copied across from "
28699 "the source disk.  The content of the partition will be blank (all zero "
28700 "bytes)."
28701 msgstr ""
28702
28703 #. type: =item
28704 #: ../tools/virt-resize.pl:409
28705 msgid "B<--delete part>"
28706 msgstr ""
28707
28708 #. type: textblock
28709 #: ../tools/virt-resize.pl:411
28710 msgid ""
28711 "Delete the named partition.  It would be more accurate to describe this as "
28712 "\"don't copy it over\", since virt-resize doesn't do in-place changes and "
28713 "the original disk image is left intact."
28714 msgstr ""
28715
28716 #. type: textblock
28717 #: ../tools/virt-resize.pl:415
28718 msgid ""
28719 "Note that when you delete a partition, then anything contained in the "
28720 "partition is also deleted.  Furthermore, this causes any partitions that "
28721 "come after to be I<renumbered>, which can easily make your guest unbootable."
28722 msgstr ""
28723
28724 #. type: =item
28725 #: ../tools/virt-resize.pl:426
28726 msgid "B<--LV-expand logvol>"
28727 msgstr ""
28728
28729 #. type: textblock
28730 #: ../tools/virt-resize.pl:428
28731 msgid ""
28732 "This takes the logical volume and, as a final step, expands it to fill all "
28733 "the space available in its volume group.  A typical usage, assuming a Linux "
28734 "guest with a single PV C</dev/sda2> and a root device called "
28735 "C</dev/vg_guest/lv_root> would be:"
28736 msgstr ""
28737
28738 #. type: verbatim
28739 #: ../tools/virt-resize.pl:433
28740 #, no-wrap
28741 msgid ""
28742 " virt-resize indisk outdisk \\\n"
28743 "   --expand /dev/sda2 --LV-expand /dev/vg_guest/lv_root\n"
28744 "\n"
28745 msgstr ""
28746
28747 #. type: textblock
28748 #: ../tools/virt-resize.pl:436
28749 msgid ""
28750 "This would first expand the partition (and PV), and then expand the root "
28751 "device to fill the extra space in the PV."
28752 msgstr ""
28753
28754 #. type: textblock
28755 #: ../tools/virt-resize.pl:439
28756 msgid ""
28757 "The contents of the LV are also resized if virt-resize knows how to do "
28758 "that.  You can stop virt-resize from trying to expand the content by using "
28759 "the option C<--no-expand-content>."
28760 msgstr ""
28761
28762 #. type: textblock
28763 #: ../tools/virt-resize.pl:443
28764 msgid "Use L<virt-filesystems(1)> to list the filesystems in the guest."
28765 msgstr ""
28766
28767 #. type: textblock
28768 #: ../tools/virt-resize.pl:446
28769 msgid ""
28770 "You can give this option multiple times, I<but> it doesn't make sense to do "
28771 "this unless the logical volumes you specify are all in different volume "
28772 "groups."
28773 msgstr ""
28774
28775 #. type: =item
28776 #: ../tools/virt-resize.pl:454
28777 msgid "B<--no-copy-boot-loader>"
28778 msgstr ""
28779
28780 #. type: textblock
28781 #: ../tools/virt-resize.pl:456
28782 msgid ""
28783 "By default, virt-resize copies over some sectors at the start of the disk "
28784 "(up to the beginning of the first partition).  Commonly these sectors "
28785 "contain the Master Boot Record (MBR) and the boot loader, and are required "
28786 "in order for the guest to boot correctly."
28787 msgstr ""
28788
28789 #. type: textblock
28790 #: ../tools/virt-resize.pl:461
28791 msgid ""
28792 "If you specify this flag, then this initial copy is not done.  You may need "
28793 "to reinstall the boot loader in this case."
28794 msgstr ""
28795
28796 #. type: =item
28797 #: ../tools/virt-resize.pl:469
28798 msgid "B<--no-extra-partition>"
28799 msgstr ""
28800
28801 #. type: textblock
28802 #: ../tools/virt-resize.pl:471
28803 msgid ""
28804 "By default, virt-resize creates an extra partition if there is any extra, "
28805 "unused space after all resizing has happened.  Use this option to prevent "
28806 "the extra partition from being created.  If you do this then the extra space "
28807 "will be inaccessible until you run fdisk, parted, or some other partitioning "
28808 "tool in the guest."
28809 msgstr ""
28810
28811 #. type: textblock
28812 #: ../tools/virt-resize.pl:477
28813 msgid ""
28814 "Note that if the surplus space is smaller than 10 MB, no extra partition "
28815 "will be created."
28816 msgstr ""
28817
28818 #. type: =item
28819 #: ../tools/virt-resize.pl:484
28820 msgid "B<--no-expand-content>"
28821 msgstr ""
28822
28823 #. type: textblock
28824 #: ../tools/virt-resize.pl:486
28825 msgid ""
28826 "By default, virt-resize will try to expand the direct contents of "
28827 "partitions, if it knows how (see C<--expand> option above)."
28828 msgstr ""
28829
28830 #. type: textblock
28831 #: ../tools/virt-resize.pl:489
28832 msgid ""
28833 "If you give the C<--no-expand-content> option then virt-resize will not "
28834 "attempt this."
28835 msgstr ""
28836
28837 #. type: =item
28838 #: ../tools/virt-resize.pl:496
28839 msgid "B<-d> | B<--debug>"
28840 msgstr ""
28841
28842 #. type: =item
28843 #: ../tools/virt-resize.pl:504
28844 msgid "B<-n> | B<--dryrun>"
28845 msgstr ""
28846
28847 #. type: textblock
28848 #: ../tools/virt-resize.pl:506
28849 msgid "Print a summary of what would be done, but don't do anything."
28850 msgstr ""
28851
28852 #. type: =item
28853 #: ../tools/virt-resize.pl:512
28854 msgid "B<-q> | B<--quiet>"
28855 msgstr ""
28856
28857 #. type: textblock
28858 #: ../tools/virt-resize.pl:514
28859 msgid "Don't print the summary."
28860 msgstr ""
28861
28862 #. type: textblock
28863 #: ../tools/virt-resize.pl:522
28864 msgid ""
28865 "Specify the format of the input disk image.  If this flag is not given then "
28866 "it is auto-detected from the image itself."
28867 msgstr ""
28868
28869 #. type: textblock
28870 #: ../tools/virt-resize.pl:528
28871 msgid ""
28872 "Note that this option I<does not> affect the output format.  See L</QCOW2 "
28873 "AND NON-SPARSE RAW FORMATS>."
28874 msgstr ""
28875
28876 #. type: =item
28877 #: ../tools/virt-resize.pl:535
28878 msgid "B<--output-format> raw"
28879 msgstr ""
28880
28881 #. type: textblock
28882 #: ../tools/virt-resize.pl:537
28883 msgid ""
28884 "Specify the format of the output disk image.  If this flag is not given then "
28885 "it is auto-detected from the image itself."
28886 msgstr ""
28887
28888 #. type: textblock
28889 #: ../tools/virt-resize.pl:543
28890 msgid ""
28891 "Note that you still need to create the output disk with the right format.  "
28892 "See L</QCOW2 AND NON-SPARSE RAW FORMATS>."
28893 msgstr ""
28894
28895 #. type: =head1
28896 #: ../tools/virt-resize.pl:1419
28897 msgid "NOTES"
28898 msgstr ""
28899
28900 #. type: =head2
28901 #: ../tools/virt-resize.pl:1421
28902 msgid "\"Partition 1 does not end on cylinder boundary.\""
28903 msgstr ""
28904
28905 #. type: textblock
28906 #: ../tools/virt-resize.pl:1423
28907 msgid ""
28908 "Virt-resize aligns partitions to multiples of 64 sectors.  Usually this "
28909 "means the partitions will not be aligned to the ancient CHS geometry.  "
28910 "However CHS geometry is meaningless for disks manufactured since the early "
28911 "1990s, and doubly so for virtual hard drives.  Alignment of partitions to "
28912 "cylinders is not required by any modern operating system."
28913 msgstr ""
28914
28915 #. type: =head2
28916 #: ../tools/virt-resize.pl:1430
28917 msgid "RESIZING WINDOWS VIRTUAL MACHINES"
28918 msgstr ""
28919
28920 #. type: textblock
28921 #: ../tools/virt-resize.pl:1432
28922 msgid ""
28923 "In Windows Vista and later versions, Microsoft switched to using a separate "
28924 "boot partition.  In these VMs, typically C</dev/sda1> is the boot partition "
28925 "and C</dev/sda2> is the main (C:) drive.  We have not had any luck resizing "
28926 "the boot partition.  Doing so seems to break the guest completely.  However "
28927 "expanding the second partition (ie. C: drive) should work."
28928 msgstr ""
28929
28930 #. type: textblock
28931 #: ../tools/virt-resize.pl:1439
28932 msgid ""
28933 "Windows may initiate a lengthy \"chkdsk\" on first boot after a resize, if "
28934 "NTFS partitions have been expanded.  This is just a safety check and (unless "
28935 "it find errors) is nothing to worry about."
28936 msgstr ""
28937
28938 #. type: =head2
28939 #: ../tools/virt-resize.pl:1443
28940 msgid "GUEST BOOT STUCK AT \"GRUB\""
28941 msgstr ""
28942
28943 #. type: textblock
28944 #: ../tools/virt-resize.pl:1445
28945 msgid ""
28946 "If a Linux guest does not boot after resizing, and the boot is stuck after "
28947 "printing C<GRUB> on the console, try reinstalling grub.  This sometimes "
28948 "happens on older (RHEL 5-era) guests, for reasons we don't fully understand, "
28949 "although we think is to do with partition alignment."
28950 msgstr ""
28951
28952 #. type: verbatim
28953 #: ../tools/virt-resize.pl:1450
28954 #, no-wrap
28955 msgid ""
28956 " guestfish -i -a newdisk\n"
28957 " ><fs> cat /boot/grub/device.map\n"
28958 " # check the contents of this file are sensible or\n"
28959 " # edit the file if necessary\n"
28960 " ><fs> grub-install / /dev/vda\n"
28961 " ><fs> exit\n"
28962 "\n"
28963 msgstr ""
28964
28965 #. type: textblock
28966 #: ../tools/virt-resize.pl:1457
28967 msgid ""
28968 "For more flexible guest reconfiguration, including if you need to specify "
28969 "other parameters to grub-install, use L<virt-rescue(1)>."
28970 msgstr ""
28971
28972 #. type: =head1
28973 #: ../tools/virt-resize.pl:1460
28974 msgid "ALTERNATIVE TOOLS"
28975 msgstr ""
28976
28977 #. type: textblock
28978 #: ../tools/virt-resize.pl:1462
28979 msgid ""
28980 "There are several proprietary tools for resizing partitions.  We won't "
28981 "mention any here."
28982 msgstr ""
28983
28984 #. type: textblock
28985 #: ../tools/virt-resize.pl:1465
28986 msgid ""
28987 "L<parted(8)> and its graphical shell gparted can do some types of resizing "
28988 "operations on disk images.  They can resize and move partitions, but I don't "
28989 "think they can do anything with the contents, and they certainly don't "
28990 "understand LVM."
28991 msgstr ""
28992
28993 #. type: textblock
28994 #: ../tools/virt-resize.pl:1470
28995 msgid ""
28996 "L<guestfish(1)> can do everything that virt-resize can do and a lot more, "
28997 "but at a much lower level.  You will probably end up hand-calculating sector "
28998 "offsets, which is something that virt-resize was designed to avoid.  If you "
28999 "want to see the guestfish-equivalent commands that virt-resize runs, use the "
29000 "C<--debug> flag."
29001 msgstr ""
29002
29003 #. type: textblock
29004 #: ../tools/virt-resize.pl:1485
29005 msgid ""
29006 "L<virt-filesystems(1)>, L<virt-df(1)>, L<guestfs(3)>, L<guestfish(1)>, "
29007 "L<lvm(8)>, L<pvresize(8)>, L<lvresize(8)>, L<resize2fs(8)>, "
29008 "L<ntfsresize(8)>, L<virsh(1)>, L<parted(8)>, L<truncate(1)>, "
29009 "L<fallocate(1)>, L<grub(8)>, L<grub-install(8)>, L<virt-rescue(1)>, "
29010 "L<Sys::Guestfs(3)>, L<http://libguestfs.org/>."
29011 msgstr ""
29012
29013 #. type: textblock
29014 #: ../tools/virt-list-filesystems.pl:32
29015 msgid "virt-list-filesystems - List filesystems in a virtual machine or disk image"
29016 msgstr ""
29017
29018 #. type: verbatim
29019 #: ../tools/virt-list-filesystems.pl:36
29020 #, no-wrap
29021 msgid ""
29022 " virt-list-filesystems [--options] domname\n"
29023 "\n"
29024 msgstr ""
29025
29026 #. type: verbatim
29027 #: ../tools/virt-list-filesystems.pl:38
29028 #, no-wrap
29029 msgid ""
29030 " virt-list-filesystems [--options] disk.img [disk.img ...]\n"
29031 "\n"
29032 msgstr ""
29033
29034 #. type: textblock
29035 #: ../tools/virt-list-filesystems.pl:42 ../tools/virt-list-partitions.pl:42
29036 msgid ""
29037 "This tool is obsolete.  Use L<virt-filesystems(1)> as a more flexible "
29038 "replacement."
29039 msgstr ""
29040
29041 #. type: textblock
29042 #: ../tools/virt-list-filesystems.pl:45
29043 msgid ""
29044 "C<virt-list-filesystems> is a command line tool to list the filesystems that "
29045 "are contained in a virtual machine or disk image."
29046 msgstr ""
29047
29048 #. type: textblock
29049 #: ../tools/virt-list-filesystems.pl:49
29050 msgid ""
29051 "C<virt-list-filesystems> is just a simple wrapper around L<libguestfs(3)> "
29052 "functionality.  For more complex cases you should look at the "
29053 "L<guestfish(1)> tool."
29054 msgstr ""
29055
29056 #. type: =item
29057 #: ../tools/virt-list-filesystems.pl:106 ../tools/virt-list-partitions.pl:115
29058 msgid "B<-l> | B<--long>"
29059 msgstr ""
29060
29061 #. type: textblock
29062 #: ../tools/virt-list-filesystems.pl:108
29063 msgid ""
29064 "With this option, C<virt-list-filesystems> displays the type of each "
29065 "filesystem too (where \"type\" means C<ext3>, C<xfs> etc.)"
29066 msgstr ""
29067
29068 #. type: =item
29069 #: ../tools/virt-list-filesystems.pl:115
29070 msgid "B<-a> | B<--all>"
29071 msgstr ""
29072
29073 #. type: textblock
29074 #: ../tools/virt-list-filesystems.pl:117
29075 msgid ""
29076 "Normally we only show mountable filesystems.  If this option is given then "
29077 "swap devices are shown too."
29078 msgstr ""
29079
29080 #. type: textblock
29081 #: ../tools/virt-list-filesystems.pl:191
29082 msgid ""
29083 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-tar(1)>, "
29084 "L<virt-filesystems(1)>, L<virt-list-partitions(1)>, L<Sys::Guestfs(3)>, "
29085 "L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
29086 msgstr ""
29087
29088 #. type: textblock
29089 #: ../tools/virt-list-filesystems.pl:208 ../tools/virt-tar.pl:298
29090 msgid "Copyright (C) 2009 Red Hat Inc."
29091 msgstr ""
29092
29093 #. type: textblock
29094 #: ../tools/virt-tar.pl:33
29095 msgid "virt-tar - Extract or upload files to a virtual machine"
29096 msgstr ""
29097
29098 #. type: verbatim
29099 #: ../tools/virt-tar.pl:37
29100 #, no-wrap
29101 msgid ""
29102 " virt-tar [--options] -x domname directory tarball\n"
29103 "\n"
29104 msgstr ""
29105
29106 #. type: verbatim
29107 #: ../tools/virt-tar.pl:39
29108 #, no-wrap
29109 msgid ""
29110 " virt-tar [--options] -u domname tarball directory\n"
29111 "\n"
29112 msgstr ""
29113
29114 #. type: verbatim
29115 #: ../tools/virt-tar.pl:41
29116 #, no-wrap
29117 msgid ""
29118 " virt-tar [--options] disk.img [disk.img ...] -x directory tarball\n"
29119 "\n"
29120 msgstr ""
29121
29122 #. type: verbatim
29123 #: ../tools/virt-tar.pl:43
29124 #, no-wrap
29125 msgid ""
29126 " virt-tar [--options] disk.img [disk.img ...] -u tarball directory\n"
29127 "\n"
29128 msgstr ""
29129
29130 #. type: textblock
29131 #: ../tools/virt-tar.pl:47
29132 msgid "Download C</home> from the VM into a local tarball:"
29133 msgstr ""
29134
29135 #. type: verbatim
29136 #: ../tools/virt-tar.pl:49
29137 #, no-wrap
29138 msgid ""
29139 " virt-tar -x domname /home home.tar\n"
29140 "\n"
29141 msgstr ""
29142
29143 #. type: verbatim
29144 #: ../tools/virt-tar.pl:51
29145 #, no-wrap
29146 msgid ""
29147 " virt-tar -zx domname /home home.tar.gz\n"
29148 "\n"
29149 msgstr ""
29150
29151 #. type: textblock
29152 #: ../tools/virt-tar.pl:53
29153 msgid "Upload a local tarball and unpack it inside C</tmp> in the VM:"
29154 msgstr ""
29155
29156 #. type: verbatim
29157 #: ../tools/virt-tar.pl:55
29158 #, no-wrap
29159 msgid ""
29160 " virt-tar -u domname uploadstuff.tar /tmp\n"
29161 "\n"
29162 msgstr ""
29163
29164 #. type: verbatim
29165 #: ../tools/virt-tar.pl:57
29166 #, no-wrap
29167 msgid ""
29168 " virt-tar -zu domname uploadstuff.tar.gz /tmp\n"
29169 "\n"
29170 msgstr ""
29171
29172 #. type: textblock
29173 #: ../tools/virt-tar.pl:61
29174 msgid ""
29175 "You must I<not> use C<virt-tar> with the C<-u> option (upload) on live "
29176 "virtual machines.  If you do this, you risk disk corruption in the VM.  "
29177 "C<virt-tar> tries to stop you from doing this, but doesn't catch all cases."
29178 msgstr ""
29179
29180 #. type: textblock
29181 #: ../tools/virt-tar.pl:66
29182 msgid ""
29183 "You can use C<-x> (extract) on live virtual machines, but you might get "
29184 "inconsistent results or errors if there is filesystem activity inside the "
29185 "VM.  If the live VM is synched and quiescent, then C<virt-tar> will usually "
29186 "work, but the only way to guarantee consistent results is if the virtual "
29187 "machine is shut down."
29188 msgstr ""
29189
29190 #. type: textblock
29191 #: ../tools/virt-tar.pl:74
29192 msgid ""
29193 "C<virt-tar> is a general purpose archive tool for downloading and uploading "
29194 "parts of a guest filesystem.  There are many possibilities: making backups, "
29195 "uploading data files, snooping on guest activity, fixing or customizing "
29196 "guests, etc."
29197 msgstr ""
29198
29199 #. type: textblock
29200 #: ../tools/virt-tar.pl:79
29201 msgid ""
29202 "If you want to just view a single file, use L<virt-cat(1)>.  If you just "
29203 "want to edit a single file, use L<virt-edit(1)>.  For more complex cases you "
29204 "should look at the L<guestfish(1)> tool."
29205 msgstr ""
29206
29207 #. type: textblock
29208 #: ../tools/virt-tar.pl:83
29209 msgid ""
29210 "There are two modes of operation: C<-x> (eXtract) downloads a directory and "
29211 "its contents (recursively) from the virtual machine into a local tarball.  "
29212 "C<-u> uploads from a local tarball, unpacking it into a directory inside the "
29213 "virtual machine.  You cannot use these two options together."
29214 msgstr ""
29215
29216 #. type: textblock
29217 #: ../tools/virt-tar.pl:89
29218 msgid ""
29219 "In addition, you may need to use the C<-z> (gZip) option to enable "
29220 "compression.  When uploading, you have to specify C<-z> if the upload file "
29221 "is compressed because virt-tar won't detect this on its own."
29222 msgstr ""
29223
29224 #. type: textblock
29225 #: ../tools/virt-tar.pl:93
29226 msgid ""
29227 "C<virt-tar> can only handle tar (optionally gzipped) format tarballs.  For "
29228 "example it cannot do PKZip files or bzip2 compression.  If you want that "
29229 "then you'll have to rebuild the tarballs yourself.  (This is a limitation of "
29230 "the L<libguestfs(3)> API)."
29231 msgstr ""
29232
29233 #. type: =item
29234 #: ../tools/virt-tar.pl:151
29235 msgid "B<-x> | B<--extract> | B<--download>"
29236 msgstr ""
29237
29238 #. type: =item
29239 #: ../tools/virt-tar.pl:153
29240 msgid "B<-u> | B<--upload>"
29241 msgstr ""
29242
29243 #. type: textblock
29244 #: ../tools/virt-tar.pl:155
29245 msgid ""
29246 "Use C<-x> to extract (download) a directory from a virtual machine to a "
29247 "local tarball."
29248 msgstr ""
29249
29250 #. type: textblock
29251 #: ../tools/virt-tar.pl:158
29252 msgid ""
29253 "Use C<-u> to upload and unpack from a local tarball into a virtual machine.  "
29254 "Please read the L</WARNING> section above before using this option."
29255 msgstr ""
29256
29257 #. type: textblock
29258 #: ../tools/virt-tar.pl:162
29259 msgid "You must specify exactly one of these options."
29260 msgstr ""
29261
29262 #. type: =item
29263 #: ../tools/virt-tar.pl:168
29264 msgid "B<-z> | B<--gzip>"
29265 msgstr ""
29266
29267 #. type: textblock
29268 #: ../tools/virt-tar.pl:170
29269 msgid "Specify that the input or output tarball is gzip-compressed."
29270 msgstr ""
29271
29272 #. type: textblock
29273 #: ../tools/virt-tar.pl:283
29274 msgid ""
29275 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-edit(1)>, "
29276 "L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, "
29277 "L<http://libguestfs.org/>."
29278 msgstr ""
29279
29280 #. type: textblock
29281 #: ../tools/virt-make-fs.pl:37
29282 msgid "virt-make-fs - Make a filesystem from a tar archive or files"
29283 msgstr ""
29284
29285 #. type: verbatim
29286 #: ../tools/virt-make-fs.pl:41
29287 #, no-wrap
29288 msgid ""
29289 " virt-make-fs [--options] input.tar output.img\n"
29290 "\n"
29291 msgstr ""
29292
29293 #. type: verbatim
29294 #: ../tools/virt-make-fs.pl:43
29295 #, no-wrap
29296 msgid ""
29297 " virt-make-fs [--options] input.tar.gz output.img\n"
29298 "\n"
29299 msgstr ""
29300
29301 #. type: verbatim
29302 #: ../tools/virt-make-fs.pl:45
29303 #, no-wrap
29304 msgid ""
29305 " virt-make-fs [--options] directory output.img\n"
29306 "\n"
29307 msgstr ""
29308
29309 #. type: textblock
29310 #: ../tools/virt-make-fs.pl:49
29311 msgid ""
29312 "Virt-make-fs is a command line tool for creating a filesystem from a tar "
29313 "archive or some files in a directory.  It is similar to tools like "
29314 "L<mkisofs(1)>, L<genisoimage(1)> and L<mksquashfs(1)>.  Unlike those tools, "
29315 "it can create common filesystem types like ext2/3 or NTFS, which can be "
29316 "useful if you want to attach these filesystems to existing virtual machines "
29317 "(eg. to import large amounts of read-only data to a VM)."
29318 msgstr ""
29319
29320 #. type: textblock
29321 #: ../tools/virt-make-fs.pl:57
29322 msgid "Basic usage is:"
29323 msgstr ""
29324
29325 #. type: verbatim
29326 #: ../tools/virt-make-fs.pl:59
29327 #, no-wrap
29328 msgid ""
29329 " virt-make-fs input output\n"
29330 "\n"
29331 msgstr ""
29332
29333 #. type: textblock
29334 #: ../tools/virt-make-fs.pl:61
29335 msgid ""
29336 "where C<input> is either a directory containing files that you want to add, "
29337 "or a tar archive (either uncompressed tar or gzip-compressed tar); and "
29338 "C<output> is a disk image.  The input type is detected automatically.  The "
29339 "output disk image defaults to a raw ext2 image unless you specify extra "
29340 "flags (see L</OPTIONS> below)."
29341 msgstr ""
29342
29343 #. type: =head2
29344 #: ../tools/virt-make-fs.pl:67
29345 msgid "EXTRA SPACE"
29346 msgstr ""
29347
29348 #. type: textblock
29349 #: ../tools/virt-make-fs.pl:69
29350 msgid ""
29351 "Unlike formats such as tar and squashfs, a filesystem does not \"just fit\" "
29352 "the files that it contains, but might have extra space.  Depending on how "
29353 "you are going to use the output, you might think this extra space is wasted "
29354 "and want to minimize it, or you might want to leave space so that more files "
29355 "can be added later.  Virt-make-fs defaults to minimizing the extra space, "
29356 "but you can use the C<--size> flag to leave space in the filesystem if you "
29357 "want it."
29358 msgstr ""
29359
29360 #. type: textblock
29361 #: ../tools/virt-make-fs.pl:77
29362 msgid ""
29363 "An alternative way to leave extra space but not make the output image any "
29364 "bigger is to use an alternative disk image format (instead of the default "
29365 "\"raw\" format).  Using C<--format=qcow2> will use the native QEmu/KVM qcow2 "
29366 "image format (check your hypervisor supports this before using it).  This "
29367 "allows you to choose a large C<--size> but the extra space won't actually be "
29368 "allocated in the image until you try to store something in it."
29369 msgstr ""
29370
29371 #. type: textblock
29372 #: ../tools/virt-make-fs.pl:85
29373 msgid ""
29374 "Don't forget that you can also use local commands including L<resize2fs(8)> "
29375 "and L<virt-resize(1)> to resize existing filesystems, or rerun virt-make-fs "
29376 "to build another image from scratch."
29377 msgstr ""
29378
29379 #. type: =head3
29380 #: ../tools/virt-make-fs.pl:89 ../tools/virt-make-fs.pl:123 ../tools/virt-make-fs.pl:142
29381 msgid "EXAMPLE"
29382 msgstr ""
29383
29384 #. type: verbatim
29385 #: ../tools/virt-make-fs.pl:91
29386 #, no-wrap
29387 msgid ""
29388 " virt-make-fs --format=qcow2 --size=+200M input output.img\n"
29389 "\n"
29390 msgstr ""
29391
29392 #. type: =head2
29393 #: ../tools/virt-make-fs.pl:93
29394 msgid "FILESYSTEM TYPE"
29395 msgstr ""
29396
29397 #. type: textblock
29398 #: ../tools/virt-make-fs.pl:95
29399 msgid ""
29400 "The default filesystem type is C<ext2>.  Just about any filesystem type that "
29401 "libguestfs supports can be used (but I<not> read-only formats like "
29402 "ISO9660).  Here are some of the more common choices:"
29403 msgstr ""
29404
29405 #. type: =item
29406 #: ../tools/virt-make-fs.pl:101
29407 msgid "I<ext3>"
29408 msgstr ""
29409
29410 #. type: textblock
29411 #: ../tools/virt-make-fs.pl:103
29412 msgid ""
29413 "Note that ext3 filesystems contain a journal, typically 1-32 MB in size.  If "
29414 "you are not going to use the filesystem in a way that requires the journal, "
29415 "then this is just wasted overhead."
29416 msgstr ""
29417
29418 #. type: =item
29419 #: ../tools/virt-make-fs.pl:107
29420 msgid "I<ntfs> or I<vfat>"
29421 msgstr ""
29422
29423 #. type: textblock
29424 #: ../tools/virt-make-fs.pl:109
29425 msgid "Useful if exporting data to a Windows guest."
29426 msgstr ""
29427
29428 #. type: textblock
29429 #: ../tools/virt-make-fs.pl:111
29430 msgid ""
29431 "I<Note for vfat>: The tar archive or local directory must only contain files "
29432 "which are owned by root (ie. UID:GID = 0:0).  The reason is that the tar "
29433 "program running within libguestfs is unable to change the ownership of "
29434 "non-root files, since vfat itself does not support this."
29435 msgstr ""
29436
29437 #. type: =item
29438 #: ../tools/virt-make-fs.pl:116
29439 msgid "I<minix>"
29440 msgstr ""
29441
29442 #. type: textblock
29443 #: ../tools/virt-make-fs.pl:118
29444 msgid ""
29445 "Lower overhead than C<ext2>, but certain limitations on filename length and "
29446 "total filesystem size."
29447 msgstr ""
29448
29449 #. type: verbatim
29450 #: ../tools/virt-make-fs.pl:125
29451 #, no-wrap
29452 msgid ""
29453 " virt-make-fs --type=minix input minixfs.img\n"
29454 "\n"
29455 msgstr ""
29456
29457 #. type: =head2
29458 #: ../tools/virt-make-fs.pl:127
29459 msgid "TO PARTITION OR NOT TO PARTITION"
29460 msgstr ""
29461
29462 #. type: textblock
29463 #: ../tools/virt-make-fs.pl:129
29464 msgid "Optionally virt-make-fs can add a partition table to the output disk."
29465 msgstr ""
29466
29467 #. type: textblock
29468 #: ../tools/virt-make-fs.pl:131
29469 msgid ""
29470 "Adding a partition can make the disk image more compatible with certain "
29471 "virtualized operating systems which don't expect to see a filesystem "
29472 "directly located on a block device (Linux doesn't care and will happily "
29473 "handle both types)."
29474 msgstr ""
29475
29476 #. type: textblock
29477 #: ../tools/virt-make-fs.pl:136
29478 msgid ""
29479 "On the other hand, if you have a partition table then the output image is no "
29480 "longer a straight filesystem.  For example you cannot run L<fsck(8)> "
29481 "directly on a partitioned disk image.  (However libguestfs tools such as "
29482 "L<guestfish(1)> and L<virt-resize(1)> can still be used)."
29483 msgstr ""
29484
29485 #. type: textblock
29486 #: ../tools/virt-make-fs.pl:144
29487 msgid "Add an MBR partition:"
29488 msgstr ""
29489
29490 #. type: verbatim
29491 #: ../tools/virt-make-fs.pl:146
29492 #, no-wrap
29493 msgid ""
29494 " virt-make-fs --partition -- input disk.img\n"
29495 "\n"
29496 msgstr ""
29497
29498 #. type: textblock
29499 #: ../tools/virt-make-fs.pl:148
29500 msgid ""
29501 "If the output disk image could be terabyte-sized or larger, it's better to "
29502 "use an EFI/GPT-compatible partition table:"
29503 msgstr ""
29504
29505 #. type: verbatim
29506 #: ../tools/virt-make-fs.pl:151
29507 #, no-wrap
29508 msgid ""
29509 " virt-make-fs --partition=gpt --size=+4T --format=qcow2 input disk.img\n"
29510 "\n"
29511 msgstr ""
29512
29513 #. type: textblock
29514 #: ../tools/virt-make-fs.pl:179
29515 msgid "Enable debugging information."
29516 msgstr ""
29517
29518 #. type: =item
29519 #: ../tools/virt-make-fs.pl:185
29520 msgid "B<--size=E<lt>NE<gt>>"
29521 msgstr ""
29522
29523 #. type: =item
29524 #: ../tools/virt-make-fs.pl:187
29525 msgid "B<--size=+E<lt>NE<gt>>"
29526 msgstr ""
29527
29528 #. type: =item
29529 #: ../tools/virt-make-fs.pl:189
29530 msgid "B<-s E<lt>NE<gt>>"
29531 msgstr ""
29532
29533 #. type: =item
29534 #: ../tools/virt-make-fs.pl:191
29535 msgid "B<-s +E<lt>NE<gt>>"
29536 msgstr ""
29537
29538 #. type: textblock
29539 #: ../tools/virt-make-fs.pl:193
29540 msgid "Use the C<--size> (or C<-s>) option to choose the size of the output image."
29541 msgstr ""
29542
29543 #. type: textblock
29544 #: ../tools/virt-make-fs.pl:196
29545 msgid ""
29546 "If this option is I<not> given, then the output image will be just large "
29547 "enough to contain all the files, with not much wasted space."
29548 msgstr ""
29549
29550 #. type: textblock
29551 #: ../tools/virt-make-fs.pl:199
29552 msgid ""
29553 "To choose a fixed size output disk, specify an absolute number followed by "
29554 "b/K/M/G/T/P/E to mean bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, "
29555 "Petabytes or Exabytes.  This must be large enough to contain all the input "
29556 "files, else you will get an error."
29557 msgstr ""
29558
29559 #. type: textblock
29560 #: ../tools/virt-make-fs.pl:204
29561 msgid ""
29562 "To leave extra space, specify C<+> (plus sign) and a number followed by "
29563 "b/K/M/G/T/P/E to mean bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, "
29564 "Petabytes or Exabytes.  For example: C<--size=+200M> means enough space for "
29565 "the input files, and (approximately) an extra 200 MB free space."
29566 msgstr ""
29567
29568 #. type: textblock
29569 #: ../tools/virt-make-fs.pl:210
29570 msgid ""
29571 "Note that virt-make-fs estimates free space, and therefore will not produce "
29572 "filesystems containing precisely the free space requested.  (It is much more "
29573 "expensive and time-consuming to produce a filesystem which has precisely the "
29574 "desired free space)."
29575 msgstr ""
29576
29577 #. type: =item
29578 #: ../tools/virt-make-fs.pl:219
29579 msgid "B<--format=E<lt>fmtE<gt>>"
29580 msgstr ""
29581
29582 #. type: =item
29583 #: ../tools/virt-make-fs.pl:221
29584 msgid "B<-F E<lt>fmtE<gt>>"
29585 msgstr ""
29586
29587 #. type: textblock
29588 #: ../tools/virt-make-fs.pl:223
29589 msgid "Choose the output disk image format."
29590 msgstr ""
29591
29592 #. type: textblock
29593 #: ../tools/virt-make-fs.pl:225
29594 msgid "The default is C<raw> (raw disk image)."
29595 msgstr ""
29596
29597 #. type: textblock
29598 #: ../tools/virt-make-fs.pl:227
29599 msgid ""
29600 "For other choices, see the L<qemu-img(1)> manpage.  The only other choice "
29601 "that would really make sense here is C<qcow2>."
29602 msgstr ""
29603
29604 #. type: =item
29605 #: ../tools/virt-make-fs.pl:234
29606 msgid "B<--type=E<lt>fsE<gt>>"
29607 msgstr ""
29608
29609 #. type: =item
29610 #: ../tools/virt-make-fs.pl:236
29611 msgid "B<-t E<lt>fsE<gt>>"
29612 msgstr ""
29613
29614 #. type: textblock
29615 #: ../tools/virt-make-fs.pl:238
29616 msgid "Choose the output filesystem type."
29617 msgstr ""
29618
29619 #. type: textblock
29620 #: ../tools/virt-make-fs.pl:240
29621 msgid "The default is C<ext2>."
29622 msgstr ""
29623
29624 #. type: textblock
29625 #: ../tools/virt-make-fs.pl:242
29626 msgid "Any filesystem which is supported read-write by libguestfs can be used here."
29627 msgstr ""
29628
29629 #. type: =item
29630 #: ../tools/virt-make-fs.pl:249
29631 msgid "B<--partition>"
29632 msgstr ""
29633
29634 #. type: =item
29635 #: ../tools/virt-make-fs.pl:251
29636 msgid "B<--partition=E<lt>parttypeE<gt>>"
29637 msgstr ""
29638
29639 #. type: textblock
29640 #: ../tools/virt-make-fs.pl:253
29641 msgid ""
29642 "If specified, this flag adds an MBR partition table to the output disk "
29643 "image."
29644 msgstr ""
29645
29646 #. type: textblock
29647 #: ../tools/virt-make-fs.pl:256
29648 msgid ""
29649 "You can change the partition table type, eg. C<--partition=gpt> for large "
29650 "disks."
29651 msgstr ""
29652
29653 #. type: textblock
29654 #: ../tools/virt-make-fs.pl:259
29655 msgid ""
29656 "Note that if you just use a lonesome C<--partition>, the Perl option parser "
29657 "might consider the next parameter to be the partition type.  For example:"
29658 msgstr ""
29659
29660 #. type: verbatim
29661 #: ../tools/virt-make-fs.pl:263
29662 #, no-wrap
29663 msgid ""
29664 " virt-make-fs --partition input.tar ...\n"
29665 "\n"
29666 msgstr ""
29667
29668 #. type: textblock
29669 #: ../tools/virt-make-fs.pl:265
29670 msgid ""
29671 "would cause virt-make-fs to think you wanted to use a partition type of "
29672 "C<input.tar> which is completely wrong.  To avoid this, use C<--> (a double "
29673 "dash) between options and the input file argument:"
29674 msgstr ""
29675
29676 #. type: verbatim
29677 #: ../tools/virt-make-fs.pl:269
29678 #, no-wrap
29679 msgid ""
29680 " virt-make-fs --partition -- input.tar ...\n"
29681 "\n"
29682 msgstr ""
29683
29684 #. type: textblock
29685 #: ../tools/virt-make-fs.pl:541
29686 msgid ""
29687 "L<guestfish(1)>, L<virt-resize(1)>, L<virt-tar(1)>, L<mkisofs(1)>, "
29688 "L<genisoimage(1)>, L<mksquashfs(1)>, L<mke2fs(8)>, L<resize2fs(8)>, "
29689 "L<guestfs(3)>, L<Sys::Guestfs(3)>, L<http://libguestfs.org/>."
29690 msgstr ""
29691
29692 #. type: verbatim
29693 #: ../tools/virt-make-fs.pl:558
29694 #, no-wrap
29695 msgid ""
29696 " export LIBGUESTFS_DEBUG=1\n"
29697 " virt-make-fs --debug [...] > /tmp/virt-make-fs.log 2>&1\n"
29698 "\n"
29699 msgstr ""
29700
29701 #. type: textblock
29702 #: ../tools/virt-make-fs.pl:561
29703 msgid ""
29704 "Attach /tmp/virt-make-fs.log to a new bug report at "
29705 "L<https://bugzilla.redhat.com/>"
29706 msgstr ""
29707
29708 #. type: textblock
29709 #: ../tools/virt-list-partitions.pl:32
29710 msgid "virt-list-partitions - List partitions in a virtual machine or disk image"
29711 msgstr ""
29712
29713 #. type: verbatim
29714 #: ../tools/virt-list-partitions.pl:36
29715 #, no-wrap
29716 msgid ""
29717 " virt-list-partitions [--options] domname\n"
29718 "\n"
29719 msgstr ""
29720
29721 #. type: verbatim
29722 #: ../tools/virt-list-partitions.pl:38
29723 #, no-wrap
29724 msgid ""
29725 " virt-list-partitions [--options] disk.img [disk.img ...]\n"
29726 "\n"
29727 msgstr ""
29728
29729 #. type: textblock
29730 #: ../tools/virt-list-partitions.pl:45
29731 msgid ""
29732 "C<virt-list-partitions> is a command line tool to list the partitions that "
29733 "are contained in a virtual machine or disk image.  It is mainly useful as a "
29734 "first step to using L<virt-resize(1)>."
29735 msgstr ""
29736
29737 #. type: textblock
29738 #: ../tools/virt-list-partitions.pl:50
29739 msgid ""
29740 "C<virt-list-partitions> is just a simple wrapper around L<libguestfs(3)> "
29741 "functionality.  For more complex cases you should look at the "
29742 "L<guestfish(1)> tool."
29743 msgstr ""
29744
29745 #. type: =item
29746 #: ../tools/virt-list-partitions.pl:107
29747 msgid "B<-h> | B<--human-readable>"
29748 msgstr ""
29749
29750 #. type: textblock
29751 #: ../tools/virt-list-partitions.pl:109
29752 msgid "Show sizes in human-readable form (eg. \"1G\")."
29753 msgstr ""
29754
29755 #. type: textblock
29756 #: ../tools/virt-list-partitions.pl:117
29757 msgid ""
29758 "With this option, C<virt-list-partitions> displays the type and size of each "
29759 "partition too (where \"type\" means C<ext3>, C<pv> etc.)"
29760 msgstr ""
29761
29762 #. type: =item
29763 #: ../tools/virt-list-partitions.pl:124
29764 msgid "B<-t> | B<--total>"
29765 msgstr ""
29766
29767 #. type: textblock
29768 #: ../tools/virt-list-partitions.pl:126
29769 msgid "Display the total size of each block device (as a separate row or rows)."
29770 msgstr ""
29771
29772 #. type: textblock
29773 #: ../tools/virt-list-partitions.pl:259
29774 msgid ""
29775 "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, "
29776 "L<virt-list-filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, "
29777 "L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
29778 msgstr ""
29779
29780 #. type: textblock
29781 #: ../tools/virt-list-partitions.pl:275
29782 msgid "Copyright (C) 2009-2010 Red Hat Inc."
29783 msgstr ""