po-docs/ja.po

   1 # SOME DESCRIPTIVE TITLE.
   2 # Copyright (C) YEAR Free Software Foundation, Inc.
   3 # FIRST AUTHOR <EMAIL@ADDRESS>, YEAR.
   4 #
   5 #, fuzzy
   6 msgid ""
   7 msgstr ""
   8 "Project-Id-Version: PACKAGE VERSION\n"
   9 "Report-Msgid-Bugs-To: libguestfs@redhat.com\n"
  10 "POT-Creation-Date: 2011-09-16 16:55+0200\n"
  11 "PO-Revision-Date: 2010-09-02 14:46+0100\n"
  12 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
  13 "Language-Team: LANGUAGE <LL@li.org>\n"
  14 "Language: \n"
  15 "MIME-Version: 1.0\n"
  16 "Content-Type: text/plain; charset=UTF-8\n"
  17 "Content-Transfer-Encoding: 8bit\n"
  18
  19 # type: =head1
  20 #. type: =head1
  21 #: ../src/guestfs.pod:3 ../fish/guestfish.pod:3
  22 #: ../test-tool/libguestfs-test-tool.pod:3 ../fuse/guestmount.pod:3
  23 #: ../tools/virt-edit.pl:32 ../tools/virt-win-reg.pl:35
  24 #: ../tools/virt-list-filesystems.pl:30 ../tools/virt-tar.pl:31
  25 #: ../tools/virt-make-fs.pl:35 ../tools/virt-list-partitions.pl:30
  26 msgid "NAME"
  27 msgstr "名前"
  28
  29 # type: textblock
  30 #. type: textblock
  31 #: ../src/guestfs.pod:5
  32 msgid "guestfs - Library for accessing and modifying virtual machine images"
  33 msgstr ""
  34
  35 # type: =head1
  36 #. type: =head1
  37 #: ../src/guestfs.pod:7 ../fish/guestfish.pod:7
  38 #: ../test-tool/libguestfs-test-tool.pod:7 ../fuse/guestmount.pod:7
  39 #: ../tools/virt-edit.pl:36 ../tools/virt-win-reg.pl:39
  40 #: ../tools/virt-list-filesystems.pl:34 ../tools/virt-tar.pl:35
  41 #: ../tools/virt-make-fs.pl:39 ../tools/virt-list-partitions.pl:34
  42 msgid "SYNOPSIS"
  43 msgstr ""
  44
  45 # type: verbatim
  46 #. type: verbatim
  47 #: ../src/guestfs.pod:9
  48 #, no-wrap
  49 msgid ""
  50 " #include <guestfs.h>\n"
  51 " \n"
  52 msgstr ""
  53
  54 # type: verbatim
  55 #. type: verbatim
  56 #: ../src/guestfs.pod:11
  57 #, no-wrap
  58 msgid ""
  59 " guestfs_h *g = guestfs_create ();\n"
  60 " guestfs_add_drive (g, \"guest.img\");\n"
  61 " guestfs_launch (g);\n"
  62 " guestfs_mount (g, \"/dev/sda1\", \"/\");\n"
  63 " guestfs_touch (g, \"/hello\");\n"
  64 " guestfs_umount (g, \"/\");\n"
  65 " guestfs_close (g);\n"
  66 "\n"
  67 msgstr ""
  68
  69 # type: verbatim
  70 #. type: verbatim
  71 #: ../src/guestfs.pod:19
  72 #, no-wrap
  73 msgid ""
  74 " cc prog.c -o prog -lguestfs\n"
  75 "or:\n"
  76 " cc prog.c -o prog `pkg-config libguestfs --cflags --libs`\n"
  77 "\n"
  78 msgstr ""
  79
  80 # type: =head1
  81 #. type: =head1
  82 #: ../src/guestfs.pod:23 ../fish/guestfish.pod:30
  83 #: ../test-tool/libguestfs-test-tool.pod:11 ../fuse/guestmount.pod:20
  84 #: ../tools/virt-edit.pl:50 ../tools/virt-win-reg.pl:63
  85 #: ../tools/virt-list-filesystems.pl:40 ../tools/virt-tar.pl:77
  86 #: ../tools/virt-make-fs.pl:47 ../tools/virt-list-partitions.pl:40
  87 msgid "DESCRIPTION"
  88 msgstr ""
  89
  90 # type: textblock
  91 #. type: textblock
  92 #: ../src/guestfs.pod:25
  93 msgid ""
  94 "Libguestfs is a library for accessing and modifying guest disk images.  "
  95 "Amongst the things this is good for: making batch configuration changes to "
  96 "guests, getting disk used/free statistics (see also: virt-df), migrating "
  97 "between virtualization systems (see also: virt-p2v), performing partial "
  98 "backups, performing partial guest clones, cloning guests and changing "
  99 "registry/UUID/hostname info, and much else besides."
 100 msgstr ""
 101
 102 # type: textblock
 103 #. type: textblock
 104 #: ../src/guestfs.pod:33
 105 msgid ""
 106 "Libguestfs uses Linux kernel and qemu code, and can access any type of guest "
 107 "filesystem that Linux and qemu can, including but not limited to: ext2/3/4, "
 108 "btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, "
 109 "qcow2, vmdk."
 110 msgstr ""
 111
 112 # type: textblock
 113 #. type: textblock
 114 #: ../src/guestfs.pod:38
 115 msgid ""
 116 "Libguestfs provides ways to enumerate guest storage (eg. partitions, LVs, "
 117 "what filesystem is in each LV, etc.).  It can also run commands in the "
 118 "context of the guest.  Also you can access filesystems over FUSE."
 119 msgstr ""
 120
 121 # type: textblock
 122 #. type: textblock
 123 #: ../src/guestfs.pod:43
 124 msgid ""
 125 "Libguestfs is a library that can be linked with C and C++ management "
 126 "programs (or management programs written in OCaml, Perl, Python, Ruby, Java, "
 127 "PHP, Haskell or C#).  You can also use it from shell scripts or the command "
 128 "line."
 129 msgstr ""
 130
 131 # type: textblock
 132 #. type: textblock
 133 #: ../src/guestfs.pod:48
 134 msgid ""
 135 "You don't need to be root to use libguestfs, although obviously you do need "
 136 "enough permissions to access the disk images."
 137 msgstr ""
 138
 139 # type: textblock
 140 #. type: textblock
 141 #: ../src/guestfs.pod:51
 142 msgid ""
 143 "Libguestfs is a large API because it can do many things.  For a gentle "
 144 "introduction, please read the L</API OVERVIEW> section next."
 145 msgstr ""
 146
 147 # type: textblock
 148 #. type: textblock
 149 #: ../src/guestfs.pod:54
 150 msgid ""
 151 "There are also some example programs in the L<guestfs-examples(3)> manual "
 152 "page."
 153 msgstr ""
 154
 155 # type: =head1
 156 #. type: =head1
 157 #: ../src/guestfs.pod:57
 158 msgid "API OVERVIEW"
 159 msgstr ""
 160
 161 # type: textblock
 162 #. type: textblock
 163 #: ../src/guestfs.pod:59
 164 msgid ""
 165 "This section provides a gentler overview of the libguestfs API.  We also try "
 166 "to group API calls together, where that may not be obvious from reading "
 167 "about the individual calls in the main section of this manual."
 168 msgstr ""
 169
 170 # type: =head2
 171 #. type: =head2
 172 #: ../src/guestfs.pod:64
 173 msgid "HANDLES"
 174 msgstr ""
 175
 176 # type: textblock
 177 #. type: textblock
 178 #: ../src/guestfs.pod:66
 179 msgid ""
 180 "Before you can use libguestfs calls, you have to create a handle.  Then you "
 181 "must add at least one disk image to the handle, followed by launching the "
 182 "handle, then performing whatever operations you want, and finally closing "
 183 "the handle.  By convention we use the single letter C<g> for the name of the "
 184 "handle variable, although of course you can use any name you want."
 185 msgstr ""
 186
 187 # type: textblock
 188 #. type: textblock
 189 #: ../src/guestfs.pod:73
 190 msgid "The general structure of all libguestfs-using programs looks like this:"
 191 msgstr ""
 192
 193 # type: verbatim
 194 #. type: verbatim
 195 #: ../src/guestfs.pod:76
 196 #, no-wrap
 197 msgid ""
 198 " guestfs_h *g = guestfs_create ();\n"
 199 " \n"
 200 msgstr ""
 201
 202 # type: verbatim
 203 #. type: verbatim
 204 #: ../src/guestfs.pod:78
 205 #, no-wrap
 206 msgid ""
 207 " /* Call guestfs_add_drive additional times if there are\n"
 208 "  * multiple disk images.\n"
 209 "  */\n"
 210 " guestfs_add_drive (g, \"guest.img\");\n"
 211 " \n"
 212 msgstr ""
 213
 214 # type: verbatim
 215 #. type: verbatim
 216 #: ../src/guestfs.pod:83
 217 #, no-wrap
 218 msgid ""
 219 " /* Most manipulation calls won't work until you've launched\n"
 220 "  * the handle 'g'.  You have to do this _after_ adding drives\n"
 221 "  * and _before_ other commands.\n"
 222 "  */\n"
 223 " guestfs_launch (g);\n"
 224 " \n"
 225 msgstr ""
 226
 227 # type: verbatim
 228 #. type: verbatim
 229 #: ../src/guestfs.pod:89
 230 #, no-wrap
 231 msgid ""
 232 " /* Now you can examine what partitions, LVs etc are available.\n"
 233 "  */\n"
 234 " char **partitions = guestfs_list_partitions (g);\n"
 235 " char **logvols = guestfs_lvs (g);\n"
 236 " \n"
 237 msgstr ""
 238
 239 # type: verbatim
 240 #. type: verbatim
 241 #: ../src/guestfs.pod:94
 242 #, no-wrap
 243 msgid ""
 244 " /* To access a filesystem in the image, you must mount it.\n"
 245 "  */\n"
 246 " guestfs_mount (g, \"/dev/sda1\", \"/\");\n"
 247 " \n"
 248 msgstr ""
 249
 250 #. type: verbatim
 251 #: ../src/guestfs.pod:98
 252 #, no-wrap
 253 msgid ""
 254 " /* Now you can perform filesystem actions on the guest\n"
 255 "  * disk image.\n"
 256 "  */\n"
 257 " guestfs_touch (g, \"/hello\");\n"
 258 " \n"
 259 msgstr ""
 260
 261 # type: verbatim
 262 #. type: verbatim
 263 #: ../src/guestfs.pod:103
 264 #, no-wrap
 265 msgid ""
 266 " /* This is only needed for libguestfs < 1.5.24.  Since then\n"
 267 "  * it is done automatically when you close the handle.  See\n"
 268 "  * discussion of autosync in this page.\n"
 269 "  */\n"
 270 " guestfs_sync (g);\n"
 271 " \n"
 272 msgstr ""
 273
 274 # type: verbatim
 275 #. type: verbatim
 276 #: ../src/guestfs.pod:109
 277 #, no-wrap
 278 msgid ""
 279 " /* Close the handle 'g'. */\n"
 280 " guestfs_close (g);\n"
 281 "\n"
 282 msgstr ""
 283
 284 # type: textblock
 285 #. type: textblock
 286 #: ../src/guestfs.pod:112
 287 msgid ""
 288 "The code above doesn't include any error checking.  In real code you should "
 289 "check return values carefully for errors.  In general all functions that "
 290 "return integers return C<-1> on error, and all functions that return "
 291 "pointers return C<NULL> on error.  See section L</ERROR HANDLING> below for "
 292 "how to handle errors, and consult the documentation for each function call "
 293 "below to see precisely how they return error indications.  See L<guestfs-"
 294 "examples(3)> for fully worked examples."
 295 msgstr ""
 296
 297 # type: =head2
 298 #. type: =head2
 299 #: ../src/guestfs.pod:121
 300 msgid "DISK IMAGES"
 301 msgstr ""
 302
 303 # type: textblock
 304 #. type: textblock
 305 #: ../src/guestfs.pod:123
 306 msgid ""
 307 "The image filename (C<\"guest.img\"> in the example above) could be a disk "
 308 "image from a virtual machine, a L<dd(1)> copy of a physical hard disk, an "
 309 "actual block device, or simply an empty file of zeroes that you have created "
 310 "through L<posix_fallocate(3)>.  Libguestfs lets you do useful things to all "
 311 "of these."
 312 msgstr ""
 313
 314 # type: textblock
 315 #. type: textblock
 316 #: ../src/guestfs.pod:129
 317 msgid ""
 318 "The call you should use in modern code for adding drives is L</"
 319 "guestfs_add_drive_opts>.  To add a disk image, allowing writes, and "
 320 "specifying that the format is raw, do:"
 321 msgstr ""
 322
 323 # type: verbatim
 324 #. type: verbatim
 325 #: ../src/guestfs.pod:133
 326 #, no-wrap
 327 msgid ""
 328 " guestfs_add_drive_opts (g, filename,\n"
 329 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"raw\",\n"
 330 "                         -1);\n"
 331 "\n"
 332 msgstr ""
 333
 334 # type: textblock
 335 #. type: textblock
 336 #: ../src/guestfs.pod:137
 337 msgid "You can add a disk read-only using:"
 338 msgstr ""
 339
 340 # type: verbatim
 341 #. type: verbatim
 342 #: ../src/guestfs.pod:139
 343 #, no-wrap
 344 msgid ""
 345 " guestfs_add_drive_opts (g, filename,\n"
 346 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"raw\",\n"
 347 "                         GUESTFS_ADD_DRIVE_OPTS_READONLY, 1,\n"
 348 "                         -1);\n"
 349 "\n"
 350 msgstr ""
 351
 352 # type: textblock
 353 #. type: textblock
 354 #: ../src/guestfs.pod:144
 355 msgid ""
 356 "or by calling the older function L</guestfs_add_drive_ro>.  In either case "
 357 "libguestfs won't modify the file."
 358 msgstr ""
 359
 360 # type: textblock
 361 #. type: textblock
 362 #: ../src/guestfs.pod:147
 363 msgid ""
 364 "Be extremely cautious if the disk image is in use, eg. if it is being used "
 365 "by a virtual machine.  Adding it read-write will almost certainly cause disk "
 366 "corruption, but adding it read-only is safe."
 367 msgstr ""
 368
 369 # type: textblock
 370 #. type: textblock
 371 #: ../src/guestfs.pod:151
 372 msgid ""
 373 "You must add at least one disk image, and you may add multiple disk images.  "
 374 "In the API, the disk images are usually referred to as C</dev/sda> (for the "
 375 "first one you added), C</dev/sdb> (for the second one you added), etc."
 376 msgstr ""
 377
 378 # type: textblock
 379 #. type: textblock
 380 #: ../src/guestfs.pod:156
 381 msgid ""
 382 "Once L</guestfs_launch> has been called you cannot add any more images.  You "
 383 "can call L</guestfs_list_devices> to get a list of the device names, in the "
 384 "order that you added them.  See also L</BLOCK DEVICE NAMING> below."
 385 msgstr ""
 386
 387 # type: =head2
 388 #. type: =head2
 389 #: ../src/guestfs.pod:161
 390 msgid "MOUNTING"
 391 msgstr ""
 392
 393 #. type: textblock
 394 #: ../src/guestfs.pod:163
 395 msgid ""
 396 "Before you can read or write files, create directories and so on in a disk "
 397 "image that contains filesystems, you have to mount those filesystems using "
 398 "L</guestfs_mount_options> or L</guestfs_mount_ro>.  If you already know that "
 399 "a disk image contains (for example) one partition with a filesystem on that "
 400 "partition, then you can mount it directly:"
 401 msgstr ""
 402
 403 #. type: verbatim
 404 #: ../src/guestfs.pod:170
 405 #, no-wrap
 406 msgid ""
 407 " guestfs_mount_options (g, \"\", \"/dev/sda1\", \"/\");\n"
 408 "\n"
 409 msgstr ""
 410
 411 #. type: textblock
 412 #: ../src/guestfs.pod:172
 413 msgid ""
 414 "where C</dev/sda1> means literally the first partition (C<1>) of the first "
 415 "disk image that we added (C</dev/sda>).  If the disk contains Linux LVM2 "
 416 "logical volumes you could refer to those instead (eg. C</dev/VG/LV>).  Note "
 417 "that these are libguestfs virtual devices, and are nothing to do with host "
 418 "devices."
 419 msgstr ""
 420
 421 #. type: textblock
 422 #: ../src/guestfs.pod:178
 423 msgid ""
 424 "If you are given a disk image and you don't know what it contains then you "
 425 "have to find out.  Libguestfs can do that too: use L</"
 426 "guestfs_list_partitions> and L</guestfs_lvs> to list possible partitions and "
 427 "LVs, and either try mounting each to see what is mountable, or else examine "
 428 "them with L</guestfs_vfs_type> or L</guestfs_file>.  To list just "
 429 "filesystems, use L</guestfs_list_filesystems>."
 430 msgstr ""
 431
 432 #. type: textblock
 433 #: ../src/guestfs.pod:186
 434 msgid ""
 435 "Libguestfs also has a set of APIs for inspection of unknown disk images (see "
 436 "L</INSPECTION> below).  But you might find it easier to look at higher level "
 437 "programs built on top of libguestfs, in particular L<virt-inspector(1)>."
 438 msgstr ""
 439
 440 #. type: textblock
 441 #: ../src/guestfs.pod:191
 442 msgid ""
 443 "To mount a filesystem read-only, use L</guestfs_mount_ro>.  There are "
 444 "several other variations of the C<guestfs_mount_*> call."
 445 msgstr ""
 446
 447 # type: =head2
 448 #. type: =head2
 449 #: ../src/guestfs.pod:194
 450 msgid "FILESYSTEM ACCESS AND MODIFICATION"
 451 msgstr ""
 452
 453 # type: textblock
 454 #. type: textblock
 455 #: ../src/guestfs.pod:196
 456 msgid ""
 457 "The majority of the libguestfs API consists of fairly low-level calls for "
 458 "accessing and modifying the files, directories, symlinks etc on mounted "
 459 "filesystems.  There are over a hundred such calls which you can find listed "
 460 "in detail below in this man page, and we don't even pretend to cover them "
 461 "all in this overview."
 462 msgstr ""
 463
 464 # type: textblock
 465 #. type: textblock
 466 #: ../src/guestfs.pod:202
 467 msgid ""
 468 "Specify filenames as full paths, starting with C<\"/\"> and including the "
 469 "mount point."
 470 msgstr ""
 471
 472 # type: textblock
 473 #. type: textblock
 474 #: ../src/guestfs.pod:205
 475 msgid ""
 476 "For example, if you mounted a filesystem at C<\"/\"> and you want to read "
 477 "the file called C<\"etc/passwd\"> then you could do:"
 478 msgstr ""
 479
 480 # type: verbatim
 481 #. type: verbatim
 482 #: ../src/guestfs.pod:208
 483 #, no-wrap
 484 msgid ""
 485 " char *data = guestfs_cat (g, \"/etc/passwd\");\n"
 486 "\n"
 487 msgstr ""
 488
 489 # type: textblock
 490 #. type: textblock
 491 #: ../src/guestfs.pod:210
 492 msgid ""
 493 "This would return C<data> as a newly allocated buffer containing the full "
 494 "content of that file (with some conditions: see also L</DOWNLOADING> below), "
 495 "or C<NULL> if there was an error."
 496 msgstr ""
 497
 498 # type: textblock
 499 #. type: textblock
 500 #: ../src/guestfs.pod:214
 501 msgid ""
 502 "As another example, to create a top-level directory on that filesystem "
 503 "called C<\"var\"> you would do:"
 504 msgstr ""
 505
 506 # type: verbatim
 507 #. type: verbatim
 508 #: ../src/guestfs.pod:217
 509 #, no-wrap
 510 msgid ""
 511 " guestfs_mkdir (g, \"/var\");\n"
 512 "\n"
 513 msgstr ""
 514
 515 # type: textblock
 516 #. type: textblock
 517 #: ../src/guestfs.pod:219
 518 msgid "To create a symlink you could do:"
 519 msgstr ""
 520
 521 # type: verbatim
 522 #. type: verbatim
 523 #: ../src/guestfs.pod:221
 524 #, no-wrap
 525 msgid ""
 526 " guestfs_ln_s (g, \"/etc/init.d/portmap\",\n"
 527 "               \"/etc/rc3.d/S30portmap\");\n"
 528 "\n"
 529 msgstr ""
 530
 531 # type: textblock
 532 #. type: textblock
 533 #: ../src/guestfs.pod:224
 534 msgid ""
 535 "Libguestfs will reject attempts to use relative paths and there is no "
 536 "concept of a current working directory."
 537 msgstr ""
 538
 539 # type: textblock
 540 #. type: textblock
 541 #: ../src/guestfs.pod:227
 542 msgid ""
 543 "Libguestfs can return errors in many situations: for example if the "
 544 "filesystem isn't writable, or if a file or directory that you requested "
 545 "doesn't exist.  If you are using the C API (documented here)  you have to "
 546 "check for those error conditions after each call.  (Other language bindings "
 547 "turn these errors into exceptions)."
 548 msgstr ""
 549
 550 # type: textblock
 551 #. type: textblock
 552 #: ../src/guestfs.pod:233
 553 msgid ""
 554 "File writes are affected by the per-handle umask, set by calling L</"
 555 "guestfs_umask> and defaulting to 022.  See L</UMASK>."
 556 msgstr ""
 557
 558 # type: =head2
 559 #. type: =head2
 560 #: ../src/guestfs.pod:236
 561 msgid "PARTITIONING"
 562 msgstr ""
 563
 564 # type: textblock
 565 #. type: textblock
 566 #: ../src/guestfs.pod:238
 567 msgid ""
 568 "Libguestfs contains API calls to read, create and modify partition tables on "
 569 "disk images."
 570 msgstr ""
 571
 572 # type: textblock
 573 #. type: textblock
 574 #: ../src/guestfs.pod:241
 575 msgid ""
 576 "In the common case where you want to create a single partition covering the "
 577 "whole disk, you should use the L</guestfs_part_disk> call:"
 578 msgstr ""
 579
 580 # type: verbatim
 581 #. type: verbatim
 582 #: ../src/guestfs.pod:245
 583 #, no-wrap
 584 msgid ""
 585 " const char *parttype = \"mbr\";\n"
 586 " if (disk_is_larger_than_2TB)\n"
 587 "   parttype = \"gpt\";\n"
 588 " guestfs_part_disk (g, \"/dev/sda\", parttype);\n"
 589 "\n"
 590 msgstr ""
 591
 592 # type: textblock
 593 #. type: textblock
 594 #: ../src/guestfs.pod:250
 595 msgid ""
 596 "Obviously this effectively wipes anything that was on that disk image before."
 597 msgstr ""
 598
 599 # type: =head2
 600 #. type: =head2
 601 #: ../src/guestfs.pod:253
 602 msgid "LVM2"
 603 msgstr ""
 604
 605 # type: textblock
 606 #. type: textblock
 607 #: ../src/guestfs.pod:255
 608 msgid ""
 609 "Libguestfs provides access to a large part of the LVM2 API, such as L</"
 610 "guestfs_lvcreate> and L</guestfs_vgremove>.  It won't make much sense unless "
 611 "you familiarize yourself with the concepts of physical volumes, volume "
 612 "groups and logical volumes."
 613 msgstr ""
 614
 615 # type: textblock
 616 #. type: textblock
 617 #: ../src/guestfs.pod:260
 618 msgid ""
 619 "This author strongly recommends reading the LVM HOWTO, online at L<http://"
 620 "tldp.org/HOWTO/LVM-HOWTO/>."
 621 msgstr ""
 622
 623 # type: =head2
 624 #. type: =head2
 625 #: ../src/guestfs.pod:263
 626 msgid "DOWNLOADING"
 627 msgstr ""
 628
 629 #. type: textblock
 630 #: ../src/guestfs.pod:265
 631 msgid ""
 632 "Use L</guestfs_cat> to download small, text only files.  This call is "
 633 "limited to files which are less than 2 MB and which cannot contain any ASCII "
 634 "NUL (C<\\0>) characters.  However the API is very simple to use."
 635 msgstr ""
 636
 637 # type: textblock
 638 #. type: textblock
 639 #: ../src/guestfs.pod:269
 640 msgid ""
 641 "L</guestfs_read_file> can be used to read files which contain arbitrary 8 "
 642 "bit data, since it returns a (pointer, size) pair.  However it is still "
 643 "limited to \"small\" files, less than 2 MB."
 644 msgstr ""
 645
 646 # type: textblock
 647 #. type: textblock
 648 #: ../src/guestfs.pod:273
 649 msgid ""
 650 "L</guestfs_download> can be used to download any file, with no limits on "
 651 "content or size (even files larger than 4 GB)."
 652 msgstr ""
 653
 654 # type: textblock
 655 #. type: textblock
 656 #: ../src/guestfs.pod:276
 657 msgid ""
 658 "To download multiple files, see L</guestfs_tar_out> and L</guestfs_tgz_out>."
 659 msgstr ""
 660
 661 # type: =head2
 662 #. type: =head2
 663 #: ../src/guestfs.pod:279
 664 msgid "UPLOADING"
 665 msgstr ""
 666
 667 # type: textblock
 668 #. type: textblock
 669 #: ../src/guestfs.pod:281
 670 msgid ""
 671 "It's often the case that you want to write a file or files to the disk image."
 672 msgstr ""
 673
 674 # type: textblock
 675 #. type: textblock
 676 #: ../src/guestfs.pod:284
 677 msgid ""
 678 "To write a small file with fixed content, use L</guestfs_write>.  To create "
 679 "a file of all zeroes, use L</guestfs_truncate_size> (sparse) or L</"
 680 "guestfs_fallocate64> (with all disk blocks allocated).  There are a variety "
 681 "of other functions for creating test files, for example L</guestfs_fill> and "
 682 "L</guestfs_fill_pattern>."
 683 msgstr ""
 684
 685 # type: textblock
 686 #. type: textblock
 687 #: ../src/guestfs.pod:290
 688 msgid ""
 689 "To upload a single file, use L</guestfs_upload>.  This call has no limits on "
 690 "file content or size (even files larger than 4 GB)."
 691 msgstr ""
 692
 693 # type: textblock
 694 #. type: textblock
 695 #: ../src/guestfs.pod:293
 696 msgid ""
 697 "To upload multiple files, see L</guestfs_tar_in> and L</guestfs_tgz_in>."
 698 msgstr ""
 699
 700 # type: textblock
 701 #. type: textblock
 702 #: ../src/guestfs.pod:295
 703 msgid ""
 704 "However the fastest way to upload I<large numbers of arbitrary files> is to "
 705 "turn them into a squashfs or CD ISO (see L<mksquashfs(8)> and L<mkisofs(8)"
 706 ">), then attach this using L</guestfs_add_drive_ro>.  If you add the drive "
 707 "in a predictable way (eg. adding it last after all other drives) then you "
 708 "can get the device name from L</guestfs_list_devices> and mount it directly "
 709 "using L</guestfs_mount_ro>.  Note that squashfs images are sometimes non-"
 710 "portable between kernel versions, and they don't support labels or UUIDs.  "
 711 "If you want to pre-build an image or you need to mount it using a label or "
 712 "UUID, use an ISO image instead."
 713 msgstr ""
 714
 715 # type: =head2
 716 #. type: =head2
 717 #: ../src/guestfs.pod:306
 718 msgid "COPYING"
 719 msgstr ""
 720
 721 # type: textblock
 722 #. type: textblock
 723 #: ../src/guestfs.pod:308
 724 msgid ""
 725 "There are various different commands for copying between files and devices "
 726 "and in and out of the guest filesystem.  These are summarised in the table "
 727 "below."
 728 msgstr ""
 729
 730 # type: =item
 731 #. type: =item
 732 #: ../src/guestfs.pod:314
 733 msgid "B<file> to B<file>"
 734 msgstr ""
 735
 736 # type: textblock
 737 #. type: textblock
 738 #: ../src/guestfs.pod:316
 739 msgid ""
 740 "Use L</guestfs_cp> to copy a single file, or L</guestfs_cp_a> to copy "
 741 "directories recursively."
 742 msgstr ""
 743
 744 # type: =item
 745 #. type: =item
 746 #: ../src/guestfs.pod:319
 747 msgid "B<file or device> to B<file or device>"
 748 msgstr ""
 749
 750 # type: textblock
 751 #. type: textblock
 752 #: ../src/guestfs.pod:321
 753 msgid ""
 754 "Use L</guestfs_dd> which efficiently uses L<dd(1)> to copy between files and "
 755 "devices in the guest."
 756 msgstr ""
 757
 758 # type: textblock
 759 #. type: textblock
 760 #: ../src/guestfs.pod:324
 761 msgid "Example: duplicate the contents of an LV:"
 762 msgstr ""
 763
 764 # type: verbatim
 765 #. type: verbatim
 766 #: ../src/guestfs.pod:326
 767 #, no-wrap
 768 msgid ""
 769 " guestfs_dd (g, \"/dev/VG/Original\", \"/dev/VG/Copy\");\n"
 770 "\n"
 771 msgstr ""
 772
 773 # type: textblock
 774 #. type: textblock
 775 #: ../src/guestfs.pod:328
 776 msgid ""
 777 "The destination (C</dev/VG/Copy>) must be at least as large as the source "
 778 "(C</dev/VG/Original>).  To copy less than the whole source device, use L</"
 779 "guestfs_copy_size>."
 780 msgstr ""
 781
 782 # type: =item
 783 #. type: =item
 784 #: ../src/guestfs.pod:332
 785 msgid "B<file on the host> to B<file or device>"
 786 msgstr ""
 787
 788 # type: textblock
 789 #. type: textblock
 790 #: ../src/guestfs.pod:334
 791 msgid "Use L</guestfs_upload>.  See L</UPLOADING> above."
 792 msgstr ""
 793
 794 # type: =item
 795 #. type: =item
 796 #: ../src/guestfs.pod:336
 797 msgid "B<file or device> to B<file on the host>"
 798 msgstr ""
 799
 800 # type: textblock
 801 #. type: textblock
 802 #: ../src/guestfs.pod:338
 803 msgid "Use L</guestfs_download>.  See L</DOWNLOADING> above."
 804 msgstr ""
 805
 806 # type: =head2
 807 #. type: =head2
 808 #: ../src/guestfs.pod:342
 809 msgid "UPLOADING AND DOWNLOADING TO PIPES AND FILE DESCRIPTORS"
 810 msgstr ""
 811
 812 # type: textblock
 813 #. type: textblock
 814 #: ../src/guestfs.pod:344
 815 msgid ""
 816 "Calls like L</guestfs_upload>, L</guestfs_download>, L</guestfs_tar_in>, L</"
 817 "guestfs_tar_out> etc appear to only take filenames as arguments, so it "
 818 "appears you can only upload and download to files.  However many Un*x-like "
 819 "hosts let you use the special device files C</dev/stdin>, C</dev/stdout>, C</"
 820 "dev/stderr> and C</dev/fd/N> to read and write from stdin, stdout, stderr, "
 821 "and arbitrary file descriptor N."
 822 msgstr ""
 823
 824 # type: textblock
 825 #. type: textblock
 826 #: ../src/guestfs.pod:352
 827 msgid "For example, L<virt-cat(1)> writes its output to stdout by doing:"
 828 msgstr ""
 829
 830 #. type: verbatim
 831 #: ../src/guestfs.pod:355
 832 #, no-wrap
 833 msgid ""
 834 " guestfs_download (g, filename, \"/dev/stdout\");\n"
 835 "\n"
 836 msgstr ""
 837
 838 #. type: textblock
 839 #: ../src/guestfs.pod:357
 840 msgid "and you can write tar output to a file descriptor C<fd> by doing:"
 841 msgstr ""
 842
 843 #. type: verbatim
 844 #: ../src/guestfs.pod:359
 845 #, no-wrap
 846 msgid ""
 847 " char devfd[64];\n"
 848 " snprintf (devfd, sizeof devfd, \"/dev/fd/%d\", fd);\n"
 849 " guestfs_tar_out (g, \"/\", devfd);\n"
 850 "\n"
 851 msgstr ""
 852
 853 # type: =head2
 854 #. type: =head2
 855 #: ../src/guestfs.pod:363
 856 msgid "LISTING FILES"
 857 msgstr ""
 858
 859 # type: textblock
 860 #. type: textblock
 861 #: ../src/guestfs.pod:365
 862 msgid ""
 863 "L</guestfs_ll> is just designed for humans to read (mainly when using the "
 864 "L<guestfish(1)>-equivalent command C<ll>)."
 865 msgstr ""
 866
 867 # type: textblock
 868 #. type: textblock
 869 #: ../src/guestfs.pod:368
 870 msgid ""
 871 "L</guestfs_ls> is a quick way to get a list of files in a directory from "
 872 "programs, as a flat list of strings."
 873 msgstr ""
 874
 875 # type: textblock
 876 #. type: textblock
 877 #: ../src/guestfs.pod:371
 878 msgid ""
 879 "L</guestfs_readdir> is a programmatic way to get a list of files in a "
 880 "directory, plus additional information about each one.  It is more "
 881 "equivalent to using the L<readdir(3)> call on a local filesystem."
 882 msgstr ""
 883
 884 # type: textblock
 885 #. type: textblock
 886 #: ../src/guestfs.pod:375
 887 msgid ""
 888 "L</guestfs_find> and L</guestfs_find0> can be used to recursively list files."
 889 msgstr ""
 890
 891 # type: =head2
 892 #. type: =head2
 893 #: ../src/guestfs.pod:378
 894 msgid "RUNNING COMMANDS"
 895 msgstr ""
 896
 897 # type: textblock
 898 #. type: textblock
 899 #: ../src/guestfs.pod:380
 900 msgid ""
 901 "Although libguestfs is primarily an API for manipulating files inside guest "
 902 "images, we also provide some limited facilities for running commands inside "
 903 "guests."
 904 msgstr ""
 905
 906 # type: textblock
 907 #. type: textblock
 908 #: ../src/guestfs.pod:384
 909 msgid "There are many limitations to this:"
 910 msgstr ""
 911
 912 # type: =item
 913 #. type: =item
 914 #: ../src/guestfs.pod:388 ../src/guestfs.pod:393 ../src/guestfs.pod:398
 915 #: ../src/guestfs.pod:402 ../src/guestfs.pod:407 ../src/guestfs.pod:411
 916 #: ../src/guestfs.pod:416 ../src/guestfs.pod:421 ../src/guestfs.pod:1064
 917 #: ../src/guestfs.pod:1068 ../src/guestfs.pod:1072 ../src/guestfs.pod:1077
 918 #: ../src/guestfs.pod:1085 ../src/guestfs.pod:1104 ../src/guestfs.pod:1112
 919 #: ../src/guestfs.pod:1134 ../src/guestfs.pod:1138 ../src/guestfs.pod:1142
 920 #: ../src/guestfs.pod:1146 ../src/guestfs.pod:1150 ../src/guestfs.pod:1154
 921 #: ../src/guestfs.pod:1643 ../src/guestfs.pod:1648 ../src/guestfs.pod:1652
 922 #: ../src/guestfs.pod:1753 ../src/guestfs.pod:1758 ../src/guestfs.pod:1762
 923 #: ../src/guestfs.pod:1772 ../src/guestfs.pod:2007 ../src/guestfs.pod:2012
 924 #: ../src/guestfs.pod:2018 ../src/guestfs.pod:2026 ../src/guestfs.pod:2380
 925 #: ../src/guestfs.pod:2386 ../src/guestfs.pod:2391 ../src/guestfs.pod:2397
 926 #: ../src/guestfs.pod:2968 ../src/guestfs.pod:2972 ../src/guestfs.pod:2976
 927 #: ../src/guestfs.pod:2980 ../src/guestfs-actions.pod:15
 928 #: ../src/guestfs-actions.pod:22 ../src/guestfs-actions.pod:582
 929 #: ../src/guestfs-actions.pod:590 ../src/guestfs-actions.pod:597
 930 #: ../src/guestfs-actions.pod:604 ../src/guestfs-actions.pod:1602
 931 #: ../src/guestfs-actions.pod:1606 ../src/guestfs-actions.pod:1610
 932 #: ../src/guestfs-actions.pod:1614 ../src/guestfs-actions.pod:1622
 933 #: ../src/guestfs-actions.pod:1626 ../src/guestfs-actions.pod:1630
 934 #: ../src/guestfs-actions.pod:1640 ../src/guestfs-actions.pod:1644
 935 #: ../src/guestfs-actions.pod:1648 ../src/guestfs-actions.pod:1786
 936 #: ../src/guestfs-actions.pod:1790 ../src/guestfs-actions.pod:1795
 937 #: ../src/guestfs-actions.pod:1800 ../src/guestfs-actions.pod:1861
 938 #: ../src/guestfs-actions.pod:1865 ../src/guestfs-actions.pod:1870
 939 #: ../src/guestfs-actions.pod:2261 ../src/guestfs-actions.pod:2268
 940 #: ../src/guestfs-actions.pod:2275 ../fish/guestfish.pod:443
 941 #: ../fish/guestfish.pod:447 ../fish/guestfish.pod:451
 942 #: ../fish/guestfish.pod:455 ../fish/guestfish-actions.pod:13
 943 #: ../fish/guestfish-actions.pod:20 ../fish/guestfish-actions.pod:385
 944 #: ../fish/guestfish-actions.pod:393 ../fish/guestfish-actions.pod:400
 945 #: ../fish/guestfish-actions.pod:407 ../fish/guestfish-actions.pod:1074
 946 #: ../fish/guestfish-actions.pod:1078 ../fish/guestfish-actions.pod:1082
 947 #: ../fish/guestfish-actions.pod:1086 ../fish/guestfish-actions.pod:1094
 948 #: ../fish/guestfish-actions.pod:1098 ../fish/guestfish-actions.pod:1102
 949 #: ../fish/guestfish-actions.pod:1112 ../fish/guestfish-actions.pod:1116
 950 #: ../fish/guestfish-actions.pod:1120 ../fish/guestfish-actions.pod:1210
 951 #: ../fish/guestfish-actions.pod:1214 ../fish/guestfish-actions.pod:1219
 952 #: ../fish/guestfish-actions.pod:1224 ../fish/guestfish-actions.pod:1266
 953 #: ../fish/guestfish-actions.pod:1270 ../fish/guestfish-actions.pod:1275
 954 #: ../fish/guestfish-actions.pod:1519 ../fish/guestfish-actions.pod:1526
 955 #: ../fish/guestfish-actions.pod:1533 ../tools/virt-edit.pl:351
 956 #: ../tools/virt-edit.pl:356 ../tools/virt-edit.pl:361
 957 #: ../tools/virt-edit.pl:372 ../tools/virt-edit.pl:376
 958 #: ../tools/virt-win-reg.pl:536 ../tools/virt-win-reg.pl:542
 959 #: ../tools/virt-win-reg.pl:548
 960 msgid "*"
 961 msgstr ""
 962
 963 # type: textblock
 964 #. type: textblock
 965 #: ../src/guestfs.pod:390
 966 msgid ""
 967 "The kernel version that the command runs under will be different from what "
 968 "it expects."
 969 msgstr ""
 970
 971 # type: textblock
 972 #. type: textblock
 973 #: ../src/guestfs.pod:395
 974 msgid ""
 975 "If the command needs to communicate with daemons, then most likely they "
 976 "won't be running."
 977 msgstr ""
 978
 979 # type: textblock
 980 #. type: textblock
 981 #: ../src/guestfs.pod:400
 982 msgid "The command will be running in limited memory."
 983 msgstr ""
 984
 985 # type: textblock
 986 #. type: textblock
 987 #: ../src/guestfs.pod:404
 988 msgid ""
 989 "The network may not be available unless you enable it (see L</"
 990 "guestfs_set_network>)."
 991 msgstr ""
 992
 993 # type: textblock
 994 #. type: textblock
 995 #: ../src/guestfs.pod:409
 996 msgid "Only supports Linux guests (not Windows, BSD, etc)."
 997 msgstr ""
 998
 999 # type: textblock
1000 #. type: textblock
1001 #: ../src/guestfs.pod:413
1002 msgid ""
1003 "Architecture limitations (eg. won't work for a PPC guest on an X86 host)."
1004 msgstr ""
1005
1006 # type: textblock
1007 #. type: textblock
1008 #: ../src/guestfs.pod:418
1009 msgid ""
1010 "For SELinux guests, you may need to enable SELinux and load policy first.  "
1011 "See L</SELINUX> in this manpage."
1012 msgstr ""
1013
1014 # type: textblock
1015 #. type: textblock
1016 #: ../src/guestfs.pod:423
1017 msgid ""
1018 "I<Security:> It is not safe to run commands from untrusted, possibly "
1019 "malicious guests.  These commands may attempt to exploit your program by "
1020 "sending unexpected output.  They could also try to exploit the Linux kernel "
1021 "or qemu provided by the libguestfs appliance.  They could use the network "
1022 "provided by the libguestfs appliance to bypass ordinary network partitions "
1023 "and firewalls.  They could use the elevated privileges or different SELinux "
1024 "context of your program to their advantage."
1025 msgstr ""
1026
1027 # type: textblock
1028 #. type: textblock
1029 #: ../src/guestfs.pod:432
1030 msgid ""
1031 "A secure alternative is to use libguestfs to install a \"firstboot\" script "
1032 "(a script which runs when the guest next boots normally), and to have this "
1033 "script run the commands you want in the normal context of the running guest, "
1034 "network security and so on.  For information about other security issues, "
1035 "see L</SECURITY>."
1036 msgstr ""
1037
1038 # type: textblock
1039 #. type: textblock
1040 #: ../src/guestfs.pod:440
1041 msgid ""
1042 "The two main API calls to run commands are L</guestfs_command> and L</"
1043 "guestfs_sh> (there are also variations)."
1044 msgstr ""
1045
1046 # type: textblock
1047 #. type: textblock
1048 #: ../src/guestfs.pod:443
1049 msgid ""
1050 "The difference is that L</guestfs_sh> runs commands using the shell, so any "
1051 "shell globs, redirections, etc will work."
1052 msgstr ""
1053
1054 # type: =head2
1055 #. type: =head2
1056 #: ../src/guestfs.pod:446
1057 msgid "CONFIGURATION FILES"
1058 msgstr ""
1059
1060 # type: textblock
1061 #. type: textblock
1062 #: ../src/guestfs.pod:448
1063 msgid ""
1064 "To read and write configuration files in Linux guest filesystems, we "
1065 "strongly recommend using Augeas.  For example, Augeas understands how to "
1066 "read and write, say, a Linux shadow password file or X.org configuration "
1067 "file, and so avoids you having to write that code."
1068 msgstr ""
1069
1070 # type: textblock
1071 #. type: textblock
1072 #: ../src/guestfs.pod:453
1073 msgid ""
1074 "The main Augeas calls are bound through the C<guestfs_aug_*> APIs.  We don't "
1075 "document Augeas itself here because there is excellent documentation on the "
1076 "L<http://augeas.net/> website."
1077 msgstr ""
1078
1079 # type: textblock
1080 #. type: textblock
1081 #: ../src/guestfs.pod:457
1082 msgid ""
1083 "If you don't want to use Augeas (you fool!) then try calling L</"
1084 "guestfs_read_lines> to get the file as a list of lines which you can iterate "
1085 "over."
1086 msgstr ""
1087
1088 # type: =head2
1089 #. type: =head2
1090 #: ../src/guestfs.pod:461
1091 msgid "SELINUX"
1092 msgstr ""
1093
1094 # type: textblock
1095 #. type: textblock
1096 #: ../src/guestfs.pod:463
1097 msgid ""
1098 "We support SELinux guests.  To ensure that labeling happens correctly in "
1099 "SELinux guests, you need to enable SELinux and load the guest's policy:"
1100 msgstr ""
1101
1102 # type: =item
1103 #. type: =item
1104 #: ../src/guestfs.pod:469 ../src/guestfs.pod:1257 ../src/guestfs.pod:1395
1105 #: ../src/guestfs.pod:2425
1106 msgid "1."
1107 msgstr ""
1108
1109 # type: textblock
1110 #. type: textblock
1111 #: ../src/guestfs.pod:471
1112 msgid "Before launching, do:"
1113 msgstr ""
1114
1115 # type: verbatim
1116 #. type: verbatim
1117 #: ../src/guestfs.pod:473
1118 #, no-wrap
1119 msgid ""
1120 " guestfs_set_selinux (g, 1);\n"
1121 "\n"
1122 msgstr ""
1123
1124 # type: =item
1125 #. type: =item
1126 #: ../src/guestfs.pod:475 ../src/guestfs.pod:1261 ../src/guestfs.pod:1399
1127 #: ../src/guestfs.pod:2450
1128 msgid "2."
1129 msgstr ""
1130
1131 # type: textblock
1132 #. type: textblock
1133 #: ../src/guestfs.pod:477
1134 msgid ""
1135 "After mounting the guest's filesystem(s), load the policy.  This is best "
1136 "done by running the L<load_policy(8)> command in the guest itself:"
1137 msgstr ""
1138
1139 # type: verbatim
1140 #. type: verbatim
1141 #: ../src/guestfs.pod:481
1142 #, no-wrap
1143 msgid ""
1144 " guestfs_sh (g, \"/usr/sbin/load_policy\");\n"
1145 "\n"
1146 msgstr ""
1147
1148 # type: textblock
1149 #. type: textblock
1150 #: ../src/guestfs.pod:483
1151 msgid ""
1152 "(Older versions of C<load_policy> require you to specify the name of the "
1153 "policy file)."
1154 msgstr ""
1155
1156 # type: =item
1157 #. type: =item
1158 #: ../src/guestfs.pod:486 ../src/guestfs.pod:1405
1159 msgid "3."
1160 msgstr ""
1161
1162 # type: textblock
1163 #. type: textblock
1164 #: ../src/guestfs.pod:488
1165 msgid ""
1166 "Optionally, set the security context for the API.  The correct security "
1167 "context to use can only be known by inspecting the guest.  As an example:"
1168 msgstr ""
1169
1170 # type: verbatim
1171 #. type: verbatim
1172 #: ../src/guestfs.pod:492
1173 #, no-wrap
1174 msgid ""
1175 " guestfs_setcon (g, \"unconfined_u:unconfined_r:unconfined_t:s0\");\n"
1176 "\n"
1177 msgstr ""
1178
1179 # type: textblock
1180 #. type: textblock
1181 #: ../src/guestfs.pod:496
1182 msgid "This will work for running commands and editing existing files."
1183 msgstr ""
1184
1185 # type: textblock
1186 #. type: textblock
1187 #: ../src/guestfs.pod:498
1188 msgid ""
1189 "When new files are created, you may need to label them explicitly, for "
1190 "example by running the external command C<restorecon pathname>."
1191 msgstr ""
1192
1193 # type: =head2
1194 #. type: =head2
1195 #: ../src/guestfs.pod:502
1196 msgid "UMASK"
1197 msgstr ""
1198
1199 # type: textblock
1200 #. type: textblock
1201 #: ../src/guestfs.pod:504
1202 msgid ""
1203 "Certain calls are affected by the current file mode creation mask (the "
1204 "\"umask\").  In particular ones which create files or directories, such as "
1205 "L</guestfs_touch>, L</guestfs_mknod> or L</guestfs_mkdir>.  This affects "
1206 "either the default mode that the file is created with or modifies the mode "
1207 "that you supply."
1208 msgstr ""
1209
1210 # type: textblock
1211 #. type: textblock
1212 #: ../src/guestfs.pod:510
1213 msgid ""
1214 "The default umask is C<022>, so files are created with modes such as C<0644> "
1215 "and directories with C<0755>."
1216 msgstr ""
1217
1218 # type: textblock
1219 #. type: textblock
1220 #: ../src/guestfs.pod:513
1221 msgid ""
1222 "There are two ways to avoid being affected by umask.  Either set umask to 0 "
1223 "(call C<guestfs_umask (g, 0)> early after launching).  Or call L</"
1224 "guestfs_chmod> after creating each file or directory."
1225 msgstr ""
1226
1227 # type: textblock
1228 #. type: textblock
1229 #: ../src/guestfs.pod:517
1230 msgid "For more information about umask, see L<umask(2)>."
1231 msgstr ""
1232
1233 # type: =head1
1234 #. type: =head1
1235 #: ../src/guestfs.pod:519 ../fish/guestfish.pod:765
1236 msgid "ENCRYPTED DISKS"
1237 msgstr ""
1238
1239 # type: textblock
1240 #. type: textblock
1241 #: ../src/guestfs.pod:521
1242 msgid ""
1243 "Libguestfs allows you to access Linux guests which have been encrypted using "
1244 "whole disk encryption that conforms to the Linux Unified Key Setup (LUKS) "
1245 "standard.  This includes nearly all whole disk encryption systems used by "
1246 "modern Linux guests."
1247 msgstr ""
1248
1249 # type: textblock
1250 #. type: textblock
1251 #: ../src/guestfs.pod:527
1252 msgid ""
1253 "Use L</guestfs_vfs_type> to identify LUKS-encrypted block devices (it "
1254 "returns the string C<crypto_LUKS>)."
1255 msgstr ""
1256
1257 # type: textblock
1258 #. type: textblock
1259 #: ../src/guestfs.pod:530
1260 msgid ""
1261 "Then open these devices by calling L</guestfs_luks_open>.  Obviously you "
1262 "will require the passphrase!"
1263 msgstr ""
1264
1265 # type: textblock
1266 #. type: textblock
1267 #: ../src/guestfs.pod:533
1268 msgid ""
1269 "Opening a LUKS device creates a new device mapper device called C</dev/"
1270 "mapper/mapname> (where C<mapname> is the string you supply to L</"
1271 "guestfs_luks_open>).  Reads and writes to this mapper device are decrypted "
1272 "from and encrypted to the underlying block device respectively."
1273 msgstr ""
1274
1275 # type: textblock
1276 #. type: textblock
1277 #: ../src/guestfs.pod:539
1278 msgid ""
1279 "LVM volume groups on the device can be made visible by calling L</"
1280 "guestfs_vgscan> followed by L</guestfs_vg_activate_all>.  The logical volume"
1281 "(s) can now be mounted in the usual way."
1282 msgstr ""
1283
1284 # type: textblock
1285 #. type: textblock
1286 #: ../src/guestfs.pod:543
1287 msgid ""
1288 "Use the reverse process to close a LUKS device.  Unmount any logical volumes "
1289 "on it, deactivate the volume groups by caling C<guestfs_vg_activate (g, 0, "
1290 "[\"/dev/VG\"])>.  Then close the mapper device by calling L</"
1291 "guestfs_luks_close> on the C</dev/mapper/mapname> device (I<not> the "
1292 "underlying encrypted block device)."
1293 msgstr ""
1294
1295 # type: =head2
1296 #. type: =head2
1297 #: ../src/guestfs.pod:550
1298 msgid "INSPECTION"
1299 msgstr ""
1300
1301 #. type: textblock
1302 #: ../src/guestfs.pod:552
1303 msgid ""
1304 "Libguestfs has APIs for inspecting an unknown disk image to find out if it "
1305 "contains operating systems, an install CD or a live CD.  (These APIs used to "
1306 "be in a separate Perl-only library called L<Sys::Guestfs::Lib(3)> but since "
1307 "version 1.5.3 the most frequently used part of this library has been "
1308 "rewritten in C and moved into the core code)."
1309 msgstr ""
1310
1311 # type: textblock
1312 #. type: textblock
1313 #: ../src/guestfs.pod:559
1314 msgid ""
1315 "Add all disks belonging to the unknown virtual machine and call L</"
1316 "guestfs_launch> in the usual way."
1317 msgstr ""
1318
1319 # type: textblock
1320 #. type: textblock
1321 #: ../src/guestfs.pod:562
1322 msgid ""
1323 "Then call L</guestfs_inspect_os>.  This function uses other libguestfs calls "
1324 "and certain heuristics, and returns a list of operating systems that were "
1325 "found.  An empty list means none were found.  A single element is the root "
1326 "filesystem of the operating system.  For dual- or multi-boot guests, "
1327 "multiple roots can be returned, each one corresponding to a separate "
1328 "operating system.  (Multi-boot virtual machines are extremely rare in the "
1329 "world of virtualization, but since this scenario can happen, we have built "
1330 "libguestfs to deal with it.)"
1331 msgstr ""
1332
1333 # type: textblock
1334 #. type: textblock
1335 #: ../src/guestfs.pod:571
1336 msgid ""
1337 "For each root, you can then call various C<guestfs_inspect_get_*> functions "
1338 "to get additional details about that operating system.  For example, call L</"
1339 "guestfs_inspect_get_type> to return the string C<windows> or C<linux> for "
1340 "Windows and Linux-based operating systems respectively."
1341 msgstr ""
1342
1343 # type: textblock
1344 #. type: textblock
1345 #: ../src/guestfs.pod:577
1346 msgid ""
1347 "Un*x-like and Linux-based operating systems usually consist of several "
1348 "filesystems which are mounted at boot time (for example, a separate boot "
1349 "partition mounted on C</boot>).  The inspection rules are able to detect how "
1350 "filesystems correspond to mount points.  Call "
1351 "C<guestfs_inspect_get_mountpoints> to get this mapping.  It might return a "
1352 "hash table like this example:"
1353 msgstr ""
1354
1355 # type: verbatim
1356 #. type: verbatim
1357 #: ../src/guestfs.pod:584
1358 #, no-wrap
1359 msgid ""
1360 " /boot => /dev/sda1\n"
1361 " /     => /dev/vg_guest/lv_root\n"
1362 " /usr  => /dev/vg_guest/lv_usr\n"
1363 "\n"
1364 msgstr ""
1365
1366 # type: textblock
1367 #. type: textblock
1368 #: ../src/guestfs.pod:588
1369 msgid ""
1370 "The caller can then make calls to L</guestfs_mount_options> to mount the "
1371 "filesystems as suggested."
1372 msgstr ""
1373
1374 # type: textblock
1375 #. type: textblock
1376 #: ../src/guestfs.pod:591
1377 msgid ""
1378 "Be careful to mount filesystems in the right order (eg. C</> before C</"
1379 "usr>).  Sorting the keys of the hash by length, shortest first, should work."
1380 msgstr ""
1381
1382 # type: textblock
1383 #. type: textblock
1384 #: ../src/guestfs.pod:595
1385 msgid ""
1386 "Inspection currently only works for some common operating systems.  "
1387 "Contributors are welcome to send patches for other operating systems that we "
1388 "currently cannot detect."
1389 msgstr ""
1390
1391 # type: textblock
1392 #. type: textblock
1393 #: ../src/guestfs.pod:599
1394 msgid ""
1395 "Encrypted disks must be opened before inspection.  See L</ENCRYPTED DISKS> "
1396 "for more details.  The L</guestfs_inspect_os> function just ignores any "
1397 "encrypted devices."
1398 msgstr ""
1399
1400 # type: textblock
1401 #. type: textblock
1402 #: ../src/guestfs.pod:603
1403 msgid ""
1404 "A note on the implementation: The call L</guestfs_inspect_os> performs "
1405 "inspection and caches the results in the guest handle.  Subsequent calls to "
1406 "C<guestfs_inspect_get_*> return this cached information, but I<do not> re-"
1407 "read the disks.  If you change the content of the guest disks, you can redo "
1408 "inspection by calling L</guestfs_inspect_os> again.  (L</"
1409 "guestfs_inspect_list_applications> works a little differently from the other "
1410 "calls and does read the disks.  See documentation for that function for "
1411 "details)."
1412 msgstr ""
1413
1414 #. type: =head3
1415 #: ../src/guestfs.pod:612
1416 msgid "INSPECTING INSTALL DISKS"
1417 msgstr ""
1418
1419 #. type: textblock
1420 #: ../src/guestfs.pod:614
1421 msgid ""
1422 "Libguestfs (since 1.9.4) can detect some install disks, install CDs, live "
1423 "CDs and more."
1424 msgstr ""
1425
1426 #. type: textblock
1427 #: ../src/guestfs.pod:617
1428 msgid ""
1429 "Call L</guestfs_inspect_get_format> to return the format of the operating "
1430 "system, which currently can be C<installed> (a regular operating system) or "
1431 "C<installer> (some sort of install disk)."
1432 msgstr ""
1433
1434 #. type: textblock
1435 #: ../src/guestfs.pod:621
1436 msgid ""
1437 "Further information is available about the operating system that can be "
1438 "installed using the regular inspection APIs like L</"
1439 "guestfs_inspect_get_product_name>, L</guestfs_inspect_get_major_version> etc."
1440 msgstr ""
1441
1442 #. type: textblock
1443 #: ../src/guestfs.pod:626
1444 msgid ""
1445 "Some additional information specific to installer disks is also available "
1446 "from the L</guestfs_inspect_is_live>, L</guestfs_inspect_is_netinst> and L</"
1447 "guestfs_inspect_is_multipart> calls."
1448 msgstr ""
1449
1450 # type: =head2
1451 #. type: =head2
1452 #: ../src/guestfs.pod:631
1453 msgid "SPECIAL CONSIDERATIONS FOR WINDOWS GUESTS"
1454 msgstr ""
1455
1456 # type: textblock
1457 #. type: textblock
1458 #: ../src/guestfs.pod:633
1459 msgid ""
1460 "Libguestfs can mount NTFS partitions.  It does this using the L<http://www."
1461 "ntfs-3g.org/> driver."
1462 msgstr ""
1463
1464 # type: =head3
1465 #. type: =head3
1466 #: ../src/guestfs.pod:636
1467 msgid "DRIVE LETTERS AND PATHS"
1468 msgstr ""
1469
1470 # type: textblock
1471 #. type: textblock
1472 #: ../src/guestfs.pod:638
1473 msgid ""
1474 "DOS and Windows still use drive letters, and the filesystems are always "
1475 "treated as case insensitive by Windows itself, and therefore you might find "
1476 "a Windows configuration file referring to a path like C<c:\\windows"
1477 "\\system32>.  When the filesystem is mounted in libguestfs, that directory "
1478 "might be referred to as C</WINDOWS/System32>."
1479 msgstr ""
1480
1481 #. type: textblock
1482 #: ../src/guestfs.pod:644
1483 msgid ""
1484 "Drive letter mappings can be found using inspection (see L</INSPECTION> and "
1485 "L</guestfs_inspect_get_drive_mappings>)"
1486 msgstr ""
1487
1488 #. type: textblock
1489 #: ../src/guestfs.pod:647
1490 msgid ""
1491 "Dealing with separator characters (backslash vs forward slash) is outside "
1492 "the scope of libguestfs, but usually a simple character replacement will "
1493 "work."
1494 msgstr ""
1495
1496 #. type: textblock
1497 #: ../src/guestfs.pod:651
1498 msgid ""
1499 "To resolve the case insensitivity of paths, call L</"
1500 "guestfs_case_sensitive_path>."
1501 msgstr ""
1502
1503 # type: =head3
1504 #. type: =head3
1505 #: ../src/guestfs.pod:654
1506 msgid "ACCESSING THE WINDOWS REGISTRY"
1507 msgstr ""
1508
1509 # type: textblock
1510 #. type: textblock
1511 #: ../src/guestfs.pod:656
1512 msgid ""
1513 "Libguestfs also provides some help for decoding Windows Registry \"hive\" "
1514 "files, through the library C<hivex> which is part of the libguestfs project "
1515 "although ships as a separate tarball.  You have to locate and download the "
1516 "hive file(s) yourself, and then pass them to C<hivex> functions.  See also "
1517 "the programs L<hivexml(1)>, L<hivexsh(1)>, L<hivexregedit(1)> and L<virt-win-"
1518 "reg(1)> for more help on this issue."
1519 msgstr ""
1520
1521 # type: =head3
1522 #. type: =head3
1523 #: ../src/guestfs.pod:664
1524 msgid "SYMLINKS ON NTFS-3G FILESYSTEMS"
1525 msgstr ""
1526
1527 # type: textblock
1528 #. type: textblock
1529 #: ../src/guestfs.pod:666
1530 msgid ""
1531 "Ntfs-3g tries to rewrite \"Junction Points\" and NTFS \"symbolic links\" to "
1532 "provide something which looks like a Linux symlink.  The way it tries to do "
1533 "the rewriting is described here:"
1534 msgstr ""
1535
1536 # type: textblock
1537 #. type: textblock
1538 #: ../src/guestfs.pod:670
1539 msgid ""
1540 "L<http://www.tuxera.com/community/ntfs-3g-advanced/junction-points-and-"
1541 "symbolic-links/>"
1542 msgstr ""
1543
1544 # type: textblock
1545 #. type: textblock
1546 #: ../src/guestfs.pod:672
1547 msgid ""
1548 "The essential problem is that ntfs-3g simply does not have enough "
1549 "information to do a correct job.  NTFS links can contain drive letters and "
1550 "references to external device GUIDs that ntfs-3g has no way of resolving.  "
1551 "It is almost certainly the case that libguestfs callers should ignore what "
1552 "ntfs-3g does (ie. don't use L</guestfs_readlink> on NTFS volumes)."
1553 msgstr ""
1554
1555 # type: textblock
1556 #. type: textblock
1557 #: ../src/guestfs.pod:679
1558 msgid ""
1559 "Instead if you encounter a symbolic link on an ntfs-3g filesystem, use L</"
1560 "guestfs_lgetxattr> to read the C<system.ntfs_reparse_data> extended "
1561 "attribute, and read the raw reparse data from that (you can find the format "
1562 "documented in various places around the web)."
1563 msgstr ""
1564
1565 # type: =head3
1566 #. type: =head3
1567 #: ../src/guestfs.pod:684
1568 msgid "EXTENDED ATTRIBUTES ON NTFS-3G FILESYSTEMS"
1569 msgstr ""
1570
1571 # type: textblock
1572 #. type: textblock
1573 #: ../src/guestfs.pod:686
1574 msgid ""
1575 "There are other useful extended attributes that can be read from ntfs-3g "
1576 "filesystems (using L</guestfs_getxattr>).  See:"
1577 msgstr ""
1578
1579 # type: textblock
1580 #. type: textblock
1581 #: ../src/guestfs.pod:689
1582 msgid ""
1583 "L<http://www.tuxera.com/community/ntfs-3g-advanced/extended-attributes/>"
1584 msgstr ""
1585
1586 # type: =head2
1587 #. type: =head2
1588 #: ../src/guestfs.pod:691
1589 msgid "USING LIBGUESTFS WITH OTHER PROGRAMMING LANGUAGES"
1590 msgstr ""
1591
1592 # type: textblock
1593 #. type: textblock
1594 #: ../src/guestfs.pod:693
1595 msgid ""
1596 "Although we don't want to discourage you from using the C API, we will "
1597 "mention here that the same API is also available in other languages."
1598 msgstr ""
1599
1600 #. type: textblock
1601 #: ../src/guestfs.pod:696
1602 msgid ""
1603 "The API is broadly identical in all supported languages.  This means that "
1604 "the C call C<guestfs_add_drive_ro(g,file)> is C<$g-E<gt>add_drive_ro($file)> "
1605 "in Perl, C<g.add_drive_ro(file)> in Python, and C<g#add_drive_ro file> in "
1606 "OCaml.  In other words, a straightforward, predictable isomorphism between "
1607 "each language."
1608 msgstr ""
1609
1610 # type: textblock
1611 #. type: textblock
1612 #: ../src/guestfs.pod:702
1613 msgid ""
1614 "Error messages are automatically transformed into exceptions if the language "
1615 "supports it."
1616 msgstr ""
1617
1618 # type: textblock
1619 #. type: textblock
1620 #: ../src/guestfs.pod:705
1621 msgid ""
1622 "We don't try to \"object orientify\" parts of the API in OO languages, "
1623 "although contributors are welcome to write higher level APIs above what we "
1624 "provide in their favourite languages if they wish."
1625 msgstr ""
1626
1627 # type: =item
1628 #. type: =item
1629 #: ../src/guestfs.pod:711
1630 msgid "B<C++>"
1631 msgstr ""
1632
1633 # type: textblock
1634 #. type: textblock
1635 #: ../src/guestfs.pod:713
1636 msgid ""
1637 "You can use the I<guestfs.h> header file from C++ programs.  The C++ API is "
1638 "identical to the C API.  C++ classes and exceptions are not used."
1639 msgstr ""
1640
1641 # type: =item
1642 #. type: =item
1643 #: ../src/guestfs.pod:717
1644 msgid "B<C#>"
1645 msgstr ""
1646
1647 # type: textblock
1648 #. type: textblock
1649 #: ../src/guestfs.pod:719
1650 msgid ""
1651 "The C# bindings are highly experimental.  Please read the warnings at the "
1652 "top of C<csharp/Libguestfs.cs>."
1653 msgstr ""
1654
1655 # type: =item
1656 #. type: =item
1657 #: ../src/guestfs.pod:722
1658 msgid "B<Haskell>"
1659 msgstr ""
1660
1661 # type: textblock
1662 #. type: textblock
1663 #: ../src/guestfs.pod:724
1664 msgid ""
1665 "This is the only language binding that is working but incomplete.  Only "
1666 "calls which return simple integers have been bound in Haskell, and we are "
1667 "looking for help to complete this binding."
1668 msgstr ""
1669
1670 # type: =item
1671 #. type: =item
1672 #: ../src/guestfs.pod:728
1673 msgid "B<Java>"
1674 msgstr ""
1675
1676 # type: textblock
1677 #. type: textblock
1678 #: ../src/guestfs.pod:730
1679 msgid ""
1680 "Full documentation is contained in the Javadoc which is distributed with "
1681 "libguestfs."
1682 msgstr ""
1683
1684 # type: =item
1685 #. type: =item
1686 #: ../src/guestfs.pod:733
1687 msgid "B<OCaml>"
1688 msgstr ""
1689
1690 #. type: textblock
1691 #: ../src/guestfs.pod:735
1692 msgid "See L<guestfs-ocaml(3)>."
1693 msgstr ""
1694
1695 # type: =item
1696 #. type: =item
1697 #: ../src/guestfs.pod:737
1698 msgid "B<Perl>"
1699 msgstr ""
1700
1701 #. type: textblock
1702 #: ../src/guestfs.pod:739
1703 msgid "See L<guestfs-perl(3)> and L<Sys::Guestfs(3)>."
1704 msgstr ""
1705
1706 # type: =item
1707 #. type: =item
1708 #: ../src/guestfs.pod:741
1709 msgid "B<PHP>"
1710 msgstr ""
1711
1712 # type: textblock
1713 #. type: textblock
1714 #: ../src/guestfs.pod:743
1715 msgid ""
1716 "For documentation see C<README-PHP> supplied with libguestfs sources or in "
1717 "the php-libguestfs package for your distribution."
1718 msgstr ""
1719
1720 # type: textblock
1721 #. type: textblock
1722 #: ../src/guestfs.pod:746
1723 msgid "The PHP binding only works correctly on 64 bit machines."
1724 msgstr ""
1725
1726 # type: =item
1727 #. type: =item
1728 #: ../src/guestfs.pod:748
1729 msgid "B<Python>"
1730 msgstr ""
1731
1732 #. type: textblock
1733 #: ../src/guestfs.pod:750
1734 msgid "See L<guestfs-python(3)>."
1735 msgstr ""
1736
1737 # type: =item
1738 #. type: =item
1739 #: ../src/guestfs.pod:752
1740 msgid "B<Ruby>"
1741 msgstr ""
1742
1743 #. type: textblock
1744 #: ../src/guestfs.pod:754
1745 msgid "See L<guestfs-ruby(3)>."
1746 msgstr ""
1747
1748 # type: =item
1749 #. type: =item
1750 #: ../src/guestfs.pod:756
1751 msgid "B<shell scripts>"
1752 msgstr ""
1753
1754 #. type: textblock
1755 #: ../src/guestfs.pod:758
1756 msgid "See L<guestfish(1)>."
1757 msgstr ""
1758
1759 # type: =head2
1760 #. type: =head2
1761 #: ../src/guestfs.pod:762
1762 msgid "LIBGUESTFS GOTCHAS"
1763 msgstr ""
1764
1765 # type: textblock
1766 #. type: textblock
1767 #: ../src/guestfs.pod:764
1768 msgid ""
1769 "L<http://en.wikipedia.org/wiki/Gotcha_(programming)>: \"A feature of a "
1770 "system [...] that works in the way it is documented but is counterintuitive "
1771 "and almost invites mistakes.\""
1772 msgstr ""
1773
1774 # type: textblock
1775 #. type: textblock
1776 #: ../src/guestfs.pod:768
1777 msgid ""
1778 "Since we developed libguestfs and the associated tools, there are several "
1779 "things we would have designed differently, but are now stuck with for "
1780 "backwards compatibility or other reasons.  If there is ever a libguestfs 2.0 "
1781 "release, you can expect these to change.  Beware of them."
1782 msgstr ""
1783
1784 # type: =item
1785 #. type: =item
1786 #: ../src/guestfs.pod:776
1787 msgid "Autosync / forgetting to sync."
1788 msgstr ""
1789
1790 #. type: textblock
1791 #: ../src/guestfs.pod:778
1792 msgid ""
1793 "I<Update:> Autosync is enabled by default for all API users starting from "
1794 "libguestfs 1.5.24.  This section only applies to older versions."
1795 msgstr ""
1796
1797 # type: textblock
1798 #. type: textblock
1799 #: ../src/guestfs.pod:781
1800 msgid ""
1801 "When modifying a filesystem from C or another language, you B<must> unmount "
1802 "all filesystems and call L</guestfs_sync> explicitly before you close the "
1803 "libguestfs handle.  You can also call:"
1804 msgstr ""
1805
1806 # type: verbatim
1807 #. type: verbatim
1808 #: ../src/guestfs.pod:785
1809 #, no-wrap
1810 msgid ""
1811 " guestfs_set_autosync (g, 1);\n"
1812 "\n"
1813 msgstr ""
1814
1815 # type: textblock
1816 #. type: textblock
1817 #: ../src/guestfs.pod:787
1818 msgid ""
1819 "to have the unmount/sync done automatically for you when the handle 'g' is "
1820 "closed.  (This feature is called \"autosync\", L</guestfs_set_autosync> q.v.)"
1821 msgstr ""
1822
1823 # type: textblock
1824 #. type: textblock
1825 #: ../src/guestfs.pod:791
1826 msgid ""
1827 "If you forget to do this, then it is entirely possible that your changes "
1828 "won't be written out, or will be partially written, or (very rarely) that "
1829 "you'll get disk corruption."
1830 msgstr ""
1831
1832 # type: textblock
1833 #. type: textblock
1834 #: ../src/guestfs.pod:795
1835 msgid ""
1836 "Note that in L<guestfish(3)> autosync is the default.  So quick and dirty "
1837 "guestfish scripts that forget to sync will work just fine, which can make "
1838 "this very puzzling if you are trying to debug a problem."
1839 msgstr ""
1840
1841 # type: =item
1842 #. type: =item
1843 #: ../src/guestfs.pod:799
1844 msgid "Mount option C<-o sync> should not be the default."
1845 msgstr ""
1846
1847 # type: textblock
1848 #. type: textblock
1849 #: ../src/guestfs.pod:801
1850 msgid ""
1851 "If you use L</guestfs_mount>, then C<-o sync,noatime> are added implicitly.  "
1852 "However C<-o sync> does not add any reliability benefit, but does have a "
1853 "very large performance impact."
1854 msgstr ""
1855
1856 # type: textblock
1857 #. type: textblock
1858 #: ../src/guestfs.pod:805
1859 msgid ""
1860 "The work around is to use L</guestfs_mount_options> and set the mount "
1861 "options that you actually want to use."
1862 msgstr ""
1863
1864 # type: =item
1865 #. type: =item
1866 #: ../src/guestfs.pod:808
1867 msgid "Read-only should be the default."
1868 msgstr ""
1869
1870 # type: textblock
1871 #. type: textblock
1872 #: ../src/guestfs.pod:810
1873 msgid ""
1874 "In L<guestfish(3)>, I<--ro> should be the default, and you should have to "
1875 "specify I<--rw> if you want to make changes to the image."
1876 msgstr ""
1877
1878 # type: textblock
1879 #. type: textblock
1880 #: ../src/guestfs.pod:813
1881 msgid "This would reduce the potential to corrupt live VM images."
1882 msgstr ""
1883
1884 # type: textblock
1885 #. type: textblock
1886 #: ../src/guestfs.pod:815
1887 msgid ""
1888 "Note that many filesystems change the disk when you just mount and unmount, "
1889 "even if you didn't perform any writes.  You need to use L</"
1890 "guestfs_add_drive_ro> to guarantee that the disk is not changed."
1891 msgstr ""
1892
1893 # type: =item
1894 #. type: =item
1895 #: ../src/guestfs.pod:819
1896 msgid "guestfish command line is hard to use."
1897 msgstr ""
1898
1899 # type: textblock
1900 #. type: textblock
1901 #: ../src/guestfs.pod:821
1902 msgid ""
1903 "C<guestfish disk.img> doesn't do what people expect (open C<disk.img> for "
1904 "examination).  It tries to run a guestfish command C<disk.img> which doesn't "
1905 "exist, so it fails.  In earlier versions of guestfish the error message was "
1906 "also unintuitive, but we have corrected this since.  Like the Bourne shell, "
1907 "we should have used C<guestfish -c command> to run commands."
1908 msgstr ""
1909
1910 # type: =item
1911 #. type: =item
1912 #: ../src/guestfs.pod:828
1913 msgid "guestfish megabyte modifiers don't work right on all commands"
1914 msgstr ""
1915
1916 # type: textblock
1917 #. type: textblock
1918 #: ../src/guestfs.pod:830
1919 msgid ""
1920 "In recent guestfish you can use C<1M> to mean 1 megabyte (and similarly for "
1921 "other modifiers).  What guestfish actually does is to multiply the number "
1922 "part by the modifier part and pass the result to the C API.  However this "
1923 "doesn't work for a few APIs which aren't expecting bytes, but are already "
1924 "expecting some other unit (eg. megabytes)."
1925 msgstr ""
1926
1927 # type: textblock
1928 #. type: textblock
1929 #: ../src/guestfs.pod:837
1930 msgid "The most common is L</guestfs_lvcreate>.  The guestfish command:"
1931 msgstr ""
1932
1933 # type: verbatim
1934 #. type: verbatim
1935 #: ../src/guestfs.pod:839
1936 #, no-wrap
1937 msgid ""
1938 " lvcreate LV VG 100M\n"
1939 "\n"
1940 msgstr ""
1941
1942 # type: textblock
1943 #. type: textblock
1944 #: ../src/guestfs.pod:841
1945 msgid ""
1946 "does not do what you might expect.  Instead because L</guestfs_lvcreate> is "
1947 "already expecting megabytes, this tries to create a 100 I<terabyte> (100 "
1948 "megabytes * megabytes) logical volume.  The error message you get from this "
1949 "is also a little obscure."
1950 msgstr ""
1951
1952 # type: textblock
1953 #. type: textblock
1954 #: ../src/guestfs.pod:846
1955 msgid ""
1956 "This could be fixed in the generator by specially marking parameters and "
1957 "return values which take bytes or other units."
1958 msgstr ""
1959
1960 # type: =item
1961 #. type: =item
1962 #: ../src/guestfs.pod:849
1963 msgid "Ambiguity between devices and paths"
1964 msgstr ""
1965
1966 # type: textblock
1967 #. type: textblock
1968 #: ../src/guestfs.pod:851
1969 msgid ""
1970 "There is a subtle ambiguity in the API between a device name (eg. C</dev/"
1971 "sdb2>) and a similar pathname.  A file might just happen to be called "
1972 "C<sdb2> in the directory C</dev> (consider some non-Unix VM image)."
1973 msgstr ""
1974
1975 # type: textblock
1976 #. type: textblock
1977 #: ../src/guestfs.pod:856
1978 msgid ""
1979 "In the current API we usually resolve this ambiguity by having two separate "
1980 "calls, for example L</guestfs_checksum> and L</guestfs_checksum_device>.  "
1981 "Some API calls are ambiguous and (incorrectly) resolve the problem by "
1982 "detecting if the path supplied begins with C</dev/>."
1983 msgstr ""
1984
1985 # type: textblock
1986 #. type: textblock
1987 #: ../src/guestfs.pod:862
1988 msgid ""
1989 "To avoid both the ambiguity and the need to duplicate some calls, we could "
1990 "make paths/devices into structured names.  One way to do this would be to "
1991 "use a notation like grub (C<hd(0,0)>), although nobody really likes this "
1992 "aspect of grub.  Another way would be to use a structured type, equivalent "
1993 "to this OCaml type:"
1994 msgstr ""
1995
1996 # type: verbatim
1997 #. type: verbatim
1998 #: ../src/guestfs.pod:868
1999 #, no-wrap
2000 msgid ""
2001 " type path = Path of string | Device of int | Partition of int * int\n"
2002 "\n"
2003 msgstr ""
2004
2005 # type: textblock
2006 #. type: textblock
2007 #: ../src/guestfs.pod:870
2008 msgid "which would allow you to pass arguments like:"
2009 msgstr ""
2010
2011 # type: verbatim
2012 #. type: verbatim
2013 #: ../src/guestfs.pod:872
2014 #, no-wrap
2015 msgid ""
2016 " Path \"/foo/bar\"\n"
2017 " Device 1            (* /dev/sdb, or perhaps /dev/sda *)\n"
2018 " Partition (1, 2)    (* /dev/sdb2 (or is it /dev/sda2 or /dev/sdb3?) *)\n"
2019 " Path \"/dev/sdb2\"    (* not a device *)\n"
2020 "\n"
2021 msgstr ""
2022
2023 # type: textblock
2024 #. type: textblock
2025 #: ../src/guestfs.pod:877
2026 msgid ""
2027 "As you can see there are still problems to resolve even with this "
2028 "representation.  Also consider how it might work in guestfish."
2029 msgstr ""
2030
2031 # type: =head2
2032 #. type: =head2
2033 #: ../src/guestfs.pod:882
2034 msgid "KEYS AND PASSPHRASES"
2035 msgstr ""
2036
2037 # type: textblock
2038 #. type: textblock
2039 #: ../src/guestfs.pod:884
2040 msgid ""
2041 "Certain libguestfs calls take a parameter that contains sensitive key "
2042 "material, passed in as a C string."
2043 msgstr ""
2044
2045 # type: textblock
2046 #. type: textblock
2047 #: ../src/guestfs.pod:887
2048 msgid ""
2049 "In the future we would hope to change the libguestfs implementation so that "
2050 "keys are L<mlock(2)>-ed into physical RAM, and thus can never end up in "
2051 "swap.  However this is I<not> done at the moment, because of the complexity "
2052 "of such an implementation."
2053 msgstr ""
2054
2055 # type: textblock
2056 #. type: textblock
2057 #: ../src/guestfs.pod:892
2058 msgid ""
2059 "Therefore you should be aware that any key parameter you pass to libguestfs "
2060 "might end up being written out to the swap partition.  If this is a concern, "
2061 "scrub the swap partition or don't use libguestfs on encrypted devices."
2062 msgstr ""
2063
2064 # type: =head1
2065 #. type: =head2
2066 #: ../src/guestfs.pod:897
2067 msgid "MULTIPLE HANDLES AND MULTIPLE THREADS"
2068 msgstr ""
2069
2070 # type: textblock
2071 #. type: textblock
2072 #: ../src/guestfs.pod:899
2073 msgid ""
2074 "All high-level libguestfs actions are synchronous.  If you want to use "
2075 "libguestfs asynchronously then you must create a thread."
2076 msgstr ""
2077
2078 # type: textblock
2079 #. type: textblock
2080 #: ../src/guestfs.pod:902
2081 msgid ""
2082 "Only use the handle from a single thread.  Either use the handle exclusively "
2083 "from one thread, or provide your own mutex so that two threads cannot issue "
2084 "calls on the same handle at the same time."
2085 msgstr ""
2086
2087 # type: textblock
2088 #. type: textblock
2089 #: ../src/guestfs.pod:906
2090 msgid ""
2091 "See the graphical program guestfs-browser for one possible architecture for "
2092 "multithreaded programs using libvirt and libguestfs."
2093 msgstr ""
2094
2095 # type: =head1
2096 #. type: =head2
2097 #: ../src/guestfs.pod:909
2098 msgid "PATH"
2099 msgstr ""
2100
2101 #. type: textblock
2102 #: ../src/guestfs.pod:911
2103 msgid ""
2104 "Libguestfs needs a supermin appliance, which it finds by looking along an "
2105 "internal path."
2106 msgstr ""
2107
2108 # type: textblock
2109 #. type: textblock
2110 #: ../src/guestfs.pod:914
2111 msgid ""
2112 "By default it looks for these in the directory C<$libdir/guestfs> (eg. C</"
2113 "usr/local/lib/guestfs> or C</usr/lib64/guestfs>)."
2114 msgstr ""
2115
2116 # type: textblock
2117 #. type: textblock
2118 #: ../src/guestfs.pod:917
2119 msgid ""
2120 "Use L</guestfs_set_path> or set the environment variable L</LIBGUESTFS_PATH> "
2121 "to change the directories that libguestfs will search in.  The value is a "
2122 "colon-separated list of paths.  The current directory is I<not> searched "
2123 "unless the path contains an empty element or C<.>.  For example "
2124 "C<LIBGUESTFS_PATH=:/usr/lib/guestfs> would search the current directory and "
2125 "then C</usr/lib/guestfs>."
2126 msgstr ""
2127
2128 # type: =head1
2129 #. type: =head2
2130 #: ../src/guestfs.pod:924
2131 msgid "QEMU WRAPPERS"
2132 msgstr ""
2133
2134 # type: textblock
2135 #. type: textblock
2136 #: ../src/guestfs.pod:926
2137 msgid ""
2138 "If you want to compile your own qemu, run qemu from a non-standard location, "
2139 "or pass extra arguments to qemu, then you can write a shell-script wrapper "
2140 "around qemu."
2141 msgstr ""
2142
2143 # type: textblock
2144 #. type: textblock
2145 #: ../src/guestfs.pod:930
2146 msgid ""
2147 "There is one important rule to remember: you I<must C<exec qemu>> as the "
2148 "last command in the shell script (so that qemu replaces the shell and "
2149 "becomes the direct child of the libguestfs-using program).  If you don't do "
2150 "this, then the qemu process won't be cleaned up correctly."
2151 msgstr ""
2152
2153 # type: textblock
2154 #. type: textblock
2155 #: ../src/guestfs.pod:935
2156 msgid ""
2157 "Here is an example of a wrapper, where I have built my own copy of qemu from "
2158 "source:"
2159 msgstr ""
2160
2161 # type: verbatim
2162 #. type: verbatim
2163 #: ../src/guestfs.pod:938
2164 #, no-wrap
2165 msgid ""
2166 " #!/bin/sh -\n"
2167 " qemudir=/home/rjones/d/qemu\n"
2168 " exec $qemudir/x86_64-softmmu/qemu-system-x86_64 -L $qemudir/pc-bios \"$@\"\n"
2169 "\n"
2170 msgstr ""
2171
2172 # type: textblock
2173 #. type: textblock
2174 #: ../src/guestfs.pod:942
2175 msgid ""
2176 "Save this script as C</tmp/qemu.wrapper> (or wherever), C<chmod +x>, and "
2177 "then use it by setting the LIBGUESTFS_QEMU environment variable.  For "
2178 "example:"
2179 msgstr ""
2180
2181 # type: verbatim
2182 #. type: verbatim
2183 #: ../src/guestfs.pod:946
2184 #, no-wrap
2185 msgid ""
2186 " LIBGUESTFS_QEMU=/tmp/qemu.wrapper guestfish\n"
2187 "\n"
2188 msgstr ""
2189
2190 # type: textblock
2191 #. type: textblock
2192 #: ../src/guestfs.pod:948
2193 msgid ""
2194 "Note that libguestfs also calls qemu with the -help and -version options in "
2195 "order to determine features."
2196 msgstr ""
2197
2198 #. type: =head2
2199 #: ../src/guestfs.pod:951
2200 msgid "ATTACHING TO RUNNING DAEMONS"
2201 msgstr ""
2202
2203 #. type: textblock
2204 #: ../src/guestfs.pod:953
2205 msgid ""
2206 "I<Note (1):> This is B<highly experimental> and has a tendency to eat "
2207 "babies.  Use with caution."
2208 msgstr ""
2209
2210 #. type: textblock
2211 #: ../src/guestfs.pod:956
2212 msgid ""
2213 "I<Note (2):> This section explains how to attach to a running daemon from a "
2214 "low level perspective.  For most users, simply using virt tools such as "
2215 "L<guestfish(1)> with the I<--live> option will \"just work\"."
2216 msgstr ""
2217
2218 #. type: =head3
2219 #: ../src/guestfs.pod:960
2220 msgid "Using guestfs_set_attach_method"
2221 msgstr ""
2222
2223 #. type: textblock
2224 #: ../src/guestfs.pod:962
2225 msgid ""
2226 "By calling L</guestfs_set_attach_method> you can change how the library "
2227 "connects to the C<guestfsd> daemon in L</guestfs_launch> (read L</"
2228 "ARCHITECTURE> for some background)."
2229 msgstr ""
2230
2231 #. type: textblock
2232 #: ../src/guestfs.pod:966
2233 msgid ""
2234 "The normal attach method is C<appliance>, where a small appliance is created "
2235 "containing the daemon, and then the library connects to this."
2236 msgstr ""
2237
2238 #. type: textblock
2239 #: ../src/guestfs.pod:969
2240 msgid ""
2241 "Setting attach method to C<unix:I<path>> (where I<path> is the path of a "
2242 "Unix domain socket) causes L</guestfs_launch> to connect to an existing "
2243 "daemon over the Unix domain socket."
2244 msgstr ""
2245
2246 #. type: textblock
2247 #: ../src/guestfs.pod:973
2248 msgid ""
2249 "The normal use for this is to connect to a running virtual machine that "
2250 "contains a C<guestfsd> daemon, and send commands so you can read and write "
2251 "files inside the live virtual machine."
2252 msgstr ""
2253
2254 #. type: =head3
2255 #: ../src/guestfs.pod:977
2256 msgid "Using guestfs_add_domain with live flag"
2257 msgstr ""
2258
2259 #. type: textblock
2260 #: ../src/guestfs.pod:979
2261 msgid ""
2262 "L</guestfs_add_domain> provides some help for getting the correct attach "
2263 "method.  If you pass the C<live> option to this function, then (if the "
2264 "virtual machine is running) it will examine the libvirt XML looking for a "
2265 "virtio-serial channel to connect to:"
2266 msgstr ""
2267
2268 #. type: verbatim
2269 #: ../src/guestfs.pod:985
2270 #, no-wrap
2271 msgid ""
2272 " <domain>\n"
2273 "   ...\n"
2274 "   <devices>\n"
2275 "     ...\n"
2276 "     <channel type='unix'>\n"
2277 "       <source mode='bind' path='/path/to/socket'/>\n"
2278 "       <target type='virtio' name='org.libguestfs.channel.0'/>\n"
2279 "     </channel>\n"
2280 "     ...\n"
2281 "   </devices>\n"
2282 " </domain>\n"
2283 "\n"
2284 msgstr ""
2285
2286 #. type: textblock
2287 #: ../src/guestfs.pod:997
2288 msgid ""
2289 "L</guestfs_add_domain> extracts C</path/to/socket> and sets the attach "
2290 "method to C<unix:/path/to/socket>."
2291 msgstr ""
2292
2293 #. type: textblock
2294 #: ../src/guestfs.pod:1000
2295 msgid ""
2296 "Some of the libguestfs tools (including guestfish) support a I<--live> "
2297 "option which is passed through to L</guestfs_add_domain> thus allowing you "
2298 "to attach to and modify live virtual machines."
2299 msgstr ""
2300
2301 #. type: textblock
2302 #: ../src/guestfs.pod:1004
2303 msgid ""
2304 "The virtual machine needs to have been set up beforehand so that it has the "
2305 "virtio-serial channel and so that guestfsd is running inside it."
2306 msgstr ""
2307
2308 # type: =head2
2309 #. type: =head2
2310 #: ../src/guestfs.pod:1008
2311 msgid "ABI GUARANTEE"
2312 msgstr ""
2313
2314 # type: textblock
2315 #. type: textblock
2316 #: ../src/guestfs.pod:1010
2317 msgid ""
2318 "We guarantee the libguestfs ABI (binary interface), for public, high-level "
2319 "actions as outlined in this section.  Although we will deprecate some "
2320 "actions, for example if they get replaced by newer calls, we will keep the "
2321 "old actions forever.  This allows you the developer to program in confidence "
2322 "against the libguestfs API."
2323 msgstr ""
2324
2325 # type: =head1
2326 #. type: =head2
2327 #: ../src/guestfs.pod:1016
2328 msgid "BLOCK DEVICE NAMING"
2329 msgstr ""
2330
2331 # type: textblock
2332 #. type: textblock
2333 #: ../src/guestfs.pod:1018
2334 msgid ""
2335 "In the kernel there is now quite a profusion of schemata for naming block "
2336 "devices (in this context, by I<block device> I mean a physical or virtual "
2337 "hard drive).  The original Linux IDE driver used names starting with C</dev/"
2338 "hd*>.  SCSI devices have historically used a different naming scheme, C</dev/"
2339 "sd*>.  When the Linux kernel I<libata> driver became a popular replacement "
2340 "for the old IDE driver (particularly for SATA devices) those devices also "
2341 "used the C</dev/sd*> scheme.  Additionally we now have virtual machines with "
2342 "paravirtualized drivers.  This has created several different naming systems, "
2343 "such as C</dev/vd*> for virtio disks and C</dev/xvd*> for Xen PV disks."
2344 msgstr ""
2345
2346 # type: textblock
2347 #. type: textblock
2348 #: ../src/guestfs.pod:1030
2349 msgid ""
2350 "As discussed above, libguestfs uses a qemu appliance running an embedded "
2351 "Linux kernel to access block devices.  We can run a variety of appliances "
2352 "based on a variety of Linux kernels."
2353 msgstr ""
2354
2355 # type: textblock
2356 #. type: textblock
2357 #: ../src/guestfs.pod:1034
2358 msgid ""
2359 "This causes a problem for libguestfs because many API calls use device or "
2360 "partition names.  Working scripts and the recipe (example) scripts that we "
2361 "make available over the internet could fail if the naming scheme changes."
2362 msgstr ""
2363
2364 # type: textblock
2365 #. type: textblock
2366 #: ../src/guestfs.pod:1039
2367 msgid ""
2368 "Therefore libguestfs defines C</dev/sd*> as the I<standard naming scheme>.  "
2369 "Internally C</dev/sd*> names are translated, if necessary, to other names as "
2370 "required.  For example, under RHEL 5 which uses the C</dev/hd*> scheme, any "
2371 "device parameter C</dev/sda2> is translated to C</dev/hda2> transparently."
2372 msgstr ""
2373
2374 # type: textblock
2375 #. type: textblock
2376 #: ../src/guestfs.pod:1045
2377 msgid ""
2378 "Note that this I<only> applies to parameters.  The L</guestfs_list_devices>, "
2379 "L</guestfs_list_partitions> and similar calls return the true names of the "
2380 "devices and partitions as known to the appliance."
2381 msgstr ""
2382
2383 # type: =head2
2384 #. type: =head3
2385 #: ../src/guestfs.pod:1050
2386 msgid "ALGORITHM FOR BLOCK DEVICE NAME TRANSLATION"
2387 msgstr ""
2388
2389 # type: textblock
2390 #. type: textblock
2391 #: ../src/guestfs.pod:1052
2392 msgid ""
2393 "Usually this translation is transparent.  However in some (very rare)  cases "
2394 "you may need to know the exact algorithm.  Such cases include where you use "
2395 "L</guestfs_config> to add a mixture of virtio and IDE devices to the qemu-"
2396 "based appliance, so have a mixture of C</dev/sd*> and C</dev/vd*> devices."
2397 msgstr ""
2398
2399 # type: textblock
2400 #. type: textblock
2401 #: ../src/guestfs.pod:1058
2402 msgid ""
2403 "The algorithm is applied only to I<parameters> which are known to be either "
2404 "device or partition names.  Return values from functions such as L</"
2405 "guestfs_list_devices> are never changed."
2406 msgstr ""
2407
2408 # type: textblock
2409 #. type: textblock
2410 #: ../src/guestfs.pod:1066
2411 msgid "Is the string a parameter which is a device or partition name?"
2412 msgstr ""
2413
2414 # type: textblock
2415 #. type: textblock
2416 #: ../src/guestfs.pod:1070
2417 msgid "Does the string begin with C</dev/sd>?"
2418 msgstr ""
2419
2420 # type: textblock
2421 #. type: textblock
2422 #: ../src/guestfs.pod:1074
2423 msgid ""
2424 "Does the named device exist? If so, we use that device.  However if I<not> "
2425 "then we continue with this algorithm."
2426 msgstr ""
2427
2428 # type: textblock
2429 #. type: textblock
2430 #: ../src/guestfs.pod:1079
2431 msgid "Replace initial C</dev/sd> string with C</dev/hd>."
2432 msgstr ""
2433
2434 # type: textblock
2435 #. type: textblock
2436 #: ../src/guestfs.pod:1081
2437 msgid "For example, change C</dev/sda2> to C</dev/hda2>."
2438 msgstr ""
2439
2440 # type: textblock
2441 #. type: textblock
2442 #: ../src/guestfs.pod:1083
2443 msgid "If that named device exists, use it.  If not, continue."
2444 msgstr ""
2445
2446 # type: textblock
2447 #. type: textblock
2448 #: ../src/guestfs.pod:1087
2449 msgid "Replace initial C</dev/sd> string with C</dev/vd>."
2450 msgstr ""
2451
2452 # type: textblock
2453 #. type: textblock
2454 #: ../src/guestfs.pod:1089
2455 msgid "If that named device exists, use it.  If not, return an error."
2456 msgstr ""
2457
2458 # type: =head3
2459 #. type: =head3
2460 #: ../src/guestfs.pod:1093
2461 msgid "PORTABILITY CONCERNS WITH BLOCK DEVICE NAMING"
2462 msgstr ""
2463
2464 # type: textblock
2465 #. type: textblock
2466 #: ../src/guestfs.pod:1095
2467 msgid ""
2468 "Although the standard naming scheme and automatic translation is useful for "
2469 "simple programs and guestfish scripts, for larger programs it is best not to "
2470 "rely on this mechanism."
2471 msgstr ""
2472
2473 # type: textblock
2474 #. type: textblock
2475 #: ../src/guestfs.pod:1099
2476 msgid ""
2477 "Where possible for maximum future portability programs using libguestfs "
2478 "should use these future-proof techniques:"
2479 msgstr ""
2480
2481 # type: textblock
2482 #. type: textblock
2483 #: ../src/guestfs.pod:1106
2484 msgid ""
2485 "Use L</guestfs_list_devices> or L</guestfs_list_partitions> to list actual "
2486 "device names, and then use those names directly."
2487 msgstr ""
2488
2489 # type: textblock
2490 #. type: textblock
2491 #: ../src/guestfs.pod:1109
2492 msgid ""
2493 "Since those device names exist by definition, they will never be translated."
2494 msgstr ""
2495
2496 # type: textblock
2497 #. type: textblock
2498 #: ../src/guestfs.pod:1114
2499 msgid ""
2500 "Use higher level ways to identify filesystems, such as LVM names, UUIDs and "
2501 "filesystem labels."
2502 msgstr ""
2503
2504 # type: =head1
2505 #. type: =head1
2506 #: ../src/guestfs.pod:1119
2507 msgid "SECURITY"
2508 msgstr ""
2509
2510 # type: textblock
2511 #. type: textblock
2512 #: ../src/guestfs.pod:1121
2513 msgid ""
2514 "This section discusses security implications of using libguestfs, "
2515 "particularly with untrusted or malicious guests or disk images."
2516 msgstr ""
2517
2518 # type: =head2
2519 #. type: =head2
2520 #: ../src/guestfs.pod:1124
2521 msgid "GENERAL SECURITY CONSIDERATIONS"
2522 msgstr ""
2523
2524 # type: textblock
2525 #. type: textblock
2526 #: ../src/guestfs.pod:1126
2527 msgid ""
2528 "Be careful with any files or data that you download from a guest (by "
2529 "\"download\" we mean not just the L</guestfs_download> command but any "
2530 "command that reads files, filenames, directories or anything else from a "
2531 "disk image).  An attacker could manipulate the data to fool your program "
2532 "into doing the wrong thing.  Consider cases such as:"
2533 msgstr ""
2534
2535 # type: textblock
2536 #. type: textblock
2537 #: ../src/guestfs.pod:1136
2538 msgid "the data (file etc) not being present"
2539 msgstr ""
2540
2541 # type: textblock
2542 #. type: textblock
2543 #: ../src/guestfs.pod:1140
2544 msgid "being present but empty"
2545 msgstr ""
2546
2547 # type: textblock
2548 #. type: textblock
2549 #: ../src/guestfs.pod:1144
2550 msgid "being much larger than normal"
2551 msgstr ""
2552
2553 # type: textblock
2554 #. type: textblock
2555 #: ../src/guestfs.pod:1148
2556 msgid "containing arbitrary 8 bit data"
2557 msgstr ""
2558
2559 # type: textblock
2560 #. type: textblock
2561 #: ../src/guestfs.pod:1152
2562 msgid "being in an unexpected character encoding"
2563 msgstr ""
2564
2565 # type: textblock
2566 #. type: textblock
2567 #: ../src/guestfs.pod:1156
2568 msgid "containing homoglyphs."
2569 msgstr ""
2570
2571 # type: =head2
2572 #. type: =head2
2573 #: ../src/guestfs.pod:1160
2574 msgid "SECURITY OF MOUNTING FILESYSTEMS"
2575 msgstr ""
2576
2577 # type: textblock
2578 #. type: textblock
2579 #: ../src/guestfs.pod:1162
2580 msgid ""
2581 "When you mount a filesystem under Linux, mistakes in the kernel filesystem "
2582 "(VFS) module can sometimes be escalated into exploits by deliberately "
2583 "creating a malicious, malformed filesystem.  These exploits are very severe "
2584 "for two reasons.  Firstly there are very many filesystem drivers in the "
2585 "kernel, and many of them are infrequently used and not much developer "
2586 "attention has been paid to the code.  Linux userspace helps potential "
2587 "crackers by detecting the filesystem type and automatically choosing the "
2588 "right VFS driver, even if that filesystem type is obscure or unexpected for "
2589 "the administrator.  Secondly, a kernel-level exploit is like a local root "
2590 "exploit (worse in some ways), giving immediate and total access to the "
2591 "system right down to the hardware level."
2592 msgstr ""
2593
2594 # type: textblock
2595 #. type: textblock
2596 #: ../src/guestfs.pod:1175
2597 msgid ""
2598 "That explains why you should never mount a filesystem from an untrusted "
2599 "guest on your host kernel.  How about libguestfs? We run a Linux kernel "
2600 "inside a qemu virtual machine, usually running as a non-root user.  The "
2601 "attacker would need to write a filesystem which first exploited the kernel, "
2602 "and then exploited either qemu virtualization (eg. a faulty qemu driver) or "
2603 "the libguestfs protocol, and finally to be as serious as the host kernel "
2604 "exploit it would need to escalate its privileges to root.  This multi-step "
2605 "escalation, performed by a static piece of data, is thought to be extremely "
2606 "hard to do, although we never say 'never' about security issues."
2607 msgstr ""
2608
2609 # type: textblock
2610 #. type: textblock
2611 #: ../src/guestfs.pod:1186
2612 msgid ""
2613 "In any case callers can reduce the attack surface by forcing the filesystem "
2614 "type when mounting (use L</guestfs_mount_vfs>)."
2615 msgstr ""
2616
2617 # type: =head2
2618 #. type: =head2
2619 #: ../src/guestfs.pod:1189
2620 msgid "PROTOCOL SECURITY"
2621 msgstr ""
2622
2623 # type: textblock
2624 #. type: textblock
2625 #: ../src/guestfs.pod:1191
2626 msgid ""
2627 "The protocol is designed to be secure, being based on RFC 4506 (XDR)  with a "
2628 "defined upper message size.  However a program that uses libguestfs must "
2629 "also take care - for example you can write a program that downloads a binary "
2630 "from a disk image and executes it locally, and no amount of protocol "
2631 "security will save you from the consequences."
2632 msgstr ""
2633
2634 # type: =head2
2635 #. type: =head2
2636 #: ../src/guestfs.pod:1197
2637 msgid "INSPECTION SECURITY"
2638 msgstr ""
2639
2640 # type: textblock
2641 #. type: textblock
2642 #: ../src/guestfs.pod:1199
2643 msgid ""
2644 "Parts of the inspection API (see L</INSPECTION>) return untrusted strings "
2645 "directly from the guest, and these could contain any 8 bit data.  Callers "
2646 "should be careful to escape these before printing them to a structured file "
2647 "(for example, use HTML escaping if creating a web page)."
2648 msgstr ""
2649
2650 # type: textblock
2651 #. type: textblock
2652 #: ../src/guestfs.pod:1205
2653 msgid ""
2654 "Guest configuration may be altered in unusual ways by the administrator of "
2655 "the virtual machine, and may not reflect reality (particularly for untrusted "
2656 "or actively malicious guests).  For example we parse the hostname from "
2657 "configuration files like C</etc/sysconfig/network> that we find in the "
2658 "guest, but the guest administrator can easily manipulate these files to "
2659 "provide the wrong hostname."
2660 msgstr ""
2661
2662 # type: textblock
2663 #. type: textblock
2664 #: ../src/guestfs.pod:1213
2665 msgid ""
2666 "The inspection API parses guest configuration using two external libraries: "
2667 "Augeas (Linux configuration) and hivex (Windows Registry).  Both are "
2668 "designed to be robust in the face of malicious data, although denial of "
2669 "service attacks are still possible, for example with oversized configuration "
2670 "files."
2671 msgstr ""
2672
2673 # type: =head2
2674 #. type: =head2
2675 #: ../src/guestfs.pod:1219
2676 msgid "RUNNING UNTRUSTED GUEST COMMANDS"
2677 msgstr ""
2678
2679 # type: textblock
2680 #. type: textblock
2681 #: ../src/guestfs.pod:1221
2682 msgid ""
2683 "Be very cautious about running commands from the guest.  By running a "
2684 "command in the guest, you are giving CPU time to a binary that you do not "
2685 "control, under the same user account as the library, albeit wrapped in qemu "
2686 "virtualization.  More information and alternatives can be found in the "
2687 "section L</RUNNING COMMANDS>."
2688 msgstr ""
2689
2690 # type: =head2
2691 #. type: =head2
2692 #: ../src/guestfs.pod:1227
2693 msgid "CVE-2010-3851"
2694 msgstr ""
2695
2696 # type: textblock
2697 #. type: textblock
2698 #: ../src/guestfs.pod:1229
2699 msgid "https://bugzilla.redhat.com/642934"
2700 msgstr ""
2701
2702 # type: textblock
2703 #. type: textblock
2704 #: ../src/guestfs.pod:1231
2705 msgid ""
2706 "This security bug concerns the automatic disk format detection that qemu "
2707 "does on disk images."
2708 msgstr ""
2709
2710 # type: textblock
2711 #. type: textblock
2712 #: ../src/guestfs.pod:1234
2713 msgid ""
2714 "A raw disk image is just the raw bytes, there is no header.  Other disk "
2715 "images like qcow2 contain a special header.  Qemu deals with this by looking "
2716 "for one of the known headers, and if none is found then assuming the disk "
2717 "image must be raw."
2718 msgstr ""
2719
2720 # type: textblock
2721 #. type: textblock
2722 #: ../src/guestfs.pod:1239
2723 msgid ""
2724 "This allows a guest which has been given a raw disk image to write some "
2725 "other header.  At next boot (or when the disk image is accessed by "
2726 "libguestfs) qemu would do autodetection and think the disk image format was, "
2727 "say, qcow2 based on the header written by the guest."
2728 msgstr ""
2729
2730 # type: textblock
2731 #. type: textblock
2732 #: ../src/guestfs.pod:1244
2733 msgid ""
2734 "This in itself would not be a problem, but qcow2 offers many features, one "
2735 "of which is to allow a disk image to refer to another image (called the "
2736 "\"backing disk\").  It does this by placing the path to the backing disk "
2737 "into the qcow2 header.  This path is not validated and could point to any "
2738 "host file (eg. \"/etc/passwd\").  The backing disk is then exposed through "
2739 "\"holes\" in the qcow2 disk image, which of course is completely under the "
2740 "control of the attacker."
2741 msgstr ""
2742
2743 # type: textblock
2744 #. type: textblock
2745 #: ../src/guestfs.pod:1252
2746 msgid ""
2747 "In libguestfs this is rather hard to exploit except under two circumstances:"
2748 msgstr ""
2749
2750 # type: textblock
2751 #. type: textblock
2752 #: ../src/guestfs.pod:1259
2753 msgid "You have enabled the network or have opened the disk in write mode."
2754 msgstr ""
2755
2756 # type: textblock
2757 #. type: textblock
2758 #: ../src/guestfs.pod:1263
2759 msgid ""
2760 "You are also running untrusted code from the guest (see L</RUNNING "
2761 "COMMANDS>)."
2762 msgstr ""
2763
2764 # type: textblock
2765 #. type: textblock
2766 #: ../src/guestfs.pod:1268
2767 msgid ""
2768 "The way to avoid this is to specify the expected disk format when adding "
2769 "disks (the optional C<format> option to L</guestfs_add_drive_opts>).  You "
2770 "should always do this if the disk is raw format, and it's a good idea for "
2771 "other cases too."
2772 msgstr ""
2773
2774 # type: textblock
2775 #. type: textblock
2776 #: ../src/guestfs.pod:1273
2777 msgid ""
2778 "For disks added from libvirt using calls like L</guestfs_add_domain>, the "
2779 "format is fetched from libvirt and passed through."
2780 msgstr ""
2781
2782 # type: textblock
2783 #. type: textblock
2784 #: ../src/guestfs.pod:1276
2785 msgid ""
2786 "For libguestfs tools, use the I<--format> command line parameter as "
2787 "appropriate."
2788 msgstr ""
2789
2790 # type: =head1
2791 #. type: =head1
2792 #: ../src/guestfs.pod:1279
2793 msgid "CONNECTION MANAGEMENT"
2794 msgstr ""
2795
2796 # type: =head2
2797 #. type: =head2
2798 #: ../src/guestfs.pod:1281
2799 msgid "guestfs_h *"
2800 msgstr ""
2801
2802 # type: textblock
2803 #. type: textblock
2804 #: ../src/guestfs.pod:1283
2805 msgid ""
2806 "C<guestfs_h> is the opaque type representing a connection handle.  Create a "
2807 "handle by calling L</guestfs_create>.  Call L</guestfs_close> to free the "
2808 "handle and release all resources used."
2809 msgstr ""
2810
2811 #. type: textblock
2812 #: ../src/guestfs.pod:1287
2813 msgid ""
2814 "For information on using multiple handles and threads, see the section L</"
2815 "MULTIPLE HANDLES AND MULTIPLE THREADS> above."
2816 msgstr ""
2817
2818 # type: =head2
2819 #. type: =head2
2820 #: ../src/guestfs.pod:1290
2821 msgid "guestfs_create"
2822 msgstr ""
2823
2824 # type: verbatim
2825 #. type: verbatim
2826 #: ../src/guestfs.pod:1292
2827 #, no-wrap
2828 msgid ""
2829 " guestfs_h *guestfs_create (void);\n"
2830 "\n"
2831 msgstr ""
2832
2833 # type: textblock
2834 #. type: textblock
2835 #: ../src/guestfs.pod:1294
2836 msgid "Create a connection handle."
2837 msgstr ""
2838
2839 #. type: textblock
2840 #: ../src/guestfs.pod:1296
2841 msgid ""
2842 "On success this returns a non-NULL pointer to a handle.  On error it returns "
2843 "NULL."
2844 msgstr ""
2845
2846 #. type: textblock
2847 #: ../src/guestfs.pod:1299
2848 msgid ""
2849 "You have to \"configure\" the handle after creating it.  This includes "
2850 "calling L</guestfs_add_drive_opts> (or one of the equivalent calls) on the "
2851 "handle at least once."
2852 msgstr ""
2853
2854 # type: textblock
2855 #. type: textblock
2856 #: ../src/guestfs.pod:1303
2857 msgid "After configuring the handle, you have to call L</guestfs_launch>."
2858 msgstr ""
2859
2860 #. type: textblock
2861 #: ../src/guestfs.pod:1305
2862 msgid ""
2863 "You may also want to configure error handling for the handle.  See the L</"
2864 "ERROR HANDLING> section below."
2865 msgstr ""
2866
2867 # type: =head2
2868 #. type: =head2
2869 #: ../src/guestfs.pod:1308
2870 msgid "guestfs_close"
2871 msgstr ""
2872
2873 # type: verbatim
2874 #. type: verbatim
2875 #: ../src/guestfs.pod:1310
2876 #, no-wrap
2877 msgid ""
2878 " void guestfs_close (guestfs_h *g);\n"
2879 "\n"
2880 msgstr ""
2881
2882 # type: textblock
2883 #. type: textblock
2884 #: ../src/guestfs.pod:1312
2885 msgid "This closes the connection handle and frees up all resources used."
2886 msgstr ""
2887
2888 #. type: textblock
2889 #: ../src/guestfs.pod:1314
2890 msgid ""
2891 "If autosync was set on the handle and the handle was launched, then this "
2892 "implicitly calls various functions to unmount filesystems and sync the "
2893 "disk.  See L</guestfs_set_autosync> for more details."
2894 msgstr ""
2895
2896 #. type: textblock
2897 #: ../src/guestfs.pod:1318
2898 msgid "If a close callback was set on the handle, then it is called."
2899 msgstr ""
2900
2901 # type: =head1
2902 #. type: =head1
2903 #: ../src/guestfs.pod:1320
2904 msgid "ERROR HANDLING"
2905 msgstr ""
2906
2907 # type: textblock
2908 #. type: textblock
2909 #: ../src/guestfs.pod:1322
2910 msgid ""
2911 "API functions can return errors.  For example, almost all functions that "
2912 "return C<int> will return C<-1> to indicate an error."
2913 msgstr ""
2914
2915 # type: textblock
2916 #. type: textblock
2917 #: ../src/guestfs.pod:1325
2918 msgid ""
2919 "Additional information is available for errors: an error message string and "
2920 "optionally an error number (errno) if the thing that failed was a system "
2921 "call."
2922 msgstr ""
2923
2924 # type: textblock
2925 #. type: textblock
2926 #: ../src/guestfs.pod:1329
2927 msgid ""
2928 "You can get at the additional information about the last error on the handle "
2929 "by calling L</guestfs_last_error>, L</guestfs_last_errno>, and/or by setting "
2930 "up an error handler with L</guestfs_set_error_handler>."
2931 msgstr ""
2932
2933 # type: textblock
2934 #. type: textblock
2935 #: ../src/guestfs.pod:1334
2936 msgid ""
2937 "When the handle is created, a default error handler is installed which "
2938 "prints the error message string to C<stderr>.  For small short-running "
2939 "command line programs it is sufficient to do:"
2940 msgstr ""
2941
2942 # type: verbatim
2943 #. type: verbatim
2944 #: ../src/guestfs.pod:1338
2945 #, no-wrap
2946 msgid ""
2947 " if (guestfs_launch (g) == -1)\n"
2948 "   exit (EXIT_FAILURE);\n"
2949 "\n"
2950 msgstr ""
2951
2952 # type: textblock
2953 #. type: textblock
2954 #: ../src/guestfs.pod:1341
2955 msgid ""
2956 "since the default error handler will ensure that an error message has been "
2957 "printed to C<stderr> before the program exits."
2958 msgstr ""
2959
2960 # type: textblock
2961 #. type: textblock
2962 #: ../src/guestfs.pod:1344
2963 msgid ""
2964 "For other programs the caller will almost certainly want to install an "
2965 "alternate error handler or do error handling in-line like this:"
2966 msgstr ""
2967
2968 # type: verbatim
2969 #. type: verbatim
2970 #: ../src/guestfs.pod:1347
2971 #, no-wrap
2972 msgid ""
2973 " g = guestfs_create ();\n"
2974 " \n"
2975 msgstr ""
2976
2977 # type: verbatim
2978 #. type: verbatim
2979 #: ../src/guestfs.pod:1349
2980 #, no-wrap
2981 msgid ""
2982 " /* This disables the default behaviour of printing errors\n"
2983 "    on stderr. */\n"
2984 " guestfs_set_error_handler (g, NULL, NULL);\n"
2985 " \n"
2986 msgstr ""
2987
2988 # type: verbatim
2989 #. type: verbatim
2990 #: ../src/guestfs.pod:1353
2991 #, no-wrap
2992 msgid ""
2993 " if (guestfs_launch (g) == -1) {\n"
2994 "   /* Examine the error message and print it etc. */\n"
2995 "   char *msg = guestfs_last_error (g);\n"
2996 "   int errnum = guestfs_last_errno (g);\n"
2997 "   fprintf (stderr, \"%s\\n\", msg);\n"
2998 "   /* ... */\n"
2999 "  }\n"
3000 "\n"
3001 msgstr ""
3002
3003 # type: textblock
3004 #. type: textblock
3005 #: ../src/guestfs.pod:1361
3006 msgid ""
3007 "Out of memory errors are handled differently.  The default action is to call "
3008 "L<abort(3)>.  If this is undesirable, then you can set a handler using L</"
3009 "guestfs_set_out_of_memory_handler>."
3010 msgstr ""
3011
3012 # type: textblock
3013 #. type: textblock
3014 #: ../src/guestfs.pod:1365
3015 msgid ""
3016 "L</guestfs_create> returns C<NULL> if the handle cannot be created, and "
3017 "because there is no handle if this happens there is no way to get additional "
3018 "error information.  However L</guestfs_create> is supposed to be a "
3019 "lightweight operation which can only fail because of insufficient memory (it "
3020 "returns NULL in this case)."
3021 msgstr ""
3022
3023 # type: =head2
3024 #. type: =head2
3025 #: ../src/guestfs.pod:1371
3026 msgid "guestfs_last_error"
3027 msgstr ""
3028
3029 # type: verbatim
3030 #. type: verbatim
3031 #: ../src/guestfs.pod:1373
3032 #, no-wrap
3033 msgid ""
3034 " const char *guestfs_last_error (guestfs_h *g);\n"
3035 "\n"
3036 msgstr ""
3037
3038 # type: textblock
3039 #. type: textblock
3040 #: ../src/guestfs.pod:1375
3041 msgid ""
3042 "This returns the last error message that happened on C<g>.  If there has not "
3043 "been an error since the handle was created, then this returns C<NULL>."
3044 msgstr ""
3045
3046 # type: textblock
3047 #. type: textblock
3048 #: ../src/guestfs.pod:1379
3049 msgid ""
3050 "The lifetime of the returned string is until the next error occurs, or L</"
3051 "guestfs_close> is called."
3052 msgstr ""
3053
3054 # type: =head2
3055 #. type: =head2
3056 #: ../src/guestfs.pod:1382
3057 msgid "guestfs_last_errno"
3058 msgstr ""
3059
3060 # type: verbatim
3061 #. type: verbatim
3062 #: ../src/guestfs.pod:1384
3063 #, no-wrap
3064 msgid ""
3065 " int guestfs_last_errno (guestfs_h *g);\n"
3066 "\n"
3067 msgstr ""
3068
3069 # type: textblock
3070 #. type: textblock
3071 #: ../src/guestfs.pod:1386
3072 msgid "This returns the last error number (errno) that happened on C<g>."
3073 msgstr ""
3074
3075 # type: textblock
3076 #. type: textblock
3077 #: ../src/guestfs.pod:1388
3078 msgid "If successful, an errno integer not equal to zero is returned."
3079 msgstr ""
3080
3081 # type: textblock
3082 #. type: textblock
3083 #: ../src/guestfs.pod:1390
3084 msgid ""
3085 "If no error, this returns 0.  This call can return 0 in three situations:"
3086 msgstr ""
3087
3088 # type: textblock
3089 #. type: textblock
3090 #: ../src/guestfs.pod:1397
3091 msgid "There has not been any error on the handle."
3092 msgstr ""
3093
3094 # type: textblock
3095 #. type: textblock
3096 #: ../src/guestfs.pod:1401
3097 msgid ""
3098 "There has been an error but the errno was meaningless.  This corresponds to "
3099 "the case where the error did not come from a failed system call, but for "
3100 "some other reason."
3101 msgstr ""
3102
3103 # type: textblock
3104 #. type: textblock
3105 #: ../src/guestfs.pod:1407
3106 msgid ""
3107 "There was an error from a failed system call, but for some reason the errno "
3108 "was not captured and returned.  This usually indicates a bug in libguestfs."
3109 msgstr ""
3110
3111 # type: textblock
3112 #. type: textblock
3113 #: ../src/guestfs.pod:1413
3114 msgid ""
3115 "Libguestfs tries to convert the errno from inside the applicance into a "
3116 "corresponding errno for the caller (not entirely trivial: the appliance "
3117 "might be running a completely different operating system from the library "
3118 "and error numbers are not standardized across Un*xen).  If this could not be "
3119 "done, then the error is translated to C<EINVAL>.  In practice this should "
3120 "only happen in very rare circumstances."
3121 msgstr ""
3122
3123 # type: =head2
3124 #. type: =head2
3125 #: ../src/guestfs.pod:1421
3126 msgid "guestfs_set_error_handler"
3127 msgstr ""
3128
3129 # type: verbatim
3130 #. type: verbatim
3131 #: ../src/guestfs.pod:1423
3132 #, no-wrap
3133 msgid ""
3134 " typedef void (*guestfs_error_handler_cb) (guestfs_h *g,\n"
3135 "                                           void *opaque,\n"
3136 "                                           const char *msg);\n"
3137 " void guestfs_set_error_handler (guestfs_h *g,\n"
3138 "                                 guestfs_error_handler_cb cb,\n"
3139 "                                 void *opaque);\n"
3140 "\n"
3141 msgstr ""
3142
3143 # type: textblock
3144 #. type: textblock
3145 #: ../src/guestfs.pod:1430
3146 msgid ""
3147 "The callback C<cb> will be called if there is an error.  The parameters "
3148 "passed to the callback are an opaque data pointer and the error message "
3149 "string."
3150 msgstr ""
3151
3152 # type: textblock
3153 #. type: textblock
3154 #: ../src/guestfs.pod:1434
3155 msgid ""
3156 "C<errno> is not passed to the callback.  To get that the callback must call "
3157 "L</guestfs_last_errno>."
3158 msgstr ""
3159
3160 # type: textblock
3161 #. type: textblock
3162 #: ../src/guestfs.pod:1437
3163 msgid ""
3164 "Note that the message string C<msg> is freed as soon as the callback "
3165 "function returns, so if you want to stash it somewhere you must make your "
3166 "own copy."
3167 msgstr ""
3168
3169 # type: textblock
3170 #. type: textblock
3171 #: ../src/guestfs.pod:1441
3172 msgid "The default handler prints messages on C<stderr>."
3173 msgstr ""
3174
3175 # type: textblock
3176 #. type: textblock
3177 #: ../src/guestfs.pod:1443
3178 msgid "If you set C<cb> to C<NULL> then I<no> handler is called."
3179 msgstr ""
3180
3181 # type: =head2
3182 #. type: =head2
3183 #: ../src/guestfs.pod:1445
3184 msgid "guestfs_get_error_handler"
3185 msgstr ""
3186
3187 # type: verbatim
3188 #. type: verbatim
3189 #: ../src/guestfs.pod:1447
3190 #, no-wrap
3191 msgid ""
3192 " guestfs_error_handler_cb guestfs_get_error_handler (guestfs_h *g,\n"
3193 "                                                     void **opaque_rtn);\n"
3194 "\n"
3195 msgstr ""
3196
3197 # type: textblock
3198 #. type: textblock
3199 #: ../src/guestfs.pod:1450
3200 msgid "Returns the current error handler callback."
3201 msgstr ""
3202
3203 # type: =head2
3204 #. type: =head2
3205 #: ../src/guestfs.pod:1452
3206 msgid "guestfs_set_out_of_memory_handler"
3207 msgstr ""
3208
3209 #. type: verbatim
3210 #: ../src/guestfs.pod:1454
3211 #, no-wrap
3212 msgid ""
3213 " typedef void (*guestfs_abort_cb) (void);\n"
3214 " void guestfs_set_out_of_memory_handler (guestfs_h *g,\n"
3215 "                                         guestfs_abort_cb);\n"
3216 "\n"
3217 msgstr ""
3218
3219 # type: textblock
3220 #. type: textblock
3221 #: ../src/guestfs.pod:1458
3222 msgid ""
3223 "The callback C<cb> will be called if there is an out of memory situation.  "
3224 "I<Note this callback must not return>."
3225 msgstr ""
3226
3227 # type: textblock
3228 #. type: textblock
3229 #: ../src/guestfs.pod:1461
3230 msgid "The default is to call L<abort(3)>."
3231 msgstr ""
3232
3233 # type: textblock
3234 #. type: textblock
3235 #: ../src/guestfs.pod:1463
3236 msgid ""
3237 "You cannot set C<cb> to C<NULL>.  You can't ignore out of memory situations."
3238 msgstr ""
3239
3240 # type: =head2
3241 #. type: =head2
3242 #: ../src/guestfs.pod:1466
3243 msgid "guestfs_get_out_of_memory_handler"
3244 msgstr ""
3245
3246 # type: verbatim
3247 #. type: verbatim
3248 #: ../src/guestfs.pod:1468
3249 #, no-wrap
3250 msgid ""
3251 " guestfs_abort_fn guestfs_get_out_of_memory_handler (guestfs_h *g);\n"
3252 "\n"
3253 msgstr ""
3254
3255 # type: textblock
3256 #. type: textblock
3257 #: ../src/guestfs.pod:1470
3258 msgid "This returns the current out of memory handler."
3259 msgstr ""
3260
3261 # type: =head1
3262 #. type: =head1
3263 #: ../src/guestfs.pod:1472
3264 msgid "API CALLS"
3265 msgstr ""
3266
3267 # type: textblock
3268 #. type: textblock
3269 #: ../src/guestfs.pod:1474 ../fish/guestfish.pod:1019
3270 msgid "@ACTIONS@"
3271 msgstr ""
3272
3273 # type: =head1
3274 #. type: =head1
3275 #: ../src/guestfs.pod:1476
3276 msgid "STRUCTURES"
3277 msgstr ""
3278
3279 # type: textblock
3280 #. type: textblock
3281 #: ../src/guestfs.pod:1478
3282 msgid "@STRUCTS@"
3283 msgstr ""
3284
3285 # type: =head1
3286 #. type: =head1
3287 #: ../src/guestfs.pod:1480
3288 msgid "AVAILABILITY"
3289 msgstr ""
3290
3291 # type: =head2
3292 #. type: =head2
3293 #: ../src/guestfs.pod:1482
3294 msgid "GROUPS OF FUNCTIONALITY IN THE APPLIANCE"
3295 msgstr ""
3296
3297 # type: textblock
3298 #. type: textblock
3299 #: ../src/guestfs.pod:1484
3300 msgid ""
3301 "Using L</guestfs_available> you can test availability of the following "
3302 "groups of functions.  This test queries the appliance to see if the "
3303 "appliance you are currently using supports the functionality."
3304 msgstr ""
3305
3306 # type: textblock
3307 #. type: textblock
3308 #: ../src/guestfs.pod:1489
3309 msgid "@AVAILABILITY@"
3310 msgstr ""
3311
3312 # type: =head2
3313 #. type: =head2
3314 #: ../src/guestfs.pod:1491
3315 msgid "GUESTFISH supported COMMAND"
3316 msgstr ""
3317
3318 # type: textblock
3319 #. type: textblock
3320 #: ../src/guestfs.pod:1493
3321 msgid ""
3322 "In L<guestfish(3)> there is a handy interactive command C<supported> which "
3323 "prints out the available groups and whether they are supported by this build "
3324 "of libguestfs.  Note however that you have to do C<run> first."
3325 msgstr ""
3326
3327 # type: =head2
3328 #. type: =head2
3329 #: ../src/guestfs.pod:1498
3330 msgid "SINGLE CALLS AT COMPILE TIME"
3331 msgstr ""
3332
3333 # type: textblock
3334 #. type: textblock
3335 #: ../src/guestfs.pod:1500
3336 msgid ""
3337 "Since version 1.5.8, C<E<lt>guestfs.hE<gt>> defines symbols for each C API "
3338 "function, such as:"
3339 msgstr ""
3340
3341 # type: verbatim
3342 #. type: verbatim
3343 #: ../src/guestfs.pod:1503
3344 #, no-wrap
3345 msgid ""
3346 " #define LIBGUESTFS_HAVE_DD 1\n"
3347 "\n"
3348 msgstr ""
3349
3350 # type: textblock
3351 #. type: textblock
3352 #: ../src/guestfs.pod:1505
3353 msgid "if L</guestfs_dd> is available."
3354 msgstr ""
3355
3356 # type: textblock
3357 #. type: textblock
3358 #: ../src/guestfs.pod:1507
3359 msgid ""
3360 "Before version 1.5.8, if you needed to test whether a single libguestfs "
3361 "function is available at compile time, we recommended using build tools such "
3362 "as autoconf or cmake.  For example in autotools you could use:"
3363 msgstr ""
3364
3365 # type: verbatim
3366 #. type: verbatim
3367 #: ../src/guestfs.pod:1512
3368 #, no-wrap
3369 msgid ""
3370 " AC_CHECK_LIB([guestfs],[guestfs_create])\n"
3371 " AC_CHECK_FUNCS([guestfs_dd])\n"
3372 "\n"
3373 msgstr ""
3374
3375 # type: textblock
3376 #. type: textblock
3377 #: ../src/guestfs.pod:1515
3378 msgid ""
3379 "which would result in C<HAVE_GUESTFS_DD> being either defined or not defined "
3380 "in your program."
3381 msgstr ""
3382
3383 # type: =head2
3384 #. type: =head2
3385 #: ../src/guestfs.pod:1518
3386 msgid "SINGLE CALLS AT RUN TIME"
3387 msgstr ""
3388
3389 # type: textblock
3390 #. type: textblock
3391 #: ../src/guestfs.pod:1520
3392 msgid ""
3393 "Testing at compile time doesn't guarantee that a function really exists in "
3394 "the library.  The reason is that you might be dynamically linked against a "
3395 "previous I<libguestfs.so> (dynamic library)  which doesn't have the call.  "
3396 "This situation unfortunately results in a segmentation fault, which is a "
3397 "shortcoming of the C dynamic linking system itself."
3398 msgstr ""
3399
3400 # type: textblock
3401 #. type: textblock
3402 #: ../src/guestfs.pod:1527
3403 msgid ""
3404 "You can use L<dlopen(3)> to test if a function is available at run time, as "
3405 "in this example program (note that you still need the compile time check as "
3406 "well):"
3407 msgstr ""
3408
3409 # type: verbatim
3410 #. type: verbatim
3411 #: ../src/guestfs.pod:1531
3412 #, no-wrap
3413 msgid ""
3414 " #include <stdio.h>\n"
3415 " #include <stdlib.h>\n"
3416 " #include <unistd.h>\n"
3417 " #include <dlfcn.h>\n"
3418 " #include <guestfs.h>\n"
3419 " \n"
3420 msgstr ""
3421
3422 # type: verbatim
3423 #. type: verbatim
3424 #: ../src/guestfs.pod:1537
3425 #, no-wrap
3426 msgid ""
3427 " main ()\n"
3428 " {\n"
3429 " #ifdef LIBGUESTFS_HAVE_DD\n"
3430 "   void *dl;\n"
3431 "   int has_function;\n"
3432 " \n"
3433 msgstr ""
3434
3435 # type: verbatim
3436 #. type: verbatim
3437 #: ../src/guestfs.pod:1543
3438 #, no-wrap
3439 msgid ""
3440 "   /* Test if the function guestfs_dd is really available. */\n"
3441 "   dl = dlopen (NULL, RTLD_LAZY);\n"
3442 "   if (!dl) {\n"
3443 "     fprintf (stderr, \"dlopen: %s\\n\", dlerror ());\n"
3444 "     exit (EXIT_FAILURE);\n"
3445 "   }\n"
3446 "   has_function = dlsym (dl, \"guestfs_dd\") != NULL;\n"
3447 "   dlclose (dl);\n"
3448 " \n"
3449 msgstr ""
3450
3451 # type: verbatim
3452 #. type: verbatim
3453 #: ../src/guestfs.pod:1552
3454 #, no-wrap
3455 msgid ""
3456 "   if (!has_function)\n"
3457 "     printf (\"this libguestfs.so does NOT have guestfs_dd function\\n\");\n"
3458 "   else {\n"
3459 "     printf (\"this libguestfs.so has guestfs_dd function\\n\");\n"
3460 "     /* Now it's safe to call\n"
3461 "     guestfs_dd (g, \"foo\", \"bar\");\n"
3462 "     */\n"
3463 "   }\n"
3464 " #else\n"
3465 "   printf (\"guestfs_dd function was not found at compile time\\n\");\n"
3466 " #endif\n"
3467 "  }\n"
3468 "\n"
3469 msgstr ""
3470
3471 # type: textblock
3472 #. type: textblock
3473 #: ../src/guestfs.pod:1565
3474 msgid ""
3475 "You may think the above is an awful lot of hassle, and it is.  There are "
3476 "other ways outside of the C linking system to ensure that this kind of "
3477 "incompatibility never arises, such as using package versioning:"
3478 msgstr ""
3479
3480 # type: verbatim
3481 #. type: verbatim
3482 #: ../src/guestfs.pod:1570
3483 #, no-wrap
3484 msgid ""
3485 " Requires: libguestfs >= 1.0.80\n"
3486 "\n"
3487 msgstr ""
3488
3489 # type: =head1
3490 #. type: =head1
3491 #: ../src/guestfs.pod:1572
3492 msgid "CALLS WITH OPTIONAL ARGUMENTS"
3493 msgstr ""
3494
3495 # type: textblock
3496 #. type: textblock
3497 #: ../src/guestfs.pod:1574
3498 msgid ""
3499 "A recent feature of the API is the introduction of calls which take optional "
3500 "arguments.  In C these are declared 3 ways.  The main way is as a call which "
3501 "takes variable arguments (ie. C<...>), as in this example:"
3502 msgstr ""
3503
3504 # type: verbatim
3505 #. type: verbatim
3506 #: ../src/guestfs.pod:1579
3507 #, no-wrap
3508 msgid ""
3509 " int guestfs_add_drive_opts (guestfs_h *g, const char *filename, ...);\n"
3510 "\n"
3511 msgstr ""
3512
3513 # type: textblock
3514 #. type: textblock
3515 #: ../src/guestfs.pod:1581
3516 msgid ""
3517 "Call this with a list of optional arguments, terminated by C<-1>.  So to "
3518 "call with no optional arguments specified:"
3519 msgstr ""
3520
3521 # type: verbatim
3522 #. type: verbatim
3523 #: ../src/guestfs.pod:1584
3524 #, no-wrap
3525 msgid ""
3526 " guestfs_add_drive_opts (g, filename, -1);\n"
3527 "\n"
3528 msgstr ""
3529
3530 # type: textblock
3531 #. type: textblock
3532 #: ../src/guestfs.pod:1586
3533 msgid "With a single optional argument:"
3534 msgstr ""
3535
3536 # type: verbatim
3537 #. type: verbatim
3538 #: ../src/guestfs.pod:1588
3539 #, no-wrap
3540 msgid ""
3541 " guestfs_add_drive_opts (g, filename,\n"
3542 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"qcow2\",\n"
3543 "                         -1);\n"
3544 "\n"
3545 msgstr ""
3546
3547 # type: textblock
3548 #. type: textblock
3549 #: ../src/guestfs.pod:1592
3550 msgid "With two:"
3551 msgstr ""
3552
3553 # type: verbatim
3554 #. type: verbatim
3555 #: ../src/guestfs.pod:1594
3556 #, no-wrap
3557 msgid ""
3558 " guestfs_add_drive_opts (g, filename,\n"
3559 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"qcow2\",\n"
3560 "                         GUESTFS_ADD_DRIVE_OPTS_READONLY, 1,\n"
3561 "                         -1);\n"
3562 "\n"
3563 msgstr ""
3564
3565 # type: textblock
3566 #. type: textblock
3567 #: ../src/guestfs.pod:1599
3568 msgid ""
3569 "and so forth.  Don't forget the terminating C<-1> otherwise Bad Things will "
3570 "happen!"
3571 msgstr ""
3572
3573 # type: =head2
3574 #. type: =head2
3575 #: ../src/guestfs.pod:1602
3576 msgid "USING va_list FOR OPTIONAL ARGUMENTS"
3577 msgstr ""
3578
3579 # type: textblock
3580 #. type: textblock
3581 #: ../src/guestfs.pod:1604
3582 msgid ""
3583 "The second variant has the same name with the suffix C<_va>, which works the "
3584 "same way but takes a C<va_list>.  See the C manual for details.  For the "
3585 "example function, this is declared:"
3586 msgstr ""
3587
3588 # type: verbatim
3589 #. type: verbatim
3590 #: ../src/guestfs.pod:1608
3591 #, no-wrap
3592 msgid ""
3593 " int guestfs_add_drive_opts_va (guestfs_h *g, const char *filename,\n"
3594 "                                va_list args);\n"
3595 "\n"
3596 msgstr ""
3597
3598 # type: =head2
3599 #. type: =head2
3600 #: ../src/guestfs.pod:1611
3601 msgid "CONSTRUCTING OPTIONAL ARGUMENTS"
3602 msgstr ""
3603
3604 # type: textblock
3605 #. type: textblock
3606 #: ../src/guestfs.pod:1613
3607 msgid ""
3608 "The third variant is useful where you need to construct these calls.  You "
3609 "pass in a structure where you fill in the optional fields.  The structure "
3610 "has a bitmask as the first element which you must set to indicate which "
3611 "fields you have filled in.  For our example function the structure and call "
3612 "are declared:"
3613 msgstr ""
3614
3615 # type: verbatim
3616 #. type: verbatim
3617 #: ../src/guestfs.pod:1619
3618 #, no-wrap
3619 msgid ""
3620 " struct guestfs_add_drive_opts_argv {\n"
3621 "   uint64_t bitmask;\n"
3622 "   int readonly;\n"
3623 "   const char *format;\n"
3624 "   /* ... */\n"
3625 " };\n"
3626 " int guestfs_add_drive_opts_argv (guestfs_h *g, const char *filename,\n"
3627 "              const struct guestfs_add_drive_opts_argv *optargs);\n"
3628 "\n"
3629 msgstr ""
3630
3631 # type: textblock
3632 #. type: textblock
3633 #: ../src/guestfs.pod:1628
3634 msgid "You could call it like this:"
3635 msgstr ""
3636
3637 # type: verbatim
3638 #. type: verbatim
3639 #: ../src/guestfs.pod:1630
3640 #, no-wrap
3641 msgid ""
3642 " struct guestfs_add_drive_opts_argv optargs = {\n"
3643 "   .bitmask = GUESTFS_ADD_DRIVE_OPTS_READONLY_BITMASK |\n"
3644 "              GUESTFS_ADD_DRIVE_OPTS_FORMAT_BITMASK,\n"
3645 "   .readonly = 1,\n"
3646 "   .format = \"qcow2\"\n"
3647 " };\n"
3648 " \n"
3649 msgstr ""
3650
3651 # type: verbatim
3652 #. type: verbatim
3653 #: ../src/guestfs.pod:1637
3654 #, no-wrap
3655 msgid ""
3656 " guestfs_add_drive_opts_argv (g, filename, &optargs);\n"
3657 "\n"
3658 msgstr ""
3659
3660 # type: textblock
3661 #. type: textblock
3662 #: ../src/guestfs.pod:1639 ../src/guestfs-actions.pod:11
3663 #: ../src/guestfs-actions.pod:1857 ../src/guestfs-actions.pod:2257
3664 #: ../fish/guestfish-actions.pod:9 ../fish/guestfish-actions.pod:1262
3665 #: ../fish/guestfish-actions.pod:1515 ../tools/virt-win-reg.pl:532
3666 msgid "Notes:"
3667 msgstr ""
3668
3669 # type: textblock
3670 #. type: textblock
3671 #: ../src/guestfs.pod:1645
3672 msgid "The C<_BITMASK> suffix on each option name when specifying the bitmask."
3673 msgstr ""
3674
3675 # type: textblock
3676 #. type: textblock
3677 #: ../src/guestfs.pod:1650
3678 msgid "You do not need to fill in all fields of the structure."
3679 msgstr ""
3680
3681 # type: textblock
3682 #. type: textblock
3683 #: ../src/guestfs.pod:1654
3684 msgid ""
3685 "There must be a one-to-one correspondence between fields of the structure "
3686 "that are filled in, and bits set in the bitmask."
3687 msgstr ""
3688
3689 # type: =head2
3690 #. type: =head2
3691 #: ../src/guestfs.pod:1659
3692 msgid "OPTIONAL ARGUMENTS IN OTHER LANGUAGES"
3693 msgstr ""
3694
3695 # type: textblock
3696 #. type: textblock
3697 #: ../src/guestfs.pod:1661
3698 msgid ""
3699 "In other languages, optional arguments are expressed in the way that is "
3700 "natural for that language.  We refer you to the language-specific "
3701 "documentation for more details on that."
3702 msgstr ""
3703
3704 # type: textblock
3705 #. type: textblock
3706 #: ../src/guestfs.pod:1665
3707 msgid "For guestfish, see L<guestfish(1)/OPTIONAL ARGUMENTS>."
3708 msgstr ""
3709
3710 # type: =head2
3711 #. type: =head2
3712 #: ../src/guestfs.pod:1667
3713 msgid "SETTING CALLBACKS TO HANDLE EVENTS"
3714 msgstr ""
3715
3716 #. type: textblock
3717 #: ../src/guestfs.pod:1669
3718 msgid ""
3719 "B<Note:> This section documents the generic event mechanism introduced in "
3720 "libguestfs 1.10, which you should use in new code if possible.  The old "
3721 "functions C<guestfs_set_log_message_callback>, "
3722 "C<guestfs_set_subprocess_quit_callback>, "
3723 "C<guestfs_set_launch_done_callback>, C<guestfs_set_close_callback> and "
3724 "C<guestfs_set_progress_callback> are no longer documented in this manual "
3725 "page."
3726 msgstr ""
3727
3728 #. type: textblock
3729 #: ../src/guestfs.pod:1677
3730 msgid ""
3731 "Handles generate events when certain things happen, such as log messages "
3732 "being generated, progress messages during long-running operations, or the "
3733 "handle being closed.  The API calls described below let you register a "
3734 "callback to be called when events happen.  You can register multiple "
3735 "callbacks (for the same, different or overlapping sets of events), and "
3736 "individually remove callbacks.  If callbacks are not removed, then they "
3737 "remain in force until the handle is closed."
3738 msgstr ""
3739
3740 #. type: textblock
3741 #: ../src/guestfs.pod:1685
3742 msgid ""
3743 "In the current implementation, events are only generated synchronously: that "
3744 "means that events (and hence callbacks) can only happen while you are in the "
3745 "middle of making another libguestfs call.  The callback is called in the "
3746 "same thread."
3747 msgstr ""
3748
3749 #. type: textblock
3750 #: ../src/guestfs.pod:1690
3751 msgid ""
3752 "Events may contain a payload, usually nothing (void), an array of 64 bit "
3753 "unsigned integers, or a message buffer.  Payloads are discussed later on."
3754 msgstr ""
3755
3756 #. type: =head3
3757 #: ../src/guestfs.pod:1694
3758 msgid "CLASSES OF EVENTS"
3759 msgstr ""
3760
3761 #. type: =item
3762 #: ../src/guestfs.pod:1698
3763 msgid "GUESTFS_EVENT_CLOSE (payload type: void)"
3764 msgstr ""
3765
3766 #. type: textblock
3767 #: ../src/guestfs.pod:1701
3768 msgid ""
3769 "The callback function will be called while the handle is being closed "
3770 "(synchronously from L</guestfs_close>)."
3771 msgstr ""
3772
3773 # type: textblock
3774 #. type: textblock
3775 #: ../src/guestfs.pod:1704
3776 msgid ""
3777 "Note that libguestfs installs an L<atexit(3)> handler to try to clean up "
3778 "handles that are open when the program exits.  This means that this callback "
3779 "might be called indirectly from L<exit(3)>, which can cause unexpected "
3780 "problems in higher-level languages (eg. if your HLL interpreter has already "
3781 "been cleaned up by the time this is called, and if your callback then jumps "
3782 "into some HLL function)."
3783 msgstr ""
3784
3785 #. type: textblock
3786 #: ../src/guestfs.pod:1711
3787 msgid ""
3788 "If no callback is registered: the handle is closed without any callback "
3789 "being invoked."
3790 msgstr ""
3791
3792 #. type: =item
3793 #: ../src/guestfs.pod:1714
3794 msgid "GUESTFS_EVENT_SUBPROCESS_QUIT (payload type: void)"
3795 msgstr ""
3796
3797 #. type: textblock
3798 #: ../src/guestfs.pod:1717
3799 msgid ""
3800 "The callback function will be called when the child process quits, either "
3801 "asynchronously or if killed by L</guestfs_kill_subprocess>.  (This "
3802 "corresponds to a transition from any state to the CONFIG state)."
3803 msgstr ""
3804
3805 #. type: textblock
3806 #: ../src/guestfs.pod:1721 ../src/guestfs.pod:1730
3807 msgid "If no callback is registered: the event is ignored."
3808 msgstr ""
3809
3810 #. type: =item
3811 #: ../src/guestfs.pod:1723
3812 msgid "GUESTFS_EVENT_LAUNCH_DONE (payload type: void)"
3813 msgstr ""
3814
3815 #. type: textblock
3816 #: ../src/guestfs.pod:1726
3817 msgid ""
3818 "The callback function will be called when the child process becomes ready "
3819 "first time after it has been launched.  (This corresponds to a transition "
3820 "from LAUNCHING to the READY state)."
3821 msgstr ""
3822
3823 #. type: =item
3824 #: ../src/guestfs.pod:1732
3825 msgid "GUESTFS_EVENT_PROGRESS (payload type: array of 4 x uint64_t)"
3826 msgstr ""
3827
3828 # type: textblock
3829 #. type: textblock
3830 #: ../src/guestfs.pod:1735
3831 msgid ""
3832 "Some long-running operations can generate progress messages.  If this "
3833 "callback is registered, then it will be called each time a progress message "
3834 "is generated (usually two seconds after the operation started, and three "
3835 "times per second thereafter until it completes, although the frequency may "
3836 "change in future versions)."
3837 msgstr ""
3838
3839 #. type: textblock
3840 #: ../src/guestfs.pod:1741
3841 msgid ""
3842 "The callback receives in the payload four unsigned 64 bit numbers which are "
3843 "(in order): C<proc_nr>, C<serial>, C<position>, C<total>."
3844 msgstr ""
3845
3846 #. type: textblock
3847 #: ../src/guestfs.pod:1744
3848 msgid ""
3849 "The units of C<total> are not defined, although for some operations C<total> "
3850 "may relate in some way to the amount of data to be transferred (eg. in bytes "
3851 "or megabytes), and C<position> may be the portion which has been transferred."
3852 msgstr ""
3853
3854 # type: textblock
3855 #. type: textblock
3856 #: ../src/guestfs.pod:1749
3857 msgid "The only defined and stable parts of the API are:"
3858 msgstr ""
3859
3860 # type: textblock
3861 #. type: textblock
3862 #: ../src/guestfs.pod:1755
3863 msgid ""
3864 "The callback can display to the user some type of progress bar or indicator "
3865 "which shows the ratio of C<position>:C<total>."
3866 msgstr ""
3867
3868 # type: textblock
3869 #. type: textblock
3870 #: ../src/guestfs.pod:1760
3871 msgid "0 E<lt>= C<position> E<lt>= C<total>"
3872 msgstr ""
3873
3874 #. type: textblock
3875 #: ../src/guestfs.pod:1764
3876 msgid ""
3877 "If any progress notification is sent during a call, then a final progress "
3878 "notification is always sent when C<position> = C<total> (I<unless> the call "
3879 "fails with an error)."
3880 msgstr ""
3881
3882 # type: textblock
3883 #. type: textblock
3884 #: ../src/guestfs.pod:1768
3885 msgid ""
3886 "This is to simplify caller code, so callers can easily set the progress "
3887 "indicator to \"100%\" at the end of the operation, without requiring special "
3888 "code to detect this case."
3889 msgstr ""
3890
3891 #. type: textblock
3892 #: ../src/guestfs.pod:1774
3893 msgid ""
3894 "For some calls we are unable to estimate the progress of the call, but we "
3895 "can still generate progress messages to indicate activity.  This is known as "
3896 "\"pulse mode\", and is directly supported by certain progress bar "
3897 "implementations (eg. GtkProgressBar)."
3898 msgstr ""
3899
3900 #. type: textblock
3901 #: ../src/guestfs.pod:1779
3902 msgid ""
3903 "For these calls, zero or more progress messages are generated with "
3904 "C<position = 0> and C<total = 1>, followed by a final message with "
3905 "C<position = total = 1>."
3906 msgstr ""
3907
3908 #. type: textblock
3909 #: ../src/guestfs.pod:1783
3910 msgid ""
3911 "As noted above, if the call fails with an error then the final message may "
3912 "not be generated."
3913 msgstr ""
3914
3915 #. type: textblock
3916 #: ../src/guestfs.pod:1788
3917 msgid ""
3918 "The callback also receives the procedure number (C<proc_nr>) and serial "
3919 "number (C<serial>) of the call.  These are only useful for debugging "
3920 "protocol issues, and the callback can normally ignore them.  The callback "
3921 "may want to print these numbers in error messages or debugging messages."
3922 msgstr ""
3923
3924 #. type: textblock
3925 #: ../src/guestfs.pod:1794
3926 msgid "If no callback is registered: progress messages are discarded."
3927 msgstr ""
3928
3929 #. type: =item
3930 #: ../src/guestfs.pod:1796
3931 msgid "GUESTFS_EVENT_APPLIANCE (payload type: message buffer)"
3932 msgstr ""
3933
3934 #. type: textblock
3935 #: ../src/guestfs.pod:1799
3936 msgid ""
3937 "The callback function is called whenever a log message is generated by qemu, "
3938 "the appliance kernel, guestfsd (daemon), or utility programs."
3939 msgstr ""
3940
3941 #. type: textblock
3942 #: ../src/guestfs.pod:1802
3943 msgid ""
3944 "If the verbose flag (L</guestfs_set_verbose>) is set before launch (L</"
3945 "guestfs_launch>) then additional debug messages are generated."
3946 msgstr ""
3947
3948 #. type: textblock
3949 #: ../src/guestfs.pod:1805 ../src/guestfs.pod:1819
3950 msgid ""
3951 "If no callback is registered: the messages are discarded unless the verbose "
3952 "flag is set in which case they are sent to stderr.  You can override the "
3953 "printing of verbose messages to stderr by setting up a callback."
3954 msgstr ""
3955
3956 #. type: =item
3957 #: ../src/guestfs.pod:1810
3958 msgid "GUESTFS_EVENT_LIBRARY (payload type: message buffer)"
3959 msgstr ""
3960
3961 #. type: textblock
3962 #: ../src/guestfs.pod:1813
3963 msgid ""
3964 "The callback function is called whenever a log message is generated by the "
3965 "library part of libguestfs."
3966 msgstr ""
3967
3968 #. type: textblock
3969 #: ../src/guestfs.pod:1816
3970 msgid ""
3971 "If the verbose flag (L</guestfs_set_verbose>) is set then additional debug "
3972 "messages are generated."
3973 msgstr ""
3974
3975 #. type: =item
3976 #: ../src/guestfs.pod:1824
3977 msgid "GUESTFS_EVENT_TRACE (payload type: message buffer)"
3978 msgstr ""
3979
3980 #. type: textblock
3981 #: ../src/guestfs.pod:1827
3982 msgid ""
3983 "The callback function is called whenever a trace message is generated.  This "
3984 "only applies if the trace flag (L</guestfs_set_trace>) is set."
3985 msgstr ""
3986
3987 #. type: textblock
3988 #: ../src/guestfs.pod:1830
3989 msgid ""
3990 "If no callback is registered: the messages are sent to stderr.  You can "
3991 "override the printing of trace messages to stderr by setting up a callback."
3992 msgstr ""
3993
3994 #. type: =head3
3995 #: ../src/guestfs.pod:1836
3996 msgid "guestfs_set_event_callback"
3997 msgstr ""
3998
3999 #. type: verbatim
4000 #: ../src/guestfs.pod:1838
4001 #, no-wrap
4002 msgid ""
4003 " int guestfs_set_event_callback (guestfs_h *g,\n"
4004 "                                 guestfs_event_callback cb,\n"
4005 "                                 uint64_t event_bitmask,\n"
4006 "                                 int flags,\n"
4007 "                                 void *opaque);\n"
4008 "\n"
4009 msgstr ""
4010
4011 #. type: textblock
4012 #: ../src/guestfs.pod:1844
4013 msgid ""
4014 "This function registers a callback (C<cb>) for all event classes in the "
4015 "C<event_bitmask>."
4016 msgstr ""
4017
4018 #. type: textblock
4019 #: ../src/guestfs.pod:1847
4020 msgid ""
4021 "For example, to register for all log message events, you could call this "
4022 "function with the bitmask C<GUESTFS_EVENT_APPLIANCE|GUESTFS_EVENT_LIBRARY>.  "
4023 "To register a single callback for all possible classes of events, use "
4024 "C<GUESTFS_EVENT_ALL>."
4025 msgstr ""
4026
4027 #. type: textblock
4028 #: ../src/guestfs.pod:1853
4029 msgid "C<flags> should always be passed as 0."
4030 msgstr ""
4031
4032 #. type: textblock
4033 #: ../src/guestfs.pod:1855
4034 msgid ""
4035 "C<opaque> is an opaque pointer which is passed to the callback.  You can use "
4036 "it for any purpose."
4037 msgstr ""
4038
4039 #. type: textblock
4040 #: ../src/guestfs.pod:1858
4041 msgid ""
4042 "The return value is the event handle (an integer) which you can use to "
4043 "delete the callback (see below)."
4044 msgstr ""
4045
4046 #. type: textblock
4047 #: ../src/guestfs.pod:1861
4048 msgid ""
4049 "If there is an error, this function returns C<-1>, and sets the error in the "
4050 "handle in the usual way (see L</guestfs_last_error> etc.)"
4051 msgstr ""
4052
4053 #. type: textblock
4054 #: ../src/guestfs.pod:1864
4055 msgid ""
4056 "Callbacks remain in effect until they are deleted, or until the handle is "
4057 "closed."
4058 msgstr ""
4059
4060 #. type: textblock
4061 #: ../src/guestfs.pod:1867
4062 msgid ""
4063 "In the case where multiple callbacks are registered for a particular event "
4064 "class, all of the callbacks are called.  The order in which multiple "
4065 "callbacks are called is not defined."
4066 msgstr ""
4067
4068 #. type: =head3
4069 #: ../src/guestfs.pod:1871
4070 msgid "guestfs_delete_event_callback"
4071 msgstr ""
4072
4073 #. type: verbatim
4074 #: ../src/guestfs.pod:1873
4075 #, no-wrap
4076 msgid ""
4077 " void guestfs_delete_event_callback (guestfs_h *g, int event_handle);\n"
4078 "\n"
4079 msgstr ""
4080
4081 #. type: textblock
4082 #: ../src/guestfs.pod:1875
4083 msgid ""
4084 "Delete a callback that was previously registered.  C<event_handle> should be "
4085 "the integer that was returned by a previous call to "
4086 "C<guestfs_set_event_callback> on the same handle."
4087 msgstr ""
4088
4089 #. type: =head3
4090 #: ../src/guestfs.pod:1879
4091 msgid "guestfs_event_callback"
4092 msgstr ""
4093
4094 #. type: verbatim
4095 #: ../src/guestfs.pod:1881
4096 #, no-wrap
4097 msgid ""
4098 " typedef void (*guestfs_event_callback) (\n"
4099 "                  guestfs_h *g,\n"
4100 "                  void *opaque,\n"
4101 "                  uint64_t event,\n"
4102 "                  int event_handle,\n"
4103 "                  int flags,\n"
4104 "                  const char *buf, size_t buf_len,\n"
4105 "                  const uint64_t *array, size_t array_len);\n"
4106 "\n"
4107 msgstr ""
4108
4109 #. type: textblock
4110 #: ../src/guestfs.pod:1890
4111 msgid ""
4112 "This is the type of the event callback function that you have to provide."
4113 msgstr ""
4114
4115 #. type: textblock
4116 #: ../src/guestfs.pod:1893
4117 msgid ""
4118 "The basic parameters are: the handle (C<g>), the opaque user pointer "
4119 "(C<opaque>), the event class (eg. C<GUESTFS_EVENT_PROGRESS>), the event "
4120 "handle, and C<flags> which in the current API you should ignore."
4121 msgstr ""
4122
4123 #. type: textblock
4124 #: ../src/guestfs.pod:1897
4125 msgid ""
4126 "The remaining parameters contain the event payload (if any).  Each event may "
4127 "contain a payload, which usually relates to the event class, but for future "
4128 "proofing your code should be written to handle any payload for any event "
4129 "class."
4130 msgstr ""
4131
4132 #. type: textblock
4133 #: ../src/guestfs.pod:1902
4134 msgid ""
4135 "C<buf> and C<buf_len> contain a message buffer (if C<buf_len == 0>, then "
4136 "there is no message buffer).  Note that this message buffer can contain "
4137 "arbitrary 8 bit data, including NUL bytes."
4138 msgstr ""
4139
4140 #. type: textblock
4141 #: ../src/guestfs.pod:1906
4142 msgid ""
4143 "C<array> and C<array_len> is an array of 64 bit unsigned integers.  At the "
4144 "moment this is only used for progress messages."
4145 msgstr ""
4146
4147 #. type: =head3
4148 #: ../src/guestfs.pod:1909
4149 msgid "EXAMPLE: CAPTURING LOG MESSAGES"
4150 msgstr ""
4151
4152 #. type: textblock
4153 #: ../src/guestfs.pod:1911
4154 msgid ""
4155 "One motivation for the generic event API was to allow GUI programs to "
4156 "capture debug and other messages.  In libguestfs E<le> 1.8 these were sent "
4157 "unconditionally to C<stderr>."
4158 msgstr ""
4159
4160 #. type: textblock
4161 #: ../src/guestfs.pod:1915
4162 msgid ""
4163 "Events associated with log messages are: C<GUESTFS_EVENT_LIBRARY>, "
4164 "C<GUESTFS_EVENT_APPLIANCE> and C<GUESTFS_EVENT_TRACE>.  (Note that error "
4165 "messages are not events; you must capture error messages separately)."
4166 msgstr ""
4167
4168 #. type: textblock
4169 #: ../src/guestfs.pod:1920
4170 msgid ""
4171 "Programs have to set up a callback to capture the classes of events of "
4172 "interest:"
4173 msgstr ""
4174
4175 #. type: verbatim
4176 #: ../src/guestfs.pod:1923
4177 #, no-wrap
4178 msgid ""
4179 " int eh =\n"
4180 "   guestfs_set_event_callback\n"
4181 "     (g, message_callback,\n"
4182 "      GUESTFS_EVENT_LIBRARY|GUESTFS_EVENT_APPLIANCE|\n"
4183 "      GUESTFS_EVENT_TRACE,\n"
4184 "      0, NULL) == -1)\n"
4185 " if (eh == -1) {\n"
4186 "   // handle error in the usual way\n"
4187 " }\n"
4188 "\n"
4189 msgstr ""
4190
4191 #. type: textblock
4192 #: ../src/guestfs.pod:1933
4193 msgid ""
4194 "The callback can then direct messages to the appropriate place.  In this "
4195 "example, messages are directed to syslog:"
4196 msgstr ""
4197
4198 #. type: verbatim
4199 #: ../src/guestfs.pod:1936
4200 #, no-wrap
4201 msgid ""
4202 " static void\n"
4203 " message_callback (\n"
4204 "         guestfs_h *g,\n"
4205 "         void *opaque,\n"
4206 "         uint64_t event,\n"
4207 "         int event_handle,\n"
4208 "         int flags,\n"
4209 "         const char *buf, size_t buf_len,\n"
4210 "         const uint64_t *array, size_t array_len)\n"
4211 " {\n"
4212 "   const int priority = LOG_USER|LOG_INFO;\n"
4213 "   if (buf_len > 0)\n"
4214 "     syslog (priority, \"event 0x%lx: %s\", event, buf);\n"
4215 " }\n"
4216 "\n"
4217 msgstr ""
4218
4219 # type: =head1
4220 #. type: =head1
4221 #: ../src/guestfs.pod:1951
4222 msgid "PRIVATE DATA AREA"
4223 msgstr ""
4224
4225 #. type: textblock
4226 #: ../src/guestfs.pod:1953
4227 msgid ""
4228 "You can attach named pieces of private data to the libguestfs handle, fetch "
4229 "them by name, and walk over them, for the lifetime of the handle.  This is "
4230 "called the private data area and is only available from the C API."
4231 msgstr ""
4232
4233 # type: textblock
4234 #. type: textblock
4235 #: ../src/guestfs.pod:1958
4236 msgid "To attach a named piece of data, use the following call:"
4237 msgstr ""
4238
4239 # type: verbatim
4240 #. type: verbatim
4241 #: ../src/guestfs.pod:1960
4242 #, no-wrap
4243 msgid ""
4244 " void guestfs_set_private (guestfs_h *g, const char *key, void *data);\n"
4245 "\n"
4246 msgstr ""
4247
4248 #. type: textblock
4249 #: ../src/guestfs.pod:1962
4250 msgid ""
4251 "C<key> is the name to associate with this data, and C<data> is an arbitrary "
4252 "pointer (which can be C<NULL>).  Any previous item with the same key is "
4253 "overwritten."
4254 msgstr ""
4255
4256 #. type: textblock
4257 #: ../src/guestfs.pod:1966
4258 msgid ""
4259 "You can use any C<key> you want, but your key should I<not> start with an "
4260 "underscore character.  Keys beginning with an underscore character are "
4261 "reserved for internal libguestfs purposes (eg. for implementing language "
4262 "bindings).  It is recommended that you prefix the key with some unique "
4263 "string to avoid collisions with other users."
4264 msgstr ""
4265
4266 # type: textblock
4267 #. type: textblock
4268 #: ../src/guestfs.pod:1972
4269 msgid "To retrieve the pointer, use:"
4270 msgstr ""
4271
4272 # type: verbatim
4273 #. type: verbatim
4274 #: ../src/guestfs.pod:1974
4275 #, no-wrap
4276 msgid ""
4277 " void *guestfs_get_private (guestfs_h *g, const char *key);\n"
4278 "\n"
4279 msgstr ""
4280
4281 # type: textblock
4282 #. type: textblock
4283 #: ../src/guestfs.pod:1976
4284 msgid ""
4285 "This function returns C<NULL> if either no data is found associated with "
4286 "C<key>, or if the user previously set the C<key>'s C<data> pointer to "
4287 "C<NULL>."
4288 msgstr ""
4289
4290 #. type: textblock
4291 #: ../src/guestfs.pod:1980
4292 msgid ""
4293 "Libguestfs does not try to look at or interpret the C<data> pointer in any "
4294 "way.  As far as libguestfs is concerned, it need not be a valid pointer at "
4295 "all.  In particular, libguestfs does I<not> try to free the data when the "
4296 "handle is closed.  If the data must be freed, then the caller must either "
4297 "free it before calling L</guestfs_close> or must set up a close callback to "
4298 "do it (see L</GUESTFS_EVENT_CLOSE>)."
4299 msgstr ""
4300
4301 #. type: textblock
4302 #: ../src/guestfs.pod:1987
4303 msgid "To walk over all entries, use these two functions:"
4304 msgstr ""
4305
4306 #. type: verbatim
4307 #: ../src/guestfs.pod:1989
4308 #, no-wrap
4309 msgid ""
4310 " void *guestfs_first_private (guestfs_h *g, const char **key_rtn);\n"
4311 "\n"
4312 msgstr ""
4313
4314 #. type: verbatim
4315 #: ../src/guestfs.pod:1991
4316 #, no-wrap
4317 msgid ""
4318 " void *guestfs_next_private (guestfs_h *g, const char **key_rtn);\n"
4319 "\n"
4320 msgstr ""
4321
4322 #. type: textblock
4323 #: ../src/guestfs.pod:1993
4324 msgid ""
4325 "C<guestfs_first_private> returns the first key, pointer pair (\"first\" does "
4326 "not have any particular meaning -- keys are not returned in any defined "
4327 "order).  A pointer to the key is returned in C<*key_rtn> and the "
4328 "corresponding data pointer is returned from the function.  C<NULL> is "
4329 "returned if there are no keys stored in the handle."
4330 msgstr ""
4331
4332 #. type: textblock
4333 #: ../src/guestfs.pod:1999
4334 msgid ""
4335 "C<guestfs_next_private> returns the next key, pointer pair.  The return "
4336 "value of this function is also C<NULL> is there are no further entries to "
4337 "return."
4338 msgstr ""
4339
4340 #. type: textblock
4341 #: ../src/guestfs.pod:2003
4342 msgid "Notes about walking over entries:"
4343 msgstr ""
4344
4345 #. type: textblock
4346 #: ../src/guestfs.pod:2009
4347 msgid ""
4348 "You must not call C<guestfs_set_private> while walking over the entries."
4349 msgstr ""
4350
4351 #. type: textblock
4352 #: ../src/guestfs.pod:2014
4353 msgid ""
4354 "The handle maintains an internal iterator which is reset when you call "
4355 "C<guestfs_first_private>.  This internal iterator is invalidated when you "
4356 "call C<guestfs_set_private>."
4357 msgstr ""
4358
4359 #. type: textblock
4360 #: ../src/guestfs.pod:2020
4361 msgid "If you have set the data pointer associated with a key to C<NULL>, ie:"
4362 msgstr ""
4363
4364 #. type: verbatim
4365 #: ../src/guestfs.pod:2022
4366 #, no-wrap
4367 msgid ""
4368 " guestfs_set_private (g, key, NULL);\n"
4369 "\n"
4370 msgstr ""
4371
4372 #. type: textblock
4373 #: ../src/guestfs.pod:2024
4374 msgid "then that C<key> is not returned when walking."
4375 msgstr ""
4376
4377 #. type: textblock
4378 #: ../src/guestfs.pod:2028
4379 msgid ""
4380 "C<*key_rtn> is only valid until the next call to C<guestfs_first_private>, "
4381 "C<guestfs_next_private> or C<guestfs_set_private>."
4382 msgstr ""
4383
4384 #. type: textblock
4385 #: ../src/guestfs.pod:2034
4386 msgid ""
4387 "The following example code shows how to print all keys and data pointers "
4388 "that are associated with the handle C<g>:"
4389 msgstr ""
4390
4391 #. type: verbatim
4392 #: ../src/guestfs.pod:2037
4393 #, no-wrap
4394 msgid ""
4395 " const char *key;\n"
4396 " void *data = guestfs_first_private (g, &key);\n"
4397 " while (data != NULL)\n"
4398 "   {\n"
4399 "     printf (\"key = %s, data = %p\\n\", key, data);\n"
4400 "     data = guestfs_next_private (g, &key);\n"
4401 "   }\n"
4402 "\n"
4403 msgstr ""
4404
4405 #. type: textblock
4406 #: ../src/guestfs.pod:2045
4407 msgid ""
4408 "More commonly you are only interested in keys that begin with an application-"
4409 "specific prefix C<foo_>.  Modify the loop like so:"
4410 msgstr ""
4411
4412 #. type: verbatim
4413 #: ../src/guestfs.pod:2048
4414 #, no-wrap
4415 msgid ""
4416 " const char *key;\n"
4417 " void *data = guestfs_first_private (g, &key);\n"
4418 " while (data != NULL)\n"
4419 "   {\n"
4420 "     if (strncmp (key, \"foo_\", strlen (\"foo_\")) == 0)\n"
4421 "       printf (\"key = %s, data = %p\\n\", key, data);\n"
4422 "     data = guestfs_next_private (g, &key);\n"
4423 "   }\n"
4424 "\n"
4425 msgstr ""
4426
4427 #. type: textblock
4428 #: ../src/guestfs.pod:2057
4429 msgid ""
4430 "If you need to modify keys while walking, then you have to jump back to the "
4431 "beginning of the loop.  For example, to delete all keys prefixed with "
4432 "C<foo_>:"
4433 msgstr ""
4434
4435 #. type: verbatim
4436 #: ../src/guestfs.pod:2061
4437 #, no-wrap
4438 msgid ""
4439 "  const char *key;\n"
4440 "  void *data;\n"
4441 " again:\n"
4442 "  data = guestfs_first_private (g, &key);\n"
4443 "  while (data != NULL)\n"
4444 "    {\n"
4445 "      if (strncmp (key, \"foo_\", strlen (\"foo_\")) == 0)\n"
4446 "        {\n"
4447 "          guestfs_set_private (g, key, NULL);\n"
4448 "          /* note that 'key' pointer is now invalid, and so is\n"
4449 "             the internal iterator */\n"
4450 "          goto again;\n"
4451 "        }\n"
4452 "      data = guestfs_next_private (g, &key);\n"
4453 "    }\n"
4454 "\n"
4455 msgstr ""
4456
4457 #. type: textblock
4458 #: ../src/guestfs.pod:2077
4459 msgid ""
4460 "Note that the above loop is guaranteed to terminate because the keys are "
4461 "being deleted, but other manipulations of keys within the loop might not "
4462 "terminate unless you also maintain an indication of which keys have been "
4463 "visited."
4464 msgstr ""
4465
4466 # type: =end
4467 #. type: =end
4468 #: ../src/guestfs.pod:2082 ../src/guestfs.pod:2087
4469 msgid "html"
4470 msgstr ""
4471
4472 # type: textblock
4473 #. type: textblock
4474 #: ../src/guestfs.pod:2084
4475 msgid ""
4476 "<!-- old anchor for the next section --> <a name="
4477 "\"state_machine_and_low_level_event_api\"/>"
4478 msgstr ""
4479
4480 # type: =head1
4481 #. type: =head1
4482 #: ../src/guestfs.pod:2089
4483 msgid "ARCHITECTURE"
4484 msgstr ""
4485
4486 # type: textblock
4487 #. type: textblock
4488 #: ../src/guestfs.pod:2091
4489 msgid ""
4490 "Internally, libguestfs is implemented by running an appliance (a special "
4491 "type of small virtual machine) using L<qemu(1)>.  Qemu runs as a child "
4492 "process of the main program."
4493 msgstr ""
4494
4495 # type: verbatim
4496 #. type: verbatim
4497 #: ../src/guestfs.pod:2095
4498 #, no-wrap
4499 msgid ""
4500 "  ___________________\n"
4501 " /                   \\\n"
4502 " | main program      |\n"
4503 " |                   |\n"
4504 " |                   |           child process / appliance\n"
4505 " |                   |           __________________________\n"
4506 " |                   |          / qemu                     \\\n"
4507 " +-------------------+   RPC    |      +-----------------+ |\n"
4508 " | libguestfs     <--------------------> guestfsd        | |\n"
4509 " |                   |          |      +-----------------+ |\n"
4510 " \\___________________/          |      | Linux kernel    | |\n"
4511 "                                |      +--^--------------+ |\n"
4512 "                                \\_________|________________/\n"
4513 "                                          |\n"
4514 "                                   _______v______\n"
4515 "                                  /              \\\n"
4516 "                                  | Device or    |\n"
4517 "                                  | disk image   |\n"
4518 "                                  \\______________/\n"
4519 "\n"
4520 msgstr ""
4521
4522 # type: textblock
4523 #. type: textblock
4524 #: ../src/guestfs.pod:2115
4525 msgid ""
4526 "The library, linked to the main program, creates the child process and hence "
4527 "the appliance in the L</guestfs_launch> function."
4528 msgstr ""
4529
4530 # type: textblock
4531 #. type: textblock
4532 #: ../src/guestfs.pod:2118
4533 msgid ""
4534 "Inside the appliance is a Linux kernel and a complete stack of userspace "
4535 "tools (such as LVM and ext2 programs) and a small controlling daemon called "
4536 "L</guestfsd>.  The library talks to L</guestfsd> using remote procedure "
4537 "calls (RPC).  There is a mostly one-to-one correspondence between libguestfs "
4538 "API calls and RPC calls to the daemon.  Lastly the disk image(s) are "
4539 "attached to the qemu process which translates device access by the "
4540 "appliance's Linux kernel into accesses to the image."
4541 msgstr ""
4542
4543 # type: textblock
4544 #. type: textblock
4545 #: ../src/guestfs.pod:2127
4546 msgid ""
4547 "A common misunderstanding is that the appliance \"is\" the virtual machine.  "
4548 "Although the disk image you are attached to might also be used by some "
4549 "virtual machine, libguestfs doesn't know or care about this.  (But you will "
4550 "care if both libguestfs's qemu process and your virtual machine are trying "
4551 "to update the disk image at the same time, since these usually results in "
4552 "massive disk corruption)."
4553 msgstr ""
4554
4555 # type: =head1
4556 #. type: =head1
4557 #: ../src/guestfs.pod:2134
4558 msgid "STATE MACHINE"
4559 msgstr ""
4560
4561 # type: textblock
4562 #. type: textblock
4563 #: ../src/guestfs.pod:2136
4564 msgid "libguestfs uses a state machine to model the child process:"
4565 msgstr ""
4566
4567 # type: verbatim
4568 #. type: verbatim
4569 #: ../src/guestfs.pod:2138
4570 #, no-wrap
4571 msgid ""
4572 "                         |\n"
4573 "                    guestfs_create\n"
4574 "                         |\n"
4575 "                         |\n"
4576 "                     ____V_____\n"
4577 "                    /          \\\n"
4578 "                    |  CONFIG  |\n"
4579 "                    \\__________/\n"
4580 "                     ^ ^   ^  \\\n"
4581 "                    /  |    \\  \\ guestfs_launch\n"
4582 "                   /   |    _\\__V______\n"
4583 "                  /    |   /           \\\n"
4584 "                 /     |   | LAUNCHING |\n"
4585 "                /      |   \\___________/\n"
4586 "               /       |       /\n"
4587 "              /        |  guestfs_launch\n"
4588 "             /         |     /\n"
4589 "    ______  /        __|____V\n"
4590 "   /      \\ ------> /        \\\n"
4591 "   | BUSY |         | READY  |\n"
4592 "   \\______/ <------ \\________/\n"
4593 "\n"
4594 msgstr ""
4595
4596 # type: textblock
4597 #. type: textblock
4598 #: ../src/guestfs.pod:2160
4599 msgid ""
4600 "The normal transitions are (1) CONFIG (when the handle is created, but there "
4601 "is no child process), (2) LAUNCHING (when the child process is booting up), "
4602 "(3) alternating between READY and BUSY as commands are issued to, and "
4603 "carried out by, the child process."
4604 msgstr ""
4605
4606 # type: textblock
4607 #. type: textblock
4608 #: ../src/guestfs.pod:2165
4609 msgid ""
4610 "The guest may be killed by L</guestfs_kill_subprocess>, or may die "
4611 "asynchronously at any time (eg. due to some internal error), and that causes "
4612 "the state to transition back to CONFIG."
4613 msgstr ""
4614
4615 # type: textblock
4616 #. type: textblock
4617 #: ../src/guestfs.pod:2169
4618 msgid ""
4619 "Configuration commands for qemu such as L</guestfs_add_drive> can only be "
4620 "issued when in the CONFIG state."
4621 msgstr ""
4622
4623 # type: textblock
4624 #. type: textblock
4625 #: ../src/guestfs.pod:2172
4626 msgid ""
4627 "The API offers one call that goes from CONFIG through LAUNCHING to READY.  "
4628 "L</guestfs_launch> blocks until the child process is READY to accept "
4629 "commands (or until some failure or timeout).  L</guestfs_launch> internally "
4630 "moves the state from CONFIG to LAUNCHING while it is running."
4631 msgstr ""
4632
4633 # type: textblock
4634 #. type: textblock
4635 #: ../src/guestfs.pod:2178
4636 msgid ""
4637 "API actions such as L</guestfs_mount> can only be issued when in the READY "
4638 "state.  These API calls block waiting for the command to be carried out (ie. "
4639 "the state to transition to BUSY and then back to READY).  There are no non-"
4640 "blocking versions, and no way to issue more than one command per handle at "
4641 "the same time."
4642 msgstr ""
4643
4644 # type: textblock
4645 #. type: textblock
4646 #: ../src/guestfs.pod:2184
4647 msgid ""
4648 "Finally, the child process sends asynchronous messages back to the main "
4649 "program, such as kernel log messages.  You can register a callback to "
4650 "receive these messages."
4651 msgstr ""
4652
4653 # type: =head1
4654 #. type: =head1
4655 #: ../src/guestfs.pod:2188
4656 msgid "INTERNALS"
4657 msgstr ""
4658
4659 # type: =head2
4660 #. type: =head2
4661 #: ../src/guestfs.pod:2190
4662 msgid "COMMUNICATION PROTOCOL"
4663 msgstr ""
4664
4665 # type: textblock
4666 #. type: textblock
4667 #: ../src/guestfs.pod:2192
4668 msgid ""
4669 "Don't rely on using this protocol directly.  This section documents how it "
4670 "currently works, but it may change at any time."
4671 msgstr ""
4672
4673 # type: textblock
4674 #. type: textblock
4675 #: ../src/guestfs.pod:2195
4676 msgid ""
4677 "The protocol used to talk between the library and the daemon running inside "
4678 "the qemu virtual machine is a simple RPC mechanism built on top of XDR (RFC "
4679 "1014, RFC 1832, RFC 4506)."
4680 msgstr ""
4681
4682 # type: textblock
4683 #. type: textblock
4684 #: ../src/guestfs.pod:2199
4685 msgid ""
4686 "The detailed format of structures is in C<src/guestfs_protocol.x> (note: "
4687 "this file is automatically generated)."
4688 msgstr ""
4689
4690 # type: textblock
4691 #. type: textblock
4692 #: ../src/guestfs.pod:2202
4693 msgid ""
4694 "There are two broad cases, ordinary functions that don't have any C<FileIn> "
4695 "and C<FileOut> parameters, which are handled with very simple request/reply "
4696 "messages.  Then there are functions that have any C<FileIn> or C<FileOut> "
4697 "parameters, which use the same request and reply messages, but they may also "
4698 "be followed by files sent using a chunked encoding."
4699 msgstr ""
4700
4701 # type: =head3
4702 #. type: =head3
4703 #: ../src/guestfs.pod:2209
4704 msgid "ORDINARY FUNCTIONS (NO FILEIN/FILEOUT PARAMS)"
4705 msgstr ""
4706
4707 # type: textblock
4708 #. type: textblock
4709 #: ../src/guestfs.pod:2211
4710 msgid "For ordinary functions, the request message is:"
4711 msgstr ""
4712
4713 # type: verbatim
4714 #. type: verbatim
4715 #: ../src/guestfs.pod:2213
4716 #, no-wrap
4717 msgid ""
4718 " total length (header + arguments,\n"
4719 "      but not including the length word itself)\n"
4720 " struct guestfs_message_header (encoded as XDR)\n"
4721 " struct guestfs_<foo>_args (encoded as XDR)\n"
4722 "\n"
4723 msgstr ""
4724
4725 # type: textblock
4726 #. type: textblock
4727 #: ../src/guestfs.pod:2218
4728 msgid ""
4729 "The total length field allows the daemon to allocate a fixed size buffer "
4730 "into which it slurps the rest of the message.  As a result, the total length "
4731 "is limited to C<GUESTFS_MESSAGE_MAX> bytes (currently 4MB), which means the "
4732 "effective size of any request is limited to somewhere under this size."
4733 msgstr ""
4734
4735 # type: textblock
4736 #. type: textblock
4737 #: ../src/guestfs.pod:2224
4738 msgid ""
4739 "Note also that many functions don't take any arguments, in which case the "
4740 "C<guestfs_I<foo>_args> is completely omitted."
4741 msgstr ""
4742
4743 # type: textblock
4744 #. type: textblock
4745 #: ../src/guestfs.pod:2227
4746 msgid ""
4747 "The header contains the procedure number (C<guestfs_proc>) which is how the "
4748 "receiver knows what type of args structure to expect, or none at all."
4749 msgstr ""
4750
4751 # type: textblock
4752 #. type: textblock
4753 #: ../src/guestfs.pod:2231
4754 msgid ""
4755 "For functions that take optional arguments, the optional arguments are "
4756 "encoded in the C<guestfs_I<foo>_args> structure in the same way as ordinary "
4757 "arguments.  A bitmask in the header indicates which optional arguments are "
4758 "meaningful.  The bitmask is also checked to see if it contains bits set "
4759 "which the daemon does not know about (eg. if more optional arguments were "
4760 "added in a later version of the library), and this causes the call to be "
4761 "rejected."
4762 msgstr ""
4763
4764 # type: textblock
4765 #. type: textblock
4766 #: ../src/guestfs.pod:2239
4767 msgid "The reply message for ordinary functions is:"
4768 msgstr ""
4769
4770 # type: verbatim
4771 #. type: verbatim
4772 #: ../src/guestfs.pod:2241
4773 #, no-wrap
4774 msgid ""
4775 " total length (header + ret,\n"
4776 "      but not including the length word itself)\n"
4777 " struct guestfs_message_header (encoded as XDR)\n"
4778 " struct guestfs_<foo>_ret (encoded as XDR)\n"
4779 "\n"
4780 msgstr ""
4781
4782 # type: textblock
4783 #. type: textblock
4784 #: ../src/guestfs.pod:2246
4785 msgid ""
4786 "As above the C<guestfs_I<foo>_ret> structure may be completely omitted for "
4787 "functions that return no formal return values."
4788 msgstr ""
4789
4790 # type: textblock
4791 #. type: textblock
4792 #: ../src/guestfs.pod:2249
4793 msgid ""
4794 "As above the total length of the reply is limited to C<GUESTFS_MESSAGE_MAX>."
4795 msgstr ""
4796
4797 # type: textblock
4798 #. type: textblock
4799 #: ../src/guestfs.pod:2252
4800 msgid ""
4801 "In the case of an error, a flag is set in the header, and the reply message "
4802 "is slightly changed:"
4803 msgstr ""
4804
4805 # type: verbatim
4806 #. type: verbatim
4807 #: ../src/guestfs.pod:2255
4808 #, no-wrap
4809 msgid ""
4810 " total length (header + error,\n"
4811 "      but not including the length word itself)\n"
4812 " struct guestfs_message_header (encoded as XDR)\n"
4813 " struct guestfs_message_error (encoded as XDR)\n"
4814 "\n"
4815 msgstr ""
4816
4817 # type: textblock
4818 #. type: textblock
4819 #: ../src/guestfs.pod:2260
4820 msgid ""
4821 "The C<guestfs_message_error> structure contains the error message as a "
4822 "string."
4823 msgstr ""
4824
4825 # type: =head3
4826 #. type: =head3
4827 #: ../src/guestfs.pod:2263
4828 msgid "FUNCTIONS THAT HAVE FILEIN PARAMETERS"
4829 msgstr ""
4830
4831 # type: textblock
4832 #. type: textblock
4833 #: ../src/guestfs.pod:2265
4834 msgid ""
4835 "A C<FileIn> parameter indicates that we transfer a file I<into> the guest.  "
4836 "The normal request message is sent (see above).  However this is followed by "
4837 "a sequence of file chunks."
4838 msgstr ""
4839
4840 # type: verbatim
4841 #. type: verbatim
4842 #: ../src/guestfs.pod:2269
4843 #, no-wrap
4844 msgid ""
4845 " total length (header + arguments,\n"
4846 "      but not including the length word itself,\n"
4847 "      and not including the chunks)\n"
4848 " struct guestfs_message_header (encoded as XDR)\n"
4849 " struct guestfs_<foo>_args (encoded as XDR)\n"
4850 " sequence of chunks for FileIn param #0\n"
4851 " sequence of chunks for FileIn param #1 etc.\n"
4852 "\n"
4853 msgstr ""
4854
4855 # type: textblock
4856 #. type: textblock
4857 #: ../src/guestfs.pod:2277
4858 msgid "The \"sequence of chunks\" is:"
4859 msgstr ""
4860
4861 # type: verbatim
4862 #. type: verbatim
4863 #: ../src/guestfs.pod:2279
4864 #, no-wrap
4865 msgid ""
4866 " length of chunk (not including length word itself)\n"
4867 " struct guestfs_chunk (encoded as XDR)\n"
4868 " length of chunk\n"
4869 " struct guestfs_chunk (encoded as XDR)\n"
4870 "   ...\n"
4871 " length of chunk\n"
4872 " struct guestfs_chunk (with data.data_len == 0)\n"
4873 "\n"
4874 msgstr ""
4875
4876 # type: textblock
4877 #. type: textblock
4878 #: ../src/guestfs.pod:2287
4879 msgid ""
4880 "The final chunk has the C<data_len> field set to zero.  Additionally a flag "
4881 "is set in the final chunk to indicate either successful completion or early "
4882 "cancellation."
4883 msgstr ""
4884
4885 # type: textblock
4886 #. type: textblock
4887 #: ../src/guestfs.pod:2291
4888 msgid ""
4889 "At time of writing there are no functions that have more than one FileIn "
4890 "parameter.  However this is (theoretically) supported, by sending the "
4891 "sequence of chunks for each FileIn parameter one after another (from left to "
4892 "right)."
4893 msgstr ""
4894
4895 # type: textblock
4896 #. type: textblock
4897 #: ../src/guestfs.pod:2296
4898 msgid ""
4899 "Both the library (sender) I<and> the daemon (receiver) may cancel the "
4900 "transfer.  The library does this by sending a chunk with a special flag set "
4901 "to indicate cancellation.  When the daemon sees this, it cancels the whole "
4902 "RPC, does I<not> send any reply, and goes back to reading the next request."
4903 msgstr ""
4904
4905 # type: textblock
4906 #. type: textblock
4907 #: ../src/guestfs.pod:2302
4908 msgid ""
4909 "The daemon may also cancel.  It does this by writing a special word "
4910 "C<GUESTFS_CANCEL_FLAG> to the socket.  The library listens for this during "
4911 "the transfer, and if it gets it, it will cancel the transfer (it sends a "
4912 "cancel chunk).  The special word is chosen so that even if cancellation "
4913 "happens right at the end of the transfer (after the library has finished "
4914 "writing and has started listening for the reply), the \"spurious\" cancel "
4915 "flag will not be confused with the reply message."
4916 msgstr ""
4917
4918 # type: textblock
4919 #. type: textblock
4920 #: ../src/guestfs.pod:2311
4921 msgid ""
4922 "This protocol allows the transfer of arbitrary sized files (no 32 bit "
4923 "limit), and also files where the size is not known in advance (eg. from "
4924 "pipes or sockets).  However the chunks are rather small "
4925 "(C<GUESTFS_MAX_CHUNK_SIZE>), so that neither the library nor the daemon need "
4926 "to keep much in memory."
4927 msgstr ""
4928
4929 # type: =head3
4930 #. type: =head3
4931 #: ../src/guestfs.pod:2317
4932 msgid "FUNCTIONS THAT HAVE FILEOUT PARAMETERS"
4933 msgstr ""
4934
4935 # type: textblock
4936 #. type: textblock
4937 #: ../src/guestfs.pod:2319
4938 msgid ""
4939 "The protocol for FileOut parameters is exactly the same as for FileIn "
4940 "parameters, but with the roles of daemon and library reversed."
4941 msgstr ""
4942
4943 # type: verbatim
4944 #. type: verbatim
4945 #: ../src/guestfs.pod:2322
4946 #, no-wrap
4947 msgid ""
4948 " total length (header + ret,\n"
4949 "      but not including the length word itself,\n"
4950 "      and not including the chunks)\n"
4951 " struct guestfs_message_header (encoded as XDR)\n"
4952 " struct guestfs_<foo>_ret (encoded as XDR)\n"
4953 " sequence of chunks for FileOut param #0\n"
4954 " sequence of chunks for FileOut param #1 etc.\n"
4955 "\n"
4956 msgstr ""
4957
4958 # type: =head3
4959 #. type: =head3
4960 #: ../src/guestfs.pod:2330
4961 msgid "INITIAL MESSAGE"
4962 msgstr ""
4963
4964 # type: textblock
4965 #. type: textblock
4966 #: ../src/guestfs.pod:2332
4967 msgid ""
4968 "When the daemon launches it sends an initial word (C<GUESTFS_LAUNCH_FLAG>) "
4969 "which indicates that the guest and daemon is alive.  This is what L</"
4970 "guestfs_launch> waits for."
4971 msgstr ""
4972
4973 # type: =head3
4974 #. type: =head3
4975 #: ../src/guestfs.pod:2336
4976 msgid "PROGRESS NOTIFICATION MESSAGES"
4977 msgstr ""
4978
4979 # type: textblock
4980 #. type: textblock
4981 #: ../src/guestfs.pod:2338
4982 msgid ""
4983 "The daemon may send progress notification messages at any time.  These are "
4984 "distinguished by the normal length word being replaced by "
4985 "C<GUESTFS_PROGRESS_FLAG>, followed by a fixed size progress message."
4986 msgstr ""
4987
4988 #. type: textblock
4989 #: ../src/guestfs.pod:2342
4990 msgid ""
4991 "The library turns them into progress callbacks (see L</"
4992 "GUESTFS_EVENT_PROGRESS>) if there is a callback registered, or discards them "
4993 "if not."
4994 msgstr ""
4995
4996 # type: textblock
4997 #. type: textblock
4998 #: ../src/guestfs.pod:2346
4999 msgid ""
5000 "The daemon self-limits the frequency of progress messages it sends (see "
5001 "C<daemon/proto.c:notify_progress>).  Not all calls generate progress "
5002 "messages."
5003 msgstr ""
5004
5005 # type: =head1
5006 #. type: =head1
5007 #: ../src/guestfs.pod:2350
5008 msgid "LIBGUESTFS VERSION NUMBERS"
5009 msgstr ""
5010
5011 # type: textblock
5012 #. type: textblock
5013 #: ../src/guestfs.pod:2352
5014 msgid ""
5015 "Since April 2010, libguestfs has started to make separate development and "
5016 "stable releases, along with corresponding branches in our git repository.  "
5017 "These separate releases can be identified by version number:"
5018 msgstr ""
5019
5020 # type: verbatim
5021 #. type: verbatim
5022 #: ../src/guestfs.pod:2357
5023 #, no-wrap
5024 msgid ""
5025 "                 even numbers for stable: 1.2.x, 1.4.x, ...\n"
5026 "       .-------- odd numbers for development: 1.3.x, 1.5.x, ...\n"
5027 "       |\n"
5028 "       v\n"
5029 " 1  .  3  .  5\n"
5030 " ^           ^\n"
5031 " |           |\n"
5032 " |           `-------- sub-version\n"
5033 " |\n"
5034 " `------ always '1' because we don't change the ABI\n"
5035 "\n"
5036 msgstr ""
5037
5038 # type: textblock
5039 #. type: textblock
5040 #: ../src/guestfs.pod:2368
5041 msgid "Thus \"1.3.5\" is the 5th update to the development branch \"1.3\"."
5042 msgstr ""
5043
5044 # type: textblock
5045 #. type: textblock
5046 #: ../src/guestfs.pod:2370
5047 msgid ""
5048 "As time passes we cherry pick fixes from the development branch and backport "
5049 "those into the stable branch, the effect being that the stable branch should "
5050 "get more stable and less buggy over time.  So the stable releases are ideal "
5051 "for people who don't need new features but would just like the software to "
5052 "work."
5053 msgstr ""
5054
5055 # type: textblock
5056 #. type: textblock
5057 #: ../src/guestfs.pod:2376
5058 msgid "Our criteria for backporting changes are:"
5059 msgstr ""
5060
5061 # type: textblock
5062 #. type: textblock
5063 #: ../src/guestfs.pod:2382
5064 msgid ""
5065 "Documentation changes which don't affect any code are backported unless the "
5066 "documentation refers to a future feature which is not in stable."
5067 msgstr ""
5068
5069 # type: textblock
5070 #. type: textblock
5071 #: ../src/guestfs.pod:2388
5072 msgid ""
5073 "Bug fixes which are not controversial, fix obvious problems, and have been "
5074 "well tested are backported."
5075 msgstr ""
5076
5077 # type: textblock
5078 #. type: textblock
5079 #: ../src/guestfs.pod:2393
5080 msgid ""
5081 "Simple rearrangements of code which shouldn't affect how it works get "
5082 "backported.  This is so that the code in the two branches doesn't get too "
5083 "far out of step, allowing us to backport future fixes more easily."
5084 msgstr ""
5085
5086 # type: textblock
5087 #. type: textblock
5088 #: ../src/guestfs.pod:2399
5089 msgid ""
5090 "We I<don't> backport new features, new APIs, new tools etc, except in one "
5091 "exceptional case: the new feature is required in order to implement an "
5092 "important bug fix."
5093 msgstr ""
5094
5095 # type: textblock
5096 #. type: textblock
5097 #: ../src/guestfs.pod:2405
5098 msgid ""
5099 "A new stable branch starts when we think the new features in development are "
5100 "substantial and compelling enough over the current stable branch to warrant "
5101 "it.  When that happens we create new stable and development versions 1.N.0 "
5102 "and 1.(N+1).0 [N is even].  The new dot-oh release won't necessarily be so "
5103 "stable at this point, but by backporting fixes from development, that branch "
5104 "will stabilize over time."
5105 msgstr ""
5106
5107 #. type: =head1
5108 #: ../src/guestfs.pod:2413
5109 msgid "EXTENDING LIBGUESTFS"
5110 msgstr ""
5111
5112 #. type: =head2
5113 #: ../src/guestfs.pod:2415
5114 msgid "ADDING A NEW API ACTION"
5115 msgstr ""
5116
5117 #. type: textblock
5118 #: ../src/guestfs.pod:2417
5119 msgid ""
5120 "Large amounts of boilerplate code in libguestfs (RPC, bindings, "
5121 "documentation) are generated, and this makes it easy to extend the "
5122 "libguestfs API."
5123 msgstr ""
5124
5125 #. type: textblock
5126 #: ../src/guestfs.pod:2421
5127 msgid "To add a new API action there are two changes:"
5128 msgstr ""
5129
5130 #. type: textblock
5131 #: ../src/guestfs.pod:2427
5132 msgid ""
5133 "You need to add a description of the call (name, parameters, return type, "
5134 "tests, documentation) to C<generator/generator_actions.ml>."
5135 msgstr ""
5136
5137 #. type: textblock
5138 #: ../src/guestfs.pod:2430
5139 msgid ""
5140 "There are two sorts of API action, depending on whether the call goes "
5141 "through to the daemon in the appliance, or is serviced entirely by the "
5142 "library (see L</ARCHITECTURE> above).  L</guestfs_sync> is an example of the "
5143 "former, since the sync is done in the appliance.  L</guestfs_set_trace> is "
5144 "an example of the latter, since a trace flag is maintained in the handle and "
5145 "all tracing is done on the library side."
5146 msgstr ""
5147
5148 #. type: textblock
5149 #: ../src/guestfs.pod:2438
5150 msgid ""
5151 "Most new actions are of the first type, and get added to the "
5152 "C<daemon_functions> list.  Each function has a unique procedure number used "
5153 "in the RPC protocol which is assigned to that action when we publish "
5154 "libguestfs and cannot be reused.  Take the latest procedure number and "
5155 "increment it."
5156 msgstr ""
5157
5158 #. type: textblock
5159 #: ../src/guestfs.pod:2444
5160 msgid ""
5161 "For library-only actions of the second type, add to the "
5162 "C<non_daemon_functions> list.  Since these functions are serviced by the "
5163 "library and do not travel over the RPC mechanism to the daemon, these "
5164 "functions do not need a procedure number, and so the procedure number is set "
5165 "to C<-1>."
5166 msgstr ""
5167
5168 #. type: textblock
5169 #: ../src/guestfs.pod:2452
5170 msgid "Implement the action (in C):"
5171 msgstr ""
5172
5173 #. type: textblock
5174 #: ../src/guestfs.pod:2454
5175 msgid ""
5176 "For daemon actions, implement the function C<do_E<lt>nameE<gt>> in the "
5177 "C<daemon/> directory."
5178 msgstr ""
5179
5180 #. type: textblock
5181 #: ../src/guestfs.pod:2457
5182 msgid ""
5183 "For library actions, implement the function C<guestfs__E<lt>nameE<gt>> "
5184 "(note: double underscore) in the C<src/> directory."
5185 msgstr ""
5186
5187 #. type: textblock
5188 #: ../src/guestfs.pod:2460
5189 msgid "In either case, use another function as an example of what to do."
5190 msgstr ""
5191
5192 #. type: textblock
5193 #: ../src/guestfs.pod:2464
5194 msgid "After making these changes, use C<make> to compile."
5195 msgstr ""
5196
5197 #. type: textblock
5198 #: ../src/guestfs.pod:2466
5199 msgid ""
5200 "Note that you don't need to implement the RPC, language bindings, manual "
5201 "pages or anything else.  It's all automatically generated from the OCaml "
5202 "description."
5203 msgstr ""
5204
5205 #. type: =head2
5206 #: ../src/guestfs.pod:2470
5207 msgid "ADDING TESTS FOR AN API ACTION"
5208 msgstr ""
5209
5210 #. type: textblock
5211 #: ../src/guestfs.pod:2472
5212 msgid ""
5213 "You can supply zero or as many tests as you want per API call.  The tests "
5214 "can either be added as part of the API description (C<generator/"
5215 "generator_actions.ml>), or in some rarer cases you may want to drop a script "
5216 "into C<regressions/>.  Note that adding a script to C<regressions/> is "
5217 "slower, so if possible use the first method."
5218 msgstr ""
5219
5220 #. type: textblock
5221 #: ../src/guestfs.pod:2478
5222 msgid ""
5223 "The following describes the test environment used when you add an API test "
5224 "in C<generator_actions.ml>."
5225 msgstr ""
5226
5227 #. type: textblock
5228 #: ../src/guestfs.pod:2481
5229 msgid "The test environment has 4 block devices:"
5230 msgstr ""
5231
5232 #. type: =item
5233 #: ../src/guestfs.pod:2485
5234 msgid "C</dev/sda> 500MB"
5235 msgstr ""
5236
5237 #. type: textblock
5238 #: ../src/guestfs.pod:2487
5239 msgid "General block device for testing."
5240 msgstr ""
5241
5242 #. type: =item
5243 #: ../src/guestfs.pod:2489
5244 msgid "C</dev/sdb> 50MB"
5245 msgstr ""
5246
5247 #. type: textblock
5248 #: ../src/guestfs.pod:2491
5249 msgid ""
5250 "C</dev/sdb1> is an ext2 filesystem used for testing filesystem write "
5251 "operations."
5252 msgstr ""
5253
5254 #. type: =item
5255 #: ../src/guestfs.pod:2494
5256 msgid "C</dev/sdc> 10MB"
5257 msgstr ""
5258
5259 #. type: textblock
5260 #: ../src/guestfs.pod:2496
5261 msgid "Used in a few tests where two block devices are needed."
5262 msgstr ""
5263
5264 #. type: =item
5265 #: ../src/guestfs.pod:2498
5266 msgid "C</dev/sdd>"
5267 msgstr ""
5268
5269 #. type: textblock
5270 #: ../src/guestfs.pod:2500
5271 msgid "ISO with fixed content (see C<images/test.iso>)."
5272 msgstr ""
5273
5274 #. type: textblock
5275 #: ../src/guestfs.pod:2504
5276 msgid ""
5277 "To be able to run the tests in a reasonable amount of time, the libguestfs "
5278 "appliance and block devices are reused between tests.  So don't try testing "
5279 "L</guestfs_kill_subprocess> :-x"
5280 msgstr ""
5281
5282 #. type: textblock
5283 #: ../src/guestfs.pod:2508
5284 msgid ""
5285 "Each test starts with an initial scenario, selected using one of the "
5286 "C<Init*> expressions, described in C<generator/generator_types.ml>.  These "
5287 "initialize the disks mentioned above in a particular way as documented in "
5288 "C<generator_types.ml>.  You should not assume anything about the previous "
5289 "contents of other disks that are not initialized."
5290 msgstr ""
5291
5292 #. type: textblock
5293 #: ../src/guestfs.pod:2514
5294 msgid ""
5295 "You can add a prerequisite clause to any individual test.  This is a run-"
5296 "time check, which, if it fails, causes the test to be skipped.  Useful if "
5297 "testing a command which might not work on all variations of libguestfs "
5298 "builds.  A test that has prerequisite of C<Always> means to run "
5299 "unconditionally."
5300 msgstr ""
5301
5302 #. type: textblock
5303 #: ../src/guestfs.pod:2520
5304 msgid ""
5305 "In addition, packagers can skip individual tests by setting environment "
5306 "variables before running C<make check>."
5307 msgstr ""
5308
5309 #. type: verbatim
5310 #: ../src/guestfs.pod:2523
5311 #, no-wrap
5312 msgid ""
5313 " SKIP_TEST_<CMD>_<NUM>=1\n"
5314 "\n"
5315 msgstr ""
5316
5317 #. type: textblock
5318 #: ../src/guestfs.pod:2525
5319 msgid "eg: C<SKIP_TEST_COMMAND_3=1> skips test #3 of L</guestfs_command>."
5320 msgstr ""
5321
5322 #. type: textblock
5323 #: ../src/guestfs.pod:2527
5324 msgid "or:"
5325 msgstr ""
5326
5327 #. type: verbatim
5328 #: ../src/guestfs.pod:2529
5329 #, no-wrap
5330 msgid ""
5331 " SKIP_TEST_<CMD>=1\n"
5332 "\n"
5333 msgstr ""
5334
5335 #. type: textblock
5336 #: ../src/guestfs.pod:2531
5337 msgid "eg: C<SKIP_TEST_ZEROFREE=1> skips all L</guestfs_zerofree> tests."
5338 msgstr ""
5339
5340 #. type: textblock
5341 #: ../src/guestfs.pod:2533
5342 msgid "Packagers can run only certain tests by setting for example:"
5343 msgstr ""
5344
5345 #. type: verbatim
5346 #: ../src/guestfs.pod:2535
5347 #, no-wrap
5348 msgid ""
5349 " TEST_ONLY=\"vfs_type zerofree\"\n"
5350 "\n"
5351 msgstr ""
5352
5353 #. type: textblock
5354 #: ../src/guestfs.pod:2537
5355 msgid ""
5356 "See C<capitests/tests.c> for more details of how these environment variables "
5357 "work."
5358 msgstr ""
5359
5360 #. type: =head2
5361 #: ../src/guestfs.pod:2540
5362 msgid "DEBUGGING NEW API ACTIONS"
5363 msgstr ""
5364
5365 #. type: textblock
5366 #: ../src/guestfs.pod:2542
5367 msgid "Test new actions work before submitting them."
5368 msgstr ""
5369
5370 #. type: textblock
5371 #: ../src/guestfs.pod:2544
5372 msgid "You can use guestfish to try out new commands."
5373 msgstr ""
5374
5375 #. type: textblock
5376 #: ../src/guestfs.pod:2546
5377 msgid ""
5378 "Debugging the daemon is a problem because it runs inside a minimal "
5379 "environment.  However you can fprintf messages in the daemon to stderr, and "
5380 "they will show up if you use C<guestfish -v>."
5381 msgstr ""
5382
5383 #. type: =head2
5384 #: ../src/guestfs.pod:2550
5385 msgid "FORMATTING CODE AND OTHER CONVENTIONS"
5386 msgstr ""
5387
5388 #. type: textblock
5389 #: ../src/guestfs.pod:2552
5390 msgid ""
5391 "Our C source code generally adheres to some basic code-formatting "
5392 "conventions.  The existing code base is not totally consistent on this "
5393 "front, but we do prefer that contributed code be formatted similarly.  In "
5394 "short, use spaces-not-TABs for indentation, use 2 spaces for each "
5395 "indentation level, and other than that, follow the K&R style."
5396 msgstr ""
5397
5398 #. type: textblock
5399 #: ../src/guestfs.pod:2558
5400 msgid ""
5401 "If you use Emacs, add the following to one of one of your start-up files (e."
5402 "g., ~/.emacs), to help ensure that you get indentation right:"
5403 msgstr ""
5404
5405 #. type: verbatim
5406 #: ../src/guestfs.pod:2561
5407 #, no-wrap
5408 msgid ""
5409 " ;;; In libguestfs, indent with spaces everywhere (not TABs).\n"
5410 " ;;; Exceptions: Makefile and ChangeLog modes.\n"
5411 " (add-hook 'find-file-hook\n"
5412 "     '(lambda () (if (and buffer-file-name\n"
5413 "                          (string-match \"/libguestfs\\\\>\"\n"
5414 "                              (buffer-file-name))\n"
5415 "                          (not (string-equal mode-name \"Change Log\"))\n"
5416 "                          (not (string-equal mode-name \"Makefile\")))\n"
5417 "                     (setq indent-tabs-mode nil))))\n"
5418 " \n"
5419 msgstr ""
5420
5421 #. type: verbatim
5422 #: ../src/guestfs.pod:2571
5423 #, no-wrap
5424 msgid ""
5425 " ;;; When editing C sources in libguestfs, use this style.\n"
5426 " (defun libguestfs-c-mode ()\n"
5427 "   \"C mode with adjusted defaults for use with libguestfs.\"\n"
5428 "   (interactive)\n"
5429 "   (c-set-style \"K&R\")\n"
5430 "   (setq c-indent-level 2)\n"
5431 "   (setq c-basic-offset 2))\n"
5432 " (add-hook 'c-mode-hook\n"
5433 "           '(lambda () (if (string-match \"/libguestfs\\\\>\"\n"
5434 "                               (buffer-file-name))\n"
5435 "                           (libguestfs-c-mode))))\n"
5436 "\n"
5437 msgstr ""
5438
5439 #. type: textblock
5440 #: ../src/guestfs.pod:2583
5441 msgid "Enable warnings when compiling (and fix any problems this finds):"
5442 msgstr ""
5443
5444 #. type: verbatim
5445 #: ../src/guestfs.pod:2586
5446 #, no-wrap
5447 msgid ""
5448 " ./configure --enable-gcc-warnings\n"
5449 "\n"
5450 msgstr ""
5451
5452 #. type: textblock
5453 #: ../src/guestfs.pod:2588
5454 msgid "Useful targets are:"
5455 msgstr ""
5456
5457 #. type: verbatim
5458 #: ../src/guestfs.pod:2590
5459 #, no-wrap
5460 msgid ""
5461 " make syntax-check  # checks the syntax of the C code\n"
5462 " make check         # runs the test suite\n"
5463 "\n"
5464 msgstr ""
5465
5466 #. type: =head2
5467 #: ../src/guestfs.pod:2593
5468 msgid "DAEMON CUSTOM PRINTF FORMATTERS"
5469 msgstr ""
5470
5471 #. type: textblock
5472 #: ../src/guestfs.pod:2595
5473 msgid ""
5474 "In the daemon code we have created custom printf formatters C<%Q> and C<%R>, "
5475 "which are used to do shell quoting."
5476 msgstr ""
5477
5478 #. type: =item
5479 #: ../src/guestfs.pod:2600
5480 msgid "%Q"
5481 msgstr ""
5482
5483 #. type: textblock
5484 #: ../src/guestfs.pod:2602
5485 msgid ""
5486 "Simple shell quoted string.  Any spaces or other shell characters are "
5487 "escaped for you."
5488 msgstr ""
5489
5490 #. type: =item
5491 #: ../src/guestfs.pod:2605
5492 msgid "%R"
5493 msgstr ""
5494
5495 #. type: textblock
5496 #: ../src/guestfs.pod:2607
5497 msgid ""
5498 "Same as C<%Q> except the string is treated as a path which is prefixed by "
5499 "the sysroot."
5500 msgstr ""
5501
5502 # type: textblock
5503 #. type: textblock
5504 #: ../src/guestfs.pod:2612 ../fish/guestfish.pod:240 ../fish/guestfish.pod:613
5505 msgid "For example:"
5506 msgstr ""
5507
5508 #. type: verbatim
5509 #: ../src/guestfs.pod:2614
5510 #, no-wrap
5511 msgid ""
5512 " asprintf (&cmd, \"cat %R\", path);\n"
5513 "\n"
5514 msgstr ""
5515
5516 #. type: textblock
5517 #: ../src/guestfs.pod:2616
5518 msgid "would produce C<cat /sysroot/some\\ path\\ with\\ spaces>"
5519 msgstr ""
5520
5521 #. type: textblock
5522 #: ../src/guestfs.pod:2618
5523 msgid ""
5524 "I<Note:> Do I<not> use these when you are passing parameters to the C<command"
5525 "{,r,v,rv}()> functions.  These parameters do NOT need to be quoted because "
5526 "they are not passed via the shell (instead, straight to exec).  You probably "
5527 "want to use the C<sysroot_path()> function however."
5528 msgstr ""
5529
5530 #. type: =head2
5531 #: ../src/guestfs.pod:2624
5532 msgid "SUBMITTING YOUR NEW API ACTIONS"
5533 msgstr ""
5534
5535 #. type: textblock
5536 #: ../src/guestfs.pod:2626
5537 msgid ""
5538 "Submit patches to the mailing list: L<http://www.redhat.com/mailman/listinfo/"
5539 "libguestfs> and CC to L<rjones@redhat.com>."
5540 msgstr ""
5541
5542 #. type: =head2
5543 #: ../src/guestfs.pod:2630
5544 msgid "INTERNATIONALIZATION (I18N) SUPPORT"
5545 msgstr ""
5546
5547 #. type: textblock
5548 #: ../src/guestfs.pod:2632
5549 msgid "We support i18n (gettext anyhow) in the library."
5550 msgstr ""
5551
5552 #. type: textblock
5553 #: ../src/guestfs.pod:2634
5554 msgid ""
5555 "However many messages come from the daemon, and we don't translate those at "
5556 "the moment.  One reason is that the appliance generally has all locale files "
5557 "removed from it, because they take up a lot of space.  So we'd have to readd "
5558 "some of those, as well as copying our PO files into the appliance."
5559 msgstr ""
5560
5561 #. type: textblock
5562 #: ../src/guestfs.pod:2640
5563 msgid ""
5564 "Debugging messages are never translated, since they are intended for the "
5565 "programmers."
5566 msgstr ""
5567
5568 #. type: =head2
5569 #: ../src/guestfs.pod:2643
5570 msgid "SOURCE CODE SUBDIRECTORIES"
5571 msgstr ""
5572
5573 #. type: =item
5574 #: ../src/guestfs.pod:2647 ../src/guestfs-actions.pod:5854
5575 #: ../fish/guestfish-actions.pod:3948
5576 msgid "C<appliance>"
5577 msgstr ""
5578
5579 #. type: textblock
5580 #: ../src/guestfs.pod:2649
5581 msgid "The libguestfs appliance, build scripts and so on."
5582 msgstr ""
5583
5584 #. type: =item
5585 #: ../src/guestfs.pod:2651
5586 msgid "C<capitests>"
5587 msgstr ""
5588
5589 #. type: textblock
5590 #: ../src/guestfs.pod:2653
5591 msgid "Automated tests of the C API."
5592 msgstr ""
5593
5594 #. type: =item
5595 #: ../src/guestfs.pod:2655
5596 msgid "C<cat>"
5597 msgstr ""
5598
5599 #. type: textblock
5600 #: ../src/guestfs.pod:2657
5601 msgid ""
5602 "The L<virt-cat(1)>, L<virt-filesystems(1)> and L<virt-ls(1)> commands and "
5603 "documentation."
5604 msgstr ""
5605
5606 #. type: =item
5607 #: ../src/guestfs.pod:2660
5608 msgid "C<caution>"
5609 msgstr ""
5610
5611 #. type: textblock
5612 #: ../src/guestfs.pod:2662
5613 msgid ""
5614 "Safety and liveness tests of components that libguestfs depends upon (not of "
5615 "libguestfs itself).  Mainly this is for qemu and the kernel."
5616 msgstr ""
5617
5618 #. type: =item
5619 #: ../src/guestfs.pod:2665
5620 msgid "C<contrib>"
5621 msgstr ""
5622
5623 #. type: textblock
5624 #: ../src/guestfs.pod:2667
5625 msgid "Outside contributions, experimental parts."
5626 msgstr ""
5627
5628 #. type: =item
5629 #: ../src/guestfs.pod:2669
5630 msgid "C<daemon>"
5631 msgstr ""
5632
5633 #. type: textblock
5634 #: ../src/guestfs.pod:2671
5635 msgid ""
5636 "The daemon that runs inside the libguestfs appliance and carries out actions."
5637 msgstr ""
5638
5639 #. type: =item
5640 #: ../src/guestfs.pod:2674
5641 msgid "C<df>"
5642 msgstr ""
5643
5644 #. type: textblock
5645 #: ../src/guestfs.pod:2676
5646 msgid "L<virt-df(1)> command and documentation."
5647 msgstr ""
5648
5649 #. type: =item
5650 #: ../src/guestfs.pod:2678
5651 msgid "C<examples>"
5652 msgstr ""
5653
5654 #. type: textblock
5655 #: ../src/guestfs.pod:2680
5656 msgid "C API example code."
5657 msgstr ""
5658
5659 #. type: =item
5660 #: ../src/guestfs.pod:2682
5661 msgid "C<fish>"
5662 msgstr ""
5663
5664 #. type: textblock
5665 #: ../src/guestfs.pod:2684
5666 msgid ""
5667 "L<guestfish(1)>, the command-line shell, and various shell scripts built on "
5668 "top such as L<virt-copy-in(1)>, L<virt-copy-out(1)>, L<virt-tar-in(1)>, "
5669 "L<virt-tar-out(1)>."
5670 msgstr ""
5671
5672 #. type: =item
5673 #: ../src/guestfs.pod:2688
5674 msgid "C<fuse>"
5675 msgstr ""
5676
5677 #. type: textblock
5678 #: ../src/guestfs.pod:2690
5679 msgid ""
5680 "L<guestmount(1)>, FUSE (userspace filesystem) built on top of libguestfs."
5681 msgstr ""
5682
5683 #. type: =item
5684 #: ../src/guestfs.pod:2692
5685 msgid "C<generator>"
5686 msgstr ""
5687
5688 #. type: textblock
5689 #: ../src/guestfs.pod:2694
5690 msgid ""
5691 "The crucially important generator, used to automatically generate large "
5692 "amounts of boilerplate C code for things like RPC and bindings."
5693 msgstr ""
5694
5695 #. type: =item
5696 #: ../src/guestfs.pod:2697
5697 msgid "C<images>"
5698 msgstr ""
5699
5700 #. type: textblock
5701 #: ../src/guestfs.pod:2699
5702 msgid "Files used by the test suite."
5703 msgstr ""
5704
5705 #. type: textblock
5706 #: ../src/guestfs.pod:2701
5707 msgid "Some \"phony\" guest images which we test against."
5708 msgstr ""
5709
5710 #. type: =item
5711 #: ../src/guestfs.pod:2703
5712 msgid "C<inspector>"
5713 msgstr ""
5714
5715 #. type: textblock
5716 #: ../src/guestfs.pod:2705
5717 msgid "L<virt-inspector(1)>, the virtual machine image inspector."
5718 msgstr ""
5719
5720 #. type: =item
5721 #: ../src/guestfs.pod:2707
5722 msgid "C<logo>"
5723 msgstr ""
5724
5725 #. type: textblock
5726 #: ../src/guestfs.pod:2709
5727 msgid "Logo used on the website.  The fish is called Arthur by the way."
5728 msgstr ""
5729
5730 #. type: =item
5731 #: ../src/guestfs.pod:2711
5732 msgid "C<m4>"
5733 msgstr ""
5734
5735 #. type: textblock
5736 #: ../src/guestfs.pod:2713
5737 msgid "M4 macros used by autoconf."
5738 msgstr ""
5739
5740 #. type: =item
5741 #: ../src/guestfs.pod:2715
5742 msgid "C<po>"
5743 msgstr ""
5744
5745 #. type: textblock
5746 #: ../src/guestfs.pod:2717
5747 msgid "Translations of simple gettext strings."
5748 msgstr ""
5749
5750 #. type: =item
5751 #: ../src/guestfs.pod:2719
5752 msgid "C<po-docs>"
5753 msgstr ""
5754
5755 #. type: textblock
5756 #: ../src/guestfs.pod:2721
5757 msgid ""
5758 "The build infrastructure and PO files for translations of manpages and POD "
5759 "files.  Eventually this will be combined with the C<po> directory, but that "
5760 "is rather complicated."
5761 msgstr ""
5762
5763 #. type: =item
5764 #: ../src/guestfs.pod:2725
5765 msgid "C<regressions>"
5766 msgstr ""
5767
5768 #. type: textblock
5769 #: ../src/guestfs.pod:2727
5770 msgid "Regression tests."
5771 msgstr ""
5772
5773 #. type: =item
5774 #: ../src/guestfs.pod:2729
5775 msgid "C<rescue>"
5776 msgstr ""
5777
5778 #. type: textblock
5779 #: ../src/guestfs.pod:2731
5780 msgid "L<virt-rescue(1)> command and documentation."
5781 msgstr ""
5782
5783 #. type: =item
5784 #: ../src/guestfs.pod:2733
5785 msgid "C<src>"
5786 msgstr ""
5787
5788 #. type: textblock
5789 #: ../src/guestfs.pod:2735
5790 msgid "Source code to the C library."
5791 msgstr ""
5792
5793 #. type: =item
5794 #: ../src/guestfs.pod:2737
5795 msgid "C<tools>"
5796 msgstr ""
5797
5798 #. type: textblock
5799 #: ../src/guestfs.pod:2739
5800 msgid "Command line tools written in Perl (L<virt-resize(1)> and many others)."
5801 msgstr ""
5802
5803 #. type: =item
5804 #: ../src/guestfs.pod:2741
5805 msgid "C<test-tool>"
5806 msgstr ""
5807
5808 #. type: textblock
5809 #: ../src/guestfs.pod:2743
5810 msgid ""
5811 "Test tool for end users to test if their qemu/kernel combination will work "
5812 "with libguestfs."
5813 msgstr ""
5814
5815 #. type: =item
5816 #: ../src/guestfs.pod:2746
5817 msgid "C<csharp>"
5818 msgstr ""
5819
5820 #. type: =item
5821 #: ../src/guestfs.pod:2748
5822 msgid "C<haskell>"
5823 msgstr ""
5824
5825 #. type: =item
5826 #: ../src/guestfs.pod:2750
5827 msgid "C<java>"
5828 msgstr ""
5829
5830 #. type: =item
5831 #: ../src/guestfs.pod:2752
5832 msgid "C<ocaml>"
5833 msgstr ""
5834
5835 #. type: =item
5836 #: ../src/guestfs.pod:2754
5837 msgid "C<php>"
5838 msgstr ""
5839
5840 #. type: =item
5841 #: ../src/guestfs.pod:2756
5842 msgid "C<perl>"
5843 msgstr ""
5844
5845 #. type: =item
5846 #: ../src/guestfs.pod:2758
5847 msgid "C<python>"
5848 msgstr ""
5849
5850 #. type: =item
5851 #: ../src/guestfs.pod:2760
5852 msgid "C<ruby>"
5853 msgstr ""
5854
5855 #. type: textblock
5856 #: ../src/guestfs.pod:2762
5857 msgid "Language bindings."
5858 msgstr ""
5859
5860 #. type: =head1
5861 #: ../src/guestfs.pod:2766
5862 msgid "LIMITS"
5863 msgstr ""
5864
5865 # type: =head2
5866 #. type: =head2
5867 #: ../src/guestfs.pod:2768
5868 msgid "PROTOCOL LIMITS"
5869 msgstr ""
5870
5871 # type: textblock
5872 #. type: textblock
5873 #: ../src/guestfs.pod:2770
5874 msgid ""
5875 "Internally libguestfs uses a message-based protocol to pass API calls and "
5876 "their responses to and from a small \"appliance\" (see L</INTERNALS> for "
5877 "plenty more detail about this).  The maximum message size used by the "
5878 "protocol is slightly less than 4 MB.  For some API calls you may need to be "
5879 "aware of this limit.  The API calls which may be affected are individually "
5880 "documented, with a link back to this section of the documentation."
5881 msgstr ""
5882
5883 # type: textblock
5884 #. type: textblock
5885 #: ../src/guestfs.pod:2778
5886 msgid ""
5887 "A simple call such as L</guestfs_cat> returns its result (the file data) in "
5888 "a simple string.  Because this string is at some point internally encoded as "
5889 "a message, the maximum size that it can return is slightly under 4 MB.  If "
5890 "the requested file is larger than this then you will get an error."
5891 msgstr ""
5892
5893 # type: textblock
5894 #. type: textblock
5895 #: ../src/guestfs.pod:2784
5896 msgid ""
5897 "In order to transfer large files into and out of the guest filesystem, you "
5898 "need to use particular calls that support this.  The sections L</UPLOADING> "
5899 "and L</DOWNLOADING> document how to do this."
5900 msgstr ""
5901
5902 # type: textblock
5903 #. type: textblock
5904 #: ../src/guestfs.pod:2788
5905 msgid ""
5906 "You might also consider mounting the disk image using our FUSE filesystem "
5907 "support (L<guestmount(1)>)."
5908 msgstr ""
5909
5910 #. type: =head2
5911 #: ../src/guestfs.pod:2791
5912 msgid "MAXIMUM NUMBER OF DISKS"
5913 msgstr ""
5914
5915 #. type: textblock
5916 #: ../src/guestfs.pod:2793
5917 msgid "When using virtio disks (the default) the current limit is B<25> disks."
5918 msgstr ""
5919
5920 #. type: textblock
5921 #: ../src/guestfs.pod:2796
5922 msgid ""
5923 "Virtio itself consumes 1 virtual PCI slot per disk, and PCI is limited to 31 "
5924 "slots.  However febootstrap only understands disks with names C</dev/vda> "
5925 "through C</dev/vdz> (26 letters) and it reserves one disk for its own "
5926 "purposes."
5927 msgstr ""
5928
5929 #. type: textblock
5930 #: ../src/guestfs.pod:2801
5931 msgid ""
5932 "We are working to substantially raise this limit in future versions but it "
5933 "requires complex changes to qemu."
5934 msgstr ""
5935
5936 #. type: textblock
5937 #: ../src/guestfs.pod:2804
5938 msgid ""
5939 "In future versions of libguestfs it should also be possible to \"hot plug\" "
5940 "disks (add and remove disks after calling L</guestfs_launch>).  This also "
5941 "requires changes to qemu."
5942 msgstr ""
5943
5944 #. type: =head2
5945 #: ../src/guestfs.pod:2808
5946 msgid "MAXIMUM NUMBER OF PARTITIONS PER DISK"
5947 msgstr ""
5948
5949 #. type: textblock
5950 #: ../src/guestfs.pod:2810
5951 msgid "Virtio limits the maximum number of partitions per disk to B<15>."
5952 msgstr ""
5953
5954 #. type: textblock
5955 #: ../src/guestfs.pod:2812
5956 msgid ""
5957 "This is because it reserves 4 bits for the minor device number (thus C</dev/"
5958 "vda>, and C</dev/vda1> through C</dev/vda15>)."
5959 msgstr ""
5960
5961 #. type: textblock
5962 #: ../src/guestfs.pod:2815
5963 msgid ""
5964 "If you attach a disk with more than 15 partitions, the extra partitions are "
5965 "ignored by libguestfs."
5966 msgstr ""
5967
5968 #. type: =head2
5969 #: ../src/guestfs.pod:2818
5970 msgid "MAXIMUM SIZE OF A DISK"
5971 msgstr ""
5972
5973 #. type: textblock
5974 #: ../src/guestfs.pod:2820
5975 msgid "Probably the limit is between 2**63-1 and 2**64-1 bytes."
5976 msgstr ""
5977
5978 #. type: textblock
5979 #: ../src/guestfs.pod:2822
5980 msgid ""
5981 "We have tested block devices up to 1 exabyte (2**60 or "
5982 "1,152,921,504,606,846,976 bytes) using sparse files backed by an XFS host "
5983 "filesystem."
5984 msgstr ""
5985
5986 #. type: textblock
5987 #: ../src/guestfs.pod:2826
5988 msgid ""
5989 "Although libguestfs probably does not impose any limit, the underlying host "
5990 "storage will.  If you store disk images on a host ext4 filesystem, then the "
5991 "maximum size will be limited by the maximum ext4 file size (currently 16 "
5992 "TB).  If you store disk images as host logical volumes then you are limited "
5993 "by the maximum size of an LV."
5994 msgstr ""
5995
5996 #. type: textblock
5997 #: ../src/guestfs.pod:2832
5998 msgid ""
5999 "For the hugest disk image files, we recommend using XFS on the host for "
6000 "storage."
6001 msgstr ""
6002
6003 #. type: =head2
6004 #: ../src/guestfs.pod:2835
6005 msgid "MAXIMUM SIZE OF A PARTITION"
6006 msgstr ""
6007
6008 #. type: textblock
6009 #: ../src/guestfs.pod:2837
6010 msgid ""
6011 "The MBR (ie. classic MS-DOS) partitioning scheme uses 32 bit sector "
6012 "numbers.  Assuming a 512 byte sector size, this means that MBR cannot "
6013 "address a partition located beyond 2 TB on the disk."
6014 msgstr ""
6015
6016 #. type: textblock
6017 #: ../src/guestfs.pod:2841
6018 msgid ""
6019 "It is recommended that you use GPT partitions on disks which are larger than "
6020 "this size.  GPT uses 64 bit sector numbers and so can address partitions "
6021 "which are theoretically larger than the largest disk we could support."
6022 msgstr ""
6023
6024 #. type: =head2
6025 #: ../src/guestfs.pod:2846
6026 msgid "MAXIMUM SIZE OF A FILESYSTEM, FILES, DIRECTORIES"
6027 msgstr ""
6028
6029 #. type: textblock
6030 #: ../src/guestfs.pod:2848
6031 msgid ""
6032 "This depends on the filesystem type.  libguestfs itself does not impose any "
6033 "known limit.  Consult Wikipedia or the filesystem documentation to find out "
6034 "what these limits are."
6035 msgstr ""
6036
6037 #. type: =head2
6038 #: ../src/guestfs.pod:2852
6039 msgid "MAXIMUM UPLOAD AND DOWNLOAD"
6040 msgstr ""
6041
6042 #. type: textblock
6043 #: ../src/guestfs.pod:2854
6044 msgid ""
6045 "The API functions L</guestfs_upload>, L</guestfs_download>, L</"
6046 "guestfs_tar_in>, L</guestfs_tar_out> and the like allow unlimited sized "
6047 "uploads and downloads."
6048 msgstr ""
6049
6050 #. type: =head2
6051 #: ../src/guestfs.pod:2858
6052 msgid "INSPECTION LIMITS"
6053 msgstr ""
6054
6055 #. type: textblock
6056 #: ../src/guestfs.pod:2860
6057 msgid ""
6058 "The inspection code has several arbitrary limits on things like the size of "
6059 "Windows Registry hive it will read, and the length of product name.  These "
6060 "are intended to stop a malicious guest from consuming arbitrary amounts of "
6061 "memory and disk space on the host, and should not be reached in practice.  "
6062 "See the source code for more information."
6063 msgstr ""
6064
6065 # type: =head1
6066 #. type: =head1
6067 #: ../src/guestfs.pod:2866 ../fish/guestfish.pod:1026
6068 #: ../test-tool/libguestfs-test-tool.pod:82 ../tools/virt-edit.pl:476
6069 msgid "ENVIRONMENT VARIABLES"
6070 msgstr ""
6071
6072 # type: =item
6073 #. type: =item
6074 #: ../src/guestfs.pod:2870 ../fish/guestfish.pod:1052
6075 msgid "LIBGUESTFS_APPEND"
6076 msgstr ""
6077
6078 # type: textblock
6079 #. type: textblock
6080 #: ../src/guestfs.pod:2872 ../fish/guestfish.pod:1054
6081 msgid "Pass additional options to the guest kernel."
6082 msgstr ""
6083
6084 # type: =item
6085 #. type: =item
6086 #: ../src/guestfs.pod:2874 ../fish/guestfish.pod:1056
6087 msgid "LIBGUESTFS_DEBUG"
6088 msgstr ""
6089
6090 # type: textblock
6091 #. type: textblock
6092 #: ../src/guestfs.pod:2876
6093 msgid ""
6094 "Set C<LIBGUESTFS_DEBUG=1> to enable verbose messages.  This has the same "
6095 "effect as calling C<guestfs_set_verbose (g, 1)>."
6096 msgstr ""
6097
6098 # type: =item
6099 #. type: =item
6100 #: ../src/guestfs.pod:2879 ../fish/guestfish.pod:1061
6101 msgid "LIBGUESTFS_MEMSIZE"
6102 msgstr ""
6103
6104 # type: textblock
6105 #. type: textblock
6106 #: ../src/guestfs.pod:2881 ../fish/guestfish.pod:1063
6107 msgid ""
6108 "Set the memory allocated to the qemu process, in megabytes.  For example:"
6109 msgstr ""
6110
6111 # type: verbatim
6112 #. type: verbatim
6113 #: ../src/guestfs.pod:2884 ../fish/guestfish.pod:1066
6114 #, no-wrap
6115 msgid ""
6116 " LIBGUESTFS_MEMSIZE=700\n"
6117 "\n"
6118 msgstr ""
6119
6120 # type: =item
6121 #. type: =item
6122 #: ../src/guestfs.pod:2886 ../fish/guestfish.pod:1068
6123 msgid "LIBGUESTFS_PATH"
6124 msgstr ""
6125
6126 #. type: textblock
6127 #: ../src/guestfs.pod:2888
6128 msgid ""
6129 "Set the path that libguestfs uses to search for a supermin appliance.  See "
6130 "the discussion of paths in section L</PATH> above."
6131 msgstr ""
6132
6133 # type: =item
6134 #. type: =item
6135 #: ../src/guestfs.pod:2891 ../fish/guestfish.pod:1073
6136 msgid "LIBGUESTFS_QEMU"
6137 msgstr ""
6138
6139 # type: textblock
6140 #. type: textblock
6141 #: ../src/guestfs.pod:2893 ../fish/guestfish.pod:1075
6142 msgid ""
6143 "Set the default qemu binary that libguestfs uses.  If not set, then the qemu "
6144 "which was found at compile time by the configure script is used."
6145 msgstr ""
6146
6147 # type: textblock
6148 #. type: textblock
6149 #: ../src/guestfs.pod:2897
6150 msgid "See also L</QEMU WRAPPERS> above."
6151 msgstr ""
6152
6153 # type: =item
6154 #. type: =item
6155 #: ../src/guestfs.pod:2899 ../fish/guestfish.pod:1079
6156 msgid "LIBGUESTFS_TRACE"
6157 msgstr ""
6158
6159 # type: textblock
6160 #. type: textblock
6161 #: ../src/guestfs.pod:2901
6162 msgid ""
6163 "Set C<LIBGUESTFS_TRACE=1> to enable command traces.  This has the same "
6164 "effect as calling C<guestfs_set_trace (g, 1)>."
6165 msgstr ""
6166
6167 # type: =item
6168 #. type: =item
6169 #: ../src/guestfs.pod:2904 ../fish/guestfish.pod:1088
6170 msgid "TMPDIR"
6171 msgstr ""
6172
6173 #. type: textblock
6174 #: ../src/guestfs.pod:2906 ../fish/guestfish.pod:1090
6175 msgid ""
6176 "Location of temporary directory, defaults to C</tmp> except for the cached "
6177 "supermin appliance which defaults to C</var/tmp>."
6178 msgstr ""
6179
6180 #. type: textblock
6181 #: ../src/guestfs.pod:2909 ../fish/guestfish.pod:1093
6182 msgid ""
6183 "If libguestfs was compiled to use the supermin appliance then the real "
6184 "appliance is cached in this directory, shared between all handles belonging "
6185 "to the same EUID.  You can use C<$TMPDIR> to configure another directory to "
6186 "use in case C</var/tmp> is not large enough."
6187 msgstr ""
6188
6189 # type: =head1
6190 #. type: =head1
6191 #: ../src/guestfs.pod:2917 ../fish/guestfish.pod:1160
6192 #: ../test-tool/libguestfs-test-tool.pod:87 ../fuse/guestmount.pod:277
6193 #: ../tools/virt-edit.pl:496 ../tools/virt-win-reg.pl:572
6194 #: ../tools/virt-list-filesystems.pl:189 ../tools/virt-tar.pl:286
6195 #: ../tools/virt-make-fs.pl:539 ../tools/virt-list-partitions.pl:257
6196 msgid "SEE ALSO"
6197 msgstr ""
6198
6199 #. type: textblock
6200 #: ../src/guestfs.pod:2919
6201 msgid ""
6202 "L<guestfs-examples(3)>, L<guestfs-ocaml(3)>, L<guestfs-perl(3)>, L<guestfs-"
6203 "python(3)>, L<guestfs-ruby(3)>, L<guestfish(1)>, L<guestmount(1)>, L<virt-cat"
6204 "(1)>, L<virt-copy-in(1)>, L<virt-copy-out(1)>, L<virt-df(1)>, L<virt-edit(1)"
6205 ">, L<virt-filesystems(1)>, L<virt-inspector(1)>, L<virt-list-filesystems(1)"
6206 ">, L<virt-list-partitions(1)>, L<virt-ls(1)>, L<virt-make-fs(1)>, L<virt-"
6207 "rescue(1)>, L<virt-tar(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>, L<virt-"
6208 "win-reg(1)>, L<qemu(1)>, L<febootstrap(1)>, L<hivex(3)>, L<http://libguestfs."
6209 "org/>."
6210 msgstr ""
6211
6212 # type: textblock
6213 #. type: textblock
6214 #: ../src/guestfs.pod:2947
6215 msgid ""
6216 "Tools with a similar purpose: L<fdisk(8)>, L<parted(8)>, L<kpartx(8)>, L<lvm"
6217 "(8)>, L<disktype(1)>."
6218 msgstr ""
6219
6220 # type: =head1
6221 #. type: =head1
6222 #: ../src/guestfs.pod:2954 ../tools/virt-win-reg.pl:587
6223 #: ../tools/virt-make-fs.pl:553
6224 msgid "BUGS"
6225 msgstr ""
6226
6227 # type: textblock
6228 #. type: textblock
6229 #: ../src/guestfs.pod:2956
6230 msgid "To get a list of bugs against libguestfs use this link:"
6231 msgstr ""
6232
6233 # type: textblock
6234 #. type: textblock
6235 #: ../src/guestfs.pod:2958
6236 msgid ""
6237 "L<https://bugzilla.redhat.com/buglist.cgi?"
6238 "component=libguestfs&product=Virtualization+Tools>"
6239 msgstr ""
6240
6241 # type: textblock
6242 #. type: textblock
6243 #: ../src/guestfs.pod:2960
6244 msgid "To report a new bug against libguestfs use this link:"
6245 msgstr ""
6246
6247 # type: textblock
6248 #. type: textblock
6249 #: ../src/guestfs.pod:2962
6250 msgid ""
6251 "L<https://bugzilla.redhat.com/enter_bug.cgi?"
6252 "component=libguestfs&product=Virtualization+Tools>"
6253 msgstr ""
6254
6255 # type: textblock
6256 #. type: textblock
6257 #: ../src/guestfs.pod:2964
6258 msgid "When reporting a bug, please check:"
6259 msgstr ""
6260
6261 # type: textblock
6262 #. type: textblock
6263 #: ../src/guestfs.pod:2970
6264 msgid "That the bug hasn't been reported already."
6265 msgstr ""
6266
6267 # type: textblock
6268 #. type: textblock
6269 #: ../src/guestfs.pod:2974
6270 msgid "That you are testing a recent version."
6271 msgstr ""
6272
6273 # type: textblock
6274 #. type: textblock
6275 #: ../src/guestfs.pod:2978
6276 msgid "Describe the bug accurately, and give a way to reproduce it."
6277 msgstr ""
6278
6279 # type: textblock
6280 #. type: textblock
6281 #: ../src/guestfs.pod:2982
6282 msgid ""
6283 "Run libguestfs-test-tool and paste the B<complete, unedited> output into the "
6284 "bug report."
6285 msgstr ""
6286
6287 # type: =head1
6288 #. type: =head1
6289 #: ../src/guestfs.pod:2987 ../fish/guestfish.pod:1183
6290 #: ../test-tool/libguestfs-test-tool.pod:93 ../fuse/guestmount.pod:288
6291 msgid "AUTHORS"
6292 msgstr ""
6293
6294 # type: textblock
6295 #. type: textblock
6296 #: ../src/guestfs.pod:2989 ../fish/guestfish.pod:1185
6297 #: ../test-tool/libguestfs-test-tool.pod:95 ../fuse/guestmount.pod:290
6298 msgid "Richard W.M. Jones (C<rjones at redhat dot com>)"
6299 msgstr ""
6300
6301 # type: =head1
6302 #. type: =head1
6303 #: ../src/guestfs.pod:2991 ../fish/guestfish.pod:1187
6304 #: ../test-tool/libguestfs-test-tool.pod:97 ../fuse/guestmount.pod:292
6305 #: ../tools/virt-edit.pl:514 ../tools/virt-win-reg.pl:602
6306 #: ../tools/virt-list-filesystems.pl:206 ../tools/virt-tar.pl:305
6307 #: ../tools/virt-make-fs.pl:568 ../tools/virt-list-partitions.pl:273
6308 msgid "COPYRIGHT"
6309 msgstr ""
6310
6311 #. type: textblock
6312 #: ../src/guestfs.pod:2993 ../fish/guestfish.pod:1189
6313 #: ../test-tool/libguestfs-test-tool.pod:99
6314 msgid "Copyright (C) 2009-2011 Red Hat Inc.  L<http://libguestfs.org/>"
6315 msgstr ""
6316
6317 # type: textblock
6318 #. type: textblock
6319 #: ../src/guestfs.pod:2996
6320 msgid ""
6321 "This library is free software; you can redistribute it and/or modify it "
6322 "under the terms of the GNU Lesser General Public License as published by the "
6323 "Free Software Foundation; either version 2 of the License, or (at your "
6324 "option) any later version."
6325 msgstr ""
6326
6327 # type: textblock
6328 #. type: textblock
6329 #: ../src/guestfs.pod:3001
6330 msgid ""
6331 "This library is distributed in the hope that it will be useful, but WITHOUT "
6332 "ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or "
6333 "FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public License "
6334 "for more details."
6335 msgstr ""
6336
6337 # type: textblock
6338 #. type: textblock
6339 #: ../src/guestfs.pod:3006
6340 msgid ""
6341 "You should have received a copy of the GNU Lesser General Public License "
6342 "along with this library; if not, write to the Free Software Foundation, "
6343 "Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA"
6344 msgstr ""
6345
6346 # type: =head2
6347 #. type: =head2
6348 #: ../src/guestfs-actions.pod:1
6349 msgid "guestfs_add_cdrom"
6350 msgstr ""
6351
6352 # type: verbatim
6353 #. type: verbatim
6354 #: ../src/guestfs-actions.pod:3
6355 #, no-wrap
6356 msgid ""
6357 " int\n"
6358 " guestfs_add_cdrom (guestfs_h *g,\n"
6359 "                    const char *filename);\n"
6360 "\n"
6361 msgstr ""
6362
6363 # type: textblock
6364 #. type: textblock
6365 #: ../src/guestfs-actions.pod:7 ../fish/guestfish-actions.pod:5
6366 msgid "This function adds a virtual CD-ROM disk image to the guest."
6367 msgstr ""
6368
6369 #. type: textblock
6370 #: ../src/guestfs-actions.pod:9 ../fish/guestfish-actions.pod:7
6371 msgid "This is equivalent to the qemu parameter I<-cdrom filename>."
6372 msgstr ""
6373
6374 # type: textblock
6375 #. type: textblock
6376 #: ../src/guestfs-actions.pod:17
6377 msgid ""
6378 "This call checks for the existence of C<filename>.  This stops you from "
6379 "specifying other types of drive which are supported by qemu such as C<nbd:> "
6380 "and C<http:> URLs.  To specify those, use the general C<guestfs_config> call "
6381 "instead."
6382 msgstr ""
6383
6384 # type: textblock
6385 #. type: textblock
6386 #: ../src/guestfs-actions.pod:24
6387 msgid ""
6388 "If you just want to add an ISO file (often you use this as an efficient way "
6389 "to transfer large files into the guest), then you should probably use "
6390 "C<guestfs_add_drive_ro> instead."
6391 msgstr ""
6392
6393 # type: textblock
6394 #. type: textblock
6395 #: ../src/guestfs-actions.pod:30 ../src/guestfs-actions.pod:134
6396 #: ../src/guestfs-actions.pod:195 ../src/guestfs-actions.pod:232
6397 #: ../src/guestfs-actions.pod:246 ../src/guestfs-actions.pod:267
6398 #: ../src/guestfs-actions.pod:287 ../src/guestfs-actions.pod:301
6399 #: ../src/guestfs-actions.pod:421 ../src/guestfs-actions.pod:441
6400 #: ../src/guestfs-actions.pod:455 ../src/guestfs-actions.pod:500
6401 #: ../src/guestfs-actions.pod:528 ../src/guestfs-actions.pod:546
6402 #: ../src/guestfs-actions.pod:613 ../src/guestfs-actions.pod:646
6403 #: ../src/guestfs-actions.pod:660 ../src/guestfs-actions.pod:675
6404 #: ../src/guestfs-actions.pod:774 ../src/guestfs-actions.pod:792
6405 #: ../src/guestfs-actions.pod:806 ../src/guestfs-actions.pod:820
6406 #: ../src/guestfs-actions.pod:981 ../src/guestfs-actions.pod:1001
6407 #: ../src/guestfs-actions.pod:1019 ../src/guestfs-actions.pod:1103
6408 #: ../src/guestfs-actions.pod:1121 ../src/guestfs-actions.pod:1140
6409 #: ../src/guestfs-actions.pod:1154 ../src/guestfs-actions.pod:1174
6410 #: ../src/guestfs-actions.pod:1244 ../src/guestfs-actions.pod:1275
6411 #: ../src/guestfs-actions.pod:1300 ../src/guestfs-actions.pod:1342
6412 #: ../src/guestfs-actions.pod:1448 ../src/guestfs-actions.pod:1482
6413 #: ../src/guestfs-actions.pod:1697 ../src/guestfs-actions.pod:1719
6414 #: ../src/guestfs-actions.pod:1806 ../src/guestfs-actions.pod:2290
6415 #: ../src/guestfs-actions.pod:2434 ../src/guestfs-actions.pod:2495
6416 #: ../src/guestfs-actions.pod:2530 ../src/guestfs-actions.pod:3483
6417 #: ../src/guestfs-actions.pod:3498 ../src/guestfs-actions.pod:3523
6418 #: ../src/guestfs-actions.pod:3678 ../src/guestfs-actions.pod:3692
6419 #: ../src/guestfs-actions.pod:3705 ../src/guestfs-actions.pod:3719
6420 #: ../src/guestfs-actions.pod:3734 ../src/guestfs-actions.pod:3770
6421 #: ../src/guestfs-actions.pod:3842 ../src/guestfs-actions.pod:3862
6422 #: ../src/guestfs-actions.pod:3879 ../src/guestfs-actions.pod:3902
6423 #: ../src/guestfs-actions.pod:3925 ../src/guestfs-actions.pod:3957
6424 #: ../src/guestfs-actions.pod:3976 ../src/guestfs-actions.pod:3995
6425 #: ../src/guestfs-actions.pod:4030 ../src/guestfs-actions.pod:4042
6426 #: ../src/guestfs-actions.pod:4078 ../src/guestfs-actions.pod:4094
6427 #: ../src/guestfs-actions.pod:4107 ../src/guestfs-actions.pod:4122
6428 #: ../src/guestfs-actions.pod:4139 ../src/guestfs-actions.pod:4232
6429 #: ../src/guestfs-actions.pod:4252 ../src/guestfs-actions.pod:4265
6430 #: ../src/guestfs-actions.pod:4316 ../src/guestfs-actions.pod:4334
6431 #: ../src/guestfs-actions.pod:4352 ../src/guestfs-actions.pod:4368
6432 #: ../src/guestfs-actions.pod:4382 ../src/guestfs-actions.pod:4396
6433 #: ../src/guestfs-actions.pod:4413 ../src/guestfs-actions.pod:4428
6434 #: ../src/guestfs-actions.pod:4448 ../src/guestfs-actions.pod:4506
6435 #: ../src/guestfs-actions.pod:4579 ../src/guestfs-actions.pod:4610
6436 #: ../src/guestfs-actions.pod:4629 ../src/guestfs-actions.pod:4648
6437 #: ../src/guestfs-actions.pod:4660 ../src/guestfs-actions.pod:4677
6438 #: ../src/guestfs-actions.pod:4690 ../src/guestfs-actions.pod:4705
6439 #: ../src/guestfs-actions.pod:4720 ../src/guestfs-actions.pod:4755
6440 #: ../src/guestfs-actions.pod:4777 ../src/guestfs-actions.pod:4797
6441 #: ../src/guestfs-actions.pod:4811 ../src/guestfs-actions.pod:4828
6442 #: ../src/guestfs-actions.pod:4877 ../src/guestfs-actions.pod:4923
6443 #: ../src/guestfs-actions.pod:4937 ../src/guestfs-actions.pod:4965
6444 #: ../src/guestfs-actions.pod:4982 ../src/guestfs-actions.pod:5000
6445 #: ../src/guestfs-actions.pod:5134 ../src/guestfs-actions.pod:5191
6446 #: ../src/guestfs-actions.pod:5213 ../src/guestfs-actions.pod:5231
6447 #: ../src/guestfs-actions.pod:5263 ../src/guestfs-actions.pod:5329
6448 #: ../src/guestfs-actions.pod:5346 ../src/guestfs-actions.pod:5359
6449 #: ../src/guestfs-actions.pod:5373 ../src/guestfs-actions.pod:5662
6450 #: ../src/guestfs-actions.pod:5681 ../src/guestfs-actions.pod:5700
6451 #: ../src/guestfs-actions.pod:5712 ../src/guestfs-actions.pod:5724
6452 #: ../src/guestfs-actions.pod:5738 ../src/guestfs-actions.pod:5750
6453 #: ../src/guestfs-actions.pod:5764 ../src/guestfs-actions.pod:5780
6454 #: ../src/guestfs-actions.pod:5801 ../src/guestfs-actions.pod:5820
6455 #: ../src/guestfs-actions.pod:5839 ../src/guestfs-actions.pod:5869
6456 #: ../src/guestfs-actions.pod:5885 ../src/guestfs-actions.pod:5908
6457 #: ../src/guestfs-actions.pod:5926 ../src/guestfs-actions.pod:5945
6458 #: ../src/guestfs-actions.pod:5966 ../src/guestfs-actions.pod:5985
6459 #: ../src/guestfs-actions.pod:6002 ../src/guestfs-actions.pod:6030
6460 #: ../src/guestfs-actions.pod:6054 ../src/guestfs-actions.pod:6073
6461 #: ../src/guestfs-actions.pod:6097 ../src/guestfs-actions.pod:6116
6462 #: ../src/guestfs-actions.pod:6131 ../src/guestfs-actions.pod:6150
6463 #: ../src/guestfs-actions.pod:6187 ../src/guestfs-actions.pod:6217
6464 #: ../src/guestfs-actions.pod:6250 ../src/guestfs-actions.pod:6372
6465 #: ../src/guestfs-actions.pod:6493 ../src/guestfs-actions.pod:6505
6466 #: ../src/guestfs-actions.pod:6518 ../src/guestfs-actions.pod:6531
6467 #: ../src/guestfs-actions.pod:6553 ../src/guestfs-actions.pod:6566
6468 #: ../src/guestfs-actions.pod:6579 ../src/guestfs-actions.pod:6592
6469 #: ../src/guestfs-actions.pod:6607 ../src/guestfs-actions.pod:6666
6470 #: ../src/guestfs-actions.pod:6683 ../src/guestfs-actions.pod:6699
6471 #: ../src/guestfs-actions.pod:6715 ../src/guestfs-actions.pod:6732
6472 #: ../src/guestfs-actions.pod:6745 ../src/guestfs-actions.pod:6765
6473 #: ../src/guestfs-actions.pod:6801 ../src/guestfs-actions.pod:6815
6474 #: ../src/guestfs-actions.pod:6856 ../src/guestfs-actions.pod:6869
6475 #: ../src/guestfs-actions.pod:6887 ../src/guestfs-actions.pod:6921
6476 #: ../src/guestfs-actions.pod:6957 ../src/guestfs-actions.pod:7076
6477 #: ../src/guestfs-actions.pod:7094 ../src/guestfs-actions.pod:7108
6478 #: ../src/guestfs-actions.pod:7163 ../src/guestfs-actions.pod:7176
6479 #: ../src/guestfs-actions.pod:7221 ../src/guestfs-actions.pod:7254
6480 #: ../src/guestfs-actions.pod:7315 ../src/guestfs-actions.pod:7341
6481 #: ../src/guestfs-actions.pod:7407 ../src/guestfs-actions.pod:7426
6482 #: ../src/guestfs-actions.pod:7455
6483 msgid "This function returns 0 on success or -1 on error."
6484 msgstr ""
6485
6486 #. type: textblock
6487 #: ../src/guestfs-actions.pod:32 ../src/guestfs-actions.pod:248
6488 #: ../src/guestfs-actions.pod:269
6489 msgid ""
6490 "This function is deprecated.  In new code, use the L</"
6491 "guestfs_add_drive_opts> call instead."
6492 msgstr ""
6493
6494 # type: textblock
6495 #. type: textblock
6496 #: ../src/guestfs-actions.pod:35 ../src/guestfs-actions.pod:251
6497 #: ../src/guestfs-actions.pod:272 ../src/guestfs-actions.pod:1453
6498 #: ../src/guestfs-actions.pod:1946 ../src/guestfs-actions.pod:1967
6499 #: ../src/guestfs-actions.pod:4453 ../src/guestfs-actions.pod:4760
6500 #: ../src/guestfs-actions.pod:6195 ../src/guestfs-actions.pod:6225
6501 #: ../src/guestfs-actions.pod:6258 ../src/guestfs-actions.pod:6317
6502 #: ../src/guestfs-actions.pod:7259 ../src/guestfs-actions.pod:7349
6503 #: ../src/guestfs-actions.pod:7518 ../fish/guestfish-actions.pod:31
6504 #: ../fish/guestfish-actions.pod:161 ../fish/guestfish-actions.pod:175
6505 #: ../fish/guestfish-actions.pod:961 ../fish/guestfish-actions.pod:1321
6506 #: ../fish/guestfish-actions.pod:1335 ../fish/guestfish-actions.pod:3032
6507 #: ../fish/guestfish-actions.pod:3229 ../fish/guestfish-actions.pod:4210
6508 #: ../fish/guestfish-actions.pod:4233 ../fish/guestfish-actions.pod:4255
6509 #: ../fish/guestfish-actions.pod:4293 ../fish/guestfish-actions.pod:4934
6510 #: ../fish/guestfish-actions.pod:5031
6511 msgid ""
6512 "Deprecated functions will not be removed from the API, but the fact that "
6513 "they are deprecated indicates that there are problems with correct use of "
6514 "these functions."
6515 msgstr ""
6516
6517 # type: textblock
6518 #. type: textblock
6519 #: ../src/guestfs-actions.pod:39 ../src/guestfs-actions.pod:136
6520 #: ../src/guestfs-actions.pod:1105 ../src/guestfs-actions.pod:1918
6521 #: ../src/guestfs-actions.pod:2016 ../src/guestfs-actions.pod:2119
6522 #: ../src/guestfs-actions.pod:3485 ../src/guestfs-actions.pod:3505
6523 #: ../src/guestfs-actions.pod:4764 ../src/guestfs-actions.pod:5887
6524 #: ../src/guestfs-actions.pod:6004 ../src/guestfs-actions.pod:6118
6525 #: ../src/guestfs-actions.pod:6609 ../src/guestfs-actions.pod:6734
6526 #: ../src/guestfs-actions.pod:7263
6527 msgid "(Added in 0.3)"
6528 msgstr ""
6529
6530 # type: =head2
6531 #. type: =head2
6532 #: ../src/guestfs-actions.pod:41
6533 msgid "guestfs_add_domain"
6534 msgstr ""
6535
6536 # type: verbatim
6537 #. type: verbatim
6538 #: ../src/guestfs-actions.pod:43
6539 #, no-wrap
6540 msgid ""
6541 " int\n"
6542 " guestfs_add_domain (guestfs_h *g,\n"
6543 "                     const char *dom,\n"
6544 "                     ...);\n"
6545 "\n"
6546 msgstr ""
6547
6548 # type: textblock
6549 #. type: textblock
6550 #: ../src/guestfs-actions.pod:48 ../src/guestfs-actions.pod:145
6551 #: ../src/guestfs-actions.pod:4467
6552 msgid ""
6553 "You may supply a list of optional arguments to this call.  Use zero or more "
6554 "of the following pairs of parameters, and terminate the list with C<-1> on "
6555 "its own.  See L</CALLS WITH OPTIONAL ARGUMENTS>."
6556 msgstr ""
6557
6558 #. type: verbatim
6559 #: ../src/guestfs-actions.pod:53
6560 #, no-wrap
6561 msgid ""
6562 " GUESTFS_ADD_DOMAIN_LIBVIRTURI, const char *libvirturi,\n"
6563 " GUESTFS_ADD_DOMAIN_READONLY, int readonly,\n"
6564 " GUESTFS_ADD_DOMAIN_IFACE, const char *iface,\n"
6565 " GUESTFS_ADD_DOMAIN_LIVE, int live,\n"
6566 "\n"
6567 msgstr ""
6568
6569 # type: textblock
6570 #. type: textblock
6571 #: ../src/guestfs-actions.pod:58
6572 msgid ""
6573 "This function adds the disk(s) attached to the named libvirt domain C<dom>.  "
6574 "It works by connecting to libvirt, requesting the domain and domain XML from "
6575 "libvirt, parsing it for disks, and calling C<guestfs_add_drive_opts> on each "
6576 "one."
6577 msgstr ""
6578
6579 # type: textblock
6580 #. type: textblock
6581 #: ../src/guestfs-actions.pod:63 ../fish/guestfish-actions.pod:46
6582 msgid ""
6583 "The number of disks added is returned.  This operation is atomic: if an "
6584 "error is returned, then no disks are added."
6585 msgstr ""
6586
6587 # type: textblock
6588 #. type: textblock
6589 #: ../src/guestfs-actions.pod:66 ../fish/guestfish-actions.pod:49
6590 msgid ""
6591 "This function does some minimal checks to make sure the libvirt domain is "
6592 "not running (unless C<readonly> is true).  In a future version we will try "
6593 "to acquire the libvirt lock on each disk."
6594 msgstr ""
6595
6596 # type: textblock
6597 #. type: textblock
6598 #: ../src/guestfs-actions.pod:70 ../fish/guestfish-actions.pod:53
6599 msgid ""
6600 "Disks must be accessible locally.  This often means that adding disks from a "
6601 "remote libvirt connection (see L<http://libvirt.org/remote.html>)  will fail "
6602 "unless those disks are accessible via the same device path locally too."
6603 msgstr ""
6604
6605 #. type: textblock
6606 #: ../src/guestfs-actions.pod:75 ../fish/guestfish-actions.pod:58
6607 msgid ""
6608 "The optional C<libvirturi> parameter sets the libvirt URI (see L<http://"
6609 "libvirt.org/uri.html>).  If this is not set then we connect to the default "
6610 "libvirt URI (or one set through an environment variable, see the libvirt "
6611 "documentation for full details)."
6612 msgstr ""
6613
6614 #. type: textblock
6615 #: ../src/guestfs-actions.pod:81 ../fish/guestfish-actions.pod:64
6616 msgid ""
6617 "The optional C<live> flag controls whether this call will try to connect to "
6618 "a running virtual machine C<guestfsd> process if it sees a suitable "
6619 "E<lt>channelE<gt> element in the libvirt XML definition.  The default (if "
6620 "the flag is omitted) is never to try.  See L<guestfs(3)/ATTACHING TO RUNNING "
6621 "DAEMONS> for more information."
6622 msgstr ""
6623
6624 # type: textblock
6625 #. type: textblock
6626 #: ../src/guestfs-actions.pod:88
6627 msgid ""
6628 "The other optional parameters are passed directly through to "
6629 "C<guestfs_add_drive_opts>."
6630 msgstr ""
6631
6632 # type: textblock
6633 #. type: textblock
6634 #: ../src/guestfs-actions.pod:91 ../src/guestfs-actions.pod:344
6635 #: ../src/guestfs-actions.pod:514 ../src/guestfs-actions.pod:692
6636 #: ../src/guestfs-actions.pod:723 ../src/guestfs-actions.pod:741
6637 #: ../src/guestfs-actions.pod:760 ../src/guestfs-actions.pod:1320
6638 #: ../src/guestfs-actions.pod:1676 ../src/guestfs-actions.pod:1879
6639 #: ../src/guestfs-actions.pod:1988 ../src/guestfs-actions.pod:2028
6640 #: ../src/guestfs-actions.pod:2083 ../src/guestfs-actions.pod:2106
6641 #: ../src/guestfs-actions.pod:2421 ../src/guestfs-actions.pod:2804
6642 #: ../src/guestfs-actions.pod:2825 ../src/guestfs-actions.pod:4900
6643 #: ../src/guestfs-actions.pod:5037 ../src/guestfs-actions.pod:5443
6644 #: ../src/guestfs-actions.pod:5469 ../src/guestfs-actions.pod:6842
6645 #: ../src/guestfs-actions.pod:7274 ../src/guestfs-actions.pod:7287
6646 #: ../src/guestfs-actions.pod:7300
6647 msgid "On error this function returns -1."
6648 msgstr ""
6649
6650 # type: textblock
6651 #. type: textblock
6652 #: ../src/guestfs-actions.pod:93
6653 msgid "(Added in 1.7.4)"
6654 msgstr ""
6655
6656 # type: =head2
6657 #. type: =head2
6658 #: ../src/guestfs-actions.pod:95
6659 msgid "guestfs_add_domain_va"
6660 msgstr ""
6661
6662 # type: verbatim
6663 #. type: verbatim
6664 #: ../src/guestfs-actions.pod:97
6665 #, no-wrap
6666 msgid ""
6667 " int\n"
6668 " guestfs_add_domain_va (guestfs_h *g,\n"
6669 "                        const char *dom,\n"
6670 "                        va_list args);\n"
6671 "\n"
6672 msgstr ""
6673
6674 # type: textblock
6675 #. type: textblock
6676 #: ../src/guestfs-actions.pod:102
6677 msgid "This is the \"va_list variant\" of L</guestfs_add_domain>."
6678 msgstr ""
6679
6680 # type: textblock
6681 #. type: textblock
6682 #: ../src/guestfs-actions.pod:104 ../src/guestfs-actions.pod:115
6683 #: ../src/guestfs-actions.pod:208 ../src/guestfs-actions.pod:219
6684 #: ../src/guestfs-actions.pod:4520 ../src/guestfs-actions.pod:4532
6685 msgid "See L</CALLS WITH OPTIONAL ARGUMENTS>."
6686 msgstr ""
6687
6688 # type: =head2
6689 #. type: =head2
6690 #: ../src/guestfs-actions.pod:106
6691 msgid "guestfs_add_domain_argv"
6692 msgstr ""
6693
6694 # type: verbatim
6695 #. type: verbatim
6696 #: ../src/guestfs-actions.pod:108
6697 #, no-wrap
6698 msgid ""
6699 " int\n"
6700 " guestfs_add_domain_argv (guestfs_h *g,\n"
6701 "                          const char *dom,\n"
6702 "                          const struct guestfs_add_domain_argv *optargs);\n"
6703 "\n"
6704 msgstr ""
6705
6706 # type: textblock
6707 #. type: textblock
6708 #: ../src/guestfs-actions.pod:113
6709 msgid "This is the \"argv variant\" of L</guestfs_add_domain>."
6710 msgstr ""
6711
6712 # type: =head2
6713 #. type: =head2
6714 #: ../src/guestfs-actions.pod:117
6715 msgid "guestfs_add_drive"
6716 msgstr ""
6717
6718 # type: verbatim
6719 #. type: verbatim
6720 #: ../src/guestfs-actions.pod:119
6721 #, no-wrap
6722 msgid ""
6723 " int\n"
6724 " guestfs_add_drive (guestfs_h *g,\n"
6725 "                    const char *filename);\n"
6726 "\n"
6727 msgstr ""
6728
6729 # type: textblock
6730 #. type: textblock
6731 #: ../src/guestfs-actions.pod:123
6732 msgid ""
6733 "This function is the equivalent of calling C<guestfs_add_drive_opts> with no "
6734 "optional parameters, so the disk is added writable, with the format being "
6735 "detected automatically."
6736 msgstr ""
6737
6738 # type: textblock
6739 #. type: textblock
6740 #: ../src/guestfs-actions.pod:127
6741 msgid ""
6742 "Automatic detection of the format opens you up to a potential security hole "
6743 "when dealing with untrusted raw-format images.  See CVE-2010-3851 and "
6744 "RHBZ#642934.  Specifying the format closes this security hole.  Therefore "
6745 "you should think about replacing calls to this function with calls to "
6746 "C<guestfs_add_drive_opts>, and specifying the format."
6747 msgstr ""
6748
6749 # type: =head2
6750 #. type: =head2
6751 #: ../src/guestfs-actions.pod:138
6752 msgid "guestfs_add_drive_opts"
6753 msgstr ""
6754
6755 # type: verbatim
6756 #. type: verbatim
6757 #: ../src/guestfs-actions.pod:140
6758 #, no-wrap
6759 msgid ""
6760 " int\n"
6761 " guestfs_add_drive_opts (guestfs_h *g,\n"
6762 "                         const char *filename,\n"
6763 "                         ...);\n"
6764 "\n"
6765 msgstr ""
6766
6767 # type: verbatim
6768 #. type: verbatim
6769 #: ../src/guestfs-actions.pod:150
6770 #, no-wrap
6771 msgid ""
6772 " GUESTFS_ADD_DRIVE_OPTS_READONLY, int readonly,\n"
6773 " GUESTFS_ADD_DRIVE_OPTS_FORMAT, const char *format,\n"
6774 " GUESTFS_ADD_DRIVE_OPTS_IFACE, const char *iface,\n"
6775 "\n"
6776 msgstr ""
6777
6778 # type: textblock
6779 #. type: textblock
6780 #: ../src/guestfs-actions.pod:154 ../fish/guestfish-actions.pod:97
6781 msgid ""
6782 "This function adds a virtual machine disk image C<filename> to libguestfs.  "
6783 "The first time you call this function, the disk appears as C</dev/sda>, the "
6784 "second time as C</dev/sdb>, and so on."
6785 msgstr ""
6786
6787 # type: textblock
6788 #. type: textblock
6789 #: ../src/guestfs-actions.pod:159 ../fish/guestfish-actions.pod:102
6790 msgid ""
6791 "You don't necessarily need to be root when using libguestfs.  However you "
6792 "obviously do need sufficient permissions to access the filename for whatever "
6793 "operations you want to perform (ie. read access if you just want to read the "
6794 "image or write access if you want to modify the image)."
6795 msgstr ""
6796
6797 # type: textblock
6798 #. type: textblock
6799 #: ../src/guestfs-actions.pod:165 ../fish/guestfish-actions.pod:108
6800 msgid "This call checks that C<filename> exists."
6801 msgstr ""
6802
6803 # type: textblock
6804 #. type: textblock
6805 #: ../src/guestfs-actions.pod:167 ../src/guestfs-actions.pod:4478
6806 #: ../fish/guestfish-actions.pod:110 ../fish/guestfish-actions.pod:3043
6807 msgid "The optional arguments are:"
6808 msgstr ""
6809
6810 # type: =item
6811 #. type: =item
6812 #: ../src/guestfs-actions.pod:171 ../fish/guestfish-actions.pod:114
6813 msgid "C<readonly>"
6814 msgstr ""
6815
6816 # type: textblock
6817 #. type: textblock
6818 #: ../src/guestfs-actions.pod:173 ../fish/guestfish-actions.pod:116
6819 msgid ""
6820 "If true then the image is treated as read-only.  Writes are still allowed, "
6821 "but they are stored in a temporary snapshot overlay which is discarded at "
6822 "the end.  The disk that you add is not modified."
6823 msgstr ""
6824
6825 # type: =item
6826 #. type: =item
6827 #: ../src/guestfs-actions.pod:177 ../fish/guestfish-actions.pod:120
6828 msgid "C<format>"
6829 msgstr ""
6830
6831 # type: textblock
6832 #. type: textblock
6833 #: ../src/guestfs-actions.pod:179
6834 msgid ""
6835 "This forces the image format.  If you omit this (or use C<guestfs_add_drive> "
6836 "or C<guestfs_add_drive_ro>) then the format is automatically detected.  "
6837 "Possible formats include C<raw> and C<qcow2>."
6838 msgstr ""
6839
6840 # type: textblock
6841 #. type: textblock
6842 #: ../src/guestfs-actions.pod:183 ../fish/guestfish-actions.pod:126
6843 msgid ""
6844 "Automatic detection of the format opens you up to a potential security hole "
6845 "when dealing with untrusted raw-format images.  See CVE-2010-3851 and "
6846 "RHBZ#642934.  Specifying the format closes this security hole."
6847 msgstr ""
6848
6849 # type: =item
6850 #. type: =item
6851 #: ../src/guestfs-actions.pod:188 ../fish/guestfish-actions.pod:131
6852 msgid "C<iface>"
6853 msgstr ""
6854
6855 # type: textblock
6856 #. type: textblock
6857 #: ../src/guestfs-actions.pod:190
6858 msgid ""
6859 "This rarely-used option lets you emulate the behaviour of the deprecated "
6860 "C<guestfs_add_drive_with_if> call (q.v.)"
6861 msgstr ""
6862
6863 # type: textblock
6864 #. type: textblock
6865 #: ../src/guestfs-actions.pod:197
6866 msgid "(Added in 1.5.23)"
6867 msgstr ""
6868
6869 # type: =head2
6870 #. type: =head2
6871 #: ../src/guestfs-actions.pod:199
6872 msgid "guestfs_add_drive_opts_va"
6873 msgstr ""
6874
6875 # type: verbatim
6876 #. type: verbatim
6877 #: ../src/guestfs-actions.pod:201
6878 #, no-wrap
6879 msgid ""
6880 " int\n"
6881 " guestfs_add_drive_opts_va (guestfs_h *g,\n"
6882 "                            const char *filename,\n"
6883 "                            va_list args);\n"
6884 "\n"
6885 msgstr ""
6886
6887 # type: textblock
6888 #. type: textblock
6889 #: ../src/guestfs-actions.pod:206
6890 msgid "This is the \"va_list variant\" of L</guestfs_add_drive_opts>."
6891 msgstr ""
6892
6893 # type: =head2
6894 #. type: =head2
6895 #: ../src/guestfs-actions.pod:210
6896 msgid "guestfs_add_drive_opts_argv"
6897 msgstr ""
6898
6899 # type: verbatim
6900 #. type: verbatim
6901 #: ../src/guestfs-actions.pod:212
6902 #, no-wrap
6903 msgid ""
6904 " int\n"
6905 " guestfs_add_drive_opts_argv (guestfs_h *g,\n"
6906 "                              const char *filename,\n"
6907 "                              const struct guestfs_add_drive_opts_argv *optargs);\n"
6908 "\n"
6909 msgstr ""
6910
6911 # type: textblock
6912 #. type: textblock
6913 #: ../src/guestfs-actions.pod:217
6914 msgid "This is the \"argv variant\" of L</guestfs_add_drive_opts>."
6915 msgstr ""
6916
6917 # type: =head2
6918 #. type: =head2
6919 #: ../src/guestfs-actions.pod:221
6920 msgid "guestfs_add_drive_ro"
6921 msgstr ""
6922
6923 # type: verbatim
6924 #. type: verbatim
6925 #: ../src/guestfs-actions.pod:223
6926 #, no-wrap
6927 msgid ""
6928 " int\n"
6929 " guestfs_add_drive_ro (guestfs_h *g,\n"
6930 "                       const char *filename);\n"
6931 "\n"
6932 msgstr ""
6933
6934 # type: textblock
6935 #. type: textblock
6936 #: ../src/guestfs-actions.pod:227
6937 msgid ""
6938 "This function is the equivalent of calling C<guestfs_add_drive_opts> with "
6939 "the optional parameter C<GUESTFS_ADD_DRIVE_OPTS_READONLY> set to 1, so the "
6940 "disk is added read-only, with the format being detected automatically."
6941 msgstr ""
6942
6943 # type: textblock
6944 #. type: textblock
6945 #: ../src/guestfs-actions.pod:234
6946 msgid "(Added in 1.0.38)"
6947 msgstr ""
6948
6949 # type: =head2
6950 #. type: =head2
6951 #: ../src/guestfs-actions.pod:236
6952 msgid "guestfs_add_drive_ro_with_if"
6953 msgstr ""
6954
6955 # type: verbatim
6956 #. type: verbatim
6957 #: ../src/guestfs-actions.pod:238
6958 #, no-wrap
6959 msgid ""
6960 " int\n"
6961 " guestfs_add_drive_ro_with_if (guestfs_h *g,\n"
6962 "                               const char *filename,\n"
6963 "                               const char *iface);\n"
6964 "\n"
6965 msgstr ""
6966
6967 # type: textblock
6968 #. type: textblock
6969 #: ../src/guestfs-actions.pod:243
6970 msgid ""
6971 "This is the same as C<guestfs_add_drive_ro> but it allows you to specify the "
6972 "QEMU interface emulation to use at run time."
6973 msgstr ""
6974
6975 # type: textblock
6976 #. type: textblock
6977 #: ../src/guestfs-actions.pod:255 ../src/guestfs-actions.pod:276
6978 #: ../src/guestfs-actions.pod:2380
6979 msgid "(Added in 1.0.84)"
6980 msgstr ""
6981
6982 # type: =head2
6983 #. type: =head2
6984 #: ../src/guestfs-actions.pod:257
6985 msgid "guestfs_add_drive_with_if"
6986 msgstr ""
6987
6988 # type: verbatim
6989 #. type: verbatim
6990 #: ../src/guestfs-actions.pod:259
6991 #, no-wrap
6992 msgid ""
6993 " int\n"
6994 " guestfs_add_drive_with_if (guestfs_h *g,\n"
6995 "                            const char *filename,\n"
6996 "                            const char *iface);\n"
6997 "\n"
6998 msgstr ""
6999
7000 # type: textblock
7001 #. type: textblock
7002 #: ../src/guestfs-actions.pod:264
7003 msgid ""
7004 "This is the same as C<guestfs_add_drive> but it allows you to specify the "
7005 "QEMU interface emulation to use at run time."
7006 msgstr ""
7007
7008 # type: =head2
7009 #. type: =head2
7010 #: ../src/guestfs-actions.pod:278
7011 msgid "guestfs_aug_clear"
7012 msgstr ""
7013
7014 # type: verbatim
7015 #. type: verbatim
7016 #: ../src/guestfs-actions.pod:280
7017 #, no-wrap
7018 msgid ""
7019 " int\n"
7020 " guestfs_aug_clear (guestfs_h *g,\n"
7021 "                    const char *augpath);\n"
7022 "\n"
7023 msgstr ""
7024
7025 # type: textblock
7026 #. type: textblock
7027 #: ../src/guestfs-actions.pod:284 ../fish/guestfish-actions.pod:183
7028 msgid ""
7029 "Set the value associated with C<path> to C<NULL>.  This is the same as the "
7030 "L<augtool(1)> C<clear> command."
7031 msgstr ""
7032
7033 # type: textblock
7034 #. type: textblock
7035 #: ../src/guestfs-actions.pod:289 ../src/guestfs-actions.pod:2108
7036 msgid "(Added in 1.3.4)"
7037 msgstr ""
7038
7039 # type: =head2
7040 #. type: =head2
7041 #: ../src/guestfs-actions.pod:291
7042 msgid "guestfs_aug_close"
7043 msgstr ""
7044
7045 # type: verbatim
7046 #. type: verbatim
7047 #: ../src/guestfs-actions.pod:293
7048 #, no-wrap
7049 msgid ""
7050 " int\n"
7051 " guestfs_aug_close (guestfs_h *g);\n"
7052 "\n"
7053 msgstr ""
7054
7055 # type: textblock
7056 #. type: textblock
7057 #: ../src/guestfs-actions.pod:296
7058 msgid ""
7059 "Close the current Augeas handle and free up any resources used by it.  After "
7060 "calling this, you have to call C<guestfs_aug_init> again before you can use "
7061 "any other Augeas functions."
7062 msgstr ""
7063
7064 # type: textblock
7065 #. type: textblock
7066 #: ../src/guestfs-actions.pod:303 ../src/guestfs-actions.pod:328
7067 #: ../src/guestfs-actions.pod:346 ../src/guestfs-actions.pod:360
7068 #: ../src/guestfs-actions.pod:423 ../src/guestfs-actions.pod:443
7069 #: ../src/guestfs-actions.pod:457 ../src/guestfs-actions.pod:488
7070 #: ../src/guestfs-actions.pod:502 ../src/guestfs-actions.pod:516
7071 #: ../src/guestfs-actions.pod:530 ../src/guestfs-actions.pod:548
7072 #: ../src/guestfs-actions.pod:5520
7073 msgid "(Added in 0.7)"
7074 msgstr ""
7075
7076 # type: =head2
7077 #. type: =head2
7078 #: ../src/guestfs-actions.pod:305
7079 msgid "guestfs_aug_defnode"
7080 msgstr ""
7081
7082 # type: verbatim
7083 #. type: verbatim
7084 #: ../src/guestfs-actions.pod:307
7085 #, no-wrap
7086 msgid ""
7087 " struct guestfs_int_bool *\n"
7088 " guestfs_aug_defnode (guestfs_h *g,\n"
7089 "                      const char *name,\n"
7090 "                      const char *expr,\n"
7091 "                      const char *val);\n"
7092 "\n"
7093 msgstr ""
7094
7095 # type: textblock
7096 #. type: textblock
7097 #: ../src/guestfs-actions.pod:313 ../fish/guestfish-actions.pod:199
7098 msgid ""
7099 "Defines a variable C<name> whose value is the result of evaluating C<expr>."
7100 msgstr ""
7101
7102 # type: textblock
7103 #. type: textblock
7104 #: ../src/guestfs-actions.pod:316
7105 msgid ""
7106 "If C<expr> evaluates to an empty nodeset, a node is created, equivalent to "
7107 "calling C<guestfs_aug_set> C<expr>, C<value>.  C<name> will be the nodeset "
7108 "containing that single node."
7109 msgstr ""
7110
7111 # type: textblock
7112 #. type: textblock
7113 #: ../src/guestfs-actions.pod:320 ../fish/guestfish-actions.pod:206
7114 msgid ""
7115 "On success this returns a pair containing the number of nodes in the "
7116 "nodeset, and a boolean flag if a node was created."
7117 msgstr ""
7118
7119 # type: textblock
7120 #. type: textblock
7121 #: ../src/guestfs-actions.pod:324
7122 msgid ""
7123 "This function returns a C<struct guestfs_int_bool *>, or NULL if there was "
7124 "an error.  I<The caller must call C<guestfs_free_int_bool> after use>."
7125 msgstr ""
7126
7127 # type: =head2
7128 #. type: =head2
7129 #: ../src/guestfs-actions.pod:330
7130 msgid "guestfs_aug_defvar"
7131 msgstr ""
7132
7133 # type: verbatim
7134 #. type: verbatim
7135 #: ../src/guestfs-actions.pod:332
7136 #, no-wrap
7137 msgid ""
7138 " int\n"
7139 " guestfs_aug_defvar (guestfs_h *g,\n"
7140 "                     const char *name,\n"
7141 "                     const char *expr);\n"
7142 "\n"
7143 msgstr ""
7144
7145 # type: textblock
7146 #. type: textblock
7147 #: ../src/guestfs-actions.pod:337 ../fish/guestfish-actions.pod:214
7148 msgid ""
7149 "Defines an Augeas variable C<name> whose value is the result of evaluating "
7150 "C<expr>.  If C<expr> is NULL, then C<name> is undefined."
7151 msgstr ""
7152
7153 # type: textblock
7154 #. type: textblock
7155 #: ../src/guestfs-actions.pod:341 ../fish/guestfish-actions.pod:218
7156 msgid ""
7157 "On success this returns the number of nodes in C<expr>, or C<0> if C<expr> "
7158 "evaluates to something which is not a nodeset."
7159 msgstr ""
7160
7161 # type: =head2
7162 #. type: =head2
7163 #: ../src/guestfs-actions.pod:348
7164 msgid "guestfs_aug_get"
7165 msgstr ""
7166
7167 # type: verbatim
7168 #. type: verbatim
7169 #: ../src/guestfs-actions.pod:350
7170 #, no-wrap
7171 msgid ""
7172 " char *\n"
7173 " guestfs_aug_get (guestfs_h *g,\n"
7174 "                  const char *augpath);\n"
7175 "\n"
7176 msgstr ""
7177
7178 # type: textblock
7179 #. type: textblock
7180 #: ../src/guestfs-actions.pod:354 ../fish/guestfish-actions.pod:225
7181 msgid ""
7182 "Look up the value associated with C<path>.  If C<path> matches exactly one "
7183 "node, the C<value> is returned."
7184 msgstr ""
7185
7186 # type: textblock
7187 #. type: textblock
7188 #: ../src/guestfs-actions.pod:357 ../src/guestfs-actions.pod:862
7189 #: ../src/guestfs-actions.pod:880 ../src/guestfs-actions.pod:940
7190 #: ../src/guestfs-actions.pod:956 ../src/guestfs-actions.pod:1059
7191 #: ../src/guestfs-actions.pod:1189 ../src/guestfs-actions.pod:1206
7192 #: ../src/guestfs-actions.pod:1225 ../src/guestfs-actions.pod:1359
7193 #: ../src/guestfs-actions.pod:1547 ../src/guestfs-actions.pod:1659
7194 #: ../src/guestfs-actions.pod:1822 ../src/guestfs-actions.pod:1839
7195 #: ../src/guestfs-actions.pod:1906 ../src/guestfs-actions.pod:1940
7196 #: ../src/guestfs-actions.pod:1961 ../src/guestfs-actions.pod:2131
7197 #: ../src/guestfs-actions.pod:2345 ../src/guestfs-actions.pod:2552
7198 #: ../src/guestfs-actions.pod:2645 ../src/guestfs-actions.pod:2756
7199 #: ../src/guestfs-actions.pod:2776 ../src/guestfs-actions.pod:2896
7200 #: ../src/guestfs-actions.pod:2927 ../src/guestfs-actions.pod:2951
7201 #: ../src/guestfs-actions.pod:2988 ../src/guestfs-actions.pod:3048
7202 #: ../src/guestfs-actions.pod:3071 ../src/guestfs-actions.pod:3092
7203 #: ../src/guestfs-actions.pod:3664 ../src/guestfs-actions.pod:4014
7204 #: ../src/guestfs-actions.pod:4184 ../src/guestfs-actions.pod:4294
7205 #: ../src/guestfs-actions.pod:5055 ../src/guestfs-actions.pod:5248
7206 #: ../src/guestfs-actions.pod:5418 ../src/guestfs-actions.pod:5596
7207 #: ../src/guestfs-actions.pod:5645 ../src/guestfs-actions.pod:6278
7208 #: ../src/guestfs-actions.pod:6294 ../src/guestfs-actions.pod:6311
7209 #: ../src/guestfs-actions.pod:6342 ../src/guestfs-actions.pod:7016
7210 #: ../src/guestfs-actions.pod:7035 ../src/guestfs-actions.pod:7053
7211 #: ../src/guestfs-actions.pod:7233 ../src/guestfs-actions.pod:7512
7212 msgid ""
7213 "This function returns a string, or NULL on error.  I<The caller must free "
7214 "the returned string after use>."
7215 msgstr ""
7216
7217 # type: =head2
7218 #. type: =head2
7219 #: ../src/guestfs-actions.pod:362
7220 msgid "guestfs_aug_init"
7221 msgstr ""
7222
7223 # type: verbatim
7224 #. type: verbatim
7225 #: ../src/guestfs-actions.pod:364
7226 #, no-wrap
7227 msgid ""
7228 " int\n"
7229 " guestfs_aug_init (guestfs_h *g,\n"
7230 "                   const char *root,\n"
7231 "                   int flags);\n"
7232 "\n"
7233 msgstr ""
7234
7235 # type: textblock
7236 #. type: textblock
7237 #: ../src/guestfs-actions.pod:369 ../fish/guestfish-actions.pod:232
7238 msgid ""
7239 "Create a new Augeas handle for editing configuration files.  If there was "
7240 "any previous Augeas handle associated with this guestfs session, then it is "
7241 "closed."
7242 msgstr ""
7243
7244 # type: textblock
7245 #. type: textblock
7246 #: ../src/guestfs-actions.pod:373
7247 msgid "You must call this before using any other C<guestfs_aug_*> commands."
7248 msgstr ""
7249
7250 # type: textblock
7251 #. type: textblock
7252 #: ../src/guestfs-actions.pod:376 ../fish/guestfish-actions.pod:239
7253 msgid ""
7254 "C<root> is the filesystem root.  C<root> must not be NULL, use C</> instead."
7255 msgstr ""
7256
7257 # type: textblock
7258 #. type: textblock
7259 #: ../src/guestfs-actions.pod:379 ../fish/guestfish-actions.pod:242
7260 msgid ""
7261 "The flags are the same as the flags defined in E<lt>augeas.hE<gt>, the "
7262 "logical I<or> of the following integers:"
7263 msgstr ""
7264
7265 # type: =item
7266 #. type: =item
7267 #: ../src/guestfs-actions.pod:385 ../fish/guestfish-actions.pod:248
7268 msgid "C<AUG_SAVE_BACKUP> = 1"
7269 msgstr ""
7270
7271 # type: textblock
7272 #. type: textblock
7273 #: ../src/guestfs-actions.pod:387 ../fish/guestfish-actions.pod:250
7274 msgid "Keep the original file with a C<.augsave> extension."
7275 msgstr ""
7276
7277 # type: =item
7278 #. type: =item
7279 #: ../src/guestfs-actions.pod:389 ../fish/guestfish-actions.pod:252
7280 msgid "C<AUG_SAVE_NEWFILE> = 2"
7281 msgstr ""
7282
7283 # type: textblock
7284 #. type: textblock
7285 #: ../src/guestfs-actions.pod:391 ../fish/guestfish-actions.pod:254
7286 msgid ""
7287 "Save changes into a file with extension C<.augnew>, and do not overwrite "
7288 "original.  Overrides C<AUG_SAVE_BACKUP>."
7289 msgstr ""
7290
7291 # type: =item
7292 #. type: =item
7293 #: ../src/guestfs-actions.pod:394 ../fish/guestfish-actions.pod:257
7294 msgid "C<AUG_TYPE_CHECK> = 4"
7295 msgstr ""
7296
7297 #. type: textblock
7298 #: ../src/guestfs-actions.pod:396 ../fish/guestfish-actions.pod:259
7299 msgid "Typecheck lenses."
7300 msgstr ""
7301
7302 #. type: textblock
7303 #: ../src/guestfs-actions.pod:398
7304 msgid ""
7305 "This option is only useful when debugging Augeas lenses.  Use of this option "
7306 "may require additional memory for the libguestfs appliance.  You may need to "
7307 "set the C<LIBGUESTFS_MEMSIZE> environment variable or call "
7308 "C<guestfs_set_memsize>."
7309 msgstr ""
7310
7311 # type: =item
7312 #. type: =item
7313 #: ../src/guestfs-actions.pod:403 ../fish/guestfish-actions.pod:266
7314 msgid "C<AUG_NO_STDINC> = 8"
7315 msgstr ""
7316
7317 # type: textblock
7318 #. type: textblock
7319 #: ../src/guestfs-actions.pod:405 ../fish/guestfish-actions.pod:268
7320 msgid "Do not use standard load path for modules."
7321 msgstr ""
7322
7323 # type: =item
7324 #. type: =item
7325 #: ../src/guestfs-actions.pod:407 ../fish/guestfish-actions.pod:270
7326 msgid "C<AUG_SAVE_NOOP> = 16"
7327 msgstr ""
7328
7329 # type: textblock
7330 #. type: textblock
7331 #: ../src/guestfs-actions.pod:409 ../fish/guestfish-actions.pod:272
7332 msgid "Make save a no-op, just record what would have been changed."
7333 msgstr ""
7334
7335 # type: =item
7336 #. type: =item
7337 #: ../src/guestfs-actions.pod:411 ../fish/guestfish-actions.pod:274
7338 msgid "C<AUG_NO_LOAD> = 32"
7339 msgstr ""
7340
7341 # type: textblock
7342 #. type: textblock
7343 #: ../src/guestfs-actions.pod:413
7344 msgid "Do not load the tree in C<guestfs_aug_init>."
7345 msgstr ""
7346
7347 # type: textblock
7348 #. type: textblock
7349 #: ../src/guestfs-actions.pod:417
7350 msgid "To close the handle, you can call C<guestfs_aug_close>."
7351 msgstr ""
7352
7353 # type: textblock
7354 #. type: textblock
7355 #: ../src/guestfs-actions.pod:419 ../fish/guestfish-actions.pod:282
7356 msgid "To find out more about Augeas, see L<http://augeas.net/>."
7357 msgstr ""
7358
7359 # type: =head2
7360 #. type: =head2
7361 #: ../src/guestfs-actions.pod:425
7362 msgid "guestfs_aug_insert"
7363 msgstr ""
7364
7365 # type: verbatim
7366 #. type: verbatim
7367 #: ../src/guestfs-actions.pod:427
7368 #, no-wrap
7369 msgid ""
7370 " int\n"
7371 " guestfs_aug_insert (guestfs_h *g,\n"
7372 "                     const char *augpath,\n"
7373 "                     const char *label,\n"
7374 "                     int before);\n"
7375 "\n"
7376 msgstr ""
7377
7378 # type: textblock
7379 #. type: textblock
7380 #: ../src/guestfs-actions.pod:433 ../fish/guestfish-actions.pod:288
7381 msgid ""
7382 "Create a new sibling C<label> for C<path>, inserting it into the tree before "
7383 "or after C<path> (depending on the boolean flag C<before>)."
7384 msgstr ""
7385
7386 # type: textblock
7387 #. type: textblock
7388 #: ../src/guestfs-actions.pod:437 ../fish/guestfish-actions.pod:292
7389 msgid ""
7390 "C<path> must match exactly one existing node in the tree, and C<label> must "
7391 "be a label, ie. not contain C</>, C<*> or end with a bracketed index C<[N]>."
7392 msgstr ""
7393
7394 # type: =head2
7395 #. type: =head2
7396 #: ../src/guestfs-actions.pod:445
7397 msgid "guestfs_aug_load"
7398 msgstr ""
7399
7400 # type: verbatim
7401 #. type: verbatim
7402 #: ../src/guestfs-actions.pod:447
7403 #, no-wrap
7404 msgid ""
7405 " int\n"
7406 " guestfs_aug_load (guestfs_h *g);\n"
7407 "\n"
7408 msgstr ""
7409
7410 # type: textblock
7411 #. type: textblock
7412 #: ../src/guestfs-actions.pod:450 ../fish/guestfish-actions.pod:300
7413 msgid "Load files into the tree."
7414 msgstr ""
7415
7416 # type: textblock
7417 #. type: textblock
7418 #: ../src/guestfs-actions.pod:452 ../fish/guestfish-actions.pod:302
7419 msgid "See C<aug_load> in the Augeas documentation for the full gory details."
7420 msgstr ""
7421
7422 # type: =head2
7423 #. type: =head2
7424 #: ../src/guestfs-actions.pod:459
7425 msgid "guestfs_aug_ls"
7426 msgstr ""
7427
7428 # type: verbatim
7429 #. type: verbatim
7430 #: ../src/guestfs-actions.pod:461
7431 #, no-wrap
7432 msgid ""
7433 " char **\n"
7434 " guestfs_aug_ls (guestfs_h *g,\n"
7435 "                 const char *augpath);\n"
7436 "\n"
7437 msgstr ""
7438
7439 # type: textblock
7440 #. type: textblock
7441 #: ../src/guestfs-actions.pod:465
7442 msgid ""
7443 "This is just a shortcut for listing C<guestfs_aug_match> C<path/*> and "
7444 "sorting the resulting nodes into alphabetical order."
7445 msgstr ""
7446
7447 # type: textblock
7448 #. type: textblock
7449 #: ../src/guestfs-actions.pod:468 ../src/guestfs-actions.pod:484
7450 #: ../src/guestfs-actions.pod:630 ../src/guestfs-actions.pod:1078
7451 #: ../src/guestfs-actions.pod:1374 ../src/guestfs-actions.pod:1393
7452 #: ../src/guestfs-actions.pod:1496 ../src/guestfs-actions.pod:1515
7453 #: ../src/guestfs-actions.pod:1761 ../src/guestfs-actions.pod:2203
7454 #: ../src/guestfs-actions.pod:2219 ../src/guestfs-actions.pod:2238
7455 #: ../src/guestfs-actions.pod:2303 ../src/guestfs-actions.pod:2327
7456 #: ../src/guestfs-actions.pod:2398 ../src/guestfs-actions.pod:2447
7457 #: ../src/guestfs-actions.pod:2714 ../src/guestfs-actions.pod:3005
7458 #: ../src/guestfs-actions.pod:3294 ../src/guestfs-actions.pod:3584
7459 #: ../src/guestfs-actions.pod:3646 ../src/guestfs-actions.pod:3751
7460 #: ../src/guestfs-actions.pod:4156 ../src/guestfs-actions.pod:4861
7461 #: ../src/guestfs-actions.pod:5390 ../src/guestfs-actions.pod:5516
7462 #: ../src/guestfs-actions.pod:5630 ../src/guestfs-actions.pod:6358
7463 #: ../src/guestfs-actions.pod:6419 ../src/guestfs-actions.pod:6474
7464 #: ../src/guestfs-actions.pod:6620 ../src/guestfs-actions.pod:6644
7465 #: ../src/guestfs-actions.pod:7126 ../src/guestfs-actions.pod:7146
7466 #: ../src/guestfs-actions.pod:7193 ../src/guestfs-actions.pod:7365
7467 #: ../src/guestfs-actions.pod:7384 ../src/guestfs-actions.pod:7469
7468 #: ../src/guestfs-actions.pod:7488 ../src/guestfs-actions.pod:7534
7469 #: ../src/guestfs-actions.pod:7553
7470 msgid ""
7471 "This function returns a NULL-terminated array of strings (like L<environ(3)"
7472 ">), or NULL if there was an error.  I<The caller must free the strings and "
7473 "the array after use>."
7474 msgstr ""
7475
7476 # type: textblock
7477 #. type: textblock
7478 #: ../src/guestfs-actions.pod:472 ../src/guestfs-actions.pod:1003
7479 #: ../src/guestfs-actions.pod:1021 ../src/guestfs-actions.pod:1431
7480 #: ../src/guestfs-actions.pod:3372 ../src/guestfs-actions.pod:3403
7481 #: ../src/guestfs-actions.pod:3997 ../src/guestfs-actions.pod:4047
7482 #: ../src/guestfs-actions.pod:4234 ../src/guestfs-actions.pod:4267
7483 #: ../src/guestfs-actions.pod:4430 ../src/guestfs-actions.pod:4865
7484 #: ../src/guestfs-actions.pod:5331 ../src/guestfs-actions.pod:5726
7485 #: ../src/guestfs-actions.pod:5740 ../src/guestfs-actions.pod:5752
7486 #: ../src/guestfs-actions.pod:6199 ../src/guestfs-actions.pod:6858
7487 #: ../src/guestfs-actions.pod:6871 ../src/guestfs-actions.pod:7110
7488 #: ../src/guestfs-actions.pod:7353
7489 msgid "(Added in 0.8)"
7490 msgstr ""
7491
7492 # type: =head2
7493 #. type: =head2
7494 #: ../src/guestfs-actions.pod:474
7495 msgid "guestfs_aug_match"
7496 msgstr ""
7497
7498 # type: verbatim
7499 #. type: verbatim
7500 #: ../src/guestfs-actions.pod:476
7501 #, no-wrap
7502 msgid ""
7503 " char **\n"
7504 " guestfs_aug_match (guestfs_h *g,\n"
7505 "                    const char *augpath);\n"
7506 "\n"
7507 msgstr ""
7508
7509 # type: textblock
7510 #. type: textblock
7511 #: ../src/guestfs-actions.pod:480 ../fish/guestfish-actions.pod:316
7512 msgid ""
7513 "Returns a list of paths which match the path expression C<path>.  The "
7514 "returned paths are sufficiently qualified so that they match exactly one "
7515 "node in the current tree."
7516 msgstr ""
7517
7518 # type: =head2
7519 #. type: =head2
7520 #: ../src/guestfs-actions.pod:490
7521 msgid "guestfs_aug_mv"
7522 msgstr ""
7523
7524 # type: verbatim
7525 #. type: verbatim
7526 #: ../src/guestfs-actions.pod:492
7527 #, no-wrap
7528 msgid ""
7529 " int\n"
7530 " guestfs_aug_mv (guestfs_h *g,\n"
7531 "                 const char *src,\n"
7532 "                 const char *dest);\n"
7533 "\n"
7534 msgstr ""
7535
7536 # type: textblock
7537 #. type: textblock
7538 #: ../src/guestfs-actions.pod:497 ../fish/guestfish-actions.pod:324
7539 msgid ""
7540 "Move the node C<src> to C<dest>.  C<src> must match exactly one node.  "
7541 "C<dest> is overwritten if it exists."
7542 msgstr ""
7543
7544 # type: =head2
7545 #. type: =head2
7546 #: ../src/guestfs-actions.pod:504
7547 msgid "guestfs_aug_rm"
7548 msgstr ""
7549
7550 # type: verbatim
7551 #. type: verbatim
7552 #: ../src/guestfs-actions.pod:506
7553 #, no-wrap
7554 msgid ""
7555 " int\n"
7556 " guestfs_aug_rm (guestfs_h *g,\n"
7557 "                 const char *augpath);\n"
7558 "\n"
7559 msgstr ""
7560
7561 # type: textblock
7562 #. type: textblock
7563 #: ../src/guestfs-actions.pod:510 ../fish/guestfish-actions.pod:331
7564 msgid "Remove C<path> and all of its children."
7565 msgstr ""
7566
7567 # type: textblock
7568 #. type: textblock
7569 #: ../src/guestfs-actions.pod:512 ../fish/guestfish-actions.pod:333
7570 msgid "On success this returns the number of entries which were removed."
7571 msgstr ""
7572
7573 # type: =head2
7574 #. type: =head2
7575 #: ../src/guestfs-actions.pod:518
7576 msgid "guestfs_aug_save"
7577 msgstr ""
7578
7579 # type: verbatim
7580 #. type: verbatim
7581 #: ../src/guestfs-actions.pod:520
7582 #, no-wrap
7583 msgid ""
7584 " int\n"
7585 " guestfs_aug_save (guestfs_h *g);\n"
7586 "\n"
7587 msgstr ""
7588
7589 # type: textblock
7590 #. type: textblock
7591 #: ../src/guestfs-actions.pod:523 ../fish/guestfish-actions.pod:339
7592 msgid "This writes all pending changes to disk."
7593 msgstr ""
7594
7595 # type: textblock
7596 #. type: textblock
7597 #: ../src/guestfs-actions.pod:525
7598 msgid ""
7599 "The flags which were passed to C<guestfs_aug_init> affect exactly how files "
7600 "are saved."
7601 msgstr ""
7602
7603 # type: =head2
7604 #. type: =head2
7605 #: ../src/guestfs-actions.pod:532
7606 msgid "guestfs_aug_set"
7607 msgstr ""
7608
7609 # type: verbatim
7610 #. type: verbatim
7611 #: ../src/guestfs-actions.pod:534
7612 #, no-wrap
7613 msgid ""
7614 " int\n"
7615 " guestfs_aug_set (guestfs_h *g,\n"
7616 "                  const char *augpath,\n"
7617 "                  const char *val);\n"
7618 "\n"
7619 msgstr ""
7620
7621 # type: textblock
7622 #. type: textblock
7623 #: ../src/guestfs-actions.pod:539 ../fish/guestfish-actions.pod:348
7624 msgid "Set the value associated with C<path> to C<val>."
7625 msgstr ""
7626
7627 # type: textblock
7628 #. type: textblock
7629 #: ../src/guestfs-actions.pod:541
7630 msgid ""
7631 "In the Augeas API, it is possible to clear a node by setting the value to "
7632 "NULL.  Due to an oversight in the libguestfs API you cannot do that with "
7633 "this call.  Instead you must use the C<guestfs_aug_clear> call."
7634 msgstr ""
7635
7636 # type: =head2
7637 #. type: =head2
7638 #: ../src/guestfs-actions.pod:550
7639 msgid "guestfs_available"
7640 msgstr ""
7641
7642 # type: verbatim
7643 #. type: verbatim
7644 #: ../src/guestfs-actions.pod:552
7645 #, no-wrap
7646 msgid ""
7647 " int\n"
7648 " guestfs_available (guestfs_h *g,\n"
7649 "                    char *const *groups);\n"
7650 "\n"
7651 msgstr ""
7652
7653 # type: textblock
7654 #. type: textblock
7655 #: ../src/guestfs-actions.pod:556 ../fish/guestfish-actions.pod:359
7656 msgid ""
7657 "This command is used to check the availability of some groups of "
7658 "functionality in the appliance, which not all builds of the libguestfs "
7659 "appliance will be able to provide."
7660 msgstr ""
7661
7662 # type: textblock
7663 #. type: textblock
7664 #: ../src/guestfs-actions.pod:560
7665 msgid ""
7666 "The libguestfs groups, and the functions that those groups correspond to, "
7667 "are listed in L<guestfs(3)/AVAILABILITY>.  You can also fetch this list at "
7668 "runtime by calling C<guestfs_available_all_groups>."
7669 msgstr ""
7670
7671 # type: textblock
7672 #. type: textblock
7673 #: ../src/guestfs-actions.pod:565 ../fish/guestfish-actions.pod:368
7674 msgid ""
7675 "The argument C<groups> is a list of group names, eg: C<[\"inotify\", \"augeas"
7676 "\"]> would check for the availability of the Linux inotify functions and "
7677 "Augeas (configuration file editing) functions."
7678 msgstr ""
7679
7680 # type: textblock
7681 #. type: textblock
7682 #: ../src/guestfs-actions.pod:570 ../fish/guestfish-actions.pod:373
7683 msgid "The command returns no error if I<all> requested groups are available."
7684 msgstr ""
7685
7686 # type: textblock
7687 #. type: textblock
7688 #: ../src/guestfs-actions.pod:572 ../fish/guestfish-actions.pod:375
7689 msgid ""
7690 "It fails with an error if one or more of the requested groups is unavailable "
7691 "in the appliance."
7692 msgstr ""
7693
7694 # type: textblock
7695 #. type: textblock
7696 #: ../src/guestfs-actions.pod:575 ../fish/guestfish-actions.pod:378
7697 msgid ""
7698 "If an unknown group name is included in the list of groups then an error is "
7699 "always returned."
7700 msgstr ""
7701
7702 # type: textblock
7703 #. type: textblock
7704 #: ../src/guestfs-actions.pod:578 ../fish/guestfish-actions.pod:381
7705 msgid "I<Notes:>"
7706 msgstr ""
7707
7708 # type: textblock
7709 #. type: textblock
7710 #: ../src/guestfs-actions.pod:584
7711 msgid "You must call C<guestfs_launch> before calling this function."
7712 msgstr ""
7713
7714 # type: textblock
7715 #. type: textblock
7716 #: ../src/guestfs-actions.pod:586 ../fish/guestfish-actions.pod:389
7717 msgid ""
7718 "The reason is because we don't know what groups are supported by the "
7719 "appliance/daemon until it is running and can be queried."
7720 msgstr ""
7721
7722 # type: textblock
7723 #. type: textblock
7724 #: ../src/guestfs-actions.pod:592 ../fish/guestfish-actions.pod:395
7725 msgid ""
7726 "If a group of functions is available, this does not necessarily mean that "
7727 "they will work.  You still have to check for errors when calling individual "
7728 "API functions even if they are available."
7729 msgstr ""
7730
7731 # type: textblock
7732 #. type: textblock
7733 #: ../src/guestfs-actions.pod:599 ../fish/guestfish-actions.pod:402
7734 msgid ""
7735 "It is usually the job of distro packagers to build complete functionality "
7736 "into the libguestfs appliance.  Upstream libguestfs, if built from source "
7737 "with all requirements satisfied, will support everything."
7738 msgstr ""
7739
7740 # type: textblock
7741 #. type: textblock
7742 #: ../src/guestfs-actions.pod:606
7743 msgid ""
7744 "This call was added in version C<1.0.80>.  In previous versions of "
7745 "libguestfs all you could do would be to speculatively execute a command to "
7746 "find out if the daemon implemented it.  See also C<guestfs_version>."
7747 msgstr ""
7748
7749 # type: textblock
7750 #. type: textblock
7751 #: ../src/guestfs-actions.pod:615 ../src/guestfs-actions.pod:1176
7752 msgid "(Added in 1.0.80)"
7753 msgstr ""
7754
7755 # type: =head2
7756 #. type: =head2
7757 #: ../src/guestfs-actions.pod:617
7758 msgid "guestfs_available_all_groups"
7759 msgstr ""
7760
7761 # type: verbatim
7762 #. type: verbatim
7763 #: ../src/guestfs-actions.pod:619
7764 #, no-wrap
7765 msgid ""
7766 " char **\n"
7767 " guestfs_available_all_groups (guestfs_h *g);\n"
7768 "\n"
7769 msgstr ""
7770
7771 # type: textblock
7772 #. type: textblock
7773 #: ../src/guestfs-actions.pod:622
7774 msgid ""
7775 "This command returns a list of all optional groups that this daemon knows "
7776 "about.  Note this returns both supported and unsupported groups.  To find "
7777 "out which ones the daemon can actually support you have to call "
7778 "C<guestfs_available> on each member of the returned list."
7779 msgstr ""
7780
7781 # type: textblock
7782 #. type: textblock
7783 #: ../src/guestfs-actions.pod:628
7784 msgid "See also C<guestfs_available> and L<guestfs(3)/AVAILABILITY>."
7785 msgstr ""
7786
7787 # type: textblock
7788 #. type: textblock
7789 #: ../src/guestfs-actions.pod:634
7790 msgid "(Added in 1.3.15)"
7791 msgstr ""
7792
7793 # type: =head2
7794 #. type: =head2
7795 #: ../src/guestfs-actions.pod:636
7796 msgid "guestfs_base64_in"
7797 msgstr ""
7798
7799 # type: verbatim
7800 #. type: verbatim
7801 #: ../src/guestfs-actions.pod:638
7802 #, no-wrap
7803 msgid ""
7804 " int\n"
7805 " guestfs_base64_in (guestfs_h *g,\n"
7806 "                    const char *base64file,\n"
7807 "                    const char *filename);\n"
7808 "\n"
7809 msgstr ""
7810
7811 # type: textblock
7812 #. type: textblock
7813 #: ../src/guestfs-actions.pod:643 ../fish/guestfish-actions.pod:432
7814 msgid ""
7815 "This command uploads base64-encoded data from C<base64file> to C<filename>."
7816 msgstr ""
7817
7818 # type: textblock
7819 #. type: textblock
7820 #: ../src/guestfs-actions.pod:648 ../src/guestfs-actions.pod:662
7821 msgid "(Added in 1.3.5)"
7822 msgstr ""
7823
7824 # type: =head2
7825 #. type: =head2
7826 #: ../src/guestfs-actions.pod:650
7827 msgid "guestfs_base64_out"
7828 msgstr ""
7829
7830 # type: verbatim
7831 #. type: verbatim
7832 #: ../src/guestfs-actions.pod:652
7833 #, no-wrap
7834 msgid ""
7835 " int\n"
7836 " guestfs_base64_out (guestfs_h *g,\n"
7837 "                     const char *filename,\n"
7838 "                     const char *base64file);\n"
7839 "\n"
7840 msgstr ""
7841
7842 # type: textblock
7843 #. type: textblock
7844 #: ../src/guestfs-actions.pod:657 ../fish/guestfish-actions.pod:441
7845 msgid ""
7846 "This command downloads the contents of C<filename>, writing it out to local "
7847 "file C<base64file> encoded as base64."
7848 msgstr ""
7849
7850 # type: =head2
7851 #. type: =head2
7852 #: ../src/guestfs-actions.pod:664
7853 msgid "guestfs_blockdev_flushbufs"
7854 msgstr ""
7855
7856 # type: verbatim
7857 #. type: verbatim
7858 #: ../src/guestfs-actions.pod:666
7859 #, no-wrap
7860 msgid ""
7861 " int\n"
7862 " guestfs_blockdev_flushbufs (guestfs_h *g,\n"
7863 "                             const char *device);\n"
7864 "\n"
7865 msgstr ""
7866
7867 # type: textblock
7868 #. type: textblock
7869 #: ../src/guestfs-actions.pod:670 ../fish/guestfish-actions.pod:450
7870 msgid ""
7871 "This tells the kernel to flush internal buffers associated with C<device>."
7872 msgstr ""
7873
7874 # type: textblock
7875 #. type: textblock
7876 #: ../src/guestfs-actions.pod:673 ../src/guestfs-actions.pod:690
7877 #: ../src/guestfs-actions.pod:705 ../src/guestfs-actions.pod:721
7878 #: ../src/guestfs-actions.pod:739 ../src/guestfs-actions.pod:758
7879 #: ../src/guestfs-actions.pod:772 ../src/guestfs-actions.pod:790
7880 #: ../src/guestfs-actions.pod:804 ../src/guestfs-actions.pod:818
7881 #: ../fish/guestfish-actions.pod:453 ../fish/guestfish-actions.pod:464
7882 #: ../fish/guestfish-actions.pod:473 ../fish/guestfish-actions.pod:483
7883 #: ../fish/guestfish-actions.pod:495 ../fish/guestfish-actions.pod:508
7884 #: ../fish/guestfish-actions.pod:516 ../fish/guestfish-actions.pod:527
7885 #: ../fish/guestfish-actions.pod:535 ../fish/guestfish-actions.pod:543
7886 msgid "This uses the L<blockdev(8)> command."
7887 msgstr ""
7888
7889 # type: textblock
7890 #. type: textblock
7891 #: ../src/guestfs-actions.pod:677 ../src/guestfs-actions.pod:694
7892 #: ../src/guestfs-actions.pod:709 ../src/guestfs-actions.pod:725
7893 #: ../src/guestfs-actions.pod:743 ../src/guestfs-actions.pod:762
7894 #: ../src/guestfs-actions.pod:776 ../src/guestfs-actions.pod:794
7895 #: ../src/guestfs-actions.pod:808 ../src/guestfs-actions.pod:822
7896 msgid "(Added in 0.9.3)"
7897 msgstr ""
7898
7899 # type: =head2
7900 #. type: =head2
7901 #: ../src/guestfs-actions.pod:679
7902 msgid "guestfs_blockdev_getbsz"
7903 msgstr ""
7904
7905 # type: verbatim
7906 #. type: verbatim
7907 #: ../src/guestfs-actions.pod:681
7908 #, no-wrap
7909 msgid ""
7910 " int\n"
7911 " guestfs_blockdev_getbsz (guestfs_h *g,\n"
7912 "                          const char *device);\n"
7913 "\n"
7914 msgstr ""
7915
7916 # type: textblock
7917 #. type: textblock
7918 #: ../src/guestfs-actions.pod:685 ../fish/guestfish-actions.pod:459
7919 msgid "This returns the block size of a device."
7920 msgstr ""
7921
7922 # type: textblock
7923 #. type: textblock
7924 #: ../src/guestfs-actions.pod:687 ../src/guestfs-actions.pod:787
7925 #: ../fish/guestfish-actions.pod:461 ../fish/guestfish-actions.pod:524
7926 msgid ""
7927 "(Note this is different from both I<size in blocks> and I<filesystem block "
7928 "size>)."
7929 msgstr ""
7930
7931 # type: =head2
7932 #. type: =head2
7933 #: ../src/guestfs-actions.pod:696
7934 msgid "guestfs_blockdev_getro"
7935 msgstr ""
7936
7937 # type: verbatim
7938 #. type: verbatim
7939 #: ../src/guestfs-actions.pod:698
7940 #, no-wrap
7941 msgid ""
7942 " int\n"
7943 " guestfs_blockdev_getro (guestfs_h *g,\n"
7944 "                         const char *device);\n"
7945 "\n"
7946 msgstr ""
7947
7948 # type: textblock
7949 #. type: textblock
7950 #: ../src/guestfs-actions.pod:702 ../fish/guestfish-actions.pod:470
7951 msgid ""
7952 "Returns a boolean indicating if the block device is read-only (true if read-"
7953 "only, false if not)."
7954 msgstr ""
7955
7956 # type: textblock
7957 #. type: textblock
7958 #: ../src/guestfs-actions.pod:707 ../src/guestfs-actions.pod:1414
7959 #: ../src/guestfs-actions.pod:1429 ../src/guestfs-actions.pod:1916
7960 #: ../src/guestfs-actions.pod:1927 ../src/guestfs-actions.pod:1999
7961 #: ../src/guestfs-actions.pod:2054 ../src/guestfs-actions.pod:2069
7962 #: ../src/guestfs-actions.pod:2094 ../src/guestfs-actions.pod:2117
7963 #: ../src/guestfs-actions.pod:3112 ../src/guestfs-actions.pod:3129
7964 #: ../src/guestfs-actions.pod:3148 ../src/guestfs-actions.pod:3311
7965 #: ../src/guestfs-actions.pod:3325 ../src/guestfs-actions.pod:3340
7966 #: ../src/guestfs-actions.pod:3354 ../src/guestfs-actions.pod:3370
7967 #: ../src/guestfs-actions.pod:3385 ../src/guestfs-actions.pod:3401
7968 #: ../src/guestfs-actions.pod:3415 ../src/guestfs-actions.pod:3428
7969 #: ../src/guestfs-actions.pod:3442 ../src/guestfs-actions.pod:3457
7970 #: ../src/guestfs-actions.pod:3472 ../src/guestfs-actions.pod:5019
7971 msgid "This function returns a C truth value on success or -1 on error."
7972 msgstr ""
7973
7974 # type: =head2
7975 #. type: =head2
7976 #: ../src/guestfs-actions.pod:711
7977 msgid "guestfs_blockdev_getsize64"
7978 msgstr ""
7979
7980 # type: verbatim
7981 #. type: verbatim
7982 #: ../src/guestfs-actions.pod:713
7983 #, no-wrap
7984 msgid ""
7985 " int64_t\n"
7986 " guestfs_blockdev_getsize64 (guestfs_h *g,\n"
7987 "                             const char *device);\n"
7988 "\n"
7989 msgstr ""
7990
7991 # type: textblock
7992 #. type: textblock
7993 #: ../src/guestfs-actions.pod:717 ../fish/guestfish-actions.pod:479
7994 msgid "This returns the size of the device in bytes."
7995 msgstr ""
7996
7997 # type: textblock
7998 #. type: textblock
7999 #: ../src/guestfs-actions.pod:719
8000 msgid "See also C<guestfs_blockdev_getsz>."
8001 msgstr ""
8002
8003 # type: =head2
8004 #. type: =head2
8005 #: ../src/guestfs-actions.pod:727
8006 msgid "guestfs_blockdev_getss"
8007 msgstr ""
8008
8009 # type: verbatim
8010 #. type: verbatim
8011 #: ../src/guestfs-actions.pod:729
8012 #, no-wrap
8013 msgid ""
8014 " int\n"
8015 " guestfs_blockdev_getss (guestfs_h *g,\n"
8016 "                         const char *device);\n"
8017 "\n"
8018 msgstr ""
8019
8020 # type: textblock
8021 #. type: textblock
8022 #: ../src/guestfs-actions.pod:733 ../fish/guestfish-actions.pod:489
8023 msgid ""
8024 "This returns the size of sectors on a block device.  Usually 512, but can be "
8025 "larger for modern devices."
8026 msgstr ""
8027
8028 # type: textblock
8029 #. type: textblock
8030 #: ../src/guestfs-actions.pod:736
8031 msgid ""
8032 "(Note, this is not the size in sectors, use C<guestfs_blockdev_getsz> for "
8033 "that)."
8034 msgstr ""
8035
8036 # type: =head2
8037 #. type: =head2
8038 #: ../src/guestfs-actions.pod:745
8039 msgid "guestfs_blockdev_getsz"
8040 msgstr ""
8041
8042 # type: verbatim
8043 #. type: verbatim
8044 #: ../src/guestfs-actions.pod:747
8045 #, no-wrap
8046 msgid ""
8047 " int64_t\n"
8048 " guestfs_blockdev_getsz (guestfs_h *g,\n"
8049 "                         const char *device);\n"
8050 "\n"
8051 msgstr ""
8052
8053 # type: textblock
8054 #. type: textblock
8055 #: ../src/guestfs-actions.pod:751 ../fish/guestfish-actions.pod:501
8056 msgid ""
8057 "This returns the size of the device in units of 512-byte sectors (even if "
8058 "the sectorsize isn't 512 bytes ... weird)."
8059 msgstr ""
8060
8061 # type: textblock
8062 #. type: textblock
8063 #: ../src/guestfs-actions.pod:754
8064 msgid ""
8065 "See also C<guestfs_blockdev_getss> for the real sector size of the device, "
8066 "and C<guestfs_blockdev_getsize64> for the more useful I<size in bytes>."
8067 msgstr ""
8068
8069 # type: =head2
8070 #. type: =head2
8071 #: ../src/guestfs-actions.pod:764
8072 msgid "guestfs_blockdev_rereadpt"
8073 msgstr ""
8074
8075 # type: verbatim
8076 #. type: verbatim
8077 #: ../src/guestfs-actions.pod:766
8078 #, no-wrap
8079 msgid ""
8080 " int\n"
8081 " guestfs_blockdev_rereadpt (guestfs_h *g,\n"
8082 "                            const char *device);\n"
8083 "\n"
8084 msgstr ""
8085
8086 # type: textblock
8087 #. type: textblock
8088 #: ../src/guestfs-actions.pod:770 ../fish/guestfish-actions.pod:514
8089 msgid "Reread the partition table on C<device>."
8090 msgstr ""
8091
8092 # type: =head2
8093 #. type: =head2
8094 #: ../src/guestfs-actions.pod:778
8095 msgid "guestfs_blockdev_setbsz"
8096 msgstr ""
8097
8098 # type: verbatim
8099 #. type: verbatim
8100 #: ../src/guestfs-actions.pod:780
8101 #, no-wrap
8102 msgid ""
8103 " int\n"
8104 " guestfs_blockdev_setbsz (guestfs_h *g,\n"
8105 "                          const char *device,\n"
8106 "                          int blocksize);\n"
8107 "\n"
8108 msgstr ""
8109
8110 # type: textblock
8111 #. type: textblock
8112 #: ../src/guestfs-actions.pod:785 ../fish/guestfish-actions.pod:522
8113 msgid "This sets the block size of a device."
8114 msgstr ""
8115
8116 # type: =head2
8117 #. type: =head2
8118 #: ../src/guestfs-actions.pod:796
8119 msgid "guestfs_blockdev_setro"
8120 msgstr ""
8121
8122 # type: verbatim
8123 #. type: verbatim
8124 #: ../src/guestfs-actions.pod:798
8125 #, no-wrap
8126 msgid ""
8127 " int\n"
8128 " guestfs_blockdev_setro (guestfs_h *g,\n"
8129 "                         const char *device);\n"
8130 "\n"
8131 msgstr ""
8132
8133 # type: textblock
8134 #. type: textblock
8135 #: ../src/guestfs-actions.pod:802 ../fish/guestfish-actions.pod:533
8136 msgid "Sets the block device named C<device> to read-only."
8137 msgstr ""
8138
8139 # type: =head2
8140 #. type: =head2
8141 #: ../src/guestfs-actions.pod:810
8142 msgid "guestfs_blockdev_setrw"
8143 msgstr ""
8144
8145 # type: verbatim
8146 #. type: verbatim
8147 #: ../src/guestfs-actions.pod:812
8148 #, no-wrap
8149 msgid ""
8150 " int\n"
8151 " guestfs_blockdev_setrw (guestfs_h *g,\n"
8152 "                         const char *device);\n"
8153 "\n"
8154 msgstr ""
8155
8156 # type: textblock
8157 #. type: textblock
8158 #: ../src/guestfs-actions.pod:816 ../fish/guestfish-actions.pod:541
8159 msgid "Sets the block device named C<device> to read-write."
8160 msgstr ""
8161
8162 # type: =head2
8163 #. type: =head2
8164 #: ../src/guestfs-actions.pod:824
8165 msgid "guestfs_case_sensitive_path"
8166 msgstr ""
8167
8168 # type: verbatim
8169 #. type: verbatim
8170 #: ../src/guestfs-actions.pod:826
8171 #, no-wrap
8172 msgid ""
8173 " char *\n"
8174 " guestfs_case_sensitive_path (guestfs_h *g,\n"
8175 "                              const char *path);\n"
8176 "\n"
8177 msgstr ""
8178
8179 # type: textblock
8180 #. type: textblock
8181 #: ../src/guestfs-actions.pod:830 ../fish/guestfish-actions.pod:549
8182 msgid ""
8183 "This can be used to resolve case insensitive paths on a filesystem which is "
8184 "case sensitive.  The use case is to resolve paths which you have read from "
8185 "Windows configuration files or the Windows Registry, to the true path."
8186 msgstr ""
8187
8188 # type: textblock
8189 #. type: textblock
8190 #: ../src/guestfs-actions.pod:835 ../fish/guestfish-actions.pod:554
8191 msgid ""
8192 "The command handles a peculiarity of the Linux ntfs-3g filesystem driver "
8193 "(and probably others), which is that although the underlying filesystem is "
8194 "case-insensitive, the driver exports the filesystem to Linux as case-"
8195 "sensitive."
8196 msgstr ""
8197
8198 # type: textblock
8199 #. type: textblock
8200 #: ../src/guestfs-actions.pod:840 ../fish/guestfish-actions.pod:559
8201 msgid ""
8202 "One consequence of this is that special directories such as C<c:\\windows> "
8203 "may appear as C</WINDOWS> or C</windows> (or other things) depending on the "
8204 "precise details of how they were created.  In Windows itself this would not "
8205 "be a problem."
8206 msgstr ""
8207
8208 # type: textblock
8209 #. type: textblock
8210 #: ../src/guestfs-actions.pod:846 ../fish/guestfish-actions.pod:565
8211 msgid ""
8212 "Bug or feature? You decide: L<http://www.tuxera.com/community/ntfs-3g-faq/"
8213 "#posixfilenames1>"
8214 msgstr ""
8215
8216 # type: textblock
8217 #. type: textblock
8218 #: ../src/guestfs-actions.pod:849 ../fish/guestfish-actions.pod:568
8219 msgid ""
8220 "This function resolves the true case of each element in the path and returns "
8221 "the case-sensitive path."
8222 msgstr ""
8223
8224 # type: textblock
8225 #. type: textblock
8226 #: ../src/guestfs-actions.pod:852
8227 msgid ""
8228 "Thus C<guestfs_case_sensitive_path> (\"/Windows/System32\")  might return C<"
8229 "\"/WINDOWS/system32\"> (the exact return value would depend on details of "
8230 "how the directories were originally created under Windows)."
8231 msgstr ""
8232
8233 # type: textblock
8234 #. type: textblock
8235 #: ../src/guestfs-actions.pod:857 ../fish/guestfish-actions.pod:576
8236 msgid "I<Note>: This function does not handle drive names, backslashes etc."
8237 msgstr ""
8238
8239 # type: textblock
8240 #. type: textblock
8241 #: ../src/guestfs-actions.pod:860
8242 msgid "See also C<guestfs_realpath>."
8243 msgstr ""
8244
8245 # type: textblock
8246 #. type: textblock
8247 #: ../src/guestfs-actions.pod:865 ../src/guestfs-actions.pod:7038
8248 msgid "(Added in 1.0.75)"
8249 msgstr ""
8250
8251 # type: =head2
8252 #. type: =head2
8253 #: ../src/guestfs-actions.pod:867
8254 msgid "guestfs_cat"
8255 msgstr ""
8256
8257 # type: verbatim
8258 #. type: verbatim
8259 #: ../src/guestfs-actions.pod:869
8260 #, no-wrap
8261 msgid ""
8262 " char *\n"
8263 " guestfs_cat (guestfs_h *g,\n"
8264 "              const char *path);\n"
8265 "\n"
8266 msgstr ""
8267
8268 # type: textblock
8269 #. type: textblock
8270 #: ../src/guestfs-actions.pod:873 ../src/guestfs-actions.pod:5506
8271 #: ../fish/guestfish-actions.pod:585 ../fish/guestfish-actions.pod:3707
8272 msgid "Return the contents of the file named C<path>."
8273 msgstr ""
8274
8275 # type: textblock
8276 #. type: textblock
8277 #: ../src/guestfs-actions.pod:875
8278 msgid ""
8279 "Note that this function cannot correctly handle binary files (specifically, "
8280 "files containing C<\\0> character which is treated as end of string).  For "
8281 "those you need to use the C<guestfs_read_file> or C<guestfs_download> "
8282 "functions which have a more complex interface."
8283 msgstr ""
8284
8285 # type: textblock
8286 #. type: textblock
8287 #: ../src/guestfs-actions.pod:883 ../src/guestfs-actions.pod:1062
8288 #: ../src/guestfs-actions.pod:1082 ../src/guestfs-actions.pod:1378
8289 #: ../src/guestfs-actions.pod:1397 ../src/guestfs-actions.pod:1500
8290 #: ../src/guestfs-actions.pod:1519 ../src/guestfs-actions.pod:1765
8291 #: ../src/guestfs-actions.pod:2223 ../src/guestfs-actions.pod:2242
8292 #: ../src/guestfs-actions.pod:2307 ../src/guestfs-actions.pod:2331
8293 #: ../src/guestfs-actions.pod:2348 ../src/guestfs-actions.pod:2377
8294 #: ../src/guestfs-actions.pod:5288 ../src/guestfs-actions.pod:5314
8295 #: ../src/guestfs-actions.pod:5445 ../src/guestfs-actions.pod:5471
8296 #: ../src/guestfs-actions.pod:5495 ../src/guestfs-actions.pod:6423
8297 #: ../src/guestfs-actions.pod:6478 ../src/guestfs-actions.pod:6624
8298 #: ../src/guestfs-actions.pod:6648 ../src/guestfs-actions.pod:7317
8299 #: ../src/guestfs-actions.pod:7343 ../src/guestfs-actions.pod:7369
8300 #: ../src/guestfs-actions.pod:7388 ../src/guestfs-actions.pod:7473
8301 #: ../src/guestfs-actions.pod:7492 ../src/guestfs-actions.pod:7538
8302 #: ../src/guestfs-actions.pod:7557 ../fish/guestfish-actions.pod:592
8303 #: ../fish/guestfish-actions.pod:727 ../fish/guestfish-actions.pod:739
8304 #: ../fish/guestfish-actions.pod:915 ../fish/guestfish-actions.pod:925
8305 #: ../fish/guestfish-actions.pod:992 ../fish/guestfish-actions.pod:1002
8306 #: ../fish/guestfish-actions.pod:1194 ../fish/guestfish-actions.pod:1495
8307 #: ../fish/guestfish-actions.pod:1505 ../fish/guestfish-actions.pod:1555
8308 #: ../fish/guestfish-actions.pod:1570 ../fish/guestfish-actions.pod:1580
8309 #: ../fish/guestfish-actions.pod:1599 ../fish/guestfish-actions.pod:3577
8310 #: ../fish/guestfish-actions.pod:3592 ../fish/guestfish-actions.pod:3668
8311 #: ../fish/guestfish-actions.pod:3685 ../fish/guestfish-actions.pod:3700
8312 #: ../fish/guestfish-actions.pod:4354 ../fish/guestfish-actions.pod:4400
8313 #: ../fish/guestfish-actions.pod:4485 ../fish/guestfish-actions.pod:4500
8314 #: ../fish/guestfish-actions.pod:4910 ../fish/guestfish-actions.pod:4928
8315 #: ../fish/guestfish-actions.pod:4945 ../fish/guestfish-actions.pod:4955
8316 #: ../fish/guestfish-actions.pod:5003 ../fish/guestfish-actions.pod:5013
8317 #: ../fish/guestfish-actions.pod:5042 ../fish/guestfish-actions.pod:5052
8318 msgid ""
8319 "Because of the message protocol, there is a transfer limit of somewhere "
8320 "between 2MB and 4MB.  See L<guestfs(3)/PROTOCOL LIMITS>."
8321 msgstr ""
8322
8323 # type: textblock
8324 #. type: textblock
8325 #: ../src/guestfs-actions.pod:886 ../src/guestfs-actions.pod:3588
8326 #: ../src/guestfs-actions.pod:3650 ../src/guestfs-actions.pod:3667
8327 #: ../src/guestfs-actions.pod:3755 ../src/guestfs-actions.pod:4160
8328 #: ../src/guestfs-actions.pod:4174 ../src/guestfs-actions.pod:5394
8329 #: ../src/guestfs-actions.pod:5408 ../src/guestfs-actions.pod:7197
8330 #: ../src/guestfs-actions.pod:7211
8331 msgid "(Added in 0.4)"
8332 msgstr ""
8333
8334 # type: =head2
8335 #. type: =head2
8336 #: ../src/guestfs-actions.pod:888
8337 msgid "guestfs_checksum"
8338 msgstr ""
8339
8340 # type: verbatim
8341 #. type: verbatim
8342 #: ../src/guestfs-actions.pod:890
8343 #, no-wrap
8344 msgid ""
8345 " char *\n"
8346 " guestfs_checksum (guestfs_h *g,\n"
8347 "                   const char *csumtype,\n"
8348 "                   const char *path);\n"
8349 "\n"
8350 msgstr ""
8351
8352 # type: textblock
8353 #. type: textblock
8354 #: ../src/guestfs-actions.pod:895 ../fish/guestfish-actions.pod:599
8355 msgid ""
8356 "This call computes the MD5, SHAx or CRC checksum of the file named C<path>."
8357 msgstr ""
8358
8359 # type: textblock
8360 #. type: textblock
8361 #: ../src/guestfs-actions.pod:898 ../fish/guestfish-actions.pod:602
8362 msgid ""
8363 "The type of checksum to compute is given by the C<csumtype> parameter which "
8364 "must have one of the following values:"
8365 msgstr ""
8366
8367 # type: =item
8368 #. type: =item
8369 #: ../src/guestfs-actions.pod:903 ../fish/guestfish-actions.pod:607
8370 msgid "C<crc>"
8371 msgstr ""
8372
8373 # type: textblock
8374 #. type: textblock
8375 #: ../src/guestfs-actions.pod:905 ../fish/guestfish-actions.pod:609
8376 msgid ""
8377 "Compute the cyclic redundancy check (CRC) specified by POSIX for the "
8378 "C<cksum> command."
8379 msgstr ""
8380
8381 # type: =item
8382 #. type: =item
8383 #: ../src/guestfs-actions.pod:908 ../fish/guestfish-actions.pod:612
8384 msgid "C<md5>"
8385 msgstr ""
8386
8387 # type: textblock
8388 #. type: textblock
8389 #: ../src/guestfs-actions.pod:910 ../fish/guestfish-actions.pod:614
8390 msgid "Compute the MD5 hash (using the C<md5sum> program)."
8391 msgstr ""
8392
8393 # type: =item
8394 #. type: =item
8395 #: ../src/guestfs-actions.pod:912 ../fish/guestfish-actions.pod:616
8396 msgid "C<sha1>"
8397 msgstr ""
8398
8399 # type: textblock
8400 #. type: textblock
8401 #: ../src/guestfs-actions.pod:914 ../fish/guestfish-actions.pod:618
8402 msgid "Compute the SHA1 hash (using the C<sha1sum> program)."
8403 msgstr ""
8404
8405 # type: =item
8406 #. type: =item
8407 #: ../src/guestfs-actions.pod:916 ../fish/guestfish-actions.pod:620
8408 msgid "C<sha224>"
8409 msgstr ""
8410
8411 # type: textblock
8412 #. type: textblock
8413 #: ../src/guestfs-actions.pod:918 ../fish/guestfish-actions.pod:622
8414 msgid "Compute the SHA224 hash (using the C<sha224sum> program)."
8415 msgstr ""
8416
8417 # type: =item
8418 #. type: =item
8419 #: ../src/guestfs-actions.pod:920 ../fish/guestfish-actions.pod:624
8420 msgid "C<sha256>"
8421 msgstr ""
8422
8423 # type: textblock
8424 #. type: textblock
8425 #: ../src/guestfs-actions.pod:922 ../fish/guestfish-actions.pod:626
8426 msgid "Compute the SHA256 hash (using the C<sha256sum> program)."
8427 msgstr ""
8428
8429 # type: =item
8430 #. type: =item
8431 #: ../src/guestfs-actions.pod:924 ../fish/guestfish-actions.pod:628
8432 msgid "C<sha384>"
8433 msgstr ""
8434
8435 # type: textblock
8436 #. type: textblock
8437 #: ../src/guestfs-actions.pod:926 ../fish/guestfish-actions.pod:630
8438 msgid "Compute the SHA384 hash (using the C<sha384sum> program)."
8439 msgstr ""
8440
8441 # type: =item
8442 #. type: =item
8443 #: ../src/guestfs-actions.pod:928 ../fish/guestfish-actions.pod:632
8444 msgid "C<sha512>"
8445 msgstr ""
8446
8447 # type: textblock
8448 #. type: textblock
8449 #: ../src/guestfs-actions.pod:930 ../fish/guestfish-actions.pod:634
8450 msgid "Compute the SHA512 hash (using the C<sha512sum> program)."
8451 msgstr ""
8452
8453 # type: textblock
8454 #. type: textblock
8455 #: ../src/guestfs-actions.pod:934 ../fish/guestfish-actions.pod:638
8456 msgid "The checksum is returned as a printable string."
8457 msgstr ""
8458
8459 # type: textblock
8460 #. type: textblock
8461 #: ../src/guestfs-actions.pod:936
8462 msgid "To get the checksum for a device, use C<guestfs_checksum_device>."
8463 msgstr ""
8464
8465 # type: textblock
8466 #. type: textblock
8467 #: ../src/guestfs-actions.pod:938
8468 msgid "To get the checksums for many files, use C<guestfs_checksums_out>."
8469 msgstr ""
8470
8471 # type: textblock
8472 #. type: textblock
8473 #: ../src/guestfs-actions.pod:943 ../src/guestfs-actions.pod:1251
8474 #: ../src/guestfs-actions.pod:2085 ../src/guestfs-actions.pod:3327
8475 #: ../src/guestfs-actions.pod:3356 ../src/guestfs-actions.pod:3417
8476 #: ../src/guestfs-actions.pod:3444 ../src/guestfs-actions.pod:6894
8477 msgid "(Added in 1.0.2)"
8478 msgstr ""
8479
8480 # type: =head2
8481 #. type: =head2
8482 #: ../src/guestfs-actions.pod:945
8483 msgid "guestfs_checksum_device"
8484 msgstr ""
8485
8486 # type: verbatim
8487 #. type: verbatim
8488 #: ../src/guestfs-actions.pod:947
8489 #, no-wrap
8490 msgid ""
8491 " char *\n"
8492 " guestfs_checksum_device (guestfs_h *g,\n"
8493 "                          const char *csumtype,\n"
8494 "                          const char *device);\n"
8495 "\n"
8496 msgstr ""
8497
8498 # type: textblock
8499 #. type: textblock
8500 #: ../src/guestfs-actions.pod:952
8501 msgid ""
8502 "This call computes the MD5, SHAx or CRC checksum of the contents of the "
8503 "device named C<device>.  For the types of checksums supported see the "
8504 "C<guestfs_checksum> command."
8505 msgstr ""
8506
8507 # type: textblock
8508 #. type: textblock
8509 #: ../src/guestfs-actions.pod:959 ../src/guestfs-actions.pod:4925
8510 #: ../src/guestfs-actions.pod:4984 ../src/guestfs-actions.pod:5021
8511 #: ../src/guestfs-actions.pod:5039 ../src/guestfs-actions.pod:5215
8512 #: ../src/guestfs-actions.pod:6803 ../src/guestfs-actions.pod:6817
8513 #: ../src/guestfs-actions.pod:7223
8514 msgid "(Added in 1.3.2)"
8515 msgstr ""
8516
8517 # type: =head2
8518 #. type: =head2
8519 #: ../src/guestfs-actions.pod:961
8520 msgid "guestfs_checksums_out"
8521 msgstr ""
8522
8523 # type: verbatim
8524 #. type: verbatim
8525 #: ../src/guestfs-actions.pod:963
8526 #, no-wrap
8527 msgid ""
8528 " int\n"
8529 " guestfs_checksums_out (guestfs_h *g,\n"
8530 "                        const char *csumtype,\n"
8531 "                        const char *directory,\n"
8532 "                        const char *sumsfile);\n"
8533 "\n"
8534 msgstr ""
8535
8536 # type: textblock
8537 #. type: textblock
8538 #: ../src/guestfs-actions.pod:969 ../fish/guestfish-actions.pod:656
8539 msgid ""
8540 "This command computes the checksums of all regular files in C<directory> and "
8541 "then emits a list of those checksums to the local output file C<sumsfile>."
8542 msgstr ""
8543
8544 # type: textblock
8545 #. type: textblock
8546 #: ../src/guestfs-actions.pod:973 ../fish/guestfish-actions.pod:660
8547 msgid ""
8548 "This can be used for verifying the integrity of a virtual machine.  However "
8549 "to be properly secure you should pay attention to the output of the checksum "
8550 "command (it uses the ones from GNU coreutils).  In particular when the "
8551 "filename is not printable, coreutils uses a special backslash syntax.  For "
8552 "more information, see the GNU coreutils info file."
8553 msgstr ""
8554
8555 # type: textblock
8556 #. type: textblock
8557 #: ../src/guestfs-actions.pod:983
8558 msgid "(Added in 1.3.7)"
8559 msgstr ""
8560
8561 # type: =head2
8562 #. type: =head2
8563 #: ../src/guestfs-actions.pod:985
8564 msgid "guestfs_chmod"
8565 msgstr ""
8566
8567 # type: verbatim
8568 #. type: verbatim
8569 #: ../src/guestfs-actions.pod:987
8570 #, no-wrap
8571 msgid ""
8572 " int\n"
8573 " guestfs_chmod (guestfs_h *g,\n"
8574 "                int mode,\n"
8575 "                const char *path);\n"
8576 "\n"
8577 msgstr ""
8578
8579 # type: textblock
8580 #. type: textblock
8581 #: ../src/guestfs-actions.pod:992 ../fish/guestfish-actions.pod:674
8582 msgid ""
8583 "Change the mode (permissions) of C<path> to C<mode>.  Only numeric modes are "
8584 "supported."
8585 msgstr ""
8586
8587 # type: textblock
8588 #. type: textblock
8589 #: ../src/guestfs-actions.pod:995 ../fish/guestfish-actions.pod:677
8590 msgid ""
8591 "I<Note>: When using this command from guestfish, C<mode> by default would be "
8592 "decimal, unless you prefix it with C<0> to get octal, ie. use C<0700> not "
8593 "C<700>."
8594 msgstr ""
8595
8596 # type: textblock
8597 #. type: textblock
8598 #: ../src/guestfs-actions.pod:999 ../src/guestfs-actions.pod:4411
8599 #: ../src/guestfs-actions.pod:4608 ../src/guestfs-actions.pod:4627
8600 #: ../src/guestfs-actions.pod:4646 ../fish/guestfish-actions.pod:681
8601 #: ../fish/guestfish-actions.pod:3007 ../fish/guestfish-actions.pod:3136
8602 #: ../fish/guestfish-actions.pod:3146 ../fish/guestfish-actions.pod:3156
8603 msgid "The mode actually set is affected by the umask."
8604 msgstr ""
8605
8606 # type: =head2
8607 #. type: =head2
8608 #: ../src/guestfs-actions.pod:1005
8609 msgid "guestfs_chown"
8610 msgstr ""
8611
8612 # type: verbatim
8613 #. type: verbatim
8614 #: ../src/guestfs-actions.pod:1007
8615 #, no-wrap
8616 msgid ""
8617 " int\n"
8618 " guestfs_chown (guestfs_h *g,\n"
8619 "                int owner,\n"
8620 "                int group,\n"
8621 "                const char *path);\n"
8622 "\n"
8623 msgstr ""
8624
8625 # type: textblock
8626 #. type: textblock
8627 #: ../src/guestfs-actions.pod:1013 ../fish/guestfish-actions.pod:687
8628 msgid "Change the file owner to C<owner> and group to C<group>."
8629 msgstr ""
8630
8631 # type: textblock
8632 #. type: textblock
8633 #: ../src/guestfs-actions.pod:1015 ../src/guestfs-actions.pod:3519
8634 #: ../fish/guestfish-actions.pod:689 ../fish/guestfish-actions.pod:2465
8635 msgid ""
8636 "Only numeric uid and gid are supported.  If you want to use names, you will "
8637 "need to locate and parse the password file yourself (Augeas support makes "
8638 "this relatively easy)."
8639 msgstr ""
8640
8641 # type: =head2
8642 #. type: =head2
8643 #: ../src/guestfs-actions.pod:1023
8644 msgid "guestfs_command"
8645 msgstr ""
8646
8647 # type: verbatim
8648 #. type: verbatim
8649 #: ../src/guestfs-actions.pod:1025
8650 #, no-wrap
8651 msgid ""
8652 " char *\n"
8653 " guestfs_command (guestfs_h *g,\n"
8654 "                  char *const *arguments);\n"
8655 "\n"
8656 msgstr ""
8657
8658 # type: textblock
8659 #. type: textblock
8660 #: ../src/guestfs-actions.pod:1029 ../fish/guestfish-actions.pod:697
8661 msgid ""
8662 "This call runs a command from the guest filesystem.  The filesystem must be "
8663 "mounted, and must contain a compatible operating system (ie. something "
8664 "Linux, with the same or compatible processor architecture)."
8665 msgstr ""
8666
8667 # type: textblock
8668 #. type: textblock
8669 #: ../src/guestfs-actions.pod:1034
8670 msgid ""
8671 "The single parameter is an argv-style list of arguments.  The first element "
8672 "is the name of the program to run.  Subsequent elements are parameters.  The "
8673 "list must be non-empty (ie. must contain a program name).  Note that the "
8674 "command runs directly, and is I<not> invoked via the shell (see "
8675 "C<guestfs_sh>)."
8676 msgstr ""
8677
8678 # type: textblock
8679 #. type: textblock
8680 #: ../src/guestfs-actions.pod:1041 ../fish/guestfish-actions.pod:709
8681 msgid "The return value is anything printed to I<stdout> by the command."
8682 msgstr ""
8683
8684 # type: textblock
8685 #. type: textblock
8686 #: ../src/guestfs-actions.pod:1044 ../fish/guestfish-actions.pod:712
8687 msgid ""
8688 "If the command returns a non-zero exit status, then this function returns an "
8689 "error message.  The error message string is the content of I<stderr> from "
8690 "the command."
8691 msgstr ""
8692
8693 # type: textblock
8694 #. type: textblock
8695 #: ../src/guestfs-actions.pod:1048 ../fish/guestfish-actions.pod:716
8696 msgid ""
8697 "The C<$PATH> environment variable will contain at least C</usr/bin> and C</"
8698 "bin>.  If you require a program from another location, you should provide "
8699 "the full path in the first parameter."
8700 msgstr ""
8701
8702 # type: textblock
8703 #. type: textblock
8704 #: ../src/guestfs-actions.pod:1053 ../fish/guestfish-actions.pod:721
8705 msgid ""
8706 "Shared libraries and data files required by the program must be available on "
8707 "filesystems which are mounted in the correct places.  It is the caller's "
8708 "responsibility to ensure all filesystems that are needed are mounted at the "
8709 "right locations."
8710 msgstr ""
8711
8712 # type: textblock
8713 #. type: textblock
8714 #: ../src/guestfs-actions.pod:1065 ../src/guestfs-actions.pod:1085
8715 #: ../src/guestfs-actions.pod:1550
8716 msgid "(Added in 0.9.1)"
8717 msgstr ""
8718
8719 # type: =head2
8720 #. type: =head2
8721 #: ../src/guestfs-actions.pod:1067
8722 msgid "guestfs_command_lines"
8723 msgstr ""
8724
8725 # type: verbatim
8726 #. type: verbatim
8727 #: ../src/guestfs-actions.pod:1069
8728 #, no-wrap
8729 msgid ""
8730 " char **\n"
8731 " guestfs_command_lines (guestfs_h *g,\n"
8732 "                        char *const *arguments);\n"
8733 "\n"
8734 msgstr ""
8735
8736 # type: textblock
8737 #. type: textblock
8738 #: ../src/guestfs-actions.pod:1073
8739 msgid ""
8740 "This is the same as C<guestfs_command>, but splits the result into a list of "
8741 "lines."
8742 msgstr ""
8743
8744 # type: textblock
8745 #. type: textblock
8746 #: ../src/guestfs-actions.pod:1076
8747 msgid "See also: C<guestfs_sh_lines>"
8748 msgstr ""
8749
8750 # type: =head2
8751 #. type: =head2
8752 #: ../src/guestfs-actions.pod:1087
8753 msgid "guestfs_config"
8754 msgstr ""
8755
8756 # type: verbatim
8757 #. type: verbatim
8758 #: ../src/guestfs-actions.pod:1089
8759 #, no-wrap
8760 msgid ""
8761 " int\n"
8762 " guestfs_config (guestfs_h *g,\n"
8763 "                 const char *qemuparam,\n"
8764 "                 const char *qemuvalue);\n"
8765 "\n"
8766 msgstr ""
8767
8768 #. type: textblock
8769 #: ../src/guestfs-actions.pod:1094 ../fish/guestfish-actions.pod:746
8770 msgid ""
8771 "This can be used to add arbitrary qemu command line parameters of the form "
8772 "I<-param value>.  Actually it's not quite arbitrary - we prevent you from "
8773 "setting some parameters which would interfere with parameters that we use."
8774 msgstr ""
8775
8776 # type: textblock
8777 #. type: textblock
8778 #: ../src/guestfs-actions.pod:1099 ../fish/guestfish-actions.pod:751
8779 msgid "The first character of C<param> string must be a C<-> (dash)."
8780 msgstr ""
8781
8782 # type: textblock
8783 #. type: textblock
8784 #: ../src/guestfs-actions.pod:1101 ../fish/guestfish-actions.pod:753
8785 msgid "C<value> can be NULL."
8786 msgstr ""
8787
8788 # type: =head2
8789 #. type: =head2
8790 #: ../src/guestfs-actions.pod:1107
8791 msgid "guestfs_copy_size"
8792 msgstr ""
8793
8794 # type: verbatim
8795 #. type: verbatim
8796 #: ../src/guestfs-actions.pod:1109
8797 #, no-wrap
8798 msgid ""
8799 " int\n"
8800 " guestfs_copy_size (guestfs_h *g,\n"
8801 "                    const char *src,\n"
8802 "                    const char *dest,\n"
8803 "                    int64_t size);\n"
8804 "\n"
8805 msgstr ""
8806
8807 # type: textblock
8808 #. type: textblock
8809 #: ../src/guestfs-actions.pod:1115 ../fish/guestfish-actions.pod:759
8810 msgid ""
8811 "This command copies exactly C<size> bytes from one source device or file "
8812 "C<src> to another destination device or file C<dest>."
8813 msgstr ""
8814
8815 # type: textblock
8816 #. type: textblock
8817 #: ../src/guestfs-actions.pod:1118 ../fish/guestfish-actions.pod:762
8818 msgid ""
8819 "Note this will fail if the source is too short or if the destination is not "
8820 "large enough."
8821 msgstr ""
8822
8823 #. type: textblock
8824 #: ../src/guestfs-actions.pod:1123 ../src/guestfs-actions.pod:1246
8825 #: ../src/guestfs-actions.pod:1277 ../src/guestfs-actions.pod:1322
8826 #: ../src/guestfs-actions.pod:1699 ../src/guestfs-actions.pod:1721
8827 #: ../src/guestfs-actions.pod:3500 ../src/guestfs-actions.pod:6889
8828 #: ../src/guestfs-actions.pod:6923 ../src/guestfs-actions.pod:7409
8829 #: ../src/guestfs-actions.pod:7428
8830 msgid ""
8831 "This long-running command can generate progress notification messages so "
8832 "that the caller can display a progress bar or indicator.  To receive these "
8833 "messages, the caller must register a progress event callback.  See L<guestfs"
8834 "(3)/GUESTFS_EVENT_PROGRESS>."
8835 msgstr ""
8836
8837 # type: textblock
8838 #. type: textblock
8839 #: ../src/guestfs-actions.pod:1128 ../src/guestfs-actions.pod:4187
8840 #: ../src/guestfs-actions.pod:5421 ../src/guestfs-actions.pod:7130
8841 #: ../src/guestfs-actions.pod:7150 ../src/guestfs-actions.pod:7236
8842 msgid "(Added in 1.0.87)"
8843 msgstr ""
8844
8845 # type: =head2
8846 #. type: =head2
8847 #: ../src/guestfs-actions.pod:1130
8848 msgid "guestfs_cp"
8849 msgstr ""
8850
8851 # type: verbatim
8852 #. type: verbatim
8853 #: ../src/guestfs-actions.pod:1132
8854 #, no-wrap
8855 msgid ""
8856 " int\n"
8857 " guestfs_cp (guestfs_h *g,\n"
8858 "             const char *src,\n"
8859 "             const char *dest);\n"
8860 "\n"
8861 msgstr ""
8862
8863 # type: textblock
8864 #. type: textblock
8865 #: ../src/guestfs-actions.pod:1137 ../fish/guestfish-actions.pod:769
8866 msgid ""
8867 "This copies a file from C<src> to C<dest> where C<dest> is either a "
8868 "destination filename or destination directory."
8869 msgstr ""
8870
8871 # type: textblock
8872 #. type: textblock
8873 #: ../src/guestfs-actions.pod:1142 ../src/guestfs-actions.pod:1156
8874 #: ../src/guestfs-actions.pod:1228 ../src/guestfs-actions.pod:1302
8875 #: ../src/guestfs-actions.pod:1416 ../src/guestfs-actions.pod:4879
8876 #: ../src/guestfs-actions.pod:5265
8877 msgid "(Added in 1.0.18)"
8878 msgstr ""
8879
8880 # type: =head2
8881 #. type: =head2
8882 #: ../src/guestfs-actions.pod:1144
8883 msgid "guestfs_cp_a"
8884 msgstr ""
8885
8886 # type: verbatim
8887 #. type: verbatim
8888 #: ../src/guestfs-actions.pod:1146
8889 #, no-wrap
8890 msgid ""
8891 " int\n"
8892 " guestfs_cp_a (guestfs_h *g,\n"
8893 "               const char *src,\n"
8894 "               const char *dest);\n"
8895 "\n"
8896 msgstr ""
8897
8898 # type: textblock
8899 #. type: textblock
8900 #: ../src/guestfs-actions.pod:1151 ../fish/guestfish-actions.pod:776
8901 msgid ""
8902 "This copies a file or directory from C<src> to C<dest> recursively using the "
8903 "C<cp -a> command."
8904 msgstr ""
8905
8906 # type: =head2
8907 #. type: =head2
8908 #: ../src/guestfs-actions.pod:1158
8909 msgid "guestfs_dd"
8910 msgstr ""
8911
8912 # type: verbatim
8913 #. type: verbatim
8914 #: ../src/guestfs-actions.pod:1160
8915 #, no-wrap
8916 msgid ""
8917 " int\n"
8918 " guestfs_dd (guestfs_h *g,\n"
8919 "             const char *src,\n"
8920 "             const char *dest);\n"
8921 "\n"
8922 msgstr ""
8923
8924 # type: textblock
8925 #. type: textblock
8926 #: ../src/guestfs-actions.pod:1165 ../fish/guestfish-actions.pod:783
8927 msgid ""
8928 "This command copies from one source device or file C<src> to another "
8929 "destination device or file C<dest>.  Normally you would use this to copy to "
8930 "or from a device or partition, for example to duplicate a filesystem."
8931 msgstr ""
8932
8933 # type: textblock
8934 #. type: textblock
8935 #: ../src/guestfs-actions.pod:1170
8936 msgid ""
8937 "If the destination is a device, it must be as large or larger than the "
8938 "source file or device, otherwise the copy will fail.  This command cannot do "
8939 "partial copies (see C<guestfs_copy_size>)."
8940 msgstr ""
8941
8942 # type: =head2
8943 #. type: =head2
8944 #: ../src/guestfs-actions.pod:1178
8945 msgid "guestfs_df"
8946 msgstr ""
8947
8948 # type: verbatim
8949 #. type: verbatim
8950 #: ../src/guestfs-actions.pod:1180
8951 #, no-wrap
8952 msgid ""
8953 " char *\n"
8954 " guestfs_df (guestfs_h *g);\n"
8955 "\n"
8956 msgstr ""
8957
8958 # type: textblock
8959 #. type: textblock
8960 #: ../src/guestfs-actions.pod:1183 ../fish/guestfish-actions.pod:796
8961 msgid "This command runs the C<df> command to report disk space used."
8962 msgstr ""
8963
8964 # type: textblock
8965 #. type: textblock
8966 #: ../src/guestfs-actions.pod:1185 ../src/guestfs-actions.pod:1202
8967 msgid ""
8968 "This command is mostly useful for interactive sessions.  It is I<not> "
8969 "intended that you try to parse the output string.  Use C<guestfs_statvfs> "
8970 "from programs."
8971 msgstr ""
8972
8973 # type: textblock
8974 #. type: textblock
8975 #: ../src/guestfs-actions.pod:1192 ../src/guestfs-actions.pod:1209
8976 #: ../src/guestfs-actions.pod:1327 ../src/guestfs-actions.pod:2310
8977 #: ../src/guestfs-actions.pod:2334 ../src/guestfs-actions.pod:2402
8978 #: ../src/guestfs-actions.pod:4297 ../src/guestfs-actions.pod:4779
8979 #: ../src/guestfs-actions.pod:6627 ../src/guestfs-actions.pod:6651
8980 #: ../src/guestfs-actions.pod:7276 ../src/guestfs-actions.pod:7289
8981 #: ../src/guestfs-actions.pod:7302
8982 msgid "(Added in 1.0.54)"
8983 msgstr ""
8984
8985 # type: =head2
8986 #. type: =head2
8987 #: ../src/guestfs-actions.pod:1194
8988 msgid "guestfs_df_h"
8989 msgstr ""
8990
8991 # type: verbatim
8992 #. type: verbatim
8993 #: ../src/guestfs-actions.pod:1196
8994 #, no-wrap
8995 msgid ""
8996 " char *\n"
8997 " guestfs_df_h (guestfs_h *g);\n"
8998 "\n"
8999 msgstr ""
9000
9001 # type: textblock
9002 #. type: textblock
9003 #: ../src/guestfs-actions.pod:1199 ../fish/guestfish-actions.pod:806
9004 msgid ""
9005 "This command runs the C<df -h> command to report disk space used in human-"
9006 "readable format."
9007 msgstr ""
9008
9009 # type: =head2
9010 #. type: =head2
9011 #: ../src/guestfs-actions.pod:1211
9012 msgid "guestfs_dmesg"
9013 msgstr ""
9014
9015 # type: verbatim
9016 #. type: verbatim
9017 #: ../src/guestfs-actions.pod:1213
9018 #, no-wrap
9019 msgid ""
9020 " char *\n"
9021 " guestfs_dmesg (guestfs_h *g);\n"
9022 "\n"
9023 msgstr ""
9024
9025 # type: textblock
9026 #. type: textblock
9027 #: ../src/guestfs-actions.pod:1216 ../fish/guestfish-actions.pod:817
9028 msgid ""
9029 "This returns the kernel messages (C<dmesg> output) from the guest kernel.  "
9030 "This is sometimes useful for extended debugging of problems."
9031 msgstr ""
9032
9033 # type: textblock
9034 #. type: textblock
9035 #: ../src/guestfs-actions.pod:1220
9036 msgid ""
9037 "Another way to get the same information is to enable verbose messages with "
9038 "C<guestfs_set_verbose> or by setting the environment variable "
9039 "C<LIBGUESTFS_DEBUG=1> before running the program."
9040 msgstr ""
9041
9042 # type: =head2
9043 #. type: =head2
9044 #: ../src/guestfs-actions.pod:1230
9045 msgid "guestfs_download"
9046 msgstr ""
9047
9048 # type: verbatim
9049 #. type: verbatim
9050 #: ../src/guestfs-actions.pod:1232
9051 #, no-wrap
9052 msgid ""
9053 " int\n"
9054 " guestfs_download (guestfs_h *g,\n"
9055 "                   const char *remotefilename,\n"
9056 "                   const char *filename);\n"
9057 "\n"
9058 msgstr ""
9059
9060 # type: textblock
9061 #. type: textblock
9062 #: ../src/guestfs-actions.pod:1237 ../src/guestfs-actions.pod:1262
9063 #: ../fish/guestfish-actions.pod:830 ../fish/guestfish-actions.pod:843
9064 msgid ""
9065 "Download file C<remotefilename> and save it as C<filename> on the local "
9066 "machine."
9067 msgstr ""
9068
9069 # type: textblock
9070 #. type: textblock
9071 #: ../src/guestfs-actions.pod:1240 ../src/guestfs-actions.pod:6883
9072 #: ../fish/guestfish-actions.pod:833 ../fish/guestfish-actions.pod:4658
9073 msgid "C<filename> can also be a named pipe."
9074 msgstr ""
9075
9076 # type: textblock
9077 #. type: textblock
9078 #: ../src/guestfs-actions.pod:1242
9079 msgid "See also C<guestfs_upload>, C<guestfs_cat>."
9080 msgstr ""
9081
9082 # type: =head2
9083 #. type: =head2
9084 #: ../src/guestfs-actions.pod:1253
9085 msgid "guestfs_download_offset"
9086 msgstr ""
9087
9088 # type: verbatim
9089 #. type: verbatim
9090 #: ../src/guestfs-actions.pod:1255
9091 #, no-wrap
9092 msgid ""
9093 " int\n"
9094 " guestfs_download_offset (guestfs_h *g,\n"
9095 "                          const char *remotefilename,\n"
9096 "                          const char *filename,\n"
9097 "                          int64_t offset,\n"
9098 "                          int64_t size);\n"
9099 "\n"
9100 msgstr ""
9101
9102 # type: textblock
9103 #. type: textblock
9104 #: ../src/guestfs-actions.pod:1265 ../fish/guestfish-actions.pod:846
9105 msgid ""
9106 "C<remotefilename> is read for C<size> bytes starting at C<offset> (this "
9107 "region must be within the file or device)."
9108 msgstr ""
9109
9110 # type: textblock
9111 #. type: textblock
9112 #: ../src/guestfs-actions.pod:1268
9113 msgid ""
9114 "Note that there is no limit on the amount of data that can be downloaded "
9115 "with this call, unlike with C<guestfs_pread>, and this call always reads the "
9116 "full amount unless an error occurs."
9117 msgstr ""
9118
9119 # type: textblock
9120 #. type: textblock
9121 #: ../src/guestfs-actions.pod:1273
9122 msgid "See also C<guestfs_download>, C<guestfs_pread>."
9123 msgstr ""
9124
9125 # type: textblock
9126 #. type: textblock
9127 #: ../src/guestfs-actions.pod:1282 ../src/guestfs-actions.pod:6928
9128 msgid "(Added in 1.5.17)"
9129 msgstr ""
9130
9131 # type: =head2
9132 #. type: =head2
9133 #: ../src/guestfs-actions.pod:1284
9134 msgid "guestfs_drop_caches"
9135 msgstr ""
9136
9137 # type: verbatim
9138 #. type: verbatim
9139 #: ../src/guestfs-actions.pod:1286
9140 #, no-wrap
9141 msgid ""
9142 " int\n"
9143 " guestfs_drop_caches (guestfs_h *g,\n"
9144 "                      int whattodrop);\n"
9145 "\n"
9146 msgstr ""
9147
9148 # type: textblock
9149 #. type: textblock
9150 #: ../src/guestfs-actions.pod:1290 ../fish/guestfish-actions.pod:862
9151 msgid ""
9152 "This instructs the guest kernel to drop its page cache, and/or dentries and "
9153 "inode caches.  The parameter C<whattodrop> tells the kernel what precisely "
9154 "to drop, see L<http://linux-mm.org/Drop_Caches>"
9155 msgstr ""
9156
9157 # type: textblock
9158 #. type: textblock
9159 #: ../src/guestfs-actions.pod:1295 ../fish/guestfish-actions.pod:867
9160 msgid "Setting C<whattodrop> to 3 should drop everything."
9161 msgstr ""
9162
9163 # type: textblock
9164 #. type: textblock
9165 #: ../src/guestfs-actions.pod:1297 ../fish/guestfish-actions.pod:869
9166 msgid ""
9167 "This automatically calls L<sync(2)> before the operation, so that the "
9168 "maximum guest memory is freed."
9169 msgstr ""
9170
9171 # type: =head2
9172 #. type: =head2
9173 #: ../src/guestfs-actions.pod:1304
9174 msgid "guestfs_du"
9175 msgstr ""
9176
9177 # type: verbatim
9178 #. type: verbatim
9179 #: ../src/guestfs-actions.pod:1306
9180 #, no-wrap
9181 msgid ""
9182 " int64_t\n"
9183 " guestfs_du (guestfs_h *g,\n"
9184 "             const char *path);\n"
9185 "\n"
9186 msgstr ""
9187
9188 # type: textblock
9189 #. type: textblock
9190 #: ../src/guestfs-actions.pod:1310 ../fish/guestfish-actions.pod:876
9191 msgid ""
9192 "This command runs the C<du -s> command to estimate file space usage for "
9193 "C<path>."
9194 msgstr ""
9195
9196 # type: textblock
9197 #. type: textblock
9198 #: ../src/guestfs-actions.pod:1313 ../fish/guestfish-actions.pod:879
9199 msgid ""
9200 "C<path> can be a file or a directory.  If C<path> is a directory then the "
9201 "estimate includes the contents of the directory and all subdirectories "
9202 "(recursively)."
9203 msgstr ""
9204
9205 # type: textblock
9206 #. type: textblock
9207 #: ../src/guestfs-actions.pod:1317 ../fish/guestfish-actions.pod:883
9208 msgid ""
9209 "The result is the estimated size in I<kilobytes> (ie. units of 1024 bytes)."
9210 msgstr ""
9211
9212 # type: =head2
9213 #. type: =head2
9214 #: ../src/guestfs-actions.pod:1329
9215 msgid "guestfs_e2fsck_f"
9216 msgstr ""
9217
9218 # type: verbatim
9219 #. type: verbatim
9220 #: ../src/guestfs-actions.pod:1331
9221 #, no-wrap
9222 msgid ""
9223 " int\n"
9224 " guestfs_e2fsck_f (guestfs_h *g,\n"
9225 "                   const char *device);\n"
9226 "\n"
9227 msgstr ""
9228
9229 #. type: textblock
9230 #: ../src/guestfs-actions.pod:1335 ../fish/guestfish-actions.pod:890
9231 msgid ""
9232 "This runs C<e2fsck -p -f device>, ie. runs the ext2/ext3 filesystem checker "
9233 "on C<device>, noninteractively (I<-p>), even if the filesystem appears to be "
9234 "clean (I<-f>)."
9235 msgstr ""
9236
9237 # type: textblock
9238 #. type: textblock
9239 #: ../src/guestfs-actions.pod:1339
9240 msgid ""
9241 "This command is only needed because of C<guestfs_resize2fs> (q.v.).  "
9242 "Normally you should use C<guestfs_fsck>."
9243 msgstr ""
9244
9245 # type: textblock
9246 #. type: textblock
9247 #: ../src/guestfs-actions.pod:1344
9248 msgid "(Added in 1.0.29)"
9249 msgstr ""
9250
9251 # type: =head2
9252 #. type: =head2
9253 #: ../src/guestfs-actions.pod:1346
9254 msgid "guestfs_echo_daemon"
9255 msgstr ""
9256
9257 # type: verbatim
9258 #. type: verbatim
9259 #: ../src/guestfs-actions.pod:1348
9260 #, no-wrap
9261 msgid ""
9262 " char *\n"
9263 " guestfs_echo_daemon (guestfs_h *g,\n"
9264 "                      char *const *words);\n"
9265 "\n"
9266 msgstr ""
9267
9268 # type: textblock
9269 #. type: textblock
9270 #: ../src/guestfs-actions.pod:1352 ../fish/guestfish-actions.pod:901
9271 msgid ""
9272 "This command concatenates the list of C<words> passed with single spaces "
9273 "between them and returns the resulting string."
9274 msgstr ""
9275
9276 # type: textblock
9277 #. type: textblock
9278 #: ../src/guestfs-actions.pod:1355 ../fish/guestfish-actions.pod:904
9279 msgid "You can use this command to test the connection through to the daemon."
9280 msgstr ""
9281
9282 # type: textblock
9283 #. type: textblock
9284 #: ../src/guestfs-actions.pod:1357
9285 msgid "See also C<guestfs_ping_daemon>."
9286 msgstr ""
9287
9288 # type: textblock
9289 #. type: textblock
9290 #: ../src/guestfs-actions.pod:1362 ../src/guestfs-actions.pod:2096
9291 #: ../src/guestfs-actions.pod:6099
9292 msgid "(Added in 1.0.69)"
9293 msgstr ""
9294
9295 # type: =head2
9296 #. type: =head2
9297 #: ../src/guestfs-actions.pod:1364
9298 msgid "guestfs_egrep"
9299 msgstr ""
9300
9301 # type: verbatim
9302 #. type: verbatim
9303 #: ../src/guestfs-actions.pod:1366
9304 #, no-wrap
9305 msgid ""
9306 " char **\n"
9307 " guestfs_egrep (guestfs_h *g,\n"
9308 "                const char *regex,\n"
9309 "                const char *path);\n"
9310 "\n"
9311 msgstr ""
9312
9313 # type: textblock
9314 #. type: textblock
9315 #: ../src/guestfs-actions.pod:1371 ../fish/guestfish-actions.pod:912
9316 msgid ""
9317 "This calls the external C<egrep> program and returns the matching lines."
9318 msgstr ""
9319
9320 # type: textblock
9321 #. type: textblock
9322 #: ../src/guestfs-actions.pod:1381 ../src/guestfs-actions.pod:1400
9323 #: ../src/guestfs-actions.pod:1457 ../src/guestfs-actions.pod:1503
9324 #: ../src/guestfs-actions.pod:1522 ../src/guestfs-actions.pod:2226
9325 #: ../src/guestfs-actions.pod:2245 ../src/guestfs-actions.pod:2423
9326 #: ../src/guestfs-actions.pod:2436 ../src/guestfs-actions.pod:2451
9327 #: ../src/guestfs-actions.pod:2497 ../src/guestfs-actions.pod:2519
9328 #: ../src/guestfs-actions.pod:2532 ../src/guestfs-actions.pod:3680
9329 #: ../src/guestfs-actions.pod:3694 ../src/guestfs-actions.pod:3707
9330 #: ../src/guestfs-actions.pod:3721 ../src/guestfs-actions.pod:4707
9331 #: ../src/guestfs-actions.pod:5599 ../src/guestfs-actions.pod:5648
9332 #: ../src/guestfs-actions.pod:6495 ../src/guestfs-actions.pod:6507
9333 #: ../src/guestfs-actions.pod:6520 ../src/guestfs-actions.pod:6533
9334 #: ../src/guestfs-actions.pod:6555 ../src/guestfs-actions.pod:6568
9335 #: ../src/guestfs-actions.pod:6581 ../src/guestfs-actions.pod:6594
9336 #: ../src/guestfs-actions.pod:7372 ../src/guestfs-actions.pod:7391
9337 #: ../src/guestfs-actions.pod:7476 ../src/guestfs-actions.pod:7495
9338 #: ../src/guestfs-actions.pod:7541 ../src/guestfs-actions.pod:7560
9339 msgid "(Added in 1.0.66)"
9340 msgstr ""
9341
9342 # type: =head2
9343 #. type: =head2
9344 #: ../src/guestfs-actions.pod:1383
9345 msgid "guestfs_egrepi"
9346 msgstr ""
9347
9348 # type: verbatim
9349 #. type: verbatim
9350 #: ../src/guestfs-actions.pod:1385
9351 #, no-wrap
9352 msgid ""
9353 " char **\n"
9354 " guestfs_egrepi (guestfs_h *g,\n"
9355 "                 const char *regex,\n"
9356 "                 const char *path);\n"
9357 "\n"
9358 msgstr ""
9359
9360 # type: textblock
9361 #. type: textblock
9362 #: ../src/guestfs-actions.pod:1390 ../fish/guestfish-actions.pod:922
9363 msgid ""
9364 "This calls the external C<egrep -i> program and returns the matching lines."
9365 msgstr ""
9366
9367 # type: =head2
9368 #. type: =head2
9369 #: ../src/guestfs-actions.pod:1402
9370 msgid "guestfs_equal"
9371 msgstr ""
9372
9373 # type: verbatim
9374 #. type: verbatim
9375 #: ../src/guestfs-actions.pod:1404
9376 #, no-wrap
9377 msgid ""
9378 " int\n"
9379 " guestfs_equal (guestfs_h *g,\n"
9380 "                const char *file1,\n"
9381 "                const char *file2);\n"
9382 "\n"
9383 msgstr ""
9384
9385 # type: textblock
9386 #. type: textblock
9387 #: ../src/guestfs-actions.pod:1409 ../fish/guestfish-actions.pod:932
9388 msgid ""
9389 "This compares the two files C<file1> and C<file2> and returns true if their "
9390 "content is exactly equal, or false otherwise."
9391 msgstr ""
9392
9393 # type: textblock
9394 #. type: textblock
9395 #: ../src/guestfs-actions.pod:1412 ../fish/guestfish-actions.pod:935
9396 msgid "The external L<cmp(1)> program is used for the comparison."
9397 msgstr ""
9398
9399 # type: =head2
9400 #. type: =head2
9401 #: ../src/guestfs-actions.pod:1418
9402 msgid "guestfs_exists"
9403 msgstr ""
9404
9405 # type: verbatim
9406 #. type: verbatim
9407 #: ../src/guestfs-actions.pod:1420
9408 #, no-wrap
9409 msgid ""
9410 " int\n"
9411 " guestfs_exists (guestfs_h *g,\n"
9412 "                 const char *path);\n"
9413 "\n"
9414 msgstr ""
9415
9416 # type: textblock
9417 #. type: textblock
9418 #: ../src/guestfs-actions.pod:1424 ../fish/guestfish-actions.pod:941
9419 msgid ""
9420 "This returns C<true> if and only if there is a file, directory (or anything) "
9421 "with the given C<path> name."
9422 msgstr ""
9423
9424 # type: textblock
9425 #. type: textblock
9426 #: ../src/guestfs-actions.pod:1427
9427 msgid "See also C<guestfs_is_file>, C<guestfs_is_dir>, C<guestfs_stat>."
9428 msgstr ""
9429
9430 # type: =head2
9431 #. type: =head2
9432 #: ../src/guestfs-actions.pod:1433
9433 msgid "guestfs_fallocate"
9434 msgstr ""
9435
9436 # type: verbatim
9437 #. type: verbatim
9438 #: ../src/guestfs-actions.pod:1435
9439 #, no-wrap
9440 msgid ""
9441 " int\n"
9442 " guestfs_fallocate (guestfs_h *g,\n"
9443 "                    const char *path,\n"
9444 "                    int len);\n"
9445 "\n"
9446 msgstr ""
9447
9448 # type: textblock
9449 #. type: textblock
9450 #: ../src/guestfs-actions.pod:1440 ../src/guestfs-actions.pod:1466
9451 #: ../fish/guestfish-actions.pod:950 ../fish/guestfish-actions.pod:969
9452 msgid ""
9453 "This command preallocates a file (containing zero bytes) named C<path> of "
9454 "size C<len> bytes.  If the file exists already, it is overwritten."
9455 msgstr ""
9456
9457 # type: textblock
9458 #. type: textblock
9459 #: ../src/guestfs-actions.pod:1444 ../fish/guestfish-actions.pod:954
9460 msgid ""
9461 "Do not confuse this with the guestfish-specific C<alloc> command which "
9462 "allocates a file in the host and attaches it as a device."
9463 msgstr ""
9464
9465 #. type: textblock
9466 #: ../src/guestfs-actions.pod:1450
9467 msgid ""
9468 "This function is deprecated.  In new code, use the L</guestfs_fallocate64> "
9469 "call instead."
9470 msgstr ""
9471
9472 # type: =head2
9473 #. type: =head2
9474 #: ../src/guestfs-actions.pod:1459
9475 msgid "guestfs_fallocate64"
9476 msgstr ""
9477
9478 # type: verbatim
9479 #. type: verbatim
9480 #: ../src/guestfs-actions.pod:1461
9481 #, no-wrap
9482 msgid ""
9483 " int\n"
9484 " guestfs_fallocate64 (guestfs_h *g,\n"
9485 "                      const char *path,\n"
9486 "                      int64_t len);\n"
9487 "\n"
9488 msgstr ""
9489
9490 # type: textblock
9491 #. type: textblock
9492 #: ../src/guestfs-actions.pod:1470
9493 msgid ""
9494 "Note that this call allocates disk blocks for the file.  To create a sparse "
9495 "file use C<guestfs_truncate_size> instead."
9496 msgstr ""
9497
9498 # type: textblock
9499 #. type: textblock
9500 #: ../src/guestfs-actions.pod:1473
9501 msgid ""
9502 "The deprecated call C<guestfs_fallocate> does the same, but owing to an "
9503 "oversight it only allowed 30 bit lengths to be specified, effectively "
9504 "limiting the maximum size of files created through that call to 1GB."
9505 msgstr ""
9506
9507 # type: textblock
9508 #. type: textblock
9509 #: ../src/guestfs-actions.pod:1478 ../fish/guestfish-actions.pod:981
9510 msgid ""
9511 "Do not confuse this with the guestfish-specific C<alloc> and C<sparse> "
9512 "commands which create a file in the host and attach it as a device."
9513 msgstr ""
9514
9515 # type: textblock
9516 #. type: textblock
9517 #: ../src/guestfs-actions.pod:1484
9518 msgid "(Added in 1.3.17)"
9519 msgstr ""
9520
9521 # type: =head2
9522 #. type: =head2
9523 #: ../src/guestfs-actions.pod:1486
9524 msgid "guestfs_fgrep"
9525 msgstr ""
9526
9527 # type: verbatim
9528 #. type: verbatim
9529 #: ../src/guestfs-actions.pod:1488
9530 #, no-wrap
9531 msgid ""
9532 " char **\n"
9533 " guestfs_fgrep (guestfs_h *g,\n"
9534 "                const char *pattern,\n"
9535 "                const char *path);\n"
9536 "\n"
9537 msgstr ""
9538
9539 # type: textblock
9540 #. type: textblock
9541 #: ../src/guestfs-actions.pod:1493 ../fish/guestfish-actions.pod:989
9542 msgid ""
9543 "This calls the external C<fgrep> program and returns the matching lines."
9544 msgstr ""
9545
9546 # type: =head2
9547 #. type: =head2
9548 #: ../src/guestfs-actions.pod:1505
9549 msgid "guestfs_fgrepi"
9550 msgstr ""
9551
9552 # type: verbatim
9553 #. type: verbatim
9554 #: ../src/guestfs-actions.pod:1507
9555 #, no-wrap
9556 msgid ""
9557 " char **\n"
9558 " guestfs_fgrepi (guestfs_h *g,\n"
9559 "                 const char *pattern,\n"
9560 "                 const char *path);\n"
9561 "\n"
9562 msgstr ""
9563
9564 # type: textblock
9565 #. type: textblock
9566 #: ../src/guestfs-actions.pod:1512 ../fish/guestfish-actions.pod:999
9567 msgid ""
9568 "This calls the external C<fgrep -i> program and returns the matching lines."
9569 msgstr ""
9570
9571 # type: =head2
9572 #. type: =head2
9573 #: ../src/guestfs-actions.pod:1524
9574 msgid "guestfs_file"
9575 msgstr ""
9576
9577 # type: verbatim
9578 #. type: verbatim
9579 #: ../src/guestfs-actions.pod:1526
9580 #, no-wrap
9581 msgid ""
9582 " char *\n"
9583 " guestfs_file (guestfs_h *g,\n"
9584 "               const char *path);\n"
9585 "\n"
9586 msgstr ""
9587
9588 # type: textblock
9589 #. type: textblock
9590 #: ../src/guestfs-actions.pod:1530 ../fish/guestfish-actions.pod:1009
9591 msgid ""
9592 "This call uses the standard L<file(1)> command to determine the type or "
9593 "contents of the file."
9594 msgstr ""
9595
9596 # type: textblock
9597 #. type: textblock
9598 #: ../src/guestfs-actions.pod:1533 ../fish/guestfish-actions.pod:1012
9599 msgid ""
9600 "This call will also transparently look inside various types of compressed "
9601 "file."
9602 msgstr ""
9603
9604 #. type: textblock
9605 #: ../src/guestfs-actions.pod:1536 ../fish/guestfish-actions.pod:1015
9606 msgid ""
9607 "The exact command which runs is C<file -zb path>.  Note in particular that "
9608 "the filename is not prepended to the output (the I<-b> option)."
9609 msgstr ""
9610
9611 #. type: textblock
9612 #: ../src/guestfs-actions.pod:1540 ../fish/guestfish-actions.pod:1019
9613 msgid ""
9614 "The output depends on the output of the underlying L<file(1)> command and it "
9615 "can change in future in ways beyond our control.  In other words, the output "
9616 "is not guaranteed by the ABI."
9617 msgstr ""
9618
9619 #. type: textblock
9620 #: ../src/guestfs-actions.pod:1544
9621 msgid ""
9622 "See also: L<file(1)>, C<guestfs_vfs_type>, C<guestfs_lstat>, "
9623 "C<guestfs_is_file>, C<guestfs_is_blockdev> (etc)."
9624 msgstr ""
9625
9626 # type: =head2
9627 #. type: =head2
9628 #: ../src/guestfs-actions.pod:1552
9629 msgid "guestfs_file_architecture"
9630 msgstr ""
9631
9632 # type: verbatim
9633 #. type: verbatim
9634 #: ../src/guestfs-actions.pod:1554
9635 #, no-wrap
9636 msgid ""
9637 " char *\n"
9638 " guestfs_file_architecture (guestfs_h *g,\n"
9639 "                            const char *filename);\n"
9640 "\n"
9641 msgstr ""
9642
9643 # type: textblock
9644 #. type: textblock
9645 #: ../src/guestfs-actions.pod:1558 ../fish/guestfish-actions.pod:1030
9646 msgid ""
9647 "This detects the architecture of the binary C<filename>, and returns it if "
9648 "known."
9649 msgstr ""
9650
9651 # type: textblock
9652 #. type: textblock
9653 #: ../src/guestfs-actions.pod:1561 ../fish/guestfish-actions.pod:1033
9654 msgid "Currently defined architectures are:"
9655 msgstr ""
9656
9657 # type: =item
9658 #. type: =item
9659 #: ../src/guestfs-actions.pod:1565 ../fish/guestfish-actions.pod:1037
9660 msgid "\"i386\""
9661 msgstr ""
9662
9663 # type: textblock
9664 #. type: textblock
9665 #: ../src/guestfs-actions.pod:1567 ../fish/guestfish-actions.pod:1039
9666 msgid ""
9667 "This string is returned for all 32 bit i386, i486, i586, i686 binaries "
9668 "irrespective of the precise processor requirements of the binary."
9669 msgstr ""
9670
9671 # type: =item
9672 #. type: =item
9673 #: ../src/guestfs-actions.pod:1570 ../fish/guestfish-actions.pod:1042
9674 msgid "\"x86_64\""
9675 msgstr ""
9676
9677 # type: textblock
9678 #. type: textblock
9679 #: ../src/guestfs-actions.pod:1572 ../fish/guestfish-actions.pod:1044
9680 msgid "64 bit x86-64."
9681 msgstr ""
9682
9683 # type: =item
9684 #. type: =item
9685 #: ../src/guestfs-actions.pod:1574 ../fish/guestfish-actions.pod:1046
9686 msgid "\"sparc\""
9687 msgstr ""
9688
9689 # type: textblock
9690 #. type: textblock
9691 #: ../src/guestfs-actions.pod:1576 ../fish/guestfish-actions.pod:1048
9692 msgid "32 bit SPARC."
9693 msgstr ""
9694
9695 # type: =item
9696 #. type: =item
9697 #: ../src/guestfs-actions.pod:1578 ../fish/guestfish-actions.pod:1050
9698 msgid "\"sparc64\""
9699 msgstr ""
9700
9701 # type: textblock
9702 #. type: textblock
9703 #: ../src/guestfs-actions.pod:1580 ../fish/guestfish-actions.pod:1052
9704 msgid "64 bit SPARC V9 and above."
9705 msgstr ""
9706
9707 # type: =item
9708 #. type: =item
9709 #: ../src/guestfs-actions.pod:1582 ../fish/guestfish-actions.pod:1054
9710 msgid "\"ia64\""
9711 msgstr ""
9712
9713 # type: textblock
9714 #. type: textblock
9715 #: ../src/guestfs-actions.pod:1584 ../fish/guestfish-actions.pod:1056
9716 msgid "Intel Itanium."
9717 msgstr ""
9718
9719 # type: =item
9720 #. type: =item
9721 #: ../src/guestfs-actions.pod:1586 ../fish/guestfish-actions.pod:1058
9722 msgid "\"ppc\""
9723 msgstr ""
9724
9725 # type: textblock
9726 #. type: textblock
9727 #: ../src/guestfs-actions.pod:1588 ../fish/guestfish-actions.pod:1060
9728 msgid "32 bit Power PC."
9729 msgstr ""
9730
9731 # type: =item
9732 #. type: =item
9733 #: ../src/guestfs-actions.pod:1590 ../fish/guestfish-actions.pod:1062
9734 msgid "\"ppc64\""
9735 msgstr ""
9736
9737 # type: textblock
9738 #. type: textblock
9739 #: ../src/guestfs-actions.pod:1592 ../fish/guestfish-actions.pod:1064
9740 msgid "64 bit Power PC."
9741 msgstr ""
9742
9743 # type: textblock
9744 #. type: textblock
9745 #: ../src/guestfs-actions.pod:1596 ../fish/guestfish-actions.pod:1068
9746 msgid "Libguestfs may return other architecture strings in future."
9747 msgstr ""
9748
9749 # type: textblock
9750 #. type: textblock
9751 #: ../src/guestfs-actions.pod:1598 ../fish/guestfish-actions.pod:1070
9752 msgid "The function works on at least the following types of files:"
9753 msgstr ""
9754
9755 # type: textblock
9756 #. type: textblock
9757 #: ../src/guestfs-actions.pod:1604 ../fish/guestfish-actions.pod:1076
9758 msgid "many types of Un*x and Linux binary"
9759 msgstr ""
9760
9761 # type: textblock
9762 #. type: textblock
9763 #: ../src/guestfs-actions.pod:1608 ../fish/guestfish-actions.pod:1080
9764 msgid "many types of Un*x and Linux shared library"
9765 msgstr ""
9766
9767 # type: textblock
9768 #. type: textblock
9769 #: ../src/guestfs-actions.pod:1612 ../fish/guestfish-actions.pod:1084
9770 msgid "Windows Win32 and Win64 binaries"
9771 msgstr ""
9772
9773 # type: textblock
9774 #. type: textblock
9775 #: ../src/guestfs-actions.pod:1616 ../fish/guestfish-actions.pod:1088
9776 msgid "Windows Win32 and Win64 DLLs"
9777 msgstr ""
9778
9779 # type: textblock
9780 #. type: textblock
9781 #: ../src/guestfs-actions.pod:1618 ../fish/guestfish-actions.pod:1090
9782 msgid "Win32 binaries and DLLs return C<i386>."
9783 msgstr ""
9784
9785 # type: textblock
9786 #. type: textblock
9787 #: ../src/guestfs-actions.pod:1620 ../fish/guestfish-actions.pod:1092
9788 msgid "Win64 binaries and DLLs return C<x86_64>."
9789 msgstr ""
9790
9791 # type: textblock
9792 #. type: textblock
9793 #: ../src/guestfs-actions.pod:1624 ../fish/guestfish-actions.pod:1096
9794 msgid "Linux kernel modules"
9795 msgstr ""
9796
9797 # type: textblock
9798 #. type: textblock
9799 #: ../src/guestfs-actions.pod:1628 ../fish/guestfish-actions.pod:1100
9800 msgid "Linux new-style initrd images"
9801 msgstr ""
9802
9803 # type: textblock
9804 #. type: textblock
9805 #: ../src/guestfs-actions.pod:1632 ../fish/guestfish-actions.pod:1104
9806 msgid "some non-x86 Linux vmlinuz kernels"
9807 msgstr ""
9808
9809 # type: textblock
9810 #. type: textblock
9811 #: ../src/guestfs-actions.pod:1636 ../fish/guestfish-actions.pod:1108
9812 msgid "What it can't do currently:"
9813 msgstr ""
9814
9815 # type: textblock
9816 #. type: textblock
9817 #: ../src/guestfs-actions.pod:1642 ../fish/guestfish-actions.pod:1114
9818 msgid "static libraries (libfoo.a)"
9819 msgstr ""
9820
9821 # type: textblock
9822 #. type: textblock
9823 #: ../src/guestfs-actions.pod:1646 ../fish/guestfish-actions.pod:1118
9824 msgid "Linux old-style initrd as compressed ext2 filesystem (RHEL 3)"
9825 msgstr ""
9826
9827 # type: textblock
9828 #. type: textblock
9829 #: ../src/guestfs-actions.pod:1650 ../fish/guestfish-actions.pod:1122
9830 msgid "x86 Linux vmlinuz kernels"
9831 msgstr ""
9832
9833 # type: textblock
9834 #. type: textblock
9835 #: ../src/guestfs-actions.pod:1652 ../fish/guestfish-actions.pod:1124
9836 msgid ""
9837 "x86 vmlinuz images (bzImage format) consist of a mix of 16-, 32- and "
9838 "compressed code, and are horribly hard to unpack.  If you want to find the "
9839 "architecture of a kernel, use the architecture of the associated initrd or "
9840 "kernel module(s) instead."
9841 msgstr ""
9842
9843 # type: textblock
9844 #. type: textblock
9845 #: ../src/guestfs-actions.pod:1662 ../src/guestfs-actions.pod:1825
9846 #: ../src/guestfs-actions.pod:1842 ../src/guestfs-actions.pod:2555
9847 #: ../src/guestfs-actions.pod:2648 ../src/guestfs-actions.pod:2718
9848 #: ../src/guestfs-actions.pod:2806 ../src/guestfs-actions.pod:2827
9849 #: ../src/guestfs-actions.pod:2870 ../src/guestfs-actions.pod:2954
9850 #: ../src/guestfs-actions.pod:3051 ../src/guestfs-actions.pod:3298
9851 #: ../src/guestfs-actions.pod:3430
9852 msgid "(Added in 1.5.3)"
9853 msgstr ""
9854
9855 # type: =head2
9856 #. type: =head2
9857 #: ../src/guestfs-actions.pod:1664
9858 msgid "guestfs_filesize"
9859 msgstr ""
9860
9861 # type: verbatim
9862 #. type: verbatim
9863 #: ../src/guestfs-actions.pod:1666
9864 #, no-wrap
9865 msgid ""
9866 " int64_t\n"
9867 " guestfs_filesize (guestfs_h *g,\n"
9868 "                   const char *file);\n"
9869 "\n"
9870 msgstr ""
9871
9872 # type: textblock
9873 #. type: textblock
9874 #: ../src/guestfs-actions.pod:1670 ../fish/guestfish-actions.pod:1135
9875 msgid "This command returns the size of C<file> in bytes."
9876 msgstr ""
9877
9878 # type: textblock
9879 #. type: textblock
9880 #: ../src/guestfs-actions.pod:1672
9881 msgid ""
9882 "To get other stats about a file, use C<guestfs_stat>, C<guestfs_lstat>, "
9883 "C<guestfs_is_dir>, C<guestfs_is_file> etc.  To get the size of block "
9884 "devices, use C<guestfs_blockdev_getsize64>."
9885 msgstr ""
9886
9887 # type: textblock
9888 #. type: textblock
9889 #: ../src/guestfs-actions.pod:1678
9890 msgid "(Added in 1.0.82)"
9891 msgstr ""
9892
9893 # type: =head2
9894 #. type: =head2
9895 #: ../src/guestfs-actions.pod:1680
9896 msgid "guestfs_fill"
9897 msgstr ""
9898
9899 # type: verbatim
9900 #. type: verbatim
9901 #: ../src/guestfs-actions.pod:1682
9902 #, no-wrap
9903 msgid ""
9904 " int\n"
9905 " guestfs_fill (guestfs_h *g,\n"
9906 "               int c,\n"
9907 "               int len,\n"
9908 "               const char *path);\n"
9909 "\n"
9910 msgstr ""
9911
9912 # type: textblock
9913 #. type: textblock
9914 #: ../src/guestfs-actions.pod:1688 ../fish/guestfish-actions.pod:1145
9915 msgid ""
9916 "This command creates a new file called C<path>.  The initial content of the "
9917 "file is C<len> octets of C<c>, where C<c> must be a number in the range C<"
9918 "[0..255]>."
9919 msgstr ""
9920
9921 # type: textblock
9922 #. type: textblock
9923 #: ../src/guestfs-actions.pod:1692
9924 msgid ""
9925 "To fill a file with zero bytes (sparsely), it is much more efficient to use "
9926 "C<guestfs_truncate_size>.  To create a file with a pattern of repeating "
9927 "bytes use C<guestfs_fill_pattern>."
9928 msgstr ""
9929
9930 # type: textblock
9931 #. type: textblock
9932 #: ../src/guestfs-actions.pod:1704
9933 msgid "(Added in 1.0.79)"
9934 msgstr ""
9935
9936 # type: =head2
9937 #. type: =head2
9938 #: ../src/guestfs-actions.pod:1706
9939 msgid "guestfs_fill_pattern"
9940 msgstr ""
9941
9942 # type: verbatim
9943 #. type: verbatim
9944 #: ../src/guestfs-actions.pod:1708
9945 #, no-wrap
9946 msgid ""
9947 " int\n"
9948 " guestfs_fill_pattern (guestfs_h *g,\n"
9949 "                       const char *pattern,\n"
9950 "                       int len,\n"
9951 "                       const char *path);\n"
9952 "\n"
9953 msgstr ""
9954
9955 # type: textblock
9956 #. type: textblock
9957 #: ../src/guestfs-actions.pod:1714
9958 msgid ""
9959 "This function is like C<guestfs_fill> except that it creates a new file of "
9960 "length C<len> containing the repeating pattern of bytes in C<pattern>.  The "
9961 "pattern is truncated if necessary to ensure the length of the file is "
9962 "exactly C<len> bytes."
9963 msgstr ""
9964
9965 # type: textblock
9966 #. type: textblock
9967 #: ../src/guestfs-actions.pod:1726
9968 msgid "(Added in 1.3.12)"
9969 msgstr ""
9970
9971 # type: =head2
9972 #. type: =head2
9973 #: ../src/guestfs-actions.pod:1728
9974 msgid "guestfs_find"
9975 msgstr ""
9976
9977 # type: verbatim
9978 #. type: verbatim
9979 #: ../src/guestfs-actions.pod:1730
9980 #, no-wrap
9981 msgid ""
9982 " char **\n"
9983 " guestfs_find (guestfs_h *g,\n"
9984 "               const char *directory);\n"
9985 "\n"
9986 msgstr ""
9987
9988 # type: textblock
9989 #. type: textblock
9990 #: ../src/guestfs-actions.pod:1734 ../fish/guestfish-actions.pod:1167
9991 msgid ""
9992 "This command lists out all files and directories, recursively, starting at "
9993 "C<directory>.  It is essentially equivalent to running the shell command "
9994 "C<find directory -print> but some post-processing happens on the output, "
9995 "described below."
9996 msgstr ""
9997
9998 # type: textblock
9999 #. type: textblock
10000 #: ../src/guestfs-actions.pod:1739 ../fish/guestfish-actions.pod:1172
10001 msgid ""
10002 "This returns a list of strings I<without any prefix>.  Thus if the directory "
10003 "structure was:"
10004 msgstr ""
10005
10006 # type: verbatim
10007 #. type: verbatim
10008 #: ../src/guestfs-actions.pod:1742 ../fish/guestfish-actions.pod:1175
10009 #, no-wrap
10010 msgid ""
10011 " /tmp/a\n"
10012 " /tmp/b\n"
10013 " /tmp/c/d\n"
10014 "\n"
10015 msgstr ""
10016
10017 # type: textblock
10018 #. type: textblock
10019 #: ../src/guestfs-actions.pod:1746
10020 msgid ""
10021 "then the returned list from C<guestfs_find> C</tmp> would be 4 elements:"
10022 msgstr ""
10023
10024 # type: verbatim
10025 #. type: verbatim
10026 #: ../src/guestfs-actions.pod:1749 ../fish/guestfish-actions.pod:1182
10027 #, no-wrap
10028 msgid ""
10029 " a\n"
10030 " b\n"
10031 " c\n"
10032 " c/d\n"
10033 "\n"
10034 msgstr ""
10035
10036 # type: textblock
10037 #. type: textblock
10038 #: ../src/guestfs-actions.pod:1754 ../fish/guestfish-actions.pod:1187
10039 msgid "If C<directory> is not a directory, then this command returns an error."
10040 msgstr ""
10041
10042 # type: textblock
10043 #. type: textblock
10044 #: ../src/guestfs-actions.pod:1757 ../fish/guestfish-actions.pod:1190
10045 msgid "The returned list is sorted."
10046 msgstr ""
10047
10048 # type: textblock
10049 #. type: textblock
10050 #: ../src/guestfs-actions.pod:1759
10051 msgid "See also C<guestfs_find0>."
10052 msgstr ""
10053
10054 # type: textblock
10055 #. type: textblock
10056 #: ../src/guestfs-actions.pod:1768 ../src/guestfs-actions.pod:4124
10057 #: ../src/guestfs-actions.pod:5683
10058 msgid "(Added in 1.0.27)"
10059 msgstr ""
10060
10061 # type: =head2
10062 #. type: =head2
10063 #: ../src/guestfs-actions.pod:1770
10064 msgid "guestfs_find0"
10065 msgstr ""
10066
10067 # type: verbatim
10068 #. type: verbatim
10069 #: ../src/guestfs-actions.pod:1772
10070 #, no-wrap
10071 msgid ""
10072 " int\n"
10073 " guestfs_find0 (guestfs_h *g,\n"
10074 "                const char *directory,\n"
10075 "                const char *files);\n"
10076 "\n"
10077 msgstr ""
10078
10079 # type: textblock
10080 #. type: textblock
10081 #: ../src/guestfs-actions.pod:1777 ../fish/guestfish-actions.pod:1201
10082 msgid ""
10083 "This command lists out all files and directories, recursively, starting at "
10084 "C<directory>, placing the resulting list in the external file called "
10085 "C<files>."
10086 msgstr ""
10087
10088 # type: textblock
10089 #. type: textblock
10090 #: ../src/guestfs-actions.pod:1781
10091 msgid ""
10092 "This command works the same way as C<guestfs_find> with the following "
10093 "exceptions:"
10094 msgstr ""
10095
10096 # type: textblock
10097 #. type: textblock
10098 #: ../src/guestfs-actions.pod:1788 ../fish/guestfish-actions.pod:1212
10099 msgid "The resulting list is written to an external file."
10100 msgstr ""
10101
10102 # type: textblock
10103 #. type: textblock
10104 #: ../src/guestfs-actions.pod:1792 ../fish/guestfish-actions.pod:1216
10105 msgid ""
10106 "Items (filenames) in the result are separated by C<\\0> characters.  See "
10107 "L<find(1)> option I<-print0>."
10108 msgstr ""
10109
10110 # type: textblock
10111 #. type: textblock
10112 #: ../src/guestfs-actions.pod:1797 ../fish/guestfish-actions.pod:1221
10113 msgid "This command is not limited in the number of names that it can return."
10114 msgstr ""
10115
10116 # type: textblock
10117 #. type: textblock
10118 #: ../src/guestfs-actions.pod:1802 ../fish/guestfish-actions.pod:1226
10119 msgid "The result list is not sorted."
10120 msgstr ""
10121
10122 # type: textblock
10123 #. type: textblock
10124 #: ../src/guestfs-actions.pod:1808
10125 msgid "(Added in 1.0.74)"
10126 msgstr ""
10127
10128 # type: =head2
10129 #. type: =head2
10130 #: ../src/guestfs-actions.pod:1810
10131 msgid "guestfs_findfs_label"
10132 msgstr ""
10133
10134 # type: verbatim
10135 #. type: verbatim
10136 #: ../src/guestfs-actions.pod:1812
10137 #, no-wrap
10138 msgid ""
10139 " char *\n"
10140 " guestfs_findfs_label (guestfs_h *g,\n"
10141 "                       const char *label);\n"
10142 "\n"
10143 msgstr ""
10144
10145 # type: textblock
10146 #. type: textblock
10147 #: ../src/guestfs-actions.pod:1816 ../fish/guestfish-actions.pod:1236
10148 msgid ""
10149 "This command searches the filesystems and returns the one which has the "
10150 "given label.  An error is returned if no such filesystem can be found."
10151 msgstr ""
10152
10153 # type: textblock
10154 #. type: textblock
10155 #: ../src/guestfs-actions.pod:1820
10156 msgid "To find the label of a filesystem, use C<guestfs_vfs_label>."
10157 msgstr ""
10158
10159 # type: =head2
10160 #. type: =head2
10161 #: ../src/guestfs-actions.pod:1827
10162 msgid "guestfs_findfs_uuid"
10163 msgstr ""
10164
10165 # type: verbatim
10166 #. type: verbatim
10167 #: ../src/guestfs-actions.pod:1829
10168 #, no-wrap
10169 msgid ""
10170 " char *\n"
10171 " guestfs_findfs_uuid (guestfs_h *g,\n"
10172 "                      const char *uuid);\n"
10173 "\n"
10174 msgstr ""
10175
10176 # type: textblock
10177 #. type: textblock
10178 #: ../src/guestfs-actions.pod:1833 ../fish/guestfish-actions.pod:1246
10179 msgid ""
10180 "This command searches the filesystems and returns the one which has the "
10181 "given UUID.  An error is returned if no such filesystem can be found."
10182 msgstr ""
10183
10184 # type: textblock
10185 #. type: textblock
10186 #: ../src/guestfs-actions.pod:1837
10187 msgid "To find the UUID of a filesystem, use C<guestfs_vfs_uuid>."
10188 msgstr ""
10189
10190 # type: =head2
10191 #. type: =head2
10192 #: ../src/guestfs-actions.pod:1844
10193 msgid "guestfs_fsck"
10194 msgstr ""
10195
10196 # type: verbatim
10197 #. type: verbatim
10198 #: ../src/guestfs-actions.pod:1846
10199 #, no-wrap
10200 msgid ""
10201 " int\n"
10202 " guestfs_fsck (guestfs_h *g,\n"
10203 "               const char *fstype,\n"
10204 "               const char *device);\n"
10205 "\n"
10206 msgstr ""
10207
10208 # type: textblock
10209 #. type: textblock
10210 #: ../src/guestfs-actions.pod:1851 ../fish/guestfish-actions.pod:1256
10211 msgid ""
10212 "This runs the filesystem checker (fsck) on C<device> which should have "
10213 "filesystem type C<fstype>."
10214 msgstr ""
10215
10216 # type: textblock
10217 #. type: textblock
10218 #: ../src/guestfs-actions.pod:1854 ../fish/guestfish-actions.pod:1259
10219 msgid ""
10220 "The returned integer is the status.  See L<fsck(8)> for the list of status "
10221 "codes from C<fsck>."
10222 msgstr ""
10223
10224 # type: textblock
10225 #. type: textblock
10226 #: ../src/guestfs-actions.pod:1863 ../fish/guestfish-actions.pod:1268
10227 msgid "Multiple status codes can be summed together."
10228 msgstr ""
10229
10230 # type: textblock
10231 #. type: textblock
10232 #: ../src/guestfs-actions.pod:1867 ../fish/guestfish-actions.pod:1272
10233 msgid ""
10234 "A non-zero return code can mean \"success\", for example if errors have been "
10235 "corrected on the filesystem."
10236 msgstr ""
10237
10238 # type: textblock
10239 #. type: textblock
10240 #: ../src/guestfs-actions.pod:1872 ../fish/guestfish-actions.pod:1277
10241 msgid "Checking or repairing NTFS volumes is not supported (by linux-ntfs)."
10242 msgstr ""
10243
10244 # type: textblock
10245 #. type: textblock
10246 #: ../src/guestfs-actions.pod:1877 ../fish/guestfish-actions.pod:1282
10247 msgid ""
10248 "This command is entirely equivalent to running C<fsck -a -t fstype device>."
10249 msgstr ""
10250
10251 # type: textblock
10252 #. type: textblock
10253 #: ../src/guestfs-actions.pod:1881 ../src/guestfs-actions.pod:7414
10254 msgid "(Added in 1.0.16)"
10255 msgstr ""
10256
10257 # type: =head2
10258 #. type: =head2
10259 #: ../src/guestfs-actions.pod:1883
10260 msgid "guestfs_get_append"
10261 msgstr ""
10262
10263 # type: verbatim
10264 #. type: verbatim
10265 #: ../src/guestfs-actions.pod:1885
10266 #, no-wrap
10267 msgid ""
10268 " const char *\n"
10269 " guestfs_get_append (guestfs_h *g);\n"
10270 "\n"
10271 msgstr ""
10272
10273 # type: textblock
10274 #. type: textblock
10275 #: ../src/guestfs-actions.pod:1888 ../fish/guestfish-actions.pod:1288
10276 msgid ""
10277 "Return the additional kernel options which are added to the guest kernel "
10278 "command line."
10279 msgstr ""
10280
10281 # type: textblock
10282 #. type: textblock
10283 #: ../src/guestfs-actions.pod:1891 ../fish/guestfish-actions.pod:1291
10284 msgid "If C<NULL> then no options are added."
10285 msgstr ""
10286
10287 # type: textblock
10288 #. type: textblock
10289 #: ../src/guestfs-actions.pod:1893
10290 msgid ""
10291 "This function returns a string which may be NULL.  There is no way to return "
10292 "an error from this function.  The string is owned by the guest handle and "
10293 "must I<not> be freed."
10294 msgstr ""
10295
10296 # type: textblock
10297 #. type: textblock
10298 #: ../src/guestfs-actions.pod:1897 ../src/guestfs-actions.pod:5361
10299 #: ../src/guestfs-actions.pod:5841 ../src/guestfs-actions.pod:6262
10300 #: ../src/guestfs-actions.pod:6281 ../src/guestfs-actions.pod:6297
10301 #: ../src/guestfs-actions.pod:6321 ../src/guestfs-actions.pod:7078
10302 #: ../src/guestfs-actions.pod:7096 ../src/guestfs-actions.pod:7457
10303 msgid "(Added in 1.0.26)"
10304 msgstr ""
10305
10306 #. type: =head2
10307 #: ../src/guestfs-actions.pod:1899
10308 msgid "guestfs_get_attach_method"
10309 msgstr ""
10310
10311 #. type: verbatim
10312 #: ../src/guestfs-actions.pod:1901
10313 #, no-wrap
10314 msgid ""
10315 " char *\n"
10316 " guestfs_get_attach_method (guestfs_h *g);\n"
10317 "\n"
10318 msgstr ""
10319
10320 #. type: textblock
10321 #: ../src/guestfs-actions.pod:1904
10322 msgid "Return the current attach method.  See C<guestfs_set_attach_method>."
10323 msgstr ""
10324
10325 # type: =head2
10326 #. type: =head2
10327 #: ../src/guestfs-actions.pod:1909
10328 msgid "guestfs_get_autosync"
10329 msgstr ""
10330
10331 # type: verbatim
10332 #. type: verbatim
10333 #: ../src/guestfs-actions.pod:1911
10334 #, no-wrap
10335 msgid ""
10336 " int\n"
10337 " guestfs_get_autosync (guestfs_h *g);\n"
10338 "\n"
10339 msgstr ""
10340
10341 # type: textblock
10342 #. type: textblock
10343 #: ../src/guestfs-actions.pod:1914 ../fish/guestfish-actions.pod:1303
10344 msgid "Get the autosync flag."
10345 msgstr ""
10346
10347 # type: =head2
10348 #. type: =head2
10349 #: ../src/guestfs-actions.pod:1920
10350 msgid "guestfs_get_direct"
10351 msgstr ""
10352
10353 # type: verbatim
10354 #. type: verbatim
10355 #: ../src/guestfs-actions.pod:1922
10356 #, no-wrap
10357 msgid ""
10358 " int\n"
10359 " guestfs_get_direct (guestfs_h *g);\n"
10360 "\n"
10361 msgstr ""
10362
10363 # type: textblock
10364 #. type: textblock
10365 #: ../src/guestfs-actions.pod:1925 ../fish/guestfish-actions.pod:1309
10366 msgid "Return the direct appliance mode flag."
10367 msgstr ""
10368
10369 # type: textblock
10370 #. type: textblock
10371 #: ../src/guestfs-actions.pod:1929 ../src/guestfs-actions.pod:5910
10372 msgid "(Added in 1.0.72)"
10373 msgstr ""
10374
10375 # type: =head2
10376 #. type: =head2
10377 #: ../src/guestfs-actions.pod:1931
10378 msgid "guestfs_get_e2label"
10379 msgstr ""
10380
10381 # type: verbatim
10382 #. type: verbatim
10383 #: ../src/guestfs-actions.pod:1933
10384 #, no-wrap
10385 msgid ""
10386 " char *\n"
10387 " guestfs_get_e2label (guestfs_h *g,\n"
10388 "                      const char *device);\n"
10389 "\n"
10390 msgstr ""
10391
10392 # type: textblock
10393 #. type: textblock
10394 #: ../src/guestfs-actions.pod:1937 ../fish/guestfish-actions.pod:1315
10395 msgid ""
10396 "This returns the ext2/3/4 filesystem label of the filesystem on C<device>."
10397 msgstr ""
10398
10399 #. type: textblock
10400 #: ../src/guestfs-actions.pod:1943
10401 msgid ""
10402 "This function is deprecated.  In new code, use the L</guestfs_vfs_label> "
10403 "call instead."
10404 msgstr ""
10405
10406 # type: textblock
10407 #. type: textblock
10408 #: ../src/guestfs-actions.pod:1950 ../src/guestfs-actions.pod:1971
10409 #: ../src/guestfs-actions.pod:5928 ../src/guestfs-actions.pod:5947
10410 msgid "(Added in 1.0.15)"
10411 msgstr ""
10412
10413 # type: =head2
10414 #. type: =head2
10415 #: ../src/guestfs-actions.pod:1952
10416 msgid "guestfs_get_e2uuid"
10417 msgstr ""
10418
10419 # type: verbatim
10420 #. type: verbatim
10421 #: ../src/guestfs-actions.pod:1954
10422 #, no-wrap
10423 msgid ""
10424 " char *\n"
10425 " guestfs_get_e2uuid (guestfs_h *g,\n"
10426 "                     const char *device);\n"
10427 "\n"
10428 msgstr ""
10429
10430 # type: textblock
10431 #. type: textblock
10432 #: ../src/guestfs-actions.pod:1958 ../fish/guestfish-actions.pod:1329
10433 msgid ""
10434 "This returns the ext2/3/4 filesystem UUID of the filesystem on C<device>."
10435 msgstr ""
10436
10437 #. type: textblock
10438 #: ../src/guestfs-actions.pod:1964
10439 msgid ""
10440 "This function is deprecated.  In new code, use the L</guestfs_vfs_uuid> call "
10441 "instead."
10442 msgstr ""
10443
10444 # type: =head2
10445 #. type: =head2
10446 #: ../src/guestfs-actions.pod:1973
10447 msgid "guestfs_get_memsize"
10448 msgstr ""
10449
10450 # type: verbatim
10451 #. type: verbatim
10452 #: ../src/guestfs-actions.pod:1975
10453 #, no-wrap
10454 msgid ""
10455 " int\n"
10456 " guestfs_get_memsize (guestfs_h *g);\n"
10457 "\n"
10458 msgstr ""
10459
10460 # type: textblock
10461 #. type: textblock
10462 #: ../src/guestfs-actions.pod:1978 ../fish/guestfish-actions.pod:1343
10463 msgid ""
10464 "This gets the memory size in megabytes allocated to the qemu subprocess."
10465 msgstr ""
10466
10467 # type: textblock
10468 #. type: textblock
10469 #: ../src/guestfs-actions.pod:1981
10470 msgid ""
10471 "If C<guestfs_set_memsize> was not called on this handle, and if "
10472 "C<LIBGUESTFS_MEMSIZE> was not set, then this returns the compiled-in default "
10473 "value for memsize."
10474 msgstr ""
10475
10476 # type: textblock
10477 #. type: textblock
10478 #: ../src/guestfs-actions.pod:1985 ../src/guestfs-actions.pod:2066
10479 #: ../src/guestfs-actions.pod:5963 ../src/guestfs-actions.pod:6070
10480 #: ../fish/guestfish-actions.pod:1350 ../fish/guestfish-actions.pod:1401
10481 #: ../fish/guestfish-actions.pod:4033 ../fish/guestfish-actions.pod:4120
10482 msgid ""
10483 "For more information on the architecture of libguestfs, see L<guestfs(3)>."
10484 msgstr ""
10485
10486 # type: textblock
10487 #. type: textblock
10488 #: ../src/guestfs-actions.pod:1990 ../src/guestfs-actions.pod:4415
10489 #: ../src/guestfs-actions.pod:4612 ../src/guestfs-actions.pod:4631
10490 #: ../src/guestfs-actions.pod:4650 ../src/guestfs-actions.pod:4662
10491 #: ../src/guestfs-actions.pod:4679 ../src/guestfs-actions.pod:4692
10492 #: ../src/guestfs-actions.pod:5586 ../src/guestfs-actions.pod:5968
10493 #: ../src/guestfs-actions.pod:6229 ../src/guestfs-actions.pod:6844
10494 msgid "(Added in 1.0.55)"
10495 msgstr ""
10496
10497 # type: =head2
10498 #. type: =head2
10499 #: ../src/guestfs-actions.pod:1992
10500 msgid "guestfs_get_network"
10501 msgstr ""
10502
10503 # type: verbatim
10504 #. type: verbatim
10505 #: ../src/guestfs-actions.pod:1994
10506 #, no-wrap
10507 msgid ""
10508 " int\n"
10509 " guestfs_get_network (guestfs_h *g);\n"
10510 "\n"
10511 msgstr ""
10512
10513 # type: textblock
10514 #. type: textblock
10515 #: ../src/guestfs-actions.pod:1997 ../fish/guestfish-actions.pod:1357
10516 msgid "This returns the enable network flag."
10517 msgstr ""
10518
10519 # type: textblock
10520 #. type: textblock
10521 #: ../src/guestfs-actions.pod:2001 ../src/guestfs-actions.pod:5987
10522 msgid "(Added in 1.5.4)"
10523 msgstr ""
10524
10525 # type: =head2
10526 #. type: =head2
10527 #: ../src/guestfs-actions.pod:2003
10528 msgid "guestfs_get_path"
10529 msgstr ""
10530
10531 # type: verbatim
10532 #. type: verbatim
10533 #: ../src/guestfs-actions.pod:2005
10534 #, no-wrap
10535 msgid ""
10536 " const char *\n"
10537 " guestfs_get_path (guestfs_h *g);\n"
10538 "\n"
10539 msgstr ""
10540
10541 # type: textblock
10542 #. type: textblock
10543 #: ../src/guestfs-actions.pod:2008 ../fish/guestfish-actions.pod:1363
10544 msgid "Return the current search path."
10545 msgstr ""
10546
10547 # type: textblock
10548 #. type: textblock
10549 #: ../src/guestfs-actions.pod:2010 ../fish/guestfish-actions.pod:1365
10550 msgid ""
10551 "This is always non-NULL.  If it wasn't set already, then this will return "
10552 "the default path."
10553 msgstr ""
10554
10555 # type: textblock
10556 #. type: textblock
10557 #: ../src/guestfs-actions.pod:2013 ../src/guestfs-actions.pod:2042
10558 msgid ""
10559 "This function returns a string, or NULL on error.  The string is owned by "
10560 "the guest handle and must I<not> be freed."
10561 msgstr ""
10562
10563 # type: =head2
10564 #. type: =head2
10565 #: ../src/guestfs-actions.pod:2018
10566 msgid "guestfs_get_pid"
10567 msgstr ""
10568
10569 # type: verbatim
10570 #. type: verbatim
10571 #: ../src/guestfs-actions.pod:2020
10572 #, no-wrap
10573 msgid ""
10574 " int\n"
10575 " guestfs_get_pid (guestfs_h *g);\n"
10576 "\n"
10577 msgstr ""
10578
10579 # type: textblock
10580 #. type: textblock
10581 #: ../src/guestfs-actions.pod:2023 ../fish/guestfish-actions.pod:1374
10582 msgid ""
10583 "Return the process ID of the qemu subprocess.  If there is no qemu "
10584 "subprocess, then this will return an error."
10585 msgstr ""
10586
10587 # type: textblock
10588 #. type: textblock
10589 #: ../src/guestfs-actions.pod:2026 ../fish/guestfish-actions.pod:1377
10590 msgid "This is an internal call used for debugging and testing."
10591 msgstr ""
10592
10593 # type: textblock
10594 #. type: textblock
10595 #: ../src/guestfs-actions.pod:2030
10596 msgid "(Added in 1.0.56)"
10597 msgstr ""
10598
10599 # type: =head2
10600 #. type: =head2
10601 #: ../src/guestfs-actions.pod:2032
10602 msgid "guestfs_get_qemu"
10603 msgstr ""
10604
10605 # type: verbatim
10606 #. type: verbatim
10607 #: ../src/guestfs-actions.pod:2034
10608 #, no-wrap
10609 msgid ""
10610 " const char *\n"
10611 " guestfs_get_qemu (guestfs_h *g);\n"
10612 "\n"
10613 msgstr ""
10614
10615 # type: textblock
10616 #. type: textblock
10617 #: ../src/guestfs-actions.pod:2037 ../fish/guestfish-actions.pod:1383
10618 msgid "Return the current qemu binary."
10619 msgstr ""
10620
10621 # type: textblock
10622 #. type: textblock
10623 #: ../src/guestfs-actions.pod:2039 ../fish/guestfish-actions.pod:1385
10624 msgid ""
10625 "This is always non-NULL.  If it wasn't set already, then this will return "
10626 "the default qemu binary name."
10627 msgstr ""
10628
10629 # type: textblock
10630 #. type: textblock
10631 #: ../src/guestfs-actions.pod:2045 ../src/guestfs-actions.pod:6032
10632 msgid "(Added in 1.0.6)"
10633 msgstr ""
10634
10635 # type: =head2
10636 #. type: =head2
10637 #: ../src/guestfs-actions.pod:2047
10638 msgid "guestfs_get_recovery_proc"
10639 msgstr ""
10640
10641 # type: verbatim
10642 #. type: verbatim
10643 #: ../src/guestfs-actions.pod:2049
10644 #, no-wrap
10645 msgid ""
10646 " int\n"
10647 " guestfs_get_recovery_proc (guestfs_h *g);\n"
10648 "\n"
10649 msgstr ""
10650
10651 # type: textblock
10652 #. type: textblock
10653 #: ../src/guestfs-actions.pod:2052 ../fish/guestfish-actions.pod:1392
10654 msgid "Return the recovery process enabled flag."
10655 msgstr ""
10656
10657 # type: textblock
10658 #. type: textblock
10659 #: ../src/guestfs-actions.pod:2056 ../src/guestfs-actions.pod:3525
10660 #: ../src/guestfs-actions.pod:3822 ../src/guestfs-actions.pod:4222
10661 #: ../src/guestfs-actions.pod:4254 ../src/guestfs-actions.pod:5291
10662 #: ../src/guestfs-actions.pod:5634 ../src/guestfs-actions.pod:6056
10663 #: ../src/guestfs-actions.pod:6747 ../src/guestfs-actions.pod:6767
10664 #: ../src/guestfs-actions.pod:6959
10665 msgid "(Added in 1.0.77)"
10666 msgstr ""
10667
10668 # type: =head2
10669 #. type: =head2
10670 #: ../src/guestfs-actions.pod:2058
10671 msgid "guestfs_get_selinux"
10672 msgstr ""
10673
10674 # type: verbatim
10675 #. type: verbatim
10676 #: ../src/guestfs-actions.pod:2060
10677 #, no-wrap
10678 msgid ""
10679 " int\n"
10680 " guestfs_get_selinux (guestfs_h *g);\n"
10681 "\n"
10682 msgstr ""
10683
10684 # type: textblock
10685 #. type: textblock
10686 #: ../src/guestfs-actions.pod:2063
10687 msgid ""
10688 "This returns the current setting of the selinux flag which is passed to the "
10689 "appliance at boot time.  See C<guestfs_set_selinux>."
10690 msgstr ""
10691
10692 # type: textblock
10693 #. type: textblock
10694 #: ../src/guestfs-actions.pod:2071 ../src/guestfs-actions.pod:2134
10695 #: ../src/guestfs-actions.pod:6075 ../src/guestfs-actions.pod:6133
10696 msgid "(Added in 1.0.67)"
10697 msgstr ""
10698
10699 # type: =head2
10700 #. type: =head2
10701 #: ../src/guestfs-actions.pod:2073
10702 msgid "guestfs_get_state"
10703 msgstr ""
10704
10705 # type: verbatim
10706 #. type: verbatim
10707 #: ../src/guestfs-actions.pod:2075
10708 #, no-wrap
10709 msgid ""
10710 " int\n"
10711 " guestfs_get_state (guestfs_h *g);\n"
10712 "\n"
10713 msgstr ""
10714
10715 # type: textblock
10716 #. type: textblock
10717 #: ../src/guestfs-actions.pod:2078 ../fish/guestfish-actions.pod:1408
10718 msgid ""
10719 "This returns the current state as an opaque integer.  This is only useful "
10720 "for printing debug and internal error messages."
10721 msgstr ""
10722
10723 # type: textblock
10724 #. type: textblock
10725 #: ../src/guestfs-actions.pod:2081 ../src/guestfs-actions.pod:3323
10726 #: ../src/guestfs-actions.pod:3352 ../src/guestfs-actions.pod:3413
10727 #: ../src/guestfs-actions.pod:3440 ../fish/guestfish-actions.pod:1411
10728 #: ../fish/guestfish-actions.pod:2347 ../fish/guestfish-actions.pod:2365
10729 #: ../fish/guestfish-actions.pod:2403 ../fish/guestfish-actions.pod:2419
10730 msgid "For more information on states, see L<guestfs(3)>."
10731 msgstr ""
10732
10733 # type: =head2
10734 #. type: =head2
10735 #: ../src/guestfs-actions.pod:2087
10736 msgid "guestfs_get_trace"
10737 msgstr ""
10738
10739 # type: verbatim
10740 #. type: verbatim
10741 #: ../src/guestfs-actions.pod:2089
10742 #, no-wrap
10743 msgid ""
10744 " int\n"
10745 " guestfs_get_trace (guestfs_h *g);\n"
10746 "\n"
10747 msgstr ""
10748
10749 # type: textblock
10750 #. type: textblock
10751 #: ../src/guestfs-actions.pod:2092 ../fish/guestfish-actions.pod:1417
10752 msgid "Return the command trace flag."
10753 msgstr ""
10754
10755 # type: =head2
10756 #. type: =head2
10757 #: ../src/guestfs-actions.pod:2098
10758 msgid "guestfs_get_umask"
10759 msgstr ""
10760
10761 # type: verbatim
10762 #. type: verbatim
10763 #: ../src/guestfs-actions.pod:2100
10764 #, no-wrap
10765 msgid ""
10766 " int\n"
10767 " guestfs_get_umask (guestfs_h *g);\n"
10768 "\n"
10769 msgstr ""
10770
10771 # type: textblock
10772 #. type: textblock
10773 #: ../src/guestfs-actions.pod:2103
10774 msgid ""
10775 "Return the current umask.  By default the umask is C<022> unless it has been "
10776 "set by calling C<guestfs_umask>."
10777 msgstr ""
10778
10779 # type: =head2
10780 #. type: =head2
10781 #: ../src/guestfs-actions.pod:2110
10782 msgid "guestfs_get_verbose"
10783 msgstr ""
10784
10785 # type: verbatim
10786 #. type: verbatim
10787 #: ../src/guestfs-actions.pod:2112
10788 #, no-wrap
10789 msgid ""
10790 " int\n"
10791 " guestfs_get_verbose (guestfs_h *g);\n"
10792 "\n"
10793 msgstr ""
10794
10795 # type: textblock
10796 #. type: textblock
10797 #: ../src/guestfs-actions.pod:2115 ../fish/guestfish-actions.pod:1430
10798 msgid "This returns the verbose messages flag."
10799 msgstr ""
10800
10801 # type: =head2
10802 #. type: =head2
10803 #: ../src/guestfs-actions.pod:2121
10804 msgid "guestfs_getcon"
10805 msgstr ""
10806
10807 # type: verbatim
10808 #. type: verbatim
10809 #: ../src/guestfs-actions.pod:2123
10810 #, no-wrap
10811 msgid ""
10812 " char *\n"
10813 " guestfs_getcon (guestfs_h *g);\n"
10814 "\n"
10815 msgstr ""
10816
10817 # type: textblock
10818 #. type: textblock
10819 #: ../src/guestfs-actions.pod:2126 ../fish/guestfish-actions.pod:1436
10820 msgid "This gets the SELinux security context of the daemon."
10821 msgstr ""
10822
10823 # type: textblock
10824 #. type: textblock
10825 #: ../src/guestfs-actions.pod:2128
10826 msgid ""
10827 "See the documentation about SELINUX in L<guestfs(3)>, and C<guestfs_setcon>"
10828 msgstr ""
10829
10830 # type: =head2
10831 #. type: =head2
10832 #: ../src/guestfs-actions.pod:2136
10833 msgid "guestfs_getxattr"
10834 msgstr ""
10835
10836 # type: verbatim
10837 #. type: verbatim
10838 #: ../src/guestfs-actions.pod:2138
10839 #, no-wrap
10840 msgid ""
10841 " char *\n"
10842 " guestfs_getxattr (guestfs_h *g,\n"
10843 "                   const char *path,\n"
10844 "                   const char *name,\n"
10845 "                   size_t *size_r);\n"
10846 "\n"
10847 msgstr ""
10848
10849 # type: textblock
10850 #. type: textblock
10851 #: ../src/guestfs-actions.pod:2144
10852 msgid ""
10853 "Get a single extended attribute from file C<path> named C<name>.  This call "
10854 "follows symlinks.  If you want to lookup an extended attribute for the "
10855 "symlink itself, use C<guestfs_lgetxattr>."
10856 msgstr ""
10857
10858 # type: textblock
10859 #. type: textblock
10860 #: ../src/guestfs-actions.pod:2148 ../src/guestfs-actions.pod:3539
10861 msgid ""
10862 "Normally it is better to get all extended attributes from a file in one go "
10863 "by calling C<guestfs_getxattrs>.  However some Linux filesystem "
10864 "implementations are buggy and do not provide a way to list out attributes.  "
10865 "For these filesystems (notably ntfs-3g)  you have to know the names of the "
10866 "extended attributes you want in advance and call this function."
10867 msgstr ""
10868
10869 # type: textblock
10870 #. type: textblock
10871 #: ../src/guestfs-actions.pod:2155 ../src/guestfs-actions.pod:3546
10872 #: ../fish/guestfish-actions.pod:1456 ../fish/guestfish-actions.pod:2484
10873 msgid ""
10874 "Extended attribute values are blobs of binary data.  If there is no extended "
10875 "attribute named C<name>, this returns an error."
10876 msgstr ""
10877
10878 # type: textblock
10879 #. type: textblock
10880 #: ../src/guestfs-actions.pod:2158
10881 msgid "See also: C<guestfs_getxattrs>, C<guestfs_lgetxattr>, L<attr(5)>."
10882 msgstr ""
10883
10884 # type: textblock
10885 #. type: textblock
10886 #: ../src/guestfs-actions.pod:2160 ../src/guestfs-actions.pod:2373
10887 #: ../src/guestfs-actions.pod:3551 ../src/guestfs-actions.pod:5284
10888 #: ../src/guestfs-actions.pod:5310 ../src/guestfs-actions.pod:5491
10889 msgid ""
10890 "This function returns a buffer, or NULL on error.  The size of the returned "
10891 "buffer is written to C<*size_r>.  I<The caller must free the returned buffer "
10892 "after use>."
10893 msgstr ""
10894
10895 #. type: textblock
10896 #: ../src/guestfs-actions.pod:2164 ../src/guestfs-actions.pod:3555
10897 msgid "(Added in 1.7.24)"
10898 msgstr ""
10899
10900 # type: =head2
10901 #. type: =head2
10902 #: ../src/guestfs-actions.pod:2166
10903 msgid "guestfs_getxattrs"
10904 msgstr ""
10905
10906 # type: verbatim
10907 #. type: verbatim
10908 #: ../src/guestfs-actions.pod:2168
10909 #, no-wrap
10910 msgid ""
10911 " struct guestfs_xattr_list *\n"
10912 " guestfs_getxattrs (guestfs_h *g,\n"
10913 "                    const char *path);\n"
10914 "\n"
10915 msgstr ""
10916
10917 # type: textblock
10918 #. type: textblock
10919 #: ../src/guestfs-actions.pod:2172 ../fish/guestfish-actions.pod:1465
10920 msgid ""
10921 "This call lists the extended attributes of the file or directory C<path>."
10922 msgstr ""
10923
10924 # type: textblock
10925 #. type: textblock
10926 #: ../src/guestfs-actions.pod:2175 ../fish/guestfish-actions.pod:1468
10927 msgid ""
10928 "At the system call level, this is a combination of the L<listxattr(2)> and "
10929 "L<getxattr(2)> calls."
10930 msgstr ""
10931
10932 # type: textblock
10933 #. type: textblock
10934 #: ../src/guestfs-actions.pod:2178
10935 msgid "See also: C<guestfs_lgetxattrs>, L<attr(5)>."
10936 msgstr ""
10937
10938 # type: textblock
10939 #. type: textblock
10940 #: ../src/guestfs-actions.pod:2180 ../src/guestfs-actions.pod:3567
10941 #: ../src/guestfs-actions.pod:4218
10942 msgid ""
10943 "This function returns a C<struct guestfs_xattr_list *>, or NULL if there was "
10944 "an error.  I<The caller must call C<guestfs_free_xattr_list> after use>."
10945 msgstr ""
10946
10947 # type: textblock
10948 #. type: textblock
10949 #: ../src/guestfs-actions.pod:2184 ../src/guestfs-actions.pod:3571
10950 #: ../src/guestfs-actions.pod:3736 ../src/guestfs-actions.pod:3772
10951 #: ../src/guestfs-actions.pod:5664 ../src/guestfs-actions.pod:6152
10952 #: ../src/guestfs-actions.pod:7522
10953 msgid "(Added in 1.0.59)"
10954 msgstr ""
10955
10956 # type: =head2
10957 #. type: =head2
10958 #: ../src/guestfs-actions.pod:2186
10959 msgid "guestfs_glob_expand"
10960 msgstr ""
10961
10962 # type: verbatim
10963 #. type: verbatim
10964 #: ../src/guestfs-actions.pod:2188
10965 #, no-wrap
10966 msgid ""
10967 " char **\n"
10968 " guestfs_glob_expand (guestfs_h *g,\n"
10969 "                      const char *pattern);\n"
10970 "\n"
10971 msgstr ""
10972
10973 # type: textblock
10974 #. type: textblock
10975 #: ../src/guestfs-actions.pod:2192 ../fish/guestfish-actions.pod:1477
10976 msgid ""
10977 "This command searches for all the pathnames matching C<pattern> according to "
10978 "the wildcard expansion rules used by the shell."
10979 msgstr ""
10980
10981 # type: textblock
10982 #. type: textblock
10983 #: ../src/guestfs-actions.pod:2196 ../fish/guestfish-actions.pod:1481
10984 msgid ""
10985 "If no paths match, then this returns an empty list (note: not an error)."
10986 msgstr ""
10987
10988 # type: textblock
10989 #. type: textblock
10990 #: ../src/guestfs-actions.pod:2199 ../fish/guestfish-actions.pod:1484
10991 msgid ""
10992 "It is just a wrapper around the C L<glob(3)> function with flags C<GLOB_MARK|"
10993 "GLOB_BRACE>.  See that manual page for more details."
10994 msgstr ""
10995
10996 # type: textblock
10997 #. type: textblock
10998 #: ../src/guestfs-actions.pod:2207 ../src/guestfs-actions.pod:6345
10999 #: ../src/guestfs-actions.pod:6362
11000 msgid "(Added in 1.0.50)"
11001 msgstr ""
11002
11003 # type: =head2
11004 #. type: =head2
11005 #: ../src/guestfs-actions.pod:2209
11006 msgid "guestfs_grep"
11007 msgstr ""
11008
11009 # type: verbatim
11010 #. type: verbatim
11011 #: ../src/guestfs-actions.pod:2211
11012 #, no-wrap
11013 msgid ""
11014 " char **\n"
11015 " guestfs_grep (guestfs_h *g,\n"
11016 "               const char *regex,\n"
11017 "               const char *path);\n"
11018 "\n"
11019 msgstr ""
11020
11021 # type: textblock
11022 #. type: textblock
11023 #: ../src/guestfs-actions.pod:2216 ../fish/guestfish-actions.pod:1492
11024 msgid "This calls the external C<grep> program and returns the matching lines."
11025 msgstr ""
11026
11027 # type: =head2
11028 #. type: =head2
11029 #: ../src/guestfs-actions.pod:2228
11030 msgid "guestfs_grepi"
11031 msgstr ""
11032
11033 # type: verbatim
11034 #. type: verbatim
11035 #: ../src/guestfs-actions.pod:2230
11036 #, no-wrap
11037 msgid ""
11038 " char **\n"
11039 " guestfs_grepi (guestfs_h *g,\n"
11040 "                const char *regex,\n"
11041 "                const char *path);\n"
11042 "\n"
11043 msgstr ""
11044
11045 # type: textblock
11046 #. type: textblock
11047 #: ../src/guestfs-actions.pod:2235 ../fish/guestfish-actions.pod:1502
11048 msgid ""
11049 "This calls the external C<grep -i> program and returns the matching lines."
11050 msgstr ""
11051
11052 # type: =head2
11053 #. type: =head2
11054 #: ../src/guestfs-actions.pod:2247
11055 msgid "guestfs_grub_install"
11056 msgstr ""
11057
11058 # type: verbatim
11059 #. type: verbatim
11060 #: ../src/guestfs-actions.pod:2249
11061 #, no-wrap
11062 msgid ""
11063 " int\n"
11064 " guestfs_grub_install (guestfs_h *g,\n"
11065 "                       const char *root,\n"
11066 "                       const char *device);\n"
11067 "\n"
11068 msgstr ""
11069
11070 #. type: textblock
11071 #: ../src/guestfs-actions.pod:2254 ../fish/guestfish-actions.pod:1512
11072 msgid ""
11073 "This command installs GRUB 1 (the Grand Unified Bootloader) on C<device>, "
11074 "with the root directory being C<root>."
11075 msgstr ""
11076
11077 #. type: textblock
11078 #: ../src/guestfs-actions.pod:2263 ../fish/guestfish-actions.pod:1521
11079 msgid ""
11080 "There is currently no way in the API to install grub2, which is used by most "
11081 "modern Linux guests.  It is possible to run the grub2 command from the "
11082 "guest, although see the caveats in L<guestfs(3)/RUNNING COMMANDS>."
11083 msgstr ""
11084
11085 #. type: textblock
11086 #: ../src/guestfs-actions.pod:2270 ../fish/guestfish-actions.pod:1528
11087 msgid ""
11088 "This uses C<grub-install> from the host.  Unfortunately grub is not always "
11089 "compatible with itself, so this only works in rather narrow circumstances.  "
11090 "Careful testing with each guest version is advisable."
11091 msgstr ""
11092
11093 #. type: textblock
11094 #: ../src/guestfs-actions.pod:2277 ../fish/guestfish-actions.pod:1535
11095 msgid ""
11096 "If grub-install reports the error \"No suitable drive was found in the "
11097 "generated device map.\" it may be that you need to create a C</boot/grub/"
11098 "device.map> file first that contains the mapping between grub device names "
11099 "and Linux device names.  It is usually sufficient to create a file "
11100 "containing:"
11101 msgstr ""
11102
11103 # type: verbatim
11104 #. type: verbatim
11105 #: ../src/guestfs-actions.pod:2284 ../fish/guestfish-actions.pod:1542
11106 #, no-wrap
11107 msgid ""
11108 " (hd0) /dev/vda\n"
11109 "\n"
11110 msgstr ""
11111
11112 # type: textblock
11113 #. type: textblock
11114 #: ../src/guestfs-actions.pod:2286 ../fish/guestfish-actions.pod:1544
11115 msgid "replacing C</dev/vda> with the name of the installation device."
11116 msgstr ""
11117
11118 # type: textblock
11119 #. type: textblock
11120 #: ../src/guestfs-actions.pod:2292
11121 msgid "(Added in 1.0.17)"
11122 msgstr ""
11123
11124 # type: =head2
11125 #. type: =head2
11126 #: ../src/guestfs-actions.pod:2294
11127 msgid "guestfs_head"
11128 msgstr ""
11129
11130 # type: verbatim
11131 #. type: verbatim
11132 #: ../src/guestfs-actions.pod:2296
11133 #, no-wrap
11134 msgid ""
11135 " char **\n"
11136 " guestfs_head (guestfs_h *g,\n"
11137 "               const char *path);\n"
11138 "\n"
11139 msgstr ""
11140
11141 # type: textblock
11142 #. type: textblock
11143 #: ../src/guestfs-actions.pod:2300 ../fish/guestfish-actions.pod:1552
11144 msgid ""
11145 "This command returns up to the first 10 lines of a file as a list of strings."
11146 msgstr ""
11147
11148 # type: =head2
11149 #. type: =head2
11150 #: ../src/guestfs-actions.pod:2312
11151 msgid "guestfs_head_n"
11152 msgstr ""
11153
11154 # type: verbatim
11155 #. type: verbatim
11156 #: ../src/guestfs-actions.pod:2314
11157 #, no-wrap
11158 msgid ""
11159 " char **\n"
11160 " guestfs_head_n (guestfs_h *g,\n"
11161 "                 int nrlines,\n"
11162 "                 const char *path);\n"
11163 "\n"
11164 msgstr ""
11165
11166 # type: textblock
11167 #. type: textblock
11168 #: ../src/guestfs-actions.pod:2319 ../fish/guestfish-actions.pod:1562
11169 msgid ""
11170 "If the parameter C<nrlines> is a positive number, this returns the first "
11171 "C<nrlines> lines of the file C<path>."
11172 msgstr ""
11173
11174 # type: textblock
11175 #. type: textblock
11176 #: ../src/guestfs-actions.pod:2322 ../fish/guestfish-actions.pod:1565
11177 msgid ""
11178 "If the parameter C<nrlines> is a negative number, this returns lines from "
11179 "the file C<path>, excluding the last C<nrlines> lines."
11180 msgstr ""
11181
11182 # type: textblock
11183 #. type: textblock
11184 #: ../src/guestfs-actions.pod:2325 ../src/guestfs-actions.pod:6642
11185 #: ../fish/guestfish-actions.pod:1568 ../fish/guestfish-actions.pod:4498
11186 msgid "If the parameter C<nrlines> is zero, this returns an empty list."
11187 msgstr ""
11188
11189 # type: =head2
11190 #. type: =head2
11191 #: ../src/guestfs-actions.pod:2336
11192 msgid "guestfs_hexdump"
11193 msgstr ""
11194
11195 # type: verbatim
11196 #. type: verbatim
11197 #: ../src/guestfs-actions.pod:2338
11198 #, no-wrap
11199 msgid ""
11200 " char *\n"
11201 " guestfs_hexdump (guestfs_h *g,\n"
11202 "                  const char *path);\n"
11203 "\n"
11204 msgstr ""
11205
11206 # type: textblock
11207 #. type: textblock
11208 #: ../src/guestfs-actions.pod:2342 ../fish/guestfish-actions.pod:1577
11209 msgid ""
11210 "This runs C<hexdump -C> on the given C<path>.  The result is the human-"
11211 "readable, canonical hex dump of the file."
11212 msgstr ""
11213
11214 # type: textblock
11215 #. type: textblock
11216 #: ../src/guestfs-actions.pod:2351 ../src/guestfs-actions.pod:6426
11217 #: ../src/guestfs-actions.pod:6481
11218 msgid "(Added in 1.0.22)"
11219 msgstr ""
11220
11221 # type: =head2
11222 #. type: =head2
11223 #: ../src/guestfs-actions.pod:2353
11224 msgid "guestfs_initrd_cat"
11225 msgstr ""
11226
11227 # type: verbatim
11228 #. type: verbatim
11229 #: ../src/guestfs-actions.pod:2355
11230 #, no-wrap
11231 msgid ""
11232 " char *\n"
11233 " guestfs_initrd_cat (guestfs_h *g,\n"
11234 "                     const char *initrdpath,\n"
11235 "                     const char *filename,\n"
11236 "                     size_t *size_r);\n"
11237 "\n"
11238 msgstr ""
11239
11240 # type: textblock
11241 #. type: textblock
11242 #: ../src/guestfs-actions.pod:2361 ../fish/guestfish-actions.pod:1587
11243 msgid ""
11244 "This command unpacks the file C<filename> from the initrd file called "
11245 "C<initrdpath>.  The filename must be given I<without> the initial C</> "
11246 "character."
11247 msgstr ""
11248
11249 # type: textblock
11250 #. type: textblock
11251 #: ../src/guestfs-actions.pod:2365 ../fish/guestfish-actions.pod:1591
11252 msgid ""
11253 "For example, in guestfish you could use the following command to examine the "
11254 "boot script (usually called C</init>)  contained in a Linux initrd or "
11255 "initramfs image:"
11256 msgstr ""
11257
11258 # type: verbatim
11259 #. type: verbatim
11260 #: ../src/guestfs-actions.pod:2369 ../fish/guestfish-actions.pod:1595
11261 #, no-wrap
11262 msgid ""
11263 " initrd-cat /boot/initrd-<version>.img init\n"
11264 "\n"
11265 msgstr ""
11266
11267 # type: textblock
11268 #. type: textblock
11269 #: ../src/guestfs-actions.pod:2371
11270 msgid "See also C<guestfs_initrd_list>."
11271 msgstr ""
11272
11273 # type: =head2
11274 #. type: =head2
11275 #: ../src/guestfs-actions.pod:2382
11276 msgid "guestfs_initrd_list"
11277 msgstr ""
11278
11279 # type: verbatim
11280 #. type: verbatim
11281 #: ../src/guestfs-actions.pod:2384
11282 #, no-wrap
11283 msgid ""
11284 " char **\n"
11285 " guestfs_initrd_list (guestfs_h *g,\n"
11286 "                      const char *path);\n"
11287 "\n"
11288 msgstr ""
11289
11290 # type: textblock
11291 #. type: textblock
11292 #: ../src/guestfs-actions.pod:2388 ../fish/guestfish-actions.pod:1606
11293 msgid "This command lists out files contained in an initrd."
11294 msgstr ""
11295
11296 # type: textblock
11297 #. type: textblock
11298 #: ../src/guestfs-actions.pod:2390 ../fish/guestfish-actions.pod:1608
11299 msgid ""
11300 "The files are listed without any initial C</> character.  The files are "
11301 "listed in the order they appear (not necessarily alphabetical).  Directory "
11302 "names are listed as separate items."
11303 msgstr ""
11304
11305 # type: textblock
11306 #. type: textblock
11307 #: ../src/guestfs-actions.pod:2394 ../fish/guestfish-actions.pod:1612
11308 msgid ""
11309 "Old Linux kernels (2.4 and earlier) used a compressed ext2 filesystem as "
11310 "initrd.  We I<only> support the newer initramfs format (compressed cpio "
11311 "files)."
11312 msgstr ""
11313
11314 # type: =head2
11315 #. type: =head2
11316 #: ../src/guestfs-actions.pod:2404
11317 msgid "guestfs_inotify_add_watch"
11318 msgstr ""
11319
11320 # type: verbatim
11321 #. type: verbatim
11322 #: ../src/guestfs-actions.pod:2406
11323 #, no-wrap
11324 msgid ""
11325 " int64_t\n"
11326 " guestfs_inotify_add_watch (guestfs_h *g,\n"
11327 "                            const char *path,\n"
11328 "                            int mask);\n"
11329 "\n"
11330 msgstr ""
11331
11332 # type: textblock
11333 #. type: textblock
11334 #: ../src/guestfs-actions.pod:2411 ../fish/guestfish-actions.pod:1620
11335 msgid "Watch C<path> for the events listed in C<mask>."
11336 msgstr ""
11337
11338 # type: textblock
11339 #. type: textblock
11340 #: ../src/guestfs-actions.pod:2413 ../fish/guestfish-actions.pod:1622
11341 msgid ""
11342 "Note that if C<path> is a directory then events within that directory are "
11343 "watched, but this does I<not> happen recursively (in subdirectories)."
11344 msgstr ""
11345
11346 # type: textblock
11347 #. type: textblock
11348 #: ../src/guestfs-actions.pod:2417 ../fish/guestfish-actions.pod:1626
11349 msgid ""
11350 "Note for non-C or non-Linux callers: the inotify events are defined by the "
11351 "Linux kernel ABI and are listed in C</usr/include/sys/inotify.h>."
11352 msgstr ""
11353
11354 # type: =head2
11355 #. type: =head2
11356 #: ../src/guestfs-actions.pod:2425
11357 msgid "guestfs_inotify_close"
11358 msgstr ""
11359
11360 # type: verbatim
11361 #. type: verbatim
11362 #: ../src/guestfs-actions.pod:2427
11363 #, no-wrap
11364 msgid ""
11365 " int\n"
11366 " guestfs_inotify_close (guestfs_h *g);\n"
11367 "\n"
11368 msgstr ""
11369
11370 # type: textblock
11371 #. type: textblock
11372 #: ../src/guestfs-actions.pod:2430 ../fish/guestfish-actions.pod:1634
11373 msgid ""
11374 "This closes the inotify handle which was previously opened by inotify_init.  "
11375 "It removes all watches, throws away any pending events, and deallocates all "
11376 "resources."
11377 msgstr ""
11378
11379 # type: =head2
11380 #. type: =head2
11381 #: ../src/guestfs-actions.pod:2438
11382 msgid "guestfs_inotify_files"
11383 msgstr ""
11384
11385 # type: verbatim
11386 #. type: verbatim
11387 #: ../src/guestfs-actions.pod:2440
11388 #, no-wrap
11389 msgid ""
11390 " char **\n"
11391 " guestfs_inotify_files (guestfs_h *g);\n"
11392 "\n"
11393 msgstr ""
11394
11395 # type: textblock
11396 #. type: textblock
11397 #: ../src/guestfs-actions.pod:2443
11398 msgid ""
11399 "This function is a helpful wrapper around C<guestfs_inotify_read> which just "
11400 "returns a list of pathnames of objects that were touched.  The returned "
11401 "pathnames are sorted and deduplicated."
11402 msgstr ""
11403
11404 # type: =head2
11405 #. type: =head2
11406 #: ../src/guestfs-actions.pod:2453
11407 msgid "guestfs_inotify_init"
11408 msgstr ""
11409
11410 # type: verbatim
11411 #. type: verbatim
11412 #: ../src/guestfs-actions.pod:2455
11413 #, no-wrap
11414 msgid ""
11415 " int\n"
11416 " guestfs_inotify_init (guestfs_h *g,\n"
11417 "                       int maxevents);\n"
11418 "\n"
11419 msgstr ""
11420
11421 # type: textblock
11422 #. type: textblock
11423 #: ../src/guestfs-actions.pod:2459 ../fish/guestfish-actions.pod:1650
11424 msgid ""
11425 "This command creates a new inotify handle.  The inotify subsystem can be "
11426 "used to notify events which happen to objects in the guest filesystem."
11427 msgstr ""
11428
11429 # type: textblock
11430 #. type: textblock
11431 #: ../src/guestfs-actions.pod:2463
11432 msgid ""
11433 "C<maxevents> is the maximum number of events which will be queued up between "
11434 "calls to C<guestfs_inotify_read> or C<guestfs_inotify_files>.  If this is "
11435 "passed as C<0>, then the kernel (or previously set)  default is used.  For "
11436 "Linux 2.6.29 the default was 16384 events.  Beyond this limit, the kernel "
11437 "throws away events, but records the fact that it threw them away by setting "
11438 "a flag C<IN_Q_OVERFLOW> in the returned structure list (see "
11439 "C<guestfs_inotify_read>)."
11440 msgstr ""
11441
11442 # type: textblock
11443 #. type: textblock
11444 #: ../src/guestfs-actions.pod:2473
11445 msgid ""
11446 "Before any events are generated, you have to add some watches to the "
11447 "internal watch list.  See: C<guestfs_inotify_add_watch>, "
11448 "C<guestfs_inotify_rm_watch> and C<guestfs_inotify_watch_all>."
11449 msgstr ""
11450
11451 # type: textblock
11452 #. type: textblock
11453 #: ../src/guestfs-actions.pod:2479
11454 msgid ""
11455 "Queued up events should be read periodically by calling "
11456 "C<guestfs_inotify_read> (or C<guestfs_inotify_files> which is just a helpful "
11457 "wrapper around C<guestfs_inotify_read>).  If you don't read the events out "
11458 "often enough then you risk the internal queue overflowing."
11459 msgstr ""
11460
11461 # type: textblock
11462 #. type: textblock
11463 #: ../src/guestfs-actions.pod:2486
11464 msgid ""
11465 "The handle should be closed after use by calling C<guestfs_inotify_close>.  "
11466 "This also removes any watches automatically."
11467 msgstr ""
11468
11469 # type: textblock
11470 #. type: textblock
11471 #: ../src/guestfs-actions.pod:2490 ../fish/guestfish-actions.pod:1681
11472 msgid ""
11473 "See also L<inotify(7)> for an overview of the inotify interface as exposed "
11474 "by the Linux kernel, which is roughly what we expose via libguestfs.  Note "
11475 "that there is one global inotify handle per libguestfs instance."
11476 msgstr ""
11477
11478 # type: =head2
11479 #. type: =head2
11480 #: ../src/guestfs-actions.pod:2499
11481 msgid "guestfs_inotify_read"
11482 msgstr ""
11483
11484 # type: verbatim
11485 #. type: verbatim
11486 #: ../src/guestfs-actions.pod:2501
11487 #, no-wrap
11488 msgid ""
11489 " struct guestfs_inotify_event_list *\n"
11490 " guestfs_inotify_read (guestfs_h *g);\n"
11491 "\n"
11492 msgstr ""
11493
11494 # type: textblock
11495 #. type: textblock
11496 #: ../src/guestfs-actions.pod:2504 ../fish/guestfish-actions.pod:1690
11497 msgid ""
11498 "Return the complete queue of events that have happened since the previous "
11499 "read call."
11500 msgstr ""
11501
11502 # type: textblock
11503 #. type: textblock
11504 #: ../src/guestfs-actions.pod:2507 ../fish/guestfish-actions.pod:1693
11505 msgid "If no events have happened, this returns an empty list."
11506 msgstr ""
11507
11508 # type: textblock
11509 #. type: textblock
11510 #: ../src/guestfs-actions.pod:2509 ../fish/guestfish-actions.pod:1695
11511 msgid ""
11512 "I<Note>: In order to make sure that all events have been read, you must call "
11513 "this function repeatedly until it returns an empty list.  The reason is that "
11514 "the call will read events up to the maximum appliance-to-host message size "
11515 "and leave remaining events in the queue."
11516 msgstr ""
11517
11518 # type: textblock
11519 #. type: textblock
11520 #: ../src/guestfs-actions.pod:2515
11521 msgid ""
11522 "This function returns a C<struct guestfs_inotify_event_list *>, or NULL if "
11523 "there was an error.  I<The caller must call "
11524 "C<guestfs_free_inotify_event_list> after use>."
11525 msgstr ""
11526
11527 # type: =head2
11528 #. type: =head2
11529 #: ../src/guestfs-actions.pod:2521
11530 msgid "guestfs_inotify_rm_watch"
11531 msgstr ""
11532
11533 # type: verbatim
11534 #. type: verbatim
11535 #: ../src/guestfs-actions.pod:2523
11536 #, no-wrap
11537 msgid ""
11538 " int\n"
11539 " guestfs_inotify_rm_watch (guestfs_h *g,\n"
11540 "                           int wd);\n"
11541 "\n"
11542 msgstr ""
11543
11544 # type: textblock
11545 #. type: textblock
11546 #: ../src/guestfs-actions.pod:2527
11547 msgid ""
11548 "Remove a previously defined inotify watch.  See C<guestfs_inotify_add_watch>."
11549 msgstr ""
11550
11551 # type: =head2
11552 #. type: =head2
11553 #: ../src/guestfs-actions.pod:2534
11554 msgid "guestfs_inspect_get_arch"
11555 msgstr ""
11556
11557 # type: verbatim
11558 #. type: verbatim
11559 #: ../src/guestfs-actions.pod:2536
11560 #, no-wrap
11561 msgid ""
11562 " char *\n"
11563 " guestfs_inspect_get_arch (guestfs_h *g,\n"
11564 "                           const char *root);\n"
11565 "\n"
11566 msgstr ""
11567
11568 # type: textblock
11569 #. type: textblock
11570 #: ../src/guestfs-actions.pod:2540 ../src/guestfs-actions.pod:2563
11571 #: ../src/guestfs-actions.pod:2656 ../src/guestfs-actions.pod:2700
11572 #: ../src/guestfs-actions.pod:2726 ../src/guestfs-actions.pod:2765
11573 #: ../src/guestfs-actions.pod:2787 ../src/guestfs-actions.pod:2814
11574 #: ../src/guestfs-actions.pod:2835 ../src/guestfs-actions.pod:2878
11575 #: ../src/guestfs-actions.pod:2907 ../src/guestfs-actions.pod:2938
11576 #: ../src/guestfs-actions.pod:2962 ../src/guestfs-actions.pod:3017
11577 #: ../src/guestfs-actions.pod:3059 ../src/guestfs-actions.pod:3080
11578 #: ../src/guestfs-actions.pod:3103 ../src/guestfs-actions.pod:3120
11579 #: ../src/guestfs-actions.pod:3137 ../src/guestfs-actions.pod:3156
11580 msgid ""
11581 "This function should only be called with a root device string as returned by "
11582 "C<guestfs_inspect_os>."
11583 msgstr ""
11584
11585 # type: textblock
11586 #. type: textblock
11587 #: ../src/guestfs-actions.pod:2543
11588 msgid ""
11589 "This returns the architecture of the inspected operating system.  The "
11590 "possible return values are listed under C<guestfs_file_architecture>."
11591 msgstr ""
11592
11593 # type: textblock
11594 #. type: textblock
11595 #: ../src/guestfs-actions.pod:2547 ../fish/guestfish-actions.pod:1719
11596 msgid ""
11597 "If the architecture could not be determined, then the string C<unknown> is "
11598 "returned."
11599 msgstr ""
11600
11601 # type: textblock
11602 #. type: textblock
11603 #: ../src/guestfs-actions.pod:2550 ../src/guestfs-actions.pod:2643
11604 #: ../src/guestfs-actions.pod:2754 ../src/guestfs-actions.pod:2774
11605 #: ../src/guestfs-actions.pod:2802 ../src/guestfs-actions.pod:2894
11606 #: ../src/guestfs-actions.pod:2925 ../src/guestfs-actions.pod:2949
11607 #: ../src/guestfs-actions.pod:3003 ../src/guestfs-actions.pod:3046
11608 #: ../src/guestfs-actions.pod:3069 ../src/guestfs-actions.pod:3090
11609 #: ../src/guestfs-actions.pod:3110 ../src/guestfs-actions.pod:3127
11610 #: ../src/guestfs-actions.pod:3146 ../src/guestfs-actions.pod:3249
11611 #: ../src/guestfs-actions.pod:3290 ../fish/guestfish-actions.pod:1722
11612 #: ../fish/guestfish-actions.pod:1808 ../fish/guestfish-actions.pod:1896
11613 #: ../fish/guestfish-actions.pod:1911 ../fish/guestfish-actions.pod:1932
11614 #: ../fish/guestfish-actions.pod:2002 ../fish/guestfish-actions.pod:2026
11615 #: ../fish/guestfish-actions.pod:2043 ../fish/guestfish-actions.pod:2086
11616 #: ../fish/guestfish-actions.pod:2121 ../fish/guestfish-actions.pod:2137
11617 #: ../fish/guestfish-actions.pod:2153 ../fish/guestfish-actions.pod:2166
11618 #: ../fish/guestfish-actions.pod:2179 ../fish/guestfish-actions.pod:2194
11619 #: ../fish/guestfish-actions.pod:2293 ../fish/guestfish-actions.pod:2327
11620 msgid "Please read L<guestfs(3)/INSPECTION> for more details."
11621 msgstr ""
11622
11623 # type: =head2
11624 #. type: =head2
11625 #: ../src/guestfs-actions.pod:2557
11626 msgid "guestfs_inspect_get_distro"
11627 msgstr ""
11628
11629 # type: verbatim
11630 #. type: verbatim
11631 #: ../src/guestfs-actions.pod:2559
11632 #, no-wrap
11633 msgid ""
11634 " char *\n"
11635 " guestfs_inspect_get_distro (guestfs_h *g,\n"
11636 "                             const char *root);\n"
11637 "\n"
11638 msgstr ""
11639
11640 # type: textblock
11641 #. type: textblock
11642 #: ../src/guestfs-actions.pod:2566 ../fish/guestfish-actions.pod:1731
11643 msgid ""
11644 "This returns the distro (distribution) of the inspected operating system."
11645 msgstr ""
11646
11647 # type: textblock
11648 #. type: textblock
11649 #: ../src/guestfs-actions.pod:2569 ../fish/guestfish-actions.pod:1734
11650 msgid "Currently defined distros are:"
11651 msgstr ""
11652
11653 # type: =item
11654 #. type: =item
11655 #: ../src/guestfs-actions.pod:2573 ../fish/guestfish-actions.pod:1738
11656 msgid "\"archlinux\""
11657 msgstr ""
11658
11659 # type: textblock
11660 #. type: textblock
11661 #: ../src/guestfs-actions.pod:2575 ../fish/guestfish-actions.pod:1740
11662 msgid "Arch Linux."
11663 msgstr ""
11664
11665 #. type: =item
11666 #: ../src/guestfs-actions.pod:2577 ../fish/guestfish-actions.pod:1742
11667 msgid "\"centos\""
11668 msgstr ""
11669
11670 #. type: textblock
11671 #: ../src/guestfs-actions.pod:2579 ../fish/guestfish-actions.pod:1744
11672 msgid "CentOS."
11673 msgstr ""
11674
11675 # type: =item
11676 #. type: =item
11677 #: ../src/guestfs-actions.pod:2581 ../fish/guestfish-actions.pod:1746
11678 msgid "\"debian\""
11679 msgstr ""
11680
11681 # type: textblock
11682 #. type: textblock
11683 #: ../src/guestfs-actions.pod:2583 ../fish/guestfish-actions.pod:1748
11684 msgid "Debian."
11685 msgstr ""
11686
11687 # type: =item
11688 #. type: =item
11689 #: ../src/guestfs-actions.pod:2585 ../fish/guestfish-actions.pod:1750
11690 msgid "\"fedora\""
11691 msgstr ""
11692
11693 # type: textblock
11694 #. type: textblock
11695 #: ../src/guestfs-actions.pod:2587 ../fish/guestfish-actions.pod:1752
11696 msgid "Fedora."
11697 msgstr ""
11698
11699 # type: =item
11700 #. type: =item
11701 #: ../src/guestfs-actions.pod:2589 ../fish/guestfish-actions.pod:1754
11702 msgid "\"gentoo\""
11703 msgstr ""
11704
11705 # type: textblock
11706 #. type: textblock
11707 #: ../src/guestfs-actions.pod:2591 ../fish/guestfish-actions.pod:1756
11708 msgid "Gentoo."
11709 msgstr ""
11710
11711 # type: =item
11712 #. type: =item
11713 #: ../src/guestfs-actions.pod:2593 ../fish/guestfish-actions.pod:1758
11714 msgid "\"linuxmint\""
11715 msgstr ""
11716
11717 # type: textblock
11718 #. type: textblock
11719 #: ../src/guestfs-actions.pod:2595 ../fish/guestfish-actions.pod:1760
11720 msgid "Linux Mint."
11721 msgstr ""
11722
11723 # type: =item
11724 #. type: =item
11725 #: ../src/guestfs-actions.pod:2597 ../fish/guestfish-actions.pod:1762
11726 msgid "\"mandriva\""
11727 msgstr ""
11728
11729 # type: textblock
11730 #. type: textblock
11731 #: ../src/guestfs-actions.pod:2599 ../fish/guestfish-actions.pod:1764
11732 msgid "Mandriva."
11733 msgstr ""
11734
11735 # type: =item
11736 #. type: =item
11737 #: ../src/guestfs-actions.pod:2601 ../fish/guestfish-actions.pod:1766
11738 msgid "\"meego\""
11739 msgstr ""
11740
11741 # type: textblock
11742 #. type: textblock
11743 #: ../src/guestfs-actions.pod:2603 ../fish/guestfish-actions.pod:1768
11744 msgid "MeeGo."
11745 msgstr ""
11746
11747 # type: =item
11748 #. type: =item
11749 #: ../src/guestfs-actions.pod:2605 ../fish/guestfish-actions.pod:1770
11750 msgid "\"pardus\""
11751 msgstr ""
11752
11753 # type: textblock
11754 #. type: textblock
11755 #: ../src/guestfs-actions.pod:2607 ../fish/guestfish-actions.pod:1772
11756 msgid "Pardus."
11757 msgstr ""
11758
11759 # type: =item
11760 #. type: =item
11761 #: ../src/guestfs-actions.pod:2609 ../fish/guestfish-actions.pod:1774
11762 msgid "\"redhat-based\""
11763 msgstr ""
11764
11765 # type: textblock
11766 #. type: textblock
11767 #: ../src/guestfs-actions.pod:2611 ../fish/guestfish-actions.pod:1776
11768 msgid "Some Red Hat-derived distro."
11769 msgstr ""
11770
11771 # type: =item
11772 #. type: =item
11773 #: ../src/guestfs-actions.pod:2613 ../fish/guestfish-actions.pod:1778
11774 msgid "\"rhel\""
11775 msgstr ""
11776
11777 #. type: textblock
11778 #: ../src/guestfs-actions.pod:2615 ../fish/guestfish-actions.pod:1780
11779 msgid "Red Hat Enterprise Linux."
11780 msgstr ""
11781
11782 #. type: =item
11783 #: ../src/guestfs-actions.pod:2617 ../fish/guestfish-actions.pod:1782
11784 msgid "\"scientificlinux\""
11785 msgstr ""
11786
11787 #. type: textblock
11788 #: ../src/guestfs-actions.pod:2619 ../fish/guestfish-actions.pod:1784
11789 msgid "Scientific Linux."
11790 msgstr ""
11791
11792 #. type: =item
11793 #: ../src/guestfs-actions.pod:2621 ../fish/guestfish-actions.pod:1786
11794 msgid "\"slackware\""
11795 msgstr ""
11796
11797 #. type: textblock
11798 #: ../src/guestfs-actions.pod:2623 ../fish/guestfish-actions.pod:1788
11799 msgid "Slackware."
11800 msgstr ""
11801
11802 # type: =item
11803 #. type: =item
11804 #: ../src/guestfs-actions.pod:2625 ../fish/guestfish-actions.pod:1790
11805 msgid "\"ubuntu\""
11806 msgstr ""
11807
11808 # type: textblock
11809 #. type: textblock
11810 #: ../src/guestfs-actions.pod:2627 ../fish/guestfish-actions.pod:1792
11811 msgid "Ubuntu."
11812 msgstr ""
11813
11814 # type: =item
11815 #. type: =item
11816 #: ../src/guestfs-actions.pod:2629 ../src/guestfs-actions.pod:2745
11817 #: ../src/guestfs-actions.pod:3037 ../fish/guestfish-actions.pod:1794
11818 #: ../fish/guestfish-actions.pod:1887 ../fish/guestfish-actions.pod:2112
11819 msgid "\"unknown\""
11820 msgstr ""
11821
11822 # type: textblock
11823 #. type: textblock
11824 #: ../src/guestfs-actions.pod:2631 ../fish/guestfish-actions.pod:1796
11825 msgid "The distro could not be determined."
11826 msgstr ""
11827
11828 # type: =item
11829 #. type: =item
11830 #: ../src/guestfs-actions.pod:2633 ../src/guestfs-actions.pod:3029
11831 #: ../fish/guestfish-actions.pod:1798 ../fish/guestfish-actions.pod:2104
11832 msgid "\"windows\""
11833 msgstr ""
11834
11835 # type: textblock
11836 #. type: textblock
11837 #: ../src/guestfs-actions.pod:2635 ../fish/guestfish-actions.pod:1800
11838 msgid ""
11839 "Windows does not have distributions.  This string is returned if the OS type "
11840 "is Windows."
11841 msgstr ""
11842
11843 # type: textblock
11844 #. type: textblock
11845 #: ../src/guestfs-actions.pod:2640 ../src/guestfs-actions.pod:2751
11846 #: ../src/guestfs-actions.pod:3043 ../fish/guestfish-actions.pod:1805
11847 #: ../fish/guestfish-actions.pod:1893 ../fish/guestfish-actions.pod:2118
11848 msgid ""
11849 "Future versions of libguestfs may return other strings here.  The caller "
11850 "should be prepared to handle any string."
11851 msgstr ""
11852
11853 #. type: =head2
11854 #: ../src/guestfs-actions.pod:2650
11855 msgid "guestfs_inspect_get_drive_mappings"
11856 msgstr ""
11857
11858 #. type: verbatim
11859 #: ../src/guestfs-actions.pod:2652
11860 #, no-wrap
11861 msgid ""
11862 " char **\n"
11863 " guestfs_inspect_get_drive_mappings (guestfs_h *g,\n"
11864 "                                     const char *root);\n"
11865 "\n"
11866 msgstr ""
11867
11868 #. type: textblock
11869 #: ../src/guestfs-actions.pod:2659 ../fish/guestfish-actions.pod:1817
11870 msgid ""
11871 "This call is useful for Windows which uses a primitive system of assigning "
11872 "drive letters (like \"C:\") to partitions.  This inspection API examines the "
11873 "Windows Registry to find out how disks/partitions are mapped to drive "
11874 "letters, and returns a hash table as in the example below:"
11875 msgstr ""
11876
11877 #. type: verbatim
11878 #: ../src/guestfs-actions.pod:2665 ../fish/guestfish-actions.pod:1823
11879 #, no-wrap
11880 msgid ""
11881 " C      =>     /dev/vda2\n"
11882 " E      =>     /dev/vdb1\n"
11883 " F      =>     /dev/vdc1\n"
11884 "\n"
11885 msgstr ""
11886
11887 #. type: textblock
11888 #: ../src/guestfs-actions.pod:2669 ../fish/guestfish-actions.pod:1827
11889 msgid ""
11890 "Note that keys are drive letters.  For Windows, the key is case insensitive "
11891 "and just contains the drive letter, without the customary colon separator "
11892 "character."
11893 msgstr ""
11894
11895 #. type: textblock
11896 #: ../src/guestfs-actions.pod:2673 ../fish/guestfish-actions.pod:1831
11897 msgid ""
11898 "In future we may support other operating systems that also used drive "
11899 "letters, but the keys for those might not be case insensitive and might be "
11900 "longer than 1 character.  For example in OS-9, hard drives were named C<h0>, "
11901 "C<h1> etc."
11902 msgstr ""
11903
11904 #. type: textblock
11905 #: ../src/guestfs-actions.pod:2678 ../fish/guestfish-actions.pod:1836
11906 msgid ""
11907 "For Windows guests, currently only hard drive mappings are returned.  "
11908 "Removable disks (eg. DVD-ROMs) are ignored."
11909 msgstr ""
11910
11911 #. type: textblock
11912 #: ../src/guestfs-actions.pod:2681 ../fish/guestfish-actions.pod:1839
11913 msgid ""
11914 "For guests that do not use drive mappings, or if the drive mappings could "
11915 "not be determined, this returns an empty hash table."
11916 msgstr ""
11917
11918 #. type: textblock
11919 #: ../src/guestfs-actions.pod:2684
11920 msgid ""
11921 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
11922 "C<guestfs_inspect_get_mountpoints>, C<guestfs_inspect_get_filesystems>."
11923 msgstr ""
11924
11925 # type: textblock
11926 #. type: textblock
11927 #: ../src/guestfs-actions.pod:2688 ../src/guestfs-actions.pod:2864
11928 #: ../src/guestfs-actions.pod:3624 ../src/guestfs-actions.pod:4841
11929 #: ../src/guestfs-actions.pod:6783
11930 msgid ""
11931 "This function returns a NULL-terminated array of strings, or NULL if there "
11932 "was an error.  The array of strings will always have length C<2n+1>, where "
11933 "C<n> keys and values alternate, followed by the trailing NULL entry.  I<The "
11934 "caller must free the strings and the array after use>."
11935 msgstr ""
11936
11937 # type: =head2
11938 #. type: =head2
11939 #: ../src/guestfs-actions.pod:2694
11940 msgid "guestfs_inspect_get_filesystems"
11941 msgstr ""
11942
11943 # type: verbatim
11944 #. type: verbatim
11945 #: ../src/guestfs-actions.pod:2696
11946 #, no-wrap
11947 msgid ""
11948 " char **\n"
11949 " guestfs_inspect_get_filesystems (guestfs_h *g,\n"
11950 "                                  const char *root);\n"
11951 "\n"
11952 msgstr ""
11953
11954 # type: textblock
11955 #. type: textblock
11956 #: ../src/guestfs-actions.pod:2703 ../fish/guestfish-actions.pod:1853
11957 msgid ""
11958 "This returns a list of all the filesystems that we think are associated with "
11959 "this operating system.  This includes the root filesystem, other ordinary "
11960 "filesystems, and non-mounted devices like swap partitions."
11961 msgstr ""
11962
11963 # type: textblock
11964 #. type: textblock
11965 #: ../src/guestfs-actions.pod:2708 ../fish/guestfish-actions.pod:1858
11966 msgid ""
11967 "In the case of a multi-boot virtual machine, it is possible for a filesystem "
11968 "to be shared between operating systems."
11969 msgstr ""
11970
11971 # type: textblock
11972 #. type: textblock
11973 #: ../src/guestfs-actions.pod:2711
11974 msgid ""
11975 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
11976 "C<guestfs_inspect_get_mountpoints>."
11977 msgstr ""
11978
11979 #. type: =head2
11980 #: ../src/guestfs-actions.pod:2720
11981 msgid "guestfs_inspect_get_format"
11982 msgstr ""
11983
11984 #. type: verbatim
11985 #: ../src/guestfs-actions.pod:2722
11986 #, no-wrap
11987 msgid ""
11988 " char *\n"
11989 " guestfs_inspect_get_format (guestfs_h *g,\n"
11990 "                             const char *root);\n"
11991 "\n"
11992 msgstr ""
11993
11994 #. type: textblock
11995 #: ../src/guestfs-actions.pod:2729 ../fish/guestfish-actions.pod:1871
11996 msgid ""
11997 "This returns the format of the inspected operating system.  You can use it "
11998 "to detect install images, live CDs and similar."
11999 msgstr ""
12000
12001 #. type: textblock
12002 #: ../src/guestfs-actions.pod:2732 ../fish/guestfish-actions.pod:1874
12003 msgid "Currently defined formats are:"
12004 msgstr ""
12005
12006 #. type: =item
12007 #: ../src/guestfs-actions.pod:2736 ../fish/guestfish-actions.pod:1878
12008 msgid "\"installed\""
12009 msgstr ""
12010
12011 #. type: textblock
12012 #: ../src/guestfs-actions.pod:2738 ../fish/guestfish-actions.pod:1880
12013 msgid "This is an installed operating system."
12014 msgstr ""
12015
12016 #. type: =item
12017 #: ../src/guestfs-actions.pod:2740 ../fish/guestfish-actions.pod:1882
12018 msgid "\"installer\""
12019 msgstr ""
12020
12021 #. type: textblock
12022 #: ../src/guestfs-actions.pod:2742 ../fish/guestfish-actions.pod:1884
12023 msgid ""
12024 "The disk image being inspected is not an installed operating system, but a "
12025 "I<bootable> install disk, live CD, or similar."
12026 msgstr ""
12027
12028 #. type: textblock
12029 #: ../src/guestfs-actions.pod:2747 ../fish/guestfish-actions.pod:1889
12030 msgid "The format of this disk image is not known."
12031 msgstr ""
12032
12033 # type: =head2
12034 #. type: =head2
12035 #: ../src/guestfs-actions.pod:2759
12036 msgid "guestfs_inspect_get_hostname"
12037 msgstr ""
12038
12039 # type: verbatim
12040 #. type: verbatim
12041 #: ../src/guestfs-actions.pod:2761
12042 #, no-wrap
12043 msgid ""
12044 " char *\n"
12045 " guestfs_inspect_get_hostname (guestfs_h *g,\n"
12046 "                               const char *root);\n"
12047 "\n"
12048 msgstr ""
12049
12050 # type: textblock
12051 #. type: textblock
12052 #: ../src/guestfs-actions.pod:2768 ../fish/guestfish-actions.pod:1905
12053 msgid ""
12054 "This function returns the hostname of the operating system as found by "
12055 "inspection of the guest's configuration files."
12056 msgstr ""
12057
12058 # type: textblock
12059 #. type: textblock
12060 #: ../src/guestfs-actions.pod:2771 ../fish/guestfish-actions.pod:1908
12061 msgid ""
12062 "If the hostname could not be determined, then the string C<unknown> is "
12063 "returned."
12064 msgstr ""
12065
12066 # type: textblock
12067 #. type: textblock
12068 #: ../src/guestfs-actions.pod:2779
12069 msgid "(Added in 1.7.9)"
12070 msgstr ""
12071
12072 # type: =head2
12073 #. type: =head2
12074 #: ../src/guestfs-actions.pod:2781
12075 msgid "guestfs_inspect_get_major_version"
12076 msgstr ""
12077
12078 # type: verbatim
12079 #. type: verbatim
12080 #: ../src/guestfs-actions.pod:2783
12081 #, no-wrap
12082 msgid ""
12083 " int\n"
12084 " guestfs_inspect_get_major_version (guestfs_h *g,\n"
12085 "                                    const char *root);\n"
12086 "\n"
12087 msgstr ""
12088
12089 # type: textblock
12090 #. type: textblock
12091 #: ../src/guestfs-actions.pod:2790 ../fish/guestfish-actions.pod:1920
12092 msgid ""
12093 "This returns the major version number of the inspected operating system."
12094 msgstr ""
12095
12096 # type: textblock
12097 #. type: textblock
12098 #: ../src/guestfs-actions.pod:2793 ../fish/guestfish-actions.pod:1923
12099 msgid ""
12100 "Windows uses a consistent versioning scheme which is I<not> reflected in the "
12101 "popular public names used by the operating system.  Notably the operating "
12102 "system known as \"Windows 7\" is really version 6.1 (ie. major = 6, minor = "
12103 "1).  You can find out the real versions corresponding to releases of Windows "
12104 "by consulting Wikipedia or MSDN."
12105 msgstr ""
12106
12107 # type: textblock
12108 #. type: textblock
12109 #: ../src/guestfs-actions.pod:2800 ../src/guestfs-actions.pod:2820
12110 #: ../fish/guestfish-actions.pod:1930 ../fish/guestfish-actions.pod:1944
12111 msgid "If the version could not be determined, then C<0> is returned."
12112 msgstr ""
12113
12114 # type: =head2
12115 #. type: =head2
12116 #: ../src/guestfs-actions.pod:2808
12117 msgid "guestfs_inspect_get_minor_version"
12118 msgstr ""
12119
12120 # type: verbatim
12121 #. type: verbatim
12122 #: ../src/guestfs-actions.pod:2810
12123 #, no-wrap
12124 msgid ""
12125 " int\n"
12126 " guestfs_inspect_get_minor_version (guestfs_h *g,\n"
12127 "                                    const char *root);\n"
12128 "\n"
12129 msgstr ""
12130
12131 # type: textblock
12132 #. type: textblock
12133 #: ../src/guestfs-actions.pod:2817 ../fish/guestfish-actions.pod:1941
12134 msgid ""
12135 "This returns the minor version number of the inspected operating system."
12136 msgstr ""
12137
12138 # type: textblock
12139 #. type: textblock
12140 #: ../src/guestfs-actions.pod:2822
12141 msgid ""
12142 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
12143 "C<guestfs_inspect_get_major_version>."
12144 msgstr ""
12145
12146 # type: =head2
12147 #. type: =head2
12148 #: ../src/guestfs-actions.pod:2829
12149 msgid "guestfs_inspect_get_mountpoints"
12150 msgstr ""
12151
12152 # type: verbatim
12153 #. type: verbatim
12154 #: ../src/guestfs-actions.pod:2831
12155 #, no-wrap
12156 msgid ""
12157 " char **\n"
12158 " guestfs_inspect_get_mountpoints (guestfs_h *g,\n"
12159 "                                  const char *root);\n"
12160 "\n"
12161 msgstr ""
12162
12163 #. type: textblock
12164 #: ../src/guestfs-actions.pod:2838 ../fish/guestfish-actions.pod:1956
12165 msgid ""
12166 "This returns a hash of where we think the filesystems associated with this "
12167 "operating system should be mounted.  Callers should note that this is at "
12168 "best an educated guess made by reading configuration files such as C</etc/"
12169 "fstab>.  I<In particular note> that this may return filesystems which are "
12170 "non-existent or not mountable and callers should be prepared to handle or "
12171 "ignore failures if they try to mount them."
12172 msgstr ""
12173
12174 # type: textblock
12175 #. type: textblock
12176 #: ../src/guestfs-actions.pod:2847 ../fish/guestfish-actions.pod:1965
12177 msgid ""
12178 "Each element in the returned hashtable has a key which is the path of the "
12179 "mountpoint (eg. C</boot>) and a value which is the filesystem that would be "
12180 "mounted there (eg. C</dev/sda1>)."
12181 msgstr ""
12182
12183 # type: textblock
12184 #. type: textblock
12185 #: ../src/guestfs-actions.pod:2852 ../fish/guestfish-actions.pod:1970
12186 msgid ""
12187 "Non-mounted devices such as swap devices are I<not> returned in this list."
12188 msgstr ""
12189
12190 #. type: textblock
12191 #: ../src/guestfs-actions.pod:2855
12192 msgid ""
12193 "For operating systems like Windows which still use drive letters, this call "
12194 "will only return an entry for the first drive \"mounted on\" C</>.  For "
12195 "information about the mapping of drive letters to partitions, see "
12196 "C<guestfs_inspect_get_drive_mappings>."
12197 msgstr ""
12198
12199 # type: textblock
12200 #. type: textblock
12201 #: ../src/guestfs-actions.pod:2861
12202 msgid ""
12203 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
12204 "C<guestfs_inspect_get_filesystems>."
12205 msgstr ""
12206
12207 # type: =head2
12208 #. type: =head2
12209 #: ../src/guestfs-actions.pod:2872
12210 msgid "guestfs_inspect_get_package_format"
12211 msgstr ""
12212
12213 # type: verbatim
12214 #. type: verbatim
12215 #: ../src/guestfs-actions.pod:2874
12216 #, no-wrap
12217 msgid ""
12218 " char *\n"
12219 " guestfs_inspect_get_package_format (guestfs_h *g,\n"
12220 "                                     const char *root);\n"
12221 "\n"
12222 msgstr ""
12223
12224 # type: textblock
12225 #. type: textblock
12226 #: ../src/guestfs-actions.pod:2881
12227 msgid ""
12228 "This function and C<guestfs_inspect_get_package_management> return the "
12229 "package format and package management tool used by the inspected operating "
12230 "system.  For example for Fedora these functions would return C<rpm> (package "
12231 "format) and C<yum> (package management)."
12232 msgstr ""
12233
12234 # type: textblock
12235 #. type: textblock
12236 #: ../src/guestfs-actions.pod:2887 ../fish/guestfish-actions.pod:1995
12237 msgid ""
12238 "This returns the string C<unknown> if we could not determine the package "
12239 "format I<or> if the operating system does not have a real packaging system "
12240 "(eg. Windows)."
12241 msgstr ""
12242
12243 # type: textblock
12244 #. type: textblock
12245 #: ../src/guestfs-actions.pod:2891 ../fish/guestfish-actions.pod:1999
12246 msgid ""
12247 "Possible strings include: C<rpm>, C<deb>, C<ebuild>, C<pisi>, C<pacman>.  "
12248 "Future versions of libguestfs may return other strings."
12249 msgstr ""
12250
12251 # type: textblock
12252 #. type: textblock
12253 #: ../src/guestfs-actions.pod:2899 ../src/guestfs-actions.pod:2930
12254 msgid "(Added in 1.7.5)"
12255 msgstr ""
12256
12257 # type: =head2
12258 #. type: =head2
12259 #: ../src/guestfs-actions.pod:2901
12260 msgid "guestfs_inspect_get_package_management"
12261 msgstr ""
12262
12263 # type: verbatim
12264 #. type: verbatim
12265 #: ../src/guestfs-actions.pod:2903
12266 #, no-wrap
12267 msgid ""
12268 " char *\n"
12269 " guestfs_inspect_get_package_management (guestfs_h *g,\n"
12270 "                                         const char *root);\n"
12271 "\n"
12272 msgstr ""
12273
12274 # type: textblock
12275 #. type: textblock
12276 #: ../src/guestfs-actions.pod:2910
12277 msgid ""
12278 "C<guestfs_inspect_get_package_format> and this function return the package "
12279 "format and package management tool used by the inspected operating system.  "
12280 "For example for Fedora these functions would return C<rpm> (package format) "
12281 "and C<yum> (package management)."
12282 msgstr ""
12283
12284 # type: textblock
12285 #. type: textblock
12286 #: ../src/guestfs-actions.pod:2916 ../fish/guestfish-actions.pod:2017
12287 msgid ""
12288 "This returns the string C<unknown> if we could not determine the package "
12289 "management tool I<or> if the operating system does not have a real packaging "
12290 "system (eg. Windows)."
12291 msgstr ""
12292
12293 # type: textblock
12294 #. type: textblock
12295 #: ../src/guestfs-actions.pod:2920 ../fish/guestfish-actions.pod:2021
12296 msgid ""
12297 "Possible strings include: C<yum>, C<up2date>, C<apt> (for all Debian "
12298 "derivatives), C<portage>, C<pisi>, C<pacman>, C<urpmi>.  Future versions of "
12299 "libguestfs may return other strings."
12300 msgstr ""
12301
12302 # type: =head2
12303 #. type: =head2
12304 #: ../src/guestfs-actions.pod:2932
12305 msgid "guestfs_inspect_get_product_name"
12306 msgstr ""
12307
12308 # type: verbatim
12309 #. type: verbatim
12310 #: ../src/guestfs-actions.pod:2934
12311 #, no-wrap
12312 msgid ""
12313 " char *\n"
12314 " guestfs_inspect_get_product_name (guestfs_h *g,\n"
12315 "                                   const char *root);\n"
12316 "\n"
12317 msgstr ""
12318
12319 # type: textblock
12320 #. type: textblock
12321 #: ../src/guestfs-actions.pod:2941 ../fish/guestfish-actions.pod:2035
12322 msgid ""
12323 "This returns the product name of the inspected operating system.  The "
12324 "product name is generally some freeform string which can be displayed to the "
12325 "user, but should not be parsed by programs."
12326 msgstr ""
12327
12328 # type: textblock
12329 #. type: textblock
12330 #: ../src/guestfs-actions.pod:2946 ../fish/guestfish-actions.pod:2040
12331 msgid ""
12332 "If the product name could not be determined, then the string C<unknown> is "
12333 "returned."
12334 msgstr ""
12335
12336 #. type: =head2
12337 #: ../src/guestfs-actions.pod:2956
12338 msgid "guestfs_inspect_get_product_variant"
12339 msgstr ""
12340
12341 #. type: verbatim
12342 #: ../src/guestfs-actions.pod:2958
12343 #, no-wrap
12344 msgid ""
12345 " char *\n"
12346 " guestfs_inspect_get_product_variant (guestfs_h *g,\n"
12347 "                                      const char *root);\n"
12348 "\n"
12349 msgstr ""
12350
12351 #. type: textblock
12352 #: ../src/guestfs-actions.pod:2965 ../fish/guestfish-actions.pod:2052
12353 msgid "This returns the product variant of the inspected operating system."
12354 msgstr ""
12355
12356 #. type: textblock
12357 #: ../src/guestfs-actions.pod:2968 ../fish/guestfish-actions.pod:2055
12358 msgid ""
12359 "For Windows guests, this returns the contents of the Registry key C<HKLM"
12360 "\\Software\\Microsoft\\Windows NT\\CurrentVersion> C<InstallationType> which "
12361 "is usually a string such as C<Client> or C<Server> (other values are "
12362 "possible).  This can be used to distinguish consumer and enterprise versions "
12363 "of Windows that have the same version number (for example, Windows 7 and "
12364 "Windows 2008 Server are both version 6.1, but the former is C<Client> and "
12365 "the latter is C<Server>)."
12366 msgstr ""
12367
12368 #. type: textblock
12369 #: ../src/guestfs-actions.pod:2977 ../fish/guestfish-actions.pod:2064
12370 msgid ""
12371 "For enterprise Linux guests, in future we intend this to return the product "
12372 "variant such as C<Desktop>, C<Server> and so on.  But this is not "
12373 "implemented at present."
12374 msgstr ""
12375
12376 #. type: textblock
12377 #: ../src/guestfs-actions.pod:2981 ../fish/guestfish-actions.pod:2068
12378 msgid ""
12379 "If the product variant could not be determined, then the string C<unknown> "
12380 "is returned."
12381 msgstr ""
12382
12383 #. type: textblock
12384 #: ../src/guestfs-actions.pod:2984
12385 msgid ""
12386 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
12387 "C<guestfs_inspect_get_product_name>, C<guestfs_inspect_get_major_version>."
12388 msgstr ""
12389
12390 # type: =head2
12391 #. type: =head2
12392 #: ../src/guestfs-actions.pod:2991
12393 msgid "guestfs_inspect_get_roots"
12394 msgstr ""
12395
12396 # type: verbatim
12397 #. type: verbatim
12398 #: ../src/guestfs-actions.pod:2993
12399 #, no-wrap
12400 msgid ""
12401 " char **\n"
12402 " guestfs_inspect_get_roots (guestfs_h *g);\n"
12403 "\n"
12404 msgstr ""
12405
12406 # type: textblock
12407 #. type: textblock
12408 #: ../src/guestfs-actions.pod:2996
12409 msgid ""
12410 "This function is a convenient way to get the list of root devices, as "
12411 "returned from a previous call to C<guestfs_inspect_os>, but without redoing "
12412 "the whole inspection process."
12413 msgstr ""
12414
12415 # type: textblock
12416 #. type: textblock
12417 #: ../src/guestfs-actions.pod:3000
12418 msgid ""
12419 "This returns an empty list if either no root devices were found or the "
12420 "caller has not called C<guestfs_inspect_os>."
12421 msgstr ""
12422
12423 # type: textblock
12424 #. type: textblock
12425 #: ../src/guestfs-actions.pod:3009
12426 msgid "(Added in 1.7.3)"
12427 msgstr ""
12428
12429 # type: =head2
12430 #. type: =head2
12431 #: ../src/guestfs-actions.pod:3011
12432 msgid "guestfs_inspect_get_type"
12433 msgstr ""
12434
12435 # type: verbatim
12436 #. type: verbatim
12437 #: ../src/guestfs-actions.pod:3013
12438 #, no-wrap
12439 msgid ""
12440 " char *\n"
12441 " guestfs_inspect_get_type (guestfs_h *g,\n"
12442 "                           const char *root);\n"
12443 "\n"
12444 msgstr ""
12445
12446 # type: textblock
12447 #. type: textblock
12448 #: ../src/guestfs-actions.pod:3020 ../fish/guestfish-actions.pod:2095
12449 msgid ""
12450 "This returns the type of the inspected operating system.  Currently defined "
12451 "types are:"
12452 msgstr ""
12453
12454 # type: =item
12455 #. type: =item
12456 #: ../src/guestfs-actions.pod:3025 ../fish/guestfish-actions.pod:2100
12457 msgid "\"linux\""
12458 msgstr ""
12459
12460 # type: textblock
12461 #. type: textblock
12462 #: ../src/guestfs-actions.pod:3027 ../fish/guestfish-actions.pod:2102
12463 msgid "Any Linux-based operating system."
12464 msgstr ""
12465
12466 # type: textblock
12467 #. type: textblock
12468 #: ../src/guestfs-actions.pod:3031 ../fish/guestfish-actions.pod:2106
12469 msgid "Any Microsoft Windows operating system."
12470 msgstr ""
12471
12472 # type: =item
12473 #. type: =item
12474 #: ../src/guestfs-actions.pod:3033 ../fish/guestfish-actions.pod:2108
12475 msgid "\"freebsd\""
12476 msgstr ""
12477
12478 # type: textblock
12479 #. type: textblock
12480 #: ../src/guestfs-actions.pod:3035 ../fish/guestfish-actions.pod:2110
12481 msgid "FreeBSD."
12482 msgstr ""
12483
12484 # type: textblock
12485 #. type: textblock
12486 #: ../src/guestfs-actions.pod:3039 ../fish/guestfish-actions.pod:2114
12487 msgid "The operating system type could not be determined."
12488 msgstr ""
12489
12490 #. type: =head2
12491 #: ../src/guestfs-actions.pod:3053
12492 msgid "guestfs_inspect_get_windows_current_control_set"
12493 msgstr ""
12494
12495 #. type: verbatim
12496 #: ../src/guestfs-actions.pod:3055
12497 #, no-wrap
12498 msgid ""
12499 " char *\n"
12500 " guestfs_inspect_get_windows_current_control_set (guestfs_h *g,\n"
12501 "                                                  const char *root);\n"
12502 "\n"
12503 msgstr ""
12504
12505 #. type: textblock
12506 #: ../src/guestfs-actions.pod:3062 ../fish/guestfish-actions.pod:2130
12507 msgid ""
12508 "This returns the Windows CurrentControlSet of the inspected guest.  The "
12509 "CurrentControlSet is a registry key name such as C<ControlSet001>."
12510 msgstr ""
12511
12512 #. type: textblock
12513 #: ../src/guestfs-actions.pod:3065 ../fish/guestfish-actions.pod:2133
12514 msgid ""
12515 "This call assumes that the guest is Windows and that the Registry could be "
12516 "examined by inspection.  If this is not the case then an error is returned."
12517 msgstr ""
12518
12519 # type: =head2
12520 #. type: =head2
12521 #: ../src/guestfs-actions.pod:3074
12522 msgid "guestfs_inspect_get_windows_systemroot"
12523 msgstr ""
12524
12525 # type: verbatim
12526 #. type: verbatim
12527 #: ../src/guestfs-actions.pod:3076
12528 #, no-wrap
12529 msgid ""
12530 " char *\n"
12531 " guestfs_inspect_get_windows_systemroot (guestfs_h *g,\n"
12532 "                                         const char *root);\n"
12533 "\n"
12534 msgstr ""
12535
12536 # type: textblock
12537 #. type: textblock
12538 #: ../src/guestfs-actions.pod:3083 ../fish/guestfish-actions.pod:2146
12539 msgid ""
12540 "This returns the Windows systemroot of the inspected guest.  The systemroot "
12541 "is a directory path such as C</WINDOWS>."
12542 msgstr ""
12543
12544 # type: textblock
12545 #. type: textblock
12546 #: ../src/guestfs-actions.pod:3086 ../fish/guestfish-actions.pod:2149
12547 msgid ""
12548 "This call assumes that the guest is Windows and that the systemroot could be "
12549 "determined by inspection.  If this is not the case then an error is returned."
12550 msgstr ""
12551
12552 # type: textblock
12553 #. type: textblock
12554 #: ../src/guestfs-actions.pod:3095
12555 msgid "(Added in 1.5.25)"
12556 msgstr ""
12557
12558 #. type: =head2
12559 #: ../src/guestfs-actions.pod:3097
12560 msgid "guestfs_inspect_is_live"
12561 msgstr ""
12562
12563 #. type: verbatim
12564 #: ../src/guestfs-actions.pod:3099
12565 #, no-wrap
12566 msgid ""
12567 " int\n"
12568 " guestfs_inspect_is_live (guestfs_h *g,\n"
12569 "                          const char *root);\n"
12570 "\n"
12571 msgstr ""
12572
12573 #. type: textblock
12574 #: ../src/guestfs-actions.pod:3106
12575 msgid ""
12576 "If C<guestfs_inspect_get_format> returns C<installer> (this is an install "
12577 "disk), then this returns true if a live image was detected on the disk."
12578 msgstr ""
12579
12580 #. type: =head2
12581 #: ../src/guestfs-actions.pod:3114
12582 msgid "guestfs_inspect_is_multipart"
12583 msgstr ""
12584
12585 #. type: verbatim
12586 #: ../src/guestfs-actions.pod:3116
12587 #, no-wrap
12588 msgid ""
12589 " int\n"
12590 " guestfs_inspect_is_multipart (guestfs_h *g,\n"
12591 "                               const char *root);\n"
12592 "\n"
12593 msgstr ""
12594
12595 #. type: textblock
12596 #: ../src/guestfs-actions.pod:3123
12597 msgid ""
12598 "If C<guestfs_inspect_get_format> returns C<installer> (this is an install "
12599 "disk), then this returns true if the disk is part of a set."
12600 msgstr ""
12601
12602 #. type: =head2
12603 #: ../src/guestfs-actions.pod:3131
12604 msgid "guestfs_inspect_is_netinst"
12605 msgstr ""
12606
12607 #. type: verbatim
12608 #: ../src/guestfs-actions.pod:3133
12609 #, no-wrap
12610 msgid ""
12611 " int\n"
12612 " guestfs_inspect_is_netinst (guestfs_h *g,\n"
12613 "                             const char *root);\n"
12614 "\n"
12615 msgstr ""
12616
12617 #. type: textblock
12618 #: ../src/guestfs-actions.pod:3140
12619 msgid ""
12620 "If C<guestfs_inspect_get_format> returns C<installer> (this is an install "
12621 "disk), then this returns true if the disk is a network installer, ie. not a "
12622 "self-contained install CD but one which is likely to require network access "
12623 "to complete the install."
12624 msgstr ""
12625
12626 # type: =head2
12627 #. type: =head2
12628 #: ../src/guestfs-actions.pod:3150
12629 msgid "guestfs_inspect_list_applications"
12630 msgstr ""
12631
12632 # type: verbatim
12633 #. type: verbatim
12634 #: ../src/guestfs-actions.pod:3152
12635 #, no-wrap
12636 msgid ""
12637 " struct guestfs_application_list *\n"
12638 " guestfs_inspect_list_applications (guestfs_h *g,\n"
12639 "                                    const char *root);\n"
12640 "\n"
12641 msgstr ""
12642
12643 # type: textblock
12644 #. type: textblock
12645 #: ../src/guestfs-actions.pod:3159 ../fish/guestfish-actions.pod:2203
12646 msgid "Return the list of applications installed in the operating system."
12647 msgstr ""
12648
12649 # type: textblock
12650 #. type: textblock
12651 #: ../src/guestfs-actions.pod:3161
12652 msgid ""
12653 "I<Note:> This call works differently from other parts of the inspection "
12654 "API.  You have to call C<guestfs_inspect_os>, then "
12655 "C<guestfs_inspect_get_mountpoints>, then mount up the disks, before calling "
12656 "this.  Listing applications is a significantly more difficult operation "
12657 "which requires access to the full filesystem.  Also note that unlike the "
12658 "other C<guestfs_inspect_get_*> calls which are just returning data cached in "
12659 "the libguestfs handle, this call actually reads parts of the mounted "
12660 "filesystems during the call."
12661 msgstr ""
12662
12663 # type: textblock
12664 #. type: textblock
12665 #: ../src/guestfs-actions.pod:3171 ../fish/guestfish-actions.pod:2215
12666 msgid ""
12667 "This returns an empty list if the inspection code was not able to determine "
12668 "the list of applications."
12669 msgstr ""
12670
12671 # type: textblock
12672 #. type: textblock
12673 #: ../src/guestfs-actions.pod:3174 ../fish/guestfish-actions.pod:2218
12674 msgid "The application structure contains the following fields:"
12675 msgstr ""
12676
12677 # type: =item
12678 #. type: =item
12679 #: ../src/guestfs-actions.pod:3178 ../fish/guestfish-actions.pod:2222
12680 msgid "C<app_name>"
12681 msgstr ""
12682
12683 # type: textblock
12684 #. type: textblock
12685 #: ../src/guestfs-actions.pod:3180 ../fish/guestfish-actions.pod:2224
12686 msgid ""
12687 "The name of the application.  For Red Hat-derived and Debian-derived Linux "
12688 "guests, this is the package name."
12689 msgstr ""
12690
12691 # type: =item
12692 #. type: =item
12693 #: ../src/guestfs-actions.pod:3183 ../fish/guestfish-actions.pod:2227
12694 msgid "C<app_display_name>"
12695 msgstr ""
12696
12697 # type: textblock
12698 #. type: textblock
12699 #: ../src/guestfs-actions.pod:3185 ../fish/guestfish-actions.pod:2229
12700 msgid ""
12701 "The display name of the application, sometimes localized to the install "
12702 "language of the guest operating system."
12703 msgstr ""
12704
12705 # type: textblock
12706 #. type: textblock
12707 #: ../src/guestfs-actions.pod:3188 ../fish/guestfish-actions.pod:2232
12708 msgid ""
12709 "If unavailable this is returned as an empty string C<\"\">.  Callers needing "
12710 "to display something can use C<app_name> instead."
12711 msgstr ""
12712
12713 # type: =item
12714 #. type: =item
12715 #: ../src/guestfs-actions.pod:3191 ../fish/guestfish-actions.pod:2235
12716 msgid "C<app_epoch>"
12717 msgstr ""
12718
12719 # type: textblock
12720 #. type: textblock
12721 #: ../src/guestfs-actions.pod:3193 ../fish/guestfish-actions.pod:2237
12722 msgid ""
12723 "For package managers which use epochs, this contains the epoch of the "
12724 "package (an integer).  If unavailable, this is returned as C<0>."
12725 msgstr ""
12726
12727 # type: =item
12728 #. type: =item
12729 #: ../src/guestfs-actions.pod:3196 ../fish/guestfish-actions.pod:2240
12730 msgid "C<app_version>"
12731 msgstr ""
12732
12733 # type: textblock
12734 #. type: textblock
12735 #: ../src/guestfs-actions.pod:3198 ../fish/guestfish-actions.pod:2242
12736 msgid ""
12737 "The version string of the application or package.  If unavailable this is "
12738 "returned as an empty string C<\"\">."
12739 msgstr ""
12740
12741 # type: =item
12742 #. type: =item
12743 #: ../src/guestfs-actions.pod:3201 ../fish/guestfish-actions.pod:2245
12744 msgid "C<app_release>"
12745 msgstr ""
12746
12747 # type: textblock
12748 #. type: textblock
12749 #: ../src/guestfs-actions.pod:3203 ../fish/guestfish-actions.pod:2247
12750 msgid ""
12751 "The release string of the application or package, for package managers that "
12752 "use this.  If unavailable this is returned as an empty string C<\"\">."
12753 msgstr ""
12754
12755 # type: =item
12756 #. type: =item
12757 #: ../src/guestfs-actions.pod:3207 ../fish/guestfish-actions.pod:2251
12758 msgid "C<app_install_path>"
12759 msgstr ""
12760
12761 # type: textblock
12762 #. type: textblock
12763 #: ../src/guestfs-actions.pod:3209 ../fish/guestfish-actions.pod:2253
12764 msgid ""
12765 "The installation path of the application (on operating systems such as "
12766 "Windows which use installation paths).  This path is in the format used by "
12767 "the guest operating system, it is not a libguestfs path."
12768 msgstr ""
12769
12770 # type: textblock
12771 #. type: textblock
12772 #: ../src/guestfs-actions.pod:3214 ../fish/guestfish-actions.pod:2258
12773 msgid "If unavailable this is returned as an empty string C<\"\">."
12774 msgstr ""
12775
12776 # type: =item
12777 #. type: =item
12778 #: ../src/guestfs-actions.pod:3216 ../fish/guestfish-actions.pod:2260
12779 msgid "C<app_trans_path>"
12780 msgstr ""
12781
12782 # type: textblock
12783 #. type: textblock
12784 #: ../src/guestfs-actions.pod:3218 ../fish/guestfish-actions.pod:2262
12785 msgid ""
12786 "The install path translated into a libguestfs path.  If unavailable this is "
12787 "returned as an empty string C<\"\">."
12788 msgstr ""
12789
12790 # type: =item
12791 #. type: =item
12792 #: ../src/guestfs-actions.pod:3221 ../fish/guestfish-actions.pod:2265
12793 msgid "C<app_publisher>"
12794 msgstr ""
12795
12796 # type: textblock
12797 #. type: textblock
12798 #: ../src/guestfs-actions.pod:3223 ../fish/guestfish-actions.pod:2267
12799 msgid ""
12800 "The name of the publisher of the application, for package managers that use "
12801 "this.  If unavailable this is returned as an empty string C<\"\">."
12802 msgstr ""
12803
12804 # type: =item
12805 #. type: =item
12806 #: ../src/guestfs-actions.pod:3227 ../fish/guestfish-actions.pod:2271
12807 msgid "C<app_url>"
12808 msgstr ""
12809
12810 # type: textblock
12811 #. type: textblock
12812 #: ../src/guestfs-actions.pod:3229 ../fish/guestfish-actions.pod:2273
12813 msgid ""
12814 "The URL (eg. upstream URL) of the application.  If unavailable this is "
12815 "returned as an empty string C<\"\">."
12816 msgstr ""
12817
12818 # type: =item
12819 #. type: =item
12820 #: ../src/guestfs-actions.pod:3232 ../fish/guestfish-actions.pod:2276
12821 msgid "C<app_source_package>"
12822 msgstr ""
12823
12824 # type: textblock
12825 #. type: textblock
12826 #: ../src/guestfs-actions.pod:3234 ../fish/guestfish-actions.pod:2278
12827 msgid ""
12828 "For packaging systems which support this, the name of the source package.  "
12829 "If unavailable this is returned as an empty string C<\"\">."
12830 msgstr ""
12831
12832 # type: =item
12833 #. type: =item
12834 #: ../src/guestfs-actions.pod:3237 ../fish/guestfish-actions.pod:2281
12835 msgid "C<app_summary>"
12836 msgstr ""
12837
12838 # type: textblock
12839 #. type: textblock
12840 #: ../src/guestfs-actions.pod:3239 ../fish/guestfish-actions.pod:2283
12841 msgid ""
12842 "A short (usually one line) description of the application or package.  If "
12843 "unavailable this is returned as an empty string C<\"\">."
12844 msgstr ""
12845
12846 # type: =item
12847 #. type: =item
12848 #: ../src/guestfs-actions.pod:3242 ../fish/guestfish-actions.pod:2286
12849 msgid "C<app_description>"
12850 msgstr ""
12851
12852 # type: textblock
12853 #. type: textblock
12854 #: ../src/guestfs-actions.pod:3244 ../fish/guestfish-actions.pod:2288
12855 msgid ""
12856 "A longer description of the application or package.  If unavailable this is "
12857 "returned as an empty string C<\"\">."
12858 msgstr ""
12859
12860 # type: textblock
12861 #. type: textblock
12862 #: ../src/guestfs-actions.pod:3251
12863 msgid ""
12864 "This function returns a C<struct guestfs_application_list *>, or NULL if "
12865 "there was an error.  I<The caller must call C<guestfs_free_application_list> "
12866 "after use>."
12867 msgstr ""
12868
12869 # type: textblock
12870 #. type: textblock
12871 #: ../src/guestfs-actions.pod:3255
12872 msgid "(Added in 1.7.8)"
12873 msgstr ""
12874
12875 # type: =head2
12876 #. type: =head2
12877 #: ../src/guestfs-actions.pod:3257
12878 msgid "guestfs_inspect_os"
12879 msgstr ""
12880
12881 # type: verbatim
12882 #. type: verbatim
12883 #: ../src/guestfs-actions.pod:3259
12884 #, no-wrap
12885 msgid ""
12886 " char **\n"
12887 " guestfs_inspect_os (guestfs_h *g);\n"
12888 "\n"
12889 msgstr ""
12890
12891 # type: textblock
12892 #. type: textblock
12893 #: ../src/guestfs-actions.pod:3262 ../fish/guestfish-actions.pod:2299
12894 msgid ""
12895 "This function uses other libguestfs functions and certain heuristics to "
12896 "inspect the disk(s) (usually disks belonging to a virtual machine), looking "
12897 "for operating systems."
12898 msgstr ""
12899
12900 # type: textblock
12901 #. type: textblock
12902 #: ../src/guestfs-actions.pod:3266 ../fish/guestfish-actions.pod:2303
12903 msgid "The list returned is empty if no operating systems were found."
12904 msgstr ""
12905
12906 # type: textblock
12907 #. type: textblock
12908 #: ../src/guestfs-actions.pod:3268 ../fish/guestfish-actions.pod:2305
12909 msgid ""
12910 "If one operating system was found, then this returns a list with a single "
12911 "element, which is the name of the root filesystem of this operating system.  "
12912 "It is also possible for this function to return a list containing more than "
12913 "one element, indicating a dual-boot or multi-boot virtual machine, with each "
12914 "element being the root filesystem of one of the operating systems."
12915 msgstr ""
12916
12917 # type: textblock
12918 #. type: textblock
12919 #: ../src/guestfs-actions.pod:3275
12920 msgid ""
12921 "You can pass the root string(s) returned to other C<guestfs_inspect_get_*> "
12922 "functions in order to query further information about each operating system, "
12923 "such as the name and version."
12924 msgstr ""
12925
12926 # type: textblock
12927 #. type: textblock
12928 #: ../src/guestfs-actions.pod:3280
12929 msgid ""
12930 "This function uses other libguestfs features such as C<guestfs_mount_ro> and "
12931 "C<guestfs_umount_all> in order to mount and unmount filesystems and look at "
12932 "the contents.  This should be called with no disks currently mounted.  The "
12933 "function may also use Augeas, so any existing Augeas handle will be closed."
12934 msgstr ""
12935
12936 # type: textblock
12937 #. type: textblock
12938 #: ../src/guestfs-actions.pod:3286 ../fish/guestfish-actions.pod:2323
12939 msgid ""
12940 "This function cannot decrypt encrypted disks.  The caller must do that first "
12941 "(supplying the necessary keys) if the disk is encrypted."
12942 msgstr ""
12943
12944 # type: textblock
12945 #. type: textblock
12946 #: ../src/guestfs-actions.pod:3292 ../src/guestfs-actions.pod:3582
12947 #: ../src/guestfs-actions.pod:3644
12948 msgid "See also C<guestfs_list_filesystems>."
12949 msgstr ""
12950
12951 # type: =head2
12952 #. type: =head2
12953 #: ../src/guestfs-actions.pod:3300
12954 msgid "guestfs_is_blockdev"
12955 msgstr ""
12956
12957 # type: verbatim
12958 #. type: verbatim
12959 #: ../src/guestfs-actions.pod:3302
12960 #, no-wrap
12961 msgid ""
12962 " int\n"
12963 " guestfs_is_blockdev (guestfs_h *g,\n"
12964 "                      const char *path);\n"
12965 "\n"
12966 msgstr ""
12967
12968 # type: textblock
12969 #. type: textblock
12970 #: ../src/guestfs-actions.pod:3306 ../fish/guestfish-actions.pod:2335
12971 msgid ""
12972 "This returns C<true> if and only if there is a block device with the given "
12973 "C<path> name."
12974 msgstr ""
12975
12976 # type: textblock
12977 #. type: textblock
12978 #: ../src/guestfs-actions.pod:3309 ../src/guestfs-actions.pod:3338
12979 #: ../src/guestfs-actions.pod:3368 ../src/guestfs-actions.pod:3383
12980 #: ../src/guestfs-actions.pod:3399 ../src/guestfs-actions.pod:3455
12981 #: ../src/guestfs-actions.pod:3470
12982 msgid "See also C<guestfs_stat>."
12983 msgstr ""
12984
12985 # type: textblock
12986 #. type: textblock
12987 #: ../src/guestfs-actions.pod:3313 ../src/guestfs-actions.pod:3342
12988 #: ../src/guestfs-actions.pod:3387 ../src/guestfs-actions.pod:3459
12989 #: ../src/guestfs-actions.pod:3474
12990 msgid "(Added in 1.5.10)"
12991 msgstr ""
12992
12993 # type: =head2
12994 #. type: =head2
12995 #: ../src/guestfs-actions.pod:3315
12996 msgid "guestfs_is_busy"
12997 msgstr ""
12998
12999 # type: verbatim
13000 #. type: verbatim
13001 #: ../src/guestfs-actions.pod:3317
13002 #, no-wrap
13003 msgid ""
13004 " int\n"
13005 " guestfs_is_busy (guestfs_h *g);\n"
13006 "\n"
13007 msgstr ""
13008
13009 # type: textblock
13010 #. type: textblock
13011 #: ../src/guestfs-actions.pod:3320 ../fish/guestfish-actions.pod:2344
13012 msgid ""
13013 "This returns true iff this handle is busy processing a command (in the "
13014 "C<BUSY> state)."
13015 msgstr ""
13016
13017 # type: =head2
13018 #. type: =head2
13019 #: ../src/guestfs-actions.pod:3329
13020 msgid "guestfs_is_chardev"
13021 msgstr ""
13022
13023 # type: verbatim
13024 #. type: verbatim
13025 #: ../src/guestfs-actions.pod:3331
13026 #, no-wrap
13027 msgid ""
13028 " int\n"
13029 " guestfs_is_chardev (guestfs_h *g,\n"
13030 "                     const char *path);\n"
13031 "\n"
13032 msgstr ""
13033
13034 # type: textblock
13035 #. type: textblock
13036 #: ../src/guestfs-actions.pod:3335 ../fish/guestfish-actions.pod:2353
13037 msgid ""
13038 "This returns C<true> if and only if there is a character device with the "
13039 "given C<path> name."
13040 msgstr ""
13041
13042 # type: =head2
13043 #. type: =head2
13044 #: ../src/guestfs-actions.pod:3344
13045 msgid "guestfs_is_config"
13046 msgstr ""
13047
13048 # type: verbatim
13049 #. type: verbatim
13050 #: ../src/guestfs-actions.pod:3346
13051 #, no-wrap
13052 msgid ""
13053 " int\n"
13054 " guestfs_is_config (guestfs_h *g);\n"
13055 "\n"
13056 msgstr ""
13057
13058 # type: textblock
13059 #. type: textblock
13060 #: ../src/guestfs-actions.pod:3349 ../fish/guestfish-actions.pod:2362
13061 msgid ""
13062 "This returns true iff this handle is being configured (in the C<CONFIG> "
13063 "state)."
13064 msgstr ""
13065
13066 # type: =head2
13067 #. type: =head2
13068 #: ../src/guestfs-actions.pod:3358
13069 msgid "guestfs_is_dir"
13070 msgstr ""
13071
13072 # type: verbatim
13073 #. type: verbatim
13074 #: ../src/guestfs-actions.pod:3360
13075 #, no-wrap
13076 msgid ""
13077 " int\n"
13078 " guestfs_is_dir (guestfs_h *g,\n"
13079 "                 const char *path);\n"
13080 "\n"
13081 msgstr ""
13082
13083 # type: textblock
13084 #. type: textblock
13085 #: ../src/guestfs-actions.pod:3364 ../fish/guestfish-actions.pod:2371
13086 msgid ""
13087 "This returns C<true> if and only if there is a directory with the given "
13088 "C<path> name.  Note that it returns false for other objects like files."
13089 msgstr ""
13090
13091 # type: =head2
13092 #. type: =head2
13093 #: ../src/guestfs-actions.pod:3374
13094 msgid "guestfs_is_fifo"
13095 msgstr ""
13096
13097 # type: verbatim
13098 #. type: verbatim
13099 #: ../src/guestfs-actions.pod:3376
13100 #, no-wrap
13101 msgid ""
13102 " int\n"
13103 " guestfs_is_fifo (guestfs_h *g,\n"
13104 "                  const char *path);\n"
13105 "\n"
13106 msgstr ""
13107
13108 # type: textblock
13109 #. type: textblock
13110 #: ../src/guestfs-actions.pod:3380 ../fish/guestfish-actions.pod:2381
13111 msgid ""
13112 "This returns C<true> if and only if there is a FIFO (named pipe)  with the "
13113 "given C<path> name."
13114 msgstr ""
13115
13116 # type: =head2
13117 #. type: =head2
13118 #: ../src/guestfs-actions.pod:3389
13119 msgid "guestfs_is_file"
13120 msgstr ""
13121
13122 # type: verbatim
13123 #. type: verbatim
13124 #: ../src/guestfs-actions.pod:3391
13125 #, no-wrap
13126 msgid ""
13127 " int\n"
13128 " guestfs_is_file (guestfs_h *g,\n"
13129 "                  const char *path);\n"
13130 "\n"
13131 msgstr ""
13132
13133 # type: textblock
13134 #. type: textblock
13135 #: ../src/guestfs-actions.pod:3395 ../fish/guestfish-actions.pod:2390
13136 msgid ""
13137 "This returns C<true> if and only if there is a regular file with the given "
13138 "C<path> name.  Note that it returns false for other objects like directories."
13139 msgstr ""
13140
13141 # type: =head2
13142 #. type: =head2
13143 #: ../src/guestfs-actions.pod:3405
13144 msgid "guestfs_is_launching"
13145 msgstr ""
13146
13147 # type: verbatim
13148 #. type: verbatim
13149 #: ../src/guestfs-actions.pod:3407
13150 #, no-wrap
13151 msgid ""
13152 " int\n"
13153 " guestfs_is_launching (guestfs_h *g);\n"
13154 "\n"
13155 msgstr ""
13156
13157 # type: textblock
13158 #. type: textblock
13159 #: ../src/guestfs-actions.pod:3410 ../fish/guestfish-actions.pod:2400
13160 msgid ""
13161 "This returns true iff this handle is launching the subprocess (in the "
13162 "C<LAUNCHING> state)."
13163 msgstr ""
13164
13165 # type: =head2
13166 #. type: =head2
13167 #: ../src/guestfs-actions.pod:3419
13168 msgid "guestfs_is_lv"
13169 msgstr ""
13170
13171 # type: verbatim
13172 #. type: verbatim
13173 #: ../src/guestfs-actions.pod:3421
13174 #, no-wrap
13175 msgid ""
13176 " int\n"
13177 " guestfs_is_lv (guestfs_h *g,\n"
13178 "                const char *device);\n"
13179 "\n"
13180 msgstr ""
13181
13182 # type: textblock
13183 #. type: textblock
13184 #: ../src/guestfs-actions.pod:3425 ../fish/guestfish-actions.pod:2409
13185 msgid ""
13186 "This command tests whether C<device> is a logical volume, and returns true "
13187 "iff this is the case."
13188 msgstr ""
13189
13190 # type: =head2
13191 #. type: =head2
13192 #: ../src/guestfs-actions.pod:3432
13193 msgid "guestfs_is_ready"
13194 msgstr ""
13195
13196 # type: verbatim
13197 #. type: verbatim
13198 #: ../src/guestfs-actions.pod:3434
13199 #, no-wrap
13200 msgid ""
13201 " int\n"
13202 " guestfs_is_ready (guestfs_h *g);\n"
13203 "\n"
13204 msgstr ""
13205
13206 # type: textblock
13207 #. type: textblock
13208 #: ../src/guestfs-actions.pod:3437 ../fish/guestfish-actions.pod:2416
13209 msgid ""
13210 "This returns true iff this handle is ready to accept commands (in the "
13211 "C<READY> state)."
13212 msgstr ""
13213
13214 # type: =head2
13215 #. type: =head2
13216 #: ../src/guestfs-actions.pod:3446
13217 msgid "guestfs_is_socket"
13218 msgstr ""
13219
13220 # type: verbatim
13221 #. type: verbatim
13222 #: ../src/guestfs-actions.pod:3448
13223 #, no-wrap
13224 msgid ""
13225 " int\n"
13226 " guestfs_is_socket (guestfs_h *g,\n"
13227 "                    const char *path);\n"
13228 "\n"
13229 msgstr ""
13230
13231 # type: textblock
13232 #. type: textblock
13233 #: ../src/guestfs-actions.pod:3452 ../fish/guestfish-actions.pod:2425
13234 msgid ""
13235 "This returns C<true> if and only if there is a Unix domain socket with the "
13236 "given C<path> name."
13237 msgstr ""
13238
13239 # type: =head2
13240 #. type: =head2
13241 #: ../src/guestfs-actions.pod:3461
13242 msgid "guestfs_is_symlink"
13243 msgstr ""
13244
13245 # type: verbatim
13246 #. type: verbatim
13247 #: ../src/guestfs-actions.pod:3463
13248 #, no-wrap
13249 msgid ""
13250 " int\n"
13251 " guestfs_is_symlink (guestfs_h *g,\n"
13252 "                     const char *path);\n"
13253 "\n"
13254 msgstr ""
13255
13256 # type: textblock
13257 #. type: textblock
13258 #: ../src/guestfs-actions.pod:3467 ../fish/guestfish-actions.pod:2434
13259 msgid ""
13260 "This returns C<true> if and only if there is a symbolic link with the given "
13261 "C<path> name."
13262 msgstr ""
13263
13264 # type: =head2
13265 #. type: =head2
13266 #: ../src/guestfs-actions.pod:3476
13267 msgid "guestfs_kill_subprocess"
13268 msgstr ""
13269
13270 # type: verbatim
13271 #. type: verbatim
13272 #: ../src/guestfs-actions.pod:3478
13273 #, no-wrap
13274 msgid ""
13275 " int\n"
13276 " guestfs_kill_subprocess (guestfs_h *g);\n"
13277 "\n"
13278 msgstr ""
13279
13280 # type: textblock
13281 #. type: textblock
13282 #: ../src/guestfs-actions.pod:3481 ../fish/guestfish-actions.pod:2443
13283 msgid "This kills the qemu subprocess.  You should never need to call this."
13284 msgstr ""
13285
13286 # type: =head2
13287 #. type: =head2
13288 #: ../src/guestfs-actions.pod:3487
13289 msgid "guestfs_launch"
13290 msgstr ""
13291
13292 # type: verbatim
13293 #. type: verbatim
13294 #: ../src/guestfs-actions.pod:3489
13295 #, no-wrap
13296 msgid ""
13297 " int\n"
13298 " guestfs_launch (guestfs_h *g);\n"
13299 "\n"
13300 msgstr ""
13301
13302 # type: textblock
13303 #. type: textblock
13304 #: ../src/guestfs-actions.pod:3492 ../fish/guestfish-actions.pod:2451
13305 msgid ""
13306 "Internally libguestfs is implemented by running a virtual machine using "
13307 "L<qemu(1)>."
13308 msgstr ""
13309
13310 # type: textblock
13311 #. type: textblock
13312 #: ../src/guestfs-actions.pod:3495 ../fish/guestfish-actions.pod:2454
13313 msgid ""
13314 "You should call this after configuring the handle (eg. adding drives) but "
13315 "before performing any actions."
13316 msgstr ""
13317
13318 # type: =head2
13319 #. type: =head2
13320 #: ../src/guestfs-actions.pod:3507
13321 msgid "guestfs_lchown"
13322 msgstr ""
13323
13324 # type: verbatim
13325 #. type: verbatim
13326 #: ../src/guestfs-actions.pod:3509
13327 #, no-wrap
13328 msgid ""
13329 " int\n"
13330 " guestfs_lchown (guestfs_h *g,\n"
13331 "                 int owner,\n"
13332 "                 int group,\n"
13333 "                 const char *path);\n"
13334 "\n"
13335 msgstr ""
13336
13337 # type: textblock
13338 #. type: textblock
13339 #: ../src/guestfs-actions.pod:3515
13340 msgid ""
13341 "Change the file owner to C<owner> and group to C<group>.  This is like "
13342 "C<guestfs_chown> but if C<path> is a symlink then the link itself is "
13343 "changed, not the target."
13344 msgstr ""
13345
13346 # type: =head2
13347 #. type: =head2
13348 #: ../src/guestfs-actions.pod:3527
13349 msgid "guestfs_lgetxattr"
13350 msgstr ""
13351
13352 # type: verbatim
13353 #. type: verbatim
13354 #: ../src/guestfs-actions.pod:3529
13355 #, no-wrap
13356 msgid ""
13357 " char *\n"
13358 " guestfs_lgetxattr (guestfs_h *g,\n"
13359 "                    const char *path,\n"
13360 "                    const char *name,\n"
13361 "                    size_t *size_r);\n"
13362 "\n"
13363 msgstr ""
13364
13365 # type: textblock
13366 #. type: textblock
13367 #: ../src/guestfs-actions.pod:3535 ../fish/guestfish-actions.pod:2473
13368 msgid ""
13369 "Get a single extended attribute from file C<path> named C<name>.  If C<path> "
13370 "is a symlink, then this call returns an extended attribute from the symlink."
13371 msgstr ""
13372
13373 # type: textblock
13374 #. type: textblock
13375 #: ../src/guestfs-actions.pod:3549
13376 msgid "See also: C<guestfs_lgetxattrs>, C<guestfs_getxattr>, L<attr(5)>."
13377 msgstr ""
13378
13379 # type: =head2
13380 #. type: =head2
13381 #: ../src/guestfs-actions.pod:3557
13382 msgid "guestfs_lgetxattrs"
13383 msgstr ""
13384
13385 # type: verbatim
13386 #. type: verbatim
13387 #: ../src/guestfs-actions.pod:3559
13388 #, no-wrap
13389 msgid ""
13390 " struct guestfs_xattr_list *\n"
13391 " guestfs_lgetxattrs (guestfs_h *g,\n"
13392 "                     const char *path);\n"
13393 "\n"
13394 msgstr ""
13395
13396 # type: textblock
13397 #. type: textblock
13398 #: ../src/guestfs-actions.pod:3563
13399 msgid ""
13400 "This is the same as C<guestfs_getxattrs>, but if C<path> is a symbolic link, "
13401 "then it returns the extended attributes of the link itself."
13402 msgstr ""
13403
13404 # type: =head2
13405 #. type: =head2
13406 #: ../src/guestfs-actions.pod:3573
13407 msgid "guestfs_list_devices"
13408 msgstr ""
13409
13410 # type: verbatim
13411 #. type: verbatim
13412 #: ../src/guestfs-actions.pod:3575
13413 #, no-wrap
13414 msgid ""
13415 " char **\n"
13416 " guestfs_list_devices (guestfs_h *g);\n"
13417 "\n"
13418 msgstr ""
13419
13420 # type: textblock
13421 #. type: textblock
13422 #: ../src/guestfs-actions.pod:3578 ../fish/guestfish-actions.pod:2501
13423 msgid "List all the block devices."
13424 msgstr ""
13425
13426 # type: textblock
13427 #. type: textblock
13428 #: ../src/guestfs-actions.pod:3580 ../fish/guestfish-actions.pod:2503
13429 msgid "The full block device names are returned, eg. C</dev/sda>."
13430 msgstr ""
13431
13432 # type: =head2
13433 #. type: =head2
13434 #: ../src/guestfs-actions.pod:3590
13435 msgid "guestfs_list_filesystems"
13436 msgstr ""
13437
13438 # type: verbatim
13439 #. type: verbatim
13440 #: ../src/guestfs-actions.pod:3592
13441 #, no-wrap
13442 msgid ""
13443 " char **\n"
13444 " guestfs_list_filesystems (guestfs_h *g);\n"
13445 "\n"
13446 msgstr ""
13447
13448 # type: textblock
13449 #. type: textblock
13450 #: ../src/guestfs-actions.pod:3595 ../fish/guestfish-actions.pod:2511
13451 msgid ""
13452 "This inspection command looks for filesystems on partitions, block devices "
13453 "and logical volumes, returning a list of devices containing filesystems and "
13454 "their type."
13455 msgstr ""
13456
13457 # type: textblock
13458 #. type: textblock
13459 #: ../src/guestfs-actions.pod:3599 ../fish/guestfish-actions.pod:2515
13460 msgid ""
13461 "The return value is a hash, where the keys are the devices containing "
13462 "filesystems, and the values are the filesystem types.  For example:"
13463 msgstr ""
13464
13465 # type: verbatim
13466 #. type: verbatim
13467 #: ../src/guestfs-actions.pod:3603 ../fish/guestfish-actions.pod:2519
13468 #, no-wrap
13469 msgid ""
13470 " \"/dev/sda1\" => \"ntfs\"\n"
13471 " \"/dev/sda2\" => \"ext2\"\n"
13472 " \"/dev/vg_guest/lv_root\" => \"ext4\"\n"
13473 " \"/dev/vg_guest/lv_swap\" => \"swap\"\n"
13474 "\n"
13475 msgstr ""
13476
13477 # type: textblock
13478 #. type: textblock
13479 #: ../src/guestfs-actions.pod:3608 ../fish/guestfish-actions.pod:2524
13480 msgid ""
13481 "The value can have the special value \"unknown\", meaning the content of the "
13482 "device is undetermined or empty.  \"swap\" means a Linux swap partition."
13483 msgstr ""
13484
13485 # type: textblock
13486 #. type: textblock
13487 #: ../src/guestfs-actions.pod:3612
13488 msgid ""
13489 "This command runs other libguestfs commands, which might include "
13490 "C<guestfs_mount> and C<guestfs_umount>, and therefore you should use this "
13491 "soon after launch and only when nothing is mounted."
13492 msgstr ""
13493
13494 # type: textblock
13495 #. type: textblock
13496 #: ../src/guestfs-actions.pod:3616
13497 msgid ""
13498 "Not all of the filesystems returned will be mountable.  In particular, swap "
13499 "partitions are returned in the list.  Also this command does not check that "
13500 "each filesystem found is valid and mountable, and some filesystems might be "
13501 "mountable but require special options.  Filesystems may not all belong to a "
13502 "single logical operating system (use C<guestfs_inspect_os> to look for OSes)."
13503 msgstr ""
13504
13505 # type: textblock
13506 #. type: textblock
13507 #: ../src/guestfs-actions.pod:3630 ../src/guestfs-actions.pod:5251
13508 msgid "(Added in 1.5.15)"
13509 msgstr ""
13510
13511 # type: =head2
13512 #. type: =head2
13513 #: ../src/guestfs-actions.pod:3632
13514 msgid "guestfs_list_partitions"
13515 msgstr ""
13516
13517 # type: verbatim
13518 #. type: verbatim
13519 #: ../src/guestfs-actions.pod:3634
13520 #, no-wrap
13521 msgid ""
13522 " char **\n"
13523 " guestfs_list_partitions (guestfs_h *g);\n"
13524 "\n"
13525 msgstr ""
13526
13527 # type: textblock
13528 #. type: textblock
13529 #: ../src/guestfs-actions.pod:3637 ../fish/guestfish-actions.pod:2544
13530 msgid "List all the partitions detected on all block devices."
13531 msgstr ""
13532
13533 # type: textblock
13534 #. type: textblock
13535 #: ../src/guestfs-actions.pod:3639 ../fish/guestfish-actions.pod:2546
13536 msgid "The full partition device names are returned, eg. C</dev/sda1>"
13537 msgstr ""
13538
13539 # type: textblock
13540 #. type: textblock
13541 #: ../src/guestfs-actions.pod:3641
13542 msgid ""
13543 "This does not return logical volumes.  For that you will need to call "
13544 "C<guestfs_lvs>."
13545 msgstr ""
13546
13547 # type: =head2
13548 #. type: =head2
13549 #: ../src/guestfs-actions.pod:3652
13550 msgid "guestfs_ll"
13551 msgstr ""
13552
13553 # type: verbatim
13554 #. type: verbatim
13555 #: ../src/guestfs-actions.pod:3654
13556 #, no-wrap
13557 msgid ""
13558 " char *\n"
13559 " guestfs_ll (guestfs_h *g,\n"
13560 "             const char *directory);\n"
13561 "\n"
13562 msgstr ""
13563
13564 # type: textblock
13565 #. type: textblock
13566 #: ../src/guestfs-actions.pod:3658 ../fish/guestfish-actions.pod:2557
13567 msgid ""
13568 "List the files in C<directory> (relative to the root directory, there is no "
13569 "cwd) in the format of 'ls -la'."
13570 msgstr ""
13571
13572 # type: textblock
13573 #. type: textblock
13574 #: ../src/guestfs-actions.pod:3661 ../fish/guestfish-actions.pod:2560
13575 msgid ""
13576 "This command is mostly useful for interactive sessions.  It is I<not> "
13577 "intended that you try to parse the output string."
13578 msgstr ""
13579
13580 # type: =head2
13581 #. type: =head2
13582 #: ../src/guestfs-actions.pod:3669
13583 msgid "guestfs_ln"
13584 msgstr ""
13585
13586 # type: verbatim
13587 #. type: verbatim
13588 #: ../src/guestfs-actions.pod:3671
13589 #, no-wrap
13590 msgid ""
13591 " int\n"
13592 " guestfs_ln (guestfs_h *g,\n"
13593 "             const char *target,\n"
13594 "             const char *linkname);\n"
13595 "\n"
13596 msgstr ""
13597
13598 # type: textblock
13599 #. type: textblock
13600 #: ../src/guestfs-actions.pod:3676 ../fish/guestfish-actions.pod:2567
13601 msgid "This command creates a hard link using the C<ln> command."
13602 msgstr ""
13603
13604 # type: =head2
13605 #. type: =head2
13606 #: ../src/guestfs-actions.pod:3682
13607 msgid "guestfs_ln_f"
13608 msgstr ""
13609
13610 # type: verbatim
13611 #. type: verbatim
13612 #: ../src/guestfs-actions.pod:3684
13613 #, no-wrap
13614 msgid ""
13615 " int\n"
13616 " guestfs_ln_f (guestfs_h *g,\n"
13617 "               const char *target,\n"
13618 "               const char *linkname);\n"
13619 "\n"
13620 msgstr ""
13621
13622 #. type: textblock
13623 #: ../src/guestfs-actions.pod:3689 ../fish/guestfish-actions.pod:2573
13624 msgid ""
13625 "This command creates a hard link using the C<ln -f> command.  The I<-f> "
13626 "option removes the link (C<linkname>) if it exists already."
13627 msgstr ""
13628
13629 # type: =head2
13630 #. type: =head2
13631 #: ../src/guestfs-actions.pod:3696
13632 msgid "guestfs_ln_s"
13633 msgstr ""
13634
13635 # type: verbatim
13636 #. type: verbatim
13637 #: ../src/guestfs-actions.pod:3698
13638 #, no-wrap
13639 msgid ""
13640 " int\n"
13641 " guestfs_ln_s (guestfs_h *g,\n"
13642 "               const char *target,\n"
13643 "               const char *linkname);\n"
13644 "\n"
13645 msgstr ""
13646
13647 # type: textblock
13648 #. type: textblock
13649 #: ../src/guestfs-actions.pod:3703 ../fish/guestfish-actions.pod:2580
13650 msgid "This command creates a symbolic link using the C<ln -s> command."
13651 msgstr ""
13652
13653 # type: =head2
13654 #. type: =head2
13655 #: ../src/guestfs-actions.pod:3709
13656 msgid "guestfs_ln_sf"
13657 msgstr ""
13658
13659 # type: verbatim
13660 #. type: verbatim
13661 #: ../src/guestfs-actions.pod:3711
13662 #, no-wrap
13663 msgid ""
13664 " int\n"
13665 " guestfs_ln_sf (guestfs_h *g,\n"
13666 "                const char *target,\n"
13667 "                const char *linkname);\n"
13668 "\n"
13669 msgstr ""
13670
13671 #. type: textblock
13672 #: ../src/guestfs-actions.pod:3716 ../fish/guestfish-actions.pod:2586
13673 msgid ""
13674 "This command creates a symbolic link using the C<ln -sf> command, The I<-f> "
13675 "option removes the link (C<linkname>) if it exists already."
13676 msgstr ""
13677
13678 # type: =head2
13679 #. type: =head2
13680 #: ../src/guestfs-actions.pod:3723
13681 msgid "guestfs_lremovexattr"
13682 msgstr ""
13683
13684 # type: verbatim
13685 #. type: verbatim
13686 #: ../src/guestfs-actions.pod:3725
13687 #, no-wrap
13688 msgid ""
13689 " int\n"
13690 " guestfs_lremovexattr (guestfs_h *g,\n"
13691 "                       const char *xattr,\n"
13692 "                       const char *path);\n"
13693 "\n"
13694 msgstr ""
13695
13696 # type: textblock
13697 #. type: textblock
13698 #: ../src/guestfs-actions.pod:3730
13699 msgid ""
13700 "This is the same as C<guestfs_removexattr>, but if C<path> is a symbolic "
13701 "link, then it removes an extended attribute of the link itself."
13702 msgstr ""
13703
13704 # type: =head2
13705 #. type: =head2
13706 #: ../src/guestfs-actions.pod:3738
13707 msgid "guestfs_ls"
13708 msgstr ""
13709
13710 # type: verbatim
13711 #. type: verbatim
13712 #: ../src/guestfs-actions.pod:3740
13713 #, no-wrap
13714 msgid ""
13715 " char **\n"
13716 " guestfs_ls (guestfs_h *g,\n"
13717 "             const char *directory);\n"
13718 "\n"
13719 msgstr ""
13720
13721 # type: textblock
13722 #. type: textblock
13723 #: ../src/guestfs-actions.pod:3744 ../fish/guestfish-actions.pod:2601
13724 msgid ""
13725 "List the files in C<directory> (relative to the root directory, there is no "
13726 "cwd).  The '.' and '..' entries are not returned, but hidden files are shown."
13727 msgstr ""
13728
13729 # type: textblock
13730 #. type: textblock
13731 #: ../src/guestfs-actions.pod:3748
13732 msgid ""
13733 "This command is mostly useful for interactive sessions.  Programs should "
13734 "probably use C<guestfs_readdir> instead."
13735 msgstr ""
13736
13737 # type: =head2
13738 #. type: =head2
13739 #: ../src/guestfs-actions.pod:3757
13740 msgid "guestfs_lsetxattr"
13741 msgstr ""
13742
13743 # type: verbatim
13744 #. type: verbatim
13745 #: ../src/guestfs-actions.pod:3759
13746 #, no-wrap
13747 msgid ""
13748 " int\n"
13749 " guestfs_lsetxattr (guestfs_h *g,\n"
13750 "                    const char *xattr,\n"
13751 "                    const char *val,\n"
13752 "                    int vallen,\n"
13753 "                    const char *path);\n"
13754 "\n"
13755 msgstr ""
13756
13757 # type: textblock
13758 #. type: textblock
13759 #: ../src/guestfs-actions.pod:3766
13760 msgid ""
13761 "This is the same as C<guestfs_setxattr>, but if C<path> is a symbolic link, "
13762 "then it sets an extended attribute of the link itself."
13763 msgstr ""
13764
13765 # type: =head2
13766 #. type: =head2
13767 #: ../src/guestfs-actions.pod:3774
13768 msgid "guestfs_lstat"
13769 msgstr ""
13770
13771 # type: verbatim
13772 #. type: verbatim
13773 #: ../src/guestfs-actions.pod:3776
13774 #, no-wrap
13775 msgid ""
13776 " struct guestfs_stat *\n"
13777 " guestfs_lstat (guestfs_h *g,\n"
13778 "                const char *path);\n"
13779 "\n"
13780 msgstr ""
13781
13782 # type: textblock
13783 #. type: textblock
13784 #: ../src/guestfs-actions.pod:3780 ../src/guestfs-actions.pod:6382
13785 #: ../fish/guestfish-actions.pod:2620 ../fish/guestfish-actions.pod:4333
13786 msgid "Returns file information for the given C<path>."
13787 msgstr ""
13788
13789 # type: textblock
13790 #. type: textblock
13791 #: ../src/guestfs-actions.pod:3782
13792 msgid ""
13793 "This is the same as C<guestfs_stat> except that if C<path> is a symbolic "
13794 "link, then the link is stat-ed, not the file it refers to."
13795 msgstr ""
13796
13797 # type: textblock
13798 #. type: textblock
13799 #: ../src/guestfs-actions.pod:3786 ../fish/guestfish-actions.pod:2626
13800 msgid "This is the same as the C<lstat(2)> system call."
13801 msgstr ""
13802
13803 # type: textblock
13804 #. type: textblock
13805 #: ../src/guestfs-actions.pod:3788 ../src/guestfs-actions.pod:6386
13806 msgid ""
13807 "This function returns a C<struct guestfs_stat *>, or NULL if there was an "
13808 "error.  I<The caller must call C<guestfs_free_stat> after use>."
13809 msgstr ""
13810
13811 # type: textblock
13812 #. type: textblock
13813 #: ../src/guestfs-actions.pod:3792 ../src/guestfs-actions.pod:6390
13814 #: ../src/guestfs-actions.pod:6408 ../src/guestfs-actions.pod:6789
13815 msgid "(Added in 0.9.2)"
13816 msgstr ""
13817
13818 # type: =head2
13819 #. type: =head2
13820 #: ../src/guestfs-actions.pod:3794
13821 msgid "guestfs_lstatlist"
13822 msgstr ""
13823
13824 # type: verbatim
13825 #. type: verbatim
13826 #: ../src/guestfs-actions.pod:3796
13827 #, no-wrap
13828 msgid ""
13829 " struct guestfs_stat_list *\n"
13830 " guestfs_lstatlist (guestfs_h *g,\n"
13831 "                    const char *path,\n"
13832 "                    char *const *names);\n"
13833 "\n"
13834 msgstr ""
13835
13836 # type: textblock
13837 #. type: textblock
13838 #: ../src/guestfs-actions.pod:3801
13839 msgid ""
13840 "This call allows you to perform the C<guestfs_lstat> operation on multiple "
13841 "files, where all files are in the directory C<path>.  C<names> is the list "
13842 "of files from this directory."
13843 msgstr ""
13844
13845 # type: textblock
13846 #. type: textblock
13847 #: ../src/guestfs-actions.pod:3805 ../fish/guestfish-actions.pod:2636
13848 msgid ""
13849 "On return you get a list of stat structs, with a one-to-one correspondence "
13850 "to the C<names> list.  If any name did not exist or could not be lstat'd, "
13851 "then the C<ino> field of that structure is set to C<-1>."
13852 msgstr ""
13853
13854 # type: textblock
13855 #. type: textblock
13856 #: ../src/guestfs-actions.pod:3810
13857 msgid ""
13858 "This call is intended for programs that want to efficiently list a directory "
13859 "contents without making many round-trips.  See also C<guestfs_lxattrlist> "
13860 "for a similarly efficient call for getting extended attributes.  Very long "
13861 "directory listings might cause the protocol message size to be exceeded, "
13862 "causing this call to fail.  The caller must split up such requests into "
13863 "smaller groups of names."
13864 msgstr ""
13865
13866 # type: textblock
13867 #. type: textblock
13868 #: ../src/guestfs-actions.pod:3818
13869 msgid ""
13870 "This function returns a C<struct guestfs_stat_list *>, or NULL if there was "
13871 "an error.  I<The caller must call C<guestfs_free_stat_list> after use>."
13872 msgstr ""
13873
13874 # type: =head2
13875 #. type: =head2
13876 #: ../src/guestfs-actions.pod:3824
13877 msgid "guestfs_luks_add_key"
13878 msgstr ""
13879
13880 # type: verbatim
13881 #. type: verbatim
13882 #: ../src/guestfs-actions.pod:3826
13883 #, no-wrap
13884 msgid ""
13885 " int\n"
13886 " guestfs_luks_add_key (guestfs_h *g,\n"
13887 "                       const char *device,\n"
13888 "                       const char *key,\n"
13889 "                       const char *newkey,\n"
13890 "                       int keyslot);\n"
13891 "\n"
13892 msgstr ""
13893
13894 # type: textblock
13895 #. type: textblock
13896 #: ../src/guestfs-actions.pod:3833 ../fish/guestfish-actions.pod:2653
13897 msgid ""
13898 "This command adds a new key on LUKS device C<device>.  C<key> is any "
13899 "existing key, and is used to access the device.  C<newkey> is the new key to "
13900 "add.  C<keyslot> is the key slot that will be replaced."
13901 msgstr ""
13902
13903 # type: textblock
13904 #. type: textblock
13905 #: ../src/guestfs-actions.pod:3838
13906 msgid ""
13907 "Note that if C<keyslot> already contains a key, then this command will "
13908 "fail.  You have to use C<guestfs_luks_kill_slot> first to remove that key."
13909 msgstr ""
13910
13911 # type: textblock
13912 #. type: textblock
13913 #: ../src/guestfs-actions.pod:3844 ../src/guestfs-actions.pod:3884
13914 #: ../src/guestfs-actions.pod:3907 ../src/guestfs-actions.pod:3927
13915 #: ../src/guestfs-actions.pod:3959 ../src/guestfs-actions.pod:3978
13916 msgid ""
13917 "This function takes a key or passphrase parameter which could contain "
13918 "sensitive material.  Read the section L</KEYS AND PASSPHRASES> for more "
13919 "information."
13920 msgstr ""
13921
13922 # type: textblock
13923 #. type: textblock
13924 #: ../src/guestfs-actions.pod:3848 ../src/guestfs-actions.pod:3888
13925 #: ../src/guestfs-actions.pod:3911 ../src/guestfs-actions.pod:3931
13926 msgid "(Added in 1.5.2)"
13927 msgstr ""
13928
13929 # type: =head2
13930 #. type: =head2
13931 #: ../src/guestfs-actions.pod:3850
13932 msgid "guestfs_luks_close"
13933 msgstr ""
13934
13935 # type: verbatim
13936 #. type: verbatim
13937 #: ../src/guestfs-actions.pod:3852
13938 #, no-wrap
13939 msgid ""
13940 " int\n"
13941 " guestfs_luks_close (guestfs_h *g,\n"
13942 "                     const char *device);\n"
13943 "\n"
13944 msgstr ""
13945
13946 # type: textblock
13947 #. type: textblock
13948 #: ../src/guestfs-actions.pod:3856
13949 msgid ""
13950 "This closes a LUKS device that was created earlier by C<guestfs_luks_open> "
13951 "or C<guestfs_luks_open_ro>.  The C<device> parameter must be the name of the "
13952 "LUKS mapping device (ie. C</dev/mapper/mapname>) and I<not> the name of the "
13953 "underlying block device."
13954 msgstr ""
13955
13956 # type: textblock
13957 #. type: textblock
13958 #: ../src/guestfs-actions.pod:3864 ../src/guestfs-actions.pod:3963
13959 #: ../src/guestfs-actions.pod:3982 ../src/guestfs-actions.pod:4032
13960 #: ../src/guestfs-actions.pod:4080
13961 msgid "(Added in 1.5.1)"
13962 msgstr ""
13963
13964 # type: =head2
13965 #. type: =head2
13966 #: ../src/guestfs-actions.pod:3866
13967 msgid "guestfs_luks_format"
13968 msgstr ""
13969
13970 # type: verbatim
13971 #. type: verbatim
13972 #: ../src/guestfs-actions.pod:3868
13973 #, no-wrap
13974 msgid ""
13975 " int\n"
13976 " guestfs_luks_format (guestfs_h *g,\n"
13977 "                      const char *device,\n"
13978 "                      const char *key,\n"
13979 "                      int keyslot);\n"
13980 "\n"
13981 msgstr ""
13982
13983 # type: textblock
13984 #. type: textblock
13985 #: ../src/guestfs-actions.pod:3874 ../fish/guestfish-actions.pod:2679
13986 msgid ""
13987 "This command erases existing data on C<device> and formats the device as a "
13988 "LUKS encrypted device.  C<key> is the initial key, which is added to key "
13989 "slot C<slot>.  (LUKS supports 8 key slots, numbered 0-7)."
13990 msgstr ""
13991
13992 # type: textblock
13993 #. type: textblock
13994 #: ../src/guestfs-actions.pod:3881 ../src/guestfs-actions.pod:3904
13995 #: ../src/guestfs-actions.pod:4044 ../src/guestfs-actions.pod:5002
13996 #: ../src/guestfs-actions.pod:5782 ../src/guestfs-actions.pod:6189
13997 #: ../src/guestfs-actions.pod:6219 ../src/guestfs-actions.pod:6252
13998 #: ../src/guestfs-actions.pod:7433 ../fish/guestfish-actions.pod:2687
13999 #: ../fish/guestfish-actions.pod:2700 ../fish/guestfish-actions.pod:2784
14000 #: ../fish/guestfish-actions.pod:3374 ../fish/guestfish-actions.pod:3894
14001 #: ../fish/guestfish-actions.pod:4204 ../fish/guestfish-actions.pod:4227
14002 #: ../fish/guestfish-actions.pod:4249 ../fish/guestfish-actions.pod:4978
14003 msgid ""
14004 "B<This command is dangerous.  Without careful use you can easily destroy all "
14005 "your data>."
14006 msgstr ""
14007
14008 # type: =head2
14009 #. type: =head2
14010 #: ../src/guestfs-actions.pod:3890
14011 msgid "guestfs_luks_format_cipher"
14012 msgstr ""
14013
14014 # type: verbatim
14015 #. type: verbatim
14016 #: ../src/guestfs-actions.pod:3892
14017 #, no-wrap
14018 msgid ""
14019 " int\n"
14020 " guestfs_luks_format_cipher (guestfs_h *g,\n"
14021 "                             const char *device,\n"
14022 "                             const char *key,\n"
14023 "                             int keyslot,\n"
14024 "                             const char *cipher);\n"
14025 "\n"
14026 msgstr ""
14027
14028 # type: textblock
14029 #. type: textblock
14030 #: ../src/guestfs-actions.pod:3899
14031 msgid ""
14032 "This command is the same as C<guestfs_luks_format> but it also allows you to "
14033 "set the C<cipher> used."
14034 msgstr ""
14035
14036 # type: =head2
14037 #. type: =head2
14038 #: ../src/guestfs-actions.pod:3913
14039 msgid "guestfs_luks_kill_slot"
14040 msgstr ""
14041
14042 # type: verbatim
14043 #. type: verbatim
14044 #: ../src/guestfs-actions.pod:3915
14045 #, no-wrap
14046 msgid ""
14047 " int\n"
14048 " guestfs_luks_kill_slot (guestfs_h *g,\n"
14049 "                         const char *device,\n"
14050 "                         const char *key,\n"
14051 "                         int keyslot);\n"
14052 "\n"
14053 msgstr ""
14054
14055 # type: textblock
14056 #. type: textblock
14057 #: ../src/guestfs-actions.pod:3921 ../fish/guestfish-actions.pod:2707
14058 msgid ""
14059 "This command deletes the key in key slot C<keyslot> from the encrypted LUKS "
14060 "device C<device>.  C<key> must be one of the I<other> keys."
14061 msgstr ""
14062
14063 # type: =head2
14064 #. type: =head2
14065 #: ../src/guestfs-actions.pod:3933
14066 msgid "guestfs_luks_open"
14067 msgstr ""
14068
14069 # type: verbatim
14070 #. type: verbatim
14071 #: ../src/guestfs-actions.pod:3935
14072 #, no-wrap
14073 msgid ""
14074 " int\n"
14075 " guestfs_luks_open (guestfs_h *g,\n"
14076 "                    const char *device,\n"
14077 "                    const char *key,\n"
14078 "                    const char *mapname);\n"
14079 "\n"
14080 msgstr ""
14081
14082 # type: textblock
14083 #. type: textblock
14084 #: ../src/guestfs-actions.pod:3941 ../fish/guestfish-actions.pod:2718
14085 msgid ""
14086 "This command opens a block device which has been encrypted according to the "
14087 "Linux Unified Key Setup (LUKS) standard."
14088 msgstr ""
14089
14090 # type: textblock
14091 #. type: textblock
14092 #: ../src/guestfs-actions.pod:3944 ../fish/guestfish-actions.pod:2721
14093 msgid "C<device> is the encrypted block device or partition."
14094 msgstr ""
14095
14096 # type: textblock
14097 #. type: textblock
14098 #: ../src/guestfs-actions.pod:3946 ../fish/guestfish-actions.pod:2723
14099 msgid ""
14100 "The caller must supply one of the keys associated with the LUKS block "
14101 "device, in the C<key> parameter."
14102 msgstr ""
14103
14104 # type: textblock
14105 #. type: textblock
14106 #: ../src/guestfs-actions.pod:3949 ../fish/guestfish-actions.pod:2726
14107 msgid ""
14108 "This creates a new block device called C</dev/mapper/mapname>.  Reads and "
14109 "writes to this block device are decrypted from and encrypted to the "
14110 "underlying C<device> respectively."
14111 msgstr ""
14112
14113 # type: textblock
14114 #. type: textblock
14115 #: ../src/guestfs-actions.pod:3953
14116 msgid ""
14117 "If this block device contains LVM volume groups, then calling "
14118 "C<guestfs_vgscan> followed by C<guestfs_vg_activate_all> will make them "
14119 "visible."
14120 msgstr ""
14121
14122 # type: =head2
14123 #. type: =head2
14124 #: ../src/guestfs-actions.pod:3965
14125 msgid "guestfs_luks_open_ro"
14126 msgstr ""
14127
14128 # type: verbatim
14129 #. type: verbatim
14130 #: ../src/guestfs-actions.pod:3967
14131 #, no-wrap
14132 msgid ""
14133 " int\n"
14134 " guestfs_luks_open_ro (guestfs_h *g,\n"
14135 "                       const char *device,\n"
14136 "                       const char *key,\n"
14137 "                       const char *mapname);\n"
14138 "\n"
14139 msgstr ""
14140
14141 # type: textblock
14142 #. type: textblock
14143 #: ../src/guestfs-actions.pod:3973
14144 msgid ""
14145 "This is the same as C<guestfs_luks_open> except that a read-only mapping is "
14146 "created."
14147 msgstr ""
14148
14149 # type: =head2
14150 #. type: =head2
14151 #: ../src/guestfs-actions.pod:3984
14152 msgid "guestfs_lvcreate"
14153 msgstr ""
14154
14155 # type: verbatim
14156 #. type: verbatim
14157 #: ../src/guestfs-actions.pod:3986
14158 #, no-wrap
14159 msgid ""
14160 " int\n"
14161 " guestfs_lvcreate (guestfs_h *g,\n"
14162 "                   const char *logvol,\n"
14163 "                   const char *volgroup,\n"
14164 "                   int mbytes);\n"
14165 "\n"
14166 msgstr ""
14167
14168 # type: textblock
14169 #. type: textblock
14170 #: ../src/guestfs-actions.pod:3992 ../fish/guestfish-actions.pod:2751
14171 msgid ""
14172 "This creates an LVM logical volume called C<logvol> on the volume group "
14173 "C<volgroup>, with C<size> megabytes."
14174 msgstr ""
14175
14176 # type: =head2
14177 #. type: =head2
14178 #: ../src/guestfs-actions.pod:3999
14179 msgid "guestfs_lvm_canonical_lv_name"
14180 msgstr ""
14181
14182 # type: verbatim
14183 #. type: verbatim
14184 #: ../src/guestfs-actions.pod:4001
14185 #, no-wrap
14186 msgid ""
14187 " char *\n"
14188 " guestfs_lvm_canonical_lv_name (guestfs_h *g,\n"
14189 "                                const char *lvname);\n"
14190 "\n"
14191 msgstr ""
14192
14193 # type: textblock
14194 #. type: textblock
14195 #: ../src/guestfs-actions.pod:4005 ../fish/guestfish-actions.pod:2758
14196 msgid ""
14197 "This converts alternative naming schemes for LVs that you might find to the "
14198 "canonical name.  For example, C</dev/mapper/VG-LV> is converted to C</dev/VG/"
14199 "LV>."
14200 msgstr ""
14201
14202 # type: textblock
14203 #. type: textblock
14204 #: ../src/guestfs-actions.pod:4009 ../fish/guestfish-actions.pod:2762
14205 msgid ""
14206 "This command returns an error if the C<lvname> parameter does not refer to a "
14207 "logical volume."
14208 msgstr ""
14209
14210 # type: textblock
14211 #. type: textblock
14212 #: ../src/guestfs-actions.pod:4012
14213 msgid "See also C<guestfs_is_lv>."
14214 msgstr ""
14215
14216 # type: textblock
14217 #. type: textblock
14218 #: ../src/guestfs-actions.pod:4017
14219 msgid "(Added in 1.5.24)"
14220 msgstr ""
14221
14222 # type: =head2
14223 #. type: =head2
14224 #: ../src/guestfs-actions.pod:4019
14225 msgid "guestfs_lvm_clear_filter"
14226 msgstr ""
14227
14228 # type: verbatim
14229 #. type: verbatim
14230 #: ../src/guestfs-actions.pod:4021
14231 #, no-wrap
14232 msgid ""
14233 " int\n"
14234 " guestfs_lvm_clear_filter (guestfs_h *g);\n"
14235 "\n"
14236 msgstr ""
14237
14238 # type: textblock
14239 #. type: textblock
14240 #: ../src/guestfs-actions.pod:4024
14241 msgid ""
14242 "This undoes the effect of C<guestfs_lvm_set_filter>.  LVM will be able to "
14243 "see every block device."
14244 msgstr ""
14245
14246 # type: textblock
14247 #. type: textblock
14248 #: ../src/guestfs-actions.pod:4027 ../src/guestfs-actions.pod:4069
14249 #: ../fish/guestfish-actions.pod:2774 ../fish/guestfish-actions.pod:2805
14250 msgid ""
14251 "This command also clears the LVM cache and performs a volume group scan."
14252 msgstr ""
14253
14254 # type: =head2
14255 #. type: =head2
14256 #: ../src/guestfs-actions.pod:4034
14257 msgid "guestfs_lvm_remove_all"
14258 msgstr ""
14259
14260 # type: verbatim
14261 #. type: verbatim
14262 #: ../src/guestfs-actions.pod:4036
14263 #, no-wrap
14264 msgid ""
14265 " int\n"
14266 " guestfs_lvm_remove_all (guestfs_h *g);\n"
14267 "\n"
14268 msgstr ""
14269
14270 # type: textblock
14271 #. type: textblock
14272 #: ../src/guestfs-actions.pod:4039 ../fish/guestfish-actions.pod:2781
14273 msgid ""
14274 "This command removes all LVM logical volumes, volume groups and physical "
14275 "volumes."
14276 msgstr ""
14277
14278 # type: =head2
14279 #. type: =head2
14280 #: ../src/guestfs-actions.pod:4049
14281 msgid "guestfs_lvm_set_filter"
14282 msgstr ""
14283
14284 # type: verbatim
14285 #. type: verbatim
14286 #: ../src/guestfs-actions.pod:4051
14287 #, no-wrap
14288 msgid ""
14289 " int\n"
14290 " guestfs_lvm_set_filter (guestfs_h *g,\n"
14291 "                         char *const *devices);\n"
14292 "\n"
14293 msgstr ""
14294
14295 # type: textblock
14296 #. type: textblock
14297 #: ../src/guestfs-actions.pod:4055 ../fish/guestfish-actions.pod:2791
14298 msgid ""
14299 "This sets the LVM device filter so that LVM will only be able to \"see\" the "
14300 "block devices in the list C<devices>, and will ignore all other attached "
14301 "block devices."
14302 msgstr ""
14303
14304 # type: textblock
14305 #. type: textblock
14306 #: ../src/guestfs-actions.pod:4059 ../fish/guestfish-actions.pod:2795
14307 msgid ""
14308 "Where disk image(s) contain duplicate PVs or VGs, this command is useful to "
14309 "get LVM to ignore the duplicates, otherwise LVM can get confused.  Note also "
14310 "there are two types of duplication possible: either cloned PVs/VGs which "
14311 "have identical UUIDs; or VGs that are not cloned but just happen to have the "
14312 "same name.  In normal operation you cannot create this situation, but you "
14313 "can do it outside LVM, eg.  by cloning disk images or by bit twiddling "
14314 "inside the LVM metadata."
14315 msgstr ""
14316
14317 # type: textblock
14318 #. type: textblock
14319 #: ../src/guestfs-actions.pod:4072 ../fish/guestfish-actions.pod:2808
14320 msgid "You can filter whole block devices or individual partitions."
14321 msgstr ""
14322
14323 # type: textblock
14324 #. type: textblock
14325 #: ../src/guestfs-actions.pod:4074 ../fish/guestfish-actions.pod:2810
14326 msgid ""
14327 "You cannot use this if any VG is currently in use (eg.  contains a mounted "
14328 "filesystem), even if you are not filtering out that VG."
14329 msgstr ""
14330
14331 # type: =head2
14332 #. type: =head2
14333 #: ../src/guestfs-actions.pod:4082
14334 msgid "guestfs_lvremove"
14335 msgstr ""
14336
14337 # type: verbatim
14338 #. type: verbatim
14339 #: ../src/guestfs-actions.pod:4084
14340 #, no-wrap
14341 msgid ""
14342 " int\n"
14343 " guestfs_lvremove (guestfs_h *g,\n"
14344 "                   const char *device);\n"
14345 "\n"
14346 msgstr ""
14347
14348 # type: textblock
14349 #. type: textblock
14350 #: ../src/guestfs-actions.pod:4088 ../fish/guestfish-actions.pod:2818
14351 msgid ""
14352 "Remove an LVM logical volume C<device>, where C<device> is the path to the "
14353 "LV, such as C</dev/VG/LV>."
14354 msgstr ""
14355
14356 # type: textblock
14357 #. type: textblock
14358 #: ../src/guestfs-actions.pod:4091 ../fish/guestfish-actions.pod:2821
14359 msgid ""
14360 "You can also remove all LVs in a volume group by specifying the VG name, C</"
14361 "dev/VG>."
14362 msgstr ""
14363
14364 # type: textblock
14365 #. type: textblock
14366 #: ../src/guestfs-actions.pod:4096 ../src/guestfs-actions.pod:5348
14367 #: ../src/guestfs-actions.pod:7165
14368 msgid "(Added in 1.0.13)"
14369 msgstr ""
14370
14371 # type: =head2
14372 #. type: =head2
14373 #: ../src/guestfs-actions.pod:4098
14374 msgid "guestfs_lvrename"
14375 msgstr ""
14376
14377 # type: verbatim
14378 #. type: verbatim
14379 #: ../src/guestfs-actions.pod:4100
14380 #, no-wrap
14381 msgid ""
14382 " int\n"
14383 " guestfs_lvrename (guestfs_h *g,\n"
14384 "                   const char *logvol,\n"
14385 "                   const char *newlogvol);\n"
14386 "\n"
14387 msgstr ""
14388
14389 # type: textblock
14390 #. type: textblock
14391 #: ../src/guestfs-actions.pod:4105 ../fish/guestfish-actions.pod:2828
14392 msgid "Rename a logical volume C<logvol> with the new name C<newlogvol>."
14393 msgstr ""
14394
14395 # type: textblock
14396 #. type: textblock
14397 #: ../src/guestfs-actions.pod:4109 ../src/guestfs-actions.pod:7178
14398 msgid "(Added in 1.0.83)"
14399 msgstr ""
14400
14401 # type: =head2
14402 #. type: =head2
14403 #: ../src/guestfs-actions.pod:4111
14404 msgid "guestfs_lvresize"
14405 msgstr ""
14406
14407 # type: verbatim
14408 #. type: verbatim
14409 #: ../src/guestfs-actions.pod:4113
14410 #, no-wrap
14411 msgid ""
14412 " int\n"
14413 " guestfs_lvresize (guestfs_h *g,\n"
14414 "                   const char *device,\n"
14415 "                   int mbytes);\n"
14416 "\n"
14417 msgstr ""
14418
14419 # type: textblock
14420 #. type: textblock
14421 #: ../src/guestfs-actions.pod:4118 ../fish/guestfish-actions.pod:2834
14422 msgid ""
14423 "This resizes (expands or shrinks) an existing LVM logical volume to "
14424 "C<mbytes>.  When reducing, data in the reduced part is lost."
14425 msgstr ""
14426
14427 # type: =head2
14428 #. type: =head2
14429 #: ../src/guestfs-actions.pod:4126
14430 msgid "guestfs_lvresize_free"
14431 msgstr ""
14432
14433 # type: verbatim
14434 #. type: verbatim
14435 #: ../src/guestfs-actions.pod:4128
14436 #, no-wrap
14437 msgid ""
14438 " int\n"
14439 " guestfs_lvresize_free (guestfs_h *g,\n"
14440 "                        const char *lv,\n"
14441 "                        int percent);\n"
14442 "\n"
14443 msgstr ""
14444
14445 # type: textblock
14446 #. type: textblock
14447 #: ../src/guestfs-actions.pod:4133 ../fish/guestfish-actions.pod:2842
14448 msgid ""
14449 "This expands an existing logical volume C<lv> so that it fills C<pc>% of the "
14450 "remaining free space in the volume group.  Commonly you would call this with "
14451 "pc = 100 which expands the logical volume as much as possible, using all "
14452 "remaining free space in the volume group."
14453 msgstr ""
14454
14455 # type: textblock
14456 #. type: textblock
14457 #: ../src/guestfs-actions.pod:4141
14458 msgid "(Added in 1.3.3)"
14459 msgstr ""
14460
14461 # type: =head2
14462 #. type: =head2
14463 #: ../src/guestfs-actions.pod:4143
14464 msgid "guestfs_lvs"
14465 msgstr ""
14466
14467 # type: verbatim
14468 #. type: verbatim
14469 #: ../src/guestfs-actions.pod:4145
14470 #, no-wrap
14471 msgid ""
14472 " char **\n"
14473 " guestfs_lvs (guestfs_h *g);\n"
14474 "\n"
14475 msgstr ""
14476
14477 # type: textblock
14478 #. type: textblock
14479 #: ../src/guestfs-actions.pod:4148 ../fish/guestfish-actions.pod:2852
14480 msgid ""
14481 "List all the logical volumes detected.  This is the equivalent of the L<lvs"
14482 "(8)> command."
14483 msgstr ""
14484
14485 # type: textblock
14486 #. type: textblock
14487 #: ../src/guestfs-actions.pod:4151 ../fish/guestfish-actions.pod:2855
14488 msgid ""
14489 "This returns a list of the logical volume device names (eg. C</dev/"
14490 "VolGroup00/LogVol00>)."
14491 msgstr ""
14492
14493 # type: textblock
14494 #. type: textblock
14495 #: ../src/guestfs-actions.pod:4154
14496 msgid "See also C<guestfs_lvs_full>, C<guestfs_list_filesystems>."
14497 msgstr ""
14498
14499 # type: =head2
14500 #. type: =head2
14501 #: ../src/guestfs-actions.pod:4162
14502 msgid "guestfs_lvs_full"
14503 msgstr ""
14504
14505 # type: verbatim
14506 #. type: verbatim
14507 #: ../src/guestfs-actions.pod:4164
14508 #, no-wrap
14509 msgid ""
14510 " struct guestfs_lvm_lv_list *\n"
14511 " guestfs_lvs_full (guestfs_h *g);\n"
14512 "\n"
14513 msgstr ""
14514
14515 # type: textblock
14516 #. type: textblock
14517 #: ../src/guestfs-actions.pod:4167 ../fish/guestfish-actions.pod:2864
14518 msgid ""
14519 "List all the logical volumes detected.  This is the equivalent of the L<lvs"
14520 "(8)> command.  The \"full\" version includes all fields."
14521 msgstr ""
14522
14523 # type: textblock
14524 #. type: textblock
14525 #: ../src/guestfs-actions.pod:4170
14526 msgid ""
14527 "This function returns a C<struct guestfs_lvm_lv_list *>, or NULL if there "
14528 "was an error.  I<The caller must call C<guestfs_free_lvm_lv_list> after use>."
14529 msgstr ""
14530
14531 # type: =head2
14532 #. type: =head2
14533 #: ../src/guestfs-actions.pod:4176
14534 msgid "guestfs_lvuuid"
14535 msgstr ""
14536
14537 # type: verbatim
14538 #. type: verbatim
14539 #: ../src/guestfs-actions.pod:4178
14540 #, no-wrap
14541 msgid ""
14542 " char *\n"
14543 " guestfs_lvuuid (guestfs_h *g,\n"
14544 "                 const char *device);\n"
14545 "\n"
14546 msgstr ""
14547
14548 # type: textblock
14549 #. type: textblock
14550 #: ../src/guestfs-actions.pod:4182 ../fish/guestfish-actions.pod:2871
14551 msgid "This command returns the UUID of the LVM LV C<device>."
14552 msgstr ""
14553
14554 # type: =head2
14555 #. type: =head2
14556 #: ../src/guestfs-actions.pod:4189
14557 msgid "guestfs_lxattrlist"
14558 msgstr ""
14559
14560 # type: verbatim
14561 #. type: verbatim
14562 #: ../src/guestfs-actions.pod:4191
14563 #, no-wrap
14564 msgid ""
14565 " struct guestfs_xattr_list *\n"
14566 " guestfs_lxattrlist (guestfs_h *g,\n"
14567 "                     const char *path,\n"
14568 "                     char *const *names);\n"
14569 "\n"
14570 msgstr ""
14571
14572 # type: textblock
14573 #. type: textblock
14574 #: ../src/guestfs-actions.pod:4196 ../fish/guestfish-actions.pod:2877
14575 msgid ""
14576 "This call allows you to get the extended attributes of multiple files, where "
14577 "all files are in the directory C<path>.  C<names> is the list of files from "
14578 "this directory."
14579 msgstr ""
14580
14581 # type: textblock
14582 #. type: textblock
14583 #: ../src/guestfs-actions.pod:4200 ../fish/guestfish-actions.pod:2881
14584 msgid ""
14585 "On return you get a flat list of xattr structs which must be interpreted "
14586 "sequentially.  The first xattr struct always has a zero-length C<attrname>.  "
14587 "C<attrval> in this struct is zero-length to indicate there was an error "
14588 "doing C<lgetxattr> for this file, I<or> is a C string which is a decimal "
14589 "number (the number of following attributes for this file, which could be C<"
14590 "\"0\">).  Then after the first xattr struct are the zero or more attributes "
14591 "for the first named file.  This repeats for the second and subsequent files."
14592 msgstr ""
14593
14594 # type: textblock
14595 #. type: textblock
14596 #: ../src/guestfs-actions.pod:4210
14597 msgid ""
14598 "This call is intended for programs that want to efficiently list a directory "
14599 "contents without making many round-trips.  See also C<guestfs_lstatlist> for "
14600 "a similarly efficient call for getting standard stats.  Very long directory "
14601 "listings might cause the protocol message size to be exceeded, causing this "
14602 "call to fail.  The caller must split up such requests into smaller groups of "
14603 "names."
14604 msgstr ""
14605
14606 # type: =head2
14607 #. type: =head2
14608 #: ../src/guestfs-actions.pod:4224
14609 msgid "guestfs_mkdir"
14610 msgstr ""
14611
14612 # type: verbatim
14613 #. type: verbatim
14614 #: ../src/guestfs-actions.pod:4226
14615 #, no-wrap
14616 msgid ""
14617 " int\n"
14618 " guestfs_mkdir (guestfs_h *g,\n"
14619 "                const char *path);\n"
14620 "\n"
14621 msgstr ""
14622
14623 # type: textblock
14624 #. type: textblock
14625 #: ../src/guestfs-actions.pod:4230 ../fish/guestfish-actions.pod:2903
14626 msgid "Create a directory named C<path>."
14627 msgstr ""
14628
14629 # type: =head2
14630 #. type: =head2
14631 #: ../src/guestfs-actions.pod:4236
14632 msgid "guestfs_mkdir_mode"
14633 msgstr ""
14634
14635 # type: verbatim
14636 #. type: verbatim
14637 #: ../src/guestfs-actions.pod:4238
14638 #, no-wrap
14639 msgid ""
14640 " int\n"
14641 " guestfs_mkdir_mode (guestfs_h *g,\n"
14642 "                     const char *path,\n"
14643 "                     int mode);\n"
14644 "\n"
14645 msgstr ""
14646
14647 # type: textblock
14648 #. type: textblock
14649 #: ../src/guestfs-actions.pod:4243 ../fish/guestfish-actions.pod:2909
14650 msgid ""
14651 "This command creates a directory, setting the initial permissions of the "
14652 "directory to C<mode>."
14653 msgstr ""
14654
14655 # type: textblock
14656 #. type: textblock
14657 #: ../src/guestfs-actions.pod:4246 ../fish/guestfish-actions.pod:2912
14658 msgid ""
14659 "For common Linux filesystems, the actual mode which is set will be C<mode & "
14660 "~umask & 01777>.  Non-native-Linux filesystems may interpret the mode in "
14661 "other ways."
14662 msgstr ""
14663
14664 # type: textblock
14665 #. type: textblock
14666 #: ../src/guestfs-actions.pod:4250
14667 msgid "See also C<guestfs_mkdir>, C<guestfs_umask>"
14668 msgstr ""
14669
14670 # type: =head2
14671 #. type: =head2
14672 #: ../src/guestfs-actions.pod:4256
14673 msgid "guestfs_mkdir_p"
14674 msgstr ""
14675
14676 # type: verbatim
14677 #. type: verbatim
14678 #: ../src/guestfs-actions.pod:4258
14679 #, no-wrap
14680 msgid ""
14681 " int\n"
14682 " guestfs_mkdir_p (guestfs_h *g,\n"
14683 "                  const char *path);\n"
14684 "\n"
14685 msgstr ""
14686
14687 # type: textblock
14688 #. type: textblock
14689 #: ../src/guestfs-actions.pod:4262 ../fish/guestfish-actions.pod:2922
14690 msgid ""
14691 "Create a directory named C<path>, creating any parent directories as "
14692 "necessary.  This is like the C<mkdir -p> shell command."
14693 msgstr ""
14694
14695 # type: =head2
14696 #. type: =head2
14697 #: ../src/guestfs-actions.pod:4269
14698 msgid "guestfs_mkdtemp"
14699 msgstr ""
14700
14701 # type: verbatim
14702 #. type: verbatim
14703 #: ../src/guestfs-actions.pod:4271
14704 #, no-wrap
14705 msgid ""
14706 " char *\n"
14707 " guestfs_mkdtemp (guestfs_h *g,\n"
14708 "                  const char *template);\n"
14709 "\n"
14710 msgstr ""
14711
14712 # type: textblock
14713 #. type: textblock
14714 #: ../src/guestfs-actions.pod:4275 ../fish/guestfish-actions.pod:2929
14715 msgid ""
14716 "This command creates a temporary directory.  The C<template> parameter "
14717 "should be a full pathname for the temporary directory name with the final "
14718 "six characters being \"XXXXXX\"."
14719 msgstr ""
14720
14721 # type: textblock
14722 #. type: textblock
14723 #: ../src/guestfs-actions.pod:4280 ../fish/guestfish-actions.pod:2934
14724 msgid ""
14725 "For example: \"/tmp/myprogXXXXXX\" or \"/Temp/myprogXXXXXX\", the second one "
14726 "being suitable for Windows filesystems."
14727 msgstr ""
14728
14729 # type: textblock
14730 #. type: textblock
14731 #: ../src/guestfs-actions.pod:4283 ../fish/guestfish-actions.pod:2937
14732 msgid "The name of the temporary directory that was created is returned."
14733 msgstr ""
14734
14735 # type: textblock
14736 #. type: textblock
14737 #: ../src/guestfs-actions.pod:4286 ../fish/guestfish-actions.pod:2940
14738 msgid "The temporary directory is created with mode 0700 and is owned by root."
14739 msgstr ""
14740
14741 # type: textblock
14742 #. type: textblock
14743 #: ../src/guestfs-actions.pod:4289 ../fish/guestfish-actions.pod:2943
14744 msgid ""
14745 "The caller is responsible for deleting the temporary directory and its "
14746 "contents after use."
14747 msgstr ""
14748
14749 # type: textblock
14750 #. type: textblock
14751 #: ../src/guestfs-actions.pod:4292 ../fish/guestfish-actions.pod:2946
14752 msgid "See also: L<mkdtemp(3)>"
14753 msgstr ""
14754
14755 # type: =head2
14756 #. type: =head2
14757 #: ../src/guestfs-actions.pod:4299
14758 msgid "guestfs_mke2fs_J"
14759 msgstr ""
14760
14761 # type: verbatim
14762 #. type: verbatim
14763 #: ../src/guestfs-actions.pod:4301
14764 #, no-wrap
14765 msgid ""
14766 " int\n"
14767 " guestfs_mke2fs_J (guestfs_h *g,\n"
14768 "                   const char *fstype,\n"
14769 "                   int blocksize,\n"
14770 "                   const char *device,\n"
14771 "                   const char *journal);\n"
14772 "\n"
14773 msgstr ""
14774
14775 # type: textblock
14776 #. type: textblock
14777 #: ../src/guestfs-actions.pod:4308 ../fish/guestfish-actions.pod:2952
14778 msgid ""
14779 "This creates an ext2/3/4 filesystem on C<device> with an external journal on "
14780 "C<journal>.  It is equivalent to the command:"
14781 msgstr ""
14782
14783 # type: verbatim
14784 #. type: verbatim
14785 #: ../src/guestfs-actions.pod:4312 ../fish/guestfish-actions.pod:2956
14786 #, no-wrap
14787 msgid ""
14788 " mke2fs -t fstype -b blocksize -J device=<journal> <device>\n"
14789 "\n"
14790 msgstr ""
14791
14792 # type: textblock
14793 #. type: textblock
14794 #: ../src/guestfs-actions.pod:4314
14795 msgid "See also C<guestfs_mke2journal>."
14796 msgstr ""
14797
14798 # type: textblock
14799 #. type: textblock
14800 #: ../src/guestfs-actions.pod:4318 ../src/guestfs-actions.pod:4336
14801 #: ../src/guestfs-actions.pod:4354 ../src/guestfs-actions.pod:4370
14802 #: ../src/guestfs-actions.pod:4384 ../src/guestfs-actions.pod:4398
14803 #: ../src/guestfs-actions.pod:4457 ../src/guestfs-actions.pod:4722
14804 msgid "(Added in 1.0.68)"
14805 msgstr ""
14806
14807 # type: =head2
14808 #. type: =head2
14809 #: ../src/guestfs-actions.pod:4320
14810 msgid "guestfs_mke2fs_JL"
14811 msgstr ""
14812
14813 # type: verbatim
14814 #. type: verbatim
14815 #: ../src/guestfs-actions.pod:4322
14816 #, no-wrap
14817 msgid ""
14818 " int\n"
14819 " guestfs_mke2fs_JL (guestfs_h *g,\n"
14820 "                    const char *fstype,\n"
14821 "                    int blocksize,\n"
14822 "                    const char *device,\n"
14823 "                    const char *label);\n"
14824 "\n"
14825 msgstr ""
14826
14827 # type: textblock
14828 #. type: textblock
14829 #: ../src/guestfs-actions.pod:4329 ../fish/guestfish-actions.pod:2964
14830 msgid ""
14831 "This creates an ext2/3/4 filesystem on C<device> with an external journal on "
14832 "the journal labeled C<label>."
14833 msgstr ""
14834
14835 # type: textblock
14836 #. type: textblock
14837 #: ../src/guestfs-actions.pod:4332
14838 msgid "See also C<guestfs_mke2journal_L>."
14839 msgstr ""
14840
14841 # type: =head2
14842 #. type: =head2
14843 #: ../src/guestfs-actions.pod:4338
14844 msgid "guestfs_mke2fs_JU"
14845 msgstr ""
14846
14847 # type: verbatim
14848 #. type: verbatim
14849 #: ../src/guestfs-actions.pod:4340
14850 #, no-wrap
14851 msgid ""
14852 " int\n"
14853 " guestfs_mke2fs_JU (guestfs_h *g,\n"
14854 "                    const char *fstype,\n"
14855 "                    int blocksize,\n"
14856 "                    const char *device,\n"
14857 "                    const char *uuid);\n"
14858 "\n"
14859 msgstr ""
14860
14861 # type: textblock
14862 #. type: textblock
14863 #: ../src/guestfs-actions.pod:4347 ../fish/guestfish-actions.pod:2973
14864 msgid ""
14865 "This creates an ext2/3/4 filesystem on C<device> with an external journal on "
14866 "the journal with UUID C<uuid>."
14867 msgstr ""
14868
14869 # type: textblock
14870 #. type: textblock
14871 #: ../src/guestfs-actions.pod:4350
14872 msgid "See also C<guestfs_mke2journal_U>."
14873 msgstr ""
14874
14875 # type: =head2
14876 #. type: =head2
14877 #: ../src/guestfs-actions.pod:4356
14878 msgid "guestfs_mke2journal"
14879 msgstr ""
14880
14881 # type: verbatim
14882 #. type: verbatim
14883 #: ../src/guestfs-actions.pod:4358
14884 #, no-wrap
14885 msgid ""
14886 " int\n"
14887 " guestfs_mke2journal (guestfs_h *g,\n"
14888 "                      int blocksize,\n"
14889 "                      const char *device);\n"
14890 "\n"
14891 msgstr ""
14892
14893 # type: textblock
14894 #. type: textblock
14895 #: ../src/guestfs-actions.pod:4363 ../fish/guestfish-actions.pod:2982
14896 msgid ""
14897 "This creates an ext2 external journal on C<device>.  It is equivalent to the "
14898 "command:"
14899 msgstr ""
14900
14901 # type: verbatim
14902 #. type: verbatim
14903 #: ../src/guestfs-actions.pod:4366 ../fish/guestfish-actions.pod:2985
14904 #, no-wrap
14905 msgid ""
14906 " mke2fs -O journal_dev -b blocksize device\n"
14907 "\n"
14908 msgstr ""
14909
14910 # type: =head2
14911 #. type: =head2
14912 #: ../src/guestfs-actions.pod:4372
14913 msgid "guestfs_mke2journal_L"
14914 msgstr ""
14915
14916 # type: verbatim
14917 #. type: verbatim
14918 #: ../src/guestfs-actions.pod:4374
14919 #, no-wrap
14920 msgid ""
14921 " int\n"
14922 " guestfs_mke2journal_L (guestfs_h *g,\n"
14923 "                        int blocksize,\n"
14924 "                        const char *label,\n"
14925 "                        const char *device);\n"
14926 "\n"
14927 msgstr ""
14928
14929 # type: textblock
14930 #. type: textblock
14931 #: ../src/guestfs-actions.pod:4380 ../fish/guestfish-actions.pod:2991
14932 msgid "This creates an ext2 external journal on C<device> with label C<label>."
14933 msgstr ""
14934
14935 # type: =head2
14936 #. type: =head2
14937 #: ../src/guestfs-actions.pod:4386
14938 msgid "guestfs_mke2journal_U"
14939 msgstr ""
14940
14941 # type: verbatim
14942 #. type: verbatim
14943 #: ../src/guestfs-actions.pod:4388
14944 #, no-wrap
14945 msgid ""
14946 " int\n"
14947 " guestfs_mke2journal_U (guestfs_h *g,\n"
14948 "                        int blocksize,\n"
14949 "                        const char *uuid,\n"
14950 "                        const char *device);\n"
14951 "\n"
14952 msgstr ""
14953
14954 # type: textblock
14955 #. type: textblock
14956 #: ../src/guestfs-actions.pod:4394 ../fish/guestfish-actions.pod:2997
14957 msgid "This creates an ext2 external journal on C<device> with UUID C<uuid>."
14958 msgstr ""
14959
14960 # type: =head2
14961 #. type: =head2
14962 #: ../src/guestfs-actions.pod:4400
14963 msgid "guestfs_mkfifo"
14964 msgstr ""
14965
14966 # type: verbatim
14967 #. type: verbatim
14968 #: ../src/guestfs-actions.pod:4402
14969 #, no-wrap
14970 msgid ""
14971 " int\n"
14972 " guestfs_mkfifo (guestfs_h *g,\n"
14973 "                 int mode,\n"
14974 "                 const char *path);\n"
14975 "\n"
14976 msgstr ""
14977
14978 # type: textblock
14979 #. type: textblock
14980 #: ../src/guestfs-actions.pod:4407
14981 msgid ""
14982 "This call creates a FIFO (named pipe) called C<path> with mode C<mode>.  It "
14983 "is just a convenient wrapper around C<guestfs_mknod>."
14984 msgstr ""
14985
14986 # type: =head2
14987 #. type: =head2
14988 #: ../src/guestfs-actions.pod:4417
14989 msgid "guestfs_mkfs"
14990 msgstr ""
14991
14992 # type: verbatim
14993 #. type: verbatim
14994 #: ../src/guestfs-actions.pod:4419
14995 #, no-wrap
14996 msgid ""
14997 " int\n"
14998 " guestfs_mkfs (guestfs_h *g,\n"
14999 "               const char *fstype,\n"
15000 "               const char *device);\n"
15001 "\n"
15002 msgstr ""
15003
15004 # type: textblock
15005 #. type: textblock
15006 #: ../src/guestfs-actions.pod:4424 ../fish/guestfish-actions.pod:3013
15007 msgid ""
15008 "This creates a filesystem on C<device> (usually a partition or LVM logical "
15009 "volume).  The filesystem type is C<fstype>, for example C<ext3>."
15010 msgstr ""
15011
15012 # type: =head2
15013 #. type: =head2
15014 #: ../src/guestfs-actions.pod:4432
15015 msgid "guestfs_mkfs_b"
15016 msgstr ""
15017
15018 # type: verbatim
15019 #. type: verbatim
15020 #: ../src/guestfs-actions.pod:4434
15021 #, no-wrap
15022 msgid ""
15023 " int\n"
15024 " guestfs_mkfs_b (guestfs_h *g,\n"
15025 "                 const char *fstype,\n"
15026 "                 int blocksize,\n"
15027 "                 const char *device);\n"
15028 "\n"
15029 msgstr ""
15030
15031 # type: textblock
15032 #. type: textblock
15033 #: ../src/guestfs-actions.pod:4440
15034 msgid ""
15035 "This call is similar to C<guestfs_mkfs>, but it allows you to control the "
15036 "block size of the resulting filesystem.  Supported block sizes depend on the "
15037 "filesystem type, but typically they are C<1024>, C<2048> or C<4096> only."
15038 msgstr ""
15039
15040 # type: textblock
15041 #. type: textblock
15042 #: ../src/guestfs-actions.pod:4445 ../src/guestfs-actions.pod:4488
15043 #: ../fish/guestfish-actions.pod:3026 ../fish/guestfish-actions.pod:3053
15044 msgid ""
15045 "For VFAT and NTFS the C<blocksize> parameter is treated as the requested "
15046 "cluster size."
15047 msgstr ""
15048
15049 #. type: textblock
15050 #: ../src/guestfs-actions.pod:4450
15051 msgid ""
15052 "This function is deprecated.  In new code, use the L</guestfs_mkfs_opts> "
15053 "call instead."
15054 msgstr ""
15055
15056 # type: =head2
15057 #. type: =head2
15058 #: ../src/guestfs-actions.pod:4459
15059 msgid "guestfs_mkfs_opts"
15060 msgstr ""
15061
15062 # type: verbatim
15063 #. type: verbatim
15064 #: ../src/guestfs-actions.pod:4461
15065 #, no-wrap
15066 msgid ""
15067 " int\n"
15068 " guestfs_mkfs_opts (guestfs_h *g,\n"
15069 "                    const char *fstype,\n"
15070 "                    const char *device,\n"
15071 "                    ...);\n"
15072 "\n"
15073 msgstr ""
15074
15075 #. type: verbatim
15076 #: ../src/guestfs-actions.pod:4472
15077 #, no-wrap
15078 msgid ""
15079 " GUESTFS_MKFS_OPTS_BLOCKSIZE, int blocksize,\n"
15080 " GUESTFS_MKFS_OPTS_FEATURES, const char *features,\n"
15081 "\n"
15082 msgstr ""
15083
15084 # type: textblock
15085 #. type: textblock
15086 #: ../src/guestfs-actions.pod:4475 ../fish/guestfish-actions.pod:3040
15087 msgid ""
15088 "This function creates a filesystem on C<device>.  The filesystem type is "
15089 "C<fstype>, for example C<ext3>."
15090 msgstr ""
15091
15092 # type: =item
15093 #. type: =item
15094 #: ../src/guestfs-actions.pod:4482 ../fish/guestfish-actions.pod:3047
15095 msgid "C<blocksize>"
15096 msgstr ""
15097
15098 # type: textblock
15099 #. type: textblock
15100 #: ../src/guestfs-actions.pod:4484 ../fish/guestfish-actions.pod:3049
15101 msgid ""
15102 "The filesystem block size.  Supported block sizes depend on the filesystem "
15103 "type, but typically they are C<1024>, C<2048> or C<4096> for Linux ext2/3 "
15104 "filesystems."
15105 msgstr ""
15106
15107 #. type: textblock
15108 #: ../src/guestfs-actions.pod:4491 ../fish/guestfish-actions.pod:3056
15109 msgid "For UFS block sizes, please see L<mkfs.ufs(8)>."
15110 msgstr ""
15111
15112 #. type: =item
15113 #: ../src/guestfs-actions.pod:4493 ../fish/guestfish-actions.pod:3058
15114 msgid "C<features>"
15115 msgstr ""
15116
15117 #. type: textblock
15118 #: ../src/guestfs-actions.pod:4495 ../fish/guestfish-actions.pod:3060
15119 msgid "This passes the I<-O> parameter to the external mkfs program."
15120 msgstr ""
15121
15122 #. type: textblock
15123 #: ../src/guestfs-actions.pod:4497 ../fish/guestfish-actions.pod:3062
15124 msgid ""
15125 "For certain filesystem types, this allows extra filesystem features to be "
15126 "selected.  See L<mke2fs(8)> and L<mkfs.ufs(8)> for more details."
15127 msgstr ""
15128
15129 #. type: textblock
15130 #: ../src/guestfs-actions.pod:4501 ../fish/guestfish-actions.pod:3066
15131 msgid ""
15132 "You cannot use this optional parameter with the C<gfs> or C<gfs2> filesystem "
15133 "type."
15134 msgstr ""
15135
15136 #. type: textblock
15137 #: ../src/guestfs-actions.pod:4508
15138 msgid "(Added in 1.7.19)"
15139 msgstr ""
15140
15141 # type: =head2
15142 #. type: =head2
15143 #: ../src/guestfs-actions.pod:4510
15144 msgid "guestfs_mkfs_opts_va"
15145 msgstr ""
15146
15147 # type: verbatim
15148 #. type: verbatim
15149 #: ../src/guestfs-actions.pod:4512
15150 #, no-wrap
15151 msgid ""
15152 " int\n"
15153 " guestfs_mkfs_opts_va (guestfs_h *g,\n"
15154 "                       const char *fstype,\n"
15155 "                       const char *device,\n"
15156 "                       va_list args);\n"
15157 "\n"
15158 msgstr ""
15159
15160 # type: textblock
15161 #. type: textblock
15162 #: ../src/guestfs-actions.pod:4518
15163 msgid "This is the \"va_list variant\" of L</guestfs_mkfs_opts>."
15164 msgstr ""
15165
15166 # type: =head2
15167 #. type: =head2
15168 #: ../src/guestfs-actions.pod:4522
15169 msgid "guestfs_mkfs_opts_argv"
15170 msgstr ""
15171
15172 # type: verbatim
15173 #. type: verbatim
15174 #: ../src/guestfs-actions.pod:4524
15175 #, no-wrap
15176 msgid ""
15177 " int\n"
15178 " guestfs_mkfs_opts_argv (guestfs_h *g,\n"
15179 "                         const char *fstype,\n"
15180 "                         const char *device,\n"
15181 "                         const struct guestfs_mkfs_opts_argv *optargs);\n"
15182 "\n"
15183 msgstr ""
15184
15185 # type: textblock
15186 #. type: textblock
15187 #: ../src/guestfs-actions.pod:4530
15188 msgid "This is the \"argv variant\" of L</guestfs_mkfs_opts>."
15189 msgstr ""
15190
15191 # type: =head2
15192 #. type: =head2
15193 #: ../src/guestfs-actions.pod:4534
15194 msgid "guestfs_mkmountpoint"
15195 msgstr ""
15196
15197 # type: verbatim
15198 #. type: verbatim
15199 #: ../src/guestfs-actions.pod:4536
15200 #, no-wrap
15201 msgid ""
15202 " int\n"
15203 " guestfs_mkmountpoint (guestfs_h *g,\n"
15204 "                       const char *exemptpath);\n"
15205 "\n"
15206 msgstr ""
15207
15208 # type: textblock
15209 #. type: textblock
15210 #: ../src/guestfs-actions.pod:4540
15211 msgid ""
15212 "C<guestfs_mkmountpoint> and C<guestfs_rmmountpoint> are specialized calls "
15213 "that can be used to create extra mountpoints before mounting the first "
15214 "filesystem."
15215 msgstr ""
15216
15217 # type: textblock
15218 #. type: textblock
15219 #: ../src/guestfs-actions.pod:4544 ../fish/guestfish-actions.pod:3081
15220 msgid ""
15221 "These calls are I<only> necessary in some very limited circumstances, mainly "
15222 "the case where you want to mount a mix of unrelated and/or read-only "
15223 "filesystems together."
15224 msgstr ""
15225
15226 # type: textblock
15227 #. type: textblock
15228 #: ../src/guestfs-actions.pod:4548 ../fish/guestfish-actions.pod:3085
15229 msgid ""
15230 "For example, live CDs often contain a \"Russian doll\" nest of filesystems, "
15231 "an ISO outer layer, with a squashfs image inside, with an ext2/3 image "
15232 "inside that.  You can unpack this as follows in guestfish:"
15233 msgstr ""
15234
15235 # type: verbatim
15236 #. type: verbatim
15237 #: ../src/guestfs-actions.pod:4553 ../fish/guestfish-actions.pod:3090
15238 #, no-wrap
15239 msgid ""
15240 " add-ro Fedora-11-i686-Live.iso\n"
15241 " run\n"
15242 " mkmountpoint /cd\n"
15243 " mkmountpoint /sqsh\n"
15244 " mkmountpoint /ext3fs\n"
15245 " mount /dev/sda /cd\n"
15246 " mount-loop /cd/LiveOS/squashfs.img /sqsh\n"
15247 " mount-loop /sqsh/LiveOS/ext3fs.img /ext3fs\n"
15248 "\n"
15249 msgstr ""
15250
15251 # type: textblock
15252 #. type: textblock
15253 #: ../src/guestfs-actions.pod:4562 ../fish/guestfish-actions.pod:3099
15254 msgid "The inner filesystem is now unpacked under the /ext3fs mountpoint."
15255 msgstr ""
15256
15257 # type: textblock
15258 #. type: textblock
15259 #: ../src/guestfs-actions.pod:4564
15260 msgid ""
15261 "C<guestfs_mkmountpoint> is not compatible with C<guestfs_umount_all>.  You "
15262 "may get unexpected errors if you try to mix these calls.  It is safest to "
15263 "manually unmount filesystems and remove mountpoints after use."
15264 msgstr ""
15265
15266 # type: textblock
15267 #. type: textblock
15268 #: ../src/guestfs-actions.pod:4568
15269 msgid ""
15270 "C<guestfs_umount_all> unmounts filesystems by sorting the paths longest "
15271 "first, so for this to work for manual mountpoints, you must ensure that the "
15272 "innermost mountpoints have the longest pathnames, as in the example code "
15273 "above."
15274 msgstr ""
15275
15276 # type: textblock
15277 #. type: textblock
15278 #: ../src/guestfs-actions.pod:4573 ../fish/guestfish-actions.pod:3110
15279 msgid ""
15280 "For more details see L<https://bugzilla.redhat.com/show_bug.cgi?id=599503>"
15281 msgstr ""
15282
15283 #. type: textblock
15284 #: ../src/guestfs-actions.pod:4575
15285 msgid ""
15286 "Autosync [see C<guestfs_set_autosync>, this is set by default on handles] "
15287 "can cause C<guestfs_umount_all> to be called when the handle is closed which "
15288 "can also trigger these issues."
15289 msgstr ""
15290
15291 # type: textblock
15292 #. type: textblock
15293 #: ../src/guestfs-actions.pod:4581 ../src/guestfs-actions.pod:4847
15294 #: ../src/guestfs-actions.pod:5766
15295 msgid "(Added in 1.0.62)"
15296 msgstr ""
15297
15298 # type: =head2
15299 #. type: =head2
15300 #: ../src/guestfs-actions.pod:4583
15301 msgid "guestfs_mknod"
15302 msgstr ""
15303
15304 # type: verbatim
15305 #. type: verbatim
15306 #: ../src/guestfs-actions.pod:4585
15307 #, no-wrap
15308 msgid ""
15309 " int\n"
15310 " guestfs_mknod (guestfs_h *g,\n"
15311 "                int mode,\n"
15312 "                int devmajor,\n"
15313 "                int devminor,\n"
15314 "                const char *path);\n"
15315 "\n"
15316 msgstr ""
15317
15318 # type: textblock
15319 #. type: textblock
15320 #: ../src/guestfs-actions.pod:4592 ../fish/guestfish-actions.pod:3120
15321 msgid ""
15322 "This call creates block or character special devices, or named pipes (FIFOs)."
15323 msgstr ""
15324
15325 # type: textblock
15326 #. type: textblock
15327 #: ../src/guestfs-actions.pod:4595 ../fish/guestfish-actions.pod:3123
15328 msgid ""
15329 "The C<mode> parameter should be the mode, using the standard constants.  "
15330 "C<devmajor> and C<devminor> are the device major and minor numbers, only "
15331 "used when creating block and character special devices."
15332 msgstr ""
15333
15334 # type: textblock
15335 #. type: textblock
15336 #: ../src/guestfs-actions.pod:4600
15337 msgid ""
15338 "Note that, just like L<mknod(2)>, the mode must be bitwise OR'd with "
15339 "S_IFBLK, S_IFCHR, S_IFIFO or S_IFSOCK (otherwise this call just creates a "
15340 "regular file).  These constants are available in the standard Linux header "
15341 "files, or you can use C<guestfs_mknod_b>, C<guestfs_mknod_c> or "
15342 "C<guestfs_mkfifo> which are wrappers around this command which bitwise OR in "
15343 "the appropriate constant for you."
15344 msgstr ""
15345
15346 # type: =head2
15347 #. type: =head2
15348 #: ../src/guestfs-actions.pod:4614
15349 msgid "guestfs_mknod_b"
15350 msgstr ""
15351
15352 # type: verbatim
15353 #. type: verbatim
15354 #: ../src/guestfs-actions.pod:4616
15355 #, no-wrap
15356 msgid ""
15357 " int\n"
15358 " guestfs_mknod_b (guestfs_h *g,\n"
15359 "                  int mode,\n"
15360 "                  int devmajor,\n"
15361 "                  int devminor,\n"
15362 "                  const char *path);\n"
15363 "\n"
15364 msgstr ""
15365
15366 # type: textblock
15367 #. type: textblock
15368 #: ../src/guestfs-actions.pod:4623
15369 msgid ""
15370 "This call creates a block device node called C<path> with mode C<mode> and "
15371 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
15372 "wrapper around C<guestfs_mknod>."
15373 msgstr ""
15374
15375 # type: =head2
15376 #. type: =head2
15377 #: ../src/guestfs-actions.pod:4633
15378 msgid "guestfs_mknod_c"
15379 msgstr ""
15380
15381 # type: verbatim
15382 #. type: verbatim
15383 #: ../src/guestfs-actions.pod:4635
15384 #, no-wrap
15385 msgid ""
15386 " int\n"
15387 " guestfs_mknod_c (guestfs_h *g,\n"
15388 "                  int mode,\n"
15389 "                  int devmajor,\n"
15390 "                  int devminor,\n"
15391 "                  const char *path);\n"
15392 "\n"
15393 msgstr ""
15394
15395 # type: textblock
15396 #. type: textblock
15397 #: ../src/guestfs-actions.pod:4642
15398 msgid ""
15399 "This call creates a char device node called C<path> with mode C<mode> and "
15400 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
15401 "wrapper around C<guestfs_mknod>."
15402 msgstr ""
15403
15404 # type: =head2
15405 #. type: =head2
15406 #: ../src/guestfs-actions.pod:4652
15407 msgid "guestfs_mkswap"
15408 msgstr ""
15409
15410 # type: verbatim
15411 #. type: verbatim
15412 #: ../src/guestfs-actions.pod:4654
15413 #, no-wrap
15414 msgid ""
15415 " int\n"
15416 " guestfs_mkswap (guestfs_h *g,\n"
15417 "                 const char *device);\n"
15418 "\n"
15419 msgstr ""
15420
15421 # type: textblock
15422 #. type: textblock
15423 #: ../src/guestfs-actions.pod:4658 ../fish/guestfish-actions.pod:3162
15424 msgid "Create a swap partition on C<device>."
15425 msgstr ""
15426
15427 # type: =head2
15428 #. type: =head2
15429 #: ../src/guestfs-actions.pod:4664
15430 msgid "guestfs_mkswap_L"
15431 msgstr ""
15432
15433 # type: verbatim
15434 #. type: verbatim
15435 #: ../src/guestfs-actions.pod:4666
15436 #, no-wrap
15437 msgid ""
15438 " int\n"
15439 " guestfs_mkswap_L (guestfs_h *g,\n"
15440 "                   const char *label,\n"
15441 "                   const char *device);\n"
15442 "\n"
15443 msgstr ""
15444
15445 # type: textblock
15446 #. type: textblock
15447 #: ../src/guestfs-actions.pod:4671 ../fish/guestfish-actions.pod:3168
15448 msgid "Create a swap partition on C<device> with label C<label>."
15449 msgstr ""
15450
15451 # type: textblock
15452 #. type: textblock
15453 #: ../src/guestfs-actions.pod:4673 ../fish/guestfish-actions.pod:3170
15454 msgid ""
15455 "Note that you cannot attach a swap label to a block device (eg. C</dev/"
15456 "sda>), just to a partition.  This appears to be a limitation of the kernel "
15457 "or swap tools."
15458 msgstr ""
15459
15460 # type: =head2
15461 #. type: =head2
15462 #: ../src/guestfs-actions.pod:4681
15463 msgid "guestfs_mkswap_U"
15464 msgstr ""
15465
15466 # type: verbatim
15467 #. type: verbatim
15468 #: ../src/guestfs-actions.pod:4683
15469 #, no-wrap
15470 msgid ""
15471 " int\n"
15472 " guestfs_mkswap_U (guestfs_h *g,\n"
15473 "                   const char *uuid,\n"
15474 "                   const char *device);\n"
15475 "\n"
15476 msgstr ""
15477
15478 # type: textblock
15479 #. type: textblock
15480 #: ../src/guestfs-actions.pod:4688 ../fish/guestfish-actions.pod:3178
15481 msgid "Create a swap partition on C<device> with UUID C<uuid>."
15482 msgstr ""
15483
15484 # type: =head2
15485 #. type: =head2
15486 #: ../src/guestfs-actions.pod:4694
15487 msgid "guestfs_mkswap_file"
15488 msgstr ""
15489
15490 # type: verbatim
15491 #. type: verbatim
15492 #: ../src/guestfs-actions.pod:4696
15493 #, no-wrap
15494 msgid ""
15495 " int\n"
15496 " guestfs_mkswap_file (guestfs_h *g,\n"
15497 "                      const char *path);\n"
15498 "\n"
15499 msgstr ""
15500
15501 # type: textblock
15502 #. type: textblock
15503 #: ../src/guestfs-actions.pod:4700 ../fish/guestfish-actions.pod:3184
15504 msgid "Create a swap file."
15505 msgstr ""
15506
15507 # type: textblock
15508 #. type: textblock
15509 #: ../src/guestfs-actions.pod:4702
15510 msgid ""
15511 "This command just writes a swap file signature to an existing file.  To "
15512 "create the file itself, use something like C<guestfs_fallocate>."
15513 msgstr ""
15514
15515 # type: =head2
15516 #. type: =head2
15517 #: ../src/guestfs-actions.pod:4709
15518 msgid "guestfs_modprobe"
15519 msgstr ""
15520
15521 # type: verbatim
15522 #. type: verbatim
15523 #: ../src/guestfs-actions.pod:4711
15524 #, no-wrap
15525 msgid ""
15526 " int\n"
15527 " guestfs_modprobe (guestfs_h *g,\n"
15528 "                   const char *modulename);\n"
15529 "\n"
15530 msgstr ""
15531
15532 # type: textblock
15533 #. type: textblock
15534 #: ../src/guestfs-actions.pod:4715 ../fish/guestfish-actions.pod:3193
15535 msgid "This loads a kernel module in the appliance."
15536 msgstr ""
15537
15538 # type: textblock
15539 #. type: textblock
15540 #: ../src/guestfs-actions.pod:4717 ../fish/guestfish-actions.pod:3195
15541 msgid ""
15542 "The kernel module must have been whitelisted when libguestfs was built (see "
15543 "C<appliance/kmod.whitelist.in> in the source)."
15544 msgstr ""
15545
15546 # type: =head2
15547 #. type: =head2
15548 #: ../src/guestfs-actions.pod:4724
15549 msgid "guestfs_mount"
15550 msgstr ""
15551
15552 # type: verbatim
15553 #. type: verbatim
15554 #: ../src/guestfs-actions.pod:4726
15555 #, no-wrap
15556 msgid ""
15557 " int\n"
15558 " guestfs_mount (guestfs_h *g,\n"
15559 "                const char *device,\n"
15560 "                const char *mountpoint);\n"
15561 "\n"
15562 msgstr ""
15563
15564 # type: textblock
15565 #. type: textblock
15566 #: ../src/guestfs-actions.pod:4731 ../fish/guestfish-actions.pod:3202
15567 msgid ""
15568 "Mount a guest disk at a position in the filesystem.  Block devices are named "
15569 "C</dev/sda>, C</dev/sdb> and so on, as they were added to the guest.  If "
15570 "those block devices contain partitions, they will have the usual names (eg. "
15571 "C</dev/sda1>).  Also LVM C</dev/VG/LV>-style names can be used."
15572 msgstr ""
15573
15574 # type: textblock
15575 #. type: textblock
15576 #: ../src/guestfs-actions.pod:4737 ../fish/guestfish-actions.pod:3208
15577 msgid ""
15578 "The rules are the same as for L<mount(2)>: A filesystem must first be "
15579 "mounted on C</> before others can be mounted.  Other filesystems can only be "
15580 "mounted on directories which already exist."
15581 msgstr ""
15582
15583 # type: textblock
15584 #. type: textblock
15585 #: ../src/guestfs-actions.pod:4742 ../fish/guestfish-actions.pod:3213
15586 msgid ""
15587 "The mounted filesystem is writable, if we have sufficient permissions on the "
15588 "underlying device."
15589 msgstr ""
15590
15591 # type: textblock
15592 #. type: textblock
15593 #: ../src/guestfs-actions.pod:4745
15594 msgid ""
15595 "B<Important note:> When you use this call, the filesystem options C<sync> "
15596 "and C<noatime> are set implicitly.  This was originally done because we "
15597 "thought it would improve reliability, but it turns out that I<-o sync> has a "
15598 "very large negative performance impact and negligible effect on "
15599 "reliability.  Therefore we recommend that you avoid using C<guestfs_mount> "
15600 "in any code that needs performance, and instead use C<guestfs_mount_options> "
15601 "(use an empty string for the first parameter if you don't want any options)."
15602 msgstr ""
15603
15604 #. type: textblock
15605 #: ../src/guestfs-actions.pod:4757
15606 msgid ""
15607 "This function is deprecated.  In new code, use the L</guestfs_mount_options> "
15608 "call instead."
15609 msgstr ""
15610
15611 # type: =head2
15612 #. type: =head2
15613 #: ../src/guestfs-actions.pod:4766
15614 msgid "guestfs_mount_loop"
15615 msgstr ""
15616
15617 # type: verbatim
15618 #. type: verbatim
15619 #: ../src/guestfs-actions.pod:4768
15620 #, no-wrap
15621 msgid ""
15622 " int\n"
15623 " guestfs_mount_loop (guestfs_h *g,\n"
15624 "                     const char *file,\n"
15625 "                     const char *mountpoint);\n"
15626 "\n"
15627 msgstr ""
15628
15629 # type: textblock
15630 #. type: textblock
15631 #: ../src/guestfs-actions.pod:4773 ../fish/guestfish-actions.pod:3237
15632 msgid ""
15633 "This command lets you mount C<file> (a filesystem image in a file) on a "
15634 "mount point.  It is entirely equivalent to the command C<mount -o loop file "
15635 "mountpoint>."
15636 msgstr ""
15637
15638 # type: =head2
15639 #. type: =head2
15640 #: ../src/guestfs-actions.pod:4781
15641 msgid "guestfs_mount_options"
15642 msgstr ""
15643
15644 # type: verbatim
15645 #. type: verbatim
15646 #: ../src/guestfs-actions.pod:4783
15647 #, no-wrap
15648 msgid ""
15649 " int\n"
15650 " guestfs_mount_options (guestfs_h *g,\n"
15651 "                        const char *options,\n"
15652 "                        const char *device,\n"
15653 "                        const char *mountpoint);\n"
15654 "\n"
15655 msgstr ""
15656
15657 # type: textblock
15658 #. type: textblock
15659 #: ../src/guestfs-actions.pod:4789
15660 msgid ""
15661 "This is the same as the C<guestfs_mount> command, but it allows you to set "
15662 "the mount options as for the L<mount(8)> I<-o> flag."
15663 msgstr ""
15664
15665 # type: textblock
15666 #. type: textblock
15667 #: ../src/guestfs-actions.pod:4793 ../fish/guestfish-actions.pod:3249
15668 msgid ""
15669 "If the C<options> parameter is an empty string, then no options are passed "
15670 "(all options default to whatever the filesystem uses)."
15671 msgstr ""
15672
15673 # type: textblock
15674 #. type: textblock
15675 #: ../src/guestfs-actions.pod:4799 ../src/guestfs-actions.pod:4813
15676 #: ../src/guestfs-actions.pod:4830
15677 msgid "(Added in 1.0.10)"
15678 msgstr ""
15679
15680 # type: =head2
15681 #. type: =head2
15682 #: ../src/guestfs-actions.pod:4801
15683 msgid "guestfs_mount_ro"
15684 msgstr ""
15685
15686 # type: verbatim
15687 #. type: verbatim
15688 #: ../src/guestfs-actions.pod:4803
15689 #, no-wrap
15690 msgid ""
15691 " int\n"
15692 " guestfs_mount_ro (guestfs_h *g,\n"
15693 "                   const char *device,\n"
15694 "                   const char *mountpoint);\n"
15695 "\n"
15696 msgstr ""
15697
15698 # type: textblock
15699 #. type: textblock
15700 #: ../src/guestfs-actions.pod:4808
15701 msgid ""
15702 "This is the same as the C<guestfs_mount> command, but it mounts the "
15703 "filesystem with the read-only (I<-o ro>) flag."
15704 msgstr ""
15705
15706 # type: =head2
15707 #. type: =head2
15708 #: ../src/guestfs-actions.pod:4815
15709 msgid "guestfs_mount_vfs"
15710 msgstr ""
15711
15712 # type: verbatim
15713 #. type: verbatim
15714 #: ../src/guestfs-actions.pod:4817
15715 #, no-wrap
15716 msgid ""
15717 " int\n"
15718 " guestfs_mount_vfs (guestfs_h *g,\n"
15719 "                    const char *options,\n"
15720 "                    const char *vfstype,\n"
15721 "                    const char *device,\n"
15722 "                    const char *mountpoint);\n"
15723 "\n"
15724 msgstr ""
15725
15726 # type: textblock
15727 #. type: textblock
15728 #: ../src/guestfs-actions.pod:4824
15729 msgid ""
15730 "This is the same as the C<guestfs_mount> command, but it allows you to set "
15731 "both the mount options and the vfstype as for the L<mount(8)> I<-o> and I<-"
15732 "t> flags."
15733 msgstr ""
15734
15735 # type: =head2
15736 #. type: =head2
15737 #: ../src/guestfs-actions.pod:4832
15738 msgid "guestfs_mountpoints"
15739 msgstr ""
15740
15741 # type: verbatim
15742 #. type: verbatim
15743 #: ../src/guestfs-actions.pod:4834
15744 #, no-wrap
15745 msgid ""
15746 " char **\n"
15747 " guestfs_mountpoints (guestfs_h *g);\n"
15748 "\n"
15749 msgstr ""
15750
15751 # type: textblock
15752 #. type: textblock
15753 #: ../src/guestfs-actions.pod:4837
15754 msgid ""
15755 "This call is similar to C<guestfs_mounts>.  That call returns a list of "
15756 "devices.  This one returns a hash table (map) of device name to directory "
15757 "where the device is mounted."
15758 msgstr ""
15759
15760 # type: =head2
15761 #. type: =head2
15762 #: ../src/guestfs-actions.pod:4849
15763 msgid "guestfs_mounts"
15764 msgstr ""
15765
15766 # type: verbatim
15767 #. type: verbatim
15768 #: ../src/guestfs-actions.pod:4851
15769 #, no-wrap
15770 msgid ""
15771 " char **\n"
15772 " guestfs_mounts (guestfs_h *g);\n"
15773 "\n"
15774 msgstr ""
15775
15776 # type: textblock
15777 #. type: textblock
15778 #: ../src/guestfs-actions.pod:4854 ../fish/guestfish-actions.pod:3280
15779 msgid ""
15780 "This returns the list of currently mounted filesystems.  It returns the list "
15781 "of devices (eg. C</dev/sda1>, C</dev/VG/LV>)."
15782 msgstr ""
15783
15784 # type: textblock
15785 #. type: textblock
15786 #: ../src/guestfs-actions.pod:4857 ../fish/guestfish-actions.pod:3283
15787 msgid "Some internal mounts are not shown."
15788 msgstr ""
15789
15790 # type: textblock
15791 #. type: textblock
15792 #: ../src/guestfs-actions.pod:4859
15793 msgid "See also: C<guestfs_mountpoints>"
15794 msgstr ""
15795
15796 # type: =head2
15797 #. type: =head2
15798 #: ../src/guestfs-actions.pod:4867
15799 msgid "guestfs_mv"
15800 msgstr ""
15801
15802 # type: verbatim
15803 #. type: verbatim
15804 #: ../src/guestfs-actions.pod:4869
15805 #, no-wrap
15806 msgid ""
15807 " int\n"
15808 " guestfs_mv (guestfs_h *g,\n"
15809 "             const char *src,\n"
15810 "             const char *dest);\n"
15811 "\n"
15812 msgstr ""
15813
15814 # type: textblock
15815 #. type: textblock
15816 #: ../src/guestfs-actions.pod:4874 ../fish/guestfish-actions.pod:3291
15817 msgid ""
15818 "This moves a file from C<src> to C<dest> where C<dest> is either a "
15819 "destination filename or destination directory."
15820 msgstr ""
15821
15822 # type: =head2
15823 #. type: =head2
15824 #: ../src/guestfs-actions.pod:4881
15825 msgid "guestfs_ntfs_3g_probe"
15826 msgstr ""
15827
15828 # type: verbatim
15829 #. type: verbatim
15830 #: ../src/guestfs-actions.pod:4883
15831 #, no-wrap
15832 msgid ""
15833 " int\n"
15834 " guestfs_ntfs_3g_probe (guestfs_h *g,\n"
15835 "                        int rw,\n"
15836 "                        const char *device);\n"
15837 "\n"
15838 msgstr ""
15839
15840 # type: textblock
15841 #. type: textblock
15842 #: ../src/guestfs-actions.pod:4888 ../fish/guestfish-actions.pod:3298
15843 msgid ""
15844 "This command runs the L<ntfs-3g.probe(8)> command which probes an NTFS "
15845 "C<device> for mountability.  (Not all NTFS volumes can be mounted read-"
15846 "write, and some cannot be mounted at all)."
15847 msgstr ""
15848
15849 # type: textblock
15850 #. type: textblock
15851 #: ../src/guestfs-actions.pod:4892 ../fish/guestfish-actions.pod:3302
15852 msgid ""
15853 "C<rw> is a boolean flag.  Set it to true if you want to test if the volume "
15854 "can be mounted read-write.  Set it to false if you want to test if the "
15855 "volume can be mounted read-only."
15856 msgstr ""
15857
15858 # type: textblock
15859 #. type: textblock
15860 #: ../src/guestfs-actions.pod:4896 ../fish/guestfish-actions.pod:3306
15861 msgid ""
15862 "The return value is an integer which C<0> if the operation would succeed, or "
15863 "some non-zero value documented in the L<ntfs-3g.probe(8)> manual page."
15864 msgstr ""
15865
15866 # type: textblock
15867 #. type: textblock
15868 #: ../src/guestfs-actions.pod:4902
15869 msgid "(Added in 1.0.43)"
15870 msgstr ""
15871
15872 # type: =head2
15873 #. type: =head2
15874 #: ../src/guestfs-actions.pod:4904
15875 msgid "guestfs_ntfsresize"
15876 msgstr ""
15877
15878 # type: verbatim
15879 #. type: verbatim
15880 #: ../src/guestfs-actions.pod:4906
15881 #, no-wrap
15882 msgid ""
15883 " int\n"
15884 " guestfs_ntfsresize (guestfs_h *g,\n"
15885 "                     const char *device);\n"
15886 "\n"
15887 msgstr ""
15888
15889 #. type: textblock
15890 #: ../src/guestfs-actions.pod:4910 ../fish/guestfish-actions.pod:3314
15891 msgid ""
15892 "This command resizes an NTFS filesystem, expanding or shrinking it to the "
15893 "size of the underlying device."
15894 msgstr ""
15895
15896 #. type: textblock
15897 #: ../src/guestfs-actions.pod:4913 ../fish/guestfish-actions.pod:3317
15898 msgid ""
15899 "I<Note:> After the resize operation, the filesystem is marked as requiring a "
15900 "consistency check (for safety).  You have to boot into Windows to perform "
15901 "this check and clear this condition.  Furthermore, ntfsresize refuses to "
15902 "resize filesystems which have been marked in this way.  So in effect it is "
15903 "not possible to call ntfsresize multiple times on a single filesystem "
15904 "without booting into Windows between each resize."
15905 msgstr ""
15906
15907 #. type: textblock
15908 #: ../src/guestfs-actions.pod:4921 ../fish/guestfish-actions.pod:3325
15909 msgid "See also L<ntfsresize(8)>."
15910 msgstr ""
15911
15912 # type: =head2
15913 #. type: =head2
15914 #: ../src/guestfs-actions.pod:4927
15915 msgid "guestfs_ntfsresize_size"
15916 msgstr ""
15917
15918 # type: verbatim
15919 #. type: verbatim
15920 #: ../src/guestfs-actions.pod:4929
15921 #, no-wrap
15922 msgid ""
15923 " int\n"
15924 " guestfs_ntfsresize_size (guestfs_h *g,\n"
15925 "                          const char *device,\n"
15926 "                          int64_t size);\n"
15927 "\n"
15928 msgstr ""
15929
15930 # type: textblock
15931 #. type: textblock
15932 #: ../src/guestfs-actions.pod:4934
15933 msgid ""
15934 "This command is the same as C<guestfs_ntfsresize> except that it allows you "
15935 "to specify the new size (in bytes) explicitly."
15936 msgstr ""
15937
15938 # type: textblock
15939 #. type: textblock
15940 #: ../src/guestfs-actions.pod:4939 ../src/guestfs-actions.pod:5375
15941 #: ../src/guestfs-actions.pod:5448 ../src/guestfs-actions.pod:5714
15942 #: ../src/guestfs-actions.pod:7320
15943 msgid "(Added in 1.3.14)"
15944 msgstr ""
15945
15946 # type: =head2
15947 #. type: =head2
15948 #: ../src/guestfs-actions.pod:4941
15949 msgid "guestfs_part_add"
15950 msgstr ""
15951
15952 # type: verbatim
15953 #. type: verbatim
15954 #: ../src/guestfs-actions.pod:4943
15955 #, no-wrap
15956 msgid ""
15957 " int\n"
15958 " guestfs_part_add (guestfs_h *g,\n"
15959 "                   const char *device,\n"
15960 "                   const char *prlogex,\n"
15961 "                   int64_t startsect,\n"
15962 "                   int64_t endsect);\n"
15963 "\n"
15964 msgstr ""
15965
15966 # type: textblock
15967 #. type: textblock
15968 #: ../src/guestfs-actions.pod:4950
15969 msgid ""
15970 "This command adds a partition to C<device>.  If there is no partition table "
15971 "on the device, call C<guestfs_part_init> first."
15972 msgstr ""
15973
15974 # type: textblock
15975 #. type: textblock
15976 #: ../src/guestfs-actions.pod:4953 ../fish/guestfish-actions.pod:3341
15977 msgid ""
15978 "The C<prlogex> parameter is the type of partition.  Normally you should pass "
15979 "C<p> or C<primary> here, but MBR partition tables also support C<l> (or "
15980 "C<logical>) and C<e> (or C<extended>) partition types."
15981 msgstr ""
15982
15983 # type: textblock
15984 #. type: textblock
15985 #: ../src/guestfs-actions.pod:4958 ../fish/guestfish-actions.pod:3346
15986 msgid ""
15987 "C<startsect> and C<endsect> are the start and end of the partition in "
15988 "I<sectors>.  C<endsect> may be negative, which means it counts backwards "
15989 "from the end of the disk (C<-1> is the last sector)."
15990 msgstr ""
15991
15992 # type: textblock
15993 #. type: textblock
15994 #: ../src/guestfs-actions.pod:4962
15995 msgid ""
15996 "Creating a partition which covers the whole disk is not so easy.  Use "
15997 "C<guestfs_part_disk> to do that."
15998 msgstr ""
15999
16000 # type: textblock
16001 #. type: textblock
16002 #: ../src/guestfs-actions.pod:4967 ../src/guestfs-actions.pod:5005
16003 #: ../src/guestfs-actions.pod:5058 ../src/guestfs-actions.pod:5136
16004 #: ../src/guestfs-actions.pod:5174 ../src/guestfs-actions.pod:5193
16005 #: ../src/guestfs-actions.pod:5233
16006 msgid "(Added in 1.0.78)"
16007 msgstr ""
16008
16009 # type: =head2
16010 #. type: =head2
16011 #: ../src/guestfs-actions.pod:4969
16012 msgid "guestfs_part_del"
16013 msgstr ""
16014
16015 # type: verbatim
16016 #. type: verbatim
16017 #: ../src/guestfs-actions.pod:4971
16018 #, no-wrap
16019 msgid ""
16020 " int\n"
16021 " guestfs_part_del (guestfs_h *g,\n"
16022 "                   const char *device,\n"
16023 "                   int partnum);\n"
16024 "\n"
16025 msgstr ""
16026
16027 # type: textblock
16028 #. type: textblock
16029 #: ../src/guestfs-actions.pod:4976 ../fish/guestfish-actions.pod:3357
16030 msgid "This command deletes the partition numbered C<partnum> on C<device>."
16031 msgstr ""
16032
16033 # type: textblock
16034 #. type: textblock
16035 #: ../src/guestfs-actions.pod:4978 ../fish/guestfish-actions.pod:3359
16036 msgid ""
16037 "Note that in the case of MBR partitioning, deleting an extended partition "
16038 "also deletes any logical partitions it contains."
16039 msgstr ""
16040
16041 # type: =head2
16042 #. type: =head2
16043 #: ../src/guestfs-actions.pod:4986
16044 msgid "guestfs_part_disk"
16045 msgstr ""
16046
16047 # type: verbatim
16048 #. type: verbatim
16049 #: ../src/guestfs-actions.pod:4988
16050 #, no-wrap
16051 msgid ""
16052 " int\n"
16053 " guestfs_part_disk (guestfs_h *g,\n"
16054 "                    const char *device,\n"
16055 "                    const char *parttype);\n"
16056 "\n"
16057 msgstr ""
16058
16059 # type: textblock
16060 #. type: textblock
16061 #: ../src/guestfs-actions.pod:4993
16062 msgid ""
16063 "This command is simply a combination of C<guestfs_part_init> followed by "
16064 "C<guestfs_part_add> to create a single primary partition covering the whole "
16065 "disk."
16066 msgstr ""
16067
16068 # type: textblock
16069 #. type: textblock
16070 #: ../src/guestfs-actions.pod:4997
16071 msgid ""
16072 "C<parttype> is the partition table type, usually C<mbr> or C<gpt>, but other "
16073 "possible values are described in C<guestfs_part_init>."
16074 msgstr ""
16075
16076 # type: =head2
16077 #. type: =head2
16078 #: ../src/guestfs-actions.pod:5007
16079 msgid "guestfs_part_get_bootable"
16080 msgstr ""
16081
16082 # type: verbatim
16083 #. type: verbatim
16084 #: ../src/guestfs-actions.pod:5009
16085 #, no-wrap
16086 msgid ""
16087 " int\n"
16088 " guestfs_part_get_bootable (guestfs_h *g,\n"
16089 "                            const char *device,\n"
16090 "                            int partnum);\n"
16091 "\n"
16092 msgstr ""
16093
16094 # type: textblock
16095 #. type: textblock
16096 #: ../src/guestfs-actions.pod:5014 ../fish/guestfish-actions.pod:3381
16097 msgid ""
16098 "This command returns true if the partition C<partnum> on C<device> has the "
16099 "bootable flag set."
16100 msgstr ""
16101
16102 # type: textblock
16103 #. type: textblock
16104 #: ../src/guestfs-actions.pod:5017
16105 msgid "See also C<guestfs_part_set_bootable>."
16106 msgstr ""
16107
16108 # type: =head2
16109 #. type: =head2
16110 #: ../src/guestfs-actions.pod:5023
16111 msgid "guestfs_part_get_mbr_id"
16112 msgstr ""
16113
16114 # type: verbatim
16115 #. type: verbatim
16116 #: ../src/guestfs-actions.pod:5025
16117 #, no-wrap
16118 msgid ""
16119 " int\n"
16120 " guestfs_part_get_mbr_id (guestfs_h *g,\n"
16121 "                          const char *device,\n"
16122 "                          int partnum);\n"
16123 "\n"
16124 msgstr ""
16125
16126 # type: textblock
16127 #. type: textblock
16128 #: ../src/guestfs-actions.pod:5030 ../fish/guestfish-actions.pod:3390
16129 msgid ""
16130 "Returns the MBR type byte (also known as the ID byte) from the numbered "
16131 "partition C<partnum>."
16132 msgstr ""
16133
16134 # type: textblock
16135 #. type: textblock
16136 #: ../src/guestfs-actions.pod:5033 ../src/guestfs-actions.pod:5209
16137 msgid ""
16138 "Note that only MBR (old DOS-style) partitions have type bytes.  You will get "
16139 "undefined results for other partition table types (see "
16140 "C<guestfs_part_get_parttype>)."
16141 msgstr ""
16142
16143 # type: =head2
16144 #. type: =head2
16145 #: ../src/guestfs-actions.pod:5041
16146 msgid "guestfs_part_get_parttype"
16147 msgstr ""
16148
16149 # type: verbatim
16150 #. type: verbatim
16151 #: ../src/guestfs-actions.pod:5043
16152 #, no-wrap
16153 msgid ""
16154 " char *\n"
16155 " guestfs_part_get_parttype (guestfs_h *g,\n"
16156 "                            const char *device);\n"
16157 "\n"
16158 msgstr ""
16159
16160 # type: textblock
16161 #. type: textblock
16162 #: ../src/guestfs-actions.pod:5047 ../fish/guestfish-actions.pod:3401
16163 msgid ""
16164 "This command examines the partition table on C<device> and returns the "
16165 "partition table type (format) being used."
16166 msgstr ""
16167
16168 # type: textblock
16169 #. type: textblock
16170 #: ../src/guestfs-actions.pod:5050
16171 msgid ""
16172 "Common return values include: C<msdos> (a DOS/Windows style MBR partition "
16173 "table), C<gpt> (a GPT/EFI-style partition table).  Other values are "
16174 "possible, although unusual.  See C<guestfs_part_init> for a full list."
16175 msgstr ""
16176
16177 # type: =head2
16178 #. type: =head2
16179 #: ../src/guestfs-actions.pod:5060
16180 msgid "guestfs_part_init"
16181 msgstr ""
16182
16183 # type: verbatim
16184 #. type: verbatim
16185 #: ../src/guestfs-actions.pod:5062
16186 #, no-wrap
16187 msgid ""
16188 " int\n"
16189 " guestfs_part_init (guestfs_h *g,\n"
16190 "                    const char *device,\n"
16191 "                    const char *parttype);\n"
16192 "\n"
16193 msgstr ""
16194
16195 # type: textblock
16196 #. type: textblock
16197 #: ../src/guestfs-actions.pod:5067 ../fish/guestfish-actions.pod:3413
16198 msgid ""
16199 "This creates an empty partition table on C<device> of one of the partition "
16200 "types listed below.  Usually C<parttype> should be either C<msdos> or C<gpt> "
16201 "(for large disks)."
16202 msgstr ""
16203
16204 # type: textblock
16205 #. type: textblock
16206 #: ../src/guestfs-actions.pod:5071
16207 msgid ""
16208 "Initially there are no partitions.  Following this, you should call "
16209 "C<guestfs_part_add> for each partition required."
16210 msgstr ""
16211
16212 # type: textblock
16213 #. type: textblock
16214 #: ../src/guestfs-actions.pod:5074 ../fish/guestfish-actions.pod:3420
16215 msgid "Possible values for C<parttype> are:"
16216 msgstr ""
16217
16218 # type: =item
16219 #. type: =item
16220 #: ../src/guestfs-actions.pod:5078 ../fish/guestfish-actions.pod:3424
16221 msgid "B<efi> | B<gpt>"
16222 msgstr ""
16223
16224 # type: textblock
16225 #. type: textblock
16226 #: ../src/guestfs-actions.pod:5080 ../fish/guestfish-actions.pod:3426
16227 msgid "Intel EFI / GPT partition table."
16228 msgstr ""
16229
16230 # type: textblock
16231 #. type: textblock
16232 #: ../src/guestfs-actions.pod:5082 ../fish/guestfish-actions.pod:3428
16233 msgid ""
16234 "This is recommended for >= 2 TB partitions that will be accessed from Linux "
16235 "and Intel-based Mac OS X.  It also has limited backwards compatibility with "
16236 "the C<mbr> format."
16237 msgstr ""
16238
16239 # type: =item
16240 #. type: =item
16241 #: ../src/guestfs-actions.pod:5086 ../fish/guestfish-actions.pod:3432
16242 msgid "B<mbr> | B<msdos>"
16243 msgstr ""
16244
16245 # type: textblock
16246 #. type: textblock
16247 #: ../src/guestfs-actions.pod:5088 ../fish/guestfish-actions.pod:3434
16248 msgid ""
16249 "The standard PC \"Master Boot Record\" (MBR) format used by MS-DOS and "
16250 "Windows.  This partition type will B<only> work for device sizes up to 2 "
16251 "TB.  For large disks we recommend using C<gpt>."
16252 msgstr ""
16253
16254 # type: textblock
16255 #. type: textblock
16256 #: ../src/guestfs-actions.pod:5095 ../fish/guestfish-actions.pod:3441
16257 msgid ""
16258 "Other partition table types that may work but are not supported include:"
16259 msgstr ""
16260
16261 # type: =item
16262 #. type: =item
16263 #: ../src/guestfs-actions.pod:5100 ../fish/guestfish-actions.pod:3446
16264 msgid "B<aix>"
16265 msgstr ""
16266
16267 # type: textblock
16268 #. type: textblock
16269 #: ../src/guestfs-actions.pod:5102 ../fish/guestfish-actions.pod:3448
16270 msgid "AIX disk labels."
16271 msgstr ""
16272
16273 # type: =item
16274 #. type: =item
16275 #: ../src/guestfs-actions.pod:5104 ../fish/guestfish-actions.pod:3450
16276 msgid "B<amiga> | B<rdb>"
16277 msgstr ""
16278
16279 # type: textblock
16280 #. type: textblock
16281 #: ../src/guestfs-actions.pod:5106 ../fish/guestfish-actions.pod:3452
16282 msgid "Amiga \"Rigid Disk Block\" format."
16283 msgstr ""
16284
16285 # type: =item
16286 #. type: =item
16287 #: ../src/guestfs-actions.pod:5108 ../fish/guestfish-actions.pod:3454
16288 msgid "B<bsd>"
16289 msgstr ""
16290
16291 # type: textblock
16292 #. type: textblock
16293 #: ../src/guestfs-actions.pod:5110 ../fish/guestfish-actions.pod:3456
16294 msgid "BSD disk labels."
16295 msgstr ""
16296
16297 # type: =item
16298 #. type: =item
16299 #: ../src/guestfs-actions.pod:5112 ../fish/guestfish-actions.pod:3458
16300 msgid "B<dasd>"
16301 msgstr ""
16302
16303 # type: textblock
16304 #. type: textblock
16305 #: ../src/guestfs-actions.pod:5114 ../fish/guestfish-actions.pod:3460
16306 msgid "DASD, used on IBM mainframes."
16307 msgstr ""
16308
16309 # type: =item
16310 #. type: =item
16311 #: ../src/guestfs-actions.pod:5116 ../fish/guestfish-actions.pod:3462
16312 msgid "B<dvh>"
16313 msgstr ""
16314
16315 # type: textblock
16316 #. type: textblock
16317 #: ../src/guestfs-actions.pod:5118 ../fish/guestfish-actions.pod:3464
16318 msgid "MIPS/SGI volumes."
16319 msgstr ""
16320
16321 # type: =item
16322 #. type: =item
16323 #: ../src/guestfs-actions.pod:5120 ../fish/guestfish-actions.pod:3466
16324 msgid "B<mac>"
16325 msgstr ""
16326
16327 # type: textblock
16328 #. type: textblock
16329 #: ../src/guestfs-actions.pod:5122 ../fish/guestfish-actions.pod:3468
16330 msgid "Old Mac partition format.  Modern Macs use C<gpt>."
16331 msgstr ""
16332
16333 # type: =item
16334 #. type: =item
16335 #: ../src/guestfs-actions.pod:5124 ../fish/guestfish-actions.pod:3470
16336 msgid "B<pc98>"
16337 msgstr ""
16338
16339 # type: textblock
16340 #. type: textblock
16341 #: ../src/guestfs-actions.pod:5126 ../fish/guestfish-actions.pod:3472
16342 msgid "NEC PC-98 format, common in Japan apparently."
16343 msgstr ""
16344
16345 # type: =item
16346 #. type: =item
16347 #: ../src/guestfs-actions.pod:5128 ../fish/guestfish-actions.pod:3474
16348 msgid "B<sun>"
16349 msgstr ""
16350
16351 # type: textblock
16352 #. type: textblock
16353 #: ../src/guestfs-actions.pod:5130 ../fish/guestfish-actions.pod:3476
16354 msgid "Sun disk labels."
16355 msgstr ""
16356
16357 # type: =head2
16358 #. type: =head2
16359 #: ../src/guestfs-actions.pod:5138
16360 msgid "guestfs_part_list"
16361 msgstr ""
16362
16363 # type: verbatim
16364 #. type: verbatim
16365 #: ../src/guestfs-actions.pod:5140
16366 #, no-wrap
16367 msgid ""
16368 " struct guestfs_partition_list *\n"
16369 " guestfs_part_list (guestfs_h *g,\n"
16370 "                    const char *device);\n"
16371 "\n"
16372 msgstr ""
16373
16374 # type: textblock
16375 #. type: textblock
16376 #: ../src/guestfs-actions.pod:5144 ../fish/guestfish-actions.pod:3484
16377 msgid ""
16378 "This command parses the partition table on C<device> and returns the list of "
16379 "partitions found."
16380 msgstr ""
16381
16382 # type: textblock
16383 #. type: textblock
16384 #: ../src/guestfs-actions.pod:5147 ../fish/guestfish-actions.pod:3487
16385 msgid "The fields in the returned structure are:"
16386 msgstr ""
16387
16388 # type: =item
16389 #. type: =item
16390 #: ../src/guestfs-actions.pod:5151 ../fish/guestfish-actions.pod:3491
16391 msgid "B<part_num>"
16392 msgstr ""
16393
16394 # type: textblock
16395 #. type: textblock
16396 #: ../src/guestfs-actions.pod:5153 ../fish/guestfish-actions.pod:3493
16397 msgid "Partition number, counting from 1."
16398 msgstr ""
16399
16400 # type: =item
16401 #. type: =item
16402 #: ../src/guestfs-actions.pod:5155 ../fish/guestfish-actions.pod:3495
16403 msgid "B<part_start>"
16404 msgstr ""
16405
16406 # type: textblock
16407 #. type: textblock
16408 #: ../src/guestfs-actions.pod:5157
16409 msgid ""
16410 "Start of the partition I<in bytes>.  To get sectors you have to divide by "
16411 "the device's sector size, see C<guestfs_blockdev_getss>."
16412 msgstr ""
16413
16414 # type: =item
16415 #. type: =item
16416 #: ../src/guestfs-actions.pod:5160 ../fish/guestfish-actions.pod:3500
16417 msgid "B<part_end>"
16418 msgstr ""
16419
16420 # type: textblock
16421 #. type: textblock
16422 #: ../src/guestfs-actions.pod:5162 ../fish/guestfish-actions.pod:3502
16423 msgid "End of the partition in bytes."
16424 msgstr ""
16425
16426 # type: =item
16427 #. type: =item
16428 #: ../src/guestfs-actions.pod:5164 ../fish/guestfish-actions.pod:3504
16429 msgid "B<part_size>"
16430 msgstr ""
16431
16432 # type: textblock
16433 #. type: textblock
16434 #: ../src/guestfs-actions.pod:5166 ../fish/guestfish-actions.pod:3506
16435 msgid "Size of the partition in bytes."
16436 msgstr ""
16437
16438 # type: textblock
16439 #. type: textblock
16440 #: ../src/guestfs-actions.pod:5170
16441 msgid ""
16442 "This function returns a C<struct guestfs_partition_list *>, or NULL if there "
16443 "was an error.  I<The caller must call C<guestfs_free_partition_list> after "
16444 "use>."
16445 msgstr ""
16446
16447 # type: =head2
16448 #. type: =head2
16449 #: ../src/guestfs-actions.pod:5176
16450 msgid "guestfs_part_set_bootable"
16451 msgstr ""
16452
16453 # type: verbatim
16454 #. type: verbatim
16455 #: ../src/guestfs-actions.pod:5178
16456 #, no-wrap
16457 msgid ""
16458 " int\n"
16459 " guestfs_part_set_bootable (guestfs_h *g,\n"
16460 "                            const char *device,\n"
16461 "                            int partnum,\n"
16462 "                            int bootable);\n"
16463 "\n"
16464 msgstr ""
16465
16466 # type: textblock
16467 #. type: textblock
16468 #: ../src/guestfs-actions.pod:5184 ../fish/guestfish-actions.pod:3514
16469 msgid ""
16470 "This sets the bootable flag on partition numbered C<partnum> on device "
16471 "C<device>.  Note that partitions are numbered from 1."
16472 msgstr ""
16473
16474 # type: textblock
16475 #. type: textblock
16476 #: ../src/guestfs-actions.pod:5187 ../fish/guestfish-actions.pod:3517
16477 msgid ""
16478 "The bootable flag is used by some operating systems (notably Windows) to "
16479 "determine which partition to boot from.  It is by no means universally "
16480 "recognized."
16481 msgstr ""
16482
16483 # type: =head2
16484 #. type: =head2
16485 #: ../src/guestfs-actions.pod:5195
16486 msgid "guestfs_part_set_mbr_id"
16487 msgstr ""
16488
16489 # type: verbatim
16490 #. type: verbatim
16491 #: ../src/guestfs-actions.pod:5197
16492 #, no-wrap
16493 msgid ""
16494 " int\n"
16495 " guestfs_part_set_mbr_id (guestfs_h *g,\n"
16496 "                          const char *device,\n"
16497 "                          int partnum,\n"
16498 "                          int idbyte);\n"
16499 "\n"
16500 msgstr ""
16501
16502 # type: textblock
16503 #. type: textblock
16504 #: ../src/guestfs-actions.pod:5203 ../fish/guestfish-actions.pod:3525
16505 msgid ""
16506 "Sets the MBR type byte (also known as the ID byte) of the numbered partition "
16507 "C<partnum> to C<idbyte>.  Note that the type bytes quoted in most "
16508 "documentation are in fact hexadecimal numbers, but usually documented "
16509 "without any leading \"0x\" which might be confusing."
16510 msgstr ""
16511
16512 # type: =head2
16513 #. type: =head2
16514 #: ../src/guestfs-actions.pod:5217
16515 msgid "guestfs_part_set_name"
16516 msgstr ""
16517
16518 # type: verbatim
16519 #. type: verbatim
16520 #: ../src/guestfs-actions.pod:5219
16521 #, no-wrap
16522 msgid ""
16523 " int\n"
16524 " guestfs_part_set_name (guestfs_h *g,\n"
16525 "                        const char *device,\n"
16526 "                        int partnum,\n"
16527 "                        const char *name);\n"
16528 "\n"
16529 msgstr ""
16530
16531 # type: textblock
16532 #. type: textblock
16533 #: ../src/guestfs-actions.pod:5225 ../fish/guestfish-actions.pod:3539
16534 msgid ""
16535 "This sets the partition name on partition numbered C<partnum> on device "
16536 "C<device>.  Note that partitions are numbered from 1."
16537 msgstr ""
16538
16539 # type: textblock
16540 #. type: textblock
16541 #: ../src/guestfs-actions.pod:5228 ../fish/guestfish-actions.pod:3542
16542 msgid ""
16543 "The partition name can only be set on certain types of partition table.  "
16544 "This works on C<gpt> but not on C<mbr> partitions."
16545 msgstr ""
16546
16547 # type: =head2
16548 #. type: =head2
16549 #: ../src/guestfs-actions.pod:5235
16550 msgid "guestfs_part_to_dev"
16551 msgstr ""
16552
16553 # type: verbatim
16554 #. type: verbatim
16555 #: ../src/guestfs-actions.pod:5237
16556 #, no-wrap
16557 msgid ""
16558 " char *\n"
16559 " guestfs_part_to_dev (guestfs_h *g,\n"
16560 "                      const char *partition);\n"
16561 "\n"
16562 msgstr ""
16563
16564 # type: textblock
16565 #. type: textblock
16566 #: ../src/guestfs-actions.pod:5241 ../fish/guestfish-actions.pod:3549
16567 msgid ""
16568 "This function takes a partition name (eg. \"/dev/sdb1\") and removes the "
16569 "partition number, returning the device name (eg. \"/dev/sdb\")."
16570 msgstr ""
16571
16572 # type: textblock
16573 #. type: textblock
16574 #: ../src/guestfs-actions.pod:5245
16575 msgid ""
16576 "The named partition must exist, for example as a string returned from "
16577 "C<guestfs_list_partitions>."
16578 msgstr ""
16579
16580 # type: =head2
16581 #. type: =head2
16582 #: ../src/guestfs-actions.pod:5253
16583 msgid "guestfs_ping_daemon"
16584 msgstr ""
16585
16586 # type: verbatim
16587 #. type: verbatim
16588 #: ../src/guestfs-actions.pod:5255
16589 #, no-wrap
16590 msgid ""
16591 " int\n"
16592 " guestfs_ping_daemon (guestfs_h *g);\n"
16593 "\n"
16594 msgstr ""
16595
16596 # type: textblock
16597 #. type: textblock
16598 #: ../src/guestfs-actions.pod:5258 ../fish/guestfish-actions.pod:3560
16599 msgid ""
16600 "This is a test probe into the guestfs daemon running inside the qemu "
16601 "subprocess.  Calling this function checks that the daemon responds to the "
16602 "ping message, without affecting the daemon or attached block device(s) in "
16603 "any other way."
16604 msgstr ""
16605
16606 # type: =head2
16607 #. type: =head2
16608 #: ../src/guestfs-actions.pod:5267
16609 msgid "guestfs_pread"
16610 msgstr ""
16611
16612 # type: verbatim
16613 #. type: verbatim
16614 #: ../src/guestfs-actions.pod:5269
16615 #, no-wrap
16616 msgid ""
16617 " char *\n"
16618 " guestfs_pread (guestfs_h *g,\n"
16619 "                const char *path,\n"
16620 "                int count,\n"
16621 "                int64_t offset,\n"
16622 "                size_t *size_r);\n"
16623 "\n"
16624 msgstr ""
16625
16626 # type: textblock
16627 #. type: textblock
16628 #: ../src/guestfs-actions.pod:5276 ../fish/guestfish-actions.pod:3569
16629 msgid ""
16630 "This command lets you read part of a file.  It reads C<count> bytes of the "
16631 "file, starting at C<offset>, from file C<path>."
16632 msgstr ""
16633
16634 # type: textblock
16635 #. type: textblock
16636 #: ../src/guestfs-actions.pod:5279 ../src/guestfs-actions.pod:5305
16637 #: ../fish/guestfish-actions.pod:3572 ../fish/guestfish-actions.pod:3587
16638 msgid ""
16639 "This may read fewer bytes than requested.  For further details see the "
16640 "L<pread(2)> system call."
16641 msgstr ""
16642
16643 # type: textblock
16644 #. type: textblock
16645 #: ../src/guestfs-actions.pod:5282
16646 msgid "See also C<guestfs_pwrite>, C<guestfs_pread_device>."
16647 msgstr ""
16648
16649 # type: =head2
16650 #. type: =head2
16651 #: ../src/guestfs-actions.pod:5293
16652 msgid "guestfs_pread_device"
16653 msgstr ""
16654
16655 # type: verbatim
16656 #. type: verbatim
16657 #: ../src/guestfs-actions.pod:5295
16658 #, no-wrap
16659 msgid ""
16660 " char *\n"
16661 " guestfs_pread_device (guestfs_h *g,\n"
16662 "                       const char *device,\n"
16663 "                       int count,\n"
16664 "                       int64_t offset,\n"
16665 "                       size_t *size_r);\n"
16666 "\n"
16667 msgstr ""
16668
16669 # type: textblock
16670 #. type: textblock
16671 #: ../src/guestfs-actions.pod:5302 ../fish/guestfish-actions.pod:3584
16672 msgid ""
16673 "This command lets you read part of a file.  It reads C<count> bytes of "
16674 "C<device>, starting at C<offset>."
16675 msgstr ""
16676
16677 # type: textblock
16678 #. type: textblock
16679 #: ../src/guestfs-actions.pod:5308
16680 msgid "See also C<guestfs_pread>."
16681 msgstr ""
16682
16683 # type: textblock
16684 #. type: textblock
16685 #: ../src/guestfs-actions.pod:5317
16686 msgid "(Added in 1.5.21)"
16687 msgstr ""
16688
16689 # type: =head2
16690 #. type: =head2
16691 #: ../src/guestfs-actions.pod:5319
16692 msgid "guestfs_pvcreate"
16693 msgstr ""
16694
16695 # type: verbatim
16696 #. type: verbatim
16697 #: ../src/guestfs-actions.pod:5321
16698 #, no-wrap
16699 msgid ""
16700 " int\n"
16701 " guestfs_pvcreate (guestfs_h *g,\n"
16702 "                   const char *device);\n"
16703 "\n"
16704 msgstr ""
16705
16706 # type: textblock
16707 #. type: textblock
16708 #: ../src/guestfs-actions.pod:5325 ../fish/guestfish-actions.pod:3599
16709 msgid ""
16710 "This creates an LVM physical volume on the named C<device>, where C<device> "
16711 "should usually be a partition name such as C</dev/sda1>."
16712 msgstr ""
16713
16714 # type: =head2
16715 #. type: =head2
16716 #: ../src/guestfs-actions.pod:5333
16717 msgid "guestfs_pvremove"
16718 msgstr ""
16719
16720 # type: verbatim
16721 #. type: verbatim
16722 #: ../src/guestfs-actions.pod:5335
16723 #, no-wrap
16724 msgid ""
16725 " int\n"
16726 " guestfs_pvremove (guestfs_h *g,\n"
16727 "                   const char *device);\n"
16728 "\n"
16729 msgstr ""
16730
16731 # type: textblock
16732 #. type: textblock
16733 #: ../src/guestfs-actions.pod:5339 ../fish/guestfish-actions.pod:3607
16734 msgid ""
16735 "This wipes a physical volume C<device> so that LVM will no longer recognise "
16736 "it."
16737 msgstr ""
16738
16739 # type: textblock
16740 #. type: textblock
16741 #: ../src/guestfs-actions.pod:5342 ../fish/guestfish-actions.pod:3610
16742 msgid ""
16743 "The implementation uses the C<pvremove> command which refuses to wipe "
16744 "physical volumes that contain any volume groups, so you have to remove those "
16745 "first."
16746 msgstr ""
16747
16748 # type: =head2
16749 #. type: =head2
16750 #: ../src/guestfs-actions.pod:5350
16751 msgid "guestfs_pvresize"
16752 msgstr ""
16753
16754 # type: verbatim
16755 #. type: verbatim
16756 #: ../src/guestfs-actions.pod:5352
16757 #, no-wrap
16758 msgid ""
16759 " int\n"
16760 " guestfs_pvresize (guestfs_h *g,\n"
16761 "                   const char *device);\n"
16762 "\n"
16763 msgstr ""
16764
16765 # type: textblock
16766 #. type: textblock
16767 #: ../src/guestfs-actions.pod:5356 ../fish/guestfish-actions.pod:3618
16768 msgid ""
16769 "This resizes (expands or shrinks) an existing LVM physical volume to match "
16770 "the new size of the underlying device."
16771 msgstr ""
16772
16773 # type: =head2
16774 #. type: =head2
16775 #: ../src/guestfs-actions.pod:5363
16776 msgid "guestfs_pvresize_size"
16777 msgstr ""
16778
16779 # type: verbatim
16780 #. type: verbatim
16781 #: ../src/guestfs-actions.pod:5365
16782 #, no-wrap
16783 msgid ""
16784 " int\n"
16785 " guestfs_pvresize_size (guestfs_h *g,\n"
16786 "                        const char *device,\n"
16787 "                        int64_t size);\n"
16788 "\n"
16789 msgstr ""
16790
16791 # type: textblock
16792 #. type: textblock
16793 #: ../src/guestfs-actions.pod:5370
16794 msgid ""
16795 "This command is the same as C<guestfs_pvresize> except that it allows you to "
16796 "specify the new size (in bytes) explicitly."
16797 msgstr ""
16798
16799 # type: =head2
16800 #. type: =head2
16801 #: ../src/guestfs-actions.pod:5377
16802 msgid "guestfs_pvs"
16803 msgstr ""
16804
16805 # type: verbatim
16806 #. type: verbatim
16807 #: ../src/guestfs-actions.pod:5379
16808 #, no-wrap
16809 msgid ""
16810 " char **\n"
16811 " guestfs_pvs (guestfs_h *g);\n"
16812 "\n"
16813 msgstr ""
16814
16815 # type: textblock
16816 #. type: textblock
16817 #: ../src/guestfs-actions.pod:5382 ../fish/guestfish-actions.pod:3632
16818 msgid ""
16819 "List all the physical volumes detected.  This is the equivalent of the L<pvs"
16820 "(8)> command."
16821 msgstr ""
16822
16823 # type: textblock
16824 #. type: textblock
16825 #: ../src/guestfs-actions.pod:5385 ../fish/guestfish-actions.pod:3635
16826 msgid ""
16827 "This returns a list of just the device names that contain PVs (eg. C</dev/"
16828 "sda2>)."
16829 msgstr ""
16830
16831 # type: textblock
16832 #. type: textblock
16833 #: ../src/guestfs-actions.pod:5388
16834 msgid "See also C<guestfs_pvs_full>."
16835 msgstr ""
16836
16837 # type: =head2
16838 #. type: =head2
16839 #: ../src/guestfs-actions.pod:5396
16840 msgid "guestfs_pvs_full"
16841 msgstr ""
16842
16843 # type: verbatim
16844 #. type: verbatim
16845 #: ../src/guestfs-actions.pod:5398
16846 #, no-wrap
16847 msgid ""
16848 " struct guestfs_lvm_pv_list *\n"
16849 " guestfs_pvs_full (guestfs_h *g);\n"
16850 "\n"
16851 msgstr ""
16852
16853 # type: textblock
16854 #. type: textblock
16855 #: ../src/guestfs-actions.pod:5401 ../fish/guestfish-actions.pod:3644
16856 msgid ""
16857 "List all the physical volumes detected.  This is the equivalent of the L<pvs"
16858 "(8)> command.  The \"full\" version includes all fields."
16859 msgstr ""
16860
16861 # type: textblock
16862 #. type: textblock
16863 #: ../src/guestfs-actions.pod:5404
16864 msgid ""
16865 "This function returns a C<struct guestfs_lvm_pv_list *>, or NULL if there "
16866 "was an error.  I<The caller must call C<guestfs_free_lvm_pv_list> after use>."
16867 msgstr ""
16868
16869 # type: =head2
16870 #. type: =head2
16871 #: ../src/guestfs-actions.pod:5410
16872 msgid "guestfs_pvuuid"
16873 msgstr ""
16874
16875 # type: verbatim
16876 #. type: verbatim
16877 #: ../src/guestfs-actions.pod:5412
16878 #, no-wrap
16879 msgid ""
16880 " char *\n"
16881 " guestfs_pvuuid (guestfs_h *g,\n"
16882 "                 const char *device);\n"
16883 "\n"
16884 msgstr ""
16885
16886 # type: textblock
16887 #. type: textblock
16888 #: ../src/guestfs-actions.pod:5416 ../fish/guestfish-actions.pod:3651
16889 msgid "This command returns the UUID of the LVM PV C<device>."
16890 msgstr ""
16891
16892 # type: =head2
16893 #. type: =head2
16894 #: ../src/guestfs-actions.pod:5423
16895 msgid "guestfs_pwrite"
16896 msgstr ""
16897
16898 # type: verbatim
16899 #. type: verbatim
16900 #: ../src/guestfs-actions.pod:5425
16901 #, no-wrap
16902 msgid ""
16903 " int\n"
16904 " guestfs_pwrite (guestfs_h *g,\n"
16905 "                 const char *path,\n"
16906 "                 const char *content,\n"
16907 "                 size_t content_size,\n"
16908 "                 int64_t offset);\n"
16909 "\n"
16910 msgstr ""
16911
16912 # type: textblock
16913 #. type: textblock
16914 #: ../src/guestfs-actions.pod:5432 ../fish/guestfish-actions.pod:3657
16915 msgid ""
16916 "This command writes to part of a file.  It writes the data buffer C<content> "
16917 "to the file C<path> starting at offset C<offset>."
16918 msgstr ""
16919
16920 # type: textblock
16921 #. type: textblock
16922 #: ../src/guestfs-actions.pod:5435 ../fish/guestfish-actions.pod:3660
16923 msgid ""
16924 "This command implements the L<pwrite(2)> system call, and like that system "
16925 "call it may not write the full data requested.  The return value is the "
16926 "number of bytes that were actually written to the file.  This could even be "
16927 "0, although short writes are unlikely for regular files in ordinary "
16928 "circumstances."
16929 msgstr ""
16930
16931 # type: textblock
16932 #. type: textblock
16933 #: ../src/guestfs-actions.pod:5441
16934 msgid "See also C<guestfs_pread>, C<guestfs_pwrite_device>."
16935 msgstr ""
16936
16937 # type: =head2
16938 #. type: =head2
16939 #: ../src/guestfs-actions.pod:5450
16940 msgid "guestfs_pwrite_device"
16941 msgstr ""
16942
16943 # type: verbatim
16944 #. type: verbatim
16945 #: ../src/guestfs-actions.pod:5452
16946 #, no-wrap
16947 msgid ""
16948 " int\n"
16949 " guestfs_pwrite_device (guestfs_h *g,\n"
16950 "                        const char *device,\n"
16951 "                        const char *content,\n"
16952 "                        size_t content_size,\n"
16953 "                        int64_t offset);\n"
16954 "\n"
16955 msgstr ""
16956
16957 # type: textblock
16958 #. type: textblock
16959 #: ../src/guestfs-actions.pod:5459 ../fish/guestfish-actions.pod:3675
16960 msgid ""
16961 "This command writes to part of a device.  It writes the data buffer "
16962 "C<content> to C<device> starting at offset C<offset>."
16963 msgstr ""
16964
16965 # type: textblock
16966 #. type: textblock
16967 #: ../src/guestfs-actions.pod:5462 ../fish/guestfish-actions.pod:3678
16968 msgid ""
16969 "This command implements the L<pwrite(2)> system call, and like that system "
16970 "call it may not write the full data requested (although short writes to disk "
16971 "devices and partitions are probably impossible with standard Linux kernels)."
16972 msgstr ""
16973
16974 # type: textblock
16975 #. type: textblock
16976 #: ../src/guestfs-actions.pod:5467
16977 msgid "See also C<guestfs_pwrite>."
16978 msgstr ""
16979
16980 # type: textblock
16981 #. type: textblock
16982 #: ../src/guestfs-actions.pod:5474
16983 msgid "(Added in 1.5.20)"
16984 msgstr ""
16985
16986 # type: =head2
16987 #. type: =head2
16988 #: ../src/guestfs-actions.pod:5476
16989 msgid "guestfs_read_file"
16990 msgstr ""
16991
16992 # type: verbatim
16993 #. type: verbatim
16994 #: ../src/guestfs-actions.pod:5478
16995 #, no-wrap
16996 msgid ""
16997 " char *\n"
16998 " guestfs_read_file (guestfs_h *g,\n"
16999 "                    const char *path,\n"
17000 "                    size_t *size_r);\n"
17001 "\n"
17002 msgstr ""
17003
17004 # type: textblock
17005 #. type: textblock
17006 #: ../src/guestfs-actions.pod:5483 ../fish/guestfish-actions.pod:3692
17007 msgid "This calls returns the contents of the file C<path> as a buffer."
17008 msgstr ""
17009
17010 # type: textblock
17011 #. type: textblock
17012 #: ../src/guestfs-actions.pod:5486
17013 msgid ""
17014 "Unlike C<guestfs_cat>, this function can correctly handle files that contain "
17015 "embedded ASCII NUL characters.  However unlike C<guestfs_download>, this "
17016 "function is limited in the total size of file that can be handled."
17017 msgstr ""
17018
17019 # type: textblock
17020 #. type: textblock
17021 #: ../src/guestfs-actions.pod:5498
17022 msgid "(Added in 1.0.63)"
17023 msgstr ""
17024
17025 # type: =head2
17026 #. type: =head2
17027 #: ../src/guestfs-actions.pod:5500
17028 msgid "guestfs_read_lines"
17029 msgstr ""
17030
17031 # type: verbatim
17032 #. type: verbatim
17033 #: ../src/guestfs-actions.pod:5502
17034 #, no-wrap
17035 msgid ""
17036 " char **\n"
17037 " guestfs_read_lines (guestfs_h *g,\n"
17038 "                     const char *path);\n"
17039 "\n"
17040 msgstr ""
17041
17042 # type: textblock
17043 #. type: textblock
17044 #: ../src/guestfs-actions.pod:5508 ../fish/guestfish-actions.pod:3709
17045 msgid ""
17046 "The file contents are returned as a list of lines.  Trailing C<LF> and "
17047 "C<CRLF> character sequences are I<not> returned."
17048 msgstr ""
17049
17050 # type: textblock
17051 #. type: textblock
17052 #: ../src/guestfs-actions.pod:5511
17053 msgid ""
17054 "Note that this function cannot correctly handle binary files (specifically, "
17055 "files containing C<\\0> character which is treated as end of line).  For "
17056 "those you need to use the C<guestfs_read_file> function which has a more "
17057 "complex interface."
17058 msgstr ""
17059
17060 # type: =head2
17061 #. type: =head2
17062 #: ../src/guestfs-actions.pod:5522
17063 msgid "guestfs_readdir"
17064 msgstr ""
17065
17066 # type: verbatim
17067 #. type: verbatim
17068 #: ../src/guestfs-actions.pod:5524
17069 #, no-wrap
17070 msgid ""
17071 " struct guestfs_dirent_list *\n"
17072 " guestfs_readdir (guestfs_h *g,\n"
17073 "                  const char *dir);\n"
17074 "\n"
17075 msgstr ""
17076
17077 # type: textblock
17078 #. type: textblock
17079 #: ../src/guestfs-actions.pod:5528 ../fish/guestfish-actions.pod:3721
17080 msgid "This returns the list of directory entries in directory C<dir>."
17081 msgstr ""
17082
17083 # type: textblock
17084 #. type: textblock
17085 #: ../src/guestfs-actions.pod:5530 ../fish/guestfish-actions.pod:3723
17086 msgid ""
17087 "All entries in the directory are returned, including C<.> and C<..>.  The "
17088 "entries are I<not> sorted, but returned in the same order as the underlying "
17089 "filesystem."
17090 msgstr ""
17091
17092 # type: textblock
17093 #. type: textblock
17094 #: ../src/guestfs-actions.pod:5534 ../fish/guestfish-actions.pod:3727
17095 msgid ""
17096 "Also this call returns basic file type information about each file.  The "
17097 "C<ftyp> field will contain one of the following characters:"
17098 msgstr ""
17099
17100 # type: =item
17101 #. type: =item
17102 #: ../src/guestfs-actions.pod:5539 ../fish/guestfish-actions.pod:3732
17103 msgid "'b'"
17104 msgstr ""
17105
17106 # type: textblock
17107 #. type: textblock
17108 #: ../src/guestfs-actions.pod:5541 ../fish/guestfish-actions.pod:3734
17109 msgid "Block special"
17110 msgstr ""
17111
17112 # type: =item
17113 #. type: =item
17114 #: ../src/guestfs-actions.pod:5543 ../fish/guestfish-actions.pod:3736
17115 msgid "'c'"
17116 msgstr ""
17117
17118 # type: textblock
17119 #. type: textblock
17120 #: ../src/guestfs-actions.pod:5545 ../fish/guestfish-actions.pod:3738
17121 msgid "Char special"
17122 msgstr ""
17123
17124 # type: =item
17125 #. type: =item
17126 #: ../src/guestfs-actions.pod:5547 ../fish/guestfish-actions.pod:3740
17127 msgid "'d'"
17128 msgstr ""
17129
17130 # type: textblock
17131 #. type: textblock
17132 #: ../src/guestfs-actions.pod:5549 ../fish/guestfish-actions.pod:3742
17133 msgid "Directory"
17134 msgstr ""
17135
17136 # type: =item
17137 #. type: =item
17138 #: ../src/guestfs-actions.pod:5551 ../fish/guestfish-actions.pod:3744
17139 msgid "'f'"
17140 msgstr ""
17141
17142 # type: textblock
17143 #. type: textblock
17144 #: ../src/guestfs-actions.pod:5553 ../fish/guestfish-actions.pod:3746
17145 msgid "FIFO (named pipe)"
17146 msgstr ""
17147
17148 # type: =item
17149 #. type: =item
17150 #: ../src/guestfs-actions.pod:5555 ../fish/guestfish-actions.pod:3748
17151 msgid "'l'"
17152 msgstr ""
17153
17154 # type: textblock
17155 #. type: textblock
17156 #: ../src/guestfs-actions.pod:5557 ../fish/guestfish-actions.pod:3750
17157 msgid "Symbolic link"
17158 msgstr ""
17159
17160 # type: =item
17161 #. type: =item
17162 #: ../src/guestfs-actions.pod:5559 ../fish/guestfish-actions.pod:3752
17163 msgid "'r'"
17164 msgstr ""
17165
17166 # type: textblock
17167 #. type: textblock
17168 #: ../src/guestfs-actions.pod:5561 ../fish/guestfish-actions.pod:3754
17169 msgid "Regular file"
17170 msgstr ""
17171
17172 # type: =item
17173 #. type: =item
17174 #: ../src/guestfs-actions.pod:5563 ../fish/guestfish-actions.pod:3756
17175 msgid "'s'"
17176 msgstr ""
17177
17178 # type: textblock
17179 #. type: textblock
17180 #: ../src/guestfs-actions.pod:5565 ../fish/guestfish-actions.pod:3758
17181 msgid "Socket"
17182 msgstr ""
17183
17184 # type: =item
17185 #. type: =item
17186 #: ../src/guestfs-actions.pod:5567 ../fish/guestfish-actions.pod:3760
17187 msgid "'u'"
17188 msgstr ""
17189
17190 # type: textblock
17191 #. type: textblock
17192 #: ../src/guestfs-actions.pod:5569 ../fish/guestfish-actions.pod:3762
17193 msgid "Unknown file type"
17194 msgstr ""
17195
17196 # type: =item
17197 #. type: =item
17198 #: ../src/guestfs-actions.pod:5571 ../fish/guestfish-actions.pod:3764
17199 msgid "'?'"
17200 msgstr ""
17201
17202 # type: textblock
17203 #. type: textblock
17204 #: ../src/guestfs-actions.pod:5573 ../fish/guestfish-actions.pod:3766
17205 msgid ""
17206 "The L<readdir(3)> call returned a C<d_type> field with an unexpected value"
17207 msgstr ""
17208
17209 # type: textblock
17210 #. type: textblock
17211 #: ../src/guestfs-actions.pod:5578
17212 msgid ""
17213 "This function is primarily intended for use by programs.  To get a simple "
17214 "list of names, use C<guestfs_ls>.  To get a printable directory for human "
17215 "consumption, use C<guestfs_ll>."
17216 msgstr ""
17217
17218 # type: textblock
17219 #. type: textblock
17220 #: ../src/guestfs-actions.pod:5582
17221 msgid ""
17222 "This function returns a C<struct guestfs_dirent_list *>, or NULL if there "
17223 "was an error.  I<The caller must call C<guestfs_free_dirent_list> after use>."
17224 msgstr ""
17225
17226 # type: =head2
17227 #. type: =head2
17228 #: ../src/guestfs-actions.pod:5588
17229 msgid "guestfs_readlink"
17230 msgstr ""
17231
17232 # type: verbatim
17233 #. type: verbatim
17234 #: ../src/guestfs-actions.pod:5590
17235 #, no-wrap
17236 msgid ""
17237 " char *\n"
17238 " guestfs_readlink (guestfs_h *g,\n"
17239 "                   const char *path);\n"
17240 "\n"
17241 msgstr ""
17242
17243 # type: textblock
17244 #. type: textblock
17245 #: ../src/guestfs-actions.pod:5594 ../fish/guestfish-actions.pod:3779
17246 msgid "This command reads the target of a symbolic link."
17247 msgstr ""
17248
17249 # type: =head2
17250 #. type: =head2
17251 #: ../src/guestfs-actions.pod:5601
17252 msgid "guestfs_readlinklist"
17253 msgstr ""
17254
17255 # type: verbatim
17256 #. type: verbatim
17257 #: ../src/guestfs-actions.pod:5603
17258 #, no-wrap
17259 msgid ""
17260 " char **\n"
17261 " guestfs_readlinklist (guestfs_h *g,\n"
17262 "                       const char *path,\n"
17263 "                       char *const *names);\n"
17264 "\n"
17265 msgstr ""
17266
17267 # type: textblock
17268 #. type: textblock
17269 #: ../src/guestfs-actions.pod:5608 ../fish/guestfish-actions.pod:3785
17270 msgid ""
17271 "This call allows you to do a C<readlink> operation on multiple files, where "
17272 "all files are in the directory C<path>.  C<names> is the list of files from "
17273 "this directory."
17274 msgstr ""
17275
17276 # type: textblock
17277 #. type: textblock
17278 #: ../src/guestfs-actions.pod:5612 ../fish/guestfish-actions.pod:3789
17279 msgid ""
17280 "On return you get a list of strings, with a one-to-one correspondence to the "
17281 "C<names> list.  Each string is the value of the symbolic link."
17282 msgstr ""
17283
17284 # type: textblock
17285 #. type: textblock
17286 #: ../src/guestfs-actions.pod:5616 ../fish/guestfish-actions.pod:3793
17287 msgid ""
17288 "If the C<readlink(2)> operation fails on any name, then the corresponding "
17289 "result string is the empty string C<\"\">.  However the whole operation is "
17290 "completed even if there were C<readlink(2)> errors, and so you can call this "
17291 "function with names where you don't know if they are symbolic links already "
17292 "(albeit slightly less efficient)."
17293 msgstr ""
17294
17295 # type: textblock
17296 #. type: textblock
17297 #: ../src/guestfs-actions.pod:5623 ../fish/guestfish-actions.pod:3800
17298 msgid ""
17299 "This call is intended for programs that want to efficiently list a directory "
17300 "contents without making many round-trips.  Very long directory listings "
17301 "might cause the protocol message size to be exceeded, causing this call to "
17302 "fail.  The caller must split up such requests into smaller groups of names."
17303 msgstr ""
17304
17305 # type: =head2
17306 #. type: =head2
17307 #: ../src/guestfs-actions.pod:5636
17308 msgid "guestfs_realpath"
17309 msgstr ""
17310
17311 # type: verbatim
17312 #. type: verbatim
17313 #: ../src/guestfs-actions.pod:5638
17314 #, no-wrap
17315 msgid ""
17316 " char *\n"
17317 " guestfs_realpath (guestfs_h *g,\n"
17318 "                   const char *path);\n"
17319 "\n"
17320 msgstr ""
17321
17322 # type: textblock
17323 #. type: textblock
17324 #: ../src/guestfs-actions.pod:5642 ../fish/guestfish-actions.pod:3811
17325 msgid ""
17326 "Return the canonicalized absolute pathname of C<path>.  The returned path "
17327 "has no C<.>, C<..> or symbolic link path elements."
17328 msgstr ""
17329
17330 # type: =head2
17331 #. type: =head2
17332 #: ../src/guestfs-actions.pod:5650
17333 msgid "guestfs_removexattr"
17334 msgstr ""
17335
17336 # type: verbatim
17337 #. type: verbatim
17338 #: ../src/guestfs-actions.pod:5652
17339 #, no-wrap
17340 msgid ""
17341 " int\n"
17342 " guestfs_removexattr (guestfs_h *g,\n"
17343 "                      const char *xattr,\n"
17344 "                      const char *path);\n"
17345 "\n"
17346 msgstr ""
17347
17348 # type: textblock
17349 #. type: textblock
17350 #: ../src/guestfs-actions.pod:5657 ../fish/guestfish-actions.pod:3818
17351 msgid ""
17352 "This call removes the extended attribute named C<xattr> of the file C<path>."
17353 msgstr ""
17354
17355 # type: textblock
17356 #. type: textblock
17357 #: ../src/guestfs-actions.pod:5660
17358 msgid "See also: C<guestfs_lremovexattr>, L<attr(5)>."
17359 msgstr ""
17360
17361 # type: =head2
17362 #. type: =head2
17363 #: ../src/guestfs-actions.pod:5666
17364 msgid "guestfs_resize2fs"
17365 msgstr ""
17366
17367 # type: verbatim
17368 #. type: verbatim
17369 #: ../src/guestfs-actions.pod:5668
17370 #, no-wrap
17371 msgid ""
17372 " int\n"
17373 " guestfs_resize2fs (guestfs_h *g,\n"
17374 "                    const char *device);\n"
17375 "\n"
17376 msgstr ""
17377
17378 # type: textblock
17379 #. type: textblock
17380 #: ../src/guestfs-actions.pod:5672 ../fish/guestfish-actions.pod:3827
17381 msgid ""
17382 "This resizes an ext2, ext3 or ext4 filesystem to match the size of the "
17383 "underlying device."
17384 msgstr ""
17385
17386 # type: textblock
17387 #. type: textblock
17388 #: ../src/guestfs-actions.pod:5675
17389 msgid ""
17390 "I<Note:> It is sometimes required that you run C<guestfs_e2fsck_f> on the "
17391 "C<device> before calling this command.  For unknown reasons C<resize2fs> "
17392 "sometimes gives an error about this and sometimes not.  In any case, it is "
17393 "always safe to call C<guestfs_e2fsck_f> before calling this function."
17394 msgstr ""
17395
17396 #. type: =head2
17397 #: ../src/guestfs-actions.pod:5685
17398 msgid "guestfs_resize2fs_M"
17399 msgstr ""
17400
17401 #. type: verbatim
17402 #: ../src/guestfs-actions.pod:5687
17403 #, no-wrap
17404 msgid ""
17405 " int\n"
17406 " guestfs_resize2fs_M (guestfs_h *g,\n"
17407 "                      const char *device);\n"
17408 "\n"
17409 msgstr ""
17410
17411 #. type: textblock
17412 #: ../src/guestfs-actions.pod:5691
17413 msgid ""
17414 "This command is the same as C<guestfs_resize2fs>, but the filesystem is "
17415 "resized to its minimum size.  This works like the I<-M> option to the "
17416 "C<resize2fs> command."
17417 msgstr ""
17418
17419 #. type: textblock
17420 #: ../src/guestfs-actions.pod:5695
17421 msgid ""
17422 "To get the resulting size of the filesystem you should call "
17423 "C<guestfs_tune2fs_l> and read the C<Block size> and C<Block count> values.  "
17424 "These two numbers, multiplied together, give the resulting size of the "
17425 "minimal filesystem in bytes."
17426 msgstr ""
17427
17428 # type: =head2
17429 #. type: =head2
17430 #: ../src/guestfs-actions.pod:5702
17431 msgid "guestfs_resize2fs_size"
17432 msgstr ""
17433
17434 # type: verbatim
17435 #. type: verbatim
17436 #: ../src/guestfs-actions.pod:5704
17437 #, no-wrap
17438 msgid ""
17439 " int\n"
17440 " guestfs_resize2fs_size (guestfs_h *g,\n"
17441 "                         const char *device,\n"
17442 "                         int64_t size);\n"
17443 "\n"
17444 msgstr ""
17445
17446 # type: textblock
17447 #. type: textblock
17448 #: ../src/guestfs-actions.pod:5709
17449 msgid ""
17450 "This command is the same as C<guestfs_resize2fs> except that it allows you "
17451 "to specify the new size (in bytes) explicitly."
17452 msgstr ""
17453
17454 # type: =head2
17455 #. type: =head2
17456 #: ../src/guestfs-actions.pod:5716
17457 msgid "guestfs_rm"
17458 msgstr ""
17459
17460 # type: verbatim
17461 #. type: verbatim
17462 #: ../src/guestfs-actions.pod:5718
17463 #, no-wrap
17464 msgid ""
17465 " int\n"
17466 " guestfs_rm (guestfs_h *g,\n"
17467 "             const char *path);\n"
17468 "\n"
17469 msgstr ""
17470
17471 # type: textblock
17472 #. type: textblock
17473 #: ../src/guestfs-actions.pod:5722 ../fish/guestfish-actions.pod:3860
17474 msgid "Remove the single file C<path>."
17475 msgstr ""
17476
17477 # type: =head2
17478 #. type: =head2
17479 #: ../src/guestfs-actions.pod:5728
17480 msgid "guestfs_rm_rf"
17481 msgstr ""
17482
17483 # type: verbatim
17484 #. type: verbatim
17485 #: ../src/guestfs-actions.pod:5730
17486 #, no-wrap
17487 msgid ""
17488 " int\n"
17489 " guestfs_rm_rf (guestfs_h *g,\n"
17490 "                const char *path);\n"
17491 "\n"
17492 msgstr ""
17493
17494 # type: textblock
17495 #. type: textblock
17496 #: ../src/guestfs-actions.pod:5734 ../fish/guestfish-actions.pod:3866
17497 msgid ""
17498 "Remove the file or directory C<path>, recursively removing the contents if "
17499 "its a directory.  This is like the C<rm -rf> shell command."
17500 msgstr ""
17501
17502 # type: =head2
17503 #. type: =head2
17504 #: ../src/guestfs-actions.pod:5742
17505 msgid "guestfs_rmdir"
17506 msgstr ""
17507
17508 # type: verbatim
17509 #. type: verbatim
17510 #: ../src/guestfs-actions.pod:5744
17511 #, no-wrap
17512 msgid ""
17513 " int\n"
17514 " guestfs_rmdir (guestfs_h *g,\n"
17515 "                const char *path);\n"
17516 "\n"
17517 msgstr ""
17518
17519 # type: textblock
17520 #. type: textblock
17521 #: ../src/guestfs-actions.pod:5748 ../fish/guestfish-actions.pod:3874
17522 msgid "Remove the single directory C<path>."
17523 msgstr ""
17524
17525 # type: =head2
17526 #. type: =head2
17527 #: ../src/guestfs-actions.pod:5754
17528 msgid "guestfs_rmmountpoint"
17529 msgstr ""
17530
17531 # type: verbatim
17532 #. type: verbatim
17533 #: ../src/guestfs-actions.pod:5756
17534 #, no-wrap
17535 msgid ""
17536 " int\n"
17537 " guestfs_rmmountpoint (guestfs_h *g,\n"
17538 "                       const char *exemptpath);\n"
17539 "\n"
17540 msgstr ""
17541
17542 # type: textblock
17543 #. type: textblock
17544 #: ../src/guestfs-actions.pod:5760
17545 msgid ""
17546 "This calls removes a mountpoint that was previously created with "
17547 "C<guestfs_mkmountpoint>.  See C<guestfs_mkmountpoint> for full details."
17548 msgstr ""
17549
17550 # type: =head2
17551 #. type: =head2
17552 #: ../src/guestfs-actions.pod:5768
17553 msgid "guestfs_scrub_device"
17554 msgstr ""
17555
17556 # type: verbatim
17557 #. type: verbatim
17558 #: ../src/guestfs-actions.pod:5770
17559 #, no-wrap
17560 msgid ""
17561 " int\n"
17562 " guestfs_scrub_device (guestfs_h *g,\n"
17563 "                       const char *device);\n"
17564 "\n"
17565 msgstr ""
17566
17567 # type: textblock
17568 #. type: textblock
17569 #: ../src/guestfs-actions.pod:5774 ../fish/guestfish-actions.pod:3888
17570 msgid ""
17571 "This command writes patterns over C<device> to make data retrieval more "
17572 "difficult."
17573 msgstr ""
17574
17575 # type: textblock
17576 #. type: textblock
17577 #: ../src/guestfs-actions.pod:5777 ../src/guestfs-actions.pod:5798
17578 #: ../src/guestfs-actions.pod:5817 ../fish/guestfish-actions.pod:3891
17579 #: ../fish/guestfish-actions.pod:3906 ../fish/guestfish-actions.pod:3919
17580 msgid ""
17581 "It is an interface to the L<scrub(1)> program.  See that manual page for "
17582 "more details."
17583 msgstr ""
17584
17585 # type: textblock
17586 #. type: textblock
17587 #: ../src/guestfs-actions.pod:5785 ../src/guestfs-actions.pod:5803
17588 #: ../src/guestfs-actions.pod:5822
17589 msgid "(Added in 1.0.52)"
17590 msgstr ""
17591
17592 # type: =head2
17593 #. type: =head2
17594 #: ../src/guestfs-actions.pod:5787
17595 msgid "guestfs_scrub_file"
17596 msgstr ""
17597
17598 # type: verbatim
17599 #. type: verbatim
17600 #: ../src/guestfs-actions.pod:5789
17601 #, no-wrap
17602 msgid ""
17603 " int\n"
17604 " guestfs_scrub_file (guestfs_h *g,\n"
17605 "                     const char *file);\n"
17606 "\n"
17607 msgstr ""
17608
17609 # type: textblock
17610 #. type: textblock
17611 #: ../src/guestfs-actions.pod:5793 ../fish/guestfish-actions.pod:3901
17612 msgid ""
17613 "This command writes patterns over a file to make data retrieval more "
17614 "difficult."
17615 msgstr ""
17616
17617 # type: textblock
17618 #. type: textblock
17619 #: ../src/guestfs-actions.pod:5796 ../fish/guestfish-actions.pod:3904
17620 msgid "The file is I<removed> after scrubbing."
17621 msgstr ""
17622
17623 # type: =head2
17624 #. type: =head2
17625 #: ../src/guestfs-actions.pod:5805
17626 msgid "guestfs_scrub_freespace"
17627 msgstr ""
17628
17629 # type: verbatim
17630 #. type: verbatim
17631 #: ../src/guestfs-actions.pod:5807
17632 #, no-wrap
17633 msgid ""
17634 " int\n"
17635 " guestfs_scrub_freespace (guestfs_h *g,\n"
17636 "                          const char *dir);\n"
17637 "\n"
17638 msgstr ""
17639
17640 # type: textblock
17641 #. type: textblock
17642 #: ../src/guestfs-actions.pod:5811
17643 msgid ""
17644 "This command creates the directory C<dir> and then fills it with files until "
17645 "the filesystem is full, and scrubs the files as for C<guestfs_scrub_file>, "
17646 "and deletes them.  The intention is to scrub any free space on the partition "
17647 "containing C<dir>."
17648 msgstr ""
17649
17650 # type: =head2
17651 #. type: =head2
17652 #: ../src/guestfs-actions.pod:5824
17653 msgid "guestfs_set_append"
17654 msgstr ""
17655
17656 # type: verbatim
17657 #. type: verbatim
17658 #: ../src/guestfs-actions.pod:5826
17659 #, no-wrap
17660 msgid ""
17661 " int\n"
17662 " guestfs_set_append (guestfs_h *g,\n"
17663 "                     const char *append);\n"
17664 "\n"
17665 msgstr ""
17666
17667 # type: textblock
17668 #. type: textblock
17669 #: ../src/guestfs-actions.pod:5830 ../fish/guestfish-actions.pod:3928
17670 msgid ""
17671 "This function is used to add additional options to the guest kernel command "
17672 "line."
17673 msgstr ""
17674
17675 # type: textblock
17676 #. type: textblock
17677 #: ../src/guestfs-actions.pod:5833 ../fish/guestfish-actions.pod:3931
17678 msgid ""
17679 "The default is C<NULL> unless overridden by setting C<LIBGUESTFS_APPEND> "
17680 "environment variable."
17681 msgstr ""
17682
17683 # type: textblock
17684 #. type: textblock
17685 #: ../src/guestfs-actions.pod:5836 ../fish/guestfish-actions.pod:3934
17686 msgid ""
17687 "Setting C<append> to C<NULL> means I<no> additional options are passed "
17688 "(libguestfs always adds a few of its own)."
17689 msgstr ""
17690
17691 #. type: =head2
17692 #: ../src/guestfs-actions.pod:5843
17693 msgid "guestfs_set_attach_method"
17694 msgstr ""
17695
17696 #. type: verbatim
17697 #: ../src/guestfs-actions.pod:5845
17698 #, no-wrap
17699 msgid ""
17700 " int\n"
17701 " guestfs_set_attach_method (guestfs_h *g,\n"
17702 "                            const char *attachmethod);\n"
17703 "\n"
17704 msgstr ""
17705
17706 #. type: textblock
17707 #: ../src/guestfs-actions.pod:5849 ../fish/guestfish-actions.pod:3943
17708 msgid ""
17709 "Set the method that libguestfs uses to connect to the back end guestfsd "
17710 "daemon.  Possible methods are:"
17711 msgstr ""
17712
17713 #. type: textblock
17714 #: ../src/guestfs-actions.pod:5856 ../fish/guestfish-actions.pod:3950
17715 msgid ""
17716 "Launch an appliance and connect to it.  This is the ordinary method and the "
17717 "default."
17718 msgstr ""
17719
17720 #. type: =item
17721 #: ../src/guestfs-actions.pod:5859 ../fish/guestfish-actions.pod:3953
17722 msgid "C<unix:I<path>>"
17723 msgstr ""
17724
17725 #. type: textblock
17726 #: ../src/guestfs-actions.pod:5861 ../fish/guestfish-actions.pod:3955
17727 msgid "Connect to the Unix domain socket I<path>."
17728 msgstr ""
17729
17730 #. type: textblock
17731 #: ../src/guestfs-actions.pod:5863 ../fish/guestfish-actions.pod:3957
17732 msgid ""
17733 "This method lets you connect to an existing daemon or (using virtio-serial) "
17734 "to a live guest.  For more information, see L<guestfs(3)/ATTACHING TO "
17735 "RUNNING DAEMONS>."
17736 msgstr ""
17737
17738 # type: =head2
17739 #. type: =head2
17740 #: ../src/guestfs-actions.pod:5871
17741 msgid "guestfs_set_autosync"
17742 msgstr ""
17743
17744 # type: verbatim
17745 #. type: verbatim
17746 #: ../src/guestfs-actions.pod:5873
17747 #, no-wrap
17748 msgid ""
17749 " int\n"
17750 " guestfs_set_autosync (guestfs_h *g,\n"
17751 "                       int autosync);\n"
17752 "\n"
17753 msgstr ""
17754
17755 #. type: textblock
17756 #: ../src/guestfs-actions.pod:5877 ../fish/guestfish-actions.pod:3969
17757 msgid ""
17758 "If C<autosync> is true, this enables autosync.  Libguestfs will make a best "
17759 "effort attempt to make filesystems consistent and synchronized when the "
17760 "handle is closed (also if the program exits without closing handles)."
17761 msgstr ""
17762
17763 # type: textblock
17764 #. type: textblock
17765 #: ../src/guestfs-actions.pod:5882 ../fish/guestfish-actions.pod:3974
17766 msgid ""
17767 "This is enabled by default (since libguestfs 1.5.24, previously it was "
17768 "disabled by default)."
17769 msgstr ""
17770
17771 # type: =head2
17772 #. type: =head2
17773 #: ../src/guestfs-actions.pod:5889
17774 msgid "guestfs_set_direct"
17775 msgstr ""
17776
17777 # type: verbatim
17778 #. type: verbatim
17779 #: ../src/guestfs-actions.pod:5891
17780 #, no-wrap
17781 msgid ""
17782 " int\n"
17783 " guestfs_set_direct (guestfs_h *g,\n"
17784 "                     int direct);\n"
17785 "\n"
17786 msgstr ""
17787
17788 # type: textblock
17789 #. type: textblock
17790 #: ../src/guestfs-actions.pod:5895 ../fish/guestfish-actions.pod:3983
17791 msgid ""
17792 "If the direct appliance mode flag is enabled, then stdin and stdout are "
17793 "passed directly through to the appliance once it is launched."
17794 msgstr ""
17795
17796 # type: textblock
17797 #. type: textblock
17798 #: ../src/guestfs-actions.pod:5899
17799 msgid ""
17800 "One consequence of this is that log messages aren't caught by the library "
17801 "and handled by C<guestfs_set_log_message_callback>, but go straight to "
17802 "stdout."
17803 msgstr ""
17804
17805 # type: textblock
17806 #. type: textblock
17807 #: ../src/guestfs-actions.pod:5903 ../fish/guestfish-actions.pod:3991
17808 msgid "You probably don't want to use this unless you know what you are doing."
17809 msgstr ""
17810
17811 # type: textblock
17812 #. type: textblock
17813 #: ../src/guestfs-actions.pod:5906 ../fish/guestfish-actions.pod:3994
17814 msgid "The default is disabled."
17815 msgstr ""
17816
17817 # type: =head2
17818 #. type: =head2
17819 #: ../src/guestfs-actions.pod:5912
17820 msgid "guestfs_set_e2label"
17821 msgstr ""
17822
17823 # type: verbatim
17824 #. type: verbatim
17825 #: ../src/guestfs-actions.pod:5914
17826 #, no-wrap
17827 msgid ""
17828 " int\n"
17829 " guestfs_set_e2label (guestfs_h *g,\n"
17830 "                      const char *device,\n"
17831 "                      const char *label);\n"
17832 "\n"
17833 msgstr ""
17834
17835 # type: textblock
17836 #. type: textblock
17837 #: ../src/guestfs-actions.pod:5919 ../fish/guestfish-actions.pod:4000
17838 msgid ""
17839 "This sets the ext2/3/4 filesystem label of the filesystem on C<device> to "
17840 "C<label>.  Filesystem labels are limited to 16 characters."
17841 msgstr ""
17842
17843 # type: textblock
17844 #. type: textblock
17845 #: ../src/guestfs-actions.pod:5923
17846 msgid ""
17847 "You can use either C<guestfs_tune2fs_l> or C<guestfs_get_e2label> to return "
17848 "the existing label on a filesystem."
17849 msgstr ""
17850
17851 # type: =head2
17852 #. type: =head2
17853 #: ../src/guestfs-actions.pod:5930
17854 msgid "guestfs_set_e2uuid"
17855 msgstr ""
17856
17857 # type: verbatim
17858 #. type: verbatim
17859 #: ../src/guestfs-actions.pod:5932
17860 #, no-wrap
17861 msgid ""
17862 " int\n"
17863 " guestfs_set_e2uuid (guestfs_h *g,\n"
17864 "                     const char *device,\n"
17865 "                     const char *uuid);\n"
17866 "\n"
17867 msgstr ""
17868
17869 # type: textblock
17870 #. type: textblock
17871 #: ../src/guestfs-actions.pod:5937 ../fish/guestfish-actions.pod:4011
17872 msgid ""
17873 "This sets the ext2/3/4 filesystem UUID of the filesystem on C<device> to "
17874 "C<uuid>.  The format of the UUID and alternatives such as C<clear>, "
17875 "C<random> and C<time> are described in the L<tune2fs(8)> manpage."
17876 msgstr ""
17877
17878 # type: textblock
17879 #. type: textblock
17880 #: ../src/guestfs-actions.pod:5942
17881 msgid ""
17882 "You can use either C<guestfs_tune2fs_l> or C<guestfs_get_e2uuid> to return "
17883 "the existing UUID of a filesystem."
17884 msgstr ""
17885
17886 # type: =head2
17887 #. type: =head2
17888 #: ../src/guestfs-actions.pod:5949
17889 msgid "guestfs_set_memsize"
17890 msgstr ""
17891
17892 # type: verbatim
17893 #. type: verbatim
17894 #: ../src/guestfs-actions.pod:5951
17895 #, no-wrap
17896 msgid ""
17897 " int\n"
17898 " guestfs_set_memsize (guestfs_h *g,\n"
17899 "                      int memsize);\n"
17900 "\n"
17901 msgstr ""
17902
17903 # type: textblock
17904 #. type: textblock
17905 #: ../src/guestfs-actions.pod:5955
17906 msgid ""
17907 "This sets the memory size in megabytes allocated to the qemu subprocess.  "
17908 "This only has any effect if called before C<guestfs_launch>."
17909 msgstr ""
17910
17911 # type: textblock
17912 #. type: textblock
17913 #: ../src/guestfs-actions.pod:5959 ../fish/guestfish-actions.pod:4029
17914 msgid ""
17915 "You can also change this by setting the environment variable "
17916 "C<LIBGUESTFS_MEMSIZE> before the handle is created."
17917 msgstr ""
17918
17919 # type: =head2
17920 #. type: =head2
17921 #: ../src/guestfs-actions.pod:5970
17922 msgid "guestfs_set_network"
17923 msgstr ""
17924
17925 # type: verbatim
17926 #. type: verbatim
17927 #: ../src/guestfs-actions.pod:5972
17928 #, no-wrap
17929 msgid ""
17930 " int\n"
17931 " guestfs_set_network (guestfs_h *g,\n"
17932 "                      int network);\n"
17933 "\n"
17934 msgstr ""
17935
17936 # type: textblock
17937 #. type: textblock
17938 #: ../src/guestfs-actions.pod:5976 ../fish/guestfish-actions.pod:4042
17939 msgid ""
17940 "If C<network> is true, then the network is enabled in the libguestfs "
17941 "appliance.  The default is false."
17942 msgstr ""
17943
17944 # type: textblock
17945 #. type: textblock
17946 #: ../src/guestfs-actions.pod:5979 ../fish/guestfish-actions.pod:4045
17947 msgid ""
17948 "This affects whether commands are able to access the network (see L<guestfs"
17949 "(3)/RUNNING COMMANDS>)."
17950 msgstr ""
17951
17952 # type: textblock
17953 #. type: textblock
17954 #: ../src/guestfs-actions.pod:5982
17955 msgid ""
17956 "You must call this before calling C<guestfs_launch>, otherwise it has no "
17957 "effect."
17958 msgstr ""
17959
17960 # type: =head2
17961 #. type: =head2
17962 #: ../src/guestfs-actions.pod:5989
17963 msgid "guestfs_set_path"
17964 msgstr ""
17965
17966 # type: verbatim
17967 #. type: verbatim
17968 #: ../src/guestfs-actions.pod:5991
17969 #, no-wrap
17970 msgid ""
17971 " int\n"
17972 " guestfs_set_path (guestfs_h *g,\n"
17973 "                   const char *searchpath);\n"
17974 "\n"
17975 msgstr ""
17976
17977 # type: textblock
17978 #. type: textblock
17979 #: ../src/guestfs-actions.pod:5995 ../fish/guestfish-actions.pod:4057
17980 msgid "Set the path that libguestfs searches for kernel and initrd.img."
17981 msgstr ""
17982
17983 # type: textblock
17984 #. type: textblock
17985 #: ../src/guestfs-actions.pod:5997 ../fish/guestfish-actions.pod:4059
17986 msgid ""
17987 "The default is C<$libdir/guestfs> unless overridden by setting "
17988 "C<LIBGUESTFS_PATH> environment variable."
17989 msgstr ""
17990
17991 # type: textblock
17992 #. type: textblock
17993 #: ../src/guestfs-actions.pod:6000 ../fish/guestfish-actions.pod:4062
17994 msgid "Setting C<path> to C<NULL> restores the default path."
17995 msgstr ""
17996
17997 # type: =head2
17998 #. type: =head2
17999 #: ../src/guestfs-actions.pod:6006
18000 msgid "guestfs_set_qemu"
18001 msgstr ""
18002
18003 # type: verbatim
18004 #. type: verbatim
18005 #: ../src/guestfs-actions.pod:6008
18006 #, no-wrap
18007 msgid ""
18008 " int\n"
18009 " guestfs_set_qemu (guestfs_h *g,\n"
18010 "                   const char *qemu);\n"
18011 "\n"
18012 msgstr ""
18013
18014 # type: textblock
18015 #. type: textblock
18016 #: ../src/guestfs-actions.pod:6012 ../fish/guestfish-actions.pod:4070
18017 msgid "Set the qemu binary that we will use."
18018 msgstr ""
18019
18020 # type: textblock
18021 #. type: textblock
18022 #: ../src/guestfs-actions.pod:6014 ../fish/guestfish-actions.pod:4072
18023 msgid ""
18024 "The default is chosen when the library was compiled by the configure script."
18025 msgstr ""
18026
18027 # type: textblock
18028 #. type: textblock
18029 #: ../src/guestfs-actions.pod:6017 ../fish/guestfish-actions.pod:4075
18030 msgid ""
18031 "You can also override this by setting the C<LIBGUESTFS_QEMU> environment "
18032 "variable."
18033 msgstr ""
18034
18035 # type: textblock
18036 #. type: textblock
18037 #: ../src/guestfs-actions.pod:6020 ../fish/guestfish-actions.pod:4078
18038 msgid "Setting C<qemu> to C<NULL> restores the default qemu binary."
18039 msgstr ""
18040
18041 # type: textblock
18042 #. type: textblock
18043 #: ../src/guestfs-actions.pod:6022 ../fish/guestfish-actions.pod:4080
18044 msgid ""
18045 "Note that you should call this function as early as possible after creating "
18046 "the handle.  This is because some pre-launch operations depend on testing "
18047 "qemu features (by running C<qemu -help>).  If the qemu binary changes, we "
18048 "don't retest features, and so you might see inconsistent results.  Using the "
18049 "environment variable C<LIBGUESTFS_QEMU> is safest of all since that picks "
18050 "the qemu binary at the same time as the handle is created."
18051 msgstr ""
18052
18053 # type: =head2
18054 #. type: =head2
18055 #: ../src/guestfs-actions.pod:6034
18056 msgid "guestfs_set_recovery_proc"
18057 msgstr ""
18058
18059 # type: verbatim
18060 #. type: verbatim
18061 #: ../src/guestfs-actions.pod:6036
18062 #, no-wrap
18063 msgid ""
18064 " int\n"
18065 " guestfs_set_recovery_proc (guestfs_h *g,\n"
18066 "                            int recoveryproc);\n"
18067 "\n"
18068 msgstr ""
18069
18070 # type: textblock
18071 #. type: textblock
18072 #: ../src/guestfs-actions.pod:6040
18073 msgid ""
18074 "If this is called with the parameter C<false> then C<guestfs_launch> does "
18075 "not create a recovery process.  The purpose of the recovery process is to "
18076 "stop runaway qemu processes in the case where the main program aborts "
18077 "abruptly."
18078 msgstr ""
18079
18080 # type: textblock
18081 #. type: textblock
18082 #: ../src/guestfs-actions.pod:6045
18083 msgid ""
18084 "This only has any effect if called before C<guestfs_launch>, and the default "
18085 "is true."
18086 msgstr ""
18087
18088 # type: textblock
18089 #. type: textblock
18090 #: ../src/guestfs-actions.pod:6048 ../fish/guestfish-actions.pod:4102
18091 msgid ""
18092 "About the only time when you would want to disable this is if the main "
18093 "process will fork itself into the background (\"daemonize\" itself).  In "
18094 "this case the recovery process thinks that the main program has disappeared "
18095 "and so kills qemu, which is not very helpful."
18096 msgstr ""
18097
18098 # type: =head2
18099 #. type: =head2
18100 #: ../src/guestfs-actions.pod:6058
18101 msgid "guestfs_set_selinux"
18102 msgstr ""
18103
18104 # type: verbatim
18105 #. type: verbatim
18106 #: ../src/guestfs-actions.pod:6060
18107 #, no-wrap
18108 msgid ""
18109 " int\n"
18110 " guestfs_set_selinux (guestfs_h *g,\n"
18111 "                      int selinux);\n"
18112 "\n"
18113 msgstr ""
18114
18115 # type: textblock
18116 #. type: textblock
18117 #: ../src/guestfs-actions.pod:6064 ../fish/guestfish-actions.pod:4114
18118 msgid ""
18119 "This sets the selinux flag that is passed to the appliance at boot time.  "
18120 "The default is C<selinux=0> (disabled)."
18121 msgstr ""
18122
18123 # type: textblock
18124 #. type: textblock
18125 #: ../src/guestfs-actions.pod:6067 ../fish/guestfish-actions.pod:4117
18126 msgid ""
18127 "Note that if SELinux is enabled, it is always in Permissive mode "
18128 "(C<enforcing=0>)."
18129 msgstr ""
18130
18131 # type: =head2
18132 #. type: =head2
18133 #: ../src/guestfs-actions.pod:6077
18134 msgid "guestfs_set_trace"
18135 msgstr ""
18136
18137 # type: verbatim
18138 #. type: verbatim
18139 #: ../src/guestfs-actions.pod:6079
18140 #, no-wrap
18141 msgid ""
18142 " int\n"
18143 " guestfs_set_trace (guestfs_h *g,\n"
18144 "                    int trace);\n"
18145 "\n"
18146 msgstr ""
18147
18148 #. type: textblock
18149 #: ../src/guestfs-actions.pod:6083 ../fish/guestfish-actions.pod:4129
18150 msgid ""
18151 "If the command trace flag is set to 1, then libguestfs calls, parameters and "
18152 "return values are traced."
18153 msgstr ""
18154
18155 # type: textblock
18156 #. type: textblock
18157 #: ../src/guestfs-actions.pod:6086 ../fish/guestfish-actions.pod:4132
18158 msgid ""
18159 "If you want to trace C API calls into libguestfs (and other libraries) then "
18160 "possibly a better way is to use the external ltrace(1) command."
18161 msgstr ""
18162
18163 # type: textblock
18164 #. type: textblock
18165 #: ../src/guestfs-actions.pod:6090 ../fish/guestfish-actions.pod:4136
18166 msgid ""
18167 "Command traces are disabled unless the environment variable "
18168 "C<LIBGUESTFS_TRACE> is defined and set to C<1>."
18169 msgstr ""
18170
18171 #. type: textblock
18172 #: ../src/guestfs-actions.pod:6093
18173 msgid ""
18174 "Trace messages are normally sent to C<stderr>, unless you register a "
18175 "callback to send them somewhere else (see C<guestfs_set_event_callback>)."
18176 msgstr ""
18177
18178 # type: =head2
18179 #. type: =head2
18180 #: ../src/guestfs-actions.pod:6101
18181 msgid "guestfs_set_verbose"
18182 msgstr ""
18183
18184 # type: verbatim
18185 #. type: verbatim
18186 #: ../src/guestfs-actions.pod:6103
18187 #, no-wrap
18188 msgid ""
18189 " int\n"
18190 " guestfs_set_verbose (guestfs_h *g,\n"
18191 "                      int verbose);\n"
18192 "\n"
18193 msgstr ""
18194
18195 #. type: textblock
18196 #: ../src/guestfs-actions.pod:6107 ../fish/guestfish-actions.pod:4149
18197 msgid "If C<verbose> is true, this turns on verbose messages."
18198 msgstr ""
18199
18200 # type: textblock
18201 #. type: textblock
18202 #: ../src/guestfs-actions.pod:6109 ../fish/guestfish-actions.pod:4151
18203 msgid ""
18204 "Verbose messages are disabled unless the environment variable "
18205 "C<LIBGUESTFS_DEBUG> is defined and set to C<1>."
18206 msgstr ""
18207
18208 #. type: textblock
18209 #: ../src/guestfs-actions.pod:6112
18210 msgid ""
18211 "Verbose messages are normally sent to C<stderr>, unless you register a "
18212 "callback to send them somewhere else (see C<guestfs_set_event_callback>)."
18213 msgstr ""
18214
18215 # type: =head2
18216 #. type: =head2
18217 #: ../src/guestfs-actions.pod:6120
18218 msgid "guestfs_setcon"
18219 msgstr ""
18220
18221 # type: verbatim
18222 #. type: verbatim
18223 #: ../src/guestfs-actions.pod:6122
18224 #, no-wrap
18225 msgid ""
18226 " int\n"
18227 " guestfs_setcon (guestfs_h *g,\n"
18228 "                 const char *context);\n"
18229 "\n"
18230 msgstr ""
18231
18232 # type: textblock
18233 #. type: textblock
18234 #: ../src/guestfs-actions.pod:6126 ../fish/guestfish-actions.pod:4162
18235 msgid ""
18236 "This sets the SELinux security context of the daemon to the string "
18237 "C<context>."
18238 msgstr ""
18239
18240 # type: textblock
18241 #. type: textblock
18242 #: ../src/guestfs-actions.pod:6129 ../fish/guestfish-actions.pod:4165
18243 msgid "See the documentation about SELINUX in L<guestfs(3)>."
18244 msgstr ""
18245
18246 # type: =head2
18247 #. type: =head2
18248 #: ../src/guestfs-actions.pod:6135
18249 msgid "guestfs_setxattr"
18250 msgstr ""
18251
18252 # type: verbatim
18253 #. type: verbatim
18254 #: ../src/guestfs-actions.pod:6137
18255 #, no-wrap
18256 msgid ""
18257 " int\n"
18258 " guestfs_setxattr (guestfs_h *g,\n"
18259 "                   const char *xattr,\n"
18260 "                   const char *val,\n"
18261 "                   int vallen,\n"
18262 "                   const char *path);\n"
18263 "\n"
18264 msgstr ""
18265
18266 # type: textblock
18267 #. type: textblock
18268 #: ../src/guestfs-actions.pod:6144 ../fish/guestfish-actions.pod:4171
18269 msgid ""
18270 "This call sets the extended attribute named C<xattr> of the file C<path> to "
18271 "the value C<val> (of length C<vallen>).  The value is arbitrary 8 bit data."
18272 msgstr ""
18273
18274 # type: textblock
18275 #. type: textblock
18276 #: ../src/guestfs-actions.pod:6148
18277 msgid "See also: C<guestfs_lsetxattr>, L<attr(5)>."
18278 msgstr ""
18279
18280 # type: =head2
18281 #. type: =head2
18282 #: ../src/guestfs-actions.pod:6154
18283 msgid "guestfs_sfdisk"
18284 msgstr ""
18285
18286 # type: verbatim
18287 #. type: verbatim
18288 #: ../src/guestfs-actions.pod:6156
18289 #, no-wrap
18290 msgid ""
18291 " int\n"
18292 " guestfs_sfdisk (guestfs_h *g,\n"
18293 "                 const char *device,\n"
18294 "                 int cyls,\n"
18295 "                 int heads,\n"
18296 "                 int sectors,\n"
18297 "                 char *const *lines);\n"
18298 "\n"
18299 msgstr ""
18300
18301 # type: textblock
18302 #. type: textblock
18303 #: ../src/guestfs-actions.pod:6164 ../fish/guestfish-actions.pod:4181
18304 msgid ""
18305 "This is a direct interface to the L<sfdisk(8)> program for creating "
18306 "partitions on block devices."
18307 msgstr ""
18308
18309 # type: textblock
18310 #. type: textblock
18311 #: ../src/guestfs-actions.pod:6167 ../fish/guestfish-actions.pod:4184
18312 msgid "C<device> should be a block device, for example C</dev/sda>."
18313 msgstr ""
18314
18315 # type: textblock
18316 #. type: textblock
18317 #: ../src/guestfs-actions.pod:6169 ../fish/guestfish-actions.pod:4186
18318 msgid ""
18319 "C<cyls>, C<heads> and C<sectors> are the number of cylinders, heads and "
18320 "sectors on the device, which are passed directly to sfdisk as the I<-C>, I<-"
18321 "H> and I<-S> parameters.  If you pass C<0> for any of these, then the "
18322 "corresponding parameter is omitted.  Usually for 'large' disks, you can just "
18323 "pass C<0> for these, but for small (floppy-sized) disks, sfdisk (or rather, "
18324 "the kernel) cannot work out the right geometry and you will need to tell it."
18325 msgstr ""
18326
18327 # type: textblock
18328 #. type: textblock
18329 #: ../src/guestfs-actions.pod:6177 ../fish/guestfish-actions.pod:4194
18330 msgid ""
18331 "C<lines> is a list of lines that we feed to C<sfdisk>.  For more information "
18332 "refer to the L<sfdisk(8)> manpage."
18333 msgstr ""
18334
18335 # type: textblock
18336 #. type: textblock
18337 #: ../src/guestfs-actions.pod:6180 ../fish/guestfish-actions.pod:4197
18338 msgid ""
18339 "To create a single partition occupying the whole disk, you would pass "
18340 "C<lines> as a single element list, when the single element being the string "
18341 "C<,> (comma)."
18342 msgstr ""
18343
18344 # type: textblock
18345 #. type: textblock
18346 #: ../src/guestfs-actions.pod:6184
18347 msgid ""
18348 "See also: C<guestfs_sfdisk_l>, C<guestfs_sfdisk_N>, C<guestfs_part_init>"
18349 msgstr ""
18350
18351 #. type: textblock
18352 #: ../src/guestfs-actions.pod:6192 ../src/guestfs-actions.pod:6222
18353 #: ../src/guestfs-actions.pod:6255
18354 msgid ""
18355 "This function is deprecated.  In new code, use the L</guestfs_part_add> call "
18356 "instead."
18357 msgstr ""
18358
18359 # type: =head2
18360 #. type: =head2
18361 #: ../src/guestfs-actions.pod:6201
18362 msgid "guestfs_sfdiskM"
18363 msgstr ""
18364
18365 # type: verbatim
18366 #. type: verbatim
18367 #: ../src/guestfs-actions.pod:6203
18368 #, no-wrap
18369 msgid ""
18370 " int\n"
18371 " guestfs_sfdiskM (guestfs_h *g,\n"
18372 "                  const char *device,\n"
18373 "                  char *const *lines);\n"
18374 "\n"
18375 msgstr ""
18376
18377 # type: textblock
18378 #. type: textblock
18379 #: ../src/guestfs-actions.pod:6208
18380 msgid ""
18381 "This is a simplified interface to the C<guestfs_sfdisk> command, where "
18382 "partition sizes are specified in megabytes only (rounded to the nearest "
18383 "cylinder) and you don't need to specify the cyls, heads and sectors "
18384 "parameters which were rarely if ever used anyway."
18385 msgstr ""
18386
18387 # type: textblock
18388 #. type: textblock
18389 #: ../src/guestfs-actions.pod:6214
18390 msgid ""
18391 "See also: C<guestfs_sfdisk>, the L<sfdisk(8)> manpage and "
18392 "C<guestfs_part_disk>"
18393 msgstr ""
18394
18395 # type: =head2
18396 #. type: =head2
18397 #: ../src/guestfs-actions.pod:6231
18398 msgid "guestfs_sfdisk_N"
18399 msgstr ""
18400
18401 # type: verbatim
18402 #. type: verbatim
18403 #: ../src/guestfs-actions.pod:6233
18404 #, no-wrap
18405 msgid ""
18406 " int\n"
18407 " guestfs_sfdisk_N (guestfs_h *g,\n"
18408 "                   const char *device,\n"
18409 "                   int partnum,\n"
18410 "                   int cyls,\n"
18411 "                   int heads,\n"
18412 "                   int sectors,\n"
18413 "                   const char *line);\n"
18414 "\n"
18415 msgstr ""
18416
18417 # type: textblock
18418 #. type: textblock
18419 #: ../src/guestfs-actions.pod:6242 ../fish/guestfish-actions.pod:4241
18420 msgid ""
18421 "This runs L<sfdisk(8)> option to modify just the single partition C<n> "
18422 "(note: C<n> counts from 1)."
18423 msgstr ""
18424
18425 # type: textblock
18426 #. type: textblock
18427 #: ../src/guestfs-actions.pod:6245
18428 msgid ""
18429 "For other parameters, see C<guestfs_sfdisk>.  You should usually pass C<0> "
18430 "for the cyls/heads/sectors parameters."
18431 msgstr ""
18432
18433 # type: textblock
18434 #. type: textblock
18435 #: ../src/guestfs-actions.pod:6248
18436 msgid "See also: C<guestfs_part_add>"
18437 msgstr ""
18438
18439 # type: =head2
18440 #. type: =head2
18441 #: ../src/guestfs-actions.pod:6264
18442 msgid "guestfs_sfdisk_disk_geometry"
18443 msgstr ""
18444
18445 # type: verbatim
18446 #. type: verbatim
18447 #: ../src/guestfs-actions.pod:6266
18448 #, no-wrap
18449 msgid ""
18450 " char *\n"
18451 " guestfs_sfdisk_disk_geometry (guestfs_h *g,\n"
18452 "                               const char *device);\n"
18453 "\n"
18454 msgstr ""
18455
18456 # type: textblock
18457 #. type: textblock
18458 #: ../src/guestfs-actions.pod:6270
18459 msgid ""
18460 "This displays the disk geometry of C<device> read from the partition table.  "
18461 "Especially in the case where the underlying block device has been resized, "
18462 "this can be different from the kernel's idea of the geometry (see "
18463 "C<guestfs_sfdisk_kernel_geometry>)."
18464 msgstr ""
18465
18466 # type: textblock
18467 #. type: textblock
18468 #: ../src/guestfs-actions.pod:6275 ../src/guestfs-actions.pod:6291
18469 #: ../fish/guestfish-actions.pod:4268 ../fish/guestfish-actions.pod:4277
18470 msgid "The result is in human-readable format, and not designed to be parsed."
18471 msgstr ""
18472
18473 # type: =head2
18474 #. type: =head2
18475 #: ../src/guestfs-actions.pod:6283
18476 msgid "guestfs_sfdisk_kernel_geometry"
18477 msgstr ""
18478
18479 # type: verbatim
18480 #. type: verbatim
18481 #: ../src/guestfs-actions.pod:6285
18482 #, no-wrap
18483 msgid ""
18484 " char *\n"
18485 " guestfs_sfdisk_kernel_geometry (guestfs_h *g,\n"
18486 "                                 const char *device);\n"
18487 "\n"
18488 msgstr ""
18489
18490 # type: textblock
18491 #. type: textblock
18492 #: ../src/guestfs-actions.pod:6289 ../fish/guestfish-actions.pod:4275
18493 msgid "This displays the kernel's idea of the geometry of C<device>."
18494 msgstr ""
18495
18496 # type: =head2
18497 #. type: =head2
18498 #: ../src/guestfs-actions.pod:6299
18499 msgid "guestfs_sfdisk_l"
18500 msgstr ""
18501
18502 # type: verbatim
18503 #. type: verbatim
18504 #: ../src/guestfs-actions.pod:6301
18505 #, no-wrap
18506 msgid ""
18507 " char *\n"
18508 " guestfs_sfdisk_l (guestfs_h *g,\n"
18509 "                   const char *device);\n"
18510 "\n"
18511 msgstr ""
18512
18513 # type: textblock
18514 #. type: textblock
18515 #: ../src/guestfs-actions.pod:6305 ../fish/guestfish-actions.pod:4284
18516 msgid ""
18517 "This displays the partition table on C<device>, in the human-readable output "
18518 "of the L<sfdisk(8)> command.  It is not intended to be parsed."
18519 msgstr ""
18520
18521 # type: textblock
18522 #. type: textblock
18523 #: ../src/guestfs-actions.pod:6309
18524 msgid "See also: C<guestfs_part_list>"
18525 msgstr ""
18526
18527 #. type: textblock
18528 #: ../src/guestfs-actions.pod:6314
18529 msgid ""
18530 "This function is deprecated.  In new code, use the L</guestfs_part_list> "
18531 "call instead."
18532 msgstr ""
18533
18534 # type: =head2
18535 #. type: =head2
18536 #: ../src/guestfs-actions.pod:6323
18537 msgid "guestfs_sh"
18538 msgstr ""
18539
18540 # type: verbatim
18541 #. type: verbatim
18542 #: ../src/guestfs-actions.pod:6325
18543 #, no-wrap
18544 msgid ""
18545 " char *\n"
18546 " guestfs_sh (guestfs_h *g,\n"
18547 "             const char *command);\n"
18548 "\n"
18549 msgstr ""
18550
18551 # type: textblock
18552 #. type: textblock
18553 #: ../src/guestfs-actions.pod:6329 ../fish/guestfish-actions.pod:4301
18554 msgid ""
18555 "This call runs a command from the guest filesystem via the guest's C</bin/"
18556 "sh>."
18557 msgstr ""
18558
18559 # type: textblock
18560 #. type: textblock
18561 #: ../src/guestfs-actions.pod:6332
18562 msgid "This is like C<guestfs_command>, but passes the command to:"
18563 msgstr ""
18564
18565 # type: verbatim
18566 #. type: verbatim
18567 #: ../src/guestfs-actions.pod:6334 ../fish/guestfish-actions.pod:4306
18568 #, no-wrap
18569 msgid ""
18570 " /bin/sh -c \"command\"\n"
18571 "\n"
18572 msgstr ""
18573
18574 # type: textblock
18575 #. type: textblock
18576 #: ../src/guestfs-actions.pod:6336 ../fish/guestfish-actions.pod:4308
18577 msgid ""
18578 "Depending on the guest's shell, this usually results in wildcards being "
18579 "expanded, shell expressions being interpolated and so on."
18580 msgstr ""
18581
18582 # type: textblock
18583 #. type: textblock
18584 #: ../src/guestfs-actions.pod:6340
18585 msgid "All the provisos about C<guestfs_command> apply to this call."
18586 msgstr ""
18587
18588 # type: =head2
18589 #. type: =head2
18590 #: ../src/guestfs-actions.pod:6347
18591 msgid "guestfs_sh_lines"
18592 msgstr ""
18593
18594 # type: verbatim
18595 #. type: verbatim
18596 #: ../src/guestfs-actions.pod:6349
18597 #, no-wrap
18598 msgid ""
18599 " char **\n"
18600 " guestfs_sh_lines (guestfs_h *g,\n"
18601 "                   const char *command);\n"
18602 "\n"
18603 msgstr ""
18604
18605 # type: textblock
18606 #. type: textblock
18607 #: ../src/guestfs-actions.pod:6353
18608 msgid ""
18609 "This is the same as C<guestfs_sh>, but splits the result into a list of "
18610 "lines."
18611 msgstr ""
18612
18613 # type: textblock
18614 #. type: textblock
18615 #: ../src/guestfs-actions.pod:6356
18616 msgid "See also: C<guestfs_command_lines>"
18617 msgstr ""
18618
18619 # type: =head2
18620 #. type: =head2
18621 #: ../src/guestfs-actions.pod:6364
18622 msgid "guestfs_sleep"
18623 msgstr ""
18624
18625 # type: verbatim
18626 #. type: verbatim
18627 #: ../src/guestfs-actions.pod:6366
18628 #, no-wrap
18629 msgid ""
18630 " int\n"
18631 " guestfs_sleep (guestfs_h *g,\n"
18632 "                int secs);\n"
18633 "\n"
18634 msgstr ""
18635
18636 # type: textblock
18637 #. type: textblock
18638 #: ../src/guestfs-actions.pod:6370 ../fish/guestfish-actions.pod:4327
18639 msgid "Sleep for C<secs> seconds."
18640 msgstr ""
18641
18642 # type: textblock
18643 #. type: textblock
18644 #: ../src/guestfs-actions.pod:6374
18645 msgid "(Added in 1.0.41)"
18646 msgstr ""
18647
18648 # type: =head2
18649 #. type: =head2
18650 #: ../src/guestfs-actions.pod:6376 ../src/guestfs-structs.pod:109
18651 msgid "guestfs_stat"
18652 msgstr ""
18653
18654 # type: verbatim
18655 #. type: verbatim
18656 #: ../src/guestfs-actions.pod:6378
18657 #, no-wrap
18658 msgid ""
18659 " struct guestfs_stat *\n"
18660 " guestfs_stat (guestfs_h *g,\n"
18661 "               const char *path);\n"
18662 "\n"
18663 msgstr ""
18664
18665 # type: textblock
18666 #. type: textblock
18667 #: ../src/guestfs-actions.pod:6384 ../fish/guestfish-actions.pod:4335
18668 msgid "This is the same as the C<stat(2)> system call."
18669 msgstr ""
18670
18671 # type: =head2
18672 #. type: =head2
18673 #: ../src/guestfs-actions.pod:6392 ../src/guestfs-structs.pod:135
18674 msgid "guestfs_statvfs"
18675 msgstr ""
18676
18677 # type: verbatim
18678 #. type: verbatim
18679 #: ../src/guestfs-actions.pod:6394
18680 #, no-wrap
18681 msgid ""
18682 " struct guestfs_statvfs *\n"
18683 " guestfs_statvfs (guestfs_h *g,\n"
18684 "                  const char *path);\n"
18685 "\n"
18686 msgstr ""
18687
18688 # type: textblock
18689 #. type: textblock
18690 #: ../src/guestfs-actions.pod:6398 ../fish/guestfish-actions.pod:4341
18691 msgid ""
18692 "Returns file system statistics for any mounted file system.  C<path> should "
18693 "be a file or directory in the mounted file system (typically it is the mount "
18694 "point itself, but it doesn't need to be)."
18695 msgstr ""
18696
18697 # type: textblock
18698 #. type: textblock
18699 #: ../src/guestfs-actions.pod:6402 ../fish/guestfish-actions.pod:4345
18700 msgid "This is the same as the C<statvfs(2)> system call."
18701 msgstr ""
18702
18703 # type: textblock
18704 #. type: textblock
18705 #: ../src/guestfs-actions.pod:6404
18706 msgid ""
18707 "This function returns a C<struct guestfs_statvfs *>, or NULL if there was an "
18708 "error.  I<The caller must call C<guestfs_free_statvfs> after use>."
18709 msgstr ""
18710
18711 # type: =head2
18712 #. type: =head2
18713 #: ../src/guestfs-actions.pod:6410
18714 msgid "guestfs_strings"
18715 msgstr ""
18716
18717 # type: verbatim
18718 #. type: verbatim
18719 #: ../src/guestfs-actions.pod:6412
18720 #, no-wrap
18721 msgid ""
18722 " char **\n"
18723 " guestfs_strings (guestfs_h *g,\n"
18724 "                  const char *path);\n"
18725 "\n"
18726 msgstr ""
18727
18728 # type: textblock
18729 #. type: textblock
18730 #: ../src/guestfs-actions.pod:6416 ../fish/guestfish-actions.pod:4351
18731 msgid ""
18732 "This runs the L<strings(1)> command on a file and returns the list of "
18733 "printable strings found."
18734 msgstr ""
18735
18736 # type: =head2
18737 #. type: =head2
18738 #: ../src/guestfs-actions.pod:6428
18739 msgid "guestfs_strings_e"
18740 msgstr ""
18741
18742 # type: verbatim
18743 #. type: verbatim
18744 #: ../src/guestfs-actions.pod:6430
18745 #, no-wrap
18746 msgid ""
18747 " char **\n"
18748 " guestfs_strings_e (guestfs_h *g,\n"
18749 "                    const char *encoding,\n"
18750 "                    const char *path);\n"
18751 "\n"
18752 msgstr ""
18753
18754 # type: textblock
18755 #. type: textblock
18756 #: ../src/guestfs-actions.pod:6435
18757 msgid ""
18758 "This is like the C<guestfs_strings> command, but allows you to specify the "
18759 "encoding of strings that are looked for in the source file C<path>."
18760 msgstr ""
18761
18762 # type: textblock
18763 #. type: textblock
18764 #: ../src/guestfs-actions.pod:6439 ../fish/guestfish-actions.pod:4365
18765 msgid "Allowed encodings are:"
18766 msgstr ""
18767
18768 # type: =item
18769 #. type: =item
18770 #: ../src/guestfs-actions.pod:6443 ../fish/guestfish-actions.pod:4369
18771 msgid "s"
18772 msgstr ""
18773
18774 # type: textblock
18775 #. type: textblock
18776 #: ../src/guestfs-actions.pod:6445
18777 msgid ""
18778 "Single 7-bit-byte characters like ASCII and the ASCII-compatible parts of "
18779 "ISO-8859-X (this is what C<guestfs_strings> uses)."
18780 msgstr ""
18781
18782 # type: =item
18783 #. type: =item
18784 #: ../src/guestfs-actions.pod:6448 ../fish/guestfish-actions.pod:4374
18785 msgid "S"
18786 msgstr ""
18787
18788 # type: textblock
18789 #. type: textblock
18790 #: ../src/guestfs-actions.pod:6450 ../fish/guestfish-actions.pod:4376
18791 msgid "Single 8-bit-byte characters."
18792 msgstr ""
18793
18794 # type: =item
18795 #. type: =item
18796 #: ../src/guestfs-actions.pod:6452 ../fish/guestfish-actions.pod:4378
18797 msgid "b"
18798 msgstr ""
18799
18800 # type: textblock
18801 #. type: textblock
18802 #: ../src/guestfs-actions.pod:6454 ../fish/guestfish-actions.pod:4380
18803 msgid "16-bit big endian strings such as those encoded in UTF-16BE or UCS-2BE."
18804 msgstr ""
18805
18806 # type: =item
18807 #. type: =item
18808 #: ../src/guestfs-actions.pod:6457 ../fish/guestfish-actions.pod:4383
18809 msgid "l (lower case letter L)"
18810 msgstr ""
18811
18812 # type: textblock
18813 #. type: textblock
18814 #: ../src/guestfs-actions.pod:6459 ../fish/guestfish-actions.pod:4385
18815 msgid ""
18816 "16-bit little endian such as UTF-16LE and UCS-2LE.  This is useful for "
18817 "examining binaries in Windows guests."
18818 msgstr ""
18819
18820 # type: =item
18821 #. type: =item
18822 #: ../src/guestfs-actions.pod:6462 ../fish/guestfish-actions.pod:4388
18823 msgid "B"
18824 msgstr ""
18825
18826 # type: textblock
18827 #. type: textblock
18828 #: ../src/guestfs-actions.pod:6464 ../fish/guestfish-actions.pod:4390
18829 msgid "32-bit big endian such as UCS-4BE."
18830 msgstr ""
18831
18832 # type: =item
18833 #. type: =item
18834 #: ../src/guestfs-actions.pod:6466 ../fish/guestfish-actions.pod:4392
18835 msgid "L"
18836 msgstr ""
18837
18838 # type: textblock
18839 #. type: textblock
18840 #: ../src/guestfs-actions.pod:6468 ../fish/guestfish-actions.pod:4394
18841 msgid "32-bit little endian such as UCS-4LE."
18842 msgstr ""
18843
18844 # type: textblock
18845 #. type: textblock
18846 #: ../src/guestfs-actions.pod:6472 ../fish/guestfish-actions.pod:4398
18847 msgid "The returned strings are transcoded to UTF-8."
18848 msgstr ""
18849
18850 # type: =head2
18851 #. type: =head2
18852 #: ../src/guestfs-actions.pod:6483
18853 msgid "guestfs_swapoff_device"
18854 msgstr ""
18855
18856 # type: verbatim
18857 #. type: verbatim
18858 #: ../src/guestfs-actions.pod:6485
18859 #, no-wrap
18860 msgid ""
18861 " int\n"
18862 " guestfs_swapoff_device (guestfs_h *g,\n"
18863 "                         const char *device);\n"
18864 "\n"
18865 msgstr ""
18866
18867 # type: textblock
18868 #. type: textblock
18869 #: ../src/guestfs-actions.pod:6489
18870 msgid ""
18871 "This command disables the libguestfs appliance swap device or partition "
18872 "named C<device>.  See C<guestfs_swapon_device>."
18873 msgstr ""
18874
18875 # type: =head2
18876 #. type: =head2
18877 #: ../src/guestfs-actions.pod:6497
18878 msgid "guestfs_swapoff_file"
18879 msgstr ""
18880
18881 # type: verbatim
18882 #. type: verbatim
18883 #: ../src/guestfs-actions.pod:6499
18884 #, no-wrap
18885 msgid ""
18886 " int\n"
18887 " guestfs_swapoff_file (guestfs_h *g,\n"
18888 "                       const char *file);\n"
18889 "\n"
18890 msgstr ""
18891
18892 # type: textblock
18893 #. type: textblock
18894 #: ../src/guestfs-actions.pod:6503 ../fish/guestfish-actions.pod:4415
18895 msgid "This command disables the libguestfs appliance swap on file."
18896 msgstr ""
18897
18898 # type: =head2
18899 #. type: =head2
18900 #: ../src/guestfs-actions.pod:6509
18901 msgid "guestfs_swapoff_label"
18902 msgstr ""
18903
18904 # type: verbatim
18905 #. type: verbatim
18906 #: ../src/guestfs-actions.pod:6511
18907 #, no-wrap
18908 msgid ""
18909 " int\n"
18910 " guestfs_swapoff_label (guestfs_h *g,\n"
18911 "                        const char *label);\n"
18912 "\n"
18913 msgstr ""
18914
18915 # type: textblock
18916 #. type: textblock
18917 #: ../src/guestfs-actions.pod:6515 ../fish/guestfish-actions.pod:4421
18918 msgid ""
18919 "This command disables the libguestfs appliance swap on labeled swap "
18920 "partition."
18921 msgstr ""
18922
18923 # type: =head2
18924 #. type: =head2
18925 #: ../src/guestfs-actions.pod:6522
18926 msgid "guestfs_swapoff_uuid"
18927 msgstr ""
18928
18929 # type: verbatim
18930 #. type: verbatim
18931 #: ../src/guestfs-actions.pod:6524
18932 #, no-wrap
18933 msgid ""
18934 " int\n"
18935 " guestfs_swapoff_uuid (guestfs_h *g,\n"
18936 "                       const char *uuid);\n"
18937 "\n"
18938 msgstr ""
18939
18940 # type: textblock
18941 #. type: textblock
18942 #: ../src/guestfs-actions.pod:6528 ../fish/guestfish-actions.pod:4428
18943 msgid ""
18944 "This command disables the libguestfs appliance swap partition with the given "
18945 "UUID."
18946 msgstr ""
18947
18948 # type: =head2
18949 #. type: =head2
18950 #: ../src/guestfs-actions.pod:6535
18951 msgid "guestfs_swapon_device"
18952 msgstr ""
18953
18954 # type: verbatim
18955 #. type: verbatim
18956 #: ../src/guestfs-actions.pod:6537
18957 #, no-wrap
18958 msgid ""
18959 " int\n"
18960 " guestfs_swapon_device (guestfs_h *g,\n"
18961 "                        const char *device);\n"
18962 "\n"
18963 msgstr ""
18964
18965 # type: textblock
18966 #. type: textblock
18967 #: ../src/guestfs-actions.pod:6541
18968 msgid ""
18969 "This command enables the libguestfs appliance to use the swap device or "
18970 "partition named C<device>.  The increased memory is made available for all "
18971 "commands, for example those run using C<guestfs_command> or C<guestfs_sh>."
18972 msgstr ""
18973
18974 # type: textblock
18975 #. type: textblock
18976 #: ../src/guestfs-actions.pod:6546 ../fish/guestfish-actions.pod:4440
18977 msgid ""
18978 "Note that you should not swap to existing guest swap partitions unless you "
18979 "know what you are doing.  They may contain hibernation information, or other "
18980 "information that the guest doesn't want you to trash.  You also risk leaking "
18981 "information about the host to the guest this way.  Instead, attach a new "
18982 "host device to the guest and swap on that."
18983 msgstr ""
18984
18985 # type: =head2
18986 #. type: =head2
18987 #: ../src/guestfs-actions.pod:6557
18988 msgid "guestfs_swapon_file"
18989 msgstr ""
18990
18991 # type: verbatim
18992 #. type: verbatim
18993 #: ../src/guestfs-actions.pod:6559
18994 #, no-wrap
18995 msgid ""
18996 " int\n"
18997 " guestfs_swapon_file (guestfs_h *g,\n"
18998 "                      const char *file);\n"
18999 "\n"
19000 msgstr ""
19001
19002 # type: textblock
19003 #. type: textblock
19004 #: ../src/guestfs-actions.pod:6563
19005 msgid ""
19006 "This command enables swap to a file.  See C<guestfs_swapon_device> for other "
19007 "notes."
19008 msgstr ""
19009
19010 # type: =head2
19011 #. type: =head2
19012 #: ../src/guestfs-actions.pod:6570
19013 msgid "guestfs_swapon_label"
19014 msgstr ""
19015
19016 # type: verbatim
19017 #. type: verbatim
19018 #: ../src/guestfs-actions.pod:6572
19019 #, no-wrap
19020 msgid ""
19021 " int\n"
19022 " guestfs_swapon_label (guestfs_h *g,\n"
19023 "                       const char *label);\n"
19024 "\n"
19025 msgstr ""
19026
19027 # type: textblock
19028 #. type: textblock
19029 #: ../src/guestfs-actions.pod:6576
19030 msgid ""
19031 "This command enables swap to a labeled swap partition.  See "
19032 "C<guestfs_swapon_device> for other notes."
19033 msgstr ""
19034
19035 # type: =head2
19036 #. type: =head2
19037 #: ../src/guestfs-actions.pod:6583
19038 msgid "guestfs_swapon_uuid"
19039 msgstr ""
19040
19041 # type: verbatim
19042 #. type: verbatim
19043 #: ../src/guestfs-actions.pod:6585
19044 #, no-wrap
19045 msgid ""
19046 " int\n"
19047 " guestfs_swapon_uuid (guestfs_h *g,\n"
19048 "                      const char *uuid);\n"
19049 "\n"
19050 msgstr ""
19051
19052 # type: textblock
19053 #. type: textblock
19054 #: ../src/guestfs-actions.pod:6589
19055 msgid ""
19056 "This command enables swap to a swap partition with the given UUID.  See "
19057 "C<guestfs_swapon_device> for other notes."
19058 msgstr ""
19059
19060 # type: =head2
19061 #. type: =head2
19062 #: ../src/guestfs-actions.pod:6596
19063 msgid "guestfs_sync"
19064 msgstr ""
19065
19066 # type: verbatim
19067 #. type: verbatim
19068 #: ../src/guestfs-actions.pod:6598
19069 #, no-wrap
19070 msgid ""
19071 " int\n"
19072 " guestfs_sync (guestfs_h *g);\n"
19073 "\n"
19074 msgstr ""
19075
19076 # type: textblock
19077 #. type: textblock
19078 #: ../src/guestfs-actions.pod:6601 ../fish/guestfish-actions.pod:4472
19079 msgid ""
19080 "This syncs the disk, so that any writes are flushed through to the "
19081 "underlying disk image."
19082 msgstr ""
19083
19084 # type: textblock
19085 #. type: textblock
19086 #: ../src/guestfs-actions.pod:6604 ../fish/guestfish-actions.pod:4475
19087 msgid ""
19088 "You should always call this if you have modified a disk image, before "
19089 "closing the handle."
19090 msgstr ""
19091
19092 # type: =head2
19093 #. type: =head2
19094 #: ../src/guestfs-actions.pod:6611
19095 msgid "guestfs_tail"
19096 msgstr ""
19097
19098 # type: verbatim
19099 #. type: verbatim
19100 #: ../src/guestfs-actions.pod:6613
19101 #, no-wrap
19102 msgid ""
19103 " char **\n"
19104 " guestfs_tail (guestfs_h *g,\n"
19105 "               const char *path);\n"
19106 "\n"
19107 msgstr ""
19108
19109 # type: textblock
19110 #. type: textblock
19111 #: ../src/guestfs-actions.pod:6617 ../fish/guestfish-actions.pod:4482
19112 msgid ""
19113 "This command returns up to the last 10 lines of a file as a list of strings."
19114 msgstr ""
19115
19116 # type: =head2
19117 #. type: =head2
19118 #: ../src/guestfs-actions.pod:6629
19119 msgid "guestfs_tail_n"
19120 msgstr ""
19121
19122 # type: verbatim
19123 #. type: verbatim
19124 #: ../src/guestfs-actions.pod:6631
19125 #, no-wrap
19126 msgid ""
19127 " char **\n"
19128 " guestfs_tail_n (guestfs_h *g,\n"
19129 "                 int nrlines,\n"
19130 "                 const char *path);\n"
19131 "\n"
19132 msgstr ""
19133
19134 # type: textblock
19135 #. type: textblock
19136 #: ../src/guestfs-actions.pod:6636 ../fish/guestfish-actions.pod:4492
19137 msgid ""
19138 "If the parameter C<nrlines> is a positive number, this returns the last "
19139 "C<nrlines> lines of the file C<path>."
19140 msgstr ""
19141
19142 # type: textblock
19143 #. type: textblock
19144 #: ../src/guestfs-actions.pod:6639 ../fish/guestfish-actions.pod:4495
19145 msgid ""
19146 "If the parameter C<nrlines> is a negative number, this returns lines from "
19147 "the file C<path>, starting with the C<-nrlines>th line."
19148 msgstr ""
19149
19150 # type: =head2
19151 #. type: =head2
19152 #: ../src/guestfs-actions.pod:6653
19153 msgid "guestfs_tar_in"
19154 msgstr ""
19155
19156 # type: verbatim
19157 #. type: verbatim
19158 #: ../src/guestfs-actions.pod:6655
19159 #, no-wrap
19160 msgid ""
19161 " int\n"
19162 " guestfs_tar_in (guestfs_h *g,\n"
19163 "                 const char *tarfile,\n"
19164 "                 const char *directory);\n"
19165 "\n"
19166 msgstr ""
19167
19168 # type: textblock
19169 #. type: textblock
19170 #: ../src/guestfs-actions.pod:6660 ../fish/guestfish-actions.pod:4507
19171 msgid ""
19172 "This command uploads and unpacks local file C<tarfile> (an I<uncompressed> "
19173 "tar file) into C<directory>."
19174 msgstr ""
19175
19176 # type: textblock
19177 #. type: textblock
19178 #: ../src/guestfs-actions.pod:6663
19179 msgid ""
19180 "To upload a compressed tarball, use C<guestfs_tgz_in> or C<guestfs_txz_in>."
19181 msgstr ""
19182
19183 # type: textblock
19184 #. type: textblock
19185 #: ../src/guestfs-actions.pod:6668 ../src/guestfs-actions.pod:6685
19186 #: ../src/guestfs-actions.pod:6701 ../src/guestfs-actions.pod:6717
19187 msgid "(Added in 1.0.3)"
19188 msgstr ""
19189
19190 # type: =head2
19191 #. type: =head2
19192 #: ../src/guestfs-actions.pod:6670
19193 msgid "guestfs_tar_out"
19194 msgstr ""
19195
19196 # type: verbatim
19197 #. type: verbatim
19198 #: ../src/guestfs-actions.pod:6672
19199 #, no-wrap
19200 msgid ""
19201 " int\n"
19202 " guestfs_tar_out (guestfs_h *g,\n"
19203 "                  const char *directory,\n"
19204 "                  const char *tarfile);\n"
19205 "\n"
19206 msgstr ""
19207
19208 # type: textblock
19209 #. type: textblock
19210 #: ../src/guestfs-actions.pod:6677 ../fish/guestfish-actions.pod:4519
19211 msgid ""
19212 "This command packs the contents of C<directory> and downloads it to local "
19213 "file C<tarfile>."
19214 msgstr ""
19215
19216 # type: textblock
19217 #. type: textblock
19218 #: ../src/guestfs-actions.pod:6680
19219 msgid ""
19220 "To download a compressed tarball, use C<guestfs_tgz_out> or "
19221 "C<guestfs_txz_out>."
19222 msgstr ""
19223
19224 # type: =head2
19225 #. type: =head2
19226 #: ../src/guestfs-actions.pod:6687
19227 msgid "guestfs_tgz_in"
19228 msgstr ""
19229
19230 # type: verbatim
19231 #. type: verbatim
19232 #: ../src/guestfs-actions.pod:6689
19233 #, no-wrap
19234 msgid ""
19235 " int\n"
19236 " guestfs_tgz_in (guestfs_h *g,\n"
19237 "                 const char *tarball,\n"
19238 "                 const char *directory);\n"
19239 "\n"
19240 msgstr ""
19241
19242 # type: textblock
19243 #. type: textblock
19244 #: ../src/guestfs-actions.pod:6694 ../fish/guestfish-actions.pod:4531
19245 msgid ""
19246 "This command uploads and unpacks local file C<tarball> (a I<gzip compressed> "
19247 "tar file) into C<directory>."
19248 msgstr ""
19249
19250 # type: textblock
19251 #. type: textblock
19252 #: ../src/guestfs-actions.pod:6697
19253 msgid "To upload an uncompressed tarball, use C<guestfs_tar_in>."
19254 msgstr ""
19255
19256 # type: =head2
19257 #. type: =head2
19258 #: ../src/guestfs-actions.pod:6703
19259 msgid "guestfs_tgz_out"
19260 msgstr ""
19261
19262 # type: verbatim
19263 #. type: verbatim
19264 #: ../src/guestfs-actions.pod:6705
19265 #, no-wrap
19266 msgid ""
19267 " int\n"
19268 " guestfs_tgz_out (guestfs_h *g,\n"
19269 "                  const char *directory,\n"
19270 "                  const char *tarball);\n"
19271 "\n"
19272 msgstr ""
19273
19274 # type: textblock
19275 #. type: textblock
19276 #: ../src/guestfs-actions.pod:6710 ../fish/guestfish-actions.pod:4542
19277 msgid ""
19278 "This command packs the contents of C<directory> and downloads it to local "
19279 "file C<tarball>."
19280 msgstr ""
19281
19282 # type: textblock
19283 #. type: textblock
19284 #: ../src/guestfs-actions.pod:6713
19285 msgid "To download an uncompressed tarball, use C<guestfs_tar_out>."
19286 msgstr ""
19287
19288 # type: =head2
19289 #. type: =head2
19290 #: ../src/guestfs-actions.pod:6719
19291 msgid "guestfs_touch"
19292 msgstr ""
19293
19294 # type: verbatim
19295 #. type: verbatim
19296 #: ../src/guestfs-actions.pod:6721
19297 #, no-wrap
19298 msgid ""
19299 " int\n"
19300 " guestfs_touch (guestfs_h *g,\n"
19301 "                const char *path);\n"
19302 "\n"
19303 msgstr ""
19304
19305 # type: textblock
19306 #. type: textblock
19307 #: ../src/guestfs-actions.pod:6725 ../fish/guestfish-actions.pod:4553
19308 msgid ""
19309 "Touch acts like the L<touch(1)> command.  It can be used to update the "
19310 "timestamps on a file, or, if the file does not exist, to create a new zero-"
19311 "length file."
19312 msgstr ""
19313
19314 # type: textblock
19315 #. type: textblock
19316 #: ../src/guestfs-actions.pod:6729 ../fish/guestfish-actions.pod:4557
19317 msgid ""
19318 "This command only works on regular files, and will fail on other file types "
19319 "such as directories, symbolic links, block special etc."
19320 msgstr ""
19321
19322 # type: =head2
19323 #. type: =head2
19324 #: ../src/guestfs-actions.pod:6736
19325 msgid "guestfs_truncate"
19326 msgstr ""
19327
19328 # type: verbatim
19329 #. type: verbatim
19330 #: ../src/guestfs-actions.pod:6738
19331 #, no-wrap
19332 msgid ""
19333 " int\n"
19334 " guestfs_truncate (guestfs_h *g,\n"
19335 "                   const char *path);\n"
19336 "\n"
19337 msgstr ""
19338
19339 # type: textblock
19340 #. type: textblock
19341 #: ../src/guestfs-actions.pod:6742 ../fish/guestfish-actions.pod:4564
19342 msgid ""
19343 "This command truncates C<path> to a zero-length file.  The file must exist "
19344 "already."
19345 msgstr ""
19346
19347 # type: =head2
19348 #. type: =head2
19349 #: ../src/guestfs-actions.pod:6749
19350 msgid "guestfs_truncate_size"
19351 msgstr ""
19352
19353 # type: verbatim
19354 #. type: verbatim
19355 #: ../src/guestfs-actions.pod:6751
19356 #, no-wrap
19357 msgid ""
19358 " int\n"
19359 " guestfs_truncate_size (guestfs_h *g,\n"
19360 "                        const char *path,\n"
19361 "                        int64_t size);\n"
19362 "\n"
19363 msgstr ""
19364
19365 # type: textblock
19366 #. type: textblock
19367 #: ../src/guestfs-actions.pod:6756 ../fish/guestfish-actions.pod:4571
19368 msgid ""
19369 "This command truncates C<path> to size C<size> bytes.  The file must exist "
19370 "already."
19371 msgstr ""
19372
19373 # type: textblock
19374 #. type: textblock
19375 #: ../src/guestfs-actions.pod:6759
19376 msgid ""
19377 "If the current file size is less than C<size> then the file is extended to "
19378 "the required size with zero bytes.  This creates a sparse file (ie. disk "
19379 "blocks are not allocated for the file until you write to it).  To create a "
19380 "non-sparse file of zeroes, use C<guestfs_fallocate64> instead."
19381 msgstr ""
19382
19383 # type: =head2
19384 #. type: =head2
19385 #: ../src/guestfs-actions.pod:6769
19386 msgid "guestfs_tune2fs_l"
19387 msgstr ""
19388
19389 # type: verbatim
19390 #. type: verbatim
19391 #: ../src/guestfs-actions.pod:6771
19392 #, no-wrap
19393 msgid ""
19394 " char **\n"
19395 " guestfs_tune2fs_l (guestfs_h *g,\n"
19396 "                    const char *device);\n"
19397 "\n"
19398 msgstr ""
19399
19400 # type: textblock
19401 #. type: textblock
19402 #: ../src/guestfs-actions.pod:6775 ../fish/guestfish-actions.pod:4584
19403 msgid ""
19404 "This returns the contents of the ext2, ext3 or ext4 filesystem superblock on "
19405 "C<device>."
19406 msgstr ""
19407
19408 # type: textblock
19409 #. type: textblock
19410 #: ../src/guestfs-actions.pod:6778 ../fish/guestfish-actions.pod:4587
19411 msgid ""
19412 "It is the same as running C<tune2fs -l device>.  See L<tune2fs(8)> manpage "
19413 "for more details.  The list of fields returned isn't clearly defined, and "
19414 "depends on both the version of C<tune2fs> that libguestfs was built against, "
19415 "and the filesystem itself."
19416 msgstr ""
19417
19418 # type: =head2
19419 #. type: =head2
19420 #: ../src/guestfs-actions.pod:6791
19421 msgid "guestfs_txz_in"
19422 msgstr ""
19423
19424 # type: verbatim
19425 #. type: verbatim
19426 #: ../src/guestfs-actions.pod:6793
19427 #, no-wrap
19428 msgid ""
19429 " int\n"
19430 " guestfs_txz_in (guestfs_h *g,\n"
19431 "                 const char *tarball,\n"
19432 "                 const char *directory);\n"
19433 "\n"
19434 msgstr ""
19435
19436 # type: textblock
19437 #. type: textblock
19438 #: ../src/guestfs-actions.pod:6798 ../fish/guestfish-actions.pod:4596
19439 msgid ""
19440 "This command uploads and unpacks local file C<tarball> (an I<xz compressed> "
19441 "tar file) into C<directory>."
19442 msgstr ""
19443
19444 # type: =head2
19445 #. type: =head2
19446 #: ../src/guestfs-actions.pod:6805
19447 msgid "guestfs_txz_out"
19448 msgstr ""
19449
19450 # type: verbatim
19451 #. type: verbatim
19452 #: ../src/guestfs-actions.pod:6807
19453 #, no-wrap
19454 msgid ""
19455 " int\n"
19456 " guestfs_txz_out (guestfs_h *g,\n"
19457 "                  const char *directory,\n"
19458 "                  const char *tarball);\n"
19459 "\n"
19460 msgstr ""
19461
19462 # type: textblock
19463 #. type: textblock
19464 #: ../src/guestfs-actions.pod:6812 ../fish/guestfish-actions.pod:4605
19465 msgid ""
19466 "This command packs the contents of C<directory> and downloads it to local "
19467 "file C<tarball> (as an xz compressed tar archive)."
19468 msgstr ""
19469
19470 # type: =head2
19471 #. type: =head2
19472 #: ../src/guestfs-actions.pod:6819
19473 msgid "guestfs_umask"
19474 msgstr ""
19475
19476 # type: verbatim
19477 #. type: verbatim
19478 #: ../src/guestfs-actions.pod:6821
19479 #, no-wrap
19480 msgid ""
19481 " int\n"
19482 " guestfs_umask (guestfs_h *g,\n"
19483 "                int mask);\n"
19484 "\n"
19485 msgstr ""
19486
19487 # type: textblock
19488 #. type: textblock
19489 #: ../src/guestfs-actions.pod:6825 ../fish/guestfish-actions.pod:4614
19490 msgid ""
19491 "This function sets the mask used for creating new files and device nodes to "
19492 "C<mask & 0777>."
19493 msgstr ""
19494
19495 # type: textblock
19496 #. type: textblock
19497 #: ../src/guestfs-actions.pod:6828 ../fish/guestfish-actions.pod:4617
19498 msgid ""
19499 "Typical umask values would be C<022> which creates new files with "
19500 "permissions like \"-rw-r--r--\" or \"-rwxr-xr-x\", and C<002> which creates "
19501 "new files with permissions like \"-rw-rw-r--\" or \"-rwxrwxr-x\"."
19502 msgstr ""
19503
19504 # type: textblock
19505 #. type: textblock
19506 #: ../src/guestfs-actions.pod:6833 ../fish/guestfish-actions.pod:4622
19507 msgid ""
19508 "The default umask is C<022>.  This is important because it means that "
19509 "directories and device nodes will be created with C<0644> or C<0755> mode "
19510 "even if you specify C<0777>."
19511 msgstr ""
19512
19513 # type: textblock
19514 #. type: textblock
19515 #: ../src/guestfs-actions.pod:6837
19516 msgid ""
19517 "See also C<guestfs_get_umask>, L<umask(2)>, C<guestfs_mknod>, "
19518 "C<guestfs_mkdir>."
19519 msgstr ""
19520
19521 # type: textblock
19522 #. type: textblock
19523 #: ../src/guestfs-actions.pod:6840 ../fish/guestfish-actions.pod:4629
19524 msgid "This call returns the previous umask."
19525 msgstr ""
19526
19527 # type: =head2
19528 #. type: =head2
19529 #: ../src/guestfs-actions.pod:6846
19530 msgid "guestfs_umount"
19531 msgstr ""
19532
19533 # type: verbatim
19534 #. type: verbatim
19535 #: ../src/guestfs-actions.pod:6848
19536 #, no-wrap
19537 msgid ""
19538 " int\n"
19539 " guestfs_umount (guestfs_h *g,\n"
19540 "                 const char *pathordevice);\n"
19541 "\n"
19542 msgstr ""
19543
19544 # type: textblock
19545 #. type: textblock
19546 #: ../src/guestfs-actions.pod:6852 ../fish/guestfish-actions.pod:4637
19547 msgid ""
19548 "This unmounts the given filesystem.  The filesystem may be specified either "
19549 "by its mountpoint (path) or the device which contains the filesystem."
19550 msgstr ""
19551
19552 # type: =head2
19553 #. type: =head2
19554 #: ../src/guestfs-actions.pod:6860
19555 msgid "guestfs_umount_all"
19556 msgstr ""
19557
19558 # type: verbatim
19559 #. type: verbatim
19560 #: ../src/guestfs-actions.pod:6862
19561 #, no-wrap
19562 msgid ""
19563 " int\n"
19564 " guestfs_umount_all (guestfs_h *g);\n"
19565 "\n"
19566 msgstr ""
19567
19568 # type: textblock
19569 #. type: textblock
19570 #: ../src/guestfs-actions.pod:6865 ../fish/guestfish-actions.pod:4647
19571 msgid "This unmounts all mounted filesystems."
19572 msgstr ""
19573
19574 # type: textblock
19575 #. type: textblock
19576 #: ../src/guestfs-actions.pod:6867 ../fish/guestfish-actions.pod:4649
19577 msgid "Some internal mounts are not unmounted by this call."
19578 msgstr ""
19579
19580 # type: =head2
19581 #. type: =head2
19582 #: ../src/guestfs-actions.pod:6873
19583 msgid "guestfs_upload"
19584 msgstr ""
19585
19586 # type: verbatim
19587 #. type: verbatim
19588 #: ../src/guestfs-actions.pod:6875
19589 #, no-wrap
19590 msgid ""
19591 " int\n"
19592 " guestfs_upload (guestfs_h *g,\n"
19593 "                 const char *filename,\n"
19594 "                 const char *remotefilename);\n"
19595 "\n"
19596 msgstr ""
19597
19598 # type: textblock
19599 #. type: textblock
19600 #: ../src/guestfs-actions.pod:6880 ../src/guestfs-actions.pod:6904
19601 #: ../fish/guestfish-actions.pod:4655 ../fish/guestfish-actions.pod:4668
19602 msgid "Upload local file C<filename> to C<remotefilename> on the filesystem."
19603 msgstr ""
19604
19605 # type: textblock
19606 #. type: textblock
19607 #: ../src/guestfs-actions.pod:6885
19608 msgid "See also C<guestfs_download>."
19609 msgstr ""
19610
19611 # type: =head2
19612 #. type: =head2
19613 #: ../src/guestfs-actions.pod:6896
19614 msgid "guestfs_upload_offset"
19615 msgstr ""
19616
19617 # type: verbatim
19618 #. type: verbatim
19619 #: ../src/guestfs-actions.pod:6898
19620 #, no-wrap
19621 msgid ""
19622 " int\n"
19623 " guestfs_upload_offset (guestfs_h *g,\n"
19624 "                        const char *filename,\n"
19625 "                        const char *remotefilename,\n"
19626 "                        int64_t offset);\n"
19627 "\n"
19628 msgstr ""
19629
19630 # type: textblock
19631 #. type: textblock
19632 #: ../src/guestfs-actions.pod:6907 ../fish/guestfish-actions.pod:4671
19633 msgid ""
19634 "C<remotefilename> is overwritten starting at the byte C<offset> specified.  "
19635 "The intention is to overwrite parts of existing files or devices, although "
19636 "if a non-existant file is specified then it is created with a \"hole\" "
19637 "before C<offset>.  The size of the data written is implicit in the size of "
19638 "the source C<filename>."
19639 msgstr ""
19640
19641 # type: textblock
19642 #. type: textblock
19643 #: ../src/guestfs-actions.pod:6914
19644 msgid ""
19645 "Note that there is no limit on the amount of data that can be uploaded with "
19646 "this call, unlike with C<guestfs_pwrite>, and this call always writes the "
19647 "full amount unless an error occurs."
19648 msgstr ""
19649
19650 # type: textblock
19651 #. type: textblock
19652 #: ../src/guestfs-actions.pod:6919
19653 msgid "See also C<guestfs_upload>, C<guestfs_pwrite>."
19654 msgstr ""
19655
19656 # type: =head2
19657 #. type: =head2
19658 #: ../src/guestfs-actions.pod:6930
19659 msgid "guestfs_utimens"
19660 msgstr ""
19661
19662 # type: verbatim
19663 #. type: verbatim
19664 #: ../src/guestfs-actions.pod:6932
19665 #, no-wrap
19666 msgid ""
19667 " int\n"
19668 " guestfs_utimens (guestfs_h *g,\n"
19669 "                  const char *path,\n"
19670 "                  int64_t atsecs,\n"
19671 "                  int64_t atnsecs,\n"
19672 "                  int64_t mtsecs,\n"
19673 "                  int64_t mtnsecs);\n"
19674 "\n"
19675 msgstr ""
19676
19677 # type: textblock
19678 #. type: textblock
19679 #: ../src/guestfs-actions.pod:6940 ../fish/guestfish-actions.pod:4691
19680 msgid "This command sets the timestamps of a file with nanosecond precision."
19681 msgstr ""
19682
19683 # type: textblock
19684 #. type: textblock
19685 #: ../src/guestfs-actions.pod:6943 ../fish/guestfish-actions.pod:4694
19686 msgid ""
19687 "C<atsecs, atnsecs> are the last access time (atime) in secs and nanoseconds "
19688 "from the epoch."
19689 msgstr ""
19690
19691 # type: textblock
19692 #. type: textblock
19693 #: ../src/guestfs-actions.pod:6946 ../fish/guestfish-actions.pod:4697
19694 msgid ""
19695 "C<mtsecs, mtnsecs> are the last modification time (mtime) in secs and "
19696 "nanoseconds from the epoch."
19697 msgstr ""
19698
19699 # type: textblock
19700 #. type: textblock
19701 #: ../src/guestfs-actions.pod:6949 ../fish/guestfish-actions.pod:4700
19702 msgid ""
19703 "If the C<*nsecs> field contains the special value C<-1> then the "
19704 "corresponding timestamp is set to the current time.  (The C<*secs> field is "
19705 "ignored in this case)."
19706 msgstr ""
19707
19708 # type: textblock
19709 #. type: textblock
19710 #: ../src/guestfs-actions.pod:6953 ../fish/guestfish-actions.pod:4704
19711 msgid ""
19712 "If the C<*nsecs> field contains the special value C<-2> then the "
19713 "corresponding timestamp is left unchanged.  (The C<*secs> field is ignored "
19714 "in this case)."
19715 msgstr ""
19716
19717 # type: =head2
19718 #. type: =head2
19719 #: ../src/guestfs-actions.pod:6961 ../src/guestfs-structs.pod:175
19720 msgid "guestfs_version"
19721 msgstr ""
19722
19723 # type: verbatim
19724 #. type: verbatim
19725 #: ../src/guestfs-actions.pod:6963
19726 #, no-wrap
19727 msgid ""
19728 " struct guestfs_version *\n"
19729 " guestfs_version (guestfs_h *g);\n"
19730 "\n"
19731 msgstr ""
19732
19733 # type: textblock
19734 #. type: textblock
19735 #: ../src/guestfs-actions.pod:6966 ../fish/guestfish-actions.pod:4712
19736 msgid ""
19737 "Return the libguestfs version number that the program is linked against."
19738 msgstr ""
19739
19740 # type: textblock
19741 #. type: textblock
19742 #: ../src/guestfs-actions.pod:6969 ../fish/guestfish-actions.pod:4715
19743 msgid ""
19744 "Note that because of dynamic linking this is not necessarily the version of "
19745 "libguestfs that you compiled against.  You can compile the program, and then "
19746 "at runtime dynamically link against a completely different C<libguestfs.so> "
19747 "library."
19748 msgstr ""
19749
19750 # type: textblock
19751 #. type: textblock
19752 #: ../src/guestfs-actions.pod:6974 ../fish/guestfish-actions.pod:4720
19753 msgid ""
19754 "This call was added in version C<1.0.58>.  In previous versions of "
19755 "libguestfs there was no way to get the version number.  From C code you can "
19756 "use dynamic linker functions to find out if this symbol exists (if it "
19757 "doesn't, then it's an earlier version)."
19758 msgstr ""
19759
19760 # type: textblock
19761 #. type: textblock
19762 #: ../src/guestfs-actions.pod:6980 ../fish/guestfish-actions.pod:4726
19763 msgid ""
19764 "The call returns a structure with four elements.  The first three (C<major>, "
19765 "C<minor> and C<release>) are numbers and correspond to the usual version "
19766 "triplet.  The fourth element (C<extra>) is a string and is normally empty, "
19767 "but may be used for distro-specific information."
19768 msgstr ""
19769
19770 # type: textblock
19771 #. type: textblock
19772 #: ../src/guestfs-actions.pod:6986 ../fish/guestfish-actions.pod:4732
19773 msgid ""
19774 "To construct the original version string: C<$major.$minor.$release$extra>"
19775 msgstr ""
19776
19777 # type: textblock
19778 #. type: textblock
19779 #: ../src/guestfs-actions.pod:6989 ../fish/guestfish-actions.pod:4735
19780 msgid "See also: L<guestfs(3)/LIBGUESTFS VERSION NUMBERS>."
19781 msgstr ""
19782
19783 # type: textblock
19784 #. type: textblock
19785 #: ../src/guestfs-actions.pod:6991
19786 msgid ""
19787 "I<Note:> Don't use this call to test for availability of features.  In "
19788 "enterprise distributions we backport features from later versions into "
19789 "earlier versions, making this an unreliable way to test for features.  Use "
19790 "C<guestfs_available> instead."
19791 msgstr ""
19792
19793 # type: textblock
19794 #. type: textblock
19795 #: ../src/guestfs-actions.pod:6997
19796 msgid ""
19797 "This function returns a C<struct guestfs_version *>, or NULL if there was an "
19798 "error.  I<The caller must call C<guestfs_free_version> after use>."
19799 msgstr ""
19800
19801 # type: textblock
19802 #. type: textblock
19803 #: ../src/guestfs-actions.pod:7001
19804 msgid "(Added in 1.0.58)"
19805 msgstr ""
19806
19807 # type: =head2
19808 #. type: =head2
19809 #: ../src/guestfs-actions.pod:7003
19810 msgid "guestfs_vfs_label"
19811 msgstr ""
19812
19813 # type: verbatim
19814 #. type: verbatim
19815 #: ../src/guestfs-actions.pod:7005
19816 #, no-wrap
19817 msgid ""
19818 " char *\n"
19819 " guestfs_vfs_label (guestfs_h *g,\n"
19820 "                    const char *device);\n"
19821 "\n"
19822 msgstr ""
19823
19824 # type: textblock
19825 #. type: textblock
19826 #: ../src/guestfs-actions.pod:7009 ../fish/guestfish-actions.pod:4747
19827 msgid "This returns the filesystem label of the filesystem on C<device>."
19828 msgstr ""
19829
19830 # type: textblock
19831 #. type: textblock
19832 #: ../src/guestfs-actions.pod:7012 ../fish/guestfish-actions.pod:4750
19833 msgid "If the filesystem is unlabeled, this returns the empty string."
19834 msgstr ""
19835
19836 # type: textblock
19837 #. type: textblock
19838 #: ../src/guestfs-actions.pod:7014
19839 msgid "To find a filesystem from the label, use C<guestfs_findfs_label>."
19840 msgstr ""
19841
19842 # type: textblock
19843 #. type: textblock
19844 #: ../src/guestfs-actions.pod:7019 ../src/guestfs-actions.pod:7056
19845 msgid "(Added in 1.3.18)"
19846 msgstr ""
19847
19848 # type: =head2
19849 #. type: =head2
19850 #: ../src/guestfs-actions.pod:7021
19851 msgid "guestfs_vfs_type"
19852 msgstr ""
19853
19854 # type: verbatim
19855 #. type: verbatim
19856 #: ../src/guestfs-actions.pod:7023
19857 #, no-wrap
19858 msgid ""
19859 " char *\n"
19860 " guestfs_vfs_type (guestfs_h *g,\n"
19861 "                   const char *device);\n"
19862 "\n"
19863 msgstr ""
19864
19865 # type: textblock
19866 #. type: textblock
19867 #: ../src/guestfs-actions.pod:7027 ../fish/guestfish-actions.pod:4758
19868 msgid ""
19869 "This command gets the filesystem type corresponding to the filesystem on "
19870 "C<device>."
19871 msgstr ""
19872
19873 # type: textblock
19874 #. type: textblock
19875 #: ../src/guestfs-actions.pod:7030 ../fish/guestfish-actions.pod:4761
19876 msgid ""
19877 "For most filesystems, the result is the name of the Linux VFS module which "
19878 "would be used to mount this filesystem if you mounted it without specifying "
19879 "the filesystem type.  For example a string such as C<ext3> or C<ntfs>."
19880 msgstr ""
19881
19882 # type: =head2
19883 #. type: =head2
19884 #: ../src/guestfs-actions.pod:7040
19885 msgid "guestfs_vfs_uuid"
19886 msgstr ""
19887
19888 # type: verbatim
19889 #. type: verbatim
19890 #: ../src/guestfs-actions.pod:7042
19891 #, no-wrap
19892 msgid ""
19893 " char *\n"
19894 " guestfs_vfs_uuid (guestfs_h *g,\n"
19895 "                   const char *device);\n"
19896 "\n"
19897 msgstr ""
19898
19899 # type: textblock
19900 #. type: textblock
19901 #: ../src/guestfs-actions.pod:7046 ../fish/guestfish-actions.pod:4770
19902 msgid "This returns the filesystem UUID of the filesystem on C<device>."
19903 msgstr ""
19904
19905 # type: textblock
19906 #. type: textblock
19907 #: ../src/guestfs-actions.pod:7049 ../fish/guestfish-actions.pod:4773
19908 msgid "If the filesystem does not have a UUID, this returns the empty string."
19909 msgstr ""
19910
19911 # type: textblock
19912 #. type: textblock
19913 #: ../src/guestfs-actions.pod:7051
19914 msgid "To find a filesystem from the UUID, use C<guestfs_findfs_uuid>."
19915 msgstr ""
19916
19917 # type: =head2
19918 #. type: =head2
19919 #: ../src/guestfs-actions.pod:7058
19920 msgid "guestfs_vg_activate"
19921 msgstr ""
19922
19923 # type: verbatim
19924 #. type: verbatim
19925 #: ../src/guestfs-actions.pod:7060
19926 #, no-wrap
19927 msgid ""
19928 " int\n"
19929 " guestfs_vg_activate (guestfs_h *g,\n"
19930 "                      int activate,\n"
19931 "                      char *const *volgroups);\n"
19932 "\n"
19933 msgstr ""
19934
19935 # type: textblock
19936 #. type: textblock
19937 #: ../src/guestfs-actions.pod:7065 ../fish/guestfish-actions.pod:4781
19938 msgid ""
19939 "This command activates or (if C<activate> is false) deactivates all logical "
19940 "volumes in the listed volume groups C<volgroups>.  If activated, then they "
19941 "are made known to the kernel, ie. they appear as C</dev/mapper> devices.  If "
19942 "deactivated, then those devices disappear."
19943 msgstr ""
19944
19945 # type: textblock
19946 #. type: textblock
19947 #: ../src/guestfs-actions.pod:7071 ../fish/guestfish-actions.pod:4787
19948 msgid "This command is the same as running C<vgchange -a y|n volgroups...>"
19949 msgstr ""
19950
19951 # type: textblock
19952 #. type: textblock
19953 #: ../src/guestfs-actions.pod:7073 ../fish/guestfish-actions.pod:4789
19954 msgid ""
19955 "Note that if C<volgroups> is an empty list then B<all> volume groups are "
19956 "activated or deactivated."
19957 msgstr ""
19958
19959 # type: =head2
19960 #. type: =head2
19961 #: ../src/guestfs-actions.pod:7080
19962 msgid "guestfs_vg_activate_all"
19963 msgstr ""
19964
19965 # type: verbatim
19966 #. type: verbatim
19967 #: ../src/guestfs-actions.pod:7082
19968 #, no-wrap
19969 msgid ""
19970 " int\n"
19971 " guestfs_vg_activate_all (guestfs_h *g,\n"
19972 "                          int activate);\n"
19973 "\n"
19974 msgstr ""
19975
19976 # type: textblock
19977 #. type: textblock
19978 #: ../src/guestfs-actions.pod:7086 ../fish/guestfish-actions.pod:4796
19979 msgid ""
19980 "This command activates or (if C<activate> is false) deactivates all logical "
19981 "volumes in all volume groups.  If activated, then they are made known to the "
19982 "kernel, ie. they appear as C</dev/mapper> devices.  If deactivated, then "
19983 "those devices disappear."
19984 msgstr ""
19985
19986 # type: textblock
19987 #. type: textblock
19988 #: ../src/guestfs-actions.pod:7092 ../fish/guestfish-actions.pod:4802
19989 msgid "This command is the same as running C<vgchange -a y|n>"
19990 msgstr ""
19991
19992 # type: =head2
19993 #. type: =head2
19994 #: ../src/guestfs-actions.pod:7098
19995 msgid "guestfs_vgcreate"
19996 msgstr ""
19997
19998 # type: verbatim
19999 #. type: verbatim
20000 #: ../src/guestfs-actions.pod:7100
20001 #, no-wrap
20002 msgid ""
20003 " int\n"
20004 " guestfs_vgcreate (guestfs_h *g,\n"
20005 "                   const char *volgroup,\n"
20006 "                   char *const *physvols);\n"
20007 "\n"
20008 msgstr ""
20009
20010 # type: textblock
20011 #. type: textblock
20012 #: ../src/guestfs-actions.pod:7105 ../fish/guestfish-actions.pod:4808
20013 msgid ""
20014 "This creates an LVM volume group called C<volgroup> from the non-empty list "
20015 "of physical volumes C<physvols>."
20016 msgstr ""
20017
20018 # type: =head2
20019 #. type: =head2
20020 #: ../src/guestfs-actions.pod:7112
20021 msgid "guestfs_vglvuuids"
20022 msgstr ""
20023
20024 # type: verbatim
20025 #. type: verbatim
20026 #: ../src/guestfs-actions.pod:7114
20027 #, no-wrap
20028 msgid ""
20029 " char **\n"
20030 " guestfs_vglvuuids (guestfs_h *g,\n"
20031 "                    const char *vgname);\n"
20032 "\n"
20033 msgstr ""
20034
20035 # type: textblock
20036 #. type: textblock
20037 #: ../src/guestfs-actions.pod:7118 ../fish/guestfish-actions.pod:4815
20038 msgid ""
20039 "Given a VG called C<vgname>, this returns the UUIDs of all the logical "
20040 "volumes created in this volume group."
20041 msgstr ""
20042
20043 # type: textblock
20044 #. type: textblock
20045 #: ../src/guestfs-actions.pod:7121
20046 msgid ""
20047 "You can use this along with C<guestfs_lvs> and C<guestfs_lvuuid> calls to "
20048 "associate logical volumes and volume groups."
20049 msgstr ""
20050
20051 # type: textblock
20052 #. type: textblock
20053 #: ../src/guestfs-actions.pod:7124
20054 msgid "See also C<guestfs_vgpvuuids>."
20055 msgstr ""
20056
20057 # type: =head2
20058 #. type: =head2
20059 #: ../src/guestfs-actions.pod:7132
20060 msgid "guestfs_vgpvuuids"
20061 msgstr ""
20062
20063 # type: verbatim
20064 #. type: verbatim
20065 #: ../src/guestfs-actions.pod:7134
20066 #, no-wrap
20067 msgid ""
20068 " char **\n"
20069 " guestfs_vgpvuuids (guestfs_h *g,\n"
20070 "                    const char *vgname);\n"
20071 "\n"
20072 msgstr ""
20073
20074 # type: textblock
20075 #. type: textblock
20076 #: ../src/guestfs-actions.pod:7138 ../fish/guestfish-actions.pod:4827
20077 msgid ""
20078 "Given a VG called C<vgname>, this returns the UUIDs of all the physical "
20079 "volumes that this volume group resides on."
20080 msgstr ""
20081
20082 # type: textblock
20083 #. type: textblock
20084 #: ../src/guestfs-actions.pod:7141
20085 msgid ""
20086 "You can use this along with C<guestfs_pvs> and C<guestfs_pvuuid> calls to "
20087 "associate physical volumes and volume groups."
20088 msgstr ""
20089
20090 # type: textblock
20091 #. type: textblock
20092 #: ../src/guestfs-actions.pod:7144
20093 msgid "See also C<guestfs_vglvuuids>."
20094 msgstr ""
20095
20096 # type: =head2
20097 #. type: =head2
20098 #: ../src/guestfs-actions.pod:7152
20099 msgid "guestfs_vgremove"
20100 msgstr ""
20101
20102 # type: verbatim
20103 #. type: verbatim
20104 #: ../src/guestfs-actions.pod:7154
20105 #, no-wrap
20106 msgid ""
20107 " int\n"
20108 " guestfs_vgremove (guestfs_h *g,\n"
20109 "                   const char *vgname);\n"
20110 "\n"
20111 msgstr ""
20112
20113 # type: textblock
20114 #. type: textblock
20115 #: ../src/guestfs-actions.pod:7158 ../fish/guestfish-actions.pod:4839
20116 msgid "Remove an LVM volume group C<vgname>, (for example C<VG>)."
20117 msgstr ""
20118
20119 # type: textblock
20120 #. type: textblock
20121 #: ../src/guestfs-actions.pod:7160 ../fish/guestfish-actions.pod:4841
20122 msgid ""
20123 "This also forcibly removes all logical volumes in the volume group (if any)."
20124 msgstr ""
20125
20126 # type: =head2
20127 #. type: =head2
20128 #: ../src/guestfs-actions.pod:7167
20129 msgid "guestfs_vgrename"
20130 msgstr ""
20131
20132 # type: verbatim
20133 #. type: verbatim
20134 #: ../src/guestfs-actions.pod:7169
20135 #, no-wrap
20136 msgid ""
20137 " int\n"
20138 " guestfs_vgrename (guestfs_h *g,\n"
20139 "                   const char *volgroup,\n"
20140 "                   const char *newvolgroup);\n"
20141 "\n"
20142 msgstr ""
20143
20144 # type: textblock
20145 #. type: textblock
20146 #: ../src/guestfs-actions.pod:7174 ../fish/guestfish-actions.pod:4848
20147 msgid "Rename a volume group C<volgroup> with the new name C<newvolgroup>."
20148 msgstr ""
20149
20150 # type: =head2
20151 #. type: =head2
20152 #: ../src/guestfs-actions.pod:7180
20153 msgid "guestfs_vgs"
20154 msgstr ""
20155
20156 # type: verbatim
20157 #. type: verbatim
20158 #: ../src/guestfs-actions.pod:7182
20159 #, no-wrap
20160 msgid ""
20161 " char **\n"
20162 " guestfs_vgs (guestfs_h *g);\n"
20163 "\n"
20164 msgstr ""
20165
20166 # type: textblock
20167 #. type: textblock
20168 #: ../src/guestfs-actions.pod:7185 ../fish/guestfish-actions.pod:4854
20169 msgid ""
20170 "List all the volumes groups detected.  This is the equivalent of the L<vgs(8)"
20171 "> command."
20172 msgstr ""
20173
20174 # type: textblock
20175 #. type: textblock
20176 #: ../src/guestfs-actions.pod:7188 ../fish/guestfish-actions.pod:4857
20177 msgid ""
20178 "This returns a list of just the volume group names that were detected (eg. "
20179 "C<VolGroup00>)."
20180 msgstr ""
20181
20182 # type: textblock
20183 #. type: textblock
20184 #: ../src/guestfs-actions.pod:7191
20185 msgid "See also C<guestfs_vgs_full>."
20186 msgstr ""
20187
20188 # type: =head2
20189 #. type: =head2
20190 #: ../src/guestfs-actions.pod:7199
20191 msgid "guestfs_vgs_full"
20192 msgstr ""
20193
20194 # type: verbatim
20195 #. type: verbatim
20196 #: ../src/guestfs-actions.pod:7201
20197 #, no-wrap
20198 msgid ""
20199 " struct guestfs_lvm_vg_list *\n"
20200 " guestfs_vgs_full (guestfs_h *g);\n"
20201 "\n"
20202 msgstr ""
20203
20204 # type: textblock
20205 #. type: textblock
20206 #: ../src/guestfs-actions.pod:7204 ../fish/guestfish-actions.pod:4866
20207 msgid ""
20208 "List all the volumes groups detected.  This is the equivalent of the L<vgs(8)"
20209 "> command.  The \"full\" version includes all fields."
20210 msgstr ""
20211
20212 # type: textblock
20213 #. type: textblock
20214 #: ../src/guestfs-actions.pod:7207
20215 msgid ""
20216 "This function returns a C<struct guestfs_lvm_vg_list *>, or NULL if there "
20217 "was an error.  I<The caller must call C<guestfs_free_lvm_vg_list> after use>."
20218 msgstr ""
20219
20220 # type: =head2
20221 #. type: =head2
20222 #: ../src/guestfs-actions.pod:7213
20223 msgid "guestfs_vgscan"
20224 msgstr ""
20225
20226 # type: verbatim
20227 #. type: verbatim
20228 #: ../src/guestfs-actions.pod:7215
20229 #, no-wrap
20230 msgid ""
20231 " int\n"
20232 " guestfs_vgscan (guestfs_h *g);\n"
20233 "\n"
20234 msgstr ""
20235
20236 # type: textblock
20237 #. type: textblock
20238 #: ../src/guestfs-actions.pod:7218 ../fish/guestfish-actions.pod:4873
20239 msgid ""
20240 "This rescans all block devices and rebuilds the list of LVM physical "
20241 "volumes, volume groups and logical volumes."
20242 msgstr ""
20243
20244 # type: =head2
20245 #. type: =head2
20246 #: ../src/guestfs-actions.pod:7225
20247 msgid "guestfs_vguuid"
20248 msgstr ""
20249
20250 # type: verbatim
20251 #. type: verbatim
20252 #: ../src/guestfs-actions.pod:7227
20253 #, no-wrap
20254 msgid ""
20255 " char *\n"
20256 " guestfs_vguuid (guestfs_h *g,\n"
20257 "                 const char *vgname);\n"
20258 "\n"
20259 msgstr ""
20260
20261 # type: textblock
20262 #. type: textblock
20263 #: ../src/guestfs-actions.pod:7231 ../fish/guestfish-actions.pod:4880
20264 msgid "This command returns the UUID of the LVM VG named C<vgname>."
20265 msgstr ""
20266
20267 # type: =head2
20268 #. type: =head2
20269 #: ../src/guestfs-actions.pod:7238
20270 msgid "guestfs_wait_ready"
20271 msgstr ""
20272
20273 # type: verbatim
20274 #. type: verbatim
20275 #: ../src/guestfs-actions.pod:7240
20276 #, no-wrap
20277 msgid ""
20278 " int\n"
20279 " guestfs_wait_ready (guestfs_h *g);\n"
20280 "\n"
20281 msgstr ""
20282
20283 # type: textblock
20284 #. type: textblock
20285 #: ../src/guestfs-actions.pod:7243
20286 msgid "This function is a no op."
20287 msgstr ""
20288
20289 # type: textblock
20290 #. type: textblock
20291 #: ../src/guestfs-actions.pod:7245
20292 msgid ""
20293 "In versions of the API E<lt> 1.0.71 you had to call this function just after "
20294 "calling C<guestfs_launch> to wait for the launch to complete.  However this "
20295 "is no longer necessary because C<guestfs_launch> now does the waiting."
20296 msgstr ""
20297
20298 # type: textblock
20299 #. type: textblock
20300 #: ../src/guestfs-actions.pod:7250
20301 msgid ""
20302 "If you see any calls to this function in code then you can just remove them, "
20303 "unless you want to retain compatibility with older versions of the API."
20304 msgstr ""
20305
20306 #. type: textblock
20307 #: ../src/guestfs-actions.pod:7256
20308 msgid ""
20309 "This function is deprecated.  In new code, use the L</guestfs_launch> call "
20310 "instead."
20311 msgstr ""
20312
20313 # type: =head2
20314 #. type: =head2
20315 #: ../src/guestfs-actions.pod:7265
20316 msgid "guestfs_wc_c"
20317 msgstr ""
20318
20319 # type: verbatim
20320 #. type: verbatim
20321 #: ../src/guestfs-actions.pod:7267
20322 #, no-wrap
20323 msgid ""
20324 " int\n"
20325 " guestfs_wc_c (guestfs_h *g,\n"
20326 "               const char *path);\n"
20327 "\n"
20328 msgstr ""
20329
20330 # type: textblock
20331 #. type: textblock
20332 #: ../src/guestfs-actions.pod:7271 ../fish/guestfish-actions.pod:4886
20333 msgid ""
20334 "This command counts the characters in a file, using the C<wc -c> external "
20335 "command."
20336 msgstr ""
20337
20338 # type: =head2
20339 #. type: =head2
20340 #: ../src/guestfs-actions.pod:7278
20341 msgid "guestfs_wc_l"
20342 msgstr ""
20343
20344 # type: verbatim
20345 #. type: verbatim
20346 #: ../src/guestfs-actions.pod:7280
20347 #, no-wrap
20348 msgid ""
20349 " int\n"
20350 " guestfs_wc_l (guestfs_h *g,\n"
20351 "               const char *path);\n"
20352 "\n"
20353 msgstr ""
20354
20355 # type: textblock
20356 #. type: textblock
20357 #: ../src/guestfs-actions.pod:7284 ../fish/guestfish-actions.pod:4893
20358 msgid ""
20359 "This command counts the lines in a file, using the C<wc -l> external command."
20360 msgstr ""
20361
20362 # type: =head2
20363 #. type: =head2
20364 #: ../src/guestfs-actions.pod:7291
20365 msgid "guestfs_wc_w"
20366 msgstr ""
20367
20368 # type: verbatim
20369 #. type: verbatim
20370 #: ../src/guestfs-actions.pod:7293
20371 #, no-wrap
20372 msgid ""
20373 " int\n"
20374 " guestfs_wc_w (guestfs_h *g,\n"
20375 "               const char *path);\n"
20376 "\n"
20377 msgstr ""
20378
20379 # type: textblock
20380 #. type: textblock
20381 #: ../src/guestfs-actions.pod:7297 ../fish/guestfish-actions.pod:4900
20382 msgid ""
20383 "This command counts the words in a file, using the C<wc -w> external command."
20384 msgstr ""
20385
20386 # type: =head2
20387 #. type: =head2
20388 #: ../src/guestfs-actions.pod:7304
20389 msgid "guestfs_write"
20390 msgstr ""
20391
20392 # type: verbatim
20393 #. type: verbatim
20394 #: ../src/guestfs-actions.pod:7306
20395 #, no-wrap
20396 msgid ""
20397 " int\n"
20398 " guestfs_write (guestfs_h *g,\n"
20399 "                const char *path,\n"
20400 "                const char *content,\n"
20401 "                size_t content_size);\n"
20402 "\n"
20403 msgstr ""
20404
20405 # type: textblock
20406 #. type: textblock
20407 #: ../src/guestfs-actions.pod:7312 ../fish/guestfish-actions.pod:4907
20408 msgid ""
20409 "This call creates a file called C<path>.  The content of the file is the "
20410 "string C<content> (which can contain any 8 bit data)."
20411 msgstr ""
20412
20413 # type: =head2
20414 #. type: =head2
20415 #: ../src/guestfs-actions.pod:7322
20416 msgid "guestfs_write_file"
20417 msgstr ""
20418
20419 # type: verbatim
20420 #. type: verbatim
20421 #: ../src/guestfs-actions.pod:7324
20422 #, no-wrap
20423 msgid ""
20424 " int\n"
20425 " guestfs_write_file (guestfs_h *g,\n"
20426 "                     const char *path,\n"
20427 "                     const char *content,\n"
20428 "                     int size);\n"
20429 "\n"
20430 msgstr ""
20431
20432 # type: textblock
20433 #. type: textblock
20434 #: ../src/guestfs-actions.pod:7330 ../fish/guestfish-actions.pod:4917
20435 msgid ""
20436 "This call creates a file called C<path>.  The contents of the file is the "
20437 "string C<content> (which can contain any 8 bit data), with length C<size>."
20438 msgstr ""
20439
20440 # type: textblock
20441 #. type: textblock
20442 #: ../src/guestfs-actions.pod:7334 ../fish/guestfish-actions.pod:4921
20443 msgid ""
20444 "As a special case, if C<size> is C<0> then the length is calculated using "
20445 "C<strlen> (so in this case the content cannot contain embedded ASCII NULs)."
20446 msgstr ""
20447
20448 # type: textblock
20449 #. type: textblock
20450 #: ../src/guestfs-actions.pod:7338 ../fish/guestfish-actions.pod:4925
20451 msgid ""
20452 "I<NB.> Owing to a bug, writing content containing ASCII NUL characters does "
20453 "I<not> work, even if the length is specified."
20454 msgstr ""
20455
20456 #. type: textblock
20457 #: ../src/guestfs-actions.pod:7346
20458 msgid ""
20459 "This function is deprecated.  In new code, use the L</guestfs_write> call "
20460 "instead."
20461 msgstr ""
20462
20463 # type: =head2
20464 #. type: =head2
20465 #: ../src/guestfs-actions.pod:7355
20466 msgid "guestfs_zegrep"
20467 msgstr ""
20468
20469 # type: verbatim
20470 #. type: verbatim
20471 #: ../src/guestfs-actions.pod:7357
20472 #, no-wrap
20473 msgid ""
20474 " char **\n"
20475 " guestfs_zegrep (guestfs_h *g,\n"
20476 "                 const char *regex,\n"
20477 "                 const char *path);\n"
20478 "\n"
20479 msgstr ""
20480
20481 # type: textblock
20482 #. type: textblock
20483 #: ../src/guestfs-actions.pod:7362 ../fish/guestfish-actions.pod:4942
20484 msgid ""
20485 "This calls the external C<zegrep> program and returns the matching lines."
20486 msgstr ""
20487
20488 # type: =head2
20489 #. type: =head2
20490 #: ../src/guestfs-actions.pod:7374
20491 msgid "guestfs_zegrepi"
20492 msgstr ""
20493
20494 # type: verbatim
20495 #. type: verbatim
20496 #: ../src/guestfs-actions.pod:7376
20497 #, no-wrap
20498 msgid ""
20499 " char **\n"
20500 " guestfs_zegrepi (guestfs_h *g,\n"
20501 "                  const char *regex,\n"
20502 "                  const char *path);\n"
20503 "\n"
20504 msgstr ""
20505
20506 # type: textblock
20507 #. type: textblock
20508 #: ../src/guestfs-actions.pod:7381 ../fish/guestfish-actions.pod:4952
20509 msgid ""
20510 "This calls the external C<zegrep -i> program and returns the matching lines."
20511 msgstr ""
20512
20513 # type: =head2
20514 #. type: =head2
20515 #: ../src/guestfs-actions.pod:7393
20516 msgid "guestfs_zero"
20517 msgstr ""
20518
20519 # type: verbatim
20520 #. type: verbatim
20521 #: ../src/guestfs-actions.pod:7395
20522 #, no-wrap
20523 msgid ""
20524 " int\n"
20525 " guestfs_zero (guestfs_h *g,\n"
20526 "               const char *device);\n"
20527 "\n"
20528 msgstr ""
20529
20530 # type: textblock
20531 #. type: textblock
20532 #: ../src/guestfs-actions.pod:7399 ../fish/guestfish-actions.pod:4962
20533 msgid "This command writes zeroes over the first few blocks of C<device>."
20534 msgstr ""
20535
20536 # type: textblock
20537 #. type: textblock
20538 #: ../src/guestfs-actions.pod:7401 ../fish/guestfish-actions.pod:4964
20539 msgid ""
20540 "How many blocks are zeroed isn't specified (but it's I<not> enough to "
20541 "securely wipe the device).  It should be sufficient to remove any partition "
20542 "tables, filesystem superblocks and so on."
20543 msgstr ""
20544
20545 # type: textblock
20546 #. type: textblock
20547 #: ../src/guestfs-actions.pod:7405
20548 msgid "See also: C<guestfs_zero_device>, C<guestfs_scrub_device>."
20549 msgstr ""
20550
20551 # type: =head2
20552 #. type: =head2
20553 #: ../src/guestfs-actions.pod:7416
20554 msgid "guestfs_zero_device"
20555 msgstr ""
20556
20557 # type: verbatim
20558 #. type: verbatim
20559 #: ../src/guestfs-actions.pod:7418
20560 #, no-wrap
20561 msgid ""
20562 " int\n"
20563 " guestfs_zero_device (guestfs_h *g,\n"
20564 "                      const char *device);\n"
20565 "\n"
20566 msgstr ""
20567
20568 # type: textblock
20569 #. type: textblock
20570 #: ../src/guestfs-actions.pod:7422
20571 msgid ""
20572 "This command writes zeroes over the entire C<device>.  Compare with "
20573 "C<guestfs_zero> which just zeroes the first few blocks of a device."
20574 msgstr ""
20575
20576 # type: textblock
20577 #. type: textblock
20578 #: ../src/guestfs-actions.pod:7436
20579 msgid "(Added in 1.3.1)"
20580 msgstr ""
20581
20582 # type: =head2
20583 #. type: =head2
20584 #: ../src/guestfs-actions.pod:7438
20585 msgid "guestfs_zerofree"
20586 msgstr ""
20587
20588 # type: verbatim
20589 #. type: verbatim
20590 #: ../src/guestfs-actions.pod:7440
20591 #, no-wrap
20592 msgid ""
20593 " int\n"
20594 " guestfs_zerofree (guestfs_h *g,\n"
20595 "                   const char *device);\n"
20596 "\n"
20597 msgstr ""
20598
20599 # type: textblock
20600 #. type: textblock
20601 #: ../src/guestfs-actions.pod:7444 ../fish/guestfish-actions.pod:4985
20602 msgid ""
20603 "This runs the I<zerofree> program on C<device>.  This program claims to zero "
20604 "unused inodes and disk blocks on an ext2/3 filesystem, thus making it "
20605 "possible to compress the filesystem more effectively."
20606 msgstr ""
20607
20608 # type: textblock
20609 #. type: textblock
20610 #: ../src/guestfs-actions.pod:7449 ../fish/guestfish-actions.pod:4990
20611 msgid "You should B<not> run this program if the filesystem is mounted."
20612 msgstr ""
20613
20614 # type: textblock
20615 #. type: textblock
20616 #: ../src/guestfs-actions.pod:7452 ../fish/guestfish-actions.pod:4993
20617 msgid ""
20618 "It is possible that using this program can damage the filesystem or data on "
20619 "the filesystem."
20620 msgstr ""
20621
20622 # type: =head2
20623 #. type: =head2
20624 #: ../src/guestfs-actions.pod:7459
20625 msgid "guestfs_zfgrep"
20626 msgstr ""
20627
20628 # type: verbatim
20629 #. type: verbatim
20630 #: ../src/guestfs-actions.pod:7461
20631 #, no-wrap
20632 msgid ""
20633 " char **\n"
20634 " guestfs_zfgrep (guestfs_h *g,\n"
20635 "                 const char *pattern,\n"
20636 "                 const char *path);\n"
20637 "\n"
20638 msgstr ""
20639
20640 # type: textblock
20641 #. type: textblock
20642 #: ../src/guestfs-actions.pod:7466 ../fish/guestfish-actions.pod:5000
20643 msgid ""
20644 "This calls the external C<zfgrep> program and returns the matching lines."
20645 msgstr ""
20646
20647 # type: =head2
20648 #. type: =head2
20649 #: ../src/guestfs-actions.pod:7478
20650 msgid "guestfs_zfgrepi"
20651 msgstr ""
20652
20653 # type: verbatim
20654 #. type: verbatim
20655 #: ../src/guestfs-actions.pod:7480
20656 #, no-wrap
20657 msgid ""
20658 " char **\n"
20659 " guestfs_zfgrepi (guestfs_h *g,\n"
20660 "                  const char *pattern,\n"
20661 "                  const char *path);\n"
20662 "\n"
20663 msgstr ""
20664
20665 # type: textblock
20666 #. type: textblock
20667 #: ../src/guestfs-actions.pod:7485 ../fish/guestfish-actions.pod:5010
20668 msgid ""
20669 "This calls the external C<zfgrep -i> program and returns the matching lines."
20670 msgstr ""
20671
20672 # type: =head2
20673 #. type: =head2
20674 #: ../src/guestfs-actions.pod:7497
20675 msgid "guestfs_zfile"
20676 msgstr ""
20677
20678 # type: verbatim
20679 #. type: verbatim
20680 #: ../src/guestfs-actions.pod:7499
20681 #, no-wrap
20682 msgid ""
20683 " char *\n"
20684 " guestfs_zfile (guestfs_h *g,\n"
20685 "                const char *meth,\n"
20686 "                const char *path);\n"
20687 "\n"
20688 msgstr ""
20689
20690 # type: textblock
20691 #. type: textblock
20692 #: ../src/guestfs-actions.pod:7504 ../fish/guestfish-actions.pod:5020
20693 msgid ""
20694 "This command runs C<file> after first decompressing C<path> using C<method>."
20695 msgstr ""
20696
20697 # type: textblock
20698 #. type: textblock
20699 #: ../src/guestfs-actions.pod:7507 ../fish/guestfish-actions.pod:5023
20700 msgid "C<method> must be one of C<gzip>, C<compress> or C<bzip2>."
20701 msgstr ""
20702
20703 # type: textblock
20704 #. type: textblock
20705 #: ../src/guestfs-actions.pod:7509
20706 msgid ""
20707 "Since 1.0.63, use C<guestfs_file> instead which can now process compressed "
20708 "files."
20709 msgstr ""
20710
20711 #. type: textblock
20712 #: ../src/guestfs-actions.pod:7515
20713 msgid ""
20714 "This function is deprecated.  In new code, use the L</guestfs_file> call "
20715 "instead."
20716 msgstr ""
20717
20718 # type: =head2
20719 #. type: =head2
20720 #: ../src/guestfs-actions.pod:7524
20721 msgid "guestfs_zgrep"
20722 msgstr ""
20723
20724 # type: verbatim
20725 #. type: verbatim
20726 #: ../src/guestfs-actions.pod:7526
20727 #, no-wrap
20728 msgid ""
20729 " char **\n"
20730 " guestfs_zgrep (guestfs_h *g,\n"
20731 "                const char *regex,\n"
20732 "                const char *path);\n"
20733 "\n"
20734 msgstr ""
20735
20736 # type: textblock
20737 #. type: textblock
20738 #: ../src/guestfs-actions.pod:7531 ../fish/guestfish-actions.pod:5039
20739 msgid ""
20740 "This calls the external C<zgrep> program and returns the matching lines."
20741 msgstr ""
20742
20743 # type: =head2
20744 #. type: =head2
20745 #: ../src/guestfs-actions.pod:7543
20746 msgid "guestfs_zgrepi"
20747 msgstr ""
20748
20749 # type: verbatim
20750 #. type: verbatim
20751 #: ../src/guestfs-actions.pod:7545
20752 #, no-wrap
20753 msgid ""
20754 " char **\n"
20755 " guestfs_zgrepi (guestfs_h *g,\n"
20756 "                 const char *regex,\n"
20757 "                 const char *path);\n"
20758 "\n"
20759 msgstr ""
20760
20761 # type: textblock
20762 #. type: textblock
20763 #: ../src/guestfs-actions.pod:7550 ../fish/guestfish-actions.pod:5049
20764 msgid ""
20765 "This calls the external C<zgrep -i> program and returns the matching lines."
20766 msgstr ""
20767
20768 # type: =item
20769 #. type: =item
20770 #: ../src/guestfs-availability.pod:3
20771 msgid "B<augeas>"
20772 msgstr ""
20773
20774 # type: textblock
20775 #. type: textblock
20776 #: ../src/guestfs-availability.pod:5
20777 msgid ""
20778 "The following functions: L</guestfs_aug_clear> L</guestfs_aug_close> L</"
20779 "guestfs_aug_defnode> L</guestfs_aug_defvar> L</guestfs_aug_get> L</"
20780 "guestfs_aug_init> L</guestfs_aug_insert> L</guestfs_aug_load> L</"
20781 "guestfs_aug_ls> L</guestfs_aug_match> L</guestfs_aug_mv> L</guestfs_aug_rm> "
20782 "L</guestfs_aug_save> L</guestfs_aug_set>"
20783 msgstr ""
20784
20785 #. type: =item
20786 #: ../src/guestfs-availability.pod:21
20787 msgid "B<grub>"
20788 msgstr ""
20789
20790 #. type: textblock
20791 #: ../src/guestfs-availability.pod:23
20792 msgid "The following functions: L</guestfs_grub_install>"
20793 msgstr ""
20794
20795 # type: =item
20796 #. type: =item
20797 #: ../src/guestfs-availability.pod:26
20798 msgid "B<inotify>"
20799 msgstr ""
20800
20801 # type: textblock
20802 #. type: textblock
20803 #: ../src/guestfs-availability.pod:28
20804 msgid ""
20805 "The following functions: L</guestfs_inotify_add_watch> L</"
20806 "guestfs_inotify_close> L</guestfs_inotify_files> L</guestfs_inotify_init> L</"
20807 "guestfs_inotify_read> L</guestfs_inotify_rm_watch>"
20808 msgstr ""
20809
20810 # type: =item
20811 #. type: =item
20812 #: ../src/guestfs-availability.pod:36
20813 msgid "B<linuxfsuuid>"
20814 msgstr ""
20815
20816 # type: textblock
20817 #. type: textblock
20818 #: ../src/guestfs-availability.pod:38
20819 msgid ""
20820 "The following functions: L</guestfs_mke2fs_JU> L</guestfs_mke2journal_U> L</"
20821 "guestfs_mkswap_U> L</guestfs_swapoff_uuid> L</guestfs_swapon_uuid>"
20822 msgstr ""
20823
20824 # type: =item
20825 #. type: =item
20826 #: ../src/guestfs-availability.pod:45
20827 msgid "B<linuxmodules>"
20828 msgstr ""
20829
20830 # type: textblock
20831 #. type: textblock
20832 #: ../src/guestfs-availability.pod:47
20833 msgid "The following functions: L</guestfs_modprobe>"
20834 msgstr ""
20835
20836 # type: =item
20837 #. type: =item
20838 #: ../src/guestfs-availability.pod:50
20839 msgid "B<linuxxattrs>"
20840 msgstr ""
20841
20842 # type: textblock
20843 #. type: textblock
20844 #: ../src/guestfs-availability.pod:52
20845 msgid ""
20846 "The following functions: L</guestfs_getxattr> L</guestfs_getxattrs> L</"
20847 "guestfs_lgetxattr> L</guestfs_lgetxattrs> L</guestfs_lremovexattr> L</"
20848 "guestfs_lsetxattr> L</guestfs_lxattrlist> L</guestfs_removexattr> L</"
20849 "guestfs_setxattr>"
20850 msgstr ""
20851
20852 # type: =item
20853 #. type: =item
20854 #: ../src/guestfs-availability.pod:63
20855 msgid "B<luks>"
20856 msgstr ""
20857
20858 # type: textblock
20859 #. type: textblock
20860 #: ../src/guestfs-availability.pod:65
20861 msgid ""
20862 "The following functions: L</guestfs_luks_add_key> L</guestfs_luks_close> L</"
20863 "guestfs_luks_format> L</guestfs_luks_format_cipher> L</"
20864 "guestfs_luks_kill_slot> L</guestfs_luks_open> L</guestfs_luks_open_ro>"
20865 msgstr ""
20866
20867 # type: =item
20868 #. type: =item
20869 #: ../src/guestfs-availability.pod:74
20870 msgid "B<lvm2>"
20871 msgstr ""
20872
20873 # type: textblock
20874 #. type: textblock
20875 #: ../src/guestfs-availability.pod:76
20876 msgid ""
20877 "The following functions: L</guestfs_is_lv> L</guestfs_lvcreate> L</"
20878 "guestfs_lvm_remove_all> L</guestfs_lvm_set_filter> L</guestfs_lvremove> L</"
20879 "guestfs_lvresize> L</guestfs_lvresize_free> L</guestfs_lvs> L</"
20880 "guestfs_lvs_full> L</guestfs_pvcreate> L</guestfs_pvremove> L</"
20881 "guestfs_pvresize> L</guestfs_pvresize_size> L</guestfs_pvs> L</"
20882 "guestfs_pvs_full> L</guestfs_vg_activate> L</guestfs_vg_activate_all> L</"
20883 "guestfs_vgcreate> L</guestfs_vgremove> L</guestfs_vgs> L</guestfs_vgs_full>"
20884 msgstr ""
20885
20886 # type: =item
20887 #. type: =item
20888 #: ../src/guestfs-availability.pod:99
20889 msgid "B<mknod>"
20890 msgstr ""
20891
20892 # type: textblock
20893 #. type: textblock
20894 #: ../src/guestfs-availability.pod:101
20895 msgid ""
20896 "The following functions: L</guestfs_mkfifo> L</guestfs_mknod> L</"
20897 "guestfs_mknod_b> L</guestfs_mknod_c>"
20898 msgstr ""
20899
20900 # type: =item
20901 #. type: =item
20902 #: ../src/guestfs-availability.pod:107
20903 msgid "B<ntfs3g>"
20904 msgstr ""
20905
20906 # type: textblock
20907 #. type: textblock
20908 #: ../src/guestfs-availability.pod:109
20909 msgid "The following functions: L</guestfs_ntfs_3g_probe>"
20910 msgstr ""
20911
20912 # type: =item
20913 #. type: =item
20914 #: ../src/guestfs-availability.pod:112
20915 msgid "B<ntfsprogs>"
20916 msgstr ""
20917
20918 # type: textblock
20919 #. type: textblock
20920 #: ../src/guestfs-availability.pod:114
20921 msgid ""
20922 "The following functions: L</guestfs_ntfsresize> L</guestfs_ntfsresize_size>"
20923 msgstr ""
20924
20925 # type: =item
20926 #. type: =item
20927 #: ../src/guestfs-availability.pod:118
20928 msgid "B<realpath>"
20929 msgstr ""
20930
20931 # type: textblock
20932 #. type: textblock
20933 #: ../src/guestfs-availability.pod:120
20934 msgid "The following functions: L</guestfs_realpath>"
20935 msgstr ""
20936
20937 # type: =item
20938 #. type: =item
20939 #: ../src/guestfs-availability.pod:123
20940 msgid "B<scrub>"
20941 msgstr ""
20942
20943 # type: textblock
20944 #. type: textblock
20945 #: ../src/guestfs-availability.pod:125
20946 msgid ""
20947 "The following functions: L</guestfs_scrub_device> L</guestfs_scrub_file> L</"
20948 "guestfs_scrub_freespace>"
20949 msgstr ""
20950
20951 # type: =item
20952 #. type: =item
20953 #: ../src/guestfs-availability.pod:130
20954 msgid "B<selinux>"
20955 msgstr ""
20956
20957 # type: textblock
20958 #. type: textblock
20959 #: ../src/guestfs-availability.pod:132
20960 msgid "The following functions: L</guestfs_getcon> L</guestfs_setcon>"
20961 msgstr ""
20962
20963 # type: =item
20964 #. type: =item
20965 #: ../src/guestfs-availability.pod:136
20966 msgid "B<xz>"
20967 msgstr ""
20968
20969 # type: textblock
20970 #. type: textblock
20971 #: ../src/guestfs-availability.pod:138
20972 msgid "The following functions: L</guestfs_txz_in> L</guestfs_txz_out>"
20973 msgstr ""
20974
20975 # type: =item
20976 #. type: =item
20977 #: ../src/guestfs-availability.pod:142
20978 msgid "B<zerofree>"
20979 msgstr ""
20980
20981 # type: textblock
20982 #. type: textblock
20983 #: ../src/guestfs-availability.pod:144
20984 msgid "The following functions: L</guestfs_zerofree>"
20985 msgstr ""
20986
20987 # type: =head2
20988 #. type: =head2
20989 #: ../src/guestfs-structs.pod:1
20990 msgid "guestfs_int_bool"
20991 msgstr ""
20992
20993 # type: verbatim
20994 #. type: verbatim
20995 #: ../src/guestfs-structs.pod:3
20996 #, no-wrap
20997 msgid ""
20998 " struct guestfs_int_bool {\n"
20999 "   int32_t i;\n"
21000 "   int32_t b;\n"
21001 " };\n"
21002 " \n"
21003 msgstr ""
21004
21005 # type: verbatim
21006 #. type: verbatim
21007 #: ../src/guestfs-structs.pod:8
21008 #, no-wrap
21009 msgid ""
21010 " struct guestfs_int_bool_list {\n"
21011 "   uint32_t len; /* Number of elements in list. */\n"
21012 "   struct guestfs_int_bool *val; /* Elements. */\n"
21013 " };\n"
21014 " \n"
21015 msgstr ""
21016
21017 # type: verbatim
21018 #. type: verbatim
21019 #: ../src/guestfs-structs.pod:13
21020 #, no-wrap
21021 msgid ""
21022 " void guestfs_free_int_bool (struct guestfs_free_int_bool *);\n"
21023 " void guestfs_free_int_bool_list (struct guestfs_free_int_bool_list *);\n"
21024 "\n"
21025 msgstr ""
21026
21027 # type: =head2
21028 #. type: =head2
21029 #: ../src/guestfs-structs.pod:16
21030 msgid "guestfs_lvm_pv"
21031 msgstr ""
21032
21033 # type: verbatim
21034 #. type: verbatim
21035 #: ../src/guestfs-structs.pod:18
21036 #, no-wrap
21037 msgid ""
21038 " struct guestfs_lvm_pv {\n"
21039 "   char *pv_name;\n"
21040 "   /* The next field is NOT nul-terminated, be careful when printing it: */\n"
21041 "   char pv_uuid[32];\n"
21042 "   char *pv_fmt;\n"
21043 "   uint64_t pv_size;\n"
21044 "   uint64_t dev_size;\n"
21045 "   uint64_t pv_free;\n"
21046 "   uint64_t pv_used;\n"
21047 "   char *pv_attr;\n"
21048 "   int64_t pv_pe_count;\n"
21049 "   int64_t pv_pe_alloc_count;\n"
21050 "   char *pv_tags;\n"
21051 "   uint64_t pe_start;\n"
21052 "   int64_t pv_mda_count;\n"
21053 "   uint64_t pv_mda_free;\n"
21054 " };\n"
21055 " \n"
21056 msgstr ""
21057
21058 # type: verbatim
21059 #. type: verbatim
21060 #: ../src/guestfs-structs.pod:36
21061 #, no-wrap
21062 msgid ""
21063 " struct guestfs_lvm_pv_list {\n"
21064 "   uint32_t len; /* Number of elements in list. */\n"
21065 "   struct guestfs_lvm_pv *val; /* Elements. */\n"
21066 " };\n"
21067 " \n"
21068 msgstr ""
21069
21070 # type: verbatim
21071 #. type: verbatim
21072 #: ../src/guestfs-structs.pod:41
21073 #, no-wrap
21074 msgid ""
21075 " void guestfs_free_lvm_pv (struct guestfs_free_lvm_pv *);\n"
21076 " void guestfs_free_lvm_pv_list (struct guestfs_free_lvm_pv_list *);\n"
21077 "\n"
21078 msgstr ""
21079
21080 # type: =head2
21081 #. type: =head2
21082 #: ../src/guestfs-structs.pod:44
21083 msgid "guestfs_lvm_vg"
21084 msgstr ""
21085
21086 # type: verbatim
21087 #. type: verbatim
21088 #: ../src/guestfs-structs.pod:46
21089 #, no-wrap
21090 msgid ""
21091 " struct guestfs_lvm_vg {\n"
21092 "   char *vg_name;\n"
21093 "   /* The next field is NOT nul-terminated, be careful when printing it: */\n"
21094 "   char vg_uuid[32];\n"
21095 "   char *vg_fmt;\n"
21096 "   char *vg_attr;\n"
21097 "   uint64_t vg_size;\n"
21098 "   uint64_t vg_free;\n"
21099 "   char *vg_sysid;\n"
21100 "   uint64_t vg_extent_size;\n"
21101 "   int64_t vg_extent_count;\n"
21102 "   int64_t vg_free_count;\n"
21103 "   int64_t max_lv;\n"
21104 "   int64_t max_pv;\n"
21105 "   int64_t pv_count;\n"
21106 "   int64_t lv_count;\n"
21107 "   int64_t snap_count;\n"
21108 "   int64_t vg_seqno;\n"
21109 "   char *vg_tags;\n"
21110 "   int64_t vg_mda_count;\n"
21111 "   uint64_t vg_mda_free;\n"
21112 " };\n"
21113 " \n"
21114 msgstr ""
21115
21116 # type: verbatim
21117 #. type: verbatim
21118 #: ../src/guestfs-structs.pod:69
21119 #, no-wrap
21120 msgid ""
21121 " struct guestfs_lvm_vg_list {\n"
21122 "   uint32_t len; /* Number of elements in list. */\n"
21123 "   struct guestfs_lvm_vg *val; /* Elements. */\n"
21124 " };\n"
21125 " \n"
21126 msgstr ""
21127
21128 # type: verbatim
21129 #. type: verbatim
21130 #: ../src/guestfs-structs.pod:74
21131 #, no-wrap
21132 msgid ""
21133 " void guestfs_free_lvm_vg (struct guestfs_free_lvm_vg *);\n"
21134 " void guestfs_free_lvm_vg_list (struct guestfs_free_lvm_vg_list *);\n"
21135 "\n"
21136 msgstr ""
21137
21138 # type: =head2
21139 #. type: =head2
21140 #: ../src/guestfs-structs.pod:77
21141 msgid "guestfs_lvm_lv"
21142 msgstr ""
21143
21144 # type: verbatim
21145 #. type: verbatim
21146 #: ../src/guestfs-structs.pod:79
21147 #, no-wrap
21148 msgid ""
21149 " struct guestfs_lvm_lv {\n"
21150 "   char *lv_name;\n"
21151 "   /* The next field is NOT nul-terminated, be careful when printing it: */\n"
21152 "   char lv_uuid[32];\n"
21153 "   char *lv_attr;\n"
21154 "   int64_t lv_major;\n"
21155 "   int64_t lv_minor;\n"
21156 "   int64_t lv_kernel_major;\n"
21157 "   int64_t lv_kernel_minor;\n"
21158 "   uint64_t lv_size;\n"
21159 "   int64_t seg_count;\n"
21160 "   char *origin;\n"
21161 "   /* The next field is [0..100] or -1 meaning 'not present': */\n"
21162 "   float snap_percent;\n"
21163 "   /* The next field is [0..100] or -1 meaning 'not present': */\n"
21164 "   float copy_percent;\n"
21165 "   char *move_pv;\n"
21166 "   char *lv_tags;\n"
21167 "   char *mirror_log;\n"
21168 "   char *modules;\n"
21169 " };\n"
21170 " \n"
21171 msgstr ""
21172
21173 # type: verbatim
21174 #. type: verbatim
21175 #: ../src/guestfs-structs.pod:101
21176 #, no-wrap
21177 msgid ""
21178 " struct guestfs_lvm_lv_list {\n"
21179 "   uint32_t len; /* Number of elements in list. */\n"
21180 "   struct guestfs_lvm_lv *val; /* Elements. */\n"
21181 " };\n"
21182 " \n"
21183 msgstr ""
21184
21185 # type: verbatim
21186 #. type: verbatim
21187 #: ../src/guestfs-structs.pod:106
21188 #, no-wrap
21189 msgid ""
21190 " void guestfs_free_lvm_lv (struct guestfs_free_lvm_lv *);\n"
21191 " void guestfs_free_lvm_lv_list (struct guestfs_free_lvm_lv_list *);\n"
21192 "\n"
21193 msgstr ""
21194
21195 # type: verbatim
21196 #. type: verbatim
21197 #: ../src/guestfs-structs.pod:111
21198 #, no-wrap
21199 msgid ""
21200 " struct guestfs_stat {\n"
21201 "   int64_t dev;\n"
21202 "   int64_t ino;\n"
21203 "   int64_t mode;\n"
21204 "   int64_t nlink;\n"
21205 "   int64_t uid;\n"
21206 "   int64_t gid;\n"
21207 "   int64_t rdev;\n"
21208 "   int64_t size;\n"
21209 "   int64_t blksize;\n"
21210 "   int64_t blocks;\n"
21211 "   int64_t atime;\n"
21212 "   int64_t mtime;\n"
21213 "   int64_t ctime;\n"
21214 " };\n"
21215 " \n"
21216 msgstr ""
21217
21218 # type: verbatim
21219 #. type: verbatim
21220 #: ../src/guestfs-structs.pod:127
21221 #, no-wrap
21222 msgid ""
21223 " struct guestfs_stat_list {\n"
21224 "   uint32_t len; /* Number of elements in list. */\n"
21225 "   struct guestfs_stat *val; /* Elements. */\n"
21226 " };\n"
21227 " \n"
21228 msgstr ""
21229
21230 # type: verbatim
21231 #. type: verbatim
21232 #: ../src/guestfs-structs.pod:132
21233 #, no-wrap
21234 msgid ""
21235 " void guestfs_free_stat (struct guestfs_free_stat *);\n"
21236 " void guestfs_free_stat_list (struct guestfs_free_stat_list *);\n"
21237 "\n"
21238 msgstr ""
21239
21240 # type: verbatim
21241 #. type: verbatim
21242 #: ../src/guestfs-structs.pod:137
21243 #, no-wrap
21244 msgid ""
21245 " struct guestfs_statvfs {\n"
21246 "   int64_t bsize;\n"
21247 "   int64_t frsize;\n"
21248 "   int64_t blocks;\n"
21249 "   int64_t bfree;\n"
21250 "   int64_t bavail;\n"
21251 "   int64_t files;\n"
21252 "   int64_t ffree;\n"
21253 "   int64_t favail;\n"
21254 "   int64_t fsid;\n"
21255 "   int64_t flag;\n"
21256 "   int64_t namemax;\n"
21257 " };\n"
21258 " \n"
21259 msgstr ""
21260
21261 # type: verbatim
21262 #. type: verbatim
21263 #: ../src/guestfs-structs.pod:151
21264 #, no-wrap
21265 msgid ""
21266 " struct guestfs_statvfs_list {\n"
21267 "   uint32_t len; /* Number of elements in list. */\n"
21268 "   struct guestfs_statvfs *val; /* Elements. */\n"
21269 " };\n"
21270 " \n"
21271 msgstr ""
21272
21273 # type: verbatim
21274 #. type: verbatim
21275 #: ../src/guestfs-structs.pod:156
21276 #, no-wrap
21277 msgid ""
21278 " void guestfs_free_statvfs (struct guestfs_free_statvfs *);\n"
21279 " void guestfs_free_statvfs_list (struct guestfs_free_statvfs_list *);\n"
21280 "\n"
21281 msgstr ""
21282
21283 # type: =head2
21284 #. type: =head2
21285 #: ../src/guestfs-structs.pod:159
21286 msgid "guestfs_dirent"
21287 msgstr ""
21288
21289 # type: verbatim
21290 #. type: verbatim
21291 #: ../src/guestfs-structs.pod:161
21292 #, no-wrap
21293 msgid ""
21294 " struct guestfs_dirent {\n"
21295 "   int64_t ino;\n"
21296 "   char ftyp;\n"
21297 "   char *name;\n"
21298 " };\n"
21299 " \n"
21300 msgstr ""
21301
21302 # type: verbatim
21303 #. type: verbatim
21304 #: ../src/guestfs-structs.pod:167
21305 #, no-wrap
21306 msgid ""
21307 " struct guestfs_dirent_list {\n"
21308 "   uint32_t len; /* Number of elements in list. */\n"
21309 "   struct guestfs_dirent *val; /* Elements. */\n"
21310 " };\n"
21311 " \n"
21312 msgstr ""
21313
21314 # type: verbatim
21315 #. type: verbatim
21316 #: ../src/guestfs-structs.pod:172
21317 #, no-wrap
21318 msgid ""
21319 " void guestfs_free_dirent (struct guestfs_free_dirent *);\n"
21320 " void guestfs_free_dirent_list (struct guestfs_free_dirent_list *);\n"
21321 "\n"
21322 msgstr ""
21323
21324 # type: verbatim
21325 #. type: verbatim
21326 #: ../src/guestfs-structs.pod:177
21327 #, no-wrap
21328 msgid ""
21329 " struct guestfs_version {\n"
21330 "   int64_t major;\n"
21331 "   int64_t minor;\n"
21332 "   int64_t release;\n"
21333 "   char *extra;\n"
21334 " };\n"
21335 " \n"
21336 msgstr ""
21337
21338 # type: verbatim
21339 #. type: verbatim
21340 #: ../src/guestfs-structs.pod:184
21341 #, no-wrap
21342 msgid ""
21343 " struct guestfs_version_list {\n"
21344 "   uint32_t len; /* Number of elements in list. */\n"
21345 "   struct guestfs_version *val; /* Elements. */\n"
21346 " };\n"
21347 " \n"
21348 msgstr ""
21349
21350 # type: verbatim
21351 #. type: verbatim
21352 #: ../src/guestfs-structs.pod:189
21353 #, no-wrap
21354 msgid ""
21355 " void guestfs_free_version (struct guestfs_free_version *);\n"
21356 " void guestfs_free_version_list (struct guestfs_free_version_list *);\n"
21357 "\n"
21358 msgstr ""
21359
21360 # type: =head2
21361 #. type: =head2
21362 #: ../src/guestfs-structs.pod:192
21363 msgid "guestfs_xattr"
21364 msgstr ""
21365
21366 # type: verbatim
21367 #. type: verbatim
21368 #: ../src/guestfs-structs.pod:194
21369 #, no-wrap
21370 msgid ""
21371 " struct guestfs_xattr {\n"
21372 "   char *attrname;\n"
21373 "   /* The next two fields describe a byte array. */\n"
21374 "   uint32_t attrval_len;\n"
21375 "   char *attrval;\n"
21376 " };\n"
21377 " \n"
21378 msgstr ""
21379
21380 # type: verbatim
21381 #. type: verbatim
21382 #: ../src/guestfs-structs.pod:201
21383 #, no-wrap
21384 msgid ""
21385 " struct guestfs_xattr_list {\n"
21386 "   uint32_t len; /* Number of elements in list. */\n"
21387 "   struct guestfs_xattr *val; /* Elements. */\n"
21388 " };\n"
21389 " \n"
21390 msgstr ""
21391
21392 # type: verbatim
21393 #. type: verbatim
21394 #: ../src/guestfs-structs.pod:206
21395 #, no-wrap
21396 msgid ""
21397 " void guestfs_free_xattr (struct guestfs_free_xattr *);\n"
21398 " void guestfs_free_xattr_list (struct guestfs_free_xattr_list *);\n"
21399 "\n"
21400 msgstr ""
21401
21402 # type: =head2
21403 #. type: =head2
21404 #: ../src/guestfs-structs.pod:209
21405 msgid "guestfs_inotify_event"
21406 msgstr ""
21407
21408 # type: verbatim
21409 #. type: verbatim
21410 #: ../src/guestfs-structs.pod:211
21411 #, no-wrap
21412 msgid ""
21413 " struct guestfs_inotify_event {\n"
21414 "   int64_t in_wd;\n"
21415 "   uint32_t in_mask;\n"
21416 "   uint32_t in_cookie;\n"
21417 "   char *in_name;\n"
21418 " };\n"
21419 " \n"
21420 msgstr ""
21421
21422 # type: verbatim
21423 #. type: verbatim
21424 #: ../src/guestfs-structs.pod:218
21425 #, no-wrap
21426 msgid ""
21427 " struct guestfs_inotify_event_list {\n"
21428 "   uint32_t len; /* Number of elements in list. */\n"
21429 "   struct guestfs_inotify_event *val; /* Elements. */\n"
21430 " };\n"
21431 " \n"
21432 msgstr ""
21433
21434 # type: verbatim
21435 #. type: verbatim
21436 #: ../src/guestfs-structs.pod:223
21437 #, no-wrap
21438 msgid ""
21439 " void guestfs_free_inotify_event (struct guestfs_free_inotify_event *);\n"
21440 " void guestfs_free_inotify_event_list (struct guestfs_free_inotify_event_list *);\n"
21441 "\n"
21442 msgstr ""
21443
21444 # type: =head2
21445 #. type: =head2
21446 #: ../src/guestfs-structs.pod:226
21447 msgid "guestfs_partition"
21448 msgstr ""
21449
21450 # type: verbatim
21451 #. type: verbatim
21452 #: ../src/guestfs-structs.pod:228
21453 #, no-wrap
21454 msgid ""
21455 " struct guestfs_partition {\n"
21456 "   int32_t part_num;\n"
21457 "   uint64_t part_start;\n"
21458 "   uint64_t part_end;\n"
21459 "   uint64_t part_size;\n"
21460 " };\n"
21461 " \n"
21462 msgstr ""
21463
21464 # type: verbatim
21465 #. type: verbatim
21466 #: ../src/guestfs-structs.pod:235
21467 #, no-wrap
21468 msgid ""
21469 " struct guestfs_partition_list {\n"
21470 "   uint32_t len; /* Number of elements in list. */\n"
21471 "   struct guestfs_partition *val; /* Elements. */\n"
21472 " };\n"
21473 " \n"
21474 msgstr ""
21475
21476 # type: verbatim
21477 #. type: verbatim
21478 #: ../src/guestfs-structs.pod:240
21479 #, no-wrap
21480 msgid ""
21481 " void guestfs_free_partition (struct guestfs_free_partition *);\n"
21482 " void guestfs_free_partition_list (struct guestfs_free_partition_list *);\n"
21483 "\n"
21484 msgstr ""
21485
21486 # type: =head2
21487 #. type: =head2
21488 #: ../src/guestfs-structs.pod:243
21489 msgid "guestfs_application"
21490 msgstr ""
21491
21492 # type: verbatim
21493 #. type: verbatim
21494 #: ../src/guestfs-structs.pod:245
21495 #, no-wrap
21496 msgid ""
21497 " struct guestfs_application {\n"
21498 "   char *app_name;\n"
21499 "   char *app_display_name;\n"
21500 "   int32_t app_epoch;\n"
21501 "   char *app_version;\n"
21502 "   char *app_release;\n"
21503 "   char *app_install_path;\n"
21504 "   char *app_trans_path;\n"
21505 "   char *app_publisher;\n"
21506 "   char *app_url;\n"
21507 "   char *app_source_package;\n"
21508 "   char *app_summary;\n"
21509 "   char *app_description;\n"
21510 " };\n"
21511 " \n"
21512 msgstr ""
21513
21514 # type: verbatim
21515 #. type: verbatim
21516 #: ../src/guestfs-structs.pod:260
21517 #, no-wrap
21518 msgid ""
21519 " struct guestfs_application_list {\n"
21520 "   uint32_t len; /* Number of elements in list. */\n"
21521 "   struct guestfs_application *val; /* Elements. */\n"
21522 " };\n"
21523 " \n"
21524 msgstr ""
21525
21526 # type: verbatim
21527 #. type: verbatim
21528 #: ../src/guestfs-structs.pod:265
21529 #, no-wrap
21530 msgid ""
21531 " void guestfs_free_application (struct guestfs_free_application *);\n"
21532 " void guestfs_free_application_list (struct guestfs_free_application_list *);\n"
21533 "\n"
21534 msgstr ""
21535
21536 # type: textblock
21537 #. type: textblock
21538 #: ../fish/guestfish.pod:5
21539 msgid "guestfish - the libguestfs Filesystem Interactive SHell"
21540 msgstr ""
21541
21542 # type: verbatim
21543 #. type: verbatim
21544 #: ../fish/guestfish.pod:9
21545 #, no-wrap
21546 msgid ""
21547 " guestfish [--options] [commands]\n"
21548 "\n"
21549 msgstr ""
21550
21551 # type: verbatim
21552 #. type: verbatim
21553 #: ../fish/guestfish.pod:11
21554 #, no-wrap
21555 msgid ""
21556 " guestfish\n"
21557 "\n"
21558 msgstr ""
21559
21560 # type: verbatim
21561 #. type: verbatim
21562 #: ../fish/guestfish.pod:13
21563 #, no-wrap
21564 msgid ""
21565 " guestfish [--ro|--rw] -a disk.img\n"
21566 "\n"
21567 msgstr ""
21568
21569 # type: verbatim
21570 #. type: verbatim
21571 #: ../fish/guestfish.pod:15
21572 #, no-wrap
21573 msgid ""
21574 " guestfish [--ro|--rw] -a disk.img -m dev[:mountpoint]\n"
21575 "\n"
21576 msgstr ""
21577
21578 # type: verbatim
21579 #. type: verbatim
21580 #: ../fish/guestfish.pod:17
21581 #, no-wrap
21582 msgid ""
21583 " guestfish -d libvirt-domain\n"
21584 "\n"
21585 msgstr ""
21586
21587 # type: verbatim
21588 #. type: verbatim
21589 #: ../fish/guestfish.pod:19
21590 #, no-wrap
21591 msgid ""
21592 " guestfish [--ro|--rw] -a disk.img -i\n"
21593 "\n"
21594 msgstr ""
21595
21596 # type: verbatim
21597 #. type: verbatim
21598 #: ../fish/guestfish.pod:21
21599 #, no-wrap
21600 msgid ""
21601 " guestfish -d libvirt-domain -i\n"
21602 "\n"
21603 msgstr ""
21604
21605 # type: =head1
21606 #. type: =head1
21607 #: ../fish/guestfish.pod:23 ../fuse/guestmount.pod:15 ../tools/virt-edit.pl:44
21608 #: ../tools/virt-win-reg.pl:51 ../tools/virt-tar.pl:64
21609 msgid "WARNING"
21610 msgstr ""
21611
21612 # type: textblock
21613 #. type: textblock
21614 #: ../fish/guestfish.pod:25
21615 msgid ""
21616 "Using guestfish in read/write mode on live virtual machines can be "
21617 "dangerous, potentially causing disk corruption.  Use the I<--ro> (read-only) "
21618 "option to use guestfish safely if the disk image or virtual machine might be "
21619 "live."
21620 msgstr ""
21621
21622 # type: textblock
21623 #. type: textblock
21624 #: ../fish/guestfish.pod:32
21625 msgid ""
21626 "Guestfish is a shell and command-line tool for examining and modifying "
21627 "virtual machine filesystems.  It uses libguestfs and exposes all of the "
21628 "functionality of the guestfs API, see L<guestfs(3)>."
21629 msgstr ""
21630
21631 # type: textblock
21632 #. type: textblock
21633 #: ../fish/guestfish.pod:36
21634 msgid ""
21635 "Guestfish gives you structured access to the libguestfs API, from shell "
21636 "scripts or the command line or interactively.  If you want to rescue a "
21637 "broken virtual machine image, you should look at the L<virt-rescue(1)> "
21638 "command."
21639 msgstr ""
21640
21641 # type: =head1
21642 #. type: =head1
21643 #: ../fish/guestfish.pod:41 ../fish/guestfish.pod:958
21644 #: ../fuse/guestmount.pod:39 ../tools/virt-edit.pl:63 ../tools/virt-tar.pl:50
21645 msgid "EXAMPLES"
21646 msgstr ""
21647
21648 # type: =head2
21649 #. type: =head2
21650 #: ../fish/guestfish.pod:43
21651 msgid "As an interactive shell"
21652 msgstr ""
21653
21654 # type: verbatim
21655 #. type: verbatim
21656 #: ../fish/guestfish.pod:45
21657 #, no-wrap
21658 msgid ""
21659 " $ guestfish\n"
21660 " \n"
21661 msgstr ""
21662
21663 # type: verbatim
21664 #. type: verbatim
21665 #: ../fish/guestfish.pod:47
21666 #, no-wrap
21667 msgid ""
21668 " Welcome to guestfish, the libguestfs filesystem interactive shell for\n"
21669 " editing virtual machine filesystems.\n"
21670 " \n"
21671 msgstr ""
21672
21673 # type: verbatim
21674 #. type: verbatim
21675 #: ../fish/guestfish.pod:50
21676 #, no-wrap
21677 msgid ""
21678 " Type: 'help' for a list of commands\n"
21679 "       'man' to read the manual\n"
21680 "       'quit' to quit the shell\n"
21681 " \n"
21682 msgstr ""
21683
21684 # type: verbatim
21685 #. type: verbatim
21686 #: ../fish/guestfish.pod:54
21687 #, no-wrap
21688 msgid ""
21689 " ><fs> add-ro disk.img\n"
21690 " ><fs> run\n"
21691 " ><fs> list-filesystems\n"
21692 " /dev/sda1: ext4\n"
21693 " /dev/vg_guest/lv_root: ext4\n"
21694 " /dev/vg_guest/lv_swap: swap\n"
21695 " ><fs> mount /dev/vg_guest/lv_root /\n"
21696 " ><fs> cat /etc/fstab\n"
21697 " # /etc/fstab\n"
21698 " # Created by anaconda\n"
21699 " [...]\n"
21700 " ><fs> exit\n"
21701 "\n"
21702 msgstr ""
21703
21704 # type: =head2
21705 #. type: =head2
21706 #: ../fish/guestfish.pod:67
21707 msgid "From shell scripts"
21708 msgstr ""
21709
21710 # type: textblock
21711 #. type: textblock
21712 #: ../fish/guestfish.pod:69
21713 msgid "Create a new C</etc/motd> file in a guest or disk image:"
21714 msgstr ""
21715
21716 # type: verbatim
21717 #. type: verbatim
21718 #: ../fish/guestfish.pod:71
21719 #, no-wrap
21720 msgid ""
21721 " guestfish <<_EOF_\n"
21722 " add disk.img\n"
21723 " run\n"
21724 " mount /dev/vg_guest/lv_root /\n"
21725 " write /etc/motd \"Welcome, new users\"\n"
21726 " _EOF_\n"
21727 "\n"
21728 msgstr ""
21729
21730 # type: textblock
21731 #. type: textblock
21732 #: ../fish/guestfish.pod:78
21733 msgid "List the LVM logical volumes in a disk image:"
21734 msgstr ""
21735
21736 # type: verbatim
21737 #. type: verbatim
21738 #: ../fish/guestfish.pod:80
21739 #, no-wrap
21740 msgid ""
21741 " guestfish -a disk.img --ro <<_EOF_\n"
21742 " run\n"
21743 " lvs\n"
21744 " _EOF_\n"
21745 "\n"
21746 msgstr ""
21747
21748 # type: textblock
21749 #. type: textblock
21750 #: ../fish/guestfish.pod:85
21751 msgid "List all the filesystems in a disk image:"
21752 msgstr ""
21753
21754 # type: verbatim
21755 #. type: verbatim
21756 #: ../fish/guestfish.pod:87
21757 #, no-wrap
21758 msgid ""
21759 " guestfish -a disk.img --ro <<_EOF_\n"
21760 " run\n"
21761 " list-filesystems\n"
21762 " _EOF_\n"
21763 "\n"
21764 msgstr ""
21765
21766 # type: =head2
21767 #. type: =head2
21768 #: ../fish/guestfish.pod:92
21769 msgid "On one command line"
21770 msgstr ""
21771
21772 # type: textblock
21773 #. type: textblock
21774 #: ../fish/guestfish.pod:94
21775 msgid "Update C</etc/resolv.conf> in a guest:"
21776 msgstr ""
21777
21778 # type: verbatim
21779 #. type: verbatim
21780 #: ../fish/guestfish.pod:96
21781 #, no-wrap
21782 msgid ""
21783 " guestfish \\\n"
21784 "   add disk.img : run : mount /dev/vg_guest/lv_root / : \\\n"
21785 "   write /etc/resolv.conf \"nameserver 1.2.3.4\"\n"
21786 "\n"
21787 msgstr ""
21788
21789 # type: textblock
21790 #. type: textblock
21791 #: ../fish/guestfish.pod:100
21792 msgid "Edit C</boot/grub/grub.conf> interactively:"
21793 msgstr ""
21794
21795 # type: verbatim
21796 #. type: verbatim
21797 #: ../fish/guestfish.pod:102
21798 #, no-wrap
21799 msgid ""
21800 " guestfish --rw --add disk.img \\\n"
21801 "   --mount /dev/vg_guest/lv_root \\\n"
21802 "   --mount /dev/sda1:/boot \\\n"
21803 "   edit /boot/grub/grub.conf\n"
21804 "\n"
21805 msgstr ""
21806
21807 # type: =head2
21808 #. type: =head2
21809 #: ../fish/guestfish.pod:107
21810 msgid "Mount disks automatically"
21811 msgstr ""
21812
21813 # type: textblock
21814 #. type: textblock
21815 #: ../fish/guestfish.pod:109
21816 msgid ""
21817 "Use the I<-i> option to automatically mount the disks from a virtual machine:"
21818 msgstr ""
21819
21820 # type: verbatim
21821 #. type: verbatim
21822 #: ../fish/guestfish.pod:112
21823 #, no-wrap
21824 msgid ""
21825 " guestfish --ro -a disk.img -i cat /etc/group\n"
21826 "\n"
21827 msgstr ""
21828
21829 # type: verbatim
21830 #. type: verbatim
21831 #: ../fish/guestfish.pod:114
21832 #, no-wrap
21833 msgid ""
21834 " guestfish --ro -d libvirt-domain -i cat /etc/group\n"
21835 "\n"
21836 msgstr ""
21837
21838 # type: textblock
21839 #. type: textblock
21840 #: ../fish/guestfish.pod:116
21841 msgid "Another way to edit C</boot/grub/grub.conf> interactively is:"
21842 msgstr ""
21843
21844 # type: verbatim
21845 #. type: verbatim
21846 #: ../fish/guestfish.pod:118
21847 #, no-wrap
21848 msgid ""
21849 " guestfish --rw -a disk.img -i edit /boot/grub/grub.conf\n"
21850 "\n"
21851 msgstr ""
21852
21853 # type: =head2
21854 #. type: =head2
21855 #: ../fish/guestfish.pod:120
21856 msgid "As a script interpreter"
21857 msgstr ""
21858
21859 # type: textblock
21860 #. type: textblock
21861 #: ../fish/guestfish.pod:122
21862 msgid "Create a 100MB disk containing an ext2-formatted partition:"
21863 msgstr ""
21864
21865 # type: verbatim
21866 #. type: verbatim
21867 #: ../fish/guestfish.pod:124
21868 #, no-wrap
21869 msgid ""
21870 " #!/usr/bin/guestfish -f\n"
21871 " sparse test1.img 100M\n"
21872 " run\n"
21873 " part-disk /dev/sda mbr\n"
21874 " mkfs ext2 /dev/sda1\n"
21875 "\n"
21876 msgstr ""
21877
21878 # type: =head2
21879 #. type: =head2
21880 #: ../fish/guestfish.pod:130
21881 msgid "Start with a prepared disk"
21882 msgstr ""
21883
21884 # type: textblock
21885 #. type: textblock
21886 #: ../fish/guestfish.pod:132
21887 msgid ""
21888 "An alternate way to create a 100MB disk called C<test1.img> containing a "
21889 "single ext2-formatted partition:"
21890 msgstr ""
21891
21892 # type: verbatim
21893 #. type: verbatim
21894 #: ../fish/guestfish.pod:135
21895 #, no-wrap
21896 msgid ""
21897 " guestfish -N fs\n"
21898 "\n"
21899 msgstr ""
21900
21901 # type: textblock
21902 #. type: textblock
21903 #: ../fish/guestfish.pod:137
21904 msgid "To list what is available do:"
21905 msgstr ""
21906
21907 # type: verbatim
21908 #. type: verbatim
21909 #: ../fish/guestfish.pod:139 ../fish/guestfish.pod:949
21910 #, no-wrap
21911 msgid ""
21912 " guestfish -N help | less\n"
21913 "\n"
21914 msgstr ""
21915
21916 # type: =head2
21917 #. type: =head2
21918 #: ../fish/guestfish.pod:141
21919 msgid "Remote control"
21920 msgstr ""
21921
21922 # type: verbatim
21923 #. type: verbatim
21924 #: ../fish/guestfish.pod:143
21925 #, no-wrap
21926 msgid ""
21927 " eval \"`guestfish --listen`\"\n"
21928 " guestfish --remote add-ro disk.img\n"
21929 " guestfish --remote run\n"
21930 " guestfish --remote lvs\n"
21931 "\n"
21932 msgstr ""
21933
21934 # type: =head1
21935 #. type: =head1
21936 #: ../fish/guestfish.pod:148 ../test-tool/libguestfs-test-tool.pod:37
21937 #: ../fuse/guestmount.pod:83 ../tools/virt-edit.pl:81
21938 #: ../tools/virt-win-reg.pl:96 ../tools/virt-list-filesystems.pl:53
21939 #: ../tools/virt-tar.pl:103 ../tools/virt-make-fs.pl:153
21940 #: ../tools/virt-list-partitions.pl:54
21941 msgid "OPTIONS"
21942 msgstr ""
21943
21944 # type: =item
21945 #. type: =item
21946 #: ../fish/guestfish.pod:152 ../fuse/guestmount.pod:141
21947 #: ../tools/virt-edit.pl:89 ../tools/virt-win-reg.pl:104
21948 #: ../tools/virt-list-filesystems.pl:61 ../tools/virt-tar.pl:111
21949 #: ../tools/virt-make-fs.pl:161 ../tools/virt-list-partitions.pl:62
21950 msgid "B<--help>"
21951 msgstr ""
21952
21953 # type: textblock
21954 #. type: textblock
21955 #: ../fish/guestfish.pod:154
21956 msgid "Displays general help on options."
21957 msgstr ""
21958
21959 # type: =item
21960 #. type: =item
21961 #: ../fish/guestfish.pod:156
21962 msgid "B<-h>"
21963 msgstr ""
21964
21965 # type: =item
21966 #. type: =item
21967 #: ../fish/guestfish.pod:158
21968 msgid "B<--cmd-help>"
21969 msgstr ""
21970
21971 # type: textblock
21972 #. type: textblock
21973 #: ../fish/guestfish.pod:160
21974 msgid "Lists all available guestfish commands."
21975 msgstr ""
21976
21977 # type: =item
21978 #. type: =item
21979 #: ../fish/guestfish.pod:162
21980 msgid "B<-h cmd>"
21981 msgstr ""
21982
21983 # type: =item
21984 #. type: =item
21985 #: ../fish/guestfish.pod:164
21986 msgid "B<--cmd-help cmd>"
21987 msgstr ""
21988
21989 # type: textblock
21990 #. type: textblock
21991 #: ../fish/guestfish.pod:166
21992 msgid "Displays detailed help on a single command C<cmd>."
21993 msgstr ""
21994
21995 # type: =item
21996 #. type: =item
21997 #: ../fish/guestfish.pod:168
21998 msgid "B<-a image>"
21999 msgstr ""
22000
22001 # type: =item
22002 #. type: =item
22003 #: ../fish/guestfish.pod:170
22004 msgid "B<--add image>"
22005 msgstr ""
22006
22007 # type: textblock
22008 #. type: textblock
22009 #: ../fish/guestfish.pod:172
22010 msgid "Add a block device or virtual machine image to the shell."
22011 msgstr ""
22012
22013 # type: textblock
22014 #. type: textblock
22015 #: ../fish/guestfish.pod:174 ../fuse/guestmount.pod:91
22016 msgid ""
22017 "The format of the disk image is auto-detected.  To override this and force a "
22018 "particular format use the I<--format=..> option."
22019 msgstr ""
22020
22021 #. type: textblock
22022 #: ../fish/guestfish.pod:177
22023 msgid ""
22024 "Using this flag is mostly equivalent to using the C<add> command, with "
22025 "C<readonly:true> if the I<--ro> flag was given, and with C<format:...> if "
22026 "the I<--format=...> flag was given."
22027 msgstr ""
22028
22029 # type: =item
22030 #. type: =item
22031 #: ../fish/guestfish.pod:181
22032 msgid "B<-c URI>"
22033 msgstr ""
22034
22035 # type: =item
22036 #. type: =item
22037 #: ../fish/guestfish.pod:183
22038 msgid "B<--connect URI>"
22039 msgstr ""
22040
22041 # type: textblock
22042 #. type: textblock
22043 #: ../fish/guestfish.pod:185 ../fuse/guestmount.pod:96
22044 msgid ""
22045 "When used in conjunction with the I<-d> option, this specifies the libvirt "
22046 "URI to use.  The default is to use the default libvirt connection."
22047 msgstr ""
22048
22049 # type: =item
22050 #. type: =item
22051 #: ../fish/guestfish.pod:189
22052 msgid "B<--csh>"
22053 msgstr ""
22054
22055 # type: textblock
22056 #. type: textblock
22057 #: ../fish/guestfish.pod:191
22058 msgid ""
22059 "If using the I<--listen> option and a csh-like shell, use this option.  See "
22060 "section L</REMOTE CONTROL AND CSH> below."
22061 msgstr ""
22062
22063 # type: =item
22064 #. type: =item
22065 #: ../fish/guestfish.pod:194
22066 msgid "B<-d libvirt-domain>"
22067 msgstr ""
22068
22069 # type: =item
22070 #. type: =item
22071 #: ../fish/guestfish.pod:196
22072 msgid "B<--domain libvirt-domain>"
22073 msgstr ""
22074
22075 # type: textblock
22076 #. type: textblock
22077 #: ../fish/guestfish.pod:198 ../fuse/guestmount.pod:102
22078 msgid ""
22079 "Add disks from the named libvirt domain.  If the I<--ro> option is also "
22080 "used, then any libvirt domain can be used.  However in write mode, only "
22081 "libvirt domains which are shut down can be named here."
22082 msgstr ""
22083
22084 # type: textblock
22085 #. type: textblock
22086 #: ../fish/guestfish.pod:202
22087 msgid ""
22088 "Using this flag is mostly equivalent to using the C<add-domain> command, "
22089 "with C<readonly:true> if the I<--ro> flag was given, and with C<format:...> "
22090 "if the I<--format:...> flag was given."
22091 msgstr ""
22092
22093 # type: =item
22094 #. type: =item
22095 #: ../fish/guestfish.pod:206
22096 msgid "B<-D>"
22097 msgstr ""
22098
22099 # type: =item
22100 #. type: =item
22101 #: ../fish/guestfish.pod:208
22102 msgid "B<--no-dest-paths>"
22103 msgstr ""
22104
22105 # type: textblock
22106 #. type: textblock
22107 #: ../fish/guestfish.pod:210
22108 msgid ""
22109 "Don't tab-complete paths on the guest filesystem.  It is useful to be able "
22110 "to hit the tab key to complete paths on the guest filesystem, but this "
22111 "causes extra \"hidden\" guestfs calls to be made, so this option is here to "
22112 "allow this feature to be disabled."
22113 msgstr ""
22114
22115 # type: =item
22116 #. type: =item
22117 #: ../fish/guestfish.pod:215 ../fuse/guestmount.pod:118
22118 msgid "B<--echo-keys>"
22119 msgstr ""
22120
22121 # type: textblock
22122 #. type: textblock
22123 #: ../fish/guestfish.pod:217 ../fuse/guestmount.pod:120
22124 msgid ""
22125 "When prompting for keys and passphrases, guestfish normally turns echoing "
22126 "off so you cannot see what you are typing.  If you are not worried about "
22127 "Tempest attacks and there is no one else in the room you can specify this "
22128 "flag to see what you are typing."
22129 msgstr ""
22130
22131 # type: =item
22132 #. type: =item
22133 #: ../fish/guestfish.pod:222
22134 msgid "B<-f file>"
22135 msgstr ""
22136
22137 # type: =item
22138 #. type: =item
22139 #: ../fish/guestfish.pod:224
22140 msgid "B<--file file>"
22141 msgstr ""
22142
22143 # type: textblock
22144 #. type: textblock
22145 #: ../fish/guestfish.pod:226
22146 msgid "Read commands from C<file>.  To write pure guestfish scripts, use:"
22147 msgstr ""
22148
22149 # type: verbatim
22150 #. type: verbatim
22151 #: ../fish/guestfish.pod:229
22152 #, no-wrap
22153 msgid ""
22154 " #!/usr/bin/guestfish -f\n"
22155 "\n"
22156 msgstr ""
22157
22158 # type: =item
22159 #. type: =item
22160 #: ../fish/guestfish.pod:231
22161 msgid "B<--format=raw|qcow2|..>"
22162 msgstr ""
22163
22164 # type: =item
22165 #. type: =item
22166 #: ../fish/guestfish.pod:233
22167 msgid "B<--format>"
22168 msgstr ""
22169
22170 # type: textblock
22171 #. type: textblock
22172 #: ../fish/guestfish.pod:235 ../fuse/guestmount.pod:127
22173 msgid ""
22174 "The default for the I<-a> option is to auto-detect the format of the disk "
22175 "image.  Using this forces the disk format for I<-a> options which follow on "
22176 "the command line.  Using I<--format> with no argument switches back to auto-"
22177 "detection for subsequent I<-a> options."
22178 msgstr ""
22179
22180 # type: verbatim
22181 #. type: verbatim
22182 #: ../fish/guestfish.pod:242
22183 #, no-wrap
22184 msgid ""
22185 " guestfish --format=raw -a disk.img\n"
22186 "\n"
22187 msgstr ""
22188
22189 # type: textblock
22190 #. type: textblock
22191 #: ../fish/guestfish.pod:244
22192 msgid "forces raw format (no auto-detection) for C<disk.img>."
22193 msgstr ""
22194
22195 # type: verbatim
22196 #. type: verbatim
22197 #: ../fish/guestfish.pod:246
22198 #, no-wrap
22199 msgid ""
22200 " guestfish --format=raw -a disk.img --format -a another.img\n"
22201 "\n"
22202 msgstr ""
22203
22204 # type: textblock
22205 #. type: textblock
22206 #: ../fish/guestfish.pod:248
22207 msgid ""
22208 "forces raw format (no auto-detection) for C<disk.img> and reverts to auto-"
22209 "detection for C<another.img>."
22210 msgstr ""
22211
22212 # type: textblock
22213 #. type: textblock
22214 #: ../fish/guestfish.pod:251
22215 msgid ""
22216 "If you have untrusted raw-format guest disk images, you should use this "
22217 "option to specify the disk format.  This avoids a possible security problem "
22218 "with malicious guests (CVE-2010-3851).  See also L</add-drive-opts>."
22219 msgstr ""
22220
22221 # type: =item
22222 #. type: =item
22223 #: ../fish/guestfish.pod:256
22224 msgid "B<-i>"
22225 msgstr ""
22226
22227 # type: =item
22228 #. type: =item
22229 #: ../fish/guestfish.pod:258
22230 msgid "B<--inspector>"
22231 msgstr ""
22232
22233 # type: textblock
22234 #. type: textblock
22235 #: ../fish/guestfish.pod:260 ../fuse/guestmount.pod:147
22236 msgid ""
22237 "Using L<virt-inspector(1)> code, inspect the disks looking for an operating "
22238 "system and mount filesystems as they would be mounted on the real virtual "
22239 "machine."
22240 msgstr ""
22241
22242 # type: textblock
22243 #. type: textblock
22244 #: ../fish/guestfish.pod:264
22245 msgid "Typical usage is either:"
22246 msgstr ""
22247
22248 # type: verbatim
22249 #. type: verbatim
22250 #: ../fish/guestfish.pod:266
22251 #, no-wrap
22252 msgid ""
22253 " guestfish -d myguest -i\n"
22254 "\n"
22255 msgstr ""
22256
22257 # type: textblock
22258 #. type: textblock
22259 #: ../fish/guestfish.pod:268
22260 msgid "(for an inactive libvirt domain called I<myguest>), or:"
22261 msgstr ""
22262
22263 # type: verbatim
22264 #. type: verbatim
22265 #: ../fish/guestfish.pod:270
22266 #, no-wrap
22267 msgid ""
22268 " guestfish --ro -d myguest -i\n"
22269 "\n"
22270 msgstr ""
22271
22272 # type: textblock
22273 #. type: textblock
22274 #: ../fish/guestfish.pod:272
22275 msgid "(for active domains, readonly), or specify the block device directly:"
22276 msgstr ""
22277
22278 # type: verbatim
22279 #. type: verbatim
22280 #: ../fish/guestfish.pod:274
22281 #, no-wrap
22282 msgid ""
22283 " guestfish --rw -a /dev/Guests/MyGuest -i\n"
22284 "\n"
22285 msgstr ""
22286
22287 # type: textblock
22288 #. type: textblock
22289 #: ../fish/guestfish.pod:276
22290 msgid ""
22291 "Note that the command line syntax changed slightly over older versions of "
22292 "guestfish.  You can still use the old syntax:"
22293 msgstr ""
22294
22295 # type: verbatim
22296 #. type: verbatim
22297 #: ../fish/guestfish.pod:279
22298 #, no-wrap
22299 msgid ""
22300 " guestfish [--ro] -i disk.img\n"
22301 "\n"
22302 msgstr ""
22303
22304 # type: verbatim
22305 #. type: verbatim
22306 #: ../fish/guestfish.pod:281
22307 #, no-wrap
22308 msgid ""
22309 " guestfish [--ro] -i libvirt-domain\n"
22310 "\n"
22311 msgstr ""
22312
22313 # type: textblock
22314 #. type: textblock
22315 #: ../fish/guestfish.pod:283
22316 msgid ""
22317 "Using this flag is mostly equivalent to using the C<inspect-os> command and "
22318 "then using other commands to mount the filesystems that were found."
22319 msgstr ""
22320
22321 # type: =item
22322 #. type: =item
22323 #: ../fish/guestfish.pod:287 ../fuse/guestmount.pod:151
22324 msgid "B<--keys-from-stdin>"
22325 msgstr ""
22326
22327 # type: textblock
22328 #. type: textblock
22329 #: ../fish/guestfish.pod:289 ../fuse/guestmount.pod:153
22330 msgid ""
22331 "Read key or passphrase parameters from stdin.  The default is to try to read "
22332 "passphrases from the user by opening C</dev/tty>."
22333 msgstr ""
22334
22335 # type: =item
22336 #. type: =item
22337 #: ../fish/guestfish.pod:292
22338 msgid "B<--listen>"
22339 msgstr ""
22340
22341 # type: textblock
22342 #. type: textblock
22343 #: ../fish/guestfish.pod:294
22344 msgid ""
22345 "Fork into the background and listen for remote commands.  See section L</"
22346 "REMOTE CONTROL GUESTFISH OVER A SOCKET> below."
22347 msgstr ""
22348
22349 #. type: =item
22350 #: ../fish/guestfish.pod:297 ../fuse/guestmount.pod:156
22351 msgid "B<--live>"
22352 msgstr ""
22353
22354 #. type: textblock
22355 #: ../fish/guestfish.pod:299 ../fuse/guestmount.pod:158
22356 msgid ""
22357 "Connect to a live virtual machine.  (Experimental, see L<guestfs(3)/"
22358 "ATTACHING TO RUNNING DAEMONS>)."
22359 msgstr ""
22360
22361 #. type: =item
22362 #: ../fish/guestfish.pod:302 ../fuse/guestmount.pod:161
22363 msgid "B<-m dev[:mountpoint[:options]]>"
22364 msgstr ""
22365
22366 #. type: =item
22367 #: ../fish/guestfish.pod:304 ../fuse/guestmount.pod:163
22368 msgid "B<--mount dev[:mountpoint[:options]]>"
22369 msgstr ""
22370
22371 # type: textblock
22372 #. type: textblock
22373 #: ../fish/guestfish.pod:306
22374 msgid "Mount the named partition or logical volume on the given mountpoint."
22375 msgstr ""
22376
22377 # type: textblock
22378 #. type: textblock
22379 #: ../fish/guestfish.pod:308
22380 msgid "If the mountpoint is omitted, it defaults to C</>."
22381 msgstr ""
22382
22383 # type: textblock
22384 #. type: textblock
22385 #: ../fish/guestfish.pod:310
22386 msgid "You have to mount something on C</> before most commands will work."
22387 msgstr ""
22388
22389 # type: textblock
22390 #. type: textblock
22391 #: ../fish/guestfish.pod:312
22392 msgid ""
22393 "If any I<-m> or I<--mount> options are given, the guest is automatically "
22394 "launched."
22395 msgstr ""
22396
22397 # type: textblock
22398 #. type: textblock
22399 #: ../fish/guestfish.pod:315
22400 msgid ""
22401 "If you don't know what filesystems a disk image contains, you can either run "
22402 "guestfish without this option, then list the partitions, filesystems and LVs "
22403 "available (see L</list-partitions>, L</list-filesystems> and L</lvs> "
22404 "commands), or you can use the L<virt-filesystems(1)> program."
22405 msgstr ""
22406
22407 #. type: textblock
22408 #: ../fish/guestfish.pod:321 ../fuse/guestmount.pod:171
22409 msgid ""
22410 "The third (and rarely used) part of the mount parameter is the list of mount "
22411 "options used to mount the underlying filesystem.  If this is not given, then "
22412 "the mount options are either the empty string or C<ro> (the latter if the "
22413 "I<--ro> flag is used).  By specifying the mount options, you override this "
22414 "default choice.  Probably the only time you would use this is to enable ACLs "
22415 "and/or extended attributes if the filesystem can support them:"
22416 msgstr ""
22417
22418 #. type: verbatim
22419 #: ../fish/guestfish.pod:329 ../fuse/guestmount.pod:179
22420 #, no-wrap
22421 msgid ""
22422 " -m /dev/sda1:/:acl,user_xattr\n"
22423 "\n"
22424 msgstr ""
22425
22426 #. type: textblock
22427 #: ../fish/guestfish.pod:331
22428 msgid "Using this flag is equivalent to using the C<mount-options> command."
22429 msgstr ""
22430
22431 # type: =item
22432 #. type: =item
22433 #: ../fish/guestfish.pod:333
22434 msgid "B<-n>"
22435 msgstr ""
22436
22437 # type: =item
22438 #. type: =item
22439 #: ../fish/guestfish.pod:335
22440 msgid "B<--no-sync>"
22441 msgstr ""
22442
22443 # type: textblock
22444 #. type: textblock
22445 #: ../fish/guestfish.pod:337
22446 msgid ""
22447 "Disable autosync.  This is enabled by default.  See the discussion of "
22448 "autosync in the L<guestfs(3)> manpage."
22449 msgstr ""
22450
22451 # type: =item
22452 #. type: =item
22453 #: ../fish/guestfish.pod:340
22454 msgid "B<-N type>"
22455 msgstr ""
22456
22457 # type: =item
22458 #. type: =item
22459 #: ../fish/guestfish.pod:342
22460 msgid "B<--new type>"
22461 msgstr ""
22462
22463 # type: =item
22464 #. type: =item
22465 #: ../fish/guestfish.pod:344
22466 msgid "B<-N help>"
22467 msgstr ""
22468
22469 # type: textblock
22470 #. type: textblock
22471 #: ../fish/guestfish.pod:346
22472 msgid ""
22473 "Prepare a fresh disk image formatted as \"type\".  This is an alternative to "
22474 "the I<-a> option: whereas I<-a> adds an existing disk, I<-N> creates a "
22475 "preformatted disk with a filesystem and adds it.  See L</PREPARED DISK "
22476 "IMAGES> below."
22477 msgstr ""
22478
22479 # type: =item
22480 #. type: =item
22481 #: ../fish/guestfish.pod:351
22482 msgid "B<--progress-bars>"
22483 msgstr ""
22484
22485 # type: textblock
22486 #. type: textblock
22487 #: ../fish/guestfish.pod:353
22488 msgid "Enable progress bars, even when guestfish is used non-interactively."
22489 msgstr ""
22490
22491 # type: textblock
22492 #. type: textblock
22493 #: ../fish/guestfish.pod:355
22494 msgid ""
22495 "Progress bars are enabled by default when guestfish is used as an "
22496 "interactive shell."
22497 msgstr ""
22498
22499 # type: =item
22500 #. type: =item
22501 #: ../fish/guestfish.pod:358
22502 msgid "B<--no-progress-bars>"
22503 msgstr ""
22504
22505 # type: textblock
22506 #. type: textblock
22507 #: ../fish/guestfish.pod:360
22508 msgid "Disable progress bars."
22509 msgstr ""
22510
22511 # type: =item
22512 #. type: =item
22513 #: ../fish/guestfish.pod:362
22514 msgid "B<--remote[=pid]>"
22515 msgstr ""
22516
22517 # type: textblock
22518 #. type: textblock
22519 #: ../fish/guestfish.pod:364
22520 msgid ""
22521 "Send remote commands to C<$GUESTFISH_PID> or C<pid>.  See section L</REMOTE "
22522 "CONTROL GUESTFISH OVER A SOCKET> below."
22523 msgstr ""
22524
22525 # type: =item
22526 #. type: =item
22527 #: ../fish/guestfish.pod:367
22528 msgid "B<-r>"
22529 msgstr ""
22530
22531 # type: =item
22532 #. type: =item
22533 #: ../fish/guestfish.pod:369
22534 msgid "B<--ro>"
22535 msgstr ""
22536
22537 # type: textblock
22538 #. type: textblock
22539 #: ../fish/guestfish.pod:371
22540 msgid ""
22541 "This changes the I<-a>, I<-d> and I<-m> options so that disks are added and "
22542 "mounts are done read-only."
22543 msgstr ""
22544
22545 # type: textblock
22546 #. type: textblock
22547 #: ../fish/guestfish.pod:374
22548 msgid ""
22549 "The option must always be used if the disk image or virtual machine might be "
22550 "running, and is generally recommended in cases where you don't need write "
22551 "access to the disk."
22552 msgstr ""
22553
22554 # type: textblock
22555 #. type: textblock
22556 #: ../fish/guestfish.pod:378
22557 msgid ""
22558 "Note that prepared disk images created with I<-N> are not affected by this "
22559 "option.  Also commands like C<add> are not affected - you have to specify "
22560 "the C<readonly:true> option explicitly if you need it."
22561 msgstr ""
22562
22563 # type: textblock
22564 #. type: textblock
22565 #: ../fish/guestfish.pod:382
22566 msgid "See also L</OPENING DISKS FOR READ AND WRITE> below."
22567 msgstr ""
22568
22569 # type: =item
22570 #. type: =item
22571 #: ../fish/guestfish.pod:384 ../fuse/guestmount.pod:235
22572 msgid "B<--selinux>"
22573 msgstr ""
22574
22575 # type: textblock
22576 #. type: textblock
22577 #: ../fish/guestfish.pod:386
22578 msgid "Enable SELinux support for the guest.  See L<guestfs(3)/SELINUX>."
22579 msgstr ""
22580
22581 # type: =item
22582 #. type: =item
22583 #: ../fish/guestfish.pod:388
22584 msgid "B<-v>"
22585 msgstr ""
22586
22587 # type: =item
22588 #. type: =item
22589 #: ../fish/guestfish.pod:390
22590 msgid "B<--verbose>"
22591 msgstr ""
22592
22593 # type: textblock
22594 #. type: textblock
22595 #: ../fish/guestfish.pod:392
22596 msgid ""
22597 "Enable very verbose messages.  This is particularly useful if you find a bug."
22598 msgstr ""
22599
22600 # type: =item
22601 #. type: =item
22602 #: ../fish/guestfish.pod:395
22603 msgid "B<-V>"
22604 msgstr ""
22605
22606 # type: =item
22607 #. type: =item
22608 #: ../fish/guestfish.pod:397 ../tools/virt-edit.pl:97
22609 #: ../tools/virt-win-reg.pl:112 ../tools/virt-list-filesystems.pl:69
22610 #: ../tools/virt-tar.pl:119 ../tools/virt-make-fs.pl:169
22611 #: ../tools/virt-list-partitions.pl:70
22612 msgid "B<--version>"
22613 msgstr ""
22614
22615 # type: textblock
22616 #. type: textblock
22617 #: ../fish/guestfish.pod:399
22618 msgid "Display the guestfish / libguestfs version number and exit."
22619 msgstr ""
22620
22621 # type: =item
22622 #. type: =item
22623 #: ../fish/guestfish.pod:401
22624 msgid "B<-w>"
22625 msgstr ""
22626
22627 # type: =item
22628 #. type: =item
22629 #: ../fish/guestfish.pod:403
22630 msgid "B<--rw>"
22631 msgstr ""
22632
22633 #. type: textblock
22634 #: ../fish/guestfish.pod:405 ../fuse/guestmount.pod:249
22635 msgid ""
22636 "This changes the I<-a>, I<-d> and I<-m> options so that disks are added and "
22637 "mounts are done read-write."
22638 msgstr ""
22639
22640 #. type: textblock
22641 #: ../fish/guestfish.pod:408
22642 msgid "See L</OPENING DISKS FOR READ AND WRITE> below."
22643 msgstr ""
22644
22645 # type: =item
22646 #. type: =item
22647 #: ../fish/guestfish.pod:410
22648 msgid "B<-x>"
22649 msgstr ""
22650
22651 # type: textblock
22652 #. type: textblock
22653 #: ../fish/guestfish.pod:412
22654 msgid "Echo each command before executing it."
22655 msgstr ""
22656
22657 # type: =head1
22658 #. type: =head1
22659 #: ../fish/guestfish.pod:416
22660 msgid "COMMANDS ON COMMAND LINE"
22661 msgstr ""
22662
22663 # type: textblock
22664 #. type: textblock
22665 #: ../fish/guestfish.pod:418
22666 msgid ""
22667 "Any additional (non-option) arguments are treated as commands to execute."
22668 msgstr ""
22669
22670 # type: textblock
22671 #. type: textblock
22672 #: ../fish/guestfish.pod:421
22673 msgid ""
22674 "Commands to execute should be separated by a colon (C<:>), where the colon "
22675 "is a separate parameter.  Thus:"
22676 msgstr ""
22677
22678 # type: verbatim
22679 #. type: verbatim
22680 #: ../fish/guestfish.pod:424
22681 #, no-wrap
22682 msgid ""
22683 " guestfish cmd [args...] : cmd [args...] : cmd [args...] ...\n"
22684 "\n"
22685 msgstr ""
22686
22687 # type: textblock
22688 #. type: textblock
22689 #: ../fish/guestfish.pod:426
22690 msgid ""
22691 "If there are no additional arguments, then we enter a shell, either an "
22692 "interactive shell with a prompt (if the input is a terminal) or a non-"
22693 "interactive shell."
22694 msgstr ""
22695
22696 # type: textblock
22697 #. type: textblock
22698 #: ../fish/guestfish.pod:430
22699 msgid ""
22700 "In either command line mode or non-interactive shell, the first command that "
22701 "gives an error causes the whole shell to exit.  In interactive mode (with a "
22702 "prompt) if a command fails, you can continue to enter commands."
22703 msgstr ""
22704
22705 # type: =head1
22706 #. type: =head1
22707 #: ../fish/guestfish.pod:435
22708 msgid "USING launch (OR run)"
22709 msgstr ""
22710
22711 # type: textblock
22712 #. type: textblock
22713 #: ../fish/guestfish.pod:437
22714 msgid ""
22715 "As with L<guestfs(3)>, you must first configure your guest by adding disks, "
22716 "then launch it, then mount any disks you need, and finally issue actions/"
22717 "commands.  So the general order of the day is:"
22718 msgstr ""
22719
22720 # type: textblock
22721 #. type: textblock
22722 #: ../fish/guestfish.pod:445
22723 msgid "add or -a/--add"
22724 msgstr ""
22725
22726 # type: textblock
22727 #. type: textblock
22728 #: ../fish/guestfish.pod:449
22729 msgid "launch (aka run)"
22730 msgstr ""
22731
22732 # type: textblock
22733 #. type: textblock
22734 #: ../fish/guestfish.pod:453
22735 msgid "mount or -m/--mount"
22736 msgstr ""
22737
22738 # type: textblock
22739 #. type: textblock
22740 #: ../fish/guestfish.pod:457
22741 msgid "any other commands"
22742 msgstr ""
22743
22744 # type: textblock
22745 #. type: textblock
22746 #: ../fish/guestfish.pod:461
22747 msgid ""
22748 "C<run> is a synonym for C<launch>.  You must C<launch> (or C<run>)  your "
22749 "guest before mounting or performing any other commands."
22750 msgstr ""
22751
22752 # type: textblock
22753 #. type: textblock
22754 #: ../fish/guestfish.pod:464
22755 msgid ""
22756 "The only exception is that if any of the I<-i>, I<-m>, I<--mount>, I<-N> or "
22757 "I<--new> options were given then C<run> is done automatically, simply "
22758 "because guestfish can't perform the action you asked for without doing this."
22759 msgstr ""
22760
22761 # type: =head1
22762 #. type: =head1
22763 #: ../fish/guestfish.pod:469
22764 msgid "OPENING DISKS FOR READ AND WRITE"
22765 msgstr ""
22766
22767 #. type: textblock
22768 #: ../fish/guestfish.pod:471
22769 msgid ""
22770 "The guestfish, L<guestmount(1)> and L<virt-rescue(1)> options I<--ro> and "
22771 "I<--rw> affect whether the other command line options I<-a>, I<-c>, I<-d>, "
22772 "I<-i> and I<-m> open disk images read-only or for writing."
22773 msgstr ""
22774
22775 #. type: textblock
22776 #: ../fish/guestfish.pod:476
22777 msgid ""
22778 "In libguestfs E<le> 1.10, guestfish, guestmount and virt-rescue defaulted to "
22779 "opening disk images supplied on the command line for write.  To open a disk "
22780 "image read-only you have to do I<-a image --ro>."
22781 msgstr ""
22782
22783 # type: textblock
22784 #. type: textblock
22785 #: ../fish/guestfish.pod:480
22786 msgid ""
22787 "This matters: If you accidentally open a live VM disk image writable then "
22788 "you will cause irreversible disk corruption."
22789 msgstr ""
22790
22791 #. type: textblock
22792 #: ../fish/guestfish.pod:483
22793 msgid ""
22794 "By libguestfs 1.12 we intend to change the default the other way.  Disk "
22795 "images will be opened read-only.  You will have to either specify "
22796 "I<guestfish --rw>, I<guestmount --rw>, I<virt-rescue --rw>, or change the "
22797 "configuration file C</etc/libguestfs-tools.conf> in order to get write "
22798 "access for disk images specified by those other command line options."
22799 msgstr ""
22800
22801 #. type: textblock
22802 #: ../fish/guestfish.pod:490
22803 msgid ""
22804 "This version of guestfish, guestmount and virt-rescue has a I<--rw> option "
22805 "which does nothing (it is already the default).  However it is highly "
22806 "recommended that you use this option to indicate that you need write access, "
22807 "and prepare your scripts for the day when this option will be required for "
22808 "write access."
22809 msgstr ""
22810
22811 # type: textblock
22812 #. type: textblock
22813 #: ../fish/guestfish.pod:496
22814 msgid ""
22815 "B<Note:> This does I<not> affect commands like L</add> and L</mount>, or any "
22816 "other libguestfs program apart from guestfish and guestmount."
22817 msgstr ""
22818
22819 # type: =head1
22820 #. type: =head1
22821 #: ../fish/guestfish.pod:499
22822 msgid "QUOTING"
22823 msgstr ""
22824
22825 # type: textblock
22826 #. type: textblock
22827 #: ../fish/guestfish.pod:501
22828 msgid ""
22829 "You can quote ordinary parameters using either single or double quotes.  For "
22830 "example:"
22831 msgstr ""
22832
22833 # type: verbatim
22834 #. type: verbatim
22835 #: ../fish/guestfish.pod:504
22836 #, no-wrap
22837 msgid ""
22838 " add \"file with a space.img\"\n"
22839 "\n"
22840 msgstr ""
22841
22842 # type: verbatim
22843 #. type: verbatim
22844 #: ../fish/guestfish.pod:506
22845 #, no-wrap
22846 msgid ""
22847 " rm '/file name'\n"
22848 "\n"
22849 msgstr ""
22850
22851 # type: verbatim
22852 #. type: verbatim
22853 #: ../fish/guestfish.pod:508
22854 #, no-wrap
22855 msgid ""
22856 " rm '/\"'\n"
22857 "\n"
22858 msgstr ""
22859
22860 # type: textblock
22861 #. type: textblock
22862 #: ../fish/guestfish.pod:510
22863 msgid ""
22864 "A few commands require a list of strings to be passed.  For these, use a "
22865 "whitespace-separated list, enclosed in quotes.  Strings containing "
22866 "whitespace to be passed through must be enclosed in single quotes.  A "
22867 "literal single quote must be escaped with a backslash."
22868 msgstr ""
22869
22870 # type: verbatim
22871 #. type: verbatim
22872 #: ../fish/guestfish.pod:515
22873 #, no-wrap
22874 msgid ""
22875 " vgcreate VG \"/dev/sda1 /dev/sdb1\"\n"
22876 " command \"/bin/echo 'foo      bar'\"\n"
22877 " command \"/bin/echo \\'foo\\'\"\n"
22878 "\n"
22879 msgstr ""
22880
22881 # type: =head1
22882 #. type: =head1
22883 #: ../fish/guestfish.pod:519
22884 msgid "OPTIONAL ARGUMENTS"
22885 msgstr ""
22886
22887 # type: textblock
22888 #. type: textblock
22889 #: ../fish/guestfish.pod:521
22890 msgid ""
22891 "Some commands take optional arguments.  These arguments appear in this "
22892 "documentation as C<[argname:..]>.  You can use them as in these examples:"
22893 msgstr ""
22894
22895 # type: verbatim
22896 #. type: verbatim
22897 #: ../fish/guestfish.pod:525
22898 #, no-wrap
22899 msgid ""
22900 " add-drive-opts filename\n"
22901 "\n"
22902 msgstr ""
22903
22904 # type: verbatim
22905 #. type: verbatim
22906 #: ../fish/guestfish.pod:527
22907 #, no-wrap
22908 msgid ""
22909 " add-drive-opts filename readonly:true\n"
22910 "\n"
22911 msgstr ""
22912
22913 # type: verbatim
22914 #. type: verbatim
22915 #: ../fish/guestfish.pod:529
22916 #, no-wrap
22917 msgid ""
22918 " add-drive-opts filename format:qcow2 readonly:false\n"
22919 "\n"
22920 msgstr ""
22921
22922 # type: textblock
22923 #. type: textblock
22924 #: ../fish/guestfish.pod:531
22925 msgid ""
22926 "Each optional argument can appear at most once.  All optional arguments must "
22927 "appear after the required ones."
22928 msgstr ""
22929
22930 # type: =head1
22931 #. type: =head1
22932 #: ../fish/guestfish.pod:534
22933 msgid "NUMBERS"
22934 msgstr ""
22935
22936 # type: textblock
22937 #. type: textblock
22938 #: ../fish/guestfish.pod:536
22939 msgid ""
22940 "This section applies to all commands which can take integers as parameters."
22941 msgstr ""
22942
22943 # type: =head2
22944 #. type: =head2
22945 #: ../fish/guestfish.pod:539
22946 msgid "SIZE SUFFIX"
22947 msgstr ""
22948
22949 # type: textblock
22950 #. type: textblock
22951 #: ../fish/guestfish.pod:541
22952 msgid ""
22953 "When the command takes a parameter measured in bytes, you can use one of the "
22954 "following suffixes to specify kilobytes, megabytes and larger sizes:"
22955 msgstr ""
22956
22957 # type: =item
22958 #. type: =item
22959 #: ../fish/guestfish.pod:547
22960 msgid "B<k> or B<K> or B<KiB>"
22961 msgstr ""
22962
22963 # type: textblock
22964 #. type: textblock
22965 #: ../fish/guestfish.pod:549
22966 msgid "The size in kilobytes (multiplied by 1024)."
22967 msgstr ""
22968
22969 # type: =item
22970 #. type: =item
22971 #: ../fish/guestfish.pod:551
22972 msgid "B<KB>"
22973 msgstr ""
22974
22975 # type: textblock
22976 #. type: textblock
22977 #: ../fish/guestfish.pod:553
22978 msgid "The size in SI 1000 byte units."
22979 msgstr ""
22980
22981 # type: =item
22982 #. type: =item
22983 #: ../fish/guestfish.pod:555
22984 msgid "B<M> or B<MiB>"
22985 msgstr ""
22986
22987 # type: textblock
22988 #. type: textblock
22989 #: ../fish/guestfish.pod:557
22990 msgid "The size in megabytes (multiplied by 1048576)."
22991 msgstr ""
22992
22993 # type: =item
22994 #. type: =item
22995 #: ../fish/guestfish.pod:559
22996 msgid "B<MB>"
22997 msgstr ""
22998
22999 # type: textblock
23000 #. type: textblock
23001 #: ../fish/guestfish.pod:561
23002 msgid "The size in SI 1000000 byte units."
23003 msgstr ""
23004
23005 # type: =item
23006 #. type: =item
23007 #: ../fish/guestfish.pod:563
23008 msgid "B<G> or B<GiB>"
23009 msgstr ""
23010
23011 # type: textblock
23012 #. type: textblock
23013 #: ../fish/guestfish.pod:565
23014 msgid "The size in gigabytes (multiplied by 2**30)."
23015 msgstr ""
23016
23017 # type: =item
23018 #. type: =item
23019 #: ../fish/guestfish.pod:567
23020 msgid "B<GB>"
23021 msgstr ""
23022
23023 # type: textblock
23024 #. type: textblock
23025 #: ../fish/guestfish.pod:569
23026 msgid "The size in SI 10**9 byte units."
23027 msgstr ""
23028
23029 # type: =item
23030 #. type: =item
23031 #: ../fish/guestfish.pod:571
23032 msgid "B<T> or B<TiB>"
23033 msgstr ""
23034
23035 # type: textblock
23036 #. type: textblock
23037 #: ../fish/guestfish.pod:573
23038 msgid "The size in terabytes (multiplied by 2**40)."
23039 msgstr ""
23040
23041 # type: =item
23042 #. type: =item
23043 #: ../fish/guestfish.pod:575
23044 msgid "B<TB>"
23045 msgstr ""
23046
23047 # type: textblock
23048 #. type: textblock
23049 #: ../fish/guestfish.pod:577
23050 msgid "The size in SI 10**12 byte units."
23051 msgstr ""
23052
23053 # type: =item
23054 #. type: =item
23055 #: ../fish/guestfish.pod:579
23056 msgid "B<P> or B<PiB>"
23057 msgstr ""
23058
23059 # type: textblock
23060 #. type: textblock
23061 #: ../fish/guestfish.pod:581
23062 msgid "The size in petabytes (multiplied by 2**50)."
23063 msgstr ""
23064
23065 # type: =item
23066 #. type: =item
23067 #: ../fish/guestfish.pod:583
23068 msgid "B<PB>"
23069 msgstr ""
23070
23071 # type: textblock
23072 #. type: textblock
23073 #: ../fish/guestfish.pod:585
23074 msgid "The size in SI 10**15 byte units."
23075 msgstr ""
23076
23077 # type: =item
23078 #. type: =item
23079 #: ../fish/guestfish.pod:587
23080 msgid "B<E> or B<EiB>"
23081 msgstr ""
23082
23083 # type: textblock
23084 #. type: textblock
23085 #: ../fish/guestfish.pod:589
23086 msgid "The size in exabytes (multiplied by 2**60)."
23087 msgstr ""
23088
23089 # type: =item
23090 #. type: =item
23091 #: ../fish/guestfish.pod:591
23092 msgid "B<EB>"
23093 msgstr ""
23094
23095 # type: textblock
23096 #. type: textblock
23097 #: ../fish/guestfish.pod:593
23098 msgid "The size in SI 10**18 byte units."
23099 msgstr ""
23100
23101 # type: =item
23102 #. type: =item
23103 #: ../fish/guestfish.pod:595
23104 msgid "B<Z> or B<ZiB>"
23105 msgstr ""
23106
23107 # type: textblock
23108 #. type: textblock
23109 #: ../fish/guestfish.pod:597
23110 msgid "The size in zettabytes (multiplied by 2**70)."
23111 msgstr ""
23112
23113 # type: =item
23114 #. type: =item
23115 #: ../fish/guestfish.pod:599
23116 msgid "B<ZB>"
23117 msgstr ""
23118
23119 # type: textblock
23120 #. type: textblock
23121 #: ../fish/guestfish.pod:601
23122 msgid "The size in SI 10**21 byte units."
23123 msgstr ""
23124
23125 # type: =item
23126 #. type: =item
23127 #: ../fish/guestfish.pod:603
23128 msgid "B<Y> or B<YiB>"
23129 msgstr ""
23130
23131 # type: textblock
23132 #. type: textblock
23133 #: ../fish/guestfish.pod:605
23134 msgid "The size in yottabytes (multiplied by 2**80)."
23135 msgstr ""
23136
23137 # type: =item
23138 #. type: =item
23139 #: ../fish/guestfish.pod:607
23140 msgid "B<YB>"
23141 msgstr ""
23142
23143 # type: textblock
23144 #. type: textblock
23145 #: ../fish/guestfish.pod:609
23146 msgid "The size in SI 10**24 byte units."
23147 msgstr ""
23148
23149 # type: verbatim
23150 #. type: verbatim
23151 #: ../fish/guestfish.pod:615
23152 #, no-wrap
23153 msgid ""
23154 " truncate-size /file 1G\n"
23155 "\n"
23156 msgstr ""
23157
23158 # type: textblock
23159 #. type: textblock
23160 #: ../fish/guestfish.pod:617
23161 msgid "would truncate the file to 1 gigabyte."
23162 msgstr ""
23163
23164 # type: textblock
23165 #. type: textblock
23166 #: ../fish/guestfish.pod:619
23167 msgid ""
23168 "Be careful because a few commands take sizes in kilobytes or megabytes (eg. "
23169 "the parameter to L</memsize> is specified in megabytes already).  Adding a "
23170 "suffix will probably not do what you expect."
23171 msgstr ""
23172
23173 # type: =head2
23174 #. type: =head2
23175 #: ../fish/guestfish.pod:623
23176 msgid "OCTAL AND HEXADECIMAL NUMBERS"
23177 msgstr ""
23178
23179 # type: textblock
23180 #. type: textblock
23181 #: ../fish/guestfish.pod:625
23182 msgid ""
23183 "For specifying the radix (base) use the C convention: C<0> to prefix an "
23184 "octal number or C<0x> to prefix a hexadecimal number.  For example:"
23185 msgstr ""
23186
23187 # type: verbatim
23188 #. type: verbatim
23189 #: ../fish/guestfish.pod:628
23190 #, no-wrap
23191 msgid ""
23192 " 1234      decimal number 1234\n"
23193 " 02322     octal number, equivalent to decimal 1234\n"
23194 " 0x4d2     hexadecimal number, equivalent to decimal 1234\n"
23195 "\n"
23196 msgstr ""
23197
23198 # type: textblock
23199 #. type: textblock
23200 #: ../fish/guestfish.pod:632
23201 msgid ""
23202 "When using the C<chmod> command, you almost always want to specify an octal "
23203 "number for the mode, and you must prefix it with C<0> (unlike the Unix "
23204 "L<chmod(1)> program):"
23205 msgstr ""
23206
23207 # type: verbatim
23208 #. type: verbatim
23209 #: ../fish/guestfish.pod:636
23210 #, no-wrap
23211 msgid ""
23212 " chmod 0777 /public  # OK\n"
23213 " chmod 777 /public   # WRONG! This is mode 777 decimal = 01411 octal.\n"
23214 "\n"
23215 msgstr ""
23216
23217 # type: textblock
23218 #. type: textblock
23219 #: ../fish/guestfish.pod:639
23220 msgid ""
23221 "Commands that return numbers usually print them in decimal, but some "
23222 "commands print numbers in other radices (eg. C<umask> prints the mode in "
23223 "octal, preceeded by C<0>)."
23224 msgstr ""
23225
23226 # type: =head1
23227 #. type: =head1
23228 #: ../fish/guestfish.pod:643
23229 msgid "WILDCARDS AND GLOBBING"
23230 msgstr ""
23231
23232 # type: textblock
23233 #. type: textblock
23234 #: ../fish/guestfish.pod:645
23235 msgid ""
23236 "Neither guestfish nor the underlying guestfs API performs wildcard expansion "
23237 "(globbing) by default.  So for example the following will not do what you "
23238 "expect:"
23239 msgstr ""
23240
23241 # type: verbatim
23242 #. type: verbatim
23243 #: ../fish/guestfish.pod:649
23244 #, no-wrap
23245 msgid ""
23246 " rm-rf /home/*\n"
23247 "\n"
23248 msgstr ""
23249
23250 # type: textblock
23251 #. type: textblock
23252 #: ../fish/guestfish.pod:651
23253 msgid ""
23254 "Assuming you don't have a directory called literally C</home/*> then the "
23255 "above command will return an error."
23256 msgstr ""
23257
23258 # type: textblock
23259 #. type: textblock
23260 #: ../fish/guestfish.pod:654
23261 msgid "To perform wildcard expansion, use the C<glob> command."
23262 msgstr ""
23263
23264 # type: verbatim
23265 #. type: verbatim
23266 #: ../fish/guestfish.pod:656
23267 #, no-wrap
23268 msgid ""
23269 " glob rm-rf /home/*\n"
23270 "\n"
23271 msgstr ""
23272
23273 # type: textblock
23274 #. type: textblock
23275 #: ../fish/guestfish.pod:658
23276 msgid ""
23277 "runs C<rm-rf> on each path that matches (ie. potentially running the command "
23278 "many times), equivalent to:"
23279 msgstr ""
23280
23281 # type: verbatim
23282 #. type: verbatim
23283 #: ../fish/guestfish.pod:661
23284 #, no-wrap
23285 msgid ""
23286 " rm-rf /home/jim\n"
23287 " rm-rf /home/joe\n"
23288 " rm-rf /home/mary\n"
23289 "\n"
23290 msgstr ""
23291
23292 # type: textblock
23293 #. type: textblock
23294 #: ../fish/guestfish.pod:665
23295 msgid "C<glob> only works on simple guest paths and not on device names."
23296 msgstr ""
23297
23298 # type: textblock
23299 #. type: textblock
23300 #: ../fish/guestfish.pod:667
23301 msgid ""
23302 "If you have several parameters, each containing a wildcard, then glob will "
23303 "perform a Cartesian product."
23304 msgstr ""
23305
23306 # type: =head1
23307 #. type: =head1
23308 #: ../fish/guestfish.pod:670
23309 msgid "COMMENTS"
23310 msgstr ""
23311
23312 # type: textblock
23313 #. type: textblock
23314 #: ../fish/guestfish.pod:672
23315 msgid ""
23316 "Any line which starts with a I<#> character is treated as a comment and "
23317 "ignored.  The I<#> can optionally be preceeded by whitespace, but B<not> by "
23318 "a command.  For example:"
23319 msgstr ""
23320
23321 # type: verbatim
23322 #. type: verbatim
23323 #: ../fish/guestfish.pod:676
23324 #, no-wrap
23325 msgid ""
23326 " # this is a comment\n"
23327 "         # this is a comment\n"
23328 " foo # NOT a comment\n"
23329 "\n"
23330 msgstr ""
23331
23332 # type: textblock
23333 #. type: textblock
23334 #: ../fish/guestfish.pod:680
23335 msgid "Blank lines are also ignored."
23336 msgstr ""
23337
23338 # type: =head1
23339 #. type: =head1
23340 #: ../fish/guestfish.pod:682
23341 msgid "RUNNING COMMANDS LOCALLY"
23342 msgstr ""
23343
23344 # type: textblock
23345 #. type: textblock
23346 #: ../fish/guestfish.pod:684
23347 msgid ""
23348 "Any line which starts with a I<!> character is treated as a command sent to "
23349 "the local shell (C</bin/sh> or whatever L<system(3)> uses).  For example:"
23350 msgstr ""
23351
23352 # type: verbatim
23353 #. type: verbatim
23354 #: ../fish/guestfish.pod:688
23355 #, no-wrap
23356 msgid ""
23357 " !mkdir local\n"
23358 " tgz-out /remote local/remote-data.tar.gz\n"
23359 "\n"
23360 msgstr ""
23361
23362 # type: textblock
23363 #. type: textblock
23364 #: ../fish/guestfish.pod:691
23365 msgid ""
23366 "will create a directory C<local> on the host, and then export the contents "
23367 "of C</remote> on the mounted filesystem to C<local/remote-data.tar.gz>.  "
23368 "(See C<tgz-out>)."
23369 msgstr ""
23370
23371 # type: textblock
23372 #. type: textblock
23373 #: ../fish/guestfish.pod:695
23374 msgid ""
23375 "To change the local directory, use the C<lcd> command.  C<!cd> will have no "
23376 "effect, due to the way that subprocesses work in Unix."
23377 msgstr ""
23378
23379 #. type: =head2
23380 #: ../fish/guestfish.pod:698
23381 msgid "LOCAL COMMANDS WITH INLINE EXECUTION"
23382 msgstr ""
23383
23384 #. type: textblock
23385 #: ../fish/guestfish.pod:700
23386 msgid ""
23387 "If a line starts with I<E<lt>!> then the shell command is executed (as for "
23388 "I<!>), but subsequently any output (stdout) of the shell command is parsed "
23389 "and executed as guestfish commands."
23390 msgstr ""
23391
23392 #. type: textblock
23393 #: ../fish/guestfish.pod:704
23394 msgid ""
23395 "Thus you can use shell script to construct arbitrary guestfish commands "
23396 "which are then parsed by guestfish."
23397 msgstr ""
23398
23399 #. type: textblock
23400 #: ../fish/guestfish.pod:707
23401 msgid ""
23402 "For example it is tedious to create a sequence of files (eg. C</foo.1> "
23403 "through C</foo.100>) using guestfish commands alone.  However this is simple "
23404 "if we use a shell script to create the guestfish commands for us:"
23405 msgstr ""
23406
23407 #. type: verbatim
23408 #: ../fish/guestfish.pod:712
23409 #, no-wrap
23410 msgid ""
23411 " <! for n in `seq 1 100`; do echo write /foo.$n $n; done\n"
23412 "\n"
23413 msgstr ""
23414
23415 #. type: textblock
23416 #: ../fish/guestfish.pod:714
23417 msgid "or with names like C</foo.001>:"
23418 msgstr ""
23419
23420 #. type: verbatim
23421 #: ../fish/guestfish.pod:716
23422 #, no-wrap
23423 msgid ""
23424 " <! for n in `seq 1 100`; do printf \"write /foo.%03d %d\\n\" $n $n; done\n"
23425 "\n"
23426 msgstr ""
23427
23428 #. type: textblock
23429 #: ../fish/guestfish.pod:718
23430 msgid ""
23431 "When using guestfish interactively it can be helpful to just run the shell "
23432 "script first (ie. remove the initial C<E<lt>> character so it is just an "
23433 "ordinary I<!> local command), see what guestfish commands it would run, and "
23434 "when you are happy with those prepend the C<E<lt>> character to run the "
23435 "guestfish commands for real."
23436 msgstr ""
23437
23438 # type: =head1
23439 #. type: =head1
23440 #: ../fish/guestfish.pod:724
23441 msgid "PIPES"
23442 msgstr ""
23443
23444 # type: textblock
23445 #. type: textblock
23446 #: ../fish/guestfish.pod:726
23447 msgid ""
23448 "Use C<command E<lt>spaceE<gt> | command> to pipe the output of the first "
23449 "command (a guestfish command) to the second command (any host command).  For "
23450 "example:"
23451 msgstr ""
23452
23453 # type: verbatim
23454 #. type: verbatim
23455 #: ../fish/guestfish.pod:730
23456 #, no-wrap
23457 msgid ""
23458 " cat /etc/passwd | awk -F: '$3 == 0 { print }'\n"
23459 "\n"
23460 msgstr ""
23461
23462 # type: textblock
23463 #. type: textblock
23464 #: ../fish/guestfish.pod:732
23465 msgid ""
23466 "(where C<cat> is the guestfish cat command, but C<awk> is the host awk "
23467 "program).  The above command would list all accounts in the guest filesystem "
23468 "which have UID 0, ie. root accounts including backdoors.  Other examples:"
23469 msgstr ""
23470
23471 # type: verbatim
23472 #. type: verbatim
23473 #: ../fish/guestfish.pod:737
23474 #, no-wrap
23475 msgid ""
23476 " hexdump /bin/ls | head\n"
23477 " list-devices | tail -1\n"
23478 " tgz-out / - | tar ztf -\n"
23479 "\n"
23480 msgstr ""
23481
23482 # type: textblock
23483 #. type: textblock
23484 #: ../fish/guestfish.pod:741
23485 msgid ""
23486 "The space before the pipe symbol is required, any space after the pipe "
23487 "symbol is optional.  Everything after the pipe symbol is just passed "
23488 "straight to the host shell, so it can contain redirections, globs and "
23489 "anything else that makes sense on the host side."
23490 msgstr ""
23491
23492 # type: textblock
23493 #. type: textblock
23494 #: ../fish/guestfish.pod:746
23495 msgid ""
23496 "To use a literal argument which begins with a pipe symbol, you have to quote "
23497 "it, eg:"
23498 msgstr ""
23499
23500 # type: verbatim
23501 #. type: verbatim
23502 #: ../fish/guestfish.pod:749
23503 #, no-wrap
23504 msgid ""
23505 " echo \"|\"\n"
23506 "\n"
23507 msgstr ""
23508
23509 # type: =head1
23510 #. type: =head1
23511 #: ../fish/guestfish.pod:751
23512 msgid "HOME DIRECTORIES"
23513 msgstr ""
23514
23515 # type: textblock
23516 #. type: textblock
23517 #: ../fish/guestfish.pod:753
23518 msgid ""
23519 "If a parameter starts with the character C<~> then the tilde may be expanded "
23520 "as a home directory path (either C<~> for the current user's home directory, "
23521 "or C<~user> for another user)."
23522 msgstr ""
23523
23524 # type: textblock
23525 #. type: textblock
23526 #: ../fish/guestfish.pod:757
23527 msgid ""
23528 "Note that home directory expansion happens for users known I<on the host>, "
23529 "not in the guest filesystem."
23530 msgstr ""
23531
23532 # type: textblock
23533 #. type: textblock
23534 #: ../fish/guestfish.pod:760
23535 msgid ""
23536 "To use a literal argument which begins with a tilde, you have to quote it, "
23537 "eg:"
23538 msgstr ""
23539
23540 # type: verbatim
23541 #. type: verbatim
23542 #: ../fish/guestfish.pod:763
23543 #, no-wrap
23544 msgid ""
23545 " echo \"~\"\n"
23546 "\n"
23547 msgstr ""
23548
23549 # type: textblock
23550 #. type: textblock
23551 #: ../fish/guestfish.pod:767
23552 msgid ""
23553 "Libguestfs has some support for Linux guests encrypted according to the "
23554 "Linux Unified Key Setup (LUKS) standard, which includes nearly all whole "
23555 "disk encryption systems used by modern Linux guests.  Currently only LVM-on-"
23556 "LUKS is supported."
23557 msgstr ""
23558
23559 # type: textblock
23560 #. type: textblock
23561 #: ../fish/guestfish.pod:772
23562 msgid "Identify encrypted block devices and partitions using L</vfs-type>:"
23563 msgstr ""
23564
23565 # type: verbatim
23566 #. type: verbatim
23567 #: ../fish/guestfish.pod:774
23568 #, no-wrap
23569 msgid ""
23570 " ><fs> vfs-type /dev/sda2\n"
23571 " crypto_LUKS\n"
23572 "\n"
23573 msgstr ""
23574
23575 # type: textblock
23576 #. type: textblock
23577 #: ../fish/guestfish.pod:777
23578 msgid ""
23579 "Then open those devices using L</luks-open>.  This creates a device-mapper "
23580 "device called C</dev/mapper/luksdev>."
23581 msgstr ""
23582
23583 # type: verbatim
23584 #. type: verbatim
23585 #: ../fish/guestfish.pod:780
23586 #, no-wrap
23587 msgid ""
23588 " ><fs> luks-open /dev/sda2 luksdev\n"
23589 " Enter key or passphrase (\"key\"): <enter the passphrase>\n"
23590 "\n"
23591 msgstr ""
23592
23593 # type: textblock
23594 #. type: textblock
23595 #: ../fish/guestfish.pod:783
23596 msgid ""
23597 "Finally you have to tell LVM to scan for volume groups on the newly created "
23598 "mapper device:"
23599 msgstr ""
23600
23601 # type: verbatim
23602 #. type: verbatim
23603 #: ../fish/guestfish.pod:786
23604 #, no-wrap
23605 msgid ""
23606 " vgscan\n"
23607 " vg-activate-all true\n"
23608 "\n"
23609 msgstr ""
23610
23611 # type: textblock
23612 #. type: textblock
23613 #: ../fish/guestfish.pod:789
23614 msgid "The logical volume(s) can now be mounted in the usual way."
23615 msgstr ""
23616
23617 # type: textblock
23618 #. type: textblock
23619 #: ../fish/guestfish.pod:791
23620 msgid ""
23621 "Before closing a LUKS device you must unmount any logical volumes on it and "
23622 "deactivate the volume groups by calling C<vg-activate false VG> on each "
23623 "one.  Then you can close the mapper device:"
23624 msgstr ""
23625
23626 # type: verbatim
23627 #. type: verbatim
23628 #: ../fish/guestfish.pod:795
23629 #, no-wrap
23630 msgid ""
23631 " vg-activate false /dev/VG\n"
23632 " luks-close /dev/mapper/luksdev\n"
23633 "\n"
23634 msgstr ""
23635
23636 # type: =head1
23637 #. type: =head1
23638 #: ../fish/guestfish.pod:798 ../tools/virt-edit.pl:342
23639 msgid "WINDOWS PATHS"
23640 msgstr ""
23641
23642 #. type: textblock
23643 #: ../fish/guestfish.pod:800
23644 msgid ""
23645 "If a path is prefixed with C<win:> then you can use Windows-style drive "
23646 "letters and paths (with some limitations).  The following commands are "
23647 "equivalent:"
23648 msgstr ""
23649
23650 # type: verbatim
23651 #. type: verbatim
23652 #: ../fish/guestfish.pod:804
23653 #, no-wrap
23654 msgid ""
23655 " file /WINDOWS/system32/config/system.LOG\n"
23656 "\n"
23657 msgstr ""
23658
23659 # type: verbatim
23660 #. type: verbatim
23661 #: ../fish/guestfish.pod:806
23662 #, no-wrap
23663 msgid ""
23664 " file win:\\windows\\system32\\config\\system.log\n"
23665 "\n"
23666 msgstr ""
23667
23668 #. type: verbatim
23669 #: ../fish/guestfish.pod:808
23670 #, no-wrap
23671 msgid ""
23672 " file WIN:C:\\Windows\\SYSTEM32\\CONFIG\\SYSTEM.LOG\n"
23673 "\n"
23674 msgstr ""
23675
23676 #. type: textblock
23677 #: ../fish/guestfish.pod:810
23678 msgid ""
23679 "The parameter is rewritten \"behind the scenes\" by looking up the position "
23680 "where the drive is mounted, prepending that to the path, changing all "
23681 "backslash characters to forward slash, then resolving the result using L</"
23682 "case-sensitive-path>.  For example if the E: drive was mounted on C</e> then "
23683 "the parameter might be rewritten like this:"
23684 msgstr ""
23685
23686 #. type: verbatim
23687 #: ../fish/guestfish.pod:816
23688 #, no-wrap
23689 msgid ""
23690 " win:e:\\foo\\bar => /e/FOO/bar\n"
23691 "\n"
23692 msgstr ""
23693
23694 #. type: textblock
23695 #: ../fish/guestfish.pod:818
23696 msgid "This only works in argument positions that expect a path."
23697 msgstr ""
23698
23699 # type: =head1
23700 #. type: =head1
23701 #: ../fish/guestfish.pod:820
23702 msgid "UPLOADING AND DOWNLOADING FILES"
23703 msgstr ""
23704
23705 # type: textblock
23706 #. type: textblock
23707 #: ../fish/guestfish.pod:822
23708 msgid ""
23709 "For commands such as C<upload>, C<download>, C<tar-in>, C<tar-out> and "
23710 "others which upload from or download to a local file, you can use the "
23711 "special filename C<-> to mean \"from stdin\" or \"to stdout\".  For example:"
23712 msgstr ""
23713
23714 # type: verbatim
23715 #. type: verbatim
23716 #: ../fish/guestfish.pod:826
23717 #, no-wrap
23718 msgid ""
23719 " upload - /foo\n"
23720 "\n"
23721 msgstr ""
23722
23723 # type: textblock
23724 #. type: textblock
23725 #: ../fish/guestfish.pod:828
23726 msgid ""
23727 "reads stdin and creates from that a file C</foo> in the disk image, and:"
23728 msgstr ""
23729
23730 # type: verbatim
23731 #. type: verbatim
23732 #: ../fish/guestfish.pod:831
23733 #, no-wrap
23734 msgid ""
23735 " tar-out /etc - | tar tf -\n"
23736 "\n"
23737 msgstr ""
23738
23739 # type: textblock
23740 #. type: textblock
23741 #: ../fish/guestfish.pod:833
23742 msgid ""
23743 "writes the tarball to stdout and then pipes that into the external \"tar\" "
23744 "command (see L</PIPES>)."
23745 msgstr ""
23746
23747 # type: textblock
23748 #. type: textblock
23749 #: ../fish/guestfish.pod:836
23750 msgid ""
23751 "When using C<-> to read from stdin, the input is read up to the end of "
23752 "stdin.  You can also use a special \"heredoc\"-like syntax to read up to "
23753 "some arbitrary end marker:"
23754 msgstr ""
23755
23756 # type: verbatim
23757 #. type: verbatim
23758 #: ../fish/guestfish.pod:840
23759 #, no-wrap
23760 msgid ""
23761 " upload -<<END /foo\n"
23762 " input line 1\n"
23763 " input line 2\n"
23764 " input line 3\n"
23765 " END\n"
23766 "\n"
23767 msgstr ""
23768
23769 # type: textblock
23770 #. type: textblock
23771 #: ../fish/guestfish.pod:846
23772 msgid ""
23773 "Any string of characters can be used instead of C<END>.  The end marker must "
23774 "appear on a line of its own, without any preceeding or following characters "
23775 "(not even spaces)."
23776 msgstr ""
23777
23778 # type: textblock
23779 #. type: textblock
23780 #: ../fish/guestfish.pod:850
23781 msgid ""
23782 "Note that the C<-E<lt>E<lt>> syntax only applies to parameters used to "
23783 "upload local files (so-called \"FileIn\" parameters in the generator)."
23784 msgstr ""
23785
23786 # type: =head1
23787 #. type: =head1
23788 #: ../fish/guestfish.pod:853
23789 msgid "EXIT ON ERROR BEHAVIOUR"
23790 msgstr ""
23791
23792 # type: textblock
23793 #. type: textblock
23794 #: ../fish/guestfish.pod:855
23795 msgid ""
23796 "By default, guestfish will ignore any errors when in interactive mode (ie. "
23797 "taking commands from a human over a tty), and will exit on the first error "
23798 "in non-interactive mode (scripts, commands given on the command line)."
23799 msgstr ""
23800
23801 # type: textblock
23802 #. type: textblock
23803 #: ../fish/guestfish.pod:860
23804 msgid ""
23805 "If you prefix a command with a I<-> character, then that command will not "
23806 "cause guestfish to exit, even if that (one) command returns an error."
23807 msgstr ""
23808
23809 # type: =head1
23810 #. type: =head1
23811 #: ../fish/guestfish.pod:864
23812 msgid "REMOTE CONTROL GUESTFISH OVER A SOCKET"
23813 msgstr ""
23814
23815 # type: textblock
23816 #. type: textblock
23817 #: ../fish/guestfish.pod:866
23818 msgid ""
23819 "Guestfish can be remote-controlled over a socket.  This is useful "
23820 "particularly in shell scripts where you want to make several different "
23821 "changes to a filesystem, but you don't want the overhead of starting up a "
23822 "guestfish process each time."
23823 msgstr ""
23824
23825 # type: textblock
23826 #. type: textblock
23827 #: ../fish/guestfish.pod:871
23828 msgid "Start a guestfish server process using:"
23829 msgstr ""
23830
23831 # type: verbatim
23832 #. type: verbatim
23833 #: ../fish/guestfish.pod:873
23834 #, no-wrap
23835 msgid ""
23836 " eval \"`guestfish --listen`\"\n"
23837 "\n"
23838 msgstr ""
23839
23840 # type: textblock
23841 #. type: textblock
23842 #: ../fish/guestfish.pod:875
23843 msgid "and then send it commands by doing:"
23844 msgstr ""
23845
23846 # type: verbatim
23847 #. type: verbatim
23848 #: ../fish/guestfish.pod:877
23849 #, no-wrap
23850 msgid ""
23851 " guestfish --remote cmd [...]\n"
23852 "\n"
23853 msgstr ""
23854
23855 # type: textblock
23856 #. type: textblock
23857 #: ../fish/guestfish.pod:879
23858 msgid "To cause the server to exit, send it the exit command:"
23859 msgstr ""
23860
23861 # type: verbatim
23862 #. type: verbatim
23863 #: ../fish/guestfish.pod:881
23864 #, no-wrap
23865 msgid ""
23866 " guestfish --remote exit\n"
23867 "\n"
23868 msgstr ""
23869
23870 # type: textblock
23871 #. type: textblock
23872 #: ../fish/guestfish.pod:883
23873 msgid ""
23874 "Note that the server will normally exit if there is an error in a command.  "
23875 "You can change this in the usual way.  See section L</EXIT ON ERROR "
23876 "BEHAVIOUR>."
23877 msgstr ""
23878
23879 # type: =head2
23880 #. type: =head2
23881 #: ../fish/guestfish.pod:887
23882 msgid "CONTROLLING MULTIPLE GUESTFISH PROCESSES"
23883 msgstr ""
23884
23885 # type: textblock
23886 #. type: textblock
23887 #: ../fish/guestfish.pod:889
23888 msgid ""
23889 "The C<eval> statement sets the environment variable C<$GUESTFISH_PID>, which "
23890 "is how the I<--remote> option knows where to send the commands.  You can "
23891 "have several guestfish listener processes running using:"
23892 msgstr ""
23893
23894 # type: verbatim
23895 #. type: verbatim
23896 #: ../fish/guestfish.pod:893
23897 #, no-wrap
23898 msgid ""
23899 " eval \"`guestfish --listen`\"\n"
23900 " pid1=$GUESTFISH_PID\n"
23901 " eval \"`guestfish --listen`\"\n"
23902 " pid2=$GUESTFISH_PID\n"
23903 " ...\n"
23904 " guestfish --remote=$pid1 cmd\n"
23905 " guestfish --remote=$pid2 cmd\n"
23906 "\n"
23907 msgstr ""
23908
23909 # type: =head2
23910 #. type: =head2
23911 #: ../fish/guestfish.pod:901
23912 msgid "REMOTE CONTROL AND CSH"
23913 msgstr ""
23914
23915 # type: textblock
23916 #. type: textblock
23917 #: ../fish/guestfish.pod:903
23918 msgid ""
23919 "When using csh-like shells (csh, tcsh etc) you have to add the I<--csh> "
23920 "option:"
23921 msgstr ""
23922
23923 # type: verbatim
23924 #. type: verbatim
23925 #: ../fish/guestfish.pod:906
23926 #, no-wrap
23927 msgid ""
23928 " eval \"`guestfish --listen --csh`\"\n"
23929 "\n"
23930 msgstr ""
23931
23932 # type: =head2
23933 #. type: =head2
23934 #: ../fish/guestfish.pod:908
23935 msgid "REMOTE CONTROL DETAILS"
23936 msgstr ""
23937
23938 # type: textblock
23939 #. type: textblock
23940 #: ../fish/guestfish.pod:910
23941 msgid ""
23942 "Remote control happens over a Unix domain socket called C</tmp/.guestfish-"
23943 "$UID/socket-$PID>, where C<$UID> is the effective user ID of the process, "
23944 "and C<$PID> is the process ID of the server."
23945 msgstr ""
23946
23947 # type: textblock
23948 #. type: textblock
23949 #: ../fish/guestfish.pod:914
23950 msgid "Guestfish client and server versions must match exactly."
23951 msgstr ""
23952
23953 #. type: =head2
23954 #: ../fish/guestfish.pod:916
23955 msgid "REMOTE CONTROL RUN COMMAND HANGING"
23956 msgstr ""
23957
23958 #. type: textblock
23959 #: ../fish/guestfish.pod:918
23960 msgid ""
23961 "Using the C<run> (or C<launch>) command remotely in a command substitution "
23962 "context hangs, ie. don't do (note the backquotes):"
23963 msgstr ""
23964
23965 #. type: verbatim
23966 #: ../fish/guestfish.pod:921
23967 #, no-wrap
23968 msgid ""
23969 " a=`guestfish --remote run`\n"
23970 "\n"
23971 msgstr ""
23972
23973 #. type: textblock
23974 #: ../fish/guestfish.pod:923
23975 msgid ""
23976 "Since the C<run> command produces no output on stdout, this is not useful "
23977 "anyway.  For further information see L<https://bugzilla.redhat.com/show_bug."
23978 "cgi?id=592910>."
23979 msgstr ""
23980
23981 # type: =head1
23982 #. type: =head1
23983 #: ../fish/guestfish.pod:927
23984 msgid "PREPARED DISK IMAGES"
23985 msgstr ""
23986
23987 # type: textblock
23988 #. type: textblock
23989 #: ../fish/guestfish.pod:929
23990 msgid ""
23991 "Use the I<-N type> or I<--new type> parameter to select one of a set of "
23992 "preformatted disk images that guestfish can make for you to save typing.  "
23993 "This is particularly useful for testing purposes.  This option is used "
23994 "instead of the I<-a> option, and like I<-a> can appear multiple times (and "
23995 "can be mixed with I<-a>)."
23996 msgstr ""
23997
23998 # type: textblock
23999 #. type: textblock
24000 #: ../fish/guestfish.pod:935
24001 msgid ""
24002 "The new disk is called C<test1.img> for the first I<-N>, C<test2.img> for "
24003 "the second and so on.  Existing files in the current directory are "
24004 "I<overwritten>."
24005 msgstr ""
24006
24007 # type: textblock
24008 #. type: textblock
24009 #: ../fish/guestfish.pod:939
24010 msgid ""
24011 "The type briefly describes how the disk should be sized, partitioned, how "
24012 "filesystem(s) should be created, and how content should be added.  "
24013 "Optionally the type can be followed by extra parameters, separated by C<:> "
24014 "(colon) characters.  For example, I<-N fs> creates a default 100MB, sparsely-"
24015 "allocated disk, containing a single partition, with the partition formatted "
24016 "as ext2.  I<-N fs:ext4:1G> is the same, but for an ext4 filesystem on a 1GB "
24017 "disk instead."
24018 msgstr ""
24019
24020 # type: textblock
24021 #. type: textblock
24022 #: ../fish/guestfish.pod:947
24023 msgid "To list the available types and any extra parameters they take, run:"
24024 msgstr ""
24025
24026 # type: textblock
24027 #. type: textblock
24028 #: ../fish/guestfish.pod:951
24029 msgid ""
24030 "Note that the prepared filesystem is not mounted.  You would usually have to "
24031 "use the C<mount /dev/sda1 /> command or add the I<-m /dev/sda1> option."
24032 msgstr ""
24033
24034 # type: textblock
24035 #. type: textblock
24036 #: ../fish/guestfish.pod:955
24037 msgid ""
24038 "If any I<-N> or I<--new> options are given, the guest is automatically "
24039 "launched."
24040 msgstr ""
24041
24042 # type: textblock
24043 #. type: textblock
24044 #: ../fish/guestfish.pod:960
24045 msgid "Create a 100MB disk with an ext4-formatted partition:"
24046 msgstr ""
24047
24048 # type: verbatim
24049 #. type: verbatim
24050 #: ../fish/guestfish.pod:962
24051 #, no-wrap
24052 msgid ""
24053 " guestfish -N fs:ext4\n"
24054 "\n"
24055 msgstr ""
24056
24057 # type: textblock
24058 #. type: textblock
24059 #: ../fish/guestfish.pod:964
24060 msgid "Create a 32MB disk with a VFAT-formatted partition, and mount it:"
24061 msgstr ""
24062
24063 # type: verbatim
24064 #. type: verbatim
24065 #: ../fish/guestfish.pod:966
24066 #, no-wrap
24067 msgid ""
24068 " guestfish -N fs:vfat:32M -m /dev/sda1\n"
24069 "\n"
24070 msgstr ""
24071
24072 # type: textblock
24073 #. type: textblock
24074 #: ../fish/guestfish.pod:968
24075 msgid "Create a blank 200MB disk:"
24076 msgstr ""
24077
24078 # type: verbatim
24079 #. type: verbatim
24080 #: ../fish/guestfish.pod:970
24081 #, no-wrap
24082 msgid ""
24083 " guestfish -N disk:200M\n"
24084 "\n"
24085 msgstr ""
24086
24087 # type: =head1
24088 #. type: =head1
24089 #: ../fish/guestfish.pod:972
24090 msgid "PROGRESS BARS"
24091 msgstr ""
24092
24093 # type: textblock
24094 #. type: textblock
24095 #: ../fish/guestfish.pod:974
24096 msgid ""
24097 "Some (not all) long-running commands send progress notification messages as "
24098 "they are running.  Guestfish turns these messages into progress bars."
24099 msgstr ""
24100
24101 # type: textblock
24102 #. type: textblock
24103 #: ../fish/guestfish.pod:978
24104 msgid ""
24105 "When a command that supports progress bars takes longer than two seconds to "
24106 "run, and if progress bars are enabled, then you will see one appearing below "
24107 "the command:"
24108 msgstr ""
24109
24110 # type: verbatim
24111 #. type: verbatim
24112 #: ../fish/guestfish.pod:982
24113 #, no-wrap
24114 msgid ""
24115 " ><fs> copy-size /large-file /another-file 2048M\n"
24116 " / 10% [#####-----------------------------------------] 00:30\n"
24117 "\n"
24118 msgstr ""
24119
24120 # type: textblock
24121 #. type: textblock
24122 #: ../fish/guestfish.pod:985
24123 msgid ""
24124 "The spinner on the left hand side moves round once for every progress "
24125 "notification received from the backend.  This is a (reasonably) golden "
24126 "assurance that the command is \"doing something\" even if the progress bar "
24127 "is not moving, because the command is able to send the progress "
24128 "notifications.  When the bar reaches 100% and the command finishes, the "
24129 "spinner disappears."
24130 msgstr ""
24131
24132 # type: textblock
24133 #. type: textblock
24134 #: ../fish/guestfish.pod:992
24135 msgid ""
24136 "Progress bars are enabled by default when guestfish is used interactively.  "
24137 "You can enable them even for non-interactive modes using I<--progress-bars>, "
24138 "and you can disable them completely using I<--no-progress-bars>."
24139 msgstr ""
24140
24141 # type: =head1
24142 #. type: =head1
24143 #: ../fish/guestfish.pod:997
24144 msgid "GUESTFISH COMMANDS"
24145 msgstr ""
24146
24147 # type: textblock
24148 #. type: textblock
24149 #: ../fish/guestfish.pod:999
24150 msgid ""
24151 "The commands in this section are guestfish convenience commands, in other "
24152 "words, they are not part of the L<guestfs(3)> API."
24153 msgstr ""
24154
24155 # type: =head2
24156 #. type: =head2
24157 #: ../fish/guestfish.pod:1002
24158 msgid "help"
24159 msgstr ""
24160
24161 # type: verbatim
24162 #. type: verbatim
24163 #: ../fish/guestfish.pod:1004
24164 #, no-wrap
24165 msgid ""
24166 " help\n"
24167 " help cmd\n"
24168 "\n"
24169 msgstr ""
24170
24171 # type: textblock
24172 #. type: textblock
24173 #: ../fish/guestfish.pod:1007
24174 msgid "Without any parameter, this provides general help."
24175 msgstr ""
24176
24177 # type: textblock
24178 #. type: textblock
24179 #: ../fish/guestfish.pod:1009
24180 msgid "With a C<cmd> parameter, this displays detailed help for that command."
24181 msgstr ""
24182
24183 # type: =head2
24184 #. type: =head2
24185 #: ../fish/guestfish.pod:1011
24186 msgid "quit | exit"
24187 msgstr ""
24188
24189 # type: textblock
24190 #. type: textblock
24191 #: ../fish/guestfish.pod:1013
24192 msgid "This exits guestfish.  You can also use C<^D> key."
24193 msgstr ""
24194
24195 # type: textblock
24196 #. type: textblock
24197 #: ../fish/guestfish.pod:1015
24198 msgid "@FISH_COMMANDS@"
24199 msgstr ""
24200
24201 # type: =head1
24202 #. type: =head1
24203 #: ../fish/guestfish.pod:1017
24204 msgid "COMMANDS"
24205 msgstr ""
24206
24207 # type: =head1
24208 #. type: =head1
24209 #: ../fish/guestfish.pod:1021 ../test-tool/libguestfs-test-tool.pod:77
24210 msgid "EXIT CODE"
24211 msgstr ""
24212
24213 # type: textblock
24214 #. type: textblock
24215 #: ../fish/guestfish.pod:1023
24216 msgid ""
24217 "guestfish returns 0 if the commands completed without error, or 1 if there "
24218 "was an error."
24219 msgstr ""
24220
24221 # type: =item
24222 #. type: =item
24223 #: ../fish/guestfish.pod:1030
24224 msgid "EDITOR"
24225 msgstr ""
24226
24227 # type: textblock
24228 #. type: textblock
24229 #: ../fish/guestfish.pod:1032
24230 msgid ""
24231 "The C<edit> command uses C<$EDITOR> as the editor.  If not set, it uses "
24232 "C<vi>."
24233 msgstr ""
24234
24235 # type: =item
24236 #. type: =item
24237 #: ../fish/guestfish.pod:1035
24238 msgid "GUESTFISH_PID"
24239 msgstr ""
24240
24241 # type: textblock
24242 #. type: textblock
24243 #: ../fish/guestfish.pod:1037
24244 msgid ""
24245 "Used with the I<--remote> option to specify the remote guestfish process to "
24246 "control.  See section L</REMOTE CONTROL GUESTFISH OVER A SOCKET>."
24247 msgstr ""
24248
24249 # type: =item
24250 #. type: =item
24251 #: ../fish/guestfish.pod:1041
24252 msgid "HEXEDITOR"
24253 msgstr ""
24254
24255 # type: textblock
24256 #. type: textblock
24257 #: ../fish/guestfish.pod:1043
24258 msgid ""
24259 "The L</hexedit> command uses C<$HEXEDITOR> as the external hex editor.  If "
24260 "not specified, the external L<hexedit(1)> program is used."
24261 msgstr ""
24262
24263 # type: =item
24264 #. type: =item
24265 #: ../fish/guestfish.pod:1047
24266 msgid "HOME"
24267 msgstr ""
24268
24269 # type: textblock
24270 #. type: textblock
24271 #: ../fish/guestfish.pod:1049
24272 msgid ""
24273 "If compiled with GNU readline support, various files in the home directory "
24274 "can be used.  See L</FILES>."
24275 msgstr ""
24276
24277 # type: textblock
24278 #. type: textblock
24279 #: ../fish/guestfish.pod:1058
24280 msgid ""
24281 "Set C<LIBGUESTFS_DEBUG=1> to enable verbose messages.  This has the same "
24282 "effect as using the B<-v> option."
24283 msgstr ""
24284
24285 # type: textblock
24286 #. type: textblock
24287 #: ../fish/guestfish.pod:1070
24288 msgid ""
24289 "Set the path that guestfish uses to search for kernel and initrd.img.  See "
24290 "the discussion of paths in L<guestfs(3)>."
24291 msgstr ""
24292
24293 # type: textblock
24294 #. type: textblock
24295 #: ../fish/guestfish.pod:1081
24296 msgid "Set C<LIBGUESTFS_TRACE=1> to enable command traces."
24297 msgstr ""
24298
24299 # type: =item
24300 #. type: =item
24301 #: ../fish/guestfish.pod:1083
24302 msgid "PAGER"
24303 msgstr ""
24304
24305 # type: textblock
24306 #. type: textblock
24307 #: ../fish/guestfish.pod:1085
24308 msgid ""
24309 "The C<more> command uses C<$PAGER> as the pager.  If not set, it uses "
24310 "C<more>."
24311 msgstr ""
24312
24313 # type: =head1
24314 #. type: =head1
24315 #: ../fish/guestfish.pod:1101 ../fuse/guestmount.pod:262
24316 msgid "FILES"
24317 msgstr ""
24318
24319 #. type: =item
24320 #: ../fish/guestfish.pod:1105 ../fuse/guestmount.pod:266
24321 msgid "$HOME/.libguestfs-tools.rc"
24322 msgstr ""
24323
24324 #. type: =item
24325 #: ../fish/guestfish.pod:1107 ../fuse/guestmount.pod:268
24326 msgid "/etc/libguestfs-tools.conf"
24327 msgstr ""
24328
24329 #. type: textblock
24330 #: ../fish/guestfish.pod:1109 ../fuse/guestmount.pod:270
24331 msgid ""
24332 "This configuration file controls the default read-only or read-write mode "
24333 "(I<--ro> or I<--rw>)."
24334 msgstr ""
24335
24336 #. type: textblock
24337 #: ../fish/guestfish.pod:1112
24338 msgid "See L</OPENING DISKS FOR READ AND WRITE>."
24339 msgstr ""
24340
24341 # type: =item
24342 #. type: =item
24343 #: ../fish/guestfish.pod:1114
24344 msgid "$HOME/.guestfish"
24345 msgstr ""
24346
24347 # type: textblock
24348 #. type: textblock
24349 #: ../fish/guestfish.pod:1116
24350 msgid ""
24351 "If compiled with GNU readline support, then the command history is saved in "
24352 "this file."
24353 msgstr ""
24354
24355 # type: =item
24356 #. type: =item
24357 #: ../fish/guestfish.pod:1119
24358 msgid "$HOME/.inputrc"
24359 msgstr ""
24360
24361 # type: =item
24362 #. type: =item
24363 #: ../fish/guestfish.pod:1121
24364 msgid "/etc/inputrc"
24365 msgstr ""
24366
24367 # type: textblock
24368 #. type: textblock
24369 #: ../fish/guestfish.pod:1123
24370 msgid ""
24371 "If compiled with GNU readline support, then these files can be used to "
24372 "configure readline.  For further information, please see L<readline(3)/"
24373 "INITIALIZATION FILE>."
24374 msgstr ""
24375
24376 # type: textblock
24377 #. type: textblock
24378 #: ../fish/guestfish.pod:1127
24379 msgid "To write rules which only apply to guestfish, use:"
24380 msgstr ""
24381
24382 # type: verbatim
24383 #. type: verbatim
24384 #: ../fish/guestfish.pod:1129
24385 #, no-wrap
24386 msgid ""
24387 " $if guestfish\n"
24388 " ...\n"
24389 " $endif\n"
24390 "\n"
24391 msgstr ""
24392
24393 # type: textblock
24394 #. type: textblock
24395 #: ../fish/guestfish.pod:1133
24396 msgid ""
24397 "Variables that you can set in inputrc that change the behaviour of guestfish "
24398 "in useful ways include:"
24399 msgstr ""
24400
24401 # type: =item
24402 #. type: =item
24403 #: ../fish/guestfish.pod:1138
24404 msgid "completion-ignore-case (default: on)"
24405 msgstr ""
24406
24407 # type: textblock
24408 #. type: textblock
24409 #: ../fish/guestfish.pod:1140
24410 msgid ""
24411 "By default, guestfish will ignore case when tab-completing paths on the "
24412 "disk.  Use:"
24413 msgstr ""
24414
24415 # type: verbatim
24416 #. type: verbatim
24417 #: ../fish/guestfish.pod:1143
24418 #, no-wrap
24419 msgid ""
24420 " set completion-ignore-case off\n"
24421 "\n"
24422 msgstr ""
24423
24424 # type: textblock
24425 #. type: textblock
24426 #: ../fish/guestfish.pod:1145
24427 msgid "to make guestfish case sensitive."
24428 msgstr ""
24429
24430 # type: =item
24431 #. type: =item
24432 #: ../fish/guestfish.pod:1149
24433 msgid "test1.img"
24434 msgstr ""
24435
24436 # type: =item
24437 #. type: =item
24438 #: ../fish/guestfish.pod:1151
24439 msgid "test2.img (etc)"
24440 msgstr ""
24441
24442 #. type: textblock
24443 #: ../fish/guestfish.pod:1153
24444 msgid ""
24445 "When using the I<-N> or I<--new> option, the prepared disk or filesystem "
24446 "will be created in the file C<test1.img> in the current directory.  The "
24447 "second use of I<-N> will use C<test2.img> and so on.  Any existing file with "
24448 "the same name will be overwritten."
24449 msgstr ""
24450
24451 #. type: textblock
24452 #: ../fish/guestfish.pod:1162
24453 msgid ""
24454 "L<guestfs(3)>, L<http://libguestfs.org/>, L<virt-cat(1)>, L<virt-copy-in(1)"
24455 ">, L<virt-copy-out(1)>, L<virt-df(1)>, L<virt-edit(1)>, L<virt-filesystems(1)"
24456 ">, L<virt-inspector(1)>, L<virt-list-filesystems(1)>, L<virt-list-partitions"
24457 "(1)>, L<virt-ls(1)>, L<virt-make-fs(1)>, L<virt-rescue(1)>, L<virt-resize(1)"
24458 ">, L<virt-tar(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>, L<virt-win-reg(1)"
24459 ">, L<hexedit(1)>."
24460 msgstr ""
24461
24462 # type: textblock
24463 #. type: textblock
24464 #: ../fish/guestfish.pod:1192 ../test-tool/libguestfs-test-tool.pod:102
24465 #: ../fuse/guestmount.pod:297 ../tools/virt-edit.pl:518
24466 #: ../tools/virt-win-reg.pl:606 ../tools/virt-list-filesystems.pl:210
24467 #: ../tools/virt-tar.pl:309 ../tools/virt-make-fs.pl:572
24468 #: ../tools/virt-list-partitions.pl:277
24469 msgid ""
24470 "This program is free software; you can redistribute it and/or modify it "
24471 "under the terms of the GNU General Public License as published by the Free "
24472 "Software Foundation; either version 2 of the License, or (at your option) "
24473 "any later version."
24474 msgstr ""
24475
24476 # type: textblock
24477 #. type: textblock
24478 #: ../fish/guestfish.pod:1197 ../test-tool/libguestfs-test-tool.pod:107
24479 #: ../fuse/guestmount.pod:302 ../tools/virt-edit.pl:523
24480 #: ../tools/virt-win-reg.pl:611 ../tools/virt-list-filesystems.pl:215
24481 #: ../tools/virt-tar.pl:314 ../tools/virt-make-fs.pl:577
24482 #: ../tools/virt-list-partitions.pl:282
24483 msgid ""
24484 "This program is distributed in the hope that it will be useful, but WITHOUT "
24485 "ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or "
24486 "FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for "
24487 "more details."
24488 msgstr ""
24489
24490 # type: textblock
24491 #. type: textblock
24492 #: ../fish/guestfish.pod:1202 ../test-tool/libguestfs-test-tool.pod:112
24493 #: ../fuse/guestmount.pod:307 ../tools/virt-edit.pl:528
24494 #: ../tools/virt-win-reg.pl:616 ../tools/virt-list-filesystems.pl:220
24495 #: ../tools/virt-tar.pl:319 ../tools/virt-make-fs.pl:582
24496 #: ../tools/virt-list-partitions.pl:287
24497 msgid ""
24498 "You should have received a copy of the GNU General Public License along with "
24499 "this program; if not, write to the Free Software Foundation, Inc., 675 Mass "
24500 "Ave, Cambridge, MA 02139, USA."
24501 msgstr ""
24502
24503 # type: =head2
24504 #. type: =head2
24505 #: ../fish/guestfish-actions.pod:1
24506 msgid "add-cdrom"
24507 msgstr ""
24508
24509 # type: verbatim
24510 #. type: verbatim
24511 #: ../fish/guestfish-actions.pod:3
24512 #, no-wrap
24513 msgid ""
24514 " add-cdrom filename\n"
24515 "\n"
24516 msgstr ""
24517
24518 # type: textblock
24519 #. type: textblock
24520 #: ../fish/guestfish-actions.pod:15
24521 msgid ""
24522 "This call checks for the existence of C<filename>.  This stops you from "
24523 "specifying other types of drive which are supported by qemu such as C<nbd:> "
24524 "and C<http:> URLs.  To specify those, use the general L</config> call "
24525 "instead."
24526 msgstr ""
24527
24528 # type: textblock
24529 #. type: textblock
24530 #: ../fish/guestfish-actions.pod:22
24531 msgid ""
24532 "If you just want to add an ISO file (often you use this as an efficient way "
24533 "to transfer large files into the guest), then you should probably use L</add-"
24534 "drive-ro> instead."
24535 msgstr ""
24536
24537 #. type: textblock
24538 #: ../fish/guestfish-actions.pod:28 ../fish/guestfish-actions.pod:158
24539 #: ../fish/guestfish-actions.pod:172
24540 msgid ""
24541 "This function is deprecated.  In new code, use the L</add_drive_opts> call "
24542 "instead."
24543 msgstr ""
24544
24545 # type: =head2
24546 #. type: =head2
24547 #: ../fish/guestfish-actions.pod:35
24548 msgid "add-domain"
24549 msgstr ""
24550
24551 # type: =head2
24552 #. type: =head2
24553 #: ../fish/guestfish-actions.pod:37
24554 msgid "domain"
24555 msgstr ""
24556
24557 #. type: verbatim
24558 #: ../fish/guestfish-actions.pod:39
24559 #, no-wrap
24560 msgid ""
24561 " add-domain dom [libvirturi:..] [readonly:..] [iface:..] [live:..]\n"
24562 "\n"
24563 msgstr ""
24564
24565 # type: textblock
24566 #. type: textblock
24567 #: ../fish/guestfish-actions.pod:41
24568 msgid ""
24569 "This function adds the disk(s) attached to the named libvirt domain C<dom>.  "
24570 "It works by connecting to libvirt, requesting the domain and domain XML from "
24571 "libvirt, parsing it for disks, and calling L</add-drive-opts> on each one."
24572 msgstr ""
24573
24574 # type: textblock
24575 #. type: textblock
24576 #: ../fish/guestfish-actions.pod:71
24577 msgid ""
24578 "The other optional parameters are passed directly through to L</add-drive-"
24579 "opts>."
24580 msgstr ""
24581
24582 # type: textblock
24583 #. type: textblock
24584 #: ../fish/guestfish-actions.pod:74 ../fish/guestfish-actions.pod:138
24585 #: ../fish/guestfish-actions.pod:3071
24586 msgid ""
24587 "This command has one or more optional arguments.  See L</OPTIONAL ARGUMENTS>."
24588 msgstr ""
24589
24590 # type: =head2
24591 #. type: =head2
24592 #: ../fish/guestfish-actions.pod:76
24593 msgid "add-drive"
24594 msgstr ""
24595
24596 # type: verbatim
24597 #. type: verbatim
24598 #: ../fish/guestfish-actions.pod:78
24599 #, no-wrap
24600 msgid ""
24601 " add-drive filename\n"
24602 "\n"
24603 msgstr ""
24604
24605 # type: textblock
24606 #. type: textblock
24607 #: ../fish/guestfish-actions.pod:80
24608 msgid ""
24609 "This function is the equivalent of calling L</add-drive-opts> with no "
24610 "optional parameters, so the disk is added writable, with the format being "
24611 "detected automatically."
24612 msgstr ""
24613
24614 # type: textblock
24615 #. type: textblock
24616 #: ../fish/guestfish-actions.pod:84
24617 msgid ""
24618 "Automatic detection of the format opens you up to a potential security hole "
24619 "when dealing with untrusted raw-format images.  See CVE-2010-3851 and "
24620 "RHBZ#642934.  Specifying the format closes this security hole.  Therefore "
24621 "you should think about replacing calls to this function with calls to L</add-"
24622 "drive-opts>, and specifying the format."
24623 msgstr ""
24624
24625 # type: =head2
24626 #. type: =head2
24627 #: ../fish/guestfish-actions.pod:91
24628 msgid "add-drive-opts"
24629 msgstr ""
24630
24631 # type: =head2
24632 #. type: =head2
24633 #: ../fish/guestfish-actions.pod:93
24634 msgid "add"
24635 msgstr ""
24636
24637 # type: verbatim
24638 #. type: verbatim
24639 #: ../fish/guestfish-actions.pod:95
24640 #, no-wrap
24641 msgid ""
24642 " add-drive-opts filename [readonly:..] [format:..] [iface:..]\n"
24643 "\n"
24644 msgstr ""
24645
24646 # type: textblock
24647 #. type: textblock
24648 #: ../fish/guestfish-actions.pod:122
24649 msgid ""
24650 "This forces the image format.  If you omit this (or use L</add-drive> or L</"
24651 "add-drive-ro>) then the format is automatically detected.  Possible formats "
24652 "include C<raw> and C<qcow2>."
24653 msgstr ""
24654
24655 # type: textblock
24656 #. type: textblock
24657 #: ../fish/guestfish-actions.pod:133
24658 msgid ""
24659 "This rarely-used option lets you emulate the behaviour of the deprecated L</"
24660 "add-drive-with-if> call (q.v.)"
24661 msgstr ""
24662
24663 # type: =head2
24664 #. type: =head2
24665 #: ../fish/guestfish-actions.pod:140
24666 msgid "add-drive-ro"
24667 msgstr ""
24668
24669 # type: =head2
24670 #. type: =head2
24671 #: ../fish/guestfish-actions.pod:142
24672 msgid "add-ro"
24673 msgstr ""
24674
24675 # type: verbatim
24676 #. type: verbatim
24677 #: ../fish/guestfish-actions.pod:144
24678 #, no-wrap
24679 msgid ""
24680 " add-drive-ro filename\n"
24681 "\n"
24682 msgstr ""
24683
24684 # type: textblock
24685 #. type: textblock
24686 #: ../fish/guestfish-actions.pod:146
24687 msgid ""
24688 "This function is the equivalent of calling L</add-drive-opts> with the "
24689 "optional parameter C<GUESTFS_ADD_DRIVE_OPTS_READONLY> set to 1, so the disk "
24690 "is added read-only, with the format being detected automatically."
24691 msgstr ""
24692
24693 # type: =head2
24694 #. type: =head2
24695 #: ../fish/guestfish-actions.pod:151
24696 msgid "add-drive-ro-with-if"
24697 msgstr ""
24698
24699 # type: verbatim
24700 #. type: verbatim
24701 #: ../fish/guestfish-actions.pod:153
24702 #, no-wrap
24703 msgid ""
24704 " add-drive-ro-with-if filename iface\n"
24705 "\n"
24706 msgstr ""
24707
24708 # type: textblock
24709 #. type: textblock
24710 #: ../fish/guestfish-actions.pod:155
24711 msgid ""
24712 "This is the same as L</add-drive-ro> but it allows you to specify the QEMU "
24713 "interface emulation to use at run time."
24714 msgstr ""
24715
24716 # type: =head2
24717 #. type: =head2
24718 #: ../fish/guestfish-actions.pod:165
24719 msgid "add-drive-with-if"
24720 msgstr ""
24721
24722 # type: verbatim
24723 #. type: verbatim
24724 #: ../fish/guestfish-actions.pod:167
24725 #, no-wrap
24726 msgid ""
24727 " add-drive-with-if filename iface\n"
24728 "\n"
24729 msgstr ""
24730
24731 # type: textblock
24732 #. type: textblock
24733 #: ../fish/guestfish-actions.pod:169
24734 msgid ""
24735 "This is the same as L</add-drive> but it allows you to specify the QEMU "
24736 "interface emulation to use at run time."
24737 msgstr ""
24738
24739 # type: =head2
24740 #. type: =head2
24741 #: ../fish/guestfish-actions.pod:179
24742 msgid "aug-clear"
24743 msgstr ""
24744
24745 # type: verbatim
24746 #. type: verbatim
24747 #: ../fish/guestfish-actions.pod:181
24748 #, no-wrap
24749 msgid ""
24750 " aug-clear augpath\n"
24751 "\n"
24752 msgstr ""
24753
24754 # type: =head2
24755 #. type: =head2
24756 #: ../fish/guestfish-actions.pod:186
24757 msgid "aug-close"
24758 msgstr ""
24759
24760 # type: verbatim
24761 #. type: verbatim
24762 #: ../fish/guestfish-actions.pod:188
24763 #, no-wrap
24764 msgid ""
24765 " aug-close\n"
24766 "\n"
24767 msgstr ""
24768
24769 # type: textblock
24770 #. type: textblock
24771 #: ../fish/guestfish-actions.pod:190
24772 msgid ""
24773 "Close the current Augeas handle and free up any resources used by it.  After "
24774 "calling this, you have to call L</aug-init> again before you can use any "
24775 "other Augeas functions."
24776 msgstr ""
24777
24778 # type: =head2
24779 #. type: =head2
24780 #: ../fish/guestfish-actions.pod:195
24781 msgid "aug-defnode"
24782 msgstr ""
24783
24784 # type: verbatim
24785 #. type: verbatim
24786 #: ../fish/guestfish-actions.pod:197
24787 #, no-wrap
24788 msgid ""
24789 " aug-defnode name expr val\n"
24790 "\n"
24791 msgstr ""
24792
24793 # type: textblock
24794 #. type: textblock
24795 #: ../fish/guestfish-actions.pod:202
24796 msgid ""
24797 "If C<expr> evaluates to an empty nodeset, a node is created, equivalent to "
24798 "calling L</aug-set> C<expr>, C<value>.  C<name> will be the nodeset "
24799 "containing that single node."
24800 msgstr ""
24801
24802 # type: =head2
24803 #. type: =head2
24804 #: ../fish/guestfish-actions.pod:210
24805 msgid "aug-defvar"
24806 msgstr ""
24807
24808 # type: verbatim
24809 #. type: verbatim
24810 #: ../fish/guestfish-actions.pod:212
24811 #, no-wrap
24812 msgid ""
24813 " aug-defvar name expr\n"
24814 "\n"
24815 msgstr ""
24816
24817 # type: =head2
24818 #. type: =head2
24819 #: ../fish/guestfish-actions.pod:221
24820 msgid "aug-get"
24821 msgstr ""
24822
24823 # type: verbatim
24824 #. type: verbatim
24825 #: ../fish/guestfish-actions.pod:223
24826 #, no-wrap
24827 msgid ""
24828 " aug-get augpath\n"
24829 "\n"
24830 msgstr ""
24831
24832 # type: =head2
24833 #. type: =head2
24834 #: ../fish/guestfish-actions.pod:228
24835 msgid "aug-init"
24836 msgstr ""
24837
24838 # type: verbatim
24839 #. type: verbatim
24840 #: ../fish/guestfish-actions.pod:230
24841 #, no-wrap
24842 msgid ""
24843 " aug-init root flags\n"
24844 "\n"
24845 msgstr ""
24846
24847 # type: textblock
24848 #. type: textblock
24849 #: ../fish/guestfish-actions.pod:236
24850 msgid "You must call this before using any other L</aug-*> commands."
24851 msgstr ""
24852
24853 #. type: textblock
24854 #: ../fish/guestfish-actions.pod:261
24855 msgid ""
24856 "This option is only useful when debugging Augeas lenses.  Use of this option "
24857 "may require additional memory for the libguestfs appliance.  You may need to "
24858 "set the C<LIBGUESTFS_MEMSIZE> environment variable or call L</set-memsize>."
24859 msgstr ""
24860
24861 # type: textblock
24862 #. type: textblock
24863 #: ../fish/guestfish-actions.pod:276
24864 msgid "Do not load the tree in L</aug-init>."
24865 msgstr ""
24866
24867 # type: textblock
24868 #. type: textblock
24869 #: ../fish/guestfish-actions.pod:280
24870 msgid "To close the handle, you can call L</aug-close>."
24871 msgstr ""
24872
24873 # type: =head2
24874 #. type: =head2
24875 #: ../fish/guestfish-actions.pod:284
24876 msgid "aug-insert"
24877 msgstr ""
24878
24879 # type: verbatim
24880 #. type: verbatim
24881 #: ../fish/guestfish-actions.pod:286
24882 #, no-wrap
24883 msgid ""
24884 " aug-insert augpath label true|false\n"
24885 "\n"
24886 msgstr ""
24887
24888 # type: =head2
24889 #. type: =head2
24890 #: ../fish/guestfish-actions.pod:296
24891 msgid "aug-load"
24892 msgstr ""
24893
24894 # type: verbatim
24895 #. type: verbatim
24896 #: ../fish/guestfish-actions.pod:298
24897 #, no-wrap
24898 msgid ""
24899 " aug-load\n"
24900 "\n"
24901 msgstr ""
24902
24903 # type: =head2
24904 #. type: =head2
24905 #: ../fish/guestfish-actions.pod:305
24906 msgid "aug-ls"
24907 msgstr ""
24908
24909 # type: verbatim
24910 #. type: verbatim
24911 #: ../fish/guestfish-actions.pod:307
24912 #, no-wrap
24913 msgid ""
24914 " aug-ls augpath\n"
24915 "\n"
24916 msgstr ""
24917
24918 # type: textblock
24919 #. type: textblock
24920 #: ../fish/guestfish-actions.pod:309
24921 msgid ""
24922 "This is just a shortcut for listing L</aug-match> C<path/*> and sorting the "
24923 "resulting nodes into alphabetical order."
24924 msgstr ""
24925
24926 # type: =head2
24927 #. type: =head2
24928 #: ../fish/guestfish-actions.pod:312
24929 msgid "aug-match"
24930 msgstr ""
24931
24932 # type: verbatim
24933 #. type: verbatim
24934 #: ../fish/guestfish-actions.pod:314
24935 #, no-wrap
24936 msgid ""
24937 " aug-match augpath\n"
24938 "\n"
24939 msgstr ""
24940
24941 # type: =head2
24942 #. type: =head2
24943 #: ../fish/guestfish-actions.pod:320
24944 msgid "aug-mv"
24945 msgstr ""
24946
24947 # type: verbatim
24948 #. type: verbatim
24949 #: ../fish/guestfish-actions.pod:322
24950 #, no-wrap
24951 msgid ""
24952 " aug-mv src dest\n"
24953 "\n"
24954 msgstr ""
24955
24956 # type: =head2
24957 #. type: =head2
24958 #: ../fish/guestfish-actions.pod:327
24959 msgid "aug-rm"
24960 msgstr ""
24961
24962 # type: verbatim
24963 #. type: verbatim
24964 #: ../fish/guestfish-actions.pod:329
24965 #, no-wrap
24966 msgid ""
24967 " aug-rm augpath\n"
24968 "\n"
24969 msgstr ""
24970
24971 # type: =head2
24972 #. type: =head2
24973 #: ../fish/guestfish-actions.pod:335
24974 msgid "aug-save"
24975 msgstr ""
24976
24977 # type: verbatim
24978 #. type: verbatim
24979 #: ../fish/guestfish-actions.pod:337
24980 #, no-wrap
24981 msgid ""
24982 " aug-save\n"
24983 "\n"
24984 msgstr ""
24985
24986 # type: textblock
24987 #. type: textblock
24988 #: ../fish/guestfish-actions.pod:341
24989 msgid ""
24990 "The flags which were passed to L</aug-init> affect exactly how files are "
24991 "saved."
24992 msgstr ""
24993
24994 # type: =head2
24995 #. type: =head2
24996 #: ../fish/guestfish-actions.pod:344
24997 msgid "aug-set"
24998 msgstr ""
24999
25000 # type: verbatim
25001 #. type: verbatim
25002 #: ../fish/guestfish-actions.pod:346
25003 #, no-wrap
25004 msgid ""
25005 " aug-set augpath val\n"
25006 "\n"
25007 msgstr ""
25008
25009 # type: textblock
25010 #. type: textblock
25011 #: ../fish/guestfish-actions.pod:350
25012 msgid ""
25013 "In the Augeas API, it is possible to clear a node by setting the value to "
25014 "NULL.  Due to an oversight in the libguestfs API you cannot do that with "
25015 "this call.  Instead you must use the L</aug-clear> call."
25016 msgstr ""
25017
25018 # type: =head2
25019 #. type: =head2
25020 #: ../fish/guestfish-actions.pod:355
25021 msgid "available"
25022 msgstr ""
25023
25024 # type: verbatim
25025 #. type: verbatim
25026 #: ../fish/guestfish-actions.pod:357
25027 #, no-wrap
25028 msgid ""
25029 " available 'groups ...'\n"
25030 "\n"
25031 msgstr ""
25032
25033 # type: textblock
25034 #. type: textblock
25035 #: ../fish/guestfish-actions.pod:363
25036 msgid ""
25037 "The libguestfs groups, and the functions that those groups correspond to, "
25038 "are listed in L<guestfs(3)/AVAILABILITY>.  You can also fetch this list at "
25039 "runtime by calling L</available-all-groups>."
25040 msgstr ""
25041
25042 # type: textblock
25043 #. type: textblock
25044 #: ../fish/guestfish-actions.pod:387
25045 msgid "You must call L</launch> before calling this function."
25046 msgstr ""
25047
25048 # type: textblock
25049 #. type: textblock
25050 #: ../fish/guestfish-actions.pod:409
25051 msgid ""
25052 "This call was added in version C<1.0.80>.  In previous versions of "
25053 "libguestfs all you could do would be to speculatively execute a command to "
25054 "find out if the daemon implemented it.  See also L</version>."
25055 msgstr ""
25056
25057 # type: =head2
25058 #. type: =head2
25059 #: ../fish/guestfish-actions.pod:416
25060 msgid "available-all-groups"
25061 msgstr ""
25062
25063 # type: verbatim
25064 #. type: verbatim
25065 #: ../fish/guestfish-actions.pod:418
25066 #, no-wrap
25067 msgid ""
25068 " available-all-groups\n"
25069 "\n"
25070 msgstr ""
25071
25072 # type: textblock
25073 #. type: textblock
25074 #: ../fish/guestfish-actions.pod:420
25075 msgid ""
25076 "This command returns a list of all optional groups that this daemon knows "
25077 "about.  Note this returns both supported and unsupported groups.  To find "
25078 "out which ones the daemon can actually support you have to call L</"
25079 "available> on each member of the returned list."
25080 msgstr ""
25081
25082 # type: textblock
25083 #. type: textblock
25084 #: ../fish/guestfish-actions.pod:426
25085 msgid "See also L</available> and L<guestfs(3)/AVAILABILITY>."
25086 msgstr ""
25087
25088 # type: =head2
25089 #. type: =head2
25090 #: ../fish/guestfish-actions.pod:428
25091 msgid "base64-in"
25092 msgstr ""
25093
25094 # type: verbatim
25095 #. type: verbatim
25096 #: ../fish/guestfish-actions.pod:430
25097 #, no-wrap
25098 msgid ""
25099 " base64-in (base64file|-) filename\n"
25100 "\n"
25101 msgstr ""
25102
25103 # type: textblock
25104 #. type: textblock
25105 #: ../fish/guestfish-actions.pod:435 ../fish/guestfish-actions.pod:444
25106 #: ../fish/guestfish-actions.pod:668 ../fish/guestfish-actions.pod:837
25107 #: ../fish/guestfish-actions.pod:856 ../fish/guestfish-actions.pod:1230
25108 #: ../fish/guestfish-actions.pod:4513 ../fish/guestfish-actions.pod:4525
25109 #: ../fish/guestfish-actions.pod:4536 ../fish/guestfish-actions.pod:4547
25110 #: ../fish/guestfish-actions.pod:4599 ../fish/guestfish-actions.pod:4608
25111 #: ../fish/guestfish-actions.pod:4662 ../fish/guestfish-actions.pod:4685
25112 msgid "Use C<-> instead of a filename to read/write from stdin/stdout."
25113 msgstr ""
25114
25115 # type: =head2
25116 #. type: =head2
25117 #: ../fish/guestfish-actions.pod:437
25118 msgid "base64-out"
25119 msgstr ""
25120
25121 # type: verbatim
25122 #. type: verbatim
25123 #: ../fish/guestfish-actions.pod:439
25124 #, no-wrap
25125 msgid ""
25126 " base64-out filename (base64file|-)\n"
25127 "\n"
25128 msgstr ""
25129
25130 # type: =head2
25131 #. type: =head2
25132 #: ../fish/guestfish-actions.pod:446
25133 msgid "blockdev-flushbufs"
25134 msgstr ""
25135
25136 # type: verbatim
25137 #. type: verbatim
25138 #: ../fish/guestfish-actions.pod:448
25139 #, no-wrap
25140 msgid ""
25141 " blockdev-flushbufs device\n"
25142 "\n"
25143 msgstr ""
25144
25145 # type: =head2
25146 #. type: =head2
25147 #: ../fish/guestfish-actions.pod:455
25148 msgid "blockdev-getbsz"
25149 msgstr ""
25150
25151 # type: verbatim
25152 #. type: verbatim
25153 #: ../fish/guestfish-actions.pod:457
25154 #, no-wrap
25155 msgid ""
25156 " blockdev-getbsz device\n"
25157 "\n"
25158 msgstr ""
25159
25160 # type: =head2
25161 #. type: =head2
25162 #: ../fish/guestfish-actions.pod:466
25163 msgid "blockdev-getro"
25164 msgstr ""
25165
25166 # type: verbatim
25167 #. type: verbatim
25168 #: ../fish/guestfish-actions.pod:468
25169 #, no-wrap
25170 msgid ""
25171 " blockdev-getro device\n"
25172 "\n"
25173 msgstr ""
25174
25175 # type: =head2
25176 #. type: =head2
25177 #: ../fish/guestfish-actions.pod:475
25178 msgid "blockdev-getsize64"
25179 msgstr ""
25180
25181 # type: verbatim
25182 #. type: verbatim
25183 #: ../fish/guestfish-actions.pod:477
25184 #, no-wrap
25185 msgid ""
25186 " blockdev-getsize64 device\n"
25187 "\n"
25188 msgstr ""
25189
25190 # type: textblock
25191 #. type: textblock
25192 #: ../fish/guestfish-actions.pod:481
25193 msgid "See also L</blockdev-getsz>."
25194 msgstr ""
25195
25196 # type: =head2
25197 #. type: =head2
25198 #: ../fish/guestfish-actions.pod:485
25199 msgid "blockdev-getss"
25200 msgstr ""
25201
25202 # type: verbatim
25203 #. type: verbatim
25204 #: ../fish/guestfish-actions.pod:487
25205 #, no-wrap
25206 msgid ""
25207 " blockdev-getss device\n"
25208 "\n"
25209 msgstr ""
25210
25211 # type: textblock
25212 #. type: textblock
25213 #: ../fish/guestfish-actions.pod:492
25214 msgid ""
25215 "(Note, this is not the size in sectors, use L</blockdev-getsz> for that)."
25216 msgstr ""
25217
25218 # type: =head2
25219 #. type: =head2
25220 #: ../fish/guestfish-actions.pod:497
25221 msgid "blockdev-getsz"
25222 msgstr ""
25223
25224 # type: verbatim
25225 #. type: verbatim
25226 #: ../fish/guestfish-actions.pod:499
25227 #, no-wrap
25228 msgid ""
25229 " blockdev-getsz device\n"
25230 "\n"
25231 msgstr ""
25232
25233 # type: textblock
25234 #. type: textblock
25235 #: ../fish/guestfish-actions.pod:504
25236 msgid ""
25237 "See also L</blockdev-getss> for the real sector size of the device, and L</"
25238 "blockdev-getsize64> for the more useful I<size in bytes>."
25239 msgstr ""
25240
25241 # type: =head2
25242 #. type: =head2
25243 #: ../fish/guestfish-actions.pod:510
25244 msgid "blockdev-rereadpt"
25245 msgstr ""
25246
25247 # type: verbatim
25248 #. type: verbatim
25249 #: ../fish/guestfish-actions.pod:512
25250 #, no-wrap
25251 msgid ""
25252 " blockdev-rereadpt device\n"
25253 "\n"
25254 msgstr ""
25255
25256 # type: =head2
25257 #. type: =head2
25258 #: ../fish/guestfish-actions.pod:518
25259 msgid "blockdev-setbsz"
25260 msgstr ""
25261
25262 # type: verbatim
25263 #. type: verbatim
25264 #: ../fish/guestfish-actions.pod:520
25265 #, no-wrap
25266 msgid ""
25267 " blockdev-setbsz device blocksize\n"
25268 "\n"
25269 msgstr ""
25270
25271 # type: =head2
25272 #. type: =head2
25273 #: ../fish/guestfish-actions.pod:529
25274 msgid "blockdev-setro"
25275 msgstr ""
25276
25277 # type: verbatim
25278 #. type: verbatim
25279 #: ../fish/guestfish-actions.pod:531
25280 #, no-wrap
25281 msgid ""
25282 " blockdev-setro device\n"
25283 "\n"
25284 msgstr ""
25285
25286 # type: =head2
25287 #. type: =head2
25288 #: ../fish/guestfish-actions.pod:537
25289 msgid "blockdev-setrw"
25290 msgstr ""
25291
25292 # type: verbatim
25293 #. type: verbatim
25294 #: ../fish/guestfish-actions.pod:539
25295 #, no-wrap
25296 msgid ""
25297 " blockdev-setrw device\n"
25298 "\n"
25299 msgstr ""
25300
25301 # type: =head2
25302 #. type: =head2
25303 #: ../fish/guestfish-actions.pod:545
25304 msgid "case-sensitive-path"
25305 msgstr ""
25306
25307 # type: verbatim
25308 #. type: verbatim
25309 #: ../fish/guestfish-actions.pod:547
25310 #, no-wrap
25311 msgid ""
25312 " case-sensitive-path path\n"
25313 "\n"
25314 msgstr ""
25315
25316 # type: textblock
25317 #. type: textblock
25318 #: ../fish/guestfish-actions.pod:571
25319 msgid ""
25320 "Thus L</case-sensitive-path> (\"/Windows/System32\")  might return C<\"/"
25321 "WINDOWS/system32\"> (the exact return value would depend on details of how "
25322 "the directories were originally created under Windows)."
25323 msgstr ""
25324
25325 # type: textblock
25326 #. type: textblock
25327 #: ../fish/guestfish-actions.pod:579
25328 msgid "See also L</realpath>."
25329 msgstr ""
25330
25331 # type: =head2
25332 #. type: =head2
25333 #: ../fish/guestfish-actions.pod:581
25334 msgid "cat"
25335 msgstr ""
25336
25337 # type: verbatim
25338 #. type: verbatim
25339 #: ../fish/guestfish-actions.pod:583
25340 #, no-wrap
25341 msgid ""
25342 " cat path\n"
25343 "\n"
25344 msgstr ""
25345
25346 # type: textblock
25347 #. type: textblock
25348 #: ../fish/guestfish-actions.pod:587
25349 msgid ""
25350 "Note that this function cannot correctly handle binary files (specifically, "
25351 "files containing C<\\0> character which is treated as end of string).  For "
25352 "those you need to use the L</read-file> or L</download> functions which have "
25353 "a more complex interface."
25354 msgstr ""
25355
25356 # type: =head2
25357 #. type: =head2
25358 #: ../fish/guestfish-actions.pod:595
25359 msgid "checksum"
25360 msgstr ""
25361
25362 # type: verbatim
25363 #. type: verbatim
25364 #: ../fish/guestfish-actions.pod:597
25365 #, no-wrap
25366 msgid ""
25367 " checksum csumtype path\n"
25368 "\n"
25369 msgstr ""
25370
25371 # type: textblock
25372 #. type: textblock
25373 #: ../fish/guestfish-actions.pod:640
25374 msgid "To get the checksum for a device, use L</checksum-device>."
25375 msgstr ""
25376
25377 # type: textblock
25378 #. type: textblock
25379 #: ../fish/guestfish-actions.pod:642
25380 msgid "To get the checksums for many files, use L</checksums-out>."
25381 msgstr ""
25382
25383 # type: =head2
25384 #. type: =head2
25385 #: ../fish/guestfish-actions.pod:644
25386 msgid "checksum-device"
25387 msgstr ""
25388
25389 # type: verbatim
25390 #. type: verbatim
25391 #: ../fish/guestfish-actions.pod:646
25392 #, no-wrap
25393 msgid ""
25394 " checksum-device csumtype device\n"
25395 "\n"
25396 msgstr ""
25397
25398 # type: textblock
25399 #. type: textblock
25400 #: ../fish/guestfish-actions.pod:648
25401 msgid ""
25402 "This call computes the MD5, SHAx or CRC checksum of the contents of the "
25403 "device named C<device>.  For the types of checksums supported see the L</"
25404 "checksum> command."
25405 msgstr ""
25406
25407 # type: =head2
25408 #. type: =head2
25409 #: ../fish/guestfish-actions.pod:652
25410 msgid "checksums-out"
25411 msgstr ""
25412
25413 # type: verbatim
25414 #. type: verbatim
25415 #: ../fish/guestfish-actions.pod:654
25416 #, no-wrap
25417 msgid ""
25418 " checksums-out csumtype directory (sumsfile|-)\n"
25419 "\n"
25420 msgstr ""
25421
25422 # type: =head2
25423 #. type: =head2
25424 #: ../fish/guestfish-actions.pod:670
25425 msgid "chmod"
25426 msgstr ""
25427
25428 # type: verbatim
25429 #. type: verbatim
25430 #: ../fish/guestfish-actions.pod:672
25431 #, no-wrap
25432 msgid ""
25433 " chmod mode path\n"
25434 "\n"
25435 msgstr ""
25436
25437 # type: =head2
25438 #. type: =head2
25439 #: ../fish/guestfish-actions.pod:683
25440 msgid "chown"
25441 msgstr ""
25442
25443 # type: verbatim
25444 #. type: verbatim
25445 #: ../fish/guestfish-actions.pod:685
25446 #, no-wrap
25447 msgid ""
25448 " chown owner group path\n"
25449 "\n"
25450 msgstr ""
25451
25452 # type: =head2
25453 #. type: =head2
25454 #: ../fish/guestfish-actions.pod:693
25455 msgid "command"
25456 msgstr ""
25457
25458 # type: verbatim
25459 #. type: verbatim
25460 #: ../fish/guestfish-actions.pod:695
25461 #, no-wrap
25462 msgid ""
25463 " command 'arguments ...'\n"
25464 "\n"
25465 msgstr ""
25466
25467 # type: textblock
25468 #. type: textblock
25469 #: ../fish/guestfish-actions.pod:702
25470 msgid ""
25471 "The single parameter is an argv-style list of arguments.  The first element "
25472 "is the name of the program to run.  Subsequent elements are parameters.  The "
25473 "list must be non-empty (ie. must contain a program name).  Note that the "
25474 "command runs directly, and is I<not> invoked via the shell (see L</sh>)."
25475 msgstr ""
25476
25477 # type: =head2
25478 #. type: =head2
25479 #: ../fish/guestfish-actions.pod:730
25480 msgid "command-lines"
25481 msgstr ""
25482
25483 # type: verbatim
25484 #. type: verbatim
25485 #: ../fish/guestfish-actions.pod:732
25486 #, no-wrap
25487 msgid ""
25488 " command-lines 'arguments ...'\n"
25489 "\n"
25490 msgstr ""
25491
25492 # type: textblock
25493 #. type: textblock
25494 #: ../fish/guestfish-actions.pod:734
25495 msgid ""
25496 "This is the same as L</command>, but splits the result into a list of lines."
25497 msgstr ""
25498
25499 # type: textblock
25500 #. type: textblock
25501 #: ../fish/guestfish-actions.pod:737
25502 msgid "See also: L</sh-lines>"
25503 msgstr ""
25504
25505 # type: =head2
25506 #. type: =head2
25507 #: ../fish/guestfish-actions.pod:742
25508 msgid "config"
25509 msgstr ""
25510
25511 # type: verbatim
25512 #. type: verbatim
25513 #: ../fish/guestfish-actions.pod:744
25514 #, no-wrap
25515 msgid ""
25516 " config qemuparam qemuvalue\n"
25517 "\n"
25518 msgstr ""
25519
25520 # type: =head2
25521 #. type: =head2
25522 #: ../fish/guestfish-actions.pod:755
25523 msgid "copy-size"
25524 msgstr ""
25525
25526 # type: verbatim
25527 #. type: verbatim
25528 #: ../fish/guestfish-actions.pod:757
25529 #, no-wrap
25530 msgid ""
25531 " copy-size src dest size\n"
25532 "\n"
25533 msgstr ""
25534
25535 # type: =head2
25536 #. type: =head2
25537 #: ../fish/guestfish-actions.pod:765
25538 msgid "cp"
25539 msgstr ""
25540
25541 # type: verbatim
25542 #. type: verbatim
25543 #: ../fish/guestfish-actions.pod:767
25544 #, no-wrap
25545 msgid ""
25546 " cp src dest\n"
25547 "\n"
25548 msgstr ""
25549
25550 # type: =head2
25551 #. type: =head2
25552 #: ../fish/guestfish-actions.pod:772
25553 msgid "cp-a"
25554 msgstr ""
25555
25556 # type: verbatim
25557 #. type: verbatim
25558 #: ../fish/guestfish-actions.pod:774
25559 #, no-wrap
25560 msgid ""
25561 " cp-a src dest\n"
25562 "\n"
25563 msgstr ""
25564
25565 # type: =head2
25566 #. type: =head2
25567 #: ../fish/guestfish-actions.pod:779
25568 msgid "dd"
25569 msgstr ""
25570
25571 # type: verbatim
25572 #. type: verbatim
25573 #: ../fish/guestfish-actions.pod:781
25574 #, no-wrap
25575 msgid ""
25576 " dd src dest\n"
25577 "\n"
25578 msgstr ""
25579
25580 # type: textblock
25581 #. type: textblock
25582 #: ../fish/guestfish-actions.pod:788
25583 msgid ""
25584 "If the destination is a device, it must be as large or larger than the "
25585 "source file or device, otherwise the copy will fail.  This command cannot do "
25586 "partial copies (see L</copy-size>)."
25587 msgstr ""
25588
25589 # type: =head2
25590 #. type: =head2
25591 #: ../fish/guestfish-actions.pod:792
25592 msgid "df"
25593 msgstr ""
25594
25595 # type: verbatim
25596 #. type: verbatim
25597 #: ../fish/guestfish-actions.pod:794
25598 #, no-wrap
25599 msgid ""
25600 " df\n"
25601 "\n"
25602 msgstr ""
25603
25604 # type: textblock
25605 #. type: textblock
25606 #: ../fish/guestfish-actions.pod:798 ../fish/guestfish-actions.pod:809
25607 msgid ""
25608 "This command is mostly useful for interactive sessions.  It is I<not> "
25609 "intended that you try to parse the output string.  Use L</statvfs> from "
25610 "programs."
25611 msgstr ""
25612
25613 # type: =head2
25614 #. type: =head2
25615 #: ../fish/guestfish-actions.pod:802
25616 msgid "df-h"
25617 msgstr ""
25618
25619 # type: verbatim
25620 #. type: verbatim
25621 #: ../fish/guestfish-actions.pod:804
25622 #, no-wrap
25623 msgid ""
25624 " df-h\n"
25625 "\n"
25626 msgstr ""
25627
25628 # type: =head2
25629 #. type: =head2
25630 #: ../fish/guestfish-actions.pod:813
25631 msgid "dmesg"
25632 msgstr ""
25633
25634 # type: verbatim
25635 #. type: verbatim
25636 #: ../fish/guestfish-actions.pod:815
25637 #, no-wrap
25638 msgid ""
25639 " dmesg\n"
25640 "\n"
25641 msgstr ""
25642
25643 # type: textblock
25644 #. type: textblock
25645 #: ../fish/guestfish-actions.pod:821
25646 msgid ""
25647 "Another way to get the same information is to enable verbose messages with "
25648 "L</set-verbose> or by setting the environment variable C<LIBGUESTFS_DEBUG=1> "
25649 "before running the program."
25650 msgstr ""
25651
25652 # type: =head2
25653 #. type: =head2
25654 #: ../fish/guestfish-actions.pod:826
25655 msgid "download"
25656 msgstr ""
25657
25658 # type: verbatim
25659 #. type: verbatim
25660 #: ../fish/guestfish-actions.pod:828
25661 #, no-wrap
25662 msgid ""
25663 " download remotefilename (filename|-)\n"
25664 "\n"
25665 msgstr ""
25666
25667 # type: textblock
25668 #. type: textblock
25669 #: ../fish/guestfish-actions.pod:835
25670 msgid "See also L</upload>, L</cat>."
25671 msgstr ""
25672
25673 # type: =head2
25674 #. type: =head2
25675 #: ../fish/guestfish-actions.pod:839
25676 msgid "download-offset"
25677 msgstr ""
25678
25679 # type: verbatim
25680 #. type: verbatim
25681 #: ../fish/guestfish-actions.pod:841
25682 #, no-wrap
25683 msgid ""
25684 " download-offset remotefilename (filename|-) offset size\n"
25685 "\n"
25686 msgstr ""
25687
25688 # type: textblock
25689 #. type: textblock
25690 #: ../fish/guestfish-actions.pod:849
25691 msgid ""
25692 "Note that there is no limit on the amount of data that can be downloaded "
25693 "with this call, unlike with L</pread>, and this call always reads the full "
25694 "amount unless an error occurs."
25695 msgstr ""
25696
25697 # type: textblock
25698 #. type: textblock
25699 #: ../fish/guestfish-actions.pod:854
25700 msgid "See also L</download>, L</pread>."
25701 msgstr ""
25702
25703 # type: =head2
25704 #. type: =head2
25705 #: ../fish/guestfish-actions.pod:858
25706 msgid "drop-caches"
25707 msgstr ""
25708
25709 # type: verbatim
25710 #. type: verbatim
25711 #: ../fish/guestfish-actions.pod:860
25712 #, no-wrap
25713 msgid ""
25714 " drop-caches whattodrop\n"
25715 "\n"
25716 msgstr ""
25717
25718 # type: =head2
25719 #. type: =head2
25720 #: ../fish/guestfish-actions.pod:872
25721 msgid "du"
25722 msgstr ""
25723
25724 # type: verbatim
25725 #. type: verbatim
25726 #: ../fish/guestfish-actions.pod:874
25727 #, no-wrap
25728 msgid ""
25729 " du path\n"
25730 "\n"
25731 msgstr ""
25732
25733 # type: =head2
25734 #. type: =head2
25735 #: ../fish/guestfish-actions.pod:886
25736 msgid "e2fsck-f"
25737 msgstr ""
25738
25739 # type: verbatim
25740 #. type: verbatim
25741 #: ../fish/guestfish-actions.pod:888
25742 #, no-wrap
25743 msgid ""
25744 " e2fsck-f device\n"
25745 "\n"
25746 msgstr ""
25747
25748 # type: textblock
25749 #. type: textblock
25750 #: ../fish/guestfish-actions.pod:894
25751 msgid ""
25752 "This command is only needed because of L</resize2fs> (q.v.).  Normally you "
25753 "should use L</fsck>."
25754 msgstr ""
25755
25756 # type: =head2
25757 #. type: =head2
25758 #: ../fish/guestfish-actions.pod:897
25759 msgid "echo-daemon"
25760 msgstr ""
25761
25762 # type: verbatim
25763 #. type: verbatim
25764 #: ../fish/guestfish-actions.pod:899
25765 #, no-wrap
25766 msgid ""
25767 " echo-daemon 'words ...'\n"
25768 "\n"
25769 msgstr ""
25770
25771 # type: textblock
25772 #. type: textblock
25773 #: ../fish/guestfish-actions.pod:906
25774 msgid "See also L</ping-daemon>."
25775 msgstr ""
25776
25777 # type: =head2
25778 #. type: =head2
25779 #: ../fish/guestfish-actions.pod:908
25780 msgid "egrep"
25781 msgstr ""
25782
25783 # type: verbatim
25784 #. type: verbatim
25785 #: ../fish/guestfish-actions.pod:910
25786 #, no-wrap
25787 msgid ""
25788 " egrep regex path\n"
25789 "\n"
25790 msgstr ""
25791
25792 # type: =head2
25793 #. type: =head2
25794 #: ../fish/guestfish-actions.pod:918
25795 msgid "egrepi"
25796 msgstr ""
25797
25798 # type: verbatim
25799 #. type: verbatim
25800 #: ../fish/guestfish-actions.pod:920
25801 #, no-wrap
25802 msgid ""
25803 " egrepi regex path\n"
25804 "\n"
25805 msgstr ""
25806
25807 # type: =head2
25808 #. type: =head2
25809 #: ../fish/guestfish-actions.pod:928
25810 msgid "equal"
25811 msgstr ""
25812
25813 # type: verbatim
25814 #. type: verbatim
25815 #: ../fish/guestfish-actions.pod:930
25816 #, no-wrap
25817 msgid ""
25818 " equal file1 file2\n"
25819 "\n"
25820 msgstr ""
25821
25822 # type: =head2
25823 #. type: =head2
25824 #: ../fish/guestfish-actions.pod:937
25825 msgid "exists"
25826 msgstr ""
25827
25828 # type: verbatim
25829 #. type: verbatim
25830 #: ../fish/guestfish-actions.pod:939
25831 #, no-wrap
25832 msgid ""
25833 " exists path\n"
25834 "\n"
25835 msgstr ""
25836
25837 # type: textblock
25838 #. type: textblock
25839 #: ../fish/guestfish-actions.pod:944
25840 msgid "See also L</is-file>, L</is-dir>, L</stat>."
25841 msgstr ""
25842
25843 # type: =head2
25844 #. type: =head2
25845 #: ../fish/guestfish-actions.pod:946
25846 msgid "fallocate"
25847 msgstr ""
25848
25849 # type: verbatim
25850 #. type: verbatim
25851 #: ../fish/guestfish-actions.pod:948
25852 #, no-wrap
25853 msgid ""
25854 " fallocate path len\n"
25855 "\n"
25856 msgstr ""
25857
25858 #. type: textblock
25859 #: ../fish/guestfish-actions.pod:958
25860 msgid ""
25861 "This function is deprecated.  In new code, use the L</fallocate64> call "
25862 "instead."
25863 msgstr ""
25864
25865 # type: =head2
25866 #. type: =head2
25867 #: ../fish/guestfish-actions.pod:965
25868 msgid "fallocate64"
25869 msgstr ""
25870
25871 # type: verbatim
25872 #. type: verbatim
25873 #: ../fish/guestfish-actions.pod:967
25874 #, no-wrap
25875 msgid ""
25876 " fallocate64 path len\n"
25877 "\n"
25878 msgstr ""
25879
25880 # type: textblock
25881 #. type: textblock
25882 #: ../fish/guestfish-actions.pod:973
25883 msgid ""
25884 "Note that this call allocates disk blocks for the file.  To create a sparse "
25885 "file use L</truncate-size> instead."
25886 msgstr ""
25887
25888 # type: textblock
25889 #. type: textblock
25890 #: ../fish/guestfish-actions.pod:976
25891 msgid ""
25892 "The deprecated call L</fallocate> does the same, but owing to an oversight "
25893 "it only allowed 30 bit lengths to be specified, effectively limiting the "
25894 "maximum size of files created through that call to 1GB."
25895 msgstr ""
25896
25897 # type: =head2
25898 #. type: =head2
25899 #: ../fish/guestfish-actions.pod:985
25900 msgid "fgrep"
25901 msgstr ""
25902
25903 # type: verbatim
25904 #. type: verbatim
25905 #: ../fish/guestfish-actions.pod:987
25906 #, no-wrap
25907 msgid ""
25908 " fgrep pattern path\n"
25909 "\n"
25910 msgstr ""
25911
25912 # type: =head2
25913 #. type: =head2
25914 #: ../fish/guestfish-actions.pod:995
25915 msgid "fgrepi"
25916 msgstr ""
25917
25918 # type: verbatim
25919 #. type: verbatim
25920 #: ../fish/guestfish-actions.pod:997
25921 #, no-wrap
25922 msgid ""
25923 " fgrepi pattern path\n"
25924 "\n"
25925 msgstr ""
25926
25927 # type: =head2
25928 #. type: =head2
25929 #: ../fish/guestfish-actions.pod:1005
25930 msgid "file"
25931 msgstr ""
25932
25933 # type: verbatim
25934 #. type: verbatim
25935 #: ../fish/guestfish-actions.pod:1007
25936 #, no-wrap
25937 msgid ""
25938 " file path\n"
25939 "\n"
25940 msgstr ""
25941
25942 #. type: textblock
25943 #: ../fish/guestfish-actions.pod:1023
25944 msgid ""
25945 "See also: L<file(1)>, L</vfs-type>, L</lstat>, L</is-file>, L</is-blockdev> "
25946 "(etc)."
25947 msgstr ""
25948
25949 # type: =head2
25950 #. type: =head2
25951 #: ../fish/guestfish-actions.pod:1026
25952 msgid "file-architecture"
25953 msgstr ""
25954
25955 # type: verbatim
25956 #. type: verbatim
25957 #: ../fish/guestfish-actions.pod:1028
25958 #, no-wrap
25959 msgid ""
25960 " file-architecture filename\n"
25961 "\n"
25962 msgstr ""
25963
25964 # type: =head2
25965 #. type: =head2
25966 #: ../fish/guestfish-actions.pod:1131
25967 msgid "filesize"
25968 msgstr ""
25969
25970 # type: verbatim
25971 #. type: verbatim
25972 #: ../fish/guestfish-actions.pod:1133
25973 #, no-wrap
25974 msgid ""
25975 " filesize file\n"
25976 "\n"
25977 msgstr ""
25978
25979 # type: textblock
25980 #. type: textblock
25981 #: ../fish/guestfish-actions.pod:1137
25982 msgid ""
25983 "To get other stats about a file, use L</stat>, L</lstat>, L</is-dir>, L</is-"
25984 "file> etc.  To get the size of block devices, use L</blockdev-getsize64>."
25985 msgstr ""
25986
25987 # type: =head2
25988 #. type: =head2
25989 #: ../fish/guestfish-actions.pod:1141
25990 msgid "fill"
25991 msgstr ""
25992
25993 # type: verbatim
25994 #. type: verbatim
25995 #: ../fish/guestfish-actions.pod:1143
25996 #, no-wrap
25997 msgid ""
25998 " fill c len path\n"
25999 "\n"
26000 msgstr ""
26001
26002 # type: textblock
26003 #. type: textblock
26004 #: ../fish/guestfish-actions.pod:1149
26005 msgid ""
26006 "To fill a file with zero bytes (sparsely), it is much more efficient to use "
26007 "L</truncate-size>.  To create a file with a pattern of repeating bytes use "
26008 "L</fill-pattern>."
26009 msgstr ""
26010
26011 # type: =head2
26012 #. type: =head2
26013 #: ../fish/guestfish-actions.pod:1154
26014 msgid "fill-pattern"
26015 msgstr ""
26016
26017 # type: verbatim
26018 #. type: verbatim
26019 #: ../fish/guestfish-actions.pod:1156
26020 #, no-wrap
26021 msgid ""
26022 " fill-pattern pattern len path\n"
26023 "\n"
26024 msgstr ""
26025
26026 # type: textblock
26027 #. type: textblock
26028 #: ../fish/guestfish-actions.pod:1158
26029 msgid ""
26030 "This function is like L</fill> except that it creates a new file of length "
26031 "C<len> containing the repeating pattern of bytes in C<pattern>.  The pattern "
26032 "is truncated if necessary to ensure the length of the file is exactly C<len> "
26033 "bytes."
26034 msgstr ""
26035
26036 # type: =head2
26037 #. type: =head2
26038 #: ../fish/guestfish-actions.pod:1163
26039 msgid "find"
26040 msgstr ""
26041
26042 # type: verbatim
26043 #. type: verbatim
26044 #: ../fish/guestfish-actions.pod:1165
26045 #, no-wrap
26046 msgid ""
26047 " find directory\n"
26048 "\n"
26049 msgstr ""
26050
26051 # type: textblock
26052 #. type: textblock
26053 #: ../fish/guestfish-actions.pod:1179
26054 msgid "then the returned list from L</find> C</tmp> would be 4 elements:"
26055 msgstr ""
26056
26057 # type: textblock
26058 #. type: textblock
26059 #: ../fish/guestfish-actions.pod:1192
26060 msgid "See also L</find0>."
26061 msgstr ""
26062
26063 # type: =head2
26064 #. type: =head2
26065 #: ../fish/guestfish-actions.pod:1197
26066 msgid "find0"
26067 msgstr ""
26068
26069 # type: verbatim
26070 #. type: verbatim
26071 #: ../fish/guestfish-actions.pod:1199
26072 #, no-wrap
26073 msgid ""
26074 " find0 directory (files|-)\n"
26075 "\n"
26076 msgstr ""
26077
26078 # type: textblock
26079 #. type: textblock
26080 #: ../fish/guestfish-actions.pod:1205
26081 msgid ""
26082 "This command works the same way as L</find> with the following exceptions:"
26083 msgstr ""
26084
26085 # type: =head2
26086 #. type: =head2
26087 #: ../fish/guestfish-actions.pod:1232
26088 msgid "findfs-label"
26089 msgstr ""
26090
26091 # type: verbatim
26092 #. type: verbatim
26093 #: ../fish/guestfish-actions.pod:1234
26094 #, no-wrap
26095 msgid ""
26096 " findfs-label label\n"
26097 "\n"
26098 msgstr ""
26099
26100 # type: textblock
26101 #. type: textblock
26102 #: ../fish/guestfish-actions.pod:1240
26103 msgid "To find the label of a filesystem, use L</vfs-label>."
26104 msgstr ""
26105
26106 # type: =head2
26107 #. type: =head2
26108 #: ../fish/guestfish-actions.pod:1242
26109 msgid "findfs-uuid"
26110 msgstr ""
26111
26112 # type: verbatim
26113 #. type: verbatim
26114 #: ../fish/guestfish-actions.pod:1244
26115 #, no-wrap
26116 msgid ""
26117 " findfs-uuid uuid\n"
26118 "\n"
26119 msgstr ""
26120
26121 # type: textblock
26122 #. type: textblock
26123 #: ../fish/guestfish-actions.pod:1250
26124 msgid "To find the UUID of a filesystem, use L</vfs-uuid>."
26125 msgstr ""
26126
26127 # type: =head2
26128 #. type: =head2
26129 #: ../fish/guestfish-actions.pod:1252
26130 msgid "fsck"
26131 msgstr ""
26132
26133 # type: verbatim
26134 #. type: verbatim
26135 #: ../fish/guestfish-actions.pod:1254
26136 #, no-wrap
26137 msgid ""
26138 " fsck fstype device\n"
26139 "\n"
26140 msgstr ""
26141
26142 # type: =head2
26143 #. type: =head2
26144 #: ../fish/guestfish-actions.pod:1284
26145 msgid "get-append"
26146 msgstr ""
26147
26148 # type: verbatim
26149 #. type: verbatim
26150 #: ../fish/guestfish-actions.pod:1286
26151 #, no-wrap
26152 msgid ""
26153 " get-append\n"
26154 "\n"
26155 msgstr ""
26156
26157 #. type: =head2
26158 #: ../fish/guestfish-actions.pod:1293
26159 msgid "get-attach-method"
26160 msgstr ""
26161
26162 #. type: verbatim
26163 #: ../fish/guestfish-actions.pod:1295
26164 #, no-wrap
26165 msgid ""
26166 " get-attach-method\n"
26167 "\n"
26168 msgstr ""
26169
26170 #. type: textblock
26171 #: ../fish/guestfish-actions.pod:1297
26172 msgid "Return the current attach method.  See L</set-attach-method>."
26173 msgstr ""
26174
26175 # type: =head2
26176 #. type: =head2
26177 #: ../fish/guestfish-actions.pod:1299
26178 msgid "get-autosync"
26179 msgstr ""
26180
26181 # type: verbatim
26182 #. type: verbatim
26183 #: ../fish/guestfish-actions.pod:1301
26184 #, no-wrap
26185 msgid ""
26186 " get-autosync\n"
26187 "\n"
26188 msgstr ""
26189
26190 # type: =head2
26191 #. type: =head2
26192 #: ../fish/guestfish-actions.pod:1305
26193 msgid "get-direct"
26194 msgstr ""
26195
26196 # type: verbatim
26197 #. type: verbatim
26198 #: ../fish/guestfish-actions.pod:1307
26199 #, no-wrap
26200 msgid ""
26201 " get-direct\n"
26202 "\n"
26203 msgstr ""
26204
26205 # type: =head2
26206 #. type: =head2
26207 #: ../fish/guestfish-actions.pod:1311
26208 msgid "get-e2label"
26209 msgstr ""
26210
26211 # type: verbatim
26212 #. type: verbatim
26213 #: ../fish/guestfish-actions.pod:1313
26214 #, no-wrap
26215 msgid ""
26216 " get-e2label device\n"
26217 "\n"
26218 msgstr ""
26219
26220 #. type: textblock
26221 #: ../fish/guestfish-actions.pod:1318
26222 msgid ""
26223 "This function is deprecated.  In new code, use the L</vfs_label> call "
26224 "instead."
26225 msgstr ""
26226
26227 # type: =head2
26228 #. type: =head2
26229 #: ../fish/guestfish-actions.pod:1325
26230 msgid "get-e2uuid"
26231 msgstr ""
26232
26233 # type: verbatim
26234 #. type: verbatim
26235 #: ../fish/guestfish-actions.pod:1327
26236 #, no-wrap
26237 msgid ""
26238 " get-e2uuid device\n"
26239 "\n"
26240 msgstr ""
26241
26242 #. type: textblock
26243 #: ../fish/guestfish-actions.pod:1332
26244 msgid ""
26245 "This function is deprecated.  In new code, use the L</vfs_uuid> call instead."
26246 msgstr ""
26247
26248 # type: =head2
26249 #. type: =head2
26250 #: ../fish/guestfish-actions.pod:1339
26251 msgid "get-memsize"
26252 msgstr ""
26253
26254 # type: verbatim
26255 #. type: verbatim
26256 #: ../fish/guestfish-actions.pod:1341
26257 #, no-wrap
26258 msgid ""
26259 " get-memsize\n"
26260 "\n"
26261 msgstr ""
26262
26263 # type: textblock
26264 #. type: textblock
26265 #: ../fish/guestfish-actions.pod:1346
26266 msgid ""
26267 "If L</set-memsize> was not called on this handle, and if "
26268 "C<LIBGUESTFS_MEMSIZE> was not set, then this returns the compiled-in default "
26269 "value for memsize."
26270 msgstr ""
26271
26272 # type: =head2
26273 #. type: =head2
26274 #: ../fish/guestfish-actions.pod:1353
26275 msgid "get-network"
26276 msgstr ""
26277
26278 # type: verbatim
26279 #. type: verbatim
26280 #: ../fish/guestfish-actions.pod:1355
26281 #, no-wrap
26282 msgid ""
26283 " get-network\n"
26284 "\n"
26285 msgstr ""
26286
26287 # type: =head2
26288 #. type: =head2
26289 #: ../fish/guestfish-actions.pod:1359
26290 msgid "get-path"
26291 msgstr ""
26292
26293 # type: verbatim
26294 #. type: verbatim
26295 #: ../fish/guestfish-actions.pod:1361
26296 #, no-wrap
26297 msgid ""
26298 " get-path\n"
26299 "\n"
26300 msgstr ""
26301
26302 # type: =head2
26303 #. type: =head2
26304 #: ../fish/guestfish-actions.pod:1368
26305 msgid "get-pid"
26306 msgstr ""
26307
26308 # type: =head2
26309 #. type: =head2
26310 #: ../fish/guestfish-actions.pod:1370
26311 msgid "pid"
26312 msgstr ""
26313
26314 # type: verbatim
26315 #. type: verbatim
26316 #: ../fish/guestfish-actions.pod:1372
26317 #, no-wrap
26318 msgid ""
26319 " get-pid\n"
26320 "\n"
26321 msgstr ""
26322
26323 # type: =head2
26324 #. type: =head2
26325 #: ../fish/guestfish-actions.pod:1379
26326 msgid "get-qemu"
26327 msgstr ""
26328
26329 # type: verbatim
26330 #. type: verbatim
26331 #: ../fish/guestfish-actions.pod:1381
26332 #, no-wrap
26333 msgid ""
26334 " get-qemu\n"
26335 "\n"
26336 msgstr ""
26337
26338 # type: =head2
26339 #. type: =head2
26340 #: ../fish/guestfish-actions.pod:1388
26341 msgid "get-recovery-proc"
26342 msgstr ""
26343
26344 # type: verbatim
26345 #. type: verbatim
26346 #: ../fish/guestfish-actions.pod:1390
26347 #, no-wrap
26348 msgid ""
26349 " get-recovery-proc\n"
26350 "\n"
26351 msgstr ""
26352
26353 # type: =head2
26354 #. type: =head2
26355 #: ../fish/guestfish-actions.pod:1394
26356 msgid "get-selinux"
26357 msgstr ""
26358
26359 # type: verbatim
26360 #. type: verbatim
26361 #: ../fish/guestfish-actions.pod:1396
26362 #, no-wrap
26363 msgid ""
26364 " get-selinux\n"
26365 "\n"
26366 msgstr ""
26367
26368 # type: textblock
26369 #. type: textblock
26370 #: ../fish/guestfish-actions.pod:1398
26371 msgid ""
26372 "This returns the current setting of the selinux flag which is passed to the "
26373 "appliance at boot time.  See L</set-selinux>."
26374 msgstr ""
26375
26376 # type: =head2
26377 #. type: =head2
26378 #: ../fish/guestfish-actions.pod:1404
26379 msgid "get-state"
26380 msgstr ""
26381
26382 # type: verbatim
26383 #. type: verbatim
26384 #: ../fish/guestfish-actions.pod:1406
26385 #, no-wrap
26386 msgid ""
26387 " get-state\n"
26388 "\n"
26389 msgstr ""
26390
26391 # type: =head2
26392 #. type: =head2
26393 #: ../fish/guestfish-actions.pod:1413
26394 msgid "get-trace"
26395 msgstr ""
26396
26397 # type: verbatim
26398 #. type: verbatim
26399 #: ../fish/guestfish-actions.pod:1415
26400 #, no-wrap
26401 msgid ""
26402 " get-trace\n"
26403 "\n"
26404 msgstr ""
26405
26406 # type: =head2
26407 #. type: =head2
26408 #: ../fish/guestfish-actions.pod:1419
26409 msgid "get-umask"
26410 msgstr ""
26411
26412 # type: verbatim
26413 #. type: verbatim
26414 #: ../fish/guestfish-actions.pod:1421
26415 #, no-wrap
26416 msgid ""
26417 " get-umask\n"
26418 "\n"
26419 msgstr ""
26420
26421 # type: textblock
26422 #. type: textblock
26423 #: ../fish/guestfish-actions.pod:1423
26424 msgid ""
26425 "Return the current umask.  By default the umask is C<022> unless it has been "
26426 "set by calling L</umask>."
26427 msgstr ""
26428
26429 # type: =head2
26430 #. type: =head2
26431 #: ../fish/guestfish-actions.pod:1426
26432 msgid "get-verbose"
26433 msgstr ""
26434
26435 # type: verbatim
26436 #. type: verbatim
26437 #: ../fish/guestfish-actions.pod:1428
26438 #, no-wrap
26439 msgid ""
26440 " get-verbose\n"
26441 "\n"
26442 msgstr ""
26443
26444 # type: =head2
26445 #. type: =head2
26446 #: ../fish/guestfish-actions.pod:1432
26447 msgid "getcon"
26448 msgstr ""
26449
26450 # type: verbatim
26451 #. type: verbatim
26452 #: ../fish/guestfish-actions.pod:1434
26453 #, no-wrap
26454 msgid ""
26455 " getcon\n"
26456 "\n"
26457 msgstr ""
26458
26459 # type: textblock
26460 #. type: textblock
26461 #: ../fish/guestfish-actions.pod:1438
26462 msgid "See the documentation about SELINUX in L<guestfs(3)>, and L</setcon>"
26463 msgstr ""
26464
26465 # type: =head2
26466 #. type: =head2
26467 #: ../fish/guestfish-actions.pod:1441
26468 msgid "getxattr"
26469 msgstr ""
26470
26471 # type: verbatim
26472 #. type: verbatim
26473 #: ../fish/guestfish-actions.pod:1443
26474 #, no-wrap
26475 msgid ""
26476 " getxattr path name\n"
26477 "\n"
26478 msgstr ""
26479
26480 # type: textblock
26481 #. type: textblock
26482 #: ../fish/guestfish-actions.pod:1445
26483 msgid ""
26484 "Get a single extended attribute from file C<path> named C<name>.  This call "
26485 "follows symlinks.  If you want to lookup an extended attribute for the "
26486 "symlink itself, use L</lgetxattr>."
26487 msgstr ""
26488
26489 # type: textblock
26490 #. type: textblock
26491 #: ../fish/guestfish-actions.pod:1449 ../fish/guestfish-actions.pod:2477
26492 msgid ""
26493 "Normally it is better to get all extended attributes from a file in one go "
26494 "by calling L</getxattrs>.  However some Linux filesystem implementations are "
26495 "buggy and do not provide a way to list out attributes.  For these "
26496 "filesystems (notably ntfs-3g)  you have to know the names of the extended "
26497 "attributes you want in advance and call this function."
26498 msgstr ""
26499
26500 # type: textblock
26501 #. type: textblock
26502 #: ../fish/guestfish-actions.pod:1459
26503 msgid "See also: L</getxattrs>, L</lgetxattr>, L<attr(5)>."
26504 msgstr ""
26505
26506 # type: =head2
26507 #. type: =head2
26508 #: ../fish/guestfish-actions.pod:1461
26509 msgid "getxattrs"
26510 msgstr ""
26511
26512 # type: verbatim
26513 #. type: verbatim
26514 #: ../fish/guestfish-actions.pod:1463
26515 #, no-wrap
26516 msgid ""
26517 " getxattrs path\n"
26518 "\n"
26519 msgstr ""
26520
26521 # type: textblock
26522 #. type: textblock
26523 #: ../fish/guestfish-actions.pod:1471
26524 msgid "See also: L</lgetxattrs>, L<attr(5)>."
26525 msgstr ""
26526
26527 # type: =head2
26528 #. type: =head2
26529 #: ../fish/guestfish-actions.pod:1473
26530 msgid "glob-expand"
26531 msgstr ""
26532
26533 # type: verbatim
26534 #. type: verbatim
26535 #: ../fish/guestfish-actions.pod:1475
26536 #, no-wrap
26537 msgid ""
26538 " glob-expand pattern\n"
26539 "\n"
26540 msgstr ""
26541
26542 # type: =head2
26543 #. type: =head2
26544 #: ../fish/guestfish-actions.pod:1488
26545 msgid "grep"
26546 msgstr ""
26547
26548 # type: verbatim
26549 #. type: verbatim
26550 #: ../fish/guestfish-actions.pod:1490
26551 #, no-wrap
26552 msgid ""
26553 " grep regex path\n"
26554 "\n"
26555 msgstr ""
26556
26557 # type: =head2
26558 #. type: =head2
26559 #: ../fish/guestfish-actions.pod:1498
26560 msgid "grepi"
26561 msgstr ""
26562
26563 # type: verbatim
26564 #. type: verbatim
26565 #: ../fish/guestfish-actions.pod:1500
26566 #, no-wrap
26567 msgid ""
26568 " grepi regex path\n"
26569 "\n"
26570 msgstr ""
26571
26572 # type: =head2
26573 #. type: =head2
26574 #: ../fish/guestfish-actions.pod:1508
26575 msgid "grub-install"
26576 msgstr ""
26577
26578 # type: verbatim
26579 #. type: verbatim
26580 #: ../fish/guestfish-actions.pod:1510
26581 #, no-wrap
26582 msgid ""
26583 " grub-install root device\n"
26584 "\n"
26585 msgstr ""
26586
26587 # type: =head2
26588 #. type: =head2
26589 #: ../fish/guestfish-actions.pod:1548
26590 msgid "head"
26591 msgstr ""
26592
26593 # type: verbatim
26594 #. type: verbatim
26595 #: ../fish/guestfish-actions.pod:1550
26596 #, no-wrap
26597 msgid ""
26598 " head path\n"
26599 "\n"
26600 msgstr ""
26601
26602 # type: =head2
26603 #. type: =head2
26604 #: ../fish/guestfish-actions.pod:1558
26605 msgid "head-n"
26606 msgstr ""
26607
26608 # type: verbatim
26609 #. type: verbatim
26610 #: ../fish/guestfish-actions.pod:1560
26611 #, no-wrap
26612 msgid ""
26613 " head-n nrlines path\n"
26614 "\n"
26615 msgstr ""
26616
26617 # type: =head2
26618 #. type: =head2
26619 #: ../fish/guestfish-actions.pod:1573
26620 msgid "hexdump"
26621 msgstr ""
26622
26623 # type: verbatim
26624 #. type: verbatim
26625 #: ../fish/guestfish-actions.pod:1575
26626 #, no-wrap
26627 msgid ""
26628 " hexdump path\n"
26629 "\n"
26630 msgstr ""
26631
26632 # type: =head2
26633 #. type: =head2
26634 #: ../fish/guestfish-actions.pod:1583
26635 msgid "initrd-cat"
26636 msgstr ""
26637
26638 # type: verbatim
26639 #. type: verbatim
26640 #: ../fish/guestfish-actions.pod:1585
26641 #, no-wrap
26642 msgid ""
26643 " initrd-cat initrdpath filename\n"
26644 "\n"
26645 msgstr ""
26646
26647 # type: textblock
26648 #. type: textblock
26649 #: ../fish/guestfish-actions.pod:1597
26650 msgid "See also L</initrd-list>."
26651 msgstr ""
26652
26653 # type: =head2
26654 #. type: =head2
26655 #: ../fish/guestfish-actions.pod:1602
26656 msgid "initrd-list"
26657 msgstr ""
26658
26659 # type: verbatim
26660 #. type: verbatim
26661 #: ../fish/guestfish-actions.pod:1604
26662 #, no-wrap
26663 msgid ""
26664 " initrd-list path\n"
26665 "\n"
26666 msgstr ""
26667
26668 # type: =head2
26669 #. type: =head2
26670 #: ../fish/guestfish-actions.pod:1616
26671 msgid "inotify-add-watch"
26672 msgstr ""
26673
26674 # type: verbatim
26675 #. type: verbatim
26676 #: ../fish/guestfish-actions.pod:1618
26677 #, no-wrap
26678 msgid ""
26679 " inotify-add-watch path mask\n"
26680 "\n"
26681 msgstr ""
26682
26683 # type: =head2
26684 #. type: =head2
26685 #: ../fish/guestfish-actions.pod:1630
26686 msgid "inotify-close"
26687 msgstr ""
26688
26689 # type: verbatim
26690 #. type: verbatim
26691 #: ../fish/guestfish-actions.pod:1632
26692 #, no-wrap
26693 msgid ""
26694 " inotify-close\n"
26695 "\n"
26696 msgstr ""
26697
26698 # type: =head2
26699 #. type: =head2
26700 #: ../fish/guestfish-actions.pod:1638
26701 msgid "inotify-files"
26702 msgstr ""
26703
26704 # type: verbatim
26705 #. type: verbatim
26706 #: ../fish/guestfish-actions.pod:1640
26707 #, no-wrap
26708 msgid ""
26709 " inotify-files\n"
26710 "\n"
26711 msgstr ""
26712
26713 # type: textblock
26714 #. type: textblock
26715 #: ../fish/guestfish-actions.pod:1642
26716 msgid ""
26717 "This function is a helpful wrapper around L</inotify-read> which just "
26718 "returns a list of pathnames of objects that were touched.  The returned "
26719 "pathnames are sorted and deduplicated."
26720 msgstr ""
26721
26722 # type: =head2
26723 #. type: =head2
26724 #: ../fish/guestfish-actions.pod:1646
26725 msgid "inotify-init"
26726 msgstr ""
26727
26728 # type: verbatim
26729 #. type: verbatim
26730 #: ../fish/guestfish-actions.pod:1648
26731 #, no-wrap
26732 msgid ""
26733 " inotify-init maxevents\n"
26734 "\n"
26735 msgstr ""
26736
26737 # type: textblock
26738 #. type: textblock
26739 #: ../fish/guestfish-actions.pod:1654
26740 msgid ""
26741 "C<maxevents> is the maximum number of events which will be queued up between "
26742 "calls to L</inotify-read> or L</inotify-files>.  If this is passed as C<0>, "
26743 "then the kernel (or previously set)  default is used.  For Linux 2.6.29 the "
26744 "default was 16384 events.  Beyond this limit, the kernel throws away events, "
26745 "but records the fact that it threw them away by setting a flag "
26746 "C<IN_Q_OVERFLOW> in the returned structure list (see L</inotify-read>)."
26747 msgstr ""
26748
26749 # type: textblock
26750 #. type: textblock
26751 #: ../fish/guestfish-actions.pod:1664
26752 msgid ""
26753 "Before any events are generated, you have to add some watches to the "
26754 "internal watch list.  See: L</inotify-add-watch>, L</inotify-rm-watch> and "
26755 "L</inotify-watch-all>."
26756 msgstr ""
26757
26758 # type: textblock
26759 #. type: textblock
26760 #: ../fish/guestfish-actions.pod:1670
26761 msgid ""
26762 "Queued up events should be read periodically by calling L</inotify-read> (or "
26763 "L</inotify-files> which is just a helpful wrapper around L</inotify-read>).  "
26764 "If you don't read the events out often enough then you risk the internal "
26765 "queue overflowing."
26766 msgstr ""
26767
26768 # type: textblock
26769 #. type: textblock
26770 #: ../fish/guestfish-actions.pod:1677
26771 msgid ""
26772 "The handle should be closed after use by calling L</inotify-close>.  This "
26773 "also removes any watches automatically."
26774 msgstr ""
26775
26776 # type: =head2
26777 #. type: =head2
26778 #: ../fish/guestfish-actions.pod:1686
26779 msgid "inotify-read"
26780 msgstr ""
26781
26782 # type: verbatim
26783 #. type: verbatim
26784 #: ../fish/guestfish-actions.pod:1688
26785 #, no-wrap
26786 msgid ""
26787 " inotify-read\n"
26788 "\n"
26789 msgstr ""
26790
26791 # type: =head2
26792 #. type: =head2
26793 #: ../fish/guestfish-actions.pod:1701
26794 msgid "inotify-rm-watch"
26795 msgstr ""
26796
26797 # type: verbatim
26798 #. type: verbatim
26799 #: ../fish/guestfish-actions.pod:1703
26800 #, no-wrap
26801 msgid ""
26802 " inotify-rm-watch wd\n"
26803 "\n"
26804 msgstr ""
26805
26806 # type: textblock
26807 #. type: textblock
26808 #: ../fish/guestfish-actions.pod:1705
26809 msgid "Remove a previously defined inotify watch.  See L</inotify-add-watch>."
26810 msgstr ""
26811
26812 # type: =head2
26813 #. type: =head2
26814 #: ../fish/guestfish-actions.pod:1708
26815 msgid "inspect-get-arch"
26816 msgstr ""
26817
26818 # type: verbatim
26819 #. type: verbatim
26820 #: ../fish/guestfish-actions.pod:1710
26821 #, no-wrap
26822 msgid ""
26823 " inspect-get-arch root\n"
26824 "\n"
26825 msgstr ""
26826
26827 # type: textblock
26828 #. type: textblock
26829 #: ../fish/guestfish-actions.pod:1712 ../fish/guestfish-actions.pod:1728
26830 #: ../fish/guestfish-actions.pod:1814 ../fish/guestfish-actions.pod:1850
26831 #: ../fish/guestfish-actions.pod:1868 ../fish/guestfish-actions.pod:1902
26832 #: ../fish/guestfish-actions.pod:1917 ../fish/guestfish-actions.pod:1938
26833 #: ../fish/guestfish-actions.pod:1953 ../fish/guestfish-actions.pod:1986
26834 #: ../fish/guestfish-actions.pod:2008 ../fish/guestfish-actions.pod:2032
26835 #: ../fish/guestfish-actions.pod:2049 ../fish/guestfish-actions.pod:2092
26836 #: ../fish/guestfish-actions.pod:2127 ../fish/guestfish-actions.pod:2143
26837 #: ../fish/guestfish-actions.pod:2159 ../fish/guestfish-actions.pod:2172
26838 #: ../fish/guestfish-actions.pod:2185 ../fish/guestfish-actions.pod:2200
26839 msgid ""
26840 "This function should only be called with a root device string as returned by "
26841 "L</inspect-os>."
26842 msgstr ""
26843
26844 # type: textblock
26845 #. type: textblock
26846 #: ../fish/guestfish-actions.pod:1715
26847 msgid ""
26848 "This returns the architecture of the inspected operating system.  The "
26849 "possible return values are listed under L</file-architecture>."
26850 msgstr ""
26851
26852 # type: =head2
26853 #. type: =head2
26854 #: ../fish/guestfish-actions.pod:1724
26855 msgid "inspect-get-distro"
26856 msgstr ""
26857
26858 # type: verbatim
26859 #. type: verbatim
26860 #: ../fish/guestfish-actions.pod:1726
26861 #, no-wrap
26862 msgid ""
26863 " inspect-get-distro root\n"
26864 "\n"
26865 msgstr ""
26866
26867 #. type: =head2
26868 #: ../fish/guestfish-actions.pod:1810
26869 msgid "inspect-get-drive-mappings"
26870 msgstr ""
26871
26872 #. type: verbatim
26873 #: ../fish/guestfish-actions.pod:1812
26874 #, no-wrap
26875 msgid ""
26876 " inspect-get-drive-mappings root\n"
26877 "\n"
26878 msgstr ""
26879
26880 #. type: textblock
26881 #: ../fish/guestfish-actions.pod:1842
26882 msgid ""
26883 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
26884 "get-mountpoints>, L</inspect-get-filesystems>."
26885 msgstr ""
26886
26887 # type: =head2
26888 #. type: =head2
26889 #: ../fish/guestfish-actions.pod:1846
26890 msgid "inspect-get-filesystems"
26891 msgstr ""
26892
26893 # type: verbatim
26894 #. type: verbatim
26895 #: ../fish/guestfish-actions.pod:1848
26896 #, no-wrap
26897 msgid ""
26898 " inspect-get-filesystems root\n"
26899 "\n"
26900 msgstr ""
26901
26902 # type: textblock
26903 #. type: textblock
26904 #: ../fish/guestfish-actions.pod:1861
26905 msgid ""
26906 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
26907 "get-mountpoints>."
26908 msgstr ""
26909
26910 #. type: =head2
26911 #: ../fish/guestfish-actions.pod:1864
26912 msgid "inspect-get-format"
26913 msgstr ""
26914
26915 #. type: verbatim
26916 #: ../fish/guestfish-actions.pod:1866
26917 #, no-wrap
26918 msgid ""
26919 " inspect-get-format root\n"
26920 "\n"
26921 msgstr ""
26922
26923 # type: =head2
26924 #. type: =head2
26925 #: ../fish/guestfish-actions.pod:1898
26926 msgid "inspect-get-hostname"
26927 msgstr ""
26928
26929 # type: verbatim
26930 #. type: verbatim
26931 #: ../fish/guestfish-actions.pod:1900
26932 #, no-wrap
26933 msgid ""
26934 " inspect-get-hostname root\n"
26935 "\n"
26936 msgstr ""
26937
26938 # type: =head2
26939 #. type: =head2
26940 #: ../fish/guestfish-actions.pod:1913
26941 msgid "inspect-get-major-version"
26942 msgstr ""
26943
26944 # type: verbatim
26945 #. type: verbatim
26946 #: ../fish/guestfish-actions.pod:1915
26947 #, no-wrap
26948 msgid ""
26949 " inspect-get-major-version root\n"
26950 "\n"
26951 msgstr ""
26952
26953 # type: =head2
26954 #. type: =head2
26955 #: ../fish/guestfish-actions.pod:1934
26956 msgid "inspect-get-minor-version"
26957 msgstr ""
26958
26959 # type: verbatim
26960 #. type: verbatim
26961 #: ../fish/guestfish-actions.pod:1936
26962 #, no-wrap
26963 msgid ""
26964 " inspect-get-minor-version root\n"
26965 "\n"
26966 msgstr ""
26967
26968 # type: textblock
26969 #. type: textblock
26970 #: ../fish/guestfish-actions.pod:1946
26971 msgid ""
26972 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
26973 "get-major-version>."
26974 msgstr ""
26975
26976 # type: =head2
26977 #. type: =head2
26978 #: ../fish/guestfish-actions.pod:1949
26979 msgid "inspect-get-mountpoints"
26980 msgstr ""
26981
26982 # type: verbatim
26983 #. type: verbatim
26984 #: ../fish/guestfish-actions.pod:1951
26985 #, no-wrap
26986 msgid ""
26987 " inspect-get-mountpoints root\n"
26988 "\n"
26989 msgstr ""
26990
26991 #. type: textblock
26992 #: ../fish/guestfish-actions.pod:1973
26993 msgid ""
26994 "For operating systems like Windows which still use drive letters, this call "
26995 "will only return an entry for the first drive \"mounted on\" C</>.  For "
26996 "information about the mapping of drive letters to partitions, see L</inspect-"
26997 "get-drive-mappings>."
26998 msgstr ""
26999
27000 # type: textblock
27001 #. type: textblock
27002 #: ../fish/guestfish-actions.pod:1979
27003 msgid ""
27004 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
27005 "get-filesystems>."
27006 msgstr ""
27007
27008 # type: =head2
27009 #. type: =head2
27010 #: ../fish/guestfish-actions.pod:1982
27011 msgid "inspect-get-package-format"
27012 msgstr ""
27013
27014 # type: verbatim
27015 #. type: verbatim
27016 #: ../fish/guestfish-actions.pod:1984
27017 #, no-wrap
27018 msgid ""
27019 " inspect-get-package-format root\n"
27020 "\n"
27021 msgstr ""
27022
27023 # type: textblock
27024 #. type: textblock
27025 #: ../fish/guestfish-actions.pod:1989
27026 msgid ""
27027 "This function and L</inspect-get-package-management> return the package "
27028 "format and package management tool used by the inspected operating system.  "
27029 "For example for Fedora these functions would return C<rpm> (package format) "
27030 "and C<yum> (package management)."
27031 msgstr ""
27032
27033 # type: =head2
27034 #. type: =head2
27035 #: ../fish/guestfish-actions.pod:2004
27036 msgid "inspect-get-package-management"
27037 msgstr ""
27038
27039 # type: verbatim
27040 #. type: verbatim
27041 #: ../fish/guestfish-actions.pod:2006
27042 #, no-wrap
27043 msgid ""
27044 " inspect-get-package-management root\n"
27045 "\n"
27046 msgstr ""
27047
27048 # type: textblock
27049 #. type: textblock
27050 #: ../fish/guestfish-actions.pod:2011
27051 msgid ""
27052 "L</inspect-get-package-format> and this function return the package format "
27053 "and package management tool used by the inspected operating system.  For "
27054 "example for Fedora these functions would return C<rpm> (package format) and "
27055 "C<yum> (package management)."
27056 msgstr ""
27057
27058 # type: =head2
27059 #. type: =head2
27060 #: ../fish/guestfish-actions.pod:2028
27061 msgid "inspect-get-product-name"
27062 msgstr ""
27063
27064 # type: verbatim
27065 #. type: verbatim
27066 #: ../fish/guestfish-actions.pod:2030
27067 #, no-wrap
27068 msgid ""
27069 " inspect-get-product-name root\n"
27070 "\n"
27071 msgstr ""
27072
27073 #. type: =head2
27074 #: ../fish/guestfish-actions.pod:2045
27075 msgid "inspect-get-product-variant"
27076 msgstr ""
27077
27078 #. type: verbatim
27079 #: ../fish/guestfish-actions.pod:2047
27080 #, no-wrap
27081 msgid ""
27082 " inspect-get-product-variant root\n"
27083 "\n"
27084 msgstr ""
27085
27086 #. type: textblock
27087 #: ../fish/guestfish-actions.pod:2071
27088 msgid ""
27089 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
27090 "get-product-name>, L</inspect-get-major-version>."
27091 msgstr ""
27092
27093 # type: =head2
27094 #. type: =head2
27095 #: ../fish/guestfish-actions.pod:2075
27096 msgid "inspect-get-roots"
27097 msgstr ""
27098
27099 # type: verbatim
27100 #. type: verbatim
27101 #: ../fish/guestfish-actions.pod:2077
27102 #, no-wrap
27103 msgid ""
27104 " inspect-get-roots\n"
27105 "\n"
27106 msgstr ""
27107
27108 # type: textblock
27109 #. type: textblock
27110 #: ../fish/guestfish-actions.pod:2079
27111 msgid ""
27112 "This function is a convenient way to get the list of root devices, as "
27113 "returned from a previous call to L</inspect-os>, but without redoing the "
27114 "whole inspection process."
27115 msgstr ""
27116
27117 # type: textblock
27118 #. type: textblock
27119 #: ../fish/guestfish-actions.pod:2083
27120 msgid ""
27121 "This returns an empty list if either no root devices were found or the "
27122 "caller has not called L</inspect-os>."
27123 msgstr ""
27124
27125 # type: =head2
27126 #. type: =head2
27127 #: ../fish/guestfish-actions.pod:2088
27128 msgid "inspect-get-type"
27129 msgstr ""
27130
27131 # type: verbatim
27132 #. type: verbatim
27133 #: ../fish/guestfish-actions.pod:2090
27134 #, no-wrap
27135 msgid ""
27136 " inspect-get-type root\n"
27137 "\n"
27138 msgstr ""
27139
27140 #. type: =head2
27141 #: ../fish/guestfish-actions.pod:2123
27142 msgid "inspect-get-windows-current-control-set"
27143 msgstr ""
27144
27145 #. type: verbatim
27146 #: ../fish/guestfish-actions.pod:2125
27147 #, no-wrap
27148 msgid ""
27149 " inspect-get-windows-current-control-set root\n"
27150 "\n"
27151 msgstr ""
27152
27153 # type: =head2
27154 #. type: =head2
27155 #: ../fish/guestfish-actions.pod:2139
27156 msgid "inspect-get-windows-systemroot"
27157 msgstr ""
27158
27159 # type: verbatim
27160 #. type: verbatim
27161 #: ../fish/guestfish-actions.pod:2141
27162 #, no-wrap
27163 msgid ""
27164 " inspect-get-windows-systemroot root\n"
27165 "\n"
27166 msgstr ""
27167
27168 #. type: =head2
27169 #: ../fish/guestfish-actions.pod:2155
27170 msgid "inspect-is-live"
27171 msgstr ""
27172
27173 #. type: verbatim
27174 #: ../fish/guestfish-actions.pod:2157
27175 #, no-wrap
27176 msgid ""
27177 " inspect-is-live root\n"
27178 "\n"
27179 msgstr ""
27180
27181 #. type: textblock
27182 #: ../fish/guestfish-actions.pod:2162
27183 msgid ""
27184 "If L</inspect-get-format> returns C<installer> (this is an install disk), "
27185 "then this returns true if a live image was detected on the disk."
27186 msgstr ""
27187
27188 #. type: =head2
27189 #: ../fish/guestfish-actions.pod:2168
27190 msgid "inspect-is-multipart"
27191 msgstr ""
27192
27193 #. type: verbatim
27194 #: ../fish/guestfish-actions.pod:2170
27195 #, no-wrap
27196 msgid ""
27197 " inspect-is-multipart root\n"
27198 "\n"
27199 msgstr ""
27200
27201 #. type: textblock
27202 #: ../fish/guestfish-actions.pod:2175
27203 msgid ""
27204 "If L</inspect-get-format> returns C<installer> (this is an install disk), "
27205 "then this returns true if the disk is part of a set."
27206 msgstr ""
27207
27208 #. type: =head2
27209 #: ../fish/guestfish-actions.pod:2181
27210 msgid "inspect-is-netinst"
27211 msgstr ""
27212
27213 #. type: verbatim
27214 #: ../fish/guestfish-actions.pod:2183
27215 #, no-wrap
27216 msgid ""
27217 " inspect-is-netinst root\n"
27218 "\n"
27219 msgstr ""
27220
27221 #. type: textblock
27222 #: ../fish/guestfish-actions.pod:2188
27223 msgid ""
27224 "If L</inspect-get-format> returns C<installer> (this is an install disk), "
27225 "then this returns true if the disk is a network installer, ie. not a self-"
27226 "contained install CD but one which is likely to require network access to "
27227 "complete the install."
27228 msgstr ""
27229
27230 # type: =head2
27231 #. type: =head2
27232 #: ../fish/guestfish-actions.pod:2196
27233 msgid "inspect-list-applications"
27234 msgstr ""
27235
27236 # type: verbatim
27237 #. type: verbatim
27238 #: ../fish/guestfish-actions.pod:2198
27239 #, no-wrap
27240 msgid ""
27241 " inspect-list-applications root\n"
27242 "\n"
27243 msgstr ""
27244
27245 # type: textblock
27246 #. type: textblock
27247 #: ../fish/guestfish-actions.pod:2205
27248 msgid ""
27249 "I<Note:> This call works differently from other parts of the inspection "
27250 "API.  You have to call L</inspect-os>, then L</inspect-get-mountpoints>, "
27251 "then mount up the disks, before calling this.  Listing applications is a "
27252 "significantly more difficult operation which requires access to the full "
27253 "filesystem.  Also note that unlike the other L</inspect-get-*> calls which "
27254 "are just returning data cached in the libguestfs handle, this call actually "
27255 "reads parts of the mounted filesystems during the call."
27256 msgstr ""
27257
27258 # type: =head2
27259 #. type: =head2
27260 #: ../fish/guestfish-actions.pod:2295
27261 msgid "inspect-os"
27262 msgstr ""
27263
27264 # type: verbatim
27265 #. type: verbatim
27266 #: ../fish/guestfish-actions.pod:2297
27267 #, no-wrap
27268 msgid ""
27269 " inspect-os\n"
27270 "\n"
27271 msgstr ""
27272
27273 # type: textblock
27274 #. type: textblock
27275 #: ../fish/guestfish-actions.pod:2312
27276 msgid ""
27277 "You can pass the root string(s) returned to other L</inspect-get-*> "
27278 "functions in order to query further information about each operating system, "
27279 "such as the name and version."
27280 msgstr ""
27281
27282 # type: textblock
27283 #. type: textblock
27284 #: ../fish/guestfish-actions.pod:2317
27285 msgid ""
27286 "This function uses other libguestfs features such as L</mount-ro> and L</"
27287 "umount-all> in order to mount and unmount filesystems and look at the "
27288 "contents.  This should be called with no disks currently mounted.  The "
27289 "function may also use Augeas, so any existing Augeas handle will be closed."
27290 msgstr ""
27291
27292 # type: textblock
27293 #. type: textblock
27294 #: ../fish/guestfish-actions.pod:2329 ../fish/guestfish-actions.pod:2505
27295 #: ../fish/guestfish-actions.pod:2551
27296 msgid "See also L</list-filesystems>."
27297 msgstr ""
27298
27299 # type: =head2
27300 #. type: =head2
27301 #: ../fish/guestfish-actions.pod:2331
27302 msgid "is-blockdev"
27303 msgstr ""
27304
27305 # type: verbatim
27306 #. type: verbatim
27307 #: ../fish/guestfish-actions.pod:2333
27308 #, no-wrap
27309 msgid ""
27310 " is-blockdev path\n"
27311 "\n"
27312 msgstr ""
27313
27314 # type: textblock
27315 #. type: textblock
27316 #: ../fish/guestfish-actions.pod:2338 ../fish/guestfish-actions.pod:2356
27317 #: ../fish/guestfish-actions.pod:2375 ../fish/guestfish-actions.pod:2384
27318 #: ../fish/guestfish-actions.pod:2394 ../fish/guestfish-actions.pod:2428
27319 #: ../fish/guestfish-actions.pod:2437
27320 msgid "See also L</stat>."
27321 msgstr ""
27322
27323 # type: =head2
27324 #. type: =head2
27325 #: ../fish/guestfish-actions.pod:2340
27326 msgid "is-busy"
27327 msgstr ""
27328
27329 # type: verbatim
27330 #. type: verbatim
27331 #: ../fish/guestfish-actions.pod:2342
27332 #, no-wrap
27333 msgid ""
27334 " is-busy\n"
27335 "\n"
27336 msgstr ""
27337
27338 # type: =head2
27339 #. type: =head2
27340 #: ../fish/guestfish-actions.pod:2349
27341 msgid "is-chardev"
27342 msgstr ""
27343
27344 # type: verbatim
27345 #. type: verbatim
27346 #: ../fish/guestfish-actions.pod:2351
27347 #, no-wrap
27348 msgid ""
27349 " is-chardev path\n"
27350 "\n"
27351 msgstr ""
27352
27353 # type: =head2
27354 #. type: =head2
27355 #: ../fish/guestfish-actions.pod:2358
27356 msgid "is-config"
27357 msgstr ""
27358
27359 # type: verbatim
27360 #. type: verbatim
27361 #: ../fish/guestfish-actions.pod:2360
27362 #, no-wrap
27363 msgid ""
27364 " is-config\n"
27365 "\n"
27366 msgstr ""
27367
27368 # type: =head2
27369 #. type: =head2
27370 #: ../fish/guestfish-actions.pod:2367
27371 msgid "is-dir"
27372 msgstr ""
27373
27374 # type: verbatim
27375 #. type: verbatim
27376 #: ../fish/guestfish-actions.pod:2369
27377 #, no-wrap
27378 msgid ""
27379 " is-dir path\n"
27380 "\n"
27381 msgstr ""
27382
27383 # type: =head2
27384 #. type: =head2
27385 #: ../fish/guestfish-actions.pod:2377
27386 msgid "is-fifo"
27387 msgstr ""
27388
27389 # type: verbatim
27390 #. type: verbatim
27391 #: ../fish/guestfish-actions.pod:2379
27392 #, no-wrap
27393 msgid ""
27394 " is-fifo path\n"
27395 "\n"
27396 msgstr ""
27397
27398 # type: =head2
27399 #. type: =head2
27400 #: ../fish/guestfish-actions.pod:2386
27401 msgid "is-file"
27402 msgstr ""
27403
27404 # type: verbatim
27405 #. type: verbatim
27406 #: ../fish/guestfish-actions.pod:2388
27407 #, no-wrap
27408 msgid ""
27409 " is-file path\n"
27410 "\n"
27411 msgstr ""
27412
27413 # type: =head2
27414 #. type: =head2
27415 #: ../fish/guestfish-actions.pod:2396
27416 msgid "is-launching"
27417 msgstr ""
27418
27419 # type: verbatim
27420 #. type: verbatim
27421 #: ../fish/guestfish-actions.pod:2398
27422 #, no-wrap
27423 msgid ""
27424 " is-launching\n"
27425 "\n"
27426 msgstr ""
27427
27428 # type: =head2
27429 #. type: =head2
27430 #: ../fish/guestfish-actions.pod:2405
27431 msgid "is-lv"
27432 msgstr ""
27433
27434 # type: verbatim
27435 #. type: verbatim
27436 #: ../fish/guestfish-actions.pod:2407
27437 #, no-wrap
27438 msgid ""
27439 " is-lv device\n"
27440 "\n"
27441 msgstr ""
27442
27443 # type: =head2
27444 #. type: =head2
27445 #: ../fish/guestfish-actions.pod:2412
27446 msgid "is-ready"
27447 msgstr ""
27448
27449 # type: verbatim
27450 #. type: verbatim
27451 #: ../fish/guestfish-actions.pod:2414
27452 #, no-wrap
27453 msgid ""
27454 " is-ready\n"
27455 "\n"
27456 msgstr ""
27457
27458 # type: =head2
27459 #. type: =head2
27460 #: ../fish/guestfish-actions.pod:2421
27461 msgid "is-socket"
27462 msgstr ""
27463
27464 # type: verbatim
27465 #. type: verbatim
27466 #: ../fish/guestfish-actions.pod:2423
27467 #, no-wrap
27468 msgid ""
27469 " is-socket path\n"
27470 "\n"
27471 msgstr ""
27472
27473 # type: =head2
27474 #. type: =head2
27475 #: ../fish/guestfish-actions.pod:2430
27476 msgid "is-symlink"
27477 msgstr ""
27478
27479 # type: verbatim
27480 #. type: verbatim
27481 #: ../fish/guestfish-actions.pod:2432
27482 #, no-wrap
27483 msgid ""
27484 " is-symlink path\n"
27485 "\n"
27486 msgstr ""
27487
27488 # type: =head2
27489 #. type: =head2
27490 #: ../fish/guestfish-actions.pod:2439
27491 msgid "kill-subprocess"
27492 msgstr ""
27493
27494 # type: verbatim
27495 #. type: verbatim
27496 #: ../fish/guestfish-actions.pod:2441
27497 #, no-wrap
27498 msgid ""
27499 " kill-subprocess\n"
27500 "\n"
27501 msgstr ""
27502
27503 # type: =head2
27504 #. type: =head2
27505 #: ../fish/guestfish-actions.pod:2445
27506 msgid "launch"
27507 msgstr ""
27508
27509 # type: =head2
27510 #. type: =head2
27511 #: ../fish/guestfish-actions.pod:2447
27512 msgid "run"
27513 msgstr ""
27514
27515 # type: verbatim
27516 #. type: verbatim
27517 #: ../fish/guestfish-actions.pod:2449
27518 #, no-wrap
27519 msgid ""
27520 " launch\n"
27521 "\n"
27522 msgstr ""
27523
27524 # type: =head2
27525 #. type: =head2
27526 #: ../fish/guestfish-actions.pod:2457
27527 msgid "lchown"
27528 msgstr ""
27529
27530 # type: verbatim
27531 #. type: verbatim
27532 #: ../fish/guestfish-actions.pod:2459
27533 #, no-wrap
27534 msgid ""
27535 " lchown owner group path\n"
27536 "\n"
27537 msgstr ""
27538
27539 # type: textblock
27540 #. type: textblock
27541 #: ../fish/guestfish-actions.pod:2461
27542 msgid ""
27543 "Change the file owner to C<owner> and group to C<group>.  This is like L</"
27544 "chown> but if C<path> is a symlink then the link itself is changed, not the "
27545 "target."
27546 msgstr ""
27547
27548 # type: =head2
27549 #. type: =head2
27550 #: ../fish/guestfish-actions.pod:2469
27551 msgid "lgetxattr"
27552 msgstr ""
27553
27554 # type: verbatim
27555 #. type: verbatim
27556 #: ../fish/guestfish-actions.pod:2471
27557 #, no-wrap
27558 msgid ""
27559 " lgetxattr path name\n"
27560 "\n"
27561 msgstr ""
27562
27563 # type: textblock
27564 #. type: textblock
27565 #: ../fish/guestfish-actions.pod:2487
27566 msgid "See also: L</lgetxattrs>, L</getxattr>, L<attr(5)>."
27567 msgstr ""
27568
27569 # type: =head2
27570 #. type: =head2
27571 #: ../fish/guestfish-actions.pod:2489
27572 msgid "lgetxattrs"
27573 msgstr ""
27574
27575 # type: verbatim
27576 #. type: verbatim
27577 #: ../fish/guestfish-actions.pod:2491
27578 #, no-wrap
27579 msgid ""
27580 " lgetxattrs path\n"
27581 "\n"
27582 msgstr ""
27583
27584 # type: textblock
27585 #. type: textblock
27586 #: ../fish/guestfish-actions.pod:2493
27587 msgid ""
27588 "This is the same as L</getxattrs>, but if C<path> is a symbolic link, then "
27589 "it returns the extended attributes of the link itself."
27590 msgstr ""
27591
27592 # type: =head2
27593 #. type: =head2
27594 #: ../fish/guestfish-actions.pod:2497
27595 msgid "list-devices"
27596 msgstr ""
27597
27598 # type: verbatim
27599 #. type: verbatim
27600 #: ../fish/guestfish-actions.pod:2499
27601 #, no-wrap
27602 msgid ""
27603 " list-devices\n"
27604 "\n"
27605 msgstr ""
27606
27607 # type: =head2
27608 #. type: =head2
27609 #: ../fish/guestfish-actions.pod:2507
27610 msgid "list-filesystems"
27611 msgstr ""
27612
27613 # type: verbatim
27614 #. type: verbatim
27615 #: ../fish/guestfish-actions.pod:2509
27616 #, no-wrap
27617 msgid ""
27618 " list-filesystems\n"
27619 "\n"
27620 msgstr ""
27621
27622 # type: textblock
27623 #. type: textblock
27624 #: ../fish/guestfish-actions.pod:2528
27625 msgid ""
27626 "This command runs other libguestfs commands, which might include L</mount> "
27627 "and L</umount>, and therefore you should use this soon after launch and only "
27628 "when nothing is mounted."
27629 msgstr ""
27630
27631 # type: textblock
27632 #. type: textblock
27633 #: ../fish/guestfish-actions.pod:2532
27634 msgid ""
27635 "Not all of the filesystems returned will be mountable.  In particular, swap "
27636 "partitions are returned in the list.  Also this command does not check that "
27637 "each filesystem found is valid and mountable, and some filesystems might be "
27638 "mountable but require special options.  Filesystems may not all belong to a "
27639 "single logical operating system (use L</inspect-os> to look for OSes)."
27640 msgstr ""
27641
27642 # type: =head2
27643 #. type: =head2
27644 #: ../fish/guestfish-actions.pod:2540
27645 msgid "list-partitions"
27646 msgstr ""
27647
27648 # type: verbatim
27649 #. type: verbatim
27650 #: ../fish/guestfish-actions.pod:2542
27651 #, no-wrap
27652 msgid ""
27653 " list-partitions\n"
27654 "\n"
27655 msgstr ""
27656
27657 # type: textblock
27658 #. type: textblock
27659 #: ../fish/guestfish-actions.pod:2548
27660 msgid ""
27661 "This does not return logical volumes.  For that you will need to call L</"
27662 "lvs>."
27663 msgstr ""
27664
27665 # type: =head2
27666 #. type: =head2
27667 #: ../fish/guestfish-actions.pod:2553
27668 msgid "ll"
27669 msgstr ""
27670
27671 # type: verbatim
27672 #. type: verbatim
27673 #: ../fish/guestfish-actions.pod:2555
27674 #, no-wrap
27675 msgid ""
27676 " ll directory\n"
27677 "\n"
27678 msgstr ""
27679
27680 # type: =head2
27681 #. type: =head2
27682 #: ../fish/guestfish-actions.pod:2563
27683 msgid "ln"
27684 msgstr ""
27685
27686 # type: verbatim
27687 #. type: verbatim
27688 #: ../fish/guestfish-actions.pod:2565
27689 #, no-wrap
27690 msgid ""
27691 " ln target linkname\n"
27692 "\n"
27693 msgstr ""
27694
27695 # type: =head2
27696 #. type: =head2
27697 #: ../fish/guestfish-actions.pod:2569
27698 msgid "ln-f"
27699 msgstr ""
27700
27701 # type: verbatim
27702 #. type: verbatim
27703 #: ../fish/guestfish-actions.pod:2571
27704 #, no-wrap
27705 msgid ""
27706 " ln-f target linkname\n"
27707 "\n"
27708 msgstr ""
27709
27710 # type: =head2
27711 #. type: =head2
27712 #: ../fish/guestfish-actions.pod:2576
27713 msgid "ln-s"
27714 msgstr ""
27715
27716 # type: verbatim
27717 #. type: verbatim
27718 #: ../fish/guestfish-actions.pod:2578
27719 #, no-wrap
27720 msgid ""
27721 " ln-s target linkname\n"
27722 "\n"
27723 msgstr ""
27724
27725 # type: =head2
27726 #. type: =head2
27727 #: ../fish/guestfish-actions.pod:2582
27728 msgid "ln-sf"
27729 msgstr ""
27730
27731 # type: verbatim
27732 #. type: verbatim
27733 #: ../fish/guestfish-actions.pod:2584
27734 #, no-wrap
27735 msgid ""
27736 " ln-sf target linkname\n"
27737 "\n"
27738 msgstr ""
27739
27740 # type: =head2
27741 #. type: =head2
27742 #: ../fish/guestfish-actions.pod:2589
27743 msgid "lremovexattr"
27744 msgstr ""
27745
27746 # type: verbatim
27747 #. type: verbatim
27748 #: ../fish/guestfish-actions.pod:2591
27749 #, no-wrap
27750 msgid ""
27751 " lremovexattr xattr path\n"
27752 "\n"
27753 msgstr ""
27754
27755 # type: textblock
27756 #. type: textblock
27757 #: ../fish/guestfish-actions.pod:2593
27758 msgid ""
27759 "This is the same as L</removexattr>, but if C<path> is a symbolic link, then "
27760 "it removes an extended attribute of the link itself."
27761 msgstr ""
27762
27763 # type: =head2
27764 #. type: =head2
27765 #: ../fish/guestfish-actions.pod:2597
27766 msgid "ls"
27767 msgstr ""
27768
27769 # type: verbatim
27770 #. type: verbatim
27771 #: ../fish/guestfish-actions.pod:2599
27772 #, no-wrap
27773 msgid ""
27774 " ls directory\n"
27775 "\n"
27776 msgstr ""
27777
27778 # type: textblock
27779 #. type: textblock
27780 #: ../fish/guestfish-actions.pod:2605
27781 msgid ""
27782 "This command is mostly useful for interactive sessions.  Programs should "
27783 "probably use L</readdir> instead."
27784 msgstr ""
27785
27786 # type: =head2
27787 #. type: =head2
27788 #: ../fish/guestfish-actions.pod:2608
27789 msgid "lsetxattr"
27790 msgstr ""
27791
27792 # type: verbatim
27793 #. type: verbatim
27794 #: ../fish/guestfish-actions.pod:2610
27795 #, no-wrap
27796 msgid ""
27797 " lsetxattr xattr val vallen path\n"
27798 "\n"
27799 msgstr ""
27800
27801 # type: textblock
27802 #. type: textblock
27803 #: ../fish/guestfish-actions.pod:2612
27804 msgid ""
27805 "This is the same as L</setxattr>, but if C<path> is a symbolic link, then it "
27806 "sets an extended attribute of the link itself."
27807 msgstr ""
27808
27809 # type: =head2
27810 #. type: =head2
27811 #: ../fish/guestfish-actions.pod:2616
27812 msgid "lstat"
27813 msgstr ""
27814
27815 # type: verbatim
27816 #. type: verbatim
27817 #: ../fish/guestfish-actions.pod:2618
27818 #, no-wrap
27819 msgid ""
27820 " lstat path\n"
27821 "\n"
27822 msgstr ""
27823
27824 # type: textblock
27825 #. type: textblock
27826 #: ../fish/guestfish-actions.pod:2622
27827 msgid ""
27828 "This is the same as L</stat> except that if C<path> is a symbolic link, then "
27829 "the link is stat-ed, not the file it refers to."
27830 msgstr ""
27831
27832 # type: =head2
27833 #. type: =head2
27834 #: ../fish/guestfish-actions.pod:2628
27835 msgid "lstatlist"
27836 msgstr ""
27837
27838 # type: verbatim
27839 #. type: verbatim
27840 #: ../fish/guestfish-actions.pod:2630
27841 #, no-wrap
27842 msgid ""
27843 " lstatlist path 'names ...'\n"
27844 "\n"
27845 msgstr ""
27846
27847 # type: textblock
27848 #. type: textblock
27849 #: ../fish/guestfish-actions.pod:2632
27850 msgid ""
27851 "This call allows you to perform the L</lstat> operation on multiple files, "
27852 "where all files are in the directory C<path>.  C<names> is the list of files "
27853 "from this directory."
27854 msgstr ""
27855
27856 # type: textblock
27857 #. type: textblock
27858 #: ../fish/guestfish-actions.pod:2641
27859 msgid ""
27860 "This call is intended for programs that want to efficiently list a directory "
27861 "contents without making many round-trips.  See also L</lxattrlist> for a "
27862 "similarly efficient call for getting extended attributes.  Very long "
27863 "directory listings might cause the protocol message size to be exceeded, "
27864 "causing this call to fail.  The caller must split up such requests into "
27865 "smaller groups of names."
27866 msgstr ""
27867
27868 # type: =head2
27869 #. type: =head2
27870 #: ../fish/guestfish-actions.pod:2649
27871 msgid "luks-add-key"
27872 msgstr ""
27873
27874 # type: verbatim
27875 #. type: verbatim
27876 #: ../fish/guestfish-actions.pod:2651
27877 #, no-wrap
27878 msgid ""
27879 " luks-add-key device keyslot\n"
27880 "\n"
27881 msgstr ""
27882
27883 # type: textblock
27884 #. type: textblock
27885 #: ../fish/guestfish-actions.pod:2658
27886 msgid ""
27887 "Note that if C<keyslot> already contains a key, then this command will "
27888 "fail.  You have to use L</luks-kill-slot> first to remove that key."
27889 msgstr ""
27890
27891 # type: textblock
27892 #. type: textblock
27893 #: ../fish/guestfish-actions.pod:2662 ../fish/guestfish-actions.pod:2684
27894 #: ../fish/guestfish-actions.pod:2697 ../fish/guestfish-actions.pod:2711
27895 #: ../fish/guestfish-actions.pod:2734 ../fish/guestfish-actions.pod:2744
27896 msgid ""
27897 "This command has one or more key or passphrase parameters.  Guestfish will "
27898 "prompt for these separately."
27899 msgstr ""
27900
27901 # type: =head2
27902 #. type: =head2
27903 #: ../fish/guestfish-actions.pod:2665
27904 msgid "luks-close"
27905 msgstr ""
27906
27907 # type: verbatim
27908 #. type: verbatim
27909 #: ../fish/guestfish-actions.pod:2667
27910 #, no-wrap
27911 msgid ""
27912 " luks-close device\n"
27913 "\n"
27914 msgstr ""
27915
27916 # type: textblock
27917 #. type: textblock
27918 #: ../fish/guestfish-actions.pod:2669
27919 msgid ""
27920 "This closes a LUKS device that was created earlier by L</luks-open> or L</"
27921 "luks-open-ro>.  The C<device> parameter must be the name of the LUKS mapping "
27922 "device (ie. C</dev/mapper/mapname>) and I<not> the name of the underlying "
27923 "block device."
27924 msgstr ""
27925
27926 # type: =head2
27927 #. type: =head2
27928 #: ../fish/guestfish-actions.pod:2675
27929 msgid "luks-format"
27930 msgstr ""
27931
27932 # type: verbatim
27933 #. type: verbatim
27934 #: ../fish/guestfish-actions.pod:2677
27935 #, no-wrap
27936 msgid ""
27937 " luks-format device keyslot\n"
27938 "\n"
27939 msgstr ""
27940
27941 # type: =head2
27942 #. type: =head2
27943 #: ../fish/guestfish-actions.pod:2690
27944 msgid "luks-format-cipher"
27945 msgstr ""
27946
27947 # type: verbatim
27948 #. type: verbatim
27949 #: ../fish/guestfish-actions.pod:2692
27950 #, no-wrap
27951 msgid ""
27952 " luks-format-cipher device keyslot cipher\n"
27953 "\n"
27954 msgstr ""
27955
27956 # type: textblock
27957 #. type: textblock
27958 #: ../fish/guestfish-actions.pod:2694
27959 msgid ""
27960 "This command is the same as L</luks-format> but it also allows you to set "
27961 "the C<cipher> used."
27962 msgstr ""
27963
27964 # type: =head2
27965 #. type: =head2
27966 #: ../fish/guestfish-actions.pod:2703
27967 msgid "luks-kill-slot"
27968 msgstr ""
27969
27970 # type: verbatim
27971 #. type: verbatim
27972 #: ../fish/guestfish-actions.pod:2705
27973 #, no-wrap
27974 msgid ""
27975 " luks-kill-slot device keyslot\n"
27976 "\n"
27977 msgstr ""
27978
27979 # type: =head2
27980 #. type: =head2
27981 #: ../fish/guestfish-actions.pod:2714
27982 msgid "luks-open"
27983 msgstr ""
27984
27985 # type: verbatim
27986 #. type: verbatim
27987 #: ../fish/guestfish-actions.pod:2716
27988 #, no-wrap
27989 msgid ""
27990 " luks-open device mapname\n"
27991 "\n"
27992 msgstr ""
27993
27994 # type: textblock
27995 #. type: textblock
27996 #: ../fish/guestfish-actions.pod:2730
27997 msgid ""
27998 "If this block device contains LVM volume groups, then calling L</vgscan> "
27999 "followed by L</vg-activate-all> will make them visible."
28000 msgstr ""
28001
28002 # type: =head2
28003 #. type: =head2
28004 #: ../fish/guestfish-actions.pod:2737
28005 msgid "luks-open-ro"
28006 msgstr ""
28007
28008 # type: verbatim
28009 #. type: verbatim
28010 #: ../fish/guestfish-actions.pod:2739
28011 #, no-wrap
28012 msgid ""
28013 " luks-open-ro device mapname\n"
28014 "\n"
28015 msgstr ""
28016
28017 # type: textblock
28018 #. type: textblock
28019 #: ../fish/guestfish-actions.pod:2741
28020 msgid ""
28021 "This is the same as L</luks-open> except that a read-only mapping is created."
28022 msgstr ""
28023
28024 # type: =head2
28025 #. type: =head2
28026 #: ../fish/guestfish-actions.pod:2747
28027 msgid "lvcreate"
28028 msgstr ""
28029
28030 # type: verbatim
28031 #. type: verbatim
28032 #: ../fish/guestfish-actions.pod:2749
28033 #, no-wrap
28034 msgid ""
28035 " lvcreate logvol volgroup mbytes\n"
28036 "\n"
28037 msgstr ""
28038
28039 # type: =head2
28040 #. type: =head2
28041 #: ../fish/guestfish-actions.pod:2754
28042 msgid "lvm-canonical-lv-name"
28043 msgstr ""
28044
28045 # type: verbatim
28046 #. type: verbatim
28047 #: ../fish/guestfish-actions.pod:2756
28048 #, no-wrap
28049 msgid ""
28050 " lvm-canonical-lv-name lvname\n"
28051 "\n"
28052 msgstr ""
28053
28054 # type: textblock
28055 #. type: textblock
28056 #: ../fish/guestfish-actions.pod:2765
28057 msgid "See also L</is-lv>."
28058 msgstr ""
28059
28060 # type: =head2
28061 #. type: =head2
28062 #: ../fish/guestfish-actions.pod:2767
28063 msgid "lvm-clear-filter"
28064 msgstr ""
28065
28066 # type: verbatim
28067 #. type: verbatim
28068 #: ../fish/guestfish-actions.pod:2769
28069 #, no-wrap
28070 msgid ""
28071 " lvm-clear-filter\n"
28072 "\n"
28073 msgstr ""
28074
28075 # type: textblock
28076 #. type: textblock
28077 #: ../fish/guestfish-actions.pod:2771
28078 msgid ""
28079 "This undoes the effect of L</lvm-set-filter>.  LVM will be able to see every "
28080 "block device."
28081 msgstr ""
28082
28083 # type: =head2
28084 #. type: =head2
28085 #: ../fish/guestfish-actions.pod:2777
28086 msgid "lvm-remove-all"
28087 msgstr ""
28088
28089 # type: verbatim
28090 #. type: verbatim
28091 #: ../fish/guestfish-actions.pod:2779
28092 #, no-wrap
28093 msgid ""
28094 " lvm-remove-all\n"
28095 "\n"
28096 msgstr ""
28097
28098 # type: =head2
28099 #. type: =head2
28100 #: ../fish/guestfish-actions.pod:2787
28101 msgid "lvm-set-filter"
28102 msgstr ""
28103
28104 # type: verbatim
28105 #. type: verbatim
28106 #: ../fish/guestfish-actions.pod:2789
28107 #, no-wrap
28108 msgid ""
28109 " lvm-set-filter 'devices ...'\n"
28110 "\n"
28111 msgstr ""
28112
28113 # type: =head2
28114 #. type: =head2
28115 #: ../fish/guestfish-actions.pod:2814
28116 msgid "lvremove"
28117 msgstr ""
28118
28119 # type: verbatim
28120 #. type: verbatim
28121 #: ../fish/guestfish-actions.pod:2816
28122 #, no-wrap
28123 msgid ""
28124 " lvremove device\n"
28125 "\n"
28126 msgstr ""
28127
28128 # type: =head2
28129 #. type: =head2
28130 #: ../fish/guestfish-actions.pod:2824
28131 msgid "lvrename"
28132 msgstr ""
28133
28134 # type: verbatim
28135 #. type: verbatim
28136 #: ../fish/guestfish-actions.pod:2826
28137 #, no-wrap
28138 msgid ""
28139 " lvrename logvol newlogvol\n"
28140 "\n"
28141 msgstr ""
28142
28143 # type: =head2
28144 #. type: =head2
28145 #: ../fish/guestfish-actions.pod:2830
28146 msgid "lvresize"
28147 msgstr ""
28148
28149 # type: verbatim
28150 #. type: verbatim
28151 #: ../fish/guestfish-actions.pod:2832
28152 #, no-wrap
28153 msgid ""
28154 " lvresize device mbytes\n"
28155 "\n"
28156 msgstr ""
28157
28158 # type: =head2
28159 #. type: =head2
28160 #: ../fish/guestfish-actions.pod:2838
28161 msgid "lvresize-free"
28162 msgstr ""
28163
28164 # type: verbatim
28165 #. type: verbatim
28166 #: ../fish/guestfish-actions.pod:2840
28167 #, no-wrap
28168 msgid ""
28169 " lvresize-free lv percent\n"
28170 "\n"
28171 msgstr ""
28172
28173 # type: =head2
28174 #. type: =head2
28175 #: ../fish/guestfish-actions.pod:2848
28176 msgid "lvs"
28177 msgstr ""
28178
28179 # type: verbatim
28180 #. type: verbatim
28181 #: ../fish/guestfish-actions.pod:2850
28182 #, no-wrap
28183 msgid ""
28184 " lvs\n"
28185 "\n"
28186 msgstr ""
28187
28188 # type: textblock
28189 #. type: textblock
28190 #: ../fish/guestfish-actions.pod:2858
28191 msgid "See also L</lvs-full>, L</list-filesystems>."
28192 msgstr ""
28193
28194 # type: =head2
28195 #. type: =head2
28196 #: ../fish/guestfish-actions.pod:2860
28197 msgid "lvs-full"
28198 msgstr ""
28199
28200 # type: verbatim
28201 #. type: verbatim
28202 #: ../fish/guestfish-actions.pod:2862
28203 #, no-wrap
28204 msgid ""
28205 " lvs-full\n"
28206 "\n"
28207 msgstr ""
28208
28209 # type: =head2
28210 #. type: =head2
28211 #: ../fish/guestfish-actions.pod:2867
28212 msgid "lvuuid"
28213 msgstr ""
28214
28215 # type: verbatim
28216 #. type: verbatim
28217 #: ../fish/guestfish-actions.pod:2869
28218 #, no-wrap
28219 msgid ""
28220 " lvuuid device\n"
28221 "\n"
28222 msgstr ""
28223
28224 # type: =head2
28225 #. type: =head2
28226 #: ../fish/guestfish-actions.pod:2873
28227 msgid "lxattrlist"
28228 msgstr ""
28229
28230 # type: verbatim
28231 #. type: verbatim
28232 #: ../fish/guestfish-actions.pod:2875
28233 #, no-wrap
28234 msgid ""
28235 " lxattrlist path 'names ...'\n"
28236 "\n"
28237 msgstr ""
28238
28239 # type: textblock
28240 #. type: textblock
28241 #: ../fish/guestfish-actions.pod:2891
28242 msgid ""
28243 "This call is intended for programs that want to efficiently list a directory "
28244 "contents without making many round-trips.  See also L</lstatlist> for a "
28245 "similarly efficient call for getting standard stats.  Very long directory "
28246 "listings might cause the protocol message size to be exceeded, causing this "
28247 "call to fail.  The caller must split up such requests into smaller groups of "
28248 "names."
28249 msgstr ""
28250
28251 # type: =head2
28252 #. type: =head2
28253 #: ../fish/guestfish-actions.pod:2899
28254 msgid "mkdir"
28255 msgstr ""
28256
28257 # type: verbatim
28258 #. type: verbatim
28259 #: ../fish/guestfish-actions.pod:2901
28260 #, no-wrap
28261 msgid ""
28262 " mkdir path\n"
28263 "\n"
28264 msgstr ""
28265
28266 # type: =head2
28267 #. type: =head2
28268 #: ../fish/guestfish-actions.pod:2905
28269 msgid "mkdir-mode"
28270 msgstr ""
28271
28272 # type: verbatim
28273 #. type: verbatim
28274 #: ../fish/guestfish-actions.pod:2907
28275 #, no-wrap
28276 msgid ""
28277 " mkdir-mode path mode\n"
28278 "\n"
28279 msgstr ""
28280
28281 # type: textblock
28282 #. type: textblock
28283 #: ../fish/guestfish-actions.pod:2916
28284 msgid "See also L</mkdir>, L</umask>"
28285 msgstr ""
28286
28287 # type: =head2
28288 #. type: =head2
28289 #: ../fish/guestfish-actions.pod:2918
28290 msgid "mkdir-p"
28291 msgstr ""
28292
28293 # type: verbatim
28294 #. type: verbatim
28295 #: ../fish/guestfish-actions.pod:2920
28296 #, no-wrap
28297 msgid ""
28298 " mkdir-p path\n"
28299 "\n"
28300 msgstr ""
28301
28302 # type: =head2
28303 #. type: =head2
28304 #: ../fish/guestfish-actions.pod:2925
28305 msgid "mkdtemp"
28306 msgstr ""
28307
28308 # type: verbatim
28309 #. type: verbatim
28310 #: ../fish/guestfish-actions.pod:2927
28311 #, no-wrap
28312 msgid ""
28313 " mkdtemp template\n"
28314 "\n"
28315 msgstr ""
28316
28317 # type: =head2
28318 #. type: =head2
28319 #: ../fish/guestfish-actions.pod:2948
28320 msgid "mke2fs-J"
28321 msgstr ""
28322
28323 # type: verbatim
28324 #. type: verbatim
28325 #: ../fish/guestfish-actions.pod:2950
28326 #, no-wrap
28327 msgid ""
28328 " mke2fs-J fstype blocksize device journal\n"
28329 "\n"
28330 msgstr ""
28331
28332 # type: textblock
28333 #. type: textblock
28334 #: ../fish/guestfish-actions.pod:2958
28335 msgid "See also L</mke2journal>."
28336 msgstr ""
28337
28338 # type: =head2
28339 #. type: =head2
28340 #: ../fish/guestfish-actions.pod:2960
28341 msgid "mke2fs-JL"
28342 msgstr ""
28343
28344 # type: verbatim
28345 #. type: verbatim
28346 #: ../fish/guestfish-actions.pod:2962
28347 #, no-wrap
28348 msgid ""
28349 " mke2fs-JL fstype blocksize device label\n"
28350 "\n"
28351 msgstr ""
28352
28353 # type: textblock
28354 #. type: textblock
28355 #: ../fish/guestfish-actions.pod:2967
28356 msgid "See also L</mke2journal-L>."
28357 msgstr ""
28358
28359 # type: =head2
28360 #. type: =head2
28361 #: ../fish/guestfish-actions.pod:2969
28362 msgid "mke2fs-JU"
28363 msgstr ""
28364
28365 # type: verbatim
28366 #. type: verbatim
28367 #: ../fish/guestfish-actions.pod:2971
28368 #, no-wrap
28369 msgid ""
28370 " mke2fs-JU fstype blocksize device uuid\n"
28371 "\n"
28372 msgstr ""
28373
28374 # type: textblock
28375 #. type: textblock
28376 #: ../fish/guestfish-actions.pod:2976
28377 msgid "See also L</mke2journal-U>."
28378 msgstr ""
28379
28380 # type: =head2
28381 #. type: =head2
28382 #: ../fish/guestfish-actions.pod:2978
28383 msgid "mke2journal"
28384 msgstr ""
28385
28386 # type: verbatim
28387 #. type: verbatim
28388 #: ../fish/guestfish-actions.pod:2980
28389 #, no-wrap
28390 msgid ""
28391 " mke2journal blocksize device\n"
28392 "\n"
28393 msgstr ""
28394
28395 # type: =head2
28396 #. type: =head2
28397 #: ../fish/guestfish-actions.pod:2987
28398 msgid "mke2journal-L"
28399 msgstr ""
28400
28401 # type: verbatim
28402 #. type: verbatim
28403 #: ../fish/guestfish-actions.pod:2989
28404 #, no-wrap
28405 msgid ""
28406 " mke2journal-L blocksize label device\n"
28407 "\n"
28408 msgstr ""
28409
28410 # type: =head2
28411 #. type: =head2
28412 #: ../fish/guestfish-actions.pod:2993
28413 msgid "mke2journal-U"
28414 msgstr ""
28415
28416 # type: verbatim
28417 #. type: verbatim
28418 #: ../fish/guestfish-actions.pod:2995
28419 #, no-wrap
28420 msgid ""
28421 " mke2journal-U blocksize uuid device\n"
28422 "\n"
28423 msgstr ""
28424
28425 # type: =head2
28426 #. type: =head2
28427 #: ../fish/guestfish-actions.pod:2999
28428 msgid "mkfifo"
28429 msgstr ""
28430
28431 # type: verbatim
28432 #. type: verbatim
28433 #: ../fish/guestfish-actions.pod:3001
28434 #, no-wrap
28435 msgid ""
28436 " mkfifo mode path\n"
28437 "\n"
28438 msgstr ""
28439
28440 # type: textblock
28441 #. type: textblock
28442 #: ../fish/guestfish-actions.pod:3003
28443 msgid ""
28444 "This call creates a FIFO (named pipe) called C<path> with mode C<mode>.  It "
28445 "is just a convenient wrapper around L</mknod>."
28446 msgstr ""
28447
28448 # type: =head2
28449 #. type: =head2
28450 #: ../fish/guestfish-actions.pod:3009
28451 msgid "mkfs"
28452 msgstr ""
28453
28454 # type: verbatim
28455 #. type: verbatim
28456 #: ../fish/guestfish-actions.pod:3011
28457 #, no-wrap
28458 msgid ""
28459 " mkfs fstype device\n"
28460 "\n"
28461 msgstr ""
28462
28463 # type: =head2
28464 #. type: =head2
28465 #: ../fish/guestfish-actions.pod:3017
28466 msgid "mkfs-b"
28467 msgstr ""
28468
28469 # type: verbatim
28470 #. type: verbatim
28471 #: ../fish/guestfish-actions.pod:3019
28472 #, no-wrap
28473 msgid ""
28474 " mkfs-b fstype blocksize device\n"
28475 "\n"
28476 msgstr ""
28477
28478 # type: textblock
28479 #. type: textblock
28480 #: ../fish/guestfish-actions.pod:3021
28481 msgid ""
28482 "This call is similar to L</mkfs>, but it allows you to control the block "
28483 "size of the resulting filesystem.  Supported block sizes depend on the "
28484 "filesystem type, but typically they are C<1024>, C<2048> or C<4096> only."
28485 msgstr ""
28486
28487 #. type: textblock
28488 #: ../fish/guestfish-actions.pod:3029
28489 msgid ""
28490 "This function is deprecated.  In new code, use the L</mkfs_opts> call "
28491 "instead."
28492 msgstr ""
28493
28494 # type: =head2
28495 #. type: =head2
28496 #: ../fish/guestfish-actions.pod:3036
28497 msgid "mkfs-opts"
28498 msgstr ""
28499
28500 #. type: verbatim
28501 #: ../fish/guestfish-actions.pod:3038
28502 #, no-wrap
28503 msgid ""
28504 " mkfs-opts fstype device [blocksize:..] [features:..]\n"
28505 "\n"
28506 msgstr ""
28507
28508 # type: =head2
28509 #. type: =head2
28510 #: ../fish/guestfish-actions.pod:3073
28511 msgid "mkmountpoint"
28512 msgstr ""
28513
28514 # type: verbatim
28515 #. type: verbatim
28516 #: ../fish/guestfish-actions.pod:3075
28517 #, no-wrap
28518 msgid ""
28519 " mkmountpoint exemptpath\n"
28520 "\n"
28521 msgstr ""
28522
28523 # type: textblock
28524 #. type: textblock
28525 #: ../fish/guestfish-actions.pod:3077
28526 msgid ""
28527 "L</mkmountpoint> and L</rmmountpoint> are specialized calls that can be used "
28528 "to create extra mountpoints before mounting the first filesystem."
28529 msgstr ""
28530
28531 # type: textblock
28532 #. type: textblock
28533 #: ../fish/guestfish-actions.pod:3101
28534 msgid ""
28535 "L</mkmountpoint> is not compatible with L</umount-all>.  You may get "
28536 "unexpected errors if you try to mix these calls.  It is safest to manually "
28537 "unmount filesystems and remove mountpoints after use."
28538 msgstr ""
28539
28540 # type: textblock
28541 #. type: textblock
28542 #: ../fish/guestfish-actions.pod:3105
28543 msgid ""
28544 "L</umount-all> unmounts filesystems by sorting the paths longest first, so "
28545 "for this to work for manual mountpoints, you must ensure that the innermost "
28546 "mountpoints have the longest pathnames, as in the example code above."
28547 msgstr ""
28548
28549 #. type: textblock
28550 #: ../fish/guestfish-actions.pod:3112
28551 msgid ""
28552 "Autosync [see L</set-autosync>, this is set by default on handles] can cause "
28553 "L</umount-all> to be called when the handle is closed which can also trigger "
28554 "these issues."
28555 msgstr ""
28556
28557 # type: =head2
28558 #. type: =head2
28559 #: ../fish/guestfish-actions.pod:3116
28560 msgid "mknod"
28561 msgstr ""
28562
28563 # type: verbatim
28564 #. type: verbatim
28565 #: ../fish/guestfish-actions.pod:3118
28566 #, no-wrap
28567 msgid ""
28568 " mknod mode devmajor devminor path\n"
28569 "\n"
28570 msgstr ""
28571
28572 # type: textblock
28573 #. type: textblock
28574 #: ../fish/guestfish-actions.pod:3128
28575 msgid ""
28576 "Note that, just like L<mknod(2)>, the mode must be bitwise OR'd with "
28577 "S_IFBLK, S_IFCHR, S_IFIFO or S_IFSOCK (otherwise this call just creates a "
28578 "regular file).  These constants are available in the standard Linux header "
28579 "files, or you can use L</mknod-b>, L</mknod-c> or L</mkfifo> which are "
28580 "wrappers around this command which bitwise OR in the appropriate constant "
28581 "for you."
28582 msgstr ""
28583
28584 # type: =head2
28585 #. type: =head2
28586 #: ../fish/guestfish-actions.pod:3138
28587 msgid "mknod-b"
28588 msgstr ""
28589
28590 # type: verbatim
28591 #. type: verbatim
28592 #: ../fish/guestfish-actions.pod:3140
28593 #, no-wrap
28594 msgid ""
28595 " mknod-b mode devmajor devminor path\n"
28596 "\n"
28597 msgstr ""
28598
28599 # type: textblock
28600 #. type: textblock
28601 #: ../fish/guestfish-actions.pod:3142
28602 msgid ""
28603 "This call creates a block device node called C<path> with mode C<mode> and "
28604 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
28605 "wrapper around L</mknod>."
28606 msgstr ""
28607
28608 # type: =head2
28609 #. type: =head2
28610 #: ../fish/guestfish-actions.pod:3148
28611 msgid "mknod-c"
28612 msgstr ""
28613
28614 # type: verbatim
28615 #. type: verbatim
28616 #: ../fish/guestfish-actions.pod:3150
28617 #, no-wrap
28618 msgid ""
28619 " mknod-c mode devmajor devminor path\n"
28620 "\n"
28621 msgstr ""
28622
28623 # type: textblock
28624 #. type: textblock
28625 #: ../fish/guestfish-actions.pod:3152
28626 msgid ""
28627 "This call creates a char device node called C<path> with mode C<mode> and "
28628 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
28629 "wrapper around L</mknod>."
28630 msgstr ""
28631
28632 # type: =head2
28633 #. type: =head2
28634 #: ../fish/guestfish-actions.pod:3158
28635 msgid "mkswap"
28636 msgstr ""
28637
28638 # type: verbatim
28639 #. type: verbatim
28640 #: ../fish/guestfish-actions.pod:3160
28641 #, no-wrap
28642 msgid ""
28643 " mkswap device\n"
28644 "\n"
28645 msgstr ""
28646
28647 # type: =head2
28648 #. type: =head2
28649 #: ../fish/guestfish-actions.pod:3164
28650 msgid "mkswap-L"
28651 msgstr ""
28652
28653 # type: verbatim
28654 #. type: verbatim
28655 #: ../fish/guestfish-actions.pod:3166
28656 #, no-wrap
28657 msgid ""
28658 " mkswap-L label device\n"
28659 "\n"
28660 msgstr ""
28661
28662 # type: =head2
28663 #. type: =head2
28664 #: ../fish/guestfish-actions.pod:3174
28665 msgid "mkswap-U"
28666 msgstr ""
28667
28668 # type: verbatim
28669 #. type: verbatim
28670 #: ../fish/guestfish-actions.pod:3176
28671 #, no-wrap
28672 msgid ""
28673 " mkswap-U uuid device\n"
28674 "\n"
28675 msgstr ""
28676
28677 # type: =head2
28678 #. type: =head2
28679 #: ../fish/guestfish-actions.pod:3180
28680 msgid "mkswap-file"
28681 msgstr ""
28682
28683 # type: verbatim
28684 #. type: verbatim
28685 #: ../fish/guestfish-actions.pod:3182
28686 #, no-wrap
28687 msgid ""
28688 " mkswap-file path\n"
28689 "\n"
28690 msgstr ""
28691
28692 # type: textblock
28693 #. type: textblock
28694 #: ../fish/guestfish-actions.pod:3186
28695 msgid ""
28696 "This command just writes a swap file signature to an existing file.  To "
28697 "create the file itself, use something like L</fallocate>."
28698 msgstr ""
28699
28700 # type: =head2
28701 #. type: =head2
28702 #: ../fish/guestfish-actions.pod:3189
28703 msgid "modprobe"
28704 msgstr ""
28705
28706 # type: verbatim
28707 #. type: verbatim
28708 #: ../fish/guestfish-actions.pod:3191
28709 #, no-wrap
28710 msgid ""
28711 " modprobe modulename\n"
28712 "\n"
28713 msgstr ""
28714
28715 # type: =head2
28716 #. type: =head2
28717 #: ../fish/guestfish-actions.pod:3198
28718 msgid "mount"
28719 msgstr ""
28720
28721 # type: verbatim
28722 #. type: verbatim
28723 #: ../fish/guestfish-actions.pod:3200
28724 #, no-wrap
28725 msgid ""
28726 " mount device mountpoint\n"
28727 "\n"
28728 msgstr ""
28729
28730 # type: textblock
28731 #. type: textblock
28732 #: ../fish/guestfish-actions.pod:3216
28733 msgid ""
28734 "B<Important note:> When you use this call, the filesystem options C<sync> "
28735 "and C<noatime> are set implicitly.  This was originally done because we "
28736 "thought it would improve reliability, but it turns out that I<-o sync> has a "
28737 "very large negative performance impact and negligible effect on "
28738 "reliability.  Therefore we recommend that you avoid using L</mount> in any "
28739 "code that needs performance, and instead use L</mount-options> (use an empty "
28740 "string for the first parameter if you don't want any options)."
28741 msgstr ""
28742
28743 #. type: textblock
28744 #: ../fish/guestfish-actions.pod:3226
28745 msgid ""
28746 "This function is deprecated.  In new code, use the L</mount_options> call "
28747 "instead."
28748 msgstr ""
28749
28750 # type: =head2
28751 #. type: =head2
28752 #: ../fish/guestfish-actions.pod:3233
28753 msgid "mount-loop"
28754 msgstr ""
28755
28756 # type: verbatim
28757 #. type: verbatim
28758 #: ../fish/guestfish-actions.pod:3235
28759 #, no-wrap
28760 msgid ""
28761 " mount-loop file mountpoint\n"
28762 "\n"
28763 msgstr ""
28764
28765 # type: =head2
28766 #. type: =head2
28767 #: ../fish/guestfish-actions.pod:3241
28768 msgid "mount-options"
28769 msgstr ""
28770
28771 # type: verbatim
28772 #. type: verbatim
28773 #: ../fish/guestfish-actions.pod:3243
28774 #, no-wrap
28775 msgid ""
28776 " mount-options options device mountpoint\n"
28777 "\n"
28778 msgstr ""
28779
28780 # type: textblock
28781 #. type: textblock
28782 #: ../fish/guestfish-actions.pod:3245
28783 msgid ""
28784 "This is the same as the L</mount> command, but it allows you to set the "
28785 "mount options as for the L<mount(8)> I<-o> flag."
28786 msgstr ""
28787
28788 # type: =head2
28789 #. type: =head2
28790 #: ../fish/guestfish-actions.pod:3253
28791 msgid "mount-ro"
28792 msgstr ""
28793
28794 # type: verbatim
28795 #. type: verbatim
28796 #: ../fish/guestfish-actions.pod:3255
28797 #, no-wrap
28798 msgid ""
28799 " mount-ro device mountpoint\n"
28800 "\n"
28801 msgstr ""
28802
28803 # type: textblock
28804 #. type: textblock
28805 #: ../fish/guestfish-actions.pod:3257
28806 msgid ""
28807 "This is the same as the L</mount> command, but it mounts the filesystem with "
28808 "the read-only (I<-o ro>) flag."
28809 msgstr ""
28810
28811 # type: =head2
28812 #. type: =head2
28813 #: ../fish/guestfish-actions.pod:3260
28814 msgid "mount-vfs"
28815 msgstr ""
28816
28817 # type: verbatim
28818 #. type: verbatim
28819 #: ../fish/guestfish-actions.pod:3262
28820 #, no-wrap
28821 msgid ""
28822 " mount-vfs options vfstype device mountpoint\n"
28823 "\n"
28824 msgstr ""
28825
28826 # type: textblock
28827 #. type: textblock
28828 #: ../fish/guestfish-actions.pod:3264
28829 msgid ""
28830 "This is the same as the L</mount> command, but it allows you to set both the "
28831 "mount options and the vfstype as for the L<mount(8)> I<-o> and I<-t> flags."
28832 msgstr ""
28833
28834 # type: =head2
28835 #. type: =head2
28836 #: ../fish/guestfish-actions.pod:3268
28837 msgid "mountpoints"
28838 msgstr ""
28839
28840 # type: verbatim
28841 #. type: verbatim
28842 #: ../fish/guestfish-actions.pod:3270
28843 #, no-wrap
28844 msgid ""
28845 " mountpoints\n"
28846 "\n"
28847 msgstr ""
28848
28849 # type: textblock
28850 #. type: textblock
28851 #: ../fish/guestfish-actions.pod:3272
28852 msgid ""
28853 "This call is similar to L</mounts>.  That call returns a list of devices.  "
28854 "This one returns a hash table (map) of device name to directory where the "
28855 "device is mounted."
28856 msgstr ""
28857
28858 # type: =head2
28859 #. type: =head2
28860 #: ../fish/guestfish-actions.pod:3276
28861 msgid "mounts"
28862 msgstr ""
28863
28864 # type: verbatim
28865 #. type: verbatim
28866 #: ../fish/guestfish-actions.pod:3278
28867 #, no-wrap
28868 msgid ""
28869 " mounts\n"
28870 "\n"
28871 msgstr ""
28872
28873 # type: textblock
28874 #. type: textblock
28875 #: ../fish/guestfish-actions.pod:3285
28876 msgid "See also: L</mountpoints>"
28877 msgstr ""
28878
28879 # type: =head2
28880 #. type: =head2
28881 #: ../fish/guestfish-actions.pod:3287
28882 msgid "mv"
28883 msgstr ""
28884
28885 # type: verbatim
28886 #. type: verbatim
28887 #: ../fish/guestfish-actions.pod:3289
28888 #, no-wrap
28889 msgid ""
28890 " mv src dest\n"
28891 "\n"
28892 msgstr ""
28893
28894 # type: =head2
28895 #. type: =head2
28896 #: ../fish/guestfish-actions.pod:3294
28897 msgid "ntfs-3g-probe"
28898 msgstr ""
28899
28900 # type: verbatim
28901 #. type: verbatim
28902 #: ../fish/guestfish-actions.pod:3296
28903 #, no-wrap
28904 msgid ""
28905 " ntfs-3g-probe true|false device\n"
28906 "\n"
28907 msgstr ""
28908
28909 # type: =head2
28910 #. type: =head2
28911 #: ../fish/guestfish-actions.pod:3310
28912 msgid "ntfsresize"
28913 msgstr ""
28914
28915 # type: verbatim
28916 #. type: verbatim
28917 #: ../fish/guestfish-actions.pod:3312
28918 #, no-wrap
28919 msgid ""
28920 " ntfsresize device\n"
28921 "\n"
28922 msgstr ""
28923
28924 # type: =head2
28925 #. type: =head2
28926 #: ../fish/guestfish-actions.pod:3327
28927 msgid "ntfsresize-size"
28928 msgstr ""
28929
28930 # type: verbatim
28931 #. type: verbatim
28932 #: ../fish/guestfish-actions.pod:3329
28933 #, no-wrap
28934 msgid ""
28935 " ntfsresize-size device size\n"
28936 "\n"
28937 msgstr ""
28938
28939 # type: textblock
28940 #. type: textblock
28941 #: ../fish/guestfish-actions.pod:3331
28942 msgid ""
28943 "This command is the same as L</ntfsresize> except that it allows you to "
28944 "specify the new size (in bytes) explicitly."
28945 msgstr ""
28946
28947 # type: =head2
28948 #. type: =head2
28949 #: ../fish/guestfish-actions.pod:3334
28950 msgid "part-add"
28951 msgstr ""
28952
28953 # type: verbatim
28954 #. type: verbatim
28955 #: ../fish/guestfish-actions.pod:3336
28956 #, no-wrap
28957 msgid ""
28958 " part-add device prlogex startsect endsect\n"
28959 "\n"
28960 msgstr ""
28961
28962 # type: textblock
28963 #. type: textblock
28964 #: ../fish/guestfish-actions.pod:3338
28965 msgid ""
28966 "This command adds a partition to C<device>.  If there is no partition table "
28967 "on the device, call L</part-init> first."
28968 msgstr ""
28969
28970 # type: textblock
28971 #. type: textblock
28972 #: ../fish/guestfish-actions.pod:3350
28973 msgid ""
28974 "Creating a partition which covers the whole disk is not so easy.  Use L</"
28975 "part-disk> to do that."
28976 msgstr ""
28977
28978 # type: =head2
28979 #. type: =head2
28980 #: ../fish/guestfish-actions.pod:3353
28981 msgid "part-del"
28982 msgstr ""
28983
28984 # type: verbatim
28985 #. type: verbatim
28986 #: ../fish/guestfish-actions.pod:3355
28987 #, no-wrap
28988 msgid ""
28989 " part-del device partnum\n"
28990 "\n"
28991 msgstr ""
28992
28993 # type: =head2
28994 #. type: =head2
28995 #: ../fish/guestfish-actions.pod:3363
28996 msgid "part-disk"
28997 msgstr ""
28998
28999 # type: verbatim
29000 #. type: verbatim
29001 #: ../fish/guestfish-actions.pod:3365
29002 #, no-wrap
29003 msgid ""
29004 " part-disk device parttype\n"
29005 "\n"
29006 msgstr ""
29007
29008 # type: textblock
29009 #. type: textblock
29010 #: ../fish/guestfish-actions.pod:3367
29011 msgid ""
29012 "This command is simply a combination of L</part-init> followed by L</part-"
29013 "add> to create a single primary partition covering the whole disk."
29014 msgstr ""
29015
29016 # type: textblock
29017 #. type: textblock
29018 #: ../fish/guestfish-actions.pod:3371
29019 msgid ""
29020 "C<parttype> is the partition table type, usually C<mbr> or C<gpt>, but other "
29021 "possible values are described in L</part-init>."
29022 msgstr ""
29023
29024 # type: =head2
29025 #. type: =head2
29026 #: ../fish/guestfish-actions.pod:3377
29027 msgid "part-get-bootable"
29028 msgstr ""
29029
29030 # type: verbatim
29031 #. type: verbatim
29032 #: ../fish/guestfish-actions.pod:3379
29033 #, no-wrap
29034 msgid ""
29035 " part-get-bootable device partnum\n"
29036 "\n"
29037 msgstr ""
29038
29039 # type: textblock
29040 #. type: textblock
29041 #: ../fish/guestfish-actions.pod:3384
29042 msgid "See also L</part-set-bootable>."
29043 msgstr ""
29044
29045 # type: =head2
29046 #. type: =head2
29047 #: ../fish/guestfish-actions.pod:3386
29048 msgid "part-get-mbr-id"
29049 msgstr ""
29050
29051 # type: verbatim
29052 #. type: verbatim
29053 #: ../fish/guestfish-actions.pod:3388
29054 #, no-wrap
29055 msgid ""
29056 " part-get-mbr-id device partnum\n"
29057 "\n"
29058 msgstr ""
29059
29060 # type: textblock
29061 #. type: textblock
29062 #: ../fish/guestfish-actions.pod:3393 ../fish/guestfish-actions.pod:3531
29063 msgid ""
29064 "Note that only MBR (old DOS-style) partitions have type bytes.  You will get "
29065 "undefined results for other partition table types (see L</part-get-"
29066 "parttype>)."
29067 msgstr ""
29068
29069 # type: =head2
29070 #. type: =head2
29071 #: ../fish/guestfish-actions.pod:3397
29072 msgid "part-get-parttype"
29073 msgstr ""
29074
29075 # type: verbatim
29076 #. type: verbatim
29077 #: ../fish/guestfish-actions.pod:3399
29078 #, no-wrap
29079 msgid ""
29080 " part-get-parttype device\n"
29081 "\n"
29082 msgstr ""
29083
29084 # type: textblock
29085 #. type: textblock
29086 #: ../fish/guestfish-actions.pod:3404
29087 msgid ""
29088 "Common return values include: C<msdos> (a DOS/Windows style MBR partition "
29089 "table), C<gpt> (a GPT/EFI-style partition table).  Other values are "
29090 "possible, although unusual.  See L</part-init> for a full list."
29091 msgstr ""
29092
29093 # type: =head2
29094 #. type: =head2
29095 #: ../fish/guestfish-actions.pod:3409
29096 msgid "part-init"
29097 msgstr ""
29098
29099 # type: verbatim
29100 #. type: verbatim
29101 #: ../fish/guestfish-actions.pod:3411
29102 #, no-wrap
29103 msgid ""
29104 " part-init device parttype\n"
29105 "\n"
29106 msgstr ""
29107
29108 # type: textblock
29109 #. type: textblock
29110 #: ../fish/guestfish-actions.pod:3417
29111 msgid ""
29112 "Initially there are no partitions.  Following this, you should call L</part-"
29113 "add> for each partition required."
29114 msgstr ""
29115
29116 # type: =head2
29117 #. type: =head2
29118 #: ../fish/guestfish-actions.pod:3480
29119 msgid "part-list"
29120 msgstr ""
29121
29122 # type: verbatim
29123 #. type: verbatim
29124 #: ../fish/guestfish-actions.pod:3482
29125 #, no-wrap
29126 msgid ""
29127 " part-list device\n"
29128 "\n"
29129 msgstr ""
29130
29131 # type: textblock
29132 #. type: textblock
29133 #: ../fish/guestfish-actions.pod:3497
29134 msgid ""
29135 "Start of the partition I<in bytes>.  To get sectors you have to divide by "
29136 "the device's sector size, see L</blockdev-getss>."
29137 msgstr ""
29138
29139 # type: =head2
29140 #. type: =head2
29141 #: ../fish/guestfish-actions.pod:3510
29142 msgid "part-set-bootable"
29143 msgstr ""
29144
29145 # type: verbatim
29146 #. type: verbatim
29147 #: ../fish/guestfish-actions.pod:3512
29148 #, no-wrap
29149 msgid ""
29150 " part-set-bootable device partnum true|false\n"
29151 "\n"
29152 msgstr ""
29153
29154 # type: =head2
29155 #. type: =head2
29156 #: ../fish/guestfish-actions.pod:3521
29157 msgid "part-set-mbr-id"
29158 msgstr ""
29159
29160 # type: verbatim
29161 #. type: verbatim
29162 #: ../fish/guestfish-actions.pod:3523
29163 #, no-wrap
29164 msgid ""
29165 " part-set-mbr-id device partnum idbyte\n"
29166 "\n"
29167 msgstr ""
29168
29169 # type: =head2
29170 #. type: =head2
29171 #: ../fish/guestfish-actions.pod:3535
29172 msgid "part-set-name"
29173 msgstr ""
29174
29175 # type: verbatim
29176 #. type: verbatim
29177 #: ../fish/guestfish-actions.pod:3537
29178 #, no-wrap
29179 msgid ""
29180 " part-set-name device partnum name\n"
29181 "\n"
29182 msgstr ""
29183
29184 # type: =head2
29185 #. type: =head2
29186 #: ../fish/guestfish-actions.pod:3545
29187 msgid "part-to-dev"
29188 msgstr ""
29189
29190 # type: verbatim
29191 #. type: verbatim
29192 #: ../fish/guestfish-actions.pod:3547
29193 #, no-wrap
29194 msgid ""
29195 " part-to-dev partition\n"
29196 "\n"
29197 msgstr ""
29198
29199 # type: textblock
29200 #. type: textblock
29201 #: ../fish/guestfish-actions.pod:3553
29202 msgid ""
29203 "The named partition must exist, for example as a string returned from L</"
29204 "list-partitions>."
29205 msgstr ""
29206
29207 # type: =head2
29208 #. type: =head2
29209 #: ../fish/guestfish-actions.pod:3556
29210 msgid "ping-daemon"
29211 msgstr ""
29212
29213 # type: verbatim
29214 #. type: verbatim
29215 #: ../fish/guestfish-actions.pod:3558
29216 #, no-wrap
29217 msgid ""
29218 " ping-daemon\n"
29219 "\n"
29220 msgstr ""
29221
29222 # type: =head2
29223 #. type: =head2
29224 #: ../fish/guestfish-actions.pod:3565
29225 msgid "pread"
29226 msgstr ""
29227
29228 # type: verbatim
29229 #. type: verbatim
29230 #: ../fish/guestfish-actions.pod:3567
29231 #, no-wrap
29232 msgid ""
29233 " pread path count offset\n"
29234 "\n"
29235 msgstr ""
29236
29237 # type: textblock
29238 #. type: textblock
29239 #: ../fish/guestfish-actions.pod:3575
29240 msgid "See also L</pwrite>, L</pread-device>."
29241 msgstr ""
29242
29243 # type: =head2
29244 #. type: =head2
29245 #: ../fish/guestfish-actions.pod:3580
29246 msgid "pread-device"
29247 msgstr ""
29248
29249 # type: verbatim
29250 #. type: verbatim
29251 #: ../fish/guestfish-actions.pod:3582
29252 #, no-wrap
29253 msgid ""
29254 " pread-device device count offset\n"
29255 "\n"
29256 msgstr ""
29257
29258 # type: textblock
29259 #. type: textblock
29260 #: ../fish/guestfish-actions.pod:3590
29261 msgid "See also L</pread>."
29262 msgstr ""
29263
29264 # type: =head2
29265 #. type: =head2
29266 #: ../fish/guestfish-actions.pod:3595
29267 msgid "pvcreate"
29268 msgstr ""
29269
29270 # type: verbatim
29271 #. type: verbatim
29272 #: ../fish/guestfish-actions.pod:3597
29273 #, no-wrap
29274 msgid ""
29275 " pvcreate device\n"
29276 "\n"
29277 msgstr ""
29278
29279 # type: =head2
29280 #. type: =head2
29281 #: ../fish/guestfish-actions.pod:3603
29282 msgid "pvremove"
29283 msgstr ""
29284
29285 # type: verbatim
29286 #. type: verbatim
29287 #: ../fish/guestfish-actions.pod:3605
29288 #, no-wrap
29289 msgid ""
29290 " pvremove device\n"
29291 "\n"
29292 msgstr ""
29293
29294 # type: =head2
29295 #. type: =head2
29296 #: ../fish/guestfish-actions.pod:3614
29297 msgid "pvresize"
29298 msgstr ""
29299
29300 # type: verbatim
29301 #. type: verbatim
29302 #: ../fish/guestfish-actions.pod:3616
29303 #, no-wrap
29304 msgid ""
29305 " pvresize device\n"
29306 "\n"
29307 msgstr ""
29308
29309 # type: =head2
29310 #. type: =head2
29311 #: ../fish/guestfish-actions.pod:3621
29312 msgid "pvresize-size"
29313 msgstr ""
29314
29315 # type: verbatim
29316 #. type: verbatim
29317 #: ../fish/guestfish-actions.pod:3623
29318 #, no-wrap
29319 msgid ""
29320 " pvresize-size device size\n"
29321 "\n"
29322 msgstr ""
29323
29324 # type: textblock
29325 #. type: textblock
29326 #: ../fish/guestfish-actions.pod:3625
29327 msgid ""
29328 "This command is the same as L</pvresize> except that it allows you to "
29329 "specify the new size (in bytes) explicitly."
29330 msgstr ""
29331
29332 # type: =head2
29333 #. type: =head2
29334 #: ../fish/guestfish-actions.pod:3628
29335 msgid "pvs"
29336 msgstr ""
29337
29338 # type: verbatim
29339 #. type: verbatim
29340 #: ../fish/guestfish-actions.pod:3630
29341 #, no-wrap
29342 msgid ""
29343 " pvs\n"
29344 "\n"
29345 msgstr ""
29346
29347 # type: textblock
29348 #. type: textblock
29349 #: ../fish/guestfish-actions.pod:3638
29350 msgid "See also L</pvs-full>."
29351 msgstr ""
29352
29353 # type: =head2
29354 #. type: =head2
29355 #: ../fish/guestfish-actions.pod:3640
29356 msgid "pvs-full"
29357 msgstr ""
29358
29359 # type: verbatim
29360 #. type: verbatim
29361 #: ../fish/guestfish-actions.pod:3642
29362 #, no-wrap
29363 msgid ""
29364 " pvs-full\n"
29365 "\n"
29366 msgstr ""
29367
29368 # type: =head2
29369 #. type: =head2
29370 #: ../fish/guestfish-actions.pod:3647
29371 msgid "pvuuid"
29372 msgstr ""
29373
29374 # type: verbatim
29375 #. type: verbatim
29376 #: ../fish/guestfish-actions.pod:3649
29377 #, no-wrap
29378 msgid ""
29379 " pvuuid device\n"
29380 "\n"
29381 msgstr ""
29382
29383 # type: =head2
29384 #. type: =head2
29385 #: ../fish/guestfish-actions.pod:3653
29386 msgid "pwrite"
29387 msgstr ""
29388
29389 # type: verbatim
29390 #. type: verbatim
29391 #: ../fish/guestfish-actions.pod:3655
29392 #, no-wrap
29393 msgid ""
29394 " pwrite path content offset\n"
29395 "\n"
29396 msgstr ""
29397
29398 # type: textblock
29399 #. type: textblock
29400 #: ../fish/guestfish-actions.pod:3666
29401 msgid "See also L</pread>, L</pwrite-device>."
29402 msgstr ""
29403
29404 # type: =head2
29405 #. type: =head2
29406 #: ../fish/guestfish-actions.pod:3671
29407 msgid "pwrite-device"
29408 msgstr ""
29409
29410 # type: verbatim
29411 #. type: verbatim
29412 #: ../fish/guestfish-actions.pod:3673
29413 #, no-wrap
29414 msgid ""
29415 " pwrite-device device content offset\n"
29416 "\n"
29417 msgstr ""
29418
29419 # type: textblock
29420 #. type: textblock
29421 #: ../fish/guestfish-actions.pod:3683
29422 msgid "See also L</pwrite>."
29423 msgstr ""
29424
29425 # type: =head2
29426 #. type: =head2
29427 #: ../fish/guestfish-actions.pod:3688
29428 msgid "read-file"
29429 msgstr ""
29430
29431 # type: verbatim
29432 #. type: verbatim
29433 #: ../fish/guestfish-actions.pod:3690
29434 #, no-wrap
29435 msgid ""
29436 " read-file path\n"
29437 "\n"
29438 msgstr ""
29439
29440 # type: textblock
29441 #. type: textblock
29442 #: ../fish/guestfish-actions.pod:3695
29443 msgid ""
29444 "Unlike L</cat>, this function can correctly handle files that contain "
29445 "embedded ASCII NUL characters.  However unlike L</download>, this function "
29446 "is limited in the total size of file that can be handled."
29447 msgstr ""
29448
29449 # type: =head2
29450 #. type: =head2
29451 #: ../fish/guestfish-actions.pod:3703
29452 msgid "read-lines"
29453 msgstr ""
29454
29455 # type: verbatim
29456 #. type: verbatim
29457 #: ../fish/guestfish-actions.pod:3705
29458 #, no-wrap
29459 msgid ""
29460 " read-lines path\n"
29461 "\n"
29462 msgstr ""
29463
29464 # type: textblock
29465 #. type: textblock
29466 #: ../fish/guestfish-actions.pod:3712
29467 msgid ""
29468 "Note that this function cannot correctly handle binary files (specifically, "
29469 "files containing C<\\0> character which is treated as end of line).  For "
29470 "those you need to use the L</read-file> function which has a more complex "
29471 "interface."
29472 msgstr ""
29473
29474 # type: =head2
29475 #. type: =head2
29476 #: ../fish/guestfish-actions.pod:3717
29477 msgid "readdir"
29478 msgstr ""
29479
29480 # type: verbatim
29481 #. type: verbatim
29482 #: ../fish/guestfish-actions.pod:3719
29483 #, no-wrap
29484 msgid ""
29485 " readdir dir\n"
29486 "\n"
29487 msgstr ""
29488
29489 # type: textblock
29490 #. type: textblock
29491 #: ../fish/guestfish-actions.pod:3771
29492 msgid ""
29493 "This function is primarily intended for use by programs.  To get a simple "
29494 "list of names, use L</ls>.  To get a printable directory for human "
29495 "consumption, use L</ll>."
29496 msgstr ""
29497
29498 # type: =head2
29499 #. type: =head2
29500 #: ../fish/guestfish-actions.pod:3775
29501 msgid "readlink"
29502 msgstr ""
29503
29504 # type: verbatim
29505 #. type: verbatim
29506 #: ../fish/guestfish-actions.pod:3777
29507 #, no-wrap
29508 msgid ""
29509 " readlink path\n"
29510 "\n"
29511 msgstr ""
29512
29513 # type: =head2
29514 #. type: =head2
29515 #: ../fish/guestfish-actions.pod:3781
29516 msgid "readlinklist"
29517 msgstr ""
29518
29519 # type: verbatim
29520 #. type: verbatim
29521 #: ../fish/guestfish-actions.pod:3783
29522 #, no-wrap
29523 msgid ""
29524 " readlinklist path 'names ...'\n"
29525 "\n"
29526 msgstr ""
29527
29528 # type: =head2
29529 #. type: =head2
29530 #: ../fish/guestfish-actions.pod:3807
29531 msgid "realpath"
29532 msgstr ""
29533
29534 # type: verbatim
29535 #. type: verbatim
29536 #: ../fish/guestfish-actions.pod:3809
29537 #, no-wrap
29538 msgid ""
29539 " realpath path\n"
29540 "\n"
29541 msgstr ""
29542
29543 # type: =head2
29544 #. type: =head2
29545 #: ../fish/guestfish-actions.pod:3814
29546 msgid "removexattr"
29547 msgstr ""
29548
29549 # type: verbatim
29550 #. type: verbatim
29551 #: ../fish/guestfish-actions.pod:3816
29552 #, no-wrap
29553 msgid ""
29554 " removexattr xattr path\n"
29555 "\n"
29556 msgstr ""
29557
29558 # type: textblock
29559 #. type: textblock
29560 #: ../fish/guestfish-actions.pod:3821
29561 msgid "See also: L</lremovexattr>, L<attr(5)>."
29562 msgstr ""
29563
29564 # type: =head2
29565 #. type: =head2
29566 #: ../fish/guestfish-actions.pod:3823
29567 msgid "resize2fs"
29568 msgstr ""
29569
29570 # type: verbatim
29571 #. type: verbatim
29572 #: ../fish/guestfish-actions.pod:3825
29573 #, no-wrap
29574 msgid ""
29575 " resize2fs device\n"
29576 "\n"
29577 msgstr ""
29578
29579 # type: textblock
29580 #. type: textblock
29581 #: ../fish/guestfish-actions.pod:3830
29582 msgid ""
29583 "I<Note:> It is sometimes required that you run L</e2fsck-f> on the C<device> "
29584 "before calling this command.  For unknown reasons C<resize2fs> sometimes "
29585 "gives an error about this and sometimes not.  In any case, it is always safe "
29586 "to call L</e2fsck-f> before calling this function."
29587 msgstr ""
29588
29589 #. type: =head2
29590 #: ../fish/guestfish-actions.pod:3836
29591 msgid "resize2fs-M"
29592 msgstr ""
29593
29594 #. type: verbatim
29595 #: ../fish/guestfish-actions.pod:3838
29596 #, no-wrap
29597 msgid ""
29598 " resize2fs-M device\n"
29599 "\n"
29600 msgstr ""
29601
29602 #. type: textblock
29603 #: ../fish/guestfish-actions.pod:3840
29604 msgid ""
29605 "This command is the same as L</resize2fs>, but the filesystem is resized to "
29606 "its minimum size.  This works like the I<-M> option to the C<resize2fs> "
29607 "command."
29608 msgstr ""
29609
29610 #. type: textblock
29611 #: ../fish/guestfish-actions.pod:3844
29612 msgid ""
29613 "To get the resulting size of the filesystem you should call L</tune2fs-l> "
29614 "and read the C<Block size> and C<Block count> values.  These two numbers, "
29615 "multiplied together, give the resulting size of the minimal filesystem in "
29616 "bytes."
29617 msgstr ""
29618
29619 # type: =head2
29620 #. type: =head2
29621 #: ../fish/guestfish-actions.pod:3849
29622 msgid "resize2fs-size"
29623 msgstr ""
29624
29625 # type: verbatim
29626 #. type: verbatim
29627 #: ../fish/guestfish-actions.pod:3851
29628 #, no-wrap
29629 msgid ""
29630 " resize2fs-size device size\n"
29631 "\n"
29632 msgstr ""
29633
29634 # type: textblock
29635 #. type: textblock
29636 #: ../fish/guestfish-actions.pod:3853
29637 msgid ""
29638 "This command is the same as L</resize2fs> except that it allows you to "
29639 "specify the new size (in bytes) explicitly."
29640 msgstr ""
29641
29642 # type: =head2
29643 #. type: =head2
29644 #: ../fish/guestfish-actions.pod:3856
29645 msgid "rm"
29646 msgstr ""
29647
29648 # type: verbatim
29649 #. type: verbatim
29650 #: ../fish/guestfish-actions.pod:3858
29651 #, no-wrap
29652 msgid ""
29653 " rm path\n"
29654 "\n"
29655 msgstr ""
29656
29657 # type: =head2
29658 #. type: =head2
29659 #: ../fish/guestfish-actions.pod:3862
29660 msgid "rm-rf"
29661 msgstr ""
29662
29663 # type: verbatim
29664 #. type: verbatim
29665 #: ../fish/guestfish-actions.pod:3864
29666 #, no-wrap
29667 msgid ""
29668 " rm-rf path\n"
29669 "\n"
29670 msgstr ""
29671
29672 # type: =head2
29673 #. type: =head2
29674 #: ../fish/guestfish-actions.pod:3870
29675 msgid "rmdir"
29676 msgstr ""
29677
29678 # type: verbatim
29679 #. type: verbatim
29680 #: ../fish/guestfish-actions.pod:3872
29681 #, no-wrap
29682 msgid ""
29683 " rmdir path\n"
29684 "\n"
29685 msgstr ""
29686
29687 # type: =head2
29688 #. type: =head2
29689 #: ../fish/guestfish-actions.pod:3876
29690 msgid "rmmountpoint"
29691 msgstr ""
29692
29693 # type: verbatim
29694 #. type: verbatim
29695 #: ../fish/guestfish-actions.pod:3878
29696 #, no-wrap
29697 msgid ""
29698 " rmmountpoint exemptpath\n"
29699 "\n"
29700 msgstr ""
29701
29702 # type: textblock
29703 #. type: textblock
29704 #: ../fish/guestfish-actions.pod:3880
29705 msgid ""
29706 "This calls removes a mountpoint that was previously created with L</"
29707 "mkmountpoint>.  See L</mkmountpoint> for full details."
29708 msgstr ""
29709
29710 # type: =head2
29711 #. type: =head2
29712 #: ../fish/guestfish-actions.pod:3884
29713 msgid "scrub-device"
29714 msgstr ""
29715
29716 # type: verbatim
29717 #. type: verbatim
29718 #: ../fish/guestfish-actions.pod:3886
29719 #, no-wrap
29720 msgid ""
29721 " scrub-device device\n"
29722 "\n"
29723 msgstr ""
29724
29725 # type: =head2
29726 #. type: =head2
29727 #: ../fish/guestfish-actions.pod:3897
29728 msgid "scrub-file"
29729 msgstr ""
29730
29731 # type: verbatim
29732 #. type: verbatim
29733 #: ../fish/guestfish-actions.pod:3899
29734 #, no-wrap
29735 msgid ""
29736 " scrub-file file\n"
29737 "\n"
29738 msgstr ""
29739
29740 # type: =head2
29741 #. type: =head2
29742 #: ../fish/guestfish-actions.pod:3909
29743 msgid "scrub-freespace"
29744 msgstr ""
29745
29746 # type: verbatim
29747 #. type: verbatim
29748 #: ../fish/guestfish-actions.pod:3911
29749 #, no-wrap
29750 msgid ""
29751 " scrub-freespace dir\n"
29752 "\n"
29753 msgstr ""
29754
29755 # type: textblock
29756 #. type: textblock
29757 #: ../fish/guestfish-actions.pod:3913
29758 msgid ""
29759 "This command creates the directory C<dir> and then fills it with files until "
29760 "the filesystem is full, and scrubs the files as for L</scrub-file>, and "
29761 "deletes them.  The intention is to scrub any free space on the partition "
29762 "containing C<dir>."
29763 msgstr ""
29764
29765 # type: =head2
29766 #. type: =head2
29767 #: ../fish/guestfish-actions.pod:3922
29768 msgid "set-append"
29769 msgstr ""
29770
29771 # type: =head2
29772 #. type: =head2
29773 #: ../fish/guestfish-actions.pod:3924
29774 msgid "append"
29775 msgstr ""
29776
29777 # type: verbatim
29778 #. type: verbatim
29779 #: ../fish/guestfish-actions.pod:3926
29780 #, no-wrap
29781 msgid ""
29782 " set-append append\n"
29783 "\n"
29784 msgstr ""
29785
29786 #. type: =head2
29787 #: ../fish/guestfish-actions.pod:3937
29788 msgid "set-attach-method"
29789 msgstr ""
29790
29791 #. type: =head2
29792 #: ../fish/guestfish-actions.pod:3939
29793 msgid "attach-method"
29794 msgstr ""
29795
29796 #. type: verbatim
29797 #: ../fish/guestfish-actions.pod:3941
29798 #, no-wrap
29799 msgid ""
29800 " set-attach-method attachmethod\n"
29801 "\n"
29802 msgstr ""
29803
29804 # type: =head2
29805 #. type: =head2
29806 #: ../fish/guestfish-actions.pod:3963
29807 msgid "set-autosync"
29808 msgstr ""
29809
29810 # type: =head2
29811 #. type: =head2
29812 #: ../fish/guestfish-actions.pod:3965
29813 msgid "autosync"
29814 msgstr ""
29815
29816 # type: verbatim
29817 #. type: verbatim
29818 #: ../fish/guestfish-actions.pod:3967
29819 #, no-wrap
29820 msgid ""
29821 " set-autosync true|false\n"
29822 "\n"
29823 msgstr ""
29824
29825 # type: =head2
29826 #. type: =head2
29827 #: ../fish/guestfish-actions.pod:3977
29828 msgid "set-direct"
29829 msgstr ""
29830
29831 # type: =head2
29832 #. type: =head2
29833 #: ../fish/guestfish-actions.pod:3979
29834 msgid "direct"
29835 msgstr ""
29836
29837 # type: verbatim
29838 #. type: verbatim
29839 #: ../fish/guestfish-actions.pod:3981
29840 #, no-wrap
29841 msgid ""
29842 " set-direct true|false\n"
29843 "\n"
29844 msgstr ""
29845
29846 # type: textblock
29847 #. type: textblock
29848 #: ../fish/guestfish-actions.pod:3987
29849 msgid ""
29850 "One consequence of this is that log messages aren't caught by the library "
29851 "and handled by L</set-log-message-callback>, but go straight to stdout."
29852 msgstr ""
29853
29854 # type: =head2
29855 #. type: =head2
29856 #: ../fish/guestfish-actions.pod:3996
29857 msgid "set-e2label"
29858 msgstr ""
29859
29860 # type: verbatim
29861 #. type: verbatim
29862 #: ../fish/guestfish-actions.pod:3998
29863 #, no-wrap
29864 msgid ""
29865 " set-e2label device label\n"
29866 "\n"
29867 msgstr ""
29868
29869 # type: textblock
29870 #. type: textblock
29871 #: ../fish/guestfish-actions.pod:4004
29872 msgid ""
29873 "You can use either L</tune2fs-l> or L</get-e2label> to return the existing "
29874 "label on a filesystem."
29875 msgstr ""
29876
29877 # type: =head2
29878 #. type: =head2
29879 #: ../fish/guestfish-actions.pod:4007
29880 msgid "set-e2uuid"
29881 msgstr ""
29882
29883 # type: verbatim
29884 #. type: verbatim
29885 #: ../fish/guestfish-actions.pod:4009
29886 #, no-wrap
29887 msgid ""
29888 " set-e2uuid device uuid\n"
29889 "\n"
29890 msgstr ""
29891
29892 # type: textblock
29893 #. type: textblock
29894 #: ../fish/guestfish-actions.pod:4016
29895 msgid ""
29896 "You can use either L</tune2fs-l> or L</get-e2uuid> to return the existing "
29897 "UUID of a filesystem."
29898 msgstr ""
29899
29900 # type: =head2
29901 #. type: =head2
29902 #: ../fish/guestfish-actions.pod:4019
29903 msgid "set-memsize"
29904 msgstr ""
29905
29906 # type: =head2
29907 #. type: =head2
29908 #: ../fish/guestfish-actions.pod:4021
29909 msgid "memsize"
29910 msgstr ""
29911
29912 # type: verbatim
29913 #. type: verbatim
29914 #: ../fish/guestfish-actions.pod:4023
29915 #, no-wrap
29916 msgid ""
29917 " set-memsize memsize\n"
29918 "\n"
29919 msgstr ""
29920
29921 # type: textblock
29922 #. type: textblock
29923 #: ../fish/guestfish-actions.pod:4025
29924 msgid ""
29925 "This sets the memory size in megabytes allocated to the qemu subprocess.  "
29926 "This only has any effect if called before L</launch>."
29927 msgstr ""
29928
29929 # type: =head2
29930 #. type: =head2
29931 #: ../fish/guestfish-actions.pod:4036
29932 msgid "set-network"
29933 msgstr ""
29934
29935 # type: =head2
29936 #. type: =head2
29937 #: ../fish/guestfish-actions.pod:4038
29938 msgid "network"
29939 msgstr ""
29940
29941 # type: verbatim
29942 #. type: verbatim
29943 #: ../fish/guestfish-actions.pod:4040
29944 #, no-wrap
29945 msgid ""
29946 " set-network true|false\n"
29947 "\n"
29948 msgstr ""
29949
29950 # type: textblock
29951 #. type: textblock
29952 #: ../fish/guestfish-actions.pod:4048
29953 msgid ""
29954 "You must call this before calling L</launch>, otherwise it has no effect."
29955 msgstr ""
29956
29957 # type: =head2
29958 #. type: =head2
29959 #: ../fish/guestfish-actions.pod:4051
29960 msgid "set-path"
29961 msgstr ""
29962
29963 # type: =head2
29964 #. type: =head2
29965 #: ../fish/guestfish-actions.pod:4053
29966 msgid "path"
29967 msgstr ""
29968
29969 # type: verbatim
29970 #. type: verbatim
29971 #: ../fish/guestfish-actions.pod:4055
29972 #, no-wrap
29973 msgid ""
29974 " set-path searchpath\n"
29975 "\n"
29976 msgstr ""
29977
29978 # type: =head2
29979 #. type: =head2
29980 #: ../fish/guestfish-actions.pod:4064
29981 msgid "set-qemu"
29982 msgstr ""
29983
29984 # type: =head2
29985 #. type: =head2
29986 #: ../fish/guestfish-actions.pod:4066
29987 msgid "qemu"
29988 msgstr ""
29989
29990 # type: verbatim
29991 #. type: verbatim
29992 #: ../fish/guestfish-actions.pod:4068
29993 #, no-wrap
29994 msgid ""
29995 " set-qemu qemu\n"
29996 "\n"
29997 msgstr ""
29998
29999 # type: =head2
30000 #. type: =head2
30001 #: ../fish/guestfish-actions.pod:4088
30002 msgid "set-recovery-proc"
30003 msgstr ""
30004
30005 # type: =head2
30006 #. type: =head2
30007 #: ../fish/guestfish-actions.pod:4090
30008 msgid "recovery-proc"
30009 msgstr ""
30010
30011 # type: verbatim
30012 #. type: verbatim
30013 #: ../fish/guestfish-actions.pod:4092
30014 #, no-wrap
30015 msgid ""
30016 " set-recovery-proc true|false\n"
30017 "\n"
30018 msgstr ""
30019
30020 # type: textblock
30021 #. type: textblock
30022 #: ../fish/guestfish-actions.pod:4094
30023 msgid ""
30024 "If this is called with the parameter C<false> then L</launch> does not "
30025 "create a recovery process.  The purpose of the recovery process is to stop "
30026 "runaway qemu processes in the case where the main program aborts abruptly."
30027 msgstr ""
30028
30029 # type: textblock
30030 #. type: textblock
30031 #: ../fish/guestfish-actions.pod:4099
30032 msgid ""
30033 "This only has any effect if called before L</launch>, and the default is "
30034 "true."
30035 msgstr ""
30036
30037 # type: =head2
30038 #. type: =head2
30039 #: ../fish/guestfish-actions.pod:4108
30040 msgid "set-selinux"
30041 msgstr ""
30042
30043 # type: =head2
30044 #. type: =head2
30045 #: ../fish/guestfish-actions.pod:4110
30046 msgid "selinux"
30047 msgstr ""
30048
30049 # type: verbatim
30050 #. type: verbatim
30051 #: ../fish/guestfish-actions.pod:4112
30052 #, no-wrap
30053 msgid ""
30054 " set-selinux true|false\n"
30055 "\n"
30056 msgstr ""
30057
30058 # type: =head2
30059 #. type: =head2
30060 #: ../fish/guestfish-actions.pod:4123
30061 msgid "set-trace"
30062 msgstr ""
30063
30064 # type: =head2
30065 #. type: =head2
30066 #: ../fish/guestfish-actions.pod:4125
30067 msgid "trace"
30068 msgstr ""
30069
30070 # type: verbatim
30071 #. type: verbatim
30072 #: ../fish/guestfish-actions.pod:4127
30073 #, no-wrap
30074 msgid ""
30075 " set-trace true|false\n"
30076 "\n"
30077 msgstr ""
30078
30079 #. type: textblock
30080 #: ../fish/guestfish-actions.pod:4139
30081 msgid ""
30082 "Trace messages are normally sent to C<stderr>, unless you register a "
30083 "callback to send them somewhere else (see L</set-event-callback>)."
30084 msgstr ""
30085
30086 # type: =head2
30087 #. type: =head2
30088 #: ../fish/guestfish-actions.pod:4143
30089 msgid "set-verbose"
30090 msgstr ""
30091
30092 # type: =head2
30093 #. type: =head2
30094 #: ../fish/guestfish-actions.pod:4145
30095 msgid "verbose"
30096 msgstr ""
30097
30098 # type: verbatim
30099 #. type: verbatim
30100 #: ../fish/guestfish-actions.pod:4147
30101 #, no-wrap
30102 msgid ""
30103 " set-verbose true|false\n"
30104 "\n"
30105 msgstr ""
30106
30107 #. type: textblock
30108 #: ../fish/guestfish-actions.pod:4154
30109 msgid ""
30110 "Verbose messages are normally sent to C<stderr>, unless you register a "
30111 "callback to send them somewhere else (see L</set-event-callback>)."
30112 msgstr ""
30113
30114 # type: =head2
30115 #. type: =head2
30116 #: ../fish/guestfish-actions.pod:4158
30117 msgid "setcon"
30118 msgstr ""
30119
30120 # type: verbatim
30121 #. type: verbatim
30122 #: ../fish/guestfish-actions.pod:4160
30123 #, no-wrap
30124 msgid ""
30125 " setcon context\n"
30126 "\n"
30127 msgstr ""
30128
30129 # type: =head2
30130 #. type: =head2
30131 #: ../fish/guestfish-actions.pod:4167
30132 msgid "setxattr"
30133 msgstr ""
30134
30135 # type: verbatim
30136 #. type: verbatim
30137 #: ../fish/guestfish-actions.pod:4169
30138 #, no-wrap
30139 msgid ""
30140 " setxattr xattr val vallen path\n"
30141 "\n"
30142 msgstr ""
30143
30144 # type: textblock
30145 #. type: textblock
30146 #: ../fish/guestfish-actions.pod:4175
30147 msgid "See also: L</lsetxattr>, L<attr(5)>."
30148 msgstr ""
30149
30150 # type: =head2
30151 #. type: =head2
30152 #: ../fish/guestfish-actions.pod:4177
30153 msgid "sfdisk"
30154 msgstr ""
30155
30156 # type: verbatim
30157 #. type: verbatim
30158 #: ../fish/guestfish-actions.pod:4179
30159 #, no-wrap
30160 msgid ""
30161 " sfdisk device cyls heads sectors 'lines ...'\n"
30162 "\n"
30163 msgstr ""
30164
30165 # type: textblock
30166 #. type: textblock
30167 #: ../fish/guestfish-actions.pod:4201
30168 msgid "See also: L</sfdisk-l>, L</sfdisk-N>, L</part-init>"
30169 msgstr ""
30170
30171 #. type: textblock
30172 #: ../fish/guestfish-actions.pod:4207 ../fish/guestfish-actions.pod:4230
30173 #: ../fish/guestfish-actions.pod:4252
30174 msgid ""
30175 "This function is deprecated.  In new code, use the L</part_add> call instead."
30176 msgstr ""
30177
30178 # type: =head2
30179 #. type: =head2
30180 #: ../fish/guestfish-actions.pod:4214
30181 msgid "sfdiskM"
30182 msgstr ""
30183
30184 # type: verbatim
30185 #. type: verbatim
30186 #: ../fish/guestfish-actions.pod:4216
30187 #, no-wrap
30188 msgid ""
30189 " sfdiskM device 'lines ...'\n"
30190 "\n"
30191 msgstr ""
30192
30193 # type: textblock
30194 #. type: textblock
30195 #: ../fish/guestfish-actions.pod:4218
30196 msgid ""
30197 "This is a simplified interface to the L</sfdisk> command, where partition "
30198 "sizes are specified in megabytes only (rounded to the nearest cylinder) and "
30199 "you don't need to specify the cyls, heads and sectors parameters which were "
30200 "rarely if ever used anyway."
30201 msgstr ""
30202
30203 # type: textblock
30204 #. type: textblock
30205 #: ../fish/guestfish-actions.pod:4224
30206 msgid "See also: L</sfdisk>, the L<sfdisk(8)> manpage and L</part-disk>"
30207 msgstr ""
30208
30209 # type: =head2
30210 #. type: =head2
30211 #: ../fish/guestfish-actions.pod:4237
30212 msgid "sfdisk-N"
30213 msgstr ""
30214
30215 # type: verbatim
30216 #. type: verbatim
30217 #: ../fish/guestfish-actions.pod:4239
30218 #, no-wrap
30219 msgid ""
30220 " sfdisk-N device partnum cyls heads sectors line\n"
30221 "\n"
30222 msgstr ""
30223
30224 # type: textblock
30225 #. type: textblock
30226 #: ../fish/guestfish-actions.pod:4244
30227 msgid ""
30228 "For other parameters, see L</sfdisk>.  You should usually pass C<0> for the "
30229 "cyls/heads/sectors parameters."
30230 msgstr ""
30231
30232 # type: textblock
30233 #. type: textblock
30234 #: ../fish/guestfish-actions.pod:4247
30235 msgid "See also: L</part-add>"
30236 msgstr ""
30237
30238 # type: =head2
30239 #. type: =head2
30240 #: ../fish/guestfish-actions.pod:4259
30241 msgid "sfdisk-disk-geometry"
30242 msgstr ""
30243
30244 # type: verbatim
30245 #. type: verbatim
30246 #: ../fish/guestfish-actions.pod:4261
30247 #, no-wrap
30248 msgid ""
30249 " sfdisk-disk-geometry device\n"
30250 "\n"
30251 msgstr ""
30252
30253 # type: textblock
30254 #. type: textblock
30255 #: ../fish/guestfish-actions.pod:4263
30256 msgid ""
30257 "This displays the disk geometry of C<device> read from the partition table.  "
30258 "Especially in the case where the underlying block device has been resized, "
30259 "this can be different from the kernel's idea of the geometry (see L</sfdisk-"
30260 "kernel-geometry>)."
30261 msgstr ""
30262
30263 # type: =head2
30264 #. type: =head2
30265 #: ../fish/guestfish-actions.pod:4271
30266 msgid "sfdisk-kernel-geometry"
30267 msgstr ""
30268
30269 # type: verbatim
30270 #. type: verbatim
30271 #: ../fish/guestfish-actions.pod:4273
30272 #, no-wrap
30273 msgid ""
30274 " sfdisk-kernel-geometry device\n"
30275 "\n"
30276 msgstr ""
30277
30278 # type: =head2
30279 #. type: =head2
30280 #: ../fish/guestfish-actions.pod:4280
30281 msgid "sfdisk-l"
30282 msgstr ""
30283
30284 # type: verbatim
30285 #. type: verbatim
30286 #: ../fish/guestfish-actions.pod:4282
30287 #, no-wrap
30288 msgid ""
30289 " sfdisk-l device\n"
30290 "\n"
30291 msgstr ""
30292
30293 # type: textblock
30294 #. type: textblock
30295 #: ../fish/guestfish-actions.pod:4288
30296 msgid "See also: L</part-list>"
30297 msgstr ""
30298
30299 #. type: textblock
30300 #: ../fish/guestfish-actions.pod:4290
30301 msgid ""
30302 "This function is deprecated.  In new code, use the L</part_list> call "
30303 "instead."
30304 msgstr ""
30305
30306 # type: =head2
30307 #. type: =head2
30308 #: ../fish/guestfish-actions.pod:4297
30309 msgid "sh"
30310 msgstr ""
30311
30312 # type: verbatim
30313 #. type: verbatim
30314 #: ../fish/guestfish-actions.pod:4299
30315 #, no-wrap
30316 msgid ""
30317 " sh command\n"
30318 "\n"
30319 msgstr ""
30320
30321 # type: textblock
30322 #. type: textblock
30323 #: ../fish/guestfish-actions.pod:4304
30324 msgid "This is like L</command>, but passes the command to:"
30325 msgstr ""
30326
30327 # type: textblock
30328 #. type: textblock
30329 #: ../fish/guestfish-actions.pod:4312
30330 msgid "All the provisos about L</command> apply to this call."
30331 msgstr ""
30332
30333 # type: =head2
30334 #. type: =head2
30335 #: ../fish/guestfish-actions.pod:4314
30336 msgid "sh-lines"
30337 msgstr ""
30338
30339 # type: verbatim
30340 #. type: verbatim
30341 #: ../fish/guestfish-actions.pod:4316
30342 #, no-wrap
30343 msgid ""
30344 " sh-lines command\n"
30345 "\n"
30346 msgstr ""
30347
30348 # type: textblock
30349 #. type: textblock
30350 #: ../fish/guestfish-actions.pod:4318
30351 msgid "This is the same as L</sh>, but splits the result into a list of lines."
30352 msgstr ""
30353
30354 # type: textblock
30355 #. type: textblock
30356 #: ../fish/guestfish-actions.pod:4321
30357 msgid "See also: L</command-lines>"
30358 msgstr ""
30359
30360 # type: =head2
30361 #. type: =head2
30362 #: ../fish/guestfish-actions.pod:4323
30363 msgid "sleep"
30364 msgstr ""
30365
30366 # type: verbatim
30367 #. type: verbatim
30368 #: ../fish/guestfish-actions.pod:4325
30369 #, no-wrap
30370 msgid ""
30371 " sleep secs\n"
30372 "\n"
30373 msgstr ""
30374
30375 # type: =head2
30376 #. type: =head2
30377 #: ../fish/guestfish-actions.pod:4329
30378 msgid "stat"
30379 msgstr ""
30380
30381 # type: verbatim
30382 #. type: verbatim
30383 #: ../fish/guestfish-actions.pod:4331
30384 #, no-wrap
30385 msgid ""
30386 " stat path\n"
30387 "\n"
30388 msgstr ""
30389
30390 # type: =head2
30391 #. type: =head2
30392 #: ../fish/guestfish-actions.pod:4337
30393 msgid "statvfs"
30394 msgstr ""
30395
30396 # type: verbatim
30397 #. type: verbatim
30398 #: ../fish/guestfish-actions.pod:4339
30399 #, no-wrap
30400 msgid ""
30401 " statvfs path\n"
30402 "\n"
30403 msgstr ""
30404
30405 # type: =head2
30406 #. type: =head2
30407 #: ../fish/guestfish-actions.pod:4347
30408 msgid "strings"
30409 msgstr ""
30410
30411 # type: verbatim
30412 #. type: verbatim
30413 #: ../fish/guestfish-actions.pod:4349
30414 #, no-wrap
30415 msgid ""
30416 " strings path\n"
30417 "\n"
30418 msgstr ""
30419
30420 # type: =head2
30421 #. type: =head2
30422 #: ../fish/guestfish-actions.pod:4357
30423 msgid "strings-e"
30424 msgstr ""
30425
30426 # type: verbatim
30427 #. type: verbatim
30428 #: ../fish/guestfish-actions.pod:4359
30429 #, no-wrap
30430 msgid ""
30431 " strings-e encoding path\n"
30432 "\n"
30433 msgstr ""
30434
30435 # type: textblock
30436 #. type: textblock
30437 #: ../fish/guestfish-actions.pod:4361
30438 msgid ""
30439 "This is like the L</strings> command, but allows you to specify the encoding "
30440 "of strings that are looked for in the source file C<path>."
30441 msgstr ""
30442
30443 # type: textblock
30444 #. type: textblock
30445 #: ../fish/guestfish-actions.pod:4371
30446 msgid ""
30447 "Single 7-bit-byte characters like ASCII and the ASCII-compatible parts of "
30448 "ISO-8859-X (this is what L</strings> uses)."
30449 msgstr ""
30450
30451 # type: =head2
30452 #. type: =head2
30453 #: ../fish/guestfish-actions.pod:4403
30454 msgid "swapoff-device"
30455 msgstr ""
30456
30457 # type: verbatim
30458 #. type: verbatim
30459 #: ../fish/guestfish-actions.pod:4405
30460 #, no-wrap
30461 msgid ""
30462 " swapoff-device device\n"
30463 "\n"
30464 msgstr ""
30465
30466 # type: textblock
30467 #. type: textblock
30468 #: ../fish/guestfish-actions.pod:4407
30469 msgid ""
30470 "This command disables the libguestfs appliance swap device or partition "
30471 "named C<device>.  See L</swapon-device>."
30472 msgstr ""
30473
30474 # type: =head2
30475 #. type: =head2
30476 #: ../fish/guestfish-actions.pod:4411
30477 msgid "swapoff-file"
30478 msgstr ""
30479
30480 # type: verbatim
30481 #. type: verbatim
30482 #: ../fish/guestfish-actions.pod:4413
30483 #, no-wrap
30484 msgid ""
30485 " swapoff-file file\n"
30486 "\n"
30487 msgstr ""
30488
30489 # type: =head2
30490 #. type: =head2
30491 #: ../fish/guestfish-actions.pod:4417
30492 msgid "swapoff-label"
30493 msgstr ""
30494
30495 # type: verbatim
30496 #. type: verbatim
30497 #: ../fish/guestfish-actions.pod:4419
30498 #, no-wrap
30499 msgid ""
30500 " swapoff-label label\n"
30501 "\n"
30502 msgstr ""
30503
30504 # type: =head2
30505 #. type: =head2
30506 #: ../fish/guestfish-actions.pod:4424
30507 msgid "swapoff-uuid"
30508 msgstr ""
30509
30510 # type: verbatim
30511 #. type: verbatim
30512 #: ../fish/guestfish-actions.pod:4426
30513 #, no-wrap
30514 msgid ""
30515 " swapoff-uuid uuid\n"
30516 "\n"
30517 msgstr ""
30518
30519 # type: =head2
30520 #. type: =head2
30521 #: ../fish/guestfish-actions.pod:4431
30522 msgid "swapon-device"
30523 msgstr ""
30524
30525 # type: verbatim
30526 #. type: verbatim
30527 #: ../fish/guestfish-actions.pod:4433
30528 #, no-wrap
30529 msgid ""
30530 " swapon-device device\n"
30531 "\n"
30532 msgstr ""
30533
30534 # type: textblock
30535 #. type: textblock
30536 #: ../fish/guestfish-actions.pod:4435
30537 msgid ""
30538 "This command enables the libguestfs appliance to use the swap device or "
30539 "partition named C<device>.  The increased memory is made available for all "
30540 "commands, for example those run using L</command> or L</sh>."
30541 msgstr ""
30542
30543 # type: =head2
30544 #. type: =head2
30545 #: ../fish/guestfish-actions.pod:4447
30546 msgid "swapon-file"
30547 msgstr ""
30548
30549 # type: verbatim
30550 #. type: verbatim
30551 #: ../fish/guestfish-actions.pod:4449
30552 #, no-wrap
30553 msgid ""
30554 " swapon-file file\n"
30555 "\n"
30556 msgstr ""
30557
30558 # type: textblock
30559 #. type: textblock
30560 #: ../fish/guestfish-actions.pod:4451
30561 msgid ""
30562 "This command enables swap to a file.  See L</swapon-device> for other notes."
30563 msgstr ""
30564
30565 # type: =head2
30566 #. type: =head2
30567 #: ../fish/guestfish-actions.pod:4454
30568 msgid "swapon-label"
30569 msgstr ""
30570
30571 # type: verbatim
30572 #. type: verbatim
30573 #: ../fish/guestfish-actions.pod:4456
30574 #, no-wrap
30575 msgid ""
30576 " swapon-label label\n"
30577 "\n"
30578 msgstr ""
30579
30580 # type: textblock
30581 #. type: textblock
30582 #: ../fish/guestfish-actions.pod:4458
30583 msgid ""
30584 "This command enables swap to a labeled swap partition.  See L</swapon-"
30585 "device> for other notes."
30586 msgstr ""
30587
30588 # type: =head2
30589 #. type: =head2
30590 #: ../fish/guestfish-actions.pod:4461
30591 msgid "swapon-uuid"
30592 msgstr ""
30593
30594 # type: verbatim
30595 #. type: verbatim
30596 #: ../fish/guestfish-actions.pod:4463
30597 #, no-wrap
30598 msgid ""
30599 " swapon-uuid uuid\n"
30600 "\n"
30601 msgstr ""
30602
30603 # type: textblock
30604 #. type: textblock
30605 #: ../fish/guestfish-actions.pod:4465
30606 msgid ""
30607 "This command enables swap to a swap partition with the given UUID.  See L</"
30608 "swapon-device> for other notes."
30609 msgstr ""
30610
30611 # type: =head2
30612 #. type: =head2
30613 #: ../fish/guestfish-actions.pod:4468
30614 msgid "sync"
30615 msgstr ""
30616
30617 # type: verbatim
30618 #. type: verbatim
30619 #: ../fish/guestfish-actions.pod:4470
30620 #, no-wrap
30621 msgid ""
30622 " sync\n"
30623 "\n"
30624 msgstr ""
30625
30626 # type: =head2
30627 #. type: =head2
30628 #: ../fish/guestfish-actions.pod:4478
30629 msgid "tail"
30630 msgstr ""
30631
30632 # type: verbatim
30633 #. type: verbatim
30634 #: ../fish/guestfish-actions.pod:4480
30635 #, no-wrap
30636 msgid ""
30637 " tail path\n"
30638 "\n"
30639 msgstr ""
30640
30641 # type: =head2
30642 #. type: =head2
30643 #: ../fish/guestfish-actions.pod:4488
30644 msgid "tail-n"
30645 msgstr ""
30646
30647 # type: verbatim
30648 #. type: verbatim
30649 #: ../fish/guestfish-actions.pod:4490
30650 #, no-wrap
30651 msgid ""
30652 " tail-n nrlines path\n"
30653 "\n"
30654 msgstr ""
30655
30656 # type: =head2
30657 #. type: =head2
30658 #: ../fish/guestfish-actions.pod:4503
30659 msgid "tar-in"
30660 msgstr ""
30661
30662 # type: verbatim
30663 #. type: verbatim
30664 #: ../fish/guestfish-actions.pod:4505
30665 #, no-wrap
30666 msgid ""
30667 " tar-in (tarfile|-) directory\n"
30668 "\n"
30669 msgstr ""
30670
30671 # type: textblock
30672 #. type: textblock
30673 #: ../fish/guestfish-actions.pod:4510
30674 msgid "To upload a compressed tarball, use L</tgz-in> or L</txz-in>."
30675 msgstr ""
30676
30677 # type: =head2
30678 #. type: =head2
30679 #: ../fish/guestfish-actions.pod:4515
30680 msgid "tar-out"
30681 msgstr ""
30682
30683 # type: verbatim
30684 #. type: verbatim
30685 #: ../fish/guestfish-actions.pod:4517
30686 #, no-wrap
30687 msgid ""
30688 " tar-out directory (tarfile|-)\n"
30689 "\n"
30690 msgstr ""
30691
30692 # type: textblock
30693 #. type: textblock
30694 #: ../fish/guestfish-actions.pod:4522
30695 msgid "To download a compressed tarball, use L</tgz-out> or L</txz-out>."
30696 msgstr ""
30697
30698 # type: =head2
30699 #. type: =head2
30700 #: ../fish/guestfish-actions.pod:4527
30701 msgid "tgz-in"
30702 msgstr ""
30703
30704 # type: verbatim
30705 #. type: verbatim
30706 #: ../fish/guestfish-actions.pod:4529
30707 #, no-wrap
30708 msgid ""
30709 " tgz-in (tarball|-) directory\n"
30710 "\n"
30711 msgstr ""
30712
30713 # type: textblock
30714 #. type: textblock
30715 #: ../fish/guestfish-actions.pod:4534
30716 msgid "To upload an uncompressed tarball, use L</tar-in>."
30717 msgstr ""
30718
30719 # type: =head2
30720 #. type: =head2
30721 #: ../fish/guestfish-actions.pod:4538
30722 msgid "tgz-out"
30723 msgstr ""
30724
30725 # type: verbatim
30726 #. type: verbatim
30727 #: ../fish/guestfish-actions.pod:4540
30728 #, no-wrap
30729 msgid ""
30730 " tgz-out directory (tarball|-)\n"
30731 "\n"
30732 msgstr ""
30733
30734 # type: textblock
30735 #. type: textblock
30736 #: ../fish/guestfish-actions.pod:4545
30737 msgid "To download an uncompressed tarball, use L</tar-out>."
30738 msgstr ""
30739
30740 # type: =head2
30741 #. type: =head2
30742 #: ../fish/guestfish-actions.pod:4549
30743 msgid "touch"
30744 msgstr ""
30745
30746 # type: verbatim
30747 #. type: verbatim
30748 #: ../fish/guestfish-actions.pod:4551
30749 #, no-wrap
30750 msgid ""
30751 " touch path\n"
30752 "\n"
30753 msgstr ""
30754
30755 # type: =head2
30756 #. type: =head2
30757 #: ../fish/guestfish-actions.pod:4560
30758 msgid "truncate"
30759 msgstr ""
30760
30761 # type: verbatim
30762 #. type: verbatim
30763 #: ../fish/guestfish-actions.pod:4562
30764 #, no-wrap
30765 msgid ""
30766 " truncate path\n"
30767 "\n"
30768 msgstr ""
30769
30770 # type: =head2
30771 #. type: =head2
30772 #: ../fish/guestfish-actions.pod:4567
30773 msgid "truncate-size"
30774 msgstr ""
30775
30776 # type: verbatim
30777 #. type: verbatim
30778 #: ../fish/guestfish-actions.pod:4569
30779 #, no-wrap
30780 msgid ""
30781 " truncate-size path size\n"
30782 "\n"
30783 msgstr ""
30784
30785 # type: textblock
30786 #. type: textblock
30787 #: ../fish/guestfish-actions.pod:4574
30788 msgid ""
30789 "If the current file size is less than C<size> then the file is extended to "
30790 "the required size with zero bytes.  This creates a sparse file (ie. disk "
30791 "blocks are not allocated for the file until you write to it).  To create a "
30792 "non-sparse file of zeroes, use L</fallocate64> instead."
30793 msgstr ""
30794
30795 # type: =head2
30796 #. type: =head2
30797 #: ../fish/guestfish-actions.pod:4580
30798 msgid "tune2fs-l"
30799 msgstr ""
30800
30801 # type: verbatim
30802 #. type: verbatim
30803 #: ../fish/guestfish-actions.pod:4582
30804 #, no-wrap
30805 msgid ""
30806 " tune2fs-l device\n"
30807 "\n"
30808 msgstr ""
30809
30810 # type: =head2
30811 #. type: =head2
30812 #: ../fish/guestfish-actions.pod:4592
30813 msgid "txz-in"
30814 msgstr ""
30815
30816 # type: verbatim
30817 #. type: verbatim
30818 #: ../fish/guestfish-actions.pod:4594
30819 #, no-wrap
30820 msgid ""
30821 " txz-in (tarball|-) directory\n"
30822 "\n"
30823 msgstr ""
30824
30825 # type: =head2
30826 #. type: =head2
30827 #: ../fish/guestfish-actions.pod:4601
30828 msgid "txz-out"
30829 msgstr ""
30830
30831 # type: verbatim
30832 #. type: verbatim
30833 #: ../fish/guestfish-actions.pod:4603
30834 #, no-wrap
30835 msgid ""
30836 " txz-out directory (tarball|-)\n"
30837 "\n"
30838 msgstr ""
30839
30840 # type: =head2
30841 #. type: =head2
30842 #: ../fish/guestfish-actions.pod:4610
30843 msgid "umask"
30844 msgstr ""
30845
30846 # type: verbatim
30847 #. type: verbatim
30848 #: ../fish/guestfish-actions.pod:4612
30849 #, no-wrap
30850 msgid ""
30851 " umask mask\n"
30852 "\n"
30853 msgstr ""
30854
30855 # type: textblock
30856 #. type: textblock
30857 #: ../fish/guestfish-actions.pod:4626
30858 msgid "See also L</get-umask>, L<umask(2)>, L</mknod>, L</mkdir>."
30859 msgstr ""
30860
30861 # type: =head2
30862 #. type: =head2
30863 #: ../fish/guestfish-actions.pod:4631
30864 msgid "umount"
30865 msgstr ""
30866
30867 # type: =head2
30868 #. type: =head2
30869 #: ../fish/guestfish-actions.pod:4633
30870 msgid "unmount"
30871 msgstr ""
30872
30873 # type: verbatim
30874 #. type: verbatim
30875 #: ../fish/guestfish-actions.pod:4635
30876 #, no-wrap
30877 msgid ""
30878 " umount pathordevice\n"
30879 "\n"
30880 msgstr ""
30881
30882 # type: =head2
30883 #. type: =head2
30884 #: ../fish/guestfish-actions.pod:4641
30885 msgid "umount-all"
30886 msgstr ""
30887
30888 # type: =head2
30889 #. type: =head2
30890 #: ../fish/guestfish-actions.pod:4643
30891 msgid "unmount-all"
30892 msgstr ""
30893
30894 # type: verbatim
30895 #. type: verbatim
30896 #: ../fish/guestfish-actions.pod:4645
30897 #, no-wrap
30898 msgid ""
30899 " umount-all\n"
30900 "\n"
30901 msgstr ""
30902
30903 # type: =head2
30904 #. type: =head2
30905 #: ../fish/guestfish-actions.pod:4651
30906 msgid "upload"
30907 msgstr ""
30908
30909 # type: verbatim
30910 #. type: verbatim
30911 #: ../fish/guestfish-actions.pod:4653
30912 #, no-wrap
30913 msgid ""
30914 " upload (filename|-) remotefilename\n"
30915 "\n"
30916 msgstr ""
30917
30918 # type: textblock
30919 #. type: textblock
30920 #: ../fish/guestfish-actions.pod:4660
30921 msgid "See also L</download>."
30922 msgstr ""
30923
30924 # type: =head2
30925 #. type: =head2
30926 #: ../fish/guestfish-actions.pod:4664
30927 msgid "upload-offset"
30928 msgstr ""
30929
30930 # type: verbatim
30931 #. type: verbatim
30932 #: ../fish/guestfish-actions.pod:4666
30933 #, no-wrap
30934 msgid ""
30935 " upload-offset (filename|-) remotefilename offset\n"
30936 "\n"
30937 msgstr ""
30938
30939 # type: textblock
30940 #. type: textblock
30941 #: ../fish/guestfish-actions.pod:4678
30942 msgid ""
30943 "Note that there is no limit on the amount of data that can be uploaded with "
30944 "this call, unlike with L</pwrite>, and this call always writes the full "
30945 "amount unless an error occurs."
30946 msgstr ""
30947
30948 # type: textblock
30949 #. type: textblock
30950 #: ../fish/guestfish-actions.pod:4683
30951 msgid "See also L</upload>, L</pwrite>."
30952 msgstr ""
30953
30954 # type: =head2
30955 #. type: =head2
30956 #: ../fish/guestfish-actions.pod:4687
30957 msgid "utimens"
30958 msgstr ""
30959
30960 # type: verbatim
30961 #. type: verbatim
30962 #: ../fish/guestfish-actions.pod:4689
30963 #, no-wrap
30964 msgid ""
30965 " utimens path atsecs atnsecs mtsecs mtnsecs\n"
30966 "\n"
30967 msgstr ""
30968
30969 # type: =head2
30970 #. type: =head2
30971 #: ../fish/guestfish-actions.pod:4708
30972 msgid "version"
30973 msgstr ""
30974
30975 # type: verbatim
30976 #. type: verbatim
30977 #: ../fish/guestfish-actions.pod:4710
30978 #, no-wrap
30979 msgid ""
30980 " version\n"
30981 "\n"
30982 msgstr ""
30983
30984 # type: textblock
30985 #. type: textblock
30986 #: ../fish/guestfish-actions.pod:4737
30987 msgid ""
30988 "I<Note:> Don't use this call to test for availability of features.  In "
30989 "enterprise distributions we backport features from later versions into "
30990 "earlier versions, making this an unreliable way to test for features.  Use "
30991 "L</available> instead."
30992 msgstr ""
30993
30994 # type: =head2
30995 #. type: =head2
30996 #: ../fish/guestfish-actions.pod:4743
30997 msgid "vfs-label"
30998 msgstr ""
30999
31000 # type: verbatim
31001 #. type: verbatim
31002 #: ../fish/guestfish-actions.pod:4745
31003 #, no-wrap
31004 msgid ""
31005 " vfs-label device\n"
31006 "\n"
31007 msgstr ""
31008
31009 # type: textblock
31010 #. type: textblock
31011 #: ../fish/guestfish-actions.pod:4752
31012 msgid "To find a filesystem from the label, use L</findfs-label>."
31013 msgstr ""
31014
31015 # type: =head2
31016 #. type: =head2
31017 #: ../fish/guestfish-actions.pod:4754
31018 msgid "vfs-type"
31019 msgstr ""
31020
31021 # type: verbatim
31022 #. type: verbatim
31023 #: ../fish/guestfish-actions.pod:4756
31024 #, no-wrap
31025 msgid ""
31026 " vfs-type device\n"
31027 "\n"
31028 msgstr ""
31029
31030 # type: =head2
31031 #. type: =head2
31032 #: ../fish/guestfish-actions.pod:4766
31033 msgid "vfs-uuid"
31034 msgstr ""
31035
31036 # type: verbatim
31037 #. type: verbatim
31038 #: ../fish/guestfish-actions.pod:4768
31039 #, no-wrap
31040 msgid ""
31041 " vfs-uuid device\n"
31042 "\n"
31043 msgstr ""
31044
31045 # type: textblock
31046 #. type: textblock
31047 #: ../fish/guestfish-actions.pod:4775
31048 msgid "To find a filesystem from the UUID, use L</findfs-uuid>."
31049 msgstr ""
31050
31051 # type: =head2
31052 #. type: =head2
31053 #: ../fish/guestfish-actions.pod:4777
31054 msgid "vg-activate"
31055 msgstr ""
31056
31057 # type: verbatim
31058 #. type: verbatim
31059 #: ../fish/guestfish-actions.pod:4779
31060 #, no-wrap
31061 msgid ""
31062 " vg-activate true|false 'volgroups ...'\n"
31063 "\n"
31064 msgstr ""
31065
31066 # type: =head2
31067 #. type: =head2
31068 #: ../fish/guestfish-actions.pod:4792
31069 msgid "vg-activate-all"
31070 msgstr ""
31071
31072 # type: verbatim
31073 #. type: verbatim
31074 #: ../fish/guestfish-actions.pod:4794
31075 #, no-wrap
31076 msgid ""
31077 " vg-activate-all true|false\n"
31078 "\n"
31079 msgstr ""
31080
31081 # type: =head2
31082 #. type: =head2
31083 #: ../fish/guestfish-actions.pod:4804
31084 msgid "vgcreate"
31085 msgstr ""
31086
31087 # type: verbatim
31088 #. type: verbatim
31089 #: ../fish/guestfish-actions.pod:4806
31090 #, no-wrap
31091 msgid ""
31092 " vgcreate volgroup 'physvols ...'\n"
31093 "\n"
31094 msgstr ""
31095
31096 # type: =head2
31097 #. type: =head2
31098 #: ../fish/guestfish-actions.pod:4811
31099 msgid "vglvuuids"
31100 msgstr ""
31101
31102 # type: verbatim
31103 #. type: verbatim
31104 #: ../fish/guestfish-actions.pod:4813
31105 #, no-wrap
31106 msgid ""
31107 " vglvuuids vgname\n"
31108 "\n"
31109 msgstr ""
31110
31111 # type: textblock
31112 #. type: textblock
31113 #: ../fish/guestfish-actions.pod:4818
31114 msgid ""
31115 "You can use this along with L</lvs> and L</lvuuid> calls to associate "
31116 "logical volumes and volume groups."
31117 msgstr ""
31118
31119 # type: textblock
31120 #. type: textblock
31121 #: ../fish/guestfish-actions.pod:4821
31122 msgid "See also L</vgpvuuids>."
31123 msgstr ""
31124
31125 # type: =head2
31126 #. type: =head2
31127 #: ../fish/guestfish-actions.pod:4823
31128 msgid "vgpvuuids"
31129 msgstr ""
31130
31131 # type: verbatim
31132 #. type: verbatim
31133 #: ../fish/guestfish-actions.pod:4825
31134 #, no-wrap
31135 msgid ""
31136 " vgpvuuids vgname\n"
31137 "\n"
31138 msgstr ""
31139
31140 # type: textblock
31141 #. type: textblock
31142 #: ../fish/guestfish-actions.pod:4830
31143 msgid ""
31144 "You can use this along with L</pvs> and L</pvuuid> calls to associate "
31145 "physical volumes and volume groups."
31146 msgstr ""
31147
31148 # type: textblock
31149 #. type: textblock
31150 #: ../fish/guestfish-actions.pod:4833
31151 msgid "See also L</vglvuuids>."
31152 msgstr ""
31153
31154 # type: =head2
31155 #. type: =head2
31156 #: ../fish/guestfish-actions.pod:4835
31157 msgid "vgremove"
31158 msgstr ""
31159
31160 # type: verbatim
31161 #. type: verbatim
31162 #: ../fish/guestfish-actions.pod:4837
31163 #, no-wrap
31164 msgid ""
31165 " vgremove vgname\n"
31166 "\n"
31167 msgstr ""
31168
31169 # type: =head2
31170 #. type: =head2
31171 #: ../fish/guestfish-actions.pod:4844
31172 msgid "vgrename"
31173 msgstr ""
31174
31175 # type: verbatim
31176 #. type: verbatim
31177 #: ../fish/guestfish-actions.pod:4846
31178 #, no-wrap
31179 msgid ""
31180 " vgrename volgroup newvolgroup\n"
31181 "\n"
31182 msgstr ""
31183
31184 # type: =head2
31185 #. type: =head2
31186 #: ../fish/guestfish-actions.pod:4850
31187 msgid "vgs"
31188 msgstr ""
31189
31190 # type: verbatim
31191 #. type: verbatim
31192 #: ../fish/guestfish-actions.pod:4852
31193 #, no-wrap
31194 msgid ""
31195 " vgs\n"
31196 "\n"
31197 msgstr ""
31198
31199 # type: textblock
31200 #. type: textblock
31201 #: ../fish/guestfish-actions.pod:4860
31202 msgid "See also L</vgs-full>."
31203 msgstr ""
31204
31205 # type: =head2
31206 #. type: =head2
31207 #: ../fish/guestfish-actions.pod:4862
31208 msgid "vgs-full"
31209 msgstr ""
31210
31211 # type: verbatim
31212 #. type: verbatim
31213 #: ../fish/guestfish-actions.pod:4864
31214 #, no-wrap
31215 msgid ""
31216 " vgs-full\n"
31217 "\n"
31218 msgstr ""
31219
31220 # type: =head2
31221 #. type: =head2
31222 #: ../fish/guestfish-actions.pod:4869
31223 msgid "vgscan"
31224 msgstr ""
31225
31226 # type: verbatim
31227 #. type: verbatim
31228 #: ../fish/guestfish-actions.pod:4871
31229 #, no-wrap
31230 msgid ""
31231 " vgscan\n"
31232 "\n"
31233 msgstr ""
31234
31235 # type: =head2
31236 #. type: =head2
31237 #: ../fish/guestfish-actions.pod:4876
31238 msgid "vguuid"
31239 msgstr ""
31240
31241 # type: verbatim
31242 #. type: verbatim
31243 #: ../fish/guestfish-actions.pod:4878
31244 #, no-wrap
31245 msgid ""
31246 " vguuid vgname\n"
31247 "\n"
31248 msgstr ""
31249
31250 # type: =head2
31251 #. type: =head2
31252 #: ../fish/guestfish-actions.pod:4882
31253 msgid "wc-c"
31254 msgstr ""
31255
31256 # type: verbatim
31257 #. type: verbatim
31258 #: ../fish/guestfish-actions.pod:4884
31259 #, no-wrap
31260 msgid ""
31261 " wc-c path\n"
31262 "\n"
31263 msgstr ""
31264
31265 # type: =head2
31266 #. type: =head2
31267 #: ../fish/guestfish-actions.pod:4889
31268 msgid "wc-l"
31269 msgstr ""
31270
31271 # type: verbatim
31272 #. type: verbatim
31273 #: ../fish/guestfish-actions.pod:4891
31274 #, no-wrap
31275 msgid ""
31276 " wc-l path\n"
31277 "\n"
31278 msgstr ""
31279
31280 # type: =head2
31281 #. type: =head2
31282 #: ../fish/guestfish-actions.pod:4896
31283 msgid "wc-w"
31284 msgstr ""
31285
31286 # type: verbatim
31287 #. type: verbatim
31288 #: ../fish/guestfish-actions.pod:4898
31289 #, no-wrap
31290 msgid ""
31291 " wc-w path\n"
31292 "\n"
31293 msgstr ""
31294
31295 # type: =head2
31296 #. type: =head2
31297 #: ../fish/guestfish-actions.pod:4903
31298 msgid "write"
31299 msgstr ""
31300
31301 # type: verbatim
31302 #. type: verbatim
31303 #: ../fish/guestfish-actions.pod:4905
31304 #, no-wrap
31305 msgid ""
31306 " write path content\n"
31307 "\n"
31308 msgstr ""
31309
31310 # type: =head2
31311 #. type: =head2
31312 #: ../fish/guestfish-actions.pod:4913
31313 msgid "write-file"
31314 msgstr ""
31315
31316 # type: verbatim
31317 #. type: verbatim
31318 #: ../fish/guestfish-actions.pod:4915
31319 #, no-wrap
31320 msgid ""
31321 " write-file path content size\n"
31322 "\n"
31323 msgstr ""
31324
31325 #. type: textblock
31326 #: ../fish/guestfish-actions.pod:4931
31327 msgid ""
31328 "This function is deprecated.  In new code, use the L</write> call instead."
31329 msgstr ""
31330
31331 # type: =head2
31332 #. type: =head2
31333 #: ../fish/guestfish-actions.pod:4938
31334 msgid "zegrep"
31335 msgstr ""
31336
31337 # type: verbatim
31338 #. type: verbatim
31339 #: ../fish/guestfish-actions.pod:4940
31340 #, no-wrap
31341 msgid ""
31342 " zegrep regex path\n"
31343 "\n"
31344 msgstr ""
31345
31346 # type: =head2
31347 #. type: =head2
31348 #: ../fish/guestfish-actions.pod:4948
31349 msgid "zegrepi"
31350 msgstr ""
31351
31352 # type: verbatim
31353 #. type: verbatim
31354 #: ../fish/guestfish-actions.pod:4950
31355 #, no-wrap
31356 msgid ""
31357 " zegrepi regex path\n"
31358 "\n"
31359 msgstr ""
31360
31361 # type: =head2
31362 #. type: =head2
31363 #: ../fish/guestfish-actions.pod:4958
31364 msgid "zero"
31365 msgstr ""
31366
31367 # type: verbatim
31368 #. type: verbatim
31369 #: ../fish/guestfish-actions.pod:4960
31370 #, no-wrap
31371 msgid ""
31372 " zero device\n"
31373 "\n"
31374 msgstr ""
31375
31376 # type: textblock
31377 #. type: textblock
31378 #: ../fish/guestfish-actions.pod:4968
31379 msgid "See also: L</zero-device>, L</scrub-device>."
31380 msgstr ""
31381
31382 # type: =head2
31383 #. type: =head2
31384 #: ../fish/guestfish-actions.pod:4970
31385 msgid "zero-device"
31386 msgstr ""
31387
31388 # type: verbatim
31389 #. type: verbatim
31390 #: ../fish/guestfish-actions.pod:4972
31391 #, no-wrap
31392 msgid ""
31393 " zero-device device\n"
31394 "\n"
31395 msgstr ""
31396
31397 # type: textblock
31398 #. type: textblock
31399 #: ../fish/guestfish-actions.pod:4974
31400 msgid ""
31401 "This command writes zeroes over the entire C<device>.  Compare with L</zero> "
31402 "which just zeroes the first few blocks of a device."
31403 msgstr ""
31404
31405 # type: =head2
31406 #. type: =head2
31407 #: ../fish/guestfish-actions.pod:4981
31408 msgid "zerofree"
31409 msgstr ""
31410
31411 # type: verbatim
31412 #. type: verbatim
31413 #: ../fish/guestfish-actions.pod:4983
31414 #, no-wrap
31415 msgid ""
31416 " zerofree device\n"
31417 "\n"
31418 msgstr ""
31419
31420 # type: =head2
31421 #. type: =head2
31422 #: ../fish/guestfish-actions.pod:4996
31423 msgid "zfgrep"
31424 msgstr ""
31425
31426 # type: verbatim
31427 #. type: verbatim
31428 #: ../fish/guestfish-actions.pod:4998
31429 #, no-wrap
31430 msgid ""
31431 " zfgrep pattern path\n"
31432 "\n"
31433 msgstr ""
31434
31435 # type: =head2
31436 #. type: =head2
31437 #: ../fish/guestfish-actions.pod:5006
31438 msgid "zfgrepi"
31439 msgstr ""
31440
31441 # type: verbatim
31442 #. type: verbatim
31443 #: ../fish/guestfish-actions.pod:5008
31444 #, no-wrap
31445 msgid ""
31446 " zfgrepi pattern path\n"
31447 "\n"
31448 msgstr ""
31449
31450 # type: =head2
31451 #. type: =head2
31452 #: ../fish/guestfish-actions.pod:5016
31453 msgid "zfile"
31454 msgstr ""
31455
31456 # type: verbatim
31457 #. type: verbatim
31458 #: ../fish/guestfish-actions.pod:5018
31459 #, no-wrap
31460 msgid ""
31461 " zfile meth path\n"
31462 "\n"
31463 msgstr ""
31464
31465 # type: textblock
31466 #. type: textblock
31467 #: ../fish/guestfish-actions.pod:5025
31468 msgid ""
31469 "Since 1.0.63, use L</file> instead which can now process compressed files."
31470 msgstr ""
31471
31472 #. type: textblock
31473 #: ../fish/guestfish-actions.pod:5028
31474 msgid ""
31475 "This function is deprecated.  In new code, use the L</file> call instead."
31476 msgstr ""
31477
31478 # type: =head2
31479 #. type: =head2
31480 #: ../fish/guestfish-actions.pod:5035
31481 msgid "zgrep"
31482 msgstr ""
31483
31484 # type: verbatim
31485 #. type: verbatim
31486 #: ../fish/guestfish-actions.pod:5037
31487 #, no-wrap
31488 msgid ""
31489 " zgrep regex path\n"
31490 "\n"
31491 msgstr ""
31492
31493 # type: =head2
31494 #. type: =head2
31495 #: ../fish/guestfish-actions.pod:5045
31496 msgid "zgrepi"
31497 msgstr ""
31498
31499 # type: verbatim
31500 #. type: verbatim
31501 #: ../fish/guestfish-actions.pod:5047
31502 #, no-wrap
31503 msgid ""
31504 " zgrepi regex path\n"
31505 "\n"
31506 msgstr ""
31507
31508 # type: =head2
31509 #. type: =head2
31510 #: ../fish/guestfish-commands.pod:1
31511 msgid "alloc"
31512 msgstr ""
31513
31514 # type: =head2
31515 #. type: =head2
31516 #: ../fish/guestfish-commands.pod:3
31517 msgid "allocate"
31518 msgstr ""
31519
31520 # type: verbatim
31521 #. type: verbatim
31522 #: ../fish/guestfish-commands.pod:5
31523 #, no-wrap
31524 msgid ""
31525 " alloc filename size\n"
31526 "\n"
31527 msgstr ""
31528
31529 # type: textblock
31530 #. type: textblock
31531 #: ../fish/guestfish-commands.pod:7
31532 msgid ""
31533 "This creates an empty (zeroed) file of the given size, and then adds so it "
31534 "can be further examined."
31535 msgstr ""
31536
31537 # type: textblock
31538 #. type: textblock
31539 #: ../fish/guestfish-commands.pod:10 ../fish/guestfish-commands.pod:168
31540 msgid "For more advanced image creation, see L<qemu-img(1)> utility."
31541 msgstr ""
31542
31543 # type: textblock
31544 #. type: textblock
31545 #: ../fish/guestfish-commands.pod:12 ../fish/guestfish-commands.pod:170
31546 msgid "Size can be specified using standard suffixes, eg. C<1M>."
31547 msgstr ""
31548
31549 # type: textblock
31550 #. type: textblock
31551 #: ../fish/guestfish-commands.pod:14
31552 msgid ""
31553 "To create a sparse file, use L</sparse> instead.  To create a prepared disk "
31554 "image, see L</PREPARED DISK IMAGES>."
31555 msgstr ""
31556
31557 # type: =head2
31558 #. type: =head2
31559 #: ../fish/guestfish-commands.pod:17
31560 msgid "copy-in"
31561 msgstr ""
31562
31563 # type: verbatim
31564 #. type: verbatim
31565 #: ../fish/guestfish-commands.pod:19
31566 #, no-wrap
31567 msgid ""
31568 " copy-in local [local ...] /remotedir\n"
31569 "\n"
31570 msgstr ""
31571
31572 # type: textblock
31573 #. type: textblock
31574 #: ../fish/guestfish-commands.pod:21
31575 msgid ""
31576 "C<copy-in> copies local files or directories recursively into the disk "
31577 "image, placing them in the directory called C</remotedir> (which must "
31578 "exist).  This guestfish meta-command turns into a sequence of L</tar-in> and "
31579 "other commands as necessary."
31580 msgstr ""
31581
31582 # type: textblock
31583 #. type: textblock
31584 #: ../fish/guestfish-commands.pod:26
31585 msgid ""
31586 "Multiple local files and directories can be specified, but the last "
31587 "parameter must always be a remote directory.  Wildcards cannot be used."
31588 msgstr ""
31589
31590 # type: =head2
31591 #. type: =head2
31592 #: ../fish/guestfish-commands.pod:30
31593 msgid "copy-out"
31594 msgstr ""
31595
31596 # type: verbatim
31597 #. type: verbatim
31598 #: ../fish/guestfish-commands.pod:32
31599 #, no-wrap
31600 msgid ""
31601 " copy-out remote [remote ...] localdir\n"
31602 "\n"
31603 msgstr ""
31604
31605 # type: textblock
31606 #. type: textblock
31607 #: ../fish/guestfish-commands.pod:34
31608 msgid ""
31609 "C<copy-out> copies remote files or directories recursively out of the disk "
31610 "image, placing them on the host disk in a local directory called C<localdir> "
31611 "(which must exist).  This guestfish meta-command turns into a sequence of L</"
31612 "download>, L</tar-out> and other commands as necessary."
31613 msgstr ""
31614
31615 # type: textblock
31616 #. type: textblock
31617 #: ../fish/guestfish-commands.pod:40
31618 msgid ""
31619 "Multiple remote files and directories can be specified, but the last "
31620 "parameter must always be a local directory.  To download to the current "
31621 "directory, use C<.> as in:"
31622 msgstr ""
31623
31624 # type: verbatim
31625 #. type: verbatim
31626 #: ../fish/guestfish-commands.pod:44
31627 #, no-wrap
31628 msgid ""
31629 " copy-out /home .\n"
31630 "\n"
31631 msgstr ""
31632
31633 # type: textblock
31634 #. type: textblock
31635 #: ../fish/guestfish-commands.pod:46
31636 msgid ""
31637 "Wildcards cannot be used in the ordinary command, but you can use them with "
31638 "the help of L</glob> like this:"
31639 msgstr ""
31640
31641 # type: verbatim
31642 #. type: verbatim
31643 #: ../fish/guestfish-commands.pod:49
31644 #, no-wrap
31645 msgid ""
31646 " glob copy-out /home/* .\n"
31647 "\n"
31648 msgstr ""
31649
31650 # type: =head2
31651 #. type: =head2
31652 #: ../fish/guestfish-commands.pod:51
31653 msgid "echo"
31654 msgstr ""
31655
31656 # type: verbatim
31657 #. type: verbatim
31658 #: ../fish/guestfish-commands.pod:53
31659 #, no-wrap
31660 msgid ""
31661 " echo [params ...]\n"
31662 "\n"
31663 msgstr ""
31664
31665 # type: textblock
31666 #. type: textblock
31667 #: ../fish/guestfish-commands.pod:55
31668 msgid "This echos the parameters to the terminal."
31669 msgstr ""
31670
31671 # type: =head2
31672 #. type: =head2
31673 #: ../fish/guestfish-commands.pod:57
31674 msgid "edit"
31675 msgstr ""
31676
31677 # type: =head2
31678 #. type: =head2
31679 #: ../fish/guestfish-commands.pod:59
31680 msgid "vi"
31681 msgstr ""
31682
31683 # type: =head2
31684 #. type: =head2
31685 #: ../fish/guestfish-commands.pod:61
31686 msgid "emacs"
31687 msgstr ""
31688
31689 # type: verbatim
31690 #. type: verbatim
31691 #: ../fish/guestfish-commands.pod:63
31692 #, no-wrap
31693 msgid ""
31694 " edit filename\n"
31695 "\n"
31696 msgstr ""
31697
31698 # type: textblock
31699 #. type: textblock
31700 #: ../fish/guestfish-commands.pod:65
31701 msgid ""
31702 "This is used to edit a file.  It downloads the file, edits it locally using "
31703 "your editor, then uploads the result."
31704 msgstr ""
31705
31706 # type: textblock
31707 #. type: textblock
31708 #: ../fish/guestfish-commands.pod:68
31709 msgid ""
31710 "The editor is C<$EDITOR>.  However if you use the alternate commands C<vi> "
31711 "or C<emacs> you will get those corresponding editors."
31712 msgstr ""
31713
31714 # type: =head2
31715 #. type: =head2
31716 #: ../fish/guestfish-commands.pod:72
31717 msgid "glob"
31718 msgstr ""
31719
31720 # type: verbatim
31721 #. type: verbatim
31722 #: ../fish/guestfish-commands.pod:74
31723 #, no-wrap
31724 msgid ""
31725 " glob command args...\n"
31726 "\n"
31727 msgstr ""
31728
31729 # type: textblock
31730 #. type: textblock
31731 #: ../fish/guestfish-commands.pod:76
31732 msgid ""
31733 "Expand wildcards in any paths in the args list, and run C<command> "
31734 "repeatedly on each matching path."
31735 msgstr ""
31736
31737 # type: textblock
31738 #. type: textblock
31739 #: ../fish/guestfish-commands.pod:79
31740 msgid "See L</WILDCARDS AND GLOBBING>."
31741 msgstr ""
31742
31743 # type: =head2
31744 #. type: =head2
31745 #: ../fish/guestfish-commands.pod:81
31746 msgid "hexedit"
31747 msgstr ""
31748
31749 # type: verbatim
31750 #. type: verbatim
31751 #: ../fish/guestfish-commands.pod:83
31752 #, no-wrap
31753 msgid ""
31754 " hexedit <filename|device>\n"
31755 " hexedit <filename|device> <max>\n"
31756 " hexedit <filename|device> <start> <max>\n"
31757 "\n"
31758 msgstr ""
31759
31760 # type: textblock
31761 #. type: textblock
31762 #: ../fish/guestfish-commands.pod:87
31763 msgid ""
31764 "Use hexedit (a hex editor) to edit all or part of a binary file or block "
31765 "device."
31766 msgstr ""
31767
31768 # type: textblock
31769 #. type: textblock
31770 #: ../fish/guestfish-commands.pod:90
31771 msgid ""
31772 "This command works by downloading potentially the whole file or device, "
31773 "editing it locally, then uploading it.  If the file or device is large, you "
31774 "have to specify which part you wish to edit by using C<max> and/or C<start> "
31775 "C<max> parameters.  C<start> and C<max> are specified in bytes, with the "
31776 "usual modifiers allowed such as C<1M> (1 megabyte)."
31777 msgstr ""
31778
31779 # type: textblock
31780 #. type: textblock
31781 #: ../fish/guestfish-commands.pod:97
31782 msgid "For example to edit the first few sectors of a disk you might do:"
31783 msgstr ""
31784
31785 # type: verbatim
31786 #. type: verbatim
31787 #: ../fish/guestfish-commands.pod:100
31788 #, no-wrap
31789 msgid ""
31790 " hexedit /dev/sda 1M\n"
31791 "\n"
31792 msgstr ""
31793
31794 # type: textblock
31795 #. type: textblock
31796 #: ../fish/guestfish-commands.pod:102
31797 msgid ""
31798 "which would allow you to edit anywhere within the first megabyte of the disk."
31799 msgstr ""
31800
31801 # type: textblock
31802 #. type: textblock
31803 #: ../fish/guestfish-commands.pod:105
31804 msgid "To edit the superblock of an ext2 filesystem on C</dev/sda1>, do:"
31805 msgstr ""
31806
31807 # type: verbatim
31808 #. type: verbatim
31809 #: ../fish/guestfish-commands.pod:107
31810 #, no-wrap
31811 msgid ""
31812 " hexedit /dev/sda1 0x400 0x400\n"
31813 "\n"
31814 msgstr ""
31815
31816 # type: textblock
31817 #. type: textblock
31818 #: ../fish/guestfish-commands.pod:109
31819 msgid "(assuming the superblock is in the standard location)."
31820 msgstr ""
31821
31822 # type: textblock
31823 #. type: textblock
31824 #: ../fish/guestfish-commands.pod:111
31825 msgid ""
31826 "This command requires the external L<hexedit(1)> program.  You can specify "
31827 "another program to use by setting the C<HEXEDITOR> environment variable."
31828 msgstr ""
31829
31830 # type: textblock
31831 #. type: textblock
31832 #: ../fish/guestfish-commands.pod:115
31833 msgid "See also L</hexdump>."
31834 msgstr ""
31835
31836 # type: =head2
31837 #. type: =head2
31838 #: ../fish/guestfish-commands.pod:117
31839 msgid "lcd"
31840 msgstr ""
31841
31842 # type: verbatim
31843 #. type: verbatim
31844 #: ../fish/guestfish-commands.pod:119
31845 #, no-wrap
31846 msgid ""
31847 " lcd directory\n"
31848 "\n"
31849 msgstr ""
31850
31851 # type: textblock
31852 #. type: textblock
31853 #: ../fish/guestfish-commands.pod:121
31854 msgid ""
31855 "Change the local directory, ie. the current directory of guestfish itself."
31856 msgstr ""
31857
31858 # type: textblock
31859 #. type: textblock
31860 #: ../fish/guestfish-commands.pod:124
31861 msgid "Note that C<!cd> won't do what you might expect."
31862 msgstr ""
31863
31864 # type: =head2
31865 #. type: =head2
31866 #: ../fish/guestfish-commands.pod:126
31867 msgid "man"
31868 msgstr ""
31869
31870 # type: =head2
31871 #. type: =head2
31872 #: ../fish/guestfish-commands.pod:128
31873 msgid "manual"
31874 msgstr ""
31875
31876 # type: verbatim
31877 #. type: verbatim
31878 #: ../fish/guestfish-commands.pod:130
31879 #, no-wrap
31880 msgid ""
31881 "  man\n"
31882 "\n"
31883 msgstr ""
31884
31885 # type: textblock
31886 #. type: textblock
31887 #: ../fish/guestfish-commands.pod:132
31888 msgid "Opens the manual page for guestfish."
31889 msgstr ""
31890
31891 # type: =head2
31892 #. type: =head2
31893 #: ../fish/guestfish-commands.pod:134
31894 msgid "more"
31895 msgstr ""
31896
31897 # type: =head2
31898 #. type: =head2
31899 #: ../fish/guestfish-commands.pod:136
31900 msgid "less"
31901 msgstr ""
31902
31903 # type: verbatim
31904 #. type: verbatim
31905 #: ../fish/guestfish-commands.pod:138
31906 #, no-wrap
31907 msgid ""
31908 " more filename\n"
31909 "\n"
31910 msgstr ""
31911
31912 # type: verbatim
31913 #. type: verbatim
31914 #: ../fish/guestfish-commands.pod:140
31915 #, no-wrap
31916 msgid ""
31917 " less filename\n"
31918 "\n"
31919 msgstr ""
31920
31921 # type: textblock
31922 #. type: textblock
31923 #: ../fish/guestfish-commands.pod:142
31924 msgid "This is used to view a file."
31925 msgstr ""
31926
31927 # type: textblock
31928 #. type: textblock
31929 #: ../fish/guestfish-commands.pod:144
31930 msgid ""
31931 "The default viewer is C<$PAGER>.  However if you use the alternate command "
31932 "C<less> you will get the C<less> command specifically."
31933 msgstr ""
31934
31935 # type: =head2
31936 #. type: =head2
31937 #: ../fish/guestfish-commands.pod:147
31938 msgid "reopen"
31939 msgstr ""
31940
31941 # type: verbatim
31942 #. type: verbatim
31943 #: ../fish/guestfish-commands.pod:149
31944 #, no-wrap
31945 msgid ""
31946 "  reopen\n"
31947 "\n"
31948 msgstr ""
31949
31950 # type: textblock
31951 #. type: textblock
31952 #: ../fish/guestfish-commands.pod:151
31953 msgid ""
31954 "Close and reopen the libguestfs handle.  It is not necessary to use this "
31955 "normally, because the handle is closed properly when guestfish exits.  "
31956 "However this is occasionally useful for testing."
31957 msgstr ""
31958
31959 # type: =head2
31960 #. type: =head2
31961 #: ../fish/guestfish-commands.pod:155
31962 msgid "sparse"
31963 msgstr ""
31964
31965 # type: verbatim
31966 #. type: verbatim
31967 #: ../fish/guestfish-commands.pod:157
31968 #, no-wrap
31969 msgid ""
31970 " sparse filename size\n"
31971 "\n"
31972 msgstr ""
31973
31974 # type: textblock
31975 #. type: textblock
31976 #: ../fish/guestfish-commands.pod:159
31977 msgid ""
31978 "This creates an empty sparse file of the given size, and then adds so it can "
31979 "be further examined."
31980 msgstr ""
31981
31982 # type: textblock
31983 #. type: textblock
31984 #: ../fish/guestfish-commands.pod:162
31985 msgid ""
31986 "In all respects it works the same as the L</alloc> command, except that the "
31987 "image file is allocated sparsely, which means that disk blocks are not "
31988 "assigned to the file until they are needed.  Sparse disk files only use "
31989 "space when written to, but they are slower and there is a danger you could "
31990 "run out of real disk space during a write operation."
31991 msgstr ""
31992
31993 # type: =head2
31994 #. type: =head2
31995 #: ../fish/guestfish-commands.pod:172
31996 msgid "supported"
31997 msgstr ""
31998
31999 # type: verbatim
32000 #. type: verbatim
32001 #: ../fish/guestfish-commands.pod:174
32002 #, no-wrap
32003 msgid ""
32004 " supported\n"
32005 "\n"
32006 msgstr ""
32007
32008 # type: textblock
32009 #. type: textblock
32010 #: ../fish/guestfish-commands.pod:176
32011 msgid ""
32012 "This command returns a list of the optional groups known to the daemon, and "
32013 "indicates which ones are supported by this build of the libguestfs appliance."
32014 msgstr ""
32015
32016 # type: textblock
32017 #. type: textblock
32018 #: ../fish/guestfish-commands.pod:180
32019 msgid "See also L<guestfs(3)/AVAILABILITY>."
32020 msgstr ""
32021
32022 # type: =head2
32023 #. type: =head2
32024 #: ../fish/guestfish-commands.pod:182
32025 msgid "time"
32026 msgstr ""
32027
32028 # type: verbatim
32029 #. type: verbatim
32030 #: ../fish/guestfish-commands.pod:184
32031 #, no-wrap
32032 msgid ""
32033 " time command args...\n"
32034 "\n"
32035 msgstr ""
32036
32037 # type: textblock
32038 #. type: textblock
32039 #: ../fish/guestfish-commands.pod:186
32040 msgid ""
32041 "Run the command as usual, but print the elapsed time afterwards.  This can "
32042 "be useful for benchmarking operations."
32043 msgstr ""
32044
32045 # type: textblock
32046 #. type: textblock
32047 #: ../test-tool/libguestfs-test-tool.pod:5
32048 msgid "libguestfs-test-tool - End user tests for libguestfs"
32049 msgstr ""
32050
32051 # type: verbatim
32052 #. type: verbatim
32053 #: ../test-tool/libguestfs-test-tool.pod:9
32054 #, no-wrap
32055 msgid ""
32056 " libguestfs-test-tool [--options]\n"
32057 "\n"
32058 msgstr ""
32059
32060 # type: textblock
32061 #. type: textblock
32062 #: ../test-tool/libguestfs-test-tool.pod:13
32063 msgid ""
32064 "libguestfs-test-tool is a test program shipped with libguestfs to end users "
32065 "and developers, to allow them to check basic libguestfs functionality is "
32066 "working.  This is needed because libguestfs occasionally breaks for reasons "
32067 "beyond our control: usually because of changes in the underlying qemu or "
32068 "kernel packages, or the host environment."
32069 msgstr ""
32070
32071 # type: textblock
32072 #. type: textblock
32073 #: ../test-tool/libguestfs-test-tool.pod:20
32074 msgid "If you suspect a problem in libguestfs, then just run:"
32075 msgstr ""
32076
32077 # type: verbatim
32078 #. type: verbatim
32079 #: ../test-tool/libguestfs-test-tool.pod:22
32080 #, no-wrap
32081 msgid ""
32082 " libguestfs-test-tool\n"
32083 "\n"
32084 msgstr ""
32085
32086 # type: textblock
32087 #. type: textblock
32088 #: ../test-tool/libguestfs-test-tool.pod:24
32089 msgid "It will print lots of diagnostic messages."
32090 msgstr ""
32091
32092 # type: textblock
32093 #. type: textblock
32094 #: ../test-tool/libguestfs-test-tool.pod:26
32095 msgid "If it runs to completion successfully, you will see this near the end:"
32096 msgstr ""
32097
32098 # type: verbatim
32099 #. type: verbatim
32100 #: ../test-tool/libguestfs-test-tool.pod:28
32101 #, no-wrap
32102 msgid ""
32103 " ===== TEST FINISHED OK =====\n"
32104 "\n"
32105 msgstr ""
32106
32107 # type: textblock
32108 #. type: textblock
32109 #: ../test-tool/libguestfs-test-tool.pod:30
32110 msgid "and the test tool will exit with code 0."
32111 msgstr ""
32112
32113 # type: textblock
32114 #. type: textblock
32115 #: ../test-tool/libguestfs-test-tool.pod:32
32116 msgid ""
32117 "If it fails (and/or exits with non-zero error code), please paste the "
32118 "B<complete, unedited> output of the test tool into a bug report.  More "
32119 "information about reporting bugs can be found on the L<http://libguestfs.org/"
32120 "> website."
32121 msgstr ""
32122
32123 # type: =item
32124 #. type: =item
32125 #: ../test-tool/libguestfs-test-tool.pod:41
32126 msgid "I<--help>"
32127 msgstr ""
32128
32129 # type: textblock
32130 #. type: textblock
32131 #: ../test-tool/libguestfs-test-tool.pod:43
32132 msgid "Display short usage information and exit."
32133 msgstr ""
32134
32135 # type: =item
32136 #. type: =item
32137 #: ../test-tool/libguestfs-test-tool.pod:45
32138 msgid "I<--qemu qemu_binary>"
32139 msgstr ""
32140
32141 # type: textblock
32142 #. type: textblock
32143 #: ../test-tool/libguestfs-test-tool.pod:47
32144 msgid ""
32145 "If you have downloaded another qemu binary, point this option at the full "
32146 "path of the binary to try it."
32147 msgstr ""
32148
32149 # type: =item
32150 #. type: =item
32151 #: ../test-tool/libguestfs-test-tool.pod:50
32152 msgid "I<--qemudir qemu_source_dir>"
32153 msgstr ""
32154
32155 # type: textblock
32156 #. type: textblock
32157 #: ../test-tool/libguestfs-test-tool.pod:52
32158 msgid ""
32159 "If you have compiled qemu from source, point this option at the source "
32160 "directory to try it."
32161 msgstr ""
32162
32163 # type: =item
32164 #. type: =item
32165 #: ../test-tool/libguestfs-test-tool.pod:55
32166 msgid "I<--timeout N>"
32167 msgstr ""
32168
32169 # type: textblock
32170 #. type: textblock
32171 #: ../test-tool/libguestfs-test-tool.pod:57
32172 msgid ""
32173 "Set the launch timeout to C<N> seconds.  The default is 120 seconds which "
32174 "does not usually need to be adjusted unless your machine is very slow."
32175 msgstr ""
32176
32177 # type: =head1
32178 #. type: =head1
32179 #: ../test-tool/libguestfs-test-tool.pod:63
32180 msgid "TRYING OUT A DIFFERENT VERSION OF QEMU"
32181 msgstr ""
32182
32183 # type: textblock
32184 #. type: textblock
32185 #: ../test-tool/libguestfs-test-tool.pod:65
32186 msgid ""
32187 "If you have compiled another version of qemu from source and would like to "
32188 "try that, then you can use the I<--qemudir> option to point to the qemu "
32189 "source directory."
32190 msgstr ""
32191
32192 # type: textblock
32193 #. type: textblock
32194 #: ../test-tool/libguestfs-test-tool.pod:69
32195 msgid ""
32196 "If you have downloaded a qemu binary from somewhere, use the I<--qemu> "
32197 "option to point to the binary."
32198 msgstr ""
32199
32200 # type: textblock
32201 #. type: textblock
32202 #: ../test-tool/libguestfs-test-tool.pod:72
32203 msgid ""
32204 "When using an alternate qemu with libguestfs, usually you would need to "
32205 "write a qemu wrapper script (see section I<QEMU WRAPPERS> in L<guestfs(3)"
32206 ">).  libguestfs-test-tool writes a temporary qemu wrapper script when you "
32207 "use either of the I<--qemudir> or I<--qemu> options."
32208 msgstr ""
32209
32210 # type: textblock
32211 #. type: textblock
32212 #: ../test-tool/libguestfs-test-tool.pod:79
32213 msgid ""
32214 "libguestfs-test-tool returns I<0> if the tests completed without error, or "
32215 "I<1> if there was an error."
32216 msgstr ""
32217
32218 # type: textblock
32219 #. type: textblock
32220 #: ../test-tool/libguestfs-test-tool.pod:84
32221 msgid ""
32222 "For the full list of environment variables which may affect libguestfs, "
32223 "please see the L<guestfs(3)> manual page."
32224 msgstr ""
32225
32226 # type: textblock
32227 #. type: textblock
32228 #: ../test-tool/libguestfs-test-tool.pod:89
32229 msgid "L<guestfs(3)>, L<http://libguestfs.org/>, L<http://qemu.org/>."
32230 msgstr ""
32231
32232 # type: textblock
32233 #. type: textblock
32234 #: ../fuse/guestmount.pod:5
32235 msgid ""
32236 "guestmount - Mount a guest filesystem on the host using FUSE and libguestfs"
32237 msgstr ""
32238
32239 # type: verbatim
32240 #. type: verbatim
32241 #: ../fuse/guestmount.pod:9
32242 #, no-wrap
32243 msgid ""
32244 " guestmount [--options] -a disk.img -m device [--ro] mountpoint\n"
32245 "\n"
32246 msgstr ""
32247
32248 # type: verbatim
32249 #. type: verbatim
32250 #: ../fuse/guestmount.pod:11
32251 #, no-wrap
32252 msgid ""
32253 " guestmount [--options] -a disk.img -i [--ro] mountpoint\n"
32254 "\n"
32255 msgstr ""
32256
32257 # type: verbatim
32258 #. type: verbatim
32259 #: ../fuse/guestmount.pod:13
32260 #, no-wrap
32261 msgid ""
32262 " guestmount [--options] -d Guest -i [--ro] mountpoint\n"
32263 "\n"
32264 msgstr ""
32265
32266 # type: textblock
32267 #. type: textblock
32268 #: ../fuse/guestmount.pod:17
32269 msgid ""
32270 "You must I<not> use C<guestmount> in read-write mode on live virtual "
32271 "machines.  If you do this, you risk disk corruption in the VM."
32272 msgstr ""
32273
32274 # type: textblock
32275 #. type: textblock
32276 #: ../fuse/guestmount.pod:22
32277 msgid ""
32278 "The guestmount program can be used to mount virtual machine filesystems and "
32279 "other disk images on the host.  It uses libguestfs for access to the guest "
32280 "filesystem, and FUSE (the \"filesystem in userspace\") to make it appear as "
32281 "a mountable device."
32282 msgstr ""
32283
32284 # type: textblock
32285 #. type: textblock
32286 #: ../fuse/guestmount.pod:27
32287 msgid ""
32288 "Along with other options, you have to give at least one device (I<-a> "
32289 "option) or libvirt domain (I<-d> option), and at least one mountpoint (I<-m> "
32290 "option) or use the I<-i> inspection option.  How this works is better "
32291 "explained in the L<guestfish(1)> manual page, or by looking at the examples "
32292 "below."
32293 msgstr ""
32294
32295 # type: textblock
32296 #. type: textblock
32297 #: ../fuse/guestmount.pod:33
32298 msgid ""
32299 "FUSE lets you mount filesystems as non-root.  The mountpoint must be owned "
32300 "by you, and the filesystem will not be visible to any other users unless you "
32301 "make certain global configuration changes to C</etc/fuse.conf>.  To unmount "
32302 "the filesystem, use the C<fusermount -u> command."
32303 msgstr ""
32304
32305 # type: textblock
32306 #. type: textblock
32307 #: ../fuse/guestmount.pod:41
32308 msgid ""
32309 "For a typical Windows guest which has its main filesystem on the first "
32310 "partition:"
32311 msgstr ""
32312
32313 # type: verbatim
32314 #. type: verbatim
32315 #: ../fuse/guestmount.pod:44
32316 #, no-wrap
32317 msgid ""
32318 " guestmount -a windows.img -m /dev/sda1 --ro /mnt\n"
32319 "\n"
32320 msgstr ""
32321
32322 # type: textblock
32323 #. type: textblock
32324 #: ../fuse/guestmount.pod:46
32325 msgid ""
32326 "For a typical Linux guest which has a /boot filesystem on the first "
32327 "partition, and the root filesystem on a logical volume:"
32328 msgstr ""
32329
32330 # type: verbatim
32331 #. type: verbatim
32332 #: ../fuse/guestmount.pod:49
32333 #, no-wrap
32334 msgid ""
32335 " guestmount -a linux.img -m /dev/VG/LV -m /dev/sda1:/boot --ro /mnt\n"
32336 "\n"
32337 msgstr ""
32338
32339 # type: textblock
32340 #. type: textblock
32341 #: ../fuse/guestmount.pod:51
32342 msgid "To get libguestfs to detect guest mountpoints for you:"
32343 msgstr ""
32344
32345 # type: verbatim
32346 #. type: verbatim
32347 #: ../fuse/guestmount.pod:53
32348 #, no-wrap
32349 msgid ""
32350 " guestmount -a guest.img -i --ro /mnt\n"
32351 "\n"
32352 msgstr ""
32353
32354 # type: textblock
32355 #. type: textblock
32356 #: ../fuse/guestmount.pod:55
32357 msgid "For a libvirt guest called \"Guest\" you could do:"
32358 msgstr ""
32359
32360 # type: verbatim
32361 #. type: verbatim
32362 #: ../fuse/guestmount.pod:57
32363 #, no-wrap
32364 msgid ""
32365 " guestmount -d Guest -i --ro /mnt\n"
32366 "\n"
32367 msgstr ""
32368
32369 # type: textblock
32370 #. type: textblock
32371 #: ../fuse/guestmount.pod:59
32372 msgid ""
32373 "If you don't know what filesystems are contained in a guest or disk image, "
32374 "use L<virt-filesystems(1)> first:"
32375 msgstr ""
32376
32377 # type: verbatim
32378 #. type: verbatim
32379 #: ../fuse/guestmount.pod:62
32380 #, no-wrap
32381 msgid ""
32382 " virt-filesystems MyGuest\n"
32383 "\n"
32384 msgstr ""
32385
32386 # type: textblock
32387 #. type: textblock
32388 #: ../fuse/guestmount.pod:64
32389 msgid ""
32390 "If you want to trace the libguestfs calls but without excessive debugging "
32391 "information, we recommend:"
32392 msgstr ""
32393
32394 # type: verbatim
32395 #. type: verbatim
32396 #: ../fuse/guestmount.pod:67
32397 #, no-wrap
32398 msgid ""
32399 " guestmount [...] --trace /mnt\n"
32400 "\n"
32401 msgstr ""
32402
32403 # type: textblock
32404 #. type: textblock
32405 #: ../fuse/guestmount.pod:69
32406 msgid "If you want to debug the program, we recommend:"
32407 msgstr ""
32408
32409 # type: verbatim
32410 #. type: verbatim
32411 #: ../fuse/guestmount.pod:71
32412 #, no-wrap
32413 msgid ""
32414 " guestmount [...] --trace --verbose /mnt\n"
32415 "\n"
32416 msgstr ""
32417
32418 #. type: =head1
32419 #: ../fuse/guestmount.pod:73
32420 msgid "NOTES"
32421 msgstr ""
32422
32423 #. type: =head2
32424 #: ../fuse/guestmount.pod:75
32425 msgid "Other users cannot see the filesystem by default"
32426 msgstr ""
32427
32428 #. type: textblock
32429 #: ../fuse/guestmount.pod:77
32430 msgid ""
32431 "If you mount a filesystem as one user (eg. root), then other users will not "
32432 "be able to see it by default.  The fix is to add the FUSE C<allow_other> "
32433 "option when mounting:"
32434 msgstr ""
32435
32436 #. type: verbatim
32437 #: ../fuse/guestmount.pod:81
32438 #, no-wrap
32439 msgid ""
32440 " sudo guestmount [...] -o allow_other /mnt\n"
32441 "\n"
32442 msgstr ""
32443
32444 # type: =item
32445 #. type: =item
32446 #: ../fuse/guestmount.pod:87
32447 msgid "B<-a image> | B<--add image>"
32448 msgstr ""
32449
32450 # type: textblock
32451 #. type: textblock
32452 #: ../fuse/guestmount.pod:89
32453 msgid "Add a block device or virtual machine image."
32454 msgstr ""
32455
32456 # type: =item
32457 #. type: =item
32458 #: ../fuse/guestmount.pod:94
32459 msgid "B<-c URI> | B<--connect URI>"
32460 msgstr ""
32461
32462 # type: =item
32463 #. type: =item
32464 #: ../fuse/guestmount.pod:100
32465 msgid "B<-d libvirt-domain> | B<--domain libvirt-domain>"
32466 msgstr ""
32467
32468 # type: =item
32469 #. type: =item
32470 #: ../fuse/guestmount.pod:106
32471 msgid "B<--dir-cache-timeout N>"
32472 msgstr ""
32473
32474 # type: textblock
32475 #. type: textblock
32476 #: ../fuse/guestmount.pod:108
32477 msgid ""
32478 "Set the readdir cache timeout to I<N> seconds, the default being 60 "
32479 "seconds.  The readdir cache [actually, there are several semi-independent "
32480 "caches] is populated after a readdir(2) call with the stat and extended "
32481 "attributes of the files in the directory, in anticipation that they will be "
32482 "requested soon after."
32483 msgstr ""
32484
32485 # type: textblock
32486 #. type: textblock
32487 #: ../fuse/guestmount.pod:114
32488 msgid ""
32489 "There is also a different attribute cache implemented by FUSE (see the FUSE "
32490 "option I<-o attr_timeout>), but the FUSE cache does not anticipate future "
32491 "requests, only cache existing ones."
32492 msgstr ""
32493
32494 # type: =item
32495 #. type: =item
32496 #: ../fuse/guestmount.pod:125
32497 msgid "B<--format=raw|qcow2|..> | B<--format>"
32498 msgstr ""
32499
32500 # type: textblock
32501 #. type: textblock
32502 #: ../fuse/guestmount.pod:132
32503 msgid ""
32504 "If you have untrusted raw-format guest disk images, you should use this "
32505 "option to specify the disk format.  This avoids a possible security problem "
32506 "with malicious guests (CVE-2010-3851).  See also L<guestfs(3)/"
32507 "guestfs_add_drive_opts>."
32508 msgstr ""
32509
32510 # type: =item
32511 #. type: =item
32512 #: ../fuse/guestmount.pod:137
32513 msgid "B<--fuse-help>"
32514 msgstr ""
32515
32516 # type: textblock
32517 #. type: textblock
32518 #: ../fuse/guestmount.pod:139
32519 msgid "Display help on special FUSE options (see I<-o> below)."
32520 msgstr ""
32521
32522 # type: textblock
32523 #. type: textblock
32524 #: ../fuse/guestmount.pod:143
32525 msgid "Display brief help and exit."
32526 msgstr ""
32527
32528 # type: =item
32529 #. type: =item
32530 #: ../fuse/guestmount.pod:145
32531 msgid "B<-i> | B<--inspector>"
32532 msgstr ""
32533
32534 # type: textblock
32535 #. type: textblock
32536 #: ../fuse/guestmount.pod:165
32537 msgid ""
32538 "Mount the named partition or logical volume on the given mountpoint B<in the "
32539 "guest> (this has nothing to do with mountpoints in the host)."
32540 msgstr ""
32541
32542 # type: textblock
32543 #. type: textblock
32544 #: ../fuse/guestmount.pod:168
32545 msgid ""
32546 "If the mountpoint is omitted, it defaults to C</>.  You have to mount "
32547 "something on C</>."
32548 msgstr ""
32549
32550 # type: =item
32551 #. type: =item
32552 #: ../fuse/guestmount.pod:181
32553 msgid "B<-n> | B<--no-sync>"
32554 msgstr ""
32555
32556 # type: textblock
32557 #. type: textblock
32558 #: ../fuse/guestmount.pod:183
32559 msgid ""
32560 "By default, we attempt to sync the guest disk when the FUSE mountpoint is "
32561 "unmounted.  If you specify this option, then we don't attempt to sync the "
32562 "disk.  See the discussion of autosync in the L<guestfs(3)> manpage."
32563 msgstr ""
32564
32565 # type: =item
32566 #. type: =item
32567 #: ../fuse/guestmount.pod:188
32568 msgid "B<-o option> | B<--option option>"
32569 msgstr ""
32570
32571 # type: textblock
32572 #. type: textblock
32573 #: ../fuse/guestmount.pod:190
32574 msgid "Pass extra options to FUSE."
32575 msgstr ""
32576
32577 # type: textblock
32578 #. type: textblock
32579 #: ../fuse/guestmount.pod:192
32580 msgid ""
32581 "To get a list of all the extra options supported by FUSE, use the command "
32582 "below.  Note that only the FUSE I<-o> options can be passed, and only some "
32583 "of them are a good idea."
32584 msgstr ""
32585
32586 # type: verbatim
32587 #. type: verbatim
32588 #: ../fuse/guestmount.pod:196
32589 #, no-wrap
32590 msgid ""
32591 " guestmount --fuse-help\n"
32592 "\n"
32593 msgstr ""
32594
32595 # type: textblock
32596 #. type: textblock
32597 #: ../fuse/guestmount.pod:198
32598 msgid "Some potentially useful FUSE options:"
32599 msgstr ""
32600
32601 # type: =item
32602 #. type: =item
32603 #: ../fuse/guestmount.pod:202
32604 msgid "B<-o allow_other>"
32605 msgstr ""
32606
32607 # type: textblock
32608 #. type: textblock
32609 #: ../fuse/guestmount.pod:204
32610 msgid "Allow other users to see the filesystem."
32611 msgstr ""
32612
32613 # type: =item
32614 #. type: =item
32615 #: ../fuse/guestmount.pod:206
32616 msgid "B<-o attr_timeout=N>"
32617 msgstr ""
32618
32619 # type: textblock
32620 #. type: textblock
32621 #: ../fuse/guestmount.pod:208
32622 msgid "Enable attribute caching by FUSE, and set the timeout to I<N> seconds."
32623 msgstr ""
32624
32625 # type: =item
32626 #. type: =item
32627 #: ../fuse/guestmount.pod:210
32628 msgid "B<-o kernel_cache>"
32629 msgstr ""
32630
32631 # type: textblock
32632 #. type: textblock
32633 #: ../fuse/guestmount.pod:212
32634 msgid ""
32635 "Allow the kernel to cache files (reduces the number of reads that have to go "
32636 "through the L<guestfs(3)> API).  This is generally a good idea if you can "
32637 "afford the extra memory usage."
32638 msgstr ""
32639
32640 # type: =item
32641 #. type: =item
32642 #: ../fuse/guestmount.pod:216
32643 msgid "B<-o uid=N> B<-o gid=N>"
32644 msgstr ""
32645
32646 # type: textblock
32647 #. type: textblock
32648 #: ../fuse/guestmount.pod:218
32649 msgid ""
32650 "Use these options to map all UIDs and GIDs inside the guest filesystem to "
32651 "the chosen values."
32652 msgstr ""
32653
32654 # type: =item
32655 #. type: =item
32656 #: ../fuse/guestmount.pod:223
32657 msgid "B<-r> | B<--ro>"
32658 msgstr ""
32659
32660 # type: textblock
32661 #. type: textblock
32662 #: ../fuse/guestmount.pod:225
32663 msgid ""
32664 "Add devices and mount everything read-only.  Also disallow writes and make "
32665 "the disk appear read-only to FUSE."
32666 msgstr ""
32667
32668 # type: textblock
32669 #. type: textblock
32670 #: ../fuse/guestmount.pod:228
32671 msgid ""
32672 "This is highly recommended if you are not going to edit the guest disk.  If "
32673 "the guest is running and this option is I<not> supplied, then there is a "
32674 "strong risk of disk corruption in the guest.  We try to prevent this from "
32675 "happening, but it is not always possible."
32676 msgstr ""
32677
32678 # type: textblock
32679 #. type: textblock
32680 #: ../fuse/guestmount.pod:233
32681 msgid "See also L<guestfish(1)/OPENING DISKS FOR READ AND WRITE>."
32682 msgstr ""
32683
32684 # type: textblock
32685 #. type: textblock
32686 #: ../fuse/guestmount.pod:237
32687 msgid "Enable SELinux support for the guest."
32688 msgstr ""
32689
32690 # type: =item
32691 #. type: =item
32692 #: ../fuse/guestmount.pod:239
32693 msgid "B<-v> | B<--verbose>"
32694 msgstr ""
32695
32696 # type: textblock
32697 #. type: textblock
32698 #: ../fuse/guestmount.pod:241
32699 msgid "Enable verbose messages from underlying libguestfs."
32700 msgstr ""
32701
32702 # type: =item
32703 #. type: =item
32704 #: ../fuse/guestmount.pod:243
32705 msgid "B<-V> | B<--version>"
32706 msgstr ""
32707
32708 # type: textblock
32709 #. type: textblock
32710 #: ../fuse/guestmount.pod:245
32711 msgid "Display the program version and exit."
32712 msgstr ""
32713
32714 # type: =item
32715 #. type: =item
32716 #: ../fuse/guestmount.pod:247
32717 msgid "B<-w> | B<--rw>"
32718 msgstr ""
32719
32720 #. type: textblock
32721 #: ../fuse/guestmount.pod:252 ../fuse/guestmount.pod:273
32722 msgid "See L<guestfish(1)/OPENING DISKS FOR READ AND WRITE>."
32723 msgstr ""
32724
32725 # type: =item
32726 #. type: =item
32727 #: ../fuse/guestmount.pod:254
32728 msgid "B<-x> | B<--trace>"
32729 msgstr ""
32730
32731 # type: textblock
32732 #. type: textblock
32733 #: ../fuse/guestmount.pod:256
32734 msgid "Trace libguestfs calls and entry into each FUSE function."
32735 msgstr ""
32736
32737 # type: textblock
32738 #. type: textblock
32739 #: ../fuse/guestmount.pod:258
32740 msgid "This also stops the daemon from forking into the background."
32741 msgstr ""
32742
32743 # type: textblock
32744 #. type: textblock
32745 #: ../fuse/guestmount.pod:279
32746 msgid ""
32747 "L<guestfish(1)>, L<virt-inspector(1)>, L<virt-cat(1)>, L<virt-edit(1)>, "
32748 "L<virt-tar(1)>, L<guestfs(3)>, L<http://libguestfs.org/>, L<http://fuse.sf."
32749 "net/>."
32750 msgstr ""
32751
32752 # type: textblock
32753 #. type: textblock
32754 #: ../fuse/guestmount.pod:294
32755 msgid "Copyright (C) 2009-2010 Red Hat Inc.  L<http://libguestfs.org/>"
32756 msgstr ""
32757
32758 # type: textblock
32759 #. type: textblock
32760 #: ../tools/virt-edit.pl:34
32761 msgid "virt-edit - Edit a file in a virtual machine"
32762 msgstr ""
32763
32764 # type: verbatim
32765 #. type: verbatim
32766 #: ../tools/virt-edit.pl:38
32767 #, no-wrap
32768 msgid ""
32769 " virt-edit [--options] domname file\n"
32770 "\n"
32771 msgstr ""
32772
32773 # type: verbatim
32774 #. type: verbatim
32775 #: ../tools/virt-edit.pl:40
32776 #, no-wrap
32777 msgid ""
32778 " virt-edit [--options] disk.img [disk.img ...] file\n"
32779 "\n"
32780 msgstr ""
32781
32782 # type: verbatim
32783 #. type: verbatim
32784 #: ../tools/virt-edit.pl:42
32785 #, no-wrap
32786 msgid ""
32787 " virt-edit [domname|disk.img] file -e 'expr'\n"
32788 "\n"
32789 msgstr ""
32790
32791 # type: textblock
32792 #. type: textblock
32793 #: ../tools/virt-edit.pl:46
32794 msgid ""
32795 "You must I<not> use C<virt-edit> on live virtual machines.  If you do this, "
32796 "you risk disk corruption in the VM.  C<virt-edit> tries to stop you from "
32797 "doing this, but doesn't catch all cases."
32798 msgstr ""
32799
32800 # type: textblock
32801 #. type: textblock
32802 #: ../tools/virt-edit.pl:52
32803 msgid ""
32804 "C<virt-edit> is a command line tool to edit C<file> where C<file> exists in "
32805 "the named virtual machine (or disk image)."
32806 msgstr ""
32807
32808 #. type: textblock
32809 #: ../tools/virt-edit.pl:55
32810 msgid "If you want to just view a file, use L<virt-cat(1)>."
32811 msgstr ""
32812
32813 #. type: textblock
32814 #: ../tools/virt-edit.pl:57
32815 msgid ""
32816 "For more complex cases you should look at the L<guestfish(1)> tool (see L</"
32817 "USING GUESTFISH> below)."
32818 msgstr ""
32819
32820 #. type: textblock
32821 #: ../tools/virt-edit.pl:60
32822 msgid ""
32823 "C<virt-edit> cannot be used to create a new file, nor to edit multiple "
32824 "files.  L<guestfish(1)> can do that and much more."
32825 msgstr ""
32826
32827 # type: textblock
32828 #. type: textblock
32829 #: ../tools/virt-edit.pl:65
32830 msgid "Edit the named files interactively:"
32831 msgstr ""
32832
32833 # type: verbatim
32834 #. type: verbatim
32835 #: ../tools/virt-edit.pl:67
32836 #, no-wrap
32837 msgid ""
32838 " virt-edit mydomain /boot/grub/grub.conf\n"
32839 "\n"
32840 msgstr ""
32841
32842 # type: verbatim
32843 #. type: verbatim
32844 #: ../tools/virt-edit.pl:69
32845 #, no-wrap
32846 msgid ""
32847 " virt-edit mydomain /etc/passwd\n"
32848 "\n"
32849 msgstr ""
32850
32851 #. type: textblock
32852 #: ../tools/virt-edit.pl:71
32853 msgid "For Windows guests, some Windows paths are understood:"
32854 msgstr ""
32855
32856 #. type: verbatim
32857 #: ../tools/virt-edit.pl:73
32858 #, no-wrap
32859 msgid ""
32860 " virt-edit mywindomain 'c:\\autoexec.bat'\n"
32861 "\n"
32862 msgstr ""
32863
32864 # type: textblock
32865 #. type: textblock
32866 #: ../tools/virt-edit.pl:75
32867 msgid ""
32868 "You can also edit files non-interactively (see L</NON-INTERACTIVE EDITING> "
32869 "below).  To change the init default level to 5:"
32870 msgstr ""
32871
32872 # type: verbatim
32873 #. type: verbatim
32874 #: ../tools/virt-edit.pl:79
32875 #, no-wrap
32876 msgid ""
32877 " virt-edit mydomain /etc/inittab -e 's/^id:.*/id:5:initdefault:/'\n"
32878 "\n"
32879 msgstr ""
32880
32881 # type: textblock
32882 #. type: textblock
32883 #: ../tools/virt-edit.pl:91 ../tools/virt-win-reg.pl:106
32884 #: ../tools/virt-list-filesystems.pl:63 ../tools/virt-tar.pl:113
32885 #: ../tools/virt-make-fs.pl:163 ../tools/virt-list-partitions.pl:64
32886 msgid "Display brief help."
32887 msgstr ""
32888
32889 # type: textblock
32890 #. type: textblock
32891 #: ../tools/virt-edit.pl:99 ../tools/virt-win-reg.pl:114
32892 #: ../tools/virt-list-filesystems.pl:71 ../tools/virt-tar.pl:121
32893 #: ../tools/virt-make-fs.pl:171 ../tools/virt-list-partitions.pl:72
32894 msgid "Display version number and exit."
32895 msgstr ""
32896
32897 # type: =item
32898 #. type: =item
32899 #: ../tools/virt-edit.pl:105
32900 msgid "B<--backup extension> | B<-b extension>"
32901 msgstr ""
32902
32903 # type: textblock
32904 #. type: textblock
32905 #: ../tools/virt-edit.pl:107
32906 msgid ""
32907 "Create a backup of the original file I<in the guest disk image>.  The backup "
32908 "has the original filename with C<extension> added."
32909 msgstr ""
32910
32911 # type: textblock
32912 #. type: textblock
32913 #: ../tools/virt-edit.pl:110
32914 msgid ""
32915 "Usually the first character of C<extension> would be a dot C<.> so you would "
32916 "write:"
32917 msgstr ""
32918
32919 # type: verbatim
32920 #. type: verbatim
32921 #: ../tools/virt-edit.pl:113
32922 #, no-wrap
32923 msgid ""
32924 " virt-edit -b .orig [etc]\n"
32925 "\n"
32926 msgstr ""
32927
32928 # type: textblock
32929 #. type: textblock
32930 #: ../tools/virt-edit.pl:115
32931 msgid "By default, no backup file is made."
32932 msgstr ""
32933
32934 # type: =item
32935 #. type: =item
32936 #: ../tools/virt-edit.pl:121 ../tools/virt-win-reg.pl:128
32937 #: ../tools/virt-list-filesystems.pl:77 ../tools/virt-tar.pl:127
32938 #: ../tools/virt-list-partitions.pl:78
32939 msgid "B<--connect URI> | B<-c URI>"
32940 msgstr ""
32941
32942 # type: textblock
32943 #. type: textblock
32944 #: ../tools/virt-edit.pl:123 ../tools/virt-win-reg.pl:130
32945 #: ../tools/virt-list-filesystems.pl:79 ../tools/virt-tar.pl:129
32946 #: ../tools/virt-list-partitions.pl:80
32947 msgid ""
32948 "If using libvirt, connect to the given I<URI>.  If omitted, then we connect "
32949 "to the default libvirt hypervisor."
32950 msgstr ""
32951
32952 # type: textblock
32953 #. type: textblock
32954 #: ../tools/virt-edit.pl:126 ../tools/virt-win-reg.pl:133
32955 #: ../tools/virt-list-filesystems.pl:82 ../tools/virt-tar.pl:132
32956 #: ../tools/virt-list-partitions.pl:83
32957 msgid ""
32958 "If you specify guest block devices directly, then libvirt is not used at all."
32959 msgstr ""
32960
32961 # type: =item
32962 #. type: =item
32963 #: ../tools/virt-edit.pl:133 ../tools/virt-win-reg.pl:140
32964 #: ../tools/virt-list-filesystems.pl:89 ../tools/virt-tar.pl:139
32965 #: ../tools/virt-list-partitions.pl:90
32966 msgid "B<--format> raw"
32967 msgstr ""
32968
32969 # type: textblock
32970 #. type: textblock
32971 #: ../tools/virt-edit.pl:135 ../tools/virt-win-reg.pl:142
32972 #: ../tools/virt-list-filesystems.pl:91 ../tools/virt-tar.pl:141
32973 #: ../tools/virt-list-partitions.pl:92
32974 msgid ""
32975 "Specify the format of disk images given on the command line.  If this is "
32976 "omitted then the format is autodetected from the content of the disk image."
32977 msgstr ""
32978
32979 # type: textblock
32980 #. type: textblock
32981 #: ../tools/virt-edit.pl:139 ../tools/virt-win-reg.pl:146
32982 #: ../tools/virt-list-filesystems.pl:95 ../tools/virt-tar.pl:145
32983 #: ../tools/virt-list-partitions.pl:96
32984 msgid ""
32985 "If disk images are requested from libvirt, then this program asks libvirt "
32986 "for this information.  In this case, the value of the format parameter is "
32987 "ignored."
32988 msgstr ""
32989
32990 # type: textblock
32991 #. type: textblock
32992 #: ../tools/virt-edit.pl:143 ../tools/virt-win-reg.pl:150
32993 #: ../tools/virt-list-filesystems.pl:99 ../tools/virt-tar.pl:149
32994 #: ../tools/virt-list-partitions.pl:100
32995 msgid ""
32996 "If working with untrusted raw-format guest disk images, you should ensure "
32997 "the format is always specified."
32998 msgstr ""
32999
33000 # type: =item
33001 #. type: =item
33002 #: ../tools/virt-edit.pl:150
33003 msgid "B<--expr EXPR> | B<-e EXPR>"
33004 msgstr ""
33005
33006 # type: textblock
33007 #. type: textblock
33008 #: ../tools/virt-edit.pl:152
33009 msgid ""
33010 "Instead of launching the external editor, non-interactively apply the Perl "
33011 "expression C<EXPR> to each line in the file.  See L</NON-INTERACTIVE "
33012 "EDITING> below."
33013 msgstr ""
33014
33015 # type: textblock
33016 #. type: textblock
33017 #: ../tools/virt-edit.pl:156
33018 msgid ""
33019 "Be careful to properly quote the expression to prevent it from being altered "
33020 "by the shell."
33021 msgstr ""
33022
33023 # type: =head1
33024 #. type: =head1
33025 #: ../tools/virt-edit.pl:280
33026 msgid "NON-INTERACTIVE EDITING"
33027 msgstr ""
33028
33029 # type: textblock
33030 #. type: textblock
33031 #: ../tools/virt-edit.pl:282
33032 msgid ""
33033 "C<virt-edit> normally calls out to C<$EDITOR> (or vi) so the system "
33034 "administrator can interactively edit the file."
33035 msgstr ""
33036
33037 # type: textblock
33038 #. type: textblock
33039 #: ../tools/virt-edit.pl:285
33040 msgid ""
33041 "There are two ways also to use C<virt-edit> from scripts in order to make "
33042 "automated edits to files.  (Note that although you I<can> use C<virt-edit> "
33043 "like this, it's less error-prone to write scripts directly using the "
33044 "libguestfs API and Augeas for configuration file editing.)"
33045 msgstr ""
33046
33047 # type: textblock
33048 #. type: textblock
33049 #: ../tools/virt-edit.pl:291
33050 msgid ""
33051 "The first method is to temporarily set C<$EDITOR> to any script or program "
33052 "you want to run.  The script is invoked as C<$EDITOR tmpfile> and it should "
33053 "update C<tmpfile> in place however it likes."
33054 msgstr ""
33055
33056 #. type: textblock
33057 #: ../tools/virt-edit.pl:295
33058 msgid ""
33059 "The second method is to use the I<-e> parameter of C<virt-edit> to run a "
33060 "short Perl snippet in the style of L<sed(1)>.  For example to replace all "
33061 "instances of C<foo> with C<bar> in a file:"
33062 msgstr ""
33063
33064 # type: verbatim
33065 #. type: verbatim
33066 #: ../tools/virt-edit.pl:299
33067 #, no-wrap
33068 msgid ""
33069 " virt-edit domname filename -e 's/foo/bar/'\n"
33070 "\n"
33071 msgstr ""
33072
33073 # type: textblock
33074 #. type: textblock
33075 #: ../tools/virt-edit.pl:301
33076 msgid ""
33077 "The full power of Perl regular expressions can be used (see L<perlre(1)>).  "
33078 "For example to delete root's password you could do:"
33079 msgstr ""
33080
33081 # type: verbatim
33082 #. type: verbatim
33083 #: ../tools/virt-edit.pl:304
33084 #, no-wrap
33085 msgid ""
33086 " virt-edit domname /etc/passwd -e 's/^root:.*?:/root::/'\n"
33087 "\n"
33088 msgstr ""
33089
33090 # type: textblock
33091 #. type: textblock
33092 #: ../tools/virt-edit.pl:306
33093 msgid ""
33094 "What really happens is that the snippet is evaluated as a Perl expression "
33095 "for each line of the file.  The line, including the final C<\\n>, is passed "
33096 "in C<$_> and the expression should update C<$_> or leave it unchanged."
33097 msgstr ""
33098
33099 # type: textblock
33100 #. type: textblock
33101 #: ../tools/virt-edit.pl:311
33102 msgid ""
33103 "To delete a line, set C<$_> to the empty string.  For example, to delete the "
33104 "C<apache> user account from the password file you can do:"
33105 msgstr ""
33106
33107 # type: verbatim
33108 #. type: verbatim
33109 #: ../tools/virt-edit.pl:314
33110 #, no-wrap
33111 msgid ""
33112 " virt-edit mydomain /etc/passwd -e '$_ = \"\" if /^apache:/'\n"
33113 "\n"
33114 msgstr ""
33115
33116 # type: textblock
33117 #. type: textblock
33118 #: ../tools/virt-edit.pl:316
33119 msgid ""
33120 "To insert a line, prepend or append it to C<$_>.  However appending lines to "
33121 "the end of the file is rather difficult this way since there is no concept "
33122 "of \"last line of the file\" - your expression just doesn't get called "
33123 "again.  You might want to use the first method (setting C<$EDITOR>) if you "
33124 "want to do this."
33125 msgstr ""
33126
33127 # type: textblock
33128 #. type: textblock
33129 #: ../tools/virt-edit.pl:322
33130 msgid ""
33131 "The variable C<$lineno> contains the current line number.  As is "
33132 "traditional, the first line in the file is number C<1>."
33133 msgstr ""
33134
33135 # type: textblock
33136 #. type: textblock
33137 #: ../tools/virt-edit.pl:325
33138 msgid ""
33139 "The return value from the expression is ignored, but the expression may call "
33140 "C<die> in order to abort the whole program, leaving the original file "
33141 "untouched."
33142 msgstr ""
33143
33144 # type: textblock
33145 #. type: textblock
33146 #: ../tools/virt-edit.pl:329
33147 msgid ""
33148 "Remember when matching the end of a line that C<$_> may contain the final C<"
33149 "\\n>, or (for DOS files) C<\\r\\n>, or if the file does not end with a "
33150 "newline then neither of these.  Thus to match or substitute some text at the "
33151 "end of a line, use this regular expression:"
33152 msgstr ""
33153
33154 # type: verbatim
33155 #. type: verbatim
33156 #: ../tools/virt-edit.pl:334
33157 #, no-wrap
33158 msgid ""
33159 " /some text(\\r?\\n)?$/\n"
33160 "\n"
33161 msgstr ""
33162
33163 # type: textblock
33164 #. type: textblock
33165 #: ../tools/virt-edit.pl:336
33166 msgid ""
33167 "Alternately, use the perl C<chomp> function, being careful not to chomp C<"
33168 "$_> itself (since that would remove all newlines from the file):"
33169 msgstr ""
33170
33171 # type: verbatim
33172 #. type: verbatim
33173 #: ../tools/virt-edit.pl:340
33174 #, no-wrap
33175 msgid ""
33176 " my $m = $_; chomp $m; $m =~ /some text$/\n"
33177 "\n"
33178 msgstr ""
33179
33180 #. type: textblock
33181 #: ../tools/virt-edit.pl:344
33182 msgid ""
33183 "C<virt-edit> has a limited ability to understand Windows drive letters and "
33184 "paths (eg. C<E:\\foo\\bar.txt>)."
33185 msgstr ""
33186
33187 #. type: textblock
33188 #: ../tools/virt-edit.pl:347
33189 msgid "If and only if the guest is running Windows then:"
33190 msgstr ""
33191
33192 #. type: textblock
33193 #: ../tools/virt-edit.pl:353
33194 msgid ""
33195 "Drive letter prefixes like C<C:> are resolved against the Windows Registry "
33196 "to the correct filesystem."
33197 msgstr ""
33198
33199 #. type: textblock
33200 #: ../tools/virt-edit.pl:358
33201 msgid ""
33202 "Any backslash (C<\\>) characters in the path are replaced with forward "
33203 "slashes so that libguestfs can process it."
33204 msgstr ""
33205
33206 #. type: textblock
33207 #: ../tools/virt-edit.pl:363
33208 msgid ""
33209 "The path is resolved case insensitively to locate the file that should be "
33210 "edited."
33211 msgstr ""
33212
33213 #. type: textblock
33214 #: ../tools/virt-edit.pl:368
33215 msgid "There are some known shortcomings:"
33216 msgstr ""
33217
33218 #. type: textblock
33219 #: ../tools/virt-edit.pl:374
33220 msgid "Some NTFS symbolic links may not be followed correctly."
33221 msgstr ""
33222
33223 #. type: textblock
33224 #: ../tools/virt-edit.pl:378
33225 msgid "NTFS junction points that cross filesystems are not followed."
33226 msgstr ""
33227
33228 #. type: =head1
33229 #: ../tools/virt-edit.pl:435
33230 msgid "USING GUESTFISH"
33231 msgstr ""
33232
33233 #. type: textblock
33234 #: ../tools/virt-edit.pl:437
33235 msgid ""
33236 "L<guestfish(1)> is a more powerful, lower level tool which you can use when "
33237 "C<virt-edit> doesn't work."
33238 msgstr ""
33239
33240 #. type: textblock
33241 #: ../tools/virt-edit.pl:440
33242 msgid "Using C<virt-edit> is approximately equivalent to doing:"
33243 msgstr ""
33244
33245 #. type: verbatim
33246 #: ../tools/virt-edit.pl:442
33247 #, no-wrap
33248 msgid ""
33249 " guestfish --rw -i -d domname edit /file\n"
33250 "\n"
33251 msgstr ""
33252
33253 #. type: textblock
33254 #: ../tools/virt-edit.pl:444
33255 msgid ""
33256 "where C<domname> is the name of the libvirt guest, and C</file> is the full "
33257 "path to the file."
33258 msgstr ""
33259
33260 #. type: textblock
33261 #: ../tools/virt-edit.pl:447
33262 msgid ""
33263 "The command above uses libguestfs's guest inspection feature and so does not "
33264 "work on guests that libguestfs cannot inspect, or on things like arbitrary "
33265 "disk images that don't contain guests.  To edit a file on a disk image "
33266 "directly, use:"
33267 msgstr ""
33268
33269 #. type: verbatim
33270 #: ../tools/virt-edit.pl:452
33271 #, no-wrap
33272 msgid ""
33273 " guestfish --rw -a disk.img -m /dev/sda1 edit /file\n"
33274 "\n"
33275 msgstr ""
33276
33277 #. type: textblock
33278 #: ../tools/virt-edit.pl:454
33279 msgid ""
33280 "where C<disk.img> is the disk image, C</dev/sda1> is the filesystem within "
33281 "the disk image to edit, and C</file> is the full path to the file."
33282 msgstr ""
33283
33284 #. type: textblock
33285 #: ../tools/virt-edit.pl:458
33286 msgid ""
33287 "C<virt-edit> cannot create new files.  Use the guestfish commands C<touch>, "
33288 "C<write> or C<upload> instead:"
33289 msgstr ""
33290
33291 #. type: verbatim
33292 #: ../tools/virt-edit.pl:461
33293 #, no-wrap
33294 msgid ""
33295 " guestfish --rw -i -d domname touch /newfile\n"
33296 "\n"
33297 msgstr ""
33298
33299 #. type: verbatim
33300 #: ../tools/virt-edit.pl:463
33301 #, no-wrap
33302 msgid ""
33303 " guestfish --rw -i -d domname write /newfile \"new content\"\n"
33304 "\n"
33305 msgstr ""
33306
33307 #. type: verbatim
33308 #: ../tools/virt-edit.pl:465
33309 #, no-wrap
33310 msgid ""
33311 " guestfish --rw -i -d domname upload localfile /newfile\n"
33312 "\n"
33313 msgstr ""
33314
33315 #. type: textblock
33316 #: ../tools/virt-edit.pl:467
33317 msgid ""
33318 "C<virt-edit> cannot edit multiple files, but guestfish can do it like this:"
33319 msgstr ""
33320
33321 #. type: verbatim
33322 #: ../tools/virt-edit.pl:470
33323 #, no-wrap
33324 msgid ""
33325 " guestfish --rw -i -d domname edit /file1 : edit /file2\n"
33326 "\n"
33327 msgstr ""
33328
33329 # type: =item
33330 #. type: =item
33331 #: ../tools/virt-edit.pl:480
33332 msgid "C<EDITOR>"
33333 msgstr ""
33334
33335 # type: textblock
33336 #. type: textblock
33337 #: ../tools/virt-edit.pl:482
33338 msgid ""
33339 "If set, this string is used as the editor.  It may contain arguments, eg. C<"
33340 "\"emacs -nw\">"
33341 msgstr ""
33342
33343 # type: textblock
33344 #. type: textblock
33345 #: ../tools/virt-edit.pl:485
33346 msgid "If not set, C<vi> is used."
33347 msgstr ""
33348
33349 # type: =head2
33350 #. type: =head1
33351 #: ../tools/virt-edit.pl:489 ../tools/virt-win-reg.pl:559
33352 #: ../tools/virt-list-filesystems.pl:182 ../tools/virt-tar.pl:279
33353 #: ../tools/virt-make-fs.pl:532 ../tools/virt-list-partitions.pl:250
33354 msgid "SHELL QUOTING"
33355 msgstr ""
33356
33357 # type: textblock
33358 #. type: textblock
33359 #: ../tools/virt-edit.pl:491 ../tools/virt-win-reg.pl:567
33360 #: ../tools/virt-list-filesystems.pl:184 ../tools/virt-tar.pl:281
33361 #: ../tools/virt-make-fs.pl:534 ../tools/virt-list-partitions.pl:252
33362 msgid ""
33363 "Libvirt guest names can contain arbitrary characters, some of which have "
33364 "meaning to the shell such as C<#> and space.  You may need to quote or "
33365 "escape these characters on the command line.  See the shell manual page L<sh"
33366 "(1)> for details."
33367 msgstr ""
33368
33369 #. type: textblock
33370 #: ../tools/virt-edit.pl:498
33371 msgid ""
33372 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-copy-in(1)>, L<virt-"
33373 "tar-in(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, "
33374 "L<http://libguestfs.org/>, L<perl(1)>, L<perlre(1)>."
33375 msgstr ""
33376
33377 # type: =head1
33378 #. type: =head1
33379 #: ../tools/virt-edit.pl:510 ../tools/virt-win-reg.pl:598
33380 #: ../tools/virt-list-filesystems.pl:202 ../tools/virt-tar.pl:301
33381 #: ../tools/virt-make-fs.pl:564 ../tools/virt-list-partitions.pl:269
33382 msgid "AUTHOR"
33383 msgstr ""
33384
33385 # type: textblock
33386 #. type: textblock
33387 #: ../tools/virt-edit.pl:512 ../tools/virt-win-reg.pl:600
33388 #: ../tools/virt-list-filesystems.pl:204 ../tools/virt-tar.pl:303
33389 #: ../tools/virt-make-fs.pl:566 ../tools/virt-list-partitions.pl:271
33390 msgid "Richard W.M. Jones L<http://people.redhat.com/~rjones/>"
33391 msgstr ""
33392
33393 #. type: textblock
33394 #: ../tools/virt-edit.pl:516
33395 msgid "Copyright (C) 2009-2011 Red Hat Inc."
33396 msgstr ""
33397
33398 # type: textblock
33399 #. type: textblock
33400 #: ../tools/virt-win-reg.pl:37
33401 msgid ""
33402 "virt-win-reg - Export and merge Windows Registry entries from a Windows guest"
33403 msgstr ""
33404
33405 # type: verbatim
33406 #. type: verbatim
33407 #: ../tools/virt-win-reg.pl:41
33408 #, no-wrap
33409 msgid ""
33410 " virt-win-reg domname 'HKLM\\Path\\To\\Subkey'\n"
33411 "\n"
33412 msgstr ""
33413
33414 # type: verbatim
33415 #. type: verbatim
33416 #: ../tools/virt-win-reg.pl:43
33417 #, no-wrap
33418 msgid ""
33419 " virt-win-reg domname 'HKLM\\Path\\To\\Subkey' name\n"
33420 "\n"
33421 msgstr ""
33422
33423 # type: verbatim
33424 #. type: verbatim
33425 #: ../tools/virt-win-reg.pl:45
33426 #, no-wrap
33427 msgid ""
33428 " virt-win-reg domname 'HKLM\\Path\\To\\Subkey' @\n"
33429 "\n"
33430 msgstr ""
33431
33432 # type: verbatim
33433 #. type: verbatim
33434 #: ../tools/virt-win-reg.pl:47
33435 #, no-wrap
33436 msgid ""
33437 " virt-win-reg --merge domname [input.reg ...]\n"
33438 "\n"
33439 msgstr ""
33440
33441 # type: verbatim
33442 #. type: verbatim
33443 #: ../tools/virt-win-reg.pl:49
33444 #, no-wrap
33445 msgid ""
33446 " virt-win-reg [--options] disk.img ... # instead of domname\n"
33447 "\n"
33448 msgstr ""
33449
33450 #. type: textblock
33451 #: ../tools/virt-win-reg.pl:53
33452 msgid ""
33453 "You must I<not> use C<virt-win-reg> with the I<--merge> option on live "
33454 "virtual machines.  If you do this, you I<will> get irreversible disk "
33455 "corruption in the VM.  C<virt-win-reg> tries to stop you from doing this, "
33456 "but doesn't catch all cases."
33457 msgstr ""
33458
33459 #. type: textblock
33460 #: ../tools/virt-win-reg.pl:58
33461 msgid ""
33462 "Modifying the Windows Registry is an inherently risky operation.  The format "
33463 "is deliberately obscure and undocumented, and Registry changes can leave the "
33464 "system unbootable.  Therefore when using the I<--merge> option, make sure "
33465 "you have a reliable backup first."
33466 msgstr ""
33467
33468 # type: textblock
33469 #. type: textblock
33470 #: ../tools/virt-win-reg.pl:65
33471 msgid ""
33472 "This program can export and merge Windows Registry entries from a Windows "
33473 "guest."
33474 msgstr ""
33475
33476 # type: textblock
33477 #. type: textblock
33478 #: ../tools/virt-win-reg.pl:68
33479 msgid ""
33480 "The first parameter is the libvirt guest name or the raw disk image of a "
33481 "Windows guest."
33482 msgstr ""
33483
33484 #. type: textblock
33485 #: ../tools/virt-win-reg.pl:71
33486 msgid ""
33487 "If I<--merge> is I<not> specified, then the chosen registry key is displayed/"
33488 "exported (recursively).  For example:"
33489 msgstr ""
33490
33491 # type: verbatim
33492 #. type: verbatim
33493 #: ../tools/virt-win-reg.pl:74
33494 #, no-wrap
33495 msgid ""
33496 " $ virt-win-reg Windows7 'HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft'\n"
33497 "\n"
33498 msgstr ""
33499
33500 # type: textblock
33501 #. type: textblock
33502 #: ../tools/virt-win-reg.pl:76
33503 msgid ""
33504 "You can also display single values from within registry keys, for example:"
33505 msgstr ""
33506
33507 # type: verbatim
33508 #. type: verbatim
33509 #: ../tools/virt-win-reg.pl:79
33510 #, no-wrap
33511 msgid ""
33512 " $ cvkey='HKLM\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion'\n"
33513 " $ virt-win-reg Windows7 $cvkey ProductName\n"
33514 " Windows 7 Enterprise\n"
33515 "\n"
33516 msgstr ""
33517
33518 #. type: textblock
33519 #: ../tools/virt-win-reg.pl:83
33520 msgid ""
33521 "With I<--merge>, you can merge a textual regedit file into the Windows "
33522 "Registry:"
33523 msgstr ""
33524
33525 # type: verbatim
33526 #. type: verbatim
33527 #: ../tools/virt-win-reg.pl:86
33528 #, no-wrap
33529 msgid ""
33530 " $ virt-win-reg --merge Windows7 changes.reg\n"
33531 "\n"
33532 msgstr ""
33533
33534 # type: =head2
33535 #. type: =head1
33536 #: ../tools/virt-win-reg.pl:88 ../tools/virt-tar.pl:45
33537 msgid "NOTE"
33538 msgstr ""
33539
33540 # type: textblock
33541 #. type: textblock
33542 #: ../tools/virt-win-reg.pl:90
33543 msgid ""
33544 "This program is only meant for simple access to the registry.  If you want "
33545 "to do complicated things with the registry, we suggest you download the "
33546 "Registry hive files from the guest using L<libguestfs(3)> or L<guestfish(1)> "
33547 "and access them locally, eg. using L<hivex(3)>, L<hivexsh(1)> or "
33548 "L<hivexregedit(1)>."
33549 msgstr ""
33550
33551 # type: =item
33552 #. type: =item
33553 #: ../tools/virt-win-reg.pl:120 ../tools/virt-make-fs.pl:177
33554 msgid "B<--debug>"
33555 msgstr ""
33556
33557 # type: textblock
33558 #. type: textblock
33559 #: ../tools/virt-win-reg.pl:122
33560 msgid "Enable debugging messages."
33561 msgstr ""
33562
33563 # type: =item
33564 #. type: =item
33565 #: ../tools/virt-win-reg.pl:157
33566 msgid "B<--merge>"
33567 msgstr ""
33568
33569 # type: textblock
33570 #. type: textblock
33571 #: ../tools/virt-win-reg.pl:159
33572 msgid ""
33573 "In merge mode, this merges a textual regedit file into the Windows Registry "
33574 "of the virtual machine.  If this flag is I<not> given then virt-win-reg "
33575 "displays or exports Registry entries instead."
33576 msgstr ""
33577
33578 #. type: textblock
33579 #: ../tools/virt-win-reg.pl:163
33580 msgid ""
33581 "Note that I<--merge> is I<unsafe> to use on live virtual machines, and will "
33582 "result in disk corruption.  However exporting (without this flag)  is always "
33583 "safe."
33584 msgstr ""
33585
33586 # type: =item
33587 #. type: =item
33588 #: ../tools/virt-win-reg.pl:171
33589 msgid "B<--encoding> UTF-16LE|ASCII"
33590 msgstr ""
33591
33592 # type: textblock
33593 #. type: textblock
33594 #: ../tools/virt-win-reg.pl:173
33595 msgid ""
33596 "When merging (only), you may need to specify the encoding for strings to be "
33597 "used in the hive file.  This is explained in detail in L<Win::Hivex::Regedit"
33598 "(3)/ENCODING STRINGS>."
33599 msgstr ""
33600
33601 # type: textblock
33602 #. type: textblock
33603 #: ../tools/virt-win-reg.pl:177
33604 msgid ""
33605 "The default is to use UTF-16LE, which should work with recent versions of "
33606 "Windows."
33607 msgstr ""
33608
33609 # type: =head2
33610 #. type: =head1
33611 #: ../tools/virt-win-reg.pl:402
33612 msgid "SUPPORTED SYSTEMS"
33613 msgstr ""
33614
33615 # type: textblock
33616 #. type: textblock
33617 #: ../tools/virt-win-reg.pl:404
33618 msgid ""
33619 "The program currently supports Windows NT-derived guests starting with "
33620 "Windows XP through to at least Windows 7."
33621 msgstr ""
33622
33623 # type: textblock
33624 #. type: textblock
33625 #: ../tools/virt-win-reg.pl:407
33626 msgid ""
33627 "Registry support is done for C<HKEY_LOCAL_MACHINE\\SAM>, C<HKEY_LOCAL_MACHINE"
33628 "\\SECURITY>, C<HKEY_LOCAL_MACHINE\\SOFTWARE>, C<HKEY_LOCAL_MACHINE\\SYSTEM> "
33629 "and C<HKEY_USERS\\.DEFAULT>."
33630 msgstr ""
33631
33632 # type: textblock
33633 #. type: textblock
33634 #: ../tools/virt-win-reg.pl:411
33635 msgid ""
33636 "You can use C<HKLM> as a shorthand for C<HKEY_LOCAL_MACHINE>, and C<HKU> for "
33637 "C<HKEY_USERS>."
33638 msgstr ""
33639
33640 # type: textblock
33641 #. type: textblock
33642 #: ../tools/virt-win-reg.pl:414
33643 msgid ""
33644 "C<HKEY_USERS\\$SID> and C<HKEY_CURRENT_USER> are B<not> supported at this "
33645 "time."
33646 msgstr ""
33647
33648 # type: =head2
33649 #. type: =head1
33650 #: ../tools/virt-win-reg.pl:417
33651 msgid "ENCODING"
33652 msgstr ""
33653
33654 # type: textblock
33655 #. type: textblock
33656 #: ../tools/virt-win-reg.pl:419
33657 msgid ""
33658 "C<virt-win-reg> expects that regedit files have already been reencoded in "
33659 "the local encoding.  Usually on Linux hosts, this means UTF-8 with Unix-"
33660 "style line endings.  Since Windows regedit files are often in UTF-16LE with "
33661 "Windows-style line endings, you may need to reencode the whole file before "
33662 "or after processing."
33663 msgstr ""
33664
33665 #. type: textblock
33666 #: ../tools/virt-win-reg.pl:425
33667 msgid ""
33668 "To reencode a file from Windows format to Linux (before processing it with "
33669 "the I<--merge> option), you would do something like this:"
33670 msgstr ""
33671
33672 # type: verbatim
33673 #. type: verbatim
33674 #: ../tools/virt-win-reg.pl:428
33675 #, no-wrap
33676 msgid ""
33677 " iconv -f utf-16le -t utf-8 < win.reg | dos2unix > linux.reg\n"
33678 "\n"
33679 msgstr ""
33680
33681 # type: textblock
33682 #. type: textblock
33683 #: ../tools/virt-win-reg.pl:430
33684 msgid ""
33685 "To go in the opposite direction, after exporting and before sending the file "
33686 "to a Windows user, do something like this:"
33687 msgstr ""
33688
33689 # type: verbatim
33690 #. type: verbatim
33691 #: ../tools/virt-win-reg.pl:433
33692 #, no-wrap
33693 msgid ""
33694 " unix2dos linux.reg | iconv -f utf-8 -t utf-16le > win.reg\n"
33695 "\n"
33696 msgstr ""
33697
33698 # type: textblock
33699 #. type: textblock
33700 #: ../tools/virt-win-reg.pl:435
33701 msgid "For more information about encoding, see L<Win::Hivex::Regedit(3)>."
33702 msgstr ""
33703
33704 # type: textblock
33705 #. type: textblock
33706 #: ../tools/virt-win-reg.pl:437
33707 msgid ""
33708 "If you are unsure about the current encoding, use the L<file(1)> command.  "
33709 "Recent versions of Windows regedit.exe produce a UTF-16LE file with Windows-"
33710 "style (CRLF) line endings, like this:"
33711 msgstr ""
33712
33713 # type: verbatim
33714 #. type: verbatim
33715 #: ../tools/virt-win-reg.pl:441
33716 #, no-wrap
33717 msgid ""
33718 " $ file software.reg\n"
33719 " software.reg: Little-endian UTF-16 Unicode text, with very long lines,\n"
33720 " with CRLF line terminators\n"
33721 "\n"
33722 msgstr ""
33723
33724 #. type: textblock
33725 #: ../tools/virt-win-reg.pl:445
33726 msgid "This file would need conversion before you could I<--merge> it."
33727 msgstr ""
33728
33729 # type: =head2
33730 #. type: =head1
33731 #: ../tools/virt-win-reg.pl:447
33732 msgid "CurrentControlSet etc."
33733 msgstr ""
33734
33735 # type: textblock
33736 #. type: textblock
33737 #: ../tools/virt-win-reg.pl:449
33738 msgid ""
33739 "Registry keys like C<CurrentControlSet> don't really exist in the Windows "
33740 "Registry at the level of the hive file, and therefore you cannot modify "
33741 "these."
33742 msgstr ""
33743
33744 # type: textblock
33745 #. type: textblock
33746 #: ../tools/virt-win-reg.pl:453
33747 msgid ""
33748 "C<CurrentControlSet> is usually an alias for C<ControlSet001>.  In some "
33749 "circumstances it might refer to another control set.  The way to find out is "
33750 "to look at the C<HKLM\\SYSTEM\\Select> key:"
33751 msgstr ""
33752
33753 # type: verbatim
33754 #. type: verbatim
33755 #: ../tools/virt-win-reg.pl:457
33756 #, no-wrap
33757 msgid ""
33758 " # virt-win-reg WindowsGuest 'HKLM\\SYSTEM\\Select'\n"
33759 " [HKEY_LOCAL_MACHINE\\SYSTEM\\Select]\n"
33760 " \"Current\"=dword:00000001\n"
33761 " \"Default\"=dword:00000001\n"
33762 " \"Failed\"=dword:00000000\n"
33763 " \"LastKnownGood\"=dword:00000002\n"
33764 "\n"
33765 msgstr ""
33766
33767 # type: textblock
33768 #. type: textblock
33769 #: ../tools/virt-win-reg.pl:464
33770 msgid "\"Current\" is the one which Windows will choose when it boots."
33771 msgstr ""
33772
33773 # type: textblock
33774 #. type: textblock
33775 #: ../tools/virt-win-reg.pl:466
33776 msgid ""
33777 "Similarly, other C<Current...> keys in the path may need to be replaced."
33778 msgstr ""
33779
33780 # type: =head1
33781 #. type: =head1
33782 #: ../tools/virt-win-reg.pl:469
33783 msgid "WINDOWS TIPS"
33784 msgstr ""
33785
33786 # type: textblock
33787 #. type: textblock
33788 #: ../tools/virt-win-reg.pl:471
33789 msgid ""
33790 "Note that some of these tips modify the guest disk image.  The guest I<must> "
33791 "be shut off, else you will get disk corruption."
33792 msgstr ""
33793
33794 # type: =head2
33795 #. type: =head2
33796 #: ../tools/virt-win-reg.pl:474
33797 msgid "RUNNING A BATCH SCRIPT WHEN A USER LOGS IN"
33798 msgstr ""
33799
33800 # type: textblock
33801 #. type: textblock
33802 #: ../tools/virt-win-reg.pl:476
33803 msgid ""
33804 "Prepare a DOS batch script, VBScript or executable.  Upload this using "
33805 "L<guestfish(1)>.  For this example the script is called C<test.bat> and it "
33806 "is uploaded into C<C:\\>:"
33807 msgstr ""
33808
33809 # type: verbatim
33810 #. type: verbatim
33811 #: ../tools/virt-win-reg.pl:480
33812 #, no-wrap
33813 msgid ""
33814 " guestfish -i -d WindowsGuest upload test.bat /test.bat\n"
33815 "\n"
33816 msgstr ""
33817
33818 # type: textblock
33819 #. type: textblock
33820 #: ../tools/virt-win-reg.pl:482
33821 msgid "Prepare a regedit file containing the registry change:"
33822 msgstr ""
33823
33824 # type: verbatim
33825 #. type: verbatim
33826 #: ../tools/virt-win-reg.pl:484
33827 #, no-wrap
33828 msgid ""
33829 " cat > test.reg <<'EOF'\n"
33830 " [HKLM\\Software\\Microsoft\\Windows\\CurrentVersion\\RunOnce]\n"
33831 " \"Test\"=\"c:\\\\test.bat\"\n"
33832 " EOF\n"
33833 "\n"
33834 msgstr ""
33835
33836 # type: textblock
33837 #. type: textblock
33838 #: ../tools/virt-win-reg.pl:489
33839 msgid ""
33840 "In this example we use the key C<RunOnce> which means that the script will "
33841 "run precisely once when the first user logs in.  If you want it to run every "
33842 "time a user logs in, replace C<RunOnce> with C<Run>."
33843 msgstr ""
33844
33845 # type: textblock
33846 #. type: textblock
33847 #: ../tools/virt-win-reg.pl:493
33848 msgid "Now update the registry:"
33849 msgstr ""
33850
33851 # type: verbatim
33852 #. type: verbatim
33853 #: ../tools/virt-win-reg.pl:495
33854 #, no-wrap
33855 msgid ""
33856 " virt-win-reg --merge WindowsGuest test.reg\n"
33857 "\n"
33858 msgstr ""
33859
33860 # type: =head2
33861 #. type: =head2
33862 #: ../tools/virt-win-reg.pl:497
33863 msgid "INSTALLING A SERVICE"
33864 msgstr ""
33865
33866 # type: textblock
33867 #. type: textblock
33868 #: ../tools/virt-win-reg.pl:499
33869 msgid ""
33870 "This section assumes you are familiar with Windows services, and you either "
33871 "have a program which handles the Windows Service Control Protocol directly "
33872 "or you want to run any program using a service wrapper like SrvAny or the "
33873 "free RHSrvAny."
33874 msgstr ""
33875
33876 # type: textblock
33877 #. type: textblock
33878 #: ../tools/virt-win-reg.pl:504
33879 msgid ""
33880 "First upload the program and optionally the service wrapper.  In this case "
33881 "the test program is called C<test.exe> and we are using the RHSrvAny wrapper:"
33882 msgstr ""
33883
33884 # type: verbatim
33885 #. type: verbatim
33886 #: ../tools/virt-win-reg.pl:508
33887 #, no-wrap
33888 msgid ""
33889 " guestfish -i -d WindowsGuest <<EOF\n"
33890 "   upload rhsrvany.exe /rhsrvany.exe\n"
33891 "   upload test.exe /test.exe\n"
33892 " EOF\n"
33893 "\n"
33894 msgstr ""
33895
33896 # type: textblock
33897 #. type: textblock
33898 #: ../tools/virt-win-reg.pl:513
33899 msgid ""
33900 "Prepare a regedit file containing the registry changes.  In this example, "
33901 "the first registry change is needed for the service itself or the service "
33902 "wrapper (if used).  The second registry change is only needed because I am "
33903 "using the RHSrvAny service wrapper."
33904 msgstr ""
33905
33906 # type: verbatim
33907 #. type: verbatim
33908 #: ../tools/virt-win-reg.pl:518
33909 #, no-wrap
33910 msgid ""
33911 " cat > service.reg <<'EOF'\n"
33912 " [HKLM\\SYSTEM\\ControlSet001\\services\\RHSrvAny]\n"
33913 " \"Type\"=dword:00000010\n"
33914 " \"Start\"=dword:00000002\n"
33915 " \"ErrorControl\"=dword:00000001\n"
33916 " \"ImagePath\"=\"c:\\\\rhsrvany.exe\"\n"
33917 " \"DisplayName\"=\"RHSrvAny\"\n"
33918 " \"ObjectName\"=\"NetworkService\"\n"
33919 " \n"
33920 msgstr ""
33921
33922 # type: verbatim
33923 #. type: verbatim
33924 #: ../tools/virt-win-reg.pl:527
33925 #, no-wrap
33926 msgid ""
33927 " [HKLM\\SYSTEM\\ControlSet001\\services\\RHSrvAny\\Parameters]\n"
33928 " \"CommandLine\"=\"c:\\\\test.exe\"\n"
33929 " \"PWD\"=\"c:\\\\Temp\"\n"
33930 " EOF\n"
33931 "\n"
33932 msgstr ""
33933
33934 # type: textblock
33935 #. type: textblock
33936 #: ../tools/virt-win-reg.pl:538
33937 msgid ""
33938 "For use of C<ControlSet001> see the section above in this manual page.  You "
33939 "may need to adjust this according to the control set that is in use by the "
33940 "guest."
33941 msgstr ""
33942
33943 # type: textblock
33944 #. type: textblock
33945 #: ../tools/virt-win-reg.pl:544
33946 msgid ""
33947 "C<\"ObjectName\"> controls the privileges that the service will have.  An "
33948 "alternative is C<\"ObjectName\"=\"LocalSystem\"> which would be the most "
33949 "privileged account."
33950 msgstr ""
33951
33952 # type: textblock
33953 #. type: textblock
33954 #: ../tools/virt-win-reg.pl:550
33955 msgid ""
33956 "For the meaning of the magic numbers, see this Microsoft KB article: "
33957 "L<http://support.microsoft.com/kb/103000>."
33958 msgstr ""
33959
33960 # type: textblock
33961 #. type: textblock
33962 #: ../tools/virt-win-reg.pl:555
33963 msgid "Update the registry:"
33964 msgstr ""
33965
33966 # type: verbatim
33967 #. type: verbatim
33968 #: ../tools/virt-win-reg.pl:557
33969 #, no-wrap
33970 msgid ""
33971 " virt-win-reg --merge WindowsGuest service.reg\n"
33972 "\n"
33973 msgstr ""
33974
33975 # type: textblock
33976 #. type: textblock
33977 #: ../tools/virt-win-reg.pl:561
33978 msgid ""
33979 "Be careful when passing parameters containing C<\\> (backslash) in the "
33980 "shell.  Usually you will have to use 'single quotes' or double backslashes "
33981 "(but not both) to protect them from the shell."
33982 msgstr ""
33983
33984 # type: textblock
33985 #. type: textblock
33986 #: ../tools/virt-win-reg.pl:565
33987 msgid "Paths and value names are case-insensitive."
33988 msgstr ""
33989
33990 # type: textblock
33991 #. type: textblock
33992 #: ../tools/virt-win-reg.pl:574
33993 msgid ""
33994 "L<hivex(3)>, L<hivexsh(1)>, L<hivexregedit(1)>, L<guestfs(3)>, L<guestfish(1)"
33995 ">, L<virt-cat(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Win::Hivex"
33996 "(3)>, L<Win::Hivex::Regedit(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
33997 msgstr ""
33998
33999 # type: textblock
34000 #. type: textblock
34001 #: ../tools/virt-win-reg.pl:589 ../tools/virt-make-fs.pl:555
34002 msgid ""
34003 "When reporting bugs, please enable debugging and capture the I<complete> "
34004 "output:"
34005 msgstr ""
34006
34007 # type: verbatim
34008 #. type: verbatim
34009 #: ../tools/virt-win-reg.pl:592
34010 #, no-wrap
34011 msgid ""
34012 " export LIBGUESTFS_DEBUG=1\n"
34013 " virt-win-reg --debug [... rest ...] > /tmp/virt-win-reg.log 2>&1\n"
34014 "\n"
34015 msgstr ""
34016
34017 # type: textblock
34018 #. type: textblock
34019 #: ../tools/virt-win-reg.pl:595
34020 msgid ""
34021 "Attach /tmp/virt-win-reg.log to a new bug report at L<https://bugzilla."
34022 "redhat.com/>"
34023 msgstr ""
34024
34025 # type: textblock
34026 #. type: textblock
34027 #: ../tools/virt-win-reg.pl:604 ../tools/virt-make-fs.pl:570
34028 msgid "Copyright (C) 2010 Red Hat Inc."
34029 msgstr ""
34030
34031 # type: textblock
34032 #. type: textblock
34033 #: ../tools/virt-list-filesystems.pl:32
34034 msgid ""
34035 "virt-list-filesystems - List filesystems in a virtual machine or disk image"
34036 msgstr ""
34037
34038 # type: verbatim
34039 #. type: verbatim
34040 #: ../tools/virt-list-filesystems.pl:36
34041 #, no-wrap
34042 msgid ""
34043 " virt-list-filesystems [--options] domname\n"
34044 "\n"
34045 msgstr ""
34046
34047 # type: verbatim
34048 #. type: verbatim
34049 #: ../tools/virt-list-filesystems.pl:38
34050 #, no-wrap
34051 msgid ""
34052 " virt-list-filesystems [--options] disk.img [disk.img ...]\n"
34053 "\n"
34054 msgstr ""
34055
34056 # type: textblock
34057 #. type: textblock
34058 #: ../tools/virt-list-filesystems.pl:42 ../tools/virt-list-partitions.pl:42
34059 msgid ""
34060 "This tool is obsolete.  Use L<virt-filesystems(1)> as a more flexible "
34061 "replacement."
34062 msgstr ""
34063
34064 # type: textblock
34065 #. type: textblock
34066 #: ../tools/virt-list-filesystems.pl:45
34067 msgid ""
34068 "C<virt-list-filesystems> is a command line tool to list the filesystems that "
34069 "are contained in a virtual machine or disk image."
34070 msgstr ""
34071
34072 # type: textblock
34073 #. type: textblock
34074 #: ../tools/virt-list-filesystems.pl:49
34075 msgid ""
34076 "C<virt-list-filesystems> is just a simple wrapper around L<libguestfs(3)> "
34077 "functionality.  For more complex cases you should look at the L<guestfish(1)"
34078 "> tool."
34079 msgstr ""
34080
34081 # type: =item
34082 #. type: =item
34083 #: ../tools/virt-list-filesystems.pl:106 ../tools/virt-list-partitions.pl:115
34084 msgid "B<-l> | B<--long>"
34085 msgstr ""
34086
34087 # type: textblock
34088 #. type: textblock
34089 #: ../tools/virt-list-filesystems.pl:108
34090 msgid ""
34091 "With this option, C<virt-list-filesystems> displays the type of each "
34092 "filesystem too (where \"type\" means C<ext3>, C<xfs> etc.)"
34093 msgstr ""
34094
34095 # type: =item
34096 #. type: =item
34097 #: ../tools/virt-list-filesystems.pl:115
34098 msgid "B<-a> | B<--all>"
34099 msgstr ""
34100
34101 # type: textblock
34102 #. type: textblock
34103 #: ../tools/virt-list-filesystems.pl:117
34104 msgid ""
34105 "Normally we only show mountable filesystems.  If this option is given then "
34106 "swap devices are shown too."
34107 msgstr ""
34108
34109 # type: textblock
34110 #. type: textblock
34111 #: ../tools/virt-list-filesystems.pl:191
34112 msgid ""
34113 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-tar(1)>, L<virt-"
34114 "filesystems(1)>, L<virt-list-partitions(1)>, L<Sys::Guestfs(3)>, L<Sys::"
34115 "Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
34116 msgstr ""
34117
34118 # type: textblock
34119 #. type: textblock
34120 #: ../tools/virt-list-filesystems.pl:208 ../tools/virt-tar.pl:307
34121 msgid "Copyright (C) 2009 Red Hat Inc."
34122 msgstr ""
34123
34124 # type: textblock
34125 #. type: textblock
34126 #: ../tools/virt-tar.pl:33
34127 msgid "virt-tar - Extract or upload files to a virtual machine"
34128 msgstr ""
34129
34130 # type: verbatim
34131 #. type: verbatim
34132 #: ../tools/virt-tar.pl:37
34133 #, no-wrap
34134 msgid ""
34135 " virt-tar [--options] -x domname directory tarball\n"
34136 "\n"
34137 msgstr ""
34138
34139 # type: verbatim
34140 #. type: verbatim
34141 #: ../tools/virt-tar.pl:39
34142 #, no-wrap
34143 msgid ""
34144 " virt-tar [--options] -u domname tarball directory\n"
34145 "\n"
34146 msgstr ""
34147
34148 # type: verbatim
34149 #. type: verbatim
34150 #: ../tools/virt-tar.pl:41
34151 #, no-wrap
34152 msgid ""
34153 " virt-tar [--options] disk.img [disk.img ...] -x directory tarball\n"
34154 "\n"
34155 msgstr ""
34156
34157 # type: verbatim
34158 #. type: verbatim
34159 #: ../tools/virt-tar.pl:43
34160 #, no-wrap
34161 msgid ""
34162 " virt-tar [--options] disk.img [disk.img ...] -u tarball directory\n"
34163 "\n"
34164 msgstr ""
34165
34166 #. type: textblock
34167 #: ../tools/virt-tar.pl:47
34168 msgid ""
34169 "This tool is obsolete.  Use L<virt-copy-in(1)>, L<virt-copy-out(1)>, L<virt-"
34170 "tar-in(1)>, L<virt-tar-out(1)> as replacements."
34171 msgstr ""
34172
34173 # type: textblock
34174 #. type: textblock
34175 #: ../tools/virt-tar.pl:52
34176 msgid "Download C</home> from the VM into a local tarball:"
34177 msgstr ""
34178
34179 # type: verbatim
34180 #. type: verbatim
34181 #: ../tools/virt-tar.pl:54
34182 #, no-wrap
34183 msgid ""
34184 " virt-tar -x domname /home home.tar\n"
34185 "\n"
34186 msgstr ""
34187
34188 # type: verbatim
34189 #. type: verbatim
34190 #: ../tools/virt-tar.pl:56
34191 #, no-wrap
34192 msgid ""
34193 " virt-tar -zx domname /home home.tar.gz\n"
34194 "\n"
34195 msgstr ""
34196
34197 # type: textblock
34198 #. type: textblock
34199 #: ../tools/virt-tar.pl:58
34200 msgid "Upload a local tarball and unpack it inside C</tmp> in the VM:"
34201 msgstr ""
34202
34203 # type: verbatim
34204 #. type: verbatim
34205 #: ../tools/virt-tar.pl:60
34206 #, no-wrap
34207 msgid ""
34208 " virt-tar -u domname uploadstuff.tar /tmp\n"
34209 "\n"
34210 msgstr ""
34211
34212 # type: verbatim
34213 #. type: verbatim
34214 #: ../tools/virt-tar.pl:62
34215 #, no-wrap
34216 msgid ""
34217 " virt-tar -zu domname uploadstuff.tar.gz /tmp\n"
34218 "\n"
34219 msgstr ""
34220
34221 #. type: textblock
34222 #: ../tools/virt-tar.pl:66
34223 msgid ""
34224 "You must I<not> use C<virt-tar> with the I<-u> option (upload) on live "
34225 "virtual machines.  If you do this, you risk disk corruption in the VM.  "
34226 "C<virt-tar> tries to stop you from doing this, but doesn't catch all cases."
34227 msgstr ""
34228
34229 #. type: textblock
34230 #: ../tools/virt-tar.pl:71
34231 msgid ""
34232 "You can use I<-x> (extract) on live virtual machines, but you might get "
34233 "inconsistent results or errors if there is filesystem activity inside the "
34234 "VM.  If the live VM is synched and quiescent, then C<virt-tar> will usually "
34235 "work, but the only way to guarantee consistent results is if the virtual "
34236 "machine is shut down."
34237 msgstr ""
34238
34239 # type: textblock
34240 #. type: textblock
34241 #: ../tools/virt-tar.pl:79
34242 msgid ""
34243 "C<virt-tar> is a general purpose archive tool for downloading and uploading "
34244 "parts of a guest filesystem.  There are many possibilities: making backups, "
34245 "uploading data files, snooping on guest activity, fixing or customizing "
34246 "guests, etc."
34247 msgstr ""
34248
34249 # type: textblock
34250 #. type: textblock
34251 #: ../tools/virt-tar.pl:84
34252 msgid ""
34253 "If you want to just view a single file, use L<virt-cat(1)>.  If you just "
34254 "want to edit a single file, use L<virt-edit(1)>.  For more complex cases you "
34255 "should look at the L<guestfish(1)> tool."
34256 msgstr ""
34257
34258 #. type: textblock
34259 #: ../tools/virt-tar.pl:88
34260 msgid ""
34261 "There are two modes of operation: I<-x> (eXtract) downloads a directory and "
34262 "its contents (recursively) from the virtual machine into a local tarball.  "
34263 "I<-u> uploads from a local tarball, unpacking it into a directory inside the "
34264 "virtual machine.  You cannot use these two options together."
34265 msgstr ""
34266
34267 #. type: textblock
34268 #: ../tools/virt-tar.pl:94
34269 msgid ""
34270 "In addition, you may need to use the I<-z> (gZip) option to enable "
34271 "compression.  When uploading, you have to specify I<-z> if the upload file "
34272 "is compressed because virt-tar won't detect this on its own."
34273 msgstr ""
34274
34275 # type: textblock
34276 #. type: textblock
34277 #: ../tools/virt-tar.pl:98
34278 msgid ""
34279 "C<virt-tar> can only handle tar (optionally gzipped) format tarballs.  For "
34280 "example it cannot do PKZip files or bzip2 compression.  If you want that "
34281 "then you'll have to rebuild the tarballs yourself.  (This is a limitation of "
34282 "the L<libguestfs(3)> API)."
34283 msgstr ""
34284
34285 # type: =item
34286 #. type: =item
34287 #: ../tools/virt-tar.pl:156
34288 msgid "B<-x> | B<--extract> | B<--download>"
34289 msgstr ""
34290
34291 # type: =item
34292 #. type: =item
34293 #: ../tools/virt-tar.pl:158
34294 msgid "B<-u> | B<--upload>"
34295 msgstr ""
34296
34297 #. type: textblock
34298 #: ../tools/virt-tar.pl:160
34299 msgid ""
34300 "Use I<-x> to extract (download) a directory from a virtual machine to a "
34301 "local tarball."
34302 msgstr ""
34303
34304 #. type: textblock
34305 #: ../tools/virt-tar.pl:163
34306 msgid ""
34307 "Use I<-u> to upload and unpack from a local tarball into a virtual machine.  "
34308 "Please read the L</WARNING> section above before using this option."
34309 msgstr ""
34310
34311 # type: textblock
34312 #. type: textblock
34313 #: ../tools/virt-tar.pl:167
34314 msgid "You must specify exactly one of these options."
34315 msgstr ""
34316
34317 # type: =item
34318 #. type: =item
34319 #: ../tools/virt-tar.pl:173
34320 msgid "B<-z> | B<--gzip>"
34321 msgstr ""
34322
34323 # type: textblock
34324 #. type: textblock
34325 #: ../tools/virt-tar.pl:175
34326 msgid "Specify that the input or output tarball is gzip-compressed."
34327 msgstr ""
34328
34329 #. type: textblock
34330 #: ../tools/virt-tar.pl:288
34331 msgid ""
34332 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-edit(1)>, L<virt-copy-"
34333 "in(1)>, L<virt-copy-out(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>, L<Sys::"
34334 "Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs."
34335 "org/>."
34336 msgstr ""
34337
34338 # type: textblock
34339 #. type: textblock
34340 #: ../tools/virt-make-fs.pl:37
34341 msgid "virt-make-fs - Make a filesystem from a tar archive or files"
34342 msgstr ""
34343
34344 # type: verbatim
34345 #. type: verbatim
34346 #: ../tools/virt-make-fs.pl:41
34347 #, no-wrap
34348 msgid ""
34349 " virt-make-fs [--options] input.tar output.img\n"
34350 "\n"
34351 msgstr ""
34352
34353 # type: verbatim
34354 #. type: verbatim
34355 #: ../tools/virt-make-fs.pl:43
34356 #, no-wrap
34357 msgid ""
34358 " virt-make-fs [--options] input.tar.gz output.img\n"
34359 "\n"
34360 msgstr ""
34361
34362 # type: verbatim
34363 #. type: verbatim
34364 #: ../tools/virt-make-fs.pl:45
34365 #, no-wrap
34366 msgid ""
34367 " virt-make-fs [--options] directory output.img\n"
34368 "\n"
34369 msgstr ""
34370
34371 # type: textblock
34372 #. type: textblock
34373 #: ../tools/virt-make-fs.pl:49
34374 msgid ""
34375 "Virt-make-fs is a command line tool for creating a filesystem from a tar "
34376 "archive or some files in a directory.  It is similar to tools like L<mkisofs"
34377 "(1)>, L<genisoimage(1)> and L<mksquashfs(1)>.  Unlike those tools, it can "
34378 "create common filesystem types like ext2/3 or NTFS, which can be useful if "
34379 "you want to attach these filesystems to existing virtual machines (eg. to "
34380 "import large amounts of read-only data to a VM)."
34381 msgstr ""
34382
34383 # type: textblock
34384 #. type: textblock
34385 #: ../tools/virt-make-fs.pl:57
34386 msgid "Basic usage is:"
34387 msgstr ""
34388
34389 # type: verbatim
34390 #. type: verbatim
34391 #: ../tools/virt-make-fs.pl:59
34392 #, no-wrap
34393 msgid ""
34394 " virt-make-fs input output\n"
34395 "\n"
34396 msgstr ""
34397
34398 # type: textblock
34399 #. type: textblock
34400 #: ../tools/virt-make-fs.pl:61
34401 msgid ""
34402 "where C<input> is either a directory containing files that you want to add, "
34403 "or a tar archive (either uncompressed tar or gzip-compressed tar); and "
34404 "C<output> is a disk image.  The input type is detected automatically.  The "
34405 "output disk image defaults to a raw ext2 image unless you specify extra "
34406 "flags (see L</OPTIONS> below)."
34407 msgstr ""
34408
34409 # type: =head2
34410 #. type: =head2
34411 #: ../tools/virt-make-fs.pl:67
34412 msgid "EXTRA SPACE"
34413 msgstr ""
34414
34415 #. type: textblock
34416 #: ../tools/virt-make-fs.pl:69
34417 msgid ""
34418 "Unlike formats such as tar and squashfs, a filesystem does not \"just fit\" "
34419 "the files that it contains, but might have extra space.  Depending on how "
34420 "you are going to use the output, you might think this extra space is wasted "
34421 "and want to minimize it, or you might want to leave space so that more files "
34422 "can be added later.  Virt-make-fs defaults to minimizing the extra space, "
34423 "but you can use the I<--size> flag to leave space in the filesystem if you "
34424 "want it."
34425 msgstr ""
34426
34427 #. type: textblock
34428 #: ../tools/virt-make-fs.pl:77
34429 msgid ""
34430 "An alternative way to leave extra space but not make the output image any "
34431 "bigger is to use an alternative disk image format (instead of the default "
34432 "\"raw\" format).  Using I<--format=qcow2> will use the native QEmu/KVM qcow2 "
34433 "image format (check your hypervisor supports this before using it).  This "
34434 "allows you to choose a large I<--size> but the extra space won't actually be "
34435 "allocated in the image until you try to store something in it."
34436 msgstr ""
34437
34438 #. type: textblock
34439 #: ../tools/virt-make-fs.pl:85
34440 msgid ""
34441 "Don't forget that you can also use local commands including L<resize2fs(8)> "
34442 "and L<virt-resize(1)> to resize existing filesystems, or rerun virt-make-fs "
34443 "to build another image from scratch."
34444 msgstr ""
34445
34446 # type: =head3
34447 #. type: =head3
34448 #: ../tools/virt-make-fs.pl:89 ../tools/virt-make-fs.pl:123
34449 #: ../tools/virt-make-fs.pl:142
34450 msgid "EXAMPLE"
34451 msgstr ""
34452
34453 # type: verbatim
34454 #. type: verbatim
34455 #: ../tools/virt-make-fs.pl:91
34456 #, no-wrap
34457 msgid ""
34458 " virt-make-fs --format=qcow2 --size=+200M input output.img\n"
34459 "\n"
34460 msgstr ""
34461
34462 # type: =head2
34463 #. type: =head2
34464 #: ../tools/virt-make-fs.pl:93
34465 msgid "FILESYSTEM TYPE"
34466 msgstr ""
34467
34468 # type: textblock
34469 #. type: textblock
34470 #: ../tools/virt-make-fs.pl:95
34471 msgid ""
34472 "The default filesystem type is C<ext2>.  Just about any filesystem type that "
34473 "libguestfs supports can be used (but I<not> read-only formats like "
34474 "ISO9660).  Here are some of the more common choices:"
34475 msgstr ""
34476
34477 # type: =item
34478 #. type: =item
34479 #: ../tools/virt-make-fs.pl:101
34480 msgid "I<ext3>"
34481 msgstr ""
34482
34483 # type: textblock
34484 #. type: textblock
34485 #: ../tools/virt-make-fs.pl:103
34486 msgid ""
34487 "Note that ext3 filesystems contain a journal, typically 1-32 MB in size.  If "
34488 "you are not going to use the filesystem in a way that requires the journal, "
34489 "then this is just wasted overhead."
34490 msgstr ""
34491
34492 # type: =item
34493 #. type: =item
34494 #: ../tools/virt-make-fs.pl:107
34495 msgid "I<ntfs> or I<vfat>"
34496 msgstr ""
34497
34498 # type: textblock
34499 #. type: textblock
34500 #: ../tools/virt-make-fs.pl:109
34501 msgid "Useful if exporting data to a Windows guest."
34502 msgstr ""
34503
34504 # type: textblock
34505 #. type: textblock
34506 #: ../tools/virt-make-fs.pl:111
34507 msgid ""
34508 "I<Note for vfat>: The tar archive or local directory must only contain files "
34509 "which are owned by root (ie. UID:GID = 0:0).  The reason is that the tar "
34510 "program running within libguestfs is unable to change the ownership of non-"
34511 "root files, since vfat itself does not support this."
34512 msgstr ""
34513
34514 # type: =item
34515 #. type: =item
34516 #: ../tools/virt-make-fs.pl:116
34517 msgid "I<minix>"
34518 msgstr ""
34519
34520 # type: textblock
34521 #. type: textblock
34522 #: ../tools/virt-make-fs.pl:118
34523 msgid ""
34524 "Lower overhead than C<ext2>, but certain limitations on filename length and "
34525 "total filesystem size."
34526 msgstr ""
34527
34528 # type: verbatim
34529 #. type: verbatim
34530 #: ../tools/virt-make-fs.pl:125
34531 #, no-wrap
34532 msgid ""
34533 " virt-make-fs --type=minix input minixfs.img\n"
34534 "\n"
34535 msgstr ""
34536
34537 # type: =head2
34538 #. type: =head2
34539 #: ../tools/virt-make-fs.pl:127
34540 msgid "TO PARTITION OR NOT TO PARTITION"
34541 msgstr ""
34542
34543 # type: textblock
34544 #. type: textblock
34545 #: ../tools/virt-make-fs.pl:129
34546 msgid "Optionally virt-make-fs can add a partition table to the output disk."
34547 msgstr ""
34548
34549 # type: textblock
34550 #. type: textblock
34551 #: ../tools/virt-make-fs.pl:131
34552 msgid ""
34553 "Adding a partition can make the disk image more compatible with certain "
34554 "virtualized operating systems which don't expect to see a filesystem "
34555 "directly located on a block device (Linux doesn't care and will happily "
34556 "handle both types)."
34557 msgstr ""
34558
34559 # type: textblock
34560 #. type: textblock
34561 #: ../tools/virt-make-fs.pl:136
34562 msgid ""
34563 "On the other hand, if you have a partition table then the output image is no "
34564 "longer a straight filesystem.  For example you cannot run L<fsck(8)> "
34565 "directly on a partitioned disk image.  (However libguestfs tools such as "
34566 "L<guestfish(1)> and L<virt-resize(1)> can still be used)."
34567 msgstr ""
34568
34569 # type: textblock
34570 #. type: textblock
34571 #: ../tools/virt-make-fs.pl:144
34572 msgid "Add an MBR partition:"
34573 msgstr ""
34574
34575 # type: verbatim
34576 #. type: verbatim
34577 #: ../tools/virt-make-fs.pl:146
34578 #, no-wrap
34579 msgid ""
34580 " virt-make-fs --partition -- input disk.img\n"
34581 "\n"
34582 msgstr ""
34583
34584 # type: textblock
34585 #. type: textblock
34586 #: ../tools/virt-make-fs.pl:148
34587 msgid ""
34588 "If the output disk image could be terabyte-sized or larger, it's better to "
34589 "use an EFI/GPT-compatible partition table:"
34590 msgstr ""
34591
34592 # type: verbatim
34593 #. type: verbatim
34594 #: ../tools/virt-make-fs.pl:151
34595 #, no-wrap
34596 msgid ""
34597 " virt-make-fs --partition=gpt --size=+4T --format=qcow2 input disk.img\n"
34598 "\n"
34599 msgstr ""
34600
34601 # type: textblock
34602 #. type: textblock
34603 #: ../tools/virt-make-fs.pl:179
34604 msgid "Enable debugging information."
34605 msgstr ""
34606
34607 # type: =item
34608 #. type: =item
34609 #: ../tools/virt-make-fs.pl:185
34610 msgid "B<--size=E<lt>NE<gt>>"
34611 msgstr ""
34612
34613 # type: =item
34614 #. type: =item
34615 #: ../tools/virt-make-fs.pl:187
34616 msgid "B<--size=+E<lt>NE<gt>>"
34617 msgstr ""
34618
34619 # type: =item
34620 #. type: =item
34621 #: ../tools/virt-make-fs.pl:189
34622 msgid "B<-s E<lt>NE<gt>>"
34623 msgstr ""
34624
34625 # type: =item
34626 #. type: =item
34627 #: ../tools/virt-make-fs.pl:191
34628 msgid "B<-s +E<lt>NE<gt>>"
34629 msgstr ""
34630
34631 #. type: textblock
34632 #: ../tools/virt-make-fs.pl:193
34633 msgid ""
34634 "Use the I<--size> (or I<-s>) option to choose the size of the output image."
34635 msgstr ""
34636
34637 # type: textblock
34638 #. type: textblock
34639 #: ../tools/virt-make-fs.pl:196
34640 msgid ""
34641 "If this option is I<not> given, then the output image will be just large "
34642 "enough to contain all the files, with not much wasted space."
34643 msgstr ""
34644
34645 # type: textblock
34646 #. type: textblock
34647 #: ../tools/virt-make-fs.pl:199
34648 msgid ""
34649 "To choose a fixed size output disk, specify an absolute number followed by b/"
34650 "K/M/G/T/P/E to mean bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, "
34651 "Petabytes or Exabytes.  This must be large enough to contain all the input "
34652 "files, else you will get an error."
34653 msgstr ""
34654
34655 #. type: textblock
34656 #: ../tools/virt-make-fs.pl:204
34657 msgid ""
34658 "To leave extra space, specify C<+> (plus sign) and a number followed by b/K/"
34659 "M/G/T/P/E to mean bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, "
34660 "Petabytes or Exabytes.  For example: I<--size=+200M> means enough space for "
34661 "the input files, and (approximately) an extra 200 MB free space."
34662 msgstr ""
34663
34664 # type: textblock
34665 #. type: textblock
34666 #: ../tools/virt-make-fs.pl:210
34667 msgid ""
34668 "Note that virt-make-fs estimates free space, and therefore will not produce "
34669 "filesystems containing precisely the free space requested.  (It is much more "
34670 "expensive and time-consuming to produce a filesystem which has precisely the "
34671 "desired free space)."
34672 msgstr ""
34673
34674 # type: =item
34675 #. type: =item
34676 #: ../tools/virt-make-fs.pl:219
34677 msgid "B<--format=E<lt>fmtE<gt>>"
34678 msgstr ""
34679
34680 # type: =item
34681 #. type: =item
34682 #: ../tools/virt-make-fs.pl:221
34683 msgid "B<-F E<lt>fmtE<gt>>"
34684 msgstr ""
34685
34686 # type: textblock
34687 #. type: textblock
34688 #: ../tools/virt-make-fs.pl:223
34689 msgid "Choose the output disk image format."
34690 msgstr ""
34691
34692 # type: textblock
34693 #. type: textblock
34694 #: ../tools/virt-make-fs.pl:225
34695 msgid "The default is C<raw> (raw disk image)."
34696 msgstr ""
34697
34698 # type: textblock
34699 #. type: textblock
34700 #: ../tools/virt-make-fs.pl:227
34701 msgid ""
34702 "For other choices, see the L<qemu-img(1)> manpage.  The only other choice "
34703 "that would really make sense here is C<qcow2>."
34704 msgstr ""
34705
34706 # type: =item
34707 #. type: =item
34708 #: ../tools/virt-make-fs.pl:234
34709 msgid "B<--type=E<lt>fsE<gt>>"
34710 msgstr ""
34711
34712 # type: =item
34713 #. type: =item
34714 #: ../tools/virt-make-fs.pl:236
34715 msgid "B<-t E<lt>fsE<gt>>"
34716 msgstr ""
34717
34718 # type: textblock
34719 #. type: textblock
34720 #: ../tools/virt-make-fs.pl:238
34721 msgid "Choose the output filesystem type."
34722 msgstr ""
34723
34724 # type: textblock
34725 #. type: textblock
34726 #: ../tools/virt-make-fs.pl:240
34727 msgid "The default is C<ext2>."
34728 msgstr ""
34729
34730 # type: textblock
34731 #. type: textblock
34732 #: ../tools/virt-make-fs.pl:242
34733 msgid ""
34734 "Any filesystem which is supported read-write by libguestfs can be used here."
34735 msgstr ""
34736
34737 # type: =item
34738 #. type: =item
34739 #: ../tools/virt-make-fs.pl:249
34740 msgid "B<--partition>"
34741 msgstr ""
34742
34743 # type: =item
34744 #. type: =item
34745 #: ../tools/virt-make-fs.pl:251
34746 msgid "B<--partition=E<lt>parttypeE<gt>>"
34747 msgstr ""
34748
34749 # type: textblock
34750 #. type: textblock
34751 #: ../tools/virt-make-fs.pl:253
34752 msgid ""
34753 "If specified, this flag adds an MBR partition table to the output disk image."
34754 msgstr ""
34755
34756 #. type: textblock
34757 #: ../tools/virt-make-fs.pl:256
34758 msgid ""
34759 "You can change the partition table type, eg. I<--partition=gpt> for large "
34760 "disks."
34761 msgstr ""
34762
34763 #. type: textblock
34764 #: ../tools/virt-make-fs.pl:259
34765 msgid ""
34766 "Note that if you just use a lonesome I<--partition>, the Perl option parser "
34767 "might consider the next parameter to be the partition type.  For example:"
34768 msgstr ""
34769
34770 # type: verbatim
34771 #. type: verbatim
34772 #: ../tools/virt-make-fs.pl:263
34773 #, no-wrap
34774 msgid ""
34775 " virt-make-fs --partition input.tar ...\n"
34776 "\n"
34777 msgstr ""
34778
34779 #. type: textblock
34780 #: ../tools/virt-make-fs.pl:265
34781 msgid ""
34782 "would cause virt-make-fs to think you wanted to use a partition type of "
34783 "C<input.tar> which is completely wrong.  To avoid this, use I<--> (a double "
34784 "dash) between options and the input file argument:"
34785 msgstr ""
34786
34787 # type: verbatim
34788 #. type: verbatim
34789 #: ../tools/virt-make-fs.pl:269
34790 #, no-wrap
34791 msgid ""
34792 " virt-make-fs --partition -- input.tar ...\n"
34793 "\n"
34794 msgstr ""
34795
34796 #. type: textblock
34797 #: ../tools/virt-make-fs.pl:541
34798 msgid ""
34799 "L<guestfish(1)>, L<virt-resize(1)>, L<virt-tar-in(1)>, L<mkisofs(1)>, "
34800 "L<genisoimage(1)>, L<mksquashfs(1)>, L<mke2fs(8)>, L<resize2fs(8)>, L<guestfs"
34801 "(3)>, L<Sys::Guestfs(3)>, L<http://libguestfs.org/>."
34802 msgstr ""
34803
34804 # type: verbatim
34805 #. type: verbatim
34806 #: ../tools/virt-make-fs.pl:558
34807 #, no-wrap
34808 msgid ""
34809 " export LIBGUESTFS_DEBUG=1\n"
34810 " virt-make-fs --debug [...] > /tmp/virt-make-fs.log 2>&1\n"
34811 "\n"
34812 msgstr ""
34813
34814 # type: textblock
34815 #. type: textblock
34816 #: ../tools/virt-make-fs.pl:561
34817 msgid ""
34818 "Attach /tmp/virt-make-fs.log to a new bug report at L<https://bugzilla."
34819 "redhat.com/>"
34820 msgstr ""
34821
34822 # type: textblock
34823 #. type: textblock
34824 #: ../tools/virt-list-partitions.pl:32
34825 msgid ""
34826 "virt-list-partitions - List partitions in a virtual machine or disk image"
34827 msgstr ""
34828
34829 # type: verbatim
34830 #. type: verbatim
34831 #: ../tools/virt-list-partitions.pl:36
34832 #, no-wrap
34833 msgid ""
34834 " virt-list-partitions [--options] domname\n"
34835 "\n"
34836 msgstr ""
34837
34838 # type: verbatim
34839 #. type: verbatim
34840 #: ../tools/virt-list-partitions.pl:38
34841 #, no-wrap
34842 msgid ""
34843 " virt-list-partitions [--options] disk.img [disk.img ...]\n"
34844 "\n"
34845 msgstr ""
34846
34847 # type: textblock
34848 #. type: textblock
34849 #: ../tools/virt-list-partitions.pl:45
34850 msgid ""
34851 "C<virt-list-partitions> is a command line tool to list the partitions that "
34852 "are contained in a virtual machine or disk image.  It is mainly useful as a "
34853 "first step to using L<virt-resize(1)>."
34854 msgstr ""
34855
34856 # type: textblock
34857 #. type: textblock
34858 #: ../tools/virt-list-partitions.pl:50
34859 msgid ""
34860 "C<virt-list-partitions> is just a simple wrapper around L<libguestfs(3)> "
34861 "functionality.  For more complex cases you should look at the L<guestfish(1)"
34862 "> tool."
34863 msgstr ""
34864
34865 # type: =item
34866 #. type: =item
34867 #: ../tools/virt-list-partitions.pl:107
34868 msgid "B<-h> | B<--human-readable>"
34869 msgstr ""
34870
34871 # type: textblock
34872 #. type: textblock
34873 #: ../tools/virt-list-partitions.pl:109
34874 msgid "Show sizes in human-readable form (eg. \"1G\")."
34875 msgstr ""
34876
34877 # type: textblock
34878 #. type: textblock
34879 #: ../tools/virt-list-partitions.pl:117
34880 msgid ""
34881 "With this option, C<virt-list-partitions> displays the type and size of each "
34882 "partition too (where \"type\" means C<ext3>, C<pv> etc.)"
34883 msgstr ""
34884
34885 # type: =item
34886 #. type: =item
34887 #: ../tools/virt-list-partitions.pl:124
34888 msgid "B<-t> | B<--total>"
34889 msgstr ""
34890
34891 # type: textblock
34892 #. type: textblock
34893 #: ../tools/virt-list-partitions.pl:126
34894 msgid ""
34895 "Display the total size of each block device (as a separate row or rows)."
34896 msgstr ""
34897
34898 # type: textblock
34899 #. type: textblock
34900 #: ../tools/virt-list-partitions.pl:259
34901 msgid ""
34902 "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
34903 "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib"
34904 "(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
34905 msgstr ""
34906
34907 # type: textblock
34908 #. type: textblock
34909 #: ../tools/virt-list-partitions.pl:275
34910 msgid "Copyright (C) 2009-2010 Red Hat Inc."
34911 msgstr ""