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-03-28 17:11+0200\n"
  11 "PO-Revision-Date: 2010-09-02 14:46+0100\n"
  12 "Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
  13 "Language-Team: LANGUAGE <LL@li.org>\n"
  14 "Language: \n"
  15 "MIME-Version: 1.0\n"
  16 "Content-Type: text/plain; charset=UTF-8\n"
  17 "Content-Transfer-Encoding: 8bit\n"
  18
  19 # type: =head1
  20 #. type: =head1
  21 #: ../src/guestfs.pod:3 ../fish/guestfish.pod:3
  22 #: ../test-tool/libguestfs-test-tool.pod:3 ../fuse/guestmount.pod:3
  23 #: ../tools/virt-edit.pl:32 ../tools/virt-win-reg.pl:35
  24 #: ../tools/virt-resize.pl:40 ../tools/virt-list-filesystems.pl:30
  25 #: ../tools/virt-tar.pl:31 ../tools/virt-make-fs.pl:35
  26 #: ../tools/virt-list-partitions.pl:30
  27 msgid "NAME"
  28 msgstr "名前"
  29
  30 # type: textblock
  31 #. type: textblock
  32 #: ../src/guestfs.pod:5
  33 msgid "guestfs - Library for accessing and modifying virtual machine images"
  34 msgstr ""
  35
  36 # type: =head1
  37 #. type: =head1
  38 #: ../src/guestfs.pod:7 ../fish/guestfish.pod:7
  39 #: ../test-tool/libguestfs-test-tool.pod:7 ../fuse/guestmount.pod:7
  40 #: ../tools/virt-edit.pl:36 ../tools/virt-win-reg.pl:39
  41 #: ../tools/virt-resize.pl:44 ../tools/virt-list-filesystems.pl:34
  42 #: ../tools/virt-tar.pl:35 ../tools/virt-make-fs.pl:39
  43 #: ../tools/virt-list-partitions.pl:34
  44 msgid "SYNOPSIS"
  45 msgstr ""
  46
  47 # type: verbatim
  48 #. type: verbatim
  49 #: ../src/guestfs.pod:9
  50 #, no-wrap
  51 msgid ""
  52 " #include <guestfs.h>\n"
  53 " \n"
  54 msgstr ""
  55
  56 # type: verbatim
  57 #. type: verbatim
  58 #: ../src/guestfs.pod:11
  59 #, no-wrap
  60 msgid ""
  61 " guestfs_h *g = guestfs_create ();\n"
  62 " guestfs_add_drive (g, \"guest.img\");\n"
  63 " guestfs_launch (g);\n"
  64 " guestfs_mount (g, \"/dev/sda1\", \"/\");\n"
  65 " guestfs_touch (g, \"/hello\");\n"
  66 " guestfs_umount (g, \"/\");\n"
  67 " guestfs_close (g);\n"
  68 "\n"
  69 msgstr ""
  70
  71 # type: verbatim
  72 #. type: verbatim
  73 #: ../src/guestfs.pod:19
  74 #, no-wrap
  75 msgid ""
  76 " cc prog.c -o prog -lguestfs\n"
  77 "or:\n"
  78 " cc prog.c -o prog `pkg-config libguestfs --cflags --libs`\n"
  79 "\n"
  80 msgstr ""
  81
  82 # type: =head1
  83 #. type: =head1
  84 #: ../src/guestfs.pod:23 ../fish/guestfish.pod:30
  85 #: ../test-tool/libguestfs-test-tool.pod:11 ../fuse/guestmount.pod:20
  86 #: ../tools/virt-edit.pl:50 ../tools/virt-win-reg.pl:63
  87 #: ../tools/virt-resize.pl:50 ../tools/virt-list-filesystems.pl:40
  88 #: ../tools/virt-tar.pl:77 ../tools/virt-make-fs.pl:47
  89 #: ../tools/virt-list-partitions.pl:40
  90 msgid "DESCRIPTION"
  91 msgstr ""
  92
  93 # type: textblock
  94 #. type: textblock
  95 #: ../src/guestfs.pod:25
  96 msgid ""
  97 "Libguestfs is a library for accessing and modifying guest disk images.  "
  98 "Amongst the things this is good for: making batch configuration changes to "
  99 "guests, getting disk used/free statistics (see also: virt-df), migrating "
 100 "between virtualization systems (see also: virt-p2v), performing partial "
 101 "backups, performing partial guest clones, cloning guests and changing "
 102 "registry/UUID/hostname info, and much else besides."
 103 msgstr ""
 104
 105 # type: textblock
 106 #. type: textblock
 107 #: ../src/guestfs.pod:33
 108 msgid ""
 109 "Libguestfs uses Linux kernel and qemu code, and can access any type of guest "
 110 "filesystem that Linux and qemu can, including but not limited to: ext2/3/4, "
 111 "btrfs, FAT and NTFS, LVM, many different disk partition schemes, qcow, "
 112 "qcow2, vmdk."
 113 msgstr ""
 114
 115 # type: textblock
 116 #. type: textblock
 117 #: ../src/guestfs.pod:38
 118 msgid ""
 119 "Libguestfs provides ways to enumerate guest storage (eg. partitions, LVs, "
 120 "what filesystem is in each LV, etc.).  It can also run commands in the "
 121 "context of the guest.  Also you can access filesystems over FUSE."
 122 msgstr ""
 123
 124 # type: textblock
 125 #. type: textblock
 126 #: ../src/guestfs.pod:43
 127 msgid ""
 128 "Libguestfs is a library that can be linked with C and C++ management "
 129 "programs (or management programs written in OCaml, Perl, Python, Ruby, Java, "
 130 "PHP, Haskell or C#).  You can also use it from shell scripts or the command "
 131 "line."
 132 msgstr ""
 133
 134 # type: textblock
 135 #. type: textblock
 136 #: ../src/guestfs.pod:48
 137 msgid ""
 138 "You don't need to be root to use libguestfs, although obviously you do need "
 139 "enough permissions to access the disk images."
 140 msgstr ""
 141
 142 # type: textblock
 143 #. type: textblock
 144 #: ../src/guestfs.pod:51
 145 msgid ""
 146 "Libguestfs is a large API because it can do many things.  For a gentle "
 147 "introduction, please read the L</API OVERVIEW> section next."
 148 msgstr ""
 149
 150 # type: textblock
 151 #. type: textblock
 152 #: ../src/guestfs.pod:54
 153 msgid ""
 154 "There are also some example programs in the L<guestfs-examples(3)> manual "
 155 "page."
 156 msgstr ""
 157
 158 # type: =head1
 159 #. type: =head1
 160 #: ../src/guestfs.pod:57
 161 msgid "API OVERVIEW"
 162 msgstr ""
 163
 164 # type: textblock
 165 #. type: textblock
 166 #: ../src/guestfs.pod:59
 167 msgid ""
 168 "This section provides a gentler overview of the libguestfs API.  We also try "
 169 "to group API calls together, where that may not be obvious from reading "
 170 "about the individual calls in the main section of this manual."
 171 msgstr ""
 172
 173 # type: =head2
 174 #. type: =head2
 175 #: ../src/guestfs.pod:64
 176 msgid "HANDLES"
 177 msgstr ""
 178
 179 # type: textblock
 180 #. type: textblock
 181 #: ../src/guestfs.pod:66
 182 msgid ""
 183 "Before you can use libguestfs calls, you have to create a handle.  Then you "
 184 "must add at least one disk image to the handle, followed by launching the "
 185 "handle, then performing whatever operations you want, and finally closing "
 186 "the handle.  By convention we use the single letter C<g> for the name of the "
 187 "handle variable, although of course you can use any name you want."
 188 msgstr ""
 189
 190 # type: textblock
 191 #. type: textblock
 192 #: ../src/guestfs.pod:73
 193 msgid "The general structure of all libguestfs-using programs looks like this:"
 194 msgstr ""
 195
 196 # type: verbatim
 197 #. type: verbatim
 198 #: ../src/guestfs.pod:76
 199 #, no-wrap
 200 msgid ""
 201 " guestfs_h *g = guestfs_create ();\n"
 202 " \n"
 203 msgstr ""
 204
 205 # type: verbatim
 206 #. type: verbatim
 207 #: ../src/guestfs.pod:78
 208 #, no-wrap
 209 msgid ""
 210 " /* Call guestfs_add_drive additional times if there are\n"
 211 "  * multiple disk images.\n"
 212 "  */\n"
 213 " guestfs_add_drive (g, \"guest.img\");\n"
 214 " \n"
 215 msgstr ""
 216
 217 # type: verbatim
 218 #. type: verbatim
 219 #: ../src/guestfs.pod:83
 220 #, no-wrap
 221 msgid ""
 222 " /* Most manipulation calls won't work until you've launched\n"
 223 "  * the handle 'g'.  You have to do this _after_ adding drives\n"
 224 "  * and _before_ other commands.\n"
 225 "  */\n"
 226 " guestfs_launch (g);\n"
 227 " \n"
 228 msgstr ""
 229
 230 # type: verbatim
 231 #. type: verbatim
 232 #: ../src/guestfs.pod:89
 233 #, no-wrap
 234 msgid ""
 235 " /* Now you can examine what partitions, LVs etc are available.\n"
 236 "  */\n"
 237 " char **partitions = guestfs_list_partitions (g);\n"
 238 " char **logvols = guestfs_lvs (g);\n"
 239 " \n"
 240 msgstr ""
 241
 242 # type: verbatim
 243 #. type: verbatim
 244 #: ../src/guestfs.pod:94
 245 #, no-wrap
 246 msgid ""
 247 " /* To access a filesystem in the image, you must mount it.\n"
 248 "  */\n"
 249 " guestfs_mount (g, \"/dev/sda1\", \"/\");\n"
 250 " \n"
 251 msgstr ""
 252
 253 #. type: verbatim
 254 #: ../src/guestfs.pod:98
 255 #, no-wrap
 256 msgid ""
 257 " /* Now you can perform filesystem actions on the guest\n"
 258 "  * disk image.\n"
 259 "  */\n"
 260 " guestfs_touch (g, \"/hello\");\n"
 261 " \n"
 262 msgstr ""
 263
 264 # type: verbatim
 265 #. type: verbatim
 266 #: ../src/guestfs.pod:103
 267 #, no-wrap
 268 msgid ""
 269 " /* This is only needed for libguestfs < 1.5.24.  Since then\n"
 270 "  * it is done automatically when you close the handle.  See\n"
 271 "  * discussion of autosync in this page.\n"
 272 "  */\n"
 273 " guestfs_sync (g);\n"
 274 " \n"
 275 msgstr ""
 276
 277 # type: verbatim
 278 #. type: verbatim
 279 #: ../src/guestfs.pod:109
 280 #, no-wrap
 281 msgid ""
 282 " /* Close the handle 'g'. */\n"
 283 " guestfs_close (g);\n"
 284 "\n"
 285 msgstr ""
 286
 287 # type: textblock
 288 #. type: textblock
 289 #: ../src/guestfs.pod:112
 290 msgid ""
 291 "The code above doesn't include any error checking.  In real code you should "
 292 "check return values carefully for errors.  In general all functions that "
 293 "return integers return C<-1> on error, and all functions that return "
 294 "pointers return C<NULL> on error.  See section L</ERROR HANDLING> below for "
 295 "how to handle errors, and consult the documentation for each function call "
 296 "below to see precisely how they return error indications.  See L<guestfs-"
 297 "examples(3)> for fully worked examples."
 298 msgstr ""
 299
 300 # type: =head2
 301 #. type: =head2
 302 #: ../src/guestfs.pod:121
 303 msgid "DISK IMAGES"
 304 msgstr ""
 305
 306 # type: textblock
 307 #. type: textblock
 308 #: ../src/guestfs.pod:123
 309 msgid ""
 310 "The image filename (C<\"guest.img\"> in the example above) could be a disk "
 311 "image from a virtual machine, a L<dd(1)> copy of a physical hard disk, an "
 312 "actual block device, or simply an empty file of zeroes that you have created "
 313 "through L<posix_fallocate(3)>.  Libguestfs lets you do useful things to all "
 314 "of these."
 315 msgstr ""
 316
 317 # type: textblock
 318 #. type: textblock
 319 #: ../src/guestfs.pod:129
 320 msgid ""
 321 "The call you should use in modern code for adding drives is L</"
 322 "guestfs_add_drive_opts>.  To add a disk image, allowing writes, and "
 323 "specifying that the format is raw, do:"
 324 msgstr ""
 325
 326 # type: verbatim
 327 #. type: verbatim
 328 #: ../src/guestfs.pod:133
 329 #, no-wrap
 330 msgid ""
 331 " guestfs_add_drive_opts (g, filename,\n"
 332 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"raw\",\n"
 333 "                         -1);\n"
 334 "\n"
 335 msgstr ""
 336
 337 # type: textblock
 338 #. type: textblock
 339 #: ../src/guestfs.pod:137
 340 msgid "You can add a disk read-only using:"
 341 msgstr ""
 342
 343 # type: verbatim
 344 #. type: verbatim
 345 #: ../src/guestfs.pod:139
 346 #, no-wrap
 347 msgid ""
 348 " guestfs_add_drive_opts (g, filename,\n"
 349 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"raw\",\n"
 350 "                         GUESTFS_ADD_DRIVE_OPTS_READONLY, 1,\n"
 351 "                         -1);\n"
 352 "\n"
 353 msgstr ""
 354
 355 # type: textblock
 356 #. type: textblock
 357 #: ../src/guestfs.pod:144
 358 msgid ""
 359 "or by calling the older function L</guestfs_add_drive_ro>.  In either case "
 360 "libguestfs won't modify the file."
 361 msgstr ""
 362
 363 # type: textblock
 364 #. type: textblock
 365 #: ../src/guestfs.pod:147
 366 msgid ""
 367 "Be extremely cautious if the disk image is in use, eg. if it is being used "
 368 "by a virtual machine.  Adding it read-write will almost certainly cause disk "
 369 "corruption, but adding it read-only is safe."
 370 msgstr ""
 371
 372 # type: textblock
 373 #. type: textblock
 374 #: ../src/guestfs.pod:151
 375 msgid ""
 376 "You must add at least one disk image, and you may add multiple disk images.  "
 377 "In the API, the disk images are usually referred to as C</dev/sda> (for the "
 378 "first one you added), C</dev/sdb> (for the second one you added), etc."
 379 msgstr ""
 380
 381 # type: textblock
 382 #. type: textblock
 383 #: ../src/guestfs.pod:156
 384 msgid ""
 385 "Once L</guestfs_launch> has been called you cannot add any more images.  You "
 386 "can call L</guestfs_list_devices> to get a list of the device names, in the "
 387 "order that you added them.  See also L</BLOCK DEVICE NAMING> below."
 388 msgstr ""
 389
 390 # type: =head2
 391 #. type: =head2
 392 #: ../src/guestfs.pod:161
 393 msgid "MOUNTING"
 394 msgstr ""
 395
 396 #. type: textblock
 397 #: ../src/guestfs.pod:163
 398 msgid ""
 399 "Before you can read or write files, create directories and so on in a disk "
 400 "image that contains filesystems, you have to mount those filesystems using "
 401 "L</guestfs_mount_options> or L</guestfs_mount_ro>.  If you already know that "
 402 "a disk image contains (for example) one partition with a filesystem on that "
 403 "partition, then you can mount it directly:"
 404 msgstr ""
 405
 406 #. type: verbatim
 407 #: ../src/guestfs.pod:170
 408 #, no-wrap
 409 msgid ""
 410 " guestfs_mount_options (g, \"\", \"/dev/sda1\", \"/\");\n"
 411 "\n"
 412 msgstr ""
 413
 414 #. type: textblock
 415 #: ../src/guestfs.pod:172
 416 msgid ""
 417 "where C</dev/sda1> means literally the first partition (C<1>) of the first "
 418 "disk image that we added (C</dev/sda>).  If the disk contains Linux LVM2 "
 419 "logical volumes you could refer to those instead (eg. C</dev/VG/LV>).  Note "
 420 "that these are libguestfs virtual devices, and are nothing to do with host "
 421 "devices."
 422 msgstr ""
 423
 424 #. type: textblock
 425 #: ../src/guestfs.pod:178
 426 msgid ""
 427 "If you are given a disk image and you don't know what it contains then you "
 428 "have to find out.  Libguestfs can do that too: use L</"
 429 "guestfs_list_partitions> and L</guestfs_lvs> to list possible partitions and "
 430 "LVs, and either try mounting each to see what is mountable, or else examine "
 431 "them with L</guestfs_vfs_type> or L</guestfs_file>.  To list just "
 432 "filesystems, use L</guestfs_list_filesystems>."
 433 msgstr ""
 434
 435 #. type: textblock
 436 #: ../src/guestfs.pod:186
 437 msgid ""
 438 "Libguestfs also has a set of APIs for inspection of unknown disk images (see "
 439 "L</INSPECTION> below).  But you might find it easier to look at higher level "
 440 "programs built on top of libguestfs, in particular L<virt-inspector(1)>."
 441 msgstr ""
 442
 443 #. type: textblock
 444 #: ../src/guestfs.pod:191
 445 msgid ""
 446 "To mount a filesystem read-only, use L</guestfs_mount_ro>.  There are "
 447 "several other variations of the C<guestfs_mount_*> call."
 448 msgstr ""
 449
 450 # type: =head2
 451 #. type: =head2
 452 #: ../src/guestfs.pod:194
 453 msgid "FILESYSTEM ACCESS AND MODIFICATION"
 454 msgstr ""
 455
 456 # type: textblock
 457 #. type: textblock
 458 #: ../src/guestfs.pod:196
 459 msgid ""
 460 "The majority of the libguestfs API consists of fairly low-level calls for "
 461 "accessing and modifying the files, directories, symlinks etc on mounted "
 462 "filesystems.  There are over a hundred such calls which you can find listed "
 463 "in detail below in this man page, and we don't even pretend to cover them "
 464 "all in this overview."
 465 msgstr ""
 466
 467 # type: textblock
 468 #. type: textblock
 469 #: ../src/guestfs.pod:202
 470 msgid ""
 471 "Specify filenames as full paths, starting with C<\"/\"> and including the "
 472 "mount point."
 473 msgstr ""
 474
 475 # type: textblock
 476 #. type: textblock
 477 #: ../src/guestfs.pod:205
 478 msgid ""
 479 "For example, if you mounted a filesystem at C<\"/\"> and you want to read "
 480 "the file called C<\"etc/passwd\"> then you could do:"
 481 msgstr ""
 482
 483 # type: verbatim
 484 #. type: verbatim
 485 #: ../src/guestfs.pod:208
 486 #, no-wrap
 487 msgid ""
 488 " char *data = guestfs_cat (g, \"/etc/passwd\");\n"
 489 "\n"
 490 msgstr ""
 491
 492 # type: textblock
 493 #. type: textblock
 494 #: ../src/guestfs.pod:210
 495 msgid ""
 496 "This would return C<data> as a newly allocated buffer containing the full "
 497 "content of that file (with some conditions: see also L</DOWNLOADING> below), "
 498 "or C<NULL> if there was an error."
 499 msgstr ""
 500
 501 # type: textblock
 502 #. type: textblock
 503 #: ../src/guestfs.pod:214
 504 msgid ""
 505 "As another example, to create a top-level directory on that filesystem "
 506 "called C<\"var\"> you would do:"
 507 msgstr ""
 508
 509 # type: verbatim
 510 #. type: verbatim
 511 #: ../src/guestfs.pod:217
 512 #, no-wrap
 513 msgid ""
 514 " guestfs_mkdir (g, \"/var\");\n"
 515 "\n"
 516 msgstr ""
 517
 518 # type: textblock
 519 #. type: textblock
 520 #: ../src/guestfs.pod:219
 521 msgid "To create a symlink you could do:"
 522 msgstr ""
 523
 524 # type: verbatim
 525 #. type: verbatim
 526 #: ../src/guestfs.pod:221
 527 #, no-wrap
 528 msgid ""
 529 " guestfs_ln_s (g, \"/etc/init.d/portmap\",\n"
 530 "               \"/etc/rc3.d/S30portmap\");\n"
 531 "\n"
 532 msgstr ""
 533
 534 # type: textblock
 535 #. type: textblock
 536 #: ../src/guestfs.pod:224
 537 msgid ""
 538 "Libguestfs will reject attempts to use relative paths and there is no "
 539 "concept of a current working directory."
 540 msgstr ""
 541
 542 # type: textblock
 543 #. type: textblock
 544 #: ../src/guestfs.pod:227
 545 msgid ""
 546 "Libguestfs can return errors in many situations: for example if the "
 547 "filesystem isn't writable, or if a file or directory that you requested "
 548 "doesn't exist.  If you are using the C API (documented here)  you have to "
 549 "check for those error conditions after each call.  (Other language bindings "
 550 "turn these errors into exceptions)."
 551 msgstr ""
 552
 553 # type: textblock
 554 #. type: textblock
 555 #: ../src/guestfs.pod:233
 556 msgid ""
 557 "File writes are affected by the per-handle umask, set by calling L</"
 558 "guestfs_umask> and defaulting to 022.  See L</UMASK>."
 559 msgstr ""
 560
 561 # type: =head2
 562 #. type: =head2
 563 #: ../src/guestfs.pod:236
 564 msgid "PARTITIONING"
 565 msgstr ""
 566
 567 # type: textblock
 568 #. type: textblock
 569 #: ../src/guestfs.pod:238
 570 msgid ""
 571 "Libguestfs contains API calls to read, create and modify partition tables on "
 572 "disk images."
 573 msgstr ""
 574
 575 # type: textblock
 576 #. type: textblock
 577 #: ../src/guestfs.pod:241
 578 msgid ""
 579 "In the common case where you want to create a single partition covering the "
 580 "whole disk, you should use the L</guestfs_part_disk> call:"
 581 msgstr ""
 582
 583 # type: verbatim
 584 #. type: verbatim
 585 #: ../src/guestfs.pod:245
 586 #, no-wrap
 587 msgid ""
 588 " const char *parttype = \"mbr\";\n"
 589 " if (disk_is_larger_than_2TB)\n"
 590 "   parttype = \"gpt\";\n"
 591 " guestfs_part_disk (g, \"/dev/sda\", parttype);\n"
 592 "\n"
 593 msgstr ""
 594
 595 # type: textblock
 596 #. type: textblock
 597 #: ../src/guestfs.pod:250
 598 msgid ""
 599 "Obviously this effectively wipes anything that was on that disk image before."
 600 msgstr ""
 601
 602 # type: =head2
 603 #. type: =head2
 604 #: ../src/guestfs.pod:253
 605 msgid "LVM2"
 606 msgstr ""
 607
 608 # type: textblock
 609 #. type: textblock
 610 #: ../src/guestfs.pod:255
 611 msgid ""
 612 "Libguestfs provides access to a large part of the LVM2 API, such as L</"
 613 "guestfs_lvcreate> and L</guestfs_vgremove>.  It won't make much sense unless "
 614 "you familiarize yourself with the concepts of physical volumes, volume "
 615 "groups and logical volumes."
 616 msgstr ""
 617
 618 # type: textblock
 619 #. type: textblock
 620 #: ../src/guestfs.pod:260
 621 msgid ""
 622 "This author strongly recommends reading the LVM HOWTO, online at L<http://"
 623 "tldp.org/HOWTO/LVM-HOWTO/>."
 624 msgstr ""
 625
 626 # type: =head2
 627 #. type: =head2
 628 #: ../src/guestfs.pod:263
 629 msgid "DOWNLOADING"
 630 msgstr ""
 631
 632 #. type: textblock
 633 #: ../src/guestfs.pod:265
 634 msgid ""
 635 "Use L</guestfs_cat> to download small, text only files.  This call is "
 636 "limited to files which are less than 2 MB and which cannot contain any ASCII "
 637 "NUL (C<\\0>) characters.  However the API is very simple to use."
 638 msgstr ""
 639
 640 # type: textblock
 641 #. type: textblock
 642 #: ../src/guestfs.pod:269
 643 msgid ""
 644 "L</guestfs_read_file> can be used to read files which contain arbitrary 8 "
 645 "bit data, since it returns a (pointer, size) pair.  However it is still "
 646 "limited to \"small\" files, less than 2 MB."
 647 msgstr ""
 648
 649 # type: textblock
 650 #. type: textblock
 651 #: ../src/guestfs.pod:273
 652 msgid ""
 653 "L</guestfs_download> can be used to download any file, with no limits on "
 654 "content or size (even files larger than 4 GB)."
 655 msgstr ""
 656
 657 # type: textblock
 658 #. type: textblock
 659 #: ../src/guestfs.pod:276
 660 msgid ""
 661 "To download multiple files, see L</guestfs_tar_out> and L</guestfs_tgz_out>."
 662 msgstr ""
 663
 664 # type: =head2
 665 #. type: =head2
 666 #: ../src/guestfs.pod:279
 667 msgid "UPLOADING"
 668 msgstr ""
 669
 670 # type: textblock
 671 #. type: textblock
 672 #: ../src/guestfs.pod:281
 673 msgid ""
 674 "It's often the case that you want to write a file or files to the disk image."
 675 msgstr ""
 676
 677 # type: textblock
 678 #. type: textblock
 679 #: ../src/guestfs.pod:284
 680 msgid ""
 681 "To write a small file with fixed content, use L</guestfs_write>.  To create "
 682 "a file of all zeroes, use L</guestfs_truncate_size> (sparse) or L</"
 683 "guestfs_fallocate64> (with all disk blocks allocated).  There are a variety "
 684 "of other functions for creating test files, for example L</guestfs_fill> and "
 685 "L</guestfs_fill_pattern>."
 686 msgstr ""
 687
 688 # type: textblock
 689 #. type: textblock
 690 #: ../src/guestfs.pod:290
 691 msgid ""
 692 "To upload a single file, use L</guestfs_upload>.  This call has no limits on "
 693 "file content or size (even files larger than 4 GB)."
 694 msgstr ""
 695
 696 # type: textblock
 697 #. type: textblock
 698 #: ../src/guestfs.pod:293
 699 msgid ""
 700 "To upload multiple files, see L</guestfs_tar_in> and L</guestfs_tgz_in>."
 701 msgstr ""
 702
 703 # type: textblock
 704 #. type: textblock
 705 #: ../src/guestfs.pod:295
 706 msgid ""
 707 "However the fastest way to upload I<large numbers of arbitrary files> is to "
 708 "turn them into a squashfs or CD ISO (see L<mksquashfs(8)> and L<mkisofs(8)"
 709 ">), then attach this using L</guestfs_add_drive_ro>.  If you add the drive "
 710 "in a predictable way (eg. adding it last after all other drives) then you "
 711 "can get the device name from L</guestfs_list_devices> and mount it directly "
 712 "using L</guestfs_mount_ro>.  Note that squashfs images are sometimes non-"
 713 "portable between kernel versions, and they don't support labels or UUIDs.  "
 714 "If you want to pre-build an image or you need to mount it using a label or "
 715 "UUID, use an ISO image instead."
 716 msgstr ""
 717
 718 # type: =head2
 719 #. type: =head2
 720 #: ../src/guestfs.pod:306
 721 msgid "COPYING"
 722 msgstr ""
 723
 724 # type: textblock
 725 #. type: textblock
 726 #: ../src/guestfs.pod:308
 727 msgid ""
 728 "There are various different commands for copying between files and devices "
 729 "and in and out of the guest filesystem.  These are summarised in the table "
 730 "below."
 731 msgstr ""
 732
 733 # type: =item
 734 #. type: =item
 735 #: ../src/guestfs.pod:314
 736 msgid "B<file> to B<file>"
 737 msgstr ""
 738
 739 # type: textblock
 740 #. type: textblock
 741 #: ../src/guestfs.pod:316
 742 msgid ""
 743 "Use L</guestfs_cp> to copy a single file, or L</guestfs_cp_a> to copy "
 744 "directories recursively."
 745 msgstr ""
 746
 747 # type: =item
 748 #. type: =item
 749 #: ../src/guestfs.pod:319
 750 msgid "B<file or device> to B<file or device>"
 751 msgstr ""
 752
 753 # type: textblock
 754 #. type: textblock
 755 #: ../src/guestfs.pod:321
 756 msgid ""
 757 "Use L</guestfs_dd> which efficiently uses L<dd(1)> to copy between files and "
 758 "devices in the guest."
 759 msgstr ""
 760
 761 # type: textblock
 762 #. type: textblock
 763 #: ../src/guestfs.pod:324
 764 msgid "Example: duplicate the contents of an LV:"
 765 msgstr ""
 766
 767 # type: verbatim
 768 #. type: verbatim
 769 #: ../src/guestfs.pod:326
 770 #, no-wrap
 771 msgid ""
 772 " guestfs_dd (g, \"/dev/VG/Original\", \"/dev/VG/Copy\");\n"
 773 "\n"
 774 msgstr ""
 775
 776 # type: textblock
 777 #. type: textblock
 778 #: ../src/guestfs.pod:328
 779 msgid ""
 780 "The destination (C</dev/VG/Copy>) must be at least as large as the source "
 781 "(C</dev/VG/Original>).  To copy less than the whole source device, use L</"
 782 "guestfs_copy_size>."
 783 msgstr ""
 784
 785 # type: =item
 786 #. type: =item
 787 #: ../src/guestfs.pod:332
 788 msgid "B<file on the host> to B<file or device>"
 789 msgstr ""
 790
 791 # type: textblock
 792 #. type: textblock
 793 #: ../src/guestfs.pod:334
 794 msgid "Use L</guestfs_upload>.  See L</UPLOADING> above."
 795 msgstr ""
 796
 797 # type: =item
 798 #. type: =item
 799 #: ../src/guestfs.pod:336
 800 msgid "B<file or device> to B<file on the host>"
 801 msgstr ""
 802
 803 # type: textblock
 804 #. type: textblock
 805 #: ../src/guestfs.pod:338
 806 msgid "Use L</guestfs_download>.  See L</DOWNLOADING> above."
 807 msgstr ""
 808
 809 # type: =head2
 810 #. type: =head2
 811 #: ../src/guestfs.pod:342
 812 msgid "UPLOADING AND DOWNLOADING TO PIPES AND FILE DESCRIPTORS"
 813 msgstr ""
 814
 815 # type: textblock
 816 #. type: textblock
 817 #: ../src/guestfs.pod:344
 818 msgid ""
 819 "Calls like L</guestfs_upload>, L</guestfs_download>, L</guestfs_tar_in>, L</"
 820 "guestfs_tar_out> etc appear to only take filenames as arguments, so it "
 821 "appears you can only upload and download to files.  However many Un*x-like "
 822 "hosts let you use the special device files C</dev/stdin>, C</dev/stdout>, C</"
 823 "dev/stderr> and C</dev/fd/N> to read and write from stdin, stdout, stderr, "
 824 "and arbitrary file descriptor N."
 825 msgstr ""
 826
 827 # type: textblock
 828 #. type: textblock
 829 #: ../src/guestfs.pod:352
 830 msgid "For example, L<virt-cat(1)> writes its output to stdout by doing:"
 831 msgstr ""
 832
 833 #. type: verbatim
 834 #: ../src/guestfs.pod:355
 835 #, no-wrap
 836 msgid ""
 837 " guestfs_download (g, filename, \"/dev/stdout\");\n"
 838 "\n"
 839 msgstr ""
 840
 841 # type: textblock
 842 #. type: textblock
 843 #: ../src/guestfs.pod:357
 844 msgid "and you can write tar output to a pipe C<fd> by doing:"
 845 msgstr ""
 846
 847 #. type: verbatim
 848 #: ../src/guestfs.pod:359
 849 #, no-wrap
 850 msgid ""
 851 " char devfd[64];\n"
 852 " snprintf (devfd, sizeof devfd, \"/dev/fd/%d\", fd);\n"
 853 " guestfs_tar_out (g, \"/\", devfd);\n"
 854 "\n"
 855 msgstr ""
 856
 857 # type: =head2
 858 #. type: =head2
 859 #: ../src/guestfs.pod:363
 860 msgid "LISTING FILES"
 861 msgstr ""
 862
 863 # type: textblock
 864 #. type: textblock
 865 #: ../src/guestfs.pod:365
 866 msgid ""
 867 "L</guestfs_ll> is just designed for humans to read (mainly when using the "
 868 "L<guestfish(1)>-equivalent command C<ll>)."
 869 msgstr ""
 870
 871 # type: textblock
 872 #. type: textblock
 873 #: ../src/guestfs.pod:368
 874 msgid ""
 875 "L</guestfs_ls> is a quick way to get a list of files in a directory from "
 876 "programs, as a flat list of strings."
 877 msgstr ""
 878
 879 # type: textblock
 880 #. type: textblock
 881 #: ../src/guestfs.pod:371
 882 msgid ""
 883 "L</guestfs_readdir> is a programmatic way to get a list of files in a "
 884 "directory, plus additional information about each one.  It is more "
 885 "equivalent to using the L<readdir(3)> call on a local filesystem."
 886 msgstr ""
 887
 888 # type: textblock
 889 #. type: textblock
 890 #: ../src/guestfs.pod:375
 891 msgid ""
 892 "L</guestfs_find> and L</guestfs_find0> can be used to recursively list files."
 893 msgstr ""
 894
 895 # type: =head2
 896 #. type: =head2
 897 #: ../src/guestfs.pod:378
 898 msgid "RUNNING COMMANDS"
 899 msgstr ""
 900
 901 # type: textblock
 902 #. type: textblock
 903 #: ../src/guestfs.pod:380
 904 msgid ""
 905 "Although libguestfs is primarily an API for manipulating files inside guest "
 906 "images, we also provide some limited facilities for running commands inside "
 907 "guests."
 908 msgstr ""
 909
 910 # type: textblock
 911 #. type: textblock
 912 #: ../src/guestfs.pod:384
 913 msgid "There are many limitations to this:"
 914 msgstr ""
 915
 916 # type: =item
 917 #. type: =item
 918 #: ../src/guestfs.pod:388 ../src/guestfs.pod:393 ../src/guestfs.pod:398
 919 #: ../src/guestfs.pod:402 ../src/guestfs.pod:407 ../src/guestfs.pod:411
 920 #: ../src/guestfs.pod:416 ../src/guestfs.pod:421 ../src/guestfs.pod:1088
 921 #: ../src/guestfs.pod:1092 ../src/guestfs.pod:1096 ../src/guestfs.pod:1101
 922 #: ../src/guestfs.pod:1109 ../src/guestfs.pod:1128 ../src/guestfs.pod:1136
 923 #: ../src/guestfs.pod:1158 ../src/guestfs.pod:1162 ../src/guestfs.pod:1166
 924 #: ../src/guestfs.pod:1170 ../src/guestfs.pod:1174 ../src/guestfs.pod:1178
 925 #: ../src/guestfs.pod:1660 ../src/guestfs.pod:1665 ../src/guestfs.pod:1669
 926 #: ../src/guestfs.pod:1770 ../src/guestfs.pod:1775 ../src/guestfs.pod:1779
 927 #: ../src/guestfs.pod:2008 ../src/guestfs.pod:2013 ../src/guestfs.pod:2019
 928 #: ../src/guestfs.pod:2027 ../src/guestfs.pod:2381 ../src/guestfs.pod:2387
 929 #: ../src/guestfs.pod:2392 ../src/guestfs.pod:2398 ../src/guestfs.pod:2863
 930 #: ../src/guestfs.pod:2867 ../src/guestfs.pod:2871 ../src/guestfs.pod:2875
 931 #: ../src/guestfs-actions.pod:15 ../src/guestfs-actions.pod:22
 932 #: ../src/guestfs-actions.pod:577 ../src/guestfs-actions.pod:585
 933 #: ../src/guestfs-actions.pod:592 ../src/guestfs-actions.pod:599
 934 #: ../src/guestfs-actions.pod:1595 ../src/guestfs-actions.pod:1599
 935 #: ../src/guestfs-actions.pod:1603 ../src/guestfs-actions.pod:1607
 936 #: ../src/guestfs-actions.pod:1615 ../src/guestfs-actions.pod:1619
 937 #: ../src/guestfs-actions.pod:1623 ../src/guestfs-actions.pod:1633
 938 #: ../src/guestfs-actions.pod:1637 ../src/guestfs-actions.pod:1641
 939 #: ../src/guestfs-actions.pod:1779 ../src/guestfs-actions.pod:1783
 940 #: ../src/guestfs-actions.pod:1788 ../src/guestfs-actions.pod:1793
 941 #: ../src/guestfs-actions.pod:1854 ../src/guestfs-actions.pod:1858
 942 #: ../src/guestfs-actions.pod:1863 ../fish/guestfish.pod:441
 943 #: ../fish/guestfish.pod:445 ../fish/guestfish.pod:449
 944 #: ../fish/guestfish.pod:453 ../fish/guestfish-actions.pod:13
 945 #: ../fish/guestfish-actions.pod:20 ../fish/guestfish-actions.pod:380
 946 #: ../fish/guestfish-actions.pod:388 ../fish/guestfish-actions.pod:395
 947 #: ../fish/guestfish-actions.pod:402 ../fish/guestfish-actions.pod:1072
 948 #: ../fish/guestfish-actions.pod:1076 ../fish/guestfish-actions.pod:1080
 949 #: ../fish/guestfish-actions.pod:1084 ../fish/guestfish-actions.pod:1092
 950 #: ../fish/guestfish-actions.pod:1096 ../fish/guestfish-actions.pod:1100
 951 #: ../fish/guestfish-actions.pod:1110 ../fish/guestfish-actions.pod:1114
 952 #: ../fish/guestfish-actions.pod:1118 ../fish/guestfish-actions.pod:1208
 953 #: ../fish/guestfish-actions.pod:1212 ../fish/guestfish-actions.pod:1217
 954 #: ../fish/guestfish-actions.pod:1222 ../fish/guestfish-actions.pod:1264
 955 #: ../fish/guestfish-actions.pod:1268 ../fish/guestfish-actions.pod:1273
 956 #: ../tools/virt-win-reg.pl:536 ../tools/virt-win-reg.pl:542
 957 #: ../tools/virt-win-reg.pl:548 ../tools/virt-resize.pl:345
 958 #: ../tools/virt-resize.pl:350 ../tools/virt-resize.pl:360
 959 msgid "*"
 960 msgstr ""
 961
 962 # type: textblock
 963 #. type: textblock
 964 #: ../src/guestfs.pod:390
 965 msgid ""
 966 "The kernel version that the command runs under will be different from what "
 967 "it expects."
 968 msgstr ""
 969
 970 # type: textblock
 971 #. type: textblock
 972 #: ../src/guestfs.pod:395
 973 msgid ""
 974 "If the command needs to communicate with daemons, then most likely they "
 975 "won't be running."
 976 msgstr ""
 977
 978 # type: textblock
 979 #. type: textblock
 980 #: ../src/guestfs.pod:400
 981 msgid "The command will be running in limited memory."
 982 msgstr ""
 983
 984 # type: textblock
 985 #. type: textblock
 986 #: ../src/guestfs.pod:404
 987 msgid ""
 988 "The network may not be available unless you enable it (see L</"
 989 "guestfs_set_network>)."
 990 msgstr ""
 991
 992 # type: textblock
 993 #. type: textblock
 994 #: ../src/guestfs.pod:409
 995 msgid "Only supports Linux guests (not Windows, BSD, etc)."
 996 msgstr ""
 997
 998 # type: textblock
 999 #. type: textblock
1000 #: ../src/guestfs.pod:413
1001 msgid ""
1002 "Architecture limitations (eg. won't work for a PPC guest on an X86 host)."
1003 msgstr ""
1004
1005 # type: textblock
1006 #. type: textblock
1007 #: ../src/guestfs.pod:418
1008 msgid ""
1009 "For SELinux guests, you may need to enable SELinux and load policy first.  "
1010 "See L</SELINUX> in this manpage."
1011 msgstr ""
1012
1013 # type: textblock
1014 #. type: textblock
1015 #: ../src/guestfs.pod:423
1016 msgid ""
1017 "I<Security:> It is not safe to run commands from untrusted, possibly "
1018 "malicious guests.  These commands may attempt to exploit your program by "
1019 "sending unexpected output.  They could also try to exploit the Linux kernel "
1020 "or qemu provided by the libguestfs appliance.  They could use the network "
1021 "provided by the libguestfs appliance to bypass ordinary network partitions "
1022 "and firewalls.  They could use the elevated privileges or different SELinux "
1023 "context of your program to their advantage."
1024 msgstr ""
1025
1026 # type: textblock
1027 #. type: textblock
1028 #: ../src/guestfs.pod:432
1029 msgid ""
1030 "A secure alternative is to use libguestfs to install a \"firstboot\" script "
1031 "(a script which runs when the guest next boots normally), and to have this "
1032 "script run the commands you want in the normal context of the running guest, "
1033 "network security and so on.  For information about other security issues, "
1034 "see L</SECURITY>."
1035 msgstr ""
1036
1037 # type: textblock
1038 #. type: textblock
1039 #: ../src/guestfs.pod:440
1040 msgid ""
1041 "The two main API calls to run commands are L</guestfs_command> and L</"
1042 "guestfs_sh> (there are also variations)."
1043 msgstr ""
1044
1045 # type: textblock
1046 #. type: textblock
1047 #: ../src/guestfs.pod:443
1048 msgid ""
1049 "The difference is that L</guestfs_sh> runs commands using the shell, so any "
1050 "shell globs, redirections, etc will work."
1051 msgstr ""
1052
1053 # type: =head2
1054 #. type: =head2
1055 #: ../src/guestfs.pod:446
1056 msgid "CONFIGURATION FILES"
1057 msgstr ""
1058
1059 # type: textblock
1060 #. type: textblock
1061 #: ../src/guestfs.pod:448
1062 msgid ""
1063 "To read and write configuration files in Linux guest filesystems, we "
1064 "strongly recommend using Augeas.  For example, Augeas understands how to "
1065 "read and write, say, a Linux shadow password file or X.org configuration "
1066 "file, and so avoids you having to write that code."
1067 msgstr ""
1068
1069 # type: textblock
1070 #. type: textblock
1071 #: ../src/guestfs.pod:453
1072 msgid ""
1073 "The main Augeas calls are bound through the C<guestfs_aug_*> APIs.  We don't "
1074 "document Augeas itself here because there is excellent documentation on the "
1075 "L<http://augeas.net/> website."
1076 msgstr ""
1077
1078 # type: textblock
1079 #. type: textblock
1080 #: ../src/guestfs.pod:457
1081 msgid ""
1082 "If you don't want to use Augeas (you fool!) then try calling L</"
1083 "guestfs_read_lines> to get the file as a list of lines which you can iterate "
1084 "over."
1085 msgstr ""
1086
1087 # type: =head2
1088 #. type: =head2
1089 #: ../src/guestfs.pod:461
1090 msgid "SELINUX"
1091 msgstr ""
1092
1093 # type: textblock
1094 #. type: textblock
1095 #: ../src/guestfs.pod:463
1096 msgid ""
1097 "We support SELinux guests.  To ensure that labeling happens correctly in "
1098 "SELinux guests, you need to enable SELinux and load the guest's policy:"
1099 msgstr ""
1100
1101 # type: =item
1102 #. type: =item
1103 #: ../src/guestfs.pod:469 ../src/guestfs.pod:1281 ../src/guestfs.pod:1412
1104 #: ../src/guestfs.pod:2426
1105 msgid "1."
1106 msgstr ""
1107
1108 # type: textblock
1109 #. type: textblock
1110 #: ../src/guestfs.pod:471
1111 msgid "Before launching, do:"
1112 msgstr ""
1113
1114 # type: verbatim
1115 #. type: verbatim
1116 #: ../src/guestfs.pod:473
1117 #, no-wrap
1118 msgid ""
1119 " guestfs_set_selinux (g, 1);\n"
1120 "\n"
1121 msgstr ""
1122
1123 # type: =item
1124 #. type: =item
1125 #: ../src/guestfs.pod:475 ../src/guestfs.pod:1285 ../src/guestfs.pod:1416
1126 #: ../src/guestfs.pod:2451
1127 msgid "2."
1128 msgstr ""
1129
1130 # type: textblock
1131 #. type: textblock
1132 #: ../src/guestfs.pod:477
1133 msgid ""
1134 "After mounting the guest's filesystem(s), load the policy.  This is best "
1135 "done by running the L<load_policy(8)> command in the guest itself:"
1136 msgstr ""
1137
1138 # type: verbatim
1139 #. type: verbatim
1140 #: ../src/guestfs.pod:481
1141 #, no-wrap
1142 msgid ""
1143 " guestfs_sh (g, \"/usr/sbin/load_policy\");\n"
1144 "\n"
1145 msgstr ""
1146
1147 # type: textblock
1148 #. type: textblock
1149 #: ../src/guestfs.pod:483
1150 msgid ""
1151 "(Older versions of C<load_policy> require you to specify the name of the "
1152 "policy file)."
1153 msgstr ""
1154
1155 # type: =item
1156 #. type: =item
1157 #: ../src/guestfs.pod:486 ../src/guestfs.pod:1422
1158 msgid "3."
1159 msgstr ""
1160
1161 # type: textblock
1162 #. type: textblock
1163 #: ../src/guestfs.pod:488
1164 msgid ""
1165 "Optionally, set the security context for the API.  The correct security "
1166 "context to use can only be known by inspecting the guest.  As an example:"
1167 msgstr ""
1168
1169 # type: verbatim
1170 #. type: verbatim
1171 #: ../src/guestfs.pod:492
1172 #, no-wrap
1173 msgid ""
1174 " guestfs_setcon (g, \"unconfined_u:unconfined_r:unconfined_t:s0\");\n"
1175 "\n"
1176 msgstr ""
1177
1178 # type: textblock
1179 #. type: textblock
1180 #: ../src/guestfs.pod:496
1181 msgid "This will work for running commands and editing existing files."
1182 msgstr ""
1183
1184 # type: textblock
1185 #. type: textblock
1186 #: ../src/guestfs.pod:498
1187 msgid ""
1188 "When new files are created, you may need to label them explicitly, for "
1189 "example by running the external command C<restorecon pathname>."
1190 msgstr ""
1191
1192 # type: =head2
1193 #. type: =head2
1194 #: ../src/guestfs.pod:502
1195 msgid "UMASK"
1196 msgstr ""
1197
1198 # type: textblock
1199 #. type: textblock
1200 #: ../src/guestfs.pod:504
1201 msgid ""
1202 "Certain calls are affected by the current file mode creation mask (the "
1203 "\"umask\").  In particular ones which create files or directories, such as "
1204 "L</guestfs_touch>, L</guestfs_mknod> or L</guestfs_mkdir>.  This affects "
1205 "either the default mode that the file is created with or modifies the mode "
1206 "that you supply."
1207 msgstr ""
1208
1209 # type: textblock
1210 #. type: textblock
1211 #: ../src/guestfs.pod:510
1212 msgid ""
1213 "The default umask is C<022>, so files are created with modes such as C<0644> "
1214 "and directories with C<0755>."
1215 msgstr ""
1216
1217 # type: textblock
1218 #. type: textblock
1219 #: ../src/guestfs.pod:513
1220 msgid ""
1221 "There are two ways to avoid being affected by umask.  Either set umask to 0 "
1222 "(call C<guestfs_umask (g, 0)> early after launching).  Or call L</"
1223 "guestfs_chmod> after creating each file or directory."
1224 msgstr ""
1225
1226 # type: textblock
1227 #. type: textblock
1228 #: ../src/guestfs.pod:517
1229 msgid "For more information about umask, see L<umask(2)>."
1230 msgstr ""
1231
1232 # type: =head1
1233 #. type: =head1
1234 #: ../src/guestfs.pod:519 ../fish/guestfish.pod:760
1235 msgid "ENCRYPTED DISKS"
1236 msgstr ""
1237
1238 # type: textblock
1239 #. type: textblock
1240 #: ../src/guestfs.pod:521
1241 msgid ""
1242 "Libguestfs allows you to access Linux guests which have been encrypted using "
1243 "whole disk encryption that conforms to the Linux Unified Key Setup (LUKS) "
1244 "standard.  This includes nearly all whole disk encryption systems used by "
1245 "modern Linux guests."
1246 msgstr ""
1247
1248 # type: textblock
1249 #. type: textblock
1250 #: ../src/guestfs.pod:527
1251 msgid ""
1252 "Use L</guestfs_vfs_type> to identify LUKS-encrypted block devices (it "
1253 "returns the string C<crypto_LUKS>)."
1254 msgstr ""
1255
1256 # type: textblock
1257 #. type: textblock
1258 #: ../src/guestfs.pod:530
1259 msgid ""
1260 "Then open these devices by calling L</guestfs_luks_open>.  Obviously you "
1261 "will require the passphrase!"
1262 msgstr ""
1263
1264 # type: textblock
1265 #. type: textblock
1266 #: ../src/guestfs.pod:533
1267 msgid ""
1268 "Opening a LUKS device creates a new device mapper device called C</dev/"
1269 "mapper/mapname> (where C<mapname> is the string you supply to L</"
1270 "guestfs_luks_open>).  Reads and writes to this mapper device are decrypted "
1271 "from and encrypted to the underlying block device respectively."
1272 msgstr ""
1273
1274 # type: textblock
1275 #. type: textblock
1276 #: ../src/guestfs.pod:539
1277 msgid ""
1278 "LVM volume groups on the device can be made visible by calling L</"
1279 "guestfs_vgscan> followed by L</guestfs_vg_activate_all>.  The logical volume"
1280 "(s) can now be mounted in the usual way."
1281 msgstr ""
1282
1283 # type: textblock
1284 #. type: textblock
1285 #: ../src/guestfs.pod:543
1286 msgid ""
1287 "Use the reverse process to close a LUKS device.  Unmount any logical volumes "
1288 "on it, deactivate the volume groups by caling C<guestfs_vg_activate (g, 0, "
1289 "[\"/dev/VG\"])>.  Then close the mapper device by calling L</"
1290 "guestfs_luks_close> on the C</dev/mapper/mapname> device (I<not> the "
1291 "underlying encrypted block device)."
1292 msgstr ""
1293
1294 # type: =head2
1295 #. type: =head2
1296 #: ../src/guestfs.pod:550
1297 msgid "INSPECTION"
1298 msgstr ""
1299
1300 #. type: textblock
1301 #: ../src/guestfs.pod:552
1302 msgid ""
1303 "Libguestfs has APIs for inspecting an unknown disk image to find out if it "
1304 "contains operating systems, an install CD or a live CD.  (These APIs used to "
1305 "be in a separate Perl-only library called L<Sys::Guestfs::Lib(3)> but since "
1306 "version 1.5.3 the most frequently used part of this library has been "
1307 "rewritten in C and moved into the core code)."
1308 msgstr ""
1309
1310 # type: textblock
1311 #. type: textblock
1312 #: ../src/guestfs.pod:559
1313 msgid ""
1314 "Add all disks belonging to the unknown virtual machine and call L</"
1315 "guestfs_launch> in the usual way."
1316 msgstr ""
1317
1318 # type: textblock
1319 #. type: textblock
1320 #: ../src/guestfs.pod:562
1321 msgid ""
1322 "Then call L</guestfs_inspect_os>.  This function uses other libguestfs calls "
1323 "and certain heuristics, and returns a list of operating systems that were "
1324 "found.  An empty list means none were found.  A single element is the root "
1325 "filesystem of the operating system.  For dual- or multi-boot guests, "
1326 "multiple roots can be returned, each one corresponding to a separate "
1327 "operating system.  (Multi-boot virtual machines are extremely rare in the "
1328 "world of virtualization, but since this scenario can happen, we have built "
1329 "libguestfs to deal with it.)"
1330 msgstr ""
1331
1332 # type: textblock
1333 #. type: textblock
1334 #: ../src/guestfs.pod:571
1335 msgid ""
1336 "For each root, you can then call various C<guestfs_inspect_get_*> functions "
1337 "to get additional details about that operating system.  For example, call L</"
1338 "guestfs_inspect_get_type> to return the string C<windows> or C<linux> for "
1339 "Windows and Linux-based operating systems respectively."
1340 msgstr ""
1341
1342 # type: textblock
1343 #. type: textblock
1344 #: ../src/guestfs.pod:577
1345 msgid ""
1346 "Un*x-like and Linux-based operating systems usually consist of several "
1347 "filesystems which are mounted at boot time (for example, a separate boot "
1348 "partition mounted on C</boot>).  The inspection rules are able to detect how "
1349 "filesystems correspond to mount points.  Call "
1350 "C<guestfs_inspect_get_mountpoints> to get this mapping.  It might return a "
1351 "hash table like this example:"
1352 msgstr ""
1353
1354 # type: verbatim
1355 #. type: verbatim
1356 #: ../src/guestfs.pod:584
1357 #, no-wrap
1358 msgid ""
1359 " /boot => /dev/sda1\n"
1360 " /     => /dev/vg_guest/lv_root\n"
1361 " /usr  => /dev/vg_guest/lv_usr\n"
1362 "\n"
1363 msgstr ""
1364
1365 # type: textblock
1366 #. type: textblock
1367 #: ../src/guestfs.pod:588
1368 msgid ""
1369 "The caller can then make calls to L</guestfs_mount_options> to mount the "
1370 "filesystems as suggested."
1371 msgstr ""
1372
1373 # type: textblock
1374 #. type: textblock
1375 #: ../src/guestfs.pod:591
1376 msgid ""
1377 "Be careful to mount filesystems in the right order (eg. C</> before C</"
1378 "usr>).  Sorting the keys of the hash by length, shortest first, should work."
1379 msgstr ""
1380
1381 # type: textblock
1382 #. type: textblock
1383 #: ../src/guestfs.pod:595
1384 msgid ""
1385 "Inspection currently only works for some common operating systems.  "
1386 "Contributors are welcome to send patches for other operating systems that we "
1387 "currently cannot detect."
1388 msgstr ""
1389
1390 # type: textblock
1391 #. type: textblock
1392 #: ../src/guestfs.pod:599
1393 msgid ""
1394 "Encrypted disks must be opened before inspection.  See L</ENCRYPTED DISKS> "
1395 "for more details.  The L</guestfs_inspect_os> function just ignores any "
1396 "encrypted devices."
1397 msgstr ""
1398
1399 # type: textblock
1400 #. type: textblock
1401 #: ../src/guestfs.pod:603
1402 msgid ""
1403 "A note on the implementation: The call L</guestfs_inspect_os> performs "
1404 "inspection and caches the results in the guest handle.  Subsequent calls to "
1405 "C<guestfs_inspect_get_*> return this cached information, but I<do not> re-"
1406 "read the disks.  If you change the content of the guest disks, you can redo "
1407 "inspection by calling L</guestfs_inspect_os> again.  (L</"
1408 "guestfs_inspect_list_applications> works a little differently from the other "
1409 "calls and does read the disks.  See documentation for that function for "
1410 "details)."
1411 msgstr ""
1412
1413 #. type: =head3
1414 #: ../src/guestfs.pod:612
1415 msgid "INSPECTING INSTALL DISKS"
1416 msgstr ""
1417
1418 #. type: textblock
1419 #: ../src/guestfs.pod:614
1420 msgid ""
1421 "Libguestfs (since 1.9.4) can detect some install disks, install CDs, live "
1422 "CDs and more."
1423 msgstr ""
1424
1425 #. type: textblock
1426 #: ../src/guestfs.pod:617
1427 msgid ""
1428 "Call L</guestfs_inspect_get_format> to return the format of the operating "
1429 "system, which currently can be C<installed> (a regular operating system) or "
1430 "C<installer> (some sort of install disk)."
1431 msgstr ""
1432
1433 #. type: textblock
1434 #: ../src/guestfs.pod:621
1435 msgid ""
1436 "Further information is available about the operating system that can be "
1437 "installed using the regular inspection APIs like L</"
1438 "guestfs_inspect_get_product_name>, L</guestfs_inspect_get_major_version> etc."
1439 msgstr ""
1440
1441 #. type: textblock
1442 #: ../src/guestfs.pod:626
1443 msgid ""
1444 "Some additional information specific to installer disks is also available "
1445 "from the L</guestfs_inspect_is_live>, L</guestfs_inspect_is_netinst> and L</"
1446 "guestfs_inspect_is_multipart> calls."
1447 msgstr ""
1448
1449 # type: =head2
1450 #. type: =head2
1451 #: ../src/guestfs.pod:631
1452 msgid "SPECIAL CONSIDERATIONS FOR WINDOWS GUESTS"
1453 msgstr ""
1454
1455 # type: textblock
1456 #. type: textblock
1457 #: ../src/guestfs.pod:633
1458 msgid ""
1459 "Libguestfs can mount NTFS partitions.  It does this using the L<http://www."
1460 "ntfs-3g.org/> driver."
1461 msgstr ""
1462
1463 # type: =head3
1464 #. type: =head3
1465 #: ../src/guestfs.pod:636
1466 msgid "DRIVE LETTERS AND PATHS"
1467 msgstr ""
1468
1469 # type: textblock
1470 #. type: textblock
1471 #: ../src/guestfs.pod:638
1472 msgid ""
1473 "DOS and Windows still use drive letters, and the filesystems are always "
1474 "treated as case insensitive by Windows itself, and therefore you might find "
1475 "a Windows configuration file referring to a path like C<c:\\windows"
1476 "\\system32>.  When the filesystem is mounted in libguestfs, that directory "
1477 "might be referred to as C</WINDOWS/System32>."
1478 msgstr ""
1479
1480 # type: textblock
1481 #. type: textblock
1482 #: ../src/guestfs.pod:644
1483 msgid ""
1484 "Drive letter mappings are outside the scope of libguestfs.  You have to use "
1485 "libguestfs to read the appropriate Windows Registry and configuration files, "
1486 "to determine yourself how drives are mapped (see also L<hivex(3)> and L<virt-"
1487 "inspector(1)>)."
1488 msgstr ""
1489
1490 # type: textblock
1491 #. type: textblock
1492 #: ../src/guestfs.pod:649
1493 msgid ""
1494 "Replacing backslash characters with forward slash characters is also outside "
1495 "the scope of libguestfs, but something that you can easily do."
1496 msgstr ""
1497
1498 # type: textblock
1499 #. type: textblock
1500 #: ../src/guestfs.pod:652
1501 msgid ""
1502 "Where we can help is in resolving the case insensitivity of paths.  For "
1503 "this, call L</guestfs_case_sensitive_path>."
1504 msgstr ""
1505
1506 # type: =head3
1507 #. type: =head3
1508 #: ../src/guestfs.pod:655
1509 msgid "ACCESSING THE WINDOWS REGISTRY"
1510 msgstr ""
1511
1512 # type: textblock
1513 #. type: textblock
1514 #: ../src/guestfs.pod:657
1515 msgid ""
1516 "Libguestfs also provides some help for decoding Windows Registry \"hive\" "
1517 "files, through the library C<hivex> which is part of the libguestfs project "
1518 "although ships as a separate tarball.  You have to locate and download the "
1519 "hive file(s) yourself, and then pass them to C<hivex> functions.  See also "
1520 "the programs L<hivexml(1)>, L<hivexsh(1)>, L<hivexregedit(1)> and L<virt-win-"
1521 "reg(1)> for more help on this issue."
1522 msgstr ""
1523
1524 # type: =head3
1525 #. type: =head3
1526 #: ../src/guestfs.pod:665
1527 msgid "SYMLINKS ON NTFS-3G FILESYSTEMS"
1528 msgstr ""
1529
1530 # type: textblock
1531 #. type: textblock
1532 #: ../src/guestfs.pod:667
1533 msgid ""
1534 "Ntfs-3g tries to rewrite \"Junction Points\" and NTFS \"symbolic links\" to "
1535 "provide something which looks like a Linux symlink.  The way it tries to do "
1536 "the rewriting is described here:"
1537 msgstr ""
1538
1539 # type: textblock
1540 #. type: textblock
1541 #: ../src/guestfs.pod:671
1542 msgid ""
1543 "L<http://www.tuxera.com/community/ntfs-3g-advanced/junction-points-and-"
1544 "symbolic-links/>"
1545 msgstr ""
1546
1547 # type: textblock
1548 #. type: textblock
1549 #: ../src/guestfs.pod:673
1550 msgid ""
1551 "The essential problem is that ntfs-3g simply does not have enough "
1552 "information to do a correct job.  NTFS links can contain drive letters and "
1553 "references to external device GUIDs that ntfs-3g has no way of resolving.  "
1554 "It is almost certainly the case that libguestfs callers should ignore what "
1555 "ntfs-3g does (ie. don't use L</guestfs_readlink> on NTFS volumes)."
1556 msgstr ""
1557
1558 # type: textblock
1559 #. type: textblock
1560 #: ../src/guestfs.pod:680
1561 msgid ""
1562 "Instead if you encounter a symbolic link on an ntfs-3g filesystem, use L</"
1563 "guestfs_lgetxattr> to read the C<system.ntfs_reparse_data> extended "
1564 "attribute, and read the raw reparse data from that (you can find the format "
1565 "documented in various places around the web)."
1566 msgstr ""
1567
1568 # type: =head3
1569 #. type: =head3
1570 #: ../src/guestfs.pod:685
1571 msgid "EXTENDED ATTRIBUTES ON NTFS-3G FILESYSTEMS"
1572 msgstr ""
1573
1574 # type: textblock
1575 #. type: textblock
1576 #: ../src/guestfs.pod:687
1577 msgid ""
1578 "There are other useful extended attributes that can be read from ntfs-3g "
1579 "filesystems (using L</guestfs_getxattr>).  See:"
1580 msgstr ""
1581
1582 # type: textblock
1583 #. type: textblock
1584 #: ../src/guestfs.pod:690
1585 msgid ""
1586 "L<http://www.tuxera.com/community/ntfs-3g-advanced/extended-attributes/>"
1587 msgstr ""
1588
1589 # type: =head2
1590 #. type: =head2
1591 #: ../src/guestfs.pod:692
1592 msgid "USING LIBGUESTFS WITH OTHER PROGRAMMING LANGUAGES"
1593 msgstr ""
1594
1595 # type: textblock
1596 #. type: textblock
1597 #: ../src/guestfs.pod:694
1598 msgid ""
1599 "Although we don't want to discourage you from using the C API, we will "
1600 "mention here that the same API is also available in other languages."
1601 msgstr ""
1602
1603 #. type: textblock
1604 #: ../src/guestfs.pod:697
1605 msgid ""
1606 "The API is broadly identical in all supported languages.  This means that "
1607 "the C call C<guestfs_add_drive_ro(g,file)> is C<$g-E<gt>add_drive_ro($file)> "
1608 "in Perl, C<g.add_drive_ro(file)> in Python, and C<g#add_drive_ro file> in "
1609 "OCaml.  In other words, a straightforward, predictable isomorphism between "
1610 "each language."
1611 msgstr ""
1612
1613 # type: textblock
1614 #. type: textblock
1615 #: ../src/guestfs.pod:703
1616 msgid ""
1617 "Error messages are automatically transformed into exceptions if the language "
1618 "supports it."
1619 msgstr ""
1620
1621 # type: textblock
1622 #. type: textblock
1623 #: ../src/guestfs.pod:706
1624 msgid ""
1625 "We don't try to \"object orientify\" parts of the API in OO languages, "
1626 "although contributors are welcome to write higher level APIs above what we "
1627 "provide in their favourite languages if they wish."
1628 msgstr ""
1629
1630 # type: =item
1631 #. type: =item
1632 #: ../src/guestfs.pod:712
1633 msgid "B<C++>"
1634 msgstr ""
1635
1636 # type: textblock
1637 #. type: textblock
1638 #: ../src/guestfs.pod:714
1639 msgid ""
1640 "You can use the I<guestfs.h> header file from C++ programs.  The C++ API is "
1641 "identical to the C API.  C++ classes and exceptions are not used."
1642 msgstr ""
1643
1644 # type: =item
1645 #. type: =item
1646 #: ../src/guestfs.pod:718
1647 msgid "B<C#>"
1648 msgstr ""
1649
1650 # type: textblock
1651 #. type: textblock
1652 #: ../src/guestfs.pod:720
1653 msgid ""
1654 "The C# bindings are highly experimental.  Please read the warnings at the "
1655 "top of C<csharp/Libguestfs.cs>."
1656 msgstr ""
1657
1658 # type: =item
1659 #. type: =item
1660 #: ../src/guestfs.pod:723
1661 msgid "B<Haskell>"
1662 msgstr ""
1663
1664 # type: textblock
1665 #. type: textblock
1666 #: ../src/guestfs.pod:725
1667 msgid ""
1668 "This is the only language binding that is working but incomplete.  Only "
1669 "calls which return simple integers have been bound in Haskell, and we are "
1670 "looking for help to complete this binding."
1671 msgstr ""
1672
1673 # type: =item
1674 #. type: =item
1675 #: ../src/guestfs.pod:729
1676 msgid "B<Java>"
1677 msgstr ""
1678
1679 # type: textblock
1680 #. type: textblock
1681 #: ../src/guestfs.pod:731
1682 msgid ""
1683 "Full documentation is contained in the Javadoc which is distributed with "
1684 "libguestfs."
1685 msgstr ""
1686
1687 # type: =item
1688 #. type: =item
1689 #: ../src/guestfs.pod:734
1690 msgid "B<OCaml>"
1691 msgstr ""
1692
1693 #. type: textblock
1694 #: ../src/guestfs.pod:736
1695 msgid "See L<guestfs-ocaml(3)>."
1696 msgstr ""
1697
1698 # type: =item
1699 #. type: =item
1700 #: ../src/guestfs.pod:738
1701 msgid "B<Perl>"
1702 msgstr ""
1703
1704 #. type: textblock
1705 #: ../src/guestfs.pod:740
1706 msgid "See L<guestfs-perl(3)> and L<Sys::Guestfs(3)>."
1707 msgstr ""
1708
1709 # type: =item
1710 #. type: =item
1711 #: ../src/guestfs.pod:742
1712 msgid "B<PHP>"
1713 msgstr ""
1714
1715 # type: textblock
1716 #. type: textblock
1717 #: ../src/guestfs.pod:744
1718 msgid ""
1719 "For documentation see C<README-PHP> supplied with libguestfs sources or in "
1720 "the php-libguestfs package for your distribution."
1721 msgstr ""
1722
1723 # type: textblock
1724 #. type: textblock
1725 #: ../src/guestfs.pod:747
1726 msgid "The PHP binding only works correctly on 64 bit machines."
1727 msgstr ""
1728
1729 # type: =item
1730 #. type: =item
1731 #: ../src/guestfs.pod:749
1732 msgid "B<Python>"
1733 msgstr ""
1734
1735 #. type: textblock
1736 #: ../src/guestfs.pod:751
1737 msgid "See L<guestfs-python(3)>."
1738 msgstr ""
1739
1740 # type: =item
1741 #. type: =item
1742 #: ../src/guestfs.pod:753
1743 msgid "B<Ruby>"
1744 msgstr ""
1745
1746 #. type: textblock
1747 #: ../src/guestfs.pod:755
1748 msgid "See L<guestfs-ruby(3)>."
1749 msgstr ""
1750
1751 # type: =item
1752 #. type: =item
1753 #: ../src/guestfs.pod:757
1754 msgid "B<shell scripts>"
1755 msgstr ""
1756
1757 #. type: textblock
1758 #: ../src/guestfs.pod:759
1759 msgid "See L<guestfish(1)>."
1760 msgstr ""
1761
1762 # type: =head2
1763 #. type: =head2
1764 #: ../src/guestfs.pod:763
1765 msgid "LIBGUESTFS GOTCHAS"
1766 msgstr ""
1767
1768 # type: textblock
1769 #. type: textblock
1770 #: ../src/guestfs.pod:765
1771 msgid ""
1772 "L<http://en.wikipedia.org/wiki/Gotcha_(programming)>: \"A feature of a "
1773 "system [...] that works in the way it is documented but is counterintuitive "
1774 "and almost invites mistakes.\""
1775 msgstr ""
1776
1777 # type: textblock
1778 #. type: textblock
1779 #: ../src/guestfs.pod:769
1780 msgid ""
1781 "Since we developed libguestfs and the associated tools, there are several "
1782 "things we would have designed differently, but are now stuck with for "
1783 "backwards compatibility or other reasons.  If there is ever a libguestfs 2.0 "
1784 "release, you can expect these to change.  Beware of them."
1785 msgstr ""
1786
1787 # type: =item
1788 #. type: =item
1789 #: ../src/guestfs.pod:777
1790 msgid "Autosync / forgetting to sync."
1791 msgstr ""
1792
1793 # type: textblock
1794 #. type: textblock
1795 #: ../src/guestfs.pod:779
1796 msgid ""
1797 "When modifying a filesystem from C or another language, you B<must> unmount "
1798 "all filesystems and call L</guestfs_sync> explicitly before you close the "
1799 "libguestfs handle.  You can also call:"
1800 msgstr ""
1801
1802 # type: verbatim
1803 #. type: verbatim
1804 #: ../src/guestfs.pod:783
1805 #, no-wrap
1806 msgid ""
1807 " guestfs_set_autosync (g, 1);\n"
1808 "\n"
1809 msgstr ""
1810
1811 # type: textblock
1812 #. type: textblock
1813 #: ../src/guestfs.pod:785
1814 msgid ""
1815 "to have the unmount/sync done automatically for you when the handle 'g' is "
1816 "closed.  (This feature is called \"autosync\", L</guestfs_set_autosync> q.v.)"
1817 msgstr ""
1818
1819 # type: textblock
1820 #. type: textblock
1821 #: ../src/guestfs.pod:789
1822 msgid ""
1823 "If you forget to do this, then it is entirely possible that your changes "
1824 "won't be written out, or will be partially written, or (very rarely) that "
1825 "you'll get disk corruption."
1826 msgstr ""
1827
1828 # type: textblock
1829 #. type: textblock
1830 #: ../src/guestfs.pod:793
1831 msgid ""
1832 "Note that in L<guestfish(3)> autosync is the default.  So quick and dirty "
1833 "guestfish scripts that forget to sync will work just fine, which can make "
1834 "this very puzzling if you are trying to debug a problem."
1835 msgstr ""
1836
1837 # type: textblock
1838 #. type: textblock
1839 #: ../src/guestfs.pod:797
1840 msgid ""
1841 "Update: Autosync is enabled by default for all API users starting from "
1842 "libguestfs 1.5.24."
1843 msgstr ""
1844
1845 # type: =item
1846 #. type: =item
1847 #: ../src/guestfs.pod:800
1848 msgid "Mount option C<-o sync> should not be the default."
1849 msgstr ""
1850
1851 # type: textblock
1852 #. type: textblock
1853 #: ../src/guestfs.pod:802
1854 msgid ""
1855 "If you use L</guestfs_mount>, then C<-o sync,noatime> are added implicitly.  "
1856 "However C<-o sync> does not add any reliability benefit, but does have a "
1857 "very large performance impact."
1858 msgstr ""
1859
1860 # type: textblock
1861 #. type: textblock
1862 #: ../src/guestfs.pod:806
1863 msgid ""
1864 "The work around is to use L</guestfs_mount_options> and set the mount "
1865 "options that you actually want to use."
1866 msgstr ""
1867
1868 # type: =item
1869 #. type: =item
1870 #: ../src/guestfs.pod:809
1871 msgid "Read-only should be the default."
1872 msgstr ""
1873
1874 # type: textblock
1875 #. type: textblock
1876 #: ../src/guestfs.pod:811
1877 msgid ""
1878 "In L<guestfish(3)>, I<--ro> should be the default, and you should have to "
1879 "specify I<--rw> if you want to make changes to the image."
1880 msgstr ""
1881
1882 # type: textblock
1883 #. type: textblock
1884 #: ../src/guestfs.pod:814
1885 msgid "This would reduce the potential to corrupt live VM images."
1886 msgstr ""
1887
1888 # type: textblock
1889 #. type: textblock
1890 #: ../src/guestfs.pod:816
1891 msgid ""
1892 "Note that many filesystems change the disk when you just mount and unmount, "
1893 "even if you didn't perform any writes.  You need to use L</"
1894 "guestfs_add_drive_ro> to guarantee that the disk is not changed."
1895 msgstr ""
1896
1897 # type: =item
1898 #. type: =item
1899 #: ../src/guestfs.pod:820
1900 msgid "guestfish command line is hard to use."
1901 msgstr ""
1902
1903 # type: textblock
1904 #. type: textblock
1905 #: ../src/guestfs.pod:822
1906 msgid ""
1907 "C<guestfish disk.img> doesn't do what people expect (open C<disk.img> for "
1908 "examination).  It tries to run a guestfish command C<disk.img> which doesn't "
1909 "exist, so it fails.  In earlier versions of guestfish the error message was "
1910 "also unintuitive, but we have corrected this since.  Like the Bourne shell, "
1911 "we should have used C<guestfish -c command> to run commands."
1912 msgstr ""
1913
1914 # type: =item
1915 #. type: =item
1916 #: ../src/guestfs.pod:829
1917 msgid "guestfish megabyte modifiers don't work right on all commands"
1918 msgstr ""
1919
1920 # type: textblock
1921 #. type: textblock
1922 #: ../src/guestfs.pod:831
1923 msgid ""
1924 "In recent guestfish you can use C<1M> to mean 1 megabyte (and similarly for "
1925 "other modifiers).  What guestfish actually does is to multiply the number "
1926 "part by the modifier part and pass the result to the C API.  However this "
1927 "doesn't work for a few APIs which aren't expecting bytes, but are already "
1928 "expecting some other unit (eg. megabytes)."
1929 msgstr ""
1930
1931 # type: textblock
1932 #. type: textblock
1933 #: ../src/guestfs.pod:838
1934 msgid "The most common is L</guestfs_lvcreate>.  The guestfish command:"
1935 msgstr ""
1936
1937 # type: verbatim
1938 #. type: verbatim
1939 #: ../src/guestfs.pod:840
1940 #, no-wrap
1941 msgid ""
1942 " lvcreate LV VG 100M\n"
1943 "\n"
1944 msgstr ""
1945
1946 # type: textblock
1947 #. type: textblock
1948 #: ../src/guestfs.pod:842
1949 msgid ""
1950 "does not do what you might expect.  Instead because L</guestfs_lvcreate> is "
1951 "already expecting megabytes, this tries to create a 100 I<terabyte> (100 "
1952 "megabytes * megabytes) logical volume.  The error message you get from this "
1953 "is also a little obscure."
1954 msgstr ""
1955
1956 # type: textblock
1957 #. type: textblock
1958 #: ../src/guestfs.pod:847
1959 msgid ""
1960 "This could be fixed in the generator by specially marking parameters and "
1961 "return values which take bytes or other units."
1962 msgstr ""
1963
1964 # type: =item
1965 #. type: =item
1966 #: ../src/guestfs.pod:850
1967 msgid "Ambiguity between devices and paths"
1968 msgstr ""
1969
1970 # type: textblock
1971 #. type: textblock
1972 #: ../src/guestfs.pod:852
1973 msgid ""
1974 "There is a subtle ambiguity in the API between a device name (eg. C</dev/"
1975 "sdb2>) and a similar pathname.  A file might just happen to be called "
1976 "C<sdb2> in the directory C</dev> (consider some non-Unix VM image)."
1977 msgstr ""
1978
1979 # type: textblock
1980 #. type: textblock
1981 #: ../src/guestfs.pod:857
1982 msgid ""
1983 "In the current API we usually resolve this ambiguity by having two separate "
1984 "calls, for example L</guestfs_checksum> and L</guestfs_checksum_device>.  "
1985 "Some API calls are ambiguous and (incorrectly) resolve the problem by "
1986 "detecting if the path supplied begins with C</dev/>."
1987 msgstr ""
1988
1989 # type: textblock
1990 #. type: textblock
1991 #: ../src/guestfs.pod:863
1992 msgid ""
1993 "To avoid both the ambiguity and the need to duplicate some calls, we could "
1994 "make paths/devices into structured names.  One way to do this would be to "
1995 "use a notation like grub (C<hd(0,0)>), although nobody really likes this "
1996 "aspect of grub.  Another way would be to use a structured type, equivalent "
1997 "to this OCaml type:"
1998 msgstr ""
1999
2000 # type: verbatim
2001 #. type: verbatim
2002 #: ../src/guestfs.pod:869
2003 #, no-wrap
2004 msgid ""
2005 " type path = Path of string | Device of int | Partition of int * int\n"
2006 "\n"
2007 msgstr ""
2008
2009 # type: textblock
2010 #. type: textblock
2011 #: ../src/guestfs.pod:871
2012 msgid "which would allow you to pass arguments like:"
2013 msgstr ""
2014
2015 # type: verbatim
2016 #. type: verbatim
2017 #: ../src/guestfs.pod:873
2018 #, no-wrap
2019 msgid ""
2020 " Path \"/foo/bar\"\n"
2021 " Device 1            (* /dev/sdb, or perhaps /dev/sda *)\n"
2022 " Partition (1, 2)    (* /dev/sdb2 (or is it /dev/sda2 or /dev/sdb3?) *)\n"
2023 " Path \"/dev/sdb2\"    (* not a device *)\n"
2024 "\n"
2025 msgstr ""
2026
2027 # type: textblock
2028 #. type: textblock
2029 #: ../src/guestfs.pod:878
2030 msgid ""
2031 "As you can see there are still problems to resolve even with this "
2032 "representation.  Also consider how it might work in guestfish."
2033 msgstr ""
2034
2035 # type: =head2
2036 #. type: =head2
2037 #: ../src/guestfs.pod:883
2038 msgid "PROTOCOL LIMITS"
2039 msgstr ""
2040
2041 # type: textblock
2042 #. type: textblock
2043 #: ../src/guestfs.pod:885
2044 msgid ""
2045 "Internally libguestfs uses a message-based protocol to pass API calls and "
2046 "their responses to and from a small \"appliance\" (see L</INTERNALS> for "
2047 "plenty more detail about this).  The maximum message size used by the "
2048 "protocol is slightly less than 4 MB.  For some API calls you may need to be "
2049 "aware of this limit.  The API calls which may be affected are individually "
2050 "documented, with a link back to this section of the documentation."
2051 msgstr ""
2052
2053 # type: textblock
2054 #. type: textblock
2055 #: ../src/guestfs.pod:893
2056 msgid ""
2057 "A simple call such as L</guestfs_cat> returns its result (the file data) in "
2058 "a simple string.  Because this string is at some point internally encoded as "
2059 "a message, the maximum size that it can return is slightly under 4 MB.  If "
2060 "the requested file is larger than this then you will get an error."
2061 msgstr ""
2062
2063 # type: textblock
2064 #. type: textblock
2065 #: ../src/guestfs.pod:899
2066 msgid ""
2067 "In order to transfer large files into and out of the guest filesystem, you "
2068 "need to use particular calls that support this.  The sections L</UPLOADING> "
2069 "and L</DOWNLOADING> document how to do this."
2070 msgstr ""
2071
2072 # type: textblock
2073 #. type: textblock
2074 #: ../src/guestfs.pod:903
2075 msgid ""
2076 "You might also consider mounting the disk image using our FUSE filesystem "
2077 "support (L<guestmount(1)>)."
2078 msgstr ""
2079
2080 # type: =head2
2081 #. type: =head2
2082 #: ../src/guestfs.pod:906
2083 msgid "KEYS AND PASSPHRASES"
2084 msgstr ""
2085
2086 # type: textblock
2087 #. type: textblock
2088 #: ../src/guestfs.pod:908
2089 msgid ""
2090 "Certain libguestfs calls take a parameter that contains sensitive key "
2091 "material, passed in as a C string."
2092 msgstr ""
2093
2094 # type: textblock
2095 #. type: textblock
2096 #: ../src/guestfs.pod:911
2097 msgid ""
2098 "In the future we would hope to change the libguestfs implementation so that "
2099 "keys are L<mlock(2)>-ed into physical RAM, and thus can never end up in "
2100 "swap.  However this is I<not> done at the moment, because of the complexity "
2101 "of such an implementation."
2102 msgstr ""
2103
2104 # type: textblock
2105 #. type: textblock
2106 #: ../src/guestfs.pod:916
2107 msgid ""
2108 "Therefore you should be aware that any key parameter you pass to libguestfs "
2109 "might end up being written out to the swap partition.  If this is a concern, "
2110 "scrub the swap partition or don't use libguestfs on encrypted devices."
2111 msgstr ""
2112
2113 # type: =head1
2114 #. type: =head2
2115 #: ../src/guestfs.pod:921
2116 msgid "MULTIPLE HANDLES AND MULTIPLE THREADS"
2117 msgstr ""
2118
2119 # type: textblock
2120 #. type: textblock
2121 #: ../src/guestfs.pod:923
2122 msgid ""
2123 "All high-level libguestfs actions are synchronous.  If you want to use "
2124 "libguestfs asynchronously then you must create a thread."
2125 msgstr ""
2126
2127 # type: textblock
2128 #. type: textblock
2129 #: ../src/guestfs.pod:926
2130 msgid ""
2131 "Only use the handle from a single thread.  Either use the handle exclusively "
2132 "from one thread, or provide your own mutex so that two threads cannot issue "
2133 "calls on the same handle at the same time."
2134 msgstr ""
2135
2136 # type: textblock
2137 #. type: textblock
2138 #: ../src/guestfs.pod:930
2139 msgid ""
2140 "See the graphical program guestfs-browser for one possible architecture for "
2141 "multithreaded programs using libvirt and libguestfs."
2142 msgstr ""
2143
2144 # type: =head1
2145 #. type: =head2
2146 #: ../src/guestfs.pod:933
2147 msgid "PATH"
2148 msgstr ""
2149
2150 #. type: textblock
2151 #: ../src/guestfs.pod:935
2152 msgid ""
2153 "Libguestfs needs a supermin appliance, which it finds by looking along an "
2154 "internal path."
2155 msgstr ""
2156
2157 # type: textblock
2158 #. type: textblock
2159 #: ../src/guestfs.pod:938
2160 msgid ""
2161 "By default it looks for these in the directory C<$libdir/guestfs> (eg. C</"
2162 "usr/local/lib/guestfs> or C</usr/lib64/guestfs>)."
2163 msgstr ""
2164
2165 # type: textblock
2166 #. type: textblock
2167 #: ../src/guestfs.pod:941
2168 msgid ""
2169 "Use L</guestfs_set_path> or set the environment variable L</LIBGUESTFS_PATH> "
2170 "to change the directories that libguestfs will search in.  The value is a "
2171 "colon-separated list of paths.  The current directory is I<not> searched "
2172 "unless the path contains an empty element or C<.>.  For example "
2173 "C<LIBGUESTFS_PATH=:/usr/lib/guestfs> would search the current directory and "
2174 "then C</usr/lib/guestfs>."
2175 msgstr ""
2176
2177 # type: =head1
2178 #. type: =head2
2179 #: ../src/guestfs.pod:948
2180 msgid "QEMU WRAPPERS"
2181 msgstr ""
2182
2183 # type: textblock
2184 #. type: textblock
2185 #: ../src/guestfs.pod:950
2186 msgid ""
2187 "If you want to compile your own qemu, run qemu from a non-standard location, "
2188 "or pass extra arguments to qemu, then you can write a shell-script wrapper "
2189 "around qemu."
2190 msgstr ""
2191
2192 # type: textblock
2193 #. type: textblock
2194 #: ../src/guestfs.pod:954
2195 msgid ""
2196 "There is one important rule to remember: you I<must C<exec qemu>> as the "
2197 "last command in the shell script (so that qemu replaces the shell and "
2198 "becomes the direct child of the libguestfs-using program).  If you don't do "
2199 "this, then the qemu process won't be cleaned up correctly."
2200 msgstr ""
2201
2202 # type: textblock
2203 #. type: textblock
2204 #: ../src/guestfs.pod:959
2205 msgid ""
2206 "Here is an example of a wrapper, where I have built my own copy of qemu from "
2207 "source:"
2208 msgstr ""
2209
2210 # type: verbatim
2211 #. type: verbatim
2212 #: ../src/guestfs.pod:962
2213 #, no-wrap
2214 msgid ""
2215 " #!/bin/sh -\n"
2216 " qemudir=/home/rjones/d/qemu\n"
2217 " exec $qemudir/x86_64-softmmu/qemu-system-x86_64 -L $qemudir/pc-bios \"$@\"\n"
2218 "\n"
2219 msgstr ""
2220
2221 # type: textblock
2222 #. type: textblock
2223 #: ../src/guestfs.pod:966
2224 msgid ""
2225 "Save this script as C</tmp/qemu.wrapper> (or wherever), C<chmod +x>, and "
2226 "then use it by setting the LIBGUESTFS_QEMU environment variable.  For "
2227 "example:"
2228 msgstr ""
2229
2230 # type: verbatim
2231 #. type: verbatim
2232 #: ../src/guestfs.pod:970
2233 #, no-wrap
2234 msgid ""
2235 " LIBGUESTFS_QEMU=/tmp/qemu.wrapper guestfish\n"
2236 "\n"
2237 msgstr ""
2238
2239 # type: textblock
2240 #. type: textblock
2241 #: ../src/guestfs.pod:972
2242 msgid ""
2243 "Note that libguestfs also calls qemu with the -help and -version options in "
2244 "order to determine features."
2245 msgstr ""
2246
2247 #. type: =head2
2248 #: ../src/guestfs.pod:975
2249 msgid "ATTACHING TO RUNNING DAEMONS"
2250 msgstr ""
2251
2252 #. type: textblock
2253 #: ../src/guestfs.pod:977
2254 msgid ""
2255 "I<Note (1):> This is B<highly experimental> and has a tendency to eat "
2256 "babies.  Use with caution."
2257 msgstr ""
2258
2259 #. type: textblock
2260 #: ../src/guestfs.pod:980
2261 msgid ""
2262 "I<Note (2):> This section explains how to attach to a running daemon from a "
2263 "low level perspective.  For most users, simply using virt tools such as "
2264 "L<guestfish(1)> with the I<--live> option will \"just work\"."
2265 msgstr ""
2266
2267 #. type: =head3
2268 #: ../src/guestfs.pod:984
2269 msgid "Using guestfs_set_attach_method"
2270 msgstr ""
2271
2272 #. type: textblock
2273 #: ../src/guestfs.pod:986
2274 msgid ""
2275 "By calling L</guestfs_set_attach_method> you can change how the library "
2276 "connects to the C<guestfsd> daemon in L</guestfs_launch> (read L</"
2277 "ARCHITECTURE> for some background)."
2278 msgstr ""
2279
2280 #. type: textblock
2281 #: ../src/guestfs.pod:990
2282 msgid ""
2283 "The normal attach method is C<appliance>, where a small appliance is created "
2284 "containing the daemon, and then the library connects to this."
2285 msgstr ""
2286
2287 #. type: textblock
2288 #: ../src/guestfs.pod:993
2289 msgid ""
2290 "Setting attach method to C<unix:I<path>> (where I<path> is the path of a "
2291 "Unix domain socket) causes L</guestfs_launch> to connect to an existing "
2292 "daemon over the Unix domain socket."
2293 msgstr ""
2294
2295 #. type: textblock
2296 #: ../src/guestfs.pod:997
2297 msgid ""
2298 "The normal use for this is to connect to a running virtual machine that "
2299 "contains a C<guestfsd> daemon, and send commands so you can read and write "
2300 "files inside the live virtual machine."
2301 msgstr ""
2302
2303 #. type: =head3
2304 #: ../src/guestfs.pod:1001
2305 msgid "Using guestfs_add_domain with live flag"
2306 msgstr ""
2307
2308 #. type: textblock
2309 #: ../src/guestfs.pod:1003
2310 msgid ""
2311 "L</guestfs_add_domain> provides some help for getting the correct attach "
2312 "method.  If you pass the C<live> option to this function, then (if the "
2313 "virtual machine is running) it will examine the libvirt XML looking for a "
2314 "virtio-serial channel to connect to:"
2315 msgstr ""
2316
2317 #. type: verbatim
2318 #: ../src/guestfs.pod:1009
2319 #, no-wrap
2320 msgid ""
2321 " <domain>\n"
2322 "   ...\n"
2323 "   <devices>\n"
2324 "     ...\n"
2325 "     <channel type='unix'>\n"
2326 "       <source mode='bind' path='/path/to/socket'/>\n"
2327 "       <target type='virtio' name='org.libguestfs.channel.0'/>\n"
2328 "     </channel>\n"
2329 "     ...\n"
2330 "   </devices>\n"
2331 " </domain>\n"
2332 "\n"
2333 msgstr ""
2334
2335 #. type: textblock
2336 #: ../src/guestfs.pod:1021
2337 msgid ""
2338 "L</guestfs_add_domain> extracts C</path/to/socket> and sets the attach "
2339 "method to C<unix:/path/to/socket>."
2340 msgstr ""
2341
2342 #. type: textblock
2343 #: ../src/guestfs.pod:1024
2344 msgid ""
2345 "Some of the libguestfs tools (including guestfish) support a I<--live> "
2346 "option which is passed through to L</guestfs_add_domain> thus allowing you "
2347 "to attach to and modify live virtual machines."
2348 msgstr ""
2349
2350 #. type: textblock
2351 #: ../src/guestfs.pod:1028
2352 msgid ""
2353 "The virtual machine needs to have been set up beforehand so that it has the "
2354 "virtio-serial channel and so that guestfsd is running inside it."
2355 msgstr ""
2356
2357 # type: =head2
2358 #. type: =head2
2359 #: ../src/guestfs.pod:1032
2360 msgid "ABI GUARANTEE"
2361 msgstr ""
2362
2363 # type: textblock
2364 #. type: textblock
2365 #: ../src/guestfs.pod:1034
2366 msgid ""
2367 "We guarantee the libguestfs ABI (binary interface), for public, high-level "
2368 "actions as outlined in this section.  Although we will deprecate some "
2369 "actions, for example if they get replaced by newer calls, we will keep the "
2370 "old actions forever.  This allows you the developer to program in confidence "
2371 "against the libguestfs API."
2372 msgstr ""
2373
2374 # type: =head1
2375 #. type: =head2
2376 #: ../src/guestfs.pod:1040
2377 msgid "BLOCK DEVICE NAMING"
2378 msgstr ""
2379
2380 # type: textblock
2381 #. type: textblock
2382 #: ../src/guestfs.pod:1042
2383 msgid ""
2384 "In the kernel there is now quite a profusion of schemata for naming block "
2385 "devices (in this context, by I<block device> I mean a physical or virtual "
2386 "hard drive).  The original Linux IDE driver used names starting with C</dev/"
2387 "hd*>.  SCSI devices have historically used a different naming scheme, C</dev/"
2388 "sd*>.  When the Linux kernel I<libata> driver became a popular replacement "
2389 "for the old IDE driver (particularly for SATA devices) those devices also "
2390 "used the C</dev/sd*> scheme.  Additionally we now have virtual machines with "
2391 "paravirtualized drivers.  This has created several different naming systems, "
2392 "such as C</dev/vd*> for virtio disks and C</dev/xvd*> for Xen PV disks."
2393 msgstr ""
2394
2395 # type: textblock
2396 #. type: textblock
2397 #: ../src/guestfs.pod:1054
2398 msgid ""
2399 "As discussed above, libguestfs uses a qemu appliance running an embedded "
2400 "Linux kernel to access block devices.  We can run a variety of appliances "
2401 "based on a variety of Linux kernels."
2402 msgstr ""
2403
2404 # type: textblock
2405 #. type: textblock
2406 #: ../src/guestfs.pod:1058
2407 msgid ""
2408 "This causes a problem for libguestfs because many API calls use device or "
2409 "partition names.  Working scripts and the recipe (example) scripts that we "
2410 "make available over the internet could fail if the naming scheme changes."
2411 msgstr ""
2412
2413 # type: textblock
2414 #. type: textblock
2415 #: ../src/guestfs.pod:1063
2416 msgid ""
2417 "Therefore libguestfs defines C</dev/sd*> as the I<standard naming scheme>.  "
2418 "Internally C</dev/sd*> names are translated, if necessary, to other names as "
2419 "required.  For example, under RHEL 5 which uses the C</dev/hd*> scheme, any "
2420 "device parameter C</dev/sda2> is translated to C</dev/hda2> transparently."
2421 msgstr ""
2422
2423 # type: textblock
2424 #. type: textblock
2425 #: ../src/guestfs.pod:1069
2426 msgid ""
2427 "Note that this I<only> applies to parameters.  The L</guestfs_list_devices>, "
2428 "L</guestfs_list_partitions> and similar calls return the true names of the "
2429 "devices and partitions as known to the appliance."
2430 msgstr ""
2431
2432 # type: =head2
2433 #. type: =head3
2434 #: ../src/guestfs.pod:1074
2435 msgid "ALGORITHM FOR BLOCK DEVICE NAME TRANSLATION"
2436 msgstr ""
2437
2438 # type: textblock
2439 #. type: textblock
2440 #: ../src/guestfs.pod:1076
2441 msgid ""
2442 "Usually this translation is transparent.  However in some (very rare)  cases "
2443 "you may need to know the exact algorithm.  Such cases include where you use "
2444 "L</guestfs_config> to add a mixture of virtio and IDE devices to the qemu-"
2445 "based appliance, so have a mixture of C</dev/sd*> and C</dev/vd*> devices."
2446 msgstr ""
2447
2448 # type: textblock
2449 #. type: textblock
2450 #: ../src/guestfs.pod:1082
2451 msgid ""
2452 "The algorithm is applied only to I<parameters> which are known to be either "
2453 "device or partition names.  Return values from functions such as L</"
2454 "guestfs_list_devices> are never changed."
2455 msgstr ""
2456
2457 # type: textblock
2458 #. type: textblock
2459 #: ../src/guestfs.pod:1090
2460 msgid "Is the string a parameter which is a device or partition name?"
2461 msgstr ""
2462
2463 # type: textblock
2464 #. type: textblock
2465 #: ../src/guestfs.pod:1094
2466 msgid "Does the string begin with C</dev/sd>?"
2467 msgstr ""
2468
2469 # type: textblock
2470 #. type: textblock
2471 #: ../src/guestfs.pod:1098
2472 msgid ""
2473 "Does the named device exist? If so, we use that device.  However if I<not> "
2474 "then we continue with this algorithm."
2475 msgstr ""
2476
2477 # type: textblock
2478 #. type: textblock
2479 #: ../src/guestfs.pod:1103
2480 msgid "Replace initial C</dev/sd> string with C</dev/hd>."
2481 msgstr ""
2482
2483 # type: textblock
2484 #. type: textblock
2485 #: ../src/guestfs.pod:1105
2486 msgid "For example, change C</dev/sda2> to C</dev/hda2>."
2487 msgstr ""
2488
2489 # type: textblock
2490 #. type: textblock
2491 #: ../src/guestfs.pod:1107
2492 msgid "If that named device exists, use it.  If not, continue."
2493 msgstr ""
2494
2495 # type: textblock
2496 #. type: textblock
2497 #: ../src/guestfs.pod:1111
2498 msgid "Replace initial C</dev/sd> string with C</dev/vd>."
2499 msgstr ""
2500
2501 # type: textblock
2502 #. type: textblock
2503 #: ../src/guestfs.pod:1113
2504 msgid "If that named device exists, use it.  If not, return an error."
2505 msgstr ""
2506
2507 # type: =head3
2508 #. type: =head3
2509 #: ../src/guestfs.pod:1117
2510 msgid "PORTABILITY CONCERNS WITH BLOCK DEVICE NAMING"
2511 msgstr ""
2512
2513 # type: textblock
2514 #. type: textblock
2515 #: ../src/guestfs.pod:1119
2516 msgid ""
2517 "Although the standard naming scheme and automatic translation is useful for "
2518 "simple programs and guestfish scripts, for larger programs it is best not to "
2519 "rely on this mechanism."
2520 msgstr ""
2521
2522 # type: textblock
2523 #. type: textblock
2524 #: ../src/guestfs.pod:1123
2525 msgid ""
2526 "Where possible for maximum future portability programs using libguestfs "
2527 "should use these future-proof techniques:"
2528 msgstr ""
2529
2530 # type: textblock
2531 #. type: textblock
2532 #: ../src/guestfs.pod:1130
2533 msgid ""
2534 "Use L</guestfs_list_devices> or L</guestfs_list_partitions> to list actual "
2535 "device names, and then use those names directly."
2536 msgstr ""
2537
2538 # type: textblock
2539 #. type: textblock
2540 #: ../src/guestfs.pod:1133
2541 msgid ""
2542 "Since those device names exist by definition, they will never be translated."
2543 msgstr ""
2544
2545 # type: textblock
2546 #. type: textblock
2547 #: ../src/guestfs.pod:1138
2548 msgid ""
2549 "Use higher level ways to identify filesystems, such as LVM names, UUIDs and "
2550 "filesystem labels."
2551 msgstr ""
2552
2553 # type: =head1
2554 #. type: =head1
2555 #: ../src/guestfs.pod:1143
2556 msgid "SECURITY"
2557 msgstr ""
2558
2559 # type: textblock
2560 #. type: textblock
2561 #: ../src/guestfs.pod:1145
2562 msgid ""
2563 "This section discusses security implications of using libguestfs, "
2564 "particularly with untrusted or malicious guests or disk images."
2565 msgstr ""
2566
2567 # type: =head2
2568 #. type: =head2
2569 #: ../src/guestfs.pod:1148
2570 msgid "GENERAL SECURITY CONSIDERATIONS"
2571 msgstr ""
2572
2573 # type: textblock
2574 #. type: textblock
2575 #: ../src/guestfs.pod:1150
2576 msgid ""
2577 "Be careful with any files or data that you download from a guest (by "
2578 "\"download\" we mean not just the L</guestfs_download> command but any "
2579 "command that reads files, filenames, directories or anything else from a "
2580 "disk image).  An attacker could manipulate the data to fool your program "
2581 "into doing the wrong thing.  Consider cases such as:"
2582 msgstr ""
2583
2584 # type: textblock
2585 #. type: textblock
2586 #: ../src/guestfs.pod:1160
2587 msgid "the data (file etc) not being present"
2588 msgstr ""
2589
2590 # type: textblock
2591 #. type: textblock
2592 #: ../src/guestfs.pod:1164
2593 msgid "being present but empty"
2594 msgstr ""
2595
2596 # type: textblock
2597 #. type: textblock
2598 #: ../src/guestfs.pod:1168
2599 msgid "being much larger than normal"
2600 msgstr ""
2601
2602 # type: textblock
2603 #. type: textblock
2604 #: ../src/guestfs.pod:1172
2605 msgid "containing arbitrary 8 bit data"
2606 msgstr ""
2607
2608 # type: textblock
2609 #. type: textblock
2610 #: ../src/guestfs.pod:1176
2611 msgid "being in an unexpected character encoding"
2612 msgstr ""
2613
2614 # type: textblock
2615 #. type: textblock
2616 #: ../src/guestfs.pod:1180
2617 msgid "containing homoglyphs."
2618 msgstr ""
2619
2620 # type: =head2
2621 #. type: =head2
2622 #: ../src/guestfs.pod:1184
2623 msgid "SECURITY OF MOUNTING FILESYSTEMS"
2624 msgstr ""
2625
2626 # type: textblock
2627 #. type: textblock
2628 #: ../src/guestfs.pod:1186
2629 msgid ""
2630 "When you mount a filesystem under Linux, mistakes in the kernel filesystem "
2631 "(VFS) module can sometimes be escalated into exploits by deliberately "
2632 "creating a malicious, malformed filesystem.  These exploits are very severe "
2633 "for two reasons.  Firstly there are very many filesystem drivers in the "
2634 "kernel, and many of them are infrequently used and not much developer "
2635 "attention has been paid to the code.  Linux userspace helps potential "
2636 "crackers by detecting the filesystem type and automatically choosing the "
2637 "right VFS driver, even if that filesystem type is obscure or unexpected for "
2638 "the administrator.  Secondly, a kernel-level exploit is like a local root "
2639 "exploit (worse in some ways), giving immediate and total access to the "
2640 "system right down to the hardware level."
2641 msgstr ""
2642
2643 # type: textblock
2644 #. type: textblock
2645 #: ../src/guestfs.pod:1199
2646 msgid ""
2647 "That explains why you should never mount a filesystem from an untrusted "
2648 "guest on your host kernel.  How about libguestfs? We run a Linux kernel "
2649 "inside a qemu virtual machine, usually running as a non-root user.  The "
2650 "attacker would need to write a filesystem which first exploited the kernel, "
2651 "and then exploited either qemu virtualization (eg. a faulty qemu driver) or "
2652 "the libguestfs protocol, and finally to be as serious as the host kernel "
2653 "exploit it would need to escalate its privileges to root.  This multi-step "
2654 "escalation, performed by a static piece of data, is thought to be extremely "
2655 "hard to do, although we never say 'never' about security issues."
2656 msgstr ""
2657
2658 # type: textblock
2659 #. type: textblock
2660 #: ../src/guestfs.pod:1210
2661 msgid ""
2662 "In any case callers can reduce the attack surface by forcing the filesystem "
2663 "type when mounting (use L</guestfs_mount_vfs>)."
2664 msgstr ""
2665
2666 # type: =head2
2667 #. type: =head2
2668 #: ../src/guestfs.pod:1213
2669 msgid "PROTOCOL SECURITY"
2670 msgstr ""
2671
2672 # type: textblock
2673 #. type: textblock
2674 #: ../src/guestfs.pod:1215
2675 msgid ""
2676 "The protocol is designed to be secure, being based on RFC 4506 (XDR)  with a "
2677 "defined upper message size.  However a program that uses libguestfs must "
2678 "also take care - for example you can write a program that downloads a binary "
2679 "from a disk image and executes it locally, and no amount of protocol "
2680 "security will save you from the consequences."
2681 msgstr ""
2682
2683 # type: =head2
2684 #. type: =head2
2685 #: ../src/guestfs.pod:1221
2686 msgid "INSPECTION SECURITY"
2687 msgstr ""
2688
2689 # type: textblock
2690 #. type: textblock
2691 #: ../src/guestfs.pod:1223
2692 msgid ""
2693 "Parts of the inspection API (see L</INSPECTION>) return untrusted strings "
2694 "directly from the guest, and these could contain any 8 bit data.  Callers "
2695 "should be careful to escape these before printing them to a structured file "
2696 "(for example, use HTML escaping if creating a web page)."
2697 msgstr ""
2698
2699 # type: textblock
2700 #. type: textblock
2701 #: ../src/guestfs.pod:1229
2702 msgid ""
2703 "Guest configuration may be altered in unusual ways by the administrator of "
2704 "the virtual machine, and may not reflect reality (particularly for untrusted "
2705 "or actively malicious guests).  For example we parse the hostname from "
2706 "configuration files like C</etc/sysconfig/network> that we find in the "
2707 "guest, but the guest administrator can easily manipulate these files to "
2708 "provide the wrong hostname."
2709 msgstr ""
2710
2711 # type: textblock
2712 #. type: textblock
2713 #: ../src/guestfs.pod:1237
2714 msgid ""
2715 "The inspection API parses guest configuration using two external libraries: "
2716 "Augeas (Linux configuration) and hivex (Windows Registry).  Both are "
2717 "designed to be robust in the face of malicious data, although denial of "
2718 "service attacks are still possible, for example with oversized configuration "
2719 "files."
2720 msgstr ""
2721
2722 # type: =head2
2723 #. type: =head2
2724 #: ../src/guestfs.pod:1243
2725 msgid "RUNNING UNTRUSTED GUEST COMMANDS"
2726 msgstr ""
2727
2728 # type: textblock
2729 #. type: textblock
2730 #: ../src/guestfs.pod:1245
2731 msgid ""
2732 "Be very cautious about running commands from the guest.  By running a "
2733 "command in the guest, you are giving CPU time to a binary that you do not "
2734 "control, under the same user account as the library, albeit wrapped in qemu "
2735 "virtualization.  More information and alternatives can be found in the "
2736 "section L</RUNNING COMMANDS>."
2737 msgstr ""
2738
2739 # type: =head2
2740 #. type: =head2
2741 #: ../src/guestfs.pod:1251
2742 msgid "CVE-2010-3851"
2743 msgstr ""
2744
2745 # type: textblock
2746 #. type: textblock
2747 #: ../src/guestfs.pod:1253
2748 msgid "https://bugzilla.redhat.com/642934"
2749 msgstr ""
2750
2751 # type: textblock
2752 #. type: textblock
2753 #: ../src/guestfs.pod:1255
2754 msgid ""
2755 "This security bug concerns the automatic disk format detection that qemu "
2756 "does on disk images."
2757 msgstr ""
2758
2759 # type: textblock
2760 #. type: textblock
2761 #: ../src/guestfs.pod:1258
2762 msgid ""
2763 "A raw disk image is just the raw bytes, there is no header.  Other disk "
2764 "images like qcow2 contain a special header.  Qemu deals with this by looking "
2765 "for one of the known headers, and if none is found then assuming the disk "
2766 "image must be raw."
2767 msgstr ""
2768
2769 # type: textblock
2770 #. type: textblock
2771 #: ../src/guestfs.pod:1263
2772 msgid ""
2773 "This allows a guest which has been given a raw disk image to write some "
2774 "other header.  At next boot (or when the disk image is accessed by "
2775 "libguestfs) qemu would do autodetection and think the disk image format was, "
2776 "say, qcow2 based on the header written by the guest."
2777 msgstr ""
2778
2779 # type: textblock
2780 #. type: textblock
2781 #: ../src/guestfs.pod:1268
2782 msgid ""
2783 "This in itself would not be a problem, but qcow2 offers many features, one "
2784 "of which is to allow a disk image to refer to another image (called the "
2785 "\"backing disk\").  It does this by placing the path to the backing disk "
2786 "into the qcow2 header.  This path is not validated and could point to any "
2787 "host file (eg. \"/etc/passwd\").  The backing disk is then exposed through "
2788 "\"holes\" in the qcow2 disk image, which of course is completely under the "
2789 "control of the attacker."
2790 msgstr ""
2791
2792 # type: textblock
2793 #. type: textblock
2794 #: ../src/guestfs.pod:1276
2795 msgid ""
2796 "In libguestfs this is rather hard to exploit except under two circumstances:"
2797 msgstr ""
2798
2799 # type: textblock
2800 #. type: textblock
2801 #: ../src/guestfs.pod:1283
2802 msgid "You have enabled the network or have opened the disk in write mode."
2803 msgstr ""
2804
2805 # type: textblock
2806 #. type: textblock
2807 #: ../src/guestfs.pod:1287
2808 msgid ""
2809 "You are also running untrusted code from the guest (see L</RUNNING "
2810 "COMMANDS>)."
2811 msgstr ""
2812
2813 # type: textblock
2814 #. type: textblock
2815 #: ../src/guestfs.pod:1292
2816 msgid ""
2817 "The way to avoid this is to specify the expected disk format when adding "
2818 "disks (the optional C<format> option to L</guestfs_add_drive_opts>).  You "
2819 "should always do this if the disk is raw format, and it's a good idea for "
2820 "other cases too."
2821 msgstr ""
2822
2823 # type: textblock
2824 #. type: textblock
2825 #: ../src/guestfs.pod:1297
2826 msgid ""
2827 "For disks added from libvirt using calls like L</guestfs_add_domain>, the "
2828 "format is fetched from libvirt and passed through."
2829 msgstr ""
2830
2831 # type: textblock
2832 #. type: textblock
2833 #: ../src/guestfs.pod:1300
2834 msgid ""
2835 "For libguestfs tools, use the I<--format> command line parameter as "
2836 "appropriate."
2837 msgstr ""
2838
2839 # type: =head1
2840 #. type: =head1
2841 #: ../src/guestfs.pod:1303
2842 msgid "CONNECTION MANAGEMENT"
2843 msgstr ""
2844
2845 # type: =head2
2846 #. type: =head2
2847 #: ../src/guestfs.pod:1305
2848 msgid "guestfs_h *"
2849 msgstr ""
2850
2851 # type: textblock
2852 #. type: textblock
2853 #: ../src/guestfs.pod:1307
2854 msgid ""
2855 "C<guestfs_h> is the opaque type representing a connection handle.  Create a "
2856 "handle by calling L</guestfs_create>.  Call L</guestfs_close> to free the "
2857 "handle and release all resources used."
2858 msgstr ""
2859
2860 # type: textblock
2861 #. type: textblock
2862 #: ../src/guestfs.pod:1311
2863 msgid ""
2864 "For information on using multiple handles and threads, see the section L</"
2865 "MULTIPLE HANDLES AND MULTIPLE THREADS> below."
2866 msgstr ""
2867
2868 # type: =head2
2869 #. type: =head2
2870 #: ../src/guestfs.pod:1314
2871 msgid "guestfs_create"
2872 msgstr ""
2873
2874 # type: verbatim
2875 #. type: verbatim
2876 #: ../src/guestfs.pod:1316
2877 #, no-wrap
2878 msgid ""
2879 " guestfs_h *guestfs_create (void);\n"
2880 "\n"
2881 msgstr ""
2882
2883 # type: textblock
2884 #. type: textblock
2885 #: ../src/guestfs.pod:1318
2886 msgid "Create a connection handle."
2887 msgstr ""
2888
2889 # type: textblock
2890 #. type: textblock
2891 #: ../src/guestfs.pod:1320
2892 msgid ""
2893 "You have to call L</guestfs_add_drive_opts> (or one of the equivalent calls) "
2894 "on the handle at least once."
2895 msgstr ""
2896
2897 # type: textblock
2898 #. type: textblock
2899 #: ../src/guestfs.pod:1323
2900 msgid ""
2901 "This function returns a non-NULL pointer to a handle on success or NULL on "
2902 "error."
2903 msgstr ""
2904
2905 # type: textblock
2906 #. type: textblock
2907 #: ../src/guestfs.pod:1326
2908 msgid "After configuring the handle, you have to call L</guestfs_launch>."
2909 msgstr ""
2910
2911 # type: textblock
2912 #. type: textblock
2913 #: ../src/guestfs.pod:1328
2914 msgid ""
2915 "You may also want to configure error handling for the handle.  See L</ERROR "
2916 "HANDLING> section below."
2917 msgstr ""
2918
2919 # type: =head2
2920 #. type: =head2
2921 #: ../src/guestfs.pod:1331
2922 msgid "guestfs_close"
2923 msgstr ""
2924
2925 # type: verbatim
2926 #. type: verbatim
2927 #: ../src/guestfs.pod:1333
2928 #, no-wrap
2929 msgid ""
2930 " void guestfs_close (guestfs_h *g);\n"
2931 "\n"
2932 msgstr ""
2933
2934 # type: textblock
2935 #. type: textblock
2936 #: ../src/guestfs.pod:1335
2937 msgid "This closes the connection handle and frees up all resources used."
2938 msgstr ""
2939
2940 # type: =head1
2941 #. type: =head1
2942 #: ../src/guestfs.pod:1337
2943 msgid "ERROR HANDLING"
2944 msgstr ""
2945
2946 # type: textblock
2947 #. type: textblock
2948 #: ../src/guestfs.pod:1339
2949 msgid ""
2950 "API functions can return errors.  For example, almost all functions that "
2951 "return C<int> will return C<-1> to indicate an error."
2952 msgstr ""
2953
2954 # type: textblock
2955 #. type: textblock
2956 #: ../src/guestfs.pod:1342
2957 msgid ""
2958 "Additional information is available for errors: an error message string and "
2959 "optionally an error number (errno) if the thing that failed was a system "
2960 "call."
2961 msgstr ""
2962
2963 # type: textblock
2964 #. type: textblock
2965 #: ../src/guestfs.pod:1346
2966 msgid ""
2967 "You can get at the additional information about the last error on the handle "
2968 "by calling L</guestfs_last_error>, L</guestfs_last_errno>, and/or by setting "
2969 "up an error handler with L</guestfs_set_error_handler>."
2970 msgstr ""
2971
2972 # type: textblock
2973 #. type: textblock
2974 #: ../src/guestfs.pod:1351
2975 msgid ""
2976 "When the handle is created, a default error handler is installed which "
2977 "prints the error message string to C<stderr>.  For small short-running "
2978 "command line programs it is sufficient to do:"
2979 msgstr ""
2980
2981 # type: verbatim
2982 #. type: verbatim
2983 #: ../src/guestfs.pod:1355
2984 #, no-wrap
2985 msgid ""
2986 " if (guestfs_launch (g) == -1)\n"
2987 "   exit (EXIT_FAILURE);\n"
2988 "\n"
2989 msgstr ""
2990
2991 # type: textblock
2992 #. type: textblock
2993 #: ../src/guestfs.pod:1358
2994 msgid ""
2995 "since the default error handler will ensure that an error message has been "
2996 "printed to C<stderr> before the program exits."
2997 msgstr ""
2998
2999 # type: textblock
3000 #. type: textblock
3001 #: ../src/guestfs.pod:1361
3002 msgid ""
3003 "For other programs the caller will almost certainly want to install an "
3004 "alternate error handler or do error handling in-line like this:"
3005 msgstr ""
3006
3007 # type: verbatim
3008 #. type: verbatim
3009 #: ../src/guestfs.pod:1364
3010 #, no-wrap
3011 msgid ""
3012 " g = guestfs_create ();\n"
3013 " \n"
3014 msgstr ""
3015
3016 # type: verbatim
3017 #. type: verbatim
3018 #: ../src/guestfs.pod:1366
3019 #, no-wrap
3020 msgid ""
3021 " /* This disables the default behaviour of printing errors\n"
3022 "    on stderr. */\n"
3023 " guestfs_set_error_handler (g, NULL, NULL);\n"
3024 " \n"
3025 msgstr ""
3026
3027 # type: verbatim
3028 #. type: verbatim
3029 #: ../src/guestfs.pod:1370
3030 #, no-wrap
3031 msgid ""
3032 " if (guestfs_launch (g) == -1) {\n"
3033 "   /* Examine the error message and print it etc. */\n"
3034 "   char *msg = guestfs_last_error (g);\n"
3035 "   int errnum = guestfs_last_errno (g);\n"
3036 "   fprintf (stderr, \"%s\\n\", msg);\n"
3037 "   /* ... */\n"
3038 "  }\n"
3039 "\n"
3040 msgstr ""
3041
3042 # type: textblock
3043 #. type: textblock
3044 #: ../src/guestfs.pod:1378
3045 msgid ""
3046 "Out of memory errors are handled differently.  The default action is to call "
3047 "L<abort(3)>.  If this is undesirable, then you can set a handler using L</"
3048 "guestfs_set_out_of_memory_handler>."
3049 msgstr ""
3050
3051 # type: textblock
3052 #. type: textblock
3053 #: ../src/guestfs.pod:1382
3054 msgid ""
3055 "L</guestfs_create> returns C<NULL> if the handle cannot be created, and "
3056 "because there is no handle if this happens there is no way to get additional "
3057 "error information.  However L</guestfs_create> is supposed to be a "
3058 "lightweight operation which can only fail because of insufficient memory (it "
3059 "returns NULL in this case)."
3060 msgstr ""
3061
3062 # type: =head2
3063 #. type: =head2
3064 #: ../src/guestfs.pod:1388
3065 msgid "guestfs_last_error"
3066 msgstr ""
3067
3068 # type: verbatim
3069 #. type: verbatim
3070 #: ../src/guestfs.pod:1390
3071 #, no-wrap
3072 msgid ""
3073 " const char *guestfs_last_error (guestfs_h *g);\n"
3074 "\n"
3075 msgstr ""
3076
3077 # type: textblock
3078 #. type: textblock
3079 #: ../src/guestfs.pod:1392
3080 msgid ""
3081 "This returns the last error message that happened on C<g>.  If there has not "
3082 "been an error since the handle was created, then this returns C<NULL>."
3083 msgstr ""
3084
3085 # type: textblock
3086 #. type: textblock
3087 #: ../src/guestfs.pod:1396
3088 msgid ""
3089 "The lifetime of the returned string is until the next error occurs, or L</"
3090 "guestfs_close> is called."
3091 msgstr ""
3092
3093 # type: =head2
3094 #. type: =head2
3095 #: ../src/guestfs.pod:1399
3096 msgid "guestfs_last_errno"
3097 msgstr ""
3098
3099 # type: verbatim
3100 #. type: verbatim
3101 #: ../src/guestfs.pod:1401
3102 #, no-wrap
3103 msgid ""
3104 " int guestfs_last_errno (guestfs_h *g);\n"
3105 "\n"
3106 msgstr ""
3107
3108 # type: textblock
3109 #. type: textblock
3110 #: ../src/guestfs.pod:1403
3111 msgid "This returns the last error number (errno) that happened on C<g>."
3112 msgstr ""
3113
3114 # type: textblock
3115 #. type: textblock
3116 #: ../src/guestfs.pod:1405
3117 msgid "If successful, an errno integer not equal to zero is returned."
3118 msgstr ""
3119
3120 # type: textblock
3121 #. type: textblock
3122 #: ../src/guestfs.pod:1407
3123 msgid ""
3124 "If no error, this returns 0.  This call can return 0 in three situations:"
3125 msgstr ""
3126
3127 # type: textblock
3128 #. type: textblock
3129 #: ../src/guestfs.pod:1414
3130 msgid "There has not been any error on the handle."
3131 msgstr ""
3132
3133 # type: textblock
3134 #. type: textblock
3135 #: ../src/guestfs.pod:1418
3136 msgid ""
3137 "There has been an error but the errno was meaningless.  This corresponds to "
3138 "the case where the error did not come from a failed system call, but for "
3139 "some other reason."
3140 msgstr ""
3141
3142 # type: textblock
3143 #. type: textblock
3144 #: ../src/guestfs.pod:1424
3145 msgid ""
3146 "There was an error from a failed system call, but for some reason the errno "
3147 "was not captured and returned.  This usually indicates a bug in libguestfs."
3148 msgstr ""
3149
3150 # type: textblock
3151 #. type: textblock
3152 #: ../src/guestfs.pod:1430
3153 msgid ""
3154 "Libguestfs tries to convert the errno from inside the applicance into a "
3155 "corresponding errno for the caller (not entirely trivial: the appliance "
3156 "might be running a completely different operating system from the library "
3157 "and error numbers are not standardized across Un*xen).  If this could not be "
3158 "done, then the error is translated to C<EINVAL>.  In practice this should "
3159 "only happen in very rare circumstances."
3160 msgstr ""
3161
3162 # type: =head2
3163 #. type: =head2
3164 #: ../src/guestfs.pod:1438
3165 msgid "guestfs_set_error_handler"
3166 msgstr ""
3167
3168 # type: verbatim
3169 #. type: verbatim
3170 #: ../src/guestfs.pod:1440
3171 #, no-wrap
3172 msgid ""
3173 " typedef void (*guestfs_error_handler_cb) (guestfs_h *g,\n"
3174 "                                           void *opaque,\n"
3175 "                                           const char *msg);\n"
3176 " void guestfs_set_error_handler (guestfs_h *g,\n"
3177 "                                 guestfs_error_handler_cb cb,\n"
3178 "                                 void *opaque);\n"
3179 "\n"
3180 msgstr ""
3181
3182 # type: textblock
3183 #. type: textblock
3184 #: ../src/guestfs.pod:1447
3185 msgid ""
3186 "The callback C<cb> will be called if there is an error.  The parameters "
3187 "passed to the callback are an opaque data pointer and the error message "
3188 "string."
3189 msgstr ""
3190
3191 # type: textblock
3192 #. type: textblock
3193 #: ../src/guestfs.pod:1451
3194 msgid ""
3195 "C<errno> is not passed to the callback.  To get that the callback must call "
3196 "L</guestfs_last_errno>."
3197 msgstr ""
3198
3199 # type: textblock
3200 #. type: textblock
3201 #: ../src/guestfs.pod:1454
3202 msgid ""
3203 "Note that the message string C<msg> is freed as soon as the callback "
3204 "function returns, so if you want to stash it somewhere you must make your "
3205 "own copy."
3206 msgstr ""
3207
3208 # type: textblock
3209 #. type: textblock
3210 #: ../src/guestfs.pod:1458
3211 msgid "The default handler prints messages on C<stderr>."
3212 msgstr ""
3213
3214 # type: textblock
3215 #. type: textblock
3216 #: ../src/guestfs.pod:1460
3217 msgid "If you set C<cb> to C<NULL> then I<no> handler is called."
3218 msgstr ""
3219
3220 # type: =head2
3221 #. type: =head2
3222 #: ../src/guestfs.pod:1462
3223 msgid "guestfs_get_error_handler"
3224 msgstr ""
3225
3226 # type: verbatim
3227 #. type: verbatim
3228 #: ../src/guestfs.pod:1464
3229 #, no-wrap
3230 msgid ""
3231 " guestfs_error_handler_cb guestfs_get_error_handler (guestfs_h *g,\n"
3232 "                                                     void **opaque_rtn);\n"
3233 "\n"
3234 msgstr ""
3235
3236 # type: textblock
3237 #. type: textblock
3238 #: ../src/guestfs.pod:1467
3239 msgid "Returns the current error handler callback."
3240 msgstr ""
3241
3242 # type: =head2
3243 #. type: =head2
3244 #: ../src/guestfs.pod:1469
3245 msgid "guestfs_set_out_of_memory_handler"
3246 msgstr ""
3247
3248 # type: verbatim
3249 #. type: verbatim
3250 #: ../src/guestfs.pod:1471
3251 #, no-wrap
3252 msgid ""
3253 " typedef void (*guestfs_abort_cb) (void);\n"
3254 " int guestfs_set_out_of_memory_handler (guestfs_h *g,\n"
3255 "                                        guestfs_abort_cb);\n"
3256 "\n"
3257 msgstr ""
3258
3259 # type: textblock
3260 #. type: textblock
3261 #: ../src/guestfs.pod:1475
3262 msgid ""
3263 "The callback C<cb> will be called if there is an out of memory situation.  "
3264 "I<Note this callback must not return>."
3265 msgstr ""
3266
3267 # type: textblock
3268 #. type: textblock
3269 #: ../src/guestfs.pod:1478
3270 msgid "The default is to call L<abort(3)>."
3271 msgstr ""
3272
3273 # type: textblock
3274 #. type: textblock
3275 #: ../src/guestfs.pod:1480
3276 msgid ""
3277 "You cannot set C<cb> to C<NULL>.  You can't ignore out of memory situations."
3278 msgstr ""
3279
3280 # type: =head2
3281 #. type: =head2
3282 #: ../src/guestfs.pod:1483
3283 msgid "guestfs_get_out_of_memory_handler"
3284 msgstr ""
3285
3286 # type: verbatim
3287 #. type: verbatim
3288 #: ../src/guestfs.pod:1485
3289 #, no-wrap
3290 msgid ""
3291 " guestfs_abort_fn guestfs_get_out_of_memory_handler (guestfs_h *g);\n"
3292 "\n"
3293 msgstr ""
3294
3295 # type: textblock
3296 #. type: textblock
3297 #: ../src/guestfs.pod:1487
3298 msgid "This returns the current out of memory handler."
3299 msgstr ""
3300
3301 # type: =head1
3302 #. type: =head1
3303 #: ../src/guestfs.pod:1489
3304 msgid "API CALLS"
3305 msgstr ""
3306
3307 # type: textblock
3308 #. type: textblock
3309 #: ../src/guestfs.pod:1491 ../fish/guestfish.pod:998
3310 msgid "@ACTIONS@"
3311 msgstr ""
3312
3313 # type: =head1
3314 #. type: =head1
3315 #: ../src/guestfs.pod:1493
3316 msgid "STRUCTURES"
3317 msgstr ""
3318
3319 # type: textblock
3320 #. type: textblock
3321 #: ../src/guestfs.pod:1495
3322 msgid "@STRUCTS@"
3323 msgstr ""
3324
3325 # type: =head1
3326 #. type: =head1
3327 #: ../src/guestfs.pod:1497
3328 msgid "AVAILABILITY"
3329 msgstr ""
3330
3331 # type: =head2
3332 #. type: =head2
3333 #: ../src/guestfs.pod:1499
3334 msgid "GROUPS OF FUNCTIONALITY IN THE APPLIANCE"
3335 msgstr ""
3336
3337 # type: textblock
3338 #. type: textblock
3339 #: ../src/guestfs.pod:1501
3340 msgid ""
3341 "Using L</guestfs_available> you can test availability of the following "
3342 "groups of functions.  This test queries the appliance to see if the "
3343 "appliance you are currently using supports the functionality."
3344 msgstr ""
3345
3346 # type: textblock
3347 #. type: textblock
3348 #: ../src/guestfs.pod:1506
3349 msgid "@AVAILABILITY@"
3350 msgstr ""
3351
3352 # type: =head2
3353 #. type: =head2
3354 #: ../src/guestfs.pod:1508
3355 msgid "GUESTFISH supported COMMAND"
3356 msgstr ""
3357
3358 # type: textblock
3359 #. type: textblock
3360 #: ../src/guestfs.pod:1510
3361 msgid ""
3362 "In L<guestfish(3)> there is a handy interactive command C<supported> which "
3363 "prints out the available groups and whether they are supported by this build "
3364 "of libguestfs.  Note however that you have to do C<run> first."
3365 msgstr ""
3366
3367 # type: =head2
3368 #. type: =head2
3369 #: ../src/guestfs.pod:1515
3370 msgid "SINGLE CALLS AT COMPILE TIME"
3371 msgstr ""
3372
3373 # type: textblock
3374 #. type: textblock
3375 #: ../src/guestfs.pod:1517
3376 msgid ""
3377 "Since version 1.5.8, C<E<lt>guestfs.hE<gt>> defines symbols for each C API "
3378 "function, such as:"
3379 msgstr ""
3380
3381 # type: verbatim
3382 #. type: verbatim
3383 #: ../src/guestfs.pod:1520
3384 #, no-wrap
3385 msgid ""
3386 " #define LIBGUESTFS_HAVE_DD 1\n"
3387 "\n"
3388 msgstr ""
3389
3390 # type: textblock
3391 #. type: textblock
3392 #: ../src/guestfs.pod:1522
3393 msgid "if L</guestfs_dd> is available."
3394 msgstr ""
3395
3396 # type: textblock
3397 #. type: textblock
3398 #: ../src/guestfs.pod:1524
3399 msgid ""
3400 "Before version 1.5.8, if you needed to test whether a single libguestfs "
3401 "function is available at compile time, we recommended using build tools such "
3402 "as autoconf or cmake.  For example in autotools you could use:"
3403 msgstr ""
3404
3405 # type: verbatim
3406 #. type: verbatim
3407 #: ../src/guestfs.pod:1529
3408 #, no-wrap
3409 msgid ""
3410 " AC_CHECK_LIB([guestfs],[guestfs_create])\n"
3411 " AC_CHECK_FUNCS([guestfs_dd])\n"
3412 "\n"
3413 msgstr ""
3414
3415 # type: textblock
3416 #. type: textblock
3417 #: ../src/guestfs.pod:1532
3418 msgid ""
3419 "which would result in C<HAVE_GUESTFS_DD> being either defined or not defined "
3420 "in your program."
3421 msgstr ""
3422
3423 # type: =head2
3424 #. type: =head2
3425 #: ../src/guestfs.pod:1535
3426 msgid "SINGLE CALLS AT RUN TIME"
3427 msgstr ""
3428
3429 # type: textblock
3430 #. type: textblock
3431 #: ../src/guestfs.pod:1537
3432 msgid ""
3433 "Testing at compile time doesn't guarantee that a function really exists in "
3434 "the library.  The reason is that you might be dynamically linked against a "
3435 "previous I<libguestfs.so> (dynamic library)  which doesn't have the call.  "
3436 "This situation unfortunately results in a segmentation fault, which is a "
3437 "shortcoming of the C dynamic linking system itself."
3438 msgstr ""
3439
3440 # type: textblock
3441 #. type: textblock
3442 #: ../src/guestfs.pod:1544
3443 msgid ""
3444 "You can use L<dlopen(3)> to test if a function is available at run time, as "
3445 "in this example program (note that you still need the compile time check as "
3446 "well):"
3447 msgstr ""
3448
3449 # type: verbatim
3450 #. type: verbatim
3451 #: ../src/guestfs.pod:1548
3452 #, no-wrap
3453 msgid ""
3454 " #include <stdio.h>\n"
3455 " #include <stdlib.h>\n"
3456 " #include <unistd.h>\n"
3457 " #include <dlfcn.h>\n"
3458 " #include <guestfs.h>\n"
3459 " \n"
3460 msgstr ""
3461
3462 # type: verbatim
3463 #. type: verbatim
3464 #: ../src/guestfs.pod:1554
3465 #, no-wrap
3466 msgid ""
3467 " main ()\n"
3468 " {\n"
3469 " #ifdef LIBGUESTFS_HAVE_DD\n"
3470 "   void *dl;\n"
3471 "   int has_function;\n"
3472 " \n"
3473 msgstr ""
3474
3475 # type: verbatim
3476 #. type: verbatim
3477 #: ../src/guestfs.pod:1560
3478 #, no-wrap
3479 msgid ""
3480 "   /* Test if the function guestfs_dd is really available. */\n"
3481 "   dl = dlopen (NULL, RTLD_LAZY);\n"
3482 "   if (!dl) {\n"
3483 "     fprintf (stderr, \"dlopen: %s\\n\", dlerror ());\n"
3484 "     exit (EXIT_FAILURE);\n"
3485 "   }\n"
3486 "   has_function = dlsym (dl, \"guestfs_dd\") != NULL;\n"
3487 "   dlclose (dl);\n"
3488 " \n"
3489 msgstr ""
3490
3491 # type: verbatim
3492 #. type: verbatim
3493 #: ../src/guestfs.pod:1569
3494 #, no-wrap
3495 msgid ""
3496 "   if (!has_function)\n"
3497 "     printf (\"this libguestfs.so does NOT have guestfs_dd function\\n\");\n"
3498 "   else {\n"
3499 "     printf (\"this libguestfs.so has guestfs_dd function\\n\");\n"
3500 "     /* Now it's safe to call\n"
3501 "     guestfs_dd (g, \"foo\", \"bar\");\n"
3502 "     */\n"
3503 "   }\n"
3504 " #else\n"
3505 "   printf (\"guestfs_dd function was not found at compile time\\n\");\n"
3506 " #endif\n"
3507 "  }\n"
3508 "\n"
3509 msgstr ""
3510
3511 # type: textblock
3512 #. type: textblock
3513 #: ../src/guestfs.pod:1582
3514 msgid ""
3515 "You may think the above is an awful lot of hassle, and it is.  There are "
3516 "other ways outside of the C linking system to ensure that this kind of "
3517 "incompatibility never arises, such as using package versioning:"
3518 msgstr ""
3519
3520 # type: verbatim
3521 #. type: verbatim
3522 #: ../src/guestfs.pod:1587
3523 #, no-wrap
3524 msgid ""
3525 " Requires: libguestfs >= 1.0.80\n"
3526 "\n"
3527 msgstr ""
3528
3529 # type: =head1
3530 #. type: =head1
3531 #: ../src/guestfs.pod:1589
3532 msgid "CALLS WITH OPTIONAL ARGUMENTS"
3533 msgstr ""
3534
3535 # type: textblock
3536 #. type: textblock
3537 #: ../src/guestfs.pod:1591
3538 msgid ""
3539 "A recent feature of the API is the introduction of calls which take optional "
3540 "arguments.  In C these are declared 3 ways.  The main way is as a call which "
3541 "takes variable arguments (ie. C<...>), as in this example:"
3542 msgstr ""
3543
3544 # type: verbatim
3545 #. type: verbatim
3546 #: ../src/guestfs.pod:1596
3547 #, no-wrap
3548 msgid ""
3549 " int guestfs_add_drive_opts (guestfs_h *g, const char *filename, ...);\n"
3550 "\n"
3551 msgstr ""
3552
3553 # type: textblock
3554 #. type: textblock
3555 #: ../src/guestfs.pod:1598
3556 msgid ""
3557 "Call this with a list of optional arguments, terminated by C<-1>.  So to "
3558 "call with no optional arguments specified:"
3559 msgstr ""
3560
3561 # type: verbatim
3562 #. type: verbatim
3563 #: ../src/guestfs.pod:1601
3564 #, no-wrap
3565 msgid ""
3566 " guestfs_add_drive_opts (g, filename, -1);\n"
3567 "\n"
3568 msgstr ""
3569
3570 # type: textblock
3571 #. type: textblock
3572 #: ../src/guestfs.pod:1603
3573 msgid "With a single optional argument:"
3574 msgstr ""
3575
3576 # type: verbatim
3577 #. type: verbatim
3578 #: ../src/guestfs.pod:1605
3579 #, no-wrap
3580 msgid ""
3581 " guestfs_add_drive_opts (g, filename,\n"
3582 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"qcow2\",\n"
3583 "                         -1);\n"
3584 "\n"
3585 msgstr ""
3586
3587 # type: textblock
3588 #. type: textblock
3589 #: ../src/guestfs.pod:1609
3590 msgid "With two:"
3591 msgstr ""
3592
3593 # type: verbatim
3594 #. type: verbatim
3595 #: ../src/guestfs.pod:1611
3596 #, no-wrap
3597 msgid ""
3598 " guestfs_add_drive_opts (g, filename,\n"
3599 "                         GUESTFS_ADD_DRIVE_OPTS_FORMAT, \"qcow2\",\n"
3600 "                         GUESTFS_ADD_DRIVE_OPTS_READONLY, 1,\n"
3601 "                         -1);\n"
3602 "\n"
3603 msgstr ""
3604
3605 # type: textblock
3606 #. type: textblock
3607 #: ../src/guestfs.pod:1616
3608 msgid ""
3609 "and so forth.  Don't forget the terminating C<-1> otherwise Bad Things will "
3610 "happen!"
3611 msgstr ""
3612
3613 # type: =head2
3614 #. type: =head2
3615 #: ../src/guestfs.pod:1619
3616 msgid "USING va_list FOR OPTIONAL ARGUMENTS"
3617 msgstr ""
3618
3619 # type: textblock
3620 #. type: textblock
3621 #: ../src/guestfs.pod:1621
3622 msgid ""
3623 "The second variant has the same name with the suffix C<_va>, which works the "
3624 "same way but takes a C<va_list>.  See the C manual for details.  For the "
3625 "example function, this is declared:"
3626 msgstr ""
3627
3628 # type: verbatim
3629 #. type: verbatim
3630 #: ../src/guestfs.pod:1625
3631 #, no-wrap
3632 msgid ""
3633 " int guestfs_add_drive_opts_va (guestfs_h *g, const char *filename,\n"
3634 "                                va_list args);\n"
3635 "\n"
3636 msgstr ""
3637
3638 # type: =head2
3639 #. type: =head2
3640 #: ../src/guestfs.pod:1628
3641 msgid "CONSTRUCTING OPTIONAL ARGUMENTS"
3642 msgstr ""
3643
3644 # type: textblock
3645 #. type: textblock
3646 #: ../src/guestfs.pod:1630
3647 msgid ""
3648 "The third variant is useful where you need to construct these calls.  You "
3649 "pass in a structure where you fill in the optional fields.  The structure "
3650 "has a bitmask as the first element which you must set to indicate which "
3651 "fields you have filled in.  For our example function the structure and call "
3652 "are declared:"
3653 msgstr ""
3654
3655 # type: verbatim
3656 #. type: verbatim
3657 #: ../src/guestfs.pod:1636
3658 #, no-wrap
3659 msgid ""
3660 " struct guestfs_add_drive_opts_argv {\n"
3661 "   uint64_t bitmask;\n"
3662 "   int readonly;\n"
3663 "   const char *format;\n"
3664 "   /* ... */\n"
3665 " };\n"
3666 " int guestfs_add_drive_opts_argv (guestfs_h *g, const char *filename,\n"
3667 "              const struct guestfs_add_drive_opts_argv *optargs);\n"
3668 "\n"
3669 msgstr ""
3670
3671 # type: textblock
3672 #. type: textblock
3673 #: ../src/guestfs.pod:1645
3674 msgid "You could call it like this:"
3675 msgstr ""
3676
3677 # type: verbatim
3678 #. type: verbatim
3679 #: ../src/guestfs.pod:1647
3680 #, no-wrap
3681 msgid ""
3682 " struct guestfs_add_drive_opts_argv optargs = {\n"
3683 "   .bitmask = GUESTFS_ADD_DRIVE_OPTS_READONLY_BITMASK |\n"
3684 "              GUESTFS_ADD_DRIVE_OPTS_FORMAT_BITMASK,\n"
3685 "   .readonly = 1,\n"
3686 "   .format = \"qcow2\"\n"
3687 " };\n"
3688 " \n"
3689 msgstr ""
3690
3691 # type: verbatim
3692 #. type: verbatim
3693 #: ../src/guestfs.pod:1654
3694 #, no-wrap
3695 msgid ""
3696 " guestfs_add_drive_opts_argv (g, filename, &optargs);\n"
3697 "\n"
3698 msgstr ""
3699
3700 # type: textblock
3701 #. type: textblock
3702 #: ../src/guestfs.pod:1656 ../src/guestfs-actions.pod:11
3703 #: ../src/guestfs-actions.pod:1850 ../fish/guestfish-actions.pod:9
3704 #: ../fish/guestfish-actions.pod:1260 ../tools/virt-win-reg.pl:532
3705 msgid "Notes:"
3706 msgstr ""
3707
3708 # type: textblock
3709 #. type: textblock
3710 #: ../src/guestfs.pod:1662
3711 msgid "The C<_BITMASK> suffix on each option name when specifying the bitmask."
3712 msgstr ""
3713
3714 # type: textblock
3715 #. type: textblock
3716 #: ../src/guestfs.pod:1667
3717 msgid "You do not need to fill in all fields of the structure."
3718 msgstr ""
3719
3720 # type: textblock
3721 #. type: textblock
3722 #: ../src/guestfs.pod:1671
3723 msgid ""
3724 "There must be a one-to-one correspondence between fields of the structure "
3725 "that are filled in, and bits set in the bitmask."
3726 msgstr ""
3727
3728 # type: =head2
3729 #. type: =head2
3730 #: ../src/guestfs.pod:1676
3731 msgid "OPTIONAL ARGUMENTS IN OTHER LANGUAGES"
3732 msgstr ""
3733
3734 # type: textblock
3735 #. type: textblock
3736 #: ../src/guestfs.pod:1678
3737 msgid ""
3738 "In other languages, optional arguments are expressed in the way that is "
3739 "natural for that language.  We refer you to the language-specific "
3740 "documentation for more details on that."
3741 msgstr ""
3742
3743 # type: textblock
3744 #. type: textblock
3745 #: ../src/guestfs.pod:1682
3746 msgid "For guestfish, see L<guestfish(1)/OPTIONAL ARGUMENTS>."
3747 msgstr ""
3748
3749 # type: =head2
3750 #. type: =head2
3751 #: ../src/guestfs.pod:1684
3752 msgid "SETTING CALLBACKS TO HANDLE EVENTS"
3753 msgstr ""
3754
3755 #. type: textblock
3756 #: ../src/guestfs.pod:1686
3757 msgid ""
3758 "B<Note:> This section documents the generic event mechanism introduced in "
3759 "libguestfs 1.10, which you should use in new code if possible.  The old "
3760 "functions C<guestfs_set_log_message_callback>, "
3761 "C<guestfs_set_subprocess_quit_callback>, "
3762 "C<guestfs_set_launch_done_callback>, C<guestfs_set_close_callback> and "
3763 "C<guestfs_set_progress_callback> are no longer documented in this manual "
3764 "page."
3765 msgstr ""
3766
3767 #. type: textblock
3768 #: ../src/guestfs.pod:1694
3769 msgid ""
3770 "Handles generate events when certain things happen, such as log messages "
3771 "being generated, progress messages during long-running operations, or the "
3772 "handle being closed.  The API calls described below let you register a "
3773 "callback to be called when events happen.  You can register multiple "
3774 "callbacks (for the same, different or overlapping sets of events), and "
3775 "individually remove callbacks.  If callbacks are not removed, then they "
3776 "remain in force until the handle is closed."
3777 msgstr ""
3778
3779 #. type: textblock
3780 #: ../src/guestfs.pod:1702
3781 msgid ""
3782 "In the current implementation, events are only generated synchronously: that "
3783 "means that events (and hence callbacks) can only happen while you are in the "
3784 "middle of making another libguestfs call.  The callback is called in the "
3785 "same thread."
3786 msgstr ""
3787
3788 #. type: textblock
3789 #: ../src/guestfs.pod:1707
3790 msgid ""
3791 "Events may contain a payload, usually nothing (void), an array of 64 bit "
3792 "unsigned integers, or a message buffer.  Payloads are discussed later on."
3793 msgstr ""
3794
3795 #. type: =head3
3796 #: ../src/guestfs.pod:1711
3797 msgid "CLASSES OF EVENTS"
3798 msgstr ""
3799
3800 #. type: =item
3801 #: ../src/guestfs.pod:1715
3802 msgid "GUESTFS_EVENT_CLOSE (payload type: void)"
3803 msgstr ""
3804
3805 #. type: textblock
3806 #: ../src/guestfs.pod:1718
3807 msgid ""
3808 "The callback function will be called while the handle is being closed "
3809 "(synchronously from L</guestfs_close>)."
3810 msgstr ""
3811
3812 # type: textblock
3813 #. type: textblock
3814 #: ../src/guestfs.pod:1721
3815 msgid ""
3816 "Note that libguestfs installs an L<atexit(3)> handler to try to clean up "
3817 "handles that are open when the program exits.  This means that this callback "
3818 "might be called indirectly from L<exit(3)>, which can cause unexpected "
3819 "problems in higher-level languages (eg. if your HLL interpreter has already "
3820 "been cleaned up by the time this is called, and if your callback then jumps "
3821 "into some HLL function)."
3822 msgstr ""
3823
3824 #. type: textblock
3825 #: ../src/guestfs.pod:1728
3826 msgid ""
3827 "If no callback is registered: the handle is closed without any callback "
3828 "being invoked."
3829 msgstr ""
3830
3831 #. type: =item
3832 #: ../src/guestfs.pod:1731
3833 msgid "GUESTFS_EVENT_SUBPROCESS_QUIT (payload type: void)"
3834 msgstr ""
3835
3836 #. type: textblock
3837 #: ../src/guestfs.pod:1734
3838 msgid ""
3839 "The callback function will be called when the child process quits, either "
3840 "asynchronously or if killed by L</guestfs_kill_subprocess>.  (This "
3841 "corresponds to a transition from any state to the CONFIG state)."
3842 msgstr ""
3843
3844 #. type: textblock
3845 #: ../src/guestfs.pod:1738 ../src/guestfs.pod:1747
3846 msgid "If no callback is registered: the event is ignored."
3847 msgstr ""
3848
3849 #. type: =item
3850 #: ../src/guestfs.pod:1740
3851 msgid "GUESTFS_EVENT_LAUNCH_DONE (payload type: void)"
3852 msgstr ""
3853
3854 #. type: textblock
3855 #: ../src/guestfs.pod:1743
3856 msgid ""
3857 "The callback function will be called when the child process becomes ready "
3858 "first time after it has been launched.  (This corresponds to a transition "
3859 "from LAUNCHING to the READY state)."
3860 msgstr ""
3861
3862 #. type: =item
3863 #: ../src/guestfs.pod:1749
3864 msgid "GUESTFS_EVENT_PROGRESS (payload type: array of 4 x uint64_t)"
3865 msgstr ""
3866
3867 # type: textblock
3868 #. type: textblock
3869 #: ../src/guestfs.pod:1752
3870 msgid ""
3871 "Some long-running operations can generate progress messages.  If this "
3872 "callback is registered, then it will be called each time a progress message "
3873 "is generated (usually two seconds after the operation started, and three "
3874 "times per second thereafter until it completes, although the frequency may "
3875 "change in future versions)."
3876 msgstr ""
3877
3878 #. type: textblock
3879 #: ../src/guestfs.pod:1758
3880 msgid ""
3881 "The callback receives in the payload four unsigned 64 bit numbers which are "
3882 "(in order): C<proc_nr>, C<serial>, C<position>, C<total>."
3883 msgstr ""
3884
3885 #. type: textblock
3886 #: ../src/guestfs.pod:1761
3887 msgid ""
3888 "The units of C<total> are not defined, although for some operations C<total> "
3889 "may relate in some way to the amount of data to be transferred (eg. in bytes "
3890 "or megabytes), and C<position> may be the portion which has been transferred."
3891 msgstr ""
3892
3893 # type: textblock
3894 #. type: textblock
3895 #: ../src/guestfs.pod:1766
3896 msgid "The only defined and stable parts of the API are:"
3897 msgstr ""
3898
3899 # type: textblock
3900 #. type: textblock
3901 #: ../src/guestfs.pod:1772
3902 msgid ""
3903 "The callback can display to the user some type of progress bar or indicator "
3904 "which shows the ratio of C<position>:C<total>."
3905 msgstr ""
3906
3907 # type: textblock
3908 #. type: textblock
3909 #: ../src/guestfs.pod:1777
3910 msgid "0 E<lt>= C<position> E<lt>= C<total>"
3911 msgstr ""
3912
3913 # type: textblock
3914 #. type: textblock
3915 #: ../src/guestfs.pod:1781
3916 msgid ""
3917 "If any progress notification is sent during a call, then a final progress "
3918 "notification is always sent when C<position> = C<total>."
3919 msgstr ""
3920
3921 # type: textblock
3922 #. type: textblock
3923 #: ../src/guestfs.pod:1784
3924 msgid ""
3925 "This is to simplify caller code, so callers can easily set the progress "
3926 "indicator to \"100%\" at the end of the operation, without requiring special "
3927 "code to detect this case."
3928 msgstr ""
3929
3930 #. type: textblock
3931 #: ../src/guestfs.pod:1790
3932 msgid ""
3933 "The callback also receives the procedure number (C<proc_nr>) and serial "
3934 "number (C<serial>) of the call.  These are only useful for debugging "
3935 "protocol issues, and the callback can normally ignore them.  The callback "
3936 "may want to print these numbers in error messages or debugging messages."
3937 msgstr ""
3938
3939 #. type: textblock
3940 #: ../src/guestfs.pod:1796
3941 msgid "If no callback is registered: progress messages are discarded."
3942 msgstr ""
3943
3944 #. type: =item
3945 #: ../src/guestfs.pod:1798
3946 msgid "GUESTFS_EVENT_APPLIANCE (payload type: message buffer)"
3947 msgstr ""
3948
3949 #. type: textblock
3950 #: ../src/guestfs.pod:1801
3951 msgid ""
3952 "The callback function is called whenever a log message is generated by qemu, "
3953 "the appliance kernel, guestfsd (daemon), or utility programs."
3954 msgstr ""
3955
3956 #. type: textblock
3957 #: ../src/guestfs.pod:1804
3958 msgid ""
3959 "If the verbose flag (L</guestfs_set_verbose>) is set before launch (L</"
3960 "guestfs_launch>) then additional debug messages are generated."
3961 msgstr ""
3962
3963 #. type: textblock
3964 #: ../src/guestfs.pod:1807 ../src/guestfs.pod:1821
3965 msgid ""
3966 "If no callback is registered: the messages are discarded unless the verbose "
3967 "flag is set in which case they are sent to stderr.  You can override the "
3968 "printing of verbose messages to stderr by setting up a callback."
3969 msgstr ""
3970
3971 #. type: =item
3972 #: ../src/guestfs.pod:1812
3973 msgid "GUESTFS_EVENT_LIBRARY (payload type: message buffer)"
3974 msgstr ""
3975
3976 #. type: textblock
3977 #: ../src/guestfs.pod:1815
3978 msgid ""
3979 "The callback function is called whenever a log message is generated by the "
3980 "library part of libguestfs."
3981 msgstr ""
3982
3983 #. type: textblock
3984 #: ../src/guestfs.pod:1818
3985 msgid ""
3986 "If the verbose flag (L</guestfs_set_verbose>) is set then additional debug "
3987 "messages are generated."
3988 msgstr ""
3989
3990 #. type: =item
3991 #: ../src/guestfs.pod:1826
3992 msgid "GUESTFS_EVENT_TRACE (payload type: message buffer)"
3993 msgstr ""
3994
3995 #. type: textblock
3996 #: ../src/guestfs.pod:1829
3997 msgid ""
3998 "The callback function is called whenever a trace message is generated.  This "
3999 "only applies if the trace flag (L</guestfs_set_trace>) is set."
4000 msgstr ""
4001
4002 #. type: textblock
4003 #: ../src/guestfs.pod:1832
4004 msgid ""
4005 "If no callback is registered: the messages are sent to stderr.  You can "
4006 "override the printing of trace messages to stderr by setting up a callback."
4007 msgstr ""
4008
4009 #. type: =head3
4010 #: ../src/guestfs.pod:1838
4011 msgid "guestfs_set_event_callback"
4012 msgstr ""
4013
4014 #. type: verbatim
4015 #: ../src/guestfs.pod:1840
4016 #, no-wrap
4017 msgid ""
4018 " int guestfs_set_event_callback (guestfs_h *g,\n"
4019 "                                 guestfs_event_callback cb,\n"
4020 "                                 uint64_t event_bitmask,\n"
4021 "                                 int flags,\n"
4022 "                                 void *opaque);\n"
4023 "\n"
4024 msgstr ""
4025
4026 #. type: textblock
4027 #: ../src/guestfs.pod:1846
4028 msgid ""
4029 "This function registers a callback (C<cb>) for all event classes in the "
4030 "C<event_bitmask>."
4031 msgstr ""
4032
4033 #. type: textblock
4034 #: ../src/guestfs.pod:1849
4035 msgid ""
4036 "For example, to register for all log message events, you could call this "
4037 "function with the bitmask C<GUESTFS_EVENT_APPLIANCE|GUESTFS_EVENT_LIBRARY>.  "
4038 "To register a single callback for all possible classes of events, use "
4039 "C<GUESTFS_EVENT_ALL>."
4040 msgstr ""
4041
4042 #. type: textblock
4043 #: ../src/guestfs.pod:1855
4044 msgid "C<flags> should always be passed as 0."
4045 msgstr ""
4046
4047 #. type: textblock
4048 #: ../src/guestfs.pod:1857
4049 msgid ""
4050 "C<opaque> is an opaque pointer which is passed to the callback.  You can use "
4051 "it for any purpose."
4052 msgstr ""
4053
4054 #. type: textblock
4055 #: ../src/guestfs.pod:1860
4056 msgid ""
4057 "The return value is the event handle (an integer) which you can use to "
4058 "delete the callback (see below)."
4059 msgstr ""
4060
4061 #. type: textblock
4062 #: ../src/guestfs.pod:1863
4063 msgid ""
4064 "If there is an error, this function returns C<-1>, and sets the error in the "
4065 "handle in the usual way (see L</guestfs_last_error> etc.)"
4066 msgstr ""
4067
4068 #. type: textblock
4069 #: ../src/guestfs.pod:1866
4070 msgid ""
4071 "Callbacks remain in effect until they are deleted, or until the handle is "
4072 "closed."
4073 msgstr ""
4074
4075 #. type: textblock
4076 #: ../src/guestfs.pod:1869
4077 msgid ""
4078 "In the case where multiple callbacks are registered for a particular event "
4079 "class, all of the callbacks are called.  The order in which multiple "
4080 "callbacks are called is not defined."
4081 msgstr ""
4082
4083 #. type: =head3
4084 #: ../src/guestfs.pod:1873
4085 msgid "guestfs_delete_event_callback"
4086 msgstr ""
4087
4088 #. type: verbatim
4089 #: ../src/guestfs.pod:1875
4090 #, no-wrap
4091 msgid ""
4092 " void guestfs_delete_event_callback (guestfs_h *g, int event_handle);\n"
4093 "\n"
4094 msgstr ""
4095
4096 #. type: textblock
4097 #: ../src/guestfs.pod:1877
4098 msgid ""
4099 "Delete a callback that was previously registered.  C<event_handle> should be "
4100 "the integer that was returned by a previous call to "
4101 "C<guestfs_set_event_callback> on the same handle."
4102 msgstr ""
4103
4104 #. type: =head3
4105 #: ../src/guestfs.pod:1881
4106 msgid "guestfs_event_callback"
4107 msgstr ""
4108
4109 #. type: verbatim
4110 #: ../src/guestfs.pod:1883
4111 #, no-wrap
4112 msgid ""
4113 " typedef void (*guestfs_event_callback) (\n"
4114 "                  guestfs_h *g,\n"
4115 "                  void *opaque,\n"
4116 "                  uint64_t event,\n"
4117 "                  int event_handle,\n"
4118 "                  int flags,\n"
4119 "                  const char *buf, size_t buf_len,\n"
4120 "                  const uint64_t *array, size_t array_len);\n"
4121 "\n"
4122 msgstr ""
4123
4124 #. type: textblock
4125 #: ../src/guestfs.pod:1892
4126 msgid ""
4127 "This is the type of the event callback function that you have to provide."
4128 msgstr ""
4129
4130 #. type: textblock
4131 #: ../src/guestfs.pod:1895
4132 msgid ""
4133 "The basic parameters are: the handle (C<g>), the opaque user pointer "
4134 "(C<opaque>), the event class (eg. C<GUESTFS_EVENT_PROGRESS>), the event "
4135 "handle, and C<flags> which in the current API you should ignore."
4136 msgstr ""
4137
4138 #. type: textblock
4139 #: ../src/guestfs.pod:1899
4140 msgid ""
4141 "The remaining parameters contain the event payload (if any).  Each event may "
4142 "contain a payload, which usually relates to the event class, but for future "
4143 "proofing your code should be written to handle any payload for any event "
4144 "class."
4145 msgstr ""
4146
4147 #. type: textblock
4148 #: ../src/guestfs.pod:1904
4149 msgid ""
4150 "C<buf> and C<buf_len> contain a message buffer (if C<buf_len == 0>, then "
4151 "there is no message buffer).  Note that this message buffer can contain "
4152 "arbitrary 8 bit data, including NUL bytes."
4153 msgstr ""
4154
4155 #. type: textblock
4156 #: ../src/guestfs.pod:1908
4157 msgid ""
4158 "C<array> and C<array_len> is an array of 64 bit unsigned integers.  At the "
4159 "moment this is only used for progress messages."
4160 msgstr ""
4161
4162 #. type: =head3
4163 #: ../src/guestfs.pod:1911
4164 msgid "EXAMPLE: CAPTURING LOG MESSAGES"
4165 msgstr ""
4166
4167 #. type: textblock
4168 #: ../src/guestfs.pod:1913
4169 msgid ""
4170 "One motivation for the generic event API was to allow GUI programs to "
4171 "capture debug and other messages.  In libguestfs E<le> 1.8 these were sent "
4172 "unconditionally to C<stderr>."
4173 msgstr ""
4174
4175 #. type: textblock
4176 #: ../src/guestfs.pod:1917
4177 msgid ""
4178 "Events associated with log messages are: C<GUESTFS_EVENT_LIBRARY>, "
4179 "C<GUESTFS_EVENT_APPLIANCE> and C<GUESTFS_EVENT_TRACE>.  (Note that error "
4180 "messages are not events; you must capture error messages separately)."
4181 msgstr ""
4182
4183 #. type: textblock
4184 #: ../src/guestfs.pod:1922
4185 msgid ""
4186 "Programs have to set up a callback to capture the classes of events of "
4187 "interest:"
4188 msgstr ""
4189
4190 #. type: verbatim
4191 #: ../src/guestfs.pod:1925
4192 #, no-wrap
4193 msgid ""
4194 " int eh =\n"
4195 "   guestfs_set_event_callback\n"
4196 "     (g, message_callback,\n"
4197 "      GUESTFS_EVENT_LIBRARY|GUESTFS_EVENT_APPLIANCE|\n"
4198 "      GUESTFS_EVENT_TRACE,\n"
4199 "      0, NULL) == -1)\n"
4200 " if (eh == -1) {\n"
4201 "   // handle error in the usual way\n"
4202 " }\n"
4203 "\n"
4204 msgstr ""
4205
4206 #. type: textblock
4207 #: ../src/guestfs.pod:1935
4208 msgid ""
4209 "The callback can then direct messages to the appropriate place.  In this "
4210 "example, messages are directed to syslog:"
4211 msgstr ""
4212
4213 #. type: verbatim
4214 #: ../src/guestfs.pod:1938
4215 #, no-wrap
4216 msgid ""
4217 " static void\n"
4218 " message_callback (\n"
4219 "         guestfs_h *g,\n"
4220 "         void *opaque,\n"
4221 "         uint64_t event,\n"
4222 "         int event_handle,\n"
4223 "         int flags,\n"
4224 "         const char *buf, size_t buf_len,\n"
4225 "         const uint64_t *array, size_t array_len)\n"
4226 " {\n"
4227 "   const int priority = LOG_USER|LOG_INFO;\n"
4228 "   if (buf_len > 0)\n"
4229 "     syslog (priority, \"event 0x%lx: %s\", event, buf);\n"
4230 " }\n"
4231 "\n"
4232 msgstr ""
4233
4234 # type: =head1
4235 #. type: =head1
4236 #: ../src/guestfs.pod:1953
4237 msgid "PRIVATE DATA AREA"
4238 msgstr ""
4239
4240 #. type: textblock
4241 #: ../src/guestfs.pod:1955
4242 msgid ""
4243 "You can attach named pieces of private data to the libguestfs handle, fetch "
4244 "them by name, and walk over them, for the lifetime of the handle.  This is "
4245 "called the private data area and is only available from the C API."
4246 msgstr ""
4247
4248 # type: textblock
4249 #. type: textblock
4250 #: ../src/guestfs.pod:1960
4251 msgid "To attach a named piece of data, use the following call:"
4252 msgstr ""
4253
4254 # type: verbatim
4255 #. type: verbatim
4256 #: ../src/guestfs.pod:1962
4257 #, no-wrap
4258 msgid ""
4259 " void guestfs_set_private (guestfs_h *g, const char *key, void *data);\n"
4260 "\n"
4261 msgstr ""
4262
4263 # type: textblock
4264 #. type: textblock
4265 #: ../src/guestfs.pod:1964
4266 msgid ""
4267 "C<key> is the name to associate with this data, and C<data> is an arbitrary "
4268 "pointer (which can be C<NULL>).  Any previous item with the same name is "
4269 "overwritten."
4270 msgstr ""
4271
4272 # type: textblock
4273 #. type: textblock
4274 #: ../src/guestfs.pod:1968
4275 msgid ""
4276 "You can use any C<key> you want, but names beginning with an underscore "
4277 "character are reserved for internal libguestfs purposes (for implementing "
4278 "language bindings).  It is recommended to prefix the name with some unique "
4279 "string to avoid collisions with other users."
4280 msgstr ""
4281
4282 # type: textblock
4283 #. type: textblock
4284 #: ../src/guestfs.pod:1973
4285 msgid "To retrieve the pointer, use:"
4286 msgstr ""
4287
4288 # type: verbatim
4289 #. type: verbatim
4290 #: ../src/guestfs.pod:1975
4291 #, no-wrap
4292 msgid ""
4293 " void *guestfs_get_private (guestfs_h *g, const char *key);\n"
4294 "\n"
4295 msgstr ""
4296
4297 # type: textblock
4298 #. type: textblock
4299 #: ../src/guestfs.pod:1977
4300 msgid ""
4301 "This function returns C<NULL> if either no data is found associated with "
4302 "C<key>, or if the user previously set the C<key>'s C<data> pointer to "
4303 "C<NULL>."
4304 msgstr ""
4305
4306 #. type: textblock
4307 #: ../src/guestfs.pod:1981
4308 msgid ""
4309 "Libguestfs does not try to look at or interpret the C<data> pointer in any "
4310 "way.  As far as libguestfs is concerned, it need not be a valid pointer at "
4311 "all.  In particular, libguestfs does I<not> try to free the data when the "
4312 "handle is closed.  If the data must be freed, then the caller must either "
4313 "free it before calling L</guestfs_close> or must set up a close callback to "
4314 "do it (see L</GUESTFS_EVENT_CLOSE>)."
4315 msgstr ""
4316
4317 #. type: textblock
4318 #: ../src/guestfs.pod:1988
4319 msgid "To walk over all entries, use these two functions:"
4320 msgstr ""
4321
4322 #. type: verbatim
4323 #: ../src/guestfs.pod:1990
4324 #, no-wrap
4325 msgid ""
4326 " void *guestfs_first_private (guestfs_h *g, const char **key_rtn);\n"
4327 "\n"
4328 msgstr ""
4329
4330 #. type: verbatim
4331 #: ../src/guestfs.pod:1992
4332 #, no-wrap
4333 msgid ""
4334 " void *guestfs_next_private (guestfs_h *g, const char **key_rtn);\n"
4335 "\n"
4336 msgstr ""
4337
4338 #. type: textblock
4339 #: ../src/guestfs.pod:1994
4340 msgid ""
4341 "C<guestfs_first_private> returns the first key, pointer pair (\"first\" does "
4342 "not have any particular meaning -- keys are not returned in any defined "
4343 "order).  A pointer to the key is returned in C<*key_rtn> and the "
4344 "corresponding data pointer is returned from the function.  C<NULL> is "
4345 "returned if there are no keys stored in the handle."
4346 msgstr ""
4347
4348 #. type: textblock
4349 #: ../src/guestfs.pod:2000
4350 msgid ""
4351 "C<guestfs_next_private> returns the next key, pointer pair.  The return "
4352 "value of this function is also C<NULL> is there are no further entries to "
4353 "return."
4354 msgstr ""
4355
4356 #. type: textblock
4357 #: ../src/guestfs.pod:2004
4358 msgid "Notes about walking over entries:"
4359 msgstr ""
4360
4361 #. type: textblock
4362 #: ../src/guestfs.pod:2010
4363 msgid ""
4364 "You must not call C<guestfs_set_private> while walking over the entries."
4365 msgstr ""
4366
4367 #. type: textblock
4368 #: ../src/guestfs.pod:2015
4369 msgid ""
4370 "The handle maintains an internal iterator which is reset when you call "
4371 "C<guestfs_first_private>.  This internal iterator is invalidated when you "
4372 "call C<guestfs_set_private>."
4373 msgstr ""
4374
4375 #. type: textblock
4376 #: ../src/guestfs.pod:2021
4377 msgid "If you have set the data pointer associated with a key to C<NULL>, ie:"
4378 msgstr ""
4379
4380 #. type: verbatim
4381 #: ../src/guestfs.pod:2023
4382 #, no-wrap
4383 msgid ""
4384 " guestfs_set_private (g, key, NULL);\n"
4385 "\n"
4386 msgstr ""
4387
4388 #. type: textblock
4389 #: ../src/guestfs.pod:2025
4390 msgid "then that C<key> is not returned when walking."
4391 msgstr ""
4392
4393 #. type: textblock
4394 #: ../src/guestfs.pod:2029
4395 msgid ""
4396 "C<*key_rtn> is only valid until the next call to C<guestfs_first_private>, "
4397 "C<guestfs_next_private> or C<guestfs_set_private>."
4398 msgstr ""
4399
4400 #. type: textblock
4401 #: ../src/guestfs.pod:2035
4402 msgid ""
4403 "The following example code shows how to print all keys and data pointers "
4404 "that are associated with the handle C<g>:"
4405 msgstr ""
4406
4407 #. type: verbatim
4408 #: ../src/guestfs.pod:2038
4409 #, no-wrap
4410 msgid ""
4411 " const char *key;\n"
4412 " void *data = guestfs_first_private (g, &key);\n"
4413 " while (data != NULL)\n"
4414 "   {\n"
4415 "     printf (\"key = %s, data = %p\\n\", key, data);\n"
4416 "     data = guestfs_next_private (g, &key);\n"
4417 "   }\n"
4418 "\n"
4419 msgstr ""
4420
4421 #. type: textblock
4422 #: ../src/guestfs.pod:2046
4423 msgid ""
4424 "More commonly you are only interested in keys that begin with an application-"
4425 "specific prefix C<foo_>.  Modify the loop like so:"
4426 msgstr ""
4427
4428 #. type: verbatim
4429 #: ../src/guestfs.pod:2049
4430 #, no-wrap
4431 msgid ""
4432 " const char *key;\n"
4433 " void *data = guestfs_first_private (g, &key);\n"
4434 " while (data != NULL)\n"
4435 "   {\n"
4436 "     if (strncmp (key, \"foo_\", strlen (\"foo_\")) == 0)\n"
4437 "       printf (\"key = %s, data = %p\\n\", key, data);\n"
4438 "     data = guestfs_next_private (g, &key);\n"
4439 "   }\n"
4440 "\n"
4441 msgstr ""
4442
4443 #. type: textblock
4444 #: ../src/guestfs.pod:2058
4445 msgid ""
4446 "If you need to modify keys while walking, then you have to jump back to the "
4447 "beginning of the loop.  For example, to delete all keys prefixed with "
4448 "C<foo_>:"
4449 msgstr ""
4450
4451 #. type: verbatim
4452 #: ../src/guestfs.pod:2062
4453 #, no-wrap
4454 msgid ""
4455 "  const char *key;\n"
4456 "  void *data;\n"
4457 " again:\n"
4458 "  data = guestfs_first_private (g, &key);\n"
4459 "  while (data != NULL)\n"
4460 "    {\n"
4461 "      if (strncmp (key, \"foo_\", strlen (\"foo_\")) == 0)\n"
4462 "        {\n"
4463 "          guestfs_set_private (g, key, NULL);\n"
4464 "          /* note that 'key' pointer is now invalid, and so is\n"
4465 "             the internal iterator */\n"
4466 "          goto again;\n"
4467 "        }\n"
4468 "      data = guestfs_next_private (g, &key);\n"
4469 "    }\n"
4470 "\n"
4471 msgstr ""
4472
4473 #. type: textblock
4474 #: ../src/guestfs.pod:2078
4475 msgid ""
4476 "Note that the above loop is guaranteed to terminate because the keys are "
4477 "being deleted, but other manipulations of keys within the loop might not "
4478 "terminate unless you also maintain an indication of which keys have been "
4479 "visited."
4480 msgstr ""
4481
4482 # type: =end
4483 #. type: =end
4484 #: ../src/guestfs.pod:2083 ../src/guestfs.pod:2088
4485 msgid "html"
4486 msgstr ""
4487
4488 # type: textblock
4489 #. type: textblock
4490 #: ../src/guestfs.pod:2085
4491 msgid ""
4492 "<!-- old anchor for the next section --> <a name="
4493 "\"state_machine_and_low_level_event_api\"/>"
4494 msgstr ""
4495
4496 # type: =head1
4497 #. type: =head1
4498 #: ../src/guestfs.pod:2090
4499 msgid "ARCHITECTURE"
4500 msgstr ""
4501
4502 # type: textblock
4503 #. type: textblock
4504 #: ../src/guestfs.pod:2092
4505 msgid ""
4506 "Internally, libguestfs is implemented by running an appliance (a special "
4507 "type of small virtual machine) using L<qemu(1)>.  Qemu runs as a child "
4508 "process of the main program."
4509 msgstr ""
4510
4511 # type: verbatim
4512 #. type: verbatim
4513 #: ../src/guestfs.pod:2096
4514 #, no-wrap
4515 msgid ""
4516 "  ___________________\n"
4517 " /                   \\\n"
4518 " | main program      |\n"
4519 " |                   |\n"
4520 " |                   |           child process / appliance\n"
4521 " |                   |           __________________________\n"
4522 " |                   |          / qemu                     \\\n"
4523 " +-------------------+   RPC    |      +-----------------+ |\n"
4524 " | libguestfs     <--------------------> guestfsd        | |\n"
4525 " |                   |          |      +-----------------+ |\n"
4526 " \\___________________/          |      | Linux kernel    | |\n"
4527 "                                |      +--^--------------+ |\n"
4528 "                                \\_________|________________/\n"
4529 "                                          |\n"
4530 "                                   _______v______\n"
4531 "                                  /              \\\n"
4532 "                                  | Device or    |\n"
4533 "                                  | disk image   |\n"
4534 "                                  \\______________/\n"
4535 "\n"
4536 msgstr ""
4537
4538 # type: textblock
4539 #. type: textblock
4540 #: ../src/guestfs.pod:2116
4541 msgid ""
4542 "The library, linked to the main program, creates the child process and hence "
4543 "the appliance in the L</guestfs_launch> function."
4544 msgstr ""
4545
4546 # type: textblock
4547 #. type: textblock
4548 #: ../src/guestfs.pod:2119
4549 msgid ""
4550 "Inside the appliance is a Linux kernel and a complete stack of userspace "
4551 "tools (such as LVM and ext2 programs) and a small controlling daemon called "
4552 "L</guestfsd>.  The library talks to L</guestfsd> using remote procedure "
4553 "calls (RPC).  There is a mostly one-to-one correspondence between libguestfs "
4554 "API calls and RPC calls to the daemon.  Lastly the disk image(s) are "
4555 "attached to the qemu process which translates device access by the "
4556 "appliance's Linux kernel into accesses to the image."
4557 msgstr ""
4558
4559 # type: textblock
4560 #. type: textblock
4561 #: ../src/guestfs.pod:2128
4562 msgid ""
4563 "A common misunderstanding is that the appliance \"is\" the virtual machine.  "
4564 "Although the disk image you are attached to might also be used by some "
4565 "virtual machine, libguestfs doesn't know or care about this.  (But you will "
4566 "care if both libguestfs's qemu process and your virtual machine are trying "
4567 "to update the disk image at the same time, since these usually results in "
4568 "massive disk corruption)."
4569 msgstr ""
4570
4571 # type: =head1
4572 #. type: =head1
4573 #: ../src/guestfs.pod:2135
4574 msgid "STATE MACHINE"
4575 msgstr ""
4576
4577 # type: textblock
4578 #. type: textblock
4579 #: ../src/guestfs.pod:2137
4580 msgid "libguestfs uses a state machine to model the child process:"
4581 msgstr ""
4582
4583 # type: verbatim
4584 #. type: verbatim
4585 #: ../src/guestfs.pod:2139
4586 #, no-wrap
4587 msgid ""
4588 "                         |\n"
4589 "                    guestfs_create\n"
4590 "                         |\n"
4591 "                         |\n"
4592 "                     ____V_____\n"
4593 "                    /          \\\n"
4594 "                    |  CONFIG  |\n"
4595 "                    \\__________/\n"
4596 "                     ^ ^   ^  \\\n"
4597 "                    /  |    \\  \\ guestfs_launch\n"
4598 "                   /   |    _\\__V______\n"
4599 "                  /    |   /           \\\n"
4600 "                 /     |   | LAUNCHING |\n"
4601 "                /      |   \\___________/\n"
4602 "               /       |       /\n"
4603 "              /        |  guestfs_launch\n"
4604 "             /         |     /\n"
4605 "    ______  /        __|____V\n"
4606 "   /      \\ ------> /        \\\n"
4607 "   | BUSY |         | READY  |\n"
4608 "   \\______/ <------ \\________/\n"
4609 "\n"
4610 msgstr ""
4611
4612 # type: textblock
4613 #. type: textblock
4614 #: ../src/guestfs.pod:2161
4615 msgid ""
4616 "The normal transitions are (1) CONFIG (when the handle is created, but there "
4617 "is no child process), (2) LAUNCHING (when the child process is booting up), "
4618 "(3) alternating between READY and BUSY as commands are issued to, and "
4619 "carried out by, the child process."
4620 msgstr ""
4621
4622 # type: textblock
4623 #. type: textblock
4624 #: ../src/guestfs.pod:2166
4625 msgid ""
4626 "The guest may be killed by L</guestfs_kill_subprocess>, or may die "
4627 "asynchronously at any time (eg. due to some internal error), and that causes "
4628 "the state to transition back to CONFIG."
4629 msgstr ""
4630
4631 # type: textblock
4632 #. type: textblock
4633 #: ../src/guestfs.pod:2170
4634 msgid ""
4635 "Configuration commands for qemu such as L</guestfs_add_drive> can only be "
4636 "issued when in the CONFIG state."
4637 msgstr ""
4638
4639 # type: textblock
4640 #. type: textblock
4641 #: ../src/guestfs.pod:2173
4642 msgid ""
4643 "The API offers one call that goes from CONFIG through LAUNCHING to READY.  "
4644 "L</guestfs_launch> blocks until the child process is READY to accept "
4645 "commands (or until some failure or timeout).  L</guestfs_launch> internally "
4646 "moves the state from CONFIG to LAUNCHING while it is running."
4647 msgstr ""
4648
4649 # type: textblock
4650 #. type: textblock
4651 #: ../src/guestfs.pod:2179
4652 msgid ""
4653 "API actions such as L</guestfs_mount> can only be issued when in the READY "
4654 "state.  These API calls block waiting for the command to be carried out (ie. "
4655 "the state to transition to BUSY and then back to READY).  There are no non-"
4656 "blocking versions, and no way to issue more than one command per handle at "
4657 "the same time."
4658 msgstr ""
4659
4660 # type: textblock
4661 #. type: textblock
4662 #: ../src/guestfs.pod:2185
4663 msgid ""
4664 "Finally, the child process sends asynchronous messages back to the main "
4665 "program, such as kernel log messages.  You can register a callback to "
4666 "receive these messages."
4667 msgstr ""
4668
4669 # type: =head1
4670 #. type: =head1
4671 #: ../src/guestfs.pod:2189
4672 msgid "INTERNALS"
4673 msgstr ""
4674
4675 # type: =head2
4676 #. type: =head2
4677 #: ../src/guestfs.pod:2191
4678 msgid "COMMUNICATION PROTOCOL"
4679 msgstr ""
4680
4681 # type: textblock
4682 #. type: textblock
4683 #: ../src/guestfs.pod:2193
4684 msgid ""
4685 "Don't rely on using this protocol directly.  This section documents how it "
4686 "currently works, but it may change at any time."
4687 msgstr ""
4688
4689 # type: textblock
4690 #. type: textblock
4691 #: ../src/guestfs.pod:2196
4692 msgid ""
4693 "The protocol used to talk between the library and the daemon running inside "
4694 "the qemu virtual machine is a simple RPC mechanism built on top of XDR (RFC "
4695 "1014, RFC 1832, RFC 4506)."
4696 msgstr ""
4697
4698 # type: textblock
4699 #. type: textblock
4700 #: ../src/guestfs.pod:2200
4701 msgid ""
4702 "The detailed format of structures is in C<src/guestfs_protocol.x> (note: "
4703 "this file is automatically generated)."
4704 msgstr ""
4705
4706 # type: textblock
4707 #. type: textblock
4708 #: ../src/guestfs.pod:2203
4709 msgid ""
4710 "There are two broad cases, ordinary functions that don't have any C<FileIn> "
4711 "and C<FileOut> parameters, which are handled with very simple request/reply "
4712 "messages.  Then there are functions that have any C<FileIn> or C<FileOut> "
4713 "parameters, which use the same request and reply messages, but they may also "
4714 "be followed by files sent using a chunked encoding."
4715 msgstr ""
4716
4717 # type: =head3
4718 #. type: =head3
4719 #: ../src/guestfs.pod:2210
4720 msgid "ORDINARY FUNCTIONS (NO FILEIN/FILEOUT PARAMS)"
4721 msgstr ""
4722
4723 # type: textblock
4724 #. type: textblock
4725 #: ../src/guestfs.pod:2212
4726 msgid "For ordinary functions, the request message is:"
4727 msgstr ""
4728
4729 # type: verbatim
4730 #. type: verbatim
4731 #: ../src/guestfs.pod:2214
4732 #, no-wrap
4733 msgid ""
4734 " total length (header + arguments,\n"
4735 "      but not including the length word itself)\n"
4736 " struct guestfs_message_header (encoded as XDR)\n"
4737 " struct guestfs_<foo>_args (encoded as XDR)\n"
4738 "\n"
4739 msgstr ""
4740
4741 # type: textblock
4742 #. type: textblock
4743 #: ../src/guestfs.pod:2219
4744 msgid ""
4745 "The total length field allows the daemon to allocate a fixed size buffer "
4746 "into which it slurps the rest of the message.  As a result, the total length "
4747 "is limited to C<GUESTFS_MESSAGE_MAX> bytes (currently 4MB), which means the "
4748 "effective size of any request is limited to somewhere under this size."
4749 msgstr ""
4750
4751 # type: textblock
4752 #. type: textblock
4753 #: ../src/guestfs.pod:2225
4754 msgid ""
4755 "Note also that many functions don't take any arguments, in which case the "
4756 "C<guestfs_I<foo>_args> is completely omitted."
4757 msgstr ""
4758
4759 # type: textblock
4760 #. type: textblock
4761 #: ../src/guestfs.pod:2228
4762 msgid ""
4763 "The header contains the procedure number (C<guestfs_proc>) which is how the "
4764 "receiver knows what type of args structure to expect, or none at all."
4765 msgstr ""
4766
4767 # type: textblock
4768 #. type: textblock
4769 #: ../src/guestfs.pod:2232
4770 msgid ""
4771 "For functions that take optional arguments, the optional arguments are "
4772 "encoded in the C<guestfs_I<foo>_args> structure in the same way as ordinary "
4773 "arguments.  A bitmask in the header indicates which optional arguments are "
4774 "meaningful.  The bitmask is also checked to see if it contains bits set "
4775 "which the daemon does not know about (eg. if more optional arguments were "
4776 "added in a later version of the library), and this causes the call to be "
4777 "rejected."
4778 msgstr ""
4779
4780 # type: textblock
4781 #. type: textblock
4782 #: ../src/guestfs.pod:2240
4783 msgid "The reply message for ordinary functions is:"
4784 msgstr ""
4785
4786 # type: verbatim
4787 #. type: verbatim
4788 #: ../src/guestfs.pod:2242
4789 #, no-wrap
4790 msgid ""
4791 " total length (header + ret,\n"
4792 "      but not including the length word itself)\n"
4793 " struct guestfs_message_header (encoded as XDR)\n"
4794 " struct guestfs_<foo>_ret (encoded as XDR)\n"
4795 "\n"
4796 msgstr ""
4797
4798 # type: textblock
4799 #. type: textblock
4800 #: ../src/guestfs.pod:2247
4801 msgid ""
4802 "As above the C<guestfs_I<foo>_ret> structure may be completely omitted for "
4803 "functions that return no formal return values."
4804 msgstr ""
4805
4806 # type: textblock
4807 #. type: textblock
4808 #: ../src/guestfs.pod:2250
4809 msgid ""
4810 "As above the total length of the reply is limited to C<GUESTFS_MESSAGE_MAX>."
4811 msgstr ""
4812
4813 # type: textblock
4814 #. type: textblock
4815 #: ../src/guestfs.pod:2253
4816 msgid ""
4817 "In the case of an error, a flag is set in the header, and the reply message "
4818 "is slightly changed:"
4819 msgstr ""
4820
4821 # type: verbatim
4822 #. type: verbatim
4823 #: ../src/guestfs.pod:2256
4824 #, no-wrap
4825 msgid ""
4826 " total length (header + error,\n"
4827 "      but not including the length word itself)\n"
4828 " struct guestfs_message_header (encoded as XDR)\n"
4829 " struct guestfs_message_error (encoded as XDR)\n"
4830 "\n"
4831 msgstr ""
4832
4833 # type: textblock
4834 #. type: textblock
4835 #: ../src/guestfs.pod:2261
4836 msgid ""
4837 "The C<guestfs_message_error> structure contains the error message as a "
4838 "string."
4839 msgstr ""
4840
4841 # type: =head3
4842 #. type: =head3
4843 #: ../src/guestfs.pod:2264
4844 msgid "FUNCTIONS THAT HAVE FILEIN PARAMETERS"
4845 msgstr ""
4846
4847 # type: textblock
4848 #. type: textblock
4849 #: ../src/guestfs.pod:2266
4850 msgid ""
4851 "A C<FileIn> parameter indicates that we transfer a file I<into> the guest.  "
4852 "The normal request message is sent (see above).  However this is followed by "
4853 "a sequence of file chunks."
4854 msgstr ""
4855
4856 # type: verbatim
4857 #. type: verbatim
4858 #: ../src/guestfs.pod:2270
4859 #, no-wrap
4860 msgid ""
4861 " total length (header + arguments,\n"
4862 "      but not including the length word itself,\n"
4863 "      and not including the chunks)\n"
4864 " struct guestfs_message_header (encoded as XDR)\n"
4865 " struct guestfs_<foo>_args (encoded as XDR)\n"
4866 " sequence of chunks for FileIn param #0\n"
4867 " sequence of chunks for FileIn param #1 etc.\n"
4868 "\n"
4869 msgstr ""
4870
4871 # type: textblock
4872 #. type: textblock
4873 #: ../src/guestfs.pod:2278
4874 msgid "The \"sequence of chunks\" is:"
4875 msgstr ""
4876
4877 # type: verbatim
4878 #. type: verbatim
4879 #: ../src/guestfs.pod:2280
4880 #, no-wrap
4881 msgid ""
4882 " length of chunk (not including length word itself)\n"
4883 " struct guestfs_chunk (encoded as XDR)\n"
4884 " length of chunk\n"
4885 " struct guestfs_chunk (encoded as XDR)\n"
4886 "   ...\n"
4887 " length of chunk\n"
4888 " struct guestfs_chunk (with data.data_len == 0)\n"
4889 "\n"
4890 msgstr ""
4891
4892 # type: textblock
4893 #. type: textblock
4894 #: ../src/guestfs.pod:2288
4895 msgid ""
4896 "The final chunk has the C<data_len> field set to zero.  Additionally a flag "
4897 "is set in the final chunk to indicate either successful completion or early "
4898 "cancellation."
4899 msgstr ""
4900
4901 # type: textblock
4902 #. type: textblock
4903 #: ../src/guestfs.pod:2292
4904 msgid ""
4905 "At time of writing there are no functions that have more than one FileIn "
4906 "parameter.  However this is (theoretically) supported, by sending the "
4907 "sequence of chunks for each FileIn parameter one after another (from left to "
4908 "right)."
4909 msgstr ""
4910
4911 # type: textblock
4912 #. type: textblock
4913 #: ../src/guestfs.pod:2297
4914 msgid ""
4915 "Both the library (sender) I<and> the daemon (receiver) may cancel the "
4916 "transfer.  The library does this by sending a chunk with a special flag set "
4917 "to indicate cancellation.  When the daemon sees this, it cancels the whole "
4918 "RPC, does I<not> send any reply, and goes back to reading the next request."
4919 msgstr ""
4920
4921 # type: textblock
4922 #. type: textblock
4923 #: ../src/guestfs.pod:2303
4924 msgid ""
4925 "The daemon may also cancel.  It does this by writing a special word "
4926 "C<GUESTFS_CANCEL_FLAG> to the socket.  The library listens for this during "
4927 "the transfer, and if it gets it, it will cancel the transfer (it sends a "
4928 "cancel chunk).  The special word is chosen so that even if cancellation "
4929 "happens right at the end of the transfer (after the library has finished "
4930 "writing and has started listening for the reply), the \"spurious\" cancel "
4931 "flag will not be confused with the reply message."
4932 msgstr ""
4933
4934 # type: textblock
4935 #. type: textblock
4936 #: ../src/guestfs.pod:2312
4937 msgid ""
4938 "This protocol allows the transfer of arbitrary sized files (no 32 bit "
4939 "limit), and also files where the size is not known in advance (eg. from "
4940 "pipes or sockets).  However the chunks are rather small "
4941 "(C<GUESTFS_MAX_CHUNK_SIZE>), so that neither the library nor the daemon need "
4942 "to keep much in memory."
4943 msgstr ""
4944
4945 # type: =head3
4946 #. type: =head3
4947 #: ../src/guestfs.pod:2318
4948 msgid "FUNCTIONS THAT HAVE FILEOUT PARAMETERS"
4949 msgstr ""
4950
4951 # type: textblock
4952 #. type: textblock
4953 #: ../src/guestfs.pod:2320
4954 msgid ""
4955 "The protocol for FileOut parameters is exactly the same as for FileIn "
4956 "parameters, but with the roles of daemon and library reversed."
4957 msgstr ""
4958
4959 # type: verbatim
4960 #. type: verbatim
4961 #: ../src/guestfs.pod:2323
4962 #, no-wrap
4963 msgid ""
4964 " total length (header + ret,\n"
4965 "      but not including the length word itself,\n"
4966 "      and not including the chunks)\n"
4967 " struct guestfs_message_header (encoded as XDR)\n"
4968 " struct guestfs_<foo>_ret (encoded as XDR)\n"
4969 " sequence of chunks for FileOut param #0\n"
4970 " sequence of chunks for FileOut param #1 etc.\n"
4971 "\n"
4972 msgstr ""
4973
4974 # type: =head3
4975 #. type: =head3
4976 #: ../src/guestfs.pod:2331
4977 msgid "INITIAL MESSAGE"
4978 msgstr ""
4979
4980 # type: textblock
4981 #. type: textblock
4982 #: ../src/guestfs.pod:2333
4983 msgid ""
4984 "When the daemon launches it sends an initial word (C<GUESTFS_LAUNCH_FLAG>) "
4985 "which indicates that the guest and daemon is alive.  This is what L</"
4986 "guestfs_launch> waits for."
4987 msgstr ""
4988
4989 # type: =head3
4990 #. type: =head3
4991 #: ../src/guestfs.pod:2337
4992 msgid "PROGRESS NOTIFICATION MESSAGES"
4993 msgstr ""
4994
4995 # type: textblock
4996 #. type: textblock
4997 #: ../src/guestfs.pod:2339
4998 msgid ""
4999 "The daemon may send progress notification messages at any time.  These are "
5000 "distinguished by the normal length word being replaced by "
5001 "C<GUESTFS_PROGRESS_FLAG>, followed by a fixed size progress message."
5002 msgstr ""
5003
5004 #. type: textblock
5005 #: ../src/guestfs.pod:2343
5006 msgid ""
5007 "The library turns them into progress callbacks (see L</"
5008 "GUESTFS_EVENT_PROGRESS>) if there is a callback registered, or discards them "
5009 "if not."
5010 msgstr ""
5011
5012 # type: textblock
5013 #. type: textblock
5014 #: ../src/guestfs.pod:2347
5015 msgid ""
5016 "The daemon self-limits the frequency of progress messages it sends (see "
5017 "C<daemon/proto.c:notify_progress>).  Not all calls generate progress "
5018 "messages."
5019 msgstr ""
5020
5021 # type: =head1
5022 #. type: =head1
5023 #: ../src/guestfs.pod:2351
5024 msgid "LIBGUESTFS VERSION NUMBERS"
5025 msgstr ""
5026
5027 # type: textblock
5028 #. type: textblock
5029 #: ../src/guestfs.pod:2353
5030 msgid ""
5031 "Since April 2010, libguestfs has started to make separate development and "
5032 "stable releases, along with corresponding branches in our git repository.  "
5033 "These separate releases can be identified by version number:"
5034 msgstr ""
5035
5036 # type: verbatim
5037 #. type: verbatim
5038 #: ../src/guestfs.pod:2358
5039 #, no-wrap
5040 msgid ""
5041 "                 even numbers for stable: 1.2.x, 1.4.x, ...\n"
5042 "       .-------- odd numbers for development: 1.3.x, 1.5.x, ...\n"
5043 "       |\n"
5044 "       v\n"
5045 " 1  .  3  .  5\n"
5046 " ^           ^\n"
5047 " |           |\n"
5048 " |           `-------- sub-version\n"
5049 " |\n"
5050 " `------ always '1' because we don't change the ABI\n"
5051 "\n"
5052 msgstr ""
5053
5054 # type: textblock
5055 #. type: textblock
5056 #: ../src/guestfs.pod:2369
5057 msgid "Thus \"1.3.5\" is the 5th update to the development branch \"1.3\"."
5058 msgstr ""
5059
5060 # type: textblock
5061 #. type: textblock
5062 #: ../src/guestfs.pod:2371
5063 msgid ""
5064 "As time passes we cherry pick fixes from the development branch and backport "
5065 "those into the stable branch, the effect being that the stable branch should "
5066 "get more stable and less buggy over time.  So the stable releases are ideal "
5067 "for people who don't need new features but would just like the software to "
5068 "work."
5069 msgstr ""
5070
5071 # type: textblock
5072 #. type: textblock
5073 #: ../src/guestfs.pod:2377
5074 msgid "Our criteria for backporting changes are:"
5075 msgstr ""
5076
5077 # type: textblock
5078 #. type: textblock
5079 #: ../src/guestfs.pod:2383
5080 msgid ""
5081 "Documentation changes which don't affect any code are backported unless the "
5082 "documentation refers to a future feature which is not in stable."
5083 msgstr ""
5084
5085 # type: textblock
5086 #. type: textblock
5087 #: ../src/guestfs.pod:2389
5088 msgid ""
5089 "Bug fixes which are not controversial, fix obvious problems, and have been "
5090 "well tested are backported."
5091 msgstr ""
5092
5093 # type: textblock
5094 #. type: textblock
5095 #: ../src/guestfs.pod:2394
5096 msgid ""
5097 "Simple rearrangements of code which shouldn't affect how it works get "
5098 "backported.  This is so that the code in the two branches doesn't get too "
5099 "far out of step, allowing us to backport future fixes more easily."
5100 msgstr ""
5101
5102 # type: textblock
5103 #. type: textblock
5104 #: ../src/guestfs.pod:2400
5105 msgid ""
5106 "We I<don't> backport new features, new APIs, new tools etc, except in one "
5107 "exceptional case: the new feature is required in order to implement an "
5108 "important bug fix."
5109 msgstr ""
5110
5111 # type: textblock
5112 #. type: textblock
5113 #: ../src/guestfs.pod:2406
5114 msgid ""
5115 "A new stable branch starts when we think the new features in development are "
5116 "substantial and compelling enough over the current stable branch to warrant "
5117 "it.  When that happens we create new stable and development versions 1.N.0 "
5118 "and 1.(N+1).0 [N is even].  The new dot-oh release won't necessarily be so "
5119 "stable at this point, but by backporting fixes from development, that branch "
5120 "will stabilize over time."
5121 msgstr ""
5122
5123 #. type: =head1
5124 #: ../src/guestfs.pod:2414
5125 msgid "EXTENDING LIBGUESTFS"
5126 msgstr ""
5127
5128 #. type: =head2
5129 #: ../src/guestfs.pod:2416
5130 msgid "ADDING A NEW API ACTION"
5131 msgstr ""
5132
5133 #. type: textblock
5134 #: ../src/guestfs.pod:2418
5135 msgid ""
5136 "Large amounts of boilerplate code in libguestfs (RPC, bindings, "
5137 "documentation) are generated, and this makes it easy to extend the "
5138 "libguestfs API."
5139 msgstr ""
5140
5141 #. type: textblock
5142 #: ../src/guestfs.pod:2422
5143 msgid "To add a new API action there are two changes:"
5144 msgstr ""
5145
5146 #. type: textblock
5147 #: ../src/guestfs.pod:2428
5148 msgid ""
5149 "You need to add a description of the call (name, parameters, return type, "
5150 "tests, documentation) to C<generator/generator_actions.ml>."
5151 msgstr ""
5152
5153 #. type: textblock
5154 #: ../src/guestfs.pod:2431
5155 msgid ""
5156 "There are two sorts of API action, depending on whether the call goes "
5157 "through to the daemon in the appliance, or is serviced entirely by the "
5158 "library (see L</ARCHITECTURE> above).  L</guestfs_sync> is an example of the "
5159 "former, since the sync is done in the appliance.  L</guestfs_set_trace> is "
5160 "an example of the latter, since a trace flag is maintained in the handle and "
5161 "all tracing is done on the library side."
5162 msgstr ""
5163
5164 #. type: textblock
5165 #: ../src/guestfs.pod:2439
5166 msgid ""
5167 "Most new actions are of the first type, and get added to the "
5168 "C<daemon_functions> list.  Each function has a unique procedure number used "
5169 "in the RPC protocol which is assigned to that action when we publish "
5170 "libguestfs and cannot be reused.  Take the latest procedure number and "
5171 "increment it."
5172 msgstr ""
5173
5174 #. type: textblock
5175 #: ../src/guestfs.pod:2445
5176 msgid ""
5177 "For library-only actions of the second type, add to the "
5178 "C<non_daemon_functions> list.  Since these functions are serviced by the "
5179 "library and do not travel over the RPC mechanism to the daemon, these "
5180 "functions do not need a procedure number, and so the procedure number is set "
5181 "to C<-1>."
5182 msgstr ""
5183
5184 #. type: textblock
5185 #: ../src/guestfs.pod:2453
5186 msgid "Implement the action (in C):"
5187 msgstr ""
5188
5189 #. type: textblock
5190 #: ../src/guestfs.pod:2455
5191 msgid ""
5192 "For daemon actions, implement the function C<do_E<lt>nameE<gt>> in the "
5193 "C<daemon/> directory."
5194 msgstr ""
5195
5196 #. type: textblock
5197 #: ../src/guestfs.pod:2458
5198 msgid ""
5199 "For library actions, implement the function C<guestfs__E<lt>nameE<gt>> "
5200 "(note: double underscore) in the C<src/> directory."
5201 msgstr ""
5202
5203 #. type: textblock
5204 #: ../src/guestfs.pod:2461
5205 msgid "In either case, use another function as an example of what to do."
5206 msgstr ""
5207
5208 #. type: textblock
5209 #: ../src/guestfs.pod:2465
5210 msgid "After making these changes, use C<make> to compile."
5211 msgstr ""
5212
5213 #. type: textblock
5214 #: ../src/guestfs.pod:2467
5215 msgid ""
5216 "Note that you don't need to implement the RPC, language bindings, manual "
5217 "pages or anything else.  It's all automatically generated from the OCaml "
5218 "description."
5219 msgstr ""
5220
5221 #. type: =head2
5222 #: ../src/guestfs.pod:2471
5223 msgid "ADDING TESTS FOR AN API ACTION"
5224 msgstr ""
5225
5226 #. type: textblock
5227 #: ../src/guestfs.pod:2473
5228 msgid ""
5229 "You can supply zero or as many tests as you want per API call.  The tests "
5230 "can either be added as part of the API description (C<generator/"
5231 "generator_actions.ml>), or in some rarer cases you may want to drop a script "
5232 "into C<regressions/>.  Note that adding a script to C<regressions/> is "
5233 "slower, so if possible use the first method."
5234 msgstr ""
5235
5236 #. type: textblock
5237 #: ../src/guestfs.pod:2479
5238 msgid ""
5239 "The following describes the test environment used when you add an API test "
5240 "in C<generator_actions.ml>."
5241 msgstr ""
5242
5243 #. type: textblock
5244 #: ../src/guestfs.pod:2482
5245 msgid "The test environment has 4 block devices:"
5246 msgstr ""
5247
5248 #. type: =item
5249 #: ../src/guestfs.pod:2486
5250 msgid "C</dev/sda> 500MB"
5251 msgstr ""
5252
5253 #. type: textblock
5254 #: ../src/guestfs.pod:2488
5255 msgid "General block device for testing."
5256 msgstr ""
5257
5258 #. type: =item
5259 #: ../src/guestfs.pod:2490
5260 msgid "C</dev/sdb> 50MB"
5261 msgstr ""
5262
5263 #. type: textblock
5264 #: ../src/guestfs.pod:2492
5265 msgid ""
5266 "C</dev/sdb1> is an ext2 filesystem used for testing filesystem write "
5267 "operations."
5268 msgstr ""
5269
5270 #. type: =item
5271 #: ../src/guestfs.pod:2495
5272 msgid "C</dev/sdc> 10MB"
5273 msgstr ""
5274
5275 #. type: textblock
5276 #: ../src/guestfs.pod:2497
5277 msgid "Used in a few tests where two block devices are needed."
5278 msgstr ""
5279
5280 #. type: =item
5281 #: ../src/guestfs.pod:2499
5282 msgid "C</dev/sdd>"
5283 msgstr ""
5284
5285 #. type: textblock
5286 #: ../src/guestfs.pod:2501
5287 msgid "ISO with fixed content (see C<images/test.iso>)."
5288 msgstr ""
5289
5290 #. type: textblock
5291 #: ../src/guestfs.pod:2505
5292 msgid ""
5293 "To be able to run the tests in a reasonable amount of time, the libguestfs "
5294 "appliance and block devices are reused between tests.  So don't try testing "
5295 "L</guestfs_kill_subprocess> :-x"
5296 msgstr ""
5297
5298 #. type: textblock
5299 #: ../src/guestfs.pod:2509
5300 msgid ""
5301 "Each test starts with an initial scenario, selected using one of the "
5302 "C<Init*> expressions, described in C<generator/generator_types.ml>.  These "
5303 "initialize the disks mentioned above in a particular way as documented in "
5304 "C<generator_types.ml>.  You should not assume anything about the previous "
5305 "contents of other disks that are not initialized."
5306 msgstr ""
5307
5308 #. type: textblock
5309 #: ../src/guestfs.pod:2515
5310 msgid ""
5311 "You can add a prerequisite clause to any individual test.  This is a run-"
5312 "time check, which, if it fails, causes the test to be skipped.  Useful if "
5313 "testing a command which might not work on all variations of libguestfs "
5314 "builds.  A test that has prerequisite of C<Always> means to run "
5315 "unconditionally."
5316 msgstr ""
5317
5318 #. type: textblock
5319 #: ../src/guestfs.pod:2521
5320 msgid ""
5321 "In addition, packagers can skip individual tests by setting environment "
5322 "variables before running C<make check>."
5323 msgstr ""
5324
5325 #. type: verbatim
5326 #: ../src/guestfs.pod:2524
5327 #, no-wrap
5328 msgid ""
5329 " SKIP_TEST_<CMD>_<NUM>=1\n"
5330 "\n"
5331 msgstr ""
5332
5333 #. type: textblock
5334 #: ../src/guestfs.pod:2526
5335 msgid "eg: C<SKIP_TEST_COMMAND_3=1> skips test #3 of L</guestfs_command>."
5336 msgstr ""
5337
5338 #. type: textblock
5339 #: ../src/guestfs.pod:2528
5340 msgid "or:"
5341 msgstr ""
5342
5343 #. type: verbatim
5344 #: ../src/guestfs.pod:2530
5345 #, no-wrap
5346 msgid ""
5347 " SKIP_TEST_<CMD>=1\n"
5348 "\n"
5349 msgstr ""
5350
5351 #. type: textblock
5352 #: ../src/guestfs.pod:2532
5353 msgid "eg: C<SKIP_TEST_ZEROFREE=1> skips all L</guestfs_zerofree> tests."
5354 msgstr ""
5355
5356 #. type: textblock
5357 #: ../src/guestfs.pod:2534
5358 msgid "Packagers can run only certain tests by setting for example:"
5359 msgstr ""
5360
5361 #. type: verbatim
5362 #: ../src/guestfs.pod:2536
5363 #, no-wrap
5364 msgid ""
5365 " TEST_ONLY=\"vfs_type zerofree\"\n"
5366 "\n"
5367 msgstr ""
5368
5369 #. type: textblock
5370 #: ../src/guestfs.pod:2538
5371 msgid ""
5372 "See C<capitests/tests.c> for more details of how these environment variables "
5373 "work."
5374 msgstr ""
5375
5376 #. type: =head2
5377 #: ../src/guestfs.pod:2541
5378 msgid "DEBUGGING NEW API ACTIONS"
5379 msgstr ""
5380
5381 #. type: textblock
5382 #: ../src/guestfs.pod:2543
5383 msgid "Test new actions work before submitting them."
5384 msgstr ""
5385
5386 #. type: textblock
5387 #: ../src/guestfs.pod:2545
5388 msgid "You can use guestfish to try out new commands."
5389 msgstr ""
5390
5391 #. type: textblock
5392 #: ../src/guestfs.pod:2547
5393 msgid ""
5394 "Debugging the daemon is a problem because it runs inside a minimal "
5395 "environment.  However you can fprintf messages in the daemon to stderr, and "
5396 "they will show up if you use C<guestfish -v>."
5397 msgstr ""
5398
5399 #. type: =head2
5400 #: ../src/guestfs.pod:2551
5401 msgid "FORMATTING CODE AND OTHER CONVENTIONS"
5402 msgstr ""
5403
5404 #. type: textblock
5405 #: ../src/guestfs.pod:2553
5406 msgid ""
5407 "Our C source code generally adheres to some basic code-formatting "
5408 "conventions.  The existing code base is not totally consistent on this "
5409 "front, but we do prefer that contributed code be formatted similarly.  In "
5410 "short, use spaces-not-TABs for indentation, use 2 spaces for each "
5411 "indentation level, and other than that, follow the K&R style."
5412 msgstr ""
5413
5414 #. type: textblock
5415 #: ../src/guestfs.pod:2559
5416 msgid ""
5417 "If you use Emacs, add the following to one of one of your start-up files (e."
5418 "g., ~/.emacs), to help ensure that you get indentation right:"
5419 msgstr ""
5420
5421 #. type: verbatim
5422 #: ../src/guestfs.pod:2562
5423 #, no-wrap
5424 msgid ""
5425 " ;;; In libguestfs, indent with spaces everywhere (not TABs).\n"
5426 " ;;; Exceptions: Makefile and ChangeLog modes.\n"
5427 " (add-hook 'find-file-hook\n"
5428 "     '(lambda () (if (and buffer-file-name\n"
5429 "                          (string-match \"/libguestfs\\\\>\"\n"
5430 "                              (buffer-file-name))\n"
5431 "                          (not (string-equal mode-name \"Change Log\"))\n"
5432 "                          (not (string-equal mode-name \"Makefile\")))\n"
5433 "                     (setq indent-tabs-mode nil))))\n"
5434 " \n"
5435 msgstr ""
5436
5437 #. type: verbatim
5438 #: ../src/guestfs.pod:2572
5439 #, no-wrap
5440 msgid ""
5441 " ;;; When editing C sources in libguestfs, use this style.\n"
5442 " (defun libguestfs-c-mode ()\n"
5443 "   \"C mode with adjusted defaults for use with libguestfs.\"\n"
5444 "   (interactive)\n"
5445 "   (c-set-style \"K&R\")\n"
5446 "   (setq c-indent-level 2)\n"
5447 "   (setq c-basic-offset 2))\n"
5448 " (add-hook 'c-mode-hook\n"
5449 "           '(lambda () (if (string-match \"/libguestfs\\\\>\"\n"
5450 "                               (buffer-file-name))\n"
5451 "                           (libguestfs-c-mode))))\n"
5452 "\n"
5453 msgstr ""
5454
5455 #. type: textblock
5456 #: ../src/guestfs.pod:2584
5457 msgid "Enable warnings when compiling (and fix any problems this finds):"
5458 msgstr ""
5459
5460 #. type: verbatim
5461 #: ../src/guestfs.pod:2587
5462 #, no-wrap
5463 msgid ""
5464 " ./configure --enable-gcc-warnings\n"
5465 "\n"
5466 msgstr ""
5467
5468 #. type: textblock
5469 #: ../src/guestfs.pod:2589
5470 msgid "Useful targets are:"
5471 msgstr ""
5472
5473 #. type: verbatim
5474 #: ../src/guestfs.pod:2591
5475 #, no-wrap
5476 msgid ""
5477 " make syntax-check  # checks the syntax of the C code\n"
5478 " make check         # runs the test suite\n"
5479 "\n"
5480 msgstr ""
5481
5482 #. type: =head2
5483 #: ../src/guestfs.pod:2594
5484 msgid "DAEMON CUSTOM PRINTF FORMATTERS"
5485 msgstr ""
5486
5487 #. type: textblock
5488 #: ../src/guestfs.pod:2596
5489 msgid ""
5490 "In the daemon code we have created custom printf formatters C<%Q> and C<%R>, "
5491 "which are used to do shell quoting."
5492 msgstr ""
5493
5494 #. type: =item
5495 #: ../src/guestfs.pod:2601
5496 msgid "%Q"
5497 msgstr ""
5498
5499 #. type: textblock
5500 #: ../src/guestfs.pod:2603
5501 msgid ""
5502 "Simple shell quoted string.  Any spaces or other shell characters are "
5503 "escaped for you."
5504 msgstr ""
5505
5506 #. type: =item
5507 #: ../src/guestfs.pod:2606
5508 msgid "%R"
5509 msgstr ""
5510
5511 #. type: textblock
5512 #: ../src/guestfs.pod:2608
5513 msgid ""
5514 "Same as C<%Q> except the string is treated as a path which is prefixed by "
5515 "the sysroot."
5516 msgstr ""
5517
5518 # type: textblock
5519 #. type: textblock
5520 #: ../src/guestfs.pod:2613 ../fish/guestfish.pod:240 ../fish/guestfish.pod:608
5521 msgid "For example:"
5522 msgstr ""
5523
5524 #. type: verbatim
5525 #: ../src/guestfs.pod:2615
5526 #, no-wrap
5527 msgid ""
5528 " asprintf (&cmd, \"cat %R\", path);\n"
5529 "\n"
5530 msgstr ""
5531
5532 #. type: textblock
5533 #: ../src/guestfs.pod:2617
5534 msgid "would produce C<cat /sysroot/some\\ path\\ with\\ spaces>"
5535 msgstr ""
5536
5537 #. type: textblock
5538 #: ../src/guestfs.pod:2619
5539 msgid ""
5540 "I<Note:> Do I<not> use these when you are passing parameters to the C<command"
5541 "{,r,v,rv}()> functions.  These parameters do NOT need to be quoted because "
5542 "they are not passed via the shell (instead, straight to exec).  You probably "
5543 "want to use the C<sysroot_path()> function however."
5544 msgstr ""
5545
5546 #. type: =head2
5547 #: ../src/guestfs.pod:2625
5548 msgid "SUBMITTING YOUR NEW API ACTIONS"
5549 msgstr ""
5550
5551 #. type: textblock
5552 #: ../src/guestfs.pod:2627
5553 msgid ""
5554 "Submit patches to the mailing list: L<http://www.redhat.com/mailman/listinfo/"
5555 "libguestfs> and CC to L<rjones@redhat.com>."
5556 msgstr ""
5557
5558 #. type: =head2
5559 #: ../src/guestfs.pod:2631
5560 msgid "INTERNATIONALIZATION (I18N) SUPPORT"
5561 msgstr ""
5562
5563 #. type: textblock
5564 #: ../src/guestfs.pod:2633
5565 msgid "We support i18n (gettext anyhow) in the library."
5566 msgstr ""
5567
5568 #. type: textblock
5569 #: ../src/guestfs.pod:2635
5570 msgid ""
5571 "However many messages come from the daemon, and we don't translate those at "
5572 "the moment.  One reason is that the appliance generally has all locale files "
5573 "removed from it, because they take up a lot of space.  So we'd have to readd "
5574 "some of those, as well as copying our PO files into the appliance."
5575 msgstr ""
5576
5577 #. type: textblock
5578 #: ../src/guestfs.pod:2641
5579 msgid ""
5580 "Debugging messages are never translated, since they are intended for the "
5581 "programmers."
5582 msgstr ""
5583
5584 #. type: =head2
5585 #: ../src/guestfs.pod:2644
5586 msgid "SOURCE CODE SUBDIRECTORIES"
5587 msgstr ""
5588
5589 #. type: =item
5590 #: ../src/guestfs.pod:2648 ../src/guestfs-actions.pod:5725
5591 #: ../fish/guestfish-actions.pod:3842
5592 msgid "C<appliance>"
5593 msgstr ""
5594
5595 #. type: textblock
5596 #: ../src/guestfs.pod:2650
5597 msgid "The libguestfs appliance, build scripts and so on."
5598 msgstr ""
5599
5600 #. type: =item
5601 #: ../src/guestfs.pod:2652
5602 msgid "C<capitests>"
5603 msgstr ""
5604
5605 #. type: textblock
5606 #: ../src/guestfs.pod:2654
5607 msgid "Automated tests of the C API."
5608 msgstr ""
5609
5610 #. type: =item
5611 #: ../src/guestfs.pod:2656
5612 msgid "C<cat>"
5613 msgstr ""
5614
5615 #. type: textblock
5616 #: ../src/guestfs.pod:2658
5617 msgid ""
5618 "The L<virt-cat(1)>, L<virt-filesystems(1)> and L<virt-ls(1)> commands and "
5619 "documentation."
5620 msgstr ""
5621
5622 #. type: =item
5623 #: ../src/guestfs.pod:2661
5624 msgid "C<contrib>"
5625 msgstr ""
5626
5627 #. type: textblock
5628 #: ../src/guestfs.pod:2663
5629 msgid "Outside contributions, experimental parts."
5630 msgstr ""
5631
5632 #. type: =item
5633 #: ../src/guestfs.pod:2665
5634 msgid "C<daemon>"
5635 msgstr ""
5636
5637 #. type: textblock
5638 #: ../src/guestfs.pod:2667
5639 msgid ""
5640 "The daemon that runs inside the libguestfs appliance and carries out actions."
5641 msgstr ""
5642
5643 #. type: =item
5644 #: ../src/guestfs.pod:2670
5645 msgid "C<df>"
5646 msgstr ""
5647
5648 #. type: textblock
5649 #: ../src/guestfs.pod:2672
5650 msgid "L<virt-df(1)> command and documentation."
5651 msgstr ""
5652
5653 #. type: =item
5654 #: ../src/guestfs.pod:2674
5655 msgid "C<examples>"
5656 msgstr ""
5657
5658 #. type: textblock
5659 #: ../src/guestfs.pod:2676
5660 msgid "C API example code."
5661 msgstr ""
5662
5663 #. type: =item
5664 #: ../src/guestfs.pod:2678
5665 msgid "C<fish>"
5666 msgstr ""
5667
5668 #. type: textblock
5669 #: ../src/guestfs.pod:2680
5670 msgid ""
5671 "L<guestfish(1)>, the command-line shell, and various shell scripts built on "
5672 "top such as L<virt-copy-in(1)>, L<virt-copy-out(1)>, L<virt-tar-in(1)>, "
5673 "L<virt-tar-out(1)>."
5674 msgstr ""
5675
5676 #. type: =item
5677 #: ../src/guestfs.pod:2684
5678 msgid "C<fuse>"
5679 msgstr ""
5680
5681 #. type: textblock
5682 #: ../src/guestfs.pod:2686
5683 msgid ""
5684 "L<guestmount(1)>, FUSE (userspace filesystem) built on top of libguestfs."
5685 msgstr ""
5686
5687 #. type: =item
5688 #: ../src/guestfs.pod:2688
5689 msgid "C<generator>"
5690 msgstr ""
5691
5692 #. type: textblock
5693 #: ../src/guestfs.pod:2690
5694 msgid ""
5695 "The crucially important generator, used to automatically generate large "
5696 "amounts of boilerplate C code for things like RPC and bindings."
5697 msgstr ""
5698
5699 #. type: =item
5700 #: ../src/guestfs.pod:2693
5701 msgid "C<images>"
5702 msgstr ""
5703
5704 #. type: textblock
5705 #: ../src/guestfs.pod:2695
5706 msgid "Files used by the test suite."
5707 msgstr ""
5708
5709 #. type: textblock
5710 #: ../src/guestfs.pod:2697
5711 msgid "Some \"phony\" guest images which we test against."
5712 msgstr ""
5713
5714 #. type: =item
5715 #: ../src/guestfs.pod:2699
5716 msgid "C<inspector>"
5717 msgstr ""
5718
5719 #. type: textblock
5720 #: ../src/guestfs.pod:2701
5721 msgid "L<virt-inspector(1)>, the virtual machine image inspector."
5722 msgstr ""
5723
5724 #. type: =item
5725 #: ../src/guestfs.pod:2703
5726 msgid "C<logo>"
5727 msgstr ""
5728
5729 #. type: textblock
5730 #: ../src/guestfs.pod:2705
5731 msgid "Logo used on the website.  The fish is called Arthur by the way."
5732 msgstr ""
5733
5734 #. type: =item
5735 #: ../src/guestfs.pod:2707
5736 msgid "C<m4>"
5737 msgstr ""
5738
5739 #. type: textblock
5740 #: ../src/guestfs.pod:2709
5741 msgid "M4 macros used by autoconf."
5742 msgstr ""
5743
5744 #. type: =item
5745 #: ../src/guestfs.pod:2711
5746 msgid "C<po>"
5747 msgstr ""
5748
5749 #. type: textblock
5750 #: ../src/guestfs.pod:2713
5751 msgid "Translations of simple gettext strings."
5752 msgstr ""
5753
5754 #. type: =item
5755 #: ../src/guestfs.pod:2715
5756 msgid "C<po-docs>"
5757 msgstr ""
5758
5759 #. type: textblock
5760 #: ../src/guestfs.pod:2717
5761 msgid ""
5762 "The build infrastructure and PO files for translations of manpages and POD "
5763 "files.  Eventually this will be combined with the C<po> directory, but that "
5764 "is rather complicated."
5765 msgstr ""
5766
5767 #. type: =item
5768 #: ../src/guestfs.pod:2721
5769 msgid "C<regressions>"
5770 msgstr ""
5771
5772 #. type: textblock
5773 #: ../src/guestfs.pod:2723
5774 msgid "Regression tests."
5775 msgstr ""
5776
5777 #. type: =item
5778 #: ../src/guestfs.pod:2725
5779 msgid "C<rescue>"
5780 msgstr ""
5781
5782 #. type: textblock
5783 #: ../src/guestfs.pod:2727
5784 msgid "L<virt-rescue(1)> command and documentation."
5785 msgstr ""
5786
5787 #. type: =item
5788 #: ../src/guestfs.pod:2729
5789 msgid "C<src>"
5790 msgstr ""
5791
5792 #. type: textblock
5793 #: ../src/guestfs.pod:2731
5794 msgid "Source code to the C library."
5795 msgstr ""
5796
5797 #. type: =item
5798 #: ../src/guestfs.pod:2733
5799 msgid "C<tools>"
5800 msgstr ""
5801
5802 #. type: textblock
5803 #: ../src/guestfs.pod:2735
5804 msgid "Command line tools written in Perl (L<virt-resize(1)> and many others)."
5805 msgstr ""
5806
5807 #. type: =item
5808 #: ../src/guestfs.pod:2737
5809 msgid "C<test-tool>"
5810 msgstr ""
5811
5812 #. type: textblock
5813 #: ../src/guestfs.pod:2739
5814 msgid ""
5815 "Test tool for end users to test if their qemu/kernel combination will work "
5816 "with libguestfs."
5817 msgstr ""
5818
5819 #. type: =item
5820 #: ../src/guestfs.pod:2742
5821 msgid "C<csharp>"
5822 msgstr ""
5823
5824 #. type: =item
5825 #: ../src/guestfs.pod:2744
5826 msgid "C<haskell>"
5827 msgstr ""
5828
5829 #. type: =item
5830 #: ../src/guestfs.pod:2746
5831 msgid "C<java>"
5832 msgstr ""
5833
5834 #. type: =item
5835 #: ../src/guestfs.pod:2748
5836 msgid "C<ocaml>"
5837 msgstr ""
5838
5839 #. type: =item
5840 #: ../src/guestfs.pod:2750
5841 msgid "C<php>"
5842 msgstr ""
5843
5844 #. type: =item
5845 #: ../src/guestfs.pod:2752
5846 msgid "C<perl>"
5847 msgstr ""
5848
5849 #. type: =item
5850 #: ../src/guestfs.pod:2754
5851 msgid "C<python>"
5852 msgstr ""
5853
5854 #. type: =item
5855 #: ../src/guestfs.pod:2756
5856 msgid "C<ruby>"
5857 msgstr ""
5858
5859 #. type: textblock
5860 #: ../src/guestfs.pod:2758
5861 msgid "Language bindings."
5862 msgstr ""
5863
5864 # type: =head1
5865 #. type: =head1
5866 #: ../src/guestfs.pod:2762 ../fish/guestfish.pod:1005
5867 #: ../test-tool/libguestfs-test-tool.pod:104 ../tools/virt-edit.pl:330
5868 msgid "ENVIRONMENT VARIABLES"
5869 msgstr ""
5870
5871 # type: =item
5872 #. type: =item
5873 #: ../src/guestfs.pod:2766 ../fish/guestfish.pod:1031
5874 msgid "LIBGUESTFS_APPEND"
5875 msgstr ""
5876
5877 # type: textblock
5878 #. type: textblock
5879 #: ../src/guestfs.pod:2768 ../fish/guestfish.pod:1033
5880 msgid "Pass additional options to the guest kernel."
5881 msgstr ""
5882
5883 # type: =item
5884 #. type: =item
5885 #: ../src/guestfs.pod:2770 ../fish/guestfish.pod:1035
5886 msgid "LIBGUESTFS_DEBUG"
5887 msgstr ""
5888
5889 # type: textblock
5890 #. type: textblock
5891 #: ../src/guestfs.pod:2772
5892 msgid ""
5893 "Set C<LIBGUESTFS_DEBUG=1> to enable verbose messages.  This has the same "
5894 "effect as calling C<guestfs_set_verbose (g, 1)>."
5895 msgstr ""
5896
5897 # type: =item
5898 #. type: =item
5899 #: ../src/guestfs.pod:2775 ../fish/guestfish.pod:1040
5900 msgid "LIBGUESTFS_MEMSIZE"
5901 msgstr ""
5902
5903 # type: textblock
5904 #. type: textblock
5905 #: ../src/guestfs.pod:2777 ../fish/guestfish.pod:1042
5906 msgid ""
5907 "Set the memory allocated to the qemu process, in megabytes.  For example:"
5908 msgstr ""
5909
5910 # type: verbatim
5911 #. type: verbatim
5912 #: ../src/guestfs.pod:2780 ../fish/guestfish.pod:1045
5913 #, no-wrap
5914 msgid ""
5915 " LIBGUESTFS_MEMSIZE=700\n"
5916 "\n"
5917 msgstr ""
5918
5919 # type: =item
5920 #. type: =item
5921 #: ../src/guestfs.pod:2782 ../fish/guestfish.pod:1047
5922 msgid "LIBGUESTFS_PATH"
5923 msgstr ""
5924
5925 #. type: textblock
5926 #: ../src/guestfs.pod:2784
5927 msgid ""
5928 "Set the path that libguestfs uses to search for a supermin appliance.  See "
5929 "the discussion of paths in section L</PATH> above."
5930 msgstr ""
5931
5932 # type: =item
5933 #. type: =item
5934 #: ../src/guestfs.pod:2787 ../fish/guestfish.pod:1052
5935 msgid "LIBGUESTFS_QEMU"
5936 msgstr ""
5937
5938 # type: textblock
5939 #. type: textblock
5940 #: ../src/guestfs.pod:2789 ../fish/guestfish.pod:1054
5941 msgid ""
5942 "Set the default qemu binary that libguestfs uses.  If not set, then the qemu "
5943 "which was found at compile time by the configure script is used."
5944 msgstr ""
5945
5946 # type: textblock
5947 #. type: textblock
5948 #: ../src/guestfs.pod:2793
5949 msgid "See also L</QEMU WRAPPERS> above."
5950 msgstr ""
5951
5952 # type: =item
5953 #. type: =item
5954 #: ../src/guestfs.pod:2795 ../fish/guestfish.pod:1058
5955 msgid "LIBGUESTFS_TRACE"
5956 msgstr ""
5957
5958 # type: textblock
5959 #. type: textblock
5960 #: ../src/guestfs.pod:2797
5961 msgid ""
5962 "Set C<LIBGUESTFS_TRACE=1> to enable command traces.  This has the same "
5963 "effect as calling C<guestfs_set_trace (g, 1)>."
5964 msgstr ""
5965
5966 # type: =item
5967 #. type: =item
5968 #: ../src/guestfs.pod:2800 ../fish/guestfish.pod:1067
5969 msgid "TMPDIR"
5970 msgstr ""
5971
5972 #. type: textblock
5973 #: ../src/guestfs.pod:2802 ../fish/guestfish.pod:1069
5974 msgid ""
5975 "Location of temporary directory, defaults to C</tmp> except for the cached "
5976 "supermin appliance which defaults to C</var/tmp>."
5977 msgstr ""
5978
5979 #. type: textblock
5980 #: ../src/guestfs.pod:2805 ../fish/guestfish.pod:1072
5981 msgid ""
5982 "If libguestfs was compiled to use the supermin appliance then the real "
5983 "appliance is cached in this directory, shared between all handles belonging "
5984 "to the same EUID.  You can use C<$TMPDIR> to configure another directory to "
5985 "use in case C</var/tmp> is not large enough."
5986 msgstr ""
5987
5988 # type: =head1
5989 #. type: =head1
5990 #: ../src/guestfs.pod:2813 ../fish/guestfish.pod:1130
5991 #: ../test-tool/libguestfs-test-tool.pod:109 ../fuse/guestmount.pod:250
5992 #: ../tools/virt-edit.pl:350 ../tools/virt-win-reg.pl:572
5993 #: ../tools/virt-resize.pl:1489 ../tools/virt-list-filesystems.pl:189
5994 #: ../tools/virt-tar.pl:286 ../tools/virt-make-fs.pl:539
5995 #: ../tools/virt-list-partitions.pl:257
5996 msgid "SEE ALSO"
5997 msgstr ""
5998
5999 #. type: textblock
6000 #: ../src/guestfs.pod:2815
6001 msgid ""
6002 "L<guestfs-examples(3)>, L<guestfs-ocaml(3)>, L<guestfs-python(3)>, L<guestfs-"
6003 "ruby(3)>, L<guestfish(1)>, L<guestmount(1)>, L<virt-cat(1)>, L<virt-copy-in"
6004 "(1)>, L<virt-copy-out(1)>, L<virt-df(1)>, L<virt-edit(1)>, L<virt-filesystems"
6005 "(1)>, L<virt-inspector(1)>, L<virt-list-filesystems(1)>, L<virt-list-"
6006 "partitions(1)>, L<virt-ls(1)>, L<virt-make-fs(1)>, L<virt-rescue(1)>, L<virt-"
6007 "tar(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>, L<virt-win-reg(1)>, L<qemu(1)"
6008 ">, L<febootstrap(1)>, L<hivex(3)>, L<http://libguestfs.org/>."
6009 msgstr ""
6010
6011 # type: textblock
6012 #. type: textblock
6013 #: ../src/guestfs.pod:2842
6014 msgid ""
6015 "Tools with a similar purpose: L<fdisk(8)>, L<parted(8)>, L<kpartx(8)>, L<lvm"
6016 "(8)>, L<disktype(1)>."
6017 msgstr ""
6018
6019 # type: =head1
6020 #. type: =head1
6021 #: ../src/guestfs.pod:2849 ../tools/virt-win-reg.pl:587
6022 #: ../tools/virt-make-fs.pl:553
6023 msgid "BUGS"
6024 msgstr ""
6025
6026 # type: textblock
6027 #. type: textblock
6028 #: ../src/guestfs.pod:2851
6029 msgid "To get a list of bugs against libguestfs use this link:"
6030 msgstr ""
6031
6032 # type: textblock
6033 #. type: textblock
6034 #: ../src/guestfs.pod:2853
6035 msgid ""
6036 "L<https://bugzilla.redhat.com/buglist.cgi?"
6037 "component=libguestfs&product=Virtualization+Tools>"
6038 msgstr ""
6039
6040 # type: textblock
6041 #. type: textblock
6042 #: ../src/guestfs.pod:2855
6043 msgid "To report a new bug against libguestfs use this link:"
6044 msgstr ""
6045
6046 # type: textblock
6047 #. type: textblock
6048 #: ../src/guestfs.pod:2857
6049 msgid ""
6050 "L<https://bugzilla.redhat.com/enter_bug.cgi?"
6051 "component=libguestfs&product=Virtualization+Tools>"
6052 msgstr ""
6053
6054 # type: textblock
6055 #. type: textblock
6056 #: ../src/guestfs.pod:2859
6057 msgid "When reporting a bug, please check:"
6058 msgstr ""
6059
6060 # type: textblock
6061 #. type: textblock
6062 #: ../src/guestfs.pod:2865
6063 msgid "That the bug hasn't been reported already."
6064 msgstr ""
6065
6066 # type: textblock
6067 #. type: textblock
6068 #: ../src/guestfs.pod:2869
6069 msgid "That you are testing a recent version."
6070 msgstr ""
6071
6072 # type: textblock
6073 #. type: textblock
6074 #: ../src/guestfs.pod:2873
6075 msgid "Describe the bug accurately, and give a way to reproduce it."
6076 msgstr ""
6077
6078 # type: textblock
6079 #. type: textblock
6080 #: ../src/guestfs.pod:2877
6081 msgid ""
6082 "Run libguestfs-test-tool and paste the B<complete, unedited> output into the "
6083 "bug report."
6084 msgstr ""
6085
6086 # type: =head1
6087 #. type: =head1
6088 #: ../src/guestfs.pod:2882 ../fish/guestfish.pod:1153
6089 #: ../test-tool/libguestfs-test-tool.pod:115 ../fuse/guestmount.pod:261
6090 msgid "AUTHORS"
6091 msgstr ""
6092
6093 # type: textblock
6094 #. type: textblock
6095 #: ../src/guestfs.pod:2884 ../fish/guestfish.pod:1155
6096 #: ../test-tool/libguestfs-test-tool.pod:117 ../fuse/guestmount.pod:263
6097 msgid "Richard W.M. Jones (C<rjones at redhat dot com>)"
6098 msgstr ""
6099
6100 # type: =head1
6101 #. type: =head1
6102 #: ../src/guestfs.pod:2886 ../fish/guestfish.pod:1157
6103 #: ../test-tool/libguestfs-test-tool.pod:119 ../fuse/guestmount.pod:265
6104 #: ../tools/virt-edit.pl:368 ../tools/virt-win-reg.pl:602
6105 #: ../tools/virt-resize.pl:1514 ../tools/virt-list-filesystems.pl:206
6106 #: ../tools/virt-tar.pl:305 ../tools/virt-make-fs.pl:568
6107 #: ../tools/virt-list-partitions.pl:273
6108 msgid "COPYRIGHT"
6109 msgstr ""
6110
6111 # type: textblock
6112 #. type: textblock
6113 #: ../src/guestfs.pod:2888 ../fish/guestfish.pod:1159
6114 #: ../fuse/guestmount.pod:267
6115 msgid "Copyright (C) 2009-2010 Red Hat Inc.  L<http://libguestfs.org/>"
6116 msgstr ""
6117
6118 # type: textblock
6119 #. type: textblock
6120 #: ../src/guestfs.pod:2891
6121 msgid ""
6122 "This library is free software; you can redistribute it and/or modify it "
6123 "under the terms of the GNU Lesser General Public License as published by the "
6124 "Free Software Foundation; either version 2 of the License, or (at your "
6125 "option) any later version."
6126 msgstr ""
6127
6128 # type: textblock
6129 #. type: textblock
6130 #: ../src/guestfs.pod:2896
6131 msgid ""
6132 "This library is distributed in the hope that it will be useful, but WITHOUT "
6133 "ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or "
6134 "FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public License "
6135 "for more details."
6136 msgstr ""
6137
6138 # type: textblock
6139 #. type: textblock
6140 #: ../src/guestfs.pod:2901
6141 msgid ""
6142 "You should have received a copy of the GNU Lesser General Public License "
6143 "along with this library; if not, write to the Free Software Foundation, "
6144 "Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA"
6145 msgstr ""
6146
6147 # type: =head2
6148 #. type: =head2
6149 #: ../src/guestfs-actions.pod:1
6150 msgid "guestfs_add_cdrom"
6151 msgstr ""
6152
6153 # type: verbatim
6154 #. type: verbatim
6155 #: ../src/guestfs-actions.pod:3
6156 #, no-wrap
6157 msgid ""
6158 " int\n"
6159 " guestfs_add_cdrom (guestfs_h *g,\n"
6160 "                    const char *filename);\n"
6161 "\n"
6162 msgstr ""
6163
6164 # type: textblock
6165 #. type: textblock
6166 #: ../src/guestfs-actions.pod:7 ../fish/guestfish-actions.pod:5
6167 msgid "This function adds a virtual CD-ROM disk image to the guest."
6168 msgstr ""
6169
6170 # type: textblock
6171 #. type: textblock
6172 #: ../src/guestfs-actions.pod:9 ../fish/guestfish-actions.pod:7
6173 msgid "This is equivalent to the qemu parameter C<-cdrom filename>."
6174 msgstr ""
6175
6176 # type: textblock
6177 #. type: textblock
6178 #: ../src/guestfs-actions.pod:17
6179 msgid ""
6180 "This call checks for the existence of C<filename>.  This stops you from "
6181 "specifying other types of drive which are supported by qemu such as C<nbd:> "
6182 "and C<http:> URLs.  To specify those, use the general C<guestfs_config> call "
6183 "instead."
6184 msgstr ""
6185
6186 # type: textblock
6187 #. type: textblock
6188 #: ../src/guestfs-actions.pod:24
6189 msgid ""
6190 "If you just want to add an ISO file (often you use this as an efficient way "
6191 "to transfer large files into the guest), then you should probably use "
6192 "C<guestfs_add_drive_ro> instead."
6193 msgstr ""
6194
6195 # type: textblock
6196 #. type: textblock
6197 #: ../src/guestfs-actions.pod:30 ../src/guestfs-actions.pod:134
6198 #: ../src/guestfs-actions.pod:195 ../src/guestfs-actions.pod:232
6199 #: ../src/guestfs-actions.pod:246 ../src/guestfs-actions.pod:267
6200 #: ../src/guestfs-actions.pod:287 ../src/guestfs-actions.pod:301
6201 #: ../src/guestfs-actions.pod:416 ../src/guestfs-actions.pod:436
6202 #: ../src/guestfs-actions.pod:450 ../src/guestfs-actions.pod:495
6203 #: ../src/guestfs-actions.pod:523 ../src/guestfs-actions.pod:541
6204 #: ../src/guestfs-actions.pod:608 ../src/guestfs-actions.pod:641
6205 #: ../src/guestfs-actions.pod:655 ../src/guestfs-actions.pod:670
6206 #: ../src/guestfs-actions.pod:769 ../src/guestfs-actions.pod:787
6207 #: ../src/guestfs-actions.pod:801 ../src/guestfs-actions.pod:815
6208 #: ../src/guestfs-actions.pod:976 ../src/guestfs-actions.pod:996
6209 #: ../src/guestfs-actions.pod:1014 ../src/guestfs-actions.pod:1098
6210 #: ../src/guestfs-actions.pod:1116 ../src/guestfs-actions.pod:1135
6211 #: ../src/guestfs-actions.pod:1149 ../src/guestfs-actions.pod:1169
6212 #: ../src/guestfs-actions.pod:1239 ../src/guestfs-actions.pod:1270
6213 #: ../src/guestfs-actions.pod:1295 ../src/guestfs-actions.pod:1332
6214 #: ../src/guestfs-actions.pod:1438 ../src/guestfs-actions.pod:1472
6215 #: ../src/guestfs-actions.pod:1690 ../src/guestfs-actions.pod:1712
6216 #: ../src/guestfs-actions.pod:1799 ../src/guestfs-actions.pod:2261
6217 #: ../src/guestfs-actions.pod:2405 ../src/guestfs-actions.pod:2466
6218 #: ../src/guestfs-actions.pod:2501 ../src/guestfs-actions.pod:3375
6219 #: ../src/guestfs-actions.pod:3390 ../src/guestfs-actions.pod:3410
6220 #: ../src/guestfs-actions.pod:3565 ../src/guestfs-actions.pod:3579
6221 #: ../src/guestfs-actions.pod:3592 ../src/guestfs-actions.pod:3606
6222 #: ../src/guestfs-actions.pod:3621 ../src/guestfs-actions.pod:3657
6223 #: ../src/guestfs-actions.pod:3729 ../src/guestfs-actions.pod:3749
6224 #: ../src/guestfs-actions.pod:3766 ../src/guestfs-actions.pod:3789
6225 #: ../src/guestfs-actions.pod:3812 ../src/guestfs-actions.pod:3844
6226 #: ../src/guestfs-actions.pod:3863 ../src/guestfs-actions.pod:3882
6227 #: ../src/guestfs-actions.pod:3917 ../src/guestfs-actions.pod:3929
6228 #: ../src/guestfs-actions.pod:3965 ../src/guestfs-actions.pod:3981
6229 #: ../src/guestfs-actions.pod:3994 ../src/guestfs-actions.pod:4009
6230 #: ../src/guestfs-actions.pod:4026 ../src/guestfs-actions.pod:4119
6231 #: ../src/guestfs-actions.pod:4139 ../src/guestfs-actions.pod:4152
6232 #: ../src/guestfs-actions.pod:4203 ../src/guestfs-actions.pod:4221
6233 #: ../src/guestfs-actions.pod:4239 ../src/guestfs-actions.pod:4255
6234 #: ../src/guestfs-actions.pod:4269 ../src/guestfs-actions.pod:4283
6235 #: ../src/guestfs-actions.pod:4300 ../src/guestfs-actions.pod:4315
6236 #: ../src/guestfs-actions.pod:4335 ../src/guestfs-actions.pod:4393
6237 #: ../src/guestfs-actions.pod:4466 ../src/guestfs-actions.pod:4497
6238 #: ../src/guestfs-actions.pod:4516 ../src/guestfs-actions.pod:4535
6239 #: ../src/guestfs-actions.pod:4547 ../src/guestfs-actions.pod:4564
6240 #: ../src/guestfs-actions.pod:4577 ../src/guestfs-actions.pod:4592
6241 #: ../src/guestfs-actions.pod:4607 ../src/guestfs-actions.pod:4642
6242 #: ../src/guestfs-actions.pod:4657 ../src/guestfs-actions.pod:4677
6243 #: ../src/guestfs-actions.pod:4691 ../src/guestfs-actions.pod:4708
6244 #: ../src/guestfs-actions.pod:4757 ../src/guestfs-actions.pod:4794
6245 #: ../src/guestfs-actions.pod:4808 ../src/guestfs-actions.pod:4836
6246 #: ../src/guestfs-actions.pod:4853 ../src/guestfs-actions.pod:4871
6247 #: ../src/guestfs-actions.pod:5005 ../src/guestfs-actions.pod:5062
6248 #: ../src/guestfs-actions.pod:5084 ../src/guestfs-actions.pod:5102
6249 #: ../src/guestfs-actions.pod:5134 ../src/guestfs-actions.pod:5200
6250 #: ../src/guestfs-actions.pod:5217 ../src/guestfs-actions.pod:5230
6251 #: ../src/guestfs-actions.pod:5244 ../src/guestfs-actions.pod:5533
6252 #: ../src/guestfs-actions.pod:5552 ../src/guestfs-actions.pod:5571
6253 #: ../src/guestfs-actions.pod:5583 ../src/guestfs-actions.pod:5595
6254 #: ../src/guestfs-actions.pod:5609 ../src/guestfs-actions.pod:5621
6255 #: ../src/guestfs-actions.pod:5635 ../src/guestfs-actions.pod:5651
6256 #: ../src/guestfs-actions.pod:5672 ../src/guestfs-actions.pod:5691
6257 #: ../src/guestfs-actions.pod:5710 ../src/guestfs-actions.pod:5740
6258 #: ../src/guestfs-actions.pod:5756 ../src/guestfs-actions.pod:5779
6259 #: ../src/guestfs-actions.pod:5797 ../src/guestfs-actions.pod:5816
6260 #: ../src/guestfs-actions.pod:5837 ../src/guestfs-actions.pod:5856
6261 #: ../src/guestfs-actions.pod:5873 ../src/guestfs-actions.pod:5901
6262 #: ../src/guestfs-actions.pod:5925 ../src/guestfs-actions.pod:5944
6263 #: ../src/guestfs-actions.pod:5968 ../src/guestfs-actions.pod:5987
6264 #: ../src/guestfs-actions.pod:6002 ../src/guestfs-actions.pod:6021
6265 #: ../src/guestfs-actions.pod:6058 ../src/guestfs-actions.pod:6081
6266 #: ../src/guestfs-actions.pod:6107 ../src/guestfs-actions.pod:6215
6267 #: ../src/guestfs-actions.pod:6336 ../src/guestfs-actions.pod:6348
6268 #: ../src/guestfs-actions.pod:6361 ../src/guestfs-actions.pod:6374
6269 #: ../src/guestfs-actions.pod:6396 ../src/guestfs-actions.pod:6409
6270 #: ../src/guestfs-actions.pod:6422 ../src/guestfs-actions.pod:6435
6271 #: ../src/guestfs-actions.pod:6450 ../src/guestfs-actions.pod:6509
6272 #: ../src/guestfs-actions.pod:6526 ../src/guestfs-actions.pod:6542
6273 #: ../src/guestfs-actions.pod:6558 ../src/guestfs-actions.pod:6575
6274 #: ../src/guestfs-actions.pod:6588 ../src/guestfs-actions.pod:6608
6275 #: ../src/guestfs-actions.pod:6644 ../src/guestfs-actions.pod:6658
6276 #: ../src/guestfs-actions.pod:6699 ../src/guestfs-actions.pod:6712
6277 #: ../src/guestfs-actions.pod:6730 ../src/guestfs-actions.pod:6764
6278 #: ../src/guestfs-actions.pod:6800 ../src/guestfs-actions.pod:6919
6279 #: ../src/guestfs-actions.pod:6937 ../src/guestfs-actions.pod:6951
6280 #: ../src/guestfs-actions.pod:7006 ../src/guestfs-actions.pod:7019
6281 #: ../src/guestfs-actions.pod:7064 ../src/guestfs-actions.pod:7097
6282 #: ../src/guestfs-actions.pod:7151 ../src/guestfs-actions.pod:7177
6283 #: ../src/guestfs-actions.pod:7243 ../src/guestfs-actions.pod:7262
6284 #: ../src/guestfs-actions.pod:7291
6285 msgid "This function returns 0 on success or -1 on error."
6286 msgstr ""
6287
6288 # type: textblock
6289 #. type: textblock
6290 #: ../src/guestfs-actions.pod:32 ../src/guestfs-actions.pod:248
6291 #: ../src/guestfs-actions.pod:269 ../fish/guestfish-actions.pod:28
6292 #: ../fish/guestfish-actions.pod:158 ../fish/guestfish-actions.pod:172
6293 msgid ""
6294 "This function is deprecated.  In new code, use the C<add_drive_opts> call "
6295 "instead."
6296 msgstr ""
6297
6298 # type: textblock
6299 #. type: textblock
6300 #: ../src/guestfs-actions.pod:35 ../src/guestfs-actions.pod:251
6301 #: ../src/guestfs-actions.pod:272 ../src/guestfs-actions.pod:1443
6302 #: ../src/guestfs-actions.pod:1939 ../src/guestfs-actions.pod:1960
6303 #: ../src/guestfs-actions.pod:4340 ../src/guestfs-actions.pod:7185
6304 #: ../src/guestfs-actions.pod:7354 ../fish/guestfish-actions.pod:31
6305 #: ../fish/guestfish-actions.pod:161 ../fish/guestfish-actions.pod:175
6306 #: ../fish/guestfish-actions.pod:956 ../fish/guestfish-actions.pod:1319
6307 #: ../fish/guestfish-actions.pod:1333 ../fish/guestfish-actions.pod:2942
6308 #: ../fish/guestfish-actions.pod:4800 ../fish/guestfish-actions.pod:4897
6309 msgid ""
6310 "Deprecated functions will not be removed from the API, but the fact that "
6311 "they are deprecated indicates that there are problems with correct use of "
6312 "these functions."
6313 msgstr ""
6314
6315 # type: textblock
6316 #. type: textblock
6317 #: ../src/guestfs-actions.pod:39 ../src/guestfs-actions.pod:136
6318 #: ../src/guestfs-actions.pod:1100 ../src/guestfs-actions.pod:1911
6319 #: ../src/guestfs-actions.pod:2009 ../src/guestfs-actions.pod:2112
6320 #: ../src/guestfs-actions.pod:3377 ../src/guestfs-actions.pod:3392
6321 #: ../src/guestfs-actions.pod:4644 ../src/guestfs-actions.pod:5758
6322 #: ../src/guestfs-actions.pod:5875 ../src/guestfs-actions.pod:5989
6323 #: ../src/guestfs-actions.pod:6452 ../src/guestfs-actions.pod:6577
6324 #: ../src/guestfs-actions.pod:7099
6325 msgid "(Added in 0.3)"
6326 msgstr ""
6327
6328 # type: =head2
6329 #. type: =head2
6330 #: ../src/guestfs-actions.pod:41
6331 msgid "guestfs_add_domain"
6332 msgstr ""
6333
6334 # type: verbatim
6335 #. type: verbatim
6336 #: ../src/guestfs-actions.pod:43
6337 #, no-wrap
6338 msgid ""
6339 " int\n"
6340 " guestfs_add_domain (guestfs_h *g,\n"
6341 "                     const char *dom,\n"
6342 "                     ...);\n"
6343 "\n"
6344 msgstr ""
6345
6346 # type: textblock
6347 #. type: textblock
6348 #: ../src/guestfs-actions.pod:48 ../src/guestfs-actions.pod:145
6349 #: ../src/guestfs-actions.pod:4354
6350 msgid ""
6351 "You may supply a list of optional arguments to this call.  Use zero or more "
6352 "of the following pairs of parameters, and terminate the list with C<-1> on "
6353 "its own.  See L</CALLS WITH OPTIONAL ARGUMENTS>."
6354 msgstr ""
6355
6356 #. type: verbatim
6357 #: ../src/guestfs-actions.pod:53
6358 #, no-wrap
6359 msgid ""
6360 " GUESTFS_ADD_DOMAIN_LIBVIRTURI, const char *libvirturi,\n"
6361 " GUESTFS_ADD_DOMAIN_READONLY, int readonly,\n"
6362 " GUESTFS_ADD_DOMAIN_IFACE, const char *iface,\n"
6363 " GUESTFS_ADD_DOMAIN_LIVE, int live,\n"
6364 "\n"
6365 msgstr ""
6366
6367 # type: textblock
6368 #. type: textblock
6369 #: ../src/guestfs-actions.pod:58
6370 msgid ""
6371 "This function adds the disk(s) attached to the named libvirt domain C<dom>.  "
6372 "It works by connecting to libvirt, requesting the domain and domain XML from "
6373 "libvirt, parsing it for disks, and calling C<guestfs_add_drive_opts> on each "
6374 "one."
6375 msgstr ""
6376
6377 # type: textblock
6378 #. type: textblock
6379 #: ../src/guestfs-actions.pod:63 ../fish/guestfish-actions.pod:46
6380 msgid ""
6381 "The number of disks added is returned.  This operation is atomic: if an "
6382 "error is returned, then no disks are added."
6383 msgstr ""
6384
6385 # type: textblock
6386 #. type: textblock
6387 #: ../src/guestfs-actions.pod:66 ../fish/guestfish-actions.pod:49
6388 msgid ""
6389 "This function does some minimal checks to make sure the libvirt domain is "
6390 "not running (unless C<readonly> is true).  In a future version we will try "
6391 "to acquire the libvirt lock on each disk."
6392 msgstr ""
6393
6394 # type: textblock
6395 #. type: textblock
6396 #: ../src/guestfs-actions.pod:70 ../fish/guestfish-actions.pod:53
6397 msgid ""
6398 "Disks must be accessible locally.  This often means that adding disks from a "
6399 "remote libvirt connection (see L<http://libvirt.org/remote.html>)  will fail "
6400 "unless those disks are accessible via the same device path locally too."
6401 msgstr ""
6402
6403 #. type: textblock
6404 #: ../src/guestfs-actions.pod:75 ../fish/guestfish-actions.pod:58
6405 msgid ""
6406 "The optional C<libvirturi> parameter sets the libvirt URI (see L<http://"
6407 "libvirt.org/uri.html>).  If this is not set then we connect to the default "
6408 "libvirt URI (or one set through an environment variable, see the libvirt "
6409 "documentation for full details)."
6410 msgstr ""
6411
6412 #. type: textblock
6413 #: ../src/guestfs-actions.pod:81 ../fish/guestfish-actions.pod:64
6414 msgid ""
6415 "The optional C<live> flag controls whether this call will try to connect to "
6416 "a running virtual machine C<guestfsd> process if it sees a suitable "
6417 "E<lt>channelE<gt> element in the libvirt XML definition.  The default (if "
6418 "the flag is omitted) is never to try.  See L<guestfs(3)/ATTACHING TO RUNNING "
6419 "DAEMONS> for more information."
6420 msgstr ""
6421
6422 # type: textblock
6423 #. type: textblock
6424 #: ../src/guestfs-actions.pod:88
6425 msgid ""
6426 "The other optional parameters are passed directly through to "
6427 "C<guestfs_add_drive_opts>."
6428 msgstr ""
6429
6430 # type: textblock
6431 #. type: textblock
6432 #: ../src/guestfs-actions.pod:91 ../src/guestfs-actions.pod:344
6433 #: ../src/guestfs-actions.pod:509 ../src/guestfs-actions.pod:687
6434 #: ../src/guestfs-actions.pod:718 ../src/guestfs-actions.pod:736
6435 #: ../src/guestfs-actions.pod:755 ../src/guestfs-actions.pod:1315
6436 #: ../src/guestfs-actions.pod:1669 ../src/guestfs-actions.pod:1872
6437 #: ../src/guestfs-actions.pod:1981 ../src/guestfs-actions.pod:2021
6438 #: ../src/guestfs-actions.pod:2076 ../src/guestfs-actions.pod:2099
6439 #: ../src/guestfs-actions.pod:2392 ../src/guestfs-actions.pod:2723
6440 #: ../src/guestfs-actions.pod:2744 ../src/guestfs-actions.pod:4780
6441 #: ../src/guestfs-actions.pod:4908 ../src/guestfs-actions.pod:5314
6442 #: ../src/guestfs-actions.pod:5340 ../src/guestfs-actions.pod:6685
6443 #: ../src/guestfs-actions.pod:7110 ../src/guestfs-actions.pod:7123
6444 #: ../src/guestfs-actions.pod:7136
6445 msgid "On error this function returns -1."
6446 msgstr ""
6447
6448 # type: textblock
6449 #. type: textblock
6450 #: ../src/guestfs-actions.pod:93
6451 msgid "(Added in 1.7.4)"
6452 msgstr ""
6453
6454 # type: =head2
6455 #. type: =head2
6456 #: ../src/guestfs-actions.pod:95
6457 msgid "guestfs_add_domain_va"
6458 msgstr ""
6459
6460 # type: verbatim
6461 #. type: verbatim
6462 #: ../src/guestfs-actions.pod:97
6463 #, no-wrap
6464 msgid ""
6465 " int\n"
6466 " guestfs_add_domain_va (guestfs_h *g,\n"
6467 "                        const char *dom,\n"
6468 "                        va_list args);\n"
6469 "\n"
6470 msgstr ""
6471
6472 # type: textblock
6473 #. type: textblock
6474 #: ../src/guestfs-actions.pod:102
6475 msgid "This is the \"va_list variant\" of L</guestfs_add_domain>."
6476 msgstr ""
6477
6478 # type: textblock
6479 #. type: textblock
6480 #: ../src/guestfs-actions.pod:104 ../src/guestfs-actions.pod:115
6481 #: ../src/guestfs-actions.pod:208 ../src/guestfs-actions.pod:219
6482 #: ../src/guestfs-actions.pod:4407 ../src/guestfs-actions.pod:4419
6483 msgid "See L</CALLS WITH OPTIONAL ARGUMENTS>."
6484 msgstr ""
6485
6486 # type: =head2
6487 #. type: =head2
6488 #: ../src/guestfs-actions.pod:106
6489 msgid "guestfs_add_domain_argv"
6490 msgstr ""
6491
6492 # type: verbatim
6493 #. type: verbatim
6494 #: ../src/guestfs-actions.pod:108
6495 #, no-wrap
6496 msgid ""
6497 " int\n"
6498 " guestfs_add_domain_argv (guestfs_h *g,\n"
6499 "                          const char *dom,\n"
6500 "                          const struct guestfs_add_domain_argv *optargs);\n"
6501 "\n"
6502 msgstr ""
6503
6504 # type: textblock
6505 #. type: textblock
6506 #: ../src/guestfs-actions.pod:113
6507 msgid "This is the \"argv variant\" of L</guestfs_add_domain>."
6508 msgstr ""
6509
6510 # type: =head2
6511 #. type: =head2
6512 #: ../src/guestfs-actions.pod:117
6513 msgid "guestfs_add_drive"
6514 msgstr ""
6515
6516 # type: verbatim
6517 #. type: verbatim
6518 #: ../src/guestfs-actions.pod:119
6519 #, no-wrap
6520 msgid ""
6521 " int\n"
6522 " guestfs_add_drive (guestfs_h *g,\n"
6523 "                    const char *filename);\n"
6524 "\n"
6525 msgstr ""
6526
6527 # type: textblock
6528 #. type: textblock
6529 #: ../src/guestfs-actions.pod:123
6530 msgid ""
6531 "This function is the equivalent of calling C<guestfs_add_drive_opts> with no "
6532 "optional parameters, so the disk is added writable, with the format being "
6533 "detected automatically."
6534 msgstr ""
6535
6536 # type: textblock
6537 #. type: textblock
6538 #: ../src/guestfs-actions.pod:127
6539 msgid ""
6540 "Automatic detection of the format opens you up to a potential security hole "
6541 "when dealing with untrusted raw-format images.  See CVE-2010-3851 and "
6542 "RHBZ#642934.  Specifying the format closes this security hole.  Therefore "
6543 "you should think about replacing calls to this function with calls to "
6544 "C<guestfs_add_drive_opts>, and specifying the format."
6545 msgstr ""
6546
6547 # type: =head2
6548 #. type: =head2
6549 #: ../src/guestfs-actions.pod:138
6550 msgid "guestfs_add_drive_opts"
6551 msgstr ""
6552
6553 # type: verbatim
6554 #. type: verbatim
6555 #: ../src/guestfs-actions.pod:140
6556 #, no-wrap
6557 msgid ""
6558 " int\n"
6559 " guestfs_add_drive_opts (guestfs_h *g,\n"
6560 "                         const char *filename,\n"
6561 "                         ...);\n"
6562 "\n"
6563 msgstr ""
6564
6565 # type: verbatim
6566 #. type: verbatim
6567 #: ../src/guestfs-actions.pod:150
6568 #, no-wrap
6569 msgid ""
6570 " GUESTFS_ADD_DRIVE_OPTS_READONLY, int readonly,\n"
6571 " GUESTFS_ADD_DRIVE_OPTS_FORMAT, const char *format,\n"
6572 " GUESTFS_ADD_DRIVE_OPTS_IFACE, const char *iface,\n"
6573 "\n"
6574 msgstr ""
6575
6576 # type: textblock
6577 #. type: textblock
6578 #: ../src/guestfs-actions.pod:154 ../fish/guestfish-actions.pod:97
6579 msgid ""
6580 "This function adds a virtual machine disk image C<filename> to libguestfs.  "
6581 "The first time you call this function, the disk appears as C</dev/sda>, the "
6582 "second time as C</dev/sdb>, and so on."
6583 msgstr ""
6584
6585 # type: textblock
6586 #. type: textblock
6587 #: ../src/guestfs-actions.pod:159 ../fish/guestfish-actions.pod:102
6588 msgid ""
6589 "You don't necessarily need to be root when using libguestfs.  However you "
6590 "obviously do need sufficient permissions to access the filename for whatever "
6591 "operations you want to perform (ie. read access if you just want to read the "
6592 "image or write access if you want to modify the image)."
6593 msgstr ""
6594
6595 # type: textblock
6596 #. type: textblock
6597 #: ../src/guestfs-actions.pod:165 ../fish/guestfish-actions.pod:108
6598 msgid "This call checks that C<filename> exists."
6599 msgstr ""
6600
6601 # type: textblock
6602 #. type: textblock
6603 #: ../src/guestfs-actions.pod:167 ../src/guestfs-actions.pod:4365
6604 #: ../fish/guestfish-actions.pod:110 ../fish/guestfish-actions.pod:2953
6605 msgid "The optional arguments are:"
6606 msgstr ""
6607
6608 # type: =item
6609 #. type: =item
6610 #: ../src/guestfs-actions.pod:171 ../fish/guestfish-actions.pod:114
6611 msgid "C<readonly>"
6612 msgstr ""
6613
6614 # type: textblock
6615 #. type: textblock
6616 #: ../src/guestfs-actions.pod:173 ../fish/guestfish-actions.pod:116
6617 msgid ""
6618 "If true then the image is treated as read-only.  Writes are still allowed, "
6619 "but they are stored in a temporary snapshot overlay which is discarded at "
6620 "the end.  The disk that you add is not modified."
6621 msgstr ""
6622
6623 # type: =item
6624 #. type: =item
6625 #: ../src/guestfs-actions.pod:177 ../fish/guestfish-actions.pod:120
6626 msgid "C<format>"
6627 msgstr ""
6628
6629 # type: textblock
6630 #. type: textblock
6631 #: ../src/guestfs-actions.pod:179
6632 msgid ""
6633 "This forces the image format.  If you omit this (or use C<guestfs_add_drive> "
6634 "or C<guestfs_add_drive_ro>) then the format is automatically detected.  "
6635 "Possible formats include C<raw> and C<qcow2>."
6636 msgstr ""
6637
6638 # type: textblock
6639 #. type: textblock
6640 #: ../src/guestfs-actions.pod:183 ../fish/guestfish-actions.pod:126
6641 msgid ""
6642 "Automatic detection of the format opens you up to a potential security hole "
6643 "when dealing with untrusted raw-format images.  See CVE-2010-3851 and "
6644 "RHBZ#642934.  Specifying the format closes this security hole."
6645 msgstr ""
6646
6647 # type: =item
6648 #. type: =item
6649 #: ../src/guestfs-actions.pod:188 ../fish/guestfish-actions.pod:131
6650 msgid "C<iface>"
6651 msgstr ""
6652
6653 # type: textblock
6654 #. type: textblock
6655 #: ../src/guestfs-actions.pod:190
6656 msgid ""
6657 "This rarely-used option lets you emulate the behaviour of the deprecated "
6658 "C<guestfs_add_drive_with_if> call (q.v.)"
6659 msgstr ""
6660
6661 # type: textblock
6662 #. type: textblock
6663 #: ../src/guestfs-actions.pod:197
6664 msgid "(Added in 1.5.23)"
6665 msgstr ""
6666
6667 # type: =head2
6668 #. type: =head2
6669 #: ../src/guestfs-actions.pod:199
6670 msgid "guestfs_add_drive_opts_va"
6671 msgstr ""
6672
6673 # type: verbatim
6674 #. type: verbatim
6675 #: ../src/guestfs-actions.pod:201
6676 #, no-wrap
6677 msgid ""
6678 " int\n"
6679 " guestfs_add_drive_opts_va (guestfs_h *g,\n"
6680 "                            const char *filename,\n"
6681 "                            va_list args);\n"
6682 "\n"
6683 msgstr ""
6684
6685 # type: textblock
6686 #. type: textblock
6687 #: ../src/guestfs-actions.pod:206
6688 msgid "This is the \"va_list variant\" of L</guestfs_add_drive_opts>."
6689 msgstr ""
6690
6691 # type: =head2
6692 #. type: =head2
6693 #: ../src/guestfs-actions.pod:210
6694 msgid "guestfs_add_drive_opts_argv"
6695 msgstr ""
6696
6697 # type: verbatim
6698 #. type: verbatim
6699 #: ../src/guestfs-actions.pod:212
6700 #, no-wrap
6701 msgid ""
6702 " int\n"
6703 " guestfs_add_drive_opts_argv (guestfs_h *g,\n"
6704 "                              const char *filename,\n"
6705 "                              const struct guestfs_add_drive_opts_argv *optargs);\n"
6706 "\n"
6707 msgstr ""
6708
6709 # type: textblock
6710 #. type: textblock
6711 #: ../src/guestfs-actions.pod:217
6712 msgid "This is the \"argv variant\" of L</guestfs_add_drive_opts>."
6713 msgstr ""
6714
6715 # type: =head2
6716 #. type: =head2
6717 #: ../src/guestfs-actions.pod:221
6718 msgid "guestfs_add_drive_ro"
6719 msgstr ""
6720
6721 # type: verbatim
6722 #. type: verbatim
6723 #: ../src/guestfs-actions.pod:223
6724 #, no-wrap
6725 msgid ""
6726 " int\n"
6727 " guestfs_add_drive_ro (guestfs_h *g,\n"
6728 "                       const char *filename);\n"
6729 "\n"
6730 msgstr ""
6731
6732 # type: textblock
6733 #. type: textblock
6734 #: ../src/guestfs-actions.pod:227
6735 msgid ""
6736 "This function is the equivalent of calling C<guestfs_add_drive_opts> with "
6737 "the optional parameter C<GUESTFS_ADD_DRIVE_OPTS_READONLY> set to 1, so the "
6738 "disk is added read-only, with the format being detected automatically."
6739 msgstr ""
6740
6741 # type: textblock
6742 #. type: textblock
6743 #: ../src/guestfs-actions.pod:234
6744 msgid "(Added in 1.0.38)"
6745 msgstr ""
6746
6747 # type: =head2
6748 #. type: =head2
6749 #: ../src/guestfs-actions.pod:236
6750 msgid "guestfs_add_drive_ro_with_if"
6751 msgstr ""
6752
6753 # type: verbatim
6754 #. type: verbatim
6755 #: ../src/guestfs-actions.pod:238
6756 #, no-wrap
6757 msgid ""
6758 " int\n"
6759 " guestfs_add_drive_ro_with_if (guestfs_h *g,\n"
6760 "                               const char *filename,\n"
6761 "                               const char *iface);\n"
6762 "\n"
6763 msgstr ""
6764
6765 # type: textblock
6766 #. type: textblock
6767 #: ../src/guestfs-actions.pod:243
6768 msgid ""
6769 "This is the same as C<guestfs_add_drive_ro> but it allows you to specify the "
6770 "QEMU interface emulation to use at run time."
6771 msgstr ""
6772
6773 # type: textblock
6774 #. type: textblock
6775 #: ../src/guestfs-actions.pod:255 ../src/guestfs-actions.pod:276
6776 #: ../src/guestfs-actions.pod:2351
6777 msgid "(Added in 1.0.84)"
6778 msgstr ""
6779
6780 # type: =head2
6781 #. type: =head2
6782 #: ../src/guestfs-actions.pod:257
6783 msgid "guestfs_add_drive_with_if"
6784 msgstr ""
6785
6786 # type: verbatim
6787 #. type: verbatim
6788 #: ../src/guestfs-actions.pod:259
6789 #, no-wrap
6790 msgid ""
6791 " int\n"
6792 " guestfs_add_drive_with_if (guestfs_h *g,\n"
6793 "                            const char *filename,\n"
6794 "                            const char *iface);\n"
6795 "\n"
6796 msgstr ""
6797
6798 # type: textblock
6799 #. type: textblock
6800 #: ../src/guestfs-actions.pod:264
6801 msgid ""
6802 "This is the same as C<guestfs_add_drive> but it allows you to specify the "
6803 "QEMU interface emulation to use at run time."
6804 msgstr ""
6805
6806 # type: =head2
6807 #. type: =head2
6808 #: ../src/guestfs-actions.pod:278
6809 msgid "guestfs_aug_clear"
6810 msgstr ""
6811
6812 # type: verbatim
6813 #. type: verbatim
6814 #: ../src/guestfs-actions.pod:280
6815 #, no-wrap
6816 msgid ""
6817 " int\n"
6818 " guestfs_aug_clear (guestfs_h *g,\n"
6819 "                    const char *augpath);\n"
6820 "\n"
6821 msgstr ""
6822
6823 # type: textblock
6824 #. type: textblock
6825 #: ../src/guestfs-actions.pod:284 ../fish/guestfish-actions.pod:183
6826 msgid ""
6827 "Set the value associated with C<path> to C<NULL>.  This is the same as the "
6828 "L<augtool(1)> C<clear> command."
6829 msgstr ""
6830
6831 # type: textblock
6832 #. type: textblock
6833 #: ../src/guestfs-actions.pod:289 ../src/guestfs-actions.pod:2101
6834 msgid "(Added in 1.3.4)"
6835 msgstr ""
6836
6837 # type: =head2
6838 #. type: =head2
6839 #: ../src/guestfs-actions.pod:291
6840 msgid "guestfs_aug_close"
6841 msgstr ""
6842
6843 # type: verbatim
6844 #. type: verbatim
6845 #: ../src/guestfs-actions.pod:293
6846 #, no-wrap
6847 msgid ""
6848 " int\n"
6849 " guestfs_aug_close (guestfs_h *g);\n"
6850 "\n"
6851 msgstr ""
6852
6853 # type: textblock
6854 #. type: textblock
6855 #: ../src/guestfs-actions.pod:296
6856 msgid ""
6857 "Close the current Augeas handle and free up any resources used by it.  After "
6858 "calling this, you have to call C<guestfs_aug_init> again before you can use "
6859 "any other Augeas functions."
6860 msgstr ""
6861
6862 # type: textblock
6863 #. type: textblock
6864 #: ../src/guestfs-actions.pod:303 ../src/guestfs-actions.pod:328
6865 #: ../src/guestfs-actions.pod:346 ../src/guestfs-actions.pod:360
6866 #: ../src/guestfs-actions.pod:418 ../src/guestfs-actions.pod:438
6867 #: ../src/guestfs-actions.pod:452 ../src/guestfs-actions.pod:483
6868 #: ../src/guestfs-actions.pod:497 ../src/guestfs-actions.pod:511
6869 #: ../src/guestfs-actions.pod:525 ../src/guestfs-actions.pod:543
6870 #: ../src/guestfs-actions.pod:5391
6871 msgid "(Added in 0.7)"
6872 msgstr ""
6873
6874 # type: =head2
6875 #. type: =head2
6876 #: ../src/guestfs-actions.pod:305
6877 msgid "guestfs_aug_defnode"
6878 msgstr ""
6879
6880 # type: verbatim
6881 #. type: verbatim
6882 #: ../src/guestfs-actions.pod:307
6883 #, no-wrap
6884 msgid ""
6885 " struct guestfs_int_bool *\n"
6886 " guestfs_aug_defnode (guestfs_h *g,\n"
6887 "                      const char *name,\n"
6888 "                      const char *expr,\n"
6889 "                      const char *val);\n"
6890 "\n"
6891 msgstr ""
6892
6893 # type: textblock
6894 #. type: textblock
6895 #: ../src/guestfs-actions.pod:313 ../fish/guestfish-actions.pod:199
6896 msgid ""
6897 "Defines a variable C<name> whose value is the result of evaluating C<expr>."
6898 msgstr ""
6899
6900 # type: textblock
6901 #. type: textblock
6902 #: ../src/guestfs-actions.pod:316
6903 msgid ""
6904 "If C<expr> evaluates to an empty nodeset, a node is created, equivalent to "
6905 "calling C<guestfs_aug_set> C<expr>, C<value>.  C<name> will be the nodeset "
6906 "containing that single node."
6907 msgstr ""
6908
6909 # type: textblock
6910 #. type: textblock
6911 #: ../src/guestfs-actions.pod:320 ../fish/guestfish-actions.pod:206
6912 msgid ""
6913 "On success this returns a pair containing the number of nodes in the "
6914 "nodeset, and a boolean flag if a node was created."
6915 msgstr ""
6916
6917 # type: textblock
6918 #. type: textblock
6919 #: ../src/guestfs-actions.pod:324
6920 msgid ""
6921 "This function returns a C<struct guestfs_int_bool *>, or NULL if there was "
6922 "an error.  I<The caller must call C<guestfs_free_int_bool> after use>."
6923 msgstr ""
6924
6925 # type: =head2
6926 #. type: =head2
6927 #: ../src/guestfs-actions.pod:330
6928 msgid "guestfs_aug_defvar"
6929 msgstr ""
6930
6931 # type: verbatim
6932 #. type: verbatim
6933 #: ../src/guestfs-actions.pod:332
6934 #, no-wrap
6935 msgid ""
6936 " int\n"
6937 " guestfs_aug_defvar (guestfs_h *g,\n"
6938 "                     const char *name,\n"
6939 "                     const char *expr);\n"
6940 "\n"
6941 msgstr ""
6942
6943 # type: textblock
6944 #. type: textblock
6945 #: ../src/guestfs-actions.pod:337 ../fish/guestfish-actions.pod:214
6946 msgid ""
6947 "Defines an Augeas variable C<name> whose value is the result of evaluating "
6948 "C<expr>.  If C<expr> is NULL, then C<name> is undefined."
6949 msgstr ""
6950
6951 # type: textblock
6952 #. type: textblock
6953 #: ../src/guestfs-actions.pod:341 ../fish/guestfish-actions.pod:218
6954 msgid ""
6955 "On success this returns the number of nodes in C<expr>, or C<0> if C<expr> "
6956 "evaluates to something which is not a nodeset."
6957 msgstr ""
6958
6959 # type: =head2
6960 #. type: =head2
6961 #: ../src/guestfs-actions.pod:348
6962 msgid "guestfs_aug_get"
6963 msgstr ""
6964
6965 # type: verbatim
6966 #. type: verbatim
6967 #: ../src/guestfs-actions.pod:350
6968 #, no-wrap
6969 msgid ""
6970 " char *\n"
6971 " guestfs_aug_get (guestfs_h *g,\n"
6972 "                  const char *augpath);\n"
6973 "\n"
6974 msgstr ""
6975
6976 # type: textblock
6977 #. type: textblock
6978 #: ../src/guestfs-actions.pod:354 ../fish/guestfish-actions.pod:225
6979 msgid ""
6980 "Look up the value associated with C<path>.  If C<path> matches exactly one "
6981 "node, the C<value> is returned."
6982 msgstr ""
6983
6984 # type: textblock
6985 #. type: textblock
6986 #: ../src/guestfs-actions.pod:357 ../src/guestfs-actions.pod:857
6987 #: ../src/guestfs-actions.pod:875 ../src/guestfs-actions.pod:935
6988 #: ../src/guestfs-actions.pod:951 ../src/guestfs-actions.pod:1054
6989 #: ../src/guestfs-actions.pod:1184 ../src/guestfs-actions.pod:1201
6990 #: ../src/guestfs-actions.pod:1220 ../src/guestfs-actions.pod:1349
6991 #: ../src/guestfs-actions.pod:1540 ../src/guestfs-actions.pod:1652
6992 #: ../src/guestfs-actions.pod:1815 ../src/guestfs-actions.pod:1832
6993 #: ../src/guestfs-actions.pod:1899 ../src/guestfs-actions.pod:1933
6994 #: ../src/guestfs-actions.pod:1954 ../src/guestfs-actions.pod:2124
6995 #: ../src/guestfs-actions.pod:2316 ../src/guestfs-actions.pod:2523
6996 #: ../src/guestfs-actions.pod:2608 ../src/guestfs-actions.pod:2675
6997 #: ../src/guestfs-actions.pod:2695 ../src/guestfs-actions.pod:2809
6998 #: ../src/guestfs-actions.pod:2840 ../src/guestfs-actions.pod:2864
6999 #: ../src/guestfs-actions.pod:2901 ../src/guestfs-actions.pod:2961
7000 #: ../src/guestfs-actions.pod:2984 ../src/guestfs-actions.pod:3551
7001 #: ../src/guestfs-actions.pod:3901 ../src/guestfs-actions.pod:4071
7002 #: ../src/guestfs-actions.pod:4181 ../src/guestfs-actions.pod:4926
7003 #: ../src/guestfs-actions.pod:5119 ../src/guestfs-actions.pod:5289
7004 #: ../src/guestfs-actions.pod:5467 ../src/guestfs-actions.pod:5516
7005 #: ../src/guestfs-actions.pod:6128 ../src/guestfs-actions.pod:6144
7006 #: ../src/guestfs-actions.pod:6161 ../src/guestfs-actions.pod:6185
7007 #: ../src/guestfs-actions.pod:6859 ../src/guestfs-actions.pod:6878
7008 #: ../src/guestfs-actions.pod:6896 ../src/guestfs-actions.pod:7076
7009 #: ../src/guestfs-actions.pod:7348
7010 msgid ""
7011 "This function returns a string, or NULL on error.  I<The caller must free "
7012 "the returned string after use>."
7013 msgstr ""
7014
7015 # type: =head2
7016 #. type: =head2
7017 #: ../src/guestfs-actions.pod:362
7018 msgid "guestfs_aug_init"
7019 msgstr ""
7020
7021 # type: verbatim
7022 #. type: verbatim
7023 #: ../src/guestfs-actions.pod:364
7024 #, no-wrap
7025 msgid ""
7026 " int\n"
7027 " guestfs_aug_init (guestfs_h *g,\n"
7028 "                   const char *root,\n"
7029 "                   int flags);\n"
7030 "\n"
7031 msgstr ""
7032
7033 # type: textblock
7034 #. type: textblock
7035 #: ../src/guestfs-actions.pod:369 ../fish/guestfish-actions.pod:232
7036 msgid ""
7037 "Create a new Augeas handle for editing configuration files.  If there was "
7038 "any previous Augeas handle associated with this guestfs session, then it is "
7039 "closed."
7040 msgstr ""
7041
7042 # type: textblock
7043 #. type: textblock
7044 #: ../src/guestfs-actions.pod:373
7045 msgid "You must call this before using any other C<guestfs_aug_*> commands."
7046 msgstr ""
7047
7048 # type: textblock
7049 #. type: textblock
7050 #: ../src/guestfs-actions.pod:376 ../fish/guestfish-actions.pod:239
7051 msgid ""
7052 "C<root> is the filesystem root.  C<root> must not be NULL, use C</> instead."
7053 msgstr ""
7054
7055 # type: textblock
7056 #. type: textblock
7057 #: ../src/guestfs-actions.pod:379 ../fish/guestfish-actions.pod:242
7058 msgid ""
7059 "The flags are the same as the flags defined in E<lt>augeas.hE<gt>, the "
7060 "logical I<or> of the following integers:"
7061 msgstr ""
7062
7063 # type: =item
7064 #. type: =item
7065 #: ../src/guestfs-actions.pod:385 ../fish/guestfish-actions.pod:248
7066 msgid "C<AUG_SAVE_BACKUP> = 1"
7067 msgstr ""
7068
7069 # type: textblock
7070 #. type: textblock
7071 #: ../src/guestfs-actions.pod:387 ../fish/guestfish-actions.pod:250
7072 msgid "Keep the original file with a C<.augsave> extension."
7073 msgstr ""
7074
7075 # type: =item
7076 #. type: =item
7077 #: ../src/guestfs-actions.pod:389 ../fish/guestfish-actions.pod:252
7078 msgid "C<AUG_SAVE_NEWFILE> = 2"
7079 msgstr ""
7080
7081 # type: textblock
7082 #. type: textblock
7083 #: ../src/guestfs-actions.pod:391 ../fish/guestfish-actions.pod:254
7084 msgid ""
7085 "Save changes into a file with extension C<.augnew>, and do not overwrite "
7086 "original.  Overrides C<AUG_SAVE_BACKUP>."
7087 msgstr ""
7088
7089 # type: =item
7090 #. type: =item
7091 #: ../src/guestfs-actions.pod:394 ../fish/guestfish-actions.pod:257
7092 msgid "C<AUG_TYPE_CHECK> = 4"
7093 msgstr ""
7094
7095 # type: textblock
7096 #. type: textblock
7097 #: ../src/guestfs-actions.pod:396 ../fish/guestfish-actions.pod:259
7098 msgid "Typecheck lenses (can be expensive)."
7099 msgstr ""
7100
7101 # type: =item
7102 #. type: =item
7103 #: ../src/guestfs-actions.pod:398 ../fish/guestfish-actions.pod:261
7104 msgid "C<AUG_NO_STDINC> = 8"
7105 msgstr ""
7106
7107 # type: textblock
7108 #. type: textblock
7109 #: ../src/guestfs-actions.pod:400 ../fish/guestfish-actions.pod:263
7110 msgid "Do not use standard load path for modules."
7111 msgstr ""
7112
7113 # type: =item
7114 #. type: =item
7115 #: ../src/guestfs-actions.pod:402 ../fish/guestfish-actions.pod:265
7116 msgid "C<AUG_SAVE_NOOP> = 16"
7117 msgstr ""
7118
7119 # type: textblock
7120 #. type: textblock
7121 #: ../src/guestfs-actions.pod:404 ../fish/guestfish-actions.pod:267
7122 msgid "Make save a no-op, just record what would have been changed."
7123 msgstr ""
7124
7125 # type: =item
7126 #. type: =item
7127 #: ../src/guestfs-actions.pod:406 ../fish/guestfish-actions.pod:269
7128 msgid "C<AUG_NO_LOAD> = 32"
7129 msgstr ""
7130
7131 # type: textblock
7132 #. type: textblock
7133 #: ../src/guestfs-actions.pod:408
7134 msgid "Do not load the tree in C<guestfs_aug_init>."
7135 msgstr ""
7136
7137 # type: textblock
7138 #. type: textblock
7139 #: ../src/guestfs-actions.pod:412
7140 msgid "To close the handle, you can call C<guestfs_aug_close>."
7141 msgstr ""
7142
7143 # type: textblock
7144 #. type: textblock
7145 #: ../src/guestfs-actions.pod:414 ../fish/guestfish-actions.pod:277
7146 msgid "To find out more about Augeas, see L<http://augeas.net/>."
7147 msgstr ""
7148
7149 # type: =head2
7150 #. type: =head2
7151 #: ../src/guestfs-actions.pod:420
7152 msgid "guestfs_aug_insert"
7153 msgstr ""
7154
7155 # type: verbatim
7156 #. type: verbatim
7157 #: ../src/guestfs-actions.pod:422
7158 #, no-wrap
7159 msgid ""
7160 " int\n"
7161 " guestfs_aug_insert (guestfs_h *g,\n"
7162 "                     const char *augpath,\n"
7163 "                     const char *label,\n"
7164 "                     int before);\n"
7165 "\n"
7166 msgstr ""
7167
7168 # type: textblock
7169 #. type: textblock
7170 #: ../src/guestfs-actions.pod:428 ../fish/guestfish-actions.pod:283
7171 msgid ""
7172 "Create a new sibling C<label> for C<path>, inserting it into the tree before "
7173 "or after C<path> (depending on the boolean flag C<before>)."
7174 msgstr ""
7175
7176 # type: textblock
7177 #. type: textblock
7178 #: ../src/guestfs-actions.pod:432 ../fish/guestfish-actions.pod:287
7179 msgid ""
7180 "C<path> must match exactly one existing node in the tree, and C<label> must "
7181 "be a label, ie. not contain C</>, C<*> or end with a bracketed index C<[N]>."
7182 msgstr ""
7183
7184 # type: =head2
7185 #. type: =head2
7186 #: ../src/guestfs-actions.pod:440
7187 msgid "guestfs_aug_load"
7188 msgstr ""
7189
7190 # type: verbatim
7191 #. type: verbatim
7192 #: ../src/guestfs-actions.pod:442
7193 #, no-wrap
7194 msgid ""
7195 " int\n"
7196 " guestfs_aug_load (guestfs_h *g);\n"
7197 "\n"
7198 msgstr ""
7199
7200 # type: textblock
7201 #. type: textblock
7202 #: ../src/guestfs-actions.pod:445 ../fish/guestfish-actions.pod:295
7203 msgid "Load files into the tree."
7204 msgstr ""
7205
7206 # type: textblock
7207 #. type: textblock
7208 #: ../src/guestfs-actions.pod:447 ../fish/guestfish-actions.pod:297
7209 msgid "See C<aug_load> in the Augeas documentation for the full gory details."
7210 msgstr ""
7211
7212 # type: =head2
7213 #. type: =head2
7214 #: ../src/guestfs-actions.pod:454
7215 msgid "guestfs_aug_ls"
7216 msgstr ""
7217
7218 # type: verbatim
7219 #. type: verbatim
7220 #: ../src/guestfs-actions.pod:456
7221 #, no-wrap
7222 msgid ""
7223 " char **\n"
7224 " guestfs_aug_ls (guestfs_h *g,\n"
7225 "                 const char *augpath);\n"
7226 "\n"
7227 msgstr ""
7228
7229 # type: textblock
7230 #. type: textblock
7231 #: ../src/guestfs-actions.pod:460
7232 msgid ""
7233 "This is just a shortcut for listing C<guestfs_aug_match> C<path/*> and "
7234 "sorting the resulting nodes into alphabetical order."
7235 msgstr ""
7236
7237 # type: textblock
7238 #. type: textblock
7239 #: ../src/guestfs-actions.pod:463 ../src/guestfs-actions.pod:479
7240 #: ../src/guestfs-actions.pod:625 ../src/guestfs-actions.pod:1073
7241 #: ../src/guestfs-actions.pod:1364 ../src/guestfs-actions.pod:1383
7242 #: ../src/guestfs-actions.pod:1486 ../src/guestfs-actions.pod:1505
7243 #: ../src/guestfs-actions.pod:1754 ../src/guestfs-actions.pod:2196
7244 #: ../src/guestfs-actions.pod:2212 ../src/guestfs-actions.pod:2231
7245 #: ../src/guestfs-actions.pod:2274 ../src/guestfs-actions.pod:2298
7246 #: ../src/guestfs-actions.pod:2369 ../src/guestfs-actions.pod:2418
7247 #: ../src/guestfs-actions.pod:2633 ../src/guestfs-actions.pod:2918
7248 #: ../src/guestfs-actions.pod:3186 ../src/guestfs-actions.pod:3471
7249 #: ../src/guestfs-actions.pod:3533 ../src/guestfs-actions.pod:3638
7250 #: ../src/guestfs-actions.pod:4043 ../src/guestfs-actions.pod:4741
7251 #: ../src/guestfs-actions.pod:5261 ../src/guestfs-actions.pod:5387
7252 #: ../src/guestfs-actions.pod:5501 ../src/guestfs-actions.pod:6201
7253 #: ../src/guestfs-actions.pod:6262 ../src/guestfs-actions.pod:6317
7254 #: ../src/guestfs-actions.pod:6463 ../src/guestfs-actions.pod:6487
7255 #: ../src/guestfs-actions.pod:6969 ../src/guestfs-actions.pod:6989
7256 #: ../src/guestfs-actions.pod:7036 ../src/guestfs-actions.pod:7201
7257 #: ../src/guestfs-actions.pod:7220 ../src/guestfs-actions.pod:7305
7258 #: ../src/guestfs-actions.pod:7324 ../src/guestfs-actions.pod:7370
7259 #: ../src/guestfs-actions.pod:7389
7260 msgid ""
7261 "This function returns a NULL-terminated array of strings (like L<environ(3)"
7262 ">), or NULL if there was an error.  I<The caller must free the strings and "
7263 "the array after use>."
7264 msgstr ""
7265
7266 # type: textblock
7267 #. type: textblock
7268 #: ../src/guestfs-actions.pod:467 ../src/guestfs-actions.pod:998
7269 #: ../src/guestfs-actions.pod:1016 ../src/guestfs-actions.pod:1421
7270 #: ../src/guestfs-actions.pod:3264 ../src/guestfs-actions.pod:3295
7271 #: ../src/guestfs-actions.pod:3884 ../src/guestfs-actions.pod:3934
7272 #: ../src/guestfs-actions.pod:4121 ../src/guestfs-actions.pod:4154
7273 #: ../src/guestfs-actions.pod:4317 ../src/guestfs-actions.pod:4745
7274 #: ../src/guestfs-actions.pod:5202 ../src/guestfs-actions.pod:5597
7275 #: ../src/guestfs-actions.pod:5611 ../src/guestfs-actions.pod:5623
7276 #: ../src/guestfs-actions.pod:6063 ../src/guestfs-actions.pod:6701
7277 #: ../src/guestfs-actions.pod:6714 ../src/guestfs-actions.pod:6953
7278 #: ../src/guestfs-actions.pod:7189
7279 msgid "(Added in 0.8)"
7280 msgstr ""
7281
7282 # type: =head2
7283 #. type: =head2
7284 #: ../src/guestfs-actions.pod:469
7285 msgid "guestfs_aug_match"
7286 msgstr ""
7287
7288 # type: verbatim
7289 #. type: verbatim
7290 #: ../src/guestfs-actions.pod:471
7291 #, no-wrap
7292 msgid ""
7293 " char **\n"
7294 " guestfs_aug_match (guestfs_h *g,\n"
7295 "                    const char *augpath);\n"
7296 "\n"
7297 msgstr ""
7298
7299 # type: textblock
7300 #. type: textblock
7301 #: ../src/guestfs-actions.pod:475 ../fish/guestfish-actions.pod:311
7302 msgid ""
7303 "Returns a list of paths which match the path expression C<path>.  The "
7304 "returned paths are sufficiently qualified so that they match exactly one "
7305 "node in the current tree."
7306 msgstr ""
7307
7308 # type: =head2
7309 #. type: =head2
7310 #: ../src/guestfs-actions.pod:485
7311 msgid "guestfs_aug_mv"
7312 msgstr ""
7313
7314 # type: verbatim
7315 #. type: verbatim
7316 #: ../src/guestfs-actions.pod:487
7317 #, no-wrap
7318 msgid ""
7319 " int\n"
7320 " guestfs_aug_mv (guestfs_h *g,\n"
7321 "                 const char *src,\n"
7322 "                 const char *dest);\n"
7323 "\n"
7324 msgstr ""
7325
7326 # type: textblock
7327 #. type: textblock
7328 #: ../src/guestfs-actions.pod:492 ../fish/guestfish-actions.pod:319
7329 msgid ""
7330 "Move the node C<src> to C<dest>.  C<src> must match exactly one node.  "
7331 "C<dest> is overwritten if it exists."
7332 msgstr ""
7333
7334 # type: =head2
7335 #. type: =head2
7336 #: ../src/guestfs-actions.pod:499
7337 msgid "guestfs_aug_rm"
7338 msgstr ""
7339
7340 # type: verbatim
7341 #. type: verbatim
7342 #: ../src/guestfs-actions.pod:501
7343 #, no-wrap
7344 msgid ""
7345 " int\n"
7346 " guestfs_aug_rm (guestfs_h *g,\n"
7347 "                 const char *augpath);\n"
7348 "\n"
7349 msgstr ""
7350
7351 # type: textblock
7352 #. type: textblock
7353 #: ../src/guestfs-actions.pod:505 ../fish/guestfish-actions.pod:326
7354 msgid "Remove C<path> and all of its children."
7355 msgstr ""
7356
7357 # type: textblock
7358 #. type: textblock
7359 #: ../src/guestfs-actions.pod:507 ../fish/guestfish-actions.pod:328
7360 msgid "On success this returns the number of entries which were removed."
7361 msgstr ""
7362
7363 # type: =head2
7364 #. type: =head2
7365 #: ../src/guestfs-actions.pod:513
7366 msgid "guestfs_aug_save"
7367 msgstr ""
7368
7369 # type: verbatim
7370 #. type: verbatim
7371 #: ../src/guestfs-actions.pod:515
7372 #, no-wrap
7373 msgid ""
7374 " int\n"
7375 " guestfs_aug_save (guestfs_h *g);\n"
7376 "\n"
7377 msgstr ""
7378
7379 # type: textblock
7380 #. type: textblock
7381 #: ../src/guestfs-actions.pod:518 ../fish/guestfish-actions.pod:334
7382 msgid "This writes all pending changes to disk."
7383 msgstr ""
7384
7385 # type: textblock
7386 #. type: textblock
7387 #: ../src/guestfs-actions.pod:520
7388 msgid ""
7389 "The flags which were passed to C<guestfs_aug_init> affect exactly how files "
7390 "are saved."
7391 msgstr ""
7392
7393 # type: =head2
7394 #. type: =head2
7395 #: ../src/guestfs-actions.pod:527
7396 msgid "guestfs_aug_set"
7397 msgstr ""
7398
7399 # type: verbatim
7400 #. type: verbatim
7401 #: ../src/guestfs-actions.pod:529
7402 #, no-wrap
7403 msgid ""
7404 " int\n"
7405 " guestfs_aug_set (guestfs_h *g,\n"
7406 "                  const char *augpath,\n"
7407 "                  const char *val);\n"
7408 "\n"
7409 msgstr ""
7410
7411 # type: textblock
7412 #. type: textblock
7413 #: ../src/guestfs-actions.pod:534 ../fish/guestfish-actions.pod:343
7414 msgid "Set the value associated with C<path> to C<val>."
7415 msgstr ""
7416
7417 # type: textblock
7418 #. type: textblock
7419 #: ../src/guestfs-actions.pod:536
7420 msgid ""
7421 "In the Augeas API, it is possible to clear a node by setting the value to "
7422 "NULL.  Due to an oversight in the libguestfs API you cannot do that with "
7423 "this call.  Instead you must use the C<guestfs_aug_clear> call."
7424 msgstr ""
7425
7426 # type: =head2
7427 #. type: =head2
7428 #: ../src/guestfs-actions.pod:545
7429 msgid "guestfs_available"
7430 msgstr ""
7431
7432 # type: verbatim
7433 #. type: verbatim
7434 #: ../src/guestfs-actions.pod:547
7435 #, no-wrap
7436 msgid ""
7437 " int\n"
7438 " guestfs_available (guestfs_h *g,\n"
7439 "                    char *const *groups);\n"
7440 "\n"
7441 msgstr ""
7442
7443 # type: textblock
7444 #. type: textblock
7445 #: ../src/guestfs-actions.pod:551 ../fish/guestfish-actions.pod:354
7446 msgid ""
7447 "This command is used to check the availability of some groups of "
7448 "functionality in the appliance, which not all builds of the libguestfs "
7449 "appliance will be able to provide."
7450 msgstr ""
7451
7452 # type: textblock
7453 #. type: textblock
7454 #: ../src/guestfs-actions.pod:555
7455 msgid ""
7456 "The libguestfs groups, and the functions that those groups correspond to, "
7457 "are listed in L<guestfs(3)/AVAILABILITY>.  You can also fetch this list at "
7458 "runtime by calling C<guestfs_available_all_groups>."
7459 msgstr ""
7460
7461 # type: textblock
7462 #. type: textblock
7463 #: ../src/guestfs-actions.pod:560 ../fish/guestfish-actions.pod:363
7464 msgid ""
7465 "The argument C<groups> is a list of group names, eg: C<[\"inotify\", \"augeas"
7466 "\"]> would check for the availability of the Linux inotify functions and "
7467 "Augeas (configuration file editing) functions."
7468 msgstr ""
7469
7470 # type: textblock
7471 #. type: textblock
7472 #: ../src/guestfs-actions.pod:565 ../fish/guestfish-actions.pod:368
7473 msgid "The command returns no error if I<all> requested groups are available."
7474 msgstr ""
7475
7476 # type: textblock
7477 #. type: textblock
7478 #: ../src/guestfs-actions.pod:567 ../fish/guestfish-actions.pod:370
7479 msgid ""
7480 "It fails with an error if one or more of the requested groups is unavailable "
7481 "in the appliance."
7482 msgstr ""
7483
7484 # type: textblock
7485 #. type: textblock
7486 #: ../src/guestfs-actions.pod:570 ../fish/guestfish-actions.pod:373
7487 msgid ""
7488 "If an unknown group name is included in the list of groups then an error is "
7489 "always returned."
7490 msgstr ""
7491
7492 # type: textblock
7493 #. type: textblock
7494 #: ../src/guestfs-actions.pod:573 ../fish/guestfish-actions.pod:376
7495 msgid "I<Notes:>"
7496 msgstr ""
7497
7498 # type: textblock
7499 #. type: textblock
7500 #: ../src/guestfs-actions.pod:579
7501 msgid "You must call C<guestfs_launch> before calling this function."
7502 msgstr ""
7503
7504 # type: textblock
7505 #. type: textblock
7506 #: ../src/guestfs-actions.pod:581 ../fish/guestfish-actions.pod:384
7507 msgid ""
7508 "The reason is because we don't know what groups are supported by the "
7509 "appliance/daemon until it is running and can be queried."
7510 msgstr ""
7511
7512 # type: textblock
7513 #. type: textblock
7514 #: ../src/guestfs-actions.pod:587 ../fish/guestfish-actions.pod:390
7515 msgid ""
7516 "If a group of functions is available, this does not necessarily mean that "
7517 "they will work.  You still have to check for errors when calling individual "
7518 "API functions even if they are available."
7519 msgstr ""
7520
7521 # type: textblock
7522 #. type: textblock
7523 #: ../src/guestfs-actions.pod:594 ../fish/guestfish-actions.pod:397
7524 msgid ""
7525 "It is usually the job of distro packagers to build complete functionality "
7526 "into the libguestfs appliance.  Upstream libguestfs, if built from source "
7527 "with all requirements satisfied, will support everything."
7528 msgstr ""
7529
7530 # type: textblock
7531 #. type: textblock
7532 #: ../src/guestfs-actions.pod:601
7533 msgid ""
7534 "This call was added in version C<1.0.80>.  In previous versions of "
7535 "libguestfs all you could do would be to speculatively execute a command to "
7536 "find out if the daemon implemented it.  See also C<guestfs_version>."
7537 msgstr ""
7538
7539 # type: textblock
7540 #. type: textblock
7541 #: ../src/guestfs-actions.pod:610 ../src/guestfs-actions.pod:1171
7542 msgid "(Added in 1.0.80)"
7543 msgstr ""
7544
7545 # type: =head2
7546 #. type: =head2
7547 #: ../src/guestfs-actions.pod:612
7548 msgid "guestfs_available_all_groups"
7549 msgstr ""
7550
7551 # type: verbatim
7552 #. type: verbatim
7553 #: ../src/guestfs-actions.pod:614
7554 #, no-wrap
7555 msgid ""
7556 " char **\n"
7557 " guestfs_available_all_groups (guestfs_h *g);\n"
7558 "\n"
7559 msgstr ""
7560
7561 # type: textblock
7562 #. type: textblock
7563 #: ../src/guestfs-actions.pod:617
7564 msgid ""
7565 "This command returns a list of all optional groups that this daemon knows "
7566 "about.  Note this returns both supported and unsupported groups.  To find "
7567 "out which ones the daemon can actually support you have to call "
7568 "C<guestfs_available> on each member of the returned list."
7569 msgstr ""
7570
7571 # type: textblock
7572 #. type: textblock
7573 #: ../src/guestfs-actions.pod:623
7574 msgid "See also C<guestfs_available> and L<guestfs(3)/AVAILABILITY>."
7575 msgstr ""
7576
7577 # type: textblock
7578 #. type: textblock
7579 #: ../src/guestfs-actions.pod:629
7580 msgid "(Added in 1.3.15)"
7581 msgstr ""
7582
7583 # type: =head2
7584 #. type: =head2
7585 #: ../src/guestfs-actions.pod:631
7586 msgid "guestfs_base64_in"
7587 msgstr ""
7588
7589 # type: verbatim
7590 #. type: verbatim
7591 #: ../src/guestfs-actions.pod:633
7592 #, no-wrap
7593 msgid ""
7594 " int\n"
7595 " guestfs_base64_in (guestfs_h *g,\n"
7596 "                    const char *base64file,\n"
7597 "                    const char *filename);\n"
7598 "\n"
7599 msgstr ""
7600
7601 # type: textblock
7602 #. type: textblock
7603 #: ../src/guestfs-actions.pod:638 ../fish/guestfish-actions.pod:427
7604 msgid ""
7605 "This command uploads base64-encoded data from C<base64file> to C<filename>."
7606 msgstr ""
7607
7608 # type: textblock
7609 #. type: textblock
7610 #: ../src/guestfs-actions.pod:643 ../src/guestfs-actions.pod:657
7611 msgid "(Added in 1.3.5)"
7612 msgstr ""
7613
7614 # type: =head2
7615 #. type: =head2
7616 #: ../src/guestfs-actions.pod:645
7617 msgid "guestfs_base64_out"
7618 msgstr ""
7619
7620 # type: verbatim
7621 #. type: verbatim
7622 #: ../src/guestfs-actions.pod:647
7623 #, no-wrap
7624 msgid ""
7625 " int\n"
7626 " guestfs_base64_out (guestfs_h *g,\n"
7627 "                     const char *filename,\n"
7628 "                     const char *base64file);\n"
7629 "\n"
7630 msgstr ""
7631
7632 # type: textblock
7633 #. type: textblock
7634 #: ../src/guestfs-actions.pod:652 ../fish/guestfish-actions.pod:436
7635 msgid ""
7636 "This command downloads the contents of C<filename>, writing it out to local "
7637 "file C<base64file> encoded as base64."
7638 msgstr ""
7639
7640 # type: =head2
7641 #. type: =head2
7642 #: ../src/guestfs-actions.pod:659
7643 msgid "guestfs_blockdev_flushbufs"
7644 msgstr ""
7645
7646 # type: verbatim
7647 #. type: verbatim
7648 #: ../src/guestfs-actions.pod:661
7649 #, no-wrap
7650 msgid ""
7651 " int\n"
7652 " guestfs_blockdev_flushbufs (guestfs_h *g,\n"
7653 "                             const char *device);\n"
7654 "\n"
7655 msgstr ""
7656
7657 # type: textblock
7658 #. type: textblock
7659 #: ../src/guestfs-actions.pod:665 ../fish/guestfish-actions.pod:445
7660 msgid ""
7661 "This tells the kernel to flush internal buffers associated with C<device>."
7662 msgstr ""
7663
7664 # type: textblock
7665 #. type: textblock
7666 #: ../src/guestfs-actions.pod:668 ../src/guestfs-actions.pod:685
7667 #: ../src/guestfs-actions.pod:700 ../src/guestfs-actions.pod:716
7668 #: ../src/guestfs-actions.pod:734 ../src/guestfs-actions.pod:753
7669 #: ../src/guestfs-actions.pod:767 ../src/guestfs-actions.pod:785
7670 #: ../src/guestfs-actions.pod:799 ../src/guestfs-actions.pod:813
7671 #: ../fish/guestfish-actions.pod:448 ../fish/guestfish-actions.pod:459
7672 #: ../fish/guestfish-actions.pod:468 ../fish/guestfish-actions.pod:478
7673 #: ../fish/guestfish-actions.pod:490 ../fish/guestfish-actions.pod:503
7674 #: ../fish/guestfish-actions.pod:511 ../fish/guestfish-actions.pod:522
7675 #: ../fish/guestfish-actions.pod:530 ../fish/guestfish-actions.pod:538
7676 msgid "This uses the L<blockdev(8)> command."
7677 msgstr ""
7678
7679 # type: textblock
7680 #. type: textblock
7681 #: ../src/guestfs-actions.pod:672 ../src/guestfs-actions.pod:689
7682 #: ../src/guestfs-actions.pod:704 ../src/guestfs-actions.pod:720
7683 #: ../src/guestfs-actions.pod:738 ../src/guestfs-actions.pod:757
7684 #: ../src/guestfs-actions.pod:771 ../src/guestfs-actions.pod:789
7685 #: ../src/guestfs-actions.pod:803 ../src/guestfs-actions.pod:817
7686 msgid "(Added in 0.9.3)"
7687 msgstr ""
7688
7689 # type: =head2
7690 #. type: =head2
7691 #: ../src/guestfs-actions.pod:674
7692 msgid "guestfs_blockdev_getbsz"
7693 msgstr ""
7694
7695 # type: verbatim
7696 #. type: verbatim
7697 #: ../src/guestfs-actions.pod:676
7698 #, no-wrap
7699 msgid ""
7700 " int\n"
7701 " guestfs_blockdev_getbsz (guestfs_h *g,\n"
7702 "                          const char *device);\n"
7703 "\n"
7704 msgstr ""
7705
7706 # type: textblock
7707 #. type: textblock
7708 #: ../src/guestfs-actions.pod:680 ../fish/guestfish-actions.pod:454
7709 msgid "This returns the block size of a device."
7710 msgstr ""
7711
7712 # type: textblock
7713 #. type: textblock
7714 #: ../src/guestfs-actions.pod:682 ../src/guestfs-actions.pod:782
7715 #: ../fish/guestfish-actions.pod:456 ../fish/guestfish-actions.pod:519
7716 msgid ""
7717 "(Note this is different from both I<size in blocks> and I<filesystem block "
7718 "size>)."
7719 msgstr ""
7720
7721 # type: =head2
7722 #. type: =head2
7723 #: ../src/guestfs-actions.pod:691
7724 msgid "guestfs_blockdev_getro"
7725 msgstr ""
7726
7727 # type: verbatim
7728 #. type: verbatim
7729 #: ../src/guestfs-actions.pod:693
7730 #, no-wrap
7731 msgid ""
7732 " int\n"
7733 " guestfs_blockdev_getro (guestfs_h *g,\n"
7734 "                         const char *device);\n"
7735 "\n"
7736 msgstr ""
7737
7738 # type: textblock
7739 #. type: textblock
7740 #: ../src/guestfs-actions.pod:697 ../fish/guestfish-actions.pod:465
7741 msgid ""
7742 "Returns a boolean indicating if the block device is read-only (true if read-"
7743 "only, false if not)."
7744 msgstr ""
7745
7746 # type: textblock
7747 #. type: textblock
7748 #: ../src/guestfs-actions.pod:702 ../src/guestfs-actions.pod:1404
7749 #: ../src/guestfs-actions.pod:1419 ../src/guestfs-actions.pod:1909
7750 #: ../src/guestfs-actions.pod:1920 ../src/guestfs-actions.pod:1992
7751 #: ../src/guestfs-actions.pod:2047 ../src/guestfs-actions.pod:2062
7752 #: ../src/guestfs-actions.pod:2087 ../src/guestfs-actions.pod:2110
7753 #: ../src/guestfs-actions.pod:3004 ../src/guestfs-actions.pod:3021
7754 #: ../src/guestfs-actions.pod:3040 ../src/guestfs-actions.pod:3203
7755 #: ../src/guestfs-actions.pod:3217 ../src/guestfs-actions.pod:3232
7756 #: ../src/guestfs-actions.pod:3246 ../src/guestfs-actions.pod:3262
7757 #: ../src/guestfs-actions.pod:3277 ../src/guestfs-actions.pod:3293
7758 #: ../src/guestfs-actions.pod:3307 ../src/guestfs-actions.pod:3320
7759 #: ../src/guestfs-actions.pod:3334 ../src/guestfs-actions.pod:3349
7760 #: ../src/guestfs-actions.pod:3364 ../src/guestfs-actions.pod:4890
7761 msgid "This function returns a C truth value on success or -1 on error."
7762 msgstr ""
7763
7764 # type: =head2
7765 #. type: =head2
7766 #: ../src/guestfs-actions.pod:706
7767 msgid "guestfs_blockdev_getsize64"
7768 msgstr ""
7769
7770 # type: verbatim
7771 #. type: verbatim
7772 #: ../src/guestfs-actions.pod:708
7773 #, no-wrap
7774 msgid ""
7775 " int64_t\n"
7776 " guestfs_blockdev_getsize64 (guestfs_h *g,\n"
7777 "                             const char *device);\n"
7778 "\n"
7779 msgstr ""
7780
7781 # type: textblock
7782 #. type: textblock
7783 #: ../src/guestfs-actions.pod:712 ../fish/guestfish-actions.pod:474
7784 msgid "This returns the size of the device in bytes."
7785 msgstr ""
7786
7787 # type: textblock
7788 #. type: textblock
7789 #: ../src/guestfs-actions.pod:714
7790 msgid "See also C<guestfs_blockdev_getsz>."
7791 msgstr ""
7792
7793 # type: =head2
7794 #. type: =head2
7795 #: ../src/guestfs-actions.pod:722
7796 msgid "guestfs_blockdev_getss"
7797 msgstr ""
7798
7799 # type: verbatim
7800 #. type: verbatim
7801 #: ../src/guestfs-actions.pod:724
7802 #, no-wrap
7803 msgid ""
7804 " int\n"
7805 " guestfs_blockdev_getss (guestfs_h *g,\n"
7806 "                         const char *device);\n"
7807 "\n"
7808 msgstr ""
7809
7810 # type: textblock
7811 #. type: textblock
7812 #: ../src/guestfs-actions.pod:728 ../fish/guestfish-actions.pod:484
7813 msgid ""
7814 "This returns the size of sectors on a block device.  Usually 512, but can be "
7815 "larger for modern devices."
7816 msgstr ""
7817
7818 # type: textblock
7819 #. type: textblock
7820 #: ../src/guestfs-actions.pod:731
7821 msgid ""
7822 "(Note, this is not the size in sectors, use C<guestfs_blockdev_getsz> for "
7823 "that)."
7824 msgstr ""
7825
7826 # type: =head2
7827 #. type: =head2
7828 #: ../src/guestfs-actions.pod:740
7829 msgid "guestfs_blockdev_getsz"
7830 msgstr ""
7831
7832 # type: verbatim
7833 #. type: verbatim
7834 #: ../src/guestfs-actions.pod:742
7835 #, no-wrap
7836 msgid ""
7837 " int64_t\n"
7838 " guestfs_blockdev_getsz (guestfs_h *g,\n"
7839 "                         const char *device);\n"
7840 "\n"
7841 msgstr ""
7842
7843 # type: textblock
7844 #. type: textblock
7845 #: ../src/guestfs-actions.pod:746 ../fish/guestfish-actions.pod:496
7846 msgid ""
7847 "This returns the size of the device in units of 512-byte sectors (even if "
7848 "the sectorsize isn't 512 bytes ... weird)."
7849 msgstr ""
7850
7851 # type: textblock
7852 #. type: textblock
7853 #: ../src/guestfs-actions.pod:749
7854 msgid ""
7855 "See also C<guestfs_blockdev_getss> for the real sector size of the device, "
7856 "and C<guestfs_blockdev_getsize64> for the more useful I<size in bytes>."
7857 msgstr ""
7858
7859 # type: =head2
7860 #. type: =head2
7861 #: ../src/guestfs-actions.pod:759
7862 msgid "guestfs_blockdev_rereadpt"
7863 msgstr ""
7864
7865 # type: verbatim
7866 #. type: verbatim
7867 #: ../src/guestfs-actions.pod:761
7868 #, no-wrap
7869 msgid ""
7870 " int\n"
7871 " guestfs_blockdev_rereadpt (guestfs_h *g,\n"
7872 "                            const char *device);\n"
7873 "\n"
7874 msgstr ""
7875
7876 # type: textblock
7877 #. type: textblock
7878 #: ../src/guestfs-actions.pod:765 ../fish/guestfish-actions.pod:509
7879 msgid "Reread the partition table on C<device>."
7880 msgstr ""
7881
7882 # type: =head2
7883 #. type: =head2
7884 #: ../src/guestfs-actions.pod:773
7885 msgid "guestfs_blockdev_setbsz"
7886 msgstr ""
7887
7888 # type: verbatim
7889 #. type: verbatim
7890 #: ../src/guestfs-actions.pod:775
7891 #, no-wrap
7892 msgid ""
7893 " int\n"
7894 " guestfs_blockdev_setbsz (guestfs_h *g,\n"
7895 "                          const char *device,\n"
7896 "                          int blocksize);\n"
7897 "\n"
7898 msgstr ""
7899
7900 # type: textblock
7901 #. type: textblock
7902 #: ../src/guestfs-actions.pod:780 ../fish/guestfish-actions.pod:517
7903 msgid "This sets the block size of a device."
7904 msgstr ""
7905
7906 # type: =head2
7907 #. type: =head2
7908 #: ../src/guestfs-actions.pod:791
7909 msgid "guestfs_blockdev_setro"
7910 msgstr ""
7911
7912 # type: verbatim
7913 #. type: verbatim
7914 #: ../src/guestfs-actions.pod:793
7915 #, no-wrap
7916 msgid ""
7917 " int\n"
7918 " guestfs_blockdev_setro (guestfs_h *g,\n"
7919 "                         const char *device);\n"
7920 "\n"
7921 msgstr ""
7922
7923 # type: textblock
7924 #. type: textblock
7925 #: ../src/guestfs-actions.pod:797 ../fish/guestfish-actions.pod:528
7926 msgid "Sets the block device named C<device> to read-only."
7927 msgstr ""
7928
7929 # type: =head2
7930 #. type: =head2
7931 #: ../src/guestfs-actions.pod:805
7932 msgid "guestfs_blockdev_setrw"
7933 msgstr ""
7934
7935 # type: verbatim
7936 #. type: verbatim
7937 #: ../src/guestfs-actions.pod:807
7938 #, no-wrap
7939 msgid ""
7940 " int\n"
7941 " guestfs_blockdev_setrw (guestfs_h *g,\n"
7942 "                         const char *device);\n"
7943 "\n"
7944 msgstr ""
7945
7946 # type: textblock
7947 #. type: textblock
7948 #: ../src/guestfs-actions.pod:811 ../fish/guestfish-actions.pod:536
7949 msgid "Sets the block device named C<device> to read-write."
7950 msgstr ""
7951
7952 # type: =head2
7953 #. type: =head2
7954 #: ../src/guestfs-actions.pod:819
7955 msgid "guestfs_case_sensitive_path"
7956 msgstr ""
7957
7958 # type: verbatim
7959 #. type: verbatim
7960 #: ../src/guestfs-actions.pod:821
7961 #, no-wrap
7962 msgid ""
7963 " char *\n"
7964 " guestfs_case_sensitive_path (guestfs_h *g,\n"
7965 "                              const char *path);\n"
7966 "\n"
7967 msgstr ""
7968
7969 # type: textblock
7970 #. type: textblock
7971 #: ../src/guestfs-actions.pod:825 ../fish/guestfish-actions.pod:544
7972 msgid ""
7973 "This can be used to resolve case insensitive paths on a filesystem which is "
7974 "case sensitive.  The use case is to resolve paths which you have read from "
7975 "Windows configuration files or the Windows Registry, to the true path."
7976 msgstr ""
7977
7978 # type: textblock
7979 #. type: textblock
7980 #: ../src/guestfs-actions.pod:830 ../fish/guestfish-actions.pod:549
7981 msgid ""
7982 "The command handles a peculiarity of the Linux ntfs-3g filesystem driver "
7983 "(and probably others), which is that although the underlying filesystem is "
7984 "case-insensitive, the driver exports the filesystem to Linux as case-"
7985 "sensitive."
7986 msgstr ""
7987
7988 # type: textblock
7989 #. type: textblock
7990 #: ../src/guestfs-actions.pod:835 ../fish/guestfish-actions.pod:554
7991 msgid ""
7992 "One consequence of this is that special directories such as C<c:\\windows> "
7993 "may appear as C</WINDOWS> or C</windows> (or other things) depending on the "
7994 "precise details of how they were created.  In Windows itself this would not "
7995 "be a problem."
7996 msgstr ""
7997
7998 # type: textblock
7999 #. type: textblock
8000 #: ../src/guestfs-actions.pod:841 ../fish/guestfish-actions.pod:560
8001 msgid ""
8002 "Bug or feature? You decide: L<http://www.tuxera.com/community/ntfs-3g-faq/"
8003 "#posixfilenames1>"
8004 msgstr ""
8005
8006 # type: textblock
8007 #. type: textblock
8008 #: ../src/guestfs-actions.pod:844 ../fish/guestfish-actions.pod:563
8009 msgid ""
8010 "This function resolves the true case of each element in the path and returns "
8011 "the case-sensitive path."
8012 msgstr ""
8013
8014 # type: textblock
8015 #. type: textblock
8016 #: ../src/guestfs-actions.pod:847
8017 msgid ""
8018 "Thus C<guestfs_case_sensitive_path> (\"/Windows/System32\")  might return C<"
8019 "\"/WINDOWS/system32\"> (the exact return value would depend on details of "
8020 "how the directories were originally created under Windows)."
8021 msgstr ""
8022
8023 # type: textblock
8024 #. type: textblock
8025 #: ../src/guestfs-actions.pod:852 ../fish/guestfish-actions.pod:571
8026 msgid "I<Note>: This function does not handle drive names, backslashes etc."
8027 msgstr ""
8028
8029 # type: textblock
8030 #. type: textblock
8031 #: ../src/guestfs-actions.pod:855
8032 msgid "See also C<guestfs_realpath>."
8033 msgstr ""
8034
8035 # type: textblock
8036 #. type: textblock
8037 #: ../src/guestfs-actions.pod:860 ../src/guestfs-actions.pod:6881
8038 msgid "(Added in 1.0.75)"
8039 msgstr ""
8040
8041 # type: =head2
8042 #. type: =head2
8043 #: ../src/guestfs-actions.pod:862
8044 msgid "guestfs_cat"
8045 msgstr ""
8046
8047 # type: verbatim
8048 #. type: verbatim
8049 #: ../src/guestfs-actions.pod:864
8050 #, no-wrap
8051 msgid ""
8052 " char *\n"
8053 " guestfs_cat (guestfs_h *g,\n"
8054 "              const char *path);\n"
8055 "\n"
8056 msgstr ""
8057
8058 # type: textblock
8059 #. type: textblock
8060 #: ../src/guestfs-actions.pod:868 ../src/guestfs-actions.pod:5377
8061 #: ../fish/guestfish-actions.pod:580 ../fish/guestfish-actions.pod:3601
8062 msgid "Return the contents of the file named C<path>."
8063 msgstr ""
8064
8065 # type: textblock
8066 #. type: textblock
8067 #: ../src/guestfs-actions.pod:870
8068 msgid ""
8069 "Note that this function cannot correctly handle binary files (specifically, "
8070 "files containing C<\\0> character which is treated as end of string).  For "
8071 "those you need to use the C<guestfs_read_file> or C<guestfs_download> "
8072 "functions which have a more complex interface."
8073 msgstr ""
8074
8075 # type: textblock
8076 #. type: textblock
8077 #: ../src/guestfs-actions.pod:878 ../src/guestfs-actions.pod:1057
8078 #: ../src/guestfs-actions.pod:1077 ../src/guestfs-actions.pod:1368
8079 #: ../src/guestfs-actions.pod:1387 ../src/guestfs-actions.pod:1490
8080 #: ../src/guestfs-actions.pod:1509 ../src/guestfs-actions.pod:1758
8081 #: ../src/guestfs-actions.pod:2216 ../src/guestfs-actions.pod:2235
8082 #: ../src/guestfs-actions.pod:2278 ../src/guestfs-actions.pod:2302
8083 #: ../src/guestfs-actions.pod:2319 ../src/guestfs-actions.pod:2348
8084 #: ../src/guestfs-actions.pod:5159 ../src/guestfs-actions.pod:5185
8085 #: ../src/guestfs-actions.pod:5316 ../src/guestfs-actions.pod:5342
8086 #: ../src/guestfs-actions.pod:5366 ../src/guestfs-actions.pod:6266
8087 #: ../src/guestfs-actions.pod:6321 ../src/guestfs-actions.pod:6467
8088 #: ../src/guestfs-actions.pod:6491 ../src/guestfs-actions.pod:7153
8089 #: ../src/guestfs-actions.pod:7179 ../src/guestfs-actions.pod:7205
8090 #: ../src/guestfs-actions.pod:7224 ../src/guestfs-actions.pod:7309
8091 #: ../src/guestfs-actions.pod:7328 ../src/guestfs-actions.pod:7374
8092 #: ../src/guestfs-actions.pod:7393 ../fish/guestfish-actions.pod:587
8093 #: ../fish/guestfish-actions.pod:722 ../fish/guestfish-actions.pod:734
8094 #: ../fish/guestfish-actions.pod:910 ../fish/guestfish-actions.pod:920
8095 #: ../fish/guestfish-actions.pod:987 ../fish/guestfish-actions.pod:997
8096 #: ../fish/guestfish-actions.pod:1192 ../fish/guestfish-actions.pod:1493
8097 #: ../fish/guestfish-actions.pod:1503 ../fish/guestfish-actions.pod:1531
8098 #: ../fish/guestfish-actions.pod:1546 ../fish/guestfish-actions.pod:1556
8099 #: ../fish/guestfish-actions.pod:1575 ../fish/guestfish-actions.pod:3471
8100 #: ../fish/guestfish-actions.pod:3486 ../fish/guestfish-actions.pod:3562
8101 #: ../fish/guestfish-actions.pod:3579 ../fish/guestfish-actions.pod:3594
8102 #: ../fish/guestfish-actions.pod:4220 ../fish/guestfish-actions.pod:4266
8103 #: ../fish/guestfish-actions.pod:4351 ../fish/guestfish-actions.pod:4366
8104 #: ../fish/guestfish-actions.pod:4776 ../fish/guestfish-actions.pod:4794
8105 #: ../fish/guestfish-actions.pod:4811 ../fish/guestfish-actions.pod:4821
8106 #: ../fish/guestfish-actions.pod:4869 ../fish/guestfish-actions.pod:4879
8107 #: ../fish/guestfish-actions.pod:4908 ../fish/guestfish-actions.pod:4918
8108 msgid ""
8109 "Because of the message protocol, there is a transfer limit of somewhere "
8110 "between 2MB and 4MB.  See L<guestfs(3)/PROTOCOL LIMITS>."
8111 msgstr ""
8112
8113 # type: textblock
8114 #. type: textblock
8115 #: ../src/guestfs-actions.pod:881 ../src/guestfs-actions.pod:3475
8116 #: ../src/guestfs-actions.pod:3537 ../src/guestfs-actions.pod:3554
8117 #: ../src/guestfs-actions.pod:3642 ../src/guestfs-actions.pod:4047
8118 #: ../src/guestfs-actions.pod:4061 ../src/guestfs-actions.pod:5265
8119 #: ../src/guestfs-actions.pod:5279 ../src/guestfs-actions.pod:7040
8120 #: ../src/guestfs-actions.pod:7054
8121 msgid "(Added in 0.4)"
8122 msgstr ""
8123
8124 # type: =head2
8125 #. type: =head2
8126 #: ../src/guestfs-actions.pod:883
8127 msgid "guestfs_checksum"
8128 msgstr ""
8129
8130 # type: verbatim
8131 #. type: verbatim
8132 #: ../src/guestfs-actions.pod:885
8133 #, no-wrap
8134 msgid ""
8135 " char *\n"
8136 " guestfs_checksum (guestfs_h *g,\n"
8137 "                   const char *csumtype,\n"
8138 "                   const char *path);\n"
8139 "\n"
8140 msgstr ""
8141
8142 # type: textblock
8143 #. type: textblock
8144 #: ../src/guestfs-actions.pod:890 ../fish/guestfish-actions.pod:594
8145 msgid ""
8146 "This call computes the MD5, SHAx or CRC checksum of the file named C<path>."
8147 msgstr ""
8148
8149 # type: textblock
8150 #. type: textblock
8151 #: ../src/guestfs-actions.pod:893 ../fish/guestfish-actions.pod:597
8152 msgid ""
8153 "The type of checksum to compute is given by the C<csumtype> parameter which "
8154 "must have one of the following values:"
8155 msgstr ""
8156
8157 # type: =item
8158 #. type: =item
8159 #: ../src/guestfs-actions.pod:898 ../fish/guestfish-actions.pod:602
8160 msgid "C<crc>"
8161 msgstr ""
8162
8163 # type: textblock
8164 #. type: textblock
8165 #: ../src/guestfs-actions.pod:900 ../fish/guestfish-actions.pod:604
8166 msgid ""
8167 "Compute the cyclic redundancy check (CRC) specified by POSIX for the "
8168 "C<cksum> command."
8169 msgstr ""
8170
8171 # type: =item
8172 #. type: =item
8173 #: ../src/guestfs-actions.pod:903 ../fish/guestfish-actions.pod:607
8174 msgid "C<md5>"
8175 msgstr ""
8176
8177 # type: textblock
8178 #. type: textblock
8179 #: ../src/guestfs-actions.pod:905 ../fish/guestfish-actions.pod:609
8180 msgid "Compute the MD5 hash (using the C<md5sum> program)."
8181 msgstr ""
8182
8183 # type: =item
8184 #. type: =item
8185 #: ../src/guestfs-actions.pod:907 ../fish/guestfish-actions.pod:611
8186 msgid "C<sha1>"
8187 msgstr ""
8188
8189 # type: textblock
8190 #. type: textblock
8191 #: ../src/guestfs-actions.pod:909 ../fish/guestfish-actions.pod:613
8192 msgid "Compute the SHA1 hash (using the C<sha1sum> program)."
8193 msgstr ""
8194
8195 # type: =item
8196 #. type: =item
8197 #: ../src/guestfs-actions.pod:911 ../fish/guestfish-actions.pod:615
8198 msgid "C<sha224>"
8199 msgstr ""
8200
8201 # type: textblock
8202 #. type: textblock
8203 #: ../src/guestfs-actions.pod:913 ../fish/guestfish-actions.pod:617
8204 msgid "Compute the SHA224 hash (using the C<sha224sum> program)."
8205 msgstr ""
8206
8207 # type: =item
8208 #. type: =item
8209 #: ../src/guestfs-actions.pod:915 ../fish/guestfish-actions.pod:619
8210 msgid "C<sha256>"
8211 msgstr ""
8212
8213 # type: textblock
8214 #. type: textblock
8215 #: ../src/guestfs-actions.pod:917 ../fish/guestfish-actions.pod:621
8216 msgid "Compute the SHA256 hash (using the C<sha256sum> program)."
8217 msgstr ""
8218
8219 # type: =item
8220 #. type: =item
8221 #: ../src/guestfs-actions.pod:919 ../fish/guestfish-actions.pod:623
8222 msgid "C<sha384>"
8223 msgstr ""
8224
8225 # type: textblock
8226 #. type: textblock
8227 #: ../src/guestfs-actions.pod:921 ../fish/guestfish-actions.pod:625
8228 msgid "Compute the SHA384 hash (using the C<sha384sum> program)."
8229 msgstr ""
8230
8231 # type: =item
8232 #. type: =item
8233 #: ../src/guestfs-actions.pod:923 ../fish/guestfish-actions.pod:627
8234 msgid "C<sha512>"
8235 msgstr ""
8236
8237 # type: textblock
8238 #. type: textblock
8239 #: ../src/guestfs-actions.pod:925 ../fish/guestfish-actions.pod:629
8240 msgid "Compute the SHA512 hash (using the C<sha512sum> program)."
8241 msgstr ""
8242
8243 # type: textblock
8244 #. type: textblock
8245 #: ../src/guestfs-actions.pod:929 ../fish/guestfish-actions.pod:633
8246 msgid "The checksum is returned as a printable string."
8247 msgstr ""
8248
8249 # type: textblock
8250 #. type: textblock
8251 #: ../src/guestfs-actions.pod:931
8252 msgid "To get the checksum for a device, use C<guestfs_checksum_device>."
8253 msgstr ""
8254
8255 # type: textblock
8256 #. type: textblock
8257 #: ../src/guestfs-actions.pod:933
8258 msgid "To get the checksums for many files, use C<guestfs_checksums_out>."
8259 msgstr ""
8260
8261 # type: textblock
8262 #. type: textblock
8263 #: ../src/guestfs-actions.pod:938 ../src/guestfs-actions.pod:1246
8264 #: ../src/guestfs-actions.pod:2078 ../src/guestfs-actions.pod:3219
8265 #: ../src/guestfs-actions.pod:3248 ../src/guestfs-actions.pod:3309
8266 #: ../src/guestfs-actions.pod:3336 ../src/guestfs-actions.pod:6737
8267 msgid "(Added in 1.0.2)"
8268 msgstr ""
8269
8270 # type: =head2
8271 #. type: =head2
8272 #: ../src/guestfs-actions.pod:940
8273 msgid "guestfs_checksum_device"
8274 msgstr ""
8275
8276 # type: verbatim
8277 #. type: verbatim
8278 #: ../src/guestfs-actions.pod:942
8279 #, no-wrap
8280 msgid ""
8281 " char *\n"
8282 " guestfs_checksum_device (guestfs_h *g,\n"
8283 "                          const char *csumtype,\n"
8284 "                          const char *device);\n"
8285 "\n"
8286 msgstr ""
8287
8288 # type: textblock
8289 #. type: textblock
8290 #: ../src/guestfs-actions.pod:947
8291 msgid ""
8292 "This call computes the MD5, SHAx or CRC checksum of the contents of the "
8293 "device named C<device>.  For the types of checksums supported see the "
8294 "C<guestfs_checksum> command."
8295 msgstr ""
8296
8297 # type: textblock
8298 #. type: textblock
8299 #: ../src/guestfs-actions.pod:954 ../src/guestfs-actions.pod:4796
8300 #: ../src/guestfs-actions.pod:4855 ../src/guestfs-actions.pod:4892
8301 #: ../src/guestfs-actions.pod:4910 ../src/guestfs-actions.pod:5086
8302 #: ../src/guestfs-actions.pod:6646 ../src/guestfs-actions.pod:6660
8303 #: ../src/guestfs-actions.pod:7066
8304 msgid "(Added in 1.3.2)"
8305 msgstr ""
8306
8307 # type: =head2
8308 #. type: =head2
8309 #: ../src/guestfs-actions.pod:956
8310 msgid "guestfs_checksums_out"
8311 msgstr ""
8312
8313 # type: verbatim
8314 #. type: verbatim
8315 #: ../src/guestfs-actions.pod:958
8316 #, no-wrap
8317 msgid ""
8318 " int\n"
8319 " guestfs_checksums_out (guestfs_h *g,\n"
8320 "                        const char *csumtype,\n"
8321 "                        const char *directory,\n"
8322 "                        const char *sumsfile);\n"
8323 "\n"
8324 msgstr ""
8325
8326 # type: textblock
8327 #. type: textblock
8328 #: ../src/guestfs-actions.pod:964 ../fish/guestfish-actions.pod:651
8329 msgid ""
8330 "This command computes the checksums of all regular files in C<directory> and "
8331 "then emits a list of those checksums to the local output file C<sumsfile>."
8332 msgstr ""
8333
8334 # type: textblock
8335 #. type: textblock
8336 #: ../src/guestfs-actions.pod:968 ../fish/guestfish-actions.pod:655
8337 msgid ""
8338 "This can be used for verifying the integrity of a virtual machine.  However "
8339 "to be properly secure you should pay attention to the output of the checksum "
8340 "command (it uses the ones from GNU coreutils).  In particular when the "
8341 "filename is not printable, coreutils uses a special backslash syntax.  For "
8342 "more information, see the GNU coreutils info file."
8343 msgstr ""
8344
8345 # type: textblock
8346 #. type: textblock
8347 #: ../src/guestfs-actions.pod:978
8348 msgid "(Added in 1.3.7)"
8349 msgstr ""
8350
8351 # type: =head2
8352 #. type: =head2
8353 #: ../src/guestfs-actions.pod:980
8354 msgid "guestfs_chmod"
8355 msgstr ""
8356
8357 # type: verbatim
8358 #. type: verbatim
8359 #: ../src/guestfs-actions.pod:982
8360 #, no-wrap
8361 msgid ""
8362 " int\n"
8363 " guestfs_chmod (guestfs_h *g,\n"
8364 "                int mode,\n"
8365 "                const char *path);\n"
8366 "\n"
8367 msgstr ""
8368
8369 # type: textblock
8370 #. type: textblock
8371 #: ../src/guestfs-actions.pod:987 ../fish/guestfish-actions.pod:669
8372 msgid ""
8373 "Change the mode (permissions) of C<path> to C<mode>.  Only numeric modes are "
8374 "supported."
8375 msgstr ""
8376
8377 # type: textblock
8378 #. type: textblock
8379 #: ../src/guestfs-actions.pod:990 ../fish/guestfish-actions.pod:672
8380 msgid ""
8381 "I<Note>: When using this command from guestfish, C<mode> by default would be "
8382 "decimal, unless you prefix it with C<0> to get octal, ie. use C<0700> not "
8383 "C<700>."
8384 msgstr ""
8385
8386 # type: textblock
8387 #. type: textblock
8388 #: ../src/guestfs-actions.pod:994 ../src/guestfs-actions.pod:4298
8389 #: ../src/guestfs-actions.pod:4495 ../src/guestfs-actions.pod:4514
8390 #: ../src/guestfs-actions.pod:4533 ../fish/guestfish-actions.pod:676
8391 #: ../fish/guestfish-actions.pod:2917 ../fish/guestfish-actions.pod:3046
8392 #: ../fish/guestfish-actions.pod:3056 ../fish/guestfish-actions.pod:3066
8393 msgid "The mode actually set is affected by the umask."
8394 msgstr ""
8395
8396 # type: =head2
8397 #. type: =head2
8398 #: ../src/guestfs-actions.pod:1000
8399 msgid "guestfs_chown"
8400 msgstr ""
8401
8402 # type: verbatim
8403 #. type: verbatim
8404 #: ../src/guestfs-actions.pod:1002
8405 #, no-wrap
8406 msgid ""
8407 " int\n"
8408 " guestfs_chown (guestfs_h *g,\n"
8409 "                int owner,\n"
8410 "                int group,\n"
8411 "                const char *path);\n"
8412 "\n"
8413 msgstr ""
8414
8415 # type: textblock
8416 #. type: textblock
8417 #: ../src/guestfs-actions.pod:1008 ../fish/guestfish-actions.pod:682
8418 msgid "Change the file owner to C<owner> and group to C<group>."
8419 msgstr ""
8420
8421 # type: textblock
8422 #. type: textblock
8423 #: ../src/guestfs-actions.pod:1010 ../src/guestfs-actions.pod:3406
8424 #: ../fish/guestfish-actions.pod:684 ../fish/guestfish-actions.pod:2375
8425 msgid ""
8426 "Only numeric uid and gid are supported.  If you want to use names, you will "
8427 "need to locate and parse the password file yourself (Augeas support makes "
8428 "this relatively easy)."
8429 msgstr ""
8430
8431 # type: =head2
8432 #. type: =head2
8433 #: ../src/guestfs-actions.pod:1018
8434 msgid "guestfs_command"
8435 msgstr ""
8436
8437 # type: verbatim
8438 #. type: verbatim
8439 #: ../src/guestfs-actions.pod:1020
8440 #, no-wrap
8441 msgid ""
8442 " char *\n"
8443 " guestfs_command (guestfs_h *g,\n"
8444 "                  char *const *arguments);\n"
8445 "\n"
8446 msgstr ""
8447
8448 # type: textblock
8449 #. type: textblock
8450 #: ../src/guestfs-actions.pod:1024 ../fish/guestfish-actions.pod:692
8451 msgid ""
8452 "This call runs a command from the guest filesystem.  The filesystem must be "
8453 "mounted, and must contain a compatible operating system (ie. something "
8454 "Linux, with the same or compatible processor architecture)."
8455 msgstr ""
8456
8457 # type: textblock
8458 #. type: textblock
8459 #: ../src/guestfs-actions.pod:1029
8460 msgid ""
8461 "The single parameter is an argv-style list of arguments.  The first element "
8462 "is the name of the program to run.  Subsequent elements are parameters.  The "
8463 "list must be non-empty (ie. must contain a program name).  Note that the "
8464 "command runs directly, and is I<not> invoked via the shell (see "
8465 "C<guestfs_sh>)."
8466 msgstr ""
8467
8468 # type: textblock
8469 #. type: textblock
8470 #: ../src/guestfs-actions.pod:1036 ../fish/guestfish-actions.pod:704
8471 msgid "The return value is anything printed to I<stdout> by the command."
8472 msgstr ""
8473
8474 # type: textblock
8475 #. type: textblock
8476 #: ../src/guestfs-actions.pod:1039 ../fish/guestfish-actions.pod:707
8477 msgid ""
8478 "If the command returns a non-zero exit status, then this function returns an "
8479 "error message.  The error message string is the content of I<stderr> from "
8480 "the command."
8481 msgstr ""
8482
8483 # type: textblock
8484 #. type: textblock
8485 #: ../src/guestfs-actions.pod:1043 ../fish/guestfish-actions.pod:711
8486 msgid ""
8487 "The C<$PATH> environment variable will contain at least C</usr/bin> and C</"
8488 "bin>.  If you require a program from another location, you should provide "
8489 "the full path in the first parameter."
8490 msgstr ""
8491
8492 # type: textblock
8493 #. type: textblock
8494 #: ../src/guestfs-actions.pod:1048 ../fish/guestfish-actions.pod:716
8495 msgid ""
8496 "Shared libraries and data files required by the program must be available on "
8497 "filesystems which are mounted in the correct places.  It is the caller's "
8498 "responsibility to ensure all filesystems that are needed are mounted at the "
8499 "right locations."
8500 msgstr ""
8501
8502 # type: textblock
8503 #. type: textblock
8504 #: ../src/guestfs-actions.pod:1060 ../src/guestfs-actions.pod:1080
8505 #: ../src/guestfs-actions.pod:1543
8506 msgid "(Added in 0.9.1)"
8507 msgstr ""
8508
8509 # type: =head2
8510 #. type: =head2
8511 #: ../src/guestfs-actions.pod:1062
8512 msgid "guestfs_command_lines"
8513 msgstr ""
8514
8515 # type: verbatim
8516 #. type: verbatim
8517 #: ../src/guestfs-actions.pod:1064
8518 #, no-wrap
8519 msgid ""
8520 " char **\n"
8521 " guestfs_command_lines (guestfs_h *g,\n"
8522 "                        char *const *arguments);\n"
8523 "\n"
8524 msgstr ""
8525
8526 # type: textblock
8527 #. type: textblock
8528 #: ../src/guestfs-actions.pod:1068
8529 msgid ""
8530 "This is the same as C<guestfs_command>, but splits the result into a list of "
8531 "lines."
8532 msgstr ""
8533
8534 # type: textblock
8535 #. type: textblock
8536 #: ../src/guestfs-actions.pod:1071
8537 msgid "See also: C<guestfs_sh_lines>"
8538 msgstr ""
8539
8540 # type: =head2
8541 #. type: =head2
8542 #: ../src/guestfs-actions.pod:1082
8543 msgid "guestfs_config"
8544 msgstr ""
8545
8546 # type: verbatim
8547 #. type: verbatim
8548 #: ../src/guestfs-actions.pod:1084
8549 #, no-wrap
8550 msgid ""
8551 " int\n"
8552 " guestfs_config (guestfs_h *g,\n"
8553 "                 const char *qemuparam,\n"
8554 "                 const char *qemuvalue);\n"
8555 "\n"
8556 msgstr ""
8557
8558 # type: textblock
8559 #. type: textblock
8560 #: ../src/guestfs-actions.pod:1089 ../fish/guestfish-actions.pod:741
8561 msgid ""
8562 "This can be used to add arbitrary qemu command line parameters of the form "
8563 "C<-param value>.  Actually it's not quite arbitrary - we prevent you from "
8564 "setting some parameters which would interfere with parameters that we use."
8565 msgstr ""
8566
8567 # type: textblock
8568 #. type: textblock
8569 #: ../src/guestfs-actions.pod:1094 ../fish/guestfish-actions.pod:746
8570 msgid "The first character of C<param> string must be a C<-> (dash)."
8571 msgstr ""
8572
8573 # type: textblock
8574 #. type: textblock
8575 #: ../src/guestfs-actions.pod:1096 ../fish/guestfish-actions.pod:748
8576 msgid "C<value> can be NULL."
8577 msgstr ""
8578
8579 # type: =head2
8580 #. type: =head2
8581 #: ../src/guestfs-actions.pod:1102
8582 msgid "guestfs_copy_size"
8583 msgstr ""
8584
8585 # type: verbatim
8586 #. type: verbatim
8587 #: ../src/guestfs-actions.pod:1104
8588 #, no-wrap
8589 msgid ""
8590 " int\n"
8591 " guestfs_copy_size (guestfs_h *g,\n"
8592 "                    const char *src,\n"
8593 "                    const char *dest,\n"
8594 "                    int64_t size);\n"
8595 "\n"
8596 msgstr ""
8597
8598 # type: textblock
8599 #. type: textblock
8600 #: ../src/guestfs-actions.pod:1110 ../fish/guestfish-actions.pod:754
8601 msgid ""
8602 "This command copies exactly C<size> bytes from one source device or file "
8603 "C<src> to another destination device or file C<dest>."
8604 msgstr ""
8605
8606 # type: textblock
8607 #. type: textblock
8608 #: ../src/guestfs-actions.pod:1113 ../fish/guestfish-actions.pod:757
8609 msgid ""
8610 "Note this will fail if the source is too short or if the destination is not "
8611 "large enough."
8612 msgstr ""
8613
8614 # type: textblock
8615 #. type: textblock
8616 #: ../src/guestfs-actions.pod:1118 ../src/guestfs-actions.pod:1241
8617 #: ../src/guestfs-actions.pod:1272 ../src/guestfs-actions.pod:1692
8618 #: ../src/guestfs-actions.pod:1714 ../src/guestfs-actions.pod:6732
8619 #: ../src/guestfs-actions.pod:6766 ../src/guestfs-actions.pod:7245
8620 #: ../src/guestfs-actions.pod:7264
8621 msgid ""
8622 "This long-running command can generate progress notification messages so "
8623 "that the caller can display a progress bar or indicator.  To receive these "
8624 "messages, the caller must register a progress callback.  See L<guestfs(3)/"
8625 "guestfs_set_progress_callback>."
8626 msgstr ""
8627
8628 # type: textblock
8629 #. type: textblock
8630 #: ../src/guestfs-actions.pod:1123 ../src/guestfs-actions.pod:4074
8631 #: ../src/guestfs-actions.pod:5292 ../src/guestfs-actions.pod:6973
8632 #: ../src/guestfs-actions.pod:6993 ../src/guestfs-actions.pod:7079
8633 msgid "(Added in 1.0.87)"
8634 msgstr ""
8635
8636 # type: =head2
8637 #. type: =head2
8638 #: ../src/guestfs-actions.pod:1125
8639 msgid "guestfs_cp"
8640 msgstr ""
8641
8642 # type: verbatim
8643 #. type: verbatim
8644 #: ../src/guestfs-actions.pod:1127
8645 #, no-wrap
8646 msgid ""
8647 " int\n"
8648 " guestfs_cp (guestfs_h *g,\n"
8649 "             const char *src,\n"
8650 "             const char *dest);\n"
8651 "\n"
8652 msgstr ""
8653
8654 # type: textblock
8655 #. type: textblock
8656 #: ../src/guestfs-actions.pod:1132 ../fish/guestfish-actions.pod:764
8657 msgid ""
8658 "This copies a file from C<src> to C<dest> where C<dest> is either a "
8659 "destination filename or destination directory."
8660 msgstr ""
8661
8662 # type: textblock
8663 #. type: textblock
8664 #: ../src/guestfs-actions.pod:1137 ../src/guestfs-actions.pod:1151
8665 #: ../src/guestfs-actions.pod:1223 ../src/guestfs-actions.pod:1297
8666 #: ../src/guestfs-actions.pod:1406 ../src/guestfs-actions.pod:4759
8667 #: ../src/guestfs-actions.pod:5136
8668 msgid "(Added in 1.0.18)"
8669 msgstr ""
8670
8671 # type: =head2
8672 #. type: =head2
8673 #: ../src/guestfs-actions.pod:1139
8674 msgid "guestfs_cp_a"
8675 msgstr ""
8676
8677 # type: verbatim
8678 #. type: verbatim
8679 #: ../src/guestfs-actions.pod:1141
8680 #, no-wrap
8681 msgid ""
8682 " int\n"
8683 " guestfs_cp_a (guestfs_h *g,\n"
8684 "               const char *src,\n"
8685 "               const char *dest);\n"
8686 "\n"
8687 msgstr ""
8688
8689 # type: textblock
8690 #. type: textblock
8691 #: ../src/guestfs-actions.pod:1146 ../fish/guestfish-actions.pod:771
8692 msgid ""
8693 "This copies a file or directory from C<src> to C<dest> recursively using the "
8694 "C<cp -a> command."
8695 msgstr ""
8696
8697 # type: =head2
8698 #. type: =head2
8699 #: ../src/guestfs-actions.pod:1153
8700 msgid "guestfs_dd"
8701 msgstr ""
8702
8703 # type: verbatim
8704 #. type: verbatim
8705 #: ../src/guestfs-actions.pod:1155
8706 #, no-wrap
8707 msgid ""
8708 " int\n"
8709 " guestfs_dd (guestfs_h *g,\n"
8710 "             const char *src,\n"
8711 "             const char *dest);\n"
8712 "\n"
8713 msgstr ""
8714
8715 # type: textblock
8716 #. type: textblock
8717 #: ../src/guestfs-actions.pod:1160 ../fish/guestfish-actions.pod:778
8718 msgid ""
8719 "This command copies from one source device or file C<src> to another "
8720 "destination device or file C<dest>.  Normally you would use this to copy to "
8721 "or from a device or partition, for example to duplicate a filesystem."
8722 msgstr ""
8723
8724 # type: textblock
8725 #. type: textblock
8726 #: ../src/guestfs-actions.pod:1165
8727 msgid ""
8728 "If the destination is a device, it must be as large or larger than the "
8729 "source file or device, otherwise the copy will fail.  This command cannot do "
8730 "partial copies (see C<guestfs_copy_size>)."
8731 msgstr ""
8732
8733 # type: =head2
8734 #. type: =head2
8735 #: ../src/guestfs-actions.pod:1173
8736 msgid "guestfs_df"
8737 msgstr ""
8738
8739 # type: verbatim
8740 #. type: verbatim
8741 #: ../src/guestfs-actions.pod:1175
8742 #, no-wrap
8743 msgid ""
8744 " char *\n"
8745 " guestfs_df (guestfs_h *g);\n"
8746 "\n"
8747 msgstr ""
8748
8749 # type: textblock
8750 #. type: textblock
8751 #: ../src/guestfs-actions.pod:1178 ../fish/guestfish-actions.pod:791
8752 msgid "This command runs the C<df> command to report disk space used."
8753 msgstr ""
8754
8755 # type: textblock
8756 #. type: textblock
8757 #: ../src/guestfs-actions.pod:1180 ../src/guestfs-actions.pod:1197
8758 msgid ""
8759 "This command is mostly useful for interactive sessions.  It is I<not> "
8760 "intended that you try to parse the output string.  Use C<guestfs_statvfs> "
8761 "from programs."
8762 msgstr ""
8763
8764 # type: textblock
8765 #. type: textblock
8766 #: ../src/guestfs-actions.pod:1187 ../src/guestfs-actions.pod:1204
8767 #: ../src/guestfs-actions.pod:1317 ../src/guestfs-actions.pod:2281
8768 #: ../src/guestfs-actions.pod:2305 ../src/guestfs-actions.pod:2373
8769 #: ../src/guestfs-actions.pod:4184 ../src/guestfs-actions.pod:4659
8770 #: ../src/guestfs-actions.pod:6470 ../src/guestfs-actions.pod:6494
8771 #: ../src/guestfs-actions.pod:7112 ../src/guestfs-actions.pod:7125
8772 #: ../src/guestfs-actions.pod:7138
8773 msgid "(Added in 1.0.54)"
8774 msgstr ""
8775
8776 # type: =head2
8777 #. type: =head2
8778 #: ../src/guestfs-actions.pod:1189
8779 msgid "guestfs_df_h"
8780 msgstr ""
8781
8782 # type: verbatim
8783 #. type: verbatim
8784 #: ../src/guestfs-actions.pod:1191
8785 #, no-wrap
8786 msgid ""
8787 " char *\n"
8788 " guestfs_df_h (guestfs_h *g);\n"
8789 "\n"
8790 msgstr ""
8791
8792 # type: textblock
8793 #. type: textblock
8794 #: ../src/guestfs-actions.pod:1194 ../fish/guestfish-actions.pod:801
8795 msgid ""
8796 "This command runs the C<df -h> command to report disk space used in human-"
8797 "readable format."
8798 msgstr ""
8799
8800 # type: =head2
8801 #. type: =head2
8802 #: ../src/guestfs-actions.pod:1206
8803 msgid "guestfs_dmesg"
8804 msgstr ""
8805
8806 # type: verbatim
8807 #. type: verbatim
8808 #: ../src/guestfs-actions.pod:1208
8809 #, no-wrap
8810 msgid ""
8811 " char *\n"
8812 " guestfs_dmesg (guestfs_h *g);\n"
8813 "\n"
8814 msgstr ""
8815
8816 # type: textblock
8817 #. type: textblock
8818 #: ../src/guestfs-actions.pod:1211 ../fish/guestfish-actions.pod:812
8819 msgid ""
8820 "This returns the kernel messages (C<dmesg> output) from the guest kernel.  "
8821 "This is sometimes useful for extended debugging of problems."
8822 msgstr ""
8823
8824 # type: textblock
8825 #. type: textblock
8826 #: ../src/guestfs-actions.pod:1215
8827 msgid ""
8828 "Another way to get the same information is to enable verbose messages with "
8829 "C<guestfs_set_verbose> or by setting the environment variable "
8830 "C<LIBGUESTFS_DEBUG=1> before running the program."
8831 msgstr ""
8832
8833 # type: =head2
8834 #. type: =head2
8835 #: ../src/guestfs-actions.pod:1225
8836 msgid "guestfs_download"
8837 msgstr ""
8838
8839 # type: verbatim
8840 #. type: verbatim
8841 #: ../src/guestfs-actions.pod:1227
8842 #, no-wrap
8843 msgid ""
8844 " int\n"
8845 " guestfs_download (guestfs_h *g,\n"
8846 "                   const char *remotefilename,\n"
8847 "                   const char *filename);\n"
8848 "\n"
8849 msgstr ""
8850
8851 # type: textblock
8852 #. type: textblock
8853 #: ../src/guestfs-actions.pod:1232 ../src/guestfs-actions.pod:1257
8854 #: ../fish/guestfish-actions.pod:825 ../fish/guestfish-actions.pod:838
8855 msgid ""
8856 "Download file C<remotefilename> and save it as C<filename> on the local "
8857 "machine."
8858 msgstr ""
8859
8860 # type: textblock
8861 #. type: textblock
8862 #: ../src/guestfs-actions.pod:1235 ../src/guestfs-actions.pod:6726
8863 #: ../fish/guestfish-actions.pod:828 ../fish/guestfish-actions.pod:4524
8864 msgid "C<filename> can also be a named pipe."
8865 msgstr ""
8866
8867 # type: textblock
8868 #. type: textblock
8869 #: ../src/guestfs-actions.pod:1237
8870 msgid "See also C<guestfs_upload>, C<guestfs_cat>."
8871 msgstr ""
8872
8873 # type: =head2
8874 #. type: =head2
8875 #: ../src/guestfs-actions.pod:1248
8876 msgid "guestfs_download_offset"
8877 msgstr ""
8878
8879 # type: verbatim
8880 #. type: verbatim
8881 #: ../src/guestfs-actions.pod:1250
8882 #, no-wrap
8883 msgid ""
8884 " int\n"
8885 " guestfs_download_offset (guestfs_h *g,\n"
8886 "                          const char *remotefilename,\n"
8887 "                          const char *filename,\n"
8888 "                          int64_t offset,\n"
8889 "                          int64_t size);\n"
8890 "\n"
8891 msgstr ""
8892
8893 # type: textblock
8894 #. type: textblock
8895 #: ../src/guestfs-actions.pod:1260 ../fish/guestfish-actions.pod:841
8896 msgid ""
8897 "C<remotefilename> is read for C<size> bytes starting at C<offset> (this "
8898 "region must be within the file or device)."
8899 msgstr ""
8900
8901 # type: textblock
8902 #. type: textblock
8903 #: ../src/guestfs-actions.pod:1263
8904 msgid ""
8905 "Note that there is no limit on the amount of data that can be downloaded "
8906 "with this call, unlike with C<guestfs_pread>, and this call always reads the "
8907 "full amount unless an error occurs."
8908 msgstr ""
8909
8910 # type: textblock
8911 #. type: textblock
8912 #: ../src/guestfs-actions.pod:1268
8913 msgid "See also C<guestfs_download>, C<guestfs_pread>."
8914 msgstr ""
8915
8916 # type: textblock
8917 #. type: textblock
8918 #: ../src/guestfs-actions.pod:1277 ../src/guestfs-actions.pod:6771
8919 msgid "(Added in 1.5.17)"
8920 msgstr ""
8921
8922 # type: =head2
8923 #. type: =head2
8924 #: ../src/guestfs-actions.pod:1279
8925 msgid "guestfs_drop_caches"
8926 msgstr ""
8927
8928 # type: verbatim
8929 #. type: verbatim
8930 #: ../src/guestfs-actions.pod:1281
8931 #, no-wrap
8932 msgid ""
8933 " int\n"
8934 " guestfs_drop_caches (guestfs_h *g,\n"
8935 "                      int whattodrop);\n"
8936 "\n"
8937 msgstr ""
8938
8939 # type: textblock
8940 #. type: textblock
8941 #: ../src/guestfs-actions.pod:1285 ../fish/guestfish-actions.pod:857
8942 msgid ""
8943 "This instructs the guest kernel to drop its page cache, and/or dentries and "
8944 "inode caches.  The parameter C<whattodrop> tells the kernel what precisely "
8945 "to drop, see L<http://linux-mm.org/Drop_Caches>"
8946 msgstr ""
8947
8948 # type: textblock
8949 #. type: textblock
8950 #: ../src/guestfs-actions.pod:1290 ../fish/guestfish-actions.pod:862
8951 msgid "Setting C<whattodrop> to 3 should drop everything."
8952 msgstr ""
8953
8954 # type: textblock
8955 #. type: textblock
8956 #: ../src/guestfs-actions.pod:1292 ../fish/guestfish-actions.pod:864
8957 msgid ""
8958 "This automatically calls L<sync(2)> before the operation, so that the "
8959 "maximum guest memory is freed."
8960 msgstr ""
8961
8962 # type: =head2
8963 #. type: =head2
8964 #: ../src/guestfs-actions.pod:1299
8965 msgid "guestfs_du"
8966 msgstr ""
8967
8968 # type: verbatim
8969 #. type: verbatim
8970 #: ../src/guestfs-actions.pod:1301
8971 #, no-wrap
8972 msgid ""
8973 " int64_t\n"
8974 " guestfs_du (guestfs_h *g,\n"
8975 "             const char *path);\n"
8976 "\n"
8977 msgstr ""
8978
8979 # type: textblock
8980 #. type: textblock
8981 #: ../src/guestfs-actions.pod:1305 ../fish/guestfish-actions.pod:871
8982 msgid ""
8983 "This command runs the C<du -s> command to estimate file space usage for "
8984 "C<path>."
8985 msgstr ""
8986
8987 # type: textblock
8988 #. type: textblock
8989 #: ../src/guestfs-actions.pod:1308 ../fish/guestfish-actions.pod:874
8990 msgid ""
8991 "C<path> can be a file or a directory.  If C<path> is a directory then the "
8992 "estimate includes the contents of the directory and all subdirectories "
8993 "(recursively)."
8994 msgstr ""
8995
8996 # type: textblock
8997 #. type: textblock
8998 #: ../src/guestfs-actions.pod:1312 ../fish/guestfish-actions.pod:878
8999 msgid ""
9000 "The result is the estimated size in I<kilobytes> (ie. units of 1024 bytes)."
9001 msgstr ""
9002
9003 # type: =head2
9004 #. type: =head2
9005 #: ../src/guestfs-actions.pod:1319
9006 msgid "guestfs_e2fsck_f"
9007 msgstr ""
9008
9009 # type: verbatim
9010 #. type: verbatim
9011 #: ../src/guestfs-actions.pod:1321
9012 #, no-wrap
9013 msgid ""
9014 " int\n"
9015 " guestfs_e2fsck_f (guestfs_h *g,\n"
9016 "                   const char *device);\n"
9017 "\n"
9018 msgstr ""
9019
9020 # type: textblock
9021 #. type: textblock
9022 #: ../src/guestfs-actions.pod:1325 ../fish/guestfish-actions.pod:885
9023 msgid ""
9024 "This runs C<e2fsck -p -f device>, ie. runs the ext2/ext3 filesystem checker "
9025 "on C<device>, noninteractively (C<-p>), even if the filesystem appears to be "
9026 "clean (C<-f>)."
9027 msgstr ""
9028
9029 # type: textblock
9030 #. type: textblock
9031 #: ../src/guestfs-actions.pod:1329
9032 msgid ""
9033 "This command is only needed because of C<guestfs_resize2fs> (q.v.).  "
9034 "Normally you should use C<guestfs_fsck>."
9035 msgstr ""
9036
9037 # type: textblock
9038 #. type: textblock
9039 #: ../src/guestfs-actions.pod:1334
9040 msgid "(Added in 1.0.29)"
9041 msgstr ""
9042
9043 # type: =head2
9044 #. type: =head2
9045 #: ../src/guestfs-actions.pod:1336
9046 msgid "guestfs_echo_daemon"
9047 msgstr ""
9048
9049 # type: verbatim
9050 #. type: verbatim
9051 #: ../src/guestfs-actions.pod:1338
9052 #, no-wrap
9053 msgid ""
9054 " char *\n"
9055 " guestfs_echo_daemon (guestfs_h *g,\n"
9056 "                      char *const *words);\n"
9057 "\n"
9058 msgstr ""
9059
9060 # type: textblock
9061 #. type: textblock
9062 #: ../src/guestfs-actions.pod:1342 ../fish/guestfish-actions.pod:896
9063 msgid ""
9064 "This command concatenates the list of C<words> passed with single spaces "
9065 "between them and returns the resulting string."
9066 msgstr ""
9067
9068 # type: textblock
9069 #. type: textblock
9070 #: ../src/guestfs-actions.pod:1345 ../fish/guestfish-actions.pod:899
9071 msgid "You can use this command to test the connection through to the daemon."
9072 msgstr ""
9073
9074 # type: textblock
9075 #. type: textblock
9076 #: ../src/guestfs-actions.pod:1347
9077 msgid "See also C<guestfs_ping_daemon>."
9078 msgstr ""
9079
9080 # type: textblock
9081 #. type: textblock
9082 #: ../src/guestfs-actions.pod:1352 ../src/guestfs-actions.pod:2089
9083 #: ../src/guestfs-actions.pod:5970
9084 msgid "(Added in 1.0.69)"
9085 msgstr ""
9086
9087 # type: =head2
9088 #. type: =head2
9089 #: ../src/guestfs-actions.pod:1354
9090 msgid "guestfs_egrep"
9091 msgstr ""
9092
9093 # type: verbatim
9094 #. type: verbatim
9095 #: ../src/guestfs-actions.pod:1356
9096 #, no-wrap
9097 msgid ""
9098 " char **\n"
9099 " guestfs_egrep (guestfs_h *g,\n"
9100 "                const char *regex,\n"
9101 "                const char *path);\n"
9102 "\n"
9103 msgstr ""
9104
9105 # type: textblock
9106 #. type: textblock
9107 #: ../src/guestfs-actions.pod:1361 ../fish/guestfish-actions.pod:907
9108 msgid ""
9109 "This calls the external C<egrep> program and returns the matching lines."
9110 msgstr ""
9111
9112 # type: textblock
9113 #. type: textblock
9114 #: ../src/guestfs-actions.pod:1371 ../src/guestfs-actions.pod:1390
9115 #: ../src/guestfs-actions.pod:1447 ../src/guestfs-actions.pod:1493
9116 #: ../src/guestfs-actions.pod:1512 ../src/guestfs-actions.pod:2219
9117 #: ../src/guestfs-actions.pod:2238 ../src/guestfs-actions.pod:2394
9118 #: ../src/guestfs-actions.pod:2407 ../src/guestfs-actions.pod:2422
9119 #: ../src/guestfs-actions.pod:2468 ../src/guestfs-actions.pod:2490
9120 #: ../src/guestfs-actions.pod:2503 ../src/guestfs-actions.pod:3567
9121 #: ../src/guestfs-actions.pod:3581 ../src/guestfs-actions.pod:3594
9122 #: ../src/guestfs-actions.pod:3608 ../src/guestfs-actions.pod:4594
9123 #: ../src/guestfs-actions.pod:5470 ../src/guestfs-actions.pod:5519
9124 #: ../src/guestfs-actions.pod:6338 ../src/guestfs-actions.pod:6350
9125 #: ../src/guestfs-actions.pod:6363 ../src/guestfs-actions.pod:6376
9126 #: ../src/guestfs-actions.pod:6398 ../src/guestfs-actions.pod:6411
9127 #: ../src/guestfs-actions.pod:6424 ../src/guestfs-actions.pod:6437
9128 #: ../src/guestfs-actions.pod:7208 ../src/guestfs-actions.pod:7227
9129 #: ../src/guestfs-actions.pod:7312 ../src/guestfs-actions.pod:7331
9130 #: ../src/guestfs-actions.pod:7377 ../src/guestfs-actions.pod:7396
9131 msgid "(Added in 1.0.66)"
9132 msgstr ""
9133
9134 # type: =head2
9135 #. type: =head2
9136 #: ../src/guestfs-actions.pod:1373
9137 msgid "guestfs_egrepi"
9138 msgstr ""
9139
9140 # type: verbatim
9141 #. type: verbatim
9142 #: ../src/guestfs-actions.pod:1375
9143 #, no-wrap
9144 msgid ""
9145 " char **\n"
9146 " guestfs_egrepi (guestfs_h *g,\n"
9147 "                 const char *regex,\n"
9148 "                 const char *path);\n"
9149 "\n"
9150 msgstr ""
9151
9152 # type: textblock
9153 #. type: textblock
9154 #: ../src/guestfs-actions.pod:1380 ../fish/guestfish-actions.pod:917
9155 msgid ""
9156 "This calls the external C<egrep -i> program and returns the matching lines."
9157 msgstr ""
9158
9159 # type: =head2
9160 #. type: =head2
9161 #: ../src/guestfs-actions.pod:1392
9162 msgid "guestfs_equal"
9163 msgstr ""
9164
9165 # type: verbatim
9166 #. type: verbatim
9167 #: ../src/guestfs-actions.pod:1394
9168 #, no-wrap
9169 msgid ""
9170 " int\n"
9171 " guestfs_equal (guestfs_h *g,\n"
9172 "                const char *file1,\n"
9173 "                const char *file2);\n"
9174 "\n"
9175 msgstr ""
9176
9177 # type: textblock
9178 #. type: textblock
9179 #: ../src/guestfs-actions.pod:1399 ../fish/guestfish-actions.pod:927
9180 msgid ""
9181 "This compares the two files C<file1> and C<file2> and returns true if their "
9182 "content is exactly equal, or false otherwise."
9183 msgstr ""
9184
9185 # type: textblock
9186 #. type: textblock
9187 #: ../src/guestfs-actions.pod:1402 ../fish/guestfish-actions.pod:930
9188 msgid "The external L<cmp(1)> program is used for the comparison."
9189 msgstr ""
9190
9191 # type: =head2
9192 #. type: =head2
9193 #: ../src/guestfs-actions.pod:1408
9194 msgid "guestfs_exists"
9195 msgstr ""
9196
9197 # type: verbatim
9198 #. type: verbatim
9199 #: ../src/guestfs-actions.pod:1410
9200 #, no-wrap
9201 msgid ""
9202 " int\n"
9203 " guestfs_exists (guestfs_h *g,\n"
9204 "                 const char *path);\n"
9205 "\n"
9206 msgstr ""
9207
9208 # type: textblock
9209 #. type: textblock
9210 #: ../src/guestfs-actions.pod:1414 ../fish/guestfish-actions.pod:936
9211 msgid ""
9212 "This returns C<true> if and only if there is a file, directory (or anything) "
9213 "with the given C<path> name."
9214 msgstr ""
9215
9216 # type: textblock
9217 #. type: textblock
9218 #: ../src/guestfs-actions.pod:1417
9219 msgid "See also C<guestfs_is_file>, C<guestfs_is_dir>, C<guestfs_stat>."
9220 msgstr ""
9221
9222 # type: =head2
9223 #. type: =head2
9224 #: ../src/guestfs-actions.pod:1423
9225 msgid "guestfs_fallocate"
9226 msgstr ""
9227
9228 # type: verbatim
9229 #. type: verbatim
9230 #: ../src/guestfs-actions.pod:1425
9231 #, no-wrap
9232 msgid ""
9233 " int\n"
9234 " guestfs_fallocate (guestfs_h *g,\n"
9235 "                    const char *path,\n"
9236 "                    int len);\n"
9237 "\n"
9238 msgstr ""
9239
9240 # type: textblock
9241 #. type: textblock
9242 #: ../src/guestfs-actions.pod:1430 ../src/guestfs-actions.pod:1456
9243 #: ../fish/guestfish-actions.pod:945 ../fish/guestfish-actions.pod:964
9244 msgid ""
9245 "This command preallocates a file (containing zero bytes) named C<path> of "
9246 "size C<len> bytes.  If the file exists already, it is overwritten."
9247 msgstr ""
9248
9249 # type: textblock
9250 #. type: textblock
9251 #: ../src/guestfs-actions.pod:1434 ../fish/guestfish-actions.pod:949
9252 msgid ""
9253 "Do not confuse this with the guestfish-specific C<alloc> command which "
9254 "allocates a file in the host and attaches it as a device."
9255 msgstr ""
9256
9257 # type: textblock
9258 #. type: textblock
9259 #: ../src/guestfs-actions.pod:1440 ../fish/guestfish-actions.pod:953
9260 msgid ""
9261 "This function is deprecated.  In new code, use the C<fallocate64> call "
9262 "instead."
9263 msgstr ""
9264
9265 # type: =head2
9266 #. type: =head2
9267 #: ../src/guestfs-actions.pod:1449
9268 msgid "guestfs_fallocate64"
9269 msgstr ""
9270
9271 # type: verbatim
9272 #. type: verbatim
9273 #: ../src/guestfs-actions.pod:1451
9274 #, no-wrap
9275 msgid ""
9276 " int\n"
9277 " guestfs_fallocate64 (guestfs_h *g,\n"
9278 "                      const char *path,\n"
9279 "                      int64_t len);\n"
9280 "\n"
9281 msgstr ""
9282
9283 # type: textblock
9284 #. type: textblock
9285 #: ../src/guestfs-actions.pod:1460
9286 msgid ""
9287 "Note that this call allocates disk blocks for the file.  To create a sparse "
9288 "file use C<guestfs_truncate_size> instead."
9289 msgstr ""
9290
9291 # type: textblock
9292 #. type: textblock
9293 #: ../src/guestfs-actions.pod:1463
9294 msgid ""
9295 "The deprecated call C<guestfs_fallocate> does the same, but owing to an "
9296 "oversight it only allowed 30 bit lengths to be specified, effectively "
9297 "limiting the maximum size of files created through that call to 1GB."
9298 msgstr ""
9299
9300 # type: textblock
9301 #. type: textblock
9302 #: ../src/guestfs-actions.pod:1468 ../fish/guestfish-actions.pod:976
9303 msgid ""
9304 "Do not confuse this with the guestfish-specific C<alloc> and C<sparse> "
9305 "commands which create a file in the host and attach it as a device."
9306 msgstr ""
9307
9308 # type: textblock
9309 #. type: textblock
9310 #: ../src/guestfs-actions.pod:1474
9311 msgid "(Added in 1.3.17)"
9312 msgstr ""
9313
9314 # type: =head2
9315 #. type: =head2
9316 #: ../src/guestfs-actions.pod:1476
9317 msgid "guestfs_fgrep"
9318 msgstr ""
9319
9320 # type: verbatim
9321 #. type: verbatim
9322 #: ../src/guestfs-actions.pod:1478
9323 #, no-wrap
9324 msgid ""
9325 " char **\n"
9326 " guestfs_fgrep (guestfs_h *g,\n"
9327 "                const char *pattern,\n"
9328 "                const char *path);\n"
9329 "\n"
9330 msgstr ""
9331
9332 # type: textblock
9333 #. type: textblock
9334 #: ../src/guestfs-actions.pod:1483 ../fish/guestfish-actions.pod:984
9335 msgid ""
9336 "This calls the external C<fgrep> program and returns the matching lines."
9337 msgstr ""
9338
9339 # type: =head2
9340 #. type: =head2
9341 #: ../src/guestfs-actions.pod:1495
9342 msgid "guestfs_fgrepi"
9343 msgstr ""
9344
9345 # type: verbatim
9346 #. type: verbatim
9347 #: ../src/guestfs-actions.pod:1497
9348 #, no-wrap
9349 msgid ""
9350 " char **\n"
9351 " guestfs_fgrepi (guestfs_h *g,\n"
9352 "                 const char *pattern,\n"
9353 "                 const char *path);\n"
9354 "\n"
9355 msgstr ""
9356
9357 # type: textblock
9358 #. type: textblock
9359 #: ../src/guestfs-actions.pod:1502 ../fish/guestfish-actions.pod:994
9360 msgid ""
9361 "This calls the external C<fgrep -i> program and returns the matching lines."
9362 msgstr ""
9363
9364 # type: =head2
9365 #. type: =head2
9366 #: ../src/guestfs-actions.pod:1514
9367 msgid "guestfs_file"
9368 msgstr ""
9369
9370 # type: verbatim
9371 #. type: verbatim
9372 #: ../src/guestfs-actions.pod:1516
9373 #, no-wrap
9374 msgid ""
9375 " char *\n"
9376 " guestfs_file (guestfs_h *g,\n"
9377 "               const char *path);\n"
9378 "\n"
9379 msgstr ""
9380
9381 # type: textblock
9382 #. type: textblock
9383 #: ../src/guestfs-actions.pod:1520 ../fish/guestfish-actions.pod:1004
9384 msgid ""
9385 "This call uses the standard L<file(1)> command to determine the type or "
9386 "contents of the file."
9387 msgstr ""
9388
9389 # type: textblock
9390 #. type: textblock
9391 #: ../src/guestfs-actions.pod:1523 ../fish/guestfish-actions.pod:1007
9392 msgid ""
9393 "This call will also transparently look inside various types of compressed "
9394 "file."
9395 msgstr ""
9396
9397 # type: textblock
9398 #. type: textblock
9399 #: ../src/guestfs-actions.pod:1526 ../fish/guestfish-actions.pod:1010
9400 msgid ""
9401 "The exact command which runs is C<file -zb path>.  Note in particular that "
9402 "the filename is not prepended to the output (the C<-b> option)."
9403 msgstr ""
9404
9405 # type: textblock
9406 #. type: textblock
9407 #: ../src/guestfs-actions.pod:1530
9408 msgid ""
9409 "This command can also be used on C</dev/> devices (and partitions, LV "
9410 "names).  You can for example use this to determine if a device contains a "
9411 "filesystem, although it's usually better to use C<guestfs_vfs_type>."
9412 msgstr ""
9413
9414 # type: textblock
9415 #. type: textblock
9416 #: ../src/guestfs-actions.pod:1535 ../fish/guestfish-actions.pod:1019
9417 msgid ""
9418 "If the C<path> does not begin with C</dev/> then this command only works for "
9419 "the content of regular files.  For other file types (directory, symbolic "
9420 "link etc) it will just return the string C<directory> etc."
9421 msgstr ""
9422
9423 # type: =head2
9424 #. type: =head2
9425 #: ../src/guestfs-actions.pod:1545
9426 msgid "guestfs_file_architecture"
9427 msgstr ""
9428
9429 # type: verbatim
9430 #. type: verbatim
9431 #: ../src/guestfs-actions.pod:1547
9432 #, no-wrap
9433 msgid ""
9434 " char *\n"
9435 " guestfs_file_architecture (guestfs_h *g,\n"
9436 "                            const char *filename);\n"
9437 "\n"
9438 msgstr ""
9439
9440 # type: textblock
9441 #. type: textblock
9442 #: ../src/guestfs-actions.pod:1551 ../fish/guestfish-actions.pod:1028
9443 msgid ""
9444 "This detects the architecture of the binary C<filename>, and returns it if "
9445 "known."
9446 msgstr ""
9447
9448 # type: textblock
9449 #. type: textblock
9450 #: ../src/guestfs-actions.pod:1554 ../fish/guestfish-actions.pod:1031
9451 msgid "Currently defined architectures are:"
9452 msgstr ""
9453
9454 # type: =item
9455 #. type: =item
9456 #: ../src/guestfs-actions.pod:1558 ../fish/guestfish-actions.pod:1035
9457 msgid "\"i386\""
9458 msgstr ""
9459
9460 # type: textblock
9461 #. type: textblock
9462 #: ../src/guestfs-actions.pod:1560 ../fish/guestfish-actions.pod:1037
9463 msgid ""
9464 "This string is returned for all 32 bit i386, i486, i586, i686 binaries "
9465 "irrespective of the precise processor requirements of the binary."
9466 msgstr ""
9467
9468 # type: =item
9469 #. type: =item
9470 #: ../src/guestfs-actions.pod:1563 ../fish/guestfish-actions.pod:1040
9471 msgid "\"x86_64\""
9472 msgstr ""
9473
9474 # type: textblock
9475 #. type: textblock
9476 #: ../src/guestfs-actions.pod:1565 ../fish/guestfish-actions.pod:1042
9477 msgid "64 bit x86-64."
9478 msgstr ""
9479
9480 # type: =item
9481 #. type: =item
9482 #: ../src/guestfs-actions.pod:1567 ../fish/guestfish-actions.pod:1044
9483 msgid "\"sparc\""
9484 msgstr ""
9485
9486 # type: textblock
9487 #. type: textblock
9488 #: ../src/guestfs-actions.pod:1569 ../fish/guestfish-actions.pod:1046
9489 msgid "32 bit SPARC."
9490 msgstr ""
9491
9492 # type: =item
9493 #. type: =item
9494 #: ../src/guestfs-actions.pod:1571 ../fish/guestfish-actions.pod:1048
9495 msgid "\"sparc64\""
9496 msgstr ""
9497
9498 # type: textblock
9499 #. type: textblock
9500 #: ../src/guestfs-actions.pod:1573 ../fish/guestfish-actions.pod:1050
9501 msgid "64 bit SPARC V9 and above."
9502 msgstr ""
9503
9504 # type: =item
9505 #. type: =item
9506 #: ../src/guestfs-actions.pod:1575 ../fish/guestfish-actions.pod:1052
9507 msgid "\"ia64\""
9508 msgstr ""
9509
9510 # type: textblock
9511 #. type: textblock
9512 #: ../src/guestfs-actions.pod:1577 ../fish/guestfish-actions.pod:1054
9513 msgid "Intel Itanium."
9514 msgstr ""
9515
9516 # type: =item
9517 #. type: =item
9518 #: ../src/guestfs-actions.pod:1579 ../fish/guestfish-actions.pod:1056
9519 msgid "\"ppc\""
9520 msgstr ""
9521
9522 # type: textblock
9523 #. type: textblock
9524 #: ../src/guestfs-actions.pod:1581 ../fish/guestfish-actions.pod:1058
9525 msgid "32 bit Power PC."
9526 msgstr ""
9527
9528 # type: =item
9529 #. type: =item
9530 #: ../src/guestfs-actions.pod:1583 ../fish/guestfish-actions.pod:1060
9531 msgid "\"ppc64\""
9532 msgstr ""
9533
9534 # type: textblock
9535 #. type: textblock
9536 #: ../src/guestfs-actions.pod:1585 ../fish/guestfish-actions.pod:1062
9537 msgid "64 bit Power PC."
9538 msgstr ""
9539
9540 # type: textblock
9541 #. type: textblock
9542 #: ../src/guestfs-actions.pod:1589 ../fish/guestfish-actions.pod:1066
9543 msgid "Libguestfs may return other architecture strings in future."
9544 msgstr ""
9545
9546 # type: textblock
9547 #. type: textblock
9548 #: ../src/guestfs-actions.pod:1591 ../fish/guestfish-actions.pod:1068
9549 msgid "The function works on at least the following types of files:"
9550 msgstr ""
9551
9552 # type: textblock
9553 #. type: textblock
9554 #: ../src/guestfs-actions.pod:1597 ../fish/guestfish-actions.pod:1074
9555 msgid "many types of Un*x and Linux binary"
9556 msgstr ""
9557
9558 # type: textblock
9559 #. type: textblock
9560 #: ../src/guestfs-actions.pod:1601 ../fish/guestfish-actions.pod:1078
9561 msgid "many types of Un*x and Linux shared library"
9562 msgstr ""
9563
9564 # type: textblock
9565 #. type: textblock
9566 #: ../src/guestfs-actions.pod:1605 ../fish/guestfish-actions.pod:1082
9567 msgid "Windows Win32 and Win64 binaries"
9568 msgstr ""
9569
9570 # type: textblock
9571 #. type: textblock
9572 #: ../src/guestfs-actions.pod:1609 ../fish/guestfish-actions.pod:1086
9573 msgid "Windows Win32 and Win64 DLLs"
9574 msgstr ""
9575
9576 # type: textblock
9577 #. type: textblock
9578 #: ../src/guestfs-actions.pod:1611 ../fish/guestfish-actions.pod:1088
9579 msgid "Win32 binaries and DLLs return C<i386>."
9580 msgstr ""
9581
9582 # type: textblock
9583 #. type: textblock
9584 #: ../src/guestfs-actions.pod:1613 ../fish/guestfish-actions.pod:1090
9585 msgid "Win64 binaries and DLLs return C<x86_64>."
9586 msgstr ""
9587
9588 # type: textblock
9589 #. type: textblock
9590 #: ../src/guestfs-actions.pod:1617 ../fish/guestfish-actions.pod:1094
9591 msgid "Linux kernel modules"
9592 msgstr ""
9593
9594 # type: textblock
9595 #. type: textblock
9596 #: ../src/guestfs-actions.pod:1621 ../fish/guestfish-actions.pod:1098
9597 msgid "Linux new-style initrd images"
9598 msgstr ""
9599
9600 # type: textblock
9601 #. type: textblock
9602 #: ../src/guestfs-actions.pod:1625 ../fish/guestfish-actions.pod:1102
9603 msgid "some non-x86 Linux vmlinuz kernels"
9604 msgstr ""
9605
9606 # type: textblock
9607 #. type: textblock
9608 #: ../src/guestfs-actions.pod:1629 ../fish/guestfish-actions.pod:1106
9609 msgid "What it can't do currently:"
9610 msgstr ""
9611
9612 # type: textblock
9613 #. type: textblock
9614 #: ../src/guestfs-actions.pod:1635 ../fish/guestfish-actions.pod:1112
9615 msgid "static libraries (libfoo.a)"
9616 msgstr ""
9617
9618 # type: textblock
9619 #. type: textblock
9620 #: ../src/guestfs-actions.pod:1639 ../fish/guestfish-actions.pod:1116
9621 msgid "Linux old-style initrd as compressed ext2 filesystem (RHEL 3)"
9622 msgstr ""
9623
9624 # type: textblock
9625 #. type: textblock
9626 #: ../src/guestfs-actions.pod:1643 ../fish/guestfish-actions.pod:1120
9627 msgid "x86 Linux vmlinuz kernels"
9628 msgstr ""
9629
9630 # type: textblock
9631 #. type: textblock
9632 #: ../src/guestfs-actions.pod:1645 ../fish/guestfish-actions.pod:1122
9633 msgid ""
9634 "x86 vmlinuz images (bzImage format) consist of a mix of 16-, 32- and "
9635 "compressed code, and are horribly hard to unpack.  If you want to find the "
9636 "architecture of a kernel, use the architecture of the associated initrd or "
9637 "kernel module(s) instead."
9638 msgstr ""
9639
9640 # type: textblock
9641 #. type: textblock
9642 #: ../src/guestfs-actions.pod:1655 ../src/guestfs-actions.pod:1818
9643 #: ../src/guestfs-actions.pod:1835 ../src/guestfs-actions.pod:2526
9644 #: ../src/guestfs-actions.pod:2611 ../src/guestfs-actions.pod:2637
9645 #: ../src/guestfs-actions.pod:2725 ../src/guestfs-actions.pod:2746
9646 #: ../src/guestfs-actions.pod:2783 ../src/guestfs-actions.pod:2867
9647 #: ../src/guestfs-actions.pod:2964 ../src/guestfs-actions.pod:3190
9648 #: ../src/guestfs-actions.pod:3322
9649 msgid "(Added in 1.5.3)"
9650 msgstr ""
9651
9652 # type: =head2
9653 #. type: =head2
9654 #: ../src/guestfs-actions.pod:1657
9655 msgid "guestfs_filesize"
9656 msgstr ""
9657
9658 # type: verbatim
9659 #. type: verbatim
9660 #: ../src/guestfs-actions.pod:1659
9661 #, no-wrap
9662 msgid ""
9663 " int64_t\n"
9664 " guestfs_filesize (guestfs_h *g,\n"
9665 "                   const char *file);\n"
9666 "\n"
9667 msgstr ""
9668
9669 # type: textblock
9670 #. type: textblock
9671 #: ../src/guestfs-actions.pod:1663 ../fish/guestfish-actions.pod:1133
9672 msgid "This command returns the size of C<file> in bytes."
9673 msgstr ""
9674
9675 # type: textblock
9676 #. type: textblock
9677 #: ../src/guestfs-actions.pod:1665
9678 msgid ""
9679 "To get other stats about a file, use C<guestfs_stat>, C<guestfs_lstat>, "
9680 "C<guestfs_is_dir>, C<guestfs_is_file> etc.  To get the size of block "
9681 "devices, use C<guestfs_blockdev_getsize64>."
9682 msgstr ""
9683
9684 # type: textblock
9685 #. type: textblock
9686 #: ../src/guestfs-actions.pod:1671
9687 msgid "(Added in 1.0.82)"
9688 msgstr ""
9689
9690 # type: =head2
9691 #. type: =head2
9692 #: ../src/guestfs-actions.pod:1673
9693 msgid "guestfs_fill"
9694 msgstr ""
9695
9696 # type: verbatim
9697 #. type: verbatim
9698 #: ../src/guestfs-actions.pod:1675
9699 #, no-wrap
9700 msgid ""
9701 " int\n"
9702 " guestfs_fill (guestfs_h *g,\n"
9703 "               int c,\n"
9704 "               int len,\n"
9705 "               const char *path);\n"
9706 "\n"
9707 msgstr ""
9708
9709 # type: textblock
9710 #. type: textblock
9711 #: ../src/guestfs-actions.pod:1681 ../fish/guestfish-actions.pod:1143
9712 msgid ""
9713 "This command creates a new file called C<path>.  The initial content of the "
9714 "file is C<len> octets of C<c>, where C<c> must be a number in the range C<"
9715 "[0..255]>."
9716 msgstr ""
9717
9718 # type: textblock
9719 #. type: textblock
9720 #: ../src/guestfs-actions.pod:1685
9721 msgid ""
9722 "To fill a file with zero bytes (sparsely), it is much more efficient to use "
9723 "C<guestfs_truncate_size>.  To create a file with a pattern of repeating "
9724 "bytes use C<guestfs_fill_pattern>."
9725 msgstr ""
9726
9727 # type: textblock
9728 #. type: textblock
9729 #: ../src/guestfs-actions.pod:1697
9730 msgid "(Added in 1.0.79)"
9731 msgstr ""
9732
9733 # type: =head2
9734 #. type: =head2
9735 #: ../src/guestfs-actions.pod:1699
9736 msgid "guestfs_fill_pattern"
9737 msgstr ""
9738
9739 # type: verbatim
9740 #. type: verbatim
9741 #: ../src/guestfs-actions.pod:1701
9742 #, no-wrap
9743 msgid ""
9744 " int\n"
9745 " guestfs_fill_pattern (guestfs_h *g,\n"
9746 "                       const char *pattern,\n"
9747 "                       int len,\n"
9748 "                       const char *path);\n"
9749 "\n"
9750 msgstr ""
9751
9752 # type: textblock
9753 #. type: textblock
9754 #: ../src/guestfs-actions.pod:1707
9755 msgid ""
9756 "This function is like C<guestfs_fill> except that it creates a new file of "
9757 "length C<len> containing the repeating pattern of bytes in C<pattern>.  The "
9758 "pattern is truncated if necessary to ensure the length of the file is "
9759 "exactly C<len> bytes."
9760 msgstr ""
9761
9762 # type: textblock
9763 #. type: textblock
9764 #: ../src/guestfs-actions.pod:1719
9765 msgid "(Added in 1.3.12)"
9766 msgstr ""
9767
9768 # type: =head2
9769 #. type: =head2
9770 #: ../src/guestfs-actions.pod:1721
9771 msgid "guestfs_find"
9772 msgstr ""
9773
9774 # type: verbatim
9775 #. type: verbatim
9776 #: ../src/guestfs-actions.pod:1723
9777 #, no-wrap
9778 msgid ""
9779 " char **\n"
9780 " guestfs_find (guestfs_h *g,\n"
9781 "               const char *directory);\n"
9782 "\n"
9783 msgstr ""
9784
9785 # type: textblock
9786 #. type: textblock
9787 #: ../src/guestfs-actions.pod:1727 ../fish/guestfish-actions.pod:1165
9788 msgid ""
9789 "This command lists out all files and directories, recursively, starting at "
9790 "C<directory>.  It is essentially equivalent to running the shell command "
9791 "C<find directory -print> but some post-processing happens on the output, "
9792 "described below."
9793 msgstr ""
9794
9795 # type: textblock
9796 #. type: textblock
9797 #: ../src/guestfs-actions.pod:1732 ../fish/guestfish-actions.pod:1170
9798 msgid ""
9799 "This returns a list of strings I<without any prefix>.  Thus if the directory "
9800 "structure was:"
9801 msgstr ""
9802
9803 # type: verbatim
9804 #. type: verbatim
9805 #: ../src/guestfs-actions.pod:1735 ../fish/guestfish-actions.pod:1173
9806 #, no-wrap
9807 msgid ""
9808 " /tmp/a\n"
9809 " /tmp/b\n"
9810 " /tmp/c/d\n"
9811 "\n"
9812 msgstr ""
9813
9814 # type: textblock
9815 #. type: textblock
9816 #: ../src/guestfs-actions.pod:1739
9817 msgid ""
9818 "then the returned list from C<guestfs_find> C</tmp> would be 4 elements:"
9819 msgstr ""
9820
9821 # type: verbatim
9822 #. type: verbatim
9823 #: ../src/guestfs-actions.pod:1742 ../fish/guestfish-actions.pod:1180
9824 #, no-wrap
9825 msgid ""
9826 " a\n"
9827 " b\n"
9828 " c\n"
9829 " c/d\n"
9830 "\n"
9831 msgstr ""
9832
9833 # type: textblock
9834 #. type: textblock
9835 #: ../src/guestfs-actions.pod:1747 ../fish/guestfish-actions.pod:1185
9836 msgid "If C<directory> is not a directory, then this command returns an error."
9837 msgstr ""
9838
9839 # type: textblock
9840 #. type: textblock
9841 #: ../src/guestfs-actions.pod:1750 ../fish/guestfish-actions.pod:1188
9842 msgid "The returned list is sorted."
9843 msgstr ""
9844
9845 # type: textblock
9846 #. type: textblock
9847 #: ../src/guestfs-actions.pod:1752
9848 msgid "See also C<guestfs_find0>."
9849 msgstr ""
9850
9851 # type: textblock
9852 #. type: textblock
9853 #: ../src/guestfs-actions.pod:1761 ../src/guestfs-actions.pod:4011
9854 #: ../src/guestfs-actions.pod:5554
9855 msgid "(Added in 1.0.27)"
9856 msgstr ""
9857
9858 # type: =head2
9859 #. type: =head2
9860 #: ../src/guestfs-actions.pod:1763
9861 msgid "guestfs_find0"
9862 msgstr ""
9863
9864 # type: verbatim
9865 #. type: verbatim
9866 #: ../src/guestfs-actions.pod:1765
9867 #, no-wrap
9868 msgid ""
9869 " int\n"
9870 " guestfs_find0 (guestfs_h *g,\n"
9871 "                const char *directory,\n"
9872 "                const char *files);\n"
9873 "\n"
9874 msgstr ""
9875
9876 # type: textblock
9877 #. type: textblock
9878 #: ../src/guestfs-actions.pod:1770 ../fish/guestfish-actions.pod:1199
9879 msgid ""
9880 "This command lists out all files and directories, recursively, starting at "
9881 "C<directory>, placing the resulting list in the external file called "
9882 "C<files>."
9883 msgstr ""
9884
9885 # type: textblock
9886 #. type: textblock
9887 #: ../src/guestfs-actions.pod:1774
9888 msgid ""
9889 "This command works the same way as C<guestfs_find> with the following "
9890 "exceptions:"
9891 msgstr ""
9892
9893 # type: textblock
9894 #. type: textblock
9895 #: ../src/guestfs-actions.pod:1781 ../fish/guestfish-actions.pod:1210
9896 msgid "The resulting list is written to an external file."
9897 msgstr ""
9898
9899 # type: textblock
9900 #. type: textblock
9901 #: ../src/guestfs-actions.pod:1785 ../fish/guestfish-actions.pod:1214
9902 msgid ""
9903 "Items (filenames) in the result are separated by C<\\0> characters.  See "
9904 "L<find(1)> option I<-print0>."
9905 msgstr ""
9906
9907 # type: textblock
9908 #. type: textblock
9909 #: ../src/guestfs-actions.pod:1790 ../fish/guestfish-actions.pod:1219
9910 msgid "This command is not limited in the number of names that it can return."
9911 msgstr ""
9912
9913 # type: textblock
9914 #. type: textblock
9915 #: ../src/guestfs-actions.pod:1795 ../fish/guestfish-actions.pod:1224
9916 msgid "The result list is not sorted."
9917 msgstr ""
9918
9919 # type: textblock
9920 #. type: textblock
9921 #: ../src/guestfs-actions.pod:1801
9922 msgid "(Added in 1.0.74)"
9923 msgstr ""
9924
9925 # type: =head2
9926 #. type: =head2
9927 #: ../src/guestfs-actions.pod:1803
9928 msgid "guestfs_findfs_label"
9929 msgstr ""
9930
9931 # type: verbatim
9932 #. type: verbatim
9933 #: ../src/guestfs-actions.pod:1805
9934 #, no-wrap
9935 msgid ""
9936 " char *\n"
9937 " guestfs_findfs_label (guestfs_h *g,\n"
9938 "                       const char *label);\n"
9939 "\n"
9940 msgstr ""
9941
9942 # type: textblock
9943 #. type: textblock
9944 #: ../src/guestfs-actions.pod:1809 ../fish/guestfish-actions.pod:1234
9945 msgid ""
9946 "This command searches the filesystems and returns the one which has the "
9947 "given label.  An error is returned if no such filesystem can be found."
9948 msgstr ""
9949
9950 # type: textblock
9951 #. type: textblock
9952 #: ../src/guestfs-actions.pod:1813
9953 msgid "To find the label of a filesystem, use C<guestfs_vfs_label>."
9954 msgstr ""
9955
9956 # type: =head2
9957 #. type: =head2
9958 #: ../src/guestfs-actions.pod:1820
9959 msgid "guestfs_findfs_uuid"
9960 msgstr ""
9961
9962 # type: verbatim
9963 #. type: verbatim
9964 #: ../src/guestfs-actions.pod:1822
9965 #, no-wrap
9966 msgid ""
9967 " char *\n"
9968 " guestfs_findfs_uuid (guestfs_h *g,\n"
9969 "                      const char *uuid);\n"
9970 "\n"
9971 msgstr ""
9972
9973 # type: textblock
9974 #. type: textblock
9975 #: ../src/guestfs-actions.pod:1826 ../fish/guestfish-actions.pod:1244
9976 msgid ""
9977 "This command searches the filesystems and returns the one which has the "
9978 "given UUID.  An error is returned if no such filesystem can be found."
9979 msgstr ""
9980
9981 # type: textblock
9982 #. type: textblock
9983 #: ../src/guestfs-actions.pod:1830
9984 msgid "To find the UUID of a filesystem, use C<guestfs_vfs_uuid>."
9985 msgstr ""
9986
9987 # type: =head2
9988 #. type: =head2
9989 #: ../src/guestfs-actions.pod:1837
9990 msgid "guestfs_fsck"
9991 msgstr ""
9992
9993 # type: verbatim
9994 #. type: verbatim
9995 #: ../src/guestfs-actions.pod:1839
9996 #, no-wrap
9997 msgid ""
9998 " int\n"
9999 " guestfs_fsck (guestfs_h *g,\n"
10000 "               const char *fstype,\n"
10001 "               const char *device);\n"
10002 "\n"
10003 msgstr ""
10004
10005 # type: textblock
10006 #. type: textblock
10007 #: ../src/guestfs-actions.pod:1844 ../fish/guestfish-actions.pod:1254
10008 msgid ""
10009 "This runs the filesystem checker (fsck) on C<device> which should have "
10010 "filesystem type C<fstype>."
10011 msgstr ""
10012
10013 # type: textblock
10014 #. type: textblock
10015 #: ../src/guestfs-actions.pod:1847 ../fish/guestfish-actions.pod:1257
10016 msgid ""
10017 "The returned integer is the status.  See L<fsck(8)> for the list of status "
10018 "codes from C<fsck>."
10019 msgstr ""
10020
10021 # type: textblock
10022 #. type: textblock
10023 #: ../src/guestfs-actions.pod:1856 ../fish/guestfish-actions.pod:1266
10024 msgid "Multiple status codes can be summed together."
10025 msgstr ""
10026
10027 # type: textblock
10028 #. type: textblock
10029 #: ../src/guestfs-actions.pod:1860 ../fish/guestfish-actions.pod:1270
10030 msgid ""
10031 "A non-zero return code can mean \"success\", for example if errors have been "
10032 "corrected on the filesystem."
10033 msgstr ""
10034
10035 # type: textblock
10036 #. type: textblock
10037 #: ../src/guestfs-actions.pod:1865 ../fish/guestfish-actions.pod:1275
10038 msgid "Checking or repairing NTFS volumes is not supported (by linux-ntfs)."
10039 msgstr ""
10040
10041 # type: textblock
10042 #. type: textblock
10043 #: ../src/guestfs-actions.pod:1870 ../fish/guestfish-actions.pod:1280
10044 msgid ""
10045 "This command is entirely equivalent to running C<fsck -a -t fstype device>."
10046 msgstr ""
10047
10048 # type: textblock
10049 #. type: textblock
10050 #: ../src/guestfs-actions.pod:1874 ../src/guestfs-actions.pod:7250
10051 msgid "(Added in 1.0.16)"
10052 msgstr ""
10053
10054 # type: =head2
10055 #. type: =head2
10056 #: ../src/guestfs-actions.pod:1876
10057 msgid "guestfs_get_append"
10058 msgstr ""
10059
10060 # type: verbatim
10061 #. type: verbatim
10062 #: ../src/guestfs-actions.pod:1878
10063 #, no-wrap
10064 msgid ""
10065 " const char *\n"
10066 " guestfs_get_append (guestfs_h *g);\n"
10067 "\n"
10068 msgstr ""
10069
10070 # type: textblock
10071 #. type: textblock
10072 #: ../src/guestfs-actions.pod:1881 ../fish/guestfish-actions.pod:1286
10073 msgid ""
10074 "Return the additional kernel options which are added to the guest kernel "
10075 "command line."
10076 msgstr ""
10077
10078 # type: textblock
10079 #. type: textblock
10080 #: ../src/guestfs-actions.pod:1884 ../fish/guestfish-actions.pod:1289
10081 msgid "If C<NULL> then no options are added."
10082 msgstr ""
10083
10084 # type: textblock
10085 #. type: textblock
10086 #: ../src/guestfs-actions.pod:1886
10087 msgid ""
10088 "This function returns a string which may be NULL.  There is no way to return "
10089 "an error from this function.  The string is owned by the guest handle and "
10090 "must I<not> be freed."
10091 msgstr ""
10092
10093 # type: textblock
10094 #. type: textblock
10095 #: ../src/guestfs-actions.pod:1890 ../src/guestfs-actions.pod:5232
10096 #: ../src/guestfs-actions.pod:5712 ../src/guestfs-actions.pod:6112
10097 #: ../src/guestfs-actions.pod:6131 ../src/guestfs-actions.pod:6147
10098 #: ../src/guestfs-actions.pod:6164 ../src/guestfs-actions.pod:6921
10099 #: ../src/guestfs-actions.pod:6939 ../src/guestfs-actions.pod:7293
10100 msgid "(Added in 1.0.26)"
10101 msgstr ""
10102
10103 #. type: =head2
10104 #: ../src/guestfs-actions.pod:1892
10105 msgid "guestfs_get_attach_method"
10106 msgstr ""
10107
10108 #. type: verbatim
10109 #: ../src/guestfs-actions.pod:1894
10110 #, no-wrap
10111 msgid ""
10112 " char *\n"
10113 " guestfs_get_attach_method (guestfs_h *g);\n"
10114 "\n"
10115 msgstr ""
10116
10117 #. type: textblock
10118 #: ../src/guestfs-actions.pod:1897
10119 msgid "Return the current attach method.  See C<guestfs_set_attach_method>."
10120 msgstr ""
10121
10122 # type: =head2
10123 #. type: =head2
10124 #: ../src/guestfs-actions.pod:1902
10125 msgid "guestfs_get_autosync"
10126 msgstr ""
10127
10128 # type: verbatim
10129 #. type: verbatim
10130 #: ../src/guestfs-actions.pod:1904
10131 #, no-wrap
10132 msgid ""
10133 " int\n"
10134 " guestfs_get_autosync (guestfs_h *g);\n"
10135 "\n"
10136 msgstr ""
10137
10138 # type: textblock
10139 #. type: textblock
10140 #: ../src/guestfs-actions.pod:1907 ../fish/guestfish-actions.pod:1301
10141 msgid "Get the autosync flag."
10142 msgstr ""
10143
10144 # type: =head2
10145 #. type: =head2
10146 #: ../src/guestfs-actions.pod:1913
10147 msgid "guestfs_get_direct"
10148 msgstr ""
10149
10150 # type: verbatim
10151 #. type: verbatim
10152 #: ../src/guestfs-actions.pod:1915
10153 #, no-wrap
10154 msgid ""
10155 " int\n"
10156 " guestfs_get_direct (guestfs_h *g);\n"
10157 "\n"
10158 msgstr ""
10159
10160 # type: textblock
10161 #. type: textblock
10162 #: ../src/guestfs-actions.pod:1918 ../fish/guestfish-actions.pod:1307
10163 msgid "Return the direct appliance mode flag."
10164 msgstr ""
10165
10166 # type: textblock
10167 #. type: textblock
10168 #: ../src/guestfs-actions.pod:1922 ../src/guestfs-actions.pod:5781
10169 msgid "(Added in 1.0.72)"
10170 msgstr ""
10171
10172 # type: =head2
10173 #. type: =head2
10174 #: ../src/guestfs-actions.pod:1924
10175 msgid "guestfs_get_e2label"
10176 msgstr ""
10177
10178 # type: verbatim
10179 #. type: verbatim
10180 #: ../src/guestfs-actions.pod:1926
10181 #, no-wrap
10182 msgid ""
10183 " char *\n"
10184 " guestfs_get_e2label (guestfs_h *g,\n"
10185 "                      const char *device);\n"
10186 "\n"
10187 msgstr ""
10188
10189 # type: textblock
10190 #. type: textblock
10191 #: ../src/guestfs-actions.pod:1930 ../fish/guestfish-actions.pod:1313
10192 msgid ""
10193 "This returns the ext2/3/4 filesystem label of the filesystem on C<device>."
10194 msgstr ""
10195
10196 # type: textblock
10197 #. type: textblock
10198 #: ../src/guestfs-actions.pod:1936 ../fish/guestfish-actions.pod:1316
10199 msgid ""
10200 "This function is deprecated.  In new code, use the C<vfs_label> call instead."
10201 msgstr ""
10202
10203 # type: textblock
10204 #. type: textblock
10205 #: ../src/guestfs-actions.pod:1943 ../src/guestfs-actions.pod:1964
10206 #: ../src/guestfs-actions.pod:5799 ../src/guestfs-actions.pod:5818
10207 msgid "(Added in 1.0.15)"
10208 msgstr ""
10209
10210 # type: =head2
10211 #. type: =head2
10212 #: ../src/guestfs-actions.pod:1945
10213 msgid "guestfs_get_e2uuid"
10214 msgstr ""
10215
10216 # type: verbatim
10217 #. type: verbatim
10218 #: ../src/guestfs-actions.pod:1947
10219 #, no-wrap
10220 msgid ""
10221 " char *\n"
10222 " guestfs_get_e2uuid (guestfs_h *g,\n"
10223 "                     const char *device);\n"
10224 "\n"
10225 msgstr ""
10226
10227 # type: textblock
10228 #. type: textblock
10229 #: ../src/guestfs-actions.pod:1951 ../fish/guestfish-actions.pod:1327
10230 msgid ""
10231 "This returns the ext2/3/4 filesystem UUID of the filesystem on C<device>."
10232 msgstr ""
10233
10234 # type: textblock
10235 #. type: textblock
10236 #: ../src/guestfs-actions.pod:1957 ../fish/guestfish-actions.pod:1330
10237 msgid ""
10238 "This function is deprecated.  In new code, use the C<vfs_uuid> call instead."
10239 msgstr ""
10240
10241 # type: =head2
10242 #. type: =head2
10243 #: ../src/guestfs-actions.pod:1966
10244 msgid "guestfs_get_memsize"
10245 msgstr ""
10246
10247 # type: verbatim
10248 #. type: verbatim
10249 #: ../src/guestfs-actions.pod:1968
10250 #, no-wrap
10251 msgid ""
10252 " int\n"
10253 " guestfs_get_memsize (guestfs_h *g);\n"
10254 "\n"
10255 msgstr ""
10256
10257 # type: textblock
10258 #. type: textblock
10259 #: ../src/guestfs-actions.pod:1971 ../fish/guestfish-actions.pod:1341
10260 msgid ""
10261 "This gets the memory size in megabytes allocated to the qemu subprocess."
10262 msgstr ""
10263
10264 # type: textblock
10265 #. type: textblock
10266 #: ../src/guestfs-actions.pod:1974
10267 msgid ""
10268 "If C<guestfs_set_memsize> was not called on this handle, and if "
10269 "C<LIBGUESTFS_MEMSIZE> was not set, then this returns the compiled-in default "
10270 "value for memsize."
10271 msgstr ""
10272
10273 # type: textblock
10274 #. type: textblock
10275 #: ../src/guestfs-actions.pod:1978 ../src/guestfs-actions.pod:2059
10276 #: ../src/guestfs-actions.pod:5834 ../src/guestfs-actions.pod:5941
10277 #: ../fish/guestfish-actions.pod:1348 ../fish/guestfish-actions.pod:1399
10278 #: ../fish/guestfish-actions.pod:3927 ../fish/guestfish-actions.pod:4014
10279 msgid ""
10280 "For more information on the architecture of libguestfs, see L<guestfs(3)>."
10281 msgstr ""
10282
10283 # type: textblock
10284 #. type: textblock
10285 #: ../src/guestfs-actions.pod:1983 ../src/guestfs-actions.pod:4302
10286 #: ../src/guestfs-actions.pod:4499 ../src/guestfs-actions.pod:4518
10287 #: ../src/guestfs-actions.pod:4537 ../src/guestfs-actions.pod:4549
10288 #: ../src/guestfs-actions.pod:4566 ../src/guestfs-actions.pod:4579
10289 #: ../src/guestfs-actions.pod:5457 ../src/guestfs-actions.pod:5839
10290 #: ../src/guestfs-actions.pod:6086 ../src/guestfs-actions.pod:6687
10291 msgid "(Added in 1.0.55)"
10292 msgstr ""
10293
10294 # type: =head2
10295 #. type: =head2
10296 #: ../src/guestfs-actions.pod:1985
10297 msgid "guestfs_get_network"
10298 msgstr ""
10299
10300 # type: verbatim
10301 #. type: verbatim
10302 #: ../src/guestfs-actions.pod:1987
10303 #, no-wrap
10304 msgid ""
10305 " int\n"
10306 " guestfs_get_network (guestfs_h *g);\n"
10307 "\n"
10308 msgstr ""
10309
10310 # type: textblock
10311 #. type: textblock
10312 #: ../src/guestfs-actions.pod:1990 ../fish/guestfish-actions.pod:1355
10313 msgid "This returns the enable network flag."
10314 msgstr ""
10315
10316 # type: textblock
10317 #. type: textblock
10318 #: ../src/guestfs-actions.pod:1994 ../src/guestfs-actions.pod:5858
10319 msgid "(Added in 1.5.4)"
10320 msgstr ""
10321
10322 # type: =head2
10323 #. type: =head2
10324 #: ../src/guestfs-actions.pod:1996
10325 msgid "guestfs_get_path"
10326 msgstr ""
10327
10328 # type: verbatim
10329 #. type: verbatim
10330 #: ../src/guestfs-actions.pod:1998
10331 #, no-wrap
10332 msgid ""
10333 " const char *\n"
10334 " guestfs_get_path (guestfs_h *g);\n"
10335 "\n"
10336 msgstr ""
10337
10338 # type: textblock
10339 #. type: textblock
10340 #: ../src/guestfs-actions.pod:2001 ../fish/guestfish-actions.pod:1361
10341 msgid "Return the current search path."
10342 msgstr ""
10343
10344 # type: textblock
10345 #. type: textblock
10346 #: ../src/guestfs-actions.pod:2003 ../fish/guestfish-actions.pod:1363
10347 msgid ""
10348 "This is always non-NULL.  If it wasn't set already, then this will return "
10349 "the default path."
10350 msgstr ""
10351
10352 # type: textblock
10353 #. type: textblock
10354 #: ../src/guestfs-actions.pod:2006 ../src/guestfs-actions.pod:2035
10355 msgid ""
10356 "This function returns a string, or NULL on error.  The string is owned by "
10357 "the guest handle and must I<not> be freed."
10358 msgstr ""
10359
10360 # type: =head2
10361 #. type: =head2
10362 #: ../src/guestfs-actions.pod:2011
10363 msgid "guestfs_get_pid"
10364 msgstr ""
10365
10366 # type: verbatim
10367 #. type: verbatim
10368 #: ../src/guestfs-actions.pod:2013
10369 #, no-wrap
10370 msgid ""
10371 " int\n"
10372 " guestfs_get_pid (guestfs_h *g);\n"
10373 "\n"
10374 msgstr ""
10375
10376 # type: textblock
10377 #. type: textblock
10378 #: ../src/guestfs-actions.pod:2016 ../fish/guestfish-actions.pod:1372
10379 msgid ""
10380 "Return the process ID of the qemu subprocess.  If there is no qemu "
10381 "subprocess, then this will return an error."
10382 msgstr ""
10383
10384 # type: textblock
10385 #. type: textblock
10386 #: ../src/guestfs-actions.pod:2019 ../fish/guestfish-actions.pod:1375
10387 msgid "This is an internal call used for debugging and testing."
10388 msgstr ""
10389
10390 # type: textblock
10391 #. type: textblock
10392 #: ../src/guestfs-actions.pod:2023
10393 msgid "(Added in 1.0.56)"
10394 msgstr ""
10395
10396 # type: =head2
10397 #. type: =head2
10398 #: ../src/guestfs-actions.pod:2025
10399 msgid "guestfs_get_qemu"
10400 msgstr ""
10401
10402 # type: verbatim
10403 #. type: verbatim
10404 #: ../src/guestfs-actions.pod:2027
10405 #, no-wrap
10406 msgid ""
10407 " const char *\n"
10408 " guestfs_get_qemu (guestfs_h *g);\n"
10409 "\n"
10410 msgstr ""
10411
10412 # type: textblock
10413 #. type: textblock
10414 #: ../src/guestfs-actions.pod:2030 ../fish/guestfish-actions.pod:1381
10415 msgid "Return the current qemu binary."
10416 msgstr ""
10417
10418 # type: textblock
10419 #. type: textblock
10420 #: ../src/guestfs-actions.pod:2032 ../fish/guestfish-actions.pod:1383
10421 msgid ""
10422 "This is always non-NULL.  If it wasn't set already, then this will return "
10423 "the default qemu binary name."
10424 msgstr ""
10425
10426 # type: textblock
10427 #. type: textblock
10428 #: ../src/guestfs-actions.pod:2038 ../src/guestfs-actions.pod:5903
10429 msgid "(Added in 1.0.6)"
10430 msgstr ""
10431
10432 # type: =head2
10433 #. type: =head2
10434 #: ../src/guestfs-actions.pod:2040
10435 msgid "guestfs_get_recovery_proc"
10436 msgstr ""
10437
10438 # type: verbatim
10439 #. type: verbatim
10440 #: ../src/guestfs-actions.pod:2042
10441 #, no-wrap
10442 msgid ""
10443 " int\n"
10444 " guestfs_get_recovery_proc (guestfs_h *g);\n"
10445 "\n"
10446 msgstr ""
10447
10448 # type: textblock
10449 #. type: textblock
10450 #: ../src/guestfs-actions.pod:2045 ../fish/guestfish-actions.pod:1390
10451 msgid "Return the recovery process enabled flag."
10452 msgstr ""
10453
10454 # type: textblock
10455 #. type: textblock
10456 #: ../src/guestfs-actions.pod:2049 ../src/guestfs-actions.pod:3412
10457 #: ../src/guestfs-actions.pod:3709 ../src/guestfs-actions.pod:4109
10458 #: ../src/guestfs-actions.pod:4141 ../src/guestfs-actions.pod:5162
10459 #: ../src/guestfs-actions.pod:5505 ../src/guestfs-actions.pod:5927
10460 #: ../src/guestfs-actions.pod:6590 ../src/guestfs-actions.pod:6610
10461 #: ../src/guestfs-actions.pod:6802
10462 msgid "(Added in 1.0.77)"
10463 msgstr ""
10464
10465 # type: =head2
10466 #. type: =head2
10467 #: ../src/guestfs-actions.pod:2051
10468 msgid "guestfs_get_selinux"
10469 msgstr ""
10470
10471 # type: verbatim
10472 #. type: verbatim
10473 #: ../src/guestfs-actions.pod:2053
10474 #, no-wrap
10475 msgid ""
10476 " int\n"
10477 " guestfs_get_selinux (guestfs_h *g);\n"
10478 "\n"
10479 msgstr ""
10480
10481 # type: textblock
10482 #. type: textblock
10483 #: ../src/guestfs-actions.pod:2056
10484 msgid ""
10485 "This returns the current setting of the selinux flag which is passed to the "
10486 "appliance at boot time.  See C<guestfs_set_selinux>."
10487 msgstr ""
10488
10489 # type: textblock
10490 #. type: textblock
10491 #: ../src/guestfs-actions.pod:2064 ../src/guestfs-actions.pod:2127
10492 #: ../src/guestfs-actions.pod:5946 ../src/guestfs-actions.pod:6004
10493 msgid "(Added in 1.0.67)"
10494 msgstr ""
10495
10496 # type: =head2
10497 #. type: =head2
10498 #: ../src/guestfs-actions.pod:2066
10499 msgid "guestfs_get_state"
10500 msgstr ""
10501
10502 # type: verbatim
10503 #. type: verbatim
10504 #: ../src/guestfs-actions.pod:2068
10505 #, no-wrap
10506 msgid ""
10507 " int\n"
10508 " guestfs_get_state (guestfs_h *g);\n"
10509 "\n"
10510 msgstr ""
10511
10512 # type: textblock
10513 #. type: textblock
10514 #: ../src/guestfs-actions.pod:2071 ../fish/guestfish-actions.pod:1406
10515 msgid ""
10516 "This returns the current state as an opaque integer.  This is only useful "
10517 "for printing debug and internal error messages."
10518 msgstr ""
10519
10520 # type: textblock
10521 #. type: textblock
10522 #: ../src/guestfs-actions.pod:2074 ../src/guestfs-actions.pod:3215
10523 #: ../src/guestfs-actions.pod:3244 ../src/guestfs-actions.pod:3305
10524 #: ../src/guestfs-actions.pod:3332 ../fish/guestfish-actions.pod:1409
10525 #: ../fish/guestfish-actions.pod:2257 ../fish/guestfish-actions.pod:2275
10526 #: ../fish/guestfish-actions.pod:2313 ../fish/guestfish-actions.pod:2329
10527 msgid "For more information on states, see L<guestfs(3)>."
10528 msgstr ""
10529
10530 # type: =head2
10531 #. type: =head2
10532 #: ../src/guestfs-actions.pod:2080
10533 msgid "guestfs_get_trace"
10534 msgstr ""
10535
10536 # type: verbatim
10537 #. type: verbatim
10538 #: ../src/guestfs-actions.pod:2082
10539 #, no-wrap
10540 msgid ""
10541 " int\n"
10542 " guestfs_get_trace (guestfs_h *g);\n"
10543 "\n"
10544 msgstr ""
10545
10546 # type: textblock
10547 #. type: textblock
10548 #: ../src/guestfs-actions.pod:2085 ../fish/guestfish-actions.pod:1415
10549 msgid "Return the command trace flag."
10550 msgstr ""
10551
10552 # type: =head2
10553 #. type: =head2
10554 #: ../src/guestfs-actions.pod:2091
10555 msgid "guestfs_get_umask"
10556 msgstr ""
10557
10558 # type: verbatim
10559 #. type: verbatim
10560 #: ../src/guestfs-actions.pod:2093
10561 #, no-wrap
10562 msgid ""
10563 " int\n"
10564 " guestfs_get_umask (guestfs_h *g);\n"
10565 "\n"
10566 msgstr ""
10567
10568 # type: textblock
10569 #. type: textblock
10570 #: ../src/guestfs-actions.pod:2096
10571 msgid ""
10572 "Return the current umask.  By default the umask is C<022> unless it has been "
10573 "set by calling C<guestfs_umask>."
10574 msgstr ""
10575
10576 # type: =head2
10577 #. type: =head2
10578 #: ../src/guestfs-actions.pod:2103
10579 msgid "guestfs_get_verbose"
10580 msgstr ""
10581
10582 # type: verbatim
10583 #. type: verbatim
10584 #: ../src/guestfs-actions.pod:2105
10585 #, no-wrap
10586 msgid ""
10587 " int\n"
10588 " guestfs_get_verbose (guestfs_h *g);\n"
10589 "\n"
10590 msgstr ""
10591
10592 # type: textblock
10593 #. type: textblock
10594 #: ../src/guestfs-actions.pod:2108 ../fish/guestfish-actions.pod:1428
10595 msgid "This returns the verbose messages flag."
10596 msgstr ""
10597
10598 # type: =head2
10599 #. type: =head2
10600 #: ../src/guestfs-actions.pod:2114
10601 msgid "guestfs_getcon"
10602 msgstr ""
10603
10604 # type: verbatim
10605 #. type: verbatim
10606 #: ../src/guestfs-actions.pod:2116
10607 #, no-wrap
10608 msgid ""
10609 " char *\n"
10610 " guestfs_getcon (guestfs_h *g);\n"
10611 "\n"
10612 msgstr ""
10613
10614 # type: textblock
10615 #. type: textblock
10616 #: ../src/guestfs-actions.pod:2119 ../fish/guestfish-actions.pod:1434
10617 msgid "This gets the SELinux security context of the daemon."
10618 msgstr ""
10619
10620 # type: textblock
10621 #. type: textblock
10622 #: ../src/guestfs-actions.pod:2121
10623 msgid ""
10624 "See the documentation about SELINUX in L<guestfs(3)>, and C<guestfs_setcon>"
10625 msgstr ""
10626
10627 # type: =head2
10628 #. type: =head2
10629 #: ../src/guestfs-actions.pod:2129
10630 msgid "guestfs_getxattr"
10631 msgstr ""
10632
10633 # type: verbatim
10634 #. type: verbatim
10635 #: ../src/guestfs-actions.pod:2131
10636 #, no-wrap
10637 msgid ""
10638 " char *\n"
10639 " guestfs_getxattr (guestfs_h *g,\n"
10640 "                   const char *path,\n"
10641 "                   const char *name,\n"
10642 "                   size_t *size_r);\n"
10643 "\n"
10644 msgstr ""
10645
10646 # type: textblock
10647 #. type: textblock
10648 #: ../src/guestfs-actions.pod:2137
10649 msgid ""
10650 "Get a single extended attribute from file C<path> named C<name>.  This call "
10651 "follows symlinks.  If you want to lookup an extended attribute for the "
10652 "symlink itself, use C<guestfs_lgetxattr>."
10653 msgstr ""
10654
10655 # type: textblock
10656 #. type: textblock
10657 #: ../src/guestfs-actions.pod:2141 ../src/guestfs-actions.pod:3426
10658 msgid ""
10659 "Normally it is better to get all extended attributes from a file in one go "
10660 "by calling C<guestfs_getxattrs>.  However some Linux filesystem "
10661 "implementations are buggy and do not provide a way to list out attributes.  "
10662 "For these filesystems (notably ntfs-3g)  you have to know the names of the "
10663 "extended attributes you want in advance and call this function."
10664 msgstr ""
10665
10666 # type: textblock
10667 #. type: textblock
10668 #: ../src/guestfs-actions.pod:2148 ../src/guestfs-actions.pod:3433
10669 #: ../fish/guestfish-actions.pod:1454 ../fish/guestfish-actions.pod:2394
10670 msgid ""
10671 "Extended attribute values are blobs of binary data.  If there is no extended "
10672 "attribute named C<name>, this returns an error."
10673 msgstr ""
10674
10675 # type: textblock
10676 #. type: textblock
10677 #: ../src/guestfs-actions.pod:2151
10678 msgid "See also: C<guestfs_getxattrs>, C<guestfs_lgetxattr>, L<attr(5)>."
10679 msgstr ""
10680
10681 # type: textblock
10682 #. type: textblock
10683 #: ../src/guestfs-actions.pod:2153 ../src/guestfs-actions.pod:2344
10684 #: ../src/guestfs-actions.pod:3438 ../src/guestfs-actions.pod:5155
10685 #: ../src/guestfs-actions.pod:5181 ../src/guestfs-actions.pod:5362
10686 msgid ""
10687 "This function returns a buffer, or NULL on error.  The size of the returned "
10688 "buffer is written to C<*size_r>.  I<The caller must free the returned buffer "
10689 "after use>."
10690 msgstr ""
10691
10692 #. type: textblock
10693 #: ../src/guestfs-actions.pod:2157 ../src/guestfs-actions.pod:3442
10694 msgid "(Added in 1.7.24)"
10695 msgstr ""
10696
10697 # type: =head2
10698 #. type: =head2
10699 #: ../src/guestfs-actions.pod:2159
10700 msgid "guestfs_getxattrs"
10701 msgstr ""
10702
10703 # type: verbatim
10704 #. type: verbatim
10705 #: ../src/guestfs-actions.pod:2161
10706 #, no-wrap
10707 msgid ""
10708 " struct guestfs_xattr_list *\n"
10709 " guestfs_getxattrs (guestfs_h *g,\n"
10710 "                    const char *path);\n"
10711 "\n"
10712 msgstr ""
10713
10714 # type: textblock
10715 #. type: textblock
10716 #: ../src/guestfs-actions.pod:2165 ../fish/guestfish-actions.pod:1463
10717 msgid ""
10718 "This call lists the extended attributes of the file or directory C<path>."
10719 msgstr ""
10720
10721 # type: textblock
10722 #. type: textblock
10723 #: ../src/guestfs-actions.pod:2168 ../fish/guestfish-actions.pod:1466
10724 msgid ""
10725 "At the system call level, this is a combination of the L<listxattr(2)> and "
10726 "L<getxattr(2)> calls."
10727 msgstr ""
10728
10729 # type: textblock
10730 #. type: textblock
10731 #: ../src/guestfs-actions.pod:2171
10732 msgid "See also: C<guestfs_lgetxattrs>, L<attr(5)>."
10733 msgstr ""
10734
10735 # type: textblock
10736 #. type: textblock
10737 #: ../src/guestfs-actions.pod:2173 ../src/guestfs-actions.pod:3454
10738 #: ../src/guestfs-actions.pod:4105
10739 msgid ""
10740 "This function returns a C<struct guestfs_xattr_list *>, or NULL if there was "
10741 "an error.  I<The caller must call C<guestfs_free_xattr_list> after use>."
10742 msgstr ""
10743
10744 # type: textblock
10745 #. type: textblock
10746 #: ../src/guestfs-actions.pod:2177 ../src/guestfs-actions.pod:3458
10747 #: ../src/guestfs-actions.pod:3623 ../src/guestfs-actions.pod:3659
10748 #: ../src/guestfs-actions.pod:5535 ../src/guestfs-actions.pod:6023
10749 #: ../src/guestfs-actions.pod:7358
10750 msgid "(Added in 1.0.59)"
10751 msgstr ""
10752
10753 # type: =head2
10754 #. type: =head2
10755 #: ../src/guestfs-actions.pod:2179
10756 msgid "guestfs_glob_expand"
10757 msgstr ""
10758
10759 # type: verbatim
10760 #. type: verbatim
10761 #: ../src/guestfs-actions.pod:2181
10762 #, no-wrap
10763 msgid ""
10764 " char **\n"
10765 " guestfs_glob_expand (guestfs_h *g,\n"
10766 "                      const char *pattern);\n"
10767 "\n"
10768 msgstr ""
10769
10770 # type: textblock
10771 #. type: textblock
10772 #: ../src/guestfs-actions.pod:2185 ../fish/guestfish-actions.pod:1475
10773 msgid ""
10774 "This command searches for all the pathnames matching C<pattern> according to "
10775 "the wildcard expansion rules used by the shell."
10776 msgstr ""
10777
10778 # type: textblock
10779 #. type: textblock
10780 #: ../src/guestfs-actions.pod:2189 ../fish/guestfish-actions.pod:1479
10781 msgid ""
10782 "If no paths match, then this returns an empty list (note: not an error)."
10783 msgstr ""
10784
10785 # type: textblock
10786 #. type: textblock
10787 #: ../src/guestfs-actions.pod:2192 ../fish/guestfish-actions.pod:1482
10788 msgid ""
10789 "It is just a wrapper around the C L<glob(3)> function with flags C<GLOB_MARK|"
10790 "GLOB_BRACE>.  See that manual page for more details."
10791 msgstr ""
10792
10793 # type: textblock
10794 #. type: textblock
10795 #: ../src/guestfs-actions.pod:2200 ../src/guestfs-actions.pod:6188
10796 #: ../src/guestfs-actions.pod:6205
10797 msgid "(Added in 1.0.50)"
10798 msgstr ""
10799
10800 # type: =head2
10801 #. type: =head2
10802 #: ../src/guestfs-actions.pod:2202
10803 msgid "guestfs_grep"
10804 msgstr ""
10805
10806 # type: verbatim
10807 #. type: verbatim
10808 #: ../src/guestfs-actions.pod:2204
10809 #, no-wrap
10810 msgid ""
10811 " char **\n"
10812 " guestfs_grep (guestfs_h *g,\n"
10813 "               const char *regex,\n"
10814 "               const char *path);\n"
10815 "\n"
10816 msgstr ""
10817
10818 # type: textblock
10819 #. type: textblock
10820 #: ../src/guestfs-actions.pod:2209 ../fish/guestfish-actions.pod:1490
10821 msgid "This calls the external C<grep> program and returns the matching lines."
10822 msgstr ""
10823
10824 # type: =head2
10825 #. type: =head2
10826 #: ../src/guestfs-actions.pod:2221
10827 msgid "guestfs_grepi"
10828 msgstr ""
10829
10830 # type: verbatim
10831 #. type: verbatim
10832 #: ../src/guestfs-actions.pod:2223
10833 #, no-wrap
10834 msgid ""
10835 " char **\n"
10836 " guestfs_grepi (guestfs_h *g,\n"
10837 "                const char *regex,\n"
10838 "                const char *path);\n"
10839 "\n"
10840 msgstr ""
10841
10842 # type: textblock
10843 #. type: textblock
10844 #: ../src/guestfs-actions.pod:2228 ../fish/guestfish-actions.pod:1500
10845 msgid ""
10846 "This calls the external C<grep -i> program and returns the matching lines."
10847 msgstr ""
10848
10849 # type: =head2
10850 #. type: =head2
10851 #: ../src/guestfs-actions.pod:2240
10852 msgid "guestfs_grub_install"
10853 msgstr ""
10854
10855 # type: verbatim
10856 #. type: verbatim
10857 #: ../src/guestfs-actions.pod:2242
10858 #, no-wrap
10859 msgid ""
10860 " int\n"
10861 " guestfs_grub_install (guestfs_h *g,\n"
10862 "                       const char *root,\n"
10863 "                       const char *device);\n"
10864 "\n"
10865 msgstr ""
10866
10867 # type: textblock
10868 #. type: textblock
10869 #: ../src/guestfs-actions.pod:2247 ../fish/guestfish-actions.pod:1510
10870 msgid ""
10871 "This command installs GRUB (the Grand Unified Bootloader) on C<device>, with "
10872 "the root directory being C<root>."
10873 msgstr ""
10874
10875 # type: textblock
10876 #. type: textblock
10877 #: ../src/guestfs-actions.pod:2250 ../fish/guestfish-actions.pod:1513
10878 msgid ""
10879 "Note: If grub-install reports the error \"No suitable drive was found in the "
10880 "generated device map.\" it may be that you need to create a C</boot/grub/"
10881 "device.map> file first that contains the mapping between grub device names "
10882 "and Linux device names.  It is usually sufficient to create a file "
10883 "containing:"
10884 msgstr ""
10885
10886 # type: verbatim
10887 #. type: verbatim
10888 #: ../src/guestfs-actions.pod:2257 ../fish/guestfish-actions.pod:1520
10889 #, no-wrap
10890 msgid ""
10891 " (hd0) /dev/vda\n"
10892 "\n"
10893 msgstr ""
10894
10895 # type: textblock
10896 #. type: textblock
10897 #: ../src/guestfs-actions.pod:2259 ../fish/guestfish-actions.pod:1522
10898 msgid "replacing C</dev/vda> with the name of the installation device."
10899 msgstr ""
10900
10901 # type: textblock
10902 #. type: textblock
10903 #: ../src/guestfs-actions.pod:2263
10904 msgid "(Added in 1.0.17)"
10905 msgstr ""
10906
10907 # type: =head2
10908 #. type: =head2
10909 #: ../src/guestfs-actions.pod:2265
10910 msgid "guestfs_head"
10911 msgstr ""
10912
10913 # type: verbatim
10914 #. type: verbatim
10915 #: ../src/guestfs-actions.pod:2267
10916 #, no-wrap
10917 msgid ""
10918 " char **\n"
10919 " guestfs_head (guestfs_h *g,\n"
10920 "               const char *path);\n"
10921 "\n"
10922 msgstr ""
10923
10924 # type: textblock
10925 #. type: textblock
10926 #: ../src/guestfs-actions.pod:2271 ../fish/guestfish-actions.pod:1528
10927 msgid ""
10928 "This command returns up to the first 10 lines of a file as a list of strings."
10929 msgstr ""
10930
10931 # type: =head2
10932 #. type: =head2
10933 #: ../src/guestfs-actions.pod:2283
10934 msgid "guestfs_head_n"
10935 msgstr ""
10936
10937 # type: verbatim
10938 #. type: verbatim
10939 #: ../src/guestfs-actions.pod:2285
10940 #, no-wrap
10941 msgid ""
10942 " char **\n"
10943 " guestfs_head_n (guestfs_h *g,\n"
10944 "                 int nrlines,\n"
10945 "                 const char *path);\n"
10946 "\n"
10947 msgstr ""
10948
10949 # type: textblock
10950 #. type: textblock
10951 #: ../src/guestfs-actions.pod:2290 ../fish/guestfish-actions.pod:1538
10952 msgid ""
10953 "If the parameter C<nrlines> is a positive number, this returns the first "
10954 "C<nrlines> lines of the file C<path>."
10955 msgstr ""
10956
10957 # type: textblock
10958 #. type: textblock
10959 #: ../src/guestfs-actions.pod:2293 ../fish/guestfish-actions.pod:1541
10960 msgid ""
10961 "If the parameter C<nrlines> is a negative number, this returns lines from "
10962 "the file C<path>, excluding the last C<nrlines> lines."
10963 msgstr ""
10964
10965 # type: textblock
10966 #. type: textblock
10967 #: ../src/guestfs-actions.pod:2296 ../src/guestfs-actions.pod:6485
10968 #: ../fish/guestfish-actions.pod:1544 ../fish/guestfish-actions.pod:4364
10969 msgid "If the parameter C<nrlines> is zero, this returns an empty list."
10970 msgstr ""
10971
10972 # type: =head2
10973 #. type: =head2
10974 #: ../src/guestfs-actions.pod:2307
10975 msgid "guestfs_hexdump"
10976 msgstr ""
10977
10978 # type: verbatim
10979 #. type: verbatim
10980 #: ../src/guestfs-actions.pod:2309
10981 #, no-wrap
10982 msgid ""
10983 " char *\n"
10984 " guestfs_hexdump (guestfs_h *g,\n"
10985 "                  const char *path);\n"
10986 "\n"
10987 msgstr ""
10988
10989 # type: textblock
10990 #. type: textblock
10991 #: ../src/guestfs-actions.pod:2313 ../fish/guestfish-actions.pod:1553
10992 msgid ""
10993 "This runs C<hexdump -C> on the given C<path>.  The result is the human-"
10994 "readable, canonical hex dump of the file."
10995 msgstr ""
10996
10997 # type: textblock
10998 #. type: textblock
10999 #: ../src/guestfs-actions.pod:2322 ../src/guestfs-actions.pod:6269
11000 #: ../src/guestfs-actions.pod:6324
11001 msgid "(Added in 1.0.22)"
11002 msgstr ""
11003
11004 # type: =head2
11005 #. type: =head2
11006 #: ../src/guestfs-actions.pod:2324
11007 msgid "guestfs_initrd_cat"
11008 msgstr ""
11009
11010 # type: verbatim
11011 #. type: verbatim
11012 #: ../src/guestfs-actions.pod:2326
11013 #, no-wrap
11014 msgid ""
11015 " char *\n"
11016 " guestfs_initrd_cat (guestfs_h *g,\n"
11017 "                     const char *initrdpath,\n"
11018 "                     const char *filename,\n"
11019 "                     size_t *size_r);\n"
11020 "\n"
11021 msgstr ""
11022
11023 # type: textblock
11024 #. type: textblock
11025 #: ../src/guestfs-actions.pod:2332 ../fish/guestfish-actions.pod:1563
11026 msgid ""
11027 "This command unpacks the file C<filename> from the initrd file called "
11028 "C<initrdpath>.  The filename must be given I<without> the initial C</> "
11029 "character."
11030 msgstr ""
11031
11032 # type: textblock
11033 #. type: textblock
11034 #: ../src/guestfs-actions.pod:2336 ../fish/guestfish-actions.pod:1567
11035 msgid ""
11036 "For example, in guestfish you could use the following command to examine the "
11037 "boot script (usually called C</init>)  contained in a Linux initrd or "
11038 "initramfs image:"
11039 msgstr ""
11040
11041 # type: verbatim
11042 #. type: verbatim
11043 #: ../src/guestfs-actions.pod:2340 ../fish/guestfish-actions.pod:1571
11044 #, no-wrap
11045 msgid ""
11046 " initrd-cat /boot/initrd-<version>.img init\n"
11047 "\n"
11048 msgstr ""
11049
11050 # type: textblock
11051 #. type: textblock
11052 #: ../src/guestfs-actions.pod:2342
11053 msgid "See also C<guestfs_initrd_list>."
11054 msgstr ""
11055
11056 # type: =head2
11057 #. type: =head2
11058 #: ../src/guestfs-actions.pod:2353
11059 msgid "guestfs_initrd_list"
11060 msgstr ""
11061
11062 # type: verbatim
11063 #. type: verbatim
11064 #: ../src/guestfs-actions.pod:2355
11065 #, no-wrap
11066 msgid ""
11067 " char **\n"
11068 " guestfs_initrd_list (guestfs_h *g,\n"
11069 "                      const char *path);\n"
11070 "\n"
11071 msgstr ""
11072
11073 # type: textblock
11074 #. type: textblock
11075 #: ../src/guestfs-actions.pod:2359 ../fish/guestfish-actions.pod:1582
11076 msgid "This command lists out files contained in an initrd."
11077 msgstr ""
11078
11079 # type: textblock
11080 #. type: textblock
11081 #: ../src/guestfs-actions.pod:2361 ../fish/guestfish-actions.pod:1584
11082 msgid ""
11083 "The files are listed without any initial C</> character.  The files are "
11084 "listed in the order they appear (not necessarily alphabetical).  Directory "
11085 "names are listed as separate items."
11086 msgstr ""
11087
11088 # type: textblock
11089 #. type: textblock
11090 #: ../src/guestfs-actions.pod:2365 ../fish/guestfish-actions.pod:1588
11091 msgid ""
11092 "Old Linux kernels (2.4 and earlier) used a compressed ext2 filesystem as "
11093 "initrd.  We I<only> support the newer initramfs format (compressed cpio "
11094 "files)."
11095 msgstr ""
11096
11097 # type: =head2
11098 #. type: =head2
11099 #: ../src/guestfs-actions.pod:2375
11100 msgid "guestfs_inotify_add_watch"
11101 msgstr ""
11102
11103 # type: verbatim
11104 #. type: verbatim
11105 #: ../src/guestfs-actions.pod:2377
11106 #, no-wrap
11107 msgid ""
11108 " int64_t\n"
11109 " guestfs_inotify_add_watch (guestfs_h *g,\n"
11110 "                            const char *path,\n"
11111 "                            int mask);\n"
11112 "\n"
11113 msgstr ""
11114
11115 # type: textblock
11116 #. type: textblock
11117 #: ../src/guestfs-actions.pod:2382 ../fish/guestfish-actions.pod:1596
11118 msgid "Watch C<path> for the events listed in C<mask>."
11119 msgstr ""
11120
11121 # type: textblock
11122 #. type: textblock
11123 #: ../src/guestfs-actions.pod:2384 ../fish/guestfish-actions.pod:1598
11124 msgid ""
11125 "Note that if C<path> is a directory then events within that directory are "
11126 "watched, but this does I<not> happen recursively (in subdirectories)."
11127 msgstr ""
11128
11129 # type: textblock
11130 #. type: textblock
11131 #: ../src/guestfs-actions.pod:2388 ../fish/guestfish-actions.pod:1602
11132 msgid ""
11133 "Note for non-C or non-Linux callers: the inotify events are defined by the "
11134 "Linux kernel ABI and are listed in C</usr/include/sys/inotify.h>."
11135 msgstr ""
11136
11137 # type: =head2
11138 #. type: =head2
11139 #: ../src/guestfs-actions.pod:2396
11140 msgid "guestfs_inotify_close"
11141 msgstr ""
11142
11143 # type: verbatim
11144 #. type: verbatim
11145 #: ../src/guestfs-actions.pod:2398
11146 #, no-wrap
11147 msgid ""
11148 " int\n"
11149 " guestfs_inotify_close (guestfs_h *g);\n"
11150 "\n"
11151 msgstr ""
11152
11153 # type: textblock
11154 #. type: textblock
11155 #: ../src/guestfs-actions.pod:2401 ../fish/guestfish-actions.pod:1610
11156 msgid ""
11157 "This closes the inotify handle which was previously opened by inotify_init.  "
11158 "It removes all watches, throws away any pending events, and deallocates all "
11159 "resources."
11160 msgstr ""
11161
11162 # type: =head2
11163 #. type: =head2
11164 #: ../src/guestfs-actions.pod:2409
11165 msgid "guestfs_inotify_files"
11166 msgstr ""
11167
11168 # type: verbatim
11169 #. type: verbatim
11170 #: ../src/guestfs-actions.pod:2411
11171 #, no-wrap
11172 msgid ""
11173 " char **\n"
11174 " guestfs_inotify_files (guestfs_h *g);\n"
11175 "\n"
11176 msgstr ""
11177
11178 # type: textblock
11179 #. type: textblock
11180 #: ../src/guestfs-actions.pod:2414
11181 msgid ""
11182 "This function is a helpful wrapper around C<guestfs_inotify_read> which just "
11183 "returns a list of pathnames of objects that were touched.  The returned "
11184 "pathnames are sorted and deduplicated."
11185 msgstr ""
11186
11187 # type: =head2
11188 #. type: =head2
11189 #: ../src/guestfs-actions.pod:2424
11190 msgid "guestfs_inotify_init"
11191 msgstr ""
11192
11193 # type: verbatim
11194 #. type: verbatim
11195 #: ../src/guestfs-actions.pod:2426
11196 #, no-wrap
11197 msgid ""
11198 " int\n"
11199 " guestfs_inotify_init (guestfs_h *g,\n"
11200 "                       int maxevents);\n"
11201 "\n"
11202 msgstr ""
11203
11204 # type: textblock
11205 #. type: textblock
11206 #: ../src/guestfs-actions.pod:2430 ../fish/guestfish-actions.pod:1626
11207 msgid ""
11208 "This command creates a new inotify handle.  The inotify subsystem can be "
11209 "used to notify events which happen to objects in the guest filesystem."
11210 msgstr ""
11211
11212 # type: textblock
11213 #. type: textblock
11214 #: ../src/guestfs-actions.pod:2434
11215 msgid ""
11216 "C<maxevents> is the maximum number of events which will be queued up between "
11217 "calls to C<guestfs_inotify_read> or C<guestfs_inotify_files>.  If this is "
11218 "passed as C<0>, then the kernel (or previously set)  default is used.  For "
11219 "Linux 2.6.29 the default was 16384 events.  Beyond this limit, the kernel "
11220 "throws away events, but records the fact that it threw them away by setting "
11221 "a flag C<IN_Q_OVERFLOW> in the returned structure list (see "
11222 "C<guestfs_inotify_read>)."
11223 msgstr ""
11224
11225 # type: textblock
11226 #. type: textblock
11227 #: ../src/guestfs-actions.pod:2444
11228 msgid ""
11229 "Before any events are generated, you have to add some watches to the "
11230 "internal watch list.  See: C<guestfs_inotify_add_watch>, "
11231 "C<guestfs_inotify_rm_watch> and C<guestfs_inotify_watch_all>."
11232 msgstr ""
11233
11234 # type: textblock
11235 #. type: textblock
11236 #: ../src/guestfs-actions.pod:2450
11237 msgid ""
11238 "Queued up events should be read periodically by calling "
11239 "C<guestfs_inotify_read> (or C<guestfs_inotify_files> which is just a helpful "
11240 "wrapper around C<guestfs_inotify_read>).  If you don't read the events out "
11241 "often enough then you risk the internal queue overflowing."
11242 msgstr ""
11243
11244 # type: textblock
11245 #. type: textblock
11246 #: ../src/guestfs-actions.pod:2457
11247 msgid ""
11248 "The handle should be closed after use by calling C<guestfs_inotify_close>.  "
11249 "This also removes any watches automatically."
11250 msgstr ""
11251
11252 # type: textblock
11253 #. type: textblock
11254 #: ../src/guestfs-actions.pod:2461 ../fish/guestfish-actions.pod:1657
11255 msgid ""
11256 "See also L<inotify(7)> for an overview of the inotify interface as exposed "
11257 "by the Linux kernel, which is roughly what we expose via libguestfs.  Note "
11258 "that there is one global inotify handle per libguestfs instance."
11259 msgstr ""
11260
11261 # type: =head2
11262 #. type: =head2
11263 #: ../src/guestfs-actions.pod:2470
11264 msgid "guestfs_inotify_read"
11265 msgstr ""
11266
11267 # type: verbatim
11268 #. type: verbatim
11269 #: ../src/guestfs-actions.pod:2472
11270 #, no-wrap
11271 msgid ""
11272 " struct guestfs_inotify_event_list *\n"
11273 " guestfs_inotify_read (guestfs_h *g);\n"
11274 "\n"
11275 msgstr ""
11276
11277 # type: textblock
11278 #. type: textblock
11279 #: ../src/guestfs-actions.pod:2475 ../fish/guestfish-actions.pod:1666
11280 msgid ""
11281 "Return the complete queue of events that have happened since the previous "
11282 "read call."
11283 msgstr ""
11284
11285 # type: textblock
11286 #. type: textblock
11287 #: ../src/guestfs-actions.pod:2478 ../fish/guestfish-actions.pod:1669
11288 msgid "If no events have happened, this returns an empty list."
11289 msgstr ""
11290
11291 # type: textblock
11292 #. type: textblock
11293 #: ../src/guestfs-actions.pod:2480 ../fish/guestfish-actions.pod:1671
11294 msgid ""
11295 "I<Note>: In order to make sure that all events have been read, you must call "
11296 "this function repeatedly until it returns an empty list.  The reason is that "
11297 "the call will read events up to the maximum appliance-to-host message size "
11298 "and leave remaining events in the queue."
11299 msgstr ""
11300
11301 # type: textblock
11302 #. type: textblock
11303 #: ../src/guestfs-actions.pod:2486
11304 msgid ""
11305 "This function returns a C<struct guestfs_inotify_event_list *>, or NULL if "
11306 "there was an error.  I<The caller must call "
11307 "C<guestfs_free_inotify_event_list> after use>."
11308 msgstr ""
11309
11310 # type: =head2
11311 #. type: =head2
11312 #: ../src/guestfs-actions.pod:2492
11313 msgid "guestfs_inotify_rm_watch"
11314 msgstr ""
11315
11316 # type: verbatim
11317 #. type: verbatim
11318 #: ../src/guestfs-actions.pod:2494
11319 #, no-wrap
11320 msgid ""
11321 " int\n"
11322 " guestfs_inotify_rm_watch (guestfs_h *g,\n"
11323 "                           int wd);\n"
11324 "\n"
11325 msgstr ""
11326
11327 # type: textblock
11328 #. type: textblock
11329 #: ../src/guestfs-actions.pod:2498
11330 msgid ""
11331 "Remove a previously defined inotify watch.  See C<guestfs_inotify_add_watch>."
11332 msgstr ""
11333
11334 # type: =head2
11335 #. type: =head2
11336 #: ../src/guestfs-actions.pod:2505
11337 msgid "guestfs_inspect_get_arch"
11338 msgstr ""
11339
11340 # type: verbatim
11341 #. type: verbatim
11342 #: ../src/guestfs-actions.pod:2507
11343 #, no-wrap
11344 msgid ""
11345 " char *\n"
11346 " guestfs_inspect_get_arch (guestfs_h *g,\n"
11347 "                           const char *root);\n"
11348 "\n"
11349 msgstr ""
11350
11351 # type: textblock
11352 #. type: textblock
11353 #: ../src/guestfs-actions.pod:2511 ../src/guestfs-actions.pod:2534
11354 #: ../src/guestfs-actions.pod:2619 ../src/guestfs-actions.pod:2645
11355 #: ../src/guestfs-actions.pod:2684 ../src/guestfs-actions.pod:2706
11356 #: ../src/guestfs-actions.pod:2733 ../src/guestfs-actions.pod:2754
11357 #: ../src/guestfs-actions.pod:2791 ../src/guestfs-actions.pod:2820
11358 #: ../src/guestfs-actions.pod:2851 ../src/guestfs-actions.pod:2875
11359 #: ../src/guestfs-actions.pod:2930 ../src/guestfs-actions.pod:2972
11360 #: ../src/guestfs-actions.pod:2995 ../src/guestfs-actions.pod:3012
11361 #: ../src/guestfs-actions.pod:3029 ../src/guestfs-actions.pod:3048
11362 msgid ""
11363 "This function should only be called with a root device string as returned by "
11364 "C<guestfs_inspect_os>."
11365 msgstr ""
11366
11367 # type: textblock
11368 #. type: textblock
11369 #: ../src/guestfs-actions.pod:2514
11370 msgid ""
11371 "This returns the architecture of the inspected operating system.  The "
11372 "possible return values are listed under C<guestfs_file_architecture>."
11373 msgstr ""
11374
11375 # type: textblock
11376 #. type: textblock
11377 #: ../src/guestfs-actions.pod:2518 ../fish/guestfish-actions.pod:1695
11378 msgid ""
11379 "If the architecture could not be determined, then the string C<unknown> is "
11380 "returned."
11381 msgstr ""
11382
11383 # type: textblock
11384 #. type: textblock
11385 #: ../src/guestfs-actions.pod:2521 ../src/guestfs-actions.pod:2606
11386 #: ../src/guestfs-actions.pod:2673 ../src/guestfs-actions.pod:2693
11387 #: ../src/guestfs-actions.pod:2721 ../src/guestfs-actions.pod:2807
11388 #: ../src/guestfs-actions.pod:2838 ../src/guestfs-actions.pod:2862
11389 #: ../src/guestfs-actions.pod:2916 ../src/guestfs-actions.pod:2959
11390 #: ../src/guestfs-actions.pod:2982 ../src/guestfs-actions.pod:3002
11391 #: ../src/guestfs-actions.pod:3019 ../src/guestfs-actions.pod:3038
11392 #: ../src/guestfs-actions.pod:3141 ../src/guestfs-actions.pod:3182
11393 #: ../fish/guestfish-actions.pod:1698 ../fish/guestfish-actions.pod:1776
11394 #: ../fish/guestfish-actions.pod:1828 ../fish/guestfish-actions.pod:1843
11395 #: ../fish/guestfish-actions.pod:1864 ../fish/guestfish-actions.pod:1928
11396 #: ../fish/guestfish-actions.pod:1952 ../fish/guestfish-actions.pod:1969
11397 #: ../fish/guestfish-actions.pod:2012 ../fish/guestfish-actions.pod:2047
11398 #: ../fish/guestfish-actions.pod:2063 ../fish/guestfish-actions.pod:2076
11399 #: ../fish/guestfish-actions.pod:2089 ../fish/guestfish-actions.pod:2104
11400 #: ../fish/guestfish-actions.pod:2203 ../fish/guestfish-actions.pod:2237
11401 msgid "Please read L<guestfs(3)/INSPECTION> for more details."
11402 msgstr ""
11403
11404 # type: =head2
11405 #. type: =head2
11406 #: ../src/guestfs-actions.pod:2528
11407 msgid "guestfs_inspect_get_distro"
11408 msgstr ""
11409
11410 # type: verbatim
11411 #. type: verbatim
11412 #: ../src/guestfs-actions.pod:2530
11413 #, no-wrap
11414 msgid ""
11415 " char *\n"
11416 " guestfs_inspect_get_distro (guestfs_h *g,\n"
11417 "                             const char *root);\n"
11418 "\n"
11419 msgstr ""
11420
11421 # type: textblock
11422 #. type: textblock
11423 #: ../src/guestfs-actions.pod:2537 ../fish/guestfish-actions.pod:1707
11424 msgid ""
11425 "This returns the distro (distribution) of the inspected operating system."
11426 msgstr ""
11427
11428 # type: textblock
11429 #. type: textblock
11430 #: ../src/guestfs-actions.pod:2540 ../fish/guestfish-actions.pod:1710
11431 msgid "Currently defined distros are:"
11432 msgstr ""
11433
11434 # type: =item
11435 #. type: =item
11436 #: ../src/guestfs-actions.pod:2544 ../fish/guestfish-actions.pod:1714
11437 msgid "\"archlinux\""
11438 msgstr ""
11439
11440 # type: textblock
11441 #. type: textblock
11442 #: ../src/guestfs-actions.pod:2546 ../fish/guestfish-actions.pod:1716
11443 msgid "Arch Linux."
11444 msgstr ""
11445
11446 # type: =item
11447 #. type: =item
11448 #: ../src/guestfs-actions.pod:2548 ../fish/guestfish-actions.pod:1718
11449 msgid "\"debian\""
11450 msgstr ""
11451
11452 # type: textblock
11453 #. type: textblock
11454 #: ../src/guestfs-actions.pod:2550 ../fish/guestfish-actions.pod:1720
11455 msgid "Debian."
11456 msgstr ""
11457
11458 # type: =item
11459 #. type: =item
11460 #: ../src/guestfs-actions.pod:2552 ../fish/guestfish-actions.pod:1722
11461 msgid "\"fedora\""
11462 msgstr ""
11463
11464 # type: textblock
11465 #. type: textblock
11466 #: ../src/guestfs-actions.pod:2554 ../fish/guestfish-actions.pod:1724
11467 msgid "Fedora."
11468 msgstr ""
11469
11470 # type: =item
11471 #. type: =item
11472 #: ../src/guestfs-actions.pod:2556 ../fish/guestfish-actions.pod:1726
11473 msgid "\"gentoo\""
11474 msgstr ""
11475
11476 # type: textblock
11477 #. type: textblock
11478 #: ../src/guestfs-actions.pod:2558 ../fish/guestfish-actions.pod:1728
11479 msgid "Gentoo."
11480 msgstr ""
11481
11482 # type: =item
11483 #. type: =item
11484 #: ../src/guestfs-actions.pod:2560 ../fish/guestfish-actions.pod:1730
11485 msgid "\"linuxmint\""
11486 msgstr ""
11487
11488 # type: textblock
11489 #. type: textblock
11490 #: ../src/guestfs-actions.pod:2562 ../fish/guestfish-actions.pod:1732
11491 msgid "Linux Mint."
11492 msgstr ""
11493
11494 # type: =item
11495 #. type: =item
11496 #: ../src/guestfs-actions.pod:2564 ../fish/guestfish-actions.pod:1734
11497 msgid "\"mandriva\""
11498 msgstr ""
11499
11500 # type: textblock
11501 #. type: textblock
11502 #: ../src/guestfs-actions.pod:2566 ../fish/guestfish-actions.pod:1736
11503 msgid "Mandriva."
11504 msgstr ""
11505
11506 # type: =item
11507 #. type: =item
11508 #: ../src/guestfs-actions.pod:2568 ../fish/guestfish-actions.pod:1738
11509 msgid "\"meego\""
11510 msgstr ""
11511
11512 # type: textblock
11513 #. type: textblock
11514 #: ../src/guestfs-actions.pod:2570 ../fish/guestfish-actions.pod:1740
11515 msgid "MeeGo."
11516 msgstr ""
11517
11518 # type: =item
11519 #. type: =item
11520 #: ../src/guestfs-actions.pod:2572 ../fish/guestfish-actions.pod:1742
11521 msgid "\"pardus\""
11522 msgstr ""
11523
11524 # type: textblock
11525 #. type: textblock
11526 #: ../src/guestfs-actions.pod:2574 ../fish/guestfish-actions.pod:1744
11527 msgid "Pardus."
11528 msgstr ""
11529
11530 # type: =item
11531 #. type: =item
11532 #: ../src/guestfs-actions.pod:2576 ../fish/guestfish-actions.pod:1746
11533 msgid "\"redhat-based\""
11534 msgstr ""
11535
11536 # type: textblock
11537 #. type: textblock
11538 #: ../src/guestfs-actions.pod:2578 ../fish/guestfish-actions.pod:1748
11539 msgid "Some Red Hat-derived distro."
11540 msgstr ""
11541
11542 # type: =item
11543 #. type: =item
11544 #: ../src/guestfs-actions.pod:2580 ../fish/guestfish-actions.pod:1750
11545 msgid "\"rhel\""
11546 msgstr ""
11547
11548 # type: textblock
11549 #. type: textblock
11550 #: ../src/guestfs-actions.pod:2582 ../fish/guestfish-actions.pod:1752
11551 msgid "Red Hat Enterprise Linux and some derivatives."
11552 msgstr ""
11553
11554 #. type: =item
11555 #: ../src/guestfs-actions.pod:2584 ../fish/guestfish-actions.pod:1754
11556 msgid "\"slackware\""
11557 msgstr ""
11558
11559 #. type: textblock
11560 #: ../src/guestfs-actions.pod:2586 ../fish/guestfish-actions.pod:1756
11561 msgid "Slackware."
11562 msgstr ""
11563
11564 # type: =item
11565 #. type: =item
11566 #: ../src/guestfs-actions.pod:2588 ../fish/guestfish-actions.pod:1758
11567 msgid "\"ubuntu\""
11568 msgstr ""
11569
11570 # type: textblock
11571 #. type: textblock
11572 #: ../src/guestfs-actions.pod:2590 ../fish/guestfish-actions.pod:1760
11573 msgid "Ubuntu."
11574 msgstr ""
11575
11576 # type: =item
11577 #. type: =item
11578 #: ../src/guestfs-actions.pod:2592 ../src/guestfs-actions.pod:2664
11579 #: ../src/guestfs-actions.pod:2950 ../fish/guestfish-actions.pod:1762
11580 #: ../fish/guestfish-actions.pod:1819 ../fish/guestfish-actions.pod:2038
11581 msgid "\"unknown\""
11582 msgstr ""
11583
11584 # type: textblock
11585 #. type: textblock
11586 #: ../src/guestfs-actions.pod:2594 ../fish/guestfish-actions.pod:1764
11587 msgid "The distro could not be determined."
11588 msgstr ""
11589
11590 # type: =item
11591 #. type: =item
11592 #: ../src/guestfs-actions.pod:2596 ../src/guestfs-actions.pod:2942
11593 #: ../fish/guestfish-actions.pod:1766 ../fish/guestfish-actions.pod:2030
11594 msgid "\"windows\""
11595 msgstr ""
11596
11597 # type: textblock
11598 #. type: textblock
11599 #: ../src/guestfs-actions.pod:2598 ../fish/guestfish-actions.pod:1768
11600 msgid ""
11601 "Windows does not have distributions.  This string is returned if the OS type "
11602 "is Windows."
11603 msgstr ""
11604
11605 # type: textblock
11606 #. type: textblock
11607 #: ../src/guestfs-actions.pod:2603 ../src/guestfs-actions.pod:2670
11608 #: ../src/guestfs-actions.pod:2956 ../fish/guestfish-actions.pod:1773
11609 #: ../fish/guestfish-actions.pod:1825 ../fish/guestfish-actions.pod:2044
11610 msgid ""
11611 "Future versions of libguestfs may return other strings here.  The caller "
11612 "should be prepared to handle any string."
11613 msgstr ""
11614
11615 # type: =head2
11616 #. type: =head2
11617 #: ../src/guestfs-actions.pod:2613
11618 msgid "guestfs_inspect_get_filesystems"
11619 msgstr ""
11620
11621 # type: verbatim
11622 #. type: verbatim
11623 #: ../src/guestfs-actions.pod:2615
11624 #, no-wrap
11625 msgid ""
11626 " char **\n"
11627 " guestfs_inspect_get_filesystems (guestfs_h *g,\n"
11628 "                                  const char *root);\n"
11629 "\n"
11630 msgstr ""
11631
11632 # type: textblock
11633 #. type: textblock
11634 #: ../src/guestfs-actions.pod:2622 ../fish/guestfish-actions.pod:1785
11635 msgid ""
11636 "This returns a list of all the filesystems that we think are associated with "
11637 "this operating system.  This includes the root filesystem, other ordinary "
11638 "filesystems, and non-mounted devices like swap partitions."
11639 msgstr ""
11640
11641 # type: textblock
11642 #. type: textblock
11643 #: ../src/guestfs-actions.pod:2627 ../fish/guestfish-actions.pod:1790
11644 msgid ""
11645 "In the case of a multi-boot virtual machine, it is possible for a filesystem "
11646 "to be shared between operating systems."
11647 msgstr ""
11648
11649 # type: textblock
11650 #. type: textblock
11651 #: ../src/guestfs-actions.pod:2630
11652 msgid ""
11653 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
11654 "C<guestfs_inspect_get_mountpoints>."
11655 msgstr ""
11656
11657 #. type: =head2
11658 #: ../src/guestfs-actions.pod:2639
11659 msgid "guestfs_inspect_get_format"
11660 msgstr ""
11661
11662 #. type: verbatim
11663 #: ../src/guestfs-actions.pod:2641
11664 #, no-wrap
11665 msgid ""
11666 " char *\n"
11667 " guestfs_inspect_get_format (guestfs_h *g,\n"
11668 "                             const char *root);\n"
11669 "\n"
11670 msgstr ""
11671
11672 #. type: textblock
11673 #: ../src/guestfs-actions.pod:2648 ../fish/guestfish-actions.pod:1803
11674 msgid ""
11675 "This returns the format of the inspected operating system.  You can use it "
11676 "to detect install images, live CDs and similar."
11677 msgstr ""
11678
11679 #. type: textblock
11680 #: ../src/guestfs-actions.pod:2651 ../fish/guestfish-actions.pod:1806
11681 msgid "Currently defined formats are:"
11682 msgstr ""
11683
11684 #. type: =item
11685 #: ../src/guestfs-actions.pod:2655 ../fish/guestfish-actions.pod:1810
11686 msgid "\"installed\""
11687 msgstr ""
11688
11689 #. type: textblock
11690 #: ../src/guestfs-actions.pod:2657 ../fish/guestfish-actions.pod:1812
11691 msgid "This is an installed operating system."
11692 msgstr ""
11693
11694 #. type: =item
11695 #: ../src/guestfs-actions.pod:2659 ../fish/guestfish-actions.pod:1814
11696 msgid "\"installer\""
11697 msgstr ""
11698
11699 #. type: textblock
11700 #: ../src/guestfs-actions.pod:2661 ../fish/guestfish-actions.pod:1816
11701 msgid ""
11702 "The disk image being inspected is not an installed operating system, but a "
11703 "I<bootable> install disk, live CD, or similar."
11704 msgstr ""
11705
11706 #. type: textblock
11707 #: ../src/guestfs-actions.pod:2666 ../fish/guestfish-actions.pod:1821
11708 msgid "The format of this disk image is not known."
11709 msgstr ""
11710
11711 # type: =head2
11712 #. type: =head2
11713 #: ../src/guestfs-actions.pod:2678
11714 msgid "guestfs_inspect_get_hostname"
11715 msgstr ""
11716
11717 # type: verbatim
11718 #. type: verbatim
11719 #: ../src/guestfs-actions.pod:2680
11720 #, no-wrap
11721 msgid ""
11722 " char *\n"
11723 " guestfs_inspect_get_hostname (guestfs_h *g,\n"
11724 "                               const char *root);\n"
11725 "\n"
11726 msgstr ""
11727
11728 # type: textblock
11729 #. type: textblock
11730 #: ../src/guestfs-actions.pod:2687 ../fish/guestfish-actions.pod:1837
11731 msgid ""
11732 "This function returns the hostname of the operating system as found by "
11733 "inspection of the guest's configuration files."
11734 msgstr ""
11735
11736 # type: textblock
11737 #. type: textblock
11738 #: ../src/guestfs-actions.pod:2690 ../fish/guestfish-actions.pod:1840
11739 msgid ""
11740 "If the hostname could not be determined, then the string C<unknown> is "
11741 "returned."
11742 msgstr ""
11743
11744 # type: textblock
11745 #. type: textblock
11746 #: ../src/guestfs-actions.pod:2698
11747 msgid "(Added in 1.7.9)"
11748 msgstr ""
11749
11750 # type: =head2
11751 #. type: =head2
11752 #: ../src/guestfs-actions.pod:2700
11753 msgid "guestfs_inspect_get_major_version"
11754 msgstr ""
11755
11756 # type: verbatim
11757 #. type: verbatim
11758 #: ../src/guestfs-actions.pod:2702
11759 #, no-wrap
11760 msgid ""
11761 " int\n"
11762 " guestfs_inspect_get_major_version (guestfs_h *g,\n"
11763 "                                    const char *root);\n"
11764 "\n"
11765 msgstr ""
11766
11767 # type: textblock
11768 #. type: textblock
11769 #: ../src/guestfs-actions.pod:2709 ../fish/guestfish-actions.pod:1852
11770 msgid ""
11771 "This returns the major version number of the inspected operating system."
11772 msgstr ""
11773
11774 # type: textblock
11775 #. type: textblock
11776 #: ../src/guestfs-actions.pod:2712 ../fish/guestfish-actions.pod:1855
11777 msgid ""
11778 "Windows uses a consistent versioning scheme which is I<not> reflected in the "
11779 "popular public names used by the operating system.  Notably the operating "
11780 "system known as \"Windows 7\" is really version 6.1 (ie. major = 6, minor = "
11781 "1).  You can find out the real versions corresponding to releases of Windows "
11782 "by consulting Wikipedia or MSDN."
11783 msgstr ""
11784
11785 # type: textblock
11786 #. type: textblock
11787 #: ../src/guestfs-actions.pod:2719 ../src/guestfs-actions.pod:2739
11788 #: ../fish/guestfish-actions.pod:1862 ../fish/guestfish-actions.pod:1876
11789 msgid "If the version could not be determined, then C<0> is returned."
11790 msgstr ""
11791
11792 # type: =head2
11793 #. type: =head2
11794 #: ../src/guestfs-actions.pod:2727
11795 msgid "guestfs_inspect_get_minor_version"
11796 msgstr ""
11797
11798 # type: verbatim
11799 #. type: verbatim
11800 #: ../src/guestfs-actions.pod:2729
11801 #, no-wrap
11802 msgid ""
11803 " int\n"
11804 " guestfs_inspect_get_minor_version (guestfs_h *g,\n"
11805 "                                    const char *root);\n"
11806 "\n"
11807 msgstr ""
11808
11809 # type: textblock
11810 #. type: textblock
11811 #: ../src/guestfs-actions.pod:2736 ../fish/guestfish-actions.pod:1873
11812 msgid ""
11813 "This returns the minor version number of the inspected operating system."
11814 msgstr ""
11815
11816 # type: textblock
11817 #. type: textblock
11818 #: ../src/guestfs-actions.pod:2741
11819 msgid ""
11820 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
11821 "C<guestfs_inspect_get_major_version>."
11822 msgstr ""
11823
11824 # type: =head2
11825 #. type: =head2
11826 #: ../src/guestfs-actions.pod:2748
11827 msgid "guestfs_inspect_get_mountpoints"
11828 msgstr ""
11829
11830 # type: verbatim
11831 #. type: verbatim
11832 #: ../src/guestfs-actions.pod:2750
11833 #, no-wrap
11834 msgid ""
11835 " char **\n"
11836 " guestfs_inspect_get_mountpoints (guestfs_h *g,\n"
11837 "                                  const char *root);\n"
11838 "\n"
11839 msgstr ""
11840
11841 #. type: textblock
11842 #: ../src/guestfs-actions.pod:2757 ../fish/guestfish-actions.pod:1888
11843 msgid ""
11844 "This returns a hash of where we think the filesystems associated with this "
11845 "operating system should be mounted.  Callers should note that this is at "
11846 "best an educated guess made by reading configuration files such as C</etc/"
11847 "fstab>.  I<In particular note> that this may return filesystems which are "
11848 "non-existent or not mountable and callers should be prepared to handle or "
11849 "ignore failures if they try to mount them."
11850 msgstr ""
11851
11852 # type: textblock
11853 #. type: textblock
11854 #: ../src/guestfs-actions.pod:2766 ../fish/guestfish-actions.pod:1897
11855 msgid ""
11856 "Each element in the returned hashtable has a key which is the path of the "
11857 "mountpoint (eg. C</boot>) and a value which is the filesystem that would be "
11858 "mounted there (eg. C</dev/sda1>)."
11859 msgstr ""
11860
11861 # type: textblock
11862 #. type: textblock
11863 #: ../src/guestfs-actions.pod:2771 ../fish/guestfish-actions.pod:1902
11864 msgid ""
11865 "Non-mounted devices such as swap devices are I<not> returned in this list."
11866 msgstr ""
11867
11868 # type: textblock
11869 #. type: textblock
11870 #: ../src/guestfs-actions.pod:2774
11871 msgid ""
11872 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
11873 "C<guestfs_inspect_get_filesystems>."
11874 msgstr ""
11875
11876 # type: textblock
11877 #. type: textblock
11878 #: ../src/guestfs-actions.pod:2777 ../src/guestfs-actions.pod:3511
11879 #: ../src/guestfs-actions.pod:4721 ../src/guestfs-actions.pod:6626
11880 msgid ""
11881 "This function returns a NULL-terminated array of strings, or NULL if there "
11882 "was an error.  The array of strings will always have length C<2n+1>, where "
11883 "C<n> keys and values alternate, followed by the trailing NULL entry.  I<The "
11884 "caller must free the strings and the array after use>."
11885 msgstr ""
11886
11887 # type: =head2
11888 #. type: =head2
11889 #: ../src/guestfs-actions.pod:2785
11890 msgid "guestfs_inspect_get_package_format"
11891 msgstr ""
11892
11893 # type: verbatim
11894 #. type: verbatim
11895 #: ../src/guestfs-actions.pod:2787
11896 #, no-wrap
11897 msgid ""
11898 " char *\n"
11899 " guestfs_inspect_get_package_format (guestfs_h *g,\n"
11900 "                                     const char *root);\n"
11901 "\n"
11902 msgstr ""
11903
11904 # type: textblock
11905 #. type: textblock
11906 #: ../src/guestfs-actions.pod:2794
11907 msgid ""
11908 "This function and C<guestfs_inspect_get_package_management> return the "
11909 "package format and package management tool used by the inspected operating "
11910 "system.  For example for Fedora these functions would return C<rpm> (package "
11911 "format) and C<yum> (package management)."
11912 msgstr ""
11913
11914 # type: textblock
11915 #. type: textblock
11916 #: ../src/guestfs-actions.pod:2800 ../fish/guestfish-actions.pod:1921
11917 msgid ""
11918 "This returns the string C<unknown> if we could not determine the package "
11919 "format I<or> if the operating system does not have a real packaging system "
11920 "(eg. Windows)."
11921 msgstr ""
11922
11923 # type: textblock
11924 #. type: textblock
11925 #: ../src/guestfs-actions.pod:2804 ../fish/guestfish-actions.pod:1925
11926 msgid ""
11927 "Possible strings include: C<rpm>, C<deb>, C<ebuild>, C<pisi>, C<pacman>.  "
11928 "Future versions of libguestfs may return other strings."
11929 msgstr ""
11930
11931 # type: textblock
11932 #. type: textblock
11933 #: ../src/guestfs-actions.pod:2812 ../src/guestfs-actions.pod:2843
11934 msgid "(Added in 1.7.5)"
11935 msgstr ""
11936
11937 # type: =head2
11938 #. type: =head2
11939 #: ../src/guestfs-actions.pod:2814
11940 msgid "guestfs_inspect_get_package_management"
11941 msgstr ""
11942
11943 # type: verbatim
11944 #. type: verbatim
11945 #: ../src/guestfs-actions.pod:2816
11946 #, no-wrap
11947 msgid ""
11948 " char *\n"
11949 " guestfs_inspect_get_package_management (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:2823
11957 msgid ""
11958 "C<guestfs_inspect_get_package_format> and this function return the package "
11959 "format and package management tool used by the inspected operating system.  "
11960 "For example for Fedora these functions would return C<rpm> (package format) "
11961 "and C<yum> (package management)."
11962 msgstr ""
11963
11964 # type: textblock
11965 #. type: textblock
11966 #: ../src/guestfs-actions.pod:2829 ../fish/guestfish-actions.pod:1943
11967 msgid ""
11968 "This returns the string C<unknown> if we could not determine the package "
11969 "management tool I<or> if the operating system does not have a real packaging "
11970 "system (eg. Windows)."
11971 msgstr ""
11972
11973 # type: textblock
11974 #. type: textblock
11975 #: ../src/guestfs-actions.pod:2833 ../fish/guestfish-actions.pod:1947
11976 msgid ""
11977 "Possible strings include: C<yum>, C<up2date>, C<apt> (for all Debian "
11978 "derivatives), C<portage>, C<pisi>, C<pacman>, C<urpmi>.  Future versions of "
11979 "libguestfs may return other strings."
11980 msgstr ""
11981
11982 # type: =head2
11983 #. type: =head2
11984 #: ../src/guestfs-actions.pod:2845
11985 msgid "guestfs_inspect_get_product_name"
11986 msgstr ""
11987
11988 # type: verbatim
11989 #. type: verbatim
11990 #: ../src/guestfs-actions.pod:2847
11991 #, no-wrap
11992 msgid ""
11993 " char *\n"
11994 " guestfs_inspect_get_product_name (guestfs_h *g,\n"
11995 "                                   const char *root);\n"
11996 "\n"
11997 msgstr ""
11998
11999 # type: textblock
12000 #. type: textblock
12001 #: ../src/guestfs-actions.pod:2854 ../fish/guestfish-actions.pod:1961
12002 msgid ""
12003 "This returns the product name of the inspected operating system.  The "
12004 "product name is generally some freeform string which can be displayed to the "
12005 "user, but should not be parsed by programs."
12006 msgstr ""
12007
12008 # type: textblock
12009 #. type: textblock
12010 #: ../src/guestfs-actions.pod:2859 ../fish/guestfish-actions.pod:1966
12011 msgid ""
12012 "If the product name could not be determined, then the string C<unknown> is "
12013 "returned."
12014 msgstr ""
12015
12016 #. type: =head2
12017 #: ../src/guestfs-actions.pod:2869
12018 msgid "guestfs_inspect_get_product_variant"
12019 msgstr ""
12020
12021 #. type: verbatim
12022 #: ../src/guestfs-actions.pod:2871
12023 #, no-wrap
12024 msgid ""
12025 " char *\n"
12026 " guestfs_inspect_get_product_variant (guestfs_h *g,\n"
12027 "                                      const char *root);\n"
12028 "\n"
12029 msgstr ""
12030
12031 #. type: textblock
12032 #: ../src/guestfs-actions.pod:2878 ../fish/guestfish-actions.pod:1978
12033 msgid "This returns the product variant of the inspected operating system."
12034 msgstr ""
12035
12036 #. type: textblock
12037 #: ../src/guestfs-actions.pod:2881 ../fish/guestfish-actions.pod:1981
12038 msgid ""
12039 "For Windows guests, this returns the contents of the Registry key C<HKLM"
12040 "\\Software\\Microsoft\\Windows NT\\CurrentVersion> C<InstallationType> which "
12041 "is usually a string such as C<Client> or C<Server> (other values are "
12042 "possible).  This can be used to distinguish consumer and enterprise versions "
12043 "of Windows that have the same version number (for example, Windows 7 and "
12044 "Windows 2008 Server are both version 6.1, but the former is C<Client> and "
12045 "the latter is C<Server>)."
12046 msgstr ""
12047
12048 #. type: textblock
12049 #: ../src/guestfs-actions.pod:2890 ../fish/guestfish-actions.pod:1990
12050 msgid ""
12051 "For enterprise Linux guests, in future we intend this to return the product "
12052 "variant such as C<Desktop>, C<Server> and so on.  But this is not "
12053 "implemented at present."
12054 msgstr ""
12055
12056 #. type: textblock
12057 #: ../src/guestfs-actions.pod:2894 ../fish/guestfish-actions.pod:1994
12058 msgid ""
12059 "If the product variant could not be determined, then the string C<unknown> "
12060 "is returned."
12061 msgstr ""
12062
12063 #. type: textblock
12064 #: ../src/guestfs-actions.pod:2897
12065 msgid ""
12066 "Please read L<guestfs(3)/INSPECTION> for more details.  See also "
12067 "C<guestfs_inspect_get_product_name>, C<guestfs_inspect_get_major_version>."
12068 msgstr ""
12069
12070 # type: =head2
12071 #. type: =head2
12072 #: ../src/guestfs-actions.pod:2904
12073 msgid "guestfs_inspect_get_roots"
12074 msgstr ""
12075
12076 # type: verbatim
12077 #. type: verbatim
12078 #: ../src/guestfs-actions.pod:2906
12079 #, no-wrap
12080 msgid ""
12081 " char **\n"
12082 " guestfs_inspect_get_roots (guestfs_h *g);\n"
12083 "\n"
12084 msgstr ""
12085
12086 # type: textblock
12087 #. type: textblock
12088 #: ../src/guestfs-actions.pod:2909
12089 msgid ""
12090 "This function is a convenient way to get the list of root devices, as "
12091 "returned from a previous call to C<guestfs_inspect_os>, but without redoing "
12092 "the whole inspection process."
12093 msgstr ""
12094
12095 # type: textblock
12096 #. type: textblock
12097 #: ../src/guestfs-actions.pod:2913
12098 msgid ""
12099 "This returns an empty list if either no root devices were found or the "
12100 "caller has not called C<guestfs_inspect_os>."
12101 msgstr ""
12102
12103 # type: textblock
12104 #. type: textblock
12105 #: ../src/guestfs-actions.pod:2922
12106 msgid "(Added in 1.7.3)"
12107 msgstr ""
12108
12109 # type: =head2
12110 #. type: =head2
12111 #: ../src/guestfs-actions.pod:2924
12112 msgid "guestfs_inspect_get_type"
12113 msgstr ""
12114
12115 # type: verbatim
12116 #. type: verbatim
12117 #: ../src/guestfs-actions.pod:2926
12118 #, no-wrap
12119 msgid ""
12120 " char *\n"
12121 " guestfs_inspect_get_type (guestfs_h *g,\n"
12122 "                           const char *root);\n"
12123 "\n"
12124 msgstr ""
12125
12126 # type: textblock
12127 #. type: textblock
12128 #: ../src/guestfs-actions.pod:2933 ../fish/guestfish-actions.pod:2021
12129 msgid ""
12130 "This returns the type of the inspected operating system.  Currently defined "
12131 "types are:"
12132 msgstr ""
12133
12134 # type: =item
12135 #. type: =item
12136 #: ../src/guestfs-actions.pod:2938 ../fish/guestfish-actions.pod:2026
12137 msgid "\"linux\""
12138 msgstr ""
12139
12140 # type: textblock
12141 #. type: textblock
12142 #: ../src/guestfs-actions.pod:2940 ../fish/guestfish-actions.pod:2028
12143 msgid "Any Linux-based operating system."
12144 msgstr ""
12145
12146 # type: textblock
12147 #. type: textblock
12148 #: ../src/guestfs-actions.pod:2944 ../fish/guestfish-actions.pod:2032
12149 msgid "Any Microsoft Windows operating system."
12150 msgstr ""
12151
12152 # type: =item
12153 #. type: =item
12154 #: ../src/guestfs-actions.pod:2946 ../fish/guestfish-actions.pod:2034
12155 msgid "\"freebsd\""
12156 msgstr ""
12157
12158 # type: textblock
12159 #. type: textblock
12160 #: ../src/guestfs-actions.pod:2948 ../fish/guestfish-actions.pod:2036
12161 msgid "FreeBSD."
12162 msgstr ""
12163
12164 # type: textblock
12165 #. type: textblock
12166 #: ../src/guestfs-actions.pod:2952 ../fish/guestfish-actions.pod:2040
12167 msgid "The operating system type could not be determined."
12168 msgstr ""
12169
12170 # type: =head2
12171 #. type: =head2
12172 #: ../src/guestfs-actions.pod:2966
12173 msgid "guestfs_inspect_get_windows_systemroot"
12174 msgstr ""
12175
12176 # type: verbatim
12177 #. type: verbatim
12178 #: ../src/guestfs-actions.pod:2968
12179 #, no-wrap
12180 msgid ""
12181 " char *\n"
12182 " guestfs_inspect_get_windows_systemroot (guestfs_h *g,\n"
12183 "                                         const char *root);\n"
12184 "\n"
12185 msgstr ""
12186
12187 # type: textblock
12188 #. type: textblock
12189 #: ../src/guestfs-actions.pod:2975 ../fish/guestfish-actions.pod:2056
12190 msgid ""
12191 "This returns the Windows systemroot of the inspected guest.  The systemroot "
12192 "is a directory path such as C</WINDOWS>."
12193 msgstr ""
12194
12195 # type: textblock
12196 #. type: textblock
12197 #: ../src/guestfs-actions.pod:2978 ../fish/guestfish-actions.pod:2059
12198 msgid ""
12199 "This call assumes that the guest is Windows and that the systemroot could be "
12200 "determined by inspection.  If this is not the case then an error is returned."
12201 msgstr ""
12202
12203 # type: textblock
12204 #. type: textblock
12205 #: ../src/guestfs-actions.pod:2987
12206 msgid "(Added in 1.5.25)"
12207 msgstr ""
12208
12209 #. type: =head2
12210 #: ../src/guestfs-actions.pod:2989
12211 msgid "guestfs_inspect_is_live"
12212 msgstr ""
12213
12214 #. type: verbatim
12215 #: ../src/guestfs-actions.pod:2991
12216 #, no-wrap
12217 msgid ""
12218 " int\n"
12219 " guestfs_inspect_is_live (guestfs_h *g,\n"
12220 "                          const char *root);\n"
12221 "\n"
12222 msgstr ""
12223
12224 #. type: textblock
12225 #: ../src/guestfs-actions.pod:2998
12226 msgid ""
12227 "If C<guestfs_inspect_get_format> returns C<installer> (this is an install "
12228 "disk), then this returns true if a live image was detected on the disk."
12229 msgstr ""
12230
12231 #. type: =head2
12232 #: ../src/guestfs-actions.pod:3006
12233 msgid "guestfs_inspect_is_multipart"
12234 msgstr ""
12235
12236 #. type: verbatim
12237 #: ../src/guestfs-actions.pod:3008
12238 #, no-wrap
12239 msgid ""
12240 " int\n"
12241 " guestfs_inspect_is_multipart (guestfs_h *g,\n"
12242 "                               const char *root);\n"
12243 "\n"
12244 msgstr ""
12245
12246 #. type: textblock
12247 #: ../src/guestfs-actions.pod:3015
12248 msgid ""
12249 "If C<guestfs_inspect_get_format> returns C<installer> (this is an install "
12250 "disk), then this returns true if the disk is part of a set."
12251 msgstr ""
12252
12253 #. type: =head2
12254 #: ../src/guestfs-actions.pod:3023
12255 msgid "guestfs_inspect_is_netinst"
12256 msgstr ""
12257
12258 #. type: verbatim
12259 #: ../src/guestfs-actions.pod:3025
12260 #, no-wrap
12261 msgid ""
12262 " int\n"
12263 " guestfs_inspect_is_netinst (guestfs_h *g,\n"
12264 "                             const char *root);\n"
12265 "\n"
12266 msgstr ""
12267
12268 #. type: textblock
12269 #: ../src/guestfs-actions.pod:3032
12270 msgid ""
12271 "If C<guestfs_inspect_get_format> returns C<installer> (this is an install "
12272 "disk), then this returns true if the disk is a network installer, ie. not a "
12273 "self-contained install CD but one which is likely to require network access "
12274 "to complete the install."
12275 msgstr ""
12276
12277 # type: =head2
12278 #. type: =head2
12279 #: ../src/guestfs-actions.pod:3042
12280 msgid "guestfs_inspect_list_applications"
12281 msgstr ""
12282
12283 # type: verbatim
12284 #. type: verbatim
12285 #: ../src/guestfs-actions.pod:3044
12286 #, no-wrap
12287 msgid ""
12288 " struct guestfs_application_list *\n"
12289 " guestfs_inspect_list_applications (guestfs_h *g,\n"
12290 "                                    const char *root);\n"
12291 "\n"
12292 msgstr ""
12293
12294 # type: textblock
12295 #. type: textblock
12296 #: ../src/guestfs-actions.pod:3051 ../fish/guestfish-actions.pod:2113
12297 msgid "Return the list of applications installed in the operating system."
12298 msgstr ""
12299
12300 # type: textblock
12301 #. type: textblock
12302 #: ../src/guestfs-actions.pod:3053
12303 msgid ""
12304 "I<Note:> This call works differently from other parts of the inspection "
12305 "API.  You have to call C<guestfs_inspect_os>, then "
12306 "C<guestfs_inspect_get_mountpoints>, then mount up the disks, before calling "
12307 "this.  Listing applications is a significantly more difficult operation "
12308 "which requires access to the full filesystem.  Also note that unlike the "
12309 "other C<guestfs_inspect_get_*> calls which are just returning data cached in "
12310 "the libguestfs handle, this call actually reads parts of the mounted "
12311 "filesystems during the call."
12312 msgstr ""
12313
12314 # type: textblock
12315 #. type: textblock
12316 #: ../src/guestfs-actions.pod:3063 ../fish/guestfish-actions.pod:2125
12317 msgid ""
12318 "This returns an empty list if the inspection code was not able to determine "
12319 "the list of applications."
12320 msgstr ""
12321
12322 # type: textblock
12323 #. type: textblock
12324 #: ../src/guestfs-actions.pod:3066 ../fish/guestfish-actions.pod:2128
12325 msgid "The application structure contains the following fields:"
12326 msgstr ""
12327
12328 # type: =item
12329 #. type: =item
12330 #: ../src/guestfs-actions.pod:3070 ../fish/guestfish-actions.pod:2132
12331 msgid "C<app_name>"
12332 msgstr ""
12333
12334 # type: textblock
12335 #. type: textblock
12336 #: ../src/guestfs-actions.pod:3072 ../fish/guestfish-actions.pod:2134
12337 msgid ""
12338 "The name of the application.  For Red Hat-derived and Debian-derived Linux "
12339 "guests, this is the package name."
12340 msgstr ""
12341
12342 # type: =item
12343 #. type: =item
12344 #: ../src/guestfs-actions.pod:3075 ../fish/guestfish-actions.pod:2137
12345 msgid "C<app_display_name>"
12346 msgstr ""
12347
12348 # type: textblock
12349 #. type: textblock
12350 #: ../src/guestfs-actions.pod:3077 ../fish/guestfish-actions.pod:2139
12351 msgid ""
12352 "The display name of the application, sometimes localized to the install "
12353 "language of the guest operating system."
12354 msgstr ""
12355
12356 # type: textblock
12357 #. type: textblock
12358 #: ../src/guestfs-actions.pod:3080 ../fish/guestfish-actions.pod:2142
12359 msgid ""
12360 "If unavailable this is returned as an empty string C<\"\">.  Callers needing "
12361 "to display something can use C<app_name> instead."
12362 msgstr ""
12363
12364 # type: =item
12365 #. type: =item
12366 #: ../src/guestfs-actions.pod:3083 ../fish/guestfish-actions.pod:2145
12367 msgid "C<app_epoch>"
12368 msgstr ""
12369
12370 # type: textblock
12371 #. type: textblock
12372 #: ../src/guestfs-actions.pod:3085 ../fish/guestfish-actions.pod:2147
12373 msgid ""
12374 "For package managers which use epochs, this contains the epoch of the "
12375 "package (an integer).  If unavailable, this is returned as C<0>."
12376 msgstr ""
12377
12378 # type: =item
12379 #. type: =item
12380 #: ../src/guestfs-actions.pod:3088 ../fish/guestfish-actions.pod:2150
12381 msgid "C<app_version>"
12382 msgstr ""
12383
12384 # type: textblock
12385 #. type: textblock
12386 #: ../src/guestfs-actions.pod:3090 ../fish/guestfish-actions.pod:2152
12387 msgid ""
12388 "The version string of the application or package.  If unavailable this is "
12389 "returned as an empty string C<\"\">."
12390 msgstr ""
12391
12392 # type: =item
12393 #. type: =item
12394 #: ../src/guestfs-actions.pod:3093 ../fish/guestfish-actions.pod:2155
12395 msgid "C<app_release>"
12396 msgstr ""
12397
12398 # type: textblock
12399 #. type: textblock
12400 #: ../src/guestfs-actions.pod:3095 ../fish/guestfish-actions.pod:2157
12401 msgid ""
12402 "The release string of the application or package, for package managers that "
12403 "use this.  If unavailable this is returned as an empty string C<\"\">."
12404 msgstr ""
12405
12406 # type: =item
12407 #. type: =item
12408 #: ../src/guestfs-actions.pod:3099 ../fish/guestfish-actions.pod:2161
12409 msgid "C<app_install_path>"
12410 msgstr ""
12411
12412 # type: textblock
12413 #. type: textblock
12414 #: ../src/guestfs-actions.pod:3101 ../fish/guestfish-actions.pod:2163
12415 msgid ""
12416 "The installation path of the application (on operating systems such as "
12417 "Windows which use installation paths).  This path is in the format used by "
12418 "the guest operating system, it is not a libguestfs path."
12419 msgstr ""
12420
12421 # type: textblock
12422 #. type: textblock
12423 #: ../src/guestfs-actions.pod:3106 ../fish/guestfish-actions.pod:2168
12424 msgid "If unavailable this is returned as an empty string C<\"\">."
12425 msgstr ""
12426
12427 # type: =item
12428 #. type: =item
12429 #: ../src/guestfs-actions.pod:3108 ../fish/guestfish-actions.pod:2170
12430 msgid "C<app_trans_path>"
12431 msgstr ""
12432
12433 # type: textblock
12434 #. type: textblock
12435 #: ../src/guestfs-actions.pod:3110 ../fish/guestfish-actions.pod:2172
12436 msgid ""
12437 "The install path translated into a libguestfs path.  If unavailable this is "
12438 "returned as an empty string C<\"\">."
12439 msgstr ""
12440
12441 # type: =item
12442 #. type: =item
12443 #: ../src/guestfs-actions.pod:3113 ../fish/guestfish-actions.pod:2175
12444 msgid "C<app_publisher>"
12445 msgstr ""
12446
12447 # type: textblock
12448 #. type: textblock
12449 #: ../src/guestfs-actions.pod:3115 ../fish/guestfish-actions.pod:2177
12450 msgid ""
12451 "The name of the publisher of the application, for package managers that use "
12452 "this.  If unavailable this is returned as an empty string C<\"\">."
12453 msgstr ""
12454
12455 # type: =item
12456 #. type: =item
12457 #: ../src/guestfs-actions.pod:3119 ../fish/guestfish-actions.pod:2181
12458 msgid "C<app_url>"
12459 msgstr ""
12460
12461 # type: textblock
12462 #. type: textblock
12463 #: ../src/guestfs-actions.pod:3121 ../fish/guestfish-actions.pod:2183
12464 msgid ""
12465 "The URL (eg. upstream URL) of the application.  If unavailable this is "
12466 "returned as an empty string C<\"\">."
12467 msgstr ""
12468
12469 # type: =item
12470 #. type: =item
12471 #: ../src/guestfs-actions.pod:3124 ../fish/guestfish-actions.pod:2186
12472 msgid "C<app_source_package>"
12473 msgstr ""
12474
12475 # type: textblock
12476 #. type: textblock
12477 #: ../src/guestfs-actions.pod:3126 ../fish/guestfish-actions.pod:2188
12478 msgid ""
12479 "For packaging systems which support this, the name of the source package.  "
12480 "If unavailable this is returned as an empty string C<\"\">."
12481 msgstr ""
12482
12483 # type: =item
12484 #. type: =item
12485 #: ../src/guestfs-actions.pod:3129 ../fish/guestfish-actions.pod:2191
12486 msgid "C<app_summary>"
12487 msgstr ""
12488
12489 # type: textblock
12490 #. type: textblock
12491 #: ../src/guestfs-actions.pod:3131 ../fish/guestfish-actions.pod:2193
12492 msgid ""
12493 "A short (usually one line) description of the application or package.  If "
12494 "unavailable this is returned as an empty string C<\"\">."
12495 msgstr ""
12496
12497 # type: =item
12498 #. type: =item
12499 #: ../src/guestfs-actions.pod:3134 ../fish/guestfish-actions.pod:2196
12500 msgid "C<app_description>"
12501 msgstr ""
12502
12503 # type: textblock
12504 #. type: textblock
12505 #: ../src/guestfs-actions.pod:3136 ../fish/guestfish-actions.pod:2198
12506 msgid ""
12507 "A longer description of the application or package.  If unavailable this is "
12508 "returned as an empty string C<\"\">."
12509 msgstr ""
12510
12511 # type: textblock
12512 #. type: textblock
12513 #: ../src/guestfs-actions.pod:3143
12514 msgid ""
12515 "This function returns a C<struct guestfs_application_list *>, or NULL if "
12516 "there was an error.  I<The caller must call C<guestfs_free_application_list> "
12517 "after use>."
12518 msgstr ""
12519
12520 # type: textblock
12521 #. type: textblock
12522 #: ../src/guestfs-actions.pod:3147
12523 msgid "(Added in 1.7.8)"
12524 msgstr ""
12525
12526 # type: =head2
12527 #. type: =head2
12528 #: ../src/guestfs-actions.pod:3149
12529 msgid "guestfs_inspect_os"
12530 msgstr ""
12531
12532 # type: verbatim
12533 #. type: verbatim
12534 #: ../src/guestfs-actions.pod:3151
12535 #, no-wrap
12536 msgid ""
12537 " char **\n"
12538 " guestfs_inspect_os (guestfs_h *g);\n"
12539 "\n"
12540 msgstr ""
12541
12542 # type: textblock
12543 #. type: textblock
12544 #: ../src/guestfs-actions.pod:3154 ../fish/guestfish-actions.pod:2209
12545 msgid ""
12546 "This function uses other libguestfs functions and certain heuristics to "
12547 "inspect the disk(s) (usually disks belonging to a virtual machine), looking "
12548 "for operating systems."
12549 msgstr ""
12550
12551 # type: textblock
12552 #. type: textblock
12553 #: ../src/guestfs-actions.pod:3158 ../fish/guestfish-actions.pod:2213
12554 msgid "The list returned is empty if no operating systems were found."
12555 msgstr ""
12556
12557 # type: textblock
12558 #. type: textblock
12559 #: ../src/guestfs-actions.pod:3160 ../fish/guestfish-actions.pod:2215
12560 msgid ""
12561 "If one operating system was found, then this returns a list with a single "
12562 "element, which is the name of the root filesystem of this operating system.  "
12563 "It is also possible for this function to return a list containing more than "
12564 "one element, indicating a dual-boot or multi-boot virtual machine, with each "
12565 "element being the root filesystem of one of the operating systems."
12566 msgstr ""
12567
12568 # type: textblock
12569 #. type: textblock
12570 #: ../src/guestfs-actions.pod:3167
12571 msgid ""
12572 "You can pass the root string(s) returned to other C<guestfs_inspect_get_*> "
12573 "functions in order to query further information about each operating system, "
12574 "such as the name and version."
12575 msgstr ""
12576
12577 # type: textblock
12578 #. type: textblock
12579 #: ../src/guestfs-actions.pod:3172
12580 msgid ""
12581 "This function uses other libguestfs features such as C<guestfs_mount_ro> and "
12582 "C<guestfs_umount_all> in order to mount and unmount filesystems and look at "
12583 "the contents.  This should be called with no disks currently mounted.  The "
12584 "function may also use Augeas, so any existing Augeas handle will be closed."
12585 msgstr ""
12586
12587 # type: textblock
12588 #. type: textblock
12589 #: ../src/guestfs-actions.pod:3178 ../fish/guestfish-actions.pod:2233
12590 msgid ""
12591 "This function cannot decrypt encrypted disks.  The caller must do that first "
12592 "(supplying the necessary keys) if the disk is encrypted."
12593 msgstr ""
12594
12595 # type: textblock
12596 #. type: textblock
12597 #: ../src/guestfs-actions.pod:3184 ../src/guestfs-actions.pod:3469
12598 #: ../src/guestfs-actions.pod:3531
12599 msgid "See also C<guestfs_list_filesystems>."
12600 msgstr ""
12601
12602 # type: =head2
12603 #. type: =head2
12604 #: ../src/guestfs-actions.pod:3192
12605 msgid "guestfs_is_blockdev"
12606 msgstr ""
12607
12608 # type: verbatim
12609 #. type: verbatim
12610 #: ../src/guestfs-actions.pod:3194
12611 #, no-wrap
12612 msgid ""
12613 " int\n"
12614 " guestfs_is_blockdev (guestfs_h *g,\n"
12615 "                      const char *path);\n"
12616 "\n"
12617 msgstr ""
12618
12619 # type: textblock
12620 #. type: textblock
12621 #: ../src/guestfs-actions.pod:3198 ../fish/guestfish-actions.pod:2245
12622 msgid ""
12623 "This returns C<true> if and only if there is a block device with the given "
12624 "C<path> name."
12625 msgstr ""
12626
12627 # type: textblock
12628 #. type: textblock
12629 #: ../src/guestfs-actions.pod:3201 ../src/guestfs-actions.pod:3230
12630 #: ../src/guestfs-actions.pod:3260 ../src/guestfs-actions.pod:3275
12631 #: ../src/guestfs-actions.pod:3291 ../src/guestfs-actions.pod:3347
12632 #: ../src/guestfs-actions.pod:3362
12633 msgid "See also C<guestfs_stat>."
12634 msgstr ""
12635
12636 # type: textblock
12637 #. type: textblock
12638 #: ../src/guestfs-actions.pod:3205 ../src/guestfs-actions.pod:3234
12639 #: ../src/guestfs-actions.pod:3279 ../src/guestfs-actions.pod:3351
12640 #: ../src/guestfs-actions.pod:3366
12641 msgid "(Added in 1.5.10)"
12642 msgstr ""
12643
12644 # type: =head2
12645 #. type: =head2
12646 #: ../src/guestfs-actions.pod:3207
12647 msgid "guestfs_is_busy"
12648 msgstr ""
12649
12650 # type: verbatim
12651 #. type: verbatim
12652 #: ../src/guestfs-actions.pod:3209
12653 #, no-wrap
12654 msgid ""
12655 " int\n"
12656 " guestfs_is_busy (guestfs_h *g);\n"
12657 "\n"
12658 msgstr ""
12659
12660 # type: textblock
12661 #. type: textblock
12662 #: ../src/guestfs-actions.pod:3212 ../fish/guestfish-actions.pod:2254
12663 msgid ""
12664 "This returns true iff this handle is busy processing a command (in the "
12665 "C<BUSY> state)."
12666 msgstr ""
12667
12668 # type: =head2
12669 #. type: =head2
12670 #: ../src/guestfs-actions.pod:3221
12671 msgid "guestfs_is_chardev"
12672 msgstr ""
12673
12674 # type: verbatim
12675 #. type: verbatim
12676 #: ../src/guestfs-actions.pod:3223
12677 #, no-wrap
12678 msgid ""
12679 " int\n"
12680 " guestfs_is_chardev (guestfs_h *g,\n"
12681 "                     const char *path);\n"
12682 "\n"
12683 msgstr ""
12684
12685 # type: textblock
12686 #. type: textblock
12687 #: ../src/guestfs-actions.pod:3227 ../fish/guestfish-actions.pod:2263
12688 msgid ""
12689 "This returns C<true> if and only if there is a character device with the "
12690 "given C<path> name."
12691 msgstr ""
12692
12693 # type: =head2
12694 #. type: =head2
12695 #: ../src/guestfs-actions.pod:3236
12696 msgid "guestfs_is_config"
12697 msgstr ""
12698
12699 # type: verbatim
12700 #. type: verbatim
12701 #: ../src/guestfs-actions.pod:3238
12702 #, no-wrap
12703 msgid ""
12704 " int\n"
12705 " guestfs_is_config (guestfs_h *g);\n"
12706 "\n"
12707 msgstr ""
12708
12709 # type: textblock
12710 #. type: textblock
12711 #: ../src/guestfs-actions.pod:3241 ../fish/guestfish-actions.pod:2272
12712 msgid ""
12713 "This returns true iff this handle is being configured (in the C<CONFIG> "
12714 "state)."
12715 msgstr ""
12716
12717 # type: =head2
12718 #. type: =head2
12719 #: ../src/guestfs-actions.pod:3250
12720 msgid "guestfs_is_dir"
12721 msgstr ""
12722
12723 # type: verbatim
12724 #. type: verbatim
12725 #: ../src/guestfs-actions.pod:3252
12726 #, no-wrap
12727 msgid ""
12728 " int\n"
12729 " guestfs_is_dir (guestfs_h *g,\n"
12730 "                 const char *path);\n"
12731 "\n"
12732 msgstr ""
12733
12734 # type: textblock
12735 #. type: textblock
12736 #: ../src/guestfs-actions.pod:3256 ../fish/guestfish-actions.pod:2281
12737 msgid ""
12738 "This returns C<true> if and only if there is a directory with the given "
12739 "C<path> name.  Note that it returns false for other objects like files."
12740 msgstr ""
12741
12742 # type: =head2
12743 #. type: =head2
12744 #: ../src/guestfs-actions.pod:3266
12745 msgid "guestfs_is_fifo"
12746 msgstr ""
12747
12748 # type: verbatim
12749 #. type: verbatim
12750 #: ../src/guestfs-actions.pod:3268
12751 #, no-wrap
12752 msgid ""
12753 " int\n"
12754 " guestfs_is_fifo (guestfs_h *g,\n"
12755 "                  const char *path);\n"
12756 "\n"
12757 msgstr ""
12758
12759 # type: textblock
12760 #. type: textblock
12761 #: ../src/guestfs-actions.pod:3272 ../fish/guestfish-actions.pod:2291
12762 msgid ""
12763 "This returns C<true> if and only if there is a FIFO (named pipe)  with the "
12764 "given C<path> name."
12765 msgstr ""
12766
12767 # type: =head2
12768 #. type: =head2
12769 #: ../src/guestfs-actions.pod:3281
12770 msgid "guestfs_is_file"
12771 msgstr ""
12772
12773 # type: verbatim
12774 #. type: verbatim
12775 #: ../src/guestfs-actions.pod:3283
12776 #, no-wrap
12777 msgid ""
12778 " int\n"
12779 " guestfs_is_file (guestfs_h *g,\n"
12780 "                  const char *path);\n"
12781 "\n"
12782 msgstr ""
12783
12784 # type: textblock
12785 #. type: textblock
12786 #: ../src/guestfs-actions.pod:3287 ../fish/guestfish-actions.pod:2300
12787 msgid ""
12788 "This returns C<true> if and only if there is a regular file with the given "
12789 "C<path> name.  Note that it returns false for other objects like directories."
12790 msgstr ""
12791
12792 # type: =head2
12793 #. type: =head2
12794 #: ../src/guestfs-actions.pod:3297
12795 msgid "guestfs_is_launching"
12796 msgstr ""
12797
12798 # type: verbatim
12799 #. type: verbatim
12800 #: ../src/guestfs-actions.pod:3299
12801 #, no-wrap
12802 msgid ""
12803 " int\n"
12804 " guestfs_is_launching (guestfs_h *g);\n"
12805 "\n"
12806 msgstr ""
12807
12808 # type: textblock
12809 #. type: textblock
12810 #: ../src/guestfs-actions.pod:3302 ../fish/guestfish-actions.pod:2310
12811 msgid ""
12812 "This returns true iff this handle is launching the subprocess (in the "
12813 "C<LAUNCHING> state)."
12814 msgstr ""
12815
12816 # type: =head2
12817 #. type: =head2
12818 #: ../src/guestfs-actions.pod:3311
12819 msgid "guestfs_is_lv"
12820 msgstr ""
12821
12822 # type: verbatim
12823 #. type: verbatim
12824 #: ../src/guestfs-actions.pod:3313
12825 #, no-wrap
12826 msgid ""
12827 " int\n"
12828 " guestfs_is_lv (guestfs_h *g,\n"
12829 "                const char *device);\n"
12830 "\n"
12831 msgstr ""
12832
12833 # type: textblock
12834 #. type: textblock
12835 #: ../src/guestfs-actions.pod:3317 ../fish/guestfish-actions.pod:2319
12836 msgid ""
12837 "This command tests whether C<device> is a logical volume, and returns true "
12838 "iff this is the case."
12839 msgstr ""
12840
12841 # type: =head2
12842 #. type: =head2
12843 #: ../src/guestfs-actions.pod:3324
12844 msgid "guestfs_is_ready"
12845 msgstr ""
12846
12847 # type: verbatim
12848 #. type: verbatim
12849 #: ../src/guestfs-actions.pod:3326
12850 #, no-wrap
12851 msgid ""
12852 " int\n"
12853 " guestfs_is_ready (guestfs_h *g);\n"
12854 "\n"
12855 msgstr ""
12856
12857 # type: textblock
12858 #. type: textblock
12859 #: ../src/guestfs-actions.pod:3329 ../fish/guestfish-actions.pod:2326
12860 msgid ""
12861 "This returns true iff this handle is ready to accept commands (in the "
12862 "C<READY> state)."
12863 msgstr ""
12864
12865 # type: =head2
12866 #. type: =head2
12867 #: ../src/guestfs-actions.pod:3338
12868 msgid "guestfs_is_socket"
12869 msgstr ""
12870
12871 # type: verbatim
12872 #. type: verbatim
12873 #: ../src/guestfs-actions.pod:3340
12874 #, no-wrap
12875 msgid ""
12876 " int\n"
12877 " guestfs_is_socket (guestfs_h *g,\n"
12878 "                    const char *path);\n"
12879 "\n"
12880 msgstr ""
12881
12882 # type: textblock
12883 #. type: textblock
12884 #: ../src/guestfs-actions.pod:3344 ../fish/guestfish-actions.pod:2335
12885 msgid ""
12886 "This returns C<true> if and only if there is a Unix domain socket with the "
12887 "given C<path> name."
12888 msgstr ""
12889
12890 # type: =head2
12891 #. type: =head2
12892 #: ../src/guestfs-actions.pod:3353
12893 msgid "guestfs_is_symlink"
12894 msgstr ""
12895
12896 # type: verbatim
12897 #. type: verbatim
12898 #: ../src/guestfs-actions.pod:3355
12899 #, no-wrap
12900 msgid ""
12901 " int\n"
12902 " guestfs_is_symlink (guestfs_h *g,\n"
12903 "                     const char *path);\n"
12904 "\n"
12905 msgstr ""
12906
12907 # type: textblock
12908 #. type: textblock
12909 #: ../src/guestfs-actions.pod:3359 ../fish/guestfish-actions.pod:2344
12910 msgid ""
12911 "This returns C<true> if and only if there is a symbolic link with the given "
12912 "C<path> name."
12913 msgstr ""
12914
12915 # type: =head2
12916 #. type: =head2
12917 #: ../src/guestfs-actions.pod:3368
12918 msgid "guestfs_kill_subprocess"
12919 msgstr ""
12920
12921 # type: verbatim
12922 #. type: verbatim
12923 #: ../src/guestfs-actions.pod:3370
12924 #, no-wrap
12925 msgid ""
12926 " int\n"
12927 " guestfs_kill_subprocess (guestfs_h *g);\n"
12928 "\n"
12929 msgstr ""
12930
12931 # type: textblock
12932 #. type: textblock
12933 #: ../src/guestfs-actions.pod:3373 ../fish/guestfish-actions.pod:2353
12934 msgid "This kills the qemu subprocess.  You should never need to call this."
12935 msgstr ""
12936
12937 # type: =head2
12938 #. type: =head2
12939 #: ../src/guestfs-actions.pod:3379
12940 msgid "guestfs_launch"
12941 msgstr ""
12942
12943 # type: verbatim
12944 #. type: verbatim
12945 #: ../src/guestfs-actions.pod:3381
12946 #, no-wrap
12947 msgid ""
12948 " int\n"
12949 " guestfs_launch (guestfs_h *g);\n"
12950 "\n"
12951 msgstr ""
12952
12953 # type: textblock
12954 #. type: textblock
12955 #: ../src/guestfs-actions.pod:3384 ../fish/guestfish-actions.pod:2361
12956 msgid ""
12957 "Internally libguestfs is implemented by running a virtual machine using "
12958 "L<qemu(1)>."
12959 msgstr ""
12960
12961 # type: textblock
12962 #. type: textblock
12963 #: ../src/guestfs-actions.pod:3387 ../fish/guestfish-actions.pod:2364
12964 msgid ""
12965 "You should call this after configuring the handle (eg. adding drives) but "
12966 "before performing any actions."
12967 msgstr ""
12968
12969 # type: =head2
12970 #. type: =head2
12971 #: ../src/guestfs-actions.pod:3394
12972 msgid "guestfs_lchown"
12973 msgstr ""
12974
12975 # type: verbatim
12976 #. type: verbatim
12977 #: ../src/guestfs-actions.pod:3396
12978 #, no-wrap
12979 msgid ""
12980 " int\n"
12981 " guestfs_lchown (guestfs_h *g,\n"
12982 "                 int owner,\n"
12983 "                 int group,\n"
12984 "                 const char *path);\n"
12985 "\n"
12986 msgstr ""
12987
12988 # type: textblock
12989 #. type: textblock
12990 #: ../src/guestfs-actions.pod:3402
12991 msgid ""
12992 "Change the file owner to C<owner> and group to C<group>.  This is like "
12993 "C<guestfs_chown> but if C<path> is a symlink then the link itself is "
12994 "changed, not the target."
12995 msgstr ""
12996
12997 # type: =head2
12998 #. type: =head2
12999 #: ../src/guestfs-actions.pod:3414
13000 msgid "guestfs_lgetxattr"
13001 msgstr ""
13002
13003 # type: verbatim
13004 #. type: verbatim
13005 #: ../src/guestfs-actions.pod:3416
13006 #, no-wrap
13007 msgid ""
13008 " char *\n"
13009 " guestfs_lgetxattr (guestfs_h *g,\n"
13010 "                    const char *path,\n"
13011 "                    const char *name,\n"
13012 "                    size_t *size_r);\n"
13013 "\n"
13014 msgstr ""
13015
13016 # type: textblock
13017 #. type: textblock
13018 #: ../src/guestfs-actions.pod:3422 ../fish/guestfish-actions.pod:2383
13019 msgid ""
13020 "Get a single extended attribute from file C<path> named C<name>.  If C<path> "
13021 "is a symlink, then this call returns an extended attribute from the symlink."
13022 msgstr ""
13023
13024 # type: textblock
13025 #. type: textblock
13026 #: ../src/guestfs-actions.pod:3436
13027 msgid "See also: C<guestfs_lgetxattrs>, C<guestfs_getxattr>, L<attr(5)>."
13028 msgstr ""
13029
13030 # type: =head2
13031 #. type: =head2
13032 #: ../src/guestfs-actions.pod:3444
13033 msgid "guestfs_lgetxattrs"
13034 msgstr ""
13035
13036 # type: verbatim
13037 #. type: verbatim
13038 #: ../src/guestfs-actions.pod:3446
13039 #, no-wrap
13040 msgid ""
13041 " struct guestfs_xattr_list *\n"
13042 " guestfs_lgetxattrs (guestfs_h *g,\n"
13043 "                     const char *path);\n"
13044 "\n"
13045 msgstr ""
13046
13047 # type: textblock
13048 #. type: textblock
13049 #: ../src/guestfs-actions.pod:3450
13050 msgid ""
13051 "This is the same as C<guestfs_getxattrs>, but if C<path> is a symbolic link, "
13052 "then it returns the extended attributes of the link itself."
13053 msgstr ""
13054
13055 # type: =head2
13056 #. type: =head2
13057 #: ../src/guestfs-actions.pod:3460
13058 msgid "guestfs_list_devices"
13059 msgstr ""
13060
13061 # type: verbatim
13062 #. type: verbatim
13063 #: ../src/guestfs-actions.pod:3462
13064 #, no-wrap
13065 msgid ""
13066 " char **\n"
13067 " guestfs_list_devices (guestfs_h *g);\n"
13068 "\n"
13069 msgstr ""
13070
13071 # type: textblock
13072 #. type: textblock
13073 #: ../src/guestfs-actions.pod:3465 ../fish/guestfish-actions.pod:2411
13074 msgid "List all the block devices."
13075 msgstr ""
13076
13077 # type: textblock
13078 #. type: textblock
13079 #: ../src/guestfs-actions.pod:3467 ../fish/guestfish-actions.pod:2413
13080 msgid "The full block device names are returned, eg. C</dev/sda>."
13081 msgstr ""
13082
13083 # type: =head2
13084 #. type: =head2
13085 #: ../src/guestfs-actions.pod:3477
13086 msgid "guestfs_list_filesystems"
13087 msgstr ""
13088
13089 # type: verbatim
13090 #. type: verbatim
13091 #: ../src/guestfs-actions.pod:3479
13092 #, no-wrap
13093 msgid ""
13094 " char **\n"
13095 " guestfs_list_filesystems (guestfs_h *g);\n"
13096 "\n"
13097 msgstr ""
13098
13099 # type: textblock
13100 #. type: textblock
13101 #: ../src/guestfs-actions.pod:3482 ../fish/guestfish-actions.pod:2421
13102 msgid ""
13103 "This inspection command looks for filesystems on partitions, block devices "
13104 "and logical volumes, returning a list of devices containing filesystems and "
13105 "their type."
13106 msgstr ""
13107
13108 # type: textblock
13109 #. type: textblock
13110 #: ../src/guestfs-actions.pod:3486 ../fish/guestfish-actions.pod:2425
13111 msgid ""
13112 "The return value is a hash, where the keys are the devices containing "
13113 "filesystems, and the values are the filesystem types.  For example:"
13114 msgstr ""
13115
13116 # type: verbatim
13117 #. type: verbatim
13118 #: ../src/guestfs-actions.pod:3490 ../fish/guestfish-actions.pod:2429
13119 #, no-wrap
13120 msgid ""
13121 " \"/dev/sda1\" => \"ntfs\"\n"
13122 " \"/dev/sda2\" => \"ext2\"\n"
13123 " \"/dev/vg_guest/lv_root\" => \"ext4\"\n"
13124 " \"/dev/vg_guest/lv_swap\" => \"swap\"\n"
13125 "\n"
13126 msgstr ""
13127
13128 # type: textblock
13129 #. type: textblock
13130 #: ../src/guestfs-actions.pod:3495 ../fish/guestfish-actions.pod:2434
13131 msgid ""
13132 "The value can have the special value \"unknown\", meaning the content of the "
13133 "device is undetermined or empty.  \"swap\" means a Linux swap partition."
13134 msgstr ""
13135
13136 # type: textblock
13137 #. type: textblock
13138 #: ../src/guestfs-actions.pod:3499
13139 msgid ""
13140 "This command runs other libguestfs commands, which might include "
13141 "C<guestfs_mount> and C<guestfs_umount>, and therefore you should use this "
13142 "soon after launch and only when nothing is mounted."
13143 msgstr ""
13144
13145 # type: textblock
13146 #. type: textblock
13147 #: ../src/guestfs-actions.pod:3503
13148 msgid ""
13149 "Not all of the filesystems returned will be mountable.  In particular, swap "
13150 "partitions are returned in the list.  Also this command does not check that "
13151 "each filesystem found is valid and mountable, and some filesystems might be "
13152 "mountable but require special options.  Filesystems may not all belong to a "
13153 "single logical operating system (use C<guestfs_inspect_os> to look for OSes)."
13154 msgstr ""
13155
13156 # type: textblock
13157 #. type: textblock
13158 #: ../src/guestfs-actions.pod:3517 ../src/guestfs-actions.pod:5122
13159 msgid "(Added in 1.5.15)"
13160 msgstr ""
13161
13162 # type: =head2
13163 #. type: =head2
13164 #: ../src/guestfs-actions.pod:3519
13165 msgid "guestfs_list_partitions"
13166 msgstr ""
13167
13168 # type: verbatim
13169 #. type: verbatim
13170 #: ../src/guestfs-actions.pod:3521
13171 #, no-wrap
13172 msgid ""
13173 " char **\n"
13174 " guestfs_list_partitions (guestfs_h *g);\n"
13175 "\n"
13176 msgstr ""
13177
13178 # type: textblock
13179 #. type: textblock
13180 #: ../src/guestfs-actions.pod:3524 ../fish/guestfish-actions.pod:2454
13181 msgid "List all the partitions detected on all block devices."
13182 msgstr ""
13183
13184 # type: textblock
13185 #. type: textblock
13186 #: ../src/guestfs-actions.pod:3526 ../fish/guestfish-actions.pod:2456
13187 msgid "The full partition device names are returned, eg. C</dev/sda1>"
13188 msgstr ""
13189
13190 # type: textblock
13191 #. type: textblock
13192 #: ../src/guestfs-actions.pod:3528
13193 msgid ""
13194 "This does not return logical volumes.  For that you will need to call "
13195 "C<guestfs_lvs>."
13196 msgstr ""
13197
13198 # type: =head2
13199 #. type: =head2
13200 #: ../src/guestfs-actions.pod:3539
13201 msgid "guestfs_ll"
13202 msgstr ""
13203
13204 # type: verbatim
13205 #. type: verbatim
13206 #: ../src/guestfs-actions.pod:3541
13207 #, no-wrap
13208 msgid ""
13209 " char *\n"
13210 " guestfs_ll (guestfs_h *g,\n"
13211 "             const char *directory);\n"
13212 "\n"
13213 msgstr ""
13214
13215 # type: textblock
13216 #. type: textblock
13217 #: ../src/guestfs-actions.pod:3545 ../fish/guestfish-actions.pod:2467
13218 msgid ""
13219 "List the files in C<directory> (relative to the root directory, there is no "
13220 "cwd) in the format of 'ls -la'."
13221 msgstr ""
13222
13223 # type: textblock
13224 #. type: textblock
13225 #: ../src/guestfs-actions.pod:3548 ../fish/guestfish-actions.pod:2470
13226 msgid ""
13227 "This command is mostly useful for interactive sessions.  It is I<not> "
13228 "intended that you try to parse the output string."
13229 msgstr ""
13230
13231 # type: =head2
13232 #. type: =head2
13233 #: ../src/guestfs-actions.pod:3556
13234 msgid "guestfs_ln"
13235 msgstr ""
13236
13237 # type: verbatim
13238 #. type: verbatim
13239 #: ../src/guestfs-actions.pod:3558
13240 #, no-wrap
13241 msgid ""
13242 " int\n"
13243 " guestfs_ln (guestfs_h *g,\n"
13244 "             const char *target,\n"
13245 "             const char *linkname);\n"
13246 "\n"
13247 msgstr ""
13248
13249 # type: textblock
13250 #. type: textblock
13251 #: ../src/guestfs-actions.pod:3563 ../fish/guestfish-actions.pod:2477
13252 msgid "This command creates a hard link using the C<ln> command."
13253 msgstr ""
13254
13255 # type: =head2
13256 #. type: =head2
13257 #: ../src/guestfs-actions.pod:3569
13258 msgid "guestfs_ln_f"
13259 msgstr ""
13260
13261 # type: verbatim
13262 #. type: verbatim
13263 #: ../src/guestfs-actions.pod:3571
13264 #, no-wrap
13265 msgid ""
13266 " int\n"
13267 " guestfs_ln_f (guestfs_h *g,\n"
13268 "               const char *target,\n"
13269 "               const char *linkname);\n"
13270 "\n"
13271 msgstr ""
13272
13273 # type: textblock
13274 #. type: textblock
13275 #: ../src/guestfs-actions.pod:3576 ../fish/guestfish-actions.pod:2483
13276 msgid ""
13277 "This command creates a hard link using the C<ln -f> command.  The C<-f> "
13278 "option removes the link (C<linkname>) if it exists already."
13279 msgstr ""
13280
13281 # type: =head2
13282 #. type: =head2
13283 #: ../src/guestfs-actions.pod:3583
13284 msgid "guestfs_ln_s"
13285 msgstr ""
13286
13287 # type: verbatim
13288 #. type: verbatim
13289 #: ../src/guestfs-actions.pod:3585
13290 #, no-wrap
13291 msgid ""
13292 " int\n"
13293 " guestfs_ln_s (guestfs_h *g,\n"
13294 "               const char *target,\n"
13295 "               const char *linkname);\n"
13296 "\n"
13297 msgstr ""
13298
13299 # type: textblock
13300 #. type: textblock
13301 #: ../src/guestfs-actions.pod:3590 ../fish/guestfish-actions.pod:2490
13302 msgid "This command creates a symbolic link using the C<ln -s> command."
13303 msgstr ""
13304
13305 # type: =head2
13306 #. type: =head2
13307 #: ../src/guestfs-actions.pod:3596
13308 msgid "guestfs_ln_sf"
13309 msgstr ""
13310
13311 # type: verbatim
13312 #. type: verbatim
13313 #: ../src/guestfs-actions.pod:3598
13314 #, no-wrap
13315 msgid ""
13316 " int\n"
13317 " guestfs_ln_sf (guestfs_h *g,\n"
13318 "                const char *target,\n"
13319 "                const char *linkname);\n"
13320 "\n"
13321 msgstr ""
13322
13323 # type: textblock
13324 #. type: textblock
13325 #: ../src/guestfs-actions.pod:3603 ../fish/guestfish-actions.pod:2496
13326 msgid ""
13327 "This command creates a symbolic link using the C<ln -sf> command, The C<-f> "
13328 "option removes the link (C<linkname>) if it exists already."
13329 msgstr ""
13330
13331 # type: =head2
13332 #. type: =head2
13333 #: ../src/guestfs-actions.pod:3610
13334 msgid "guestfs_lremovexattr"
13335 msgstr ""
13336
13337 # type: verbatim
13338 #. type: verbatim
13339 #: ../src/guestfs-actions.pod:3612
13340 #, no-wrap
13341 msgid ""
13342 " int\n"
13343 " guestfs_lremovexattr (guestfs_h *g,\n"
13344 "                       const char *xattr,\n"
13345 "                       const char *path);\n"
13346 "\n"
13347 msgstr ""
13348
13349 # type: textblock
13350 #. type: textblock
13351 #: ../src/guestfs-actions.pod:3617
13352 msgid ""
13353 "This is the same as C<guestfs_removexattr>, but if C<path> is a symbolic "
13354 "link, then it removes an extended attribute of the link itself."
13355 msgstr ""
13356
13357 # type: =head2
13358 #. type: =head2
13359 #: ../src/guestfs-actions.pod:3625
13360 msgid "guestfs_ls"
13361 msgstr ""
13362
13363 # type: verbatim
13364 #. type: verbatim
13365 #: ../src/guestfs-actions.pod:3627
13366 #, no-wrap
13367 msgid ""
13368 " char **\n"
13369 " guestfs_ls (guestfs_h *g,\n"
13370 "             const char *directory);\n"
13371 "\n"
13372 msgstr ""
13373
13374 # type: textblock
13375 #. type: textblock
13376 #: ../src/guestfs-actions.pod:3631 ../fish/guestfish-actions.pod:2511
13377 msgid ""
13378 "List the files in C<directory> (relative to the root directory, there is no "
13379 "cwd).  The '.' and '..' entries are not returned, but hidden files are shown."
13380 msgstr ""
13381
13382 # type: textblock
13383 #. type: textblock
13384 #: ../src/guestfs-actions.pod:3635
13385 msgid ""
13386 "This command is mostly useful for interactive sessions.  Programs should "
13387 "probably use C<guestfs_readdir> instead."
13388 msgstr ""
13389
13390 # type: =head2
13391 #. type: =head2
13392 #: ../src/guestfs-actions.pod:3644
13393 msgid "guestfs_lsetxattr"
13394 msgstr ""
13395
13396 # type: verbatim
13397 #. type: verbatim
13398 #: ../src/guestfs-actions.pod:3646
13399 #, no-wrap
13400 msgid ""
13401 " int\n"
13402 " guestfs_lsetxattr (guestfs_h *g,\n"
13403 "                    const char *xattr,\n"
13404 "                    const char *val,\n"
13405 "                    int vallen,\n"
13406 "                    const char *path);\n"
13407 "\n"
13408 msgstr ""
13409
13410 # type: textblock
13411 #. type: textblock
13412 #: ../src/guestfs-actions.pod:3653
13413 msgid ""
13414 "This is the same as C<guestfs_setxattr>, but if C<path> is a symbolic link, "
13415 "then it sets an extended attribute of the link itself."
13416 msgstr ""
13417
13418 # type: =head2
13419 #. type: =head2
13420 #: ../src/guestfs-actions.pod:3661
13421 msgid "guestfs_lstat"
13422 msgstr ""
13423
13424 # type: verbatim
13425 #. type: verbatim
13426 #: ../src/guestfs-actions.pod:3663
13427 #, no-wrap
13428 msgid ""
13429 " struct guestfs_stat *\n"
13430 " guestfs_lstat (guestfs_h *g,\n"
13431 "                const char *path);\n"
13432 "\n"
13433 msgstr ""
13434
13435 # type: textblock
13436 #. type: textblock
13437 #: ../src/guestfs-actions.pod:3667 ../src/guestfs-actions.pod:6225
13438 #: ../fish/guestfish-actions.pod:2530 ../fish/guestfish-actions.pod:4199
13439 msgid "Returns file information for the given C<path>."
13440 msgstr ""
13441
13442 # type: textblock
13443 #. type: textblock
13444 #: ../src/guestfs-actions.pod:3669
13445 msgid ""
13446 "This is the same as C<guestfs_stat> except that if C<path> is a symbolic "
13447 "link, then the link is stat-ed, not the file it refers to."
13448 msgstr ""
13449
13450 # type: textblock
13451 #. type: textblock
13452 #: ../src/guestfs-actions.pod:3673 ../fish/guestfish-actions.pod:2536
13453 msgid "This is the same as the C<lstat(2)> system call."
13454 msgstr ""
13455
13456 # type: textblock
13457 #. type: textblock
13458 #: ../src/guestfs-actions.pod:3675 ../src/guestfs-actions.pod:6229
13459 msgid ""
13460 "This function returns a C<struct guestfs_stat *>, or NULL if there was an "
13461 "error.  I<The caller must call C<guestfs_free_stat> after use>."
13462 msgstr ""
13463
13464 # type: textblock
13465 #. type: textblock
13466 #: ../src/guestfs-actions.pod:3679 ../src/guestfs-actions.pod:6233
13467 #: ../src/guestfs-actions.pod:6251 ../src/guestfs-actions.pod:6632
13468 msgid "(Added in 0.9.2)"
13469 msgstr ""
13470
13471 # type: =head2
13472 #. type: =head2
13473 #: ../src/guestfs-actions.pod:3681
13474 msgid "guestfs_lstatlist"
13475 msgstr ""
13476
13477 # type: verbatim
13478 #. type: verbatim
13479 #: ../src/guestfs-actions.pod:3683
13480 #, no-wrap
13481 msgid ""
13482 " struct guestfs_stat_list *\n"
13483 " guestfs_lstatlist (guestfs_h *g,\n"
13484 "                    const char *path,\n"
13485 "                    char *const *names);\n"
13486 "\n"
13487 msgstr ""
13488
13489 # type: textblock
13490 #. type: textblock
13491 #: ../src/guestfs-actions.pod:3688
13492 msgid ""
13493 "This call allows you to perform the C<guestfs_lstat> operation on multiple "
13494 "files, where all files are in the directory C<path>.  C<names> is the list "
13495 "of files from this directory."
13496 msgstr ""
13497
13498 # type: textblock
13499 #. type: textblock
13500 #: ../src/guestfs-actions.pod:3692 ../fish/guestfish-actions.pod:2546
13501 msgid ""
13502 "On return you get a list of stat structs, with a one-to-one correspondence "
13503 "to the C<names> list.  If any name did not exist or could not be lstat'd, "
13504 "then the C<ino> field of that structure is set to C<-1>."
13505 msgstr ""
13506
13507 # type: textblock
13508 #. type: textblock
13509 #: ../src/guestfs-actions.pod:3697
13510 msgid ""
13511 "This call is intended for programs that want to efficiently list a directory "
13512 "contents without making many round-trips.  See also C<guestfs_lxattrlist> "
13513 "for a similarly efficient call for getting extended attributes.  Very long "
13514 "directory listings might cause the protocol message size to be exceeded, "
13515 "causing this call to fail.  The caller must split up such requests into "
13516 "smaller groups of names."
13517 msgstr ""
13518
13519 # type: textblock
13520 #. type: textblock
13521 #: ../src/guestfs-actions.pod:3705
13522 msgid ""
13523 "This function returns a C<struct guestfs_stat_list *>, or NULL if there was "
13524 "an error.  I<The caller must call C<guestfs_free_stat_list> after use>."
13525 msgstr ""
13526
13527 # type: =head2
13528 #. type: =head2
13529 #: ../src/guestfs-actions.pod:3711
13530 msgid "guestfs_luks_add_key"
13531 msgstr ""
13532
13533 # type: verbatim
13534 #. type: verbatim
13535 #: ../src/guestfs-actions.pod:3713
13536 #, no-wrap
13537 msgid ""
13538 " int\n"
13539 " guestfs_luks_add_key (guestfs_h *g,\n"
13540 "                       const char *device,\n"
13541 "                       const char *key,\n"
13542 "                       const char *newkey,\n"
13543 "                       int keyslot);\n"
13544 "\n"
13545 msgstr ""
13546
13547 # type: textblock
13548 #. type: textblock
13549 #: ../src/guestfs-actions.pod:3720 ../fish/guestfish-actions.pod:2563
13550 msgid ""
13551 "This command adds a new key on LUKS device C<device>.  C<key> is any "
13552 "existing key, and is used to access the device.  C<newkey> is the new key to "
13553 "add.  C<keyslot> is the key slot that will be replaced."
13554 msgstr ""
13555
13556 # type: textblock
13557 #. type: textblock
13558 #: ../src/guestfs-actions.pod:3725
13559 msgid ""
13560 "Note that if C<keyslot> already contains a key, then this command will "
13561 "fail.  You have to use C<guestfs_luks_kill_slot> first to remove that key."
13562 msgstr ""
13563
13564 # type: textblock
13565 #. type: textblock
13566 #: ../src/guestfs-actions.pod:3731 ../src/guestfs-actions.pod:3771
13567 #: ../src/guestfs-actions.pod:3794 ../src/guestfs-actions.pod:3814
13568 #: ../src/guestfs-actions.pod:3846 ../src/guestfs-actions.pod:3865
13569 msgid ""
13570 "This function takes a key or passphrase parameter which could contain "
13571 "sensitive material.  Read the section L</KEYS AND PASSPHRASES> for more "
13572 "information."
13573 msgstr ""
13574
13575 # type: textblock
13576 #. type: textblock
13577 #: ../src/guestfs-actions.pod:3735 ../src/guestfs-actions.pod:3775
13578 #: ../src/guestfs-actions.pod:3798 ../src/guestfs-actions.pod:3818
13579 msgid "(Added in 1.5.2)"
13580 msgstr ""
13581
13582 # type: =head2
13583 #. type: =head2
13584 #: ../src/guestfs-actions.pod:3737
13585 msgid "guestfs_luks_close"
13586 msgstr ""
13587
13588 # type: verbatim
13589 #. type: verbatim
13590 #: ../src/guestfs-actions.pod:3739
13591 #, no-wrap
13592 msgid ""
13593 " int\n"
13594 " guestfs_luks_close (guestfs_h *g,\n"
13595 "                     const char *device);\n"
13596 "\n"
13597 msgstr ""
13598
13599 # type: textblock
13600 #. type: textblock
13601 #: ../src/guestfs-actions.pod:3743
13602 msgid ""
13603 "This closes a LUKS device that was created earlier by C<guestfs_luks_open> "
13604 "or C<guestfs_luks_open_ro>.  The C<device> parameter must be the name of the "
13605 "LUKS mapping device (ie. C</dev/mapper/mapname>) and I<not> the name of the "
13606 "underlying block device."
13607 msgstr ""
13608
13609 # type: textblock
13610 #. type: textblock
13611 #: ../src/guestfs-actions.pod:3751 ../src/guestfs-actions.pod:3850
13612 #: ../src/guestfs-actions.pod:3869 ../src/guestfs-actions.pod:3919
13613 #: ../src/guestfs-actions.pod:3967
13614 msgid "(Added in 1.5.1)"
13615 msgstr ""
13616
13617 # type: =head2
13618 #. type: =head2
13619 #: ../src/guestfs-actions.pod:3753
13620 msgid "guestfs_luks_format"
13621 msgstr ""
13622
13623 # type: verbatim
13624 #. type: verbatim
13625 #: ../src/guestfs-actions.pod:3755
13626 #, no-wrap
13627 msgid ""
13628 " int\n"
13629 " guestfs_luks_format (guestfs_h *g,\n"
13630 "                      const char *device,\n"
13631 "                      const char *key,\n"
13632 "                      int keyslot);\n"
13633 "\n"
13634 msgstr ""
13635
13636 # type: textblock
13637 #. type: textblock
13638 #: ../src/guestfs-actions.pod:3761 ../fish/guestfish-actions.pod:2589
13639 msgid ""
13640 "This command erases existing data on C<device> and formats the device as a "
13641 "LUKS encrypted device.  C<key> is the initial key, which is added to key "
13642 "slot C<slot>.  (LUKS supports 8 key slots, numbered 0-7)."
13643 msgstr ""
13644
13645 # type: textblock
13646 #. type: textblock
13647 #: ../src/guestfs-actions.pod:3768 ../src/guestfs-actions.pod:3791
13648 #: ../src/guestfs-actions.pod:3931 ../src/guestfs-actions.pod:4873
13649 #: ../src/guestfs-actions.pod:5653 ../src/guestfs-actions.pod:6060
13650 #: ../src/guestfs-actions.pod:6083 ../src/guestfs-actions.pod:6109
13651 #: ../src/guestfs-actions.pod:7269 ../fish/guestfish-actions.pod:2597
13652 #: ../fish/guestfish-actions.pod:2610 ../fish/guestfish-actions.pod:2694
13653 #: ../fish/guestfish-actions.pod:3268 ../fish/guestfish-actions.pod:3788
13654 #: ../fish/guestfish-actions.pod:4098 ../fish/guestfish-actions.pod:4114
13655 #: ../fish/guestfish-actions.pod:4129 ../fish/guestfish-actions.pod:4844
13656 msgid ""
13657 "B<This command is dangerous.  Without careful use you can easily destroy all "
13658 "your data>."
13659 msgstr ""
13660
13661 # type: =head2
13662 #. type: =head2
13663 #: ../src/guestfs-actions.pod:3777
13664 msgid "guestfs_luks_format_cipher"
13665 msgstr ""
13666
13667 # type: verbatim
13668 #. type: verbatim
13669 #: ../src/guestfs-actions.pod:3779
13670 #, no-wrap
13671 msgid ""
13672 " int\n"
13673 " guestfs_luks_format_cipher (guestfs_h *g,\n"
13674 "                             const char *device,\n"
13675 "                             const char *key,\n"
13676 "                             int keyslot,\n"
13677 "                             const char *cipher);\n"
13678 "\n"
13679 msgstr ""
13680
13681 # type: textblock
13682 #. type: textblock
13683 #: ../src/guestfs-actions.pod:3786
13684 msgid ""
13685 "This command is the same as C<guestfs_luks_format> but it also allows you to "
13686 "set the C<cipher> used."
13687 msgstr ""
13688
13689 # type: =head2
13690 #. type: =head2
13691 #: ../src/guestfs-actions.pod:3800
13692 msgid "guestfs_luks_kill_slot"
13693 msgstr ""
13694
13695 # type: verbatim
13696 #. type: verbatim
13697 #: ../src/guestfs-actions.pod:3802
13698 #, no-wrap
13699 msgid ""
13700 " int\n"
13701 " guestfs_luks_kill_slot (guestfs_h *g,\n"
13702 "                         const char *device,\n"
13703 "                         const char *key,\n"
13704 "                         int keyslot);\n"
13705 "\n"
13706 msgstr ""
13707
13708 # type: textblock
13709 #. type: textblock
13710 #: ../src/guestfs-actions.pod:3808 ../fish/guestfish-actions.pod:2617
13711 msgid ""
13712 "This command deletes the key in key slot C<keyslot> from the encrypted LUKS "
13713 "device C<device>.  C<key> must be one of the I<other> keys."
13714 msgstr ""
13715
13716 # type: =head2
13717 #. type: =head2
13718 #: ../src/guestfs-actions.pod:3820
13719 msgid "guestfs_luks_open"
13720 msgstr ""
13721
13722 # type: verbatim
13723 #. type: verbatim
13724 #: ../src/guestfs-actions.pod:3822
13725 #, no-wrap
13726 msgid ""
13727 " int\n"
13728 " guestfs_luks_open (guestfs_h *g,\n"
13729 "                    const char *device,\n"
13730 "                    const char *key,\n"
13731 "                    const char *mapname);\n"
13732 "\n"
13733 msgstr ""
13734
13735 # type: textblock
13736 #. type: textblock
13737 #: ../src/guestfs-actions.pod:3828 ../fish/guestfish-actions.pod:2628
13738 msgid ""
13739 "This command opens a block device which has been encrypted according to the "
13740 "Linux Unified Key Setup (LUKS) standard."
13741 msgstr ""
13742
13743 # type: textblock
13744 #. type: textblock
13745 #: ../src/guestfs-actions.pod:3831 ../fish/guestfish-actions.pod:2631
13746 msgid "C<device> is the encrypted block device or partition."
13747 msgstr ""
13748
13749 # type: textblock
13750 #. type: textblock
13751 #: ../src/guestfs-actions.pod:3833 ../fish/guestfish-actions.pod:2633
13752 msgid ""
13753 "The caller must supply one of the keys associated with the LUKS block "
13754 "device, in the C<key> parameter."
13755 msgstr ""
13756
13757 # type: textblock
13758 #. type: textblock
13759 #: ../src/guestfs-actions.pod:3836 ../fish/guestfish-actions.pod:2636
13760 msgid ""
13761 "This creates a new block device called C</dev/mapper/mapname>.  Reads and "
13762 "writes to this block device are decrypted from and encrypted to the "
13763 "underlying C<device> respectively."
13764 msgstr ""
13765
13766 # type: textblock
13767 #. type: textblock
13768 #: ../src/guestfs-actions.pod:3840
13769 msgid ""
13770 "If this block device contains LVM volume groups, then calling "
13771 "C<guestfs_vgscan> followed by C<guestfs_vg_activate_all> will make them "
13772 "visible."
13773 msgstr ""
13774
13775 # type: =head2
13776 #. type: =head2
13777 #: ../src/guestfs-actions.pod:3852
13778 msgid "guestfs_luks_open_ro"
13779 msgstr ""
13780
13781 # type: verbatim
13782 #. type: verbatim
13783 #: ../src/guestfs-actions.pod:3854
13784 #, no-wrap
13785 msgid ""
13786 " int\n"
13787 " guestfs_luks_open_ro (guestfs_h *g,\n"
13788 "                       const char *device,\n"
13789 "                       const char *key,\n"
13790 "                       const char *mapname);\n"
13791 "\n"
13792 msgstr ""
13793
13794 # type: textblock
13795 #. type: textblock
13796 #: ../src/guestfs-actions.pod:3860
13797 msgid ""
13798 "This is the same as C<guestfs_luks_open> except that a read-only mapping is "
13799 "created."
13800 msgstr ""
13801
13802 # type: =head2
13803 #. type: =head2
13804 #: ../src/guestfs-actions.pod:3871
13805 msgid "guestfs_lvcreate"
13806 msgstr ""
13807
13808 # type: verbatim
13809 #. type: verbatim
13810 #: ../src/guestfs-actions.pod:3873
13811 #, no-wrap
13812 msgid ""
13813 " int\n"
13814 " guestfs_lvcreate (guestfs_h *g,\n"
13815 "                   const char *logvol,\n"
13816 "                   const char *volgroup,\n"
13817 "                   int mbytes);\n"
13818 "\n"
13819 msgstr ""
13820
13821 # type: textblock
13822 #. type: textblock
13823 #: ../src/guestfs-actions.pod:3879 ../fish/guestfish-actions.pod:2661
13824 msgid ""
13825 "This creates an LVM logical volume called C<logvol> on the volume group "
13826 "C<volgroup>, with C<size> megabytes."
13827 msgstr ""
13828
13829 # type: =head2
13830 #. type: =head2
13831 #: ../src/guestfs-actions.pod:3886
13832 msgid "guestfs_lvm_canonical_lv_name"
13833 msgstr ""
13834
13835 # type: verbatim
13836 #. type: verbatim
13837 #: ../src/guestfs-actions.pod:3888
13838 #, no-wrap
13839 msgid ""
13840 " char *\n"
13841 " guestfs_lvm_canonical_lv_name (guestfs_h *g,\n"
13842 "                                const char *lvname);\n"
13843 "\n"
13844 msgstr ""
13845
13846 # type: textblock
13847 #. type: textblock
13848 #: ../src/guestfs-actions.pod:3892 ../fish/guestfish-actions.pod:2668
13849 msgid ""
13850 "This converts alternative naming schemes for LVs that you might find to the "
13851 "canonical name.  For example, C</dev/mapper/VG-LV> is converted to C</dev/VG/"
13852 "LV>."
13853 msgstr ""
13854
13855 # type: textblock
13856 #. type: textblock
13857 #: ../src/guestfs-actions.pod:3896 ../fish/guestfish-actions.pod:2672
13858 msgid ""
13859 "This command returns an error if the C<lvname> parameter does not refer to a "
13860 "logical volume."
13861 msgstr ""
13862
13863 # type: textblock
13864 #. type: textblock
13865 #: ../src/guestfs-actions.pod:3899
13866 msgid "See also C<guestfs_is_lv>."
13867 msgstr ""
13868
13869 # type: textblock
13870 #. type: textblock
13871 #: ../src/guestfs-actions.pod:3904
13872 msgid "(Added in 1.5.24)"
13873 msgstr ""
13874
13875 # type: =head2
13876 #. type: =head2
13877 #: ../src/guestfs-actions.pod:3906
13878 msgid "guestfs_lvm_clear_filter"
13879 msgstr ""
13880
13881 # type: verbatim
13882 #. type: verbatim
13883 #: ../src/guestfs-actions.pod:3908
13884 #, no-wrap
13885 msgid ""
13886 " int\n"
13887 " guestfs_lvm_clear_filter (guestfs_h *g);\n"
13888 "\n"
13889 msgstr ""
13890
13891 # type: textblock
13892 #. type: textblock
13893 #: ../src/guestfs-actions.pod:3911
13894 msgid ""
13895 "This undoes the effect of C<guestfs_lvm_set_filter>.  LVM will be able to "
13896 "see every block device."
13897 msgstr ""
13898
13899 # type: textblock
13900 #. type: textblock
13901 #: ../src/guestfs-actions.pod:3914 ../src/guestfs-actions.pod:3956
13902 #: ../fish/guestfish-actions.pod:2684 ../fish/guestfish-actions.pod:2715
13903 msgid ""
13904 "This command also clears the LVM cache and performs a volume group scan."
13905 msgstr ""
13906
13907 # type: =head2
13908 #. type: =head2
13909 #: ../src/guestfs-actions.pod:3921
13910 msgid "guestfs_lvm_remove_all"
13911 msgstr ""
13912
13913 # type: verbatim
13914 #. type: verbatim
13915 #: ../src/guestfs-actions.pod:3923
13916 #, no-wrap
13917 msgid ""
13918 " int\n"
13919 " guestfs_lvm_remove_all (guestfs_h *g);\n"
13920 "\n"
13921 msgstr ""
13922
13923 # type: textblock
13924 #. type: textblock
13925 #: ../src/guestfs-actions.pod:3926 ../fish/guestfish-actions.pod:2691
13926 msgid ""
13927 "This command removes all LVM logical volumes, volume groups and physical "
13928 "volumes."
13929 msgstr ""
13930
13931 # type: =head2
13932 #. type: =head2
13933 #: ../src/guestfs-actions.pod:3936
13934 msgid "guestfs_lvm_set_filter"
13935 msgstr ""
13936
13937 # type: verbatim
13938 #. type: verbatim
13939 #: ../src/guestfs-actions.pod:3938
13940 #, no-wrap
13941 msgid ""
13942 " int\n"
13943 " guestfs_lvm_set_filter (guestfs_h *g,\n"
13944 "                         char *const *devices);\n"
13945 "\n"
13946 msgstr ""
13947
13948 # type: textblock
13949 #. type: textblock
13950 #: ../src/guestfs-actions.pod:3942 ../fish/guestfish-actions.pod:2701
13951 msgid ""
13952 "This sets the LVM device filter so that LVM will only be able to \"see\" the "
13953 "block devices in the list C<devices>, and will ignore all other attached "
13954 "block devices."
13955 msgstr ""
13956
13957 # type: textblock
13958 #. type: textblock
13959 #: ../src/guestfs-actions.pod:3946 ../fish/guestfish-actions.pod:2705
13960 msgid ""
13961 "Where disk image(s) contain duplicate PVs or VGs, this command is useful to "
13962 "get LVM to ignore the duplicates, otherwise LVM can get confused.  Note also "
13963 "there are two types of duplication possible: either cloned PVs/VGs which "
13964 "have identical UUIDs; or VGs that are not cloned but just happen to have the "
13965 "same name.  In normal operation you cannot create this situation, but you "
13966 "can do it outside LVM, eg.  by cloning disk images or by bit twiddling "
13967 "inside the LVM metadata."
13968 msgstr ""
13969
13970 # type: textblock
13971 #. type: textblock
13972 #: ../src/guestfs-actions.pod:3959 ../fish/guestfish-actions.pod:2718
13973 msgid "You can filter whole block devices or individual partitions."
13974 msgstr ""
13975
13976 # type: textblock
13977 #. type: textblock
13978 #: ../src/guestfs-actions.pod:3961 ../fish/guestfish-actions.pod:2720
13979 msgid ""
13980 "You cannot use this if any VG is currently in use (eg.  contains a mounted "
13981 "filesystem), even if you are not filtering out that VG."
13982 msgstr ""
13983
13984 # type: =head2
13985 #. type: =head2
13986 #: ../src/guestfs-actions.pod:3969
13987 msgid "guestfs_lvremove"
13988 msgstr ""
13989
13990 # type: verbatim
13991 #. type: verbatim
13992 #: ../src/guestfs-actions.pod:3971
13993 #, no-wrap
13994 msgid ""
13995 " int\n"
13996 " guestfs_lvremove (guestfs_h *g,\n"
13997 "                   const char *device);\n"
13998 "\n"
13999 msgstr ""
14000
14001 # type: textblock
14002 #. type: textblock
14003 #: ../src/guestfs-actions.pod:3975 ../fish/guestfish-actions.pod:2728
14004 msgid ""
14005 "Remove an LVM logical volume C<device>, where C<device> is the path to the "
14006 "LV, such as C</dev/VG/LV>."
14007 msgstr ""
14008
14009 # type: textblock
14010 #. type: textblock
14011 #: ../src/guestfs-actions.pod:3978 ../fish/guestfish-actions.pod:2731
14012 msgid ""
14013 "You can also remove all LVs in a volume group by specifying the VG name, C</"
14014 "dev/VG>."
14015 msgstr ""
14016
14017 # type: textblock
14018 #. type: textblock
14019 #: ../src/guestfs-actions.pod:3983 ../src/guestfs-actions.pod:5219
14020 #: ../src/guestfs-actions.pod:7008
14021 msgid "(Added in 1.0.13)"
14022 msgstr ""
14023
14024 # type: =head2
14025 #. type: =head2
14026 #: ../src/guestfs-actions.pod:3985
14027 msgid "guestfs_lvrename"
14028 msgstr ""
14029
14030 # type: verbatim
14031 #. type: verbatim
14032 #: ../src/guestfs-actions.pod:3987
14033 #, no-wrap
14034 msgid ""
14035 " int\n"
14036 " guestfs_lvrename (guestfs_h *g,\n"
14037 "                   const char *logvol,\n"
14038 "                   const char *newlogvol);\n"
14039 "\n"
14040 msgstr ""
14041
14042 # type: textblock
14043 #. type: textblock
14044 #: ../src/guestfs-actions.pod:3992 ../fish/guestfish-actions.pod:2738
14045 msgid "Rename a logical volume C<logvol> with the new name C<newlogvol>."
14046 msgstr ""
14047
14048 # type: textblock
14049 #. type: textblock
14050 #: ../src/guestfs-actions.pod:3996 ../src/guestfs-actions.pod:7021
14051 msgid "(Added in 1.0.83)"
14052 msgstr ""
14053
14054 # type: =head2
14055 #. type: =head2
14056 #: ../src/guestfs-actions.pod:3998
14057 msgid "guestfs_lvresize"
14058 msgstr ""
14059
14060 # type: verbatim
14061 #. type: verbatim
14062 #: ../src/guestfs-actions.pod:4000
14063 #, no-wrap
14064 msgid ""
14065 " int\n"
14066 " guestfs_lvresize (guestfs_h *g,\n"
14067 "                   const char *device,\n"
14068 "                   int mbytes);\n"
14069 "\n"
14070 msgstr ""
14071
14072 # type: textblock
14073 #. type: textblock
14074 #: ../src/guestfs-actions.pod:4005 ../fish/guestfish-actions.pod:2744
14075 msgid ""
14076 "This resizes (expands or shrinks) an existing LVM logical volume to "
14077 "C<mbytes>.  When reducing, data in the reduced part is lost."
14078 msgstr ""
14079
14080 # type: =head2
14081 #. type: =head2
14082 #: ../src/guestfs-actions.pod:4013
14083 msgid "guestfs_lvresize_free"
14084 msgstr ""
14085
14086 # type: verbatim
14087 #. type: verbatim
14088 #: ../src/guestfs-actions.pod:4015
14089 #, no-wrap
14090 msgid ""
14091 " int\n"
14092 " guestfs_lvresize_free (guestfs_h *g,\n"
14093 "                        const char *lv,\n"
14094 "                        int percent);\n"
14095 "\n"
14096 msgstr ""
14097
14098 # type: textblock
14099 #. type: textblock
14100 #: ../src/guestfs-actions.pod:4020 ../fish/guestfish-actions.pod:2752
14101 msgid ""
14102 "This expands an existing logical volume C<lv> so that it fills C<pc>% of the "
14103 "remaining free space in the volume group.  Commonly you would call this with "
14104 "pc = 100 which expands the logical volume as much as possible, using all "
14105 "remaining free space in the volume group."
14106 msgstr ""
14107
14108 # type: textblock
14109 #. type: textblock
14110 #: ../src/guestfs-actions.pod:4028
14111 msgid "(Added in 1.3.3)"
14112 msgstr ""
14113
14114 # type: =head2
14115 #. type: =head2
14116 #: ../src/guestfs-actions.pod:4030
14117 msgid "guestfs_lvs"
14118 msgstr ""
14119
14120 # type: verbatim
14121 #. type: verbatim
14122 #: ../src/guestfs-actions.pod:4032
14123 #, no-wrap
14124 msgid ""
14125 " char **\n"
14126 " guestfs_lvs (guestfs_h *g);\n"
14127 "\n"
14128 msgstr ""
14129
14130 # type: textblock
14131 #. type: textblock
14132 #: ../src/guestfs-actions.pod:4035 ../fish/guestfish-actions.pod:2762
14133 msgid ""
14134 "List all the logical volumes detected.  This is the equivalent of the L<lvs"
14135 "(8)> command."
14136 msgstr ""
14137
14138 # type: textblock
14139 #. type: textblock
14140 #: ../src/guestfs-actions.pod:4038 ../fish/guestfish-actions.pod:2765
14141 msgid ""
14142 "This returns a list of the logical volume device names (eg. C</dev/"
14143 "VolGroup00/LogVol00>)."
14144 msgstr ""
14145
14146 # type: textblock
14147 #. type: textblock
14148 #: ../src/guestfs-actions.pod:4041
14149 msgid "See also C<guestfs_lvs_full>, C<guestfs_list_filesystems>."
14150 msgstr ""
14151
14152 # type: =head2
14153 #. type: =head2
14154 #: ../src/guestfs-actions.pod:4049
14155 msgid "guestfs_lvs_full"
14156 msgstr ""
14157
14158 # type: verbatim
14159 #. type: verbatim
14160 #: ../src/guestfs-actions.pod:4051
14161 #, no-wrap
14162 msgid ""
14163 " struct guestfs_lvm_lv_list *\n"
14164 " guestfs_lvs_full (guestfs_h *g);\n"
14165 "\n"
14166 msgstr ""
14167
14168 # type: textblock
14169 #. type: textblock
14170 #: ../src/guestfs-actions.pod:4054 ../fish/guestfish-actions.pod:2774
14171 msgid ""
14172 "List all the logical volumes detected.  This is the equivalent of the L<lvs"
14173 "(8)> command.  The \"full\" version includes all fields."
14174 msgstr ""
14175
14176 # type: textblock
14177 #. type: textblock
14178 #: ../src/guestfs-actions.pod:4057
14179 msgid ""
14180 "This function returns a C<struct guestfs_lvm_lv_list *>, or NULL if there "
14181 "was an error.  I<The caller must call C<guestfs_free_lvm_lv_list> after use>."
14182 msgstr ""
14183
14184 # type: =head2
14185 #. type: =head2
14186 #: ../src/guestfs-actions.pod:4063
14187 msgid "guestfs_lvuuid"
14188 msgstr ""
14189
14190 # type: verbatim
14191 #. type: verbatim
14192 #: ../src/guestfs-actions.pod:4065
14193 #, no-wrap
14194 msgid ""
14195 " char *\n"
14196 " guestfs_lvuuid (guestfs_h *g,\n"
14197 "                 const char *device);\n"
14198 "\n"
14199 msgstr ""
14200
14201 # type: textblock
14202 #. type: textblock
14203 #: ../src/guestfs-actions.pod:4069 ../fish/guestfish-actions.pod:2781
14204 msgid "This command returns the UUID of the LVM LV C<device>."
14205 msgstr ""
14206
14207 # type: =head2
14208 #. type: =head2
14209 #: ../src/guestfs-actions.pod:4076
14210 msgid "guestfs_lxattrlist"
14211 msgstr ""
14212
14213 # type: verbatim
14214 #. type: verbatim
14215 #: ../src/guestfs-actions.pod:4078
14216 #, no-wrap
14217 msgid ""
14218 " struct guestfs_xattr_list *\n"
14219 " guestfs_lxattrlist (guestfs_h *g,\n"
14220 "                     const char *path,\n"
14221 "                     char *const *names);\n"
14222 "\n"
14223 msgstr ""
14224
14225 # type: textblock
14226 #. type: textblock
14227 #: ../src/guestfs-actions.pod:4083 ../fish/guestfish-actions.pod:2787
14228 msgid ""
14229 "This call allows you to get the extended attributes of multiple files, where "
14230 "all files are in the directory C<path>.  C<names> is the list of files from "
14231 "this directory."
14232 msgstr ""
14233
14234 # type: textblock
14235 #. type: textblock
14236 #: ../src/guestfs-actions.pod:4087 ../fish/guestfish-actions.pod:2791
14237 msgid ""
14238 "On return you get a flat list of xattr structs which must be interpreted "
14239 "sequentially.  The first xattr struct always has a zero-length C<attrname>.  "
14240 "C<attrval> in this struct is zero-length to indicate there was an error "
14241 "doing C<lgetxattr> for this file, I<or> is a C string which is a decimal "
14242 "number (the number of following attributes for this file, which could be C<"
14243 "\"0\">).  Then after the first xattr struct are the zero or more attributes "
14244 "for the first named file.  This repeats for the second and subsequent files."
14245 msgstr ""
14246
14247 # type: textblock
14248 #. type: textblock
14249 #: ../src/guestfs-actions.pod:4097
14250 msgid ""
14251 "This call is intended for programs that want to efficiently list a directory "
14252 "contents without making many round-trips.  See also C<guestfs_lstatlist> for "
14253 "a similarly efficient call for getting standard stats.  Very long directory "
14254 "listings might cause the protocol message size to be exceeded, causing this "
14255 "call to fail.  The caller must split up such requests into smaller groups of "
14256 "names."
14257 msgstr ""
14258
14259 # type: =head2
14260 #. type: =head2
14261 #: ../src/guestfs-actions.pod:4111
14262 msgid "guestfs_mkdir"
14263 msgstr ""
14264
14265 # type: verbatim
14266 #. type: verbatim
14267 #: ../src/guestfs-actions.pod:4113
14268 #, no-wrap
14269 msgid ""
14270 " int\n"
14271 " guestfs_mkdir (guestfs_h *g,\n"
14272 "                const char *path);\n"
14273 "\n"
14274 msgstr ""
14275
14276 # type: textblock
14277 #. type: textblock
14278 #: ../src/guestfs-actions.pod:4117 ../fish/guestfish-actions.pod:2813
14279 msgid "Create a directory named C<path>."
14280 msgstr ""
14281
14282 # type: =head2
14283 #. type: =head2
14284 #: ../src/guestfs-actions.pod:4123
14285 msgid "guestfs_mkdir_mode"
14286 msgstr ""
14287
14288 # type: verbatim
14289 #. type: verbatim
14290 #: ../src/guestfs-actions.pod:4125
14291 #, no-wrap
14292 msgid ""
14293 " int\n"
14294 " guestfs_mkdir_mode (guestfs_h *g,\n"
14295 "                     const char *path,\n"
14296 "                     int mode);\n"
14297 "\n"
14298 msgstr ""
14299
14300 # type: textblock
14301 #. type: textblock
14302 #: ../src/guestfs-actions.pod:4130 ../fish/guestfish-actions.pod:2819
14303 msgid ""
14304 "This command creates a directory, setting the initial permissions of the "
14305 "directory to C<mode>."
14306 msgstr ""
14307
14308 # type: textblock
14309 #. type: textblock
14310 #: ../src/guestfs-actions.pod:4133 ../fish/guestfish-actions.pod:2822
14311 msgid ""
14312 "For common Linux filesystems, the actual mode which is set will be C<mode & "
14313 "~umask & 01777>.  Non-native-Linux filesystems may interpret the mode in "
14314 "other ways."
14315 msgstr ""
14316
14317 # type: textblock
14318 #. type: textblock
14319 #: ../src/guestfs-actions.pod:4137
14320 msgid "See also C<guestfs_mkdir>, C<guestfs_umask>"
14321 msgstr ""
14322
14323 # type: =head2
14324 #. type: =head2
14325 #: ../src/guestfs-actions.pod:4143
14326 msgid "guestfs_mkdir_p"
14327 msgstr ""
14328
14329 # type: verbatim
14330 #. type: verbatim
14331 #: ../src/guestfs-actions.pod:4145
14332 #, no-wrap
14333 msgid ""
14334 " int\n"
14335 " guestfs_mkdir_p (guestfs_h *g,\n"
14336 "                  const char *path);\n"
14337 "\n"
14338 msgstr ""
14339
14340 # type: textblock
14341 #. type: textblock
14342 #: ../src/guestfs-actions.pod:4149 ../fish/guestfish-actions.pod:2832
14343 msgid ""
14344 "Create a directory named C<path>, creating any parent directories as "
14345 "necessary.  This is like the C<mkdir -p> shell command."
14346 msgstr ""
14347
14348 # type: =head2
14349 #. type: =head2
14350 #: ../src/guestfs-actions.pod:4156
14351 msgid "guestfs_mkdtemp"
14352 msgstr ""
14353
14354 # type: verbatim
14355 #. type: verbatim
14356 #: ../src/guestfs-actions.pod:4158
14357 #, no-wrap
14358 msgid ""
14359 " char *\n"
14360 " guestfs_mkdtemp (guestfs_h *g,\n"
14361 "                  const char *template);\n"
14362 "\n"
14363 msgstr ""
14364
14365 # type: textblock
14366 #. type: textblock
14367 #: ../src/guestfs-actions.pod:4162 ../fish/guestfish-actions.pod:2839
14368 msgid ""
14369 "This command creates a temporary directory.  The C<template> parameter "
14370 "should be a full pathname for the temporary directory name with the final "
14371 "six characters being \"XXXXXX\"."
14372 msgstr ""
14373
14374 # type: textblock
14375 #. type: textblock
14376 #: ../src/guestfs-actions.pod:4167 ../fish/guestfish-actions.pod:2844
14377 msgid ""
14378 "For example: \"/tmp/myprogXXXXXX\" or \"/Temp/myprogXXXXXX\", the second one "
14379 "being suitable for Windows filesystems."
14380 msgstr ""
14381
14382 # type: textblock
14383 #. type: textblock
14384 #: ../src/guestfs-actions.pod:4170 ../fish/guestfish-actions.pod:2847
14385 msgid "The name of the temporary directory that was created is returned."
14386 msgstr ""
14387
14388 # type: textblock
14389 #. type: textblock
14390 #: ../src/guestfs-actions.pod:4173 ../fish/guestfish-actions.pod:2850
14391 msgid "The temporary directory is created with mode 0700 and is owned by root."
14392 msgstr ""
14393
14394 # type: textblock
14395 #. type: textblock
14396 #: ../src/guestfs-actions.pod:4176 ../fish/guestfish-actions.pod:2853
14397 msgid ""
14398 "The caller is responsible for deleting the temporary directory and its "
14399 "contents after use."
14400 msgstr ""
14401
14402 # type: textblock
14403 #. type: textblock
14404 #: ../src/guestfs-actions.pod:4179 ../fish/guestfish-actions.pod:2856
14405 msgid "See also: L<mkdtemp(3)>"
14406 msgstr ""
14407
14408 # type: =head2
14409 #. type: =head2
14410 #: ../src/guestfs-actions.pod:4186
14411 msgid "guestfs_mke2fs_J"
14412 msgstr ""
14413
14414 # type: verbatim
14415 #. type: verbatim
14416 #: ../src/guestfs-actions.pod:4188
14417 #, no-wrap
14418 msgid ""
14419 " int\n"
14420 " guestfs_mke2fs_J (guestfs_h *g,\n"
14421 "                   const char *fstype,\n"
14422 "                   int blocksize,\n"
14423 "                   const char *device,\n"
14424 "                   const char *journal);\n"
14425 "\n"
14426 msgstr ""
14427
14428 # type: textblock
14429 #. type: textblock
14430 #: ../src/guestfs-actions.pod:4195 ../fish/guestfish-actions.pod:2862
14431 msgid ""
14432 "This creates an ext2/3/4 filesystem on C<device> with an external journal on "
14433 "C<journal>.  It is equivalent to the command:"
14434 msgstr ""
14435
14436 # type: verbatim
14437 #. type: verbatim
14438 #: ../src/guestfs-actions.pod:4199 ../fish/guestfish-actions.pod:2866
14439 #, no-wrap
14440 msgid ""
14441 " mke2fs -t fstype -b blocksize -J device=<journal> <device>\n"
14442 "\n"
14443 msgstr ""
14444
14445 # type: textblock
14446 #. type: textblock
14447 #: ../src/guestfs-actions.pod:4201
14448 msgid "See also C<guestfs_mke2journal>."
14449 msgstr ""
14450
14451 # type: textblock
14452 #. type: textblock
14453 #: ../src/guestfs-actions.pod:4205 ../src/guestfs-actions.pod:4223
14454 #: ../src/guestfs-actions.pod:4241 ../src/guestfs-actions.pod:4257
14455 #: ../src/guestfs-actions.pod:4271 ../src/guestfs-actions.pod:4285
14456 #: ../src/guestfs-actions.pod:4344 ../src/guestfs-actions.pod:4609
14457 msgid "(Added in 1.0.68)"
14458 msgstr ""
14459
14460 # type: =head2
14461 #. type: =head2
14462 #: ../src/guestfs-actions.pod:4207
14463 msgid "guestfs_mke2fs_JL"
14464 msgstr ""
14465
14466 # type: verbatim
14467 #. type: verbatim
14468 #: ../src/guestfs-actions.pod:4209
14469 #, no-wrap
14470 msgid ""
14471 " int\n"
14472 " guestfs_mke2fs_JL (guestfs_h *g,\n"
14473 "                    const char *fstype,\n"
14474 "                    int blocksize,\n"
14475 "                    const char *device,\n"
14476 "                    const char *label);\n"
14477 "\n"
14478 msgstr ""
14479
14480 # type: textblock
14481 #. type: textblock
14482 #: ../src/guestfs-actions.pod:4216 ../fish/guestfish-actions.pod:2874
14483 msgid ""
14484 "This creates an ext2/3/4 filesystem on C<device> with an external journal on "
14485 "the journal labeled C<label>."
14486 msgstr ""
14487
14488 # type: textblock
14489 #. type: textblock
14490 #: ../src/guestfs-actions.pod:4219
14491 msgid "See also C<guestfs_mke2journal_L>."
14492 msgstr ""
14493
14494 # type: =head2
14495 #. type: =head2
14496 #: ../src/guestfs-actions.pod:4225
14497 msgid "guestfs_mke2fs_JU"
14498 msgstr ""
14499
14500 # type: verbatim
14501 #. type: verbatim
14502 #: ../src/guestfs-actions.pod:4227
14503 #, no-wrap
14504 msgid ""
14505 " int\n"
14506 " guestfs_mke2fs_JU (guestfs_h *g,\n"
14507 "                    const char *fstype,\n"
14508 "                    int blocksize,\n"
14509 "                    const char *device,\n"
14510 "                    const char *uuid);\n"
14511 "\n"
14512 msgstr ""
14513
14514 # type: textblock
14515 #. type: textblock
14516 #: ../src/guestfs-actions.pod:4234 ../fish/guestfish-actions.pod:2883
14517 msgid ""
14518 "This creates an ext2/3/4 filesystem on C<device> with an external journal on "
14519 "the journal with UUID C<uuid>."
14520 msgstr ""
14521
14522 # type: textblock
14523 #. type: textblock
14524 #: ../src/guestfs-actions.pod:4237
14525 msgid "See also C<guestfs_mke2journal_U>."
14526 msgstr ""
14527
14528 # type: =head2
14529 #. type: =head2
14530 #: ../src/guestfs-actions.pod:4243
14531 msgid "guestfs_mke2journal"
14532 msgstr ""
14533
14534 # type: verbatim
14535 #. type: verbatim
14536 #: ../src/guestfs-actions.pod:4245
14537 #, no-wrap
14538 msgid ""
14539 " int\n"
14540 " guestfs_mke2journal (guestfs_h *g,\n"
14541 "                      int blocksize,\n"
14542 "                      const char *device);\n"
14543 "\n"
14544 msgstr ""
14545
14546 # type: textblock
14547 #. type: textblock
14548 #: ../src/guestfs-actions.pod:4250 ../fish/guestfish-actions.pod:2892
14549 msgid ""
14550 "This creates an ext2 external journal on C<device>.  It is equivalent to the "
14551 "command:"
14552 msgstr ""
14553
14554 # type: verbatim
14555 #. type: verbatim
14556 #: ../src/guestfs-actions.pod:4253 ../fish/guestfish-actions.pod:2895
14557 #, no-wrap
14558 msgid ""
14559 " mke2fs -O journal_dev -b blocksize device\n"
14560 "\n"
14561 msgstr ""
14562
14563 # type: =head2
14564 #. type: =head2
14565 #: ../src/guestfs-actions.pod:4259
14566 msgid "guestfs_mke2journal_L"
14567 msgstr ""
14568
14569 # type: verbatim
14570 #. type: verbatim
14571 #: ../src/guestfs-actions.pod:4261
14572 #, no-wrap
14573 msgid ""
14574 " int\n"
14575 " guestfs_mke2journal_L (guestfs_h *g,\n"
14576 "                        int blocksize,\n"
14577 "                        const char *label,\n"
14578 "                        const char *device);\n"
14579 "\n"
14580 msgstr ""
14581
14582 # type: textblock
14583 #. type: textblock
14584 #: ../src/guestfs-actions.pod:4267 ../fish/guestfish-actions.pod:2901
14585 msgid "This creates an ext2 external journal on C<device> with label C<label>."
14586 msgstr ""
14587
14588 # type: =head2
14589 #. type: =head2
14590 #: ../src/guestfs-actions.pod:4273
14591 msgid "guestfs_mke2journal_U"
14592 msgstr ""
14593
14594 # type: verbatim
14595 #. type: verbatim
14596 #: ../src/guestfs-actions.pod:4275
14597 #, no-wrap
14598 msgid ""
14599 " int\n"
14600 " guestfs_mke2journal_U (guestfs_h *g,\n"
14601 "                        int blocksize,\n"
14602 "                        const char *uuid,\n"
14603 "                        const char *device);\n"
14604 "\n"
14605 msgstr ""
14606
14607 # type: textblock
14608 #. type: textblock
14609 #: ../src/guestfs-actions.pod:4281 ../fish/guestfish-actions.pod:2907
14610 msgid "This creates an ext2 external journal on C<device> with UUID C<uuid>."
14611 msgstr ""
14612
14613 # type: =head2
14614 #. type: =head2
14615 #: ../src/guestfs-actions.pod:4287
14616 msgid "guestfs_mkfifo"
14617 msgstr ""
14618
14619 # type: verbatim
14620 #. type: verbatim
14621 #: ../src/guestfs-actions.pod:4289
14622 #, no-wrap
14623 msgid ""
14624 " int\n"
14625 " guestfs_mkfifo (guestfs_h *g,\n"
14626 "                 int mode,\n"
14627 "                 const char *path);\n"
14628 "\n"
14629 msgstr ""
14630
14631 # type: textblock
14632 #. type: textblock
14633 #: ../src/guestfs-actions.pod:4294
14634 msgid ""
14635 "This call creates a FIFO (named pipe) called C<path> with mode C<mode>.  It "
14636 "is just a convenient wrapper around C<guestfs_mknod>."
14637 msgstr ""
14638
14639 # type: =head2
14640 #. type: =head2
14641 #: ../src/guestfs-actions.pod:4304
14642 msgid "guestfs_mkfs"
14643 msgstr ""
14644
14645 # type: verbatim
14646 #. type: verbatim
14647 #: ../src/guestfs-actions.pod:4306
14648 #, no-wrap
14649 msgid ""
14650 " int\n"
14651 " guestfs_mkfs (guestfs_h *g,\n"
14652 "               const char *fstype,\n"
14653 "               const char *device);\n"
14654 "\n"
14655 msgstr ""
14656
14657 # type: textblock
14658 #. type: textblock
14659 #: ../src/guestfs-actions.pod:4311 ../fish/guestfish-actions.pod:2923
14660 msgid ""
14661 "This creates a filesystem on C<device> (usually a partition or LVM logical "
14662 "volume).  The filesystem type is C<fstype>, for example C<ext3>."
14663 msgstr ""
14664
14665 # type: =head2
14666 #. type: =head2
14667 #: ../src/guestfs-actions.pod:4319
14668 msgid "guestfs_mkfs_b"
14669 msgstr ""
14670
14671 # type: verbatim
14672 #. type: verbatim
14673 #: ../src/guestfs-actions.pod:4321
14674 #, no-wrap
14675 msgid ""
14676 " int\n"
14677 " guestfs_mkfs_b (guestfs_h *g,\n"
14678 "                 const char *fstype,\n"
14679 "                 int blocksize,\n"
14680 "                 const char *device);\n"
14681 "\n"
14682 msgstr ""
14683
14684 # type: textblock
14685 #. type: textblock
14686 #: ../src/guestfs-actions.pod:4327
14687 msgid ""
14688 "This call is similar to C<guestfs_mkfs>, but it allows you to control the "
14689 "block size of the resulting filesystem.  Supported block sizes depend on the "
14690 "filesystem type, but typically they are C<1024>, C<2048> or C<4096> only."
14691 msgstr ""
14692
14693 # type: textblock
14694 #. type: textblock
14695 #: ../src/guestfs-actions.pod:4332 ../src/guestfs-actions.pod:4375
14696 #: ../fish/guestfish-actions.pod:2936 ../fish/guestfish-actions.pod:2963
14697 msgid ""
14698 "For VFAT and NTFS the C<blocksize> parameter is treated as the requested "
14699 "cluster size."
14700 msgstr ""
14701
14702 # type: textblock
14703 #. type: textblock
14704 #: ../src/guestfs-actions.pod:4337 ../fish/guestfish-actions.pod:2939
14705 msgid ""
14706 "This function is deprecated.  In new code, use the C<mkfs_opts> call instead."
14707 msgstr ""
14708
14709 # type: =head2
14710 #. type: =head2
14711 #: ../src/guestfs-actions.pod:4346
14712 msgid "guestfs_mkfs_opts"
14713 msgstr ""
14714
14715 # type: verbatim
14716 #. type: verbatim
14717 #: ../src/guestfs-actions.pod:4348
14718 #, no-wrap
14719 msgid ""
14720 " int\n"
14721 " guestfs_mkfs_opts (guestfs_h *g,\n"
14722 "                    const char *fstype,\n"
14723 "                    const char *device,\n"
14724 "                    ...);\n"
14725 "\n"
14726 msgstr ""
14727
14728 #. type: verbatim
14729 #: ../src/guestfs-actions.pod:4359
14730 #, no-wrap
14731 msgid ""
14732 " GUESTFS_MKFS_OPTS_BLOCKSIZE, int blocksize,\n"
14733 " GUESTFS_MKFS_OPTS_FEATURES, const char *features,\n"
14734 "\n"
14735 msgstr ""
14736
14737 # type: textblock
14738 #. type: textblock
14739 #: ../src/guestfs-actions.pod:4362 ../fish/guestfish-actions.pod:2950
14740 msgid ""
14741 "This function creates a filesystem on C<device>.  The filesystem type is "
14742 "C<fstype>, for example C<ext3>."
14743 msgstr ""
14744
14745 # type: =item
14746 #. type: =item
14747 #: ../src/guestfs-actions.pod:4369 ../fish/guestfish-actions.pod:2957
14748 msgid "C<blocksize>"
14749 msgstr ""
14750
14751 # type: textblock
14752 #. type: textblock
14753 #: ../src/guestfs-actions.pod:4371 ../fish/guestfish-actions.pod:2959
14754 msgid ""
14755 "The filesystem block size.  Supported block sizes depend on the filesystem "
14756 "type, but typically they are C<1024>, C<2048> or C<4096> for Linux ext2/3 "
14757 "filesystems."
14758 msgstr ""
14759
14760 #. type: textblock
14761 #: ../src/guestfs-actions.pod:4378 ../fish/guestfish-actions.pod:2966
14762 msgid "For UFS block sizes, please see L<mkfs.ufs(8)>."
14763 msgstr ""
14764
14765 #. type: =item
14766 #: ../src/guestfs-actions.pod:4380 ../fish/guestfish-actions.pod:2968
14767 msgid "C<features>"
14768 msgstr ""
14769
14770 #. type: textblock
14771 #: ../src/guestfs-actions.pod:4382 ../fish/guestfish-actions.pod:2970
14772 msgid "This passes the C<-O> parameter to the external mkfs program."
14773 msgstr ""
14774
14775 #. type: textblock
14776 #: ../src/guestfs-actions.pod:4384 ../fish/guestfish-actions.pod:2972
14777 msgid ""
14778 "For certain filesystem types, this allows extra filesystem features to be "
14779 "selected.  See L<mke2fs(8)> and L<mkfs.ufs(8)> for more details."
14780 msgstr ""
14781
14782 #. type: textblock
14783 #: ../src/guestfs-actions.pod:4388 ../fish/guestfish-actions.pod:2976
14784 msgid ""
14785 "You cannot use this optional parameter with the C<gfs> or C<gfs2> filesystem "
14786 "type."
14787 msgstr ""
14788
14789 #. type: textblock
14790 #: ../src/guestfs-actions.pod:4395
14791 msgid "(Added in 1.7.19)"
14792 msgstr ""
14793
14794 # type: =head2
14795 #. type: =head2
14796 #: ../src/guestfs-actions.pod:4397
14797 msgid "guestfs_mkfs_opts_va"
14798 msgstr ""
14799
14800 # type: verbatim
14801 #. type: verbatim
14802 #: ../src/guestfs-actions.pod:4399
14803 #, no-wrap
14804 msgid ""
14805 " int\n"
14806 " guestfs_mkfs_opts_va (guestfs_h *g,\n"
14807 "                       const char *fstype,\n"
14808 "                       const char *device,\n"
14809 "                       va_list args);\n"
14810 "\n"
14811 msgstr ""
14812
14813 # type: textblock
14814 #. type: textblock
14815 #: ../src/guestfs-actions.pod:4405
14816 msgid "This is the \"va_list variant\" of L</guestfs_mkfs_opts>."
14817 msgstr ""
14818
14819 # type: =head2
14820 #. type: =head2
14821 #: ../src/guestfs-actions.pod:4409
14822 msgid "guestfs_mkfs_opts_argv"
14823 msgstr ""
14824
14825 # type: verbatim
14826 #. type: verbatim
14827 #: ../src/guestfs-actions.pod:4411
14828 #, no-wrap
14829 msgid ""
14830 " int\n"
14831 " guestfs_mkfs_opts_argv (guestfs_h *g,\n"
14832 "                         const char *fstype,\n"
14833 "                         const char *device,\n"
14834 "                         const struct guestfs_mkfs_opts_argv *optargs);\n"
14835 "\n"
14836 msgstr ""
14837
14838 # type: textblock
14839 #. type: textblock
14840 #: ../src/guestfs-actions.pod:4417
14841 msgid "This is the \"argv variant\" of L</guestfs_mkfs_opts>."
14842 msgstr ""
14843
14844 # type: =head2
14845 #. type: =head2
14846 #: ../src/guestfs-actions.pod:4421
14847 msgid "guestfs_mkmountpoint"
14848 msgstr ""
14849
14850 # type: verbatim
14851 #. type: verbatim
14852 #: ../src/guestfs-actions.pod:4423
14853 #, no-wrap
14854 msgid ""
14855 " int\n"
14856 " guestfs_mkmountpoint (guestfs_h *g,\n"
14857 "                       const char *exemptpath);\n"
14858 "\n"
14859 msgstr ""
14860
14861 # type: textblock
14862 #. type: textblock
14863 #: ../src/guestfs-actions.pod:4427
14864 msgid ""
14865 "C<guestfs_mkmountpoint> and C<guestfs_rmmountpoint> are specialized calls "
14866 "that can be used to create extra mountpoints before mounting the first "
14867 "filesystem."
14868 msgstr ""
14869
14870 # type: textblock
14871 #. type: textblock
14872 #: ../src/guestfs-actions.pod:4431 ../fish/guestfish-actions.pod:2991
14873 msgid ""
14874 "These calls are I<only> necessary in some very limited circumstances, mainly "
14875 "the case where you want to mount a mix of unrelated and/or read-only "
14876 "filesystems together."
14877 msgstr ""
14878
14879 # type: textblock
14880 #. type: textblock
14881 #: ../src/guestfs-actions.pod:4435 ../fish/guestfish-actions.pod:2995
14882 msgid ""
14883 "For example, live CDs often contain a \"Russian doll\" nest of filesystems, "
14884 "an ISO outer layer, with a squashfs image inside, with an ext2/3 image "
14885 "inside that.  You can unpack this as follows in guestfish:"
14886 msgstr ""
14887
14888 # type: verbatim
14889 #. type: verbatim
14890 #: ../src/guestfs-actions.pod:4440 ../fish/guestfish-actions.pod:3000
14891 #, no-wrap
14892 msgid ""
14893 " add-ro Fedora-11-i686-Live.iso\n"
14894 " run\n"
14895 " mkmountpoint /cd\n"
14896 " mkmountpoint /sqsh\n"
14897 " mkmountpoint /ext3fs\n"
14898 " mount /dev/sda /cd\n"
14899 " mount-loop /cd/LiveOS/squashfs.img /sqsh\n"
14900 " mount-loop /sqsh/LiveOS/ext3fs.img /ext3fs\n"
14901 "\n"
14902 msgstr ""
14903
14904 # type: textblock
14905 #. type: textblock
14906 #: ../src/guestfs-actions.pod:4449 ../fish/guestfish-actions.pod:3009
14907 msgid "The inner filesystem is now unpacked under the /ext3fs mountpoint."
14908 msgstr ""
14909
14910 # type: textblock
14911 #. type: textblock
14912 #: ../src/guestfs-actions.pod:4451
14913 msgid ""
14914 "C<guestfs_mkmountpoint> is not compatible with C<guestfs_umount_all>.  You "
14915 "may get unexpected errors if you try to mix these calls.  It is safest to "
14916 "manually unmount filesystems and remove mountpoints after use."
14917 msgstr ""
14918
14919 # type: textblock
14920 #. type: textblock
14921 #: ../src/guestfs-actions.pod:4455
14922 msgid ""
14923 "C<guestfs_umount_all> unmounts filesystems by sorting the paths longest "
14924 "first, so for this to work for manual mountpoints, you must ensure that the "
14925 "innermost mountpoints have the longest pathnames, as in the example code "
14926 "above."
14927 msgstr ""
14928
14929 # type: textblock
14930 #. type: textblock
14931 #: ../src/guestfs-actions.pod:4460 ../fish/guestfish-actions.pod:3020
14932 msgid ""
14933 "For more details see L<https://bugzilla.redhat.com/show_bug.cgi?id=599503>"
14934 msgstr ""
14935
14936 #. type: textblock
14937 #: ../src/guestfs-actions.pod:4462
14938 msgid ""
14939 "Autosync [see C<guestfs_set_autosync>, this is set by default on handles] "
14940 "can cause C<guestfs_umount_all> to be called when the handle is closed which "
14941 "can also trigger these issues."
14942 msgstr ""
14943
14944 # type: textblock
14945 #. type: textblock
14946 #: ../src/guestfs-actions.pod:4468 ../src/guestfs-actions.pod:4727
14947 #: ../src/guestfs-actions.pod:5637
14948 msgid "(Added in 1.0.62)"
14949 msgstr ""
14950
14951 # type: =head2
14952 #. type: =head2
14953 #: ../src/guestfs-actions.pod:4470
14954 msgid "guestfs_mknod"
14955 msgstr ""
14956
14957 # type: verbatim
14958 #. type: verbatim
14959 #: ../src/guestfs-actions.pod:4472
14960 #, no-wrap
14961 msgid ""
14962 " int\n"
14963 " guestfs_mknod (guestfs_h *g,\n"
14964 "                int mode,\n"
14965 "                int devmajor,\n"
14966 "                int devminor,\n"
14967 "                const char *path);\n"
14968 "\n"
14969 msgstr ""
14970
14971 # type: textblock
14972 #. type: textblock
14973 #: ../src/guestfs-actions.pod:4479 ../fish/guestfish-actions.pod:3030
14974 msgid ""
14975 "This call creates block or character special devices, or named pipes (FIFOs)."
14976 msgstr ""
14977
14978 # type: textblock
14979 #. type: textblock
14980 #: ../src/guestfs-actions.pod:4482 ../fish/guestfish-actions.pod:3033
14981 msgid ""
14982 "The C<mode> parameter should be the mode, using the standard constants.  "
14983 "C<devmajor> and C<devminor> are the device major and minor numbers, only "
14984 "used when creating block and character special devices."
14985 msgstr ""
14986
14987 # type: textblock
14988 #. type: textblock
14989 #: ../src/guestfs-actions.pod:4487
14990 msgid ""
14991 "Note that, just like L<mknod(2)>, the mode must be bitwise OR'd with "
14992 "S_IFBLK, S_IFCHR, S_IFIFO or S_IFSOCK (otherwise this call just creates a "
14993 "regular file).  These constants are available in the standard Linux header "
14994 "files, or you can use C<guestfs_mknod_b>, C<guestfs_mknod_c> or "
14995 "C<guestfs_mkfifo> which are wrappers around this command which bitwise OR in "
14996 "the appropriate constant for you."
14997 msgstr ""
14998
14999 # type: =head2
15000 #. type: =head2
15001 #: ../src/guestfs-actions.pod:4501
15002 msgid "guestfs_mknod_b"
15003 msgstr ""
15004
15005 # type: verbatim
15006 #. type: verbatim
15007 #: ../src/guestfs-actions.pod:4503
15008 #, no-wrap
15009 msgid ""
15010 " int\n"
15011 " guestfs_mknod_b (guestfs_h *g,\n"
15012 "                  int mode,\n"
15013 "                  int devmajor,\n"
15014 "                  int devminor,\n"
15015 "                  const char *path);\n"
15016 "\n"
15017 msgstr ""
15018
15019 # type: textblock
15020 #. type: textblock
15021 #: ../src/guestfs-actions.pod:4510
15022 msgid ""
15023 "This call creates a block device node called C<path> with mode C<mode> and "
15024 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
15025 "wrapper around C<guestfs_mknod>."
15026 msgstr ""
15027
15028 # type: =head2
15029 #. type: =head2
15030 #: ../src/guestfs-actions.pod:4520
15031 msgid "guestfs_mknod_c"
15032 msgstr ""
15033
15034 # type: verbatim
15035 #. type: verbatim
15036 #: ../src/guestfs-actions.pod:4522
15037 #, no-wrap
15038 msgid ""
15039 " int\n"
15040 " guestfs_mknod_c (guestfs_h *g,\n"
15041 "                  int mode,\n"
15042 "                  int devmajor,\n"
15043 "                  int devminor,\n"
15044 "                  const char *path);\n"
15045 "\n"
15046 msgstr ""
15047
15048 # type: textblock
15049 #. type: textblock
15050 #: ../src/guestfs-actions.pod:4529
15051 msgid ""
15052 "This call creates a char device node called C<path> with mode C<mode> and "
15053 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
15054 "wrapper around C<guestfs_mknod>."
15055 msgstr ""
15056
15057 # type: =head2
15058 #. type: =head2
15059 #: ../src/guestfs-actions.pod:4539
15060 msgid "guestfs_mkswap"
15061 msgstr ""
15062
15063 # type: verbatim
15064 #. type: verbatim
15065 #: ../src/guestfs-actions.pod:4541
15066 #, no-wrap
15067 msgid ""
15068 " int\n"
15069 " guestfs_mkswap (guestfs_h *g,\n"
15070 "                 const char *device);\n"
15071 "\n"
15072 msgstr ""
15073
15074 # type: textblock
15075 #. type: textblock
15076 #: ../src/guestfs-actions.pod:4545 ../fish/guestfish-actions.pod:3072
15077 msgid "Create a swap partition on C<device>."
15078 msgstr ""
15079
15080 # type: =head2
15081 #. type: =head2
15082 #: ../src/guestfs-actions.pod:4551
15083 msgid "guestfs_mkswap_L"
15084 msgstr ""
15085
15086 # type: verbatim
15087 #. type: verbatim
15088 #: ../src/guestfs-actions.pod:4553
15089 #, no-wrap
15090 msgid ""
15091 " int\n"
15092 " guestfs_mkswap_L (guestfs_h *g,\n"
15093 "                   const char *label,\n"
15094 "                   const char *device);\n"
15095 "\n"
15096 msgstr ""
15097
15098 # type: textblock
15099 #. type: textblock
15100 #: ../src/guestfs-actions.pod:4558 ../fish/guestfish-actions.pod:3078
15101 msgid "Create a swap partition on C<device> with label C<label>."
15102 msgstr ""
15103
15104 # type: textblock
15105 #. type: textblock
15106 #: ../src/guestfs-actions.pod:4560 ../fish/guestfish-actions.pod:3080
15107 msgid ""
15108 "Note that you cannot attach a swap label to a block device (eg. C</dev/"
15109 "sda>), just to a partition.  This appears to be a limitation of the kernel "
15110 "or swap tools."
15111 msgstr ""
15112
15113 # type: =head2
15114 #. type: =head2
15115 #: ../src/guestfs-actions.pod:4568
15116 msgid "guestfs_mkswap_U"
15117 msgstr ""
15118
15119 # type: verbatim
15120 #. type: verbatim
15121 #: ../src/guestfs-actions.pod:4570
15122 #, no-wrap
15123 msgid ""
15124 " int\n"
15125 " guestfs_mkswap_U (guestfs_h *g,\n"
15126 "                   const char *uuid,\n"
15127 "                   const char *device);\n"
15128 "\n"
15129 msgstr ""
15130
15131 # type: textblock
15132 #. type: textblock
15133 #: ../src/guestfs-actions.pod:4575 ../fish/guestfish-actions.pod:3088
15134 msgid "Create a swap partition on C<device> with UUID C<uuid>."
15135 msgstr ""
15136
15137 # type: =head2
15138 #. type: =head2
15139 #: ../src/guestfs-actions.pod:4581
15140 msgid "guestfs_mkswap_file"
15141 msgstr ""
15142
15143 # type: verbatim
15144 #. type: verbatim
15145 #: ../src/guestfs-actions.pod:4583
15146 #, no-wrap
15147 msgid ""
15148 " int\n"
15149 " guestfs_mkswap_file (guestfs_h *g,\n"
15150 "                      const char *path);\n"
15151 "\n"
15152 msgstr ""
15153
15154 # type: textblock
15155 #. type: textblock
15156 #: ../src/guestfs-actions.pod:4587 ../fish/guestfish-actions.pod:3094
15157 msgid "Create a swap file."
15158 msgstr ""
15159
15160 # type: textblock
15161 #. type: textblock
15162 #: ../src/guestfs-actions.pod:4589
15163 msgid ""
15164 "This command just writes a swap file signature to an existing file.  To "
15165 "create the file itself, use something like C<guestfs_fallocate>."
15166 msgstr ""
15167
15168 # type: =head2
15169 #. type: =head2
15170 #: ../src/guestfs-actions.pod:4596
15171 msgid "guestfs_modprobe"
15172 msgstr ""
15173
15174 # type: verbatim
15175 #. type: verbatim
15176 #: ../src/guestfs-actions.pod:4598
15177 #, no-wrap
15178 msgid ""
15179 " int\n"
15180 " guestfs_modprobe (guestfs_h *g,\n"
15181 "                   const char *modulename);\n"
15182 "\n"
15183 msgstr ""
15184
15185 # type: textblock
15186 #. type: textblock
15187 #: ../src/guestfs-actions.pod:4602 ../fish/guestfish-actions.pod:3103
15188 msgid "This loads a kernel module in the appliance."
15189 msgstr ""
15190
15191 # type: textblock
15192 #. type: textblock
15193 #: ../src/guestfs-actions.pod:4604 ../fish/guestfish-actions.pod:3105
15194 msgid ""
15195 "The kernel module must have been whitelisted when libguestfs was built (see "
15196 "C<appliance/kmod.whitelist.in> in the source)."
15197 msgstr ""
15198
15199 # type: =head2
15200 #. type: =head2
15201 #: ../src/guestfs-actions.pod:4611
15202 msgid "guestfs_mount"
15203 msgstr ""
15204
15205 # type: verbatim
15206 #. type: verbatim
15207 #: ../src/guestfs-actions.pod:4613
15208 #, no-wrap
15209 msgid ""
15210 " int\n"
15211 " guestfs_mount (guestfs_h *g,\n"
15212 "                const char *device,\n"
15213 "                const char *mountpoint);\n"
15214 "\n"
15215 msgstr ""
15216
15217 # type: textblock
15218 #. type: textblock
15219 #: ../src/guestfs-actions.pod:4618 ../fish/guestfish-actions.pod:3112
15220 msgid ""
15221 "Mount a guest disk at a position in the filesystem.  Block devices are named "
15222 "C</dev/sda>, C</dev/sdb> and so on, as they were added to the guest.  If "
15223 "those block devices contain partitions, they will have the usual names (eg. "
15224 "C</dev/sda1>).  Also LVM C</dev/VG/LV>-style names can be used."
15225 msgstr ""
15226
15227 # type: textblock
15228 #. type: textblock
15229 #: ../src/guestfs-actions.pod:4624 ../fish/guestfish-actions.pod:3118
15230 msgid ""
15231 "The rules are the same as for L<mount(2)>: A filesystem must first be "
15232 "mounted on C</> before others can be mounted.  Other filesystems can only be "
15233 "mounted on directories which already exist."
15234 msgstr ""
15235
15236 # type: textblock
15237 #. type: textblock
15238 #: ../src/guestfs-actions.pod:4629 ../fish/guestfish-actions.pod:3123
15239 msgid ""
15240 "The mounted filesystem is writable, if we have sufficient permissions on the "
15241 "underlying device."
15242 msgstr ""
15243
15244 # type: textblock
15245 #. type: textblock
15246 #: ../src/guestfs-actions.pod:4632
15247 msgid ""
15248 "B<Important note:> When you use this call, the filesystem options C<sync> "
15249 "and C<noatime> are set implicitly.  This was originally done because we "
15250 "thought it would improve reliability, but it turns out that I<-o sync> has a "
15251 "very large negative performance impact and negligible effect on "
15252 "reliability.  Therefore we recommend that you avoid using C<guestfs_mount> "
15253 "in any code that needs performance, and instead use C<guestfs_mount_options> "
15254 "(use an empty string for the first parameter if you don't want any options)."
15255 msgstr ""
15256
15257 # type: =head2
15258 #. type: =head2
15259 #: ../src/guestfs-actions.pod:4646
15260 msgid "guestfs_mount_loop"
15261 msgstr ""
15262
15263 # type: verbatim
15264 #. type: verbatim
15265 #: ../src/guestfs-actions.pod:4648
15266 #, no-wrap
15267 msgid ""
15268 " int\n"
15269 " guestfs_mount_loop (guestfs_h *g,\n"
15270 "                     const char *file,\n"
15271 "                     const char *mountpoint);\n"
15272 "\n"
15273 msgstr ""
15274
15275 # type: textblock
15276 #. type: textblock
15277 #: ../src/guestfs-actions.pod:4653 ../fish/guestfish-actions.pod:3140
15278 msgid ""
15279 "This command lets you mount C<file> (a filesystem image in a file) on a "
15280 "mount point.  It is entirely equivalent to the command C<mount -o loop file "
15281 "mountpoint>."
15282 msgstr ""
15283
15284 # type: =head2
15285 #. type: =head2
15286 #: ../src/guestfs-actions.pod:4661
15287 msgid "guestfs_mount_options"
15288 msgstr ""
15289
15290 # type: verbatim
15291 #. type: verbatim
15292 #: ../src/guestfs-actions.pod:4663
15293 #, no-wrap
15294 msgid ""
15295 " int\n"
15296 " guestfs_mount_options (guestfs_h *g,\n"
15297 "                        const char *options,\n"
15298 "                        const char *device,\n"
15299 "                        const char *mountpoint);\n"
15300 "\n"
15301 msgstr ""
15302
15303 # type: textblock
15304 #. type: textblock
15305 #: ../src/guestfs-actions.pod:4669
15306 msgid ""
15307 "This is the same as the C<guestfs_mount> command, but it allows you to set "
15308 "the mount options as for the L<mount(8)> I<-o> flag."
15309 msgstr ""
15310
15311 # type: textblock
15312 #. type: textblock
15313 #: ../src/guestfs-actions.pod:4673 ../fish/guestfish-actions.pod:3152
15314 msgid ""
15315 "If the C<options> parameter is an empty string, then no options are passed "
15316 "(all options default to whatever the filesystem uses)."
15317 msgstr ""
15318
15319 # type: textblock
15320 #. type: textblock
15321 #: ../src/guestfs-actions.pod:4679 ../src/guestfs-actions.pod:4693
15322 #: ../src/guestfs-actions.pod:4710
15323 msgid "(Added in 1.0.10)"
15324 msgstr ""
15325
15326 # type: =head2
15327 #. type: =head2
15328 #: ../src/guestfs-actions.pod:4681
15329 msgid "guestfs_mount_ro"
15330 msgstr ""
15331
15332 # type: verbatim
15333 #. type: verbatim
15334 #: ../src/guestfs-actions.pod:4683
15335 #, no-wrap
15336 msgid ""
15337 " int\n"
15338 " guestfs_mount_ro (guestfs_h *g,\n"
15339 "                   const char *device,\n"
15340 "                   const char *mountpoint);\n"
15341 "\n"
15342 msgstr ""
15343
15344 # type: textblock
15345 #. type: textblock
15346 #: ../src/guestfs-actions.pod:4688
15347 msgid ""
15348 "This is the same as the C<guestfs_mount> command, but it mounts the "
15349 "filesystem with the read-only (I<-o ro>) flag."
15350 msgstr ""
15351
15352 # type: =head2
15353 #. type: =head2
15354 #: ../src/guestfs-actions.pod:4695
15355 msgid "guestfs_mount_vfs"
15356 msgstr ""
15357
15358 # type: verbatim
15359 #. type: verbatim
15360 #: ../src/guestfs-actions.pod:4697
15361 #, no-wrap
15362 msgid ""
15363 " int\n"
15364 " guestfs_mount_vfs (guestfs_h *g,\n"
15365 "                    const char *options,\n"
15366 "                    const char *vfstype,\n"
15367 "                    const char *device,\n"
15368 "                    const char *mountpoint);\n"
15369 "\n"
15370 msgstr ""
15371
15372 # type: textblock
15373 #. type: textblock
15374 #: ../src/guestfs-actions.pod:4704
15375 msgid ""
15376 "This is the same as the C<guestfs_mount> command, but it allows you to set "
15377 "both the mount options and the vfstype as for the L<mount(8)> I<-o> and I<-"
15378 "t> flags."
15379 msgstr ""
15380
15381 # type: =head2
15382 #. type: =head2
15383 #: ../src/guestfs-actions.pod:4712
15384 msgid "guestfs_mountpoints"
15385 msgstr ""
15386
15387 # type: verbatim
15388 #. type: verbatim
15389 #: ../src/guestfs-actions.pod:4714
15390 #, no-wrap
15391 msgid ""
15392 " char **\n"
15393 " guestfs_mountpoints (guestfs_h *g);\n"
15394 "\n"
15395 msgstr ""
15396
15397 # type: textblock
15398 #. type: textblock
15399 #: ../src/guestfs-actions.pod:4717
15400 msgid ""
15401 "This call is similar to C<guestfs_mounts>.  That call returns a list of "
15402 "devices.  This one returns a hash table (map) of device name to directory "
15403 "where the device is mounted."
15404 msgstr ""
15405
15406 # type: =head2
15407 #. type: =head2
15408 #: ../src/guestfs-actions.pod:4729
15409 msgid "guestfs_mounts"
15410 msgstr ""
15411
15412 # type: verbatim
15413 #. type: verbatim
15414 #: ../src/guestfs-actions.pod:4731
15415 #, no-wrap
15416 msgid ""
15417 " char **\n"
15418 " guestfs_mounts (guestfs_h *g);\n"
15419 "\n"
15420 msgstr ""
15421
15422 # type: textblock
15423 #. type: textblock
15424 #: ../src/guestfs-actions.pod:4734 ../fish/guestfish-actions.pod:3183
15425 msgid ""
15426 "This returns the list of currently mounted filesystems.  It returns the list "
15427 "of devices (eg. C</dev/sda1>, C</dev/VG/LV>)."
15428 msgstr ""
15429
15430 # type: textblock
15431 #. type: textblock
15432 #: ../src/guestfs-actions.pod:4737 ../fish/guestfish-actions.pod:3186
15433 msgid "Some internal mounts are not shown."
15434 msgstr ""
15435
15436 # type: textblock
15437 #. type: textblock
15438 #: ../src/guestfs-actions.pod:4739
15439 msgid "See also: C<guestfs_mountpoints>"
15440 msgstr ""
15441
15442 # type: =head2
15443 #. type: =head2
15444 #: ../src/guestfs-actions.pod:4747
15445 msgid "guestfs_mv"
15446 msgstr ""
15447
15448 # type: verbatim
15449 #. type: verbatim
15450 #: ../src/guestfs-actions.pod:4749
15451 #, no-wrap
15452 msgid ""
15453 " int\n"
15454 " guestfs_mv (guestfs_h *g,\n"
15455 "             const char *src,\n"
15456 "             const char *dest);\n"
15457 "\n"
15458 msgstr ""
15459
15460 # type: textblock
15461 #. type: textblock
15462 #: ../src/guestfs-actions.pod:4754 ../fish/guestfish-actions.pod:3194
15463 msgid ""
15464 "This moves a file from C<src> to C<dest> where C<dest> is either a "
15465 "destination filename or destination directory."
15466 msgstr ""
15467
15468 # type: =head2
15469 #. type: =head2
15470 #: ../src/guestfs-actions.pod:4761
15471 msgid "guestfs_ntfs_3g_probe"
15472 msgstr ""
15473
15474 # type: verbatim
15475 #. type: verbatim
15476 #: ../src/guestfs-actions.pod:4763
15477 #, no-wrap
15478 msgid ""
15479 " int\n"
15480 " guestfs_ntfs_3g_probe (guestfs_h *g,\n"
15481 "                        int rw,\n"
15482 "                        const char *device);\n"
15483 "\n"
15484 msgstr ""
15485
15486 # type: textblock
15487 #. type: textblock
15488 #: ../src/guestfs-actions.pod:4768 ../fish/guestfish-actions.pod:3201
15489 msgid ""
15490 "This command runs the L<ntfs-3g.probe(8)> command which probes an NTFS "
15491 "C<device> for mountability.  (Not all NTFS volumes can be mounted read-"
15492 "write, and some cannot be mounted at all)."
15493 msgstr ""
15494
15495 # type: textblock
15496 #. type: textblock
15497 #: ../src/guestfs-actions.pod:4772 ../fish/guestfish-actions.pod:3205
15498 msgid ""
15499 "C<rw> is a boolean flag.  Set it to true if you want to test if the volume "
15500 "can be mounted read-write.  Set it to false if you want to test if the "
15501 "volume can be mounted read-only."
15502 msgstr ""
15503
15504 # type: textblock
15505 #. type: textblock
15506 #: ../src/guestfs-actions.pod:4776 ../fish/guestfish-actions.pod:3209
15507 msgid ""
15508 "The return value is an integer which C<0> if the operation would succeed, or "
15509 "some non-zero value documented in the L<ntfs-3g.probe(8)> manual page."
15510 msgstr ""
15511
15512 # type: textblock
15513 #. type: textblock
15514 #: ../src/guestfs-actions.pod:4782
15515 msgid "(Added in 1.0.43)"
15516 msgstr ""
15517
15518 # type: =head2
15519 #. type: =head2
15520 #: ../src/guestfs-actions.pod:4784
15521 msgid "guestfs_ntfsresize"
15522 msgstr ""
15523
15524 # type: verbatim
15525 #. type: verbatim
15526 #: ../src/guestfs-actions.pod:4786
15527 #, no-wrap
15528 msgid ""
15529 " int\n"
15530 " guestfs_ntfsresize (guestfs_h *g,\n"
15531 "                     const char *device);\n"
15532 "\n"
15533 msgstr ""
15534
15535 # type: textblock
15536 #. type: textblock
15537 #: ../src/guestfs-actions.pod:4790 ../fish/guestfish-actions.pod:3217
15538 msgid ""
15539 "This command resizes an NTFS filesystem, expanding or shrinking it to the "
15540 "size of the underlying device.  See also L<ntfsresize(8)>."
15541 msgstr ""
15542
15543 # type: =head2
15544 #. type: =head2
15545 #: ../src/guestfs-actions.pod:4798
15546 msgid "guestfs_ntfsresize_size"
15547 msgstr ""
15548
15549 # type: verbatim
15550 #. type: verbatim
15551 #: ../src/guestfs-actions.pod:4800
15552 #, no-wrap
15553 msgid ""
15554 " int\n"
15555 " guestfs_ntfsresize_size (guestfs_h *g,\n"
15556 "                          const char *device,\n"
15557 "                          int64_t size);\n"
15558 "\n"
15559 msgstr ""
15560
15561 # type: textblock
15562 #. type: textblock
15563 #: ../src/guestfs-actions.pod:4805
15564 msgid ""
15565 "This command is the same as C<guestfs_ntfsresize> except that it allows you "
15566 "to specify the new size (in bytes) explicitly."
15567 msgstr ""
15568
15569 # type: textblock
15570 #. type: textblock
15571 #: ../src/guestfs-actions.pod:4810 ../src/guestfs-actions.pod:5246
15572 #: ../src/guestfs-actions.pod:5319 ../src/guestfs-actions.pod:5585
15573 #: ../src/guestfs-actions.pod:7156
15574 msgid "(Added in 1.3.14)"
15575 msgstr ""
15576
15577 # type: =head2
15578 #. type: =head2
15579 #: ../src/guestfs-actions.pod:4812
15580 msgid "guestfs_part_add"
15581 msgstr ""
15582
15583 # type: verbatim
15584 #. type: verbatim
15585 #: ../src/guestfs-actions.pod:4814
15586 #, no-wrap
15587 msgid ""
15588 " int\n"
15589 " guestfs_part_add (guestfs_h *g,\n"
15590 "                   const char *device,\n"
15591 "                   const char *prlogex,\n"
15592 "                   int64_t startsect,\n"
15593 "                   int64_t endsect);\n"
15594 "\n"
15595 msgstr ""
15596
15597 # type: textblock
15598 #. type: textblock
15599 #: ../src/guestfs-actions.pod:4821
15600 msgid ""
15601 "This command adds a partition to C<device>.  If there is no partition table "
15602 "on the device, call C<guestfs_part_init> first."
15603 msgstr ""
15604
15605 # type: textblock
15606 #. type: textblock
15607 #: ../src/guestfs-actions.pod:4824 ../fish/guestfish-actions.pod:3235
15608 msgid ""
15609 "The C<prlogex> parameter is the type of partition.  Normally you should pass "
15610 "C<p> or C<primary> here, but MBR partition tables also support C<l> (or "
15611 "C<logical>) and C<e> (or C<extended>) partition types."
15612 msgstr ""
15613
15614 # type: textblock
15615 #. type: textblock
15616 #: ../src/guestfs-actions.pod:4829 ../fish/guestfish-actions.pod:3240
15617 msgid ""
15618 "C<startsect> and C<endsect> are the start and end of the partition in "
15619 "I<sectors>.  C<endsect> may be negative, which means it counts backwards "
15620 "from the end of the disk (C<-1> is the last sector)."
15621 msgstr ""
15622
15623 # type: textblock
15624 #. type: textblock
15625 #: ../src/guestfs-actions.pod:4833
15626 msgid ""
15627 "Creating a partition which covers the whole disk is not so easy.  Use "
15628 "C<guestfs_part_disk> to do that."
15629 msgstr ""
15630
15631 # type: textblock
15632 #. type: textblock
15633 #: ../src/guestfs-actions.pod:4838 ../src/guestfs-actions.pod:4876
15634 #: ../src/guestfs-actions.pod:4929 ../src/guestfs-actions.pod:5007
15635 #: ../src/guestfs-actions.pod:5045 ../src/guestfs-actions.pod:5064
15636 #: ../src/guestfs-actions.pod:5104
15637 msgid "(Added in 1.0.78)"
15638 msgstr ""
15639
15640 # type: =head2
15641 #. type: =head2
15642 #: ../src/guestfs-actions.pod:4840
15643 msgid "guestfs_part_del"
15644 msgstr ""
15645
15646 # type: verbatim
15647 #. type: verbatim
15648 #: ../src/guestfs-actions.pod:4842
15649 #, no-wrap
15650 msgid ""
15651 " int\n"
15652 " guestfs_part_del (guestfs_h *g,\n"
15653 "                   const char *device,\n"
15654 "                   int partnum);\n"
15655 "\n"
15656 msgstr ""
15657
15658 # type: textblock
15659 #. type: textblock
15660 #: ../src/guestfs-actions.pod:4847 ../fish/guestfish-actions.pod:3251
15661 msgid "This command deletes the partition numbered C<partnum> on C<device>."
15662 msgstr ""
15663
15664 # type: textblock
15665 #. type: textblock
15666 #: ../src/guestfs-actions.pod:4849 ../fish/guestfish-actions.pod:3253
15667 msgid ""
15668 "Note that in the case of MBR partitioning, deleting an extended partition "
15669 "also deletes any logical partitions it contains."
15670 msgstr ""
15671
15672 # type: =head2
15673 #. type: =head2
15674 #: ../src/guestfs-actions.pod:4857
15675 msgid "guestfs_part_disk"
15676 msgstr ""
15677
15678 # type: verbatim
15679 #. type: verbatim
15680 #: ../src/guestfs-actions.pod:4859
15681 #, no-wrap
15682 msgid ""
15683 " int\n"
15684 " guestfs_part_disk (guestfs_h *g,\n"
15685 "                    const char *device,\n"
15686 "                    const char *parttype);\n"
15687 "\n"
15688 msgstr ""
15689
15690 # type: textblock
15691 #. type: textblock
15692 #: ../src/guestfs-actions.pod:4864
15693 msgid ""
15694 "This command is simply a combination of C<guestfs_part_init> followed by "
15695 "C<guestfs_part_add> to create a single primary partition covering the whole "
15696 "disk."
15697 msgstr ""
15698
15699 # type: textblock
15700 #. type: textblock
15701 #: ../src/guestfs-actions.pod:4868
15702 msgid ""
15703 "C<parttype> is the partition table type, usually C<mbr> or C<gpt>, but other "
15704 "possible values are described in C<guestfs_part_init>."
15705 msgstr ""
15706
15707 # type: =head2
15708 #. type: =head2
15709 #: ../src/guestfs-actions.pod:4878
15710 msgid "guestfs_part_get_bootable"
15711 msgstr ""
15712
15713 # type: verbatim
15714 #. type: verbatim
15715 #: ../src/guestfs-actions.pod:4880
15716 #, no-wrap
15717 msgid ""
15718 " int\n"
15719 " guestfs_part_get_bootable (guestfs_h *g,\n"
15720 "                            const char *device,\n"
15721 "                            int partnum);\n"
15722 "\n"
15723 msgstr ""
15724
15725 # type: textblock
15726 #. type: textblock
15727 #: ../src/guestfs-actions.pod:4885 ../fish/guestfish-actions.pod:3275
15728 msgid ""
15729 "This command returns true if the partition C<partnum> on C<device> has the "
15730 "bootable flag set."
15731 msgstr ""
15732
15733 # type: textblock
15734 #. type: textblock
15735 #: ../src/guestfs-actions.pod:4888
15736 msgid "See also C<guestfs_part_set_bootable>."
15737 msgstr ""
15738
15739 # type: =head2
15740 #. type: =head2
15741 #: ../src/guestfs-actions.pod:4894
15742 msgid "guestfs_part_get_mbr_id"
15743 msgstr ""
15744
15745 # type: verbatim
15746 #. type: verbatim
15747 #: ../src/guestfs-actions.pod:4896
15748 #, no-wrap
15749 msgid ""
15750 " int\n"
15751 " guestfs_part_get_mbr_id (guestfs_h *g,\n"
15752 "                          const char *device,\n"
15753 "                          int partnum);\n"
15754 "\n"
15755 msgstr ""
15756
15757 # type: textblock
15758 #. type: textblock
15759 #: ../src/guestfs-actions.pod:4901 ../fish/guestfish-actions.pod:3284
15760 msgid ""
15761 "Returns the MBR type byte (also known as the ID byte) from the numbered "
15762 "partition C<partnum>."
15763 msgstr ""
15764
15765 # type: textblock
15766 #. type: textblock
15767 #: ../src/guestfs-actions.pod:4904 ../src/guestfs-actions.pod:5080
15768 msgid ""
15769 "Note that only MBR (old DOS-style) partitions have type bytes.  You will get "
15770 "undefined results for other partition table types (see "
15771 "C<guestfs_part_get_parttype>)."
15772 msgstr ""
15773
15774 # type: =head2
15775 #. type: =head2
15776 #: ../src/guestfs-actions.pod:4912
15777 msgid "guestfs_part_get_parttype"
15778 msgstr ""
15779
15780 # type: verbatim
15781 #. type: verbatim
15782 #: ../src/guestfs-actions.pod:4914
15783 #, no-wrap
15784 msgid ""
15785 " char *\n"
15786 " guestfs_part_get_parttype (guestfs_h *g,\n"
15787 "                            const char *device);\n"
15788 "\n"
15789 msgstr ""
15790
15791 # type: textblock
15792 #. type: textblock
15793 #: ../src/guestfs-actions.pod:4918 ../fish/guestfish-actions.pod:3295
15794 msgid ""
15795 "This command examines the partition table on C<device> and returns the "
15796 "partition table type (format) being used."
15797 msgstr ""
15798
15799 # type: textblock
15800 #. type: textblock
15801 #: ../src/guestfs-actions.pod:4921
15802 msgid ""
15803 "Common return values include: C<msdos> (a DOS/Windows style MBR partition "
15804 "table), C<gpt> (a GPT/EFI-style partition table).  Other values are "
15805 "possible, although unusual.  See C<guestfs_part_init> for a full list."
15806 msgstr ""
15807
15808 # type: =head2
15809 #. type: =head2
15810 #: ../src/guestfs-actions.pod:4931
15811 msgid "guestfs_part_init"
15812 msgstr ""
15813
15814 # type: verbatim
15815 #. type: verbatim
15816 #: ../src/guestfs-actions.pod:4933
15817 #, no-wrap
15818 msgid ""
15819 " int\n"
15820 " guestfs_part_init (guestfs_h *g,\n"
15821 "                    const char *device,\n"
15822 "                    const char *parttype);\n"
15823 "\n"
15824 msgstr ""
15825
15826 # type: textblock
15827 #. type: textblock
15828 #: ../src/guestfs-actions.pod:4938 ../fish/guestfish-actions.pod:3307
15829 msgid ""
15830 "This creates an empty partition table on C<device> of one of the partition "
15831 "types listed below.  Usually C<parttype> should be either C<msdos> or C<gpt> "
15832 "(for large disks)."
15833 msgstr ""
15834
15835 # type: textblock
15836 #. type: textblock
15837 #: ../src/guestfs-actions.pod:4942
15838 msgid ""
15839 "Initially there are no partitions.  Following this, you should call "
15840 "C<guestfs_part_add> for each partition required."
15841 msgstr ""
15842
15843 # type: textblock
15844 #. type: textblock
15845 #: ../src/guestfs-actions.pod:4945 ../fish/guestfish-actions.pod:3314
15846 msgid "Possible values for C<parttype> are:"
15847 msgstr ""
15848
15849 # type: =item
15850 #. type: =item
15851 #: ../src/guestfs-actions.pod:4949 ../fish/guestfish-actions.pod:3318
15852 msgid "B<efi> | B<gpt>"
15853 msgstr ""
15854
15855 # type: textblock
15856 #. type: textblock
15857 #: ../src/guestfs-actions.pod:4951 ../fish/guestfish-actions.pod:3320
15858 msgid "Intel EFI / GPT partition table."
15859 msgstr ""
15860
15861 # type: textblock
15862 #. type: textblock
15863 #: ../src/guestfs-actions.pod:4953 ../fish/guestfish-actions.pod:3322
15864 msgid ""
15865 "This is recommended for >= 2 TB partitions that will be accessed from Linux "
15866 "and Intel-based Mac OS X.  It also has limited backwards compatibility with "
15867 "the C<mbr> format."
15868 msgstr ""
15869
15870 # type: =item
15871 #. type: =item
15872 #: ../src/guestfs-actions.pod:4957 ../fish/guestfish-actions.pod:3326
15873 msgid "B<mbr> | B<msdos>"
15874 msgstr ""
15875
15876 # type: textblock
15877 #. type: textblock
15878 #: ../src/guestfs-actions.pod:4959 ../fish/guestfish-actions.pod:3328
15879 msgid ""
15880 "The standard PC \"Master Boot Record\" (MBR) format used by MS-DOS and "
15881 "Windows.  This partition type will B<only> work for device sizes up to 2 "
15882 "TB.  For large disks we recommend using C<gpt>."
15883 msgstr ""
15884
15885 # type: textblock
15886 #. type: textblock
15887 #: ../src/guestfs-actions.pod:4966 ../fish/guestfish-actions.pod:3335
15888 msgid ""
15889 "Other partition table types that may work but are not supported include:"
15890 msgstr ""
15891
15892 # type: =item
15893 #. type: =item
15894 #: ../src/guestfs-actions.pod:4971 ../fish/guestfish-actions.pod:3340
15895 msgid "B<aix>"
15896 msgstr ""
15897
15898 # type: textblock
15899 #. type: textblock
15900 #: ../src/guestfs-actions.pod:4973 ../fish/guestfish-actions.pod:3342
15901 msgid "AIX disk labels."
15902 msgstr ""
15903
15904 # type: =item
15905 #. type: =item
15906 #: ../src/guestfs-actions.pod:4975 ../fish/guestfish-actions.pod:3344
15907 msgid "B<amiga> | B<rdb>"
15908 msgstr ""
15909
15910 # type: textblock
15911 #. type: textblock
15912 #: ../src/guestfs-actions.pod:4977 ../fish/guestfish-actions.pod:3346
15913 msgid "Amiga \"Rigid Disk Block\" format."
15914 msgstr ""
15915
15916 # type: =item
15917 #. type: =item
15918 #: ../src/guestfs-actions.pod:4979 ../fish/guestfish-actions.pod:3348
15919 msgid "B<bsd>"
15920 msgstr ""
15921
15922 # type: textblock
15923 #. type: textblock
15924 #: ../src/guestfs-actions.pod:4981 ../fish/guestfish-actions.pod:3350
15925 msgid "BSD disk labels."
15926 msgstr ""
15927
15928 # type: =item
15929 #. type: =item
15930 #: ../src/guestfs-actions.pod:4983 ../fish/guestfish-actions.pod:3352
15931 msgid "B<dasd>"
15932 msgstr ""
15933
15934 # type: textblock
15935 #. type: textblock
15936 #: ../src/guestfs-actions.pod:4985 ../fish/guestfish-actions.pod:3354
15937 msgid "DASD, used on IBM mainframes."
15938 msgstr ""
15939
15940 # type: =item
15941 #. type: =item
15942 #: ../src/guestfs-actions.pod:4987 ../fish/guestfish-actions.pod:3356
15943 msgid "B<dvh>"
15944 msgstr ""
15945
15946 # type: textblock
15947 #. type: textblock
15948 #: ../src/guestfs-actions.pod:4989 ../fish/guestfish-actions.pod:3358
15949 msgid "MIPS/SGI volumes."
15950 msgstr ""
15951
15952 # type: =item
15953 #. type: =item
15954 #: ../src/guestfs-actions.pod:4991 ../fish/guestfish-actions.pod:3360
15955 msgid "B<mac>"
15956 msgstr ""
15957
15958 # type: textblock
15959 #. type: textblock
15960 #: ../src/guestfs-actions.pod:4993 ../fish/guestfish-actions.pod:3362
15961 msgid "Old Mac partition format.  Modern Macs use C<gpt>."
15962 msgstr ""
15963
15964 # type: =item
15965 #. type: =item
15966 #: ../src/guestfs-actions.pod:4995 ../fish/guestfish-actions.pod:3364
15967 msgid "B<pc98>"
15968 msgstr ""
15969
15970 # type: textblock
15971 #. type: textblock
15972 #: ../src/guestfs-actions.pod:4997 ../fish/guestfish-actions.pod:3366
15973 msgid "NEC PC-98 format, common in Japan apparently."
15974 msgstr ""
15975
15976 # type: =item
15977 #. type: =item
15978 #: ../src/guestfs-actions.pod:4999 ../fish/guestfish-actions.pod:3368
15979 msgid "B<sun>"
15980 msgstr ""
15981
15982 # type: textblock
15983 #. type: textblock
15984 #: ../src/guestfs-actions.pod:5001 ../fish/guestfish-actions.pod:3370
15985 msgid "Sun disk labels."
15986 msgstr ""
15987
15988 # type: =head2
15989 #. type: =head2
15990 #: ../src/guestfs-actions.pod:5009
15991 msgid "guestfs_part_list"
15992 msgstr ""
15993
15994 # type: verbatim
15995 #. type: verbatim
15996 #: ../src/guestfs-actions.pod:5011
15997 #, no-wrap
15998 msgid ""
15999 " struct guestfs_partition_list *\n"
16000 " guestfs_part_list (guestfs_h *g,\n"
16001 "                    const char *device);\n"
16002 "\n"
16003 msgstr ""
16004
16005 # type: textblock
16006 #. type: textblock
16007 #: ../src/guestfs-actions.pod:5015 ../fish/guestfish-actions.pod:3378
16008 msgid ""
16009 "This command parses the partition table on C<device> and returns the list of "
16010 "partitions found."
16011 msgstr ""
16012
16013 # type: textblock
16014 #. type: textblock
16015 #: ../src/guestfs-actions.pod:5018 ../fish/guestfish-actions.pod:3381
16016 msgid "The fields in the returned structure are:"
16017 msgstr ""
16018
16019 # type: =item
16020 #. type: =item
16021 #: ../src/guestfs-actions.pod:5022 ../fish/guestfish-actions.pod:3385
16022 msgid "B<part_num>"
16023 msgstr ""
16024
16025 # type: textblock
16026 #. type: textblock
16027 #: ../src/guestfs-actions.pod:5024 ../fish/guestfish-actions.pod:3387
16028 msgid "Partition number, counting from 1."
16029 msgstr ""
16030
16031 # type: =item
16032 #. type: =item
16033 #: ../src/guestfs-actions.pod:5026 ../fish/guestfish-actions.pod:3389
16034 msgid "B<part_start>"
16035 msgstr ""
16036
16037 # type: textblock
16038 #. type: textblock
16039 #: ../src/guestfs-actions.pod:5028
16040 msgid ""
16041 "Start of the partition I<in bytes>.  To get sectors you have to divide by "
16042 "the device's sector size, see C<guestfs_blockdev_getss>."
16043 msgstr ""
16044
16045 # type: =item
16046 #. type: =item
16047 #: ../src/guestfs-actions.pod:5031 ../fish/guestfish-actions.pod:3394
16048 msgid "B<part_end>"
16049 msgstr ""
16050
16051 # type: textblock
16052 #. type: textblock
16053 #: ../src/guestfs-actions.pod:5033 ../fish/guestfish-actions.pod:3396
16054 msgid "End of the partition in bytes."
16055 msgstr ""
16056
16057 # type: =item
16058 #. type: =item
16059 #: ../src/guestfs-actions.pod:5035 ../fish/guestfish-actions.pod:3398
16060 msgid "B<part_size>"
16061 msgstr ""
16062
16063 # type: textblock
16064 #. type: textblock
16065 #: ../src/guestfs-actions.pod:5037 ../fish/guestfish-actions.pod:3400
16066 msgid "Size of the partition in bytes."
16067 msgstr ""
16068
16069 # type: textblock
16070 #. type: textblock
16071 #: ../src/guestfs-actions.pod:5041
16072 msgid ""
16073 "This function returns a C<struct guestfs_partition_list *>, or NULL if there "
16074 "was an error.  I<The caller must call C<guestfs_free_partition_list> after "
16075 "use>."
16076 msgstr ""
16077
16078 # type: =head2
16079 #. type: =head2
16080 #: ../src/guestfs-actions.pod:5047
16081 msgid "guestfs_part_set_bootable"
16082 msgstr ""
16083
16084 # type: verbatim
16085 #. type: verbatim
16086 #: ../src/guestfs-actions.pod:5049
16087 #, no-wrap
16088 msgid ""
16089 " int\n"
16090 " guestfs_part_set_bootable (guestfs_h *g,\n"
16091 "                            const char *device,\n"
16092 "                            int partnum,\n"
16093 "                            int bootable);\n"
16094 "\n"
16095 msgstr ""
16096
16097 # type: textblock
16098 #. type: textblock
16099 #: ../src/guestfs-actions.pod:5055 ../fish/guestfish-actions.pod:3408
16100 msgid ""
16101 "This sets the bootable flag on partition numbered C<partnum> on device "
16102 "C<device>.  Note that partitions are numbered from 1."
16103 msgstr ""
16104
16105 # type: textblock
16106 #. type: textblock
16107 #: ../src/guestfs-actions.pod:5058 ../fish/guestfish-actions.pod:3411
16108 msgid ""
16109 "The bootable flag is used by some operating systems (notably Windows) to "
16110 "determine which partition to boot from.  It is by no means universally "
16111 "recognized."
16112 msgstr ""
16113
16114 # type: =head2
16115 #. type: =head2
16116 #: ../src/guestfs-actions.pod:5066
16117 msgid "guestfs_part_set_mbr_id"
16118 msgstr ""
16119
16120 # type: verbatim
16121 #. type: verbatim
16122 #: ../src/guestfs-actions.pod:5068
16123 #, no-wrap
16124 msgid ""
16125 " int\n"
16126 " guestfs_part_set_mbr_id (guestfs_h *g,\n"
16127 "                          const char *device,\n"
16128 "                          int partnum,\n"
16129 "                          int idbyte);\n"
16130 "\n"
16131 msgstr ""
16132
16133 # type: textblock
16134 #. type: textblock
16135 #: ../src/guestfs-actions.pod:5074 ../fish/guestfish-actions.pod:3419
16136 msgid ""
16137 "Sets the MBR type byte (also known as the ID byte) of the numbered partition "
16138 "C<partnum> to C<idbyte>.  Note that the type bytes quoted in most "
16139 "documentation are in fact hexadecimal numbers, but usually documented "
16140 "without any leading \"0x\" which might be confusing."
16141 msgstr ""
16142
16143 # type: =head2
16144 #. type: =head2
16145 #: ../src/guestfs-actions.pod:5088
16146 msgid "guestfs_part_set_name"
16147 msgstr ""
16148
16149 # type: verbatim
16150 #. type: verbatim
16151 #: ../src/guestfs-actions.pod:5090
16152 #, no-wrap
16153 msgid ""
16154 " int\n"
16155 " guestfs_part_set_name (guestfs_h *g,\n"
16156 "                        const char *device,\n"
16157 "                        int partnum,\n"
16158 "                        const char *name);\n"
16159 "\n"
16160 msgstr ""
16161
16162 # type: textblock
16163 #. type: textblock
16164 #: ../src/guestfs-actions.pod:5096 ../fish/guestfish-actions.pod:3433
16165 msgid ""
16166 "This sets the partition name on partition numbered C<partnum> on device "
16167 "C<device>.  Note that partitions are numbered from 1."
16168 msgstr ""
16169
16170 # type: textblock
16171 #. type: textblock
16172 #: ../src/guestfs-actions.pod:5099 ../fish/guestfish-actions.pod:3436
16173 msgid ""
16174 "The partition name can only be set on certain types of partition table.  "
16175 "This works on C<gpt> but not on C<mbr> partitions."
16176 msgstr ""
16177
16178 # type: =head2
16179 #. type: =head2
16180 #: ../src/guestfs-actions.pod:5106
16181 msgid "guestfs_part_to_dev"
16182 msgstr ""
16183
16184 # type: verbatim
16185 #. type: verbatim
16186 #: ../src/guestfs-actions.pod:5108
16187 #, no-wrap
16188 msgid ""
16189 " char *\n"
16190 " guestfs_part_to_dev (guestfs_h *g,\n"
16191 "                      const char *partition);\n"
16192 "\n"
16193 msgstr ""
16194
16195 # type: textblock
16196 #. type: textblock
16197 #: ../src/guestfs-actions.pod:5112 ../fish/guestfish-actions.pod:3443
16198 msgid ""
16199 "This function takes a partition name (eg. \"/dev/sdb1\") and removes the "
16200 "partition number, returning the device name (eg. \"/dev/sdb\")."
16201 msgstr ""
16202
16203 # type: textblock
16204 #. type: textblock
16205 #: ../src/guestfs-actions.pod:5116
16206 msgid ""
16207 "The named partition must exist, for example as a string returned from "
16208 "C<guestfs_list_partitions>."
16209 msgstr ""
16210
16211 # type: =head2
16212 #. type: =head2
16213 #: ../src/guestfs-actions.pod:5124
16214 msgid "guestfs_ping_daemon"
16215 msgstr ""
16216
16217 # type: verbatim
16218 #. type: verbatim
16219 #: ../src/guestfs-actions.pod:5126
16220 #, no-wrap
16221 msgid ""
16222 " int\n"
16223 " guestfs_ping_daemon (guestfs_h *g);\n"
16224 "\n"
16225 msgstr ""
16226
16227 # type: textblock
16228 #. type: textblock
16229 #: ../src/guestfs-actions.pod:5129 ../fish/guestfish-actions.pod:3454
16230 msgid ""
16231 "This is a test probe into the guestfs daemon running inside the qemu "
16232 "subprocess.  Calling this function checks that the daemon responds to the "
16233 "ping message, without affecting the daemon or attached block device(s) in "
16234 "any other way."
16235 msgstr ""
16236
16237 # type: =head2
16238 #. type: =head2
16239 #: ../src/guestfs-actions.pod:5138
16240 msgid "guestfs_pread"
16241 msgstr ""
16242
16243 # type: verbatim
16244 #. type: verbatim
16245 #: ../src/guestfs-actions.pod:5140
16246 #, no-wrap
16247 msgid ""
16248 " char *\n"
16249 " guestfs_pread (guestfs_h *g,\n"
16250 "                const char *path,\n"
16251 "                int count,\n"
16252 "                int64_t offset,\n"
16253 "                size_t *size_r);\n"
16254 "\n"
16255 msgstr ""
16256
16257 # type: textblock
16258 #. type: textblock
16259 #: ../src/guestfs-actions.pod:5147 ../fish/guestfish-actions.pod:3463
16260 msgid ""
16261 "This command lets you read part of a file.  It reads C<count> bytes of the "
16262 "file, starting at C<offset>, from file C<path>."
16263 msgstr ""
16264
16265 # type: textblock
16266 #. type: textblock
16267 #: ../src/guestfs-actions.pod:5150 ../src/guestfs-actions.pod:5176
16268 #: ../fish/guestfish-actions.pod:3466 ../fish/guestfish-actions.pod:3481
16269 msgid ""
16270 "This may read fewer bytes than requested.  For further details see the "
16271 "L<pread(2)> system call."
16272 msgstr ""
16273
16274 # type: textblock
16275 #. type: textblock
16276 #: ../src/guestfs-actions.pod:5153
16277 msgid "See also C<guestfs_pwrite>, C<guestfs_pread_device>."
16278 msgstr ""
16279
16280 # type: =head2
16281 #. type: =head2
16282 #: ../src/guestfs-actions.pod:5164
16283 msgid "guestfs_pread_device"
16284 msgstr ""
16285
16286 # type: verbatim
16287 #. type: verbatim
16288 #: ../src/guestfs-actions.pod:5166
16289 #, no-wrap
16290 msgid ""
16291 " char *\n"
16292 " guestfs_pread_device (guestfs_h *g,\n"
16293 "                       const char *device,\n"
16294 "                       int count,\n"
16295 "                       int64_t offset,\n"
16296 "                       size_t *size_r);\n"
16297 "\n"
16298 msgstr ""
16299
16300 # type: textblock
16301 #. type: textblock
16302 #: ../src/guestfs-actions.pod:5173 ../fish/guestfish-actions.pod:3478
16303 msgid ""
16304 "This command lets you read part of a file.  It reads C<count> bytes of "
16305 "C<device>, starting at C<offset>."
16306 msgstr ""
16307
16308 # type: textblock
16309 #. type: textblock
16310 #: ../src/guestfs-actions.pod:5179
16311 msgid "See also C<guestfs_pread>."
16312 msgstr ""
16313
16314 # type: textblock
16315 #. type: textblock
16316 #: ../src/guestfs-actions.pod:5188
16317 msgid "(Added in 1.5.21)"
16318 msgstr ""
16319
16320 # type: =head2
16321 #. type: =head2
16322 #: ../src/guestfs-actions.pod:5190
16323 msgid "guestfs_pvcreate"
16324 msgstr ""
16325
16326 # type: verbatim
16327 #. type: verbatim
16328 #: ../src/guestfs-actions.pod:5192
16329 #, no-wrap
16330 msgid ""
16331 " int\n"
16332 " guestfs_pvcreate (guestfs_h *g,\n"
16333 "                   const char *device);\n"
16334 "\n"
16335 msgstr ""
16336
16337 # type: textblock
16338 #. type: textblock
16339 #: ../src/guestfs-actions.pod:5196 ../fish/guestfish-actions.pod:3493
16340 msgid ""
16341 "This creates an LVM physical volume on the named C<device>, where C<device> "
16342 "should usually be a partition name such as C</dev/sda1>."
16343 msgstr ""
16344
16345 # type: =head2
16346 #. type: =head2
16347 #: ../src/guestfs-actions.pod:5204
16348 msgid "guestfs_pvremove"
16349 msgstr ""
16350
16351 # type: verbatim
16352 #. type: verbatim
16353 #: ../src/guestfs-actions.pod:5206
16354 #, no-wrap
16355 msgid ""
16356 " int\n"
16357 " guestfs_pvremove (guestfs_h *g,\n"
16358 "                   const char *device);\n"
16359 "\n"
16360 msgstr ""
16361
16362 # type: textblock
16363 #. type: textblock
16364 #: ../src/guestfs-actions.pod:5210 ../fish/guestfish-actions.pod:3501
16365 msgid ""
16366 "This wipes a physical volume C<device> so that LVM will no longer recognise "
16367 "it."
16368 msgstr ""
16369
16370 # type: textblock
16371 #. type: textblock
16372 #: ../src/guestfs-actions.pod:5213 ../fish/guestfish-actions.pod:3504
16373 msgid ""
16374 "The implementation uses the C<pvremove> command which refuses to wipe "
16375 "physical volumes that contain any volume groups, so you have to remove those "
16376 "first."
16377 msgstr ""
16378
16379 # type: =head2
16380 #. type: =head2
16381 #: ../src/guestfs-actions.pod:5221
16382 msgid "guestfs_pvresize"
16383 msgstr ""
16384
16385 # type: verbatim
16386 #. type: verbatim
16387 #: ../src/guestfs-actions.pod:5223
16388 #, no-wrap
16389 msgid ""
16390 " int\n"
16391 " guestfs_pvresize (guestfs_h *g,\n"
16392 "                   const char *device);\n"
16393 "\n"
16394 msgstr ""
16395
16396 # type: textblock
16397 #. type: textblock
16398 #: ../src/guestfs-actions.pod:5227 ../fish/guestfish-actions.pod:3512
16399 msgid ""
16400 "This resizes (expands or shrinks) an existing LVM physical volume to match "
16401 "the new size of the underlying device."
16402 msgstr ""
16403
16404 # type: =head2
16405 #. type: =head2
16406 #: ../src/guestfs-actions.pod:5234
16407 msgid "guestfs_pvresize_size"
16408 msgstr ""
16409
16410 # type: verbatim
16411 #. type: verbatim
16412 #: ../src/guestfs-actions.pod:5236
16413 #, no-wrap
16414 msgid ""
16415 " int\n"
16416 " guestfs_pvresize_size (guestfs_h *g,\n"
16417 "                        const char *device,\n"
16418 "                        int64_t size);\n"
16419 "\n"
16420 msgstr ""
16421
16422 # type: textblock
16423 #. type: textblock
16424 #: ../src/guestfs-actions.pod:5241
16425 msgid ""
16426 "This command is the same as C<guestfs_pvresize> except that it allows you to "
16427 "specify the new size (in bytes) explicitly."
16428 msgstr ""
16429
16430 # type: =head2
16431 #. type: =head2
16432 #: ../src/guestfs-actions.pod:5248
16433 msgid "guestfs_pvs"
16434 msgstr ""
16435
16436 # type: verbatim
16437 #. type: verbatim
16438 #: ../src/guestfs-actions.pod:5250
16439 #, no-wrap
16440 msgid ""
16441 " char **\n"
16442 " guestfs_pvs (guestfs_h *g);\n"
16443 "\n"
16444 msgstr ""
16445
16446 # type: textblock
16447 #. type: textblock
16448 #: ../src/guestfs-actions.pod:5253 ../fish/guestfish-actions.pod:3526
16449 msgid ""
16450 "List all the physical volumes detected.  This is the equivalent of the L<pvs"
16451 "(8)> command."
16452 msgstr ""
16453
16454 # type: textblock
16455 #. type: textblock
16456 #: ../src/guestfs-actions.pod:5256 ../fish/guestfish-actions.pod:3529
16457 msgid ""
16458 "This returns a list of just the device names that contain PVs (eg. C</dev/"
16459 "sda2>)."
16460 msgstr ""
16461
16462 # type: textblock
16463 #. type: textblock
16464 #: ../src/guestfs-actions.pod:5259
16465 msgid "See also C<guestfs_pvs_full>."
16466 msgstr ""
16467
16468 # type: =head2
16469 #. type: =head2
16470 #: ../src/guestfs-actions.pod:5267
16471 msgid "guestfs_pvs_full"
16472 msgstr ""
16473
16474 # type: verbatim
16475 #. type: verbatim
16476 #: ../src/guestfs-actions.pod:5269
16477 #, no-wrap
16478 msgid ""
16479 " struct guestfs_lvm_pv_list *\n"
16480 " guestfs_pvs_full (guestfs_h *g);\n"
16481 "\n"
16482 msgstr ""
16483
16484 # type: textblock
16485 #. type: textblock
16486 #: ../src/guestfs-actions.pod:5272 ../fish/guestfish-actions.pod:3538
16487 msgid ""
16488 "List all the physical volumes detected.  This is the equivalent of the L<pvs"
16489 "(8)> command.  The \"full\" version includes all fields."
16490 msgstr ""
16491
16492 # type: textblock
16493 #. type: textblock
16494 #: ../src/guestfs-actions.pod:5275
16495 msgid ""
16496 "This function returns a C<struct guestfs_lvm_pv_list *>, or NULL if there "
16497 "was an error.  I<The caller must call C<guestfs_free_lvm_pv_list> after use>."
16498 msgstr ""
16499
16500 # type: =head2
16501 #. type: =head2
16502 #: ../src/guestfs-actions.pod:5281
16503 msgid "guestfs_pvuuid"
16504 msgstr ""
16505
16506 # type: verbatim
16507 #. type: verbatim
16508 #: ../src/guestfs-actions.pod:5283
16509 #, no-wrap
16510 msgid ""
16511 " char *\n"
16512 " guestfs_pvuuid (guestfs_h *g,\n"
16513 "                 const char *device);\n"
16514 "\n"
16515 msgstr ""
16516
16517 # type: textblock
16518 #. type: textblock
16519 #: ../src/guestfs-actions.pod:5287 ../fish/guestfish-actions.pod:3545
16520 msgid "This command returns the UUID of the LVM PV C<device>."
16521 msgstr ""
16522
16523 # type: =head2
16524 #. type: =head2
16525 #: ../src/guestfs-actions.pod:5294
16526 msgid "guestfs_pwrite"
16527 msgstr ""
16528
16529 # type: verbatim
16530 #. type: verbatim
16531 #: ../src/guestfs-actions.pod:5296
16532 #, no-wrap
16533 msgid ""
16534 " int\n"
16535 " guestfs_pwrite (guestfs_h *g,\n"
16536 "                 const char *path,\n"
16537 "                 const char *content,\n"
16538 "                 size_t content_size,\n"
16539 "                 int64_t offset);\n"
16540 "\n"
16541 msgstr ""
16542
16543 # type: textblock
16544 #. type: textblock
16545 #: ../src/guestfs-actions.pod:5303 ../fish/guestfish-actions.pod:3551
16546 msgid ""
16547 "This command writes to part of a file.  It writes the data buffer C<content> "
16548 "to the file C<path> starting at offset C<offset>."
16549 msgstr ""
16550
16551 # type: textblock
16552 #. type: textblock
16553 #: ../src/guestfs-actions.pod:5306 ../fish/guestfish-actions.pod:3554
16554 msgid ""
16555 "This command implements the L<pwrite(2)> system call, and like that system "
16556 "call it may not write the full data requested.  The return value is the "
16557 "number of bytes that were actually written to the file.  This could even be "
16558 "0, although short writes are unlikely for regular files in ordinary "
16559 "circumstances."
16560 msgstr ""
16561
16562 # type: textblock
16563 #. type: textblock
16564 #: ../src/guestfs-actions.pod:5312
16565 msgid "See also C<guestfs_pread>, C<guestfs_pwrite_device>."
16566 msgstr ""
16567
16568 # type: =head2
16569 #. type: =head2
16570 #: ../src/guestfs-actions.pod:5321
16571 msgid "guestfs_pwrite_device"
16572 msgstr ""
16573
16574 # type: verbatim
16575 #. type: verbatim
16576 #: ../src/guestfs-actions.pod:5323
16577 #, no-wrap
16578 msgid ""
16579 " int\n"
16580 " guestfs_pwrite_device (guestfs_h *g,\n"
16581 "                        const char *device,\n"
16582 "                        const char *content,\n"
16583 "                        size_t content_size,\n"
16584 "                        int64_t offset);\n"
16585 "\n"
16586 msgstr ""
16587
16588 # type: textblock
16589 #. type: textblock
16590 #: ../src/guestfs-actions.pod:5330 ../fish/guestfish-actions.pod:3569
16591 msgid ""
16592 "This command writes to part of a device.  It writes the data buffer "
16593 "C<content> to C<device> starting at offset C<offset>."
16594 msgstr ""
16595
16596 # type: textblock
16597 #. type: textblock
16598 #: ../src/guestfs-actions.pod:5333 ../fish/guestfish-actions.pod:3572
16599 msgid ""
16600 "This command implements the L<pwrite(2)> system call, and like that system "
16601 "call it may not write the full data requested (although short writes to disk "
16602 "devices and partitions are probably impossible with standard Linux kernels)."
16603 msgstr ""
16604
16605 # type: textblock
16606 #. type: textblock
16607 #: ../src/guestfs-actions.pod:5338
16608 msgid "See also C<guestfs_pwrite>."
16609 msgstr ""
16610
16611 # type: textblock
16612 #. type: textblock
16613 #: ../src/guestfs-actions.pod:5345
16614 msgid "(Added in 1.5.20)"
16615 msgstr ""
16616
16617 # type: =head2
16618 #. type: =head2
16619 #: ../src/guestfs-actions.pod:5347
16620 msgid "guestfs_read_file"
16621 msgstr ""
16622
16623 # type: verbatim
16624 #. type: verbatim
16625 #: ../src/guestfs-actions.pod:5349
16626 #, no-wrap
16627 msgid ""
16628 " char *\n"
16629 " guestfs_read_file (guestfs_h *g,\n"
16630 "                    const char *path,\n"
16631 "                    size_t *size_r);\n"
16632 "\n"
16633 msgstr ""
16634
16635 # type: textblock
16636 #. type: textblock
16637 #: ../src/guestfs-actions.pod:5354 ../fish/guestfish-actions.pod:3586
16638 msgid "This calls returns the contents of the file C<path> as a buffer."
16639 msgstr ""
16640
16641 # type: textblock
16642 #. type: textblock
16643 #: ../src/guestfs-actions.pod:5357
16644 msgid ""
16645 "Unlike C<guestfs_cat>, this function can correctly handle files that contain "
16646 "embedded ASCII NUL characters.  However unlike C<guestfs_download>, this "
16647 "function is limited in the total size of file that can be handled."
16648 msgstr ""
16649
16650 # type: textblock
16651 #. type: textblock
16652 #: ../src/guestfs-actions.pod:5369
16653 msgid "(Added in 1.0.63)"
16654 msgstr ""
16655
16656 # type: =head2
16657 #. type: =head2
16658 #: ../src/guestfs-actions.pod:5371
16659 msgid "guestfs_read_lines"
16660 msgstr ""
16661
16662 # type: verbatim
16663 #. type: verbatim
16664 #: ../src/guestfs-actions.pod:5373
16665 #, no-wrap
16666 msgid ""
16667 " char **\n"
16668 " guestfs_read_lines (guestfs_h *g,\n"
16669 "                     const char *path);\n"
16670 "\n"
16671 msgstr ""
16672
16673 # type: textblock
16674 #. type: textblock
16675 #: ../src/guestfs-actions.pod:5379 ../fish/guestfish-actions.pod:3603
16676 msgid ""
16677 "The file contents are returned as a list of lines.  Trailing C<LF> and "
16678 "C<CRLF> character sequences are I<not> returned."
16679 msgstr ""
16680
16681 # type: textblock
16682 #. type: textblock
16683 #: ../src/guestfs-actions.pod:5382
16684 msgid ""
16685 "Note that this function cannot correctly handle binary files (specifically, "
16686 "files containing C<\\0> character which is treated as end of line).  For "
16687 "those you need to use the C<guestfs_read_file> function which has a more "
16688 "complex interface."
16689 msgstr ""
16690
16691 # type: =head2
16692 #. type: =head2
16693 #: ../src/guestfs-actions.pod:5393
16694 msgid "guestfs_readdir"
16695 msgstr ""
16696
16697 # type: verbatim
16698 #. type: verbatim
16699 #: ../src/guestfs-actions.pod:5395
16700 #, no-wrap
16701 msgid ""
16702 " struct guestfs_dirent_list *\n"
16703 " guestfs_readdir (guestfs_h *g,\n"
16704 "                  const char *dir);\n"
16705 "\n"
16706 msgstr ""
16707
16708 # type: textblock
16709 #. type: textblock
16710 #: ../src/guestfs-actions.pod:5399 ../fish/guestfish-actions.pod:3615
16711 msgid "This returns the list of directory entries in directory C<dir>."
16712 msgstr ""
16713
16714 # type: textblock
16715 #. type: textblock
16716 #: ../src/guestfs-actions.pod:5401 ../fish/guestfish-actions.pod:3617
16717 msgid ""
16718 "All entries in the directory are returned, including C<.> and C<..>.  The "
16719 "entries are I<not> sorted, but returned in the same order as the underlying "
16720 "filesystem."
16721 msgstr ""
16722
16723 # type: textblock
16724 #. type: textblock
16725 #: ../src/guestfs-actions.pod:5405 ../fish/guestfish-actions.pod:3621
16726 msgid ""
16727 "Also this call returns basic file type information about each file.  The "
16728 "C<ftyp> field will contain one of the following characters:"
16729 msgstr ""
16730
16731 # type: =item
16732 #. type: =item
16733 #: ../src/guestfs-actions.pod:5410 ../fish/guestfish-actions.pod:3626
16734 msgid "'b'"
16735 msgstr ""
16736
16737 # type: textblock
16738 #. type: textblock
16739 #: ../src/guestfs-actions.pod:5412 ../fish/guestfish-actions.pod:3628
16740 msgid "Block special"
16741 msgstr ""
16742
16743 # type: =item
16744 #. type: =item
16745 #: ../src/guestfs-actions.pod:5414 ../fish/guestfish-actions.pod:3630
16746 msgid "'c'"
16747 msgstr ""
16748
16749 # type: textblock
16750 #. type: textblock
16751 #: ../src/guestfs-actions.pod:5416 ../fish/guestfish-actions.pod:3632
16752 msgid "Char special"
16753 msgstr ""
16754
16755 # type: =item
16756 #. type: =item
16757 #: ../src/guestfs-actions.pod:5418 ../fish/guestfish-actions.pod:3634
16758 msgid "'d'"
16759 msgstr ""
16760
16761 # type: textblock
16762 #. type: textblock
16763 #: ../src/guestfs-actions.pod:5420 ../fish/guestfish-actions.pod:3636
16764 msgid "Directory"
16765 msgstr ""
16766
16767 # type: =item
16768 #. type: =item
16769 #: ../src/guestfs-actions.pod:5422 ../fish/guestfish-actions.pod:3638
16770 msgid "'f'"
16771 msgstr ""
16772
16773 # type: textblock
16774 #. type: textblock
16775 #: ../src/guestfs-actions.pod:5424 ../fish/guestfish-actions.pod:3640
16776 msgid "FIFO (named pipe)"
16777 msgstr ""
16778
16779 # type: =item
16780 #. type: =item
16781 #: ../src/guestfs-actions.pod:5426 ../fish/guestfish-actions.pod:3642
16782 msgid "'l'"
16783 msgstr ""
16784
16785 # type: textblock
16786 #. type: textblock
16787 #: ../src/guestfs-actions.pod:5428 ../fish/guestfish-actions.pod:3644
16788 msgid "Symbolic link"
16789 msgstr ""
16790
16791 # type: =item
16792 #. type: =item
16793 #: ../src/guestfs-actions.pod:5430 ../fish/guestfish-actions.pod:3646
16794 msgid "'r'"
16795 msgstr ""
16796
16797 # type: textblock
16798 #. type: textblock
16799 #: ../src/guestfs-actions.pod:5432 ../fish/guestfish-actions.pod:3648
16800 msgid "Regular file"
16801 msgstr ""
16802
16803 # type: =item
16804 #. type: =item
16805 #: ../src/guestfs-actions.pod:5434 ../fish/guestfish-actions.pod:3650
16806 msgid "'s'"
16807 msgstr ""
16808
16809 # type: textblock
16810 #. type: textblock
16811 #: ../src/guestfs-actions.pod:5436 ../fish/guestfish-actions.pod:3652
16812 msgid "Socket"
16813 msgstr ""
16814
16815 # type: =item
16816 #. type: =item
16817 #: ../src/guestfs-actions.pod:5438 ../fish/guestfish-actions.pod:3654
16818 msgid "'u'"
16819 msgstr ""
16820
16821 # type: textblock
16822 #. type: textblock
16823 #: ../src/guestfs-actions.pod:5440 ../fish/guestfish-actions.pod:3656
16824 msgid "Unknown file type"
16825 msgstr ""
16826
16827 # type: =item
16828 #. type: =item
16829 #: ../src/guestfs-actions.pod:5442 ../fish/guestfish-actions.pod:3658
16830 msgid "'?'"
16831 msgstr ""
16832
16833 # type: textblock
16834 #. type: textblock
16835 #: ../src/guestfs-actions.pod:5444 ../fish/guestfish-actions.pod:3660
16836 msgid ""
16837 "The L<readdir(3)> call returned a C<d_type> field with an unexpected value"
16838 msgstr ""
16839
16840 # type: textblock
16841 #. type: textblock
16842 #: ../src/guestfs-actions.pod:5449
16843 msgid ""
16844 "This function is primarily intended for use by programs.  To get a simple "
16845 "list of names, use C<guestfs_ls>.  To get a printable directory for human "
16846 "consumption, use C<guestfs_ll>."
16847 msgstr ""
16848
16849 # type: textblock
16850 #. type: textblock
16851 #: ../src/guestfs-actions.pod:5453
16852 msgid ""
16853 "This function returns a C<struct guestfs_dirent_list *>, or NULL if there "
16854 "was an error.  I<The caller must call C<guestfs_free_dirent_list> after use>."
16855 msgstr ""
16856
16857 # type: =head2
16858 #. type: =head2
16859 #: ../src/guestfs-actions.pod:5459
16860 msgid "guestfs_readlink"
16861 msgstr ""
16862
16863 # type: verbatim
16864 #. type: verbatim
16865 #: ../src/guestfs-actions.pod:5461
16866 #, no-wrap
16867 msgid ""
16868 " char *\n"
16869 " guestfs_readlink (guestfs_h *g,\n"
16870 "                   const char *path);\n"
16871 "\n"
16872 msgstr ""
16873
16874 # type: textblock
16875 #. type: textblock
16876 #: ../src/guestfs-actions.pod:5465 ../fish/guestfish-actions.pod:3673
16877 msgid "This command reads the target of a symbolic link."
16878 msgstr ""
16879
16880 # type: =head2
16881 #. type: =head2
16882 #: ../src/guestfs-actions.pod:5472
16883 msgid "guestfs_readlinklist"
16884 msgstr ""
16885
16886 # type: verbatim
16887 #. type: verbatim
16888 #: ../src/guestfs-actions.pod:5474
16889 #, no-wrap
16890 msgid ""
16891 " char **\n"
16892 " guestfs_readlinklist (guestfs_h *g,\n"
16893 "                       const char *path,\n"
16894 "                       char *const *names);\n"
16895 "\n"
16896 msgstr ""
16897
16898 # type: textblock
16899 #. type: textblock
16900 #: ../src/guestfs-actions.pod:5479 ../fish/guestfish-actions.pod:3679
16901 msgid ""
16902 "This call allows you to do a C<readlink> operation on multiple files, where "
16903 "all files are in the directory C<path>.  C<names> is the list of files from "
16904 "this directory."
16905 msgstr ""
16906
16907 # type: textblock
16908 #. type: textblock
16909 #: ../src/guestfs-actions.pod:5483 ../fish/guestfish-actions.pod:3683
16910 msgid ""
16911 "On return you get a list of strings, with a one-to-one correspondence to the "
16912 "C<names> list.  Each string is the value of the symbolic link."
16913 msgstr ""
16914
16915 # type: textblock
16916 #. type: textblock
16917 #: ../src/guestfs-actions.pod:5487 ../fish/guestfish-actions.pod:3687
16918 msgid ""
16919 "If the C<readlink(2)> operation fails on any name, then the corresponding "
16920 "result string is the empty string C<\"\">.  However the whole operation is "
16921 "completed even if there were C<readlink(2)> errors, and so you can call this "
16922 "function with names where you don't know if they are symbolic links already "
16923 "(albeit slightly less efficient)."
16924 msgstr ""
16925
16926 # type: textblock
16927 #. type: textblock
16928 #: ../src/guestfs-actions.pod:5494 ../fish/guestfish-actions.pod:3694
16929 msgid ""
16930 "This call is intended for programs that want to efficiently list a directory "
16931 "contents without making many round-trips.  Very long directory listings "
16932 "might cause the protocol message size to be exceeded, causing this call to "
16933 "fail.  The caller must split up such requests into smaller groups of names."
16934 msgstr ""
16935
16936 # type: =head2
16937 #. type: =head2
16938 #: ../src/guestfs-actions.pod:5507
16939 msgid "guestfs_realpath"
16940 msgstr ""
16941
16942 # type: verbatim
16943 #. type: verbatim
16944 #: ../src/guestfs-actions.pod:5509
16945 #, no-wrap
16946 msgid ""
16947 " char *\n"
16948 " guestfs_realpath (guestfs_h *g,\n"
16949 "                   const char *path);\n"
16950 "\n"
16951 msgstr ""
16952
16953 # type: textblock
16954 #. type: textblock
16955 #: ../src/guestfs-actions.pod:5513 ../fish/guestfish-actions.pod:3705
16956 msgid ""
16957 "Return the canonicalized absolute pathname of C<path>.  The returned path "
16958 "has no C<.>, C<..> or symbolic link path elements."
16959 msgstr ""
16960
16961 # type: =head2
16962 #. type: =head2
16963 #: ../src/guestfs-actions.pod:5521
16964 msgid "guestfs_removexattr"
16965 msgstr ""
16966
16967 # type: verbatim
16968 #. type: verbatim
16969 #: ../src/guestfs-actions.pod:5523
16970 #, no-wrap
16971 msgid ""
16972 " int\n"
16973 " guestfs_removexattr (guestfs_h *g,\n"
16974 "                      const char *xattr,\n"
16975 "                      const char *path);\n"
16976 "\n"
16977 msgstr ""
16978
16979 # type: textblock
16980 #. type: textblock
16981 #: ../src/guestfs-actions.pod:5528 ../fish/guestfish-actions.pod:3712
16982 msgid ""
16983 "This call removes the extended attribute named C<xattr> of the file C<path>."
16984 msgstr ""
16985
16986 # type: textblock
16987 #. type: textblock
16988 #: ../src/guestfs-actions.pod:5531
16989 msgid "See also: C<guestfs_lremovexattr>, L<attr(5)>."
16990 msgstr ""
16991
16992 # type: =head2
16993 #. type: =head2
16994 #: ../src/guestfs-actions.pod:5537
16995 msgid "guestfs_resize2fs"
16996 msgstr ""
16997
16998 # type: verbatim
16999 #. type: verbatim
17000 #: ../src/guestfs-actions.pod:5539
17001 #, no-wrap
17002 msgid ""
17003 " int\n"
17004 " guestfs_resize2fs (guestfs_h *g,\n"
17005 "                    const char *device);\n"
17006 "\n"
17007 msgstr ""
17008
17009 # type: textblock
17010 #. type: textblock
17011 #: ../src/guestfs-actions.pod:5543 ../fish/guestfish-actions.pod:3721
17012 msgid ""
17013 "This resizes an ext2, ext3 or ext4 filesystem to match the size of the "
17014 "underlying device."
17015 msgstr ""
17016
17017 # type: textblock
17018 #. type: textblock
17019 #: ../src/guestfs-actions.pod:5546
17020 msgid ""
17021 "I<Note:> It is sometimes required that you run C<guestfs_e2fsck_f> on the "
17022 "C<device> before calling this command.  For unknown reasons C<resize2fs> "
17023 "sometimes gives an error about this and sometimes not.  In any case, it is "
17024 "always safe to call C<guestfs_e2fsck_f> before calling this function."
17025 msgstr ""
17026
17027 #. type: =head2
17028 #: ../src/guestfs-actions.pod:5556
17029 msgid "guestfs_resize2fs_M"
17030 msgstr ""
17031
17032 #. type: verbatim
17033 #: ../src/guestfs-actions.pod:5558
17034 #, no-wrap
17035 msgid ""
17036 " int\n"
17037 " guestfs_resize2fs_M (guestfs_h *g,\n"
17038 "                      const char *device);\n"
17039 "\n"
17040 msgstr ""
17041
17042 #. type: textblock
17043 #: ../src/guestfs-actions.pod:5562
17044 msgid ""
17045 "This command is the same as C<guestfs_resize2fs>, but the filesystem is "
17046 "resized to its minimum size.  This works like the C<-M> option to the "
17047 "C<resize2fs> command."
17048 msgstr ""
17049
17050 #. type: textblock
17051 #: ../src/guestfs-actions.pod:5566
17052 msgid ""
17053 "To get the resulting size of the filesystem you should call "
17054 "C<guestfs_tune2fs_l> and read the C<Block size> and C<Block count> values.  "
17055 "These two numbers, multiplied together, give the resulting size of the "
17056 "minimal filesystem in bytes."
17057 msgstr ""
17058
17059 # type: =head2
17060 #. type: =head2
17061 #: ../src/guestfs-actions.pod:5573
17062 msgid "guestfs_resize2fs_size"
17063 msgstr ""
17064
17065 # type: verbatim
17066 #. type: verbatim
17067 #: ../src/guestfs-actions.pod:5575
17068 #, no-wrap
17069 msgid ""
17070 " int\n"
17071 " guestfs_resize2fs_size (guestfs_h *g,\n"
17072 "                         const char *device,\n"
17073 "                         int64_t size);\n"
17074 "\n"
17075 msgstr ""
17076
17077 # type: textblock
17078 #. type: textblock
17079 #: ../src/guestfs-actions.pod:5580
17080 msgid ""
17081 "This command is the same as C<guestfs_resize2fs> except that it allows you "
17082 "to specify the new size (in bytes) explicitly."
17083 msgstr ""
17084
17085 # type: =head2
17086 #. type: =head2
17087 #: ../src/guestfs-actions.pod:5587
17088 msgid "guestfs_rm"
17089 msgstr ""
17090
17091 # type: verbatim
17092 #. type: verbatim
17093 #: ../src/guestfs-actions.pod:5589
17094 #, no-wrap
17095 msgid ""
17096 " int\n"
17097 " guestfs_rm (guestfs_h *g,\n"
17098 "             const char *path);\n"
17099 "\n"
17100 msgstr ""
17101
17102 # type: textblock
17103 #. type: textblock
17104 #: ../src/guestfs-actions.pod:5593 ../fish/guestfish-actions.pod:3754
17105 msgid "Remove the single file C<path>."
17106 msgstr ""
17107
17108 # type: =head2
17109 #. type: =head2
17110 #: ../src/guestfs-actions.pod:5599
17111 msgid "guestfs_rm_rf"
17112 msgstr ""
17113
17114 # type: verbatim
17115 #. type: verbatim
17116 #: ../src/guestfs-actions.pod:5601
17117 #, no-wrap
17118 msgid ""
17119 " int\n"
17120 " guestfs_rm_rf (guestfs_h *g,\n"
17121 "                const char *path);\n"
17122 "\n"
17123 msgstr ""
17124
17125 # type: textblock
17126 #. type: textblock
17127 #: ../src/guestfs-actions.pod:5605 ../fish/guestfish-actions.pod:3760
17128 msgid ""
17129 "Remove the file or directory C<path>, recursively removing the contents if "
17130 "its a directory.  This is like the C<rm -rf> shell command."
17131 msgstr ""
17132
17133 # type: =head2
17134 #. type: =head2
17135 #: ../src/guestfs-actions.pod:5613
17136 msgid "guestfs_rmdir"
17137 msgstr ""
17138
17139 # type: verbatim
17140 #. type: verbatim
17141 #: ../src/guestfs-actions.pod:5615
17142 #, no-wrap
17143 msgid ""
17144 " int\n"
17145 " guestfs_rmdir (guestfs_h *g,\n"
17146 "                const char *path);\n"
17147 "\n"
17148 msgstr ""
17149
17150 # type: textblock
17151 #. type: textblock
17152 #: ../src/guestfs-actions.pod:5619 ../fish/guestfish-actions.pod:3768
17153 msgid "Remove the single directory C<path>."
17154 msgstr ""
17155
17156 # type: =head2
17157 #. type: =head2
17158 #: ../src/guestfs-actions.pod:5625
17159 msgid "guestfs_rmmountpoint"
17160 msgstr ""
17161
17162 # type: verbatim
17163 #. type: verbatim
17164 #: ../src/guestfs-actions.pod:5627
17165 #, no-wrap
17166 msgid ""
17167 " int\n"
17168 " guestfs_rmmountpoint (guestfs_h *g,\n"
17169 "                       const char *exemptpath);\n"
17170 "\n"
17171 msgstr ""
17172
17173 # type: textblock
17174 #. type: textblock
17175 #: ../src/guestfs-actions.pod:5631
17176 msgid ""
17177 "This calls removes a mountpoint that was previously created with "
17178 "C<guestfs_mkmountpoint>.  See C<guestfs_mkmountpoint> for full details."
17179 msgstr ""
17180
17181 # type: =head2
17182 #. type: =head2
17183 #: ../src/guestfs-actions.pod:5639
17184 msgid "guestfs_scrub_device"
17185 msgstr ""
17186
17187 # type: verbatim
17188 #. type: verbatim
17189 #: ../src/guestfs-actions.pod:5641
17190 #, no-wrap
17191 msgid ""
17192 " int\n"
17193 " guestfs_scrub_device (guestfs_h *g,\n"
17194 "                       const char *device);\n"
17195 "\n"
17196 msgstr ""
17197
17198 # type: textblock
17199 #. type: textblock
17200 #: ../src/guestfs-actions.pod:5645 ../fish/guestfish-actions.pod:3782
17201 msgid ""
17202 "This command writes patterns over C<device> to make data retrieval more "
17203 "difficult."
17204 msgstr ""
17205
17206 # type: textblock
17207 #. type: textblock
17208 #: ../src/guestfs-actions.pod:5648 ../src/guestfs-actions.pod:5669
17209 #: ../src/guestfs-actions.pod:5688 ../fish/guestfish-actions.pod:3785
17210 #: ../fish/guestfish-actions.pod:3800 ../fish/guestfish-actions.pod:3813
17211 msgid ""
17212 "It is an interface to the L<scrub(1)> program.  See that manual page for "
17213 "more details."
17214 msgstr ""
17215
17216 # type: textblock
17217 #. type: textblock
17218 #: ../src/guestfs-actions.pod:5656 ../src/guestfs-actions.pod:5674
17219 #: ../src/guestfs-actions.pod:5693
17220 msgid "(Added in 1.0.52)"
17221 msgstr ""
17222
17223 # type: =head2
17224 #. type: =head2
17225 #: ../src/guestfs-actions.pod:5658
17226 msgid "guestfs_scrub_file"
17227 msgstr ""
17228
17229 # type: verbatim
17230 #. type: verbatim
17231 #: ../src/guestfs-actions.pod:5660
17232 #, no-wrap
17233 msgid ""
17234 " int\n"
17235 " guestfs_scrub_file (guestfs_h *g,\n"
17236 "                     const char *file);\n"
17237 "\n"
17238 msgstr ""
17239
17240 # type: textblock
17241 #. type: textblock
17242 #: ../src/guestfs-actions.pod:5664 ../fish/guestfish-actions.pod:3795
17243 msgid ""
17244 "This command writes patterns over a file to make data retrieval more "
17245 "difficult."
17246 msgstr ""
17247
17248 # type: textblock
17249 #. type: textblock
17250 #: ../src/guestfs-actions.pod:5667 ../fish/guestfish-actions.pod:3798
17251 msgid "The file is I<removed> after scrubbing."
17252 msgstr ""
17253
17254 # type: =head2
17255 #. type: =head2
17256 #: ../src/guestfs-actions.pod:5676
17257 msgid "guestfs_scrub_freespace"
17258 msgstr ""
17259
17260 # type: verbatim
17261 #. type: verbatim
17262 #: ../src/guestfs-actions.pod:5678
17263 #, no-wrap
17264 msgid ""
17265 " int\n"
17266 " guestfs_scrub_freespace (guestfs_h *g,\n"
17267 "                          const char *dir);\n"
17268 "\n"
17269 msgstr ""
17270
17271 # type: textblock
17272 #. type: textblock
17273 #: ../src/guestfs-actions.pod:5682
17274 msgid ""
17275 "This command creates the directory C<dir> and then fills it with files until "
17276 "the filesystem is full, and scrubs the files as for C<guestfs_scrub_file>, "
17277 "and deletes them.  The intention is to scrub any free space on the partition "
17278 "containing C<dir>."
17279 msgstr ""
17280
17281 # type: =head2
17282 #. type: =head2
17283 #: ../src/guestfs-actions.pod:5695
17284 msgid "guestfs_set_append"
17285 msgstr ""
17286
17287 # type: verbatim
17288 #. type: verbatim
17289 #: ../src/guestfs-actions.pod:5697
17290 #, no-wrap
17291 msgid ""
17292 " int\n"
17293 " guestfs_set_append (guestfs_h *g,\n"
17294 "                     const char *append);\n"
17295 "\n"
17296 msgstr ""
17297
17298 # type: textblock
17299 #. type: textblock
17300 #: ../src/guestfs-actions.pod:5701 ../fish/guestfish-actions.pod:3822
17301 msgid ""
17302 "This function is used to add additional options to the guest kernel command "
17303 "line."
17304 msgstr ""
17305
17306 # type: textblock
17307 #. type: textblock
17308 #: ../src/guestfs-actions.pod:5704 ../fish/guestfish-actions.pod:3825
17309 msgid ""
17310 "The default is C<NULL> unless overridden by setting C<LIBGUESTFS_APPEND> "
17311 "environment variable."
17312 msgstr ""
17313
17314 # type: textblock
17315 #. type: textblock
17316 #: ../src/guestfs-actions.pod:5707 ../fish/guestfish-actions.pod:3828
17317 msgid ""
17318 "Setting C<append> to C<NULL> means I<no> additional options are passed "
17319 "(libguestfs always adds a few of its own)."
17320 msgstr ""
17321
17322 #. type: =head2
17323 #: ../src/guestfs-actions.pod:5714
17324 msgid "guestfs_set_attach_method"
17325 msgstr ""
17326
17327 #. type: verbatim
17328 #: ../src/guestfs-actions.pod:5716
17329 #, no-wrap
17330 msgid ""
17331 " int\n"
17332 " guestfs_set_attach_method (guestfs_h *g,\n"
17333 "                            const char *attachmethod);\n"
17334 "\n"
17335 msgstr ""
17336
17337 #. type: textblock
17338 #: ../src/guestfs-actions.pod:5720 ../fish/guestfish-actions.pod:3837
17339 msgid ""
17340 "Set the method that libguestfs uses to connect to the back end guestfsd "
17341 "daemon.  Possible methods are:"
17342 msgstr ""
17343
17344 #. type: textblock
17345 #: ../src/guestfs-actions.pod:5727 ../fish/guestfish-actions.pod:3844
17346 msgid ""
17347 "Launch an appliance and connect to it.  This is the ordinary method and the "
17348 "default."
17349 msgstr ""
17350
17351 #. type: =item
17352 #: ../src/guestfs-actions.pod:5730 ../fish/guestfish-actions.pod:3847
17353 msgid "C<unix:I<path>>"
17354 msgstr ""
17355
17356 #. type: textblock
17357 #: ../src/guestfs-actions.pod:5732 ../fish/guestfish-actions.pod:3849
17358 msgid "Connect to the Unix domain socket I<path>."
17359 msgstr ""
17360
17361 #. type: textblock
17362 #: ../src/guestfs-actions.pod:5734 ../fish/guestfish-actions.pod:3851
17363 msgid ""
17364 "This method lets you connect to an existing daemon or (using virtio-serial) "
17365 "to a live guest.  For more information, see L<guestfs(3)/ATTACHING TO "
17366 "RUNNING DAEMONS>."
17367 msgstr ""
17368
17369 # type: =head2
17370 #. type: =head2
17371 #: ../src/guestfs-actions.pod:5742
17372 msgid "guestfs_set_autosync"
17373 msgstr ""
17374
17375 # type: verbatim
17376 #. type: verbatim
17377 #: ../src/guestfs-actions.pod:5744
17378 #, no-wrap
17379 msgid ""
17380 " int\n"
17381 " guestfs_set_autosync (guestfs_h *g,\n"
17382 "                       int autosync);\n"
17383 "\n"
17384 msgstr ""
17385
17386 #. type: textblock
17387 #: ../src/guestfs-actions.pod:5748 ../fish/guestfish-actions.pod:3863
17388 msgid ""
17389 "If C<autosync> is true, this enables autosync.  Libguestfs will make a best "
17390 "effort attempt to make filesystems consistent and synchronized when the "
17391 "handle is closed (also if the program exits without closing handles)."
17392 msgstr ""
17393
17394 # type: textblock
17395 #. type: textblock
17396 #: ../src/guestfs-actions.pod:5753 ../fish/guestfish-actions.pod:3868
17397 msgid ""
17398 "This is enabled by default (since libguestfs 1.5.24, previously it was "
17399 "disabled by default)."
17400 msgstr ""
17401
17402 # type: =head2
17403 #. type: =head2
17404 #: ../src/guestfs-actions.pod:5760
17405 msgid "guestfs_set_direct"
17406 msgstr ""
17407
17408 # type: verbatim
17409 #. type: verbatim
17410 #: ../src/guestfs-actions.pod:5762
17411 #, no-wrap
17412 msgid ""
17413 " int\n"
17414 " guestfs_set_direct (guestfs_h *g,\n"
17415 "                     int direct);\n"
17416 "\n"
17417 msgstr ""
17418
17419 # type: textblock
17420 #. type: textblock
17421 #: ../src/guestfs-actions.pod:5766 ../fish/guestfish-actions.pod:3877
17422 msgid ""
17423 "If the direct appliance mode flag is enabled, then stdin and stdout are "
17424 "passed directly through to the appliance once it is launched."
17425 msgstr ""
17426
17427 # type: textblock
17428 #. type: textblock
17429 #: ../src/guestfs-actions.pod:5770
17430 msgid ""
17431 "One consequence of this is that log messages aren't caught by the library "
17432 "and handled by C<guestfs_set_log_message_callback>, but go straight to "
17433 "stdout."
17434 msgstr ""
17435
17436 # type: textblock
17437 #. type: textblock
17438 #: ../src/guestfs-actions.pod:5774 ../fish/guestfish-actions.pod:3885
17439 msgid "You probably don't want to use this unless you know what you are doing."
17440 msgstr ""
17441
17442 # type: textblock
17443 #. type: textblock
17444 #: ../src/guestfs-actions.pod:5777 ../fish/guestfish-actions.pod:3888
17445 msgid "The default is disabled."
17446 msgstr ""
17447
17448 # type: =head2
17449 #. type: =head2
17450 #: ../src/guestfs-actions.pod:5783
17451 msgid "guestfs_set_e2label"
17452 msgstr ""
17453
17454 # type: verbatim
17455 #. type: verbatim
17456 #: ../src/guestfs-actions.pod:5785
17457 #, no-wrap
17458 msgid ""
17459 " int\n"
17460 " guestfs_set_e2label (guestfs_h *g,\n"
17461 "                      const char *device,\n"
17462 "                      const char *label);\n"
17463 "\n"
17464 msgstr ""
17465
17466 # type: textblock
17467 #. type: textblock
17468 #: ../src/guestfs-actions.pod:5790 ../fish/guestfish-actions.pod:3894
17469 msgid ""
17470 "This sets the ext2/3/4 filesystem label of the filesystem on C<device> to "
17471 "C<label>.  Filesystem labels are limited to 16 characters."
17472 msgstr ""
17473
17474 # type: textblock
17475 #. type: textblock
17476 #: ../src/guestfs-actions.pod:5794
17477 msgid ""
17478 "You can use either C<guestfs_tune2fs_l> or C<guestfs_get_e2label> to return "
17479 "the existing label on a filesystem."
17480 msgstr ""
17481
17482 # type: =head2
17483 #. type: =head2
17484 #: ../src/guestfs-actions.pod:5801
17485 msgid "guestfs_set_e2uuid"
17486 msgstr ""
17487
17488 # type: verbatim
17489 #. type: verbatim
17490 #: ../src/guestfs-actions.pod:5803
17491 #, no-wrap
17492 msgid ""
17493 " int\n"
17494 " guestfs_set_e2uuid (guestfs_h *g,\n"
17495 "                     const char *device,\n"
17496 "                     const char *uuid);\n"
17497 "\n"
17498 msgstr ""
17499
17500 # type: textblock
17501 #. type: textblock
17502 #: ../src/guestfs-actions.pod:5808 ../fish/guestfish-actions.pod:3905
17503 msgid ""
17504 "This sets the ext2/3/4 filesystem UUID of the filesystem on C<device> to "
17505 "C<uuid>.  The format of the UUID and alternatives such as C<clear>, "
17506 "C<random> and C<time> are described in the L<tune2fs(8)> manpage."
17507 msgstr ""
17508
17509 # type: textblock
17510 #. type: textblock
17511 #: ../src/guestfs-actions.pod:5813
17512 msgid ""
17513 "You can use either C<guestfs_tune2fs_l> or C<guestfs_get_e2uuid> to return "
17514 "the existing UUID of a filesystem."
17515 msgstr ""
17516
17517 # type: =head2
17518 #. type: =head2
17519 #: ../src/guestfs-actions.pod:5820
17520 msgid "guestfs_set_memsize"
17521 msgstr ""
17522
17523 # type: verbatim
17524 #. type: verbatim
17525 #: ../src/guestfs-actions.pod:5822
17526 #, no-wrap
17527 msgid ""
17528 " int\n"
17529 " guestfs_set_memsize (guestfs_h *g,\n"
17530 "                      int memsize);\n"
17531 "\n"
17532 msgstr ""
17533
17534 # type: textblock
17535 #. type: textblock
17536 #: ../src/guestfs-actions.pod:5826
17537 msgid ""
17538 "This sets the memory size in megabytes allocated to the qemu subprocess.  "
17539 "This only has any effect if called before C<guestfs_launch>."
17540 msgstr ""
17541
17542 # type: textblock
17543 #. type: textblock
17544 #: ../src/guestfs-actions.pod:5830 ../fish/guestfish-actions.pod:3923
17545 msgid ""
17546 "You can also change this by setting the environment variable "
17547 "C<LIBGUESTFS_MEMSIZE> before the handle is created."
17548 msgstr ""
17549
17550 # type: =head2
17551 #. type: =head2
17552 #: ../src/guestfs-actions.pod:5841
17553 msgid "guestfs_set_network"
17554 msgstr ""
17555
17556 # type: verbatim
17557 #. type: verbatim
17558 #: ../src/guestfs-actions.pod:5843
17559 #, no-wrap
17560 msgid ""
17561 " int\n"
17562 " guestfs_set_network (guestfs_h *g,\n"
17563 "                      int network);\n"
17564 "\n"
17565 msgstr ""
17566
17567 # type: textblock
17568 #. type: textblock
17569 #: ../src/guestfs-actions.pod:5847 ../fish/guestfish-actions.pod:3936
17570 msgid ""
17571 "If C<network> is true, then the network is enabled in the libguestfs "
17572 "appliance.  The default is false."
17573 msgstr ""
17574
17575 # type: textblock
17576 #. type: textblock
17577 #: ../src/guestfs-actions.pod:5850 ../fish/guestfish-actions.pod:3939
17578 msgid ""
17579 "This affects whether commands are able to access the network (see L<guestfs"
17580 "(3)/RUNNING COMMANDS>)."
17581 msgstr ""
17582
17583 # type: textblock
17584 #. type: textblock
17585 #: ../src/guestfs-actions.pod:5853
17586 msgid ""
17587 "You must call this before calling C<guestfs_launch>, otherwise it has no "
17588 "effect."
17589 msgstr ""
17590
17591 # type: =head2
17592 #. type: =head2
17593 #: ../src/guestfs-actions.pod:5860
17594 msgid "guestfs_set_path"
17595 msgstr ""
17596
17597 # type: verbatim
17598 #. type: verbatim
17599 #: ../src/guestfs-actions.pod:5862
17600 #, no-wrap
17601 msgid ""
17602 " int\n"
17603 " guestfs_set_path (guestfs_h *g,\n"
17604 "                   const char *searchpath);\n"
17605 "\n"
17606 msgstr ""
17607
17608 # type: textblock
17609 #. type: textblock
17610 #: ../src/guestfs-actions.pod:5866 ../fish/guestfish-actions.pod:3951
17611 msgid "Set the path that libguestfs searches for kernel and initrd.img."
17612 msgstr ""
17613
17614 # type: textblock
17615 #. type: textblock
17616 #: ../src/guestfs-actions.pod:5868 ../fish/guestfish-actions.pod:3953
17617 msgid ""
17618 "The default is C<$libdir/guestfs> unless overridden by setting "
17619 "C<LIBGUESTFS_PATH> environment variable."
17620 msgstr ""
17621
17622 # type: textblock
17623 #. type: textblock
17624 #: ../src/guestfs-actions.pod:5871 ../fish/guestfish-actions.pod:3956
17625 msgid "Setting C<path> to C<NULL> restores the default path."
17626 msgstr ""
17627
17628 # type: =head2
17629 #. type: =head2
17630 #: ../src/guestfs-actions.pod:5877
17631 msgid "guestfs_set_qemu"
17632 msgstr ""
17633
17634 # type: verbatim
17635 #. type: verbatim
17636 #: ../src/guestfs-actions.pod:5879
17637 #, no-wrap
17638 msgid ""
17639 " int\n"
17640 " guestfs_set_qemu (guestfs_h *g,\n"
17641 "                   const char *qemu);\n"
17642 "\n"
17643 msgstr ""
17644
17645 # type: textblock
17646 #. type: textblock
17647 #: ../src/guestfs-actions.pod:5883 ../fish/guestfish-actions.pod:3964
17648 msgid "Set the qemu binary that we will use."
17649 msgstr ""
17650
17651 # type: textblock
17652 #. type: textblock
17653 #: ../src/guestfs-actions.pod:5885 ../fish/guestfish-actions.pod:3966
17654 msgid ""
17655 "The default is chosen when the library was compiled by the configure script."
17656 msgstr ""
17657
17658 # type: textblock
17659 #. type: textblock
17660 #: ../src/guestfs-actions.pod:5888 ../fish/guestfish-actions.pod:3969
17661 msgid ""
17662 "You can also override this by setting the C<LIBGUESTFS_QEMU> environment "
17663 "variable."
17664 msgstr ""
17665
17666 # type: textblock
17667 #. type: textblock
17668 #: ../src/guestfs-actions.pod:5891 ../fish/guestfish-actions.pod:3972
17669 msgid "Setting C<qemu> to C<NULL> restores the default qemu binary."
17670 msgstr ""
17671
17672 # type: textblock
17673 #. type: textblock
17674 #: ../src/guestfs-actions.pod:5893 ../fish/guestfish-actions.pod:3974
17675 msgid ""
17676 "Note that you should call this function as early as possible after creating "
17677 "the handle.  This is because some pre-launch operations depend on testing "
17678 "qemu features (by running C<qemu -help>).  If the qemu binary changes, we "
17679 "don't retest features, and so you might see inconsistent results.  Using the "
17680 "environment variable C<LIBGUESTFS_QEMU> is safest of all since that picks "
17681 "the qemu binary at the same time as the handle is created."
17682 msgstr ""
17683
17684 # type: =head2
17685 #. type: =head2
17686 #: ../src/guestfs-actions.pod:5905
17687 msgid "guestfs_set_recovery_proc"
17688 msgstr ""
17689
17690 # type: verbatim
17691 #. type: verbatim
17692 #: ../src/guestfs-actions.pod:5907
17693 #, no-wrap
17694 msgid ""
17695 " int\n"
17696 " guestfs_set_recovery_proc (guestfs_h *g,\n"
17697 "                            int recoveryproc);\n"
17698 "\n"
17699 msgstr ""
17700
17701 # type: textblock
17702 #. type: textblock
17703 #: ../src/guestfs-actions.pod:5911
17704 msgid ""
17705 "If this is called with the parameter C<false> then C<guestfs_launch> does "
17706 "not create a recovery process.  The purpose of the recovery process is to "
17707 "stop runaway qemu processes in the case where the main program aborts "
17708 "abruptly."
17709 msgstr ""
17710
17711 # type: textblock
17712 #. type: textblock
17713 #: ../src/guestfs-actions.pod:5916
17714 msgid ""
17715 "This only has any effect if called before C<guestfs_launch>, and the default "
17716 "is true."
17717 msgstr ""
17718
17719 # type: textblock
17720 #. type: textblock
17721 #: ../src/guestfs-actions.pod:5919 ../fish/guestfish-actions.pod:3996
17722 msgid ""
17723 "About the only time when you would want to disable this is if the main "
17724 "process will fork itself into the background (\"daemonize\" itself).  In "
17725 "this case the recovery process thinks that the main program has disappeared "
17726 "and so kills qemu, which is not very helpful."
17727 msgstr ""
17728
17729 # type: =head2
17730 #. type: =head2
17731 #: ../src/guestfs-actions.pod:5929
17732 msgid "guestfs_set_selinux"
17733 msgstr ""
17734
17735 # type: verbatim
17736 #. type: verbatim
17737 #: ../src/guestfs-actions.pod:5931
17738 #, no-wrap
17739 msgid ""
17740 " int\n"
17741 " guestfs_set_selinux (guestfs_h *g,\n"
17742 "                      int selinux);\n"
17743 "\n"
17744 msgstr ""
17745
17746 # type: textblock
17747 #. type: textblock
17748 #: ../src/guestfs-actions.pod:5935 ../fish/guestfish-actions.pod:4008
17749 msgid ""
17750 "This sets the selinux flag that is passed to the appliance at boot time.  "
17751 "The default is C<selinux=0> (disabled)."
17752 msgstr ""
17753
17754 # type: textblock
17755 #. type: textblock
17756 #: ../src/guestfs-actions.pod:5938 ../fish/guestfish-actions.pod:4011
17757 msgid ""
17758 "Note that if SELinux is enabled, it is always in Permissive mode "
17759 "(C<enforcing=0>)."
17760 msgstr ""
17761
17762 # type: =head2
17763 #. type: =head2
17764 #: ../src/guestfs-actions.pod:5948
17765 msgid "guestfs_set_trace"
17766 msgstr ""
17767
17768 # type: verbatim
17769 #. type: verbatim
17770 #: ../src/guestfs-actions.pod:5950
17771 #, no-wrap
17772 msgid ""
17773 " int\n"
17774 " guestfs_set_trace (guestfs_h *g,\n"
17775 "                    int trace);\n"
17776 "\n"
17777 msgstr ""
17778
17779 #. type: textblock
17780 #: ../src/guestfs-actions.pod:5954 ../fish/guestfish-actions.pod:4023
17781 msgid ""
17782 "If the command trace flag is set to 1, then libguestfs calls, parameters and "
17783 "return values are traced."
17784 msgstr ""
17785
17786 # type: textblock
17787 #. type: textblock
17788 #: ../src/guestfs-actions.pod:5957 ../fish/guestfish-actions.pod:4026
17789 msgid ""
17790 "If you want to trace C API calls into libguestfs (and other libraries) then "
17791 "possibly a better way is to use the external ltrace(1) command."
17792 msgstr ""
17793
17794 # type: textblock
17795 #. type: textblock
17796 #: ../src/guestfs-actions.pod:5961 ../fish/guestfish-actions.pod:4030
17797 msgid ""
17798 "Command traces are disabled unless the environment variable "
17799 "C<LIBGUESTFS_TRACE> is defined and set to C<1>."
17800 msgstr ""
17801
17802 #. type: textblock
17803 #: ../src/guestfs-actions.pod:5964
17804 msgid ""
17805 "Trace messages are normally sent to C<stderr>, unless you register a "
17806 "callback to send them somewhere else (see C<guestfs_set_event_callback>)."
17807 msgstr ""
17808
17809 # type: =head2
17810 #. type: =head2
17811 #: ../src/guestfs-actions.pod:5972
17812 msgid "guestfs_set_verbose"
17813 msgstr ""
17814
17815 # type: verbatim
17816 #. type: verbatim
17817 #: ../src/guestfs-actions.pod:5974
17818 #, no-wrap
17819 msgid ""
17820 " int\n"
17821 " guestfs_set_verbose (guestfs_h *g,\n"
17822 "                      int verbose);\n"
17823 "\n"
17824 msgstr ""
17825
17826 #. type: textblock
17827 #: ../src/guestfs-actions.pod:5978 ../fish/guestfish-actions.pod:4043
17828 msgid "If C<verbose> is true, this turns on verbose messages."
17829 msgstr ""
17830
17831 # type: textblock
17832 #. type: textblock
17833 #: ../src/guestfs-actions.pod:5980 ../fish/guestfish-actions.pod:4045
17834 msgid ""
17835 "Verbose messages are disabled unless the environment variable "
17836 "C<LIBGUESTFS_DEBUG> is defined and set to C<1>."
17837 msgstr ""
17838
17839 #. type: textblock
17840 #: ../src/guestfs-actions.pod:5983
17841 msgid ""
17842 "Verbose messages are normally sent to C<stderr>, unless you register a "
17843 "callback to send them somewhere else (see C<guestfs_set_event_callback>)."
17844 msgstr ""
17845
17846 # type: =head2
17847 #. type: =head2
17848 #: ../src/guestfs-actions.pod:5991
17849 msgid "guestfs_setcon"
17850 msgstr ""
17851
17852 # type: verbatim
17853 #. type: verbatim
17854 #: ../src/guestfs-actions.pod:5993
17855 #, no-wrap
17856 msgid ""
17857 " int\n"
17858 " guestfs_setcon (guestfs_h *g,\n"
17859 "                 const char *context);\n"
17860 "\n"
17861 msgstr ""
17862
17863 # type: textblock
17864 #. type: textblock
17865 #: ../src/guestfs-actions.pod:5997 ../fish/guestfish-actions.pod:4056
17866 msgid ""
17867 "This sets the SELinux security context of the daemon to the string "
17868 "C<context>."
17869 msgstr ""
17870
17871 # type: textblock
17872 #. type: textblock
17873 #: ../src/guestfs-actions.pod:6000 ../fish/guestfish-actions.pod:4059
17874 msgid "See the documentation about SELINUX in L<guestfs(3)>."
17875 msgstr ""
17876
17877 # type: =head2
17878 #. type: =head2
17879 #: ../src/guestfs-actions.pod:6006
17880 msgid "guestfs_setxattr"
17881 msgstr ""
17882
17883 # type: verbatim
17884 #. type: verbatim
17885 #: ../src/guestfs-actions.pod:6008
17886 #, no-wrap
17887 msgid ""
17888 " int\n"
17889 " guestfs_setxattr (guestfs_h *g,\n"
17890 "                   const char *xattr,\n"
17891 "                   const char *val,\n"
17892 "                   int vallen,\n"
17893 "                   const char *path);\n"
17894 "\n"
17895 msgstr ""
17896
17897 # type: textblock
17898 #. type: textblock
17899 #: ../src/guestfs-actions.pod:6015 ../fish/guestfish-actions.pod:4065
17900 msgid ""
17901 "This call sets the extended attribute named C<xattr> of the file C<path> to "
17902 "the value C<val> (of length C<vallen>).  The value is arbitrary 8 bit data."
17903 msgstr ""
17904
17905 # type: textblock
17906 #. type: textblock
17907 #: ../src/guestfs-actions.pod:6019
17908 msgid "See also: C<guestfs_lsetxattr>, L<attr(5)>."
17909 msgstr ""
17910
17911 # type: =head2
17912 #. type: =head2
17913 #: ../src/guestfs-actions.pod:6025
17914 msgid "guestfs_sfdisk"
17915 msgstr ""
17916
17917 # type: verbatim
17918 #. type: verbatim
17919 #: ../src/guestfs-actions.pod:6027
17920 #, no-wrap
17921 msgid ""
17922 " int\n"
17923 " guestfs_sfdisk (guestfs_h *g,\n"
17924 "                 const char *device,\n"
17925 "                 int cyls,\n"
17926 "                 int heads,\n"
17927 "                 int sectors,\n"
17928 "                 char *const *lines);\n"
17929 "\n"
17930 msgstr ""
17931
17932 # type: textblock
17933 #. type: textblock
17934 #: ../src/guestfs-actions.pod:6035 ../fish/guestfish-actions.pod:4075
17935 msgid ""
17936 "This is a direct interface to the L<sfdisk(8)> program for creating "
17937 "partitions on block devices."
17938 msgstr ""
17939
17940 # type: textblock
17941 #. type: textblock
17942 #: ../src/guestfs-actions.pod:6038 ../fish/guestfish-actions.pod:4078
17943 msgid "C<device> should be a block device, for example C</dev/sda>."
17944 msgstr ""
17945
17946 # type: textblock
17947 #. type: textblock
17948 #: ../src/guestfs-actions.pod:6040 ../fish/guestfish-actions.pod:4080
17949 msgid ""
17950 "C<cyls>, C<heads> and C<sectors> are the number of cylinders, heads and "
17951 "sectors on the device, which are passed directly to sfdisk as the I<-C>, I<-"
17952 "H> and I<-S> parameters.  If you pass C<0> for any of these, then the "
17953 "corresponding parameter is omitted.  Usually for 'large' disks, you can just "
17954 "pass C<0> for these, but for small (floppy-sized) disks, sfdisk (or rather, "
17955 "the kernel) cannot work out the right geometry and you will need to tell it."
17956 msgstr ""
17957
17958 # type: textblock
17959 #. type: textblock
17960 #: ../src/guestfs-actions.pod:6048 ../fish/guestfish-actions.pod:4088
17961 msgid ""
17962 "C<lines> is a list of lines that we feed to C<sfdisk>.  For more information "
17963 "refer to the L<sfdisk(8)> manpage."
17964 msgstr ""
17965
17966 # type: textblock
17967 #. type: textblock
17968 #: ../src/guestfs-actions.pod:6051 ../fish/guestfish-actions.pod:4091
17969 msgid ""
17970 "To create a single partition occupying the whole disk, you would pass "
17971 "C<lines> as a single element list, when the single element being the string "
17972 "C<,> (comma)."
17973 msgstr ""
17974
17975 # type: textblock
17976 #. type: textblock
17977 #: ../src/guestfs-actions.pod:6055
17978 msgid ""
17979 "See also: C<guestfs_sfdisk_l>, C<guestfs_sfdisk_N>, C<guestfs_part_init>"
17980 msgstr ""
17981
17982 # type: =head2
17983 #. type: =head2
17984 #: ../src/guestfs-actions.pod:6065
17985 msgid "guestfs_sfdiskM"
17986 msgstr ""
17987
17988 # type: verbatim
17989 #. type: verbatim
17990 #: ../src/guestfs-actions.pod:6067
17991 #, no-wrap
17992 msgid ""
17993 " int\n"
17994 " guestfs_sfdiskM (guestfs_h *g,\n"
17995 "                  const char *device,\n"
17996 "                  char *const *lines);\n"
17997 "\n"
17998 msgstr ""
17999
18000 # type: textblock
18001 #. type: textblock
18002 #: ../src/guestfs-actions.pod:6072
18003 msgid ""
18004 "This is a simplified interface to the C<guestfs_sfdisk> command, where "
18005 "partition sizes are specified in megabytes only (rounded to the nearest "
18006 "cylinder) and you don't need to specify the cyls, heads and sectors "
18007 "parameters which were rarely if ever used anyway."
18008 msgstr ""
18009
18010 # type: textblock
18011 #. type: textblock
18012 #: ../src/guestfs-actions.pod:6078
18013 msgid ""
18014 "See also: C<guestfs_sfdisk>, the L<sfdisk(8)> manpage and "
18015 "C<guestfs_part_disk>"
18016 msgstr ""
18017
18018 # type: =head2
18019 #. type: =head2
18020 #: ../src/guestfs-actions.pod:6088
18021 msgid "guestfs_sfdisk_N"
18022 msgstr ""
18023
18024 # type: verbatim
18025 #. type: verbatim
18026 #: ../src/guestfs-actions.pod:6090
18027 #, no-wrap
18028 msgid ""
18029 " int\n"
18030 " guestfs_sfdisk_N (guestfs_h *g,\n"
18031 "                   const char *device,\n"
18032 "                   int partnum,\n"
18033 "                   int cyls,\n"
18034 "                   int heads,\n"
18035 "                   int sectors,\n"
18036 "                   const char *line);\n"
18037 "\n"
18038 msgstr ""
18039
18040 # type: textblock
18041 #. type: textblock
18042 #: ../src/guestfs-actions.pod:6099 ../fish/guestfish-actions.pod:4121
18043 msgid ""
18044 "This runs L<sfdisk(8)> option to modify just the single partition C<n> "
18045 "(note: C<n> counts from 1)."
18046 msgstr ""
18047
18048 # type: textblock
18049 #. type: textblock
18050 #: ../src/guestfs-actions.pod:6102
18051 msgid ""
18052 "For other parameters, see C<guestfs_sfdisk>.  You should usually pass C<0> "
18053 "for the cyls/heads/sectors parameters."
18054 msgstr ""
18055
18056 # type: textblock
18057 #. type: textblock
18058 #: ../src/guestfs-actions.pod:6105
18059 msgid "See also: C<guestfs_part_add>"
18060 msgstr ""
18061
18062 # type: =head2
18063 #. type: =head2
18064 #: ../src/guestfs-actions.pod:6114
18065 msgid "guestfs_sfdisk_disk_geometry"
18066 msgstr ""
18067
18068 # type: verbatim
18069 #. type: verbatim
18070 #: ../src/guestfs-actions.pod:6116
18071 #, no-wrap
18072 msgid ""
18073 " char *\n"
18074 " guestfs_sfdisk_disk_geometry (guestfs_h *g,\n"
18075 "                               const char *device);\n"
18076 "\n"
18077 msgstr ""
18078
18079 # type: textblock
18080 #. type: textblock
18081 #: ../src/guestfs-actions.pod:6120
18082 msgid ""
18083 "This displays the disk geometry of C<device> read from the partition table.  "
18084 "Especially in the case where the underlying block device has been resized, "
18085 "this can be different from the kernel's idea of the geometry (see "
18086 "C<guestfs_sfdisk_kernel_geometry>)."
18087 msgstr ""
18088
18089 # type: textblock
18090 #. type: textblock
18091 #: ../src/guestfs-actions.pod:6125 ../src/guestfs-actions.pod:6141
18092 #: ../fish/guestfish-actions.pod:4141 ../fish/guestfish-actions.pod:4150
18093 msgid "The result is in human-readable format, and not designed to be parsed."
18094 msgstr ""
18095
18096 # type: =head2
18097 #. type: =head2
18098 #: ../src/guestfs-actions.pod:6133
18099 msgid "guestfs_sfdisk_kernel_geometry"
18100 msgstr ""
18101
18102 # type: verbatim
18103 #. type: verbatim
18104 #: ../src/guestfs-actions.pod:6135
18105 #, no-wrap
18106 msgid ""
18107 " char *\n"
18108 " guestfs_sfdisk_kernel_geometry (guestfs_h *g,\n"
18109 "                                 const char *device);\n"
18110 "\n"
18111 msgstr ""
18112
18113 # type: textblock
18114 #. type: textblock
18115 #: ../src/guestfs-actions.pod:6139 ../fish/guestfish-actions.pod:4148
18116 msgid "This displays the kernel's idea of the geometry of C<device>."
18117 msgstr ""
18118
18119 # type: =head2
18120 #. type: =head2
18121 #: ../src/guestfs-actions.pod:6149
18122 msgid "guestfs_sfdisk_l"
18123 msgstr ""
18124
18125 # type: verbatim
18126 #. type: verbatim
18127 #: ../src/guestfs-actions.pod:6151
18128 #, no-wrap
18129 msgid ""
18130 " char *\n"
18131 " guestfs_sfdisk_l (guestfs_h *g,\n"
18132 "                   const char *device);\n"
18133 "\n"
18134 msgstr ""
18135
18136 # type: textblock
18137 #. type: textblock
18138 #: ../src/guestfs-actions.pod:6155 ../fish/guestfish-actions.pod:4157
18139 msgid ""
18140 "This displays the partition table on C<device>, in the human-readable output "
18141 "of the L<sfdisk(8)> command.  It is not intended to be parsed."
18142 msgstr ""
18143
18144 # type: textblock
18145 #. type: textblock
18146 #: ../src/guestfs-actions.pod:6159
18147 msgid "See also: C<guestfs_part_list>"
18148 msgstr ""
18149
18150 # type: =head2
18151 #. type: =head2
18152 #: ../src/guestfs-actions.pod:6166
18153 msgid "guestfs_sh"
18154 msgstr ""
18155
18156 # type: verbatim
18157 #. type: verbatim
18158 #: ../src/guestfs-actions.pod:6168
18159 #, no-wrap
18160 msgid ""
18161 " char *\n"
18162 " guestfs_sh (guestfs_h *g,\n"
18163 "             const char *command);\n"
18164 "\n"
18165 msgstr ""
18166
18167 # type: textblock
18168 #. type: textblock
18169 #: ../src/guestfs-actions.pod:6172 ../fish/guestfish-actions.pod:4167
18170 msgid ""
18171 "This call runs a command from the guest filesystem via the guest's C</bin/"
18172 "sh>."
18173 msgstr ""
18174
18175 # type: textblock
18176 #. type: textblock
18177 #: ../src/guestfs-actions.pod:6175
18178 msgid "This is like C<guestfs_command>, but passes the command to:"
18179 msgstr ""
18180
18181 # type: verbatim
18182 #. type: verbatim
18183 #: ../src/guestfs-actions.pod:6177 ../fish/guestfish-actions.pod:4172
18184 #, no-wrap
18185 msgid ""
18186 " /bin/sh -c \"command\"\n"
18187 "\n"
18188 msgstr ""
18189
18190 # type: textblock
18191 #. type: textblock
18192 #: ../src/guestfs-actions.pod:6179 ../fish/guestfish-actions.pod:4174
18193 msgid ""
18194 "Depending on the guest's shell, this usually results in wildcards being "
18195 "expanded, shell expressions being interpolated and so on."
18196 msgstr ""
18197
18198 # type: textblock
18199 #. type: textblock
18200 #: ../src/guestfs-actions.pod:6183
18201 msgid "All the provisos about C<guestfs_command> apply to this call."
18202 msgstr ""
18203
18204 # type: =head2
18205 #. type: =head2
18206 #: ../src/guestfs-actions.pod:6190
18207 msgid "guestfs_sh_lines"
18208 msgstr ""
18209
18210 # type: verbatim
18211 #. type: verbatim
18212 #: ../src/guestfs-actions.pod:6192
18213 #, no-wrap
18214 msgid ""
18215 " char **\n"
18216 " guestfs_sh_lines (guestfs_h *g,\n"
18217 "                   const char *command);\n"
18218 "\n"
18219 msgstr ""
18220
18221 # type: textblock
18222 #. type: textblock
18223 #: ../src/guestfs-actions.pod:6196
18224 msgid ""
18225 "This is the same as C<guestfs_sh>, but splits the result into a list of "
18226 "lines."
18227 msgstr ""
18228
18229 # type: textblock
18230 #. type: textblock
18231 #: ../src/guestfs-actions.pod:6199
18232 msgid "See also: C<guestfs_command_lines>"
18233 msgstr ""
18234
18235 # type: =head2
18236 #. type: =head2
18237 #: ../src/guestfs-actions.pod:6207
18238 msgid "guestfs_sleep"
18239 msgstr ""
18240
18241 # type: verbatim
18242 #. type: verbatim
18243 #: ../src/guestfs-actions.pod:6209
18244 #, no-wrap
18245 msgid ""
18246 " int\n"
18247 " guestfs_sleep (guestfs_h *g,\n"
18248 "                int secs);\n"
18249 "\n"
18250 msgstr ""
18251
18252 # type: textblock
18253 #. type: textblock
18254 #: ../src/guestfs-actions.pod:6213 ../fish/guestfish-actions.pod:4193
18255 msgid "Sleep for C<secs> seconds."
18256 msgstr ""
18257
18258 # type: textblock
18259 #. type: textblock
18260 #: ../src/guestfs-actions.pod:6217
18261 msgid "(Added in 1.0.41)"
18262 msgstr ""
18263
18264 # type: =head2
18265 #. type: =head2
18266 #: ../src/guestfs-actions.pod:6219 ../src/guestfs-structs.pod:109
18267 msgid "guestfs_stat"
18268 msgstr ""
18269
18270 # type: verbatim
18271 #. type: verbatim
18272 #: ../src/guestfs-actions.pod:6221
18273 #, no-wrap
18274 msgid ""
18275 " struct guestfs_stat *\n"
18276 " guestfs_stat (guestfs_h *g,\n"
18277 "               const char *path);\n"
18278 "\n"
18279 msgstr ""
18280
18281 # type: textblock
18282 #. type: textblock
18283 #: ../src/guestfs-actions.pod:6227 ../fish/guestfish-actions.pod:4201
18284 msgid "This is the same as the C<stat(2)> system call."
18285 msgstr ""
18286
18287 # type: =head2
18288 #. type: =head2
18289 #: ../src/guestfs-actions.pod:6235 ../src/guestfs-structs.pod:135
18290 msgid "guestfs_statvfs"
18291 msgstr ""
18292
18293 # type: verbatim
18294 #. type: verbatim
18295 #: ../src/guestfs-actions.pod:6237
18296 #, no-wrap
18297 msgid ""
18298 " struct guestfs_statvfs *\n"
18299 " guestfs_statvfs (guestfs_h *g,\n"
18300 "                  const char *path);\n"
18301 "\n"
18302 msgstr ""
18303
18304 # type: textblock
18305 #. type: textblock
18306 #: ../src/guestfs-actions.pod:6241 ../fish/guestfish-actions.pod:4207
18307 msgid ""
18308 "Returns file system statistics for any mounted file system.  C<path> should "
18309 "be a file or directory in the mounted file system (typically it is the mount "
18310 "point itself, but it doesn't need to be)."
18311 msgstr ""
18312
18313 # type: textblock
18314 #. type: textblock
18315 #: ../src/guestfs-actions.pod:6245 ../fish/guestfish-actions.pod:4211
18316 msgid "This is the same as the C<statvfs(2)> system call."
18317 msgstr ""
18318
18319 # type: textblock
18320 #. type: textblock
18321 #: ../src/guestfs-actions.pod:6247
18322 msgid ""
18323 "This function returns a C<struct guestfs_statvfs *>, or NULL if there was an "
18324 "error.  I<The caller must call C<guestfs_free_statvfs> after use>."
18325 msgstr ""
18326
18327 # type: =head2
18328 #. type: =head2
18329 #: ../src/guestfs-actions.pod:6253
18330 msgid "guestfs_strings"
18331 msgstr ""
18332
18333 # type: verbatim
18334 #. type: verbatim
18335 #: ../src/guestfs-actions.pod:6255
18336 #, no-wrap
18337 msgid ""
18338 " char **\n"
18339 " guestfs_strings (guestfs_h *g,\n"
18340 "                  const char *path);\n"
18341 "\n"
18342 msgstr ""
18343
18344 # type: textblock
18345 #. type: textblock
18346 #: ../src/guestfs-actions.pod:6259 ../fish/guestfish-actions.pod:4217
18347 msgid ""
18348 "This runs the L<strings(1)> command on a file and returns the list of "
18349 "printable strings found."
18350 msgstr ""
18351
18352 # type: =head2
18353 #. type: =head2
18354 #: ../src/guestfs-actions.pod:6271
18355 msgid "guestfs_strings_e"
18356 msgstr ""
18357
18358 # type: verbatim
18359 #. type: verbatim
18360 #: ../src/guestfs-actions.pod:6273
18361 #, no-wrap
18362 msgid ""
18363 " char **\n"
18364 " guestfs_strings_e (guestfs_h *g,\n"
18365 "                    const char *encoding,\n"
18366 "                    const char *path);\n"
18367 "\n"
18368 msgstr ""
18369
18370 # type: textblock
18371 #. type: textblock
18372 #: ../src/guestfs-actions.pod:6278
18373 msgid ""
18374 "This is like the C<guestfs_strings> command, but allows you to specify the "
18375 "encoding of strings that are looked for in the source file C<path>."
18376 msgstr ""
18377
18378 # type: textblock
18379 #. type: textblock
18380 #: ../src/guestfs-actions.pod:6282 ../fish/guestfish-actions.pod:4231
18381 msgid "Allowed encodings are:"
18382 msgstr ""
18383
18384 # type: =item
18385 #. type: =item
18386 #: ../src/guestfs-actions.pod:6286 ../fish/guestfish-actions.pod:4235
18387 msgid "s"
18388 msgstr ""
18389
18390 # type: textblock
18391 #. type: textblock
18392 #: ../src/guestfs-actions.pod:6288
18393 msgid ""
18394 "Single 7-bit-byte characters like ASCII and the ASCII-compatible parts of "
18395 "ISO-8859-X (this is what C<guestfs_strings> uses)."
18396 msgstr ""
18397
18398 # type: =item
18399 #. type: =item
18400 #: ../src/guestfs-actions.pod:6291 ../fish/guestfish-actions.pod:4240
18401 msgid "S"
18402 msgstr ""
18403
18404 # type: textblock
18405 #. type: textblock
18406 #: ../src/guestfs-actions.pod:6293 ../fish/guestfish-actions.pod:4242
18407 msgid "Single 8-bit-byte characters."
18408 msgstr ""
18409
18410 # type: =item
18411 #. type: =item
18412 #: ../src/guestfs-actions.pod:6295 ../fish/guestfish-actions.pod:4244
18413 msgid "b"
18414 msgstr ""
18415
18416 # type: textblock
18417 #. type: textblock
18418 #: ../src/guestfs-actions.pod:6297 ../fish/guestfish-actions.pod:4246
18419 msgid "16-bit big endian strings such as those encoded in UTF-16BE or UCS-2BE."
18420 msgstr ""
18421
18422 # type: =item
18423 #. type: =item
18424 #: ../src/guestfs-actions.pod:6300 ../fish/guestfish-actions.pod:4249
18425 msgid "l (lower case letter L)"
18426 msgstr ""
18427
18428 # type: textblock
18429 #. type: textblock
18430 #: ../src/guestfs-actions.pod:6302 ../fish/guestfish-actions.pod:4251
18431 msgid ""
18432 "16-bit little endian such as UTF-16LE and UCS-2LE.  This is useful for "
18433 "examining binaries in Windows guests."
18434 msgstr ""
18435
18436 # type: =item
18437 #. type: =item
18438 #: ../src/guestfs-actions.pod:6305 ../fish/guestfish-actions.pod:4254
18439 msgid "B"
18440 msgstr ""
18441
18442 # type: textblock
18443 #. type: textblock
18444 #: ../src/guestfs-actions.pod:6307 ../fish/guestfish-actions.pod:4256
18445 msgid "32-bit big endian such as UCS-4BE."
18446 msgstr ""
18447
18448 # type: =item
18449 #. type: =item
18450 #: ../src/guestfs-actions.pod:6309 ../fish/guestfish-actions.pod:4258
18451 msgid "L"
18452 msgstr ""
18453
18454 # type: textblock
18455 #. type: textblock
18456 #: ../src/guestfs-actions.pod:6311 ../fish/guestfish-actions.pod:4260
18457 msgid "32-bit little endian such as UCS-4LE."
18458 msgstr ""
18459
18460 # type: textblock
18461 #. type: textblock
18462 #: ../src/guestfs-actions.pod:6315 ../fish/guestfish-actions.pod:4264
18463 msgid "The returned strings are transcoded to UTF-8."
18464 msgstr ""
18465
18466 # type: =head2
18467 #. type: =head2
18468 #: ../src/guestfs-actions.pod:6326
18469 msgid "guestfs_swapoff_device"
18470 msgstr ""
18471
18472 # type: verbatim
18473 #. type: verbatim
18474 #: ../src/guestfs-actions.pod:6328
18475 #, no-wrap
18476 msgid ""
18477 " int\n"
18478 " guestfs_swapoff_device (guestfs_h *g,\n"
18479 "                         const char *device);\n"
18480 "\n"
18481 msgstr ""
18482
18483 # type: textblock
18484 #. type: textblock
18485 #: ../src/guestfs-actions.pod:6332
18486 msgid ""
18487 "This command disables the libguestfs appliance swap device or partition "
18488 "named C<device>.  See C<guestfs_swapon_device>."
18489 msgstr ""
18490
18491 # type: =head2
18492 #. type: =head2
18493 #: ../src/guestfs-actions.pod:6340
18494 msgid "guestfs_swapoff_file"
18495 msgstr ""
18496
18497 # type: verbatim
18498 #. type: verbatim
18499 #: ../src/guestfs-actions.pod:6342
18500 #, no-wrap
18501 msgid ""
18502 " int\n"
18503 " guestfs_swapoff_file (guestfs_h *g,\n"
18504 "                       const char *file);\n"
18505 "\n"
18506 msgstr ""
18507
18508 # type: textblock
18509 #. type: textblock
18510 #: ../src/guestfs-actions.pod:6346 ../fish/guestfish-actions.pod:4281
18511 msgid "This command disables the libguestfs appliance swap on file."
18512 msgstr ""
18513
18514 # type: =head2
18515 #. type: =head2
18516 #: ../src/guestfs-actions.pod:6352
18517 msgid "guestfs_swapoff_label"
18518 msgstr ""
18519
18520 # type: verbatim
18521 #. type: verbatim
18522 #: ../src/guestfs-actions.pod:6354
18523 #, no-wrap
18524 msgid ""
18525 " int\n"
18526 " guestfs_swapoff_label (guestfs_h *g,\n"
18527 "                        const char *label);\n"
18528 "\n"
18529 msgstr ""
18530
18531 # type: textblock
18532 #. type: textblock
18533 #: ../src/guestfs-actions.pod:6358 ../fish/guestfish-actions.pod:4287
18534 msgid ""
18535 "This command disables the libguestfs appliance swap on labeled swap "
18536 "partition."
18537 msgstr ""
18538
18539 # type: =head2
18540 #. type: =head2
18541 #: ../src/guestfs-actions.pod:6365
18542 msgid "guestfs_swapoff_uuid"
18543 msgstr ""
18544
18545 # type: verbatim
18546 #. type: verbatim
18547 #: ../src/guestfs-actions.pod:6367
18548 #, no-wrap
18549 msgid ""
18550 " int\n"
18551 " guestfs_swapoff_uuid (guestfs_h *g,\n"
18552 "                       const char *uuid);\n"
18553 "\n"
18554 msgstr ""
18555
18556 # type: textblock
18557 #. type: textblock
18558 #: ../src/guestfs-actions.pod:6371 ../fish/guestfish-actions.pod:4294
18559 msgid ""
18560 "This command disables the libguestfs appliance swap partition with the given "
18561 "UUID."
18562 msgstr ""
18563
18564 # type: =head2
18565 #. type: =head2
18566 #: ../src/guestfs-actions.pod:6378
18567 msgid "guestfs_swapon_device"
18568 msgstr ""
18569
18570 # type: verbatim
18571 #. type: verbatim
18572 #: ../src/guestfs-actions.pod:6380
18573 #, no-wrap
18574 msgid ""
18575 " int\n"
18576 " guestfs_swapon_device (guestfs_h *g,\n"
18577 "                        const char *device);\n"
18578 "\n"
18579 msgstr ""
18580
18581 # type: textblock
18582 #. type: textblock
18583 #: ../src/guestfs-actions.pod:6384
18584 msgid ""
18585 "This command enables the libguestfs appliance to use the swap device or "
18586 "partition named C<device>.  The increased memory is made available for all "
18587 "commands, for example those run using C<guestfs_command> or C<guestfs_sh>."
18588 msgstr ""
18589
18590 # type: textblock
18591 #. type: textblock
18592 #: ../src/guestfs-actions.pod:6389 ../fish/guestfish-actions.pod:4306
18593 msgid ""
18594 "Note that you should not swap to existing guest swap partitions unless you "
18595 "know what you are doing.  They may contain hibernation information, or other "
18596 "information that the guest doesn't want you to trash.  You also risk leaking "
18597 "information about the host to the guest this way.  Instead, attach a new "
18598 "host device to the guest and swap on that."
18599 msgstr ""
18600
18601 # type: =head2
18602 #. type: =head2
18603 #: ../src/guestfs-actions.pod:6400
18604 msgid "guestfs_swapon_file"
18605 msgstr ""
18606
18607 # type: verbatim
18608 #. type: verbatim
18609 #: ../src/guestfs-actions.pod:6402
18610 #, no-wrap
18611 msgid ""
18612 " int\n"
18613 " guestfs_swapon_file (guestfs_h *g,\n"
18614 "                      const char *file);\n"
18615 "\n"
18616 msgstr ""
18617
18618 # type: textblock
18619 #. type: textblock
18620 #: ../src/guestfs-actions.pod:6406
18621 msgid ""
18622 "This command enables swap to a file.  See C<guestfs_swapon_device> for other "
18623 "notes."
18624 msgstr ""
18625
18626 # type: =head2
18627 #. type: =head2
18628 #: ../src/guestfs-actions.pod:6413
18629 msgid "guestfs_swapon_label"
18630 msgstr ""
18631
18632 # type: verbatim
18633 #. type: verbatim
18634 #: ../src/guestfs-actions.pod:6415
18635 #, no-wrap
18636 msgid ""
18637 " int\n"
18638 " guestfs_swapon_label (guestfs_h *g,\n"
18639 "                       const char *label);\n"
18640 "\n"
18641 msgstr ""
18642
18643 # type: textblock
18644 #. type: textblock
18645 #: ../src/guestfs-actions.pod:6419
18646 msgid ""
18647 "This command enables swap to a labeled swap partition.  See "
18648 "C<guestfs_swapon_device> for other notes."
18649 msgstr ""
18650
18651 # type: =head2
18652 #. type: =head2
18653 #: ../src/guestfs-actions.pod:6426
18654 msgid "guestfs_swapon_uuid"
18655 msgstr ""
18656
18657 # type: verbatim
18658 #. type: verbatim
18659 #: ../src/guestfs-actions.pod:6428
18660 #, no-wrap
18661 msgid ""
18662 " int\n"
18663 " guestfs_swapon_uuid (guestfs_h *g,\n"
18664 "                      const char *uuid);\n"
18665 "\n"
18666 msgstr ""
18667
18668 # type: textblock
18669 #. type: textblock
18670 #: ../src/guestfs-actions.pod:6432
18671 msgid ""
18672 "This command enables swap to a swap partition with the given UUID.  See "
18673 "C<guestfs_swapon_device> for other notes."
18674 msgstr ""
18675
18676 # type: =head2
18677 #. type: =head2
18678 #: ../src/guestfs-actions.pod:6439
18679 msgid "guestfs_sync"
18680 msgstr ""
18681
18682 # type: verbatim
18683 #. type: verbatim
18684 #: ../src/guestfs-actions.pod:6441
18685 #, no-wrap
18686 msgid ""
18687 " int\n"
18688 " guestfs_sync (guestfs_h *g);\n"
18689 "\n"
18690 msgstr ""
18691
18692 # type: textblock
18693 #. type: textblock
18694 #: ../src/guestfs-actions.pod:6444 ../fish/guestfish-actions.pod:4338
18695 msgid ""
18696 "This syncs the disk, so that any writes are flushed through to the "
18697 "underlying disk image."
18698 msgstr ""
18699
18700 # type: textblock
18701 #. type: textblock
18702 #: ../src/guestfs-actions.pod:6447 ../fish/guestfish-actions.pod:4341
18703 msgid ""
18704 "You should always call this if you have modified a disk image, before "
18705 "closing the handle."
18706 msgstr ""
18707
18708 # type: =head2
18709 #. type: =head2
18710 #: ../src/guestfs-actions.pod:6454
18711 msgid "guestfs_tail"
18712 msgstr ""
18713
18714 # type: verbatim
18715 #. type: verbatim
18716 #: ../src/guestfs-actions.pod:6456
18717 #, no-wrap
18718 msgid ""
18719 " char **\n"
18720 " guestfs_tail (guestfs_h *g,\n"
18721 "               const char *path);\n"
18722 "\n"
18723 msgstr ""
18724
18725 # type: textblock
18726 #. type: textblock
18727 #: ../src/guestfs-actions.pod:6460 ../fish/guestfish-actions.pod:4348
18728 msgid ""
18729 "This command returns up to the last 10 lines of a file as a list of strings."
18730 msgstr ""
18731
18732 # type: =head2
18733 #. type: =head2
18734 #: ../src/guestfs-actions.pod:6472
18735 msgid "guestfs_tail_n"
18736 msgstr ""
18737
18738 # type: verbatim
18739 #. type: verbatim
18740 #: ../src/guestfs-actions.pod:6474
18741 #, no-wrap
18742 msgid ""
18743 " char **\n"
18744 " guestfs_tail_n (guestfs_h *g,\n"
18745 "                 int nrlines,\n"
18746 "                 const char *path);\n"
18747 "\n"
18748 msgstr ""
18749
18750 # type: textblock
18751 #. type: textblock
18752 #: ../src/guestfs-actions.pod:6479 ../fish/guestfish-actions.pod:4358
18753 msgid ""
18754 "If the parameter C<nrlines> is a positive number, this returns the last "
18755 "C<nrlines> lines of the file C<path>."
18756 msgstr ""
18757
18758 # type: textblock
18759 #. type: textblock
18760 #: ../src/guestfs-actions.pod:6482 ../fish/guestfish-actions.pod:4361
18761 msgid ""
18762 "If the parameter C<nrlines> is a negative number, this returns lines from "
18763 "the file C<path>, starting with the C<-nrlines>th line."
18764 msgstr ""
18765
18766 # type: =head2
18767 #. type: =head2
18768 #: ../src/guestfs-actions.pod:6496
18769 msgid "guestfs_tar_in"
18770 msgstr ""
18771
18772 # type: verbatim
18773 #. type: verbatim
18774 #: ../src/guestfs-actions.pod:6498
18775 #, no-wrap
18776 msgid ""
18777 " int\n"
18778 " guestfs_tar_in (guestfs_h *g,\n"
18779 "                 const char *tarfile,\n"
18780 "                 const char *directory);\n"
18781 "\n"
18782 msgstr ""
18783
18784 # type: textblock
18785 #. type: textblock
18786 #: ../src/guestfs-actions.pod:6503 ../fish/guestfish-actions.pod:4373
18787 msgid ""
18788 "This command uploads and unpacks local file C<tarfile> (an I<uncompressed> "
18789 "tar file) into C<directory>."
18790 msgstr ""
18791
18792 # type: textblock
18793 #. type: textblock
18794 #: ../src/guestfs-actions.pod:6506
18795 msgid ""
18796 "To upload a compressed tarball, use C<guestfs_tgz_in> or C<guestfs_txz_in>."
18797 msgstr ""
18798
18799 # type: textblock
18800 #. type: textblock
18801 #: ../src/guestfs-actions.pod:6511 ../src/guestfs-actions.pod:6528
18802 #: ../src/guestfs-actions.pod:6544 ../src/guestfs-actions.pod:6560
18803 msgid "(Added in 1.0.3)"
18804 msgstr ""
18805
18806 # type: =head2
18807 #. type: =head2
18808 #: ../src/guestfs-actions.pod:6513
18809 msgid "guestfs_tar_out"
18810 msgstr ""
18811
18812 # type: verbatim
18813 #. type: verbatim
18814 #: ../src/guestfs-actions.pod:6515
18815 #, no-wrap
18816 msgid ""
18817 " int\n"
18818 " guestfs_tar_out (guestfs_h *g,\n"
18819 "                  const char *directory,\n"
18820 "                  const char *tarfile);\n"
18821 "\n"
18822 msgstr ""
18823
18824 # type: textblock
18825 #. type: textblock
18826 #: ../src/guestfs-actions.pod:6520 ../fish/guestfish-actions.pod:4385
18827 msgid ""
18828 "This command packs the contents of C<directory> and downloads it to local "
18829 "file C<tarfile>."
18830 msgstr ""
18831
18832 # type: textblock
18833 #. type: textblock
18834 #: ../src/guestfs-actions.pod:6523
18835 msgid ""
18836 "To download a compressed tarball, use C<guestfs_tgz_out> or "
18837 "C<guestfs_txz_out>."
18838 msgstr ""
18839
18840 # type: =head2
18841 #. type: =head2
18842 #: ../src/guestfs-actions.pod:6530
18843 msgid "guestfs_tgz_in"
18844 msgstr ""
18845
18846 # type: verbatim
18847 #. type: verbatim
18848 #: ../src/guestfs-actions.pod:6532
18849 #, no-wrap
18850 msgid ""
18851 " int\n"
18852 " guestfs_tgz_in (guestfs_h *g,\n"
18853 "                 const char *tarball,\n"
18854 "                 const char *directory);\n"
18855 "\n"
18856 msgstr ""
18857
18858 # type: textblock
18859 #. type: textblock
18860 #: ../src/guestfs-actions.pod:6537 ../fish/guestfish-actions.pod:4397
18861 msgid ""
18862 "This command uploads and unpacks local file C<tarball> (a I<gzip compressed> "
18863 "tar file) into C<directory>."
18864 msgstr ""
18865
18866 # type: textblock
18867 #. type: textblock
18868 #: ../src/guestfs-actions.pod:6540
18869 msgid "To upload an uncompressed tarball, use C<guestfs_tar_in>."
18870 msgstr ""
18871
18872 # type: =head2
18873 #. type: =head2
18874 #: ../src/guestfs-actions.pod:6546
18875 msgid "guestfs_tgz_out"
18876 msgstr ""
18877
18878 # type: verbatim
18879 #. type: verbatim
18880 #: ../src/guestfs-actions.pod:6548
18881 #, no-wrap
18882 msgid ""
18883 " int\n"
18884 " guestfs_tgz_out (guestfs_h *g,\n"
18885 "                  const char *directory,\n"
18886 "                  const char *tarball);\n"
18887 "\n"
18888 msgstr ""
18889
18890 # type: textblock
18891 #. type: textblock
18892 #: ../src/guestfs-actions.pod:6553 ../fish/guestfish-actions.pod:4408
18893 msgid ""
18894 "This command packs the contents of C<directory> and downloads it to local "
18895 "file C<tarball>."
18896 msgstr ""
18897
18898 # type: textblock
18899 #. type: textblock
18900 #: ../src/guestfs-actions.pod:6556
18901 msgid "To download an uncompressed tarball, use C<guestfs_tar_out>."
18902 msgstr ""
18903
18904 # type: =head2
18905 #. type: =head2
18906 #: ../src/guestfs-actions.pod:6562
18907 msgid "guestfs_touch"
18908 msgstr ""
18909
18910 # type: verbatim
18911 #. type: verbatim
18912 #: ../src/guestfs-actions.pod:6564
18913 #, no-wrap
18914 msgid ""
18915 " int\n"
18916 " guestfs_touch (guestfs_h *g,\n"
18917 "                const char *path);\n"
18918 "\n"
18919 msgstr ""
18920
18921 # type: textblock
18922 #. type: textblock
18923 #: ../src/guestfs-actions.pod:6568 ../fish/guestfish-actions.pod:4419
18924 msgid ""
18925 "Touch acts like the L<touch(1)> command.  It can be used to update the "
18926 "timestamps on a file, or, if the file does not exist, to create a new zero-"
18927 "length file."
18928 msgstr ""
18929
18930 # type: textblock
18931 #. type: textblock
18932 #: ../src/guestfs-actions.pod:6572 ../fish/guestfish-actions.pod:4423
18933 msgid ""
18934 "This command only works on regular files, and will fail on other file types "
18935 "such as directories, symbolic links, block special etc."
18936 msgstr ""
18937
18938 # type: =head2
18939 #. type: =head2
18940 #: ../src/guestfs-actions.pod:6579
18941 msgid "guestfs_truncate"
18942 msgstr ""
18943
18944 # type: verbatim
18945 #. type: verbatim
18946 #: ../src/guestfs-actions.pod:6581
18947 #, no-wrap
18948 msgid ""
18949 " int\n"
18950 " guestfs_truncate (guestfs_h *g,\n"
18951 "                   const char *path);\n"
18952 "\n"
18953 msgstr ""
18954
18955 # type: textblock
18956 #. type: textblock
18957 #: ../src/guestfs-actions.pod:6585 ../fish/guestfish-actions.pod:4430
18958 msgid ""
18959 "This command truncates C<path> to a zero-length file.  The file must exist "
18960 "already."
18961 msgstr ""
18962
18963 # type: =head2
18964 #. type: =head2
18965 #: ../src/guestfs-actions.pod:6592
18966 msgid "guestfs_truncate_size"
18967 msgstr ""
18968
18969 # type: verbatim
18970 #. type: verbatim
18971 #: ../src/guestfs-actions.pod:6594
18972 #, no-wrap
18973 msgid ""
18974 " int\n"
18975 " guestfs_truncate_size (guestfs_h *g,\n"
18976 "                        const char *path,\n"
18977 "                        int64_t size);\n"
18978 "\n"
18979 msgstr ""
18980
18981 # type: textblock
18982 #. type: textblock
18983 #: ../src/guestfs-actions.pod:6599 ../fish/guestfish-actions.pod:4437
18984 msgid ""
18985 "This command truncates C<path> to size C<size> bytes.  The file must exist "
18986 "already."
18987 msgstr ""
18988
18989 # type: textblock
18990 #. type: textblock
18991 #: ../src/guestfs-actions.pod:6602
18992 msgid ""
18993 "If the current file size is less than C<size> then the file is extended to "
18994 "the required size with zero bytes.  This creates a sparse file (ie. disk "
18995 "blocks are not allocated for the file until you write to it).  To create a "
18996 "non-sparse file of zeroes, use C<guestfs_fallocate64> instead."
18997 msgstr ""
18998
18999 # type: =head2
19000 #. type: =head2
19001 #: ../src/guestfs-actions.pod:6612
19002 msgid "guestfs_tune2fs_l"
19003 msgstr ""
19004
19005 # type: verbatim
19006 #. type: verbatim
19007 #: ../src/guestfs-actions.pod:6614
19008 #, no-wrap
19009 msgid ""
19010 " char **\n"
19011 " guestfs_tune2fs_l (guestfs_h *g,\n"
19012 "                    const char *device);\n"
19013 "\n"
19014 msgstr ""
19015
19016 # type: textblock
19017 #. type: textblock
19018 #: ../src/guestfs-actions.pod:6618 ../fish/guestfish-actions.pod:4450
19019 msgid ""
19020 "This returns the contents of the ext2, ext3 or ext4 filesystem superblock on "
19021 "C<device>."
19022 msgstr ""
19023
19024 # type: textblock
19025 #. type: textblock
19026 #: ../src/guestfs-actions.pod:6621 ../fish/guestfish-actions.pod:4453
19027 msgid ""
19028 "It is the same as running C<tune2fs -l device>.  See L<tune2fs(8)> manpage "
19029 "for more details.  The list of fields returned isn't clearly defined, and "
19030 "depends on both the version of C<tune2fs> that libguestfs was built against, "
19031 "and the filesystem itself."
19032 msgstr ""
19033
19034 # type: =head2
19035 #. type: =head2
19036 #: ../src/guestfs-actions.pod:6634
19037 msgid "guestfs_txz_in"
19038 msgstr ""
19039
19040 # type: verbatim
19041 #. type: verbatim
19042 #: ../src/guestfs-actions.pod:6636
19043 #, no-wrap
19044 msgid ""
19045 " int\n"
19046 " guestfs_txz_in (guestfs_h *g,\n"
19047 "                 const char *tarball,\n"
19048 "                 const char *directory);\n"
19049 "\n"
19050 msgstr ""
19051
19052 # type: textblock
19053 #. type: textblock
19054 #: ../src/guestfs-actions.pod:6641 ../fish/guestfish-actions.pod:4462
19055 msgid ""
19056 "This command uploads and unpacks local file C<tarball> (an I<xz compressed> "
19057 "tar file) into C<directory>."
19058 msgstr ""
19059
19060 # type: =head2
19061 #. type: =head2
19062 #: ../src/guestfs-actions.pod:6648
19063 msgid "guestfs_txz_out"
19064 msgstr ""
19065
19066 # type: verbatim
19067 #. type: verbatim
19068 #: ../src/guestfs-actions.pod:6650
19069 #, no-wrap
19070 msgid ""
19071 " int\n"
19072 " guestfs_txz_out (guestfs_h *g,\n"
19073 "                  const char *directory,\n"
19074 "                  const char *tarball);\n"
19075 "\n"
19076 msgstr ""
19077
19078 # type: textblock
19079 #. type: textblock
19080 #: ../src/guestfs-actions.pod:6655 ../fish/guestfish-actions.pod:4471
19081 msgid ""
19082 "This command packs the contents of C<directory> and downloads it to local "
19083 "file C<tarball> (as an xz compressed tar archive)."
19084 msgstr ""
19085
19086 # type: =head2
19087 #. type: =head2
19088 #: ../src/guestfs-actions.pod:6662
19089 msgid "guestfs_umask"
19090 msgstr ""
19091
19092 # type: verbatim
19093 #. type: verbatim
19094 #: ../src/guestfs-actions.pod:6664
19095 #, no-wrap
19096 msgid ""
19097 " int\n"
19098 " guestfs_umask (guestfs_h *g,\n"
19099 "                int mask);\n"
19100 "\n"
19101 msgstr ""
19102
19103 # type: textblock
19104 #. type: textblock
19105 #: ../src/guestfs-actions.pod:6668 ../fish/guestfish-actions.pod:4480
19106 msgid ""
19107 "This function sets the mask used for creating new files and device nodes to "
19108 "C<mask & 0777>."
19109 msgstr ""
19110
19111 # type: textblock
19112 #. type: textblock
19113 #: ../src/guestfs-actions.pod:6671 ../fish/guestfish-actions.pod:4483
19114 msgid ""
19115 "Typical umask values would be C<022> which creates new files with "
19116 "permissions like \"-rw-r--r--\" or \"-rwxr-xr-x\", and C<002> which creates "
19117 "new files with permissions like \"-rw-rw-r--\" or \"-rwxrwxr-x\"."
19118 msgstr ""
19119
19120 # type: textblock
19121 #. type: textblock
19122 #: ../src/guestfs-actions.pod:6676 ../fish/guestfish-actions.pod:4488
19123 msgid ""
19124 "The default umask is C<022>.  This is important because it means that "
19125 "directories and device nodes will be created with C<0644> or C<0755> mode "
19126 "even if you specify C<0777>."
19127 msgstr ""
19128
19129 # type: textblock
19130 #. type: textblock
19131 #: ../src/guestfs-actions.pod:6680
19132 msgid ""
19133 "See also C<guestfs_get_umask>, L<umask(2)>, C<guestfs_mknod>, "
19134 "C<guestfs_mkdir>."
19135 msgstr ""
19136
19137 # type: textblock
19138 #. type: textblock
19139 #: ../src/guestfs-actions.pod:6683 ../fish/guestfish-actions.pod:4495
19140 msgid "This call returns the previous umask."
19141 msgstr ""
19142
19143 # type: =head2
19144 #. type: =head2
19145 #: ../src/guestfs-actions.pod:6689
19146 msgid "guestfs_umount"
19147 msgstr ""
19148
19149 # type: verbatim
19150 #. type: verbatim
19151 #: ../src/guestfs-actions.pod:6691
19152 #, no-wrap
19153 msgid ""
19154 " int\n"
19155 " guestfs_umount (guestfs_h *g,\n"
19156 "                 const char *pathordevice);\n"
19157 "\n"
19158 msgstr ""
19159
19160 # type: textblock
19161 #. type: textblock
19162 #: ../src/guestfs-actions.pod:6695 ../fish/guestfish-actions.pod:4503
19163 msgid ""
19164 "This unmounts the given filesystem.  The filesystem may be specified either "
19165 "by its mountpoint (path) or the device which contains the filesystem."
19166 msgstr ""
19167
19168 # type: =head2
19169 #. type: =head2
19170 #: ../src/guestfs-actions.pod:6703
19171 msgid "guestfs_umount_all"
19172 msgstr ""
19173
19174 # type: verbatim
19175 #. type: verbatim
19176 #: ../src/guestfs-actions.pod:6705
19177 #, no-wrap
19178 msgid ""
19179 " int\n"
19180 " guestfs_umount_all (guestfs_h *g);\n"
19181 "\n"
19182 msgstr ""
19183
19184 # type: textblock
19185 #. type: textblock
19186 #: ../src/guestfs-actions.pod:6708 ../fish/guestfish-actions.pod:4513
19187 msgid "This unmounts all mounted filesystems."
19188 msgstr ""
19189
19190 # type: textblock
19191 #. type: textblock
19192 #: ../src/guestfs-actions.pod:6710 ../fish/guestfish-actions.pod:4515
19193 msgid "Some internal mounts are not unmounted by this call."
19194 msgstr ""
19195
19196 # type: =head2
19197 #. type: =head2
19198 #: ../src/guestfs-actions.pod:6716
19199 msgid "guestfs_upload"
19200 msgstr ""
19201
19202 # type: verbatim
19203 #. type: verbatim
19204 #: ../src/guestfs-actions.pod:6718
19205 #, no-wrap
19206 msgid ""
19207 " int\n"
19208 " guestfs_upload (guestfs_h *g,\n"
19209 "                 const char *filename,\n"
19210 "                 const char *remotefilename);\n"
19211 "\n"
19212 msgstr ""
19213
19214 # type: textblock
19215 #. type: textblock
19216 #: ../src/guestfs-actions.pod:6723 ../src/guestfs-actions.pod:6747
19217 #: ../fish/guestfish-actions.pod:4521 ../fish/guestfish-actions.pod:4534
19218 msgid "Upload local file C<filename> to C<remotefilename> on the filesystem."
19219 msgstr ""
19220
19221 # type: textblock
19222 #. type: textblock
19223 #: ../src/guestfs-actions.pod:6728
19224 msgid "See also C<guestfs_download>."
19225 msgstr ""
19226
19227 # type: =head2
19228 #. type: =head2
19229 #: ../src/guestfs-actions.pod:6739
19230 msgid "guestfs_upload_offset"
19231 msgstr ""
19232
19233 # type: verbatim
19234 #. type: verbatim
19235 #: ../src/guestfs-actions.pod:6741
19236 #, no-wrap
19237 msgid ""
19238 " int\n"
19239 " guestfs_upload_offset (guestfs_h *g,\n"
19240 "                        const char *filename,\n"
19241 "                        const char *remotefilename,\n"
19242 "                        int64_t offset);\n"
19243 "\n"
19244 msgstr ""
19245
19246 # type: textblock
19247 #. type: textblock
19248 #: ../src/guestfs-actions.pod:6750 ../fish/guestfish-actions.pod:4537
19249 msgid ""
19250 "C<remotefilename> is overwritten starting at the byte C<offset> specified.  "
19251 "The intention is to overwrite parts of existing files or devices, although "
19252 "if a non-existant file is specified then it is created with a \"hole\" "
19253 "before C<offset>.  The size of the data written is implicit in the size of "
19254 "the source C<filename>."
19255 msgstr ""
19256
19257 # type: textblock
19258 #. type: textblock
19259 #: ../src/guestfs-actions.pod:6757
19260 msgid ""
19261 "Note that there is no limit on the amount of data that can be uploaded with "
19262 "this call, unlike with C<guestfs_pwrite>, and this call always writes the "
19263 "full amount unless an error occurs."
19264 msgstr ""
19265
19266 # type: textblock
19267 #. type: textblock
19268 #: ../src/guestfs-actions.pod:6762
19269 msgid "See also C<guestfs_upload>, C<guestfs_pwrite>."
19270 msgstr ""
19271
19272 # type: =head2
19273 #. type: =head2
19274 #: ../src/guestfs-actions.pod:6773
19275 msgid "guestfs_utimens"
19276 msgstr ""
19277
19278 # type: verbatim
19279 #. type: verbatim
19280 #: ../src/guestfs-actions.pod:6775
19281 #, no-wrap
19282 msgid ""
19283 " int\n"
19284 " guestfs_utimens (guestfs_h *g,\n"
19285 "                  const char *path,\n"
19286 "                  int64_t atsecs,\n"
19287 "                  int64_t atnsecs,\n"
19288 "                  int64_t mtsecs,\n"
19289 "                  int64_t mtnsecs);\n"
19290 "\n"
19291 msgstr ""
19292
19293 # type: textblock
19294 #. type: textblock
19295 #: ../src/guestfs-actions.pod:6783 ../fish/guestfish-actions.pod:4557
19296 msgid "This command sets the timestamps of a file with nanosecond precision."
19297 msgstr ""
19298
19299 # type: textblock
19300 #. type: textblock
19301 #: ../src/guestfs-actions.pod:6786 ../fish/guestfish-actions.pod:4560
19302 msgid ""
19303 "C<atsecs, atnsecs> are the last access time (atime) in secs and nanoseconds "
19304 "from the epoch."
19305 msgstr ""
19306
19307 # type: textblock
19308 #. type: textblock
19309 #: ../src/guestfs-actions.pod:6789 ../fish/guestfish-actions.pod:4563
19310 msgid ""
19311 "C<mtsecs, mtnsecs> are the last modification time (mtime) in secs and "
19312 "nanoseconds from the epoch."
19313 msgstr ""
19314
19315 # type: textblock
19316 #. type: textblock
19317 #: ../src/guestfs-actions.pod:6792 ../fish/guestfish-actions.pod:4566
19318 msgid ""
19319 "If the C<*nsecs> field contains the special value C<-1> then the "
19320 "corresponding timestamp is set to the current time.  (The C<*secs> field is "
19321 "ignored in this case)."
19322 msgstr ""
19323
19324 # type: textblock
19325 #. type: textblock
19326 #: ../src/guestfs-actions.pod:6796 ../fish/guestfish-actions.pod:4570
19327 msgid ""
19328 "If the C<*nsecs> field contains the special value C<-2> then the "
19329 "corresponding timestamp is left unchanged.  (The C<*secs> field is ignored "
19330 "in this case)."
19331 msgstr ""
19332
19333 # type: =head2
19334 #. type: =head2
19335 #: ../src/guestfs-actions.pod:6804 ../src/guestfs-structs.pod:175
19336 msgid "guestfs_version"
19337 msgstr ""
19338
19339 # type: verbatim
19340 #. type: verbatim
19341 #: ../src/guestfs-actions.pod:6806
19342 #, no-wrap
19343 msgid ""
19344 " struct guestfs_version *\n"
19345 " guestfs_version (guestfs_h *g);\n"
19346 "\n"
19347 msgstr ""
19348
19349 # type: textblock
19350 #. type: textblock
19351 #: ../src/guestfs-actions.pod:6809 ../fish/guestfish-actions.pod:4578
19352 msgid ""
19353 "Return the libguestfs version number that the program is linked against."
19354 msgstr ""
19355
19356 # type: textblock
19357 #. type: textblock
19358 #: ../src/guestfs-actions.pod:6812 ../fish/guestfish-actions.pod:4581
19359 msgid ""
19360 "Note that because of dynamic linking this is not necessarily the version of "
19361 "libguestfs that you compiled against.  You can compile the program, and then "
19362 "at runtime dynamically link against a completely different C<libguestfs.so> "
19363 "library."
19364 msgstr ""
19365
19366 # type: textblock
19367 #. type: textblock
19368 #: ../src/guestfs-actions.pod:6817 ../fish/guestfish-actions.pod:4586
19369 msgid ""
19370 "This call was added in version C<1.0.58>.  In previous versions of "
19371 "libguestfs there was no way to get the version number.  From C code you can "
19372 "use dynamic linker functions to find out if this symbol exists (if it "
19373 "doesn't, then it's an earlier version)."
19374 msgstr ""
19375
19376 # type: textblock
19377 #. type: textblock
19378 #: ../src/guestfs-actions.pod:6823 ../fish/guestfish-actions.pod:4592
19379 msgid ""
19380 "The call returns a structure with four elements.  The first three (C<major>, "
19381 "C<minor> and C<release>) are numbers and correspond to the usual version "
19382 "triplet.  The fourth element (C<extra>) is a string and is normally empty, "
19383 "but may be used for distro-specific information."
19384 msgstr ""
19385
19386 # type: textblock
19387 #. type: textblock
19388 #: ../src/guestfs-actions.pod:6829 ../fish/guestfish-actions.pod:4598
19389 msgid ""
19390 "To construct the original version string: C<$major.$minor.$release$extra>"
19391 msgstr ""
19392
19393 # type: textblock
19394 #. type: textblock
19395 #: ../src/guestfs-actions.pod:6832 ../fish/guestfish-actions.pod:4601
19396 msgid "See also: L<guestfs(3)/LIBGUESTFS VERSION NUMBERS>."
19397 msgstr ""
19398
19399 # type: textblock
19400 #. type: textblock
19401 #: ../src/guestfs-actions.pod:6834
19402 msgid ""
19403 "I<Note:> Don't use this call to test for availability of features.  In "
19404 "enterprise distributions we backport features from later versions into "
19405 "earlier versions, making this an unreliable way to test for features.  Use "
19406 "C<guestfs_available> instead."
19407 msgstr ""
19408
19409 # type: textblock
19410 #. type: textblock
19411 #: ../src/guestfs-actions.pod:6840
19412 msgid ""
19413 "This function returns a C<struct guestfs_version *>, or NULL if there was an "
19414 "error.  I<The caller must call C<guestfs_free_version> after use>."
19415 msgstr ""
19416
19417 # type: textblock
19418 #. type: textblock
19419 #: ../src/guestfs-actions.pod:6844
19420 msgid "(Added in 1.0.58)"
19421 msgstr ""
19422
19423 # type: =head2
19424 #. type: =head2
19425 #: ../src/guestfs-actions.pod:6846
19426 msgid "guestfs_vfs_label"
19427 msgstr ""
19428
19429 # type: verbatim
19430 #. type: verbatim
19431 #: ../src/guestfs-actions.pod:6848
19432 #, no-wrap
19433 msgid ""
19434 " char *\n"
19435 " guestfs_vfs_label (guestfs_h *g,\n"
19436 "                    const char *device);\n"
19437 "\n"
19438 msgstr ""
19439
19440 # type: textblock
19441 #. type: textblock
19442 #: ../src/guestfs-actions.pod:6852 ../fish/guestfish-actions.pod:4613
19443 msgid "This returns the filesystem label of the filesystem on C<device>."
19444 msgstr ""
19445
19446 # type: textblock
19447 #. type: textblock
19448 #: ../src/guestfs-actions.pod:6855 ../fish/guestfish-actions.pod:4616
19449 msgid "If the filesystem is unlabeled, this returns the empty string."
19450 msgstr ""
19451
19452 # type: textblock
19453 #. type: textblock
19454 #: ../src/guestfs-actions.pod:6857
19455 msgid "To find a filesystem from the label, use C<guestfs_findfs_label>."
19456 msgstr ""
19457
19458 # type: textblock
19459 #. type: textblock
19460 #: ../src/guestfs-actions.pod:6862 ../src/guestfs-actions.pod:6899
19461 msgid "(Added in 1.3.18)"
19462 msgstr ""
19463
19464 # type: =head2
19465 #. type: =head2
19466 #: ../src/guestfs-actions.pod:6864
19467 msgid "guestfs_vfs_type"
19468 msgstr ""
19469
19470 # type: verbatim
19471 #. type: verbatim
19472 #: ../src/guestfs-actions.pod:6866
19473 #, no-wrap
19474 msgid ""
19475 " char *\n"
19476 " guestfs_vfs_type (guestfs_h *g,\n"
19477 "                   const char *device);\n"
19478 "\n"
19479 msgstr ""
19480
19481 # type: textblock
19482 #. type: textblock
19483 #: ../src/guestfs-actions.pod:6870 ../fish/guestfish-actions.pod:4624
19484 msgid ""
19485 "This command gets the filesystem type corresponding to the filesystem on "
19486 "C<device>."
19487 msgstr ""
19488
19489 # type: textblock
19490 #. type: textblock
19491 #: ../src/guestfs-actions.pod:6873 ../fish/guestfish-actions.pod:4627
19492 msgid ""
19493 "For most filesystems, the result is the name of the Linux VFS module which "
19494 "would be used to mount this filesystem if you mounted it without specifying "
19495 "the filesystem type.  For example a string such as C<ext3> or C<ntfs>."
19496 msgstr ""
19497
19498 # type: =head2
19499 #. type: =head2
19500 #: ../src/guestfs-actions.pod:6883
19501 msgid "guestfs_vfs_uuid"
19502 msgstr ""
19503
19504 # type: verbatim
19505 #. type: verbatim
19506 #: ../src/guestfs-actions.pod:6885
19507 #, no-wrap
19508 msgid ""
19509 " char *\n"
19510 " guestfs_vfs_uuid (guestfs_h *g,\n"
19511 "                   const char *device);\n"
19512 "\n"
19513 msgstr ""
19514
19515 # type: textblock
19516 #. type: textblock
19517 #: ../src/guestfs-actions.pod:6889 ../fish/guestfish-actions.pod:4636
19518 msgid "This returns the filesystem UUID of the filesystem on C<device>."
19519 msgstr ""
19520
19521 # type: textblock
19522 #. type: textblock
19523 #: ../src/guestfs-actions.pod:6892 ../fish/guestfish-actions.pod:4639
19524 msgid "If the filesystem does not have a UUID, this returns the empty string."
19525 msgstr ""
19526
19527 # type: textblock
19528 #. type: textblock
19529 #: ../src/guestfs-actions.pod:6894
19530 msgid "To find a filesystem from the UUID, use C<guestfs_findfs_uuid>."
19531 msgstr ""
19532
19533 # type: =head2
19534 #. type: =head2
19535 #: ../src/guestfs-actions.pod:6901
19536 msgid "guestfs_vg_activate"
19537 msgstr ""
19538
19539 # type: verbatim
19540 #. type: verbatim
19541 #: ../src/guestfs-actions.pod:6903
19542 #, no-wrap
19543 msgid ""
19544 " int\n"
19545 " guestfs_vg_activate (guestfs_h *g,\n"
19546 "                      int activate,\n"
19547 "                      char *const *volgroups);\n"
19548 "\n"
19549 msgstr ""
19550
19551 # type: textblock
19552 #. type: textblock
19553 #: ../src/guestfs-actions.pod:6908 ../fish/guestfish-actions.pod:4647
19554 msgid ""
19555 "This command activates or (if C<activate> is false) deactivates all logical "
19556 "volumes in the listed volume groups C<volgroups>.  If activated, then they "
19557 "are made known to the kernel, ie. they appear as C</dev/mapper> devices.  If "
19558 "deactivated, then those devices disappear."
19559 msgstr ""
19560
19561 # type: textblock
19562 #. type: textblock
19563 #: ../src/guestfs-actions.pod:6914 ../fish/guestfish-actions.pod:4653
19564 msgid "This command is the same as running C<vgchange -a y|n volgroups...>"
19565 msgstr ""
19566
19567 # type: textblock
19568 #. type: textblock
19569 #: ../src/guestfs-actions.pod:6916 ../fish/guestfish-actions.pod:4655
19570 msgid ""
19571 "Note that if C<volgroups> is an empty list then B<all> volume groups are "
19572 "activated or deactivated."
19573 msgstr ""
19574
19575 # type: =head2
19576 #. type: =head2
19577 #: ../src/guestfs-actions.pod:6923
19578 msgid "guestfs_vg_activate_all"
19579 msgstr ""
19580
19581 # type: verbatim
19582 #. type: verbatim
19583 #: ../src/guestfs-actions.pod:6925
19584 #, no-wrap
19585 msgid ""
19586 " int\n"
19587 " guestfs_vg_activate_all (guestfs_h *g,\n"
19588 "                          int activate);\n"
19589 "\n"
19590 msgstr ""
19591
19592 # type: textblock
19593 #. type: textblock
19594 #: ../src/guestfs-actions.pod:6929 ../fish/guestfish-actions.pod:4662
19595 msgid ""
19596 "This command activates or (if C<activate> is false) deactivates all logical "
19597 "volumes in all volume groups.  If activated, then they are made known to the "
19598 "kernel, ie. they appear as C</dev/mapper> devices.  If deactivated, then "
19599 "those devices disappear."
19600 msgstr ""
19601
19602 # type: textblock
19603 #. type: textblock
19604 #: ../src/guestfs-actions.pod:6935 ../fish/guestfish-actions.pod:4668
19605 msgid "This command is the same as running C<vgchange -a y|n>"
19606 msgstr ""
19607
19608 # type: =head2
19609 #. type: =head2
19610 #: ../src/guestfs-actions.pod:6941
19611 msgid "guestfs_vgcreate"
19612 msgstr ""
19613
19614 # type: verbatim
19615 #. type: verbatim
19616 #: ../src/guestfs-actions.pod:6943
19617 #, no-wrap
19618 msgid ""
19619 " int\n"
19620 " guestfs_vgcreate (guestfs_h *g,\n"
19621 "                   const char *volgroup,\n"
19622 "                   char *const *physvols);\n"
19623 "\n"
19624 msgstr ""
19625
19626 # type: textblock
19627 #. type: textblock
19628 #: ../src/guestfs-actions.pod:6948 ../fish/guestfish-actions.pod:4674
19629 msgid ""
19630 "This creates an LVM volume group called C<volgroup> from the non-empty list "
19631 "of physical volumes C<physvols>."
19632 msgstr ""
19633
19634 # type: =head2
19635 #. type: =head2
19636 #: ../src/guestfs-actions.pod:6955
19637 msgid "guestfs_vglvuuids"
19638 msgstr ""
19639
19640 # type: verbatim
19641 #. type: verbatim
19642 #: ../src/guestfs-actions.pod:6957
19643 #, no-wrap
19644 msgid ""
19645 " char **\n"
19646 " guestfs_vglvuuids (guestfs_h *g,\n"
19647 "                    const char *vgname);\n"
19648 "\n"
19649 msgstr ""
19650
19651 # type: textblock
19652 #. type: textblock
19653 #: ../src/guestfs-actions.pod:6961 ../fish/guestfish-actions.pod:4681
19654 msgid ""
19655 "Given a VG called C<vgname>, this returns the UUIDs of all the logical "
19656 "volumes created in this volume group."
19657 msgstr ""
19658
19659 # type: textblock
19660 #. type: textblock
19661 #: ../src/guestfs-actions.pod:6964
19662 msgid ""
19663 "You can use this along with C<guestfs_lvs> and C<guestfs_lvuuid> calls to "
19664 "associate logical volumes and volume groups."
19665 msgstr ""
19666
19667 # type: textblock
19668 #. type: textblock
19669 #: ../src/guestfs-actions.pod:6967
19670 msgid "See also C<guestfs_vgpvuuids>."
19671 msgstr ""
19672
19673 # type: =head2
19674 #. type: =head2
19675 #: ../src/guestfs-actions.pod:6975
19676 msgid "guestfs_vgpvuuids"
19677 msgstr ""
19678
19679 # type: verbatim
19680 #. type: verbatim
19681 #: ../src/guestfs-actions.pod:6977
19682 #, no-wrap
19683 msgid ""
19684 " char **\n"
19685 " guestfs_vgpvuuids (guestfs_h *g,\n"
19686 "                    const char *vgname);\n"
19687 "\n"
19688 msgstr ""
19689
19690 # type: textblock
19691 #. type: textblock
19692 #: ../src/guestfs-actions.pod:6981 ../fish/guestfish-actions.pod:4693
19693 msgid ""
19694 "Given a VG called C<vgname>, this returns the UUIDs of all the physical "
19695 "volumes that this volume group resides on."
19696 msgstr ""
19697
19698 # type: textblock
19699 #. type: textblock
19700 #: ../src/guestfs-actions.pod:6984
19701 msgid ""
19702 "You can use this along with C<guestfs_pvs> and C<guestfs_pvuuid> calls to "
19703 "associate physical volumes and volume groups."
19704 msgstr ""
19705
19706 # type: textblock
19707 #. type: textblock
19708 #: ../src/guestfs-actions.pod:6987
19709 msgid "See also C<guestfs_vglvuuids>."
19710 msgstr ""
19711
19712 # type: =head2
19713 #. type: =head2
19714 #: ../src/guestfs-actions.pod:6995
19715 msgid "guestfs_vgremove"
19716 msgstr ""
19717
19718 # type: verbatim
19719 #. type: verbatim
19720 #: ../src/guestfs-actions.pod:6997
19721 #, no-wrap
19722 msgid ""
19723 " int\n"
19724 " guestfs_vgremove (guestfs_h *g,\n"
19725 "                   const char *vgname);\n"
19726 "\n"
19727 msgstr ""
19728
19729 # type: textblock
19730 #. type: textblock
19731 #: ../src/guestfs-actions.pod:7001 ../fish/guestfish-actions.pod:4705
19732 msgid "Remove an LVM volume group C<vgname>, (for example C<VG>)."
19733 msgstr ""
19734
19735 # type: textblock
19736 #. type: textblock
19737 #: ../src/guestfs-actions.pod:7003 ../fish/guestfish-actions.pod:4707
19738 msgid ""
19739 "This also forcibly removes all logical volumes in the volume group (if any)."
19740 msgstr ""
19741
19742 # type: =head2
19743 #. type: =head2
19744 #: ../src/guestfs-actions.pod:7010
19745 msgid "guestfs_vgrename"
19746 msgstr ""
19747
19748 # type: verbatim
19749 #. type: verbatim
19750 #: ../src/guestfs-actions.pod:7012
19751 #, no-wrap
19752 msgid ""
19753 " int\n"
19754 " guestfs_vgrename (guestfs_h *g,\n"
19755 "                   const char *volgroup,\n"
19756 "                   const char *newvolgroup);\n"
19757 "\n"
19758 msgstr ""
19759
19760 # type: textblock
19761 #. type: textblock
19762 #: ../src/guestfs-actions.pod:7017 ../fish/guestfish-actions.pod:4714
19763 msgid "Rename a volume group C<volgroup> with the new name C<newvolgroup>."
19764 msgstr ""
19765
19766 # type: =head2
19767 #. type: =head2
19768 #: ../src/guestfs-actions.pod:7023
19769 msgid "guestfs_vgs"
19770 msgstr ""
19771
19772 # type: verbatim
19773 #. type: verbatim
19774 #: ../src/guestfs-actions.pod:7025
19775 #, no-wrap
19776 msgid ""
19777 " char **\n"
19778 " guestfs_vgs (guestfs_h *g);\n"
19779 "\n"
19780 msgstr ""
19781
19782 # type: textblock
19783 #. type: textblock
19784 #: ../src/guestfs-actions.pod:7028 ../fish/guestfish-actions.pod:4720
19785 msgid ""
19786 "List all the volumes groups detected.  This is the equivalent of the L<vgs(8)"
19787 "> command."
19788 msgstr ""
19789
19790 # type: textblock
19791 #. type: textblock
19792 #: ../src/guestfs-actions.pod:7031 ../fish/guestfish-actions.pod:4723
19793 msgid ""
19794 "This returns a list of just the volume group names that were detected (eg. "
19795 "C<VolGroup00>)."
19796 msgstr ""
19797
19798 # type: textblock
19799 #. type: textblock
19800 #: ../src/guestfs-actions.pod:7034
19801 msgid "See also C<guestfs_vgs_full>."
19802 msgstr ""
19803
19804 # type: =head2
19805 #. type: =head2
19806 #: ../src/guestfs-actions.pod:7042
19807 msgid "guestfs_vgs_full"
19808 msgstr ""
19809
19810 # type: verbatim
19811 #. type: verbatim
19812 #: ../src/guestfs-actions.pod:7044
19813 #, no-wrap
19814 msgid ""
19815 " struct guestfs_lvm_vg_list *\n"
19816 " guestfs_vgs_full (guestfs_h *g);\n"
19817 "\n"
19818 msgstr ""
19819
19820 # type: textblock
19821 #. type: textblock
19822 #: ../src/guestfs-actions.pod:7047 ../fish/guestfish-actions.pod:4732
19823 msgid ""
19824 "List all the volumes groups detected.  This is the equivalent of the L<vgs(8)"
19825 "> command.  The \"full\" version includes all fields."
19826 msgstr ""
19827
19828 # type: textblock
19829 #. type: textblock
19830 #: ../src/guestfs-actions.pod:7050
19831 msgid ""
19832 "This function returns a C<struct guestfs_lvm_vg_list *>, or NULL if there "
19833 "was an error.  I<The caller must call C<guestfs_free_lvm_vg_list> after use>."
19834 msgstr ""
19835
19836 # type: =head2
19837 #. type: =head2
19838 #: ../src/guestfs-actions.pod:7056
19839 msgid "guestfs_vgscan"
19840 msgstr ""
19841
19842 # type: verbatim
19843 #. type: verbatim
19844 #: ../src/guestfs-actions.pod:7058
19845 #, no-wrap
19846 msgid ""
19847 " int\n"
19848 " guestfs_vgscan (guestfs_h *g);\n"
19849 "\n"
19850 msgstr ""
19851
19852 # type: textblock
19853 #. type: textblock
19854 #: ../src/guestfs-actions.pod:7061 ../fish/guestfish-actions.pod:4739
19855 msgid ""
19856 "This rescans all block devices and rebuilds the list of LVM physical "
19857 "volumes, volume groups and logical volumes."
19858 msgstr ""
19859
19860 # type: =head2
19861 #. type: =head2
19862 #: ../src/guestfs-actions.pod:7068
19863 msgid "guestfs_vguuid"
19864 msgstr ""
19865
19866 # type: verbatim
19867 #. type: verbatim
19868 #: ../src/guestfs-actions.pod:7070
19869 #, no-wrap
19870 msgid ""
19871 " char *\n"
19872 " guestfs_vguuid (guestfs_h *g,\n"
19873 "                 const char *vgname);\n"
19874 "\n"
19875 msgstr ""
19876
19877 # type: textblock
19878 #. type: textblock
19879 #: ../src/guestfs-actions.pod:7074 ../fish/guestfish-actions.pod:4746
19880 msgid "This command returns the UUID of the LVM VG named C<vgname>."
19881 msgstr ""
19882
19883 # type: =head2
19884 #. type: =head2
19885 #: ../src/guestfs-actions.pod:7081
19886 msgid "guestfs_wait_ready"
19887 msgstr ""
19888
19889 # type: verbatim
19890 #. type: verbatim
19891 #: ../src/guestfs-actions.pod:7083
19892 #, no-wrap
19893 msgid ""
19894 " int\n"
19895 " guestfs_wait_ready (guestfs_h *g);\n"
19896 "\n"
19897 msgstr ""
19898
19899 # type: textblock
19900 #. type: textblock
19901 #: ../src/guestfs-actions.pod:7086
19902 msgid "This function is a no op."
19903 msgstr ""
19904
19905 # type: textblock
19906 #. type: textblock
19907 #: ../src/guestfs-actions.pod:7088
19908 msgid ""
19909 "In versions of the API E<lt> 1.0.71 you had to call this function just after "
19910 "calling C<guestfs_launch> to wait for the launch to complete.  However this "
19911 "is no longer necessary because C<guestfs_launch> now does the waiting."
19912 msgstr ""
19913
19914 # type: textblock
19915 #. type: textblock
19916 #: ../src/guestfs-actions.pod:7093
19917 msgid ""
19918 "If you see any calls to this function in code then you can just remove them, "
19919 "unless you want to retain compatibility with older versions of the API."
19920 msgstr ""
19921
19922 # type: =head2
19923 #. type: =head2
19924 #: ../src/guestfs-actions.pod:7101
19925 msgid "guestfs_wc_c"
19926 msgstr ""
19927
19928 # type: verbatim
19929 #. type: verbatim
19930 #: ../src/guestfs-actions.pod:7103
19931 #, no-wrap
19932 msgid ""
19933 " int\n"
19934 " guestfs_wc_c (guestfs_h *g,\n"
19935 "               const char *path);\n"
19936 "\n"
19937 msgstr ""
19938
19939 # type: textblock
19940 #. type: textblock
19941 #: ../src/guestfs-actions.pod:7107 ../fish/guestfish-actions.pod:4752
19942 msgid ""
19943 "This command counts the characters in a file, using the C<wc -c> external "
19944 "command."
19945 msgstr ""
19946
19947 # type: =head2
19948 #. type: =head2
19949 #: ../src/guestfs-actions.pod:7114
19950 msgid "guestfs_wc_l"
19951 msgstr ""
19952
19953 # type: verbatim
19954 #. type: verbatim
19955 #: ../src/guestfs-actions.pod:7116
19956 #, no-wrap
19957 msgid ""
19958 " int\n"
19959 " guestfs_wc_l (guestfs_h *g,\n"
19960 "               const char *path);\n"
19961 "\n"
19962 msgstr ""
19963
19964 # type: textblock
19965 #. type: textblock
19966 #: ../src/guestfs-actions.pod:7120 ../fish/guestfish-actions.pod:4759
19967 msgid ""
19968 "This command counts the lines in a file, using the C<wc -l> external command."
19969 msgstr ""
19970
19971 # type: =head2
19972 #. type: =head2
19973 #: ../src/guestfs-actions.pod:7127
19974 msgid "guestfs_wc_w"
19975 msgstr ""
19976
19977 # type: verbatim
19978 #. type: verbatim
19979 #: ../src/guestfs-actions.pod:7129
19980 #, no-wrap
19981 msgid ""
19982 " int\n"
19983 " guestfs_wc_w (guestfs_h *g,\n"
19984 "               const char *path);\n"
19985 "\n"
19986 msgstr ""
19987
19988 # type: textblock
19989 #. type: textblock
19990 #: ../src/guestfs-actions.pod:7133 ../fish/guestfish-actions.pod:4766
19991 msgid ""
19992 "This command counts the words in a file, using the C<wc -w> external command."
19993 msgstr ""
19994
19995 # type: =head2
19996 #. type: =head2
19997 #: ../src/guestfs-actions.pod:7140
19998 msgid "guestfs_write"
19999 msgstr ""
20000
20001 # type: verbatim
20002 #. type: verbatim
20003 #: ../src/guestfs-actions.pod:7142
20004 #, no-wrap
20005 msgid ""
20006 " int\n"
20007 " guestfs_write (guestfs_h *g,\n"
20008 "                const char *path,\n"
20009 "                const char *content,\n"
20010 "                size_t content_size);\n"
20011 "\n"
20012 msgstr ""
20013
20014 # type: textblock
20015 #. type: textblock
20016 #: ../src/guestfs-actions.pod:7148 ../fish/guestfish-actions.pod:4773
20017 msgid ""
20018 "This call creates a file called C<path>.  The content of the file is the "
20019 "string C<content> (which can contain any 8 bit data)."
20020 msgstr ""
20021
20022 # type: =head2
20023 #. type: =head2
20024 #: ../src/guestfs-actions.pod:7158
20025 msgid "guestfs_write_file"
20026 msgstr ""
20027
20028 # type: verbatim
20029 #. type: verbatim
20030 #: ../src/guestfs-actions.pod:7160
20031 #, no-wrap
20032 msgid ""
20033 " int\n"
20034 " guestfs_write_file (guestfs_h *g,\n"
20035 "                     const char *path,\n"
20036 "                     const char *content,\n"
20037 "                     int size);\n"
20038 "\n"
20039 msgstr ""
20040
20041 # type: textblock
20042 #. type: textblock
20043 #: ../src/guestfs-actions.pod:7166 ../fish/guestfish-actions.pod:4783
20044 msgid ""
20045 "This call creates a file called C<path>.  The contents of the file is the "
20046 "string C<content> (which can contain any 8 bit data), with length C<size>."
20047 msgstr ""
20048
20049 # type: textblock
20050 #. type: textblock
20051 #: ../src/guestfs-actions.pod:7170 ../fish/guestfish-actions.pod:4787
20052 msgid ""
20053 "As a special case, if C<size> is C<0> then the length is calculated using "
20054 "C<strlen> (so in this case the content cannot contain embedded ASCII NULs)."
20055 msgstr ""
20056
20057 # type: textblock
20058 #. type: textblock
20059 #: ../src/guestfs-actions.pod:7174 ../fish/guestfish-actions.pod:4791
20060 msgid ""
20061 "I<NB.> Owing to a bug, writing content containing ASCII NUL characters does "
20062 "I<not> work, even if the length is specified."
20063 msgstr ""
20064
20065 # type: textblock
20066 #. type: textblock
20067 #: ../src/guestfs-actions.pod:7182 ../fish/guestfish-actions.pod:4797
20068 msgid ""
20069 "This function is deprecated.  In new code, use the C<write> call instead."
20070 msgstr ""
20071
20072 # type: =head2
20073 #. type: =head2
20074 #: ../src/guestfs-actions.pod:7191
20075 msgid "guestfs_zegrep"
20076 msgstr ""
20077
20078 # type: verbatim
20079 #. type: verbatim
20080 #: ../src/guestfs-actions.pod:7193
20081 #, no-wrap
20082 msgid ""
20083 " char **\n"
20084 " guestfs_zegrep (guestfs_h *g,\n"
20085 "                 const char *regex,\n"
20086 "                 const char *path);\n"
20087 "\n"
20088 msgstr ""
20089
20090 # type: textblock
20091 #. type: textblock
20092 #: ../src/guestfs-actions.pod:7198 ../fish/guestfish-actions.pod:4808
20093 msgid ""
20094 "This calls the external C<zegrep> program and returns the matching lines."
20095 msgstr ""
20096
20097 # type: =head2
20098 #. type: =head2
20099 #: ../src/guestfs-actions.pod:7210
20100 msgid "guestfs_zegrepi"
20101 msgstr ""
20102
20103 # type: verbatim
20104 #. type: verbatim
20105 #: ../src/guestfs-actions.pod:7212
20106 #, no-wrap
20107 msgid ""
20108 " char **\n"
20109 " guestfs_zegrepi (guestfs_h *g,\n"
20110 "                  const char *regex,\n"
20111 "                  const char *path);\n"
20112 "\n"
20113 msgstr ""
20114
20115 # type: textblock
20116 #. type: textblock
20117 #: ../src/guestfs-actions.pod:7217 ../fish/guestfish-actions.pod:4818
20118 msgid ""
20119 "This calls the external C<zegrep -i> program and returns the matching lines."
20120 msgstr ""
20121
20122 # type: =head2
20123 #. type: =head2
20124 #: ../src/guestfs-actions.pod:7229
20125 msgid "guestfs_zero"
20126 msgstr ""
20127
20128 # type: verbatim
20129 #. type: verbatim
20130 #: ../src/guestfs-actions.pod:7231
20131 #, no-wrap
20132 msgid ""
20133 " int\n"
20134 " guestfs_zero (guestfs_h *g,\n"
20135 "               const char *device);\n"
20136 "\n"
20137 msgstr ""
20138
20139 # type: textblock
20140 #. type: textblock
20141 #: ../src/guestfs-actions.pod:7235 ../fish/guestfish-actions.pod:4828
20142 msgid "This command writes zeroes over the first few blocks of C<device>."
20143 msgstr ""
20144
20145 # type: textblock
20146 #. type: textblock
20147 #: ../src/guestfs-actions.pod:7237 ../fish/guestfish-actions.pod:4830
20148 msgid ""
20149 "How many blocks are zeroed isn't specified (but it's I<not> enough to "
20150 "securely wipe the device).  It should be sufficient to remove any partition "
20151 "tables, filesystem superblocks and so on."
20152 msgstr ""
20153
20154 # type: textblock
20155 #. type: textblock
20156 #: ../src/guestfs-actions.pod:7241
20157 msgid "See also: C<guestfs_zero_device>, C<guestfs_scrub_device>."
20158 msgstr ""
20159
20160 # type: =head2
20161 #. type: =head2
20162 #: ../src/guestfs-actions.pod:7252
20163 msgid "guestfs_zero_device"
20164 msgstr ""
20165
20166 # type: verbatim
20167 #. type: verbatim
20168 #: ../src/guestfs-actions.pod:7254
20169 #, no-wrap
20170 msgid ""
20171 " int\n"
20172 " guestfs_zero_device (guestfs_h *g,\n"
20173 "                      const char *device);\n"
20174 "\n"
20175 msgstr ""
20176
20177 # type: textblock
20178 #. type: textblock
20179 #: ../src/guestfs-actions.pod:7258
20180 msgid ""
20181 "This command writes zeroes over the entire C<device>.  Compare with "
20182 "C<guestfs_zero> which just zeroes the first few blocks of a device."
20183 msgstr ""
20184
20185 # type: textblock
20186 #. type: textblock
20187 #: ../src/guestfs-actions.pod:7272
20188 msgid "(Added in 1.3.1)"
20189 msgstr ""
20190
20191 # type: =head2
20192 #. type: =head2
20193 #: ../src/guestfs-actions.pod:7274
20194 msgid "guestfs_zerofree"
20195 msgstr ""
20196
20197 # type: verbatim
20198 #. type: verbatim
20199 #: ../src/guestfs-actions.pod:7276
20200 #, no-wrap
20201 msgid ""
20202 " int\n"
20203 " guestfs_zerofree (guestfs_h *g,\n"
20204 "                   const char *device);\n"
20205 "\n"
20206 msgstr ""
20207
20208 # type: textblock
20209 #. type: textblock
20210 #: ../src/guestfs-actions.pod:7280 ../fish/guestfish-actions.pod:4851
20211 msgid ""
20212 "This runs the I<zerofree> program on C<device>.  This program claims to zero "
20213 "unused inodes and disk blocks on an ext2/3 filesystem, thus making it "
20214 "possible to compress the filesystem more effectively."
20215 msgstr ""
20216
20217 # type: textblock
20218 #. type: textblock
20219 #: ../src/guestfs-actions.pod:7285 ../fish/guestfish-actions.pod:4856
20220 msgid "You should B<not> run this program if the filesystem is mounted."
20221 msgstr ""
20222
20223 # type: textblock
20224 #. type: textblock
20225 #: ../src/guestfs-actions.pod:7288 ../fish/guestfish-actions.pod:4859
20226 msgid ""
20227 "It is possible that using this program can damage the filesystem or data on "
20228 "the filesystem."
20229 msgstr ""
20230
20231 # type: =head2
20232 #. type: =head2
20233 #: ../src/guestfs-actions.pod:7295
20234 msgid "guestfs_zfgrep"
20235 msgstr ""
20236
20237 # type: verbatim
20238 #. type: verbatim
20239 #: ../src/guestfs-actions.pod:7297
20240 #, no-wrap
20241 msgid ""
20242 " char **\n"
20243 " guestfs_zfgrep (guestfs_h *g,\n"
20244 "                 const char *pattern,\n"
20245 "                 const char *path);\n"
20246 "\n"
20247 msgstr ""
20248
20249 # type: textblock
20250 #. type: textblock
20251 #: ../src/guestfs-actions.pod:7302 ../fish/guestfish-actions.pod:4866
20252 msgid ""
20253 "This calls the external C<zfgrep> program and returns the matching lines."
20254 msgstr ""
20255
20256 # type: =head2
20257 #. type: =head2
20258 #: ../src/guestfs-actions.pod:7314
20259 msgid "guestfs_zfgrepi"
20260 msgstr ""
20261
20262 # type: verbatim
20263 #. type: verbatim
20264 #: ../src/guestfs-actions.pod:7316
20265 #, no-wrap
20266 msgid ""
20267 " char **\n"
20268 " guestfs_zfgrepi (guestfs_h *g,\n"
20269 "                  const char *pattern,\n"
20270 "                  const char *path);\n"
20271 "\n"
20272 msgstr ""
20273
20274 # type: textblock
20275 #. type: textblock
20276 #: ../src/guestfs-actions.pod:7321 ../fish/guestfish-actions.pod:4876
20277 msgid ""
20278 "This calls the external C<zfgrep -i> program and returns the matching lines."
20279 msgstr ""
20280
20281 # type: =head2
20282 #. type: =head2
20283 #: ../src/guestfs-actions.pod:7333
20284 msgid "guestfs_zfile"
20285 msgstr ""
20286
20287 # type: verbatim
20288 #. type: verbatim
20289 #: ../src/guestfs-actions.pod:7335
20290 #, no-wrap
20291 msgid ""
20292 " char *\n"
20293 " guestfs_zfile (guestfs_h *g,\n"
20294 "                const char *meth,\n"
20295 "                const char *path);\n"
20296 "\n"
20297 msgstr ""
20298
20299 # type: textblock
20300 #. type: textblock
20301 #: ../src/guestfs-actions.pod:7340 ../fish/guestfish-actions.pod:4886
20302 msgid ""
20303 "This command runs C<file> after first decompressing C<path> using C<method>."
20304 msgstr ""
20305
20306 # type: textblock
20307 #. type: textblock
20308 #: ../src/guestfs-actions.pod:7343 ../fish/guestfish-actions.pod:4889
20309 msgid "C<method> must be one of C<gzip>, C<compress> or C<bzip2>."
20310 msgstr ""
20311
20312 # type: textblock
20313 #. type: textblock
20314 #: ../src/guestfs-actions.pod:7345
20315 msgid ""
20316 "Since 1.0.63, use C<guestfs_file> instead which can now process compressed "
20317 "files."
20318 msgstr ""
20319
20320 # type: textblock
20321 #. type: textblock
20322 #: ../src/guestfs-actions.pod:7351 ../fish/guestfish-actions.pod:4894
20323 msgid ""
20324 "This function is deprecated.  In new code, use the C<file> call instead."
20325 msgstr ""
20326
20327 # type: =head2
20328 #. type: =head2
20329 #: ../src/guestfs-actions.pod:7360
20330 msgid "guestfs_zgrep"
20331 msgstr ""
20332
20333 # type: verbatim
20334 #. type: verbatim
20335 #: ../src/guestfs-actions.pod:7362
20336 #, no-wrap
20337 msgid ""
20338 " char **\n"
20339 " guestfs_zgrep (guestfs_h *g,\n"
20340 "                const char *regex,\n"
20341 "                const char *path);\n"
20342 "\n"
20343 msgstr ""
20344
20345 # type: textblock
20346 #. type: textblock
20347 #: ../src/guestfs-actions.pod:7367 ../fish/guestfish-actions.pod:4905
20348 msgid ""
20349 "This calls the external C<zgrep> program and returns the matching lines."
20350 msgstr ""
20351
20352 # type: =head2
20353 #. type: =head2
20354 #: ../src/guestfs-actions.pod:7379
20355 msgid "guestfs_zgrepi"
20356 msgstr ""
20357
20358 # type: verbatim
20359 #. type: verbatim
20360 #: ../src/guestfs-actions.pod:7381
20361 #, no-wrap
20362 msgid ""
20363 " char **\n"
20364 " guestfs_zgrepi (guestfs_h *g,\n"
20365 "                 const char *regex,\n"
20366 "                 const char *path);\n"
20367 "\n"
20368 msgstr ""
20369
20370 # type: textblock
20371 #. type: textblock
20372 #: ../src/guestfs-actions.pod:7386 ../fish/guestfish-actions.pod:4915
20373 msgid ""
20374 "This calls the external C<zgrep -i> program and returns the matching lines."
20375 msgstr ""
20376
20377 # type: =item
20378 #. type: =item
20379 #: ../src/guestfs-availability.pod:3
20380 msgid "B<augeas>"
20381 msgstr ""
20382
20383 # type: textblock
20384 #. type: textblock
20385 #: ../src/guestfs-availability.pod:5
20386 msgid ""
20387 "The following functions: L</guestfs_aug_clear> L</guestfs_aug_close> L</"
20388 "guestfs_aug_defnode> L</guestfs_aug_defvar> L</guestfs_aug_get> L</"
20389 "guestfs_aug_init> L</guestfs_aug_insert> L</guestfs_aug_load> L</"
20390 "guestfs_aug_ls> L</guestfs_aug_match> L</guestfs_aug_mv> L</guestfs_aug_rm> "
20391 "L</guestfs_aug_save> L</guestfs_aug_set>"
20392 msgstr ""
20393
20394 # type: =item
20395 #. type: =item
20396 #: ../src/guestfs-availability.pod:21
20397 msgid "B<inotify>"
20398 msgstr ""
20399
20400 # type: textblock
20401 #. type: textblock
20402 #: ../src/guestfs-availability.pod:23
20403 msgid ""
20404 "The following functions: L</guestfs_inotify_add_watch> L</"
20405 "guestfs_inotify_close> L</guestfs_inotify_files> L</guestfs_inotify_init> L</"
20406 "guestfs_inotify_read> L</guestfs_inotify_rm_watch>"
20407 msgstr ""
20408
20409 # type: =item
20410 #. type: =item
20411 #: ../src/guestfs-availability.pod:31
20412 msgid "B<linuxfsuuid>"
20413 msgstr ""
20414
20415 # type: textblock
20416 #. type: textblock
20417 #: ../src/guestfs-availability.pod:33
20418 msgid ""
20419 "The following functions: L</guestfs_mke2fs_JU> L</guestfs_mke2journal_U> L</"
20420 "guestfs_mkswap_U> L</guestfs_swapoff_uuid> L</guestfs_swapon_uuid>"
20421 msgstr ""
20422
20423 # type: =item
20424 #. type: =item
20425 #: ../src/guestfs-availability.pod:40
20426 msgid "B<linuxmodules>"
20427 msgstr ""
20428
20429 # type: textblock
20430 #. type: textblock
20431 #: ../src/guestfs-availability.pod:42
20432 msgid "The following functions: L</guestfs_modprobe>"
20433 msgstr ""
20434
20435 # type: =item
20436 #. type: =item
20437 #: ../src/guestfs-availability.pod:45
20438 msgid "B<linuxxattrs>"
20439 msgstr ""
20440
20441 # type: textblock
20442 #. type: textblock
20443 #: ../src/guestfs-availability.pod:47
20444 msgid ""
20445 "The following functions: L</guestfs_getxattr> L</guestfs_getxattrs> L</"
20446 "guestfs_lgetxattr> L</guestfs_lgetxattrs> L</guestfs_lremovexattr> L</"
20447 "guestfs_lsetxattr> L</guestfs_lxattrlist> L</guestfs_removexattr> L</"
20448 "guestfs_setxattr>"
20449 msgstr ""
20450
20451 # type: =item
20452 #. type: =item
20453 #: ../src/guestfs-availability.pod:58
20454 msgid "B<luks>"
20455 msgstr ""
20456
20457 # type: textblock
20458 #. type: textblock
20459 #: ../src/guestfs-availability.pod:60
20460 msgid ""
20461 "The following functions: L</guestfs_luks_add_key> L</guestfs_luks_close> L</"
20462 "guestfs_luks_format> L</guestfs_luks_format_cipher> L</"
20463 "guestfs_luks_kill_slot> L</guestfs_luks_open> L</guestfs_luks_open_ro>"
20464 msgstr ""
20465
20466 # type: =item
20467 #. type: =item
20468 #: ../src/guestfs-availability.pod:69
20469 msgid "B<lvm2>"
20470 msgstr ""
20471
20472 # type: textblock
20473 #. type: textblock
20474 #: ../src/guestfs-availability.pod:71
20475 msgid ""
20476 "The following functions: L</guestfs_is_lv> L</guestfs_lvcreate> L</"
20477 "guestfs_lvm_remove_all> L</guestfs_lvm_set_filter> L</guestfs_lvremove> L</"
20478 "guestfs_lvresize> L</guestfs_lvresize_free> L</guestfs_lvs> L</"
20479 "guestfs_lvs_full> L</guestfs_pvcreate> L</guestfs_pvremove> L</"
20480 "guestfs_pvresize> L</guestfs_pvresize_size> L</guestfs_pvs> L</"
20481 "guestfs_pvs_full> L</guestfs_vg_activate> L</guestfs_vg_activate_all> L</"
20482 "guestfs_vgcreate> L</guestfs_vgremove> L</guestfs_vgs> L</guestfs_vgs_full>"
20483 msgstr ""
20484
20485 # type: =item
20486 #. type: =item
20487 #: ../src/guestfs-availability.pod:94
20488 msgid "B<mknod>"
20489 msgstr ""
20490
20491 # type: textblock
20492 #. type: textblock
20493 #: ../src/guestfs-availability.pod:96
20494 msgid ""
20495 "The following functions: L</guestfs_mkfifo> L</guestfs_mknod> L</"
20496 "guestfs_mknod_b> L</guestfs_mknod_c>"
20497 msgstr ""
20498
20499 # type: =item
20500 #. type: =item
20501 #: ../src/guestfs-availability.pod:102
20502 msgid "B<ntfs3g>"
20503 msgstr ""
20504
20505 # type: textblock
20506 #. type: textblock
20507 #: ../src/guestfs-availability.pod:104
20508 msgid "The following functions: L</guestfs_ntfs_3g_probe>"
20509 msgstr ""
20510
20511 # type: =item
20512 #. type: =item
20513 #: ../src/guestfs-availability.pod:107
20514 msgid "B<ntfsprogs>"
20515 msgstr ""
20516
20517 # type: textblock
20518 #. type: textblock
20519 #: ../src/guestfs-availability.pod:109
20520 msgid ""
20521 "The following functions: L</guestfs_ntfsresize> L</guestfs_ntfsresize_size>"
20522 msgstr ""
20523
20524 # type: =item
20525 #. type: =item
20526 #: ../src/guestfs-availability.pod:113
20527 msgid "B<realpath>"
20528 msgstr ""
20529
20530 # type: textblock
20531 #. type: textblock
20532 #: ../src/guestfs-availability.pod:115
20533 msgid "The following functions: L</guestfs_realpath>"
20534 msgstr ""
20535
20536 # type: =item
20537 #. type: =item
20538 #: ../src/guestfs-availability.pod:118
20539 msgid "B<scrub>"
20540 msgstr ""
20541
20542 # type: textblock
20543 #. type: textblock
20544 #: ../src/guestfs-availability.pod:120
20545 msgid ""
20546 "The following functions: L</guestfs_scrub_device> L</guestfs_scrub_file> L</"
20547 "guestfs_scrub_freespace>"
20548 msgstr ""
20549
20550 # type: =item
20551 #. type: =item
20552 #: ../src/guestfs-availability.pod:125
20553 msgid "B<selinux>"
20554 msgstr ""
20555
20556 # type: textblock
20557 #. type: textblock
20558 #: ../src/guestfs-availability.pod:127
20559 msgid "The following functions: L</guestfs_getcon> L</guestfs_setcon>"
20560 msgstr ""
20561
20562 # type: =item
20563 #. type: =item
20564 #: ../src/guestfs-availability.pod:131
20565 msgid "B<xz>"
20566 msgstr ""
20567
20568 # type: textblock
20569 #. type: textblock
20570 #: ../src/guestfs-availability.pod:133
20571 msgid "The following functions: L</guestfs_txz_in> L</guestfs_txz_out>"
20572 msgstr ""
20573
20574 # type: =item
20575 #. type: =item
20576 #: ../src/guestfs-availability.pod:137
20577 msgid "B<zerofree>"
20578 msgstr ""
20579
20580 # type: textblock
20581 #. type: textblock
20582 #: ../src/guestfs-availability.pod:139
20583 msgid "The following functions: L</guestfs_zerofree>"
20584 msgstr ""
20585
20586 # type: =head2
20587 #. type: =head2
20588 #: ../src/guestfs-structs.pod:1
20589 msgid "guestfs_int_bool"
20590 msgstr ""
20591
20592 # type: verbatim
20593 #. type: verbatim
20594 #: ../src/guestfs-structs.pod:3
20595 #, no-wrap
20596 msgid ""
20597 " struct guestfs_int_bool {\n"
20598 "   int32_t i;\n"
20599 "   int32_t b;\n"
20600 " };\n"
20601 " \n"
20602 msgstr ""
20603
20604 # type: verbatim
20605 #. type: verbatim
20606 #: ../src/guestfs-structs.pod:8
20607 #, no-wrap
20608 msgid ""
20609 " struct guestfs_int_bool_list {\n"
20610 "   uint32_t len; /* Number of elements in list. */\n"
20611 "   struct guestfs_int_bool *val; /* Elements. */\n"
20612 " };\n"
20613 " \n"
20614 msgstr ""
20615
20616 # type: verbatim
20617 #. type: verbatim
20618 #: ../src/guestfs-structs.pod:13
20619 #, no-wrap
20620 msgid ""
20621 " void guestfs_free_int_bool (struct guestfs_free_int_bool *);\n"
20622 " void guestfs_free_int_bool_list (struct guestfs_free_int_bool_list *);\n"
20623 "\n"
20624 msgstr ""
20625
20626 # type: =head2
20627 #. type: =head2
20628 #: ../src/guestfs-structs.pod:16
20629 msgid "guestfs_lvm_pv"
20630 msgstr ""
20631
20632 # type: verbatim
20633 #. type: verbatim
20634 #: ../src/guestfs-structs.pod:18
20635 #, no-wrap
20636 msgid ""
20637 " struct guestfs_lvm_pv {\n"
20638 "   char *pv_name;\n"
20639 "   /* The next field is NOT nul-terminated, be careful when printing it: */\n"
20640 "   char pv_uuid[32];\n"
20641 "   char *pv_fmt;\n"
20642 "   uint64_t pv_size;\n"
20643 "   uint64_t dev_size;\n"
20644 "   uint64_t pv_free;\n"
20645 "   uint64_t pv_used;\n"
20646 "   char *pv_attr;\n"
20647 "   int64_t pv_pe_count;\n"
20648 "   int64_t pv_pe_alloc_count;\n"
20649 "   char *pv_tags;\n"
20650 "   uint64_t pe_start;\n"
20651 "   int64_t pv_mda_count;\n"
20652 "   uint64_t pv_mda_free;\n"
20653 " };\n"
20654 " \n"
20655 msgstr ""
20656
20657 # type: verbatim
20658 #. type: verbatim
20659 #: ../src/guestfs-structs.pod:36
20660 #, no-wrap
20661 msgid ""
20662 " struct guestfs_lvm_pv_list {\n"
20663 "   uint32_t len; /* Number of elements in list. */\n"
20664 "   struct guestfs_lvm_pv *val; /* Elements. */\n"
20665 " };\n"
20666 " \n"
20667 msgstr ""
20668
20669 # type: verbatim
20670 #. type: verbatim
20671 #: ../src/guestfs-structs.pod:41
20672 #, no-wrap
20673 msgid ""
20674 " void guestfs_free_lvm_pv (struct guestfs_free_lvm_pv *);\n"
20675 " void guestfs_free_lvm_pv_list (struct guestfs_free_lvm_pv_list *);\n"
20676 "\n"
20677 msgstr ""
20678
20679 # type: =head2
20680 #. type: =head2
20681 #: ../src/guestfs-structs.pod:44
20682 msgid "guestfs_lvm_vg"
20683 msgstr ""
20684
20685 # type: verbatim
20686 #. type: verbatim
20687 #: ../src/guestfs-structs.pod:46
20688 #, no-wrap
20689 msgid ""
20690 " struct guestfs_lvm_vg {\n"
20691 "   char *vg_name;\n"
20692 "   /* The next field is NOT nul-terminated, be careful when printing it: */\n"
20693 "   char vg_uuid[32];\n"
20694 "   char *vg_fmt;\n"
20695 "   char *vg_attr;\n"
20696 "   uint64_t vg_size;\n"
20697 "   uint64_t vg_free;\n"
20698 "   char *vg_sysid;\n"
20699 "   uint64_t vg_extent_size;\n"
20700 "   int64_t vg_extent_count;\n"
20701 "   int64_t vg_free_count;\n"
20702 "   int64_t max_lv;\n"
20703 "   int64_t max_pv;\n"
20704 "   int64_t pv_count;\n"
20705 "   int64_t lv_count;\n"
20706 "   int64_t snap_count;\n"
20707 "   int64_t vg_seqno;\n"
20708 "   char *vg_tags;\n"
20709 "   int64_t vg_mda_count;\n"
20710 "   uint64_t vg_mda_free;\n"
20711 " };\n"
20712 " \n"
20713 msgstr ""
20714
20715 # type: verbatim
20716 #. type: verbatim
20717 #: ../src/guestfs-structs.pod:69
20718 #, no-wrap
20719 msgid ""
20720 " struct guestfs_lvm_vg_list {\n"
20721 "   uint32_t len; /* Number of elements in list. */\n"
20722 "   struct guestfs_lvm_vg *val; /* Elements. */\n"
20723 " };\n"
20724 " \n"
20725 msgstr ""
20726
20727 # type: verbatim
20728 #. type: verbatim
20729 #: ../src/guestfs-structs.pod:74
20730 #, no-wrap
20731 msgid ""
20732 " void guestfs_free_lvm_vg (struct guestfs_free_lvm_vg *);\n"
20733 " void guestfs_free_lvm_vg_list (struct guestfs_free_lvm_vg_list *);\n"
20734 "\n"
20735 msgstr ""
20736
20737 # type: =head2
20738 #. type: =head2
20739 #: ../src/guestfs-structs.pod:77
20740 msgid "guestfs_lvm_lv"
20741 msgstr ""
20742
20743 # type: verbatim
20744 #. type: verbatim
20745 #: ../src/guestfs-structs.pod:79
20746 #, no-wrap
20747 msgid ""
20748 " struct guestfs_lvm_lv {\n"
20749 "   char *lv_name;\n"
20750 "   /* The next field is NOT nul-terminated, be careful when printing it: */\n"
20751 "   char lv_uuid[32];\n"
20752 "   char *lv_attr;\n"
20753 "   int64_t lv_major;\n"
20754 "   int64_t lv_minor;\n"
20755 "   int64_t lv_kernel_major;\n"
20756 "   int64_t lv_kernel_minor;\n"
20757 "   uint64_t lv_size;\n"
20758 "   int64_t seg_count;\n"
20759 "   char *origin;\n"
20760 "   /* The next field is [0..100] or -1 meaning 'not present': */\n"
20761 "   float snap_percent;\n"
20762 "   /* The next field is [0..100] or -1 meaning 'not present': */\n"
20763 "   float copy_percent;\n"
20764 "   char *move_pv;\n"
20765 "   char *lv_tags;\n"
20766 "   char *mirror_log;\n"
20767 "   char *modules;\n"
20768 " };\n"
20769 " \n"
20770 msgstr ""
20771
20772 # type: verbatim
20773 #. type: verbatim
20774 #: ../src/guestfs-structs.pod:101
20775 #, no-wrap
20776 msgid ""
20777 " struct guestfs_lvm_lv_list {\n"
20778 "   uint32_t len; /* Number of elements in list. */\n"
20779 "   struct guestfs_lvm_lv *val; /* Elements. */\n"
20780 " };\n"
20781 " \n"
20782 msgstr ""
20783
20784 # type: verbatim
20785 #. type: verbatim
20786 #: ../src/guestfs-structs.pod:106
20787 #, no-wrap
20788 msgid ""
20789 " void guestfs_free_lvm_lv (struct guestfs_free_lvm_lv *);\n"
20790 " void guestfs_free_lvm_lv_list (struct guestfs_free_lvm_lv_list *);\n"
20791 "\n"
20792 msgstr ""
20793
20794 # type: verbatim
20795 #. type: verbatim
20796 #: ../src/guestfs-structs.pod:111
20797 #, no-wrap
20798 msgid ""
20799 " struct guestfs_stat {\n"
20800 "   int64_t dev;\n"
20801 "   int64_t ino;\n"
20802 "   int64_t mode;\n"
20803 "   int64_t nlink;\n"
20804 "   int64_t uid;\n"
20805 "   int64_t gid;\n"
20806 "   int64_t rdev;\n"
20807 "   int64_t size;\n"
20808 "   int64_t blksize;\n"
20809 "   int64_t blocks;\n"
20810 "   int64_t atime;\n"
20811 "   int64_t mtime;\n"
20812 "   int64_t ctime;\n"
20813 " };\n"
20814 " \n"
20815 msgstr ""
20816
20817 # type: verbatim
20818 #. type: verbatim
20819 #: ../src/guestfs-structs.pod:127
20820 #, no-wrap
20821 msgid ""
20822 " struct guestfs_stat_list {\n"
20823 "   uint32_t len; /* Number of elements in list. */\n"
20824 "   struct guestfs_stat *val; /* Elements. */\n"
20825 " };\n"
20826 " \n"
20827 msgstr ""
20828
20829 # type: verbatim
20830 #. type: verbatim
20831 #: ../src/guestfs-structs.pod:132
20832 #, no-wrap
20833 msgid ""
20834 " void guestfs_free_stat (struct guestfs_free_stat *);\n"
20835 " void guestfs_free_stat_list (struct guestfs_free_stat_list *);\n"
20836 "\n"
20837 msgstr ""
20838
20839 # type: verbatim
20840 #. type: verbatim
20841 #: ../src/guestfs-structs.pod:137
20842 #, no-wrap
20843 msgid ""
20844 " struct guestfs_statvfs {\n"
20845 "   int64_t bsize;\n"
20846 "   int64_t frsize;\n"
20847 "   int64_t blocks;\n"
20848 "   int64_t bfree;\n"
20849 "   int64_t bavail;\n"
20850 "   int64_t files;\n"
20851 "   int64_t ffree;\n"
20852 "   int64_t favail;\n"
20853 "   int64_t fsid;\n"
20854 "   int64_t flag;\n"
20855 "   int64_t namemax;\n"
20856 " };\n"
20857 " \n"
20858 msgstr ""
20859
20860 # type: verbatim
20861 #. type: verbatim
20862 #: ../src/guestfs-structs.pod:151
20863 #, no-wrap
20864 msgid ""
20865 " struct guestfs_statvfs_list {\n"
20866 "   uint32_t len; /* Number of elements in list. */\n"
20867 "   struct guestfs_statvfs *val; /* Elements. */\n"
20868 " };\n"
20869 " \n"
20870 msgstr ""
20871
20872 # type: verbatim
20873 #. type: verbatim
20874 #: ../src/guestfs-structs.pod:156
20875 #, no-wrap
20876 msgid ""
20877 " void guestfs_free_statvfs (struct guestfs_free_statvfs *);\n"
20878 " void guestfs_free_statvfs_list (struct guestfs_free_statvfs_list *);\n"
20879 "\n"
20880 msgstr ""
20881
20882 # type: =head2
20883 #. type: =head2
20884 #: ../src/guestfs-structs.pod:159
20885 msgid "guestfs_dirent"
20886 msgstr ""
20887
20888 # type: verbatim
20889 #. type: verbatim
20890 #: ../src/guestfs-structs.pod:161
20891 #, no-wrap
20892 msgid ""
20893 " struct guestfs_dirent {\n"
20894 "   int64_t ino;\n"
20895 "   char ftyp;\n"
20896 "   char *name;\n"
20897 " };\n"
20898 " \n"
20899 msgstr ""
20900
20901 # type: verbatim
20902 #. type: verbatim
20903 #: ../src/guestfs-structs.pod:167
20904 #, no-wrap
20905 msgid ""
20906 " struct guestfs_dirent_list {\n"
20907 "   uint32_t len; /* Number of elements in list. */\n"
20908 "   struct guestfs_dirent *val; /* Elements. */\n"
20909 " };\n"
20910 " \n"
20911 msgstr ""
20912
20913 # type: verbatim
20914 #. type: verbatim
20915 #: ../src/guestfs-structs.pod:172
20916 #, no-wrap
20917 msgid ""
20918 " void guestfs_free_dirent (struct guestfs_free_dirent *);\n"
20919 " void guestfs_free_dirent_list (struct guestfs_free_dirent_list *);\n"
20920 "\n"
20921 msgstr ""
20922
20923 # type: verbatim
20924 #. type: verbatim
20925 #: ../src/guestfs-structs.pod:177
20926 #, no-wrap
20927 msgid ""
20928 " struct guestfs_version {\n"
20929 "   int64_t major;\n"
20930 "   int64_t minor;\n"
20931 "   int64_t release;\n"
20932 "   char *extra;\n"
20933 " };\n"
20934 " \n"
20935 msgstr ""
20936
20937 # type: verbatim
20938 #. type: verbatim
20939 #: ../src/guestfs-structs.pod:184
20940 #, no-wrap
20941 msgid ""
20942 " struct guestfs_version_list {\n"
20943 "   uint32_t len; /* Number of elements in list. */\n"
20944 "   struct guestfs_version *val; /* Elements. */\n"
20945 " };\n"
20946 " \n"
20947 msgstr ""
20948
20949 # type: verbatim
20950 #. type: verbatim
20951 #: ../src/guestfs-structs.pod:189
20952 #, no-wrap
20953 msgid ""
20954 " void guestfs_free_version (struct guestfs_free_version *);\n"
20955 " void guestfs_free_version_list (struct guestfs_free_version_list *);\n"
20956 "\n"
20957 msgstr ""
20958
20959 # type: =head2
20960 #. type: =head2
20961 #: ../src/guestfs-structs.pod:192
20962 msgid "guestfs_xattr"
20963 msgstr ""
20964
20965 # type: verbatim
20966 #. type: verbatim
20967 #: ../src/guestfs-structs.pod:194
20968 #, no-wrap
20969 msgid ""
20970 " struct guestfs_xattr {\n"
20971 "   char *attrname;\n"
20972 "   /* The next two fields describe a byte array. */\n"
20973 "   uint32_t attrval_len;\n"
20974 "   char *attrval;\n"
20975 " };\n"
20976 " \n"
20977 msgstr ""
20978
20979 # type: verbatim
20980 #. type: verbatim
20981 #: ../src/guestfs-structs.pod:201
20982 #, no-wrap
20983 msgid ""
20984 " struct guestfs_xattr_list {\n"
20985 "   uint32_t len; /* Number of elements in list. */\n"
20986 "   struct guestfs_xattr *val; /* Elements. */\n"
20987 " };\n"
20988 " \n"
20989 msgstr ""
20990
20991 # type: verbatim
20992 #. type: verbatim
20993 #: ../src/guestfs-structs.pod:206
20994 #, no-wrap
20995 msgid ""
20996 " void guestfs_free_xattr (struct guestfs_free_xattr *);\n"
20997 " void guestfs_free_xattr_list (struct guestfs_free_xattr_list *);\n"
20998 "\n"
20999 msgstr ""
21000
21001 # type: =head2
21002 #. type: =head2
21003 #: ../src/guestfs-structs.pod:209
21004 msgid "guestfs_inotify_event"
21005 msgstr ""
21006
21007 # type: verbatim
21008 #. type: verbatim
21009 #: ../src/guestfs-structs.pod:211
21010 #, no-wrap
21011 msgid ""
21012 " struct guestfs_inotify_event {\n"
21013 "   int64_t in_wd;\n"
21014 "   uint32_t in_mask;\n"
21015 "   uint32_t in_cookie;\n"
21016 "   char *in_name;\n"
21017 " };\n"
21018 " \n"
21019 msgstr ""
21020
21021 # type: verbatim
21022 #. type: verbatim
21023 #: ../src/guestfs-structs.pod:218
21024 #, no-wrap
21025 msgid ""
21026 " struct guestfs_inotify_event_list {\n"
21027 "   uint32_t len; /* Number of elements in list. */\n"
21028 "   struct guestfs_inotify_event *val; /* Elements. */\n"
21029 " };\n"
21030 " \n"
21031 msgstr ""
21032
21033 # type: verbatim
21034 #. type: verbatim
21035 #: ../src/guestfs-structs.pod:223
21036 #, no-wrap
21037 msgid ""
21038 " void guestfs_free_inotify_event (struct guestfs_free_inotify_event *);\n"
21039 " void guestfs_free_inotify_event_list (struct guestfs_free_inotify_event_list *);\n"
21040 "\n"
21041 msgstr ""
21042
21043 # type: =head2
21044 #. type: =head2
21045 #: ../src/guestfs-structs.pod:226
21046 msgid "guestfs_partition"
21047 msgstr ""
21048
21049 # type: verbatim
21050 #. type: verbatim
21051 #: ../src/guestfs-structs.pod:228
21052 #, no-wrap
21053 msgid ""
21054 " struct guestfs_partition {\n"
21055 "   int32_t part_num;\n"
21056 "   uint64_t part_start;\n"
21057 "   uint64_t part_end;\n"
21058 "   uint64_t part_size;\n"
21059 " };\n"
21060 " \n"
21061 msgstr ""
21062
21063 # type: verbatim
21064 #. type: verbatim
21065 #: ../src/guestfs-structs.pod:235
21066 #, no-wrap
21067 msgid ""
21068 " struct guestfs_partition_list {\n"
21069 "   uint32_t len; /* Number of elements in list. */\n"
21070 "   struct guestfs_partition *val; /* Elements. */\n"
21071 " };\n"
21072 " \n"
21073 msgstr ""
21074
21075 # type: verbatim
21076 #. type: verbatim
21077 #: ../src/guestfs-structs.pod:240
21078 #, no-wrap
21079 msgid ""
21080 " void guestfs_free_partition (struct guestfs_free_partition *);\n"
21081 " void guestfs_free_partition_list (struct guestfs_free_partition_list *);\n"
21082 "\n"
21083 msgstr ""
21084
21085 # type: =head2
21086 #. type: =head2
21087 #: ../src/guestfs-structs.pod:243
21088 msgid "guestfs_application"
21089 msgstr ""
21090
21091 # type: verbatim
21092 #. type: verbatim
21093 #: ../src/guestfs-structs.pod:245
21094 #, no-wrap
21095 msgid ""
21096 " struct guestfs_application {\n"
21097 "   char *app_name;\n"
21098 "   char *app_display_name;\n"
21099 "   int32_t app_epoch;\n"
21100 "   char *app_version;\n"
21101 "   char *app_release;\n"
21102 "   char *app_install_path;\n"
21103 "   char *app_trans_path;\n"
21104 "   char *app_publisher;\n"
21105 "   char *app_url;\n"
21106 "   char *app_source_package;\n"
21107 "   char *app_summary;\n"
21108 "   char *app_description;\n"
21109 " };\n"
21110 " \n"
21111 msgstr ""
21112
21113 # type: verbatim
21114 #. type: verbatim
21115 #: ../src/guestfs-structs.pod:260
21116 #, no-wrap
21117 msgid ""
21118 " struct guestfs_application_list {\n"
21119 "   uint32_t len; /* Number of elements in list. */\n"
21120 "   struct guestfs_application *val; /* Elements. */\n"
21121 " };\n"
21122 " \n"
21123 msgstr ""
21124
21125 # type: verbatim
21126 #. type: verbatim
21127 #: ../src/guestfs-structs.pod:265
21128 #, no-wrap
21129 msgid ""
21130 " void guestfs_free_application (struct guestfs_free_application *);\n"
21131 " void guestfs_free_application_list (struct guestfs_free_application_list *);\n"
21132 "\n"
21133 msgstr ""
21134
21135 # type: textblock
21136 #. type: textblock
21137 #: ../fish/guestfish.pod:5
21138 msgid "guestfish - the libguestfs Filesystem Interactive SHell"
21139 msgstr ""
21140
21141 # type: verbatim
21142 #. type: verbatim
21143 #: ../fish/guestfish.pod:9
21144 #, no-wrap
21145 msgid ""
21146 " guestfish [--options] [commands]\n"
21147 "\n"
21148 msgstr ""
21149
21150 # type: verbatim
21151 #. type: verbatim
21152 #: ../fish/guestfish.pod:11
21153 #, no-wrap
21154 msgid ""
21155 " guestfish\n"
21156 "\n"
21157 msgstr ""
21158
21159 # type: verbatim
21160 #. type: verbatim
21161 #: ../fish/guestfish.pod:13
21162 #, no-wrap
21163 msgid ""
21164 " guestfish [--ro|--rw] -a disk.img\n"
21165 "\n"
21166 msgstr ""
21167
21168 # type: verbatim
21169 #. type: verbatim
21170 #: ../fish/guestfish.pod:15
21171 #, no-wrap
21172 msgid ""
21173 " guestfish [--ro|--rw] -a disk.img -m dev[:mountpoint]\n"
21174 "\n"
21175 msgstr ""
21176
21177 # type: verbatim
21178 #. type: verbatim
21179 #: ../fish/guestfish.pod:17
21180 #, no-wrap
21181 msgid ""
21182 " guestfish -d libvirt-domain\n"
21183 "\n"
21184 msgstr ""
21185
21186 # type: verbatim
21187 #. type: verbatim
21188 #: ../fish/guestfish.pod:19
21189 #, no-wrap
21190 msgid ""
21191 " guestfish [--ro|--rw] -a disk.img -i\n"
21192 "\n"
21193 msgstr ""
21194
21195 # type: verbatim
21196 #. type: verbatim
21197 #: ../fish/guestfish.pod:21
21198 #, no-wrap
21199 msgid ""
21200 " guestfish -d libvirt-domain -i\n"
21201 "\n"
21202 msgstr ""
21203
21204 # type: =head1
21205 #. type: =head1
21206 #: ../fish/guestfish.pod:23 ../fuse/guestmount.pod:15 ../tools/virt-edit.pl:44
21207 #: ../tools/virt-win-reg.pl:51 ../tools/virt-tar.pl:64
21208 msgid "WARNING"
21209 msgstr ""
21210
21211 # type: textblock
21212 #. type: textblock
21213 #: ../fish/guestfish.pod:25
21214 msgid ""
21215 "Using guestfish in read/write mode on live virtual machines can be "
21216 "dangerous, potentially causing disk corruption.  Use the I<--ro> (read-only) "
21217 "option to use guestfish safely if the disk image or virtual machine might be "
21218 "live."
21219 msgstr ""
21220
21221 # type: textblock
21222 #. type: textblock
21223 #: ../fish/guestfish.pod:32
21224 msgid ""
21225 "Guestfish is a shell and command-line tool for examining and modifying "
21226 "virtual machine filesystems.  It uses libguestfs and exposes all of the "
21227 "functionality of the guestfs API, see L<guestfs(3)>."
21228 msgstr ""
21229
21230 # type: textblock
21231 #. type: textblock
21232 #: ../fish/guestfish.pod:36
21233 msgid ""
21234 "Guestfish gives you structured access to the libguestfs API, from shell "
21235 "scripts or the command line or interactively.  If you want to rescue a "
21236 "broken virtual machine image, you should look at the L<virt-rescue(1)> "
21237 "command."
21238 msgstr ""
21239
21240 # type: =head1
21241 #. type: =head1
21242 #: ../fish/guestfish.pod:41 ../fish/guestfish.pod:937
21243 #: ../fuse/guestmount.pod:39 ../tools/virt-edit.pl:58
21244 #: ../tools/virt-resize.pl:64 ../tools/virt-tar.pl:50
21245 msgid "EXAMPLES"
21246 msgstr ""
21247
21248 # type: =head2
21249 #. type: =head2
21250 #: ../fish/guestfish.pod:43
21251 msgid "As an interactive shell"
21252 msgstr ""
21253
21254 # type: verbatim
21255 #. type: verbatim
21256 #: ../fish/guestfish.pod:45
21257 #, no-wrap
21258 msgid ""
21259 " $ guestfish\n"
21260 " \n"
21261 msgstr ""
21262
21263 # type: verbatim
21264 #. type: verbatim
21265 #: ../fish/guestfish.pod:47
21266 #, no-wrap
21267 msgid ""
21268 " Welcome to guestfish, the libguestfs filesystem interactive shell for\n"
21269 " editing virtual machine filesystems.\n"
21270 " \n"
21271 msgstr ""
21272
21273 # type: verbatim
21274 #. type: verbatim
21275 #: ../fish/guestfish.pod:50
21276 #, no-wrap
21277 msgid ""
21278 " Type: 'help' for a list of commands\n"
21279 "       'man' to read the manual\n"
21280 "       'quit' to quit the shell\n"
21281 " \n"
21282 msgstr ""
21283
21284 # type: verbatim
21285 #. type: verbatim
21286 #: ../fish/guestfish.pod:54
21287 #, no-wrap
21288 msgid ""
21289 " ><fs> add-ro disk.img\n"
21290 " ><fs> run\n"
21291 " ><fs> list-filesystems\n"
21292 " /dev/sda1: ext4\n"
21293 " /dev/vg_guest/lv_root: ext4\n"
21294 " /dev/vg_guest/lv_swap: swap\n"
21295 " ><fs> mount /dev/vg_guest/lv_root /\n"
21296 " ><fs> cat /etc/fstab\n"
21297 " # /etc/fstab\n"
21298 " # Created by anaconda\n"
21299 " [...]\n"
21300 " ><fs> exit\n"
21301 "\n"
21302 msgstr ""
21303
21304 # type: =head2
21305 #. type: =head2
21306 #: ../fish/guestfish.pod:67
21307 msgid "From shell scripts"
21308 msgstr ""
21309
21310 # type: textblock
21311 #. type: textblock
21312 #: ../fish/guestfish.pod:69
21313 msgid "Create a new C</etc/motd> file in a guest or disk image:"
21314 msgstr ""
21315
21316 # type: verbatim
21317 #. type: verbatim
21318 #: ../fish/guestfish.pod:71
21319 #, no-wrap
21320 msgid ""
21321 " guestfish <<_EOF_\n"
21322 " add disk.img\n"
21323 " run\n"
21324 " mount /dev/vg_guest/lv_root /\n"
21325 " write /etc/motd \"Welcome, new users\"\n"
21326 " _EOF_\n"
21327 "\n"
21328 msgstr ""
21329
21330 # type: textblock
21331 #. type: textblock
21332 #: ../fish/guestfish.pod:78
21333 msgid "List the LVM logical volumes in a disk image:"
21334 msgstr ""
21335
21336 # type: verbatim
21337 #. type: verbatim
21338 #: ../fish/guestfish.pod:80
21339 #, no-wrap
21340 msgid ""
21341 " guestfish -a disk.img --ro <<_EOF_\n"
21342 " run\n"
21343 " lvs\n"
21344 " _EOF_\n"
21345 "\n"
21346 msgstr ""
21347
21348 # type: textblock
21349 #. type: textblock
21350 #: ../fish/guestfish.pod:85
21351 msgid "List all the filesystems in a disk image:"
21352 msgstr ""
21353
21354 # type: verbatim
21355 #. type: verbatim
21356 #: ../fish/guestfish.pod:87
21357 #, no-wrap
21358 msgid ""
21359 " guestfish -a disk.img --ro <<_EOF_\n"
21360 " run\n"
21361 " list-filesystems\n"
21362 " _EOF_\n"
21363 "\n"
21364 msgstr ""
21365
21366 # type: =head2
21367 #. type: =head2
21368 #: ../fish/guestfish.pod:92
21369 msgid "On one command line"
21370 msgstr ""
21371
21372 # type: textblock
21373 #. type: textblock
21374 #: ../fish/guestfish.pod:94
21375 msgid "Update C</etc/resolv.conf> in a guest:"
21376 msgstr ""
21377
21378 # type: verbatim
21379 #. type: verbatim
21380 #: ../fish/guestfish.pod:96
21381 #, no-wrap
21382 msgid ""
21383 " guestfish \\\n"
21384 "   add disk.img : run : mount /dev/vg_guest/lv_root / : \\\n"
21385 "   write /etc/resolv.conf \"nameserver 1.2.3.4\"\n"
21386 "\n"
21387 msgstr ""
21388
21389 # type: textblock
21390 #. type: textblock
21391 #: ../fish/guestfish.pod:100
21392 msgid "Edit C</boot/grub/grub.conf> interactively:"
21393 msgstr ""
21394
21395 # type: verbatim
21396 #. type: verbatim
21397 #: ../fish/guestfish.pod:102
21398 #, no-wrap
21399 msgid ""
21400 " guestfish --rw --add disk.img \\\n"
21401 "   --mount /dev/vg_guest/lv_root \\\n"
21402 "   --mount /dev/sda1:/boot \\\n"
21403 "   edit /boot/grub/grub.conf\n"
21404 "\n"
21405 msgstr ""
21406
21407 # type: =head2
21408 #. type: =head2
21409 #: ../fish/guestfish.pod:107
21410 msgid "Mount disks automatically"
21411 msgstr ""
21412
21413 # type: textblock
21414 #. type: textblock
21415 #: ../fish/guestfish.pod:109
21416 msgid ""
21417 "Use the I<-i> option to automatically mount the disks from a virtual machine:"
21418 msgstr ""
21419
21420 # type: verbatim
21421 #. type: verbatim
21422 #: ../fish/guestfish.pod:112
21423 #, no-wrap
21424 msgid ""
21425 " guestfish --ro -a disk.img -i cat /etc/group\n"
21426 "\n"
21427 msgstr ""
21428
21429 # type: verbatim
21430 #. type: verbatim
21431 #: ../fish/guestfish.pod:114
21432 #, no-wrap
21433 msgid ""
21434 " guestfish --ro -d libvirt-domain -i cat /etc/group\n"
21435 "\n"
21436 msgstr ""
21437
21438 # type: textblock
21439 #. type: textblock
21440 #: ../fish/guestfish.pod:116
21441 msgid "Another way to edit C</boot/grub/grub.conf> interactively is:"
21442 msgstr ""
21443
21444 # type: verbatim
21445 #. type: verbatim
21446 #: ../fish/guestfish.pod:118
21447 #, no-wrap
21448 msgid ""
21449 " guestfish --rw -a disk.img -i edit /boot/grub/grub.conf\n"
21450 "\n"
21451 msgstr ""
21452
21453 # type: =head2
21454 #. type: =head2
21455 #: ../fish/guestfish.pod:120
21456 msgid "As a script interpreter"
21457 msgstr ""
21458
21459 # type: textblock
21460 #. type: textblock
21461 #: ../fish/guestfish.pod:122
21462 msgid "Create a 100MB disk containing an ext2-formatted partition:"
21463 msgstr ""
21464
21465 # type: verbatim
21466 #. type: verbatim
21467 #: ../fish/guestfish.pod:124
21468 #, no-wrap
21469 msgid ""
21470 " #!/usr/bin/guestfish -f\n"
21471 " sparse test1.img 100M\n"
21472 " run\n"
21473 " part-disk /dev/sda mbr\n"
21474 " mkfs ext2 /dev/sda1\n"
21475 "\n"
21476 msgstr ""
21477
21478 # type: =head2
21479 #. type: =head2
21480 #: ../fish/guestfish.pod:130
21481 msgid "Start with a prepared disk"
21482 msgstr ""
21483
21484 # type: textblock
21485 #. type: textblock
21486 #: ../fish/guestfish.pod:132
21487 msgid ""
21488 "An alternate way to create a 100MB disk called C<test1.img> containing a "
21489 "single ext2-formatted partition:"
21490 msgstr ""
21491
21492 # type: verbatim
21493 #. type: verbatim
21494 #: ../fish/guestfish.pod:135
21495 #, no-wrap
21496 msgid ""
21497 " guestfish -N fs\n"
21498 "\n"
21499 msgstr ""
21500
21501 # type: textblock
21502 #. type: textblock
21503 #: ../fish/guestfish.pod:137
21504 msgid "To list what is available do:"
21505 msgstr ""
21506
21507 # type: verbatim
21508 #. type: verbatim
21509 #: ../fish/guestfish.pod:139 ../fish/guestfish.pod:928
21510 #, no-wrap
21511 msgid ""
21512 " guestfish -N help | less\n"
21513 "\n"
21514 msgstr ""
21515
21516 # type: =head2
21517 #. type: =head2
21518 #: ../fish/guestfish.pod:141
21519 msgid "Remote control"
21520 msgstr ""
21521
21522 # type: verbatim
21523 #. type: verbatim
21524 #: ../fish/guestfish.pod:143
21525 #, no-wrap
21526 msgid ""
21527 " eval \"`guestfish --listen`\"\n"
21528 " guestfish --remote add-ro disk.img\n"
21529 " guestfish --remote run\n"
21530 " guestfish --remote lvs\n"
21531 "\n"
21532 msgstr ""
21533
21534 # type: =head1
21535 #. type: =head1
21536 #: ../fish/guestfish.pod:148 ../test-tool/libguestfs-test-tool.pod:37
21537 #: ../fuse/guestmount.pod:73 ../tools/virt-edit.pl:72
21538 #: ../tools/virt-win-reg.pl:96 ../tools/virt-resize.pl:254
21539 #: ../tools/virt-list-filesystems.pl:53 ../tools/virt-tar.pl:103
21540 #: ../tools/virt-make-fs.pl:153 ../tools/virt-list-partitions.pl:54
21541 msgid "OPTIONS"
21542 msgstr ""
21543
21544 # type: =item
21545 #. type: =item
21546 #: ../fish/guestfish.pod:152 ../fuse/guestmount.pod:131
21547 #: ../tools/virt-edit.pl:80 ../tools/virt-win-reg.pl:104
21548 #: ../tools/virt-resize.pl:262 ../tools/virt-list-filesystems.pl:61
21549 #: ../tools/virt-tar.pl:111 ../tools/virt-make-fs.pl:161
21550 #: ../tools/virt-list-partitions.pl:62
21551 msgid "B<--help>"
21552 msgstr ""
21553
21554 # type: textblock
21555 #. type: textblock
21556 #: ../fish/guestfish.pod:154
21557 msgid "Displays general help on options."
21558 msgstr ""
21559
21560 # type: =item
21561 #. type: =item
21562 #: ../fish/guestfish.pod:156
21563 msgid "B<-h>"
21564 msgstr ""
21565
21566 # type: =item
21567 #. type: =item
21568 #: ../fish/guestfish.pod:158
21569 msgid "B<--cmd-help>"
21570 msgstr ""
21571
21572 # type: textblock
21573 #. type: textblock
21574 #: ../fish/guestfish.pod:160
21575 msgid "Lists all available guestfish commands."
21576 msgstr ""
21577
21578 # type: =item
21579 #. type: =item
21580 #: ../fish/guestfish.pod:162
21581 msgid "B<-h cmd>"
21582 msgstr ""
21583
21584 # type: =item
21585 #. type: =item
21586 #: ../fish/guestfish.pod:164
21587 msgid "B<--cmd-help cmd>"
21588 msgstr ""
21589
21590 # type: textblock
21591 #. type: textblock
21592 #: ../fish/guestfish.pod:166
21593 msgid "Displays detailed help on a single command C<cmd>."
21594 msgstr ""
21595
21596 # type: =item
21597 #. type: =item
21598 #: ../fish/guestfish.pod:168
21599 msgid "B<-a image>"
21600 msgstr ""
21601
21602 # type: =item
21603 #. type: =item
21604 #: ../fish/guestfish.pod:170
21605 msgid "B<--add image>"
21606 msgstr ""
21607
21608 # type: textblock
21609 #. type: textblock
21610 #: ../fish/guestfish.pod:172
21611 msgid "Add a block device or virtual machine image to the shell."
21612 msgstr ""
21613
21614 # type: textblock
21615 #. type: textblock
21616 #: ../fish/guestfish.pod:174 ../fuse/guestmount.pod:81
21617 msgid ""
21618 "The format of the disk image is auto-detected.  To override this and force a "
21619 "particular format use the I<--format=..> option."
21620 msgstr ""
21621
21622 # type: textblock
21623 #. type: textblock
21624 #: ../fish/guestfish.pod:177
21625 msgid ""
21626 "Using this flag is mostly equivalent to using the C<add> command, with "
21627 "C<readonly:true> if the I<--ro> flag was given, and with C<format:...> if "
21628 "the I<--format:...> flag was given."
21629 msgstr ""
21630
21631 # type: =item
21632 #. type: =item
21633 #: ../fish/guestfish.pod:181
21634 msgid "B<-c URI>"
21635 msgstr ""
21636
21637 # type: =item
21638 #. type: =item
21639 #: ../fish/guestfish.pod:183
21640 msgid "B<--connect URI>"
21641 msgstr ""
21642
21643 # type: textblock
21644 #. type: textblock
21645 #: ../fish/guestfish.pod:185 ../fuse/guestmount.pod:86
21646 msgid ""
21647 "When used in conjunction with the I<-d> option, this specifies the libvirt "
21648 "URI to use.  The default is to use the default libvirt connection."
21649 msgstr ""
21650
21651 # type: =item
21652 #. type: =item
21653 #: ../fish/guestfish.pod:189
21654 msgid "B<--csh>"
21655 msgstr ""
21656
21657 # type: textblock
21658 #. type: textblock
21659 #: ../fish/guestfish.pod:191
21660 msgid ""
21661 "If using the I<--listen> option and a csh-like shell, use this option.  See "
21662 "section L</REMOTE CONTROL AND CSH> below."
21663 msgstr ""
21664
21665 # type: =item
21666 #. type: =item
21667 #: ../fish/guestfish.pod:194
21668 msgid "B<-d libvirt-domain>"
21669 msgstr ""
21670
21671 # type: =item
21672 #. type: =item
21673 #: ../fish/guestfish.pod:196
21674 msgid "B<--domain libvirt-domain>"
21675 msgstr ""
21676
21677 # type: textblock
21678 #. type: textblock
21679 #: ../fish/guestfish.pod:198 ../fuse/guestmount.pod:92
21680 msgid ""
21681 "Add disks from the named libvirt domain.  If the I<--ro> option is also "
21682 "used, then any libvirt domain can be used.  However in write mode, only "
21683 "libvirt domains which are shut down can be named here."
21684 msgstr ""
21685
21686 # type: textblock
21687 #. type: textblock
21688 #: ../fish/guestfish.pod:202
21689 msgid ""
21690 "Using this flag is mostly equivalent to using the C<add-domain> command, "
21691 "with C<readonly:true> if the I<--ro> flag was given, and with C<format:...> "
21692 "if the I<--format:...> flag was given."
21693 msgstr ""
21694
21695 # type: =item
21696 #. type: =item
21697 #: ../fish/guestfish.pod:206
21698 msgid "B<-D>"
21699 msgstr ""
21700
21701 # type: =item
21702 #. type: =item
21703 #: ../fish/guestfish.pod:208
21704 msgid "B<--no-dest-paths>"
21705 msgstr ""
21706
21707 # type: textblock
21708 #. type: textblock
21709 #: ../fish/guestfish.pod:210
21710 msgid ""
21711 "Don't tab-complete paths on the guest filesystem.  It is useful to be able "
21712 "to hit the tab key to complete paths on the guest filesystem, but this "
21713 "causes extra \"hidden\" guestfs calls to be made, so this option is here to "
21714 "allow this feature to be disabled."
21715 msgstr ""
21716
21717 # type: =item
21718 #. type: =item
21719 #: ../fish/guestfish.pod:215 ../fuse/guestmount.pod:108
21720 msgid "B<--echo-keys>"
21721 msgstr ""
21722
21723 # type: textblock
21724 #. type: textblock
21725 #: ../fish/guestfish.pod:217 ../fuse/guestmount.pod:110
21726 msgid ""
21727 "When prompting for keys and passphrases, guestfish normally turns echoing "
21728 "off so you cannot see what you are typing.  If you are not worried about "
21729 "Tempest attacks and there is no one else in the room you can specify this "
21730 "flag to see what you are typing."
21731 msgstr ""
21732
21733 # type: =item
21734 #. type: =item
21735 #: ../fish/guestfish.pod:222
21736 msgid "B<-f file>"
21737 msgstr ""
21738
21739 # type: =item
21740 #. type: =item
21741 #: ../fish/guestfish.pod:224
21742 msgid "B<--file file>"
21743 msgstr ""
21744
21745 # type: textblock
21746 #. type: textblock
21747 #: ../fish/guestfish.pod:226
21748 msgid "Read commands from C<file>.  To write pure guestfish scripts, use:"
21749 msgstr ""
21750
21751 # type: verbatim
21752 #. type: verbatim
21753 #: ../fish/guestfish.pod:229
21754 #, no-wrap
21755 msgid ""
21756 " #!/usr/bin/guestfish -f\n"
21757 "\n"
21758 msgstr ""
21759
21760 # type: =item
21761 #. type: =item
21762 #: ../fish/guestfish.pod:231
21763 msgid "B<--format=raw|qcow2|..>"
21764 msgstr ""
21765
21766 # type: =item
21767 #. type: =item
21768 #: ../fish/guestfish.pod:233
21769 msgid "B<--format>"
21770 msgstr ""
21771
21772 # type: textblock
21773 #. type: textblock
21774 #: ../fish/guestfish.pod:235 ../fuse/guestmount.pod:117
21775 msgid ""
21776 "The default for the I<-a> option is to auto-detect the format of the disk "
21777 "image.  Using this forces the disk format for I<-a> options which follow on "
21778 "the command line.  Using I<--format> with no argument switches back to auto-"
21779 "detection for subsequent I<-a> options."
21780 msgstr ""
21781
21782 # type: verbatim
21783 #. type: verbatim
21784 #: ../fish/guestfish.pod:242
21785 #, no-wrap
21786 msgid ""
21787 " guestfish --format=raw -a disk.img\n"
21788 "\n"
21789 msgstr ""
21790
21791 # type: textblock
21792 #. type: textblock
21793 #: ../fish/guestfish.pod:244
21794 msgid "forces raw format (no auto-detection) for C<disk.img>."
21795 msgstr ""
21796
21797 # type: verbatim
21798 #. type: verbatim
21799 #: ../fish/guestfish.pod:246
21800 #, no-wrap
21801 msgid ""
21802 " guestfish --format=raw -a disk.img --format -a another.img\n"
21803 "\n"
21804 msgstr ""
21805
21806 # type: textblock
21807 #. type: textblock
21808 #: ../fish/guestfish.pod:248
21809 msgid ""
21810 "forces raw format (no auto-detection) for C<disk.img> and reverts to auto-"
21811 "detection for C<another.img>."
21812 msgstr ""
21813
21814 # type: textblock
21815 #. type: textblock
21816 #: ../fish/guestfish.pod:251
21817 msgid ""
21818 "If you have untrusted raw-format guest disk images, you should use this "
21819 "option to specify the disk format.  This avoids a possible security problem "
21820 "with malicious guests (CVE-2010-3851).  See also L</add-drive-opts>."
21821 msgstr ""
21822
21823 # type: =item
21824 #. type: =item
21825 #: ../fish/guestfish.pod:256
21826 msgid "B<-i>"
21827 msgstr ""
21828
21829 # type: =item
21830 #. type: =item
21831 #: ../fish/guestfish.pod:258
21832 msgid "B<--inspector>"
21833 msgstr ""
21834
21835 # type: textblock
21836 #. type: textblock
21837 #: ../fish/guestfish.pod:260 ../fuse/guestmount.pod:137
21838 msgid ""
21839 "Using L<virt-inspector(1)> code, inspect the disks looking for an operating "
21840 "system and mount filesystems as they would be mounted on the real virtual "
21841 "machine."
21842 msgstr ""
21843
21844 # type: textblock
21845 #. type: textblock
21846 #: ../fish/guestfish.pod:264
21847 msgid "Typical usage is either:"
21848 msgstr ""
21849
21850 # type: verbatim
21851 #. type: verbatim
21852 #: ../fish/guestfish.pod:266
21853 #, no-wrap
21854 msgid ""
21855 " guestfish -d myguest -i\n"
21856 "\n"
21857 msgstr ""
21858
21859 # type: textblock
21860 #. type: textblock
21861 #: ../fish/guestfish.pod:268
21862 msgid "(for an inactive libvirt domain called I<myguest>), or:"
21863 msgstr ""
21864
21865 # type: verbatim
21866 #. type: verbatim
21867 #: ../fish/guestfish.pod:270
21868 #, no-wrap
21869 msgid ""
21870 " guestfish --ro -d myguest -i\n"
21871 "\n"
21872 msgstr ""
21873
21874 # type: textblock
21875 #. type: textblock
21876 #: ../fish/guestfish.pod:272
21877 msgid "(for active domains, readonly), or specify the block device directly:"
21878 msgstr ""
21879
21880 # type: verbatim
21881 #. type: verbatim
21882 #: ../fish/guestfish.pod:274
21883 #, no-wrap
21884 msgid ""
21885 " guestfish --rw -a /dev/Guests/MyGuest -i\n"
21886 "\n"
21887 msgstr ""
21888
21889 # type: textblock
21890 #. type: textblock
21891 #: ../fish/guestfish.pod:276
21892 msgid ""
21893 "Note that the command line syntax changed slightly over older versions of "
21894 "guestfish.  You can still use the old syntax:"
21895 msgstr ""
21896
21897 # type: verbatim
21898 #. type: verbatim
21899 #: ../fish/guestfish.pod:279
21900 #, no-wrap
21901 msgid ""
21902 " guestfish [--ro] -i disk.img\n"
21903 "\n"
21904 msgstr ""
21905
21906 # type: verbatim
21907 #. type: verbatim
21908 #: ../fish/guestfish.pod:281
21909 #, no-wrap
21910 msgid ""
21911 " guestfish [--ro] -i libvirt-domain\n"
21912 "\n"
21913 msgstr ""
21914
21915 # type: textblock
21916 #. type: textblock
21917 #: ../fish/guestfish.pod:283
21918 msgid ""
21919 "Using this flag is mostly equivalent to using the C<inspect-os> command and "
21920 "then using other commands to mount the filesystems that were found."
21921 msgstr ""
21922
21923 # type: =item
21924 #. type: =item
21925 #: ../fish/guestfish.pod:287 ../fuse/guestmount.pod:141
21926 msgid "B<--keys-from-stdin>"
21927 msgstr ""
21928
21929 # type: textblock
21930 #. type: textblock
21931 #: ../fish/guestfish.pod:289 ../fuse/guestmount.pod:143
21932 msgid ""
21933 "Read key or passphrase parameters from stdin.  The default is to try to read "
21934 "passphrases from the user by opening C</dev/tty>."
21935 msgstr ""
21936
21937 # type: =item
21938 #. type: =item
21939 #: ../fish/guestfish.pod:292
21940 msgid "B<--listen>"
21941 msgstr ""
21942
21943 # type: textblock
21944 #. type: textblock
21945 #: ../fish/guestfish.pod:294
21946 msgid ""
21947 "Fork into the background and listen for remote commands.  See section L</"
21948 "REMOTE CONTROL GUESTFISH OVER A SOCKET> below."
21949 msgstr ""
21950
21951 #. type: =item
21952 #: ../fish/guestfish.pod:297 ../fuse/guestmount.pod:146
21953 msgid "B<--live>"
21954 msgstr ""
21955
21956 #. type: textblock
21957 #: ../fish/guestfish.pod:299 ../fuse/guestmount.pod:148
21958 msgid ""
21959 "Connect to a live virtual machine.  (Experimental, see L<guestfs(3)/"
21960 "ATTACHING TO RUNNING DAEMONS>)."
21961 msgstr ""
21962
21963 #. type: =item
21964 #: ../fish/guestfish.pod:302 ../fuse/guestmount.pod:151
21965 msgid "B<-m dev[:mountpoint[:options]]>"
21966 msgstr ""
21967
21968 #. type: =item
21969 #: ../fish/guestfish.pod:304 ../fuse/guestmount.pod:153
21970 msgid "B<--mount dev[:mountpoint[:options]]>"
21971 msgstr ""
21972
21973 # type: textblock
21974 #. type: textblock
21975 #: ../fish/guestfish.pod:306
21976 msgid "Mount the named partition or logical volume on the given mountpoint."
21977 msgstr ""
21978
21979 # type: textblock
21980 #. type: textblock
21981 #: ../fish/guestfish.pod:308
21982 msgid "If the mountpoint is omitted, it defaults to C</>."
21983 msgstr ""
21984
21985 # type: textblock
21986 #. type: textblock
21987 #: ../fish/guestfish.pod:310
21988 msgid "You have to mount something on C</> before most commands will work."
21989 msgstr ""
21990
21991 # type: textblock
21992 #. type: textblock
21993 #: ../fish/guestfish.pod:312
21994 msgid ""
21995 "If any I<-m> or I<--mount> options are given, the guest is automatically "
21996 "launched."
21997 msgstr ""
21998
21999 # type: textblock
22000 #. type: textblock
22001 #: ../fish/guestfish.pod:315
22002 msgid ""
22003 "If you don't know what filesystems a disk image contains, you can either run "
22004 "guestfish without this option, then list the partitions, filesystems and LVs "
22005 "available (see L</list-partitions>, L</list-filesystems> and L</lvs> "
22006 "commands), or you can use the L<virt-filesystems(1)> program."
22007 msgstr ""
22008
22009 #. type: textblock
22010 #: ../fish/guestfish.pod:321 ../fuse/guestmount.pod:161
22011 msgid ""
22012 "The third (and rarely used) part of the mount parameter is the list of mount "
22013 "options used to mount the underlying filesystem.  If this is not given, then "
22014 "the mount options are either the empty string or C<ro> (the latter if the "
22015 "I<--ro> flag is used).  By specifying the mount options, you override this "
22016 "default choice.  Probably the only time you would use this is to enable ACLs "
22017 "and/or extended attributes if the filesystem can support them:"
22018 msgstr ""
22019
22020 #. type: verbatim
22021 #: ../fish/guestfish.pod:329 ../fuse/guestmount.pod:169
22022 #, no-wrap
22023 msgid ""
22024 " -m /dev/sda1:/:acl,user_xattr\n"
22025 "\n"
22026 msgstr ""
22027
22028 #. type: textblock
22029 #: ../fish/guestfish.pod:331
22030 msgid "Using this flag is equivalent to using the C<mount-options> command."
22031 msgstr ""
22032
22033 # type: =item
22034 #. type: =item
22035 #: ../fish/guestfish.pod:333
22036 msgid "B<-n>"
22037 msgstr ""
22038
22039 # type: =item
22040 #. type: =item
22041 #: ../fish/guestfish.pod:335
22042 msgid "B<--no-sync>"
22043 msgstr ""
22044
22045 # type: textblock
22046 #. type: textblock
22047 #: ../fish/guestfish.pod:337
22048 msgid ""
22049 "Disable autosync.  This is enabled by default.  See the discussion of "
22050 "autosync in the L<guestfs(3)> manpage."
22051 msgstr ""
22052
22053 # type: =item
22054 #. type: =item
22055 #: ../fish/guestfish.pod:340
22056 msgid "B<-N type>"
22057 msgstr ""
22058
22059 # type: =item
22060 #. type: =item
22061 #: ../fish/guestfish.pod:342
22062 msgid "B<--new type>"
22063 msgstr ""
22064
22065 # type: =item
22066 #. type: =item
22067 #: ../fish/guestfish.pod:344
22068 msgid "B<-N help>"
22069 msgstr ""
22070
22071 # type: textblock
22072 #. type: textblock
22073 #: ../fish/guestfish.pod:346
22074 msgid ""
22075 "Prepare a fresh disk image formatted as \"type\".  This is an alternative to "
22076 "the I<-a> option: whereas I<-a> adds an existing disk, I<-N> creates a "
22077 "preformatted disk with a filesystem and adds it.  See L</PREPARED DISK "
22078 "IMAGES> below."
22079 msgstr ""
22080
22081 # type: =item
22082 #. type: =item
22083 #: ../fish/guestfish.pod:351
22084 msgid "B<--progress-bars>"
22085 msgstr ""
22086
22087 # type: textblock
22088 #. type: textblock
22089 #: ../fish/guestfish.pod:353
22090 msgid "Enable progress bars, even when guestfish is used non-interactively."
22091 msgstr ""
22092
22093 # type: textblock
22094 #. type: textblock
22095 #: ../fish/guestfish.pod:355
22096 msgid ""
22097 "Progress bars are enabled by default when guestfish is used as an "
22098 "interactive shell."
22099 msgstr ""
22100
22101 # type: =item
22102 #. type: =item
22103 #: ../fish/guestfish.pod:358
22104 msgid "B<--no-progress-bars>"
22105 msgstr ""
22106
22107 # type: textblock
22108 #. type: textblock
22109 #: ../fish/guestfish.pod:360
22110 msgid "Disable progress bars."
22111 msgstr ""
22112
22113 # type: =item
22114 #. type: =item
22115 #: ../fish/guestfish.pod:362
22116 msgid "B<--remote[=pid]>"
22117 msgstr ""
22118
22119 # type: textblock
22120 #. type: textblock
22121 #: ../fish/guestfish.pod:364
22122 msgid ""
22123 "Send remote commands to C<$GUESTFISH_PID> or C<pid>.  See section L</REMOTE "
22124 "CONTROL GUESTFISH OVER A SOCKET> below."
22125 msgstr ""
22126
22127 # type: =item
22128 #. type: =item
22129 #: ../fish/guestfish.pod:367
22130 msgid "B<-r>"
22131 msgstr ""
22132
22133 # type: =item
22134 #. type: =item
22135 #: ../fish/guestfish.pod:369
22136 msgid "B<--ro>"
22137 msgstr ""
22138
22139 # type: textblock
22140 #. type: textblock
22141 #: ../fish/guestfish.pod:371
22142 msgid ""
22143 "This changes the I<-a>, I<-d> and I<-m> options so that disks are added and "
22144 "mounts are done read-only."
22145 msgstr ""
22146
22147 # type: textblock
22148 #. type: textblock
22149 #: ../fish/guestfish.pod:374
22150 msgid ""
22151 "The option must always be used if the disk image or virtual machine might be "
22152 "running, and is generally recommended in cases where you don't need write "
22153 "access to the disk."
22154 msgstr ""
22155
22156 # type: textblock
22157 #. type: textblock
22158 #: ../fish/guestfish.pod:378
22159 msgid ""
22160 "Note that prepared disk images created with I<-N> are not affected by this "
22161 "option.  Also commands like C<add> are not affected - you have to specify "
22162 "the C<readonly:true> option explicitly if you need it."
22163 msgstr ""
22164
22165 # type: textblock
22166 #. type: textblock
22167 #: ../fish/guestfish.pod:382
22168 msgid "See also L</OPENING DISKS FOR READ AND WRITE> below."
22169 msgstr ""
22170
22171 # type: =item
22172 #. type: =item
22173 #: ../fish/guestfish.pod:384 ../fuse/guestmount.pod:225
22174 msgid "B<--selinux>"
22175 msgstr ""
22176
22177 # type: textblock
22178 #. type: textblock
22179 #: ../fish/guestfish.pod:386
22180 msgid "Enable SELinux support for the guest.  See L<guestfs(3)/SELINUX>."
22181 msgstr ""
22182
22183 # type: =item
22184 #. type: =item
22185 #: ../fish/guestfish.pod:388
22186 msgid "B<-v>"
22187 msgstr ""
22188
22189 # type: =item
22190 #. type: =item
22191 #: ../fish/guestfish.pod:390
22192 msgid "B<--verbose>"
22193 msgstr ""
22194
22195 # type: textblock
22196 #. type: textblock
22197 #: ../fish/guestfish.pod:392
22198 msgid ""
22199 "Enable very verbose messages.  This is particularly useful if you find a bug."
22200 msgstr ""
22201
22202 # type: =item
22203 #. type: =item
22204 #: ../fish/guestfish.pod:395
22205 msgid "B<-V>"
22206 msgstr ""
22207
22208 # type: =item
22209 #. type: =item
22210 #: ../fish/guestfish.pod:397 ../tools/virt-edit.pl:88
22211 #: ../tools/virt-win-reg.pl:112 ../tools/virt-resize.pl:270
22212 #: ../tools/virt-list-filesystems.pl:69 ../tools/virt-tar.pl:119
22213 #: ../tools/virt-make-fs.pl:169 ../tools/virt-list-partitions.pl:70
22214 msgid "B<--version>"
22215 msgstr ""
22216
22217 # type: textblock
22218 #. type: textblock
22219 #: ../fish/guestfish.pod:399
22220 msgid "Display the guestfish / libguestfs version number and exit."
22221 msgstr ""
22222
22223 # type: =item
22224 #. type: =item
22225 #: ../fish/guestfish.pod:401
22226 msgid "B<-w>"
22227 msgstr ""
22228
22229 # type: =item
22230 #. type: =item
22231 #: ../fish/guestfish.pod:403
22232 msgid "B<--rw>"
22233 msgstr ""
22234
22235 # type: textblock
22236 #. type: textblock
22237 #: ../fish/guestfish.pod:405
22238 msgid ""
22239 "This option does nothing at the moment.  See L</OPENING DISKS FOR READ AND "
22240 "WRITE> below."
22241 msgstr ""
22242
22243 # type: =item
22244 #. type: =item
22245 #: ../fish/guestfish.pod:408
22246 msgid "B<-x>"
22247 msgstr ""
22248
22249 # type: textblock
22250 #. type: textblock
22251 #: ../fish/guestfish.pod:410
22252 msgid "Echo each command before executing it."
22253 msgstr ""
22254
22255 # type: =head1
22256 #. type: =head1
22257 #: ../fish/guestfish.pod:414
22258 msgid "COMMANDS ON COMMAND LINE"
22259 msgstr ""
22260
22261 # type: textblock
22262 #. type: textblock
22263 #: ../fish/guestfish.pod:416
22264 msgid ""
22265 "Any additional (non-option) arguments are treated as commands to execute."
22266 msgstr ""
22267
22268 # type: textblock
22269 #. type: textblock
22270 #: ../fish/guestfish.pod:419
22271 msgid ""
22272 "Commands to execute should be separated by a colon (C<:>), where the colon "
22273 "is a separate parameter.  Thus:"
22274 msgstr ""
22275
22276 # type: verbatim
22277 #. type: verbatim
22278 #: ../fish/guestfish.pod:422
22279 #, no-wrap
22280 msgid ""
22281 " guestfish cmd [args...] : cmd [args...] : cmd [args...] ...\n"
22282 "\n"
22283 msgstr ""
22284
22285 # type: textblock
22286 #. type: textblock
22287 #: ../fish/guestfish.pod:424
22288 msgid ""
22289 "If there are no additional arguments, then we enter a shell, either an "
22290 "interactive shell with a prompt (if the input is a terminal) or a non-"
22291 "interactive shell."
22292 msgstr ""
22293
22294 # type: textblock
22295 #. type: textblock
22296 #: ../fish/guestfish.pod:428
22297 msgid ""
22298 "In either command line mode or non-interactive shell, the first command that "
22299 "gives an error causes the whole shell to exit.  In interactive mode (with a "
22300 "prompt) if a command fails, you can continue to enter commands."
22301 msgstr ""
22302
22303 # type: =head1
22304 #. type: =head1
22305 #: ../fish/guestfish.pod:433
22306 msgid "USING launch (OR run)"
22307 msgstr ""
22308
22309 # type: textblock
22310 #. type: textblock
22311 #: ../fish/guestfish.pod:435
22312 msgid ""
22313 "As with L<guestfs(3)>, you must first configure your guest by adding disks, "
22314 "then launch it, then mount any disks you need, and finally issue actions/"
22315 "commands.  So the general order of the day is:"
22316 msgstr ""
22317
22318 # type: textblock
22319 #. type: textblock
22320 #: ../fish/guestfish.pod:443
22321 msgid "add or -a/--add"
22322 msgstr ""
22323
22324 # type: textblock
22325 #. type: textblock
22326 #: ../fish/guestfish.pod:447
22327 msgid "launch (aka run)"
22328 msgstr ""
22329
22330 # type: textblock
22331 #. type: textblock
22332 #: ../fish/guestfish.pod:451
22333 msgid "mount or -m/--mount"
22334 msgstr ""
22335
22336 # type: textblock
22337 #. type: textblock
22338 #: ../fish/guestfish.pod:455
22339 msgid "any other commands"
22340 msgstr ""
22341
22342 # type: textblock
22343 #. type: textblock
22344 #: ../fish/guestfish.pod:459
22345 msgid ""
22346 "C<run> is a synonym for C<launch>.  You must C<launch> (or C<run>)  your "
22347 "guest before mounting or performing any other commands."
22348 msgstr ""
22349
22350 # type: textblock
22351 #. type: textblock
22352 #: ../fish/guestfish.pod:462
22353 msgid ""
22354 "The only exception is that if any of the I<-i>, I<-m>, I<--mount>, I<-N> or "
22355 "I<--new> options were given then C<run> is done automatically, simply "
22356 "because guestfish can't perform the action you asked for without doing this."
22357 msgstr ""
22358
22359 # type: =head1
22360 #. type: =head1
22361 #: ../fish/guestfish.pod:467
22362 msgid "OPENING DISKS FOR READ AND WRITE"
22363 msgstr ""
22364
22365 # type: textblock
22366 #. type: textblock
22367 #: ../fish/guestfish.pod:469
22368 msgid ""
22369 "The guestfish (and L<guestmount(1)>) options I<--ro> and I<--rw> affect "
22370 "whether the other command line options I<-a>, I<-c>, I<-d>, I<-i> and I<-m> "
22371 "open disk images read-only or for writing."
22372 msgstr ""
22373
22374 # type: textblock
22375 #. type: textblock
22376 #: ../fish/guestfish.pod:473
22377 msgid ""
22378 "In libguestfs E<lt> 1.6.2, guestfish and guestmount defaulted to opening "
22379 "disk images supplied on the command line for write.  To open a disk image "
22380 "read-only you have to do I<-a image --ro>."
22381 msgstr ""
22382
22383 # type: textblock
22384 #. type: textblock
22385 #: ../fish/guestfish.pod:477
22386 msgid ""
22387 "This matters: If you accidentally open a live VM disk image writable then "
22388 "you will cause irreversible disk corruption."
22389 msgstr ""
22390
22391 #. type: textblock
22392 #: ../fish/guestfish.pod:480
22393 msgid ""
22394 "By libguestfs 1.10 we intend to change the default the other way.  Disk "
22395 "images will be opened read-only.  You will have to either specify "
22396 "I<guestfish --rw> or change a configuration file in order to get write "
22397 "access for disk images specified by those other command line options."
22398 msgstr ""
22399
22400 # type: textblock
22401 #. type: textblock
22402 #: ../fish/guestfish.pod:485
22403 msgid ""
22404 "This version of guestfish has a I<--rw> option which does nothing (it is "
22405 "already the default).  However it is highly recommended that you use this "
22406 "option to indicate that guestfish needs write access, and to prepare your "
22407 "scripts for the day when this option will be required for write access."
22408 msgstr ""
22409
22410 # type: textblock
22411 #. type: textblock
22412 #: ../fish/guestfish.pod:491
22413 msgid ""
22414 "B<Note:> This does I<not> affect commands like L</add> and L</mount>, or any "
22415 "other libguestfs program apart from guestfish and guestmount."
22416 msgstr ""
22417
22418 # type: =head1
22419 #. type: =head1
22420 #: ../fish/guestfish.pod:494
22421 msgid "QUOTING"
22422 msgstr ""
22423
22424 # type: textblock
22425 #. type: textblock
22426 #: ../fish/guestfish.pod:496
22427 msgid ""
22428 "You can quote ordinary parameters using either single or double quotes.  For "
22429 "example:"
22430 msgstr ""
22431
22432 # type: verbatim
22433 #. type: verbatim
22434 #: ../fish/guestfish.pod:499
22435 #, no-wrap
22436 msgid ""
22437 " add \"file with a space.img\"\n"
22438 "\n"
22439 msgstr ""
22440
22441 # type: verbatim
22442 #. type: verbatim
22443 #: ../fish/guestfish.pod:501
22444 #, no-wrap
22445 msgid ""
22446 " rm '/file name'\n"
22447 "\n"
22448 msgstr ""
22449
22450 # type: verbatim
22451 #. type: verbatim
22452 #: ../fish/guestfish.pod:503
22453 #, no-wrap
22454 msgid ""
22455 " rm '/\"'\n"
22456 "\n"
22457 msgstr ""
22458
22459 # type: textblock
22460 #. type: textblock
22461 #: ../fish/guestfish.pod:505
22462 msgid ""
22463 "A few commands require a list of strings to be passed.  For these, use a "
22464 "whitespace-separated list, enclosed in quotes.  Strings containing "
22465 "whitespace to be passed through must be enclosed in single quotes.  A "
22466 "literal single quote must be escaped with a backslash."
22467 msgstr ""
22468
22469 # type: verbatim
22470 #. type: verbatim
22471 #: ../fish/guestfish.pod:510
22472 #, no-wrap
22473 msgid ""
22474 " vgcreate VG \"/dev/sda1 /dev/sdb1\"\n"
22475 " command \"/bin/echo 'foo      bar'\"\n"
22476 " command \"/bin/echo \\'foo\\'\"\n"
22477 "\n"
22478 msgstr ""
22479
22480 # type: =head1
22481 #. type: =head1
22482 #: ../fish/guestfish.pod:514
22483 msgid "OPTIONAL ARGUMENTS"
22484 msgstr ""
22485
22486 # type: textblock
22487 #. type: textblock
22488 #: ../fish/guestfish.pod:516
22489 msgid ""
22490 "Some commands take optional arguments.  These arguments appear in this "
22491 "documentation as C<[argname:..]>.  You can use them as in these examples:"
22492 msgstr ""
22493
22494 # type: verbatim
22495 #. type: verbatim
22496 #: ../fish/guestfish.pod:520
22497 #, no-wrap
22498 msgid ""
22499 " add-drive-opts filename\n"
22500 "\n"
22501 msgstr ""
22502
22503 # type: verbatim
22504 #. type: verbatim
22505 #: ../fish/guestfish.pod:522
22506 #, no-wrap
22507 msgid ""
22508 " add-drive-opts filename readonly:true\n"
22509 "\n"
22510 msgstr ""
22511
22512 # type: verbatim
22513 #. type: verbatim
22514 #: ../fish/guestfish.pod:524
22515 #, no-wrap
22516 msgid ""
22517 " add-drive-opts filename format:qcow2 readonly:false\n"
22518 "\n"
22519 msgstr ""
22520
22521 # type: textblock
22522 #. type: textblock
22523 #: ../fish/guestfish.pod:526
22524 msgid ""
22525 "Each optional argument can appear at most once.  All optional arguments must "
22526 "appear after the required ones."
22527 msgstr ""
22528
22529 # type: =head1
22530 #. type: =head1
22531 #: ../fish/guestfish.pod:529
22532 msgid "NUMBERS"
22533 msgstr ""
22534
22535 # type: textblock
22536 #. type: textblock
22537 #: ../fish/guestfish.pod:531
22538 msgid ""
22539 "This section applies to all commands which can take integers as parameters."
22540 msgstr ""
22541
22542 # type: =head2
22543 #. type: =head2
22544 #: ../fish/guestfish.pod:534
22545 msgid "SIZE SUFFIX"
22546 msgstr ""
22547
22548 # type: textblock
22549 #. type: textblock
22550 #: ../fish/guestfish.pod:536
22551 msgid ""
22552 "When the command takes a parameter measured in bytes, you can use one of the "
22553 "following suffixes to specify kilobytes, megabytes and larger sizes:"
22554 msgstr ""
22555
22556 # type: =item
22557 #. type: =item
22558 #: ../fish/guestfish.pod:542
22559 msgid "B<k> or B<K> or B<KiB>"
22560 msgstr ""
22561
22562 # type: textblock
22563 #. type: textblock
22564 #: ../fish/guestfish.pod:544
22565 msgid "The size in kilobytes (multiplied by 1024)."
22566 msgstr ""
22567
22568 # type: =item
22569 #. type: =item
22570 #: ../fish/guestfish.pod:546
22571 msgid "B<KB>"
22572 msgstr ""
22573
22574 # type: textblock
22575 #. type: textblock
22576 #: ../fish/guestfish.pod:548
22577 msgid "The size in SI 1000 byte units."
22578 msgstr ""
22579
22580 # type: =item
22581 #. type: =item
22582 #: ../fish/guestfish.pod:550
22583 msgid "B<M> or B<MiB>"
22584 msgstr ""
22585
22586 # type: textblock
22587 #. type: textblock
22588 #: ../fish/guestfish.pod:552
22589 msgid "The size in megabytes (multiplied by 1048576)."
22590 msgstr ""
22591
22592 # type: =item
22593 #. type: =item
22594 #: ../fish/guestfish.pod:554
22595 msgid "B<MB>"
22596 msgstr ""
22597
22598 # type: textblock
22599 #. type: textblock
22600 #: ../fish/guestfish.pod:556
22601 msgid "The size in SI 1000000 byte units."
22602 msgstr ""
22603
22604 # type: =item
22605 #. type: =item
22606 #: ../fish/guestfish.pod:558
22607 msgid "B<G> or B<GiB>"
22608 msgstr ""
22609
22610 # type: textblock
22611 #. type: textblock
22612 #: ../fish/guestfish.pod:560
22613 msgid "The size in gigabytes (multiplied by 2**30)."
22614 msgstr ""
22615
22616 # type: =item
22617 #. type: =item
22618 #: ../fish/guestfish.pod:562
22619 msgid "B<GB>"
22620 msgstr ""
22621
22622 # type: textblock
22623 #. type: textblock
22624 #: ../fish/guestfish.pod:564
22625 msgid "The size in SI 10**9 byte units."
22626 msgstr ""
22627
22628 # type: =item
22629 #. type: =item
22630 #: ../fish/guestfish.pod:566
22631 msgid "B<T> or B<TiB>"
22632 msgstr ""
22633
22634 # type: textblock
22635 #. type: textblock
22636 #: ../fish/guestfish.pod:568
22637 msgid "The size in terabytes (multiplied by 2**40)."
22638 msgstr ""
22639
22640 # type: =item
22641 #. type: =item
22642 #: ../fish/guestfish.pod:570
22643 msgid "B<TB>"
22644 msgstr ""
22645
22646 # type: textblock
22647 #. type: textblock
22648 #: ../fish/guestfish.pod:572
22649 msgid "The size in SI 10**12 byte units."
22650 msgstr ""
22651
22652 # type: =item
22653 #. type: =item
22654 #: ../fish/guestfish.pod:574
22655 msgid "B<P> or B<PiB>"
22656 msgstr ""
22657
22658 # type: textblock
22659 #. type: textblock
22660 #: ../fish/guestfish.pod:576
22661 msgid "The size in petabytes (multiplied by 2**50)."
22662 msgstr ""
22663
22664 # type: =item
22665 #. type: =item
22666 #: ../fish/guestfish.pod:578
22667 msgid "B<PB>"
22668 msgstr ""
22669
22670 # type: textblock
22671 #. type: textblock
22672 #: ../fish/guestfish.pod:580
22673 msgid "The size in SI 10**15 byte units."
22674 msgstr ""
22675
22676 # type: =item
22677 #. type: =item
22678 #: ../fish/guestfish.pod:582
22679 msgid "B<E> or B<EiB>"
22680 msgstr ""
22681
22682 # type: textblock
22683 #. type: textblock
22684 #: ../fish/guestfish.pod:584
22685 msgid "The size in exabytes (multiplied by 2**60)."
22686 msgstr ""
22687
22688 # type: =item
22689 #. type: =item
22690 #: ../fish/guestfish.pod:586
22691 msgid "B<EB>"
22692 msgstr ""
22693
22694 # type: textblock
22695 #. type: textblock
22696 #: ../fish/guestfish.pod:588
22697 msgid "The size in SI 10**18 byte units."
22698 msgstr ""
22699
22700 # type: =item
22701 #. type: =item
22702 #: ../fish/guestfish.pod:590
22703 msgid "B<Z> or B<ZiB>"
22704 msgstr ""
22705
22706 # type: textblock
22707 #. type: textblock
22708 #: ../fish/guestfish.pod:592
22709 msgid "The size in zettabytes (multiplied by 2**70)."
22710 msgstr ""
22711
22712 # type: =item
22713 #. type: =item
22714 #: ../fish/guestfish.pod:594
22715 msgid "B<ZB>"
22716 msgstr ""
22717
22718 # type: textblock
22719 #. type: textblock
22720 #: ../fish/guestfish.pod:596
22721 msgid "The size in SI 10**21 byte units."
22722 msgstr ""
22723
22724 # type: =item
22725 #. type: =item
22726 #: ../fish/guestfish.pod:598
22727 msgid "B<Y> or B<YiB>"
22728 msgstr ""
22729
22730 # type: textblock
22731 #. type: textblock
22732 #: ../fish/guestfish.pod:600
22733 msgid "The size in yottabytes (multiplied by 2**80)."
22734 msgstr ""
22735
22736 # type: =item
22737 #. type: =item
22738 #: ../fish/guestfish.pod:602
22739 msgid "B<YB>"
22740 msgstr ""
22741
22742 # type: textblock
22743 #. type: textblock
22744 #: ../fish/guestfish.pod:604
22745 msgid "The size in SI 10**24 byte units."
22746 msgstr ""
22747
22748 # type: verbatim
22749 #. type: verbatim
22750 #: ../fish/guestfish.pod:610
22751 #, no-wrap
22752 msgid ""
22753 " truncate-size /file 1G\n"
22754 "\n"
22755 msgstr ""
22756
22757 # type: textblock
22758 #. type: textblock
22759 #: ../fish/guestfish.pod:612
22760 msgid "would truncate the file to 1 gigabyte."
22761 msgstr ""
22762
22763 # type: textblock
22764 #. type: textblock
22765 #: ../fish/guestfish.pod:614
22766 msgid ""
22767 "Be careful because a few commands take sizes in kilobytes or megabytes (eg. "
22768 "the parameter to L</memsize> is specified in megabytes already).  Adding a "
22769 "suffix will probably not do what you expect."
22770 msgstr ""
22771
22772 # type: =head2
22773 #. type: =head2
22774 #: ../fish/guestfish.pod:618
22775 msgid "OCTAL AND HEXADECIMAL NUMBERS"
22776 msgstr ""
22777
22778 # type: textblock
22779 #. type: textblock
22780 #: ../fish/guestfish.pod:620
22781 msgid ""
22782 "For specifying the radix (base) use the C convention: C<0> to prefix an "
22783 "octal number or C<0x> to prefix a hexadecimal number.  For example:"
22784 msgstr ""
22785
22786 # type: verbatim
22787 #. type: verbatim
22788 #: ../fish/guestfish.pod:623
22789 #, no-wrap
22790 msgid ""
22791 " 1234      decimal number 1234\n"
22792 " 02322     octal number, equivalent to decimal 1234\n"
22793 " 0x4d2     hexadecimal number, equivalent to decimal 1234\n"
22794 "\n"
22795 msgstr ""
22796
22797 # type: textblock
22798 #. type: textblock
22799 #: ../fish/guestfish.pod:627
22800 msgid ""
22801 "When using the C<chmod> command, you almost always want to specify an octal "
22802 "number for the mode, and you must prefix it with C<0> (unlike the Unix "
22803 "L<chmod(1)> program):"
22804 msgstr ""
22805
22806 # type: verbatim
22807 #. type: verbatim
22808 #: ../fish/guestfish.pod:631
22809 #, no-wrap
22810 msgid ""
22811 " chmod 0777 /public  # OK\n"
22812 " chmod 777 /public   # WRONG! This is mode 777 decimal = 01411 octal.\n"
22813 "\n"
22814 msgstr ""
22815
22816 # type: textblock
22817 #. type: textblock
22818 #: ../fish/guestfish.pod:634
22819 msgid ""
22820 "Commands that return numbers usually print them in decimal, but some "
22821 "commands print numbers in other radices (eg. C<umask> prints the mode in "
22822 "octal, preceeded by C<0>)."
22823 msgstr ""
22824
22825 # type: =head1
22826 #. type: =head1
22827 #: ../fish/guestfish.pod:638
22828 msgid "WILDCARDS AND GLOBBING"
22829 msgstr ""
22830
22831 # type: textblock
22832 #. type: textblock
22833 #: ../fish/guestfish.pod:640
22834 msgid ""
22835 "Neither guestfish nor the underlying guestfs API performs wildcard expansion "
22836 "(globbing) by default.  So for example the following will not do what you "
22837 "expect:"
22838 msgstr ""
22839
22840 # type: verbatim
22841 #. type: verbatim
22842 #: ../fish/guestfish.pod:644
22843 #, no-wrap
22844 msgid ""
22845 " rm-rf /home/*\n"
22846 "\n"
22847 msgstr ""
22848
22849 # type: textblock
22850 #. type: textblock
22851 #: ../fish/guestfish.pod:646
22852 msgid ""
22853 "Assuming you don't have a directory called literally C</home/*> then the "
22854 "above command will return an error."
22855 msgstr ""
22856
22857 # type: textblock
22858 #. type: textblock
22859 #: ../fish/guestfish.pod:649
22860 msgid "To perform wildcard expansion, use the C<glob> command."
22861 msgstr ""
22862
22863 # type: verbatim
22864 #. type: verbatim
22865 #: ../fish/guestfish.pod:651
22866 #, no-wrap
22867 msgid ""
22868 " glob rm-rf /home/*\n"
22869 "\n"
22870 msgstr ""
22871
22872 # type: textblock
22873 #. type: textblock
22874 #: ../fish/guestfish.pod:653
22875 msgid ""
22876 "runs C<rm-rf> on each path that matches (ie. potentially running the command "
22877 "many times), equivalent to:"
22878 msgstr ""
22879
22880 # type: verbatim
22881 #. type: verbatim
22882 #: ../fish/guestfish.pod:656
22883 #, no-wrap
22884 msgid ""
22885 " rm-rf /home/jim\n"
22886 " rm-rf /home/joe\n"
22887 " rm-rf /home/mary\n"
22888 "\n"
22889 msgstr ""
22890
22891 # type: textblock
22892 #. type: textblock
22893 #: ../fish/guestfish.pod:660
22894 msgid "C<glob> only works on simple guest paths and not on device names."
22895 msgstr ""
22896
22897 # type: textblock
22898 #. type: textblock
22899 #: ../fish/guestfish.pod:662
22900 msgid ""
22901 "If you have several parameters, each containing a wildcard, then glob will "
22902 "perform a Cartesian product."
22903 msgstr ""
22904
22905 # type: =head1
22906 #. type: =head1
22907 #: ../fish/guestfish.pod:665
22908 msgid "COMMENTS"
22909 msgstr ""
22910
22911 # type: textblock
22912 #. type: textblock
22913 #: ../fish/guestfish.pod:667
22914 msgid ""
22915 "Any line which starts with a I<#> character is treated as a comment and "
22916 "ignored.  The I<#> can optionally be preceeded by whitespace, but B<not> by "
22917 "a command.  For example:"
22918 msgstr ""
22919
22920 # type: verbatim
22921 #. type: verbatim
22922 #: ../fish/guestfish.pod:671
22923 #, no-wrap
22924 msgid ""
22925 " # this is a comment\n"
22926 "         # this is a comment\n"
22927 " foo # NOT a comment\n"
22928 "\n"
22929 msgstr ""
22930
22931 # type: textblock
22932 #. type: textblock
22933 #: ../fish/guestfish.pod:675
22934 msgid "Blank lines are also ignored."
22935 msgstr ""
22936
22937 # type: =head1
22938 #. type: =head1
22939 #: ../fish/guestfish.pod:677
22940 msgid "RUNNING COMMANDS LOCALLY"
22941 msgstr ""
22942
22943 # type: textblock
22944 #. type: textblock
22945 #: ../fish/guestfish.pod:679
22946 msgid ""
22947 "Any line which starts with a I<!> character is treated as a command sent to "
22948 "the local shell (C</bin/sh> or whatever L<system(3)> uses).  For example:"
22949 msgstr ""
22950
22951 # type: verbatim
22952 #. type: verbatim
22953 #: ../fish/guestfish.pod:683
22954 #, no-wrap
22955 msgid ""
22956 " !mkdir local\n"
22957 " tgz-out /remote local/remote-data.tar.gz\n"
22958 "\n"
22959 msgstr ""
22960
22961 # type: textblock
22962 #. type: textblock
22963 #: ../fish/guestfish.pod:686
22964 msgid ""
22965 "will create a directory C<local> on the host, and then export the contents "
22966 "of C</remote> on the mounted filesystem to C<local/remote-data.tar.gz>.  "
22967 "(See C<tgz-out>)."
22968 msgstr ""
22969
22970 # type: textblock
22971 #. type: textblock
22972 #: ../fish/guestfish.pod:690
22973 msgid ""
22974 "To change the local directory, use the C<lcd> command.  C<!cd> will have no "
22975 "effect, due to the way that subprocesses work in Unix."
22976 msgstr ""
22977
22978 #. type: =head2
22979 #: ../fish/guestfish.pod:693
22980 msgid "LOCAL COMMANDS WITH INLINE EXECUTION"
22981 msgstr ""
22982
22983 #. type: textblock
22984 #: ../fish/guestfish.pod:695
22985 msgid ""
22986 "If a line starts with I<E<lt>!> then the shell command is executed (as for "
22987 "I<!>), but subsequently any output (stdout) of the shell command is parsed "
22988 "and executed as guestfish commands."
22989 msgstr ""
22990
22991 #. type: textblock
22992 #: ../fish/guestfish.pod:699
22993 msgid ""
22994 "Thus you can use shell script to construct arbitrary guestfish commands "
22995 "which are then parsed by guestfish."
22996 msgstr ""
22997
22998 #. type: textblock
22999 #: ../fish/guestfish.pod:702
23000 msgid ""
23001 "For example it is tedious to create a sequence of files (eg. C</foo.1> "
23002 "through C</foo.100>) using guestfish commands alone.  However this is simple "
23003 "if we use a shell script to create the guestfish commands for us:"
23004 msgstr ""
23005
23006 #. type: verbatim
23007 #: ../fish/guestfish.pod:707
23008 #, no-wrap
23009 msgid ""
23010 " <! for n in `seq 1 100`; do echo write /foo.$n $n; done\n"
23011 "\n"
23012 msgstr ""
23013
23014 #. type: textblock
23015 #: ../fish/guestfish.pod:709
23016 msgid "or with names like C</foo.001>:"
23017 msgstr ""
23018
23019 #. type: verbatim
23020 #: ../fish/guestfish.pod:711
23021 #, no-wrap
23022 msgid ""
23023 " <! for n in `seq 1 100`; do printf \"write /foo.%03d %d\\n\" $n $n; done\n"
23024 "\n"
23025 msgstr ""
23026
23027 #. type: textblock
23028 #: ../fish/guestfish.pod:713
23029 msgid ""
23030 "When using guestfish interactively it can be helpful to just run the shell "
23031 "script first (ie. remove the initial C<E<lt>> character so it is just an "
23032 "ordinary I<!> local command), see what guestfish commands it would run, and "
23033 "when you are happy with those prepend the C<E<lt>> character to run the "
23034 "guestfish commands for real."
23035 msgstr ""
23036
23037 # type: =head1
23038 #. type: =head1
23039 #: ../fish/guestfish.pod:719
23040 msgid "PIPES"
23041 msgstr ""
23042
23043 # type: textblock
23044 #. type: textblock
23045 #: ../fish/guestfish.pod:721
23046 msgid ""
23047 "Use C<command E<lt>spaceE<gt> | command> to pipe the output of the first "
23048 "command (a guestfish command) to the second command (any host command).  For "
23049 "example:"
23050 msgstr ""
23051
23052 # type: verbatim
23053 #. type: verbatim
23054 #: ../fish/guestfish.pod:725
23055 #, no-wrap
23056 msgid ""
23057 " cat /etc/passwd | awk -F: '$3 == 0 { print }'\n"
23058 "\n"
23059 msgstr ""
23060
23061 # type: textblock
23062 #. type: textblock
23063 #: ../fish/guestfish.pod:727
23064 msgid ""
23065 "(where C<cat> is the guestfish cat command, but C<awk> is the host awk "
23066 "program).  The above command would list all accounts in the guest filesystem "
23067 "which have UID 0, ie. root accounts including backdoors.  Other examples:"
23068 msgstr ""
23069
23070 # type: verbatim
23071 #. type: verbatim
23072 #: ../fish/guestfish.pod:732
23073 #, no-wrap
23074 msgid ""
23075 " hexdump /bin/ls | head\n"
23076 " list-devices | tail -1\n"
23077 " tgz-out / - | tar ztf -\n"
23078 "\n"
23079 msgstr ""
23080
23081 # type: textblock
23082 #. type: textblock
23083 #: ../fish/guestfish.pod:736
23084 msgid ""
23085 "The space before the pipe symbol is required, any space after the pipe "
23086 "symbol is optional.  Everything after the pipe symbol is just passed "
23087 "straight to the host shell, so it can contain redirections, globs and "
23088 "anything else that makes sense on the host side."
23089 msgstr ""
23090
23091 # type: textblock
23092 #. type: textblock
23093 #: ../fish/guestfish.pod:741
23094 msgid ""
23095 "To use a literal argument which begins with a pipe symbol, you have to quote "
23096 "it, eg:"
23097 msgstr ""
23098
23099 # type: verbatim
23100 #. type: verbatim
23101 #: ../fish/guestfish.pod:744
23102 #, no-wrap
23103 msgid ""
23104 " echo \"|\"\n"
23105 "\n"
23106 msgstr ""
23107
23108 # type: =head1
23109 #. type: =head1
23110 #: ../fish/guestfish.pod:746
23111 msgid "HOME DIRECTORIES"
23112 msgstr ""
23113
23114 # type: textblock
23115 #. type: textblock
23116 #: ../fish/guestfish.pod:748
23117 msgid ""
23118 "If a parameter starts with the character C<~> then the tilde may be expanded "
23119 "as a home directory path (either C<~> for the current user's home directory, "
23120 "or C<~user> for another user)."
23121 msgstr ""
23122
23123 # type: textblock
23124 #. type: textblock
23125 #: ../fish/guestfish.pod:752
23126 msgid ""
23127 "Note that home directory expansion happens for users known I<on the host>, "
23128 "not in the guest filesystem."
23129 msgstr ""
23130
23131 # type: textblock
23132 #. type: textblock
23133 #: ../fish/guestfish.pod:755
23134 msgid ""
23135 "To use a literal argument which begins with a tilde, you have to quote it, "
23136 "eg:"
23137 msgstr ""
23138
23139 # type: verbatim
23140 #. type: verbatim
23141 #: ../fish/guestfish.pod:758
23142 #, no-wrap
23143 msgid ""
23144 " echo \"~\"\n"
23145 "\n"
23146 msgstr ""
23147
23148 # type: textblock
23149 #. type: textblock
23150 #: ../fish/guestfish.pod:762
23151 msgid ""
23152 "Libguestfs has some support for Linux guests encrypted according to the "
23153 "Linux Unified Key Setup (LUKS) standard, which includes nearly all whole "
23154 "disk encryption systems used by modern Linux guests.  Currently only LVM-on-"
23155 "LUKS is supported."
23156 msgstr ""
23157
23158 # type: textblock
23159 #. type: textblock
23160 #: ../fish/guestfish.pod:767
23161 msgid "Identify encrypted block devices and partitions using L</vfs-type>:"
23162 msgstr ""
23163
23164 # type: verbatim
23165 #. type: verbatim
23166 #: ../fish/guestfish.pod:769
23167 #, no-wrap
23168 msgid ""
23169 " ><fs> vfs-type /dev/sda2\n"
23170 " crypto_LUKS\n"
23171 "\n"
23172 msgstr ""
23173
23174 # type: textblock
23175 #. type: textblock
23176 #: ../fish/guestfish.pod:772
23177 msgid ""
23178 "Then open those devices using L</luks-open>.  This creates a device-mapper "
23179 "device called C</dev/mapper/luksdev>."
23180 msgstr ""
23181
23182 # type: verbatim
23183 #. type: verbatim
23184 #: ../fish/guestfish.pod:775
23185 #, no-wrap
23186 msgid ""
23187 " ><fs> luks-open /dev/sda2 luksdev\n"
23188 " Enter key or passphrase (\"key\"): <enter the passphrase>\n"
23189 "\n"
23190 msgstr ""
23191
23192 # type: textblock
23193 #. type: textblock
23194 #: ../fish/guestfish.pod:778
23195 msgid ""
23196 "Finally you have to tell LVM to scan for volume groups on the newly created "
23197 "mapper device:"
23198 msgstr ""
23199
23200 # type: verbatim
23201 #. type: verbatim
23202 #: ../fish/guestfish.pod:781
23203 #, no-wrap
23204 msgid ""
23205 " vgscan\n"
23206 " vg-activate-all true\n"
23207 "\n"
23208 msgstr ""
23209
23210 # type: textblock
23211 #. type: textblock
23212 #: ../fish/guestfish.pod:784
23213 msgid "The logical volume(s) can now be mounted in the usual way."
23214 msgstr ""
23215
23216 # type: textblock
23217 #. type: textblock
23218 #: ../fish/guestfish.pod:786
23219 msgid ""
23220 "Before closing a LUKS device you must unmount any logical volumes on it and "
23221 "deactivate the volume groups by calling C<vg-activate false VG> on each "
23222 "one.  Then you can close the mapper device:"
23223 msgstr ""
23224
23225 # type: verbatim
23226 #. type: verbatim
23227 #: ../fish/guestfish.pod:790
23228 #, no-wrap
23229 msgid ""
23230 " vg-activate false /dev/VG\n"
23231 " luks-close /dev/mapper/luksdev\n"
23232 "\n"
23233 msgstr ""
23234
23235 # type: =head1
23236 #. type: =head1
23237 #: ../fish/guestfish.pod:793
23238 msgid "WINDOWS PATHS"
23239 msgstr ""
23240
23241 # type: textblock
23242 #. type: textblock
23243 #: ../fish/guestfish.pod:795
23244 msgid ""
23245 "If a path is prefixed with C<win:> then you can use Windows-style paths "
23246 "(with some limitations).  The following commands are equivalent:"
23247 msgstr ""
23248
23249 # type: verbatim
23250 #. type: verbatim
23251 #: ../fish/guestfish.pod:798
23252 #, no-wrap
23253 msgid ""
23254 " file /WINDOWS/system32/config/system.LOG\n"
23255 "\n"
23256 msgstr ""
23257
23258 # type: verbatim
23259 #. type: verbatim
23260 #: ../fish/guestfish.pod:800
23261 #, no-wrap
23262 msgid ""
23263 " file win:/windows/system32/config/system.log\n"
23264 "\n"
23265 msgstr ""
23266
23267 # type: verbatim
23268 #. type: verbatim
23269 #: ../fish/guestfish.pod:802
23270 #, no-wrap
23271 msgid ""
23272 " file win:\\windows\\system32\\config\\system.log\n"
23273 "\n"
23274 msgstr ""
23275
23276 # type: verbatim
23277 #. type: verbatim
23278 #: ../fish/guestfish.pod:804
23279 #, no-wrap
23280 msgid ""
23281 " file WIN:C:\\Windows\\SYSTEM32\\conFIG\\SYSTEM.LOG\n"
23282 "\n"
23283 msgstr ""
23284
23285 # type: textblock
23286 #. type: textblock
23287 #: ../fish/guestfish.pod:806
23288 msgid ""
23289 "This syntax implicitly calls C<case-sensitive-path> (q.v.) so it also "
23290 "handles case insensitivity like Windows would.  This only works in argument "
23291 "positions that expect a path."
23292 msgstr ""
23293
23294 # type: =head1
23295 #. type: =head1
23296 #: ../fish/guestfish.pod:810
23297 msgid "UPLOADING AND DOWNLOADING FILES"
23298 msgstr ""
23299
23300 # type: textblock
23301 #. type: textblock
23302 #: ../fish/guestfish.pod:812
23303 msgid ""
23304 "For commands such as C<upload>, C<download>, C<tar-in>, C<tar-out> and "
23305 "others which upload from or download to a local file, you can use the "
23306 "special filename C<-> to mean \"from stdin\" or \"to stdout\".  For example:"
23307 msgstr ""
23308
23309 # type: verbatim
23310 #. type: verbatim
23311 #: ../fish/guestfish.pod:816
23312 #, no-wrap
23313 msgid ""
23314 " upload - /foo\n"
23315 "\n"
23316 msgstr ""
23317
23318 # type: textblock
23319 #. type: textblock
23320 #: ../fish/guestfish.pod:818
23321 msgid ""
23322 "reads stdin and creates from that a file C</foo> in the disk image, and:"
23323 msgstr ""
23324
23325 # type: verbatim
23326 #. type: verbatim
23327 #: ../fish/guestfish.pod:821
23328 #, no-wrap
23329 msgid ""
23330 " tar-out /etc - | tar tf -\n"
23331 "\n"
23332 msgstr ""
23333
23334 # type: textblock
23335 #. type: textblock
23336 #: ../fish/guestfish.pod:823
23337 msgid ""
23338 "writes the tarball to stdout and then pipes that into the external \"tar\" "
23339 "command (see L</PIPES>)."
23340 msgstr ""
23341
23342 # type: textblock
23343 #. type: textblock
23344 #: ../fish/guestfish.pod:826
23345 msgid ""
23346 "When using C<-> to read from stdin, the input is read up to the end of "
23347 "stdin.  You can also use a special \"heredoc\"-like syntax to read up to "
23348 "some arbitrary end marker:"
23349 msgstr ""
23350
23351 # type: verbatim
23352 #. type: verbatim
23353 #: ../fish/guestfish.pod:830
23354 #, no-wrap
23355 msgid ""
23356 " upload -<<END /foo\n"
23357 " input line 1\n"
23358 " input line 2\n"
23359 " input line 3\n"
23360 " END\n"
23361 "\n"
23362 msgstr ""
23363
23364 # type: textblock
23365 #. type: textblock
23366 #: ../fish/guestfish.pod:836
23367 msgid ""
23368 "Any string of characters can be used instead of C<END>.  The end marker must "
23369 "appear on a line of its own, without any preceeding or following characters "
23370 "(not even spaces)."
23371 msgstr ""
23372
23373 # type: textblock
23374 #. type: textblock
23375 #: ../fish/guestfish.pod:840
23376 msgid ""
23377 "Note that the C<-E<lt>E<lt>> syntax only applies to parameters used to "
23378 "upload local files (so-called \"FileIn\" parameters in the generator)."
23379 msgstr ""
23380
23381 # type: =head1
23382 #. type: =head1
23383 #: ../fish/guestfish.pod:843
23384 msgid "EXIT ON ERROR BEHAVIOUR"
23385 msgstr ""
23386
23387 # type: textblock
23388 #. type: textblock
23389 #: ../fish/guestfish.pod:845
23390 msgid ""
23391 "By default, guestfish will ignore any errors when in interactive mode (ie. "
23392 "taking commands from a human over a tty), and will exit on the first error "
23393 "in non-interactive mode (scripts, commands given on the command line)."
23394 msgstr ""
23395
23396 # type: textblock
23397 #. type: textblock
23398 #: ../fish/guestfish.pod:850
23399 msgid ""
23400 "If you prefix a command with a I<-> character, then that command will not "
23401 "cause guestfish to exit, even if that (one) command returns an error."
23402 msgstr ""
23403
23404 # type: =head1
23405 #. type: =head1
23406 #: ../fish/guestfish.pod:854
23407 msgid "REMOTE CONTROL GUESTFISH OVER A SOCKET"
23408 msgstr ""
23409
23410 # type: textblock
23411 #. type: textblock
23412 #: ../fish/guestfish.pod:856
23413 msgid ""
23414 "Guestfish can be remote-controlled over a socket.  This is useful "
23415 "particularly in shell scripts where you want to make several different "
23416 "changes to a filesystem, but you don't want the overhead of starting up a "
23417 "guestfish process each time."
23418 msgstr ""
23419
23420 # type: textblock
23421 #. type: textblock
23422 #: ../fish/guestfish.pod:861
23423 msgid "Start a guestfish server process using:"
23424 msgstr ""
23425
23426 # type: verbatim
23427 #. type: verbatim
23428 #: ../fish/guestfish.pod:863
23429 #, no-wrap
23430 msgid ""
23431 " eval \"`guestfish --listen`\"\n"
23432 "\n"
23433 msgstr ""
23434
23435 # type: textblock
23436 #. type: textblock
23437 #: ../fish/guestfish.pod:865
23438 msgid "and then send it commands by doing:"
23439 msgstr ""
23440
23441 # type: verbatim
23442 #. type: verbatim
23443 #: ../fish/guestfish.pod:867
23444 #, no-wrap
23445 msgid ""
23446 " guestfish --remote cmd [...]\n"
23447 "\n"
23448 msgstr ""
23449
23450 # type: textblock
23451 #. type: textblock
23452 #: ../fish/guestfish.pod:869
23453 msgid "To cause the server to exit, send it the exit command:"
23454 msgstr ""
23455
23456 # type: verbatim
23457 #. type: verbatim
23458 #: ../fish/guestfish.pod:871
23459 #, no-wrap
23460 msgid ""
23461 " guestfish --remote exit\n"
23462 "\n"
23463 msgstr ""
23464
23465 # type: textblock
23466 #. type: textblock
23467 #: ../fish/guestfish.pod:873
23468 msgid ""
23469 "Note that the server will normally exit if there is an error in a command.  "
23470 "You can change this in the usual way.  See section L</EXIT ON ERROR "
23471 "BEHAVIOUR>."
23472 msgstr ""
23473
23474 # type: =head2
23475 #. type: =head2
23476 #: ../fish/guestfish.pod:877
23477 msgid "CONTROLLING MULTIPLE GUESTFISH PROCESSES"
23478 msgstr ""
23479
23480 # type: textblock
23481 #. type: textblock
23482 #: ../fish/guestfish.pod:879
23483 msgid ""
23484 "The C<eval> statement sets the environment variable C<$GUESTFISH_PID>, which "
23485 "is how the I<--remote> option knows where to send the commands.  You can "
23486 "have several guestfish listener processes running using:"
23487 msgstr ""
23488
23489 # type: verbatim
23490 #. type: verbatim
23491 #: ../fish/guestfish.pod:883
23492 #, no-wrap
23493 msgid ""
23494 " eval \"`guestfish --listen`\"\n"
23495 " pid1=$GUESTFISH_PID\n"
23496 " eval \"`guestfish --listen`\"\n"
23497 " pid2=$GUESTFISH_PID\n"
23498 " ...\n"
23499 " guestfish --remote=$pid1 cmd\n"
23500 " guestfish --remote=$pid2 cmd\n"
23501 "\n"
23502 msgstr ""
23503
23504 # type: =head2
23505 #. type: =head2
23506 #: ../fish/guestfish.pod:891
23507 msgid "REMOTE CONTROL AND CSH"
23508 msgstr ""
23509
23510 # type: textblock
23511 #. type: textblock
23512 #: ../fish/guestfish.pod:893
23513 msgid ""
23514 "When using csh-like shells (csh, tcsh etc) you have to add the I<--csh> "
23515 "option:"
23516 msgstr ""
23517
23518 # type: verbatim
23519 #. type: verbatim
23520 #: ../fish/guestfish.pod:896
23521 #, no-wrap
23522 msgid ""
23523 " eval \"`guestfish --listen --csh`\"\n"
23524 "\n"
23525 msgstr ""
23526
23527 # type: =head2
23528 #. type: =head2
23529 #: ../fish/guestfish.pod:898
23530 msgid "REMOTE CONTROL DETAILS"
23531 msgstr ""
23532
23533 # type: textblock
23534 #. type: textblock
23535 #: ../fish/guestfish.pod:900
23536 msgid ""
23537 "Remote control happens over a Unix domain socket called C</tmp/.guestfish-"
23538 "$UID/socket-$PID>, where C<$UID> is the effective user ID of the process, "
23539 "and C<$PID> is the process ID of the server."
23540 msgstr ""
23541
23542 # type: textblock
23543 #. type: textblock
23544 #: ../fish/guestfish.pod:904
23545 msgid "Guestfish client and server versions must match exactly."
23546 msgstr ""
23547
23548 # type: =head1
23549 #. type: =head1
23550 #: ../fish/guestfish.pod:906
23551 msgid "PREPARED DISK IMAGES"
23552 msgstr ""
23553
23554 # type: textblock
23555 #. type: textblock
23556 #: ../fish/guestfish.pod:908
23557 msgid ""
23558 "Use the I<-N type> or I<--new type> parameter to select one of a set of "
23559 "preformatted disk images that guestfish can make for you to save typing.  "
23560 "This is particularly useful for testing purposes.  This option is used "
23561 "instead of the I<-a> option, and like I<-a> can appear multiple times (and "
23562 "can be mixed with I<-a>)."
23563 msgstr ""
23564
23565 # type: textblock
23566 #. type: textblock
23567 #: ../fish/guestfish.pod:914
23568 msgid ""
23569 "The new disk is called C<test1.img> for the first I<-N>, C<test2.img> for "
23570 "the second and so on.  Existing files in the current directory are "
23571 "I<overwritten>."
23572 msgstr ""
23573
23574 # type: textblock
23575 #. type: textblock
23576 #: ../fish/guestfish.pod:918
23577 msgid ""
23578 "The type briefly describes how the disk should be sized, partitioned, how "
23579 "filesystem(s) should be created, and how content should be added.  "
23580 "Optionally the type can be followed by extra parameters, separated by C<:> "
23581 "(colon) characters.  For example, I<-N fs> creates a default 100MB, sparsely-"
23582 "allocated disk, containing a single partition, with the partition formatted "
23583 "as ext2.  I<-N fs:ext4:1G> is the same, but for an ext4 filesystem on a 1GB "
23584 "disk instead."
23585 msgstr ""
23586
23587 # type: textblock
23588 #. type: textblock
23589 #: ../fish/guestfish.pod:926
23590 msgid "To list the available types and any extra parameters they take, run:"
23591 msgstr ""
23592
23593 # type: textblock
23594 #. type: textblock
23595 #: ../fish/guestfish.pod:930
23596 msgid ""
23597 "Note that the prepared filesystem is not mounted.  You would usually have to "
23598 "use the C<mount /dev/sda1 /> command or add the I<-m /dev/sda1> option."
23599 msgstr ""
23600
23601 # type: textblock
23602 #. type: textblock
23603 #: ../fish/guestfish.pod:934
23604 msgid ""
23605 "If any I<-N> or I<--new> options are given, the guest is automatically "
23606 "launched."
23607 msgstr ""
23608
23609 # type: textblock
23610 #. type: textblock
23611 #: ../fish/guestfish.pod:939
23612 msgid "Create a 100MB disk with an ext4-formatted partition:"
23613 msgstr ""
23614
23615 # type: verbatim
23616 #. type: verbatim
23617 #: ../fish/guestfish.pod:941
23618 #, no-wrap
23619 msgid ""
23620 " guestfish -N fs:ext4\n"
23621 "\n"
23622 msgstr ""
23623
23624 # type: textblock
23625 #. type: textblock
23626 #: ../fish/guestfish.pod:943
23627 msgid "Create a 32MB disk with a VFAT-formatted partition, and mount it:"
23628 msgstr ""
23629
23630 # type: verbatim
23631 #. type: verbatim
23632 #: ../fish/guestfish.pod:945
23633 #, no-wrap
23634 msgid ""
23635 " guestfish -N fs:vfat:32M -m /dev/sda1\n"
23636 "\n"
23637 msgstr ""
23638
23639 # type: textblock
23640 #. type: textblock
23641 #: ../fish/guestfish.pod:947
23642 msgid "Create a blank 200MB disk:"
23643 msgstr ""
23644
23645 # type: verbatim
23646 #. type: verbatim
23647 #: ../fish/guestfish.pod:949
23648 #, no-wrap
23649 msgid ""
23650 " guestfish -N disk:200M\n"
23651 "\n"
23652 msgstr ""
23653
23654 # type: =head1
23655 #. type: =head1
23656 #: ../fish/guestfish.pod:951
23657 msgid "PROGRESS BARS"
23658 msgstr ""
23659
23660 # type: textblock
23661 #. type: textblock
23662 #: ../fish/guestfish.pod:953
23663 msgid ""
23664 "Some (not all) long-running commands send progress notification messages as "
23665 "they are running.  Guestfish turns these messages into progress bars."
23666 msgstr ""
23667
23668 # type: textblock
23669 #. type: textblock
23670 #: ../fish/guestfish.pod:957
23671 msgid ""
23672 "When a command that supports progress bars takes longer than two seconds to "
23673 "run, and if progress bars are enabled, then you will see one appearing below "
23674 "the command:"
23675 msgstr ""
23676
23677 # type: verbatim
23678 #. type: verbatim
23679 #: ../fish/guestfish.pod:961
23680 #, no-wrap
23681 msgid ""
23682 " ><fs> copy-size /large-file /another-file 2048M\n"
23683 " / 10% [#####-----------------------------------------] 00:30\n"
23684 "\n"
23685 msgstr ""
23686
23687 # type: textblock
23688 #. type: textblock
23689 #: ../fish/guestfish.pod:964
23690 msgid ""
23691 "The spinner on the left hand side moves round once for every progress "
23692 "notification received from the backend.  This is a (reasonably) golden "
23693 "assurance that the command is \"doing something\" even if the progress bar "
23694 "is not moving, because the command is able to send the progress "
23695 "notifications.  When the bar reaches 100% and the command finishes, the "
23696 "spinner disappears."
23697 msgstr ""
23698
23699 # type: textblock
23700 #. type: textblock
23701 #: ../fish/guestfish.pod:971
23702 msgid ""
23703 "Progress bars are enabled by default when guestfish is used interactively.  "
23704 "You can enable them even for non-interactive modes using I<--progress-bars>, "
23705 "and you can disable them completely using I<--no-progress-bars>."
23706 msgstr ""
23707
23708 # type: =head1
23709 #. type: =head1
23710 #: ../fish/guestfish.pod:976
23711 msgid "GUESTFISH COMMANDS"
23712 msgstr ""
23713
23714 # type: textblock
23715 #. type: textblock
23716 #: ../fish/guestfish.pod:978
23717 msgid ""
23718 "The commands in this section are guestfish convenience commands, in other "
23719 "words, they are not part of the L<guestfs(3)> API."
23720 msgstr ""
23721
23722 # type: =head2
23723 #. type: =head2
23724 #: ../fish/guestfish.pod:981
23725 msgid "help"
23726 msgstr ""
23727
23728 # type: verbatim
23729 #. type: verbatim
23730 #: ../fish/guestfish.pod:983
23731 #, no-wrap
23732 msgid ""
23733 " help\n"
23734 " help cmd\n"
23735 "\n"
23736 msgstr ""
23737
23738 # type: textblock
23739 #. type: textblock
23740 #: ../fish/guestfish.pod:986
23741 msgid "Without any parameter, this provides general help."
23742 msgstr ""
23743
23744 # type: textblock
23745 #. type: textblock
23746 #: ../fish/guestfish.pod:988
23747 msgid "With a C<cmd> parameter, this displays detailed help for that command."
23748 msgstr ""
23749
23750 # type: =head2
23751 #. type: =head2
23752 #: ../fish/guestfish.pod:990
23753 msgid "quit | exit"
23754 msgstr ""
23755
23756 # type: textblock
23757 #. type: textblock
23758 #: ../fish/guestfish.pod:992
23759 msgid "This exits guestfish.  You can also use C<^D> key."
23760 msgstr ""
23761
23762 # type: textblock
23763 #. type: textblock
23764 #: ../fish/guestfish.pod:994
23765 msgid "@FISH_COMMANDS@"
23766 msgstr ""
23767
23768 # type: =head1
23769 #. type: =head1
23770 #: ../fish/guestfish.pod:996
23771 msgid "COMMANDS"
23772 msgstr ""
23773
23774 # type: =head1
23775 #. type: =head1
23776 #: ../fish/guestfish.pod:1000 ../test-tool/libguestfs-test-tool.pod:83
23777 msgid "EXIT CODE"
23778 msgstr ""
23779
23780 # type: textblock
23781 #. type: textblock
23782 #: ../fish/guestfish.pod:1002
23783 msgid ""
23784 "guestfish returns 0 if the commands completed without error, or 1 if there "
23785 "was an error."
23786 msgstr ""
23787
23788 # type: =item
23789 #. type: =item
23790 #: ../fish/guestfish.pod:1009
23791 msgid "EDITOR"
23792 msgstr ""
23793
23794 # type: textblock
23795 #. type: textblock
23796 #: ../fish/guestfish.pod:1011
23797 msgid ""
23798 "The C<edit> command uses C<$EDITOR> as the editor.  If not set, it uses "
23799 "C<vi>."
23800 msgstr ""
23801
23802 # type: =item
23803 #. type: =item
23804 #: ../fish/guestfish.pod:1014
23805 msgid "GUESTFISH_PID"
23806 msgstr ""
23807
23808 # type: textblock
23809 #. type: textblock
23810 #: ../fish/guestfish.pod:1016
23811 msgid ""
23812 "Used with the I<--remote> option to specify the remote guestfish process to "
23813 "control.  See section L</REMOTE CONTROL GUESTFISH OVER A SOCKET>."
23814 msgstr ""
23815
23816 # type: =item
23817 #. type: =item
23818 #: ../fish/guestfish.pod:1020
23819 msgid "HEXEDITOR"
23820 msgstr ""
23821
23822 # type: textblock
23823 #. type: textblock
23824 #: ../fish/guestfish.pod:1022
23825 msgid ""
23826 "The L</hexedit> command uses C<$HEXEDITOR> as the external hex editor.  If "
23827 "not specified, the external L<hexedit(1)> program is used."
23828 msgstr ""
23829
23830 # type: =item
23831 #. type: =item
23832 #: ../fish/guestfish.pod:1026
23833 msgid "HOME"
23834 msgstr ""
23835
23836 # type: textblock
23837 #. type: textblock
23838 #: ../fish/guestfish.pod:1028
23839 msgid ""
23840 "If compiled with GNU readline support, various files in the home directory "
23841 "can be used.  See L</FILES>."
23842 msgstr ""
23843
23844 # type: textblock
23845 #. type: textblock
23846 #: ../fish/guestfish.pod:1037
23847 msgid ""
23848 "Set C<LIBGUESTFS_DEBUG=1> to enable verbose messages.  This has the same "
23849 "effect as using the B<-v> option."
23850 msgstr ""
23851
23852 # type: textblock
23853 #. type: textblock
23854 #: ../fish/guestfish.pod:1049
23855 msgid ""
23856 "Set the path that guestfish uses to search for kernel and initrd.img.  See "
23857 "the discussion of paths in L<guestfs(3)>."
23858 msgstr ""
23859
23860 # type: textblock
23861 #. type: textblock
23862 #: ../fish/guestfish.pod:1060
23863 msgid "Set C<LIBGUESTFS_TRACE=1> to enable command traces."
23864 msgstr ""
23865
23866 # type: =item
23867 #. type: =item
23868 #: ../fish/guestfish.pod:1062
23869 msgid "PAGER"
23870 msgstr ""
23871
23872 # type: textblock
23873 #. type: textblock
23874 #: ../fish/guestfish.pod:1064
23875 msgid ""
23876 "The C<more> command uses C<$PAGER> as the pager.  If not set, it uses "
23877 "C<more>."
23878 msgstr ""
23879
23880 # type: =head1
23881 #. type: =head1
23882 #: ../fish/guestfish.pod:1080 ../test-tool/libguestfs-test-tool.pod:88
23883 msgid "FILES"
23884 msgstr ""
23885
23886 # type: =item
23887 #. type: =item
23888 #: ../fish/guestfish.pod:1084
23889 msgid "$HOME/.guestfish"
23890 msgstr ""
23891
23892 # type: textblock
23893 #. type: textblock
23894 #: ../fish/guestfish.pod:1086
23895 msgid ""
23896 "If compiled with GNU readline support, then the command history is saved in "
23897 "this file."
23898 msgstr ""
23899
23900 # type: =item
23901 #. type: =item
23902 #: ../fish/guestfish.pod:1089
23903 msgid "$HOME/.inputrc"
23904 msgstr ""
23905
23906 # type: =item
23907 #. type: =item
23908 #: ../fish/guestfish.pod:1091
23909 msgid "/etc/inputrc"
23910 msgstr ""
23911
23912 # type: textblock
23913 #. type: textblock
23914 #: ../fish/guestfish.pod:1093
23915 msgid ""
23916 "If compiled with GNU readline support, then these files can be used to "
23917 "configure readline.  For further information, please see L<readline(3)/"
23918 "INITIALIZATION FILE>."
23919 msgstr ""
23920
23921 # type: textblock
23922 #. type: textblock
23923 #: ../fish/guestfish.pod:1097
23924 msgid "To write rules which only apply to guestfish, use:"
23925 msgstr ""
23926
23927 # type: verbatim
23928 #. type: verbatim
23929 #: ../fish/guestfish.pod:1099
23930 #, no-wrap
23931 msgid ""
23932 " $if guestfish\n"
23933 " ...\n"
23934 " $endif\n"
23935 "\n"
23936 msgstr ""
23937
23938 # type: textblock
23939 #. type: textblock
23940 #: ../fish/guestfish.pod:1103
23941 msgid ""
23942 "Variables that you can set in inputrc that change the behaviour of guestfish "
23943 "in useful ways include:"
23944 msgstr ""
23945
23946 # type: =item
23947 #. type: =item
23948 #: ../fish/guestfish.pod:1108
23949 msgid "completion-ignore-case (default: on)"
23950 msgstr ""
23951
23952 # type: textblock
23953 #. type: textblock
23954 #: ../fish/guestfish.pod:1110
23955 msgid ""
23956 "By default, guestfish will ignore case when tab-completing paths on the "
23957 "disk.  Use:"
23958 msgstr ""
23959
23960 # type: verbatim
23961 #. type: verbatim
23962 #: ../fish/guestfish.pod:1113
23963 #, no-wrap
23964 msgid ""
23965 " set completion-ignore-case off\n"
23966 "\n"
23967 msgstr ""
23968
23969 # type: textblock
23970 #. type: textblock
23971 #: ../fish/guestfish.pod:1115
23972 msgid "to make guestfish case sensitive."
23973 msgstr ""
23974
23975 # type: =item
23976 #. type: =item
23977 #: ../fish/guestfish.pod:1119
23978 msgid "test1.img"
23979 msgstr ""
23980
23981 # type: =item
23982 #. type: =item
23983 #: ../fish/guestfish.pod:1121
23984 msgid "test2.img (etc)"
23985 msgstr ""
23986
23987 # type: textblock
23988 #. type: textblock
23989 #: ../fish/guestfish.pod:1123
23990 msgid ""
23991 "When using the C<-N> or C<--new> option, the prepared disk or filesystem "
23992 "will be created in the file C<test1.img> in the current directory.  The "
23993 "second use of C<-N> will use C<test2.img> and so on.  Any existing file with "
23994 "the same name will be overwritten."
23995 msgstr ""
23996
23997 #. type: textblock
23998 #: ../fish/guestfish.pod:1132
23999 msgid ""
24000 "L<guestfs(3)>, L<http://libguestfs.org/>, L<virt-cat(1)>, L<virt-copy-in(1)"
24001 ">, L<virt-copy-out(1)>, L<virt-df(1)>, L<virt-edit(1)>, L<virt-filesystems(1)"
24002 ">, L<virt-inspector(1)>, L<virt-list-filesystems(1)>, L<virt-list-partitions"
24003 "(1)>, L<virt-ls(1)>, L<virt-make-fs(1)>, L<virt-rescue(1)>, L<virt-resize(1)"
24004 ">, L<virt-tar(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>, L<virt-win-reg(1)"
24005 ">, L<hexedit(1)>."
24006 msgstr ""
24007
24008 # type: textblock
24009 #. type: textblock
24010 #: ../fish/guestfish.pod:1162 ../test-tool/libguestfs-test-tool.pod:124
24011 #: ../fuse/guestmount.pod:270 ../tools/virt-edit.pl:372
24012 #: ../tools/virt-win-reg.pl:606 ../tools/virt-resize.pl:1518
24013 #: ../tools/virt-list-filesystems.pl:210 ../tools/virt-tar.pl:309
24014 #: ../tools/virt-make-fs.pl:572 ../tools/virt-list-partitions.pl:277
24015 msgid ""
24016 "This program is free software; you can redistribute it and/or modify it "
24017 "under the terms of the GNU General Public License as published by the Free "
24018 "Software Foundation; either version 2 of the License, or (at your option) "
24019 "any later version."
24020 msgstr ""
24021
24022 # type: textblock
24023 #. type: textblock
24024 #: ../fish/guestfish.pod:1167 ../test-tool/libguestfs-test-tool.pod:129
24025 #: ../fuse/guestmount.pod:275 ../tools/virt-edit.pl:377
24026 #: ../tools/virt-win-reg.pl:611 ../tools/virt-resize.pl:1523
24027 #: ../tools/virt-list-filesystems.pl:215 ../tools/virt-tar.pl:314
24028 #: ../tools/virt-make-fs.pl:577 ../tools/virt-list-partitions.pl:282
24029 msgid ""
24030 "This program is distributed in the hope that it will be useful, but WITHOUT "
24031 "ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or "
24032 "FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for "
24033 "more details."
24034 msgstr ""
24035
24036 # type: textblock
24037 #. type: textblock
24038 #: ../fish/guestfish.pod:1172 ../test-tool/libguestfs-test-tool.pod:134
24039 #: ../fuse/guestmount.pod:280 ../tools/virt-edit.pl:382
24040 #: ../tools/virt-win-reg.pl:616 ../tools/virt-resize.pl:1528
24041 #: ../tools/virt-list-filesystems.pl:220 ../tools/virt-tar.pl:319
24042 #: ../tools/virt-make-fs.pl:582 ../tools/virt-list-partitions.pl:287
24043 msgid ""
24044 "You should have received a copy of the GNU General Public License along with "
24045 "this program; if not, write to the Free Software Foundation, Inc., 675 Mass "
24046 "Ave, Cambridge, MA 02139, USA."
24047 msgstr ""
24048
24049 # type: =head2
24050 #. type: =head2
24051 #: ../fish/guestfish-actions.pod:1
24052 msgid "add-cdrom"
24053 msgstr ""
24054
24055 # type: verbatim
24056 #. type: verbatim
24057 #: ../fish/guestfish-actions.pod:3
24058 #, no-wrap
24059 msgid ""
24060 " add-cdrom filename\n"
24061 "\n"
24062 msgstr ""
24063
24064 # type: textblock
24065 #. type: textblock
24066 #: ../fish/guestfish-actions.pod:15
24067 msgid ""
24068 "This call checks for the existence of C<filename>.  This stops you from "
24069 "specifying other types of drive which are supported by qemu such as C<nbd:> "
24070 "and C<http:> URLs.  To specify those, use the general L</config> call "
24071 "instead."
24072 msgstr ""
24073
24074 # type: textblock
24075 #. type: textblock
24076 #: ../fish/guestfish-actions.pod:22
24077 msgid ""
24078 "If you just want to add an ISO file (often you use this as an efficient way "
24079 "to transfer large files into the guest), then you should probably use L</add-"
24080 "drive-ro> instead."
24081 msgstr ""
24082
24083 # type: =head2
24084 #. type: =head2
24085 #: ../fish/guestfish-actions.pod:35
24086 msgid "add-domain"
24087 msgstr ""
24088
24089 # type: =head2
24090 #. type: =head2
24091 #: ../fish/guestfish-actions.pod:37
24092 msgid "domain"
24093 msgstr ""
24094
24095 #. type: verbatim
24096 #: ../fish/guestfish-actions.pod:39
24097 #, no-wrap
24098 msgid ""
24099 " add-domain dom [libvirturi:..] [readonly:..] [iface:..] [live:..]\n"
24100 "\n"
24101 msgstr ""
24102
24103 # type: textblock
24104 #. type: textblock
24105 #: ../fish/guestfish-actions.pod:41
24106 msgid ""
24107 "This function adds the disk(s) attached to the named libvirt domain C<dom>.  "
24108 "It works by connecting to libvirt, requesting the domain and domain XML from "
24109 "libvirt, parsing it for disks, and calling L</add-drive-opts> on each one."
24110 msgstr ""
24111
24112 # type: textblock
24113 #. type: textblock
24114 #: ../fish/guestfish-actions.pod:71
24115 msgid ""
24116 "The other optional parameters are passed directly through to L</add-drive-"
24117 "opts>."
24118 msgstr ""
24119
24120 # type: textblock
24121 #. type: textblock
24122 #: ../fish/guestfish-actions.pod:74 ../fish/guestfish-actions.pod:138
24123 #: ../fish/guestfish-actions.pod:2981
24124 msgid ""
24125 "This command has one or more optional arguments.  See L</OPTIONAL ARGUMENTS>."
24126 msgstr ""
24127
24128 # type: =head2
24129 #. type: =head2
24130 #: ../fish/guestfish-actions.pod:76
24131 msgid "add-drive"
24132 msgstr ""
24133
24134 # type: verbatim
24135 #. type: verbatim
24136 #: ../fish/guestfish-actions.pod:78
24137 #, no-wrap
24138 msgid ""
24139 " add-drive filename\n"
24140 "\n"
24141 msgstr ""
24142
24143 # type: textblock
24144 #. type: textblock
24145 #: ../fish/guestfish-actions.pod:80
24146 msgid ""
24147 "This function is the equivalent of calling L</add-drive-opts> with no "
24148 "optional parameters, so the disk is added writable, with the format being "
24149 "detected automatically."
24150 msgstr ""
24151
24152 # type: textblock
24153 #. type: textblock
24154 #: ../fish/guestfish-actions.pod:84
24155 msgid ""
24156 "Automatic detection of the format opens you up to a potential security hole "
24157 "when dealing with untrusted raw-format images.  See CVE-2010-3851 and "
24158 "RHBZ#642934.  Specifying the format closes this security hole.  Therefore "
24159 "you should think about replacing calls to this function with calls to L</add-"
24160 "drive-opts>, and specifying the format."
24161 msgstr ""
24162
24163 # type: =head2
24164 #. type: =head2
24165 #: ../fish/guestfish-actions.pod:91
24166 msgid "add-drive-opts"
24167 msgstr ""
24168
24169 # type: =head2
24170 #. type: =head2
24171 #: ../fish/guestfish-actions.pod:93
24172 msgid "add"
24173 msgstr ""
24174
24175 # type: verbatim
24176 #. type: verbatim
24177 #: ../fish/guestfish-actions.pod:95
24178 #, no-wrap
24179 msgid ""
24180 " add-drive-opts filename [readonly:..] [format:..] [iface:..]\n"
24181 "\n"
24182 msgstr ""
24183
24184 # type: textblock
24185 #. type: textblock
24186 #: ../fish/guestfish-actions.pod:122
24187 msgid ""
24188 "This forces the image format.  If you omit this (or use L</add-drive> or L</"
24189 "add-drive-ro>) then the format is automatically detected.  Possible formats "
24190 "include C<raw> and C<qcow2>."
24191 msgstr ""
24192
24193 # type: textblock
24194 #. type: textblock
24195 #: ../fish/guestfish-actions.pod:133
24196 msgid ""
24197 "This rarely-used option lets you emulate the behaviour of the deprecated L</"
24198 "add-drive-with-if> call (q.v.)"
24199 msgstr ""
24200
24201 # type: =head2
24202 #. type: =head2
24203 #: ../fish/guestfish-actions.pod:140
24204 msgid "add-drive-ro"
24205 msgstr ""
24206
24207 # type: =head2
24208 #. type: =head2
24209 #: ../fish/guestfish-actions.pod:142
24210 msgid "add-ro"
24211 msgstr ""
24212
24213 # type: verbatim
24214 #. type: verbatim
24215 #: ../fish/guestfish-actions.pod:144
24216 #, no-wrap
24217 msgid ""
24218 " add-drive-ro filename\n"
24219 "\n"
24220 msgstr ""
24221
24222 # type: textblock
24223 #. type: textblock
24224 #: ../fish/guestfish-actions.pod:146
24225 msgid ""
24226 "This function is the equivalent of calling L</add-drive-opts> with the "
24227 "optional parameter C<GUESTFS_ADD_DRIVE_OPTS_READONLY> set to 1, so the disk "
24228 "is added read-only, with the format being detected automatically."
24229 msgstr ""
24230
24231 # type: =head2
24232 #. type: =head2
24233 #: ../fish/guestfish-actions.pod:151
24234 msgid "add-drive-ro-with-if"
24235 msgstr ""
24236
24237 # type: verbatim
24238 #. type: verbatim
24239 #: ../fish/guestfish-actions.pod:153
24240 #, no-wrap
24241 msgid ""
24242 " add-drive-ro-with-if filename iface\n"
24243 "\n"
24244 msgstr ""
24245
24246 # type: textblock
24247 #. type: textblock
24248 #: ../fish/guestfish-actions.pod:155
24249 msgid ""
24250 "This is the same as L</add-drive-ro> but it allows you to specify the QEMU "
24251 "interface emulation to use at run time."
24252 msgstr ""
24253
24254 # type: =head2
24255 #. type: =head2
24256 #: ../fish/guestfish-actions.pod:165
24257 msgid "add-drive-with-if"
24258 msgstr ""
24259
24260 # type: verbatim
24261 #. type: verbatim
24262 #: ../fish/guestfish-actions.pod:167
24263 #, no-wrap
24264 msgid ""
24265 " add-drive-with-if filename iface\n"
24266 "\n"
24267 msgstr ""
24268
24269 # type: textblock
24270 #. type: textblock
24271 #: ../fish/guestfish-actions.pod:169
24272 msgid ""
24273 "This is the same as L</add-drive> but it allows you to specify the QEMU "
24274 "interface emulation to use at run time."
24275 msgstr ""
24276
24277 # type: =head2
24278 #. type: =head2
24279 #: ../fish/guestfish-actions.pod:179
24280 msgid "aug-clear"
24281 msgstr ""
24282
24283 # type: verbatim
24284 #. type: verbatim
24285 #: ../fish/guestfish-actions.pod:181
24286 #, no-wrap
24287 msgid ""
24288 " aug-clear augpath\n"
24289 "\n"
24290 msgstr ""
24291
24292 # type: =head2
24293 #. type: =head2
24294 #: ../fish/guestfish-actions.pod:186
24295 msgid "aug-close"
24296 msgstr ""
24297
24298 # type: verbatim
24299 #. type: verbatim
24300 #: ../fish/guestfish-actions.pod:188
24301 #, no-wrap
24302 msgid ""
24303 " aug-close\n"
24304 "\n"
24305 msgstr ""
24306
24307 # type: textblock
24308 #. type: textblock
24309 #: ../fish/guestfish-actions.pod:190
24310 msgid ""
24311 "Close the current Augeas handle and free up any resources used by it.  After "
24312 "calling this, you have to call L</aug-init> again before you can use any "
24313 "other Augeas functions."
24314 msgstr ""
24315
24316 # type: =head2
24317 #. type: =head2
24318 #: ../fish/guestfish-actions.pod:195
24319 msgid "aug-defnode"
24320 msgstr ""
24321
24322 # type: verbatim
24323 #. type: verbatim
24324 #: ../fish/guestfish-actions.pod:197
24325 #, no-wrap
24326 msgid ""
24327 " aug-defnode name expr val\n"
24328 "\n"
24329 msgstr ""
24330
24331 # type: textblock
24332 #. type: textblock
24333 #: ../fish/guestfish-actions.pod:202
24334 msgid ""
24335 "If C<expr> evaluates to an empty nodeset, a node is created, equivalent to "
24336 "calling L</aug-set> C<expr>, C<value>.  C<name> will be the nodeset "
24337 "containing that single node."
24338 msgstr ""
24339
24340 # type: =head2
24341 #. type: =head2
24342 #: ../fish/guestfish-actions.pod:210
24343 msgid "aug-defvar"
24344 msgstr ""
24345
24346 # type: verbatim
24347 #. type: verbatim
24348 #: ../fish/guestfish-actions.pod:212
24349 #, no-wrap
24350 msgid ""
24351 " aug-defvar name expr\n"
24352 "\n"
24353 msgstr ""
24354
24355 # type: =head2
24356 #. type: =head2
24357 #: ../fish/guestfish-actions.pod:221
24358 msgid "aug-get"
24359 msgstr ""
24360
24361 # type: verbatim
24362 #. type: verbatim
24363 #: ../fish/guestfish-actions.pod:223
24364 #, no-wrap
24365 msgid ""
24366 " aug-get augpath\n"
24367 "\n"
24368 msgstr ""
24369
24370 # type: =head2
24371 #. type: =head2
24372 #: ../fish/guestfish-actions.pod:228
24373 msgid "aug-init"
24374 msgstr ""
24375
24376 # type: verbatim
24377 #. type: verbatim
24378 #: ../fish/guestfish-actions.pod:230
24379 #, no-wrap
24380 msgid ""
24381 " aug-init root flags\n"
24382 "\n"
24383 msgstr ""
24384
24385 # type: textblock
24386 #. type: textblock
24387 #: ../fish/guestfish-actions.pod:236
24388 msgid "You must call this before using any other L</aug-*> commands."
24389 msgstr ""
24390
24391 # type: textblock
24392 #. type: textblock
24393 #: ../fish/guestfish-actions.pod:271
24394 msgid "Do not load the tree in L</aug-init>."
24395 msgstr ""
24396
24397 # type: textblock
24398 #. type: textblock
24399 #: ../fish/guestfish-actions.pod:275
24400 msgid "To close the handle, you can call L</aug-close>."
24401 msgstr ""
24402
24403 # type: =head2
24404 #. type: =head2
24405 #: ../fish/guestfish-actions.pod:279
24406 msgid "aug-insert"
24407 msgstr ""
24408
24409 # type: verbatim
24410 #. type: verbatim
24411 #: ../fish/guestfish-actions.pod:281
24412 #, no-wrap
24413 msgid ""
24414 " aug-insert augpath label true|false\n"
24415 "\n"
24416 msgstr ""
24417
24418 # type: =head2
24419 #. type: =head2
24420 #: ../fish/guestfish-actions.pod:291
24421 msgid "aug-load"
24422 msgstr ""
24423
24424 # type: verbatim
24425 #. type: verbatim
24426 #: ../fish/guestfish-actions.pod:293
24427 #, no-wrap
24428 msgid ""
24429 " aug-load\n"
24430 "\n"
24431 msgstr ""
24432
24433 # type: =head2
24434 #. type: =head2
24435 #: ../fish/guestfish-actions.pod:300
24436 msgid "aug-ls"
24437 msgstr ""
24438
24439 # type: verbatim
24440 #. type: verbatim
24441 #: ../fish/guestfish-actions.pod:302
24442 #, no-wrap
24443 msgid ""
24444 " aug-ls augpath\n"
24445 "\n"
24446 msgstr ""
24447
24448 # type: textblock
24449 #. type: textblock
24450 #: ../fish/guestfish-actions.pod:304
24451 msgid ""
24452 "This is just a shortcut for listing L</aug-match> C<path/*> and sorting the "
24453 "resulting nodes into alphabetical order."
24454 msgstr ""
24455
24456 # type: =head2
24457 #. type: =head2
24458 #: ../fish/guestfish-actions.pod:307
24459 msgid "aug-match"
24460 msgstr ""
24461
24462 # type: verbatim
24463 #. type: verbatim
24464 #: ../fish/guestfish-actions.pod:309
24465 #, no-wrap
24466 msgid ""
24467 " aug-match augpath\n"
24468 "\n"
24469 msgstr ""
24470
24471 # type: =head2
24472 #. type: =head2
24473 #: ../fish/guestfish-actions.pod:315
24474 msgid "aug-mv"
24475 msgstr ""
24476
24477 # type: verbatim
24478 #. type: verbatim
24479 #: ../fish/guestfish-actions.pod:317
24480 #, no-wrap
24481 msgid ""
24482 " aug-mv src dest\n"
24483 "\n"
24484 msgstr ""
24485
24486 # type: =head2
24487 #. type: =head2
24488 #: ../fish/guestfish-actions.pod:322
24489 msgid "aug-rm"
24490 msgstr ""
24491
24492 # type: verbatim
24493 #. type: verbatim
24494 #: ../fish/guestfish-actions.pod:324
24495 #, no-wrap
24496 msgid ""
24497 " aug-rm augpath\n"
24498 "\n"
24499 msgstr ""
24500
24501 # type: =head2
24502 #. type: =head2
24503 #: ../fish/guestfish-actions.pod:330
24504 msgid "aug-save"
24505 msgstr ""
24506
24507 # type: verbatim
24508 #. type: verbatim
24509 #: ../fish/guestfish-actions.pod:332
24510 #, no-wrap
24511 msgid ""
24512 " aug-save\n"
24513 "\n"
24514 msgstr ""
24515
24516 # type: textblock
24517 #. type: textblock
24518 #: ../fish/guestfish-actions.pod:336
24519 msgid ""
24520 "The flags which were passed to L</aug-init> affect exactly how files are "
24521 "saved."
24522 msgstr ""
24523
24524 # type: =head2
24525 #. type: =head2
24526 #: ../fish/guestfish-actions.pod:339
24527 msgid "aug-set"
24528 msgstr ""
24529
24530 # type: verbatim
24531 #. type: verbatim
24532 #: ../fish/guestfish-actions.pod:341
24533 #, no-wrap
24534 msgid ""
24535 " aug-set augpath val\n"
24536 "\n"
24537 msgstr ""
24538
24539 # type: textblock
24540 #. type: textblock
24541 #: ../fish/guestfish-actions.pod:345
24542 msgid ""
24543 "In the Augeas API, it is possible to clear a node by setting the value to "
24544 "NULL.  Due to an oversight in the libguestfs API you cannot do that with "
24545 "this call.  Instead you must use the L</aug-clear> call."
24546 msgstr ""
24547
24548 # type: =head2
24549 #. type: =head2
24550 #: ../fish/guestfish-actions.pod:350
24551 msgid "available"
24552 msgstr ""
24553
24554 # type: verbatim
24555 #. type: verbatim
24556 #: ../fish/guestfish-actions.pod:352
24557 #, no-wrap
24558 msgid ""
24559 " available 'groups ...'\n"
24560 "\n"
24561 msgstr ""
24562
24563 # type: textblock
24564 #. type: textblock
24565 #: ../fish/guestfish-actions.pod:358
24566 msgid ""
24567 "The libguestfs groups, and the functions that those groups correspond to, "
24568 "are listed in L<guestfs(3)/AVAILABILITY>.  You can also fetch this list at "
24569 "runtime by calling L</available-all-groups>."
24570 msgstr ""
24571
24572 # type: textblock
24573 #. type: textblock
24574 #: ../fish/guestfish-actions.pod:382
24575 msgid "You must call L</launch> before calling this function."
24576 msgstr ""
24577
24578 # type: textblock
24579 #. type: textblock
24580 #: ../fish/guestfish-actions.pod:404
24581 msgid ""
24582 "This call was added in version C<1.0.80>.  In previous versions of "
24583 "libguestfs all you could do would be to speculatively execute a command to "
24584 "find out if the daemon implemented it.  See also L</version>."
24585 msgstr ""
24586
24587 # type: =head2
24588 #. type: =head2
24589 #: ../fish/guestfish-actions.pod:411
24590 msgid "available-all-groups"
24591 msgstr ""
24592
24593 # type: verbatim
24594 #. type: verbatim
24595 #: ../fish/guestfish-actions.pod:413
24596 #, no-wrap
24597 msgid ""
24598 " available-all-groups\n"
24599 "\n"
24600 msgstr ""
24601
24602 # type: textblock
24603 #. type: textblock
24604 #: ../fish/guestfish-actions.pod:415
24605 msgid ""
24606 "This command returns a list of all optional groups that this daemon knows "
24607 "about.  Note this returns both supported and unsupported groups.  To find "
24608 "out which ones the daemon can actually support you have to call L</"
24609 "available> on each member of the returned list."
24610 msgstr ""
24611
24612 # type: textblock
24613 #. type: textblock
24614 #: ../fish/guestfish-actions.pod:421
24615 msgid "See also L</available> and L<guestfs(3)/AVAILABILITY>."
24616 msgstr ""
24617
24618 # type: =head2
24619 #. type: =head2
24620 #: ../fish/guestfish-actions.pod:423
24621 msgid "base64-in"
24622 msgstr ""
24623
24624 # type: verbatim
24625 #. type: verbatim
24626 #: ../fish/guestfish-actions.pod:425
24627 #, no-wrap
24628 msgid ""
24629 " base64-in (base64file|-) filename\n"
24630 "\n"
24631 msgstr ""
24632
24633 # type: textblock
24634 #. type: textblock
24635 #: ../fish/guestfish-actions.pod:430 ../fish/guestfish-actions.pod:439
24636 #: ../fish/guestfish-actions.pod:663 ../fish/guestfish-actions.pod:832
24637 #: ../fish/guestfish-actions.pod:851 ../fish/guestfish-actions.pod:1228
24638 #: ../fish/guestfish-actions.pod:4379 ../fish/guestfish-actions.pod:4391
24639 #: ../fish/guestfish-actions.pod:4402 ../fish/guestfish-actions.pod:4413
24640 #: ../fish/guestfish-actions.pod:4465 ../fish/guestfish-actions.pod:4474
24641 #: ../fish/guestfish-actions.pod:4528 ../fish/guestfish-actions.pod:4551
24642 msgid "Use C<-> instead of a filename to read/write from stdin/stdout."
24643 msgstr ""
24644
24645 # type: =head2
24646 #. type: =head2
24647 #: ../fish/guestfish-actions.pod:432
24648 msgid "base64-out"
24649 msgstr ""
24650
24651 # type: verbatim
24652 #. type: verbatim
24653 #: ../fish/guestfish-actions.pod:434
24654 #, no-wrap
24655 msgid ""
24656 " base64-out filename (base64file|-)\n"
24657 "\n"
24658 msgstr ""
24659
24660 # type: =head2
24661 #. type: =head2
24662 #: ../fish/guestfish-actions.pod:441
24663 msgid "blockdev-flushbufs"
24664 msgstr ""
24665
24666 # type: verbatim
24667 #. type: verbatim
24668 #: ../fish/guestfish-actions.pod:443
24669 #, no-wrap
24670 msgid ""
24671 " blockdev-flushbufs device\n"
24672 "\n"
24673 msgstr ""
24674
24675 # type: =head2
24676 #. type: =head2
24677 #: ../fish/guestfish-actions.pod:450
24678 msgid "blockdev-getbsz"
24679 msgstr ""
24680
24681 # type: verbatim
24682 #. type: verbatim
24683 #: ../fish/guestfish-actions.pod:452
24684 #, no-wrap
24685 msgid ""
24686 " blockdev-getbsz device\n"
24687 "\n"
24688 msgstr ""
24689
24690 # type: =head2
24691 #. type: =head2
24692 #: ../fish/guestfish-actions.pod:461
24693 msgid "blockdev-getro"
24694 msgstr ""
24695
24696 # type: verbatim
24697 #. type: verbatim
24698 #: ../fish/guestfish-actions.pod:463
24699 #, no-wrap
24700 msgid ""
24701 " blockdev-getro device\n"
24702 "\n"
24703 msgstr ""
24704
24705 # type: =head2
24706 #. type: =head2
24707 #: ../fish/guestfish-actions.pod:470
24708 msgid "blockdev-getsize64"
24709 msgstr ""
24710
24711 # type: verbatim
24712 #. type: verbatim
24713 #: ../fish/guestfish-actions.pod:472
24714 #, no-wrap
24715 msgid ""
24716 " blockdev-getsize64 device\n"
24717 "\n"
24718 msgstr ""
24719
24720 # type: textblock
24721 #. type: textblock
24722 #: ../fish/guestfish-actions.pod:476
24723 msgid "See also L</blockdev-getsz>."
24724 msgstr ""
24725
24726 # type: =head2
24727 #. type: =head2
24728 #: ../fish/guestfish-actions.pod:480
24729 msgid "blockdev-getss"
24730 msgstr ""
24731
24732 # type: verbatim
24733 #. type: verbatim
24734 #: ../fish/guestfish-actions.pod:482
24735 #, no-wrap
24736 msgid ""
24737 " blockdev-getss device\n"
24738 "\n"
24739 msgstr ""
24740
24741 # type: textblock
24742 #. type: textblock
24743 #: ../fish/guestfish-actions.pod:487
24744 msgid ""
24745 "(Note, this is not the size in sectors, use L</blockdev-getsz> for that)."
24746 msgstr ""
24747
24748 # type: =head2
24749 #. type: =head2
24750 #: ../fish/guestfish-actions.pod:492
24751 msgid "blockdev-getsz"
24752 msgstr ""
24753
24754 # type: verbatim
24755 #. type: verbatim
24756 #: ../fish/guestfish-actions.pod:494
24757 #, no-wrap
24758 msgid ""
24759 " blockdev-getsz device\n"
24760 "\n"
24761 msgstr ""
24762
24763 # type: textblock
24764 #. type: textblock
24765 #: ../fish/guestfish-actions.pod:499
24766 msgid ""
24767 "See also L</blockdev-getss> for the real sector size of the device, and L</"
24768 "blockdev-getsize64> for the more useful I<size in bytes>."
24769 msgstr ""
24770
24771 # type: =head2
24772 #. type: =head2
24773 #: ../fish/guestfish-actions.pod:505
24774 msgid "blockdev-rereadpt"
24775 msgstr ""
24776
24777 # type: verbatim
24778 #. type: verbatim
24779 #: ../fish/guestfish-actions.pod:507
24780 #, no-wrap
24781 msgid ""
24782 " blockdev-rereadpt device\n"
24783 "\n"
24784 msgstr ""
24785
24786 # type: =head2
24787 #. type: =head2
24788 #: ../fish/guestfish-actions.pod:513
24789 msgid "blockdev-setbsz"
24790 msgstr ""
24791
24792 # type: verbatim
24793 #. type: verbatim
24794 #: ../fish/guestfish-actions.pod:515
24795 #, no-wrap
24796 msgid ""
24797 " blockdev-setbsz device blocksize\n"
24798 "\n"
24799 msgstr ""
24800
24801 # type: =head2
24802 #. type: =head2
24803 #: ../fish/guestfish-actions.pod:524
24804 msgid "blockdev-setro"
24805 msgstr ""
24806
24807 # type: verbatim
24808 #. type: verbatim
24809 #: ../fish/guestfish-actions.pod:526
24810 #, no-wrap
24811 msgid ""
24812 " blockdev-setro device\n"
24813 "\n"
24814 msgstr ""
24815
24816 # type: =head2
24817 #. type: =head2
24818 #: ../fish/guestfish-actions.pod:532
24819 msgid "blockdev-setrw"
24820 msgstr ""
24821
24822 # type: verbatim
24823 #. type: verbatim
24824 #: ../fish/guestfish-actions.pod:534
24825 #, no-wrap
24826 msgid ""
24827 " blockdev-setrw device\n"
24828 "\n"
24829 msgstr ""
24830
24831 # type: =head2
24832 #. type: =head2
24833 #: ../fish/guestfish-actions.pod:540
24834 msgid "case-sensitive-path"
24835 msgstr ""
24836
24837 # type: verbatim
24838 #. type: verbatim
24839 #: ../fish/guestfish-actions.pod:542
24840 #, no-wrap
24841 msgid ""
24842 " case-sensitive-path path\n"
24843 "\n"
24844 msgstr ""
24845
24846 # type: textblock
24847 #. type: textblock
24848 #: ../fish/guestfish-actions.pod:566
24849 msgid ""
24850 "Thus L</case-sensitive-path> (\"/Windows/System32\")  might return C<\"/"
24851 "WINDOWS/system32\"> (the exact return value would depend on details of how "
24852 "the directories were originally created under Windows)."
24853 msgstr ""
24854
24855 # type: textblock
24856 #. type: textblock
24857 #: ../fish/guestfish-actions.pod:574
24858 msgid "See also L</realpath>."
24859 msgstr ""
24860
24861 # type: =head2
24862 #. type: =head2
24863 #: ../fish/guestfish-actions.pod:576
24864 msgid "cat"
24865 msgstr ""
24866
24867 # type: verbatim
24868 #. type: verbatim
24869 #: ../fish/guestfish-actions.pod:578
24870 #, no-wrap
24871 msgid ""
24872 " cat path\n"
24873 "\n"
24874 msgstr ""
24875
24876 # type: textblock
24877 #. type: textblock
24878 #: ../fish/guestfish-actions.pod:582
24879 msgid ""
24880 "Note that this function cannot correctly handle binary files (specifically, "
24881 "files containing C<\\0> character which is treated as end of string).  For "
24882 "those you need to use the L</read-file> or L</download> functions which have "
24883 "a more complex interface."
24884 msgstr ""
24885
24886 # type: =head2
24887 #. type: =head2
24888 #: ../fish/guestfish-actions.pod:590
24889 msgid "checksum"
24890 msgstr ""
24891
24892 # type: verbatim
24893 #. type: verbatim
24894 #: ../fish/guestfish-actions.pod:592
24895 #, no-wrap
24896 msgid ""
24897 " checksum csumtype path\n"
24898 "\n"
24899 msgstr ""
24900
24901 # type: textblock
24902 #. type: textblock
24903 #: ../fish/guestfish-actions.pod:635
24904 msgid "To get the checksum for a device, use L</checksum-device>."
24905 msgstr ""
24906
24907 # type: textblock
24908 #. type: textblock
24909 #: ../fish/guestfish-actions.pod:637
24910 msgid "To get the checksums for many files, use L</checksums-out>."
24911 msgstr ""
24912
24913 # type: =head2
24914 #. type: =head2
24915 #: ../fish/guestfish-actions.pod:639
24916 msgid "checksum-device"
24917 msgstr ""
24918
24919 # type: verbatim
24920 #. type: verbatim
24921 #: ../fish/guestfish-actions.pod:641
24922 #, no-wrap
24923 msgid ""
24924 " checksum-device csumtype device\n"
24925 "\n"
24926 msgstr ""
24927
24928 # type: textblock
24929 #. type: textblock
24930 #: ../fish/guestfish-actions.pod:643
24931 msgid ""
24932 "This call computes the MD5, SHAx or CRC checksum of the contents of the "
24933 "device named C<device>.  For the types of checksums supported see the L</"
24934 "checksum> command."
24935 msgstr ""
24936
24937 # type: =head2
24938 #. type: =head2
24939 #: ../fish/guestfish-actions.pod:647
24940 msgid "checksums-out"
24941 msgstr ""
24942
24943 # type: verbatim
24944 #. type: verbatim
24945 #: ../fish/guestfish-actions.pod:649
24946 #, no-wrap
24947 msgid ""
24948 " checksums-out csumtype directory (sumsfile|-)\n"
24949 "\n"
24950 msgstr ""
24951
24952 # type: =head2
24953 #. type: =head2
24954 #: ../fish/guestfish-actions.pod:665
24955 msgid "chmod"
24956 msgstr ""
24957
24958 # type: verbatim
24959 #. type: verbatim
24960 #: ../fish/guestfish-actions.pod:667
24961 #, no-wrap
24962 msgid ""
24963 " chmod mode path\n"
24964 "\n"
24965 msgstr ""
24966
24967 # type: =head2
24968 #. type: =head2
24969 #: ../fish/guestfish-actions.pod:678
24970 msgid "chown"
24971 msgstr ""
24972
24973 # type: verbatim
24974 #. type: verbatim
24975 #: ../fish/guestfish-actions.pod:680
24976 #, no-wrap
24977 msgid ""
24978 " chown owner group path\n"
24979 "\n"
24980 msgstr ""
24981
24982 # type: =head2
24983 #. type: =head2
24984 #: ../fish/guestfish-actions.pod:688
24985 msgid "command"
24986 msgstr ""
24987
24988 # type: verbatim
24989 #. type: verbatim
24990 #: ../fish/guestfish-actions.pod:690
24991 #, no-wrap
24992 msgid ""
24993 " command 'arguments ...'\n"
24994 "\n"
24995 msgstr ""
24996
24997 # type: textblock
24998 #. type: textblock
24999 #: ../fish/guestfish-actions.pod:697
25000 msgid ""
25001 "The single parameter is an argv-style list of arguments.  The first element "
25002 "is the name of the program to run.  Subsequent elements are parameters.  The "
25003 "list must be non-empty (ie. must contain a program name).  Note that the "
25004 "command runs directly, and is I<not> invoked via the shell (see L</sh>)."
25005 msgstr ""
25006
25007 # type: =head2
25008 #. type: =head2
25009 #: ../fish/guestfish-actions.pod:725
25010 msgid "command-lines"
25011 msgstr ""
25012
25013 # type: verbatim
25014 #. type: verbatim
25015 #: ../fish/guestfish-actions.pod:727
25016 #, no-wrap
25017 msgid ""
25018 " command-lines 'arguments ...'\n"
25019 "\n"
25020 msgstr ""
25021
25022 # type: textblock
25023 #. type: textblock
25024 #: ../fish/guestfish-actions.pod:729
25025 msgid ""
25026 "This is the same as L</command>, but splits the result into a list of lines."
25027 msgstr ""
25028
25029 # type: textblock
25030 #. type: textblock
25031 #: ../fish/guestfish-actions.pod:732
25032 msgid "See also: L</sh-lines>"
25033 msgstr ""
25034
25035 # type: =head2
25036 #. type: =head2
25037 #: ../fish/guestfish-actions.pod:737
25038 msgid "config"
25039 msgstr ""
25040
25041 # type: verbatim
25042 #. type: verbatim
25043 #: ../fish/guestfish-actions.pod:739
25044 #, no-wrap
25045 msgid ""
25046 " config qemuparam qemuvalue\n"
25047 "\n"
25048 msgstr ""
25049
25050 # type: =head2
25051 #. type: =head2
25052 #: ../fish/guestfish-actions.pod:750
25053 msgid "copy-size"
25054 msgstr ""
25055
25056 # type: verbatim
25057 #. type: verbatim
25058 #: ../fish/guestfish-actions.pod:752
25059 #, no-wrap
25060 msgid ""
25061 " copy-size src dest size\n"
25062 "\n"
25063 msgstr ""
25064
25065 # type: =head2
25066 #. type: =head2
25067 #: ../fish/guestfish-actions.pod:760
25068 msgid "cp"
25069 msgstr ""
25070
25071 # type: verbatim
25072 #. type: verbatim
25073 #: ../fish/guestfish-actions.pod:762
25074 #, no-wrap
25075 msgid ""
25076 " cp src dest\n"
25077 "\n"
25078 msgstr ""
25079
25080 # type: =head2
25081 #. type: =head2
25082 #: ../fish/guestfish-actions.pod:767
25083 msgid "cp-a"
25084 msgstr ""
25085
25086 # type: verbatim
25087 #. type: verbatim
25088 #: ../fish/guestfish-actions.pod:769
25089 #, no-wrap
25090 msgid ""
25091 " cp-a src dest\n"
25092 "\n"
25093 msgstr ""
25094
25095 # type: =head2
25096 #. type: =head2
25097 #: ../fish/guestfish-actions.pod:774
25098 msgid "dd"
25099 msgstr ""
25100
25101 # type: verbatim
25102 #. type: verbatim
25103 #: ../fish/guestfish-actions.pod:776
25104 #, no-wrap
25105 msgid ""
25106 " dd src dest\n"
25107 "\n"
25108 msgstr ""
25109
25110 # type: textblock
25111 #. type: textblock
25112 #: ../fish/guestfish-actions.pod:783
25113 msgid ""
25114 "If the destination is a device, it must be as large or larger than the "
25115 "source file or device, otherwise the copy will fail.  This command cannot do "
25116 "partial copies (see L</copy-size>)."
25117 msgstr ""
25118
25119 # type: =head2
25120 #. type: =head2
25121 #: ../fish/guestfish-actions.pod:787
25122 msgid "df"
25123 msgstr ""
25124
25125 # type: verbatim
25126 #. type: verbatim
25127 #: ../fish/guestfish-actions.pod:789
25128 #, no-wrap
25129 msgid ""
25130 " df\n"
25131 "\n"
25132 msgstr ""
25133
25134 # type: textblock
25135 #. type: textblock
25136 #: ../fish/guestfish-actions.pod:793 ../fish/guestfish-actions.pod:804
25137 msgid ""
25138 "This command is mostly useful for interactive sessions.  It is I<not> "
25139 "intended that you try to parse the output string.  Use L</statvfs> from "
25140 "programs."
25141 msgstr ""
25142
25143 # type: =head2
25144 #. type: =head2
25145 #: ../fish/guestfish-actions.pod:797
25146 msgid "df-h"
25147 msgstr ""
25148
25149 # type: verbatim
25150 #. type: verbatim
25151 #: ../fish/guestfish-actions.pod:799
25152 #, no-wrap
25153 msgid ""
25154 " df-h\n"
25155 "\n"
25156 msgstr ""
25157
25158 # type: =head2
25159 #. type: =head2
25160 #: ../fish/guestfish-actions.pod:808
25161 msgid "dmesg"
25162 msgstr ""
25163
25164 # type: verbatim
25165 #. type: verbatim
25166 #: ../fish/guestfish-actions.pod:810
25167 #, no-wrap
25168 msgid ""
25169 " dmesg\n"
25170 "\n"
25171 msgstr ""
25172
25173 # type: textblock
25174 #. type: textblock
25175 #: ../fish/guestfish-actions.pod:816
25176 msgid ""
25177 "Another way to get the same information is to enable verbose messages with "
25178 "L</set-verbose> or by setting the environment variable C<LIBGUESTFS_DEBUG=1> "
25179 "before running the program."
25180 msgstr ""
25181
25182 # type: =head2
25183 #. type: =head2
25184 #: ../fish/guestfish-actions.pod:821
25185 msgid "download"
25186 msgstr ""
25187
25188 # type: verbatim
25189 #. type: verbatim
25190 #: ../fish/guestfish-actions.pod:823
25191 #, no-wrap
25192 msgid ""
25193 " download remotefilename (filename|-)\n"
25194 "\n"
25195 msgstr ""
25196
25197 # type: textblock
25198 #. type: textblock
25199 #: ../fish/guestfish-actions.pod:830
25200 msgid "See also L</upload>, L</cat>."
25201 msgstr ""
25202
25203 # type: =head2
25204 #. type: =head2
25205 #: ../fish/guestfish-actions.pod:834
25206 msgid "download-offset"
25207 msgstr ""
25208
25209 # type: verbatim
25210 #. type: verbatim
25211 #: ../fish/guestfish-actions.pod:836
25212 #, no-wrap
25213 msgid ""
25214 " download-offset remotefilename (filename|-) offset size\n"
25215 "\n"
25216 msgstr ""
25217
25218 # type: textblock
25219 #. type: textblock
25220 #: ../fish/guestfish-actions.pod:844
25221 msgid ""
25222 "Note that there is no limit on the amount of data that can be downloaded "
25223 "with this call, unlike with L</pread>, and this call always reads the full "
25224 "amount unless an error occurs."
25225 msgstr ""
25226
25227 # type: textblock
25228 #. type: textblock
25229 #: ../fish/guestfish-actions.pod:849
25230 msgid "See also L</download>, L</pread>."
25231 msgstr ""
25232
25233 # type: =head2
25234 #. type: =head2
25235 #: ../fish/guestfish-actions.pod:853
25236 msgid "drop-caches"
25237 msgstr ""
25238
25239 # type: verbatim
25240 #. type: verbatim
25241 #: ../fish/guestfish-actions.pod:855
25242 #, no-wrap
25243 msgid ""
25244 " drop-caches whattodrop\n"
25245 "\n"
25246 msgstr ""
25247
25248 # type: =head2
25249 #. type: =head2
25250 #: ../fish/guestfish-actions.pod:867
25251 msgid "du"
25252 msgstr ""
25253
25254 # type: verbatim
25255 #. type: verbatim
25256 #: ../fish/guestfish-actions.pod:869
25257 #, no-wrap
25258 msgid ""
25259 " du path\n"
25260 "\n"
25261 msgstr ""
25262
25263 # type: =head2
25264 #. type: =head2
25265 #: ../fish/guestfish-actions.pod:881
25266 msgid "e2fsck-f"
25267 msgstr ""
25268
25269 # type: verbatim
25270 #. type: verbatim
25271 #: ../fish/guestfish-actions.pod:883
25272 #, no-wrap
25273 msgid ""
25274 " e2fsck-f device\n"
25275 "\n"
25276 msgstr ""
25277
25278 # type: textblock
25279 #. type: textblock
25280 #: ../fish/guestfish-actions.pod:889
25281 msgid ""
25282 "This command is only needed because of L</resize2fs> (q.v.).  Normally you "
25283 "should use L</fsck>."
25284 msgstr ""
25285
25286 # type: =head2
25287 #. type: =head2
25288 #: ../fish/guestfish-actions.pod:892
25289 msgid "echo-daemon"
25290 msgstr ""
25291
25292 # type: verbatim
25293 #. type: verbatim
25294 #: ../fish/guestfish-actions.pod:894
25295 #, no-wrap
25296 msgid ""
25297 " echo-daemon 'words ...'\n"
25298 "\n"
25299 msgstr ""
25300
25301 # type: textblock
25302 #. type: textblock
25303 #: ../fish/guestfish-actions.pod:901
25304 msgid "See also L</ping-daemon>."
25305 msgstr ""
25306
25307 # type: =head2
25308 #. type: =head2
25309 #: ../fish/guestfish-actions.pod:903
25310 msgid "egrep"
25311 msgstr ""
25312
25313 # type: verbatim
25314 #. type: verbatim
25315 #: ../fish/guestfish-actions.pod:905
25316 #, no-wrap
25317 msgid ""
25318 " egrep regex path\n"
25319 "\n"
25320 msgstr ""
25321
25322 # type: =head2
25323 #. type: =head2
25324 #: ../fish/guestfish-actions.pod:913
25325 msgid "egrepi"
25326 msgstr ""
25327
25328 # type: verbatim
25329 #. type: verbatim
25330 #: ../fish/guestfish-actions.pod:915
25331 #, no-wrap
25332 msgid ""
25333 " egrepi regex path\n"
25334 "\n"
25335 msgstr ""
25336
25337 # type: =head2
25338 #. type: =head2
25339 #: ../fish/guestfish-actions.pod:923
25340 msgid "equal"
25341 msgstr ""
25342
25343 # type: verbatim
25344 #. type: verbatim
25345 #: ../fish/guestfish-actions.pod:925
25346 #, no-wrap
25347 msgid ""
25348 " equal file1 file2\n"
25349 "\n"
25350 msgstr ""
25351
25352 # type: =head2
25353 #. type: =head2
25354 #: ../fish/guestfish-actions.pod:932
25355 msgid "exists"
25356 msgstr ""
25357
25358 # type: verbatim
25359 #. type: verbatim
25360 #: ../fish/guestfish-actions.pod:934
25361 #, no-wrap
25362 msgid ""
25363 " exists path\n"
25364 "\n"
25365 msgstr ""
25366
25367 # type: textblock
25368 #. type: textblock
25369 #: ../fish/guestfish-actions.pod:939
25370 msgid "See also L</is-file>, L</is-dir>, L</stat>."
25371 msgstr ""
25372
25373 # type: =head2
25374 #. type: =head2
25375 #: ../fish/guestfish-actions.pod:941
25376 msgid "fallocate"
25377 msgstr ""
25378
25379 # type: verbatim
25380 #. type: verbatim
25381 #: ../fish/guestfish-actions.pod:943
25382 #, no-wrap
25383 msgid ""
25384 " fallocate path len\n"
25385 "\n"
25386 msgstr ""
25387
25388 # type: =head2
25389 #. type: =head2
25390 #: ../fish/guestfish-actions.pod:960
25391 msgid "fallocate64"
25392 msgstr ""
25393
25394 # type: verbatim
25395 #. type: verbatim
25396 #: ../fish/guestfish-actions.pod:962
25397 #, no-wrap
25398 msgid ""
25399 " fallocate64 path len\n"
25400 "\n"
25401 msgstr ""
25402
25403 # type: textblock
25404 #. type: textblock
25405 #: ../fish/guestfish-actions.pod:968
25406 msgid ""
25407 "Note that this call allocates disk blocks for the file.  To create a sparse "
25408 "file use L</truncate-size> instead."
25409 msgstr ""
25410
25411 # type: textblock
25412 #. type: textblock
25413 #: ../fish/guestfish-actions.pod:971
25414 msgid ""
25415 "The deprecated call L</fallocate> does the same, but owing to an oversight "
25416 "it only allowed 30 bit lengths to be specified, effectively limiting the "
25417 "maximum size of files created through that call to 1GB."
25418 msgstr ""
25419
25420 # type: =head2
25421 #. type: =head2
25422 #: ../fish/guestfish-actions.pod:980
25423 msgid "fgrep"
25424 msgstr ""
25425
25426 # type: verbatim
25427 #. type: verbatim
25428 #: ../fish/guestfish-actions.pod:982
25429 #, no-wrap
25430 msgid ""
25431 " fgrep pattern path\n"
25432 "\n"
25433 msgstr ""
25434
25435 # type: =head2
25436 #. type: =head2
25437 #: ../fish/guestfish-actions.pod:990
25438 msgid "fgrepi"
25439 msgstr ""
25440
25441 # type: verbatim
25442 #. type: verbatim
25443 #: ../fish/guestfish-actions.pod:992
25444 #, no-wrap
25445 msgid ""
25446 " fgrepi pattern path\n"
25447 "\n"
25448 msgstr ""
25449
25450 # type: =head2
25451 #. type: =head2
25452 #: ../fish/guestfish-actions.pod:1000
25453 msgid "file"
25454 msgstr ""
25455
25456 # type: verbatim
25457 #. type: verbatim
25458 #: ../fish/guestfish-actions.pod:1002
25459 #, no-wrap
25460 msgid ""
25461 " file path\n"
25462 "\n"
25463 msgstr ""
25464
25465 # type: textblock
25466 #. type: textblock
25467 #: ../fish/guestfish-actions.pod:1014
25468 msgid ""
25469 "This command can also be used on C</dev/> devices (and partitions, LV "
25470 "names).  You can for example use this to determine if a device contains a "
25471 "filesystem, although it's usually better to use L</vfs-type>."
25472 msgstr ""
25473
25474 # type: =head2
25475 #. type: =head2
25476 #: ../fish/guestfish-actions.pod:1024
25477 msgid "file-architecture"
25478 msgstr ""
25479
25480 # type: verbatim
25481 #. type: verbatim
25482 #: ../fish/guestfish-actions.pod:1026
25483 #, no-wrap
25484 msgid ""
25485 " file-architecture filename\n"
25486 "\n"
25487 msgstr ""
25488
25489 # type: =head2
25490 #. type: =head2
25491 #: ../fish/guestfish-actions.pod:1129
25492 msgid "filesize"
25493 msgstr ""
25494
25495 # type: verbatim
25496 #. type: verbatim
25497 #: ../fish/guestfish-actions.pod:1131
25498 #, no-wrap
25499 msgid ""
25500 " filesize file\n"
25501 "\n"
25502 msgstr ""
25503
25504 # type: textblock
25505 #. type: textblock
25506 #: ../fish/guestfish-actions.pod:1135
25507 msgid ""
25508 "To get other stats about a file, use L</stat>, L</lstat>, L</is-dir>, L</is-"
25509 "file> etc.  To get the size of block devices, use L</blockdev-getsize64>."
25510 msgstr ""
25511
25512 # type: =head2
25513 #. type: =head2
25514 #: ../fish/guestfish-actions.pod:1139
25515 msgid "fill"
25516 msgstr ""
25517
25518 # type: verbatim
25519 #. type: verbatim
25520 #: ../fish/guestfish-actions.pod:1141
25521 #, no-wrap
25522 msgid ""
25523 " fill c len path\n"
25524 "\n"
25525 msgstr ""
25526
25527 # type: textblock
25528 #. type: textblock
25529 #: ../fish/guestfish-actions.pod:1147
25530 msgid ""
25531 "To fill a file with zero bytes (sparsely), it is much more efficient to use "
25532 "L</truncate-size>.  To create a file with a pattern of repeating bytes use "
25533 "L</fill-pattern>."
25534 msgstr ""
25535
25536 # type: =head2
25537 #. type: =head2
25538 #: ../fish/guestfish-actions.pod:1152
25539 msgid "fill-pattern"
25540 msgstr ""
25541
25542 # type: verbatim
25543 #. type: verbatim
25544 #: ../fish/guestfish-actions.pod:1154
25545 #, no-wrap
25546 msgid ""
25547 " fill-pattern pattern len path\n"
25548 "\n"
25549 msgstr ""
25550
25551 # type: textblock
25552 #. type: textblock
25553 #: ../fish/guestfish-actions.pod:1156
25554 msgid ""
25555 "This function is like L</fill> except that it creates a new file of length "
25556 "C<len> containing the repeating pattern of bytes in C<pattern>.  The pattern "
25557 "is truncated if necessary to ensure the length of the file is exactly C<len> "
25558 "bytes."
25559 msgstr ""
25560
25561 # type: =head2
25562 #. type: =head2
25563 #: ../fish/guestfish-actions.pod:1161
25564 msgid "find"
25565 msgstr ""
25566
25567 # type: verbatim
25568 #. type: verbatim
25569 #: ../fish/guestfish-actions.pod:1163
25570 #, no-wrap
25571 msgid ""
25572 " find directory\n"
25573 "\n"
25574 msgstr ""
25575
25576 # type: textblock
25577 #. type: textblock
25578 #: ../fish/guestfish-actions.pod:1177
25579 msgid "then the returned list from L</find> C</tmp> would be 4 elements:"
25580 msgstr ""
25581
25582 # type: textblock
25583 #. type: textblock
25584 #: ../fish/guestfish-actions.pod:1190
25585 msgid "See also L</find0>."
25586 msgstr ""
25587
25588 # type: =head2
25589 #. type: =head2
25590 #: ../fish/guestfish-actions.pod:1195
25591 msgid "find0"
25592 msgstr ""
25593
25594 # type: verbatim
25595 #. type: verbatim
25596 #: ../fish/guestfish-actions.pod:1197
25597 #, no-wrap
25598 msgid ""
25599 " find0 directory (files|-)\n"
25600 "\n"
25601 msgstr ""
25602
25603 # type: textblock
25604 #. type: textblock
25605 #: ../fish/guestfish-actions.pod:1203
25606 msgid ""
25607 "This command works the same way as L</find> with the following exceptions:"
25608 msgstr ""
25609
25610 # type: =head2
25611 #. type: =head2
25612 #: ../fish/guestfish-actions.pod:1230
25613 msgid "findfs-label"
25614 msgstr ""
25615
25616 # type: verbatim
25617 #. type: verbatim
25618 #: ../fish/guestfish-actions.pod:1232
25619 #, no-wrap
25620 msgid ""
25621 " findfs-label label\n"
25622 "\n"
25623 msgstr ""
25624
25625 # type: textblock
25626 #. type: textblock
25627 #: ../fish/guestfish-actions.pod:1238
25628 msgid "To find the label of a filesystem, use L</vfs-label>."
25629 msgstr ""
25630
25631 # type: =head2
25632 #. type: =head2
25633 #: ../fish/guestfish-actions.pod:1240
25634 msgid "findfs-uuid"
25635 msgstr ""
25636
25637 # type: verbatim
25638 #. type: verbatim
25639 #: ../fish/guestfish-actions.pod:1242
25640 #, no-wrap
25641 msgid ""
25642 " findfs-uuid uuid\n"
25643 "\n"
25644 msgstr ""
25645
25646 # type: textblock
25647 #. type: textblock
25648 #: ../fish/guestfish-actions.pod:1248
25649 msgid "To find the UUID of a filesystem, use L</vfs-uuid>."
25650 msgstr ""
25651
25652 # type: =head2
25653 #. type: =head2
25654 #: ../fish/guestfish-actions.pod:1250
25655 msgid "fsck"
25656 msgstr ""
25657
25658 # type: verbatim
25659 #. type: verbatim
25660 #: ../fish/guestfish-actions.pod:1252
25661 #, no-wrap
25662 msgid ""
25663 " fsck fstype device\n"
25664 "\n"
25665 msgstr ""
25666
25667 # type: =head2
25668 #. type: =head2
25669 #: ../fish/guestfish-actions.pod:1282
25670 msgid "get-append"
25671 msgstr ""
25672
25673 # type: verbatim
25674 #. type: verbatim
25675 #: ../fish/guestfish-actions.pod:1284
25676 #, no-wrap
25677 msgid ""
25678 " get-append\n"
25679 "\n"
25680 msgstr ""
25681
25682 #. type: =head2
25683 #: ../fish/guestfish-actions.pod:1291
25684 msgid "get-attach-method"
25685 msgstr ""
25686
25687 #. type: verbatim
25688 #: ../fish/guestfish-actions.pod:1293
25689 #, no-wrap
25690 msgid ""
25691 " get-attach-method\n"
25692 "\n"
25693 msgstr ""
25694
25695 #. type: textblock
25696 #: ../fish/guestfish-actions.pod:1295
25697 msgid "Return the current attach method.  See L</set-attach-method>."
25698 msgstr ""
25699
25700 # type: =head2
25701 #. type: =head2
25702 #: ../fish/guestfish-actions.pod:1297
25703 msgid "get-autosync"
25704 msgstr ""
25705
25706 # type: verbatim
25707 #. type: verbatim
25708 #: ../fish/guestfish-actions.pod:1299
25709 #, no-wrap
25710 msgid ""
25711 " get-autosync\n"
25712 "\n"
25713 msgstr ""
25714
25715 # type: =head2
25716 #. type: =head2
25717 #: ../fish/guestfish-actions.pod:1303
25718 msgid "get-direct"
25719 msgstr ""
25720
25721 # type: verbatim
25722 #. type: verbatim
25723 #: ../fish/guestfish-actions.pod:1305
25724 #, no-wrap
25725 msgid ""
25726 " get-direct\n"
25727 "\n"
25728 msgstr ""
25729
25730 # type: =head2
25731 #. type: =head2
25732 #: ../fish/guestfish-actions.pod:1309
25733 msgid "get-e2label"
25734 msgstr ""
25735
25736 # type: verbatim
25737 #. type: verbatim
25738 #: ../fish/guestfish-actions.pod:1311
25739 #, no-wrap
25740 msgid ""
25741 " get-e2label device\n"
25742 "\n"
25743 msgstr ""
25744
25745 # type: =head2
25746 #. type: =head2
25747 #: ../fish/guestfish-actions.pod:1323
25748 msgid "get-e2uuid"
25749 msgstr ""
25750
25751 # type: verbatim
25752 #. type: verbatim
25753 #: ../fish/guestfish-actions.pod:1325
25754 #, no-wrap
25755 msgid ""
25756 " get-e2uuid device\n"
25757 "\n"
25758 msgstr ""
25759
25760 # type: =head2
25761 #. type: =head2
25762 #: ../fish/guestfish-actions.pod:1337
25763 msgid "get-memsize"
25764 msgstr ""
25765
25766 # type: verbatim
25767 #. type: verbatim
25768 #: ../fish/guestfish-actions.pod:1339
25769 #, no-wrap
25770 msgid ""
25771 " get-memsize\n"
25772 "\n"
25773 msgstr ""
25774
25775 # type: textblock
25776 #. type: textblock
25777 #: ../fish/guestfish-actions.pod:1344
25778 msgid ""
25779 "If L</set-memsize> was not called on this handle, and if "
25780 "C<LIBGUESTFS_MEMSIZE> was not set, then this returns the compiled-in default "
25781 "value for memsize."
25782 msgstr ""
25783
25784 # type: =head2
25785 #. type: =head2
25786 #: ../fish/guestfish-actions.pod:1351
25787 msgid "get-network"
25788 msgstr ""
25789
25790 # type: verbatim
25791 #. type: verbatim
25792 #: ../fish/guestfish-actions.pod:1353
25793 #, no-wrap
25794 msgid ""
25795 " get-network\n"
25796 "\n"
25797 msgstr ""
25798
25799 # type: =head2
25800 #. type: =head2
25801 #: ../fish/guestfish-actions.pod:1357
25802 msgid "get-path"
25803 msgstr ""
25804
25805 # type: verbatim
25806 #. type: verbatim
25807 #: ../fish/guestfish-actions.pod:1359
25808 #, no-wrap
25809 msgid ""
25810 " get-path\n"
25811 "\n"
25812 msgstr ""
25813
25814 # type: =head2
25815 #. type: =head2
25816 #: ../fish/guestfish-actions.pod:1366
25817 msgid "get-pid"
25818 msgstr ""
25819
25820 # type: =head2
25821 #. type: =head2
25822 #: ../fish/guestfish-actions.pod:1368
25823 msgid "pid"
25824 msgstr ""
25825
25826 # type: verbatim
25827 #. type: verbatim
25828 #: ../fish/guestfish-actions.pod:1370
25829 #, no-wrap
25830 msgid ""
25831 " get-pid\n"
25832 "\n"
25833 msgstr ""
25834
25835 # type: =head2
25836 #. type: =head2
25837 #: ../fish/guestfish-actions.pod:1377
25838 msgid "get-qemu"
25839 msgstr ""
25840
25841 # type: verbatim
25842 #. type: verbatim
25843 #: ../fish/guestfish-actions.pod:1379
25844 #, no-wrap
25845 msgid ""
25846 " get-qemu\n"
25847 "\n"
25848 msgstr ""
25849
25850 # type: =head2
25851 #. type: =head2
25852 #: ../fish/guestfish-actions.pod:1386
25853 msgid "get-recovery-proc"
25854 msgstr ""
25855
25856 # type: verbatim
25857 #. type: verbatim
25858 #: ../fish/guestfish-actions.pod:1388
25859 #, no-wrap
25860 msgid ""
25861 " get-recovery-proc\n"
25862 "\n"
25863 msgstr ""
25864
25865 # type: =head2
25866 #. type: =head2
25867 #: ../fish/guestfish-actions.pod:1392
25868 msgid "get-selinux"
25869 msgstr ""
25870
25871 # type: verbatim
25872 #. type: verbatim
25873 #: ../fish/guestfish-actions.pod:1394
25874 #, no-wrap
25875 msgid ""
25876 " get-selinux\n"
25877 "\n"
25878 msgstr ""
25879
25880 # type: textblock
25881 #. type: textblock
25882 #: ../fish/guestfish-actions.pod:1396
25883 msgid ""
25884 "This returns the current setting of the selinux flag which is passed to the "
25885 "appliance at boot time.  See L</set-selinux>."
25886 msgstr ""
25887
25888 # type: =head2
25889 #. type: =head2
25890 #: ../fish/guestfish-actions.pod:1402
25891 msgid "get-state"
25892 msgstr ""
25893
25894 # type: verbatim
25895 #. type: verbatim
25896 #: ../fish/guestfish-actions.pod:1404
25897 #, no-wrap
25898 msgid ""
25899 " get-state\n"
25900 "\n"
25901 msgstr ""
25902
25903 # type: =head2
25904 #. type: =head2
25905 #: ../fish/guestfish-actions.pod:1411
25906 msgid "get-trace"
25907 msgstr ""
25908
25909 # type: verbatim
25910 #. type: verbatim
25911 #: ../fish/guestfish-actions.pod:1413
25912 #, no-wrap
25913 msgid ""
25914 " get-trace\n"
25915 "\n"
25916 msgstr ""
25917
25918 # type: =head2
25919 #. type: =head2
25920 #: ../fish/guestfish-actions.pod:1417
25921 msgid "get-umask"
25922 msgstr ""
25923
25924 # type: verbatim
25925 #. type: verbatim
25926 #: ../fish/guestfish-actions.pod:1419
25927 #, no-wrap
25928 msgid ""
25929 " get-umask\n"
25930 "\n"
25931 msgstr ""
25932
25933 # type: textblock
25934 #. type: textblock
25935 #: ../fish/guestfish-actions.pod:1421
25936 msgid ""
25937 "Return the current umask.  By default the umask is C<022> unless it has been "
25938 "set by calling L</umask>."
25939 msgstr ""
25940
25941 # type: =head2
25942 #. type: =head2
25943 #: ../fish/guestfish-actions.pod:1424
25944 msgid "get-verbose"
25945 msgstr ""
25946
25947 # type: verbatim
25948 #. type: verbatim
25949 #: ../fish/guestfish-actions.pod:1426
25950 #, no-wrap
25951 msgid ""
25952 " get-verbose\n"
25953 "\n"
25954 msgstr ""
25955
25956 # type: =head2
25957 #. type: =head2
25958 #: ../fish/guestfish-actions.pod:1430
25959 msgid "getcon"
25960 msgstr ""
25961
25962 # type: verbatim
25963 #. type: verbatim
25964 #: ../fish/guestfish-actions.pod:1432
25965 #, no-wrap
25966 msgid ""
25967 " getcon\n"
25968 "\n"
25969 msgstr ""
25970
25971 # type: textblock
25972 #. type: textblock
25973 #: ../fish/guestfish-actions.pod:1436
25974 msgid "See the documentation about SELINUX in L<guestfs(3)>, and L</setcon>"
25975 msgstr ""
25976
25977 # type: =head2
25978 #. type: =head2
25979 #: ../fish/guestfish-actions.pod:1439
25980 msgid "getxattr"
25981 msgstr ""
25982
25983 # type: verbatim
25984 #. type: verbatim
25985 #: ../fish/guestfish-actions.pod:1441
25986 #, no-wrap
25987 msgid ""
25988 " getxattr path name\n"
25989 "\n"
25990 msgstr ""
25991
25992 # type: textblock
25993 #. type: textblock
25994 #: ../fish/guestfish-actions.pod:1443
25995 msgid ""
25996 "Get a single extended attribute from file C<path> named C<name>.  This call "
25997 "follows symlinks.  If you want to lookup an extended attribute for the "
25998 "symlink itself, use L</lgetxattr>."
25999 msgstr ""
26000
26001 # type: textblock
26002 #. type: textblock
26003 #: ../fish/guestfish-actions.pod:1447 ../fish/guestfish-actions.pod:2387
26004 msgid ""
26005 "Normally it is better to get all extended attributes from a file in one go "
26006 "by calling L</getxattrs>.  However some Linux filesystem implementations are "
26007 "buggy and do not provide a way to list out attributes.  For these "
26008 "filesystems (notably ntfs-3g)  you have to know the names of the extended "
26009 "attributes you want in advance and call this function."
26010 msgstr ""
26011
26012 # type: textblock
26013 #. type: textblock
26014 #: ../fish/guestfish-actions.pod:1457
26015 msgid "See also: L</getxattrs>, L</lgetxattr>, L<attr(5)>."
26016 msgstr ""
26017
26018 # type: =head2
26019 #. type: =head2
26020 #: ../fish/guestfish-actions.pod:1459
26021 msgid "getxattrs"
26022 msgstr ""
26023
26024 # type: verbatim
26025 #. type: verbatim
26026 #: ../fish/guestfish-actions.pod:1461
26027 #, no-wrap
26028 msgid ""
26029 " getxattrs path\n"
26030 "\n"
26031 msgstr ""
26032
26033 # type: textblock
26034 #. type: textblock
26035 #: ../fish/guestfish-actions.pod:1469
26036 msgid "See also: L</lgetxattrs>, L<attr(5)>."
26037 msgstr ""
26038
26039 # type: =head2
26040 #. type: =head2
26041 #: ../fish/guestfish-actions.pod:1471
26042 msgid "glob-expand"
26043 msgstr ""
26044
26045 # type: verbatim
26046 #. type: verbatim
26047 #: ../fish/guestfish-actions.pod:1473
26048 #, no-wrap
26049 msgid ""
26050 " glob-expand pattern\n"
26051 "\n"
26052 msgstr ""
26053
26054 # type: =head2
26055 #. type: =head2
26056 #: ../fish/guestfish-actions.pod:1486
26057 msgid "grep"
26058 msgstr ""
26059
26060 # type: verbatim
26061 #. type: verbatim
26062 #: ../fish/guestfish-actions.pod:1488
26063 #, no-wrap
26064 msgid ""
26065 " grep regex path\n"
26066 "\n"
26067 msgstr ""
26068
26069 # type: =head2
26070 #. type: =head2
26071 #: ../fish/guestfish-actions.pod:1496
26072 msgid "grepi"
26073 msgstr ""
26074
26075 # type: verbatim
26076 #. type: verbatim
26077 #: ../fish/guestfish-actions.pod:1498
26078 #, no-wrap
26079 msgid ""
26080 " grepi regex path\n"
26081 "\n"
26082 msgstr ""
26083
26084 # type: =head2
26085 #. type: =head2
26086 #: ../fish/guestfish-actions.pod:1506
26087 msgid "grub-install"
26088 msgstr ""
26089
26090 # type: verbatim
26091 #. type: verbatim
26092 #: ../fish/guestfish-actions.pod:1508
26093 #, no-wrap
26094 msgid ""
26095 " grub-install root device\n"
26096 "\n"
26097 msgstr ""
26098
26099 # type: =head2
26100 #. type: =head2
26101 #: ../fish/guestfish-actions.pod:1524
26102 msgid "head"
26103 msgstr ""
26104
26105 # type: verbatim
26106 #. type: verbatim
26107 #: ../fish/guestfish-actions.pod:1526
26108 #, no-wrap
26109 msgid ""
26110 " head path\n"
26111 "\n"
26112 msgstr ""
26113
26114 # type: =head2
26115 #. type: =head2
26116 #: ../fish/guestfish-actions.pod:1534
26117 msgid "head-n"
26118 msgstr ""
26119
26120 # type: verbatim
26121 #. type: verbatim
26122 #: ../fish/guestfish-actions.pod:1536
26123 #, no-wrap
26124 msgid ""
26125 " head-n nrlines path\n"
26126 "\n"
26127 msgstr ""
26128
26129 # type: =head2
26130 #. type: =head2
26131 #: ../fish/guestfish-actions.pod:1549
26132 msgid "hexdump"
26133 msgstr ""
26134
26135 # type: verbatim
26136 #. type: verbatim
26137 #: ../fish/guestfish-actions.pod:1551
26138 #, no-wrap
26139 msgid ""
26140 " hexdump path\n"
26141 "\n"
26142 msgstr ""
26143
26144 # type: =head2
26145 #. type: =head2
26146 #: ../fish/guestfish-actions.pod:1559
26147 msgid "initrd-cat"
26148 msgstr ""
26149
26150 # type: verbatim
26151 #. type: verbatim
26152 #: ../fish/guestfish-actions.pod:1561
26153 #, no-wrap
26154 msgid ""
26155 " initrd-cat initrdpath filename\n"
26156 "\n"
26157 msgstr ""
26158
26159 # type: textblock
26160 #. type: textblock
26161 #: ../fish/guestfish-actions.pod:1573
26162 msgid "See also L</initrd-list>."
26163 msgstr ""
26164
26165 # type: =head2
26166 #. type: =head2
26167 #: ../fish/guestfish-actions.pod:1578
26168 msgid "initrd-list"
26169 msgstr ""
26170
26171 # type: verbatim
26172 #. type: verbatim
26173 #: ../fish/guestfish-actions.pod:1580
26174 #, no-wrap
26175 msgid ""
26176 " initrd-list path\n"
26177 "\n"
26178 msgstr ""
26179
26180 # type: =head2
26181 #. type: =head2
26182 #: ../fish/guestfish-actions.pod:1592
26183 msgid "inotify-add-watch"
26184 msgstr ""
26185
26186 # type: verbatim
26187 #. type: verbatim
26188 #: ../fish/guestfish-actions.pod:1594
26189 #, no-wrap
26190 msgid ""
26191 " inotify-add-watch path mask\n"
26192 "\n"
26193 msgstr ""
26194
26195 # type: =head2
26196 #. type: =head2
26197 #: ../fish/guestfish-actions.pod:1606
26198 msgid "inotify-close"
26199 msgstr ""
26200
26201 # type: verbatim
26202 #. type: verbatim
26203 #: ../fish/guestfish-actions.pod:1608
26204 #, no-wrap
26205 msgid ""
26206 " inotify-close\n"
26207 "\n"
26208 msgstr ""
26209
26210 # type: =head2
26211 #. type: =head2
26212 #: ../fish/guestfish-actions.pod:1614
26213 msgid "inotify-files"
26214 msgstr ""
26215
26216 # type: verbatim
26217 #. type: verbatim
26218 #: ../fish/guestfish-actions.pod:1616
26219 #, no-wrap
26220 msgid ""
26221 " inotify-files\n"
26222 "\n"
26223 msgstr ""
26224
26225 # type: textblock
26226 #. type: textblock
26227 #: ../fish/guestfish-actions.pod:1618
26228 msgid ""
26229 "This function is a helpful wrapper around L</inotify-read> which just "
26230 "returns a list of pathnames of objects that were touched.  The returned "
26231 "pathnames are sorted and deduplicated."
26232 msgstr ""
26233
26234 # type: =head2
26235 #. type: =head2
26236 #: ../fish/guestfish-actions.pod:1622
26237 msgid "inotify-init"
26238 msgstr ""
26239
26240 # type: verbatim
26241 #. type: verbatim
26242 #: ../fish/guestfish-actions.pod:1624
26243 #, no-wrap
26244 msgid ""
26245 " inotify-init maxevents\n"
26246 "\n"
26247 msgstr ""
26248
26249 # type: textblock
26250 #. type: textblock
26251 #: ../fish/guestfish-actions.pod:1630
26252 msgid ""
26253 "C<maxevents> is the maximum number of events which will be queued up between "
26254 "calls to L</inotify-read> or L</inotify-files>.  If this is passed as C<0>, "
26255 "then the kernel (or previously set)  default is used.  For Linux 2.6.29 the "
26256 "default was 16384 events.  Beyond this limit, the kernel throws away events, "
26257 "but records the fact that it threw them away by setting a flag "
26258 "C<IN_Q_OVERFLOW> in the returned structure list (see L</inotify-read>)."
26259 msgstr ""
26260
26261 # type: textblock
26262 #. type: textblock
26263 #: ../fish/guestfish-actions.pod:1640
26264 msgid ""
26265 "Before any events are generated, you have to add some watches to the "
26266 "internal watch list.  See: L</inotify-add-watch>, L</inotify-rm-watch> and "
26267 "L</inotify-watch-all>."
26268 msgstr ""
26269
26270 # type: textblock
26271 #. type: textblock
26272 #: ../fish/guestfish-actions.pod:1646
26273 msgid ""
26274 "Queued up events should be read periodically by calling L</inotify-read> (or "
26275 "L</inotify-files> which is just a helpful wrapper around L</inotify-read>).  "
26276 "If you don't read the events out often enough then you risk the internal "
26277 "queue overflowing."
26278 msgstr ""
26279
26280 # type: textblock
26281 #. type: textblock
26282 #: ../fish/guestfish-actions.pod:1653
26283 msgid ""
26284 "The handle should be closed after use by calling L</inotify-close>.  This "
26285 "also removes any watches automatically."
26286 msgstr ""
26287
26288 # type: =head2
26289 #. type: =head2
26290 #: ../fish/guestfish-actions.pod:1662
26291 msgid "inotify-read"
26292 msgstr ""
26293
26294 # type: verbatim
26295 #. type: verbatim
26296 #: ../fish/guestfish-actions.pod:1664
26297 #, no-wrap
26298 msgid ""
26299 " inotify-read\n"
26300 "\n"
26301 msgstr ""
26302
26303 # type: =head2
26304 #. type: =head2
26305 #: ../fish/guestfish-actions.pod:1677
26306 msgid "inotify-rm-watch"
26307 msgstr ""
26308
26309 # type: verbatim
26310 #. type: verbatim
26311 #: ../fish/guestfish-actions.pod:1679
26312 #, no-wrap
26313 msgid ""
26314 " inotify-rm-watch wd\n"
26315 "\n"
26316 msgstr ""
26317
26318 # type: textblock
26319 #. type: textblock
26320 #: ../fish/guestfish-actions.pod:1681
26321 msgid "Remove a previously defined inotify watch.  See L</inotify-add-watch>."
26322 msgstr ""
26323
26324 # type: =head2
26325 #. type: =head2
26326 #: ../fish/guestfish-actions.pod:1684
26327 msgid "inspect-get-arch"
26328 msgstr ""
26329
26330 # type: verbatim
26331 #. type: verbatim
26332 #: ../fish/guestfish-actions.pod:1686
26333 #, no-wrap
26334 msgid ""
26335 " inspect-get-arch root\n"
26336 "\n"
26337 msgstr ""
26338
26339 # type: textblock
26340 #. type: textblock
26341 #: ../fish/guestfish-actions.pod:1688 ../fish/guestfish-actions.pod:1704
26342 #: ../fish/guestfish-actions.pod:1782 ../fish/guestfish-actions.pod:1800
26343 #: ../fish/guestfish-actions.pod:1834 ../fish/guestfish-actions.pod:1849
26344 #: ../fish/guestfish-actions.pod:1870 ../fish/guestfish-actions.pod:1885
26345 #: ../fish/guestfish-actions.pod:1912 ../fish/guestfish-actions.pod:1934
26346 #: ../fish/guestfish-actions.pod:1958 ../fish/guestfish-actions.pod:1975
26347 #: ../fish/guestfish-actions.pod:2018 ../fish/guestfish-actions.pod:2053
26348 #: ../fish/guestfish-actions.pod:2069 ../fish/guestfish-actions.pod:2082
26349 #: ../fish/guestfish-actions.pod:2095 ../fish/guestfish-actions.pod:2110
26350 msgid ""
26351 "This function should only be called with a root device string as returned by "
26352 "L</inspect-os>."
26353 msgstr ""
26354
26355 # type: textblock
26356 #. type: textblock
26357 #: ../fish/guestfish-actions.pod:1691
26358 msgid ""
26359 "This returns the architecture of the inspected operating system.  The "
26360 "possible return values are listed under L</file-architecture>."
26361 msgstr ""
26362
26363 # type: =head2
26364 #. type: =head2
26365 #: ../fish/guestfish-actions.pod:1700
26366 msgid "inspect-get-distro"
26367 msgstr ""
26368
26369 # type: verbatim
26370 #. type: verbatim
26371 #: ../fish/guestfish-actions.pod:1702
26372 #, no-wrap
26373 msgid ""
26374 " inspect-get-distro root\n"
26375 "\n"
26376 msgstr ""
26377
26378 # type: =head2
26379 #. type: =head2
26380 #: ../fish/guestfish-actions.pod:1778
26381 msgid "inspect-get-filesystems"
26382 msgstr ""
26383
26384 # type: verbatim
26385 #. type: verbatim
26386 #: ../fish/guestfish-actions.pod:1780
26387 #, no-wrap
26388 msgid ""
26389 " inspect-get-filesystems root\n"
26390 "\n"
26391 msgstr ""
26392
26393 # type: textblock
26394 #. type: textblock
26395 #: ../fish/guestfish-actions.pod:1793
26396 msgid ""
26397 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
26398 "get-mountpoints>."
26399 msgstr ""
26400
26401 #. type: =head2
26402 #: ../fish/guestfish-actions.pod:1796
26403 msgid "inspect-get-format"
26404 msgstr ""
26405
26406 #. type: verbatim
26407 #: ../fish/guestfish-actions.pod:1798
26408 #, no-wrap
26409 msgid ""
26410 " inspect-get-format root\n"
26411 "\n"
26412 msgstr ""
26413
26414 # type: =head2
26415 #. type: =head2
26416 #: ../fish/guestfish-actions.pod:1830
26417 msgid "inspect-get-hostname"
26418 msgstr ""
26419
26420 # type: verbatim
26421 #. type: verbatim
26422 #: ../fish/guestfish-actions.pod:1832
26423 #, no-wrap
26424 msgid ""
26425 " inspect-get-hostname root\n"
26426 "\n"
26427 msgstr ""
26428
26429 # type: =head2
26430 #. type: =head2
26431 #: ../fish/guestfish-actions.pod:1845
26432 msgid "inspect-get-major-version"
26433 msgstr ""
26434
26435 # type: verbatim
26436 #. type: verbatim
26437 #: ../fish/guestfish-actions.pod:1847
26438 #, no-wrap
26439 msgid ""
26440 " inspect-get-major-version root\n"
26441 "\n"
26442 msgstr ""
26443
26444 # type: =head2
26445 #. type: =head2
26446 #: ../fish/guestfish-actions.pod:1866
26447 msgid "inspect-get-minor-version"
26448 msgstr ""
26449
26450 # type: verbatim
26451 #. type: verbatim
26452 #: ../fish/guestfish-actions.pod:1868
26453 #, no-wrap
26454 msgid ""
26455 " inspect-get-minor-version root\n"
26456 "\n"
26457 msgstr ""
26458
26459 # type: textblock
26460 #. type: textblock
26461 #: ../fish/guestfish-actions.pod:1878
26462 msgid ""
26463 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
26464 "get-major-version>."
26465 msgstr ""
26466
26467 # type: =head2
26468 #. type: =head2
26469 #: ../fish/guestfish-actions.pod:1881
26470 msgid "inspect-get-mountpoints"
26471 msgstr ""
26472
26473 # type: verbatim
26474 #. type: verbatim
26475 #: ../fish/guestfish-actions.pod:1883
26476 #, no-wrap
26477 msgid ""
26478 " inspect-get-mountpoints root\n"
26479 "\n"
26480 msgstr ""
26481
26482 # type: textblock
26483 #. type: textblock
26484 #: ../fish/guestfish-actions.pod:1905
26485 msgid ""
26486 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
26487 "get-filesystems>."
26488 msgstr ""
26489
26490 # type: =head2
26491 #. type: =head2
26492 #: ../fish/guestfish-actions.pod:1908
26493 msgid "inspect-get-package-format"
26494 msgstr ""
26495
26496 # type: verbatim
26497 #. type: verbatim
26498 #: ../fish/guestfish-actions.pod:1910
26499 #, no-wrap
26500 msgid ""
26501 " inspect-get-package-format root\n"
26502 "\n"
26503 msgstr ""
26504
26505 # type: textblock
26506 #. type: textblock
26507 #: ../fish/guestfish-actions.pod:1915
26508 msgid ""
26509 "This function and L</inspect-get-package-management> return the package "
26510 "format and package management tool used by the inspected operating system.  "
26511 "For example for Fedora these functions would return C<rpm> (package format) "
26512 "and C<yum> (package management)."
26513 msgstr ""
26514
26515 # type: =head2
26516 #. type: =head2
26517 #: ../fish/guestfish-actions.pod:1930
26518 msgid "inspect-get-package-management"
26519 msgstr ""
26520
26521 # type: verbatim
26522 #. type: verbatim
26523 #: ../fish/guestfish-actions.pod:1932
26524 #, no-wrap
26525 msgid ""
26526 " inspect-get-package-management root\n"
26527 "\n"
26528 msgstr ""
26529
26530 # type: textblock
26531 #. type: textblock
26532 #: ../fish/guestfish-actions.pod:1937
26533 msgid ""
26534 "L</inspect-get-package-format> and this function return the package format "
26535 "and package management tool used by the inspected operating system.  For "
26536 "example for Fedora these functions would return C<rpm> (package format) and "
26537 "C<yum> (package management)."
26538 msgstr ""
26539
26540 # type: =head2
26541 #. type: =head2
26542 #: ../fish/guestfish-actions.pod:1954
26543 msgid "inspect-get-product-name"
26544 msgstr ""
26545
26546 # type: verbatim
26547 #. type: verbatim
26548 #: ../fish/guestfish-actions.pod:1956
26549 #, no-wrap
26550 msgid ""
26551 " inspect-get-product-name root\n"
26552 "\n"
26553 msgstr ""
26554
26555 #. type: =head2
26556 #: ../fish/guestfish-actions.pod:1971
26557 msgid "inspect-get-product-variant"
26558 msgstr ""
26559
26560 #. type: verbatim
26561 #: ../fish/guestfish-actions.pod:1973
26562 #, no-wrap
26563 msgid ""
26564 " inspect-get-product-variant root\n"
26565 "\n"
26566 msgstr ""
26567
26568 #. type: textblock
26569 #: ../fish/guestfish-actions.pod:1997
26570 msgid ""
26571 "Please read L<guestfs(3)/INSPECTION> for more details.  See also L</inspect-"
26572 "get-product-name>, L</inspect-get-major-version>."
26573 msgstr ""
26574
26575 # type: =head2
26576 #. type: =head2
26577 #: ../fish/guestfish-actions.pod:2001
26578 msgid "inspect-get-roots"
26579 msgstr ""
26580
26581 # type: verbatim
26582 #. type: verbatim
26583 #: ../fish/guestfish-actions.pod:2003
26584 #, no-wrap
26585 msgid ""
26586 " inspect-get-roots\n"
26587 "\n"
26588 msgstr ""
26589
26590 # type: textblock
26591 #. type: textblock
26592 #: ../fish/guestfish-actions.pod:2005
26593 msgid ""
26594 "This function is a convenient way to get the list of root devices, as "
26595 "returned from a previous call to L</inspect-os>, but without redoing the "
26596 "whole inspection process."
26597 msgstr ""
26598
26599 # type: textblock
26600 #. type: textblock
26601 #: ../fish/guestfish-actions.pod:2009
26602 msgid ""
26603 "This returns an empty list if either no root devices were found or the "
26604 "caller has not called L</inspect-os>."
26605 msgstr ""
26606
26607 # type: =head2
26608 #. type: =head2
26609 #: ../fish/guestfish-actions.pod:2014
26610 msgid "inspect-get-type"
26611 msgstr ""
26612
26613 # type: verbatim
26614 #. type: verbatim
26615 #: ../fish/guestfish-actions.pod:2016
26616 #, no-wrap
26617 msgid ""
26618 " inspect-get-type root\n"
26619 "\n"
26620 msgstr ""
26621
26622 # type: =head2
26623 #. type: =head2
26624 #: ../fish/guestfish-actions.pod:2049
26625 msgid "inspect-get-windows-systemroot"
26626 msgstr ""
26627
26628 # type: verbatim
26629 #. type: verbatim
26630 #: ../fish/guestfish-actions.pod:2051
26631 #, no-wrap
26632 msgid ""
26633 " inspect-get-windows-systemroot root\n"
26634 "\n"
26635 msgstr ""
26636
26637 #. type: =head2
26638 #: ../fish/guestfish-actions.pod:2065
26639 msgid "inspect-is-live"
26640 msgstr ""
26641
26642 #. type: verbatim
26643 #: ../fish/guestfish-actions.pod:2067
26644 #, no-wrap
26645 msgid ""
26646 " inspect-is-live root\n"
26647 "\n"
26648 msgstr ""
26649
26650 #. type: textblock
26651 #: ../fish/guestfish-actions.pod:2072
26652 msgid ""
26653 "If L</inspect-get-format> returns C<installer> (this is an install disk), "
26654 "then this returns true if a live image was detected on the disk."
26655 msgstr ""
26656
26657 #. type: =head2
26658 #: ../fish/guestfish-actions.pod:2078
26659 msgid "inspect-is-multipart"
26660 msgstr ""
26661
26662 #. type: verbatim
26663 #: ../fish/guestfish-actions.pod:2080
26664 #, no-wrap
26665 msgid ""
26666 " inspect-is-multipart root\n"
26667 "\n"
26668 msgstr ""
26669
26670 #. type: textblock
26671 #: ../fish/guestfish-actions.pod:2085
26672 msgid ""
26673 "If L</inspect-get-format> returns C<installer> (this is an install disk), "
26674 "then this returns true if the disk is part of a set."
26675 msgstr ""
26676
26677 #. type: =head2
26678 #: ../fish/guestfish-actions.pod:2091
26679 msgid "inspect-is-netinst"
26680 msgstr ""
26681
26682 #. type: verbatim
26683 #: ../fish/guestfish-actions.pod:2093
26684 #, no-wrap
26685 msgid ""
26686 " inspect-is-netinst root\n"
26687 "\n"
26688 msgstr ""
26689
26690 #. type: textblock
26691 #: ../fish/guestfish-actions.pod:2098
26692 msgid ""
26693 "If L</inspect-get-format> returns C<installer> (this is an install disk), "
26694 "then this returns true if the disk is a network installer, ie. not a self-"
26695 "contained install CD but one which is likely to require network access to "
26696 "complete the install."
26697 msgstr ""
26698
26699 # type: =head2
26700 #. type: =head2
26701 #: ../fish/guestfish-actions.pod:2106
26702 msgid "inspect-list-applications"
26703 msgstr ""
26704
26705 # type: verbatim
26706 #. type: verbatim
26707 #: ../fish/guestfish-actions.pod:2108
26708 #, no-wrap
26709 msgid ""
26710 " inspect-list-applications root\n"
26711 "\n"
26712 msgstr ""
26713
26714 # type: textblock
26715 #. type: textblock
26716 #: ../fish/guestfish-actions.pod:2115
26717 msgid ""
26718 "I<Note:> This call works differently from other parts of the inspection "
26719 "API.  You have to call L</inspect-os>, then L</inspect-get-mountpoints>, "
26720 "then mount up the disks, before calling this.  Listing applications is a "
26721 "significantly more difficult operation which requires access to the full "
26722 "filesystem.  Also note that unlike the other L</inspect-get-*> calls which "
26723 "are just returning data cached in the libguestfs handle, this call actually "
26724 "reads parts of the mounted filesystems during the call."
26725 msgstr ""
26726
26727 # type: =head2
26728 #. type: =head2
26729 #: ../fish/guestfish-actions.pod:2205
26730 msgid "inspect-os"
26731 msgstr ""
26732
26733 # type: verbatim
26734 #. type: verbatim
26735 #: ../fish/guestfish-actions.pod:2207
26736 #, no-wrap
26737 msgid ""
26738 " inspect-os\n"
26739 "\n"
26740 msgstr ""
26741
26742 # type: textblock
26743 #. type: textblock
26744 #: ../fish/guestfish-actions.pod:2222
26745 msgid ""
26746 "You can pass the root string(s) returned to other L</inspect-get-*> "
26747 "functions in order to query further information about each operating system, "
26748 "such as the name and version."
26749 msgstr ""
26750
26751 # type: textblock
26752 #. type: textblock
26753 #: ../fish/guestfish-actions.pod:2227
26754 msgid ""
26755 "This function uses other libguestfs features such as L</mount-ro> and L</"
26756 "umount-all> in order to mount and unmount filesystems and look at the "
26757 "contents.  This should be called with no disks currently mounted.  The "
26758 "function may also use Augeas, so any existing Augeas handle will be closed."
26759 msgstr ""
26760
26761 # type: textblock
26762 #. type: textblock
26763 #: ../fish/guestfish-actions.pod:2239 ../fish/guestfish-actions.pod:2415
26764 #: ../fish/guestfish-actions.pod:2461
26765 msgid "See also L</list-filesystems>."
26766 msgstr ""
26767
26768 # type: =head2
26769 #. type: =head2
26770 #: ../fish/guestfish-actions.pod:2241
26771 msgid "is-blockdev"
26772 msgstr ""
26773
26774 # type: verbatim
26775 #. type: verbatim
26776 #: ../fish/guestfish-actions.pod:2243
26777 #, no-wrap
26778 msgid ""
26779 " is-blockdev path\n"
26780 "\n"
26781 msgstr ""
26782
26783 # type: textblock
26784 #. type: textblock
26785 #: ../fish/guestfish-actions.pod:2248 ../fish/guestfish-actions.pod:2266
26786 #: ../fish/guestfish-actions.pod:2285 ../fish/guestfish-actions.pod:2294
26787 #: ../fish/guestfish-actions.pod:2304 ../fish/guestfish-actions.pod:2338
26788 #: ../fish/guestfish-actions.pod:2347
26789 msgid "See also L</stat>."
26790 msgstr ""
26791
26792 # type: =head2
26793 #. type: =head2
26794 #: ../fish/guestfish-actions.pod:2250
26795 msgid "is-busy"
26796 msgstr ""
26797
26798 # type: verbatim
26799 #. type: verbatim
26800 #: ../fish/guestfish-actions.pod:2252
26801 #, no-wrap
26802 msgid ""
26803 " is-busy\n"
26804 "\n"
26805 msgstr ""
26806
26807 # type: =head2
26808 #. type: =head2
26809 #: ../fish/guestfish-actions.pod:2259
26810 msgid "is-chardev"
26811 msgstr ""
26812
26813 # type: verbatim
26814 #. type: verbatim
26815 #: ../fish/guestfish-actions.pod:2261
26816 #, no-wrap
26817 msgid ""
26818 " is-chardev path\n"
26819 "\n"
26820 msgstr ""
26821
26822 # type: =head2
26823 #. type: =head2
26824 #: ../fish/guestfish-actions.pod:2268
26825 msgid "is-config"
26826 msgstr ""
26827
26828 # type: verbatim
26829 #. type: verbatim
26830 #: ../fish/guestfish-actions.pod:2270
26831 #, no-wrap
26832 msgid ""
26833 " is-config\n"
26834 "\n"
26835 msgstr ""
26836
26837 # type: =head2
26838 #. type: =head2
26839 #: ../fish/guestfish-actions.pod:2277
26840 msgid "is-dir"
26841 msgstr ""
26842
26843 # type: verbatim
26844 #. type: verbatim
26845 #: ../fish/guestfish-actions.pod:2279
26846 #, no-wrap
26847 msgid ""
26848 " is-dir path\n"
26849 "\n"
26850 msgstr ""
26851
26852 # type: =head2
26853 #. type: =head2
26854 #: ../fish/guestfish-actions.pod:2287
26855 msgid "is-fifo"
26856 msgstr ""
26857
26858 # type: verbatim
26859 #. type: verbatim
26860 #: ../fish/guestfish-actions.pod:2289
26861 #, no-wrap
26862 msgid ""
26863 " is-fifo path\n"
26864 "\n"
26865 msgstr ""
26866
26867 # type: =head2
26868 #. type: =head2
26869 #: ../fish/guestfish-actions.pod:2296
26870 msgid "is-file"
26871 msgstr ""
26872
26873 # type: verbatim
26874 #. type: verbatim
26875 #: ../fish/guestfish-actions.pod:2298
26876 #, no-wrap
26877 msgid ""
26878 " is-file path\n"
26879 "\n"
26880 msgstr ""
26881
26882 # type: =head2
26883 #. type: =head2
26884 #: ../fish/guestfish-actions.pod:2306
26885 msgid "is-launching"
26886 msgstr ""
26887
26888 # type: verbatim
26889 #. type: verbatim
26890 #: ../fish/guestfish-actions.pod:2308
26891 #, no-wrap
26892 msgid ""
26893 " is-launching\n"
26894 "\n"
26895 msgstr ""
26896
26897 # type: =head2
26898 #. type: =head2
26899 #: ../fish/guestfish-actions.pod:2315
26900 msgid "is-lv"
26901 msgstr ""
26902
26903 # type: verbatim
26904 #. type: verbatim
26905 #: ../fish/guestfish-actions.pod:2317
26906 #, no-wrap
26907 msgid ""
26908 " is-lv device\n"
26909 "\n"
26910 msgstr ""
26911
26912 # type: =head2
26913 #. type: =head2
26914 #: ../fish/guestfish-actions.pod:2322
26915 msgid "is-ready"
26916 msgstr ""
26917
26918 # type: verbatim
26919 #. type: verbatim
26920 #: ../fish/guestfish-actions.pod:2324
26921 #, no-wrap
26922 msgid ""
26923 " is-ready\n"
26924 "\n"
26925 msgstr ""
26926
26927 # type: =head2
26928 #. type: =head2
26929 #: ../fish/guestfish-actions.pod:2331
26930 msgid "is-socket"
26931 msgstr ""
26932
26933 # type: verbatim
26934 #. type: verbatim
26935 #: ../fish/guestfish-actions.pod:2333
26936 #, no-wrap
26937 msgid ""
26938 " is-socket path\n"
26939 "\n"
26940 msgstr ""
26941
26942 # type: =head2
26943 #. type: =head2
26944 #: ../fish/guestfish-actions.pod:2340
26945 msgid "is-symlink"
26946 msgstr ""
26947
26948 # type: verbatim
26949 #. type: verbatim
26950 #: ../fish/guestfish-actions.pod:2342
26951 #, no-wrap
26952 msgid ""
26953 " is-symlink path\n"
26954 "\n"
26955 msgstr ""
26956
26957 # type: =head2
26958 #. type: =head2
26959 #: ../fish/guestfish-actions.pod:2349
26960 msgid "kill-subprocess"
26961 msgstr ""
26962
26963 # type: verbatim
26964 #. type: verbatim
26965 #: ../fish/guestfish-actions.pod:2351
26966 #, no-wrap
26967 msgid ""
26968 " kill-subprocess\n"
26969 "\n"
26970 msgstr ""
26971
26972 # type: =head2
26973 #. type: =head2
26974 #: ../fish/guestfish-actions.pod:2355
26975 msgid "launch"
26976 msgstr ""
26977
26978 # type: =head2
26979 #. type: =head2
26980 #: ../fish/guestfish-actions.pod:2357
26981 msgid "run"
26982 msgstr ""
26983
26984 # type: verbatim
26985 #. type: verbatim
26986 #: ../fish/guestfish-actions.pod:2359
26987 #, no-wrap
26988 msgid ""
26989 " launch\n"
26990 "\n"
26991 msgstr ""
26992
26993 # type: =head2
26994 #. type: =head2
26995 #: ../fish/guestfish-actions.pod:2367
26996 msgid "lchown"
26997 msgstr ""
26998
26999 # type: verbatim
27000 #. type: verbatim
27001 #: ../fish/guestfish-actions.pod:2369
27002 #, no-wrap
27003 msgid ""
27004 " lchown owner group path\n"
27005 "\n"
27006 msgstr ""
27007
27008 # type: textblock
27009 #. type: textblock
27010 #: ../fish/guestfish-actions.pod:2371
27011 msgid ""
27012 "Change the file owner to C<owner> and group to C<group>.  This is like L</"
27013 "chown> but if C<path> is a symlink then the link itself is changed, not the "
27014 "target."
27015 msgstr ""
27016
27017 # type: =head2
27018 #. type: =head2
27019 #: ../fish/guestfish-actions.pod:2379
27020 msgid "lgetxattr"
27021 msgstr ""
27022
27023 # type: verbatim
27024 #. type: verbatim
27025 #: ../fish/guestfish-actions.pod:2381
27026 #, no-wrap
27027 msgid ""
27028 " lgetxattr path name\n"
27029 "\n"
27030 msgstr ""
27031
27032 # type: textblock
27033 #. type: textblock
27034 #: ../fish/guestfish-actions.pod:2397
27035 msgid "See also: L</lgetxattrs>, L</getxattr>, L<attr(5)>."
27036 msgstr ""
27037
27038 # type: =head2
27039 #. type: =head2
27040 #: ../fish/guestfish-actions.pod:2399
27041 msgid "lgetxattrs"
27042 msgstr ""
27043
27044 # type: verbatim
27045 #. type: verbatim
27046 #: ../fish/guestfish-actions.pod:2401
27047 #, no-wrap
27048 msgid ""
27049 " lgetxattrs path\n"
27050 "\n"
27051 msgstr ""
27052
27053 # type: textblock
27054 #. type: textblock
27055 #: ../fish/guestfish-actions.pod:2403
27056 msgid ""
27057 "This is the same as L</getxattrs>, but if C<path> is a symbolic link, then "
27058 "it returns the extended attributes of the link itself."
27059 msgstr ""
27060
27061 # type: =head2
27062 #. type: =head2
27063 #: ../fish/guestfish-actions.pod:2407
27064 msgid "list-devices"
27065 msgstr ""
27066
27067 # type: verbatim
27068 #. type: verbatim
27069 #: ../fish/guestfish-actions.pod:2409
27070 #, no-wrap
27071 msgid ""
27072 " list-devices\n"
27073 "\n"
27074 msgstr ""
27075
27076 # type: =head2
27077 #. type: =head2
27078 #: ../fish/guestfish-actions.pod:2417
27079 msgid "list-filesystems"
27080 msgstr ""
27081
27082 # type: verbatim
27083 #. type: verbatim
27084 #: ../fish/guestfish-actions.pod:2419
27085 #, no-wrap
27086 msgid ""
27087 " list-filesystems\n"
27088 "\n"
27089 msgstr ""
27090
27091 # type: textblock
27092 #. type: textblock
27093 #: ../fish/guestfish-actions.pod:2438
27094 msgid ""
27095 "This command runs other libguestfs commands, which might include L</mount> "
27096 "and L</umount>, and therefore you should use this soon after launch and only "
27097 "when nothing is mounted."
27098 msgstr ""
27099
27100 # type: textblock
27101 #. type: textblock
27102 #: ../fish/guestfish-actions.pod:2442
27103 msgid ""
27104 "Not all of the filesystems returned will be mountable.  In particular, swap "
27105 "partitions are returned in the list.  Also this command does not check that "
27106 "each filesystem found is valid and mountable, and some filesystems might be "
27107 "mountable but require special options.  Filesystems may not all belong to a "
27108 "single logical operating system (use L</inspect-os> to look for OSes)."
27109 msgstr ""
27110
27111 # type: =head2
27112 #. type: =head2
27113 #: ../fish/guestfish-actions.pod:2450
27114 msgid "list-partitions"
27115 msgstr ""
27116
27117 # type: verbatim
27118 #. type: verbatim
27119 #: ../fish/guestfish-actions.pod:2452
27120 #, no-wrap
27121 msgid ""
27122 " list-partitions\n"
27123 "\n"
27124 msgstr ""
27125
27126 # type: textblock
27127 #. type: textblock
27128 #: ../fish/guestfish-actions.pod:2458
27129 msgid ""
27130 "This does not return logical volumes.  For that you will need to call L</"
27131 "lvs>."
27132 msgstr ""
27133
27134 # type: =head2
27135 #. type: =head2
27136 #: ../fish/guestfish-actions.pod:2463
27137 msgid "ll"
27138 msgstr ""
27139
27140 # type: verbatim
27141 #. type: verbatim
27142 #: ../fish/guestfish-actions.pod:2465
27143 #, no-wrap
27144 msgid ""
27145 " ll directory\n"
27146 "\n"
27147 msgstr ""
27148
27149 # type: =head2
27150 #. type: =head2
27151 #: ../fish/guestfish-actions.pod:2473
27152 msgid "ln"
27153 msgstr ""
27154
27155 # type: verbatim
27156 #. type: verbatim
27157 #: ../fish/guestfish-actions.pod:2475
27158 #, no-wrap
27159 msgid ""
27160 " ln target linkname\n"
27161 "\n"
27162 msgstr ""
27163
27164 # type: =head2
27165 #. type: =head2
27166 #: ../fish/guestfish-actions.pod:2479
27167 msgid "ln-f"
27168 msgstr ""
27169
27170 # type: verbatim
27171 #. type: verbatim
27172 #: ../fish/guestfish-actions.pod:2481
27173 #, no-wrap
27174 msgid ""
27175 " ln-f target linkname\n"
27176 "\n"
27177 msgstr ""
27178
27179 # type: =head2
27180 #. type: =head2
27181 #: ../fish/guestfish-actions.pod:2486
27182 msgid "ln-s"
27183 msgstr ""
27184
27185 # type: verbatim
27186 #. type: verbatim
27187 #: ../fish/guestfish-actions.pod:2488
27188 #, no-wrap
27189 msgid ""
27190 " ln-s target linkname\n"
27191 "\n"
27192 msgstr ""
27193
27194 # type: =head2
27195 #. type: =head2
27196 #: ../fish/guestfish-actions.pod:2492
27197 msgid "ln-sf"
27198 msgstr ""
27199
27200 # type: verbatim
27201 #. type: verbatim
27202 #: ../fish/guestfish-actions.pod:2494
27203 #, no-wrap
27204 msgid ""
27205 " ln-sf target linkname\n"
27206 "\n"
27207 msgstr ""
27208
27209 # type: =head2
27210 #. type: =head2
27211 #: ../fish/guestfish-actions.pod:2499
27212 msgid "lremovexattr"
27213 msgstr ""
27214
27215 # type: verbatim
27216 #. type: verbatim
27217 #: ../fish/guestfish-actions.pod:2501
27218 #, no-wrap
27219 msgid ""
27220 " lremovexattr xattr path\n"
27221 "\n"
27222 msgstr ""
27223
27224 # type: textblock
27225 #. type: textblock
27226 #: ../fish/guestfish-actions.pod:2503
27227 msgid ""
27228 "This is the same as L</removexattr>, but if C<path> is a symbolic link, then "
27229 "it removes an extended attribute of the link itself."
27230 msgstr ""
27231
27232 # type: =head2
27233 #. type: =head2
27234 #: ../fish/guestfish-actions.pod:2507
27235 msgid "ls"
27236 msgstr ""
27237
27238 # type: verbatim
27239 #. type: verbatim
27240 #: ../fish/guestfish-actions.pod:2509
27241 #, no-wrap
27242 msgid ""
27243 " ls directory\n"
27244 "\n"
27245 msgstr ""
27246
27247 # type: textblock
27248 #. type: textblock
27249 #: ../fish/guestfish-actions.pod:2515
27250 msgid ""
27251 "This command is mostly useful for interactive sessions.  Programs should "
27252 "probably use L</readdir> instead."
27253 msgstr ""
27254
27255 # type: =head2
27256 #. type: =head2
27257 #: ../fish/guestfish-actions.pod:2518
27258 msgid "lsetxattr"
27259 msgstr ""
27260
27261 # type: verbatim
27262 #. type: verbatim
27263 #: ../fish/guestfish-actions.pod:2520
27264 #, no-wrap
27265 msgid ""
27266 " lsetxattr xattr val vallen path\n"
27267 "\n"
27268 msgstr ""
27269
27270 # type: textblock
27271 #. type: textblock
27272 #: ../fish/guestfish-actions.pod:2522
27273 msgid ""
27274 "This is the same as L</setxattr>, but if C<path> is a symbolic link, then it "
27275 "sets an extended attribute of the link itself."
27276 msgstr ""
27277
27278 # type: =head2
27279 #. type: =head2
27280 #: ../fish/guestfish-actions.pod:2526
27281 msgid "lstat"
27282 msgstr ""
27283
27284 # type: verbatim
27285 #. type: verbatim
27286 #: ../fish/guestfish-actions.pod:2528
27287 #, no-wrap
27288 msgid ""
27289 " lstat path\n"
27290 "\n"
27291 msgstr ""
27292
27293 # type: textblock
27294 #. type: textblock
27295 #: ../fish/guestfish-actions.pod:2532
27296 msgid ""
27297 "This is the same as L</stat> except that if C<path> is a symbolic link, then "
27298 "the link is stat-ed, not the file it refers to."
27299 msgstr ""
27300
27301 # type: =head2
27302 #. type: =head2
27303 #: ../fish/guestfish-actions.pod:2538
27304 msgid "lstatlist"
27305 msgstr ""
27306
27307 # type: verbatim
27308 #. type: verbatim
27309 #: ../fish/guestfish-actions.pod:2540
27310 #, no-wrap
27311 msgid ""
27312 " lstatlist path 'names ...'\n"
27313 "\n"
27314 msgstr ""
27315
27316 # type: textblock
27317 #. type: textblock
27318 #: ../fish/guestfish-actions.pod:2542
27319 msgid ""
27320 "This call allows you to perform the L</lstat> operation on multiple files, "
27321 "where all files are in the directory C<path>.  C<names> is the list of files "
27322 "from this directory."
27323 msgstr ""
27324
27325 # type: textblock
27326 #. type: textblock
27327 #: ../fish/guestfish-actions.pod:2551
27328 msgid ""
27329 "This call is intended for programs that want to efficiently list a directory "
27330 "contents without making many round-trips.  See also L</lxattrlist> for a "
27331 "similarly efficient call for getting extended attributes.  Very long "
27332 "directory listings might cause the protocol message size to be exceeded, "
27333 "causing this call to fail.  The caller must split up such requests into "
27334 "smaller groups of names."
27335 msgstr ""
27336
27337 # type: =head2
27338 #. type: =head2
27339 #: ../fish/guestfish-actions.pod:2559
27340 msgid "luks-add-key"
27341 msgstr ""
27342
27343 # type: verbatim
27344 #. type: verbatim
27345 #: ../fish/guestfish-actions.pod:2561
27346 #, no-wrap
27347 msgid ""
27348 " luks-add-key device keyslot\n"
27349 "\n"
27350 msgstr ""
27351
27352 # type: textblock
27353 #. type: textblock
27354 #: ../fish/guestfish-actions.pod:2568
27355 msgid ""
27356 "Note that if C<keyslot> already contains a key, then this command will "
27357 "fail.  You have to use L</luks-kill-slot> first to remove that key."
27358 msgstr ""
27359
27360 # type: textblock
27361 #. type: textblock
27362 #: ../fish/guestfish-actions.pod:2572 ../fish/guestfish-actions.pod:2594
27363 #: ../fish/guestfish-actions.pod:2607 ../fish/guestfish-actions.pod:2621
27364 #: ../fish/guestfish-actions.pod:2644 ../fish/guestfish-actions.pod:2654
27365 msgid ""
27366 "This command has one or more key or passphrase parameters.  Guestfish will "
27367 "prompt for these separately."
27368 msgstr ""
27369
27370 # type: =head2
27371 #. type: =head2
27372 #: ../fish/guestfish-actions.pod:2575
27373 msgid "luks-close"
27374 msgstr ""
27375
27376 # type: verbatim
27377 #. type: verbatim
27378 #: ../fish/guestfish-actions.pod:2577
27379 #, no-wrap
27380 msgid ""
27381 " luks-close device\n"
27382 "\n"
27383 msgstr ""
27384
27385 # type: textblock
27386 #. type: textblock
27387 #: ../fish/guestfish-actions.pod:2579
27388 msgid ""
27389 "This closes a LUKS device that was created earlier by L</luks-open> or L</"
27390 "luks-open-ro>.  The C<device> parameter must be the name of the LUKS mapping "
27391 "device (ie. C</dev/mapper/mapname>) and I<not> the name of the underlying "
27392 "block device."
27393 msgstr ""
27394
27395 # type: =head2
27396 #. type: =head2
27397 #: ../fish/guestfish-actions.pod:2585
27398 msgid "luks-format"
27399 msgstr ""
27400
27401 # type: verbatim
27402 #. type: verbatim
27403 #: ../fish/guestfish-actions.pod:2587
27404 #, no-wrap
27405 msgid ""
27406 " luks-format device keyslot\n"
27407 "\n"
27408 msgstr ""
27409
27410 # type: =head2
27411 #. type: =head2
27412 #: ../fish/guestfish-actions.pod:2600
27413 msgid "luks-format-cipher"
27414 msgstr ""
27415
27416 # type: verbatim
27417 #. type: verbatim
27418 #: ../fish/guestfish-actions.pod:2602
27419 #, no-wrap
27420 msgid ""
27421 " luks-format-cipher device keyslot cipher\n"
27422 "\n"
27423 msgstr ""
27424
27425 # type: textblock
27426 #. type: textblock
27427 #: ../fish/guestfish-actions.pod:2604
27428 msgid ""
27429 "This command is the same as L</luks-format> but it also allows you to set "
27430 "the C<cipher> used."
27431 msgstr ""
27432
27433 # type: =head2
27434 #. type: =head2
27435 #: ../fish/guestfish-actions.pod:2613
27436 msgid "luks-kill-slot"
27437 msgstr ""
27438
27439 # type: verbatim
27440 #. type: verbatim
27441 #: ../fish/guestfish-actions.pod:2615
27442 #, no-wrap
27443 msgid ""
27444 " luks-kill-slot device keyslot\n"
27445 "\n"
27446 msgstr ""
27447
27448 # type: =head2
27449 #. type: =head2
27450 #: ../fish/guestfish-actions.pod:2624
27451 msgid "luks-open"
27452 msgstr ""
27453
27454 # type: verbatim
27455 #. type: verbatim
27456 #: ../fish/guestfish-actions.pod:2626
27457 #, no-wrap
27458 msgid ""
27459 " luks-open device mapname\n"
27460 "\n"
27461 msgstr ""
27462
27463 # type: textblock
27464 #. type: textblock
27465 #: ../fish/guestfish-actions.pod:2640
27466 msgid ""
27467 "If this block device contains LVM volume groups, then calling L</vgscan> "
27468 "followed by L</vg-activate-all> will make them visible."
27469 msgstr ""
27470
27471 # type: =head2
27472 #. type: =head2
27473 #: ../fish/guestfish-actions.pod:2647
27474 msgid "luks-open-ro"
27475 msgstr ""
27476
27477 # type: verbatim
27478 #. type: verbatim
27479 #: ../fish/guestfish-actions.pod:2649
27480 #, no-wrap
27481 msgid ""
27482 " luks-open-ro device mapname\n"
27483 "\n"
27484 msgstr ""
27485
27486 # type: textblock
27487 #. type: textblock
27488 #: ../fish/guestfish-actions.pod:2651
27489 msgid ""
27490 "This is the same as L</luks-open> except that a read-only mapping is created."
27491 msgstr ""
27492
27493 # type: =head2
27494 #. type: =head2
27495 #: ../fish/guestfish-actions.pod:2657
27496 msgid "lvcreate"
27497 msgstr ""
27498
27499 # type: verbatim
27500 #. type: verbatim
27501 #: ../fish/guestfish-actions.pod:2659
27502 #, no-wrap
27503 msgid ""
27504 " lvcreate logvol volgroup mbytes\n"
27505 "\n"
27506 msgstr ""
27507
27508 # type: =head2
27509 #. type: =head2
27510 #: ../fish/guestfish-actions.pod:2664
27511 msgid "lvm-canonical-lv-name"
27512 msgstr ""
27513
27514 # type: verbatim
27515 #. type: verbatim
27516 #: ../fish/guestfish-actions.pod:2666
27517 #, no-wrap
27518 msgid ""
27519 " lvm-canonical-lv-name lvname\n"
27520 "\n"
27521 msgstr ""
27522
27523 # type: textblock
27524 #. type: textblock
27525 #: ../fish/guestfish-actions.pod:2675
27526 msgid "See also L</is-lv>."
27527 msgstr ""
27528
27529 # type: =head2
27530 #. type: =head2
27531 #: ../fish/guestfish-actions.pod:2677
27532 msgid "lvm-clear-filter"
27533 msgstr ""
27534
27535 # type: verbatim
27536 #. type: verbatim
27537 #: ../fish/guestfish-actions.pod:2679
27538 #, no-wrap
27539 msgid ""
27540 " lvm-clear-filter\n"
27541 "\n"
27542 msgstr ""
27543
27544 # type: textblock
27545 #. type: textblock
27546 #: ../fish/guestfish-actions.pod:2681
27547 msgid ""
27548 "This undoes the effect of L</lvm-set-filter>.  LVM will be able to see every "
27549 "block device."
27550 msgstr ""
27551
27552 # type: =head2
27553 #. type: =head2
27554 #: ../fish/guestfish-actions.pod:2687
27555 msgid "lvm-remove-all"
27556 msgstr ""
27557
27558 # type: verbatim
27559 #. type: verbatim
27560 #: ../fish/guestfish-actions.pod:2689
27561 #, no-wrap
27562 msgid ""
27563 " lvm-remove-all\n"
27564 "\n"
27565 msgstr ""
27566
27567 # type: =head2
27568 #. type: =head2
27569 #: ../fish/guestfish-actions.pod:2697
27570 msgid "lvm-set-filter"
27571 msgstr ""
27572
27573 # type: verbatim
27574 #. type: verbatim
27575 #: ../fish/guestfish-actions.pod:2699
27576 #, no-wrap
27577 msgid ""
27578 " lvm-set-filter 'devices ...'\n"
27579 "\n"
27580 msgstr ""
27581
27582 # type: =head2
27583 #. type: =head2
27584 #: ../fish/guestfish-actions.pod:2724
27585 msgid "lvremove"
27586 msgstr ""
27587
27588 # type: verbatim
27589 #. type: verbatim
27590 #: ../fish/guestfish-actions.pod:2726
27591 #, no-wrap
27592 msgid ""
27593 " lvremove device\n"
27594 "\n"
27595 msgstr ""
27596
27597 # type: =head2
27598 #. type: =head2
27599 #: ../fish/guestfish-actions.pod:2734
27600 msgid "lvrename"
27601 msgstr ""
27602
27603 # type: verbatim
27604 #. type: verbatim
27605 #: ../fish/guestfish-actions.pod:2736
27606 #, no-wrap
27607 msgid ""
27608 " lvrename logvol newlogvol\n"
27609 "\n"
27610 msgstr ""
27611
27612 # type: =head2
27613 #. type: =head2
27614 #: ../fish/guestfish-actions.pod:2740
27615 msgid "lvresize"
27616 msgstr ""
27617
27618 # type: verbatim
27619 #. type: verbatim
27620 #: ../fish/guestfish-actions.pod:2742
27621 #, no-wrap
27622 msgid ""
27623 " lvresize device mbytes\n"
27624 "\n"
27625 msgstr ""
27626
27627 # type: =head2
27628 #. type: =head2
27629 #: ../fish/guestfish-actions.pod:2748
27630 msgid "lvresize-free"
27631 msgstr ""
27632
27633 # type: verbatim
27634 #. type: verbatim
27635 #: ../fish/guestfish-actions.pod:2750
27636 #, no-wrap
27637 msgid ""
27638 " lvresize-free lv percent\n"
27639 "\n"
27640 msgstr ""
27641
27642 # type: =head2
27643 #. type: =head2
27644 #: ../fish/guestfish-actions.pod:2758
27645 msgid "lvs"
27646 msgstr ""
27647
27648 # type: verbatim
27649 #. type: verbatim
27650 #: ../fish/guestfish-actions.pod:2760
27651 #, no-wrap
27652 msgid ""
27653 " lvs\n"
27654 "\n"
27655 msgstr ""
27656
27657 # type: textblock
27658 #. type: textblock
27659 #: ../fish/guestfish-actions.pod:2768
27660 msgid "See also L</lvs-full>, L</list-filesystems>."
27661 msgstr ""
27662
27663 # type: =head2
27664 #. type: =head2
27665 #: ../fish/guestfish-actions.pod:2770
27666 msgid "lvs-full"
27667 msgstr ""
27668
27669 # type: verbatim
27670 #. type: verbatim
27671 #: ../fish/guestfish-actions.pod:2772
27672 #, no-wrap
27673 msgid ""
27674 " lvs-full\n"
27675 "\n"
27676 msgstr ""
27677
27678 # type: =head2
27679 #. type: =head2
27680 #: ../fish/guestfish-actions.pod:2777
27681 msgid "lvuuid"
27682 msgstr ""
27683
27684 # type: verbatim
27685 #. type: verbatim
27686 #: ../fish/guestfish-actions.pod:2779
27687 #, no-wrap
27688 msgid ""
27689 " lvuuid device\n"
27690 "\n"
27691 msgstr ""
27692
27693 # type: =head2
27694 #. type: =head2
27695 #: ../fish/guestfish-actions.pod:2783
27696 msgid "lxattrlist"
27697 msgstr ""
27698
27699 # type: verbatim
27700 #. type: verbatim
27701 #: ../fish/guestfish-actions.pod:2785
27702 #, no-wrap
27703 msgid ""
27704 " lxattrlist path 'names ...'\n"
27705 "\n"
27706 msgstr ""
27707
27708 # type: textblock
27709 #. type: textblock
27710 #: ../fish/guestfish-actions.pod:2801
27711 msgid ""
27712 "This call is intended for programs that want to efficiently list a directory "
27713 "contents without making many round-trips.  See also L</lstatlist> for a "
27714 "similarly efficient call for getting standard stats.  Very long directory "
27715 "listings might cause the protocol message size to be exceeded, causing this "
27716 "call to fail.  The caller must split up such requests into smaller groups of "
27717 "names."
27718 msgstr ""
27719
27720 # type: =head2
27721 #. type: =head2
27722 #: ../fish/guestfish-actions.pod:2809
27723 msgid "mkdir"
27724 msgstr ""
27725
27726 # type: verbatim
27727 #. type: verbatim
27728 #: ../fish/guestfish-actions.pod:2811
27729 #, no-wrap
27730 msgid ""
27731 " mkdir path\n"
27732 "\n"
27733 msgstr ""
27734
27735 # type: =head2
27736 #. type: =head2
27737 #: ../fish/guestfish-actions.pod:2815
27738 msgid "mkdir-mode"
27739 msgstr ""
27740
27741 # type: verbatim
27742 #. type: verbatim
27743 #: ../fish/guestfish-actions.pod:2817
27744 #, no-wrap
27745 msgid ""
27746 " mkdir-mode path mode\n"
27747 "\n"
27748 msgstr ""
27749
27750 # type: textblock
27751 #. type: textblock
27752 #: ../fish/guestfish-actions.pod:2826
27753 msgid "See also L</mkdir>, L</umask>"
27754 msgstr ""
27755
27756 # type: =head2
27757 #. type: =head2
27758 #: ../fish/guestfish-actions.pod:2828
27759 msgid "mkdir-p"
27760 msgstr ""
27761
27762 # type: verbatim
27763 #. type: verbatim
27764 #: ../fish/guestfish-actions.pod:2830
27765 #, no-wrap
27766 msgid ""
27767 " mkdir-p path\n"
27768 "\n"
27769 msgstr ""
27770
27771 # type: =head2
27772 #. type: =head2
27773 #: ../fish/guestfish-actions.pod:2835
27774 msgid "mkdtemp"
27775 msgstr ""
27776
27777 # type: verbatim
27778 #. type: verbatim
27779 #: ../fish/guestfish-actions.pod:2837
27780 #, no-wrap
27781 msgid ""
27782 " mkdtemp template\n"
27783 "\n"
27784 msgstr ""
27785
27786 # type: =head2
27787 #. type: =head2
27788 #: ../fish/guestfish-actions.pod:2858
27789 msgid "mke2fs-J"
27790 msgstr ""
27791
27792 # type: verbatim
27793 #. type: verbatim
27794 #: ../fish/guestfish-actions.pod:2860
27795 #, no-wrap
27796 msgid ""
27797 " mke2fs-J fstype blocksize device journal\n"
27798 "\n"
27799 msgstr ""
27800
27801 # type: textblock
27802 #. type: textblock
27803 #: ../fish/guestfish-actions.pod:2868
27804 msgid "See also L</mke2journal>."
27805 msgstr ""
27806
27807 # type: =head2
27808 #. type: =head2
27809 #: ../fish/guestfish-actions.pod:2870
27810 msgid "mke2fs-JL"
27811 msgstr ""
27812
27813 # type: verbatim
27814 #. type: verbatim
27815 #: ../fish/guestfish-actions.pod:2872
27816 #, no-wrap
27817 msgid ""
27818 " mke2fs-JL fstype blocksize device label\n"
27819 "\n"
27820 msgstr ""
27821
27822 # type: textblock
27823 #. type: textblock
27824 #: ../fish/guestfish-actions.pod:2877
27825 msgid "See also L</mke2journal-L>."
27826 msgstr ""
27827
27828 # type: =head2
27829 #. type: =head2
27830 #: ../fish/guestfish-actions.pod:2879
27831 msgid "mke2fs-JU"
27832 msgstr ""
27833
27834 # type: verbatim
27835 #. type: verbatim
27836 #: ../fish/guestfish-actions.pod:2881
27837 #, no-wrap
27838 msgid ""
27839 " mke2fs-JU fstype blocksize device uuid\n"
27840 "\n"
27841 msgstr ""
27842
27843 # type: textblock
27844 #. type: textblock
27845 #: ../fish/guestfish-actions.pod:2886
27846 msgid "See also L</mke2journal-U>."
27847 msgstr ""
27848
27849 # type: =head2
27850 #. type: =head2
27851 #: ../fish/guestfish-actions.pod:2888
27852 msgid "mke2journal"
27853 msgstr ""
27854
27855 # type: verbatim
27856 #. type: verbatim
27857 #: ../fish/guestfish-actions.pod:2890
27858 #, no-wrap
27859 msgid ""
27860 " mke2journal blocksize device\n"
27861 "\n"
27862 msgstr ""
27863
27864 # type: =head2
27865 #. type: =head2
27866 #: ../fish/guestfish-actions.pod:2897
27867 msgid "mke2journal-L"
27868 msgstr ""
27869
27870 # type: verbatim
27871 #. type: verbatim
27872 #: ../fish/guestfish-actions.pod:2899
27873 #, no-wrap
27874 msgid ""
27875 " mke2journal-L blocksize label device\n"
27876 "\n"
27877 msgstr ""
27878
27879 # type: =head2
27880 #. type: =head2
27881 #: ../fish/guestfish-actions.pod:2903
27882 msgid "mke2journal-U"
27883 msgstr ""
27884
27885 # type: verbatim
27886 #. type: verbatim
27887 #: ../fish/guestfish-actions.pod:2905
27888 #, no-wrap
27889 msgid ""
27890 " mke2journal-U blocksize uuid device\n"
27891 "\n"
27892 msgstr ""
27893
27894 # type: =head2
27895 #. type: =head2
27896 #: ../fish/guestfish-actions.pod:2909
27897 msgid "mkfifo"
27898 msgstr ""
27899
27900 # type: verbatim
27901 #. type: verbatim
27902 #: ../fish/guestfish-actions.pod:2911
27903 #, no-wrap
27904 msgid ""
27905 " mkfifo mode path\n"
27906 "\n"
27907 msgstr ""
27908
27909 # type: textblock
27910 #. type: textblock
27911 #: ../fish/guestfish-actions.pod:2913
27912 msgid ""
27913 "This call creates a FIFO (named pipe) called C<path> with mode C<mode>.  It "
27914 "is just a convenient wrapper around L</mknod>."
27915 msgstr ""
27916
27917 # type: =head2
27918 #. type: =head2
27919 #: ../fish/guestfish-actions.pod:2919
27920 msgid "mkfs"
27921 msgstr ""
27922
27923 # type: verbatim
27924 #. type: verbatim
27925 #: ../fish/guestfish-actions.pod:2921
27926 #, no-wrap
27927 msgid ""
27928 " mkfs fstype device\n"
27929 "\n"
27930 msgstr ""
27931
27932 # type: =head2
27933 #. type: =head2
27934 #: ../fish/guestfish-actions.pod:2927
27935 msgid "mkfs-b"
27936 msgstr ""
27937
27938 # type: verbatim
27939 #. type: verbatim
27940 #: ../fish/guestfish-actions.pod:2929
27941 #, no-wrap
27942 msgid ""
27943 " mkfs-b fstype blocksize device\n"
27944 "\n"
27945 msgstr ""
27946
27947 # type: textblock
27948 #. type: textblock
27949 #: ../fish/guestfish-actions.pod:2931
27950 msgid ""
27951 "This call is similar to L</mkfs>, but it allows you to control the block "
27952 "size of the resulting filesystem.  Supported block sizes depend on the "
27953 "filesystem type, but typically they are C<1024>, C<2048> or C<4096> only."
27954 msgstr ""
27955
27956 # type: =head2
27957 #. type: =head2
27958 #: ../fish/guestfish-actions.pod:2946
27959 msgid "mkfs-opts"
27960 msgstr ""
27961
27962 #. type: verbatim
27963 #: ../fish/guestfish-actions.pod:2948
27964 #, no-wrap
27965 msgid ""
27966 " mkfs-opts fstype device [blocksize:..] [features:..]\n"
27967 "\n"
27968 msgstr ""
27969
27970 # type: =head2
27971 #. type: =head2
27972 #: ../fish/guestfish-actions.pod:2983
27973 msgid "mkmountpoint"
27974 msgstr ""
27975
27976 # type: verbatim
27977 #. type: verbatim
27978 #: ../fish/guestfish-actions.pod:2985
27979 #, no-wrap
27980 msgid ""
27981 " mkmountpoint exemptpath\n"
27982 "\n"
27983 msgstr ""
27984
27985 # type: textblock
27986 #. type: textblock
27987 #: ../fish/guestfish-actions.pod:2987
27988 msgid ""
27989 "L</mkmountpoint> and L</rmmountpoint> are specialized calls that can be used "
27990 "to create extra mountpoints before mounting the first filesystem."
27991 msgstr ""
27992
27993 # type: textblock
27994 #. type: textblock
27995 #: ../fish/guestfish-actions.pod:3011
27996 msgid ""
27997 "L</mkmountpoint> is not compatible with L</umount-all>.  You may get "
27998 "unexpected errors if you try to mix these calls.  It is safest to manually "
27999 "unmount filesystems and remove mountpoints after use."
28000 msgstr ""
28001
28002 # type: textblock
28003 #. type: textblock
28004 #: ../fish/guestfish-actions.pod:3015
28005 msgid ""
28006 "L</umount-all> unmounts filesystems by sorting the paths longest first, so "
28007 "for this to work for manual mountpoints, you must ensure that the innermost "
28008 "mountpoints have the longest pathnames, as in the example code above."
28009 msgstr ""
28010
28011 #. type: textblock
28012 #: ../fish/guestfish-actions.pod:3022
28013 msgid ""
28014 "Autosync [see L</set-autosync>, this is set by default on handles] can cause "
28015 "L</umount-all> to be called when the handle is closed which can also trigger "
28016 "these issues."
28017 msgstr ""
28018
28019 # type: =head2
28020 #. type: =head2
28021 #: ../fish/guestfish-actions.pod:3026
28022 msgid "mknod"
28023 msgstr ""
28024
28025 # type: verbatim
28026 #. type: verbatim
28027 #: ../fish/guestfish-actions.pod:3028
28028 #, no-wrap
28029 msgid ""
28030 " mknod mode devmajor devminor path\n"
28031 "\n"
28032 msgstr ""
28033
28034 # type: textblock
28035 #. type: textblock
28036 #: ../fish/guestfish-actions.pod:3038
28037 msgid ""
28038 "Note that, just like L<mknod(2)>, the mode must be bitwise OR'd with "
28039 "S_IFBLK, S_IFCHR, S_IFIFO or S_IFSOCK (otherwise this call just creates a "
28040 "regular file).  These constants are available in the standard Linux header "
28041 "files, or you can use L</mknod-b>, L</mknod-c> or L</mkfifo> which are "
28042 "wrappers around this command which bitwise OR in the appropriate constant "
28043 "for you."
28044 msgstr ""
28045
28046 # type: =head2
28047 #. type: =head2
28048 #: ../fish/guestfish-actions.pod:3048
28049 msgid "mknod-b"
28050 msgstr ""
28051
28052 # type: verbatim
28053 #. type: verbatim
28054 #: ../fish/guestfish-actions.pod:3050
28055 #, no-wrap
28056 msgid ""
28057 " mknod-b mode devmajor devminor path\n"
28058 "\n"
28059 msgstr ""
28060
28061 # type: textblock
28062 #. type: textblock
28063 #: ../fish/guestfish-actions.pod:3052
28064 msgid ""
28065 "This call creates a block device node called C<path> with mode C<mode> and "
28066 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
28067 "wrapper around L</mknod>."
28068 msgstr ""
28069
28070 # type: =head2
28071 #. type: =head2
28072 #: ../fish/guestfish-actions.pod:3058
28073 msgid "mknod-c"
28074 msgstr ""
28075
28076 # type: verbatim
28077 #. type: verbatim
28078 #: ../fish/guestfish-actions.pod:3060
28079 #, no-wrap
28080 msgid ""
28081 " mknod-c mode devmajor devminor path\n"
28082 "\n"
28083 msgstr ""
28084
28085 # type: textblock
28086 #. type: textblock
28087 #: ../fish/guestfish-actions.pod:3062
28088 msgid ""
28089 "This call creates a char device node called C<path> with mode C<mode> and "
28090 "device major/minor C<devmajor> and C<devminor>.  It is just a convenient "
28091 "wrapper around L</mknod>."
28092 msgstr ""
28093
28094 # type: =head2
28095 #. type: =head2
28096 #: ../fish/guestfish-actions.pod:3068
28097 msgid "mkswap"
28098 msgstr ""
28099
28100 # type: verbatim
28101 #. type: verbatim
28102 #: ../fish/guestfish-actions.pod:3070
28103 #, no-wrap
28104 msgid ""
28105 " mkswap device\n"
28106 "\n"
28107 msgstr ""
28108
28109 # type: =head2
28110 #. type: =head2
28111 #: ../fish/guestfish-actions.pod:3074
28112 msgid "mkswap-L"
28113 msgstr ""
28114
28115 # type: verbatim
28116 #. type: verbatim
28117 #: ../fish/guestfish-actions.pod:3076
28118 #, no-wrap
28119 msgid ""
28120 " mkswap-L label device\n"
28121 "\n"
28122 msgstr ""
28123
28124 # type: =head2
28125 #. type: =head2
28126 #: ../fish/guestfish-actions.pod:3084
28127 msgid "mkswap-U"
28128 msgstr ""
28129
28130 # type: verbatim
28131 #. type: verbatim
28132 #: ../fish/guestfish-actions.pod:3086
28133 #, no-wrap
28134 msgid ""
28135 " mkswap-U uuid device\n"
28136 "\n"
28137 msgstr ""
28138
28139 # type: =head2
28140 #. type: =head2
28141 #: ../fish/guestfish-actions.pod:3090
28142 msgid "mkswap-file"
28143 msgstr ""
28144
28145 # type: verbatim
28146 #. type: verbatim
28147 #: ../fish/guestfish-actions.pod:3092
28148 #, no-wrap
28149 msgid ""
28150 " mkswap-file path\n"
28151 "\n"
28152 msgstr ""
28153
28154 # type: textblock
28155 #. type: textblock
28156 #: ../fish/guestfish-actions.pod:3096
28157 msgid ""
28158 "This command just writes a swap file signature to an existing file.  To "
28159 "create the file itself, use something like L</fallocate>."
28160 msgstr ""
28161
28162 # type: =head2
28163 #. type: =head2
28164 #: ../fish/guestfish-actions.pod:3099
28165 msgid "modprobe"
28166 msgstr ""
28167
28168 # type: verbatim
28169 #. type: verbatim
28170 #: ../fish/guestfish-actions.pod:3101
28171 #, no-wrap
28172 msgid ""
28173 " modprobe modulename\n"
28174 "\n"
28175 msgstr ""
28176
28177 # type: =head2
28178 #. type: =head2
28179 #: ../fish/guestfish-actions.pod:3108
28180 msgid "mount"
28181 msgstr ""
28182
28183 # type: verbatim
28184 #. type: verbatim
28185 #: ../fish/guestfish-actions.pod:3110
28186 #, no-wrap
28187 msgid ""
28188 " mount device mountpoint\n"
28189 "\n"
28190 msgstr ""
28191
28192 # type: textblock
28193 #. type: textblock
28194 #: ../fish/guestfish-actions.pod:3126
28195 msgid ""
28196 "B<Important note:> When you use this call, the filesystem options C<sync> "
28197 "and C<noatime> are set implicitly.  This was originally done because we "
28198 "thought it would improve reliability, but it turns out that I<-o sync> has a "
28199 "very large negative performance impact and negligible effect on "
28200 "reliability.  Therefore we recommend that you avoid using L</mount> in any "
28201 "code that needs performance, and instead use L</mount-options> (use an empty "
28202 "string for the first parameter if you don't want any options)."
28203 msgstr ""
28204
28205 # type: =head2
28206 #. type: =head2
28207 #: ../fish/guestfish-actions.pod:3136
28208 msgid "mount-loop"
28209 msgstr ""
28210
28211 # type: verbatim
28212 #. type: verbatim
28213 #: ../fish/guestfish-actions.pod:3138
28214 #, no-wrap
28215 msgid ""
28216 " mount-loop file mountpoint\n"
28217 "\n"
28218 msgstr ""
28219
28220 # type: =head2
28221 #. type: =head2
28222 #: ../fish/guestfish-actions.pod:3144
28223 msgid "mount-options"
28224 msgstr ""
28225
28226 # type: verbatim
28227 #. type: verbatim
28228 #: ../fish/guestfish-actions.pod:3146
28229 #, no-wrap
28230 msgid ""
28231 " mount-options options device mountpoint\n"
28232 "\n"
28233 msgstr ""
28234
28235 # type: textblock
28236 #. type: textblock
28237 #: ../fish/guestfish-actions.pod:3148
28238 msgid ""
28239 "This is the same as the L</mount> command, but it allows you to set the "
28240 "mount options as for the L<mount(8)> I<-o> flag."
28241 msgstr ""
28242
28243 # type: =head2
28244 #. type: =head2
28245 #: ../fish/guestfish-actions.pod:3156
28246 msgid "mount-ro"
28247 msgstr ""
28248
28249 # type: verbatim
28250 #. type: verbatim
28251 #: ../fish/guestfish-actions.pod:3158
28252 #, no-wrap
28253 msgid ""
28254 " mount-ro device mountpoint\n"
28255 "\n"
28256 msgstr ""
28257
28258 # type: textblock
28259 #. type: textblock
28260 #: ../fish/guestfish-actions.pod:3160
28261 msgid ""
28262 "This is the same as the L</mount> command, but it mounts the filesystem with "
28263 "the read-only (I<-o ro>) flag."
28264 msgstr ""
28265
28266 # type: =head2
28267 #. type: =head2
28268 #: ../fish/guestfish-actions.pod:3163
28269 msgid "mount-vfs"
28270 msgstr ""
28271
28272 # type: verbatim
28273 #. type: verbatim
28274 #: ../fish/guestfish-actions.pod:3165
28275 #, no-wrap
28276 msgid ""
28277 " mount-vfs options vfstype device mountpoint\n"
28278 "\n"
28279 msgstr ""
28280
28281 # type: textblock
28282 #. type: textblock
28283 #: ../fish/guestfish-actions.pod:3167
28284 msgid ""
28285 "This is the same as the L</mount> command, but it allows you to set both the "
28286 "mount options and the vfstype as for the L<mount(8)> I<-o> and I<-t> flags."
28287 msgstr ""
28288
28289 # type: =head2
28290 #. type: =head2
28291 #: ../fish/guestfish-actions.pod:3171
28292 msgid "mountpoints"
28293 msgstr ""
28294
28295 # type: verbatim
28296 #. type: verbatim
28297 #: ../fish/guestfish-actions.pod:3173
28298 #, no-wrap
28299 msgid ""
28300 " mountpoints\n"
28301 "\n"
28302 msgstr ""
28303
28304 # type: textblock
28305 #. type: textblock
28306 #: ../fish/guestfish-actions.pod:3175
28307 msgid ""
28308 "This call is similar to L</mounts>.  That call returns a list of devices.  "
28309 "This one returns a hash table (map) of device name to directory where the "
28310 "device is mounted."
28311 msgstr ""
28312
28313 # type: =head2
28314 #. type: =head2
28315 #: ../fish/guestfish-actions.pod:3179
28316 msgid "mounts"
28317 msgstr ""
28318
28319 # type: verbatim
28320 #. type: verbatim
28321 #: ../fish/guestfish-actions.pod:3181
28322 #, no-wrap
28323 msgid ""
28324 " mounts\n"
28325 "\n"
28326 msgstr ""
28327
28328 # type: textblock
28329 #. type: textblock
28330 #: ../fish/guestfish-actions.pod:3188
28331 msgid "See also: L</mountpoints>"
28332 msgstr ""
28333
28334 # type: =head2
28335 #. type: =head2
28336 #: ../fish/guestfish-actions.pod:3190
28337 msgid "mv"
28338 msgstr ""
28339
28340 # type: verbatim
28341 #. type: verbatim
28342 #: ../fish/guestfish-actions.pod:3192
28343 #, no-wrap
28344 msgid ""
28345 " mv src dest\n"
28346 "\n"
28347 msgstr ""
28348
28349 # type: =head2
28350 #. type: =head2
28351 #: ../fish/guestfish-actions.pod:3197
28352 msgid "ntfs-3g-probe"
28353 msgstr ""
28354
28355 # type: verbatim
28356 #. type: verbatim
28357 #: ../fish/guestfish-actions.pod:3199
28358 #, no-wrap
28359 msgid ""
28360 " ntfs-3g-probe true|false device\n"
28361 "\n"
28362 msgstr ""
28363
28364 # type: =head2
28365 #. type: =head2
28366 #: ../fish/guestfish-actions.pod:3213
28367 msgid "ntfsresize"
28368 msgstr ""
28369
28370 # type: verbatim
28371 #. type: verbatim
28372 #: ../fish/guestfish-actions.pod:3215
28373 #, no-wrap
28374 msgid ""
28375 " ntfsresize device\n"
28376 "\n"
28377 msgstr ""
28378
28379 # type: =head2
28380 #. type: =head2
28381 #: ../fish/guestfish-actions.pod:3221
28382 msgid "ntfsresize-size"
28383 msgstr ""
28384
28385 # type: verbatim
28386 #. type: verbatim
28387 #: ../fish/guestfish-actions.pod:3223
28388 #, no-wrap
28389 msgid ""
28390 " ntfsresize-size device size\n"
28391 "\n"
28392 msgstr ""
28393
28394 # type: textblock
28395 #. type: textblock
28396 #: ../fish/guestfish-actions.pod:3225
28397 msgid ""
28398 "This command is the same as L</ntfsresize> except that it allows you to "
28399 "specify the new size (in bytes) explicitly."
28400 msgstr ""
28401
28402 # type: =head2
28403 #. type: =head2
28404 #: ../fish/guestfish-actions.pod:3228
28405 msgid "part-add"
28406 msgstr ""
28407
28408 # type: verbatim
28409 #. type: verbatim
28410 #: ../fish/guestfish-actions.pod:3230
28411 #, no-wrap
28412 msgid ""
28413 " part-add device prlogex startsect endsect\n"
28414 "\n"
28415 msgstr ""
28416
28417 # type: textblock
28418 #. type: textblock
28419 #: ../fish/guestfish-actions.pod:3232
28420 msgid ""
28421 "This command adds a partition to C<device>.  If there is no partition table "
28422 "on the device, call L</part-init> first."
28423 msgstr ""
28424
28425 # type: textblock
28426 #. type: textblock
28427 #: ../fish/guestfish-actions.pod:3244
28428 msgid ""
28429 "Creating a partition which covers the whole disk is not so easy.  Use L</"
28430 "part-disk> to do that."
28431 msgstr ""
28432
28433 # type: =head2
28434 #. type: =head2
28435 #: ../fish/guestfish-actions.pod:3247
28436 msgid "part-del"
28437 msgstr ""
28438
28439 # type: verbatim
28440 #. type: verbatim
28441 #: ../fish/guestfish-actions.pod:3249
28442 #, no-wrap
28443 msgid ""
28444 " part-del device partnum\n"
28445 "\n"
28446 msgstr ""
28447
28448 # type: =head2
28449 #. type: =head2
28450 #: ../fish/guestfish-actions.pod:3257
28451 msgid "part-disk"
28452 msgstr ""
28453
28454 # type: verbatim
28455 #. type: verbatim
28456 #: ../fish/guestfish-actions.pod:3259
28457 #, no-wrap
28458 msgid ""
28459 " part-disk device parttype\n"
28460 "\n"
28461 msgstr ""
28462
28463 # type: textblock
28464 #. type: textblock
28465 #: ../fish/guestfish-actions.pod:3261
28466 msgid ""
28467 "This command is simply a combination of L</part-init> followed by L</part-"
28468 "add> to create a single primary partition covering the whole disk."
28469 msgstr ""
28470
28471 # type: textblock
28472 #. type: textblock
28473 #: ../fish/guestfish-actions.pod:3265
28474 msgid ""
28475 "C<parttype> is the partition table type, usually C<mbr> or C<gpt>, but other "
28476 "possible values are described in L</part-init>."
28477 msgstr ""
28478
28479 # type: =head2
28480 #. type: =head2
28481 #: ../fish/guestfish-actions.pod:3271
28482 msgid "part-get-bootable"
28483 msgstr ""
28484
28485 # type: verbatim
28486 #. type: verbatim
28487 #: ../fish/guestfish-actions.pod:3273
28488 #, no-wrap
28489 msgid ""
28490 " part-get-bootable device partnum\n"
28491 "\n"
28492 msgstr ""
28493
28494 # type: textblock
28495 #. type: textblock
28496 #: ../fish/guestfish-actions.pod:3278
28497 msgid "See also L</part-set-bootable>."
28498 msgstr ""
28499
28500 # type: =head2
28501 #. type: =head2
28502 #: ../fish/guestfish-actions.pod:3280
28503 msgid "part-get-mbr-id"
28504 msgstr ""
28505
28506 # type: verbatim
28507 #. type: verbatim
28508 #: ../fish/guestfish-actions.pod:3282
28509 #, no-wrap
28510 msgid ""
28511 " part-get-mbr-id device partnum\n"
28512 "\n"
28513 msgstr ""
28514
28515 # type: textblock
28516 #. type: textblock
28517 #: ../fish/guestfish-actions.pod:3287 ../fish/guestfish-actions.pod:3425
28518 msgid ""
28519 "Note that only MBR (old DOS-style) partitions have type bytes.  You will get "
28520 "undefined results for other partition table types (see L</part-get-"
28521 "parttype>)."
28522 msgstr ""
28523
28524 # type: =head2
28525 #. type: =head2
28526 #: ../fish/guestfish-actions.pod:3291
28527 msgid "part-get-parttype"
28528 msgstr ""
28529
28530 # type: verbatim
28531 #. type: verbatim
28532 #: ../fish/guestfish-actions.pod:3293
28533 #, no-wrap
28534 msgid ""
28535 " part-get-parttype device\n"
28536 "\n"
28537 msgstr ""
28538
28539 # type: textblock
28540 #. type: textblock
28541 #: ../fish/guestfish-actions.pod:3298
28542 msgid ""
28543 "Common return values include: C<msdos> (a DOS/Windows style MBR partition "
28544 "table), C<gpt> (a GPT/EFI-style partition table).  Other values are "
28545 "possible, although unusual.  See L</part-init> for a full list."
28546 msgstr ""
28547
28548 # type: =head2
28549 #. type: =head2
28550 #: ../fish/guestfish-actions.pod:3303
28551 msgid "part-init"
28552 msgstr ""
28553
28554 # type: verbatim
28555 #. type: verbatim
28556 #: ../fish/guestfish-actions.pod:3305
28557 #, no-wrap
28558 msgid ""
28559 " part-init device parttype\n"
28560 "\n"
28561 msgstr ""
28562
28563 # type: textblock
28564 #. type: textblock
28565 #: ../fish/guestfish-actions.pod:3311
28566 msgid ""
28567 "Initially there are no partitions.  Following this, you should call L</part-"
28568 "add> for each partition required."
28569 msgstr ""
28570
28571 # type: =head2
28572 #. type: =head2
28573 #: ../fish/guestfish-actions.pod:3374
28574 msgid "part-list"
28575 msgstr ""
28576
28577 # type: verbatim
28578 #. type: verbatim
28579 #: ../fish/guestfish-actions.pod:3376
28580 #, no-wrap
28581 msgid ""
28582 " part-list device\n"
28583 "\n"
28584 msgstr ""
28585
28586 # type: textblock
28587 #. type: textblock
28588 #: ../fish/guestfish-actions.pod:3391
28589 msgid ""
28590 "Start of the partition I<in bytes>.  To get sectors you have to divide by "
28591 "the device's sector size, see L</blockdev-getss>."
28592 msgstr ""
28593
28594 # type: =head2
28595 #. type: =head2
28596 #: ../fish/guestfish-actions.pod:3404
28597 msgid "part-set-bootable"
28598 msgstr ""
28599
28600 # type: verbatim
28601 #. type: verbatim
28602 #: ../fish/guestfish-actions.pod:3406
28603 #, no-wrap
28604 msgid ""
28605 " part-set-bootable device partnum true|false\n"
28606 "\n"
28607 msgstr ""
28608
28609 # type: =head2
28610 #. type: =head2
28611 #: ../fish/guestfish-actions.pod:3415
28612 msgid "part-set-mbr-id"
28613 msgstr ""
28614
28615 # type: verbatim
28616 #. type: verbatim
28617 #: ../fish/guestfish-actions.pod:3417
28618 #, no-wrap
28619 msgid ""
28620 " part-set-mbr-id device partnum idbyte\n"
28621 "\n"
28622 msgstr ""
28623
28624 # type: =head2
28625 #. type: =head2
28626 #: ../fish/guestfish-actions.pod:3429
28627 msgid "part-set-name"
28628 msgstr ""
28629
28630 # type: verbatim
28631 #. type: verbatim
28632 #: ../fish/guestfish-actions.pod:3431
28633 #, no-wrap
28634 msgid ""
28635 " part-set-name device partnum name\n"
28636 "\n"
28637 msgstr ""
28638
28639 # type: =head2
28640 #. type: =head2
28641 #: ../fish/guestfish-actions.pod:3439
28642 msgid "part-to-dev"
28643 msgstr ""
28644
28645 # type: verbatim
28646 #. type: verbatim
28647 #: ../fish/guestfish-actions.pod:3441
28648 #, no-wrap
28649 msgid ""
28650 " part-to-dev partition\n"
28651 "\n"
28652 msgstr ""
28653
28654 # type: textblock
28655 #. type: textblock
28656 #: ../fish/guestfish-actions.pod:3447
28657 msgid ""
28658 "The named partition must exist, for example as a string returned from L</"
28659 "list-partitions>."
28660 msgstr ""
28661
28662 # type: =head2
28663 #. type: =head2
28664 #: ../fish/guestfish-actions.pod:3450
28665 msgid "ping-daemon"
28666 msgstr ""
28667
28668 # type: verbatim
28669 #. type: verbatim
28670 #: ../fish/guestfish-actions.pod:3452
28671 #, no-wrap
28672 msgid ""
28673 " ping-daemon\n"
28674 "\n"
28675 msgstr ""
28676
28677 # type: =head2
28678 #. type: =head2
28679 #: ../fish/guestfish-actions.pod:3459
28680 msgid "pread"
28681 msgstr ""
28682
28683 # type: verbatim
28684 #. type: verbatim
28685 #: ../fish/guestfish-actions.pod:3461
28686 #, no-wrap
28687 msgid ""
28688 " pread path count offset\n"
28689 "\n"
28690 msgstr ""
28691
28692 # type: textblock
28693 #. type: textblock
28694 #: ../fish/guestfish-actions.pod:3469
28695 msgid "See also L</pwrite>, L</pread-device>."
28696 msgstr ""
28697
28698 # type: =head2
28699 #. type: =head2
28700 #: ../fish/guestfish-actions.pod:3474
28701 msgid "pread-device"
28702 msgstr ""
28703
28704 # type: verbatim
28705 #. type: verbatim
28706 #: ../fish/guestfish-actions.pod:3476
28707 #, no-wrap
28708 msgid ""
28709 " pread-device device count offset\n"
28710 "\n"
28711 msgstr ""
28712
28713 # type: textblock
28714 #. type: textblock
28715 #: ../fish/guestfish-actions.pod:3484
28716 msgid "See also L</pread>."
28717 msgstr ""
28718
28719 # type: =head2
28720 #. type: =head2
28721 #: ../fish/guestfish-actions.pod:3489
28722 msgid "pvcreate"
28723 msgstr ""
28724
28725 # type: verbatim
28726 #. type: verbatim
28727 #: ../fish/guestfish-actions.pod:3491
28728 #, no-wrap
28729 msgid ""
28730 " pvcreate device\n"
28731 "\n"
28732 msgstr ""
28733
28734 # type: =head2
28735 #. type: =head2
28736 #: ../fish/guestfish-actions.pod:3497
28737 msgid "pvremove"
28738 msgstr ""
28739
28740 # type: verbatim
28741 #. type: verbatim
28742 #: ../fish/guestfish-actions.pod:3499
28743 #, no-wrap
28744 msgid ""
28745 " pvremove device\n"
28746 "\n"
28747 msgstr ""
28748
28749 # type: =head2
28750 #. type: =head2
28751 #: ../fish/guestfish-actions.pod:3508
28752 msgid "pvresize"
28753 msgstr ""
28754
28755 # type: verbatim
28756 #. type: verbatim
28757 #: ../fish/guestfish-actions.pod:3510
28758 #, no-wrap
28759 msgid ""
28760 " pvresize device\n"
28761 "\n"
28762 msgstr ""
28763
28764 # type: =head2
28765 #. type: =head2
28766 #: ../fish/guestfish-actions.pod:3515
28767 msgid "pvresize-size"
28768 msgstr ""
28769
28770 # type: verbatim
28771 #. type: verbatim
28772 #: ../fish/guestfish-actions.pod:3517
28773 #, no-wrap
28774 msgid ""
28775 " pvresize-size device size\n"
28776 "\n"
28777 msgstr ""
28778
28779 # type: textblock
28780 #. type: textblock
28781 #: ../fish/guestfish-actions.pod:3519
28782 msgid ""
28783 "This command is the same as L</pvresize> except that it allows you to "
28784 "specify the new size (in bytes) explicitly."
28785 msgstr ""
28786
28787 # type: =head2
28788 #. type: =head2
28789 #: ../fish/guestfish-actions.pod:3522
28790 msgid "pvs"
28791 msgstr ""
28792
28793 # type: verbatim
28794 #. type: verbatim
28795 #: ../fish/guestfish-actions.pod:3524
28796 #, no-wrap
28797 msgid ""
28798 " pvs\n"
28799 "\n"
28800 msgstr ""
28801
28802 # type: textblock
28803 #. type: textblock
28804 #: ../fish/guestfish-actions.pod:3532
28805 msgid "See also L</pvs-full>."
28806 msgstr ""
28807
28808 # type: =head2
28809 #. type: =head2
28810 #: ../fish/guestfish-actions.pod:3534
28811 msgid "pvs-full"
28812 msgstr ""
28813
28814 # type: verbatim
28815 #. type: verbatim
28816 #: ../fish/guestfish-actions.pod:3536
28817 #, no-wrap
28818 msgid ""
28819 " pvs-full\n"
28820 "\n"
28821 msgstr ""
28822
28823 # type: =head2
28824 #. type: =head2
28825 #: ../fish/guestfish-actions.pod:3541
28826 msgid "pvuuid"
28827 msgstr ""
28828
28829 # type: verbatim
28830 #. type: verbatim
28831 #: ../fish/guestfish-actions.pod:3543
28832 #, no-wrap
28833 msgid ""
28834 " pvuuid device\n"
28835 "\n"
28836 msgstr ""
28837
28838 # type: =head2
28839 #. type: =head2
28840 #: ../fish/guestfish-actions.pod:3547
28841 msgid "pwrite"
28842 msgstr ""
28843
28844 # type: verbatim
28845 #. type: verbatim
28846 #: ../fish/guestfish-actions.pod:3549
28847 #, no-wrap
28848 msgid ""
28849 " pwrite path content offset\n"
28850 "\n"
28851 msgstr ""
28852
28853 # type: textblock
28854 #. type: textblock
28855 #: ../fish/guestfish-actions.pod:3560
28856 msgid "See also L</pread>, L</pwrite-device>."
28857 msgstr ""
28858
28859 # type: =head2
28860 #. type: =head2
28861 #: ../fish/guestfish-actions.pod:3565
28862 msgid "pwrite-device"
28863 msgstr ""
28864
28865 # type: verbatim
28866 #. type: verbatim
28867 #: ../fish/guestfish-actions.pod:3567
28868 #, no-wrap
28869 msgid ""
28870 " pwrite-device device content offset\n"
28871 "\n"
28872 msgstr ""
28873
28874 # type: textblock
28875 #. type: textblock
28876 #: ../fish/guestfish-actions.pod:3577
28877 msgid "See also L</pwrite>."
28878 msgstr ""
28879
28880 # type: =head2
28881 #. type: =head2
28882 #: ../fish/guestfish-actions.pod:3582
28883 msgid "read-file"
28884 msgstr ""
28885
28886 # type: verbatim
28887 #. type: verbatim
28888 #: ../fish/guestfish-actions.pod:3584
28889 #, no-wrap
28890 msgid ""
28891 " read-file path\n"
28892 "\n"
28893 msgstr ""
28894
28895 # type: textblock
28896 #. type: textblock
28897 #: ../fish/guestfish-actions.pod:3589
28898 msgid ""
28899 "Unlike L</cat>, this function can correctly handle files that contain "
28900 "embedded ASCII NUL characters.  However unlike L</download>, this function "
28901 "is limited in the total size of file that can be handled."
28902 msgstr ""
28903
28904 # type: =head2
28905 #. type: =head2
28906 #: ../fish/guestfish-actions.pod:3597
28907 msgid "read-lines"
28908 msgstr ""
28909
28910 # type: verbatim
28911 #. type: verbatim
28912 #: ../fish/guestfish-actions.pod:3599
28913 #, no-wrap
28914 msgid ""
28915 " read-lines path\n"
28916 "\n"
28917 msgstr ""
28918
28919 # type: textblock
28920 #. type: textblock
28921 #: ../fish/guestfish-actions.pod:3606
28922 msgid ""
28923 "Note that this function cannot correctly handle binary files (specifically, "
28924 "files containing C<\\0> character which is treated as end of line).  For "
28925 "those you need to use the L</read-file> function which has a more complex "
28926 "interface."
28927 msgstr ""
28928
28929 # type: =head2
28930 #. type: =head2
28931 #: ../fish/guestfish-actions.pod:3611
28932 msgid "readdir"
28933 msgstr ""
28934
28935 # type: verbatim
28936 #. type: verbatim
28937 #: ../fish/guestfish-actions.pod:3613
28938 #, no-wrap
28939 msgid ""
28940 " readdir dir\n"
28941 "\n"
28942 msgstr ""
28943
28944 # type: textblock
28945 #. type: textblock
28946 #: ../fish/guestfish-actions.pod:3665
28947 msgid ""
28948 "This function is primarily intended for use by programs.  To get a simple "
28949 "list of names, use L</ls>.  To get a printable directory for human "
28950 "consumption, use L</ll>."
28951 msgstr ""
28952
28953 # type: =head2
28954 #. type: =head2
28955 #: ../fish/guestfish-actions.pod:3669
28956 msgid "readlink"
28957 msgstr ""
28958
28959 # type: verbatim
28960 #. type: verbatim
28961 #: ../fish/guestfish-actions.pod:3671
28962 #, no-wrap
28963 msgid ""
28964 " readlink path\n"
28965 "\n"
28966 msgstr ""
28967
28968 # type: =head2
28969 #. type: =head2
28970 #: ../fish/guestfish-actions.pod:3675
28971 msgid "readlinklist"
28972 msgstr ""
28973
28974 # type: verbatim
28975 #. type: verbatim
28976 #: ../fish/guestfish-actions.pod:3677
28977 #, no-wrap
28978 msgid ""
28979 " readlinklist path 'names ...'\n"
28980 "\n"
28981 msgstr ""
28982
28983 # type: =head2
28984 #. type: =head2
28985 #: ../fish/guestfish-actions.pod:3701
28986 msgid "realpath"
28987 msgstr ""
28988
28989 # type: verbatim
28990 #. type: verbatim
28991 #: ../fish/guestfish-actions.pod:3703
28992 #, no-wrap
28993 msgid ""
28994 " realpath path\n"
28995 "\n"
28996 msgstr ""
28997
28998 # type: =head2
28999 #. type: =head2
29000 #: ../fish/guestfish-actions.pod:3708
29001 msgid "removexattr"
29002 msgstr ""
29003
29004 # type: verbatim
29005 #. type: verbatim
29006 #: ../fish/guestfish-actions.pod:3710
29007 #, no-wrap
29008 msgid ""
29009 " removexattr xattr path\n"
29010 "\n"
29011 msgstr ""
29012
29013 # type: textblock
29014 #. type: textblock
29015 #: ../fish/guestfish-actions.pod:3715
29016 msgid "See also: L</lremovexattr>, L<attr(5)>."
29017 msgstr ""
29018
29019 # type: =head2
29020 #. type: =head2
29021 #: ../fish/guestfish-actions.pod:3717
29022 msgid "resize2fs"
29023 msgstr ""
29024
29025 # type: verbatim
29026 #. type: verbatim
29027 #: ../fish/guestfish-actions.pod:3719
29028 #, no-wrap
29029 msgid ""
29030 " resize2fs device\n"
29031 "\n"
29032 msgstr ""
29033
29034 # type: textblock
29035 #. type: textblock
29036 #: ../fish/guestfish-actions.pod:3724
29037 msgid ""
29038 "I<Note:> It is sometimes required that you run L</e2fsck-f> on the C<device> "
29039 "before calling this command.  For unknown reasons C<resize2fs> sometimes "
29040 "gives an error about this and sometimes not.  In any case, it is always safe "
29041 "to call L</e2fsck-f> before calling this function."
29042 msgstr ""
29043
29044 #. type: =head2
29045 #: ../fish/guestfish-actions.pod:3730
29046 msgid "resize2fs-M"
29047 msgstr ""
29048
29049 #. type: verbatim
29050 #: ../fish/guestfish-actions.pod:3732
29051 #, no-wrap
29052 msgid ""
29053 " resize2fs-M device\n"
29054 "\n"
29055 msgstr ""
29056
29057 #. type: textblock
29058 #: ../fish/guestfish-actions.pod:3734
29059 msgid ""
29060 "This command is the same as L</resize2fs>, but the filesystem is resized to "
29061 "its minimum size.  This works like the C<-M> option to the C<resize2fs> "
29062 "command."
29063 msgstr ""
29064
29065 #. type: textblock
29066 #: ../fish/guestfish-actions.pod:3738
29067 msgid ""
29068 "To get the resulting size of the filesystem you should call L</tune2fs-l> "
29069 "and read the C<Block size> and C<Block count> values.  These two numbers, "
29070 "multiplied together, give the resulting size of the minimal filesystem in "
29071 "bytes."
29072 msgstr ""
29073
29074 # type: =head2
29075 #. type: =head2
29076 #: ../fish/guestfish-actions.pod:3743
29077 msgid "resize2fs-size"
29078 msgstr ""
29079
29080 # type: verbatim
29081 #. type: verbatim
29082 #: ../fish/guestfish-actions.pod:3745
29083 #, no-wrap
29084 msgid ""
29085 " resize2fs-size device size\n"
29086 "\n"
29087 msgstr ""
29088
29089 # type: textblock
29090 #. type: textblock
29091 #: ../fish/guestfish-actions.pod:3747
29092 msgid ""
29093 "This command is the same as L</resize2fs> except that it allows you to "
29094 "specify the new size (in bytes) explicitly."
29095 msgstr ""
29096
29097 # type: =head2
29098 #. type: =head2
29099 #: ../fish/guestfish-actions.pod:3750
29100 msgid "rm"
29101 msgstr ""
29102
29103 # type: verbatim
29104 #. type: verbatim
29105 #: ../fish/guestfish-actions.pod:3752
29106 #, no-wrap
29107 msgid ""
29108 " rm path\n"
29109 "\n"
29110 msgstr ""
29111
29112 # type: =head2
29113 #. type: =head2
29114 #: ../fish/guestfish-actions.pod:3756
29115 msgid "rm-rf"
29116 msgstr ""
29117
29118 # type: verbatim
29119 #. type: verbatim
29120 #: ../fish/guestfish-actions.pod:3758
29121 #, no-wrap
29122 msgid ""
29123 " rm-rf path\n"
29124 "\n"
29125 msgstr ""
29126
29127 # type: =head2
29128 #. type: =head2
29129 #: ../fish/guestfish-actions.pod:3764
29130 msgid "rmdir"
29131 msgstr ""
29132
29133 # type: verbatim
29134 #. type: verbatim
29135 #: ../fish/guestfish-actions.pod:3766
29136 #, no-wrap
29137 msgid ""
29138 " rmdir path\n"
29139 "\n"
29140 msgstr ""
29141
29142 # type: =head2
29143 #. type: =head2
29144 #: ../fish/guestfish-actions.pod:3770
29145 msgid "rmmountpoint"
29146 msgstr ""
29147
29148 # type: verbatim
29149 #. type: verbatim
29150 #: ../fish/guestfish-actions.pod:3772
29151 #, no-wrap
29152 msgid ""
29153 " rmmountpoint exemptpath\n"
29154 "\n"
29155 msgstr ""
29156
29157 # type: textblock
29158 #. type: textblock
29159 #: ../fish/guestfish-actions.pod:3774
29160 msgid ""
29161 "This calls removes a mountpoint that was previously created with L</"
29162 "mkmountpoint>.  See L</mkmountpoint> for full details."
29163 msgstr ""
29164
29165 # type: =head2
29166 #. type: =head2
29167 #: ../fish/guestfish-actions.pod:3778
29168 msgid "scrub-device"
29169 msgstr ""
29170
29171 # type: verbatim
29172 #. type: verbatim
29173 #: ../fish/guestfish-actions.pod:3780
29174 #, no-wrap
29175 msgid ""
29176 " scrub-device device\n"
29177 "\n"
29178 msgstr ""
29179
29180 # type: =head2
29181 #. type: =head2
29182 #: ../fish/guestfish-actions.pod:3791
29183 msgid "scrub-file"
29184 msgstr ""
29185
29186 # type: verbatim
29187 #. type: verbatim
29188 #: ../fish/guestfish-actions.pod:3793
29189 #, no-wrap
29190 msgid ""
29191 " scrub-file file\n"
29192 "\n"
29193 msgstr ""
29194
29195 # type: =head2
29196 #. type: =head2
29197 #: ../fish/guestfish-actions.pod:3803
29198 msgid "scrub-freespace"
29199 msgstr ""
29200
29201 # type: verbatim
29202 #. type: verbatim
29203 #: ../fish/guestfish-actions.pod:3805
29204 #, no-wrap
29205 msgid ""
29206 " scrub-freespace dir\n"
29207 "\n"
29208 msgstr ""
29209
29210 # type: textblock
29211 #. type: textblock
29212 #: ../fish/guestfish-actions.pod:3807
29213 msgid ""
29214 "This command creates the directory C<dir> and then fills it with files until "
29215 "the filesystem is full, and scrubs the files as for L</scrub-file>, and "
29216 "deletes them.  The intention is to scrub any free space on the partition "
29217 "containing C<dir>."
29218 msgstr ""
29219
29220 # type: =head2
29221 #. type: =head2
29222 #: ../fish/guestfish-actions.pod:3816
29223 msgid "set-append"
29224 msgstr ""
29225
29226 # type: =head2
29227 #. type: =head2
29228 #: ../fish/guestfish-actions.pod:3818
29229 msgid "append"
29230 msgstr ""
29231
29232 # type: verbatim
29233 #. type: verbatim
29234 #: ../fish/guestfish-actions.pod:3820
29235 #, no-wrap
29236 msgid ""
29237 " set-append append\n"
29238 "\n"
29239 msgstr ""
29240
29241 #. type: =head2
29242 #: ../fish/guestfish-actions.pod:3831
29243 msgid "set-attach-method"
29244 msgstr ""
29245
29246 #. type: =head2
29247 #: ../fish/guestfish-actions.pod:3833
29248 msgid "attach-method"
29249 msgstr ""
29250
29251 #. type: verbatim
29252 #: ../fish/guestfish-actions.pod:3835
29253 #, no-wrap
29254 msgid ""
29255 " set-attach-method attachmethod\n"
29256 "\n"
29257 msgstr ""
29258
29259 # type: =head2
29260 #. type: =head2
29261 #: ../fish/guestfish-actions.pod:3857
29262 msgid "set-autosync"
29263 msgstr ""
29264
29265 # type: =head2
29266 #. type: =head2
29267 #: ../fish/guestfish-actions.pod:3859
29268 msgid "autosync"
29269 msgstr ""
29270
29271 # type: verbatim
29272 #. type: verbatim
29273 #: ../fish/guestfish-actions.pod:3861
29274 #, no-wrap
29275 msgid ""
29276 " set-autosync true|false\n"
29277 "\n"
29278 msgstr ""
29279
29280 # type: =head2
29281 #. type: =head2
29282 #: ../fish/guestfish-actions.pod:3871
29283 msgid "set-direct"
29284 msgstr ""
29285
29286 # type: =head2
29287 #. type: =head2
29288 #: ../fish/guestfish-actions.pod:3873
29289 msgid "direct"
29290 msgstr ""
29291
29292 # type: verbatim
29293 #. type: verbatim
29294 #: ../fish/guestfish-actions.pod:3875
29295 #, no-wrap
29296 msgid ""
29297 " set-direct true|false\n"
29298 "\n"
29299 msgstr ""
29300
29301 # type: textblock
29302 #. type: textblock
29303 #: ../fish/guestfish-actions.pod:3881
29304 msgid ""
29305 "One consequence of this is that log messages aren't caught by the library "
29306 "and handled by L</set-log-message-callback>, but go straight to stdout."
29307 msgstr ""
29308
29309 # type: =head2
29310 #. type: =head2
29311 #: ../fish/guestfish-actions.pod:3890
29312 msgid "set-e2label"
29313 msgstr ""
29314
29315 # type: verbatim
29316 #. type: verbatim
29317 #: ../fish/guestfish-actions.pod:3892
29318 #, no-wrap
29319 msgid ""
29320 " set-e2label device label\n"
29321 "\n"
29322 msgstr ""
29323
29324 # type: textblock
29325 #. type: textblock
29326 #: ../fish/guestfish-actions.pod:3898
29327 msgid ""
29328 "You can use either L</tune2fs-l> or L</get-e2label> to return the existing "
29329 "label on a filesystem."
29330 msgstr ""
29331
29332 # type: =head2
29333 #. type: =head2
29334 #: ../fish/guestfish-actions.pod:3901
29335 msgid "set-e2uuid"
29336 msgstr ""
29337
29338 # type: verbatim
29339 #. type: verbatim
29340 #: ../fish/guestfish-actions.pod:3903
29341 #, no-wrap
29342 msgid ""
29343 " set-e2uuid device uuid\n"
29344 "\n"
29345 msgstr ""
29346
29347 # type: textblock
29348 #. type: textblock
29349 #: ../fish/guestfish-actions.pod:3910
29350 msgid ""
29351 "You can use either L</tune2fs-l> or L</get-e2uuid> to return the existing "
29352 "UUID of a filesystem."
29353 msgstr ""
29354
29355 # type: =head2
29356 #. type: =head2
29357 #: ../fish/guestfish-actions.pod:3913
29358 msgid "set-memsize"
29359 msgstr ""
29360
29361 # type: =head2
29362 #. type: =head2
29363 #: ../fish/guestfish-actions.pod:3915
29364 msgid "memsize"
29365 msgstr ""
29366
29367 # type: verbatim
29368 #. type: verbatim
29369 #: ../fish/guestfish-actions.pod:3917
29370 #, no-wrap
29371 msgid ""
29372 " set-memsize memsize\n"
29373 "\n"
29374 msgstr ""
29375
29376 # type: textblock
29377 #. type: textblock
29378 #: ../fish/guestfish-actions.pod:3919
29379 msgid ""
29380 "This sets the memory size in megabytes allocated to the qemu subprocess.  "
29381 "This only has any effect if called before L</launch>."
29382 msgstr ""
29383
29384 # type: =head2
29385 #. type: =head2
29386 #: ../fish/guestfish-actions.pod:3930
29387 msgid "set-network"
29388 msgstr ""
29389
29390 # type: =head2
29391 #. type: =head2
29392 #: ../fish/guestfish-actions.pod:3932
29393 msgid "network"
29394 msgstr ""
29395
29396 # type: verbatim
29397 #. type: verbatim
29398 #: ../fish/guestfish-actions.pod:3934
29399 #, no-wrap
29400 msgid ""
29401 " set-network true|false\n"
29402 "\n"
29403 msgstr ""
29404
29405 # type: textblock
29406 #. type: textblock
29407 #: ../fish/guestfish-actions.pod:3942
29408 msgid ""
29409 "You must call this before calling L</launch>, otherwise it has no effect."
29410 msgstr ""
29411
29412 # type: =head2
29413 #. type: =head2
29414 #: ../fish/guestfish-actions.pod:3945
29415 msgid "set-path"
29416 msgstr ""
29417
29418 # type: =head2
29419 #. type: =head2
29420 #: ../fish/guestfish-actions.pod:3947
29421 msgid "path"
29422 msgstr ""
29423
29424 # type: verbatim
29425 #. type: verbatim
29426 #: ../fish/guestfish-actions.pod:3949
29427 #, no-wrap
29428 msgid ""
29429 " set-path searchpath\n"
29430 "\n"
29431 msgstr ""
29432
29433 # type: =head2
29434 #. type: =head2
29435 #: ../fish/guestfish-actions.pod:3958
29436 msgid "set-qemu"
29437 msgstr ""
29438
29439 # type: =head2
29440 #. type: =head2
29441 #: ../fish/guestfish-actions.pod:3960
29442 msgid "qemu"
29443 msgstr ""
29444
29445 # type: verbatim
29446 #. type: verbatim
29447 #: ../fish/guestfish-actions.pod:3962
29448 #, no-wrap
29449 msgid ""
29450 " set-qemu qemu\n"
29451 "\n"
29452 msgstr ""
29453
29454 # type: =head2
29455 #. type: =head2
29456 #: ../fish/guestfish-actions.pod:3982
29457 msgid "set-recovery-proc"
29458 msgstr ""
29459
29460 # type: =head2
29461 #. type: =head2
29462 #: ../fish/guestfish-actions.pod:3984
29463 msgid "recovery-proc"
29464 msgstr ""
29465
29466 # type: verbatim
29467 #. type: verbatim
29468 #: ../fish/guestfish-actions.pod:3986
29469 #, no-wrap
29470 msgid ""
29471 " set-recovery-proc true|false\n"
29472 "\n"
29473 msgstr ""
29474
29475 # type: textblock
29476 #. type: textblock
29477 #: ../fish/guestfish-actions.pod:3988
29478 msgid ""
29479 "If this is called with the parameter C<false> then L</launch> does not "
29480 "create a recovery process.  The purpose of the recovery process is to stop "
29481 "runaway qemu processes in the case where the main program aborts abruptly."
29482 msgstr ""
29483
29484 # type: textblock
29485 #. type: textblock
29486 #: ../fish/guestfish-actions.pod:3993
29487 msgid ""
29488 "This only has any effect if called before L</launch>, and the default is "
29489 "true."
29490 msgstr ""
29491
29492 # type: =head2
29493 #. type: =head2
29494 #: ../fish/guestfish-actions.pod:4002
29495 msgid "set-selinux"
29496 msgstr ""
29497
29498 # type: =head2
29499 #. type: =head2
29500 #: ../fish/guestfish-actions.pod:4004
29501 msgid "selinux"
29502 msgstr ""
29503
29504 # type: verbatim
29505 #. type: verbatim
29506 #: ../fish/guestfish-actions.pod:4006
29507 #, no-wrap
29508 msgid ""
29509 " set-selinux true|false\n"
29510 "\n"
29511 msgstr ""
29512
29513 # type: =head2
29514 #. type: =head2
29515 #: ../fish/guestfish-actions.pod:4017
29516 msgid "set-trace"
29517 msgstr ""
29518
29519 # type: =head2
29520 #. type: =head2
29521 #: ../fish/guestfish-actions.pod:4019
29522 msgid "trace"
29523 msgstr ""
29524
29525 # type: verbatim
29526 #. type: verbatim
29527 #: ../fish/guestfish-actions.pod:4021
29528 #, no-wrap
29529 msgid ""
29530 " set-trace true|false\n"
29531 "\n"
29532 msgstr ""
29533
29534 #. type: textblock
29535 #: ../fish/guestfish-actions.pod:4033
29536 msgid ""
29537 "Trace messages are normally sent to C<stderr>, unless you register a "
29538 "callback to send them somewhere else (see L</set-event-callback>)."
29539 msgstr ""
29540
29541 # type: =head2
29542 #. type: =head2
29543 #: ../fish/guestfish-actions.pod:4037
29544 msgid "set-verbose"
29545 msgstr ""
29546
29547 # type: =head2
29548 #. type: =head2
29549 #: ../fish/guestfish-actions.pod:4039
29550 msgid "verbose"
29551 msgstr ""
29552
29553 # type: verbatim
29554 #. type: verbatim
29555 #: ../fish/guestfish-actions.pod:4041
29556 #, no-wrap
29557 msgid ""
29558 " set-verbose true|false\n"
29559 "\n"
29560 msgstr ""
29561
29562 #. type: textblock
29563 #: ../fish/guestfish-actions.pod:4048
29564 msgid ""
29565 "Verbose messages are normally sent to C<stderr>, unless you register a "
29566 "callback to send them somewhere else (see L</set-event-callback>)."
29567 msgstr ""
29568
29569 # type: =head2
29570 #. type: =head2
29571 #: ../fish/guestfish-actions.pod:4052
29572 msgid "setcon"
29573 msgstr ""
29574
29575 # type: verbatim
29576 #. type: verbatim
29577 #: ../fish/guestfish-actions.pod:4054
29578 #, no-wrap
29579 msgid ""
29580 " setcon context\n"
29581 "\n"
29582 msgstr ""
29583
29584 # type: =head2
29585 #. type: =head2
29586 #: ../fish/guestfish-actions.pod:4061
29587 msgid "setxattr"
29588 msgstr ""
29589
29590 # type: verbatim
29591 #. type: verbatim
29592 #: ../fish/guestfish-actions.pod:4063
29593 #, no-wrap
29594 msgid ""
29595 " setxattr xattr val vallen path\n"
29596 "\n"
29597 msgstr ""
29598
29599 # type: textblock
29600 #. type: textblock
29601 #: ../fish/guestfish-actions.pod:4069
29602 msgid "See also: L</lsetxattr>, L<attr(5)>."
29603 msgstr ""
29604
29605 # type: =head2
29606 #. type: =head2
29607 #: ../fish/guestfish-actions.pod:4071
29608 msgid "sfdisk"
29609 msgstr ""
29610
29611 # type: verbatim
29612 #. type: verbatim
29613 #: ../fish/guestfish-actions.pod:4073
29614 #, no-wrap
29615 msgid ""
29616 " sfdisk device cyls heads sectors 'lines ...'\n"
29617 "\n"
29618 msgstr ""
29619
29620 # type: textblock
29621 #. type: textblock
29622 #: ../fish/guestfish-actions.pod:4095
29623 msgid "See also: L</sfdisk-l>, L</sfdisk-N>, L</part-init>"
29624 msgstr ""
29625
29626 # type: =head2
29627 #. type: =head2
29628 #: ../fish/guestfish-actions.pod:4101
29629 msgid "sfdiskM"
29630 msgstr ""
29631
29632 # type: verbatim
29633 #. type: verbatim
29634 #: ../fish/guestfish-actions.pod:4103
29635 #, no-wrap
29636 msgid ""
29637 " sfdiskM device 'lines ...'\n"
29638 "\n"
29639 msgstr ""
29640
29641 # type: textblock
29642 #. type: textblock
29643 #: ../fish/guestfish-actions.pod:4105
29644 msgid ""
29645 "This is a simplified interface to the L</sfdisk> command, where partition "
29646 "sizes are specified in megabytes only (rounded to the nearest cylinder) and "
29647 "you don't need to specify the cyls, heads and sectors parameters which were "
29648 "rarely if ever used anyway."
29649 msgstr ""
29650
29651 # type: textblock
29652 #. type: textblock
29653 #: ../fish/guestfish-actions.pod:4111
29654 msgid "See also: L</sfdisk>, the L<sfdisk(8)> manpage and L</part-disk>"
29655 msgstr ""
29656
29657 # type: =head2
29658 #. type: =head2
29659 #: ../fish/guestfish-actions.pod:4117
29660 msgid "sfdisk-N"
29661 msgstr ""
29662
29663 # type: verbatim
29664 #. type: verbatim
29665 #: ../fish/guestfish-actions.pod:4119
29666 #, no-wrap
29667 msgid ""
29668 " sfdisk-N device partnum cyls heads sectors line\n"
29669 "\n"
29670 msgstr ""
29671
29672 # type: textblock
29673 #. type: textblock
29674 #: ../fish/guestfish-actions.pod:4124
29675 msgid ""
29676 "For other parameters, see L</sfdisk>.  You should usually pass C<0> for the "
29677 "cyls/heads/sectors parameters."
29678 msgstr ""
29679
29680 # type: textblock
29681 #. type: textblock
29682 #: ../fish/guestfish-actions.pod:4127
29683 msgid "See also: L</part-add>"
29684 msgstr ""
29685
29686 # type: =head2
29687 #. type: =head2
29688 #: ../fish/guestfish-actions.pod:4132
29689 msgid "sfdisk-disk-geometry"
29690 msgstr ""
29691
29692 # type: verbatim
29693 #. type: verbatim
29694 #: ../fish/guestfish-actions.pod:4134
29695 #, no-wrap
29696 msgid ""
29697 " sfdisk-disk-geometry device\n"
29698 "\n"
29699 msgstr ""
29700
29701 # type: textblock
29702 #. type: textblock
29703 #: ../fish/guestfish-actions.pod:4136
29704 msgid ""
29705 "This displays the disk geometry of C<device> read from the partition table.  "
29706 "Especially in the case where the underlying block device has been resized, "
29707 "this can be different from the kernel's idea of the geometry (see L</sfdisk-"
29708 "kernel-geometry>)."
29709 msgstr ""
29710
29711 # type: =head2
29712 #. type: =head2
29713 #: ../fish/guestfish-actions.pod:4144
29714 msgid "sfdisk-kernel-geometry"
29715 msgstr ""
29716
29717 # type: verbatim
29718 #. type: verbatim
29719 #: ../fish/guestfish-actions.pod:4146
29720 #, no-wrap
29721 msgid ""
29722 " sfdisk-kernel-geometry device\n"
29723 "\n"
29724 msgstr ""
29725
29726 # type: =head2
29727 #. type: =head2
29728 #: ../fish/guestfish-actions.pod:4153
29729 msgid "sfdisk-l"
29730 msgstr ""
29731
29732 # type: verbatim
29733 #. type: verbatim
29734 #: ../fish/guestfish-actions.pod:4155
29735 #, no-wrap
29736 msgid ""
29737 " sfdisk-l device\n"
29738 "\n"
29739 msgstr ""
29740
29741 # type: textblock
29742 #. type: textblock
29743 #: ../fish/guestfish-actions.pod:4161
29744 msgid "See also: L</part-list>"
29745 msgstr ""
29746
29747 # type: =head2
29748 #. type: =head2
29749 #: ../fish/guestfish-actions.pod:4163
29750 msgid "sh"
29751 msgstr ""
29752
29753 # type: verbatim
29754 #. type: verbatim
29755 #: ../fish/guestfish-actions.pod:4165
29756 #, no-wrap
29757 msgid ""
29758 " sh command\n"
29759 "\n"
29760 msgstr ""
29761
29762 # type: textblock
29763 #. type: textblock
29764 #: ../fish/guestfish-actions.pod:4170
29765 msgid "This is like L</command>, but passes the command to:"
29766 msgstr ""
29767
29768 # type: textblock
29769 #. type: textblock
29770 #: ../fish/guestfish-actions.pod:4178
29771 msgid "All the provisos about L</command> apply to this call."
29772 msgstr ""
29773
29774 # type: =head2
29775 #. type: =head2
29776 #: ../fish/guestfish-actions.pod:4180
29777 msgid "sh-lines"
29778 msgstr ""
29779
29780 # type: verbatim
29781 #. type: verbatim
29782 #: ../fish/guestfish-actions.pod:4182
29783 #, no-wrap
29784 msgid ""
29785 " sh-lines command\n"
29786 "\n"
29787 msgstr ""
29788
29789 # type: textblock
29790 #. type: textblock
29791 #: ../fish/guestfish-actions.pod:4184
29792 msgid "This is the same as L</sh>, but splits the result into a list of lines."
29793 msgstr ""
29794
29795 # type: textblock
29796 #. type: textblock
29797 #: ../fish/guestfish-actions.pod:4187
29798 msgid "See also: L</command-lines>"
29799 msgstr ""
29800
29801 # type: =head2
29802 #. type: =head2
29803 #: ../fish/guestfish-actions.pod:4189
29804 msgid "sleep"
29805 msgstr ""
29806
29807 # type: verbatim
29808 #. type: verbatim
29809 #: ../fish/guestfish-actions.pod:4191
29810 #, no-wrap
29811 msgid ""
29812 " sleep secs\n"
29813 "\n"
29814 msgstr ""
29815
29816 # type: =head2
29817 #. type: =head2
29818 #: ../fish/guestfish-actions.pod:4195
29819 msgid "stat"
29820 msgstr ""
29821
29822 # type: verbatim
29823 #. type: verbatim
29824 #: ../fish/guestfish-actions.pod:4197
29825 #, no-wrap
29826 msgid ""
29827 " stat path\n"
29828 "\n"
29829 msgstr ""
29830
29831 # type: =head2
29832 #. type: =head2
29833 #: ../fish/guestfish-actions.pod:4203
29834 msgid "statvfs"
29835 msgstr ""
29836
29837 # type: verbatim
29838 #. type: verbatim
29839 #: ../fish/guestfish-actions.pod:4205
29840 #, no-wrap
29841 msgid ""
29842 " statvfs path\n"
29843 "\n"
29844 msgstr ""
29845
29846 # type: =head2
29847 #. type: =head2
29848 #: ../fish/guestfish-actions.pod:4213
29849 msgid "strings"
29850 msgstr ""
29851
29852 # type: verbatim
29853 #. type: verbatim
29854 #: ../fish/guestfish-actions.pod:4215
29855 #, no-wrap
29856 msgid ""
29857 " strings path\n"
29858 "\n"
29859 msgstr ""
29860
29861 # type: =head2
29862 #. type: =head2
29863 #: ../fish/guestfish-actions.pod:4223
29864 msgid "strings-e"
29865 msgstr ""
29866
29867 # type: verbatim
29868 #. type: verbatim
29869 #: ../fish/guestfish-actions.pod:4225
29870 #, no-wrap
29871 msgid ""
29872 " strings-e encoding path\n"
29873 "\n"
29874 msgstr ""
29875
29876 # type: textblock
29877 #. type: textblock
29878 #: ../fish/guestfish-actions.pod:4227
29879 msgid ""
29880 "This is like the L</strings> command, but allows you to specify the encoding "
29881 "of strings that are looked for in the source file C<path>."
29882 msgstr ""
29883
29884 # type: textblock
29885 #. type: textblock
29886 #: ../fish/guestfish-actions.pod:4237
29887 msgid ""
29888 "Single 7-bit-byte characters like ASCII and the ASCII-compatible parts of "
29889 "ISO-8859-X (this is what L</strings> uses)."
29890 msgstr ""
29891
29892 # type: =head2
29893 #. type: =head2
29894 #: ../fish/guestfish-actions.pod:4269
29895 msgid "swapoff-device"
29896 msgstr ""
29897
29898 # type: verbatim
29899 #. type: verbatim
29900 #: ../fish/guestfish-actions.pod:4271
29901 #, no-wrap
29902 msgid ""
29903 " swapoff-device device\n"
29904 "\n"
29905 msgstr ""
29906
29907 # type: textblock
29908 #. type: textblock
29909 #: ../fish/guestfish-actions.pod:4273
29910 msgid ""
29911 "This command disables the libguestfs appliance swap device or partition "
29912 "named C<device>.  See L</swapon-device>."
29913 msgstr ""
29914
29915 # type: =head2
29916 #. type: =head2
29917 #: ../fish/guestfish-actions.pod:4277
29918 msgid "swapoff-file"
29919 msgstr ""
29920
29921 # type: verbatim
29922 #. type: verbatim
29923 #: ../fish/guestfish-actions.pod:4279
29924 #, no-wrap
29925 msgid ""
29926 " swapoff-file file\n"
29927 "\n"
29928 msgstr ""
29929
29930 # type: =head2
29931 #. type: =head2
29932 #: ../fish/guestfish-actions.pod:4283
29933 msgid "swapoff-label"
29934 msgstr ""
29935
29936 # type: verbatim
29937 #. type: verbatim
29938 #: ../fish/guestfish-actions.pod:4285
29939 #, no-wrap
29940 msgid ""
29941 " swapoff-label label\n"
29942 "\n"
29943 msgstr ""
29944
29945 # type: =head2
29946 #. type: =head2
29947 #: ../fish/guestfish-actions.pod:4290
29948 msgid "swapoff-uuid"
29949 msgstr ""
29950
29951 # type: verbatim
29952 #. type: verbatim
29953 #: ../fish/guestfish-actions.pod:4292
29954 #, no-wrap
29955 msgid ""
29956 " swapoff-uuid uuid\n"
29957 "\n"
29958 msgstr ""
29959
29960 # type: =head2
29961 #. type: =head2
29962 #: ../fish/guestfish-actions.pod:4297
29963 msgid "swapon-device"
29964 msgstr ""
29965
29966 # type: verbatim
29967 #. type: verbatim
29968 #: ../fish/guestfish-actions.pod:4299
29969 #, no-wrap
29970 msgid ""
29971 " swapon-device device\n"
29972 "\n"
29973 msgstr ""
29974
29975 # type: textblock
29976 #. type: textblock
29977 #: ../fish/guestfish-actions.pod:4301
29978 msgid ""
29979 "This command enables the libguestfs appliance to use the swap device or "
29980 "partition named C<device>.  The increased memory is made available for all "
29981 "commands, for example those run using L</command> or L</sh>."
29982 msgstr ""
29983
29984 # type: =head2
29985 #. type: =head2
29986 #: ../fish/guestfish-actions.pod:4313
29987 msgid "swapon-file"
29988 msgstr ""
29989
29990 # type: verbatim
29991 #. type: verbatim
29992 #: ../fish/guestfish-actions.pod:4315
29993 #, no-wrap
29994 msgid ""
29995 " swapon-file file\n"
29996 "\n"
29997 msgstr ""
29998
29999 # type: textblock
30000 #. type: textblock
30001 #: ../fish/guestfish-actions.pod:4317
30002 msgid ""
30003 "This command enables swap to a file.  See L</swapon-device> for other notes."
30004 msgstr ""
30005
30006 # type: =head2
30007 #. type: =head2
30008 #: ../fish/guestfish-actions.pod:4320
30009 msgid "swapon-label"
30010 msgstr ""
30011
30012 # type: verbatim
30013 #. type: verbatim
30014 #: ../fish/guestfish-actions.pod:4322
30015 #, no-wrap
30016 msgid ""
30017 " swapon-label label\n"
30018 "\n"
30019 msgstr ""
30020
30021 # type: textblock
30022 #. type: textblock
30023 #: ../fish/guestfish-actions.pod:4324
30024 msgid ""
30025 "This command enables swap to a labeled swap partition.  See L</swapon-"
30026 "device> for other notes."
30027 msgstr ""
30028
30029 # type: =head2
30030 #. type: =head2
30031 #: ../fish/guestfish-actions.pod:4327
30032 msgid "swapon-uuid"
30033 msgstr ""
30034
30035 # type: verbatim
30036 #. type: verbatim
30037 #: ../fish/guestfish-actions.pod:4329
30038 #, no-wrap
30039 msgid ""
30040 " swapon-uuid uuid\n"
30041 "\n"
30042 msgstr ""
30043
30044 # type: textblock
30045 #. type: textblock
30046 #: ../fish/guestfish-actions.pod:4331
30047 msgid ""
30048 "This command enables swap to a swap partition with the given UUID.  See L</"
30049 "swapon-device> for other notes."
30050 msgstr ""
30051
30052 # type: =head2
30053 #. type: =head2
30054 #: ../fish/guestfish-actions.pod:4334
30055 msgid "sync"
30056 msgstr ""
30057
30058 # type: verbatim
30059 #. type: verbatim
30060 #: ../fish/guestfish-actions.pod:4336
30061 #, no-wrap
30062 msgid ""
30063 " sync\n"
30064 "\n"
30065 msgstr ""
30066
30067 # type: =head2
30068 #. type: =head2
30069 #: ../fish/guestfish-actions.pod:4344
30070 msgid "tail"
30071 msgstr ""
30072
30073 # type: verbatim
30074 #. type: verbatim
30075 #: ../fish/guestfish-actions.pod:4346
30076 #, no-wrap
30077 msgid ""
30078 " tail path\n"
30079 "\n"
30080 msgstr ""
30081
30082 # type: =head2
30083 #. type: =head2
30084 #: ../fish/guestfish-actions.pod:4354
30085 msgid "tail-n"
30086 msgstr ""
30087
30088 # type: verbatim
30089 #. type: verbatim
30090 #: ../fish/guestfish-actions.pod:4356
30091 #, no-wrap
30092 msgid ""
30093 " tail-n nrlines path\n"
30094 "\n"
30095 msgstr ""
30096
30097 # type: =head2
30098 #. type: =head2
30099 #: ../fish/guestfish-actions.pod:4369
30100 msgid "tar-in"
30101 msgstr ""
30102
30103 # type: verbatim
30104 #. type: verbatim
30105 #: ../fish/guestfish-actions.pod:4371
30106 #, no-wrap
30107 msgid ""
30108 " tar-in (tarfile|-) directory\n"
30109 "\n"
30110 msgstr ""
30111
30112 # type: textblock
30113 #. type: textblock
30114 #: ../fish/guestfish-actions.pod:4376
30115 msgid "To upload a compressed tarball, use L</tgz-in> or L</txz-in>."
30116 msgstr ""
30117
30118 # type: =head2
30119 #. type: =head2
30120 #: ../fish/guestfish-actions.pod:4381
30121 msgid "tar-out"
30122 msgstr ""
30123
30124 # type: verbatim
30125 #. type: verbatim
30126 #: ../fish/guestfish-actions.pod:4383
30127 #, no-wrap
30128 msgid ""
30129 " tar-out directory (tarfile|-)\n"
30130 "\n"
30131 msgstr ""
30132
30133 # type: textblock
30134 #. type: textblock
30135 #: ../fish/guestfish-actions.pod:4388
30136 msgid "To download a compressed tarball, use L</tgz-out> or L</txz-out>."
30137 msgstr ""
30138
30139 # type: =head2
30140 #. type: =head2
30141 #: ../fish/guestfish-actions.pod:4393
30142 msgid "tgz-in"
30143 msgstr ""
30144
30145 # type: verbatim
30146 #. type: verbatim
30147 #: ../fish/guestfish-actions.pod:4395
30148 #, no-wrap
30149 msgid ""
30150 " tgz-in (tarball|-) directory\n"
30151 "\n"
30152 msgstr ""
30153
30154 # type: textblock
30155 #. type: textblock
30156 #: ../fish/guestfish-actions.pod:4400
30157 msgid "To upload an uncompressed tarball, use L</tar-in>."
30158 msgstr ""
30159
30160 # type: =head2
30161 #. type: =head2
30162 #: ../fish/guestfish-actions.pod:4404
30163 msgid "tgz-out"
30164 msgstr ""
30165
30166 # type: verbatim
30167 #. type: verbatim
30168 #: ../fish/guestfish-actions.pod:4406
30169 #, no-wrap
30170 msgid ""
30171 " tgz-out directory (tarball|-)\n"
30172 "\n"
30173 msgstr ""
30174
30175 # type: textblock
30176 #. type: textblock
30177 #: ../fish/guestfish-actions.pod:4411
30178 msgid "To download an uncompressed tarball, use L</tar-out>."
30179 msgstr ""
30180
30181 # type: =head2
30182 #. type: =head2
30183 #: ../fish/guestfish-actions.pod:4415
30184 msgid "touch"
30185 msgstr ""
30186
30187 # type: verbatim
30188 #. type: verbatim
30189 #: ../fish/guestfish-actions.pod:4417
30190 #, no-wrap
30191 msgid ""
30192 " touch path\n"
30193 "\n"
30194 msgstr ""
30195
30196 # type: =head2
30197 #. type: =head2
30198 #: ../fish/guestfish-actions.pod:4426
30199 msgid "truncate"
30200 msgstr ""
30201
30202 # type: verbatim
30203 #. type: verbatim
30204 #: ../fish/guestfish-actions.pod:4428
30205 #, no-wrap
30206 msgid ""
30207 " truncate path\n"
30208 "\n"
30209 msgstr ""
30210
30211 # type: =head2
30212 #. type: =head2
30213 #: ../fish/guestfish-actions.pod:4433
30214 msgid "truncate-size"
30215 msgstr ""
30216
30217 # type: verbatim
30218 #. type: verbatim
30219 #: ../fish/guestfish-actions.pod:4435
30220 #, no-wrap
30221 msgid ""
30222 " truncate-size path size\n"
30223 "\n"
30224 msgstr ""
30225
30226 # type: textblock
30227 #. type: textblock
30228 #: ../fish/guestfish-actions.pod:4440
30229 msgid ""
30230 "If the current file size is less than C<size> then the file is extended to "
30231 "the required size with zero bytes.  This creates a sparse file (ie. disk "
30232 "blocks are not allocated for the file until you write to it).  To create a "
30233 "non-sparse file of zeroes, use L</fallocate64> instead."
30234 msgstr ""
30235
30236 # type: =head2
30237 #. type: =head2
30238 #: ../fish/guestfish-actions.pod:4446
30239 msgid "tune2fs-l"
30240 msgstr ""
30241
30242 # type: verbatim
30243 #. type: verbatim
30244 #: ../fish/guestfish-actions.pod:4448
30245 #, no-wrap
30246 msgid ""
30247 " tune2fs-l device\n"
30248 "\n"
30249 msgstr ""
30250
30251 # type: =head2
30252 #. type: =head2
30253 #: ../fish/guestfish-actions.pod:4458
30254 msgid "txz-in"
30255 msgstr ""
30256
30257 # type: verbatim
30258 #. type: verbatim
30259 #: ../fish/guestfish-actions.pod:4460
30260 #, no-wrap
30261 msgid ""
30262 " txz-in (tarball|-) directory\n"
30263 "\n"
30264 msgstr ""
30265
30266 # type: =head2
30267 #. type: =head2
30268 #: ../fish/guestfish-actions.pod:4467
30269 msgid "txz-out"
30270 msgstr ""
30271
30272 # type: verbatim
30273 #. type: verbatim
30274 #: ../fish/guestfish-actions.pod:4469
30275 #, no-wrap
30276 msgid ""
30277 " txz-out directory (tarball|-)\n"
30278 "\n"
30279 msgstr ""
30280
30281 # type: =head2
30282 #. type: =head2
30283 #: ../fish/guestfish-actions.pod:4476
30284 msgid "umask"
30285 msgstr ""
30286
30287 # type: verbatim
30288 #. type: verbatim
30289 #: ../fish/guestfish-actions.pod:4478
30290 #, no-wrap
30291 msgid ""
30292 " umask mask\n"
30293 "\n"
30294 msgstr ""
30295
30296 # type: textblock
30297 #. type: textblock
30298 #: ../fish/guestfish-actions.pod:4492
30299 msgid "See also L</get-umask>, L<umask(2)>, L</mknod>, L</mkdir>."
30300 msgstr ""
30301
30302 # type: =head2
30303 #. type: =head2
30304 #: ../fish/guestfish-actions.pod:4497
30305 msgid "umount"
30306 msgstr ""
30307
30308 # type: =head2
30309 #. type: =head2
30310 #: ../fish/guestfish-actions.pod:4499
30311 msgid "unmount"
30312 msgstr ""
30313
30314 # type: verbatim
30315 #. type: verbatim
30316 #: ../fish/guestfish-actions.pod:4501
30317 #, no-wrap
30318 msgid ""
30319 " umount pathordevice\n"
30320 "\n"
30321 msgstr ""
30322
30323 # type: =head2
30324 #. type: =head2
30325 #: ../fish/guestfish-actions.pod:4507
30326 msgid "umount-all"
30327 msgstr ""
30328
30329 # type: =head2
30330 #. type: =head2
30331 #: ../fish/guestfish-actions.pod:4509
30332 msgid "unmount-all"
30333 msgstr ""
30334
30335 # type: verbatim
30336 #. type: verbatim
30337 #: ../fish/guestfish-actions.pod:4511
30338 #, no-wrap
30339 msgid ""
30340 " umount-all\n"
30341 "\n"
30342 msgstr ""
30343
30344 # type: =head2
30345 #. type: =head2
30346 #: ../fish/guestfish-actions.pod:4517
30347 msgid "upload"
30348 msgstr ""
30349
30350 # type: verbatim
30351 #. type: verbatim
30352 #: ../fish/guestfish-actions.pod:4519
30353 #, no-wrap
30354 msgid ""
30355 " upload (filename|-) remotefilename\n"
30356 "\n"
30357 msgstr ""
30358
30359 # type: textblock
30360 #. type: textblock
30361 #: ../fish/guestfish-actions.pod:4526
30362 msgid "See also L</download>."
30363 msgstr ""
30364
30365 # type: =head2
30366 #. type: =head2
30367 #: ../fish/guestfish-actions.pod:4530
30368 msgid "upload-offset"
30369 msgstr ""
30370
30371 # type: verbatim
30372 #. type: verbatim
30373 #: ../fish/guestfish-actions.pod:4532
30374 #, no-wrap
30375 msgid ""
30376 " upload-offset (filename|-) remotefilename offset\n"
30377 "\n"
30378 msgstr ""
30379
30380 # type: textblock
30381 #. type: textblock
30382 #: ../fish/guestfish-actions.pod:4544
30383 msgid ""
30384 "Note that there is no limit on the amount of data that can be uploaded with "
30385 "this call, unlike with L</pwrite>, and this call always writes the full "
30386 "amount unless an error occurs."
30387 msgstr ""
30388
30389 # type: textblock
30390 #. type: textblock
30391 #: ../fish/guestfish-actions.pod:4549
30392 msgid "See also L</upload>, L</pwrite>."
30393 msgstr ""
30394
30395 # type: =head2
30396 #. type: =head2
30397 #: ../fish/guestfish-actions.pod:4553
30398 msgid "utimens"
30399 msgstr ""
30400
30401 # type: verbatim
30402 #. type: verbatim
30403 #: ../fish/guestfish-actions.pod:4555
30404 #, no-wrap
30405 msgid ""
30406 " utimens path atsecs atnsecs mtsecs mtnsecs\n"
30407 "\n"
30408 msgstr ""
30409
30410 # type: =head2
30411 #. type: =head2
30412 #: ../fish/guestfish-actions.pod:4574
30413 msgid "version"
30414 msgstr ""
30415
30416 # type: verbatim
30417 #. type: verbatim
30418 #: ../fish/guestfish-actions.pod:4576
30419 #, no-wrap
30420 msgid ""
30421 " version\n"
30422 "\n"
30423 msgstr ""
30424
30425 # type: textblock
30426 #. type: textblock
30427 #: ../fish/guestfish-actions.pod:4603
30428 msgid ""
30429 "I<Note:> Don't use this call to test for availability of features.  In "
30430 "enterprise distributions we backport features from later versions into "
30431 "earlier versions, making this an unreliable way to test for features.  Use "
30432 "L</available> instead."
30433 msgstr ""
30434
30435 # type: =head2
30436 #. type: =head2
30437 #: ../fish/guestfish-actions.pod:4609
30438 msgid "vfs-label"
30439 msgstr ""
30440
30441 # type: verbatim
30442 #. type: verbatim
30443 #: ../fish/guestfish-actions.pod:4611
30444 #, no-wrap
30445 msgid ""
30446 " vfs-label device\n"
30447 "\n"
30448 msgstr ""
30449
30450 # type: textblock
30451 #. type: textblock
30452 #: ../fish/guestfish-actions.pod:4618
30453 msgid "To find a filesystem from the label, use L</findfs-label>."
30454 msgstr ""
30455
30456 # type: =head2
30457 #. type: =head2
30458 #: ../fish/guestfish-actions.pod:4620
30459 msgid "vfs-type"
30460 msgstr ""
30461
30462 # type: verbatim
30463 #. type: verbatim
30464 #: ../fish/guestfish-actions.pod:4622
30465 #, no-wrap
30466 msgid ""
30467 " vfs-type device\n"
30468 "\n"
30469 msgstr ""
30470
30471 # type: =head2
30472 #. type: =head2
30473 #: ../fish/guestfish-actions.pod:4632
30474 msgid "vfs-uuid"
30475 msgstr ""
30476
30477 # type: verbatim
30478 #. type: verbatim
30479 #: ../fish/guestfish-actions.pod:4634
30480 #, no-wrap
30481 msgid ""
30482 " vfs-uuid device\n"
30483 "\n"
30484 msgstr ""
30485
30486 # type: textblock
30487 #. type: textblock
30488 #: ../fish/guestfish-actions.pod:4641
30489 msgid "To find a filesystem from the UUID, use L</findfs-uuid>."
30490 msgstr ""
30491
30492 # type: =head2
30493 #. type: =head2
30494 #: ../fish/guestfish-actions.pod:4643
30495 msgid "vg-activate"
30496 msgstr ""
30497
30498 # type: verbatim
30499 #. type: verbatim
30500 #: ../fish/guestfish-actions.pod:4645
30501 #, no-wrap
30502 msgid ""
30503 " vg-activate true|false 'volgroups ...'\n"
30504 "\n"
30505 msgstr ""
30506
30507 # type: =head2
30508 #. type: =head2
30509 #: ../fish/guestfish-actions.pod:4658
30510 msgid "vg-activate-all"
30511 msgstr ""
30512
30513 # type: verbatim
30514 #. type: verbatim
30515 #: ../fish/guestfish-actions.pod:4660
30516 #, no-wrap
30517 msgid ""
30518 " vg-activate-all true|false\n"
30519 "\n"
30520 msgstr ""
30521
30522 # type: =head2
30523 #. type: =head2
30524 #: ../fish/guestfish-actions.pod:4670
30525 msgid "vgcreate"
30526 msgstr ""
30527
30528 # type: verbatim
30529 #. type: verbatim
30530 #: ../fish/guestfish-actions.pod:4672
30531 #, no-wrap
30532 msgid ""
30533 " vgcreate volgroup 'physvols ...'\n"
30534 "\n"
30535 msgstr ""
30536
30537 # type: =head2
30538 #. type: =head2
30539 #: ../fish/guestfish-actions.pod:4677
30540 msgid "vglvuuids"
30541 msgstr ""
30542
30543 # type: verbatim
30544 #. type: verbatim
30545 #: ../fish/guestfish-actions.pod:4679
30546 #, no-wrap
30547 msgid ""
30548 " vglvuuids vgname\n"
30549 "\n"
30550 msgstr ""
30551
30552 # type: textblock
30553 #. type: textblock
30554 #: ../fish/guestfish-actions.pod:4684
30555 msgid ""
30556 "You can use this along with L</lvs> and L</lvuuid> calls to associate "
30557 "logical volumes and volume groups."
30558 msgstr ""
30559
30560 # type: textblock
30561 #. type: textblock
30562 #: ../fish/guestfish-actions.pod:4687
30563 msgid "See also L</vgpvuuids>."
30564 msgstr ""
30565
30566 # type: =head2
30567 #. type: =head2
30568 #: ../fish/guestfish-actions.pod:4689
30569 msgid "vgpvuuids"
30570 msgstr ""
30571
30572 # type: verbatim
30573 #. type: verbatim
30574 #: ../fish/guestfish-actions.pod:4691
30575 #, no-wrap
30576 msgid ""
30577 " vgpvuuids vgname\n"
30578 "\n"
30579 msgstr ""
30580
30581 # type: textblock
30582 #. type: textblock
30583 #: ../fish/guestfish-actions.pod:4696
30584 msgid ""
30585 "You can use this along with L</pvs> and L</pvuuid> calls to associate "
30586 "physical volumes and volume groups."
30587 msgstr ""
30588
30589 # type: textblock
30590 #. type: textblock
30591 #: ../fish/guestfish-actions.pod:4699
30592 msgid "See also L</vglvuuids>."
30593 msgstr ""
30594
30595 # type: =head2
30596 #. type: =head2
30597 #: ../fish/guestfish-actions.pod:4701
30598 msgid "vgremove"
30599 msgstr ""
30600
30601 # type: verbatim
30602 #. type: verbatim
30603 #: ../fish/guestfish-actions.pod:4703
30604 #, no-wrap
30605 msgid ""
30606 " vgremove vgname\n"
30607 "\n"
30608 msgstr ""
30609
30610 # type: =head2
30611 #. type: =head2
30612 #: ../fish/guestfish-actions.pod:4710
30613 msgid "vgrename"
30614 msgstr ""
30615
30616 # type: verbatim
30617 #. type: verbatim
30618 #: ../fish/guestfish-actions.pod:4712
30619 #, no-wrap
30620 msgid ""
30621 " vgrename volgroup newvolgroup\n"
30622 "\n"
30623 msgstr ""
30624
30625 # type: =head2
30626 #. type: =head2
30627 #: ../fish/guestfish-actions.pod:4716
30628 msgid "vgs"
30629 msgstr ""
30630
30631 # type: verbatim
30632 #. type: verbatim
30633 #: ../fish/guestfish-actions.pod:4718
30634 #, no-wrap
30635 msgid ""
30636 " vgs\n"
30637 "\n"
30638 msgstr ""
30639
30640 # type: textblock
30641 #. type: textblock
30642 #: ../fish/guestfish-actions.pod:4726
30643 msgid "See also L</vgs-full>."
30644 msgstr ""
30645
30646 # type: =head2
30647 #. type: =head2
30648 #: ../fish/guestfish-actions.pod:4728
30649 msgid "vgs-full"
30650 msgstr ""
30651
30652 # type: verbatim
30653 #. type: verbatim
30654 #: ../fish/guestfish-actions.pod:4730
30655 #, no-wrap
30656 msgid ""
30657 " vgs-full\n"
30658 "\n"
30659 msgstr ""
30660
30661 # type: =head2
30662 #. type: =head2
30663 #: ../fish/guestfish-actions.pod:4735
30664 msgid "vgscan"
30665 msgstr ""
30666
30667 # type: verbatim
30668 #. type: verbatim
30669 #: ../fish/guestfish-actions.pod:4737
30670 #, no-wrap
30671 msgid ""
30672 " vgscan\n"
30673 "\n"
30674 msgstr ""
30675
30676 # type: =head2
30677 #. type: =head2
30678 #: ../fish/guestfish-actions.pod:4742
30679 msgid "vguuid"
30680 msgstr ""
30681
30682 # type: verbatim
30683 #. type: verbatim
30684 #: ../fish/guestfish-actions.pod:4744
30685 #, no-wrap
30686 msgid ""
30687 " vguuid vgname\n"
30688 "\n"
30689 msgstr ""
30690
30691 # type: =head2
30692 #. type: =head2
30693 #: ../fish/guestfish-actions.pod:4748
30694 msgid "wc-c"
30695 msgstr ""
30696
30697 # type: verbatim
30698 #. type: verbatim
30699 #: ../fish/guestfish-actions.pod:4750
30700 #, no-wrap
30701 msgid ""
30702 " wc-c path\n"
30703 "\n"
30704 msgstr ""
30705
30706 # type: =head2
30707 #. type: =head2
30708 #: ../fish/guestfish-actions.pod:4755
30709 msgid "wc-l"
30710 msgstr ""
30711
30712 # type: verbatim
30713 #. type: verbatim
30714 #: ../fish/guestfish-actions.pod:4757
30715 #, no-wrap
30716 msgid ""
30717 " wc-l path\n"
30718 "\n"
30719 msgstr ""
30720
30721 # type: =head2
30722 #. type: =head2
30723 #: ../fish/guestfish-actions.pod:4762
30724 msgid "wc-w"
30725 msgstr ""
30726
30727 # type: verbatim
30728 #. type: verbatim
30729 #: ../fish/guestfish-actions.pod:4764
30730 #, no-wrap
30731 msgid ""
30732 " wc-w path\n"
30733 "\n"
30734 msgstr ""
30735
30736 # type: =head2
30737 #. type: =head2
30738 #: ../fish/guestfish-actions.pod:4769
30739 msgid "write"
30740 msgstr ""
30741
30742 # type: verbatim
30743 #. type: verbatim
30744 #: ../fish/guestfish-actions.pod:4771
30745 #, no-wrap
30746 msgid ""
30747 " write path content\n"
30748 "\n"
30749 msgstr ""
30750
30751 # type: =head2
30752 #. type: =head2
30753 #: ../fish/guestfish-actions.pod:4779
30754 msgid "write-file"
30755 msgstr ""
30756
30757 # type: verbatim
30758 #. type: verbatim
30759 #: ../fish/guestfish-actions.pod:4781
30760 #, no-wrap
30761 msgid ""
30762 " write-file path content size\n"
30763 "\n"
30764 msgstr ""
30765
30766 # type: =head2
30767 #. type: =head2
30768 #: ../fish/guestfish-actions.pod:4804
30769 msgid "zegrep"
30770 msgstr ""
30771
30772 # type: verbatim
30773 #. type: verbatim
30774 #: ../fish/guestfish-actions.pod:4806
30775 #, no-wrap
30776 msgid ""
30777 " zegrep regex path\n"
30778 "\n"
30779 msgstr ""
30780
30781 # type: =head2
30782 #. type: =head2
30783 #: ../fish/guestfish-actions.pod:4814
30784 msgid "zegrepi"
30785 msgstr ""
30786
30787 # type: verbatim
30788 #. type: verbatim
30789 #: ../fish/guestfish-actions.pod:4816
30790 #, no-wrap
30791 msgid ""
30792 " zegrepi regex path\n"
30793 "\n"
30794 msgstr ""
30795
30796 # type: =head2
30797 #. type: =head2
30798 #: ../fish/guestfish-actions.pod:4824
30799 msgid "zero"
30800 msgstr ""
30801
30802 # type: verbatim
30803 #. type: verbatim
30804 #: ../fish/guestfish-actions.pod:4826
30805 #, no-wrap
30806 msgid ""
30807 " zero device\n"
30808 "\n"
30809 msgstr ""
30810
30811 # type: textblock
30812 #. type: textblock
30813 #: ../fish/guestfish-actions.pod:4834
30814 msgid "See also: L</zero-device>, L</scrub-device>."
30815 msgstr ""
30816
30817 # type: =head2
30818 #. type: =head2
30819 #: ../fish/guestfish-actions.pod:4836
30820 msgid "zero-device"
30821 msgstr ""
30822
30823 # type: verbatim
30824 #. type: verbatim
30825 #: ../fish/guestfish-actions.pod:4838
30826 #, no-wrap
30827 msgid ""
30828 " zero-device device\n"
30829 "\n"
30830 msgstr ""
30831
30832 # type: textblock
30833 #. type: textblock
30834 #: ../fish/guestfish-actions.pod:4840
30835 msgid ""
30836 "This command writes zeroes over the entire C<device>.  Compare with L</zero> "
30837 "which just zeroes the first few blocks of a device."
30838 msgstr ""
30839
30840 # type: =head2
30841 #. type: =head2
30842 #: ../fish/guestfish-actions.pod:4847
30843 msgid "zerofree"
30844 msgstr ""
30845
30846 # type: verbatim
30847 #. type: verbatim
30848 #: ../fish/guestfish-actions.pod:4849
30849 #, no-wrap
30850 msgid ""
30851 " zerofree device\n"
30852 "\n"
30853 msgstr ""
30854
30855 # type: =head2
30856 #. type: =head2
30857 #: ../fish/guestfish-actions.pod:4862
30858 msgid "zfgrep"
30859 msgstr ""
30860
30861 # type: verbatim
30862 #. type: verbatim
30863 #: ../fish/guestfish-actions.pod:4864
30864 #, no-wrap
30865 msgid ""
30866 " zfgrep pattern path\n"
30867 "\n"
30868 msgstr ""
30869
30870 # type: =head2
30871 #. type: =head2
30872 #: ../fish/guestfish-actions.pod:4872
30873 msgid "zfgrepi"
30874 msgstr ""
30875
30876 # type: verbatim
30877 #. type: verbatim
30878 #: ../fish/guestfish-actions.pod:4874
30879 #, no-wrap
30880 msgid ""
30881 " zfgrepi pattern path\n"
30882 "\n"
30883 msgstr ""
30884
30885 # type: =head2
30886 #. type: =head2
30887 #: ../fish/guestfish-actions.pod:4882
30888 msgid "zfile"
30889 msgstr ""
30890
30891 # type: verbatim
30892 #. type: verbatim
30893 #: ../fish/guestfish-actions.pod:4884
30894 #, no-wrap
30895 msgid ""
30896 " zfile meth path\n"
30897 "\n"
30898 msgstr ""
30899
30900 # type: textblock
30901 #. type: textblock
30902 #: ../fish/guestfish-actions.pod:4891
30903 msgid ""
30904 "Since 1.0.63, use L</file> instead which can now process compressed files."
30905 msgstr ""
30906
30907 # type: =head2
30908 #. type: =head2
30909 #: ../fish/guestfish-actions.pod:4901
30910 msgid "zgrep"
30911 msgstr ""
30912
30913 # type: verbatim
30914 #. type: verbatim
30915 #: ../fish/guestfish-actions.pod:4903
30916 #, no-wrap
30917 msgid ""
30918 " zgrep regex path\n"
30919 "\n"
30920 msgstr ""
30921
30922 # type: =head2
30923 #. type: =head2
30924 #: ../fish/guestfish-actions.pod:4911
30925 msgid "zgrepi"
30926 msgstr ""
30927
30928 # type: verbatim
30929 #. type: verbatim
30930 #: ../fish/guestfish-actions.pod:4913
30931 #, no-wrap
30932 msgid ""
30933 " zgrepi regex path\n"
30934 "\n"
30935 msgstr ""
30936
30937 # type: =head2
30938 #. type: =head2
30939 #: ../fish/guestfish-commands.pod:1
30940 msgid "alloc"
30941 msgstr ""
30942
30943 # type: =head2
30944 #. type: =head2
30945 #: ../fish/guestfish-commands.pod:3
30946 msgid "allocate"
30947 msgstr ""
30948
30949 # type: verbatim
30950 #. type: verbatim
30951 #: ../fish/guestfish-commands.pod:5
30952 #, no-wrap
30953 msgid ""
30954 " alloc filename size\n"
30955 "\n"
30956 msgstr ""
30957
30958 # type: textblock
30959 #. type: textblock
30960 #: ../fish/guestfish-commands.pod:7
30961 msgid ""
30962 "This creates an empty (zeroed) file of the given size, and then adds so it "
30963 "can be further examined."
30964 msgstr ""
30965
30966 # type: textblock
30967 #. type: textblock
30968 #: ../fish/guestfish-commands.pod:10 ../fish/guestfish-commands.pod:168
30969 msgid "For more advanced image creation, see L<qemu-img(1)> utility."
30970 msgstr ""
30971
30972 # type: textblock
30973 #. type: textblock
30974 #: ../fish/guestfish-commands.pod:12 ../fish/guestfish-commands.pod:170
30975 msgid "Size can be specified using standard suffixes, eg. C<1M>."
30976 msgstr ""
30977
30978 # type: textblock
30979 #. type: textblock
30980 #: ../fish/guestfish-commands.pod:14
30981 msgid ""
30982 "To create a sparse file, use L</sparse> instead.  To create a prepared disk "
30983 "image, see L</PREPARED DISK IMAGES>."
30984 msgstr ""
30985
30986 # type: =head2
30987 #. type: =head2
30988 #: ../fish/guestfish-commands.pod:17
30989 msgid "copy-in"
30990 msgstr ""
30991
30992 # type: verbatim
30993 #. type: verbatim
30994 #: ../fish/guestfish-commands.pod:19
30995 #, no-wrap
30996 msgid ""
30997 " copy-in local [local ...] /remotedir\n"
30998 "\n"
30999 msgstr ""
31000
31001 # type: textblock
31002 #. type: textblock
31003 #: ../fish/guestfish-commands.pod:21
31004 msgid ""
31005 "C<copy-in> copies local files or directories recursively into the disk "
31006 "image, placing them in the directory called C</remotedir> (which must "
31007 "exist).  This guestfish meta-command turns into a sequence of L</tar-in> and "
31008 "other commands as necessary."
31009 msgstr ""
31010
31011 # type: textblock
31012 #. type: textblock
31013 #: ../fish/guestfish-commands.pod:26
31014 msgid ""
31015 "Multiple local files and directories can be specified, but the last "
31016 "parameter must always be a remote directory.  Wildcards cannot be used."
31017 msgstr ""
31018
31019 # type: =head2
31020 #. type: =head2
31021 #: ../fish/guestfish-commands.pod:30
31022 msgid "copy-out"
31023 msgstr ""
31024
31025 # type: verbatim
31026 #. type: verbatim
31027 #: ../fish/guestfish-commands.pod:32
31028 #, no-wrap
31029 msgid ""
31030 " copy-out remote [remote ...] localdir\n"
31031 "\n"
31032 msgstr ""
31033
31034 # type: textblock
31035 #. type: textblock
31036 #: ../fish/guestfish-commands.pod:34
31037 msgid ""
31038 "C<copy-out> copies remote files or directories recursively out of the disk "
31039 "image, placing them on the host disk in a local directory called C<localdir> "
31040 "(which must exist).  This guestfish meta-command turns into a sequence of L</"
31041 "download>, L</tar-out> and other commands as necessary."
31042 msgstr ""
31043
31044 # type: textblock
31045 #. type: textblock
31046 #: ../fish/guestfish-commands.pod:40
31047 msgid ""
31048 "Multiple remote files and directories can be specified, but the last "
31049 "parameter must always be a local directory.  To download to the current "
31050 "directory, use C<.> as in:"
31051 msgstr ""
31052
31053 # type: verbatim
31054 #. type: verbatim
31055 #: ../fish/guestfish-commands.pod:44
31056 #, no-wrap
31057 msgid ""
31058 " copy-out /home .\n"
31059 "\n"
31060 msgstr ""
31061
31062 # type: textblock
31063 #. type: textblock
31064 #: ../fish/guestfish-commands.pod:46
31065 msgid ""
31066 "Wildcards cannot be used in the ordinary command, but you can use them with "
31067 "the help of L</glob> like this:"
31068 msgstr ""
31069
31070 # type: verbatim
31071 #. type: verbatim
31072 #: ../fish/guestfish-commands.pod:49
31073 #, no-wrap
31074 msgid ""
31075 " glob copy-out /home/* .\n"
31076 "\n"
31077 msgstr ""
31078
31079 # type: =head2
31080 #. type: =head2
31081 #: ../fish/guestfish-commands.pod:51
31082 msgid "echo"
31083 msgstr ""
31084
31085 # type: verbatim
31086 #. type: verbatim
31087 #: ../fish/guestfish-commands.pod:53
31088 #, no-wrap
31089 msgid ""
31090 " echo [params ...]\n"
31091 "\n"
31092 msgstr ""
31093
31094 # type: textblock
31095 #. type: textblock
31096 #: ../fish/guestfish-commands.pod:55
31097 msgid "This echos the parameters to the terminal."
31098 msgstr ""
31099
31100 # type: =head2
31101 #. type: =head2
31102 #: ../fish/guestfish-commands.pod:57
31103 msgid "edit"
31104 msgstr ""
31105
31106 # type: =head2
31107 #. type: =head2
31108 #: ../fish/guestfish-commands.pod:59
31109 msgid "vi"
31110 msgstr ""
31111
31112 # type: =head2
31113 #. type: =head2
31114 #: ../fish/guestfish-commands.pod:61
31115 msgid "emacs"
31116 msgstr ""
31117
31118 # type: verbatim
31119 #. type: verbatim
31120 #: ../fish/guestfish-commands.pod:63
31121 #, no-wrap
31122 msgid ""
31123 " edit filename\n"
31124 "\n"
31125 msgstr ""
31126
31127 # type: textblock
31128 #. type: textblock
31129 #: ../fish/guestfish-commands.pod:65
31130 msgid ""
31131 "This is used to edit a file.  It downloads the file, edits it locally using "
31132 "your editor, then uploads the result."
31133 msgstr ""
31134
31135 # type: textblock
31136 #. type: textblock
31137 #: ../fish/guestfish-commands.pod:68
31138 msgid ""
31139 "The editor is C<$EDITOR>.  However if you use the alternate commands C<vi> "
31140 "or C<emacs> you will get those corresponding editors."
31141 msgstr ""
31142
31143 # type: =head2
31144 #. type: =head2
31145 #: ../fish/guestfish-commands.pod:72
31146 msgid "glob"
31147 msgstr ""
31148
31149 # type: verbatim
31150 #. type: verbatim
31151 #: ../fish/guestfish-commands.pod:74
31152 #, no-wrap
31153 msgid ""
31154 " glob command args...\n"
31155 "\n"
31156 msgstr ""
31157
31158 # type: textblock
31159 #. type: textblock
31160 #: ../fish/guestfish-commands.pod:76
31161 msgid ""
31162 "Expand wildcards in any paths in the args list, and run C<command> "
31163 "repeatedly on each matching path."
31164 msgstr ""
31165
31166 # type: textblock
31167 #. type: textblock
31168 #: ../fish/guestfish-commands.pod:79
31169 msgid "See L</WILDCARDS AND GLOBBING>."
31170 msgstr ""
31171
31172 # type: =head2
31173 #. type: =head2
31174 #: ../fish/guestfish-commands.pod:81
31175 msgid "hexedit"
31176 msgstr ""
31177
31178 # type: verbatim
31179 #. type: verbatim
31180 #: ../fish/guestfish-commands.pod:83
31181 #, no-wrap
31182 msgid ""
31183 " hexedit <filename|device>\n"
31184 " hexedit <filename|device> <max>\n"
31185 " hexedit <filename|device> <start> <max>\n"
31186 "\n"
31187 msgstr ""
31188
31189 # type: textblock
31190 #. type: textblock
31191 #: ../fish/guestfish-commands.pod:87
31192 msgid ""
31193 "Use hexedit (a hex editor) to edit all or part of a binary file or block "
31194 "device."
31195 msgstr ""
31196
31197 # type: textblock
31198 #. type: textblock
31199 #: ../fish/guestfish-commands.pod:90
31200 msgid ""
31201 "This command works by downloading potentially the whole file or device, "
31202 "editing it locally, then uploading it.  If the file or device is large, you "
31203 "have to specify which part you wish to edit by using C<max> and/or C<start> "
31204 "C<max> parameters.  C<start> and C<max> are specified in bytes, with the "
31205 "usual modifiers allowed such as C<1M> (1 megabyte)."
31206 msgstr ""
31207
31208 # type: textblock
31209 #. type: textblock
31210 #: ../fish/guestfish-commands.pod:97
31211 msgid "For example to edit the first few sectors of a disk you might do:"
31212 msgstr ""
31213
31214 # type: verbatim
31215 #. type: verbatim
31216 #: ../fish/guestfish-commands.pod:100
31217 #, no-wrap
31218 msgid ""
31219 " hexedit /dev/sda 1M\n"
31220 "\n"
31221 msgstr ""
31222
31223 # type: textblock
31224 #. type: textblock
31225 #: ../fish/guestfish-commands.pod:102
31226 msgid ""
31227 "which would allow you to edit anywhere within the first megabyte of the disk."
31228 msgstr ""
31229
31230 # type: textblock
31231 #. type: textblock
31232 #: ../fish/guestfish-commands.pod:105
31233 msgid "To edit the superblock of an ext2 filesystem on C</dev/sda1>, do:"
31234 msgstr ""
31235
31236 # type: verbatim
31237 #. type: verbatim
31238 #: ../fish/guestfish-commands.pod:107
31239 #, no-wrap
31240 msgid ""
31241 " hexedit /dev/sda1 0x400 0x400\n"
31242 "\n"
31243 msgstr ""
31244
31245 # type: textblock
31246 #. type: textblock
31247 #: ../fish/guestfish-commands.pod:109
31248 msgid "(assuming the superblock is in the standard location)."
31249 msgstr ""
31250
31251 # type: textblock
31252 #. type: textblock
31253 #: ../fish/guestfish-commands.pod:111
31254 msgid ""
31255 "This command requires the external L<hexedit(1)> program.  You can specify "
31256 "another program to use by setting the C<HEXEDITOR> environment variable."
31257 msgstr ""
31258
31259 # type: textblock
31260 #. type: textblock
31261 #: ../fish/guestfish-commands.pod:115
31262 msgid "See also L</hexdump>."
31263 msgstr ""
31264
31265 # type: =head2
31266 #. type: =head2
31267 #: ../fish/guestfish-commands.pod:117
31268 msgid "lcd"
31269 msgstr ""
31270
31271 # type: verbatim
31272 #. type: verbatim
31273 #: ../fish/guestfish-commands.pod:119
31274 #, no-wrap
31275 msgid ""
31276 " lcd directory\n"
31277 "\n"
31278 msgstr ""
31279
31280 # type: textblock
31281 #. type: textblock
31282 #: ../fish/guestfish-commands.pod:121
31283 msgid ""
31284 "Change the local directory, ie. the current directory of guestfish itself."
31285 msgstr ""
31286
31287 # type: textblock
31288 #. type: textblock
31289 #: ../fish/guestfish-commands.pod:124
31290 msgid "Note that C<!cd> won't do what you might expect."
31291 msgstr ""
31292
31293 # type: =head2
31294 #. type: =head2
31295 #: ../fish/guestfish-commands.pod:126
31296 msgid "man"
31297 msgstr ""
31298
31299 # type: =head2
31300 #. type: =head2
31301 #: ../fish/guestfish-commands.pod:128
31302 msgid "manual"
31303 msgstr ""
31304
31305 # type: verbatim
31306 #. type: verbatim
31307 #: ../fish/guestfish-commands.pod:130
31308 #, no-wrap
31309 msgid ""
31310 "  man\n"
31311 "\n"
31312 msgstr ""
31313
31314 # type: textblock
31315 #. type: textblock
31316 #: ../fish/guestfish-commands.pod:132
31317 msgid "Opens the manual page for guestfish."
31318 msgstr ""
31319
31320 # type: =head2
31321 #. type: =head2
31322 #: ../fish/guestfish-commands.pod:134
31323 msgid "more"
31324 msgstr ""
31325
31326 # type: =head2
31327 #. type: =head2
31328 #: ../fish/guestfish-commands.pod:136
31329 msgid "less"
31330 msgstr ""
31331
31332 # type: verbatim
31333 #. type: verbatim
31334 #: ../fish/guestfish-commands.pod:138
31335 #, no-wrap
31336 msgid ""
31337 " more filename\n"
31338 "\n"
31339 msgstr ""
31340
31341 # type: verbatim
31342 #. type: verbatim
31343 #: ../fish/guestfish-commands.pod:140
31344 #, no-wrap
31345 msgid ""
31346 " less filename\n"
31347 "\n"
31348 msgstr ""
31349
31350 # type: textblock
31351 #. type: textblock
31352 #: ../fish/guestfish-commands.pod:142
31353 msgid "This is used to view a file."
31354 msgstr ""
31355
31356 # type: textblock
31357 #. type: textblock
31358 #: ../fish/guestfish-commands.pod:144
31359 msgid ""
31360 "The default viewer is C<$PAGER>.  However if you use the alternate command "
31361 "C<less> you will get the C<less> command specifically."
31362 msgstr ""
31363
31364 # type: =head2
31365 #. type: =head2
31366 #: ../fish/guestfish-commands.pod:147
31367 msgid "reopen"
31368 msgstr ""
31369
31370 # type: verbatim
31371 #. type: verbatim
31372 #: ../fish/guestfish-commands.pod:149
31373 #, no-wrap
31374 msgid ""
31375 "  reopen\n"
31376 "\n"
31377 msgstr ""
31378
31379 # type: textblock
31380 #. type: textblock
31381 #: ../fish/guestfish-commands.pod:151
31382 msgid ""
31383 "Close and reopen the libguestfs handle.  It is not necessary to use this "
31384 "normally, because the handle is closed properly when guestfish exits.  "
31385 "However this is occasionally useful for testing."
31386 msgstr ""
31387
31388 # type: =head2
31389 #. type: =head2
31390 #: ../fish/guestfish-commands.pod:155
31391 msgid "sparse"
31392 msgstr ""
31393
31394 # type: verbatim
31395 #. type: verbatim
31396 #: ../fish/guestfish-commands.pod:157
31397 #, no-wrap
31398 msgid ""
31399 " sparse filename size\n"
31400 "\n"
31401 msgstr ""
31402
31403 # type: textblock
31404 #. type: textblock
31405 #: ../fish/guestfish-commands.pod:159
31406 msgid ""
31407 "This creates an empty sparse file of the given size, and then adds so it can "
31408 "be further examined."
31409 msgstr ""
31410
31411 # type: textblock
31412 #. type: textblock
31413 #: ../fish/guestfish-commands.pod:162
31414 msgid ""
31415 "In all respects it works the same as the L</alloc> command, except that the "
31416 "image file is allocated sparsely, which means that disk blocks are not "
31417 "assigned to the file until they are needed.  Sparse disk files only use "
31418 "space when written to, but they are slower and there is a danger you could "
31419 "run out of real disk space during a write operation."
31420 msgstr ""
31421
31422 # type: =head2
31423 #. type: =head2
31424 #: ../fish/guestfish-commands.pod:172
31425 msgid "supported"
31426 msgstr ""
31427
31428 # type: verbatim
31429 #. type: verbatim
31430 #: ../fish/guestfish-commands.pod:174
31431 #, no-wrap
31432 msgid ""
31433 " supported\n"
31434 "\n"
31435 msgstr ""
31436
31437 # type: textblock
31438 #. type: textblock
31439 #: ../fish/guestfish-commands.pod:176
31440 msgid ""
31441 "This command returns a list of the optional groups known to the daemon, and "
31442 "indicates which ones are supported by this build of the libguestfs appliance."
31443 msgstr ""
31444
31445 # type: textblock
31446 #. type: textblock
31447 #: ../fish/guestfish-commands.pod:180
31448 msgid "See also L<guestfs(3)/AVAILABILITY>."
31449 msgstr ""
31450
31451 # type: =head2
31452 #. type: =head2
31453 #: ../fish/guestfish-commands.pod:182
31454 msgid "time"
31455 msgstr ""
31456
31457 # type: verbatim
31458 #. type: verbatim
31459 #: ../fish/guestfish-commands.pod:184
31460 #, no-wrap
31461 msgid ""
31462 " time command args...\n"
31463 "\n"
31464 msgstr ""
31465
31466 # type: textblock
31467 #. type: textblock
31468 #: ../fish/guestfish-commands.pod:186
31469 msgid ""
31470 "Run the command as usual, but print the elapsed time afterwards.  This can "
31471 "be useful for benchmarking operations."
31472 msgstr ""
31473
31474 # type: textblock
31475 #. type: textblock
31476 #: ../test-tool/libguestfs-test-tool.pod:5
31477 msgid "libguestfs-test-tool - End user tests for libguestfs"
31478 msgstr ""
31479
31480 # type: verbatim
31481 #. type: verbatim
31482 #: ../test-tool/libguestfs-test-tool.pod:9
31483 #, no-wrap
31484 msgid ""
31485 " libguestfs-test-tool [--options]\n"
31486 "\n"
31487 msgstr ""
31488
31489 # type: textblock
31490 #. type: textblock
31491 #: ../test-tool/libguestfs-test-tool.pod:13
31492 msgid ""
31493 "libguestfs-test-tool is a test program shipped with libguestfs to end users "
31494 "and developers, to allow them to check basic libguestfs functionality is "
31495 "working.  This is needed because libguestfs occasionally breaks for reasons "
31496 "beyond our control: usually because of changes in the underlying qemu or "
31497 "kernel packages, or the host environment."
31498 msgstr ""
31499
31500 # type: textblock
31501 #. type: textblock
31502 #: ../test-tool/libguestfs-test-tool.pod:20
31503 msgid "If you suspect a problem in libguestfs, then just run:"
31504 msgstr ""
31505
31506 # type: verbatim
31507 #. type: verbatim
31508 #: ../test-tool/libguestfs-test-tool.pod:22
31509 #, no-wrap
31510 msgid ""
31511 " libguestfs-test-tool\n"
31512 "\n"
31513 msgstr ""
31514
31515 # type: textblock
31516 #. type: textblock
31517 #: ../test-tool/libguestfs-test-tool.pod:24
31518 msgid "It will print lots of diagnostic messages."
31519 msgstr ""
31520
31521 # type: textblock
31522 #. type: textblock
31523 #: ../test-tool/libguestfs-test-tool.pod:26
31524 msgid "If it runs to completion successfully, you will see this near the end:"
31525 msgstr ""
31526
31527 # type: verbatim
31528 #. type: verbatim
31529 #: ../test-tool/libguestfs-test-tool.pod:28
31530 #, no-wrap
31531 msgid ""
31532 " ===== TEST FINISHED OK =====\n"
31533 "\n"
31534 msgstr ""
31535
31536 # type: textblock
31537 #. type: textblock
31538 #: ../test-tool/libguestfs-test-tool.pod:30
31539 msgid "and the test tool will exit with code 0."
31540 msgstr ""
31541
31542 # type: textblock
31543 #. type: textblock
31544 #: ../test-tool/libguestfs-test-tool.pod:32
31545 msgid ""
31546 "If it fails (and/or exits with non-zero error code), please paste the "
31547 "B<complete, unedited> output of the test tool into a bug report.  More "
31548 "information about reporting bugs can be found on the L<http://libguestfs.org/"
31549 "> website."
31550 msgstr ""
31551
31552 # type: =item
31553 #. type: =item
31554 #: ../test-tool/libguestfs-test-tool.pod:41
31555 msgid "I<--help>"
31556 msgstr ""
31557
31558 # type: textblock
31559 #. type: textblock
31560 #: ../test-tool/libguestfs-test-tool.pod:43
31561 msgid "Display short usage information and exit."
31562 msgstr ""
31563
31564 # type: =item
31565 #. type: =item
31566 #: ../test-tool/libguestfs-test-tool.pod:45
31567 msgid "I<--helper /path/to/libguestfs-test-tool-helper>"
31568 msgstr ""
31569
31570 # type: textblock
31571 #. type: textblock
31572 #: ../test-tool/libguestfs-test-tool.pod:47
31573 msgid ""
31574 "Pass an alternate name for the helper program.  libguestfs-test-tool will "
31575 "normally look in the C<$libexec> directory that was configured when the tool "
31576 "was built."
31577 msgstr ""
31578
31579 # type: =item
31580 #. type: =item
31581 #: ../test-tool/libguestfs-test-tool.pod:51
31582 msgid "I<--qemu qemu_binary>"
31583 msgstr ""
31584
31585 # type: textblock
31586 #. type: textblock
31587 #: ../test-tool/libguestfs-test-tool.pod:53
31588 msgid ""
31589 "If you have downloaded another qemu binary, point this option at the full "
31590 "path of the binary to try it."
31591 msgstr ""
31592
31593 # type: =item
31594 #. type: =item
31595 #: ../test-tool/libguestfs-test-tool.pod:56
31596 msgid "I<--qemudir qemu_source_dir>"
31597 msgstr ""
31598
31599 # type: textblock
31600 #. type: textblock
31601 #: ../test-tool/libguestfs-test-tool.pod:58
31602 msgid ""
31603 "If you have compiled qemu from source, point this option at the source "
31604 "directory to try it."
31605 msgstr ""
31606
31607 # type: =item
31608 #. type: =item
31609 #: ../test-tool/libguestfs-test-tool.pod:61
31610 msgid "I<--timeout N>"
31611 msgstr ""
31612
31613 # type: textblock
31614 #. type: textblock
31615 #: ../test-tool/libguestfs-test-tool.pod:63
31616 msgid ""
31617 "Set the launch timeout to C<N> seconds.  The default is 120 seconds which "
31618 "does not usually need to be adjusted unless your machine is very slow."
31619 msgstr ""
31620
31621 # type: =head1
31622 #. type: =head1
31623 #: ../test-tool/libguestfs-test-tool.pod:69
31624 msgid "TRYING OUT A DIFFERENT VERSION OF QEMU"
31625 msgstr ""
31626
31627 # type: textblock
31628 #. type: textblock
31629 #: ../test-tool/libguestfs-test-tool.pod:71
31630 msgid ""
31631 "If you have compiled another version of qemu from source and would like to "
31632 "try that, then you can use the I<--qemudir> option to point to the qemu "
31633 "source directory."
31634 msgstr ""
31635
31636 # type: textblock
31637 #. type: textblock
31638 #: ../test-tool/libguestfs-test-tool.pod:75
31639 msgid ""
31640 "If you have downloaded a qemu binary from somewhere, use the I<--qemu> "
31641 "option to point to the binary."
31642 msgstr ""
31643
31644 # type: textblock
31645 #. type: textblock
31646 #: ../test-tool/libguestfs-test-tool.pod:78
31647 msgid ""
31648 "When using an alternate qemu with libguestfs, usually you would need to "
31649 "write a qemu wrapper script (see section I<QEMU WRAPPERS> in L<guestfs(3)"
31650 ">).  libguestfs-test-tool writes a temporary qemu wrapper script when you "
31651 "use either of the I<--qemudir> or I<--qemu> options."
31652 msgstr ""
31653
31654 # type: textblock
31655 #. type: textblock
31656 #: ../test-tool/libguestfs-test-tool.pod:85
31657 msgid ""
31658 "libguestfs-test-tool returns I<0> if the tests completed without error, or "
31659 "I<1> if there was an error."
31660 msgstr ""
31661
31662 # type: =item
31663 #. type: =item
31664 #: ../test-tool/libguestfs-test-tool.pod:92
31665 msgid "/usr/libexec/libguestfs-test-tool-helper"
31666 msgstr ""
31667
31668 # type: textblock
31669 #. type: textblock
31670 #: ../test-tool/libguestfs-test-tool.pod:94
31671 msgid ""
31672 "This helper program is run inside the appliance and provides additional "
31673 "tests."
31674 msgstr ""
31675
31676 # type: =item
31677 #. type: =item
31678 #: ../test-tool/libguestfs-test-tool.pod:97
31679 msgid "/usr/bin/mkisofs"
31680 msgstr ""
31681
31682 # type: textblock
31683 #. type: textblock
31684 #: ../test-tool/libguestfs-test-tool.pod:99
31685 msgid ""
31686 "The C<mkisofs> command is required in order to construct a CD-ROM ISO file "
31687 "which is used as part of the tests."
31688 msgstr ""
31689
31690 # type: textblock
31691 #. type: textblock
31692 #: ../test-tool/libguestfs-test-tool.pod:106
31693 msgid ""
31694 "For the full list of environment variables which may affect libguestfs, "
31695 "please see the L<guestfs(3)> manual page."
31696 msgstr ""
31697
31698 # type: textblock
31699 #. type: textblock
31700 #: ../test-tool/libguestfs-test-tool.pod:111
31701 msgid "L<guestfs(3)>, L<http://libguestfs.org/>, L<http://qemu.org/>."
31702 msgstr ""
31703
31704 # type: textblock
31705 #. type: textblock
31706 #: ../test-tool/libguestfs-test-tool.pod:121
31707 msgid "Copyright (C) 2009 Red Hat Inc.  L<http://libguestfs.org/>"
31708 msgstr ""
31709
31710 # type: textblock
31711 #. type: textblock
31712 #: ../fuse/guestmount.pod:5
31713 msgid ""
31714 "guestmount - Mount a guest filesystem on the host using FUSE and libguestfs"
31715 msgstr ""
31716
31717 # type: verbatim
31718 #. type: verbatim
31719 #: ../fuse/guestmount.pod:9
31720 #, no-wrap
31721 msgid ""
31722 " guestmount [--options] -a disk.img -m device [--ro] mountpoint\n"
31723 "\n"
31724 msgstr ""
31725
31726 # type: verbatim
31727 #. type: verbatim
31728 #: ../fuse/guestmount.pod:11
31729 #, no-wrap
31730 msgid ""
31731 " guestmount [--options] -a disk.img -i [--ro] mountpoint\n"
31732 "\n"
31733 msgstr ""
31734
31735 # type: verbatim
31736 #. type: verbatim
31737 #: ../fuse/guestmount.pod:13
31738 #, no-wrap
31739 msgid ""
31740 " guestmount [--options] -d Guest -i [--ro] mountpoint\n"
31741 "\n"
31742 msgstr ""
31743
31744 # type: textblock
31745 #. type: textblock
31746 #: ../fuse/guestmount.pod:17
31747 msgid ""
31748 "You must I<not> use C<guestmount> in read-write mode on live virtual "
31749 "machines.  If you do this, you risk disk corruption in the VM."
31750 msgstr ""
31751
31752 # type: textblock
31753 #. type: textblock
31754 #: ../fuse/guestmount.pod:22
31755 msgid ""
31756 "The guestmount program can be used to mount virtual machine filesystems and "
31757 "other disk images on the host.  It uses libguestfs for access to the guest "
31758 "filesystem, and FUSE (the \"filesystem in userspace\") to make it appear as "
31759 "a mountable device."
31760 msgstr ""
31761
31762 # type: textblock
31763 #. type: textblock
31764 #: ../fuse/guestmount.pod:27
31765 msgid ""
31766 "Along with other options, you have to give at least one device (I<-a> "
31767 "option) or libvirt domain (I<-d> option), and at least one mountpoint (I<-m> "
31768 "option) or use the I<-i> inspection option.  How this works is better "
31769 "explained in the L<guestfish(1)> manual page, or by looking at the examples "
31770 "below."
31771 msgstr ""
31772
31773 # type: textblock
31774 #. type: textblock
31775 #: ../fuse/guestmount.pod:33
31776 msgid ""
31777 "FUSE lets you mount filesystems as non-root.  The mountpoint must be owned "
31778 "by you, and the filesystem will not be visible to any other users unless you "
31779 "make certain global configuration changes to C</etc/fuse.conf>.  To unmount "
31780 "the filesystem, use the C<fusermount -u> command."
31781 msgstr ""
31782
31783 # type: textblock
31784 #. type: textblock
31785 #: ../fuse/guestmount.pod:41
31786 msgid ""
31787 "For a typical Windows guest which has its main filesystem on the first "
31788 "partition:"
31789 msgstr ""
31790
31791 # type: verbatim
31792 #. type: verbatim
31793 #: ../fuse/guestmount.pod:44
31794 #, no-wrap
31795 msgid ""
31796 " guestmount -a windows.img -m /dev/sda1 --ro /mnt\n"
31797 "\n"
31798 msgstr ""
31799
31800 # type: textblock
31801 #. type: textblock
31802 #: ../fuse/guestmount.pod:46
31803 msgid ""
31804 "For a typical Linux guest which has a /boot filesystem on the first "
31805 "partition, and the root filesystem on a logical volume:"
31806 msgstr ""
31807
31808 # type: verbatim
31809 #. type: verbatim
31810 #: ../fuse/guestmount.pod:49
31811 #, no-wrap
31812 msgid ""
31813 " guestmount -a linux.img -m /dev/VG/LV -m /dev/sda1:/boot --ro /mnt\n"
31814 "\n"
31815 msgstr ""
31816
31817 # type: textblock
31818 #. type: textblock
31819 #: ../fuse/guestmount.pod:51
31820 msgid "To get libguestfs to detect guest mountpoints for you:"
31821 msgstr ""
31822
31823 # type: verbatim
31824 #. type: verbatim
31825 #: ../fuse/guestmount.pod:53
31826 #, no-wrap
31827 msgid ""
31828 " guestmount -a guest.img -i --ro /mnt\n"
31829 "\n"
31830 msgstr ""
31831
31832 # type: textblock
31833 #. type: textblock
31834 #: ../fuse/guestmount.pod:55
31835 msgid "For a libvirt guest called \"Guest\" you could do:"
31836 msgstr ""
31837
31838 # type: verbatim
31839 #. type: verbatim
31840 #: ../fuse/guestmount.pod:57
31841 #, no-wrap
31842 msgid ""
31843 " guestmount -d Guest -i --ro /mnt\n"
31844 "\n"
31845 msgstr ""
31846
31847 # type: textblock
31848 #. type: textblock
31849 #: ../fuse/guestmount.pod:59
31850 msgid ""
31851 "If you don't know what filesystems are contained in a guest or disk image, "
31852 "use L<virt-filesystems(1)> first:"
31853 msgstr ""
31854
31855 # type: verbatim
31856 #. type: verbatim
31857 #: ../fuse/guestmount.pod:62
31858 #, no-wrap
31859 msgid ""
31860 " virt-filesystems MyGuest\n"
31861 "\n"
31862 msgstr ""
31863
31864 # type: textblock
31865 #. type: textblock
31866 #: ../fuse/guestmount.pod:64
31867 msgid ""
31868 "If you want to trace the libguestfs calls but without excessive debugging "
31869 "information, we recommend:"
31870 msgstr ""
31871
31872 # type: verbatim
31873 #. type: verbatim
31874 #: ../fuse/guestmount.pod:67
31875 #, no-wrap
31876 msgid ""
31877 " guestmount [...] --trace /mnt\n"
31878 "\n"
31879 msgstr ""
31880
31881 # type: textblock
31882 #. type: textblock
31883 #: ../fuse/guestmount.pod:69
31884 msgid "If you want to debug the program, we recommend:"
31885 msgstr ""
31886
31887 # type: verbatim
31888 #. type: verbatim
31889 #: ../fuse/guestmount.pod:71
31890 #, no-wrap
31891 msgid ""
31892 " guestmount [...] --trace --verbose /mnt\n"
31893 "\n"
31894 msgstr ""
31895
31896 # type: =item
31897 #. type: =item
31898 #: ../fuse/guestmount.pod:77
31899 msgid "B<-a image> | B<--add image>"
31900 msgstr ""
31901
31902 # type: textblock
31903 #. type: textblock
31904 #: ../fuse/guestmount.pod:79
31905 msgid "Add a block device or virtual machine image."
31906 msgstr ""
31907
31908 # type: =item
31909 #. type: =item
31910 #: ../fuse/guestmount.pod:84
31911 msgid "B<-c URI> | B<--connect URI>"
31912 msgstr ""
31913
31914 # type: =item
31915 #. type: =item
31916 #: ../fuse/guestmount.pod:90
31917 msgid "B<-d libvirt-domain> | B<--domain libvirt-domain>"
31918 msgstr ""
31919
31920 # type: =item
31921 #. type: =item
31922 #: ../fuse/guestmount.pod:96
31923 msgid "B<--dir-cache-timeout N>"
31924 msgstr ""
31925
31926 # type: textblock
31927 #. type: textblock
31928 #: ../fuse/guestmount.pod:98
31929 msgid ""
31930 "Set the readdir cache timeout to I<N> seconds, the default being 60 "
31931 "seconds.  The readdir cache [actually, there are several semi-independent "
31932 "caches] is populated after a readdir(2) call with the stat and extended "
31933 "attributes of the files in the directory, in anticipation that they will be "
31934 "requested soon after."
31935 msgstr ""
31936
31937 # type: textblock
31938 #. type: textblock
31939 #: ../fuse/guestmount.pod:104
31940 msgid ""
31941 "There is also a different attribute cache implemented by FUSE (see the FUSE "
31942 "option I<-o attr_timeout>), but the FUSE cache does not anticipate future "
31943 "requests, only cache existing ones."
31944 msgstr ""
31945
31946 # type: =item
31947 #. type: =item
31948 #: ../fuse/guestmount.pod:115
31949 msgid "B<--format=raw|qcow2|..> | B<--format>"
31950 msgstr ""
31951
31952 # type: textblock
31953 #. type: textblock
31954 #: ../fuse/guestmount.pod:122
31955 msgid ""
31956 "If you have untrusted raw-format guest disk images, you should use this "
31957 "option to specify the disk format.  This avoids a possible security problem "
31958 "with malicious guests (CVE-2010-3851).  See also L<guestfs(3)/"
31959 "guestfs_add_drive_opts>."
31960 msgstr ""
31961
31962 # type: =item
31963 #. type: =item
31964 #: ../fuse/guestmount.pod:127
31965 msgid "B<--fuse-help>"
31966 msgstr ""
31967
31968 # type: textblock
31969 #. type: textblock
31970 #: ../fuse/guestmount.pod:129
31971 msgid "Display help on special FUSE options (see I<-o> below)."
31972 msgstr ""
31973
31974 # type: textblock
31975 #. type: textblock
31976 #: ../fuse/guestmount.pod:133
31977 msgid "Display brief help and exit."
31978 msgstr ""
31979
31980 # type: =item
31981 #. type: =item
31982 #: ../fuse/guestmount.pod:135
31983 msgid "B<-i> | B<--inspector>"
31984 msgstr ""
31985
31986 # type: textblock
31987 #. type: textblock
31988 #: ../fuse/guestmount.pod:155
31989 msgid ""
31990 "Mount the named partition or logical volume on the given mountpoint B<in the "
31991 "guest> (this has nothing to do with mountpoints in the host)."
31992 msgstr ""
31993
31994 # type: textblock
31995 #. type: textblock
31996 #: ../fuse/guestmount.pod:158
31997 msgid ""
31998 "If the mountpoint is omitted, it defaults to C</>.  You have to mount "
31999 "something on C</>."
32000 msgstr ""
32001
32002 # type: =item
32003 #. type: =item
32004 #: ../fuse/guestmount.pod:171
32005 msgid "B<-n> | B<--no-sync>"
32006 msgstr ""
32007
32008 # type: textblock
32009 #. type: textblock
32010 #: ../fuse/guestmount.pod:173
32011 msgid ""
32012 "By default, we attempt to sync the guest disk when the FUSE mountpoint is "
32013 "unmounted.  If you specify this option, then we don't attempt to sync the "
32014 "disk.  See the discussion of autosync in the L<guestfs(3)> manpage."
32015 msgstr ""
32016
32017 # type: =item
32018 #. type: =item
32019 #: ../fuse/guestmount.pod:178
32020 msgid "B<-o option> | B<--option option>"
32021 msgstr ""
32022
32023 # type: textblock
32024 #. type: textblock
32025 #: ../fuse/guestmount.pod:180
32026 msgid "Pass extra options to FUSE."
32027 msgstr ""
32028
32029 # type: textblock
32030 #. type: textblock
32031 #: ../fuse/guestmount.pod:182
32032 msgid ""
32033 "To get a list of all the extra options supported by FUSE, use the command "
32034 "below.  Note that only the FUSE I<-o> options can be passed, and only some "
32035 "of them are a good idea."
32036 msgstr ""
32037
32038 # type: verbatim
32039 #. type: verbatim
32040 #: ../fuse/guestmount.pod:186
32041 #, no-wrap
32042 msgid ""
32043 " guestmount --fuse-help\n"
32044 "\n"
32045 msgstr ""
32046
32047 # type: textblock
32048 #. type: textblock
32049 #: ../fuse/guestmount.pod:188
32050 msgid "Some potentially useful FUSE options:"
32051 msgstr ""
32052
32053 # type: =item
32054 #. type: =item
32055 #: ../fuse/guestmount.pod:192
32056 msgid "B<-o allow_other>"
32057 msgstr ""
32058
32059 # type: textblock
32060 #. type: textblock
32061 #: ../fuse/guestmount.pod:194
32062 msgid "Allow other users to see the filesystem."
32063 msgstr ""
32064
32065 # type: =item
32066 #. type: =item
32067 #: ../fuse/guestmount.pod:196
32068 msgid "B<-o attr_timeout=N>"
32069 msgstr ""
32070
32071 # type: textblock
32072 #. type: textblock
32073 #: ../fuse/guestmount.pod:198
32074 msgid "Enable attribute caching by FUSE, and set the timeout to I<N> seconds."
32075 msgstr ""
32076
32077 # type: =item
32078 #. type: =item
32079 #: ../fuse/guestmount.pod:200
32080 msgid "B<-o kernel_cache>"
32081 msgstr ""
32082
32083 # type: textblock
32084 #. type: textblock
32085 #: ../fuse/guestmount.pod:202
32086 msgid ""
32087 "Allow the kernel to cache files (reduces the number of reads that have to go "
32088 "through the L<guestfs(3)> API).  This is generally a good idea if you can "
32089 "afford the extra memory usage."
32090 msgstr ""
32091
32092 # type: =item
32093 #. type: =item
32094 #: ../fuse/guestmount.pod:206
32095 msgid "B<-o uid=N> B<-o gid=N>"
32096 msgstr ""
32097
32098 # type: textblock
32099 #. type: textblock
32100 #: ../fuse/guestmount.pod:208
32101 msgid ""
32102 "Use these options to map all UIDs and GIDs inside the guest filesystem to "
32103 "the chosen values."
32104 msgstr ""
32105
32106 # type: =item
32107 #. type: =item
32108 #: ../fuse/guestmount.pod:213
32109 msgid "B<-r> | B<--ro>"
32110 msgstr ""
32111
32112 # type: textblock
32113 #. type: textblock
32114 #: ../fuse/guestmount.pod:215
32115 msgid ""
32116 "Add devices and mount everything read-only.  Also disallow writes and make "
32117 "the disk appear read-only to FUSE."
32118 msgstr ""
32119
32120 # type: textblock
32121 #. type: textblock
32122 #: ../fuse/guestmount.pod:218
32123 msgid ""
32124 "This is highly recommended if you are not going to edit the guest disk.  If "
32125 "the guest is running and this option is I<not> supplied, then there is a "
32126 "strong risk of disk corruption in the guest.  We try to prevent this from "
32127 "happening, but it is not always possible."
32128 msgstr ""
32129
32130 # type: textblock
32131 #. type: textblock
32132 #: ../fuse/guestmount.pod:223
32133 msgid "See also L<guestfish(1)/OPENING DISKS FOR READ AND WRITE>."
32134 msgstr ""
32135
32136 # type: textblock
32137 #. type: textblock
32138 #: ../fuse/guestmount.pod:227
32139 msgid "Enable SELinux support for the guest."
32140 msgstr ""
32141
32142 # type: =item
32143 #. type: =item
32144 #: ../fuse/guestmount.pod:229
32145 msgid "B<-v> | B<--verbose>"
32146 msgstr ""
32147
32148 # type: textblock
32149 #. type: textblock
32150 #: ../fuse/guestmount.pod:231
32151 msgid "Enable verbose messages from underlying libguestfs."
32152 msgstr ""
32153
32154 # type: =item
32155 #. type: =item
32156 #: ../fuse/guestmount.pod:233
32157 msgid "B<-V> | B<--version>"
32158 msgstr ""
32159
32160 # type: textblock
32161 #. type: textblock
32162 #: ../fuse/guestmount.pod:235
32163 msgid "Display the program version and exit."
32164 msgstr ""
32165
32166 # type: =item
32167 #. type: =item
32168 #: ../fuse/guestmount.pod:237
32169 msgid "B<-w> | B<--rw>"
32170 msgstr ""
32171
32172 # type: textblock
32173 #. type: textblock
32174 #: ../fuse/guestmount.pod:239
32175 msgid ""
32176 "This option does nothing at the moment.  See L<guestfish(1)/OPENING DISKS "
32177 "FOR READ AND WRITE>."
32178 msgstr ""
32179
32180 # type: =item
32181 #. type: =item
32182 #: ../fuse/guestmount.pod:242
32183 msgid "B<-x> | B<--trace>"
32184 msgstr ""
32185
32186 # type: textblock
32187 #. type: textblock
32188 #: ../fuse/guestmount.pod:244
32189 msgid "Trace libguestfs calls and entry into each FUSE function."
32190 msgstr ""
32191
32192 # type: textblock
32193 #. type: textblock
32194 #: ../fuse/guestmount.pod:246
32195 msgid "This also stops the daemon from forking into the background."
32196 msgstr ""
32197
32198 # type: textblock
32199 #. type: textblock
32200 #: ../fuse/guestmount.pod:252
32201 msgid ""
32202 "L<guestfish(1)>, L<virt-inspector(1)>, L<virt-cat(1)>, L<virt-edit(1)>, "
32203 "L<virt-tar(1)>, L<guestfs(3)>, L<http://libguestfs.org/>, L<http://fuse.sf."
32204 "net/>."
32205 msgstr ""
32206
32207 # type: textblock
32208 #. type: textblock
32209 #: ../tools/virt-edit.pl:34
32210 msgid "virt-edit - Edit a file in a virtual machine"
32211 msgstr ""
32212
32213 # type: verbatim
32214 #. type: verbatim
32215 #: ../tools/virt-edit.pl:38
32216 #, no-wrap
32217 msgid ""
32218 " virt-edit [--options] domname file\n"
32219 "\n"
32220 msgstr ""
32221
32222 # type: verbatim
32223 #. type: verbatim
32224 #: ../tools/virt-edit.pl:40
32225 #, no-wrap
32226 msgid ""
32227 " virt-edit [--options] disk.img [disk.img ...] file\n"
32228 "\n"
32229 msgstr ""
32230
32231 # type: verbatim
32232 #. type: verbatim
32233 #: ../tools/virt-edit.pl:42
32234 #, no-wrap
32235 msgid ""
32236 " virt-edit [domname|disk.img] file -e 'expr'\n"
32237 "\n"
32238 msgstr ""
32239
32240 # type: textblock
32241 #. type: textblock
32242 #: ../tools/virt-edit.pl:46
32243 msgid ""
32244 "You must I<not> use C<virt-edit> on live virtual machines.  If you do this, "
32245 "you risk disk corruption in the VM.  C<virt-edit> tries to stop you from "
32246 "doing this, but doesn't catch all cases."
32247 msgstr ""
32248
32249 # type: textblock
32250 #. type: textblock
32251 #: ../tools/virt-edit.pl:52
32252 msgid ""
32253 "C<virt-edit> is a command line tool to edit C<file> where C<file> exists in "
32254 "the named virtual machine (or disk image)."
32255 msgstr ""
32256
32257 # type: textblock
32258 #. type: textblock
32259 #: ../tools/virt-edit.pl:55
32260 msgid ""
32261 "If you want to just view a file, use L<virt-cat(1)>.  For more complex cases "
32262 "you should look at the L<guestfish(1)> tool."
32263 msgstr ""
32264
32265 # type: textblock
32266 #. type: textblock
32267 #: ../tools/virt-edit.pl:60
32268 msgid "Edit the named files interactively:"
32269 msgstr ""
32270
32271 # type: verbatim
32272 #. type: verbatim
32273 #: ../tools/virt-edit.pl:62
32274 #, no-wrap
32275 msgid ""
32276 " virt-edit mydomain /boot/grub/grub.conf\n"
32277 "\n"
32278 msgstr ""
32279
32280 # type: verbatim
32281 #. type: verbatim
32282 #: ../tools/virt-edit.pl:64
32283 #, no-wrap
32284 msgid ""
32285 " virt-edit mydomain /etc/passwd\n"
32286 "\n"
32287 msgstr ""
32288
32289 # type: textblock
32290 #. type: textblock
32291 #: ../tools/virt-edit.pl:66
32292 msgid ""
32293 "You can also edit files non-interactively (see L</NON-INTERACTIVE EDITING> "
32294 "below).  To change the init default level to 5:"
32295 msgstr ""
32296
32297 # type: verbatim
32298 #. type: verbatim
32299 #: ../tools/virt-edit.pl:70
32300 #, no-wrap
32301 msgid ""
32302 " virt-edit mydomain /etc/inittab -e 's/^id:.*/id:5:initdefault:/'\n"
32303 "\n"
32304 msgstr ""
32305
32306 # type: textblock
32307 #. type: textblock
32308 #: ../tools/virt-edit.pl:82 ../tools/virt-win-reg.pl:106
32309 #: ../tools/virt-list-filesystems.pl:63 ../tools/virt-tar.pl:113
32310 #: ../tools/virt-make-fs.pl:163 ../tools/virt-list-partitions.pl:64
32311 msgid "Display brief help."
32312 msgstr ""
32313
32314 # type: textblock
32315 #. type: textblock
32316 #: ../tools/virt-edit.pl:90 ../tools/virt-win-reg.pl:114
32317 #: ../tools/virt-resize.pl:272 ../tools/virt-list-filesystems.pl:71
32318 #: ../tools/virt-tar.pl:121 ../tools/virt-make-fs.pl:171
32319 #: ../tools/virt-list-partitions.pl:72
32320 msgid "Display version number and exit."
32321 msgstr ""
32322
32323 # type: =item
32324 #. type: =item
32325 #: ../tools/virt-edit.pl:96
32326 msgid "B<--backup extension> | B<-b extension>"
32327 msgstr ""
32328
32329 # type: textblock
32330 #. type: textblock
32331 #: ../tools/virt-edit.pl:98
32332 msgid ""
32333 "Create a backup of the original file I<in the guest disk image>.  The backup "
32334 "has the original filename with C<extension> added."
32335 msgstr ""
32336
32337 # type: textblock
32338 #. type: textblock
32339 #: ../tools/virt-edit.pl:101
32340 msgid ""
32341 "Usually the first character of C<extension> would be a dot C<.> so you would "
32342 "write:"
32343 msgstr ""
32344
32345 # type: verbatim
32346 #. type: verbatim
32347 #: ../tools/virt-edit.pl:104
32348 #, no-wrap
32349 msgid ""
32350 " virt-edit -b .orig [etc]\n"
32351 "\n"
32352 msgstr ""
32353
32354 # type: textblock
32355 #. type: textblock
32356 #: ../tools/virt-edit.pl:106
32357 msgid "By default, no backup file is made."
32358 msgstr ""
32359
32360 # type: =item
32361 #. type: =item
32362 #: ../tools/virt-edit.pl:112 ../tools/virt-win-reg.pl:128
32363 #: ../tools/virt-list-filesystems.pl:77 ../tools/virt-tar.pl:127
32364 #: ../tools/virt-list-partitions.pl:78
32365 msgid "B<--connect URI> | B<-c URI>"
32366 msgstr ""
32367
32368 # type: textblock
32369 #. type: textblock
32370 #: ../tools/virt-edit.pl:114 ../tools/virt-win-reg.pl:130
32371 #: ../tools/virt-list-filesystems.pl:79 ../tools/virt-tar.pl:129
32372 #: ../tools/virt-list-partitions.pl:80
32373 msgid ""
32374 "If using libvirt, connect to the given I<URI>.  If omitted, then we connect "
32375 "to the default libvirt hypervisor."
32376 msgstr ""
32377
32378 # type: textblock
32379 #. type: textblock
32380 #: ../tools/virt-edit.pl:117 ../tools/virt-win-reg.pl:133
32381 #: ../tools/virt-list-filesystems.pl:82 ../tools/virt-tar.pl:132
32382 #: ../tools/virt-list-partitions.pl:83
32383 msgid ""
32384 "If you specify guest block devices directly, then libvirt is not used at all."
32385 msgstr ""
32386
32387 # type: =item
32388 #. type: =item
32389 #: ../tools/virt-edit.pl:124 ../tools/virt-win-reg.pl:140
32390 #: ../tools/virt-resize.pl:520 ../tools/virt-list-filesystems.pl:89
32391 #: ../tools/virt-tar.pl:139 ../tools/virt-list-partitions.pl:90
32392 msgid "B<--format> raw"
32393 msgstr ""
32394
32395 # type: textblock
32396 #. type: textblock
32397 #: ../tools/virt-edit.pl:126 ../tools/virt-win-reg.pl:142
32398 #: ../tools/virt-list-filesystems.pl:91 ../tools/virt-tar.pl:141
32399 #: ../tools/virt-list-partitions.pl:92
32400 msgid ""
32401 "Specify the format of disk images given on the command line.  If this is "
32402 "omitted then the format is autodetected from the content of the disk image."
32403 msgstr ""
32404
32405 # type: textblock
32406 #. type: textblock
32407 #: ../tools/virt-edit.pl:130 ../tools/virt-win-reg.pl:146
32408 #: ../tools/virt-list-filesystems.pl:95 ../tools/virt-tar.pl:145
32409 #: ../tools/virt-list-partitions.pl:96
32410 msgid ""
32411 "If disk images are requested from libvirt, then this program asks libvirt "
32412 "for this information.  In this case, the value of the format parameter is "
32413 "ignored."
32414 msgstr ""
32415
32416 # type: textblock
32417 #. type: textblock
32418 #: ../tools/virt-edit.pl:134 ../tools/virt-win-reg.pl:150
32419 #: ../tools/virt-resize.pl:525 ../tools/virt-resize.pl:540
32420 #: ../tools/virt-list-filesystems.pl:99 ../tools/virt-tar.pl:149
32421 #: ../tools/virt-list-partitions.pl:100
32422 msgid ""
32423 "If working with untrusted raw-format guest disk images, you should ensure "
32424 "the format is always specified."
32425 msgstr ""
32426
32427 # type: =item
32428 #. type: =item
32429 #: ../tools/virt-edit.pl:141
32430 msgid "B<--expr EXPR> | B<-e EXPR>"
32431 msgstr ""
32432
32433 # type: textblock
32434 #. type: textblock
32435 #: ../tools/virt-edit.pl:143
32436 msgid ""
32437 "Instead of launching the external editor, non-interactively apply the Perl "
32438 "expression C<EXPR> to each line in the file.  See L</NON-INTERACTIVE "
32439 "EDITING> below."
32440 msgstr ""
32441
32442 # type: textblock
32443 #. type: textblock
32444 #: ../tools/virt-edit.pl:147
32445 msgid ""
32446 "Be careful to properly quote the expression to prevent it from being altered "
32447 "by the shell."
32448 msgstr ""
32449
32450 # type: =head1
32451 #. type: =head1
32452 #: ../tools/virt-edit.pl:268
32453 msgid "NON-INTERACTIVE EDITING"
32454 msgstr ""
32455
32456 # type: textblock
32457 #. type: textblock
32458 #: ../tools/virt-edit.pl:270
32459 msgid ""
32460 "C<virt-edit> normally calls out to C<$EDITOR> (or vi) so the system "
32461 "administrator can interactively edit the file."
32462 msgstr ""
32463
32464 # type: textblock
32465 #. type: textblock
32466 #: ../tools/virt-edit.pl:273
32467 msgid ""
32468 "There are two ways also to use C<virt-edit> from scripts in order to make "
32469 "automated edits to files.  (Note that although you I<can> use C<virt-edit> "
32470 "like this, it's less error-prone to write scripts directly using the "
32471 "libguestfs API and Augeas for configuration file editing.)"
32472 msgstr ""
32473
32474 # type: textblock
32475 #. type: textblock
32476 #: ../tools/virt-edit.pl:279
32477 msgid ""
32478 "The first method is to temporarily set C<$EDITOR> to any script or program "
32479 "you want to run.  The script is invoked as C<$EDITOR tmpfile> and it should "
32480 "update C<tmpfile> in place however it likes."
32481 msgstr ""
32482
32483 # type: textblock
32484 #. type: textblock
32485 #: ../tools/virt-edit.pl:283
32486 msgid ""
32487 "The second method is to use the C<-e> parameter of C<virt-edit> to run a "
32488 "short Perl snippet in the style of L<sed(1)>.  For example to replace all "
32489 "instances of C<foo> with C<bar> in a file:"
32490 msgstr ""
32491
32492 # type: verbatim
32493 #. type: verbatim
32494 #: ../tools/virt-edit.pl:287
32495 #, no-wrap
32496 msgid ""
32497 " virt-edit domname filename -e 's/foo/bar/'\n"
32498 "\n"
32499 msgstr ""
32500
32501 # type: textblock
32502 #. type: textblock
32503 #: ../tools/virt-edit.pl:289
32504 msgid ""
32505 "The full power of Perl regular expressions can be used (see L<perlre(1)>).  "
32506 "For example to delete root's password you could do:"
32507 msgstr ""
32508
32509 # type: verbatim
32510 #. type: verbatim
32511 #: ../tools/virt-edit.pl:292
32512 #, no-wrap
32513 msgid ""
32514 " virt-edit domname /etc/passwd -e 's/^root:.*?:/root::/'\n"
32515 "\n"
32516 msgstr ""
32517
32518 # type: textblock
32519 #. type: textblock
32520 #: ../tools/virt-edit.pl:294
32521 msgid ""
32522 "What really happens is that the snippet is evaluated as a Perl expression "
32523 "for each line of the file.  The line, including the final C<\\n>, is passed "
32524 "in C<$_> and the expression should update C<$_> or leave it unchanged."
32525 msgstr ""
32526
32527 # type: textblock
32528 #. type: textblock
32529 #: ../tools/virt-edit.pl:299
32530 msgid ""
32531 "To delete a line, set C<$_> to the empty string.  For example, to delete the "
32532 "C<apache> user account from the password file you can do:"
32533 msgstr ""
32534
32535 # type: verbatim
32536 #. type: verbatim
32537 #: ../tools/virt-edit.pl:302
32538 #, no-wrap
32539 msgid ""
32540 " virt-edit mydomain /etc/passwd -e '$_ = \"\" if /^apache:/'\n"
32541 "\n"
32542 msgstr ""
32543
32544 # type: textblock
32545 #. type: textblock
32546 #: ../tools/virt-edit.pl:304
32547 msgid ""
32548 "To insert a line, prepend or append it to C<$_>.  However appending lines to "
32549 "the end of the file is rather difficult this way since there is no concept "
32550 "of \"last line of the file\" - your expression just doesn't get called "
32551 "again.  You might want to use the first method (setting C<$EDITOR>) if you "
32552 "want to do this."
32553 msgstr ""
32554
32555 # type: textblock
32556 #. type: textblock
32557 #: ../tools/virt-edit.pl:310
32558 msgid ""
32559 "The variable C<$lineno> contains the current line number.  As is "
32560 "traditional, the first line in the file is number C<1>."
32561 msgstr ""
32562
32563 # type: textblock
32564 #. type: textblock
32565 #: ../tools/virt-edit.pl:313
32566 msgid ""
32567 "The return value from the expression is ignored, but the expression may call "
32568 "C<die> in order to abort the whole program, leaving the original file "
32569 "untouched."
32570 msgstr ""
32571
32572 # type: textblock
32573 #. type: textblock
32574 #: ../tools/virt-edit.pl:317
32575 msgid ""
32576 "Remember when matching the end of a line that C<$_> may contain the final C<"
32577 "\\n>, or (for DOS files) C<\\r\\n>, or if the file does not end with a "
32578 "newline then neither of these.  Thus to match or substitute some text at the "
32579 "end of a line, use this regular expression:"
32580 msgstr ""
32581
32582 # type: verbatim
32583 #. type: verbatim
32584 #: ../tools/virt-edit.pl:322
32585 #, no-wrap
32586 msgid ""
32587 " /some text(\\r?\\n)?$/\n"
32588 "\n"
32589 msgstr ""
32590
32591 # type: textblock
32592 #. type: textblock
32593 #: ../tools/virt-edit.pl:324
32594 msgid ""
32595 "Alternately, use the perl C<chomp> function, being careful not to chomp C<"
32596 "$_> itself (since that would remove all newlines from the file):"
32597 msgstr ""
32598
32599 # type: verbatim
32600 #. type: verbatim
32601 #: ../tools/virt-edit.pl:328
32602 #, no-wrap
32603 msgid ""
32604 " my $m = $_; chomp $m; $m =~ /some text$/\n"
32605 "\n"
32606 msgstr ""
32607
32608 # type: =item
32609 #. type: =item
32610 #: ../tools/virt-edit.pl:334
32611 msgid "C<EDITOR>"
32612 msgstr ""
32613
32614 # type: textblock
32615 #. type: textblock
32616 #: ../tools/virt-edit.pl:336
32617 msgid ""
32618 "If set, this string is used as the editor.  It may contain arguments, eg. C<"
32619 "\"emacs -nw\">"
32620 msgstr ""
32621
32622 # type: textblock
32623 #. type: textblock
32624 #: ../tools/virt-edit.pl:339
32625 msgid "If not set, C<vi> is used."
32626 msgstr ""
32627
32628 # type: =head2
32629 #. type: =head1
32630 #: ../tools/virt-edit.pl:343 ../tools/virt-win-reg.pl:559
32631 #: ../tools/virt-resize.pl:1482 ../tools/virt-list-filesystems.pl:182
32632 #: ../tools/virt-tar.pl:279 ../tools/virt-make-fs.pl:532
32633 #: ../tools/virt-list-partitions.pl:250
32634 msgid "SHELL QUOTING"
32635 msgstr ""
32636
32637 # type: textblock
32638 #. type: textblock
32639 #: ../tools/virt-edit.pl:345 ../tools/virt-win-reg.pl:567
32640 #: ../tools/virt-resize.pl:1484 ../tools/virt-list-filesystems.pl:184
32641 #: ../tools/virt-tar.pl:281 ../tools/virt-make-fs.pl:534
32642 #: ../tools/virt-list-partitions.pl:252
32643 msgid ""
32644 "Libvirt guest names can contain arbitrary characters, some of which have "
32645 "meaning to the shell such as C<#> and space.  You may need to quote or "
32646 "escape these characters on the command line.  See the shell manual page L<sh"
32647 "(1)> for details."
32648 msgstr ""
32649
32650 #. type: textblock
32651 #: ../tools/virt-edit.pl:352
32652 msgid ""
32653 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-copy-in(1)>, L<virt-"
32654 "tar-in(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, "
32655 "L<http://libguestfs.org/>, L<perl(1)>, L<perlre(1)>."
32656 msgstr ""
32657
32658 # type: =head1
32659 #. type: =head1
32660 #: ../tools/virt-edit.pl:364 ../tools/virt-win-reg.pl:598
32661 #: ../tools/virt-resize.pl:1510 ../tools/virt-list-filesystems.pl:202
32662 #: ../tools/virt-tar.pl:301 ../tools/virt-make-fs.pl:564
32663 #: ../tools/virt-list-partitions.pl:269
32664 msgid "AUTHOR"
32665 msgstr ""
32666
32667 # type: textblock
32668 #. type: textblock
32669 #: ../tools/virt-edit.pl:366 ../tools/virt-win-reg.pl:600
32670 #: ../tools/virt-resize.pl:1512 ../tools/virt-list-filesystems.pl:204
32671 #: ../tools/virt-tar.pl:303 ../tools/virt-make-fs.pl:566
32672 #: ../tools/virt-list-partitions.pl:271
32673 msgid "Richard W.M. Jones L<http://people.redhat.com/~rjones/>"
32674 msgstr ""
32675
32676 # type: textblock
32677 #. type: textblock
32678 #: ../tools/virt-edit.pl:370 ../tools/virt-list-partitions.pl:275
32679 msgid "Copyright (C) 2009-2010 Red Hat Inc."
32680 msgstr ""
32681
32682 # type: textblock
32683 #. type: textblock
32684 #: ../tools/virt-win-reg.pl:37
32685 msgid ""
32686 "virt-win-reg - Export and merge Windows Registry entries from a Windows guest"
32687 msgstr ""
32688
32689 # type: verbatim
32690 #. type: verbatim
32691 #: ../tools/virt-win-reg.pl:41
32692 #, no-wrap
32693 msgid ""
32694 " virt-win-reg domname 'HKLM\\Path\\To\\Subkey'\n"
32695 "\n"
32696 msgstr ""
32697
32698 # type: verbatim
32699 #. type: verbatim
32700 #: ../tools/virt-win-reg.pl:43
32701 #, no-wrap
32702 msgid ""
32703 " virt-win-reg domname 'HKLM\\Path\\To\\Subkey' name\n"
32704 "\n"
32705 msgstr ""
32706
32707 # type: verbatim
32708 #. type: verbatim
32709 #: ../tools/virt-win-reg.pl:45
32710 #, no-wrap
32711 msgid ""
32712 " virt-win-reg domname 'HKLM\\Path\\To\\Subkey' @\n"
32713 "\n"
32714 msgstr ""
32715
32716 # type: verbatim
32717 #. type: verbatim
32718 #: ../tools/virt-win-reg.pl:47
32719 #, no-wrap
32720 msgid ""
32721 " virt-win-reg --merge domname [input.reg ...]\n"
32722 "\n"
32723 msgstr ""
32724
32725 # type: verbatim
32726 #. type: verbatim
32727 #: ../tools/virt-win-reg.pl:49
32728 #, no-wrap
32729 msgid ""
32730 " virt-win-reg [--options] disk.img ... # instead of domname\n"
32731 "\n"
32732 msgstr ""
32733
32734 # type: textblock
32735 #. type: textblock
32736 #: ../tools/virt-win-reg.pl:53
32737 msgid ""
32738 "You must I<not> use C<virt-win-reg> with the C<--merge> option on live "
32739 "virtual machines.  If you do this, you I<will> get irreversible disk "
32740 "corruption in the VM.  C<virt-win-reg> tries to stop you from doing this, "
32741 "but doesn't catch all cases."
32742 msgstr ""
32743
32744 # type: textblock
32745 #. type: textblock
32746 #: ../tools/virt-win-reg.pl:58
32747 msgid ""
32748 "Modifying the Windows Registry is an inherently risky operation.  The format "
32749 "is deliberately obscure and undocumented, and Registry changes can leave the "
32750 "system unbootable.  Therefore when using the C<--merge> option, make sure "
32751 "you have a reliable backup first."
32752 msgstr ""
32753
32754 # type: textblock
32755 #. type: textblock
32756 #: ../tools/virt-win-reg.pl:65
32757 msgid ""
32758 "This program can export and merge Windows Registry entries from a Windows "
32759 "guest."
32760 msgstr ""
32761
32762 # type: textblock
32763 #. type: textblock
32764 #: ../tools/virt-win-reg.pl:68
32765 msgid ""
32766 "The first parameter is the libvirt guest name or the raw disk image of a "
32767 "Windows guest."
32768 msgstr ""
32769
32770 # type: textblock
32771 #. type: textblock
32772 #: ../tools/virt-win-reg.pl:71
32773 msgid ""
32774 "If C<--merge> is I<not> specified, then the chosen registry key is displayed/"
32775 "exported (recursively).  For example:"
32776 msgstr ""
32777
32778 # type: verbatim
32779 #. type: verbatim
32780 #: ../tools/virt-win-reg.pl:74
32781 #, no-wrap
32782 msgid ""
32783 " $ virt-win-reg Windows7 'HKEY_LOCAL_MACHINE\\SOFTWARE\\Microsoft'\n"
32784 "\n"
32785 msgstr ""
32786
32787 # type: textblock
32788 #. type: textblock
32789 #: ../tools/virt-win-reg.pl:76
32790 msgid ""
32791 "You can also display single values from within registry keys, for example:"
32792 msgstr ""
32793
32794 # type: verbatim
32795 #. type: verbatim
32796 #: ../tools/virt-win-reg.pl:79
32797 #, no-wrap
32798 msgid ""
32799 " $ cvkey='HKLM\\SOFTWARE\\Microsoft\\Windows NT\\CurrentVersion'\n"
32800 " $ virt-win-reg Windows7 $cvkey ProductName\n"
32801 " Windows 7 Enterprise\n"
32802 "\n"
32803 msgstr ""
32804
32805 # type: textblock
32806 #. type: textblock
32807 #: ../tools/virt-win-reg.pl:83
32808 msgid ""
32809 "With C<--merge>, you can merge a textual regedit file into the Windows "
32810 "Registry:"
32811 msgstr ""
32812
32813 # type: verbatim
32814 #. type: verbatim
32815 #: ../tools/virt-win-reg.pl:86
32816 #, no-wrap
32817 msgid ""
32818 " $ virt-win-reg --merge Windows7 changes.reg\n"
32819 "\n"
32820 msgstr ""
32821
32822 # type: =head2
32823 #. type: =head1
32824 #: ../tools/virt-win-reg.pl:88 ../tools/virt-tar.pl:45
32825 msgid "NOTE"
32826 msgstr ""
32827
32828 # type: textblock
32829 #. type: textblock
32830 #: ../tools/virt-win-reg.pl:90
32831 msgid ""
32832 "This program is only meant for simple access to the registry.  If you want "
32833 "to do complicated things with the registry, we suggest you download the "
32834 "Registry hive files from the guest using L<libguestfs(3)> or L<guestfish(1)> "
32835 "and access them locally, eg. using L<hivex(3)>, L<hivexsh(1)> or "
32836 "L<hivexregedit(1)>."
32837 msgstr ""
32838
32839 # type: =item
32840 #. type: =item
32841 #: ../tools/virt-win-reg.pl:120 ../tools/virt-make-fs.pl:177
32842 msgid "B<--debug>"
32843 msgstr ""
32844
32845 # type: textblock
32846 #. type: textblock
32847 #: ../tools/virt-win-reg.pl:122 ../tools/virt-resize.pl:498
32848 msgid "Enable debugging messages."
32849 msgstr ""
32850
32851 # type: =item
32852 #. type: =item
32853 #: ../tools/virt-win-reg.pl:157
32854 msgid "B<--merge>"
32855 msgstr ""
32856
32857 # type: textblock
32858 #. type: textblock
32859 #: ../tools/virt-win-reg.pl:159
32860 msgid ""
32861 "In merge mode, this merges a textual regedit file into the Windows Registry "
32862 "of the virtual machine.  If this flag is I<not> given then virt-win-reg "
32863 "displays or exports Registry entries instead."
32864 msgstr ""
32865
32866 # type: textblock
32867 #. type: textblock
32868 #: ../tools/virt-win-reg.pl:163
32869 msgid ""
32870 "Note that C<--merge> is I<unsafe> to use on live virtual machines, and will "
32871 "result in disk corruption.  However exporting (without this flag)  is always "
32872 "safe."
32873 msgstr ""
32874
32875 # type: =item
32876 #. type: =item
32877 #: ../tools/virt-win-reg.pl:171
32878 msgid "B<--encoding> UTF-16LE|ASCII"
32879 msgstr ""
32880
32881 # type: textblock
32882 #. type: textblock
32883 #: ../tools/virt-win-reg.pl:173
32884 msgid ""
32885 "When merging (only), you may need to specify the encoding for strings to be "
32886 "used in the hive file.  This is explained in detail in L<Win::Hivex::Regedit"
32887 "(3)/ENCODING STRINGS>."
32888 msgstr ""
32889
32890 # type: textblock
32891 #. type: textblock
32892 #: ../tools/virt-win-reg.pl:177
32893 msgid ""
32894 "The default is to use UTF-16LE, which should work with recent versions of "
32895 "Windows."
32896 msgstr ""
32897
32898 # type: =head2
32899 #. type: =head1
32900 #: ../tools/virt-win-reg.pl:402
32901 msgid "SUPPORTED SYSTEMS"
32902 msgstr ""
32903
32904 # type: textblock
32905 #. type: textblock
32906 #: ../tools/virt-win-reg.pl:404
32907 msgid ""
32908 "The program currently supports Windows NT-derived guests starting with "
32909 "Windows XP through to at least Windows 7."
32910 msgstr ""
32911
32912 # type: textblock
32913 #. type: textblock
32914 #: ../tools/virt-win-reg.pl:407
32915 msgid ""
32916 "Registry support is done for C<HKEY_LOCAL_MACHINE\\SAM>, C<HKEY_LOCAL_MACHINE"
32917 "\\SECURITY>, C<HKEY_LOCAL_MACHINE\\SOFTWARE>, C<HKEY_LOCAL_MACHINE\\SYSTEM> "
32918 "and C<HKEY_USERS\\.DEFAULT>."
32919 msgstr ""
32920
32921 # type: textblock
32922 #. type: textblock
32923 #: ../tools/virt-win-reg.pl:411
32924 msgid ""
32925 "You can use C<HKLM> as a shorthand for C<HKEY_LOCAL_MACHINE>, and C<HKU> for "
32926 "C<HKEY_USERS>."
32927 msgstr ""
32928
32929 # type: textblock
32930 #. type: textblock
32931 #: ../tools/virt-win-reg.pl:414
32932 msgid ""
32933 "C<HKEY_USERS\\$SID> and C<HKEY_CURRENT_USER> are B<not> supported at this "
32934 "time."
32935 msgstr ""
32936
32937 # type: =head2
32938 #. type: =head1
32939 #: ../tools/virt-win-reg.pl:417
32940 msgid "ENCODING"
32941 msgstr ""
32942
32943 # type: textblock
32944 #. type: textblock
32945 #: ../tools/virt-win-reg.pl:419
32946 msgid ""
32947 "C<virt-win-reg> expects that regedit files have already been reencoded in "
32948 "the local encoding.  Usually on Linux hosts, this means UTF-8 with Unix-"
32949 "style line endings.  Since Windows regedit files are often in UTF-16LE with "
32950 "Windows-style line endings, you may need to reencode the whole file before "
32951 "or after processing."
32952 msgstr ""
32953
32954 # type: textblock
32955 #. type: textblock
32956 #: ../tools/virt-win-reg.pl:425
32957 msgid ""
32958 "To reencode a file from Windows format to Linux (before processing it with "
32959 "the C<--merge> option), you would do something like this:"
32960 msgstr ""
32961
32962 # type: verbatim
32963 #. type: verbatim
32964 #: ../tools/virt-win-reg.pl:428
32965 #, no-wrap
32966 msgid ""
32967 " iconv -f utf-16le -t utf-8 < win.reg | dos2unix > linux.reg\n"
32968 "\n"
32969 msgstr ""
32970
32971 # type: textblock
32972 #. type: textblock
32973 #: ../tools/virt-win-reg.pl:430
32974 msgid ""
32975 "To go in the opposite direction, after exporting and before sending the file "
32976 "to a Windows user, do something like this:"
32977 msgstr ""
32978
32979 # type: verbatim
32980 #. type: verbatim
32981 #: ../tools/virt-win-reg.pl:433
32982 #, no-wrap
32983 msgid ""
32984 " unix2dos linux.reg | iconv -f utf-8 -t utf-16le > win.reg\n"
32985 "\n"
32986 msgstr ""
32987
32988 # type: textblock
32989 #. type: textblock
32990 #: ../tools/virt-win-reg.pl:435
32991 msgid "For more information about encoding, see L<Win::Hivex::Regedit(3)>."
32992 msgstr ""
32993
32994 # type: textblock
32995 #. type: textblock
32996 #: ../tools/virt-win-reg.pl:437
32997 msgid ""
32998 "If you are unsure about the current encoding, use the L<file(1)> command.  "
32999 "Recent versions of Windows regedit.exe produce a UTF-16LE file with Windows-"
33000 "style (CRLF) line endings, like this:"
33001 msgstr ""
33002
33003 # type: verbatim
33004 #. type: verbatim
33005 #: ../tools/virt-win-reg.pl:441
33006 #, no-wrap
33007 msgid ""
33008 " $ file software.reg\n"
33009 " software.reg: Little-endian UTF-16 Unicode text, with very long lines,\n"
33010 " with CRLF line terminators\n"
33011 "\n"
33012 msgstr ""
33013
33014 # type: textblock
33015 #. type: textblock
33016 #: ../tools/virt-win-reg.pl:445
33017 msgid "This file would need conversion before you could C<--merge> it."
33018 msgstr ""
33019
33020 # type: =head2
33021 #. type: =head1
33022 #: ../tools/virt-win-reg.pl:447
33023 msgid "CurrentControlSet etc."
33024 msgstr ""
33025
33026 # type: textblock
33027 #. type: textblock
33028 #: ../tools/virt-win-reg.pl:449
33029 msgid ""
33030 "Registry keys like C<CurrentControlSet> don't really exist in the Windows "
33031 "Registry at the level of the hive file, and therefore you cannot modify "
33032 "these."
33033 msgstr ""
33034
33035 # type: textblock
33036 #. type: textblock
33037 #: ../tools/virt-win-reg.pl:453
33038 msgid ""
33039 "C<CurrentControlSet> is usually an alias for C<ControlSet001>.  In some "
33040 "circumstances it might refer to another control set.  The way to find out is "
33041 "to look at the C<HKLM\\SYSTEM\\Select> key:"
33042 msgstr ""
33043
33044 # type: verbatim
33045 #. type: verbatim
33046 #: ../tools/virt-win-reg.pl:457
33047 #, no-wrap
33048 msgid ""
33049 " # virt-win-reg WindowsGuest 'HKLM\\SYSTEM\\Select'\n"
33050 " [HKEY_LOCAL_MACHINE\\SYSTEM\\Select]\n"
33051 " \"Current\"=dword:00000001\n"
33052 " \"Default\"=dword:00000001\n"
33053 " \"Failed\"=dword:00000000\n"
33054 " \"LastKnownGood\"=dword:00000002\n"
33055 "\n"
33056 msgstr ""
33057
33058 # type: textblock
33059 #. type: textblock
33060 #: ../tools/virt-win-reg.pl:464
33061 msgid "\"Current\" is the one which Windows will choose when it boots."
33062 msgstr ""
33063
33064 # type: textblock
33065 #. type: textblock
33066 #: ../tools/virt-win-reg.pl:466
33067 msgid ""
33068 "Similarly, other C<Current...> keys in the path may need to be replaced."
33069 msgstr ""
33070
33071 # type: =head1
33072 #. type: =head1
33073 #: ../tools/virt-win-reg.pl:469
33074 msgid "WINDOWS TIPS"
33075 msgstr ""
33076
33077 # type: textblock
33078 #. type: textblock
33079 #: ../tools/virt-win-reg.pl:471
33080 msgid ""
33081 "Note that some of these tips modify the guest disk image.  The guest I<must> "
33082 "be shut off, else you will get disk corruption."
33083 msgstr ""
33084
33085 # type: =head2
33086 #. type: =head2
33087 #: ../tools/virt-win-reg.pl:474
33088 msgid "RUNNING A BATCH SCRIPT WHEN A USER LOGS IN"
33089 msgstr ""
33090
33091 # type: textblock
33092 #. type: textblock
33093 #: ../tools/virt-win-reg.pl:476
33094 msgid ""
33095 "Prepare a DOS batch script, VBScript or executable.  Upload this using "
33096 "L<guestfish(1)>.  For this example the script is called C<test.bat> and it "
33097 "is uploaded into C<C:\\>:"
33098 msgstr ""
33099
33100 # type: verbatim
33101 #. type: verbatim
33102 #: ../tools/virt-win-reg.pl:480
33103 #, no-wrap
33104 msgid ""
33105 " guestfish -i -d WindowsGuest upload test.bat /test.bat\n"
33106 "\n"
33107 msgstr ""
33108
33109 # type: textblock
33110 #. type: textblock
33111 #: ../tools/virt-win-reg.pl:482
33112 msgid "Prepare a regedit file containing the registry change:"
33113 msgstr ""
33114
33115 # type: verbatim
33116 #. type: verbatim
33117 #: ../tools/virt-win-reg.pl:484
33118 #, no-wrap
33119 msgid ""
33120 " cat > test.reg <<'EOF'\n"
33121 " [HKLM\\Software\\Microsoft\\Windows\\CurrentVersion\\RunOnce]\n"
33122 " \"Test\"=\"c:\\\\test.bat\"\n"
33123 " EOF\n"
33124 "\n"
33125 msgstr ""
33126
33127 # type: textblock
33128 #. type: textblock
33129 #: ../tools/virt-win-reg.pl:489
33130 msgid ""
33131 "In this example we use the key C<RunOnce> which means that the script will "
33132 "run precisely once when the first user logs in.  If you want it to run every "
33133 "time a user logs in, replace C<RunOnce> with C<Run>."
33134 msgstr ""
33135
33136 # type: textblock
33137 #. type: textblock
33138 #: ../tools/virt-win-reg.pl:493
33139 msgid "Now update the registry:"
33140 msgstr ""
33141
33142 # type: verbatim
33143 #. type: verbatim
33144 #: ../tools/virt-win-reg.pl:495
33145 #, no-wrap
33146 msgid ""
33147 " virt-win-reg --merge WindowsGuest test.reg\n"
33148 "\n"
33149 msgstr ""
33150
33151 # type: =head2
33152 #. type: =head2
33153 #: ../tools/virt-win-reg.pl:497
33154 msgid "INSTALLING A SERVICE"
33155 msgstr ""
33156
33157 # type: textblock
33158 #. type: textblock
33159 #: ../tools/virt-win-reg.pl:499
33160 msgid ""
33161 "This section assumes you are familiar with Windows services, and you either "
33162 "have a program which handles the Windows Service Control Protocol directly "
33163 "or you want to run any program using a service wrapper like SrvAny or the "
33164 "free RHSrvAny."
33165 msgstr ""
33166
33167 # type: textblock
33168 #. type: textblock
33169 #: ../tools/virt-win-reg.pl:504
33170 msgid ""
33171 "First upload the program and optionally the service wrapper.  In this case "
33172 "the test program is called C<test.exe> and we are using the RHSrvAny wrapper:"
33173 msgstr ""
33174
33175 # type: verbatim
33176 #. type: verbatim
33177 #: ../tools/virt-win-reg.pl:508
33178 #, no-wrap
33179 msgid ""
33180 " guestfish -i -d WindowsGuest <<EOF\n"
33181 "   upload rhsrvany.exe /rhsrvany.exe\n"
33182 "   upload test.exe /test.exe\n"
33183 " EOF\n"
33184 "\n"
33185 msgstr ""
33186
33187 # type: textblock
33188 #. type: textblock
33189 #: ../tools/virt-win-reg.pl:513
33190 msgid ""
33191 "Prepare a regedit file containing the registry changes.  In this example, "
33192 "the first registry change is needed for the service itself or the service "
33193 "wrapper (if used).  The second registry change is only needed because I am "
33194 "using the RHSrvAny service wrapper."
33195 msgstr ""
33196
33197 # type: verbatim
33198 #. type: verbatim
33199 #: ../tools/virt-win-reg.pl:518
33200 #, no-wrap
33201 msgid ""
33202 " cat > service.reg <<'EOF'\n"
33203 " [HKLM\\SYSTEM\\ControlSet001\\services\\RHSrvAny]\n"
33204 " \"Type\"=dword:00000010\n"
33205 " \"Start\"=dword:00000002\n"
33206 " \"ErrorControl\"=dword:00000001\n"
33207 " \"ImagePath\"=\"c:\\\\rhsrvany.exe\"\n"
33208 " \"DisplayName\"=\"RHSrvAny\"\n"
33209 " \"ObjectName\"=\"NetworkService\"\n"
33210 " \n"
33211 msgstr ""
33212
33213 # type: verbatim
33214 #. type: verbatim
33215 #: ../tools/virt-win-reg.pl:527
33216 #, no-wrap
33217 msgid ""
33218 " [HKLM\\SYSTEM\\ControlSet001\\services\\RHSrvAny\\Parameters]\n"
33219 " \"CommandLine\"=\"c:\\\\test.exe\"\n"
33220 " \"PWD\"=\"c:\\\\Temp\"\n"
33221 " EOF\n"
33222 "\n"
33223 msgstr ""
33224
33225 # type: textblock
33226 #. type: textblock
33227 #: ../tools/virt-win-reg.pl:538
33228 msgid ""
33229 "For use of C<ControlSet001> see the section above in this manual page.  You "
33230 "may need to adjust this according to the control set that is in use by the "
33231 "guest."
33232 msgstr ""
33233
33234 # type: textblock
33235 #. type: textblock
33236 #: ../tools/virt-win-reg.pl:544
33237 msgid ""
33238 "C<\"ObjectName\"> controls the privileges that the service will have.  An "
33239 "alternative is C<\"ObjectName\"=\"LocalSystem\"> which would be the most "
33240 "privileged account."
33241 msgstr ""
33242
33243 # type: textblock
33244 #. type: textblock
33245 #: ../tools/virt-win-reg.pl:550
33246 msgid ""
33247 "For the meaning of the magic numbers, see this Microsoft KB article: "
33248 "L<http://support.microsoft.com/kb/103000>."
33249 msgstr ""
33250
33251 # type: textblock
33252 #. type: textblock
33253 #: ../tools/virt-win-reg.pl:555
33254 msgid "Update the registry:"
33255 msgstr ""
33256
33257 # type: verbatim
33258 #. type: verbatim
33259 #: ../tools/virt-win-reg.pl:557
33260 #, no-wrap
33261 msgid ""
33262 " virt-win-reg --merge WindowsGuest service.reg\n"
33263 "\n"
33264 msgstr ""
33265
33266 # type: textblock
33267 #. type: textblock
33268 #: ../tools/virt-win-reg.pl:561
33269 msgid ""
33270 "Be careful when passing parameters containing C<\\> (backslash) in the "
33271 "shell.  Usually you will have to use 'single quotes' or double backslashes "
33272 "(but not both) to protect them from the shell."
33273 msgstr ""
33274
33275 # type: textblock
33276 #. type: textblock
33277 #: ../tools/virt-win-reg.pl:565
33278 msgid "Paths and value names are case-insensitive."
33279 msgstr ""
33280
33281 # type: textblock
33282 #. type: textblock
33283 #: ../tools/virt-win-reg.pl:574
33284 msgid ""
33285 "L<hivex(3)>, L<hivexsh(1)>, L<hivexregedit(1)>, L<guestfs(3)>, L<guestfish(1)"
33286 ">, L<virt-cat(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Win::Hivex"
33287 "(3)>, L<Win::Hivex::Regedit(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
33288 msgstr ""
33289
33290 # type: textblock
33291 #. type: textblock
33292 #: ../tools/virt-win-reg.pl:589 ../tools/virt-make-fs.pl:555
33293 msgid ""
33294 "When reporting bugs, please enable debugging and capture the I<complete> "
33295 "output:"
33296 msgstr ""
33297
33298 # type: verbatim
33299 #. type: verbatim
33300 #: ../tools/virt-win-reg.pl:592
33301 #, no-wrap
33302 msgid ""
33303 " export LIBGUESTFS_DEBUG=1\n"
33304 " virt-win-reg --debug [... rest ...] > /tmp/virt-win-reg.log 2>&1\n"
33305 "\n"
33306 msgstr ""
33307
33308 # type: textblock
33309 #. type: textblock
33310 #: ../tools/virt-win-reg.pl:595
33311 msgid ""
33312 "Attach /tmp/virt-win-reg.log to a new bug report at L<https://bugzilla."
33313 "redhat.com/>"
33314 msgstr ""
33315
33316 # type: textblock
33317 #. type: textblock
33318 #: ../tools/virt-win-reg.pl:604 ../tools/virt-resize.pl:1516
33319 #: ../tools/virt-make-fs.pl:570
33320 msgid "Copyright (C) 2010 Red Hat Inc."
33321 msgstr ""
33322
33323 # type: textblock
33324 #. type: textblock
33325 #: ../tools/virt-resize.pl:42
33326 msgid "virt-resize - Resize a virtual machine disk"
33327 msgstr ""
33328
33329 # type: verbatim
33330 #. type: verbatim
33331 #: ../tools/virt-resize.pl:46
33332 #, no-wrap
33333 msgid ""
33334 " virt-resize [--resize /dev/sdaN=[+/-]<size>[%]]\n"
33335 "   [--expand /dev/sdaN] [--shrink /dev/sdaN]\n"
33336 "   [--ignore /dev/sdaN] [--delete /dev/sdaN] [...] indisk outdisk\n"
33337 "\n"
33338 msgstr ""
33339
33340 # type: textblock
33341 #. type: textblock
33342 #: ../tools/virt-resize.pl:52
33343 msgid ""
33344 "Virt-resize is a tool which can resize a virtual machine disk, making it "
33345 "larger or smaller overall, and resizing or deleting any partitions contained "
33346 "within."
33347 msgstr ""
33348
33349 # type: textblock
33350 #. type: textblock
33351 #: ../tools/virt-resize.pl:56
33352 msgid ""
33353 "Virt-resize B<cannot> resize disk images in-place.  Virt-resize B<should "
33354 "not> be used on live virtual machines - for consistent results, shut the "
33355 "virtual machine down before resizing it."
33356 msgstr ""
33357
33358 # type: textblock
33359 #. type: textblock
33360 #: ../tools/virt-resize.pl:60
33361 msgid ""
33362 "If you are not familiar with the associated tools: L<virt-filesystems(1)> "
33363 "and L<virt-df(1)>, we recommend you go and read those manual pages first."
33364 msgstr ""
33365
33366 # type: textblock
33367 #. type: textblock
33368 #: ../tools/virt-resize.pl:66
33369 msgid ""
33370 "Copy C<olddisk> to C<newdisk>, extending one of the guest's partitions to "
33371 "fill the extra 5GB of space."
33372 msgstr ""
33373
33374 #. type: verbatim
33375 #: ../tools/virt-resize.pl:69
33376 #, no-wrap
33377 msgid ""
33378 " truncate -r olddisk newdisk; truncate -s +5G newdisk\n"
33379 " virt-filesystems --long -h --all -a olddisk\n"
33380 " # Note \"/dev/sda2\" is a partition inside the \"olddisk\" file.\n"
33381 " virt-resize --expand /dev/sda2 olddisk newdisk\n"
33382 "\n"
33383 msgstr ""
33384
33385 # type: textblock
33386 #. type: textblock
33387 #: ../tools/virt-resize.pl:74
33388 msgid ""
33389 "As above, but make the /boot partition 200MB bigger, while giving the "
33390 "remaining space to /dev/sda2:"
33391 msgstr ""
33392
33393 # type: verbatim
33394 #. type: verbatim
33395 #: ../tools/virt-resize.pl:77
33396 #, no-wrap
33397 msgid ""
33398 " virt-resize --resize /dev/sda1=+200M --expand /dev/sda2 olddisk newdisk\n"
33399 "\n"
33400 msgstr ""
33401
33402 # type: textblock
33403 #. type: textblock
33404 #: ../tools/virt-resize.pl:79
33405 msgid "As above, but the output format will be uncompressed qcow2:"
33406 msgstr ""
33407
33408 # type: verbatim
33409 #. type: verbatim
33410 #: ../tools/virt-resize.pl:81
33411 #, no-wrap
33412 msgid ""
33413 " qemu-img create -f qcow2 newdisk.qcow2 15G\n"
33414 " virt-resize --expand /dev/sda2 olddisk newdisk.qcow2\n"
33415 "\n"
33416 msgstr ""
33417
33418 # type: =head1
33419 #. type: =head1
33420 #: ../tools/virt-resize.pl:84
33421 msgid "DETAILED USAGE"
33422 msgstr ""
33423
33424 # type: =head2
33425 #. type: =head2
33426 #: ../tools/virt-resize.pl:86
33427 msgid "EXPANDING A VIRTUAL MACHINE DISK"
33428 msgstr ""
33429
33430 # type: =item
33431 #. type: =item
33432 #: ../tools/virt-resize.pl:90
33433 msgid "1. Shut down the virtual machine"
33434 msgstr ""
33435
33436 # type: =item
33437 #. type: =item
33438 #: ../tools/virt-resize.pl:92
33439 msgid "2. Locate input disk image"
33440 msgstr ""
33441
33442 # type: textblock
33443 #. type: textblock
33444 #: ../tools/virt-resize.pl:94
33445 msgid ""
33446 "Locate the input disk image (ie. the file or device on the host containing "
33447 "the guest's disk).  If the guest is managed by libvirt, you can use C<virsh "
33448 "dumpxml> like this to find the disk image name:"
33449 msgstr ""
33450
33451 # type: verbatim
33452 #. type: verbatim
33453 #: ../tools/virt-resize.pl:98
33454 #, no-wrap
33455 msgid ""
33456 " # virsh dumpxml guestname | xpath /domain/devices/disk/source\n"
33457 " Found 1 nodes:\n"
33458 " -- NODE --\n"
33459 " <source dev=\"/dev/vg/lv_guest\" />\n"
33460 "\n"
33461 msgstr ""
33462
33463 # type: =item
33464 #. type: =item
33465 #: ../tools/virt-resize.pl:103
33466 msgid "3. Look at current sizing"
33467 msgstr ""
33468
33469 # type: textblock
33470 #. type: textblock
33471 #: ../tools/virt-resize.pl:105
33472 msgid "Use L<virt-filesystems(1)> to display the current partitions and sizes:"
33473 msgstr ""
33474
33475 # type: verbatim
33476 #. type: verbatim
33477 #: ../tools/virt-resize.pl:108
33478 #, no-wrap
33479 msgid ""
33480 " # virt-filesystems --long --parts --blkdevs -h -a /dev/vg/lv_guest\n"
33481 " Name       Type       Size  Parent\n"
33482 " /dev/sda1  partition  101M  /dev/sda\n"
33483 " /dev/sda2  partition  7.9G  /dev/sda\n"
33484 " /dev/sda   device     8.0G  -\n"
33485 "\n"
33486 msgstr ""
33487
33488 # type: textblock
33489 #. type: textblock
33490 #: ../tools/virt-resize.pl:114
33491 msgid ""
33492 "(This example is a virtual machine with an 8 GB disk which we would like to "
33493 "expand up to 10 GB)."
33494 msgstr ""
33495
33496 # type: =item
33497 #. type: =item
33498 #: ../tools/virt-resize.pl:117
33499 msgid "4. Create output disk"
33500 msgstr ""
33501
33502 # type: textblock
33503 #. type: textblock
33504 #: ../tools/virt-resize.pl:119
33505 msgid ""
33506 "Virt-resize cannot do in-place disk modifications.  You have to have space "
33507 "to store the resized output disk."
33508 msgstr ""
33509
33510 # type: textblock
33511 #. type: textblock
33512 #: ../tools/virt-resize.pl:122
33513 msgid ""
33514 "To store the resized disk image in a file, create a file of a suitable size:"
33515 msgstr ""
33516
33517 # type: verbatim
33518 #. type: verbatim
33519 #: ../tools/virt-resize.pl:125
33520 #, no-wrap
33521 msgid ""
33522 " # rm -f outdisk\n"
33523 " # truncate -s 10G outdisk\n"
33524 "\n"
33525 msgstr ""
33526
33527 # type: textblock
33528 #. type: textblock
33529 #: ../tools/virt-resize.pl:128
33530 msgid "Or use L<lvcreate(1)> to create a logical volume:"
33531 msgstr ""
33532
33533 # type: verbatim
33534 #. type: verbatim
33535 #: ../tools/virt-resize.pl:130
33536 #, no-wrap
33537 msgid ""
33538 " # lvcreate -L 10G -n lv_name vg_name\n"
33539 "\n"
33540 msgstr ""
33541
33542 # type: textblock
33543 #. type: textblock
33544 #: ../tools/virt-resize.pl:132
33545 msgid "Or use L<virsh(1)> vol-create-as to create a libvirt storage volume:"
33546 msgstr ""
33547
33548 # type: verbatim
33549 #. type: verbatim
33550 #: ../tools/virt-resize.pl:134
33551 #, no-wrap
33552 msgid ""
33553 " # virsh pool-list\n"
33554 " # virsh vol-create-as poolname newvol 10G\n"
33555 "\n"
33556 msgstr ""
33557
33558 # type: =item
33559 #. type: =item
33560 #: ../tools/virt-resize.pl:137
33561 msgid "5. Resize"
33562 msgstr ""
33563
33564 # type: textblock
33565 #. type: textblock
33566 #: ../tools/virt-resize.pl:139
33567 msgid ""
33568 "virt-resize takes two mandatory parameters, the input disk (eg. device or "
33569 "file) and the output disk.  The output disk is the one created in the "
33570 "previous step."
33571 msgstr ""
33572
33573 # type: verbatim
33574 #. type: verbatim
33575 #: ../tools/virt-resize.pl:143
33576 #, no-wrap
33577 msgid ""
33578 " # virt-resize indisk outdisk\n"
33579 "\n"
33580 msgstr ""
33581
33582 # type: textblock
33583 #. type: textblock
33584 #: ../tools/virt-resize.pl:145
33585 msgid ""
33586 "This command just copies disk image C<indisk> to disk image C<outdisk> "
33587 "I<without> resizing or changing any existing partitions.  If C<outdisk> is "
33588 "larger, then an extra, empty partition is created at the end of the disk "
33589 "covering the extra space.  If C<outdisk> is smaller, then it will give an "
33590 "error."
33591 msgstr ""
33592
33593 # type: textblock
33594 #. type: textblock
33595 #: ../tools/virt-resize.pl:151
33596 msgid ""
33597 "More realistically you'd want to expand existing partitions in the disk "
33598 "image by passing extra options (for the full list see the L</OPTIONS> "
33599 "section below)."
33600 msgstr ""
33601
33602 # type: textblock
33603 #. type: textblock
33604 #: ../tools/virt-resize.pl:155
33605 msgid ""
33606 "L</--expand> is the most useful option.  It expands the named partition "
33607 "within the disk to fill any extra space:"
33608 msgstr ""
33609
33610 # type: verbatim
33611 #. type: verbatim
33612 #: ../tools/virt-resize.pl:158
33613 #, no-wrap
33614 msgid ""
33615 " # virt-resize --expand /dev/sda2 indisk outdisk\n"
33616 "\n"
33617 msgstr ""
33618
33619 # type: textblock
33620 #. type: textblock
33621 #: ../tools/virt-resize.pl:160
33622 msgid ""
33623 "(In this case, an extra partition is I<not> created at the end of the disk, "
33624 "because there will be no unused space)."
33625 msgstr ""
33626
33627 # type: textblock
33628 #. type: textblock
33629 #: ../tools/virt-resize.pl:163
33630 msgid ""
33631 "L</--resize> is the other commonly used option.  The following would "
33632 "increase the size of /dev/sda1 by 200M, and expand /dev/sda2 to fill the "
33633 "rest of the available space:"
33634 msgstr ""
33635
33636 # type: verbatim
33637 #. type: verbatim
33638 #: ../tools/virt-resize.pl:167
33639 #, no-wrap
33640 msgid ""
33641 " # virt-resize --resize /dev/sda1=+200M --expand /dev/sda2 \\\n"
33642 "     indisk outdisk\n"
33643 "\n"
33644 msgstr ""
33645
33646 # type: textblock
33647 #. type: textblock
33648 #: ../tools/virt-resize.pl:170
33649 msgid ""
33650 "If the expanded partition in the image contains a filesystem or LVM PV, then "
33651 "if virt-resize knows how, it will resize the contents, the equivalent of "
33652 "calling a command such as L<pvresize(8)>, L<resize2fs(8)> or L<ntfsresize(8)"
33653 ">.  However virt-resize does not know how to resize some filesystems, so you "
33654 "would have to online resize them after booting the guest."
33655 msgstr ""
33656
33657 # type: textblock
33658 #. type: textblock
33659 #: ../tools/virt-resize.pl:177
33660 msgid "Other options are covered below."
33661 msgstr ""
33662
33663 # type: =item
33664 #. type: =item
33665 #: ../tools/virt-resize.pl:179
33666 msgid "6. Test"
33667 msgstr ""
33668
33669 # type: textblock
33670 #. type: textblock
33671 #: ../tools/virt-resize.pl:181
33672 msgid "Thoroughly test the new disk image I<before> discarding the old one."
33673 msgstr ""
33674
33675 # type: textblock
33676 #. type: textblock
33677 #: ../tools/virt-resize.pl:183
33678 msgid "If you are using libvirt, edit the XML to point at the new disk:"
33679 msgstr ""
33680
33681 # type: verbatim
33682 #. type: verbatim
33683 #: ../tools/virt-resize.pl:185
33684 #, no-wrap
33685 msgid ""
33686 " # virsh edit guestname\n"
33687 "\n"
33688 msgstr ""
33689
33690 # type: textblock
33691 #. type: textblock
33692 #: ../tools/virt-resize.pl:187
33693 msgid ""
33694 "Change E<lt>source ...E<gt>, see L<http://libvirt.org/formatdomain."
33695 "html#elementsDisks>"
33696 msgstr ""
33697
33698 # type: textblock
33699 #. type: textblock
33700 #: ../tools/virt-resize.pl:190
33701 msgid "Then start up the domain with the new, resized disk:"
33702 msgstr ""
33703
33704 # type: verbatim
33705 #. type: verbatim
33706 #: ../tools/virt-resize.pl:192
33707 #, no-wrap
33708 msgid ""
33709 " # virsh start guestname\n"
33710 "\n"
33711 msgstr ""
33712
33713 # type: textblock
33714 #. type: textblock
33715 #: ../tools/virt-resize.pl:194
33716 msgid ""
33717 "and check that it still works.  See also the L</NOTES> section below for "
33718 "additional information."
33719 msgstr ""
33720
33721 # type: =item
33722 #. type: =item
33723 #: ../tools/virt-resize.pl:197
33724 msgid "7. Resize LVs etc inside the guest"
33725 msgstr ""
33726
33727 # type: textblock
33728 #. type: textblock
33729 #: ../tools/virt-resize.pl:199
33730 msgid "(This can also be done offline using L<guestfish(1)>)"
33731 msgstr ""
33732
33733 # type: textblock
33734 #. type: textblock
33735 #: ../tools/virt-resize.pl:201
33736 msgid ""
33737 "Once the guest has booted you should see the new space available, at least "
33738 "for filesystems that virt-resize knows how to resize, and for PVs.  The user "
33739 "may need to resize LVs inside PVs, and also resize filesystem types that "
33740 "virt-resize does not know how to expand."
33741 msgstr ""
33742
33743 # type: =head2
33744 #. type: =head2
33745 #: ../tools/virt-resize.pl:208
33746 msgid "SHRINKING A VIRTUAL MACHINE DISK"
33747 msgstr ""
33748
33749 # type: textblock
33750 #. type: textblock
33751 #: ../tools/virt-resize.pl:210
33752 msgid ""
33753 "Shrinking is somewhat more complex than expanding, and only an overview is "
33754 "given here."
33755 msgstr ""
33756
33757 # type: textblock
33758 #. type: textblock
33759 #: ../tools/virt-resize.pl:213
33760 msgid ""
33761 "Firstly virt-resize will not attempt to shrink any partition content (PVs, "
33762 "filesystems).  The user has to shrink content before passing the disk image "
33763 "to virt-resize, and virt-resize will check that the content has been shrunk "
33764 "properly."
33765 msgstr ""
33766
33767 # type: textblock
33768 #. type: textblock
33769 #: ../tools/virt-resize.pl:218
33770 msgid "(Shrinking can also be done offline using L<guestfish(1)>)"
33771 msgstr ""
33772
33773 # type: textblock
33774 #. type: textblock
33775 #: ../tools/virt-resize.pl:220
33776 msgid ""
33777 "After shrinking PVs and filesystems, shut down the guest, and proceed with "
33778 "steps 3 and 4 above to allocate a new disk image."
33779 msgstr ""
33780
33781 # type: textblock
33782 #. type: textblock
33783 #: ../tools/virt-resize.pl:223
33784 msgid ""
33785 "Then run virt-resize with any of the C<--shrink> and/or C<--resize> options."
33786 msgstr ""
33787
33788 # type: =head2
33789 #. type: =head2
33790 #: ../tools/virt-resize.pl:226
33791 msgid "IGNORING OR DELETING PARTITIONS"
33792 msgstr ""
33793
33794 # type: textblock
33795 #. type: textblock
33796 #: ../tools/virt-resize.pl:228
33797 msgid ""
33798 "virt-resize also gives a convenient way to ignore or delete partitions when "
33799 "copying from the input disk to the output disk.  Ignoring a partition speeds "
33800 "up the copy where you don't care about the existing contents of a "
33801 "partition.  Deleting a partition removes it completely, but note that it "
33802 "also renumbers any partitions after the one which is deleted, which can "
33803 "leave some guests unbootable."
33804 msgstr ""
33805
33806 # type: =head2
33807 #. type: =head2
33808 #: ../tools/virt-resize.pl:235
33809 msgid "QCOW2 AND NON-SPARSE RAW FORMATS"
33810 msgstr ""
33811
33812 # type: textblock
33813 #. type: textblock
33814 #: ../tools/virt-resize.pl:237
33815 msgid ""
33816 "If the input disk is in qcow2 format, then you may prefer that the output is "
33817 "in qcow2 format as well.  Alternately, virt-resize can convert the format on "
33818 "the fly.  The output format is simply determined by the format of the empty "
33819 "output container that you provide.  Thus to create qcow2 output, use:"
33820 msgstr ""
33821
33822 # type: verbatim
33823 #. type: verbatim
33824 #: ../tools/virt-resize.pl:243
33825 #, no-wrap
33826 msgid ""
33827 " qemu-img create [-c] -f qcow2 outdisk [size]\n"
33828 "\n"
33829 msgstr ""
33830
33831 # type: textblock
33832 #. type: textblock
33833 #: ../tools/virt-resize.pl:245
33834 msgid "instead of the truncate command (use C<-c> for a compressed disk)."
33835 msgstr ""
33836
33837 # type: textblock
33838 #. type: textblock
33839 #: ../tools/virt-resize.pl:247
33840 msgid "Similarly, to get non-sparse raw output use:"
33841 msgstr ""
33842
33843 # type: verbatim
33844 #. type: verbatim
33845 #: ../tools/virt-resize.pl:249
33846 #, no-wrap
33847 msgid ""
33848 " fallocate -l size outdisk\n"
33849 "\n"
33850 msgstr ""
33851
33852 # type: textblock
33853 #. type: textblock
33854 #: ../tools/virt-resize.pl:251
33855 msgid ""
33856 "(on older systems that don't have the L<fallocate(1)> command use C<dd if=/"
33857 "dev/zero of=outdisk bs=1M count=..>)"
33858 msgstr ""
33859
33860 # type: textblock
33861 #. type: textblock
33862 #: ../tools/virt-resize.pl:264
33863 msgid "Display help."
33864 msgstr ""
33865
33866 # type: =item
33867 #. type: =item
33868 #: ../tools/virt-resize.pl:278
33869 msgid "B<--resize part=size>"
33870 msgstr ""
33871
33872 # type: textblock
33873 #. type: textblock
33874 #: ../tools/virt-resize.pl:280
33875 msgid ""
33876 "Resize the named partition (expanding or shrinking it) so that it has the "
33877 "given size."
33878 msgstr ""
33879
33880 # type: textblock
33881 #. type: textblock
33882 #: ../tools/virt-resize.pl:283
33883 msgid ""
33884 "C<size> can be expressed as an absolute number followed by b/K/M/G/T/P/E to "
33885 "mean bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, Petabytes or "
33886 "Exabytes; or as a percentage of the current size; or as a relative number or "
33887 "percentage.  For example:"
33888 msgstr ""
33889
33890 # type: verbatim
33891 #. type: verbatim
33892 #: ../tools/virt-resize.pl:288
33893 #, no-wrap
33894 msgid ""
33895 " --resize /dev/sda2=10G\n"
33896 "\n"
33897 msgstr ""
33898
33899 # type: verbatim
33900 #. type: verbatim
33901 #: ../tools/virt-resize.pl:290
33902 #, no-wrap
33903 msgid ""
33904 " --resize /dev/sda4=90%\n"
33905 "\n"
33906 msgstr ""
33907
33908 # type: verbatim
33909 #. type: verbatim
33910 #: ../tools/virt-resize.pl:292
33911 #, no-wrap
33912 msgid ""
33913 " --resize /dev/sda2=+1G\n"
33914 "\n"
33915 msgstr ""
33916
33917 # type: verbatim
33918 #. type: verbatim
33919 #: ../tools/virt-resize.pl:294
33920 #, no-wrap
33921 msgid ""
33922 " --resize /dev/sda2=-200M\n"
33923 "\n"
33924 msgstr ""
33925
33926 # type: verbatim
33927 #. type: verbatim
33928 #: ../tools/virt-resize.pl:296
33929 #, no-wrap
33930 msgid ""
33931 " --resize /dev/sda1=+128K\n"
33932 "\n"
33933 msgstr ""
33934
33935 # type: verbatim
33936 #. type: verbatim
33937 #: ../tools/virt-resize.pl:298
33938 #, no-wrap
33939 msgid ""
33940 " --resize /dev/sda1=+10%\n"
33941 "\n"
33942 msgstr ""
33943
33944 # type: verbatim
33945 #. type: verbatim
33946 #: ../tools/virt-resize.pl:300
33947 #, no-wrap
33948 msgid ""
33949 " --resize /dev/sda1=-10%\n"
33950 "\n"
33951 msgstr ""
33952
33953 # type: textblock
33954 #. type: textblock
33955 #: ../tools/virt-resize.pl:302
33956 msgid ""
33957 "You can increase the size of any partition.  Virt-resize will expand the "
33958 "direct content of the partition if it knows how (see C<--expand> below)."
33959 msgstr ""
33960
33961 # type: textblock
33962 #. type: textblock
33963 #: ../tools/virt-resize.pl:306
33964 msgid ""
33965 "You can only I<decrease> the size of partitions that contain filesystems or "
33966 "PVs which have already been shrunk.  Virt-resize will check this has been "
33967 "done before proceeding, or else will print an error (see also C<--resize-"
33968 "force>)."
33969 msgstr ""
33970
33971 # type: textblock
33972 #. type: textblock
33973 #: ../tools/virt-resize.pl:311 ../tools/virt-resize.pl:403
33974 #: ../tools/virt-resize.pl:420
33975 msgid "You can give this option multiple times."
33976 msgstr ""
33977
33978 # type: =item
33979 #. type: =item
33980 #: ../tools/virt-resize.pl:317
33981 msgid "B<--resize-force part=size>"
33982 msgstr ""
33983
33984 # type: textblock
33985 #. type: textblock
33986 #: ../tools/virt-resize.pl:319
33987 msgid ""
33988 "This is the same as C<--resize> except that it will let you decrease the "
33989 "size of any partition.  Generally this means you will lose any data which "
33990 "was at the end of the partition you shrink, but you may not care about that "
33991 "(eg. if shrinking an unused partition, or if you can easily recreate it such "
33992 "as a swap partition)."
33993 msgstr ""
33994
33995 # type: textblock
33996 #. type: textblock
33997 #: ../tools/virt-resize.pl:325
33998 msgid "See also the C<--ignore> option."
33999 msgstr ""
34000
34001 # type: =item
34002 #. type: =item
34003 #: ../tools/virt-resize.pl:331
34004 msgid "B<--expand part>"
34005 msgstr ""
34006
34007 # type: textblock
34008 #. type: textblock
34009 #: ../tools/virt-resize.pl:333
34010 msgid ""
34011 "Expand the named partition so it uses up all extra space (space left over "
34012 "after any other resize changes that you request have been done)."
34013 msgstr ""
34014
34015 # type: textblock
34016 #. type: textblock
34017 #: ../tools/virt-resize.pl:336
34018 msgid ""
34019 "If virt-resize knows how, it will expand the direct content of the "
34020 "partition.  For example, if the partition is an LVM PV, it will expand the "
34021 "PV to fit (like calling L<pvresize(8)>).  Virt-resize leaves any other "
34022 "content it doesn't know about alone."
34023 msgstr ""
34024
34025 # type: textblock
34026 #. type: textblock
34027 #: ../tools/virt-resize.pl:341
34028 msgid "Currently virt-resize can resize:"
34029 msgstr ""
34030
34031 # type: textblock
34032 #. type: textblock
34033 #: ../tools/virt-resize.pl:347
34034 msgid ""
34035 "ext2, ext3 and ext4 filesystems when they are contained directly inside a "
34036 "partition."
34037 msgstr ""
34038
34039 # type: textblock
34040 #. type: textblock
34041 #: ../tools/virt-resize.pl:352
34042 msgid ""
34043 "NTFS filesystems contained directly in a partition, if libguestfs was "
34044 "compiled with support for NTFS."
34045 msgstr ""
34046
34047 # type: textblock
34048 #. type: textblock
34049 #: ../tools/virt-resize.pl:355
34050 msgid ""
34051 "The filesystem must have been shut down consistently last time it was used.  "
34052 "Additionally, L<ntfsresize(8)> marks the resized filesystem as requiring a "
34053 "consistency check, so at the first boot after resizing Windows will check "
34054 "the disk."
34055 msgstr ""
34056
34057 # type: textblock
34058 #. type: textblock
34059 #: ../tools/virt-resize.pl:362
34060 msgid ""
34061 "LVM PVs (physical volumes).  virt-resize does not usually resize anything "
34062 "inside the PV, but see the C<--LV-expand> option.  The user could also "
34063 "resize LVs as desired after boot."
34064 msgstr ""
34065
34066 # type: textblock
34067 #. type: textblock
34068 #: ../tools/virt-resize.pl:368 ../tools/virt-resize.pl:390
34069 msgid "Note that you cannot use C<--expand> and C<--shrink> together."
34070 msgstr ""
34071
34072 # type: =item
34073 #. type: =item
34074 #: ../tools/virt-resize.pl:374
34075 msgid "B<--shrink part>"
34076 msgstr ""
34077
34078 # type: textblock
34079 #. type: textblock
34080 #: ../tools/virt-resize.pl:376
34081 msgid ""
34082 "Shrink the named partition until the overall disk image fits in the "
34083 "destination.  The named partition B<must> contain a filesystem or PV which "
34084 "has already been shrunk using another tool (eg. L<guestfish(1)> or other "
34085 "online tools).  Virt-resize will check this and give an error if it has not "
34086 "been done."
34087 msgstr ""
34088
34089 # type: textblock
34090 #. type: textblock
34091 #: ../tools/virt-resize.pl:382
34092 msgid ""
34093 "The amount by which the overall disk must be shrunk (after carrying out all "
34094 "other operations requested by the user) is called the \"deficit\".  For "
34095 "example, a straight copy (assume no other operations)  from a 5GB disk image "
34096 "to a 4GB disk image results in a 1GB deficit.  In this case, virt-resize "
34097 "would give an error unless the user specified a partition to shrink and that "
34098 "partition had more than a gigabyte of free space."
34099 msgstr ""
34100
34101 # type: =item
34102 #. type: =item
34103 #: ../tools/virt-resize.pl:396
34104 msgid "B<--ignore part>"
34105 msgstr ""
34106
34107 # type: textblock
34108 #. type: textblock
34109 #: ../tools/virt-resize.pl:398
34110 msgid ""
34111 "Ignore the named partition.  Effectively this means the partition is "
34112 "allocated on the destination disk, but the content is not copied across from "
34113 "the source disk.  The content of the partition will be blank (all zero "
34114 "bytes)."
34115 msgstr ""
34116
34117 # type: =item
34118 #. type: =item
34119 #: ../tools/virt-resize.pl:409
34120 msgid "B<--delete part>"
34121 msgstr ""
34122
34123 # type: textblock
34124 #. type: textblock
34125 #: ../tools/virt-resize.pl:411
34126 msgid ""
34127 "Delete the named partition.  It would be more accurate to describe this as "
34128 "\"don't copy it over\", since virt-resize doesn't do in-place changes and "
34129 "the original disk image is left intact."
34130 msgstr ""
34131
34132 # type: textblock
34133 #. type: textblock
34134 #: ../tools/virt-resize.pl:415
34135 msgid ""
34136 "Note that when you delete a partition, then anything contained in the "
34137 "partition is also deleted.  Furthermore, this causes any partitions that "
34138 "come after to be I<renumbered>, which can easily make your guest unbootable."
34139 msgstr ""
34140
34141 # type: =item
34142 #. type: =item
34143 #: ../tools/virt-resize.pl:426
34144 msgid "B<--LV-expand logvol>"
34145 msgstr ""
34146
34147 # type: textblock
34148 #. type: textblock
34149 #: ../tools/virt-resize.pl:428
34150 msgid ""
34151 "This takes the logical volume and, as a final step, expands it to fill all "
34152 "the space available in its volume group.  A typical usage, assuming a Linux "
34153 "guest with a single PV C</dev/sda2> and a root device called C</dev/vg_guest/"
34154 "lv_root> would be:"
34155 msgstr ""
34156
34157 # type: verbatim
34158 #. type: verbatim
34159 #: ../tools/virt-resize.pl:433
34160 #, no-wrap
34161 msgid ""
34162 " virt-resize indisk outdisk \\\n"
34163 "   --expand /dev/sda2 --LV-expand /dev/vg_guest/lv_root\n"
34164 "\n"
34165 msgstr ""
34166
34167 # type: textblock
34168 #. type: textblock
34169 #: ../tools/virt-resize.pl:436
34170 msgid ""
34171 "This would first expand the partition (and PV), and then expand the root "
34172 "device to fill the extra space in the PV."
34173 msgstr ""
34174
34175 # type: textblock
34176 #. type: textblock
34177 #: ../tools/virt-resize.pl:439
34178 msgid ""
34179 "The contents of the LV are also resized if virt-resize knows how to do "
34180 "that.  You can stop virt-resize from trying to expand the content by using "
34181 "the option C<--no-expand-content>."
34182 msgstr ""
34183
34184 # type: textblock
34185 #. type: textblock
34186 #: ../tools/virt-resize.pl:443
34187 msgid "Use L<virt-filesystems(1)> to list the filesystems in the guest."
34188 msgstr ""
34189
34190 # type: textblock
34191 #. type: textblock
34192 #: ../tools/virt-resize.pl:446
34193 msgid ""
34194 "You can give this option multiple times, I<but> it doesn't make sense to do "
34195 "this unless the logical volumes you specify are all in different volume "
34196 "groups."
34197 msgstr ""
34198
34199 # type: =item
34200 #. type: =item
34201 #: ../tools/virt-resize.pl:454
34202 msgid "B<--no-copy-boot-loader>"
34203 msgstr ""
34204
34205 # type: textblock
34206 #. type: textblock
34207 #: ../tools/virt-resize.pl:456
34208 msgid ""
34209 "By default, virt-resize copies over some sectors at the start of the disk "
34210 "(up to the beginning of the first partition).  Commonly these sectors "
34211 "contain the Master Boot Record (MBR) and the boot loader, and are required "
34212 "in order for the guest to boot correctly."
34213 msgstr ""
34214
34215 # type: textblock
34216 #. type: textblock
34217 #: ../tools/virt-resize.pl:461
34218 msgid ""
34219 "If you specify this flag, then this initial copy is not done.  You may need "
34220 "to reinstall the boot loader in this case."
34221 msgstr ""
34222
34223 # type: =item
34224 #. type: =item
34225 #: ../tools/virt-resize.pl:469
34226 msgid "B<--no-extra-partition>"
34227 msgstr ""
34228
34229 # type: textblock
34230 #. type: textblock
34231 #: ../tools/virt-resize.pl:471
34232 msgid ""
34233 "By default, virt-resize creates an extra partition if there is any extra, "
34234 "unused space after all resizing has happened.  Use this option to prevent "
34235 "the extra partition from being created.  If you do this then the extra space "
34236 "will be inaccessible until you run fdisk, parted, or some other partitioning "
34237 "tool in the guest."
34238 msgstr ""
34239
34240 # type: textblock
34241 #. type: textblock
34242 #: ../tools/virt-resize.pl:477
34243 msgid ""
34244 "Note that if the surplus space is smaller than 10 MB, no extra partition "
34245 "will be created."
34246 msgstr ""
34247
34248 # type: =item
34249 #. type: =item
34250 #: ../tools/virt-resize.pl:484
34251 msgid "B<--no-expand-content>"
34252 msgstr ""
34253
34254 # type: textblock
34255 #. type: textblock
34256 #: ../tools/virt-resize.pl:486
34257 msgid ""
34258 "By default, virt-resize will try to expand the direct contents of "
34259 "partitions, if it knows how (see C<--expand> option above)."
34260 msgstr ""
34261
34262 # type: textblock
34263 #. type: textblock
34264 #: ../tools/virt-resize.pl:489
34265 msgid ""
34266 "If you give the C<--no-expand-content> option then virt-resize will not "
34267 "attempt this."
34268 msgstr ""
34269
34270 # type: =item
34271 #. type: =item
34272 #: ../tools/virt-resize.pl:496
34273 msgid "B<-d> | B<--debug>"
34274 msgstr ""
34275
34276 # type: =item
34277 #. type: =item
34278 #: ../tools/virt-resize.pl:504
34279 msgid "B<-n> | B<--dryrun>"
34280 msgstr ""
34281
34282 # type: textblock
34283 #. type: textblock
34284 #: ../tools/virt-resize.pl:506
34285 msgid "Print a summary of what would be done, but don't do anything."
34286 msgstr ""
34287
34288 # type: =item
34289 #. type: =item
34290 #: ../tools/virt-resize.pl:512
34291 msgid "B<-q> | B<--quiet>"
34292 msgstr ""
34293
34294 # type: textblock
34295 #. type: textblock
34296 #: ../tools/virt-resize.pl:514
34297 msgid "Don't print the summary."
34298 msgstr ""
34299
34300 # type: textblock
34301 #. type: textblock
34302 #: ../tools/virt-resize.pl:522
34303 msgid ""
34304 "Specify the format of the input disk image.  If this flag is not given then "
34305 "it is auto-detected from the image itself."
34306 msgstr ""
34307
34308 # type: textblock
34309 #. type: textblock
34310 #: ../tools/virt-resize.pl:528
34311 msgid ""
34312 "Note that this option I<does not> affect the output format.  See L</QCOW2 "
34313 "AND NON-SPARSE RAW FORMATS>."
34314 msgstr ""
34315
34316 # type: =item
34317 #. type: =item
34318 #: ../tools/virt-resize.pl:535
34319 msgid "B<--output-format> raw"
34320 msgstr ""
34321
34322 # type: textblock
34323 #. type: textblock
34324 #: ../tools/virt-resize.pl:537
34325 msgid ""
34326 "Specify the format of the output disk image.  If this flag is not given then "
34327 "it is auto-detected from the image itself."
34328 msgstr ""
34329
34330 # type: textblock
34331 #. type: textblock
34332 #: ../tools/virt-resize.pl:543
34333 msgid ""
34334 "Note that you still need to create the output disk with the right format.  "
34335 "See L</QCOW2 AND NON-SPARSE RAW FORMATS>."
34336 msgstr ""
34337
34338 # type: =head1
34339 #. type: =head1
34340 #: ../tools/virt-resize.pl:1425
34341 msgid "NOTES"
34342 msgstr ""
34343
34344 # type: =head2
34345 #. type: =head2
34346 #: ../tools/virt-resize.pl:1427
34347 msgid "\"Partition 1 does not end on cylinder boundary.\""
34348 msgstr ""
34349
34350 # type: textblock
34351 #. type: textblock
34352 #: ../tools/virt-resize.pl:1429
34353 msgid ""
34354 "Virt-resize aligns partitions to multiples of 64 sectors.  Usually this "
34355 "means the partitions will not be aligned to the ancient CHS geometry.  "
34356 "However CHS geometry is meaningless for disks manufactured since the early "
34357 "1990s, and doubly so for virtual hard drives.  Alignment of partitions to "
34358 "cylinders is not required by any modern operating system."
34359 msgstr ""
34360
34361 # type: =head2
34362 #. type: =head2
34363 #: ../tools/virt-resize.pl:1436
34364 msgid "RESIZING WINDOWS VIRTUAL MACHINES"
34365 msgstr ""
34366
34367 # type: textblock
34368 #. type: textblock
34369 #: ../tools/virt-resize.pl:1438
34370 msgid ""
34371 "In Windows Vista and later versions, Microsoft switched to using a separate "
34372 "boot partition.  In these VMs, typically C</dev/sda1> is the boot partition "
34373 "and C</dev/sda2> is the main (C:) drive.  We have not had any luck resizing "
34374 "the boot partition.  Doing so seems to break the guest completely.  However "
34375 "expanding the second partition (ie. C: drive) should work."
34376 msgstr ""
34377
34378 # type: textblock
34379 #. type: textblock
34380 #: ../tools/virt-resize.pl:1445
34381 msgid ""
34382 "Windows may initiate a lengthy \"chkdsk\" on first boot after a resize, if "
34383 "NTFS partitions have been expanded.  This is just a safety check and (unless "
34384 "it find errors) is nothing to worry about."
34385 msgstr ""
34386
34387 # type: =head2
34388 #. type: =head2
34389 #: ../tools/virt-resize.pl:1449
34390 msgid "GUEST BOOT STUCK AT \"GRUB\""
34391 msgstr ""
34392
34393 # type: textblock
34394 #. type: textblock
34395 #: ../tools/virt-resize.pl:1451
34396 msgid ""
34397 "If a Linux guest does not boot after resizing, and the boot is stuck after "
34398 "printing C<GRUB> on the console, try reinstalling grub.  This sometimes "
34399 "happens on older (RHEL 5-era) guests, for reasons we don't fully understand, "
34400 "although we think is to do with partition alignment."
34401 msgstr ""
34402
34403 # type: verbatim
34404 #. type: verbatim
34405 #: ../tools/virt-resize.pl:1456
34406 #, no-wrap
34407 msgid ""
34408 " guestfish -i -a newdisk\n"
34409 " ><fs> cat /boot/grub/device.map\n"
34410 " # check the contents of this file are sensible or\n"
34411 " # edit the file if necessary\n"
34412 " ><fs> grub-install / /dev/vda\n"
34413 " ><fs> exit\n"
34414 "\n"
34415 msgstr ""
34416
34417 # type: textblock
34418 #. type: textblock
34419 #: ../tools/virt-resize.pl:1463
34420 msgid ""
34421 "For more flexible guest reconfiguration, including if you need to specify "
34422 "other parameters to grub-install, use L<virt-rescue(1)>."
34423 msgstr ""
34424
34425 # type: =head1
34426 #. type: =head1
34427 #: ../tools/virt-resize.pl:1466
34428 msgid "ALTERNATIVE TOOLS"
34429 msgstr ""
34430
34431 # type: textblock
34432 #. type: textblock
34433 #: ../tools/virt-resize.pl:1468
34434 msgid ""
34435 "There are several proprietary tools for resizing partitions.  We won't "
34436 "mention any here."
34437 msgstr ""
34438
34439 # type: textblock
34440 #. type: textblock
34441 #: ../tools/virt-resize.pl:1471
34442 msgid ""
34443 "L<parted(8)> and its graphical shell gparted can do some types of resizing "
34444 "operations on disk images.  They can resize and move partitions, but I don't "
34445 "think they can do anything with the contents, and they certainly don't "
34446 "understand LVM."
34447 msgstr ""
34448
34449 # type: textblock
34450 #. type: textblock
34451 #: ../tools/virt-resize.pl:1476
34452 msgid ""
34453 "L<guestfish(1)> can do everything that virt-resize can do and a lot more, "
34454 "but at a much lower level.  You will probably end up hand-calculating sector "
34455 "offsets, which is something that virt-resize was designed to avoid.  If you "
34456 "want to see the guestfish-equivalent commands that virt-resize runs, use the "
34457 "C<--debug> flag."
34458 msgstr ""
34459
34460 # type: textblock
34461 #. type: textblock
34462 #: ../tools/virt-resize.pl:1491
34463 msgid ""
34464 "L<virt-filesystems(1)>, L<virt-df(1)>, L<guestfs(3)>, L<guestfish(1)>, L<lvm"
34465 "(8)>, L<pvresize(8)>, L<lvresize(8)>, L<resize2fs(8)>, L<ntfsresize(8)>, "
34466 "L<virsh(1)>, L<parted(8)>, L<truncate(1)>, L<fallocate(1)>, L<grub(8)>, "
34467 "L<grub-install(8)>, L<virt-rescue(1)>, L<Sys::Guestfs(3)>, L<http://"
34468 "libguestfs.org/>."
34469 msgstr ""
34470
34471 # type: textblock
34472 #. type: textblock
34473 #: ../tools/virt-list-filesystems.pl:32
34474 msgid ""
34475 "virt-list-filesystems - List filesystems in a virtual machine or disk image"
34476 msgstr ""
34477
34478 # type: verbatim
34479 #. type: verbatim
34480 #: ../tools/virt-list-filesystems.pl:36
34481 #, no-wrap
34482 msgid ""
34483 " virt-list-filesystems [--options] domname\n"
34484 "\n"
34485 msgstr ""
34486
34487 # type: verbatim
34488 #. type: verbatim
34489 #: ../tools/virt-list-filesystems.pl:38
34490 #, no-wrap
34491 msgid ""
34492 " virt-list-filesystems [--options] disk.img [disk.img ...]\n"
34493 "\n"
34494 msgstr ""
34495
34496 # type: textblock
34497 #. type: textblock
34498 #: ../tools/virt-list-filesystems.pl:42 ../tools/virt-list-partitions.pl:42
34499 msgid ""
34500 "This tool is obsolete.  Use L<virt-filesystems(1)> as a more flexible "
34501 "replacement."
34502 msgstr ""
34503
34504 # type: textblock
34505 #. type: textblock
34506 #: ../tools/virt-list-filesystems.pl:45
34507 msgid ""
34508 "C<virt-list-filesystems> is a command line tool to list the filesystems that "
34509 "are contained in a virtual machine or disk image."
34510 msgstr ""
34511
34512 # type: textblock
34513 #. type: textblock
34514 #: ../tools/virt-list-filesystems.pl:49
34515 msgid ""
34516 "C<virt-list-filesystems> is just a simple wrapper around L<libguestfs(3)> "
34517 "functionality.  For more complex cases you should look at the L<guestfish(1)"
34518 "> tool."
34519 msgstr ""
34520
34521 # type: =item
34522 #. type: =item
34523 #: ../tools/virt-list-filesystems.pl:106 ../tools/virt-list-partitions.pl:115
34524 msgid "B<-l> | B<--long>"
34525 msgstr ""
34526
34527 # type: textblock
34528 #. type: textblock
34529 #: ../tools/virt-list-filesystems.pl:108
34530 msgid ""
34531 "With this option, C<virt-list-filesystems> displays the type of each "
34532 "filesystem too (where \"type\" means C<ext3>, C<xfs> etc.)"
34533 msgstr ""
34534
34535 # type: =item
34536 #. type: =item
34537 #: ../tools/virt-list-filesystems.pl:115
34538 msgid "B<-a> | B<--all>"
34539 msgstr ""
34540
34541 # type: textblock
34542 #. type: textblock
34543 #: ../tools/virt-list-filesystems.pl:117
34544 msgid ""
34545 "Normally we only show mountable filesystems.  If this option is given then "
34546 "swap devices are shown too."
34547 msgstr ""
34548
34549 # type: textblock
34550 #. type: textblock
34551 #: ../tools/virt-list-filesystems.pl:191
34552 msgid ""
34553 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-tar(1)>, L<virt-"
34554 "filesystems(1)>, L<virt-list-partitions(1)>, L<Sys::Guestfs(3)>, L<Sys::"
34555 "Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
34556 msgstr ""
34557
34558 # type: textblock
34559 #. type: textblock
34560 #: ../tools/virt-list-filesystems.pl:208 ../tools/virt-tar.pl:307
34561 msgid "Copyright (C) 2009 Red Hat Inc."
34562 msgstr ""
34563
34564 # type: textblock
34565 #. type: textblock
34566 #: ../tools/virt-tar.pl:33
34567 msgid "virt-tar - Extract or upload files to a virtual machine"
34568 msgstr ""
34569
34570 # type: verbatim
34571 #. type: verbatim
34572 #: ../tools/virt-tar.pl:37
34573 #, no-wrap
34574 msgid ""
34575 " virt-tar [--options] -x domname directory tarball\n"
34576 "\n"
34577 msgstr ""
34578
34579 # type: verbatim
34580 #. type: verbatim
34581 #: ../tools/virt-tar.pl:39
34582 #, no-wrap
34583 msgid ""
34584 " virt-tar [--options] -u domname tarball directory\n"
34585 "\n"
34586 msgstr ""
34587
34588 # type: verbatim
34589 #. type: verbatim
34590 #: ../tools/virt-tar.pl:41
34591 #, no-wrap
34592 msgid ""
34593 " virt-tar [--options] disk.img [disk.img ...] -x directory tarball\n"
34594 "\n"
34595 msgstr ""
34596
34597 # type: verbatim
34598 #. type: verbatim
34599 #: ../tools/virt-tar.pl:43
34600 #, no-wrap
34601 msgid ""
34602 " virt-tar [--options] disk.img [disk.img ...] -u tarball directory\n"
34603 "\n"
34604 msgstr ""
34605
34606 #. type: textblock
34607 #: ../tools/virt-tar.pl:47
34608 msgid ""
34609 "This tool is obsolete.  Use L<virt-copy-in(1)>, L<virt-copy-out(1)>, L<virt-"
34610 "tar-in(1)>, L<virt-tar-out(1)> as replacements."
34611 msgstr ""
34612
34613 # type: textblock
34614 #. type: textblock
34615 #: ../tools/virt-tar.pl:52
34616 msgid "Download C</home> from the VM into a local tarball:"
34617 msgstr ""
34618
34619 # type: verbatim
34620 #. type: verbatim
34621 #: ../tools/virt-tar.pl:54
34622 #, no-wrap
34623 msgid ""
34624 " virt-tar -x domname /home home.tar\n"
34625 "\n"
34626 msgstr ""
34627
34628 # type: verbatim
34629 #. type: verbatim
34630 #: ../tools/virt-tar.pl:56
34631 #, no-wrap
34632 msgid ""
34633 " virt-tar -zx domname /home home.tar.gz\n"
34634 "\n"
34635 msgstr ""
34636
34637 # type: textblock
34638 #. type: textblock
34639 #: ../tools/virt-tar.pl:58
34640 msgid "Upload a local tarball and unpack it inside C</tmp> in the VM:"
34641 msgstr ""
34642
34643 # type: verbatim
34644 #. type: verbatim
34645 #: ../tools/virt-tar.pl:60
34646 #, no-wrap
34647 msgid ""
34648 " virt-tar -u domname uploadstuff.tar /tmp\n"
34649 "\n"
34650 msgstr ""
34651
34652 # type: verbatim
34653 #. type: verbatim
34654 #: ../tools/virt-tar.pl:62
34655 #, no-wrap
34656 msgid ""
34657 " virt-tar -zu domname uploadstuff.tar.gz /tmp\n"
34658 "\n"
34659 msgstr ""
34660
34661 # type: textblock
34662 #. type: textblock
34663 #: ../tools/virt-tar.pl:66
34664 msgid ""
34665 "You must I<not> use C<virt-tar> with the C<-u> option (upload) on live "
34666 "virtual machines.  If you do this, you risk disk corruption in the VM.  "
34667 "C<virt-tar> tries to stop you from doing this, but doesn't catch all cases."
34668 msgstr ""
34669
34670 # type: textblock
34671 #. type: textblock
34672 #: ../tools/virt-tar.pl:71
34673 msgid ""
34674 "You can use C<-x> (extract) on live virtual machines, but you might get "
34675 "inconsistent results or errors if there is filesystem activity inside the "
34676 "VM.  If the live VM is synched and quiescent, then C<virt-tar> will usually "
34677 "work, but the only way to guarantee consistent results is if the virtual "
34678 "machine is shut down."
34679 msgstr ""
34680
34681 # type: textblock
34682 #. type: textblock
34683 #: ../tools/virt-tar.pl:79
34684 msgid ""
34685 "C<virt-tar> is a general purpose archive tool for downloading and uploading "
34686 "parts of a guest filesystem.  There are many possibilities: making backups, "
34687 "uploading data files, snooping on guest activity, fixing or customizing "
34688 "guests, etc."
34689 msgstr ""
34690
34691 # type: textblock
34692 #. type: textblock
34693 #: ../tools/virt-tar.pl:84
34694 msgid ""
34695 "If you want to just view a single file, use L<virt-cat(1)>.  If you just "
34696 "want to edit a single file, use L<virt-edit(1)>.  For more complex cases you "
34697 "should look at the L<guestfish(1)> tool."
34698 msgstr ""
34699
34700 # type: textblock
34701 #. type: textblock
34702 #: ../tools/virt-tar.pl:88
34703 msgid ""
34704 "There are two modes of operation: C<-x> (eXtract) downloads a directory and "
34705 "its contents (recursively) from the virtual machine into a local tarball.  "
34706 "C<-u> uploads from a local tarball, unpacking it into a directory inside the "
34707 "virtual machine.  You cannot use these two options together."
34708 msgstr ""
34709
34710 # type: textblock
34711 #. type: textblock
34712 #: ../tools/virt-tar.pl:94
34713 msgid ""
34714 "In addition, you may need to use the C<-z> (gZip) option to enable "
34715 "compression.  When uploading, you have to specify C<-z> if the upload file "
34716 "is compressed because virt-tar won't detect this on its own."
34717 msgstr ""
34718
34719 # type: textblock
34720 #. type: textblock
34721 #: ../tools/virt-tar.pl:98
34722 msgid ""
34723 "C<virt-tar> can only handle tar (optionally gzipped) format tarballs.  For "
34724 "example it cannot do PKZip files or bzip2 compression.  If you want that "
34725 "then you'll have to rebuild the tarballs yourself.  (This is a limitation of "
34726 "the L<libguestfs(3)> API)."
34727 msgstr ""
34728
34729 # type: =item
34730 #. type: =item
34731 #: ../tools/virt-tar.pl:156
34732 msgid "B<-x> | B<--extract> | B<--download>"
34733 msgstr ""
34734
34735 # type: =item
34736 #. type: =item
34737 #: ../tools/virt-tar.pl:158
34738 msgid "B<-u> | B<--upload>"
34739 msgstr ""
34740
34741 # type: textblock
34742 #. type: textblock
34743 #: ../tools/virt-tar.pl:160
34744 msgid ""
34745 "Use C<-x> to extract (download) a directory from a virtual machine to a "
34746 "local tarball."
34747 msgstr ""
34748
34749 # type: textblock
34750 #. type: textblock
34751 #: ../tools/virt-tar.pl:163
34752 msgid ""
34753 "Use C<-u> to upload and unpack from a local tarball into a virtual machine.  "
34754 "Please read the L</WARNING> section above before using this option."
34755 msgstr ""
34756
34757 # type: textblock
34758 #. type: textblock
34759 #: ../tools/virt-tar.pl:167
34760 msgid "You must specify exactly one of these options."
34761 msgstr ""
34762
34763 # type: =item
34764 #. type: =item
34765 #: ../tools/virt-tar.pl:173
34766 msgid "B<-z> | B<--gzip>"
34767 msgstr ""
34768
34769 # type: textblock
34770 #. type: textblock
34771 #: ../tools/virt-tar.pl:175
34772 msgid "Specify that the input or output tarball is gzip-compressed."
34773 msgstr ""
34774
34775 #. type: textblock
34776 #: ../tools/virt-tar.pl:288
34777 msgid ""
34778 "L<guestfs(3)>, L<guestfish(1)>, L<virt-cat(1)>, L<virt-edit(1)>, L<virt-copy-"
34779 "in(1)>, L<virt-copy-out(1)>, L<virt-tar-in(1)>, L<virt-tar-out(1)>, L<Sys::"
34780 "Guestfs(3)>, L<Sys::Guestfs::Lib(3)>, L<Sys::Virt(3)>, L<http://libguestfs."
34781 "org/>."
34782 msgstr ""
34783
34784 # type: textblock
34785 #. type: textblock
34786 #: ../tools/virt-make-fs.pl:37
34787 msgid "virt-make-fs - Make a filesystem from a tar archive or files"
34788 msgstr ""
34789
34790 # type: verbatim
34791 #. type: verbatim
34792 #: ../tools/virt-make-fs.pl:41
34793 #, no-wrap
34794 msgid ""
34795 " virt-make-fs [--options] input.tar output.img\n"
34796 "\n"
34797 msgstr ""
34798
34799 # type: verbatim
34800 #. type: verbatim
34801 #: ../tools/virt-make-fs.pl:43
34802 #, no-wrap
34803 msgid ""
34804 " virt-make-fs [--options] input.tar.gz output.img\n"
34805 "\n"
34806 msgstr ""
34807
34808 # type: verbatim
34809 #. type: verbatim
34810 #: ../tools/virt-make-fs.pl:45
34811 #, no-wrap
34812 msgid ""
34813 " virt-make-fs [--options] directory output.img\n"
34814 "\n"
34815 msgstr ""
34816
34817 # type: textblock
34818 #. type: textblock
34819 #: ../tools/virt-make-fs.pl:49
34820 msgid ""
34821 "Virt-make-fs is a command line tool for creating a filesystem from a tar "
34822 "archive or some files in a directory.  It is similar to tools like L<mkisofs"
34823 "(1)>, L<genisoimage(1)> and L<mksquashfs(1)>.  Unlike those tools, it can "
34824 "create common filesystem types like ext2/3 or NTFS, which can be useful if "
34825 "you want to attach these filesystems to existing virtual machines (eg. to "
34826 "import large amounts of read-only data to a VM)."
34827 msgstr ""
34828
34829 # type: textblock
34830 #. type: textblock
34831 #: ../tools/virt-make-fs.pl:57
34832 msgid "Basic usage is:"
34833 msgstr ""
34834
34835 # type: verbatim
34836 #. type: verbatim
34837 #: ../tools/virt-make-fs.pl:59
34838 #, no-wrap
34839 msgid ""
34840 " virt-make-fs input output\n"
34841 "\n"
34842 msgstr ""
34843
34844 # type: textblock
34845 #. type: textblock
34846 #: ../tools/virt-make-fs.pl:61
34847 msgid ""
34848 "where C<input> is either a directory containing files that you want to add, "
34849 "or a tar archive (either uncompressed tar or gzip-compressed tar); and "
34850 "C<output> is a disk image.  The input type is detected automatically.  The "
34851 "output disk image defaults to a raw ext2 image unless you specify extra "
34852 "flags (see L</OPTIONS> below)."
34853 msgstr ""
34854
34855 # type: =head2
34856 #. type: =head2
34857 #: ../tools/virt-make-fs.pl:67
34858 msgid "EXTRA SPACE"
34859 msgstr ""
34860
34861 # type: textblock
34862 #. type: textblock
34863 #: ../tools/virt-make-fs.pl:69
34864 msgid ""
34865 "Unlike formats such as tar and squashfs, a filesystem does not \"just fit\" "
34866 "the files that it contains, but might have extra space.  Depending on how "
34867 "you are going to use the output, you might think this extra space is wasted "
34868 "and want to minimize it, or you might want to leave space so that more files "
34869 "can be added later.  Virt-make-fs defaults to minimizing the extra space, "
34870 "but you can use the C<--size> flag to leave space in the filesystem if you "
34871 "want it."
34872 msgstr ""
34873
34874 # type: textblock
34875 #. type: textblock
34876 #: ../tools/virt-make-fs.pl:77
34877 msgid ""
34878 "An alternative way to leave extra space but not make the output image any "
34879 "bigger is to use an alternative disk image format (instead of the default "
34880 "\"raw\" format).  Using C<--format=qcow2> will use the native QEmu/KVM qcow2 "
34881 "image format (check your hypervisor supports this before using it).  This "
34882 "allows you to choose a large C<--size> but the extra space won't actually be "
34883 "allocated in the image until you try to store something in it."
34884 msgstr ""
34885
34886 #. type: textblock
34887 #: ../tools/virt-make-fs.pl:85
34888 msgid ""
34889 "Don't forget that you can also use local commands including L<resize2fs(8)> "
34890 "and L<virt-resize(1)> to resize existing filesystems, or rerun virt-make-fs "
34891 "to build another image from scratch."
34892 msgstr ""
34893
34894 # type: =head3
34895 #. type: =head3
34896 #: ../tools/virt-make-fs.pl:89 ../tools/virt-make-fs.pl:123
34897 #: ../tools/virt-make-fs.pl:142
34898 msgid "EXAMPLE"
34899 msgstr ""
34900
34901 # type: verbatim
34902 #. type: verbatim
34903 #: ../tools/virt-make-fs.pl:91
34904 #, no-wrap
34905 msgid ""
34906 " virt-make-fs --format=qcow2 --size=+200M input output.img\n"
34907 "\n"
34908 msgstr ""
34909
34910 # type: =head2
34911 #. type: =head2
34912 #: ../tools/virt-make-fs.pl:93
34913 msgid "FILESYSTEM TYPE"
34914 msgstr ""
34915
34916 # type: textblock
34917 #. type: textblock
34918 #: ../tools/virt-make-fs.pl:95
34919 msgid ""
34920 "The default filesystem type is C<ext2>.  Just about any filesystem type that "
34921 "libguestfs supports can be used (but I<not> read-only formats like "
34922 "ISO9660).  Here are some of the more common choices:"
34923 msgstr ""
34924
34925 # type: =item
34926 #. type: =item
34927 #: ../tools/virt-make-fs.pl:101
34928 msgid "I<ext3>"
34929 msgstr ""
34930
34931 # type: textblock
34932 #. type: textblock
34933 #: ../tools/virt-make-fs.pl:103
34934 msgid ""
34935 "Note that ext3 filesystems contain a journal, typically 1-32 MB in size.  If "
34936 "you are not going to use the filesystem in a way that requires the journal, "
34937 "then this is just wasted overhead."
34938 msgstr ""
34939
34940 # type: =item
34941 #. type: =item
34942 #: ../tools/virt-make-fs.pl:107
34943 msgid "I<ntfs> or I<vfat>"
34944 msgstr ""
34945
34946 # type: textblock
34947 #. type: textblock
34948 #: ../tools/virt-make-fs.pl:109
34949 msgid "Useful if exporting data to a Windows guest."
34950 msgstr ""
34951
34952 # type: textblock
34953 #. type: textblock
34954 #: ../tools/virt-make-fs.pl:111
34955 msgid ""
34956 "I<Note for vfat>: The tar archive or local directory must only contain files "
34957 "which are owned by root (ie. UID:GID = 0:0).  The reason is that the tar "
34958 "program running within libguestfs is unable to change the ownership of non-"
34959 "root files, since vfat itself does not support this."
34960 msgstr ""
34961
34962 # type: =item
34963 #. type: =item
34964 #: ../tools/virt-make-fs.pl:116
34965 msgid "I<minix>"
34966 msgstr ""
34967
34968 # type: textblock
34969 #. type: textblock
34970 #: ../tools/virt-make-fs.pl:118
34971 msgid ""
34972 "Lower overhead than C<ext2>, but certain limitations on filename length and "
34973 "total filesystem size."
34974 msgstr ""
34975
34976 # type: verbatim
34977 #. type: verbatim
34978 #: ../tools/virt-make-fs.pl:125
34979 #, no-wrap
34980 msgid ""
34981 " virt-make-fs --type=minix input minixfs.img\n"
34982 "\n"
34983 msgstr ""
34984
34985 # type: =head2
34986 #. type: =head2
34987 #: ../tools/virt-make-fs.pl:127
34988 msgid "TO PARTITION OR NOT TO PARTITION"
34989 msgstr ""
34990
34991 # type: textblock
34992 #. type: textblock
34993 #: ../tools/virt-make-fs.pl:129
34994 msgid "Optionally virt-make-fs can add a partition table to the output disk."
34995 msgstr ""
34996
34997 # type: textblock
34998 #. type: textblock
34999 #: ../tools/virt-make-fs.pl:131
35000 msgid ""
35001 "Adding a partition can make the disk image more compatible with certain "
35002 "virtualized operating systems which don't expect to see a filesystem "
35003 "directly located on a block device (Linux doesn't care and will happily "
35004 "handle both types)."
35005 msgstr ""
35006
35007 # type: textblock
35008 #. type: textblock
35009 #: ../tools/virt-make-fs.pl:136
35010 msgid ""
35011 "On the other hand, if you have a partition table then the output image is no "
35012 "longer a straight filesystem.  For example you cannot run L<fsck(8)> "
35013 "directly on a partitioned disk image.  (However libguestfs tools such as "
35014 "L<guestfish(1)> and L<virt-resize(1)> can still be used)."
35015 msgstr ""
35016
35017 # type: textblock
35018 #. type: textblock
35019 #: ../tools/virt-make-fs.pl:144
35020 msgid "Add an MBR partition:"
35021 msgstr ""
35022
35023 # type: verbatim
35024 #. type: verbatim
35025 #: ../tools/virt-make-fs.pl:146
35026 #, no-wrap
35027 msgid ""
35028 " virt-make-fs --partition -- input disk.img\n"
35029 "\n"
35030 msgstr ""
35031
35032 # type: textblock
35033 #. type: textblock
35034 #: ../tools/virt-make-fs.pl:148
35035 msgid ""
35036 "If the output disk image could be terabyte-sized or larger, it's better to "
35037 "use an EFI/GPT-compatible partition table:"
35038 msgstr ""
35039
35040 # type: verbatim
35041 #. type: verbatim
35042 #: ../tools/virt-make-fs.pl:151
35043 #, no-wrap
35044 msgid ""
35045 " virt-make-fs --partition=gpt --size=+4T --format=qcow2 input disk.img\n"
35046 "\n"
35047 msgstr ""
35048
35049 # type: textblock
35050 #. type: textblock
35051 #: ../tools/virt-make-fs.pl:179
35052 msgid "Enable debugging information."
35053 msgstr ""
35054
35055 # type: =item
35056 #. type: =item
35057 #: ../tools/virt-make-fs.pl:185
35058 msgid "B<--size=E<lt>NE<gt>>"
35059 msgstr ""
35060
35061 # type: =item
35062 #. type: =item
35063 #: ../tools/virt-make-fs.pl:187
35064 msgid "B<--size=+E<lt>NE<gt>>"
35065 msgstr ""
35066
35067 # type: =item
35068 #. type: =item
35069 #: ../tools/virt-make-fs.pl:189
35070 msgid "B<-s E<lt>NE<gt>>"
35071 msgstr ""
35072
35073 # type: =item
35074 #. type: =item
35075 #: ../tools/virt-make-fs.pl:191
35076 msgid "B<-s +E<lt>NE<gt>>"
35077 msgstr ""
35078
35079 # type: textblock
35080 #. type: textblock
35081 #: ../tools/virt-make-fs.pl:193
35082 msgid ""
35083 "Use the C<--size> (or C<-s>) option to choose the size of the output image."
35084 msgstr ""
35085
35086 # type: textblock
35087 #. type: textblock
35088 #: ../tools/virt-make-fs.pl:196
35089 msgid ""
35090 "If this option is I<not> given, then the output image will be just large "
35091 "enough to contain all the files, with not much wasted space."
35092 msgstr ""
35093
35094 # type: textblock
35095 #. type: textblock
35096 #: ../tools/virt-make-fs.pl:199
35097 msgid ""
35098 "To choose a fixed size output disk, specify an absolute number followed by b/"
35099 "K/M/G/T/P/E to mean bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, "
35100 "Petabytes or Exabytes.  This must be large enough to contain all the input "
35101 "files, else you will get an error."
35102 msgstr ""
35103
35104 # type: textblock
35105 #. type: textblock
35106 #: ../tools/virt-make-fs.pl:204
35107 msgid ""
35108 "To leave extra space, specify C<+> (plus sign) and a number followed by b/K/"
35109 "M/G/T/P/E to mean bytes, Kilobytes, Megabytes, Gigabytes, Terabytes, "
35110 "Petabytes or Exabytes.  For example: C<--size=+200M> means enough space for "
35111 "the input files, and (approximately) an extra 200 MB free space."
35112 msgstr ""
35113
35114 # type: textblock
35115 #. type: textblock
35116 #: ../tools/virt-make-fs.pl:210
35117 msgid ""
35118 "Note that virt-make-fs estimates free space, and therefore will not produce "
35119 "filesystems containing precisely the free space requested.  (It is much more "
35120 "expensive and time-consuming to produce a filesystem which has precisely the "
35121 "desired free space)."
35122 msgstr ""
35123
35124 # type: =item
35125 #. type: =item
35126 #: ../tools/virt-make-fs.pl:219
35127 msgid "B<--format=E<lt>fmtE<gt>>"
35128 msgstr ""
35129
35130 # type: =item
35131 #. type: =item
35132 #: ../tools/virt-make-fs.pl:221
35133 msgid "B<-F E<lt>fmtE<gt>>"
35134 msgstr ""
35135
35136 # type: textblock
35137 #. type: textblock
35138 #: ../tools/virt-make-fs.pl:223
35139 msgid "Choose the output disk image format."
35140 msgstr ""
35141
35142 # type: textblock
35143 #. type: textblock
35144 #: ../tools/virt-make-fs.pl:225
35145 msgid "The default is C<raw> (raw disk image)."
35146 msgstr ""
35147
35148 # type: textblock
35149 #. type: textblock
35150 #: ../tools/virt-make-fs.pl:227
35151 msgid ""
35152 "For other choices, see the L<qemu-img(1)> manpage.  The only other choice "
35153 "that would really make sense here is C<qcow2>."
35154 msgstr ""
35155
35156 # type: =item
35157 #. type: =item
35158 #: ../tools/virt-make-fs.pl:234
35159 msgid "B<--type=E<lt>fsE<gt>>"
35160 msgstr ""
35161
35162 # type: =item
35163 #. type: =item
35164 #: ../tools/virt-make-fs.pl:236
35165 msgid "B<-t E<lt>fsE<gt>>"
35166 msgstr ""
35167
35168 # type: textblock
35169 #. type: textblock
35170 #: ../tools/virt-make-fs.pl:238
35171 msgid "Choose the output filesystem type."
35172 msgstr ""
35173
35174 # type: textblock
35175 #. type: textblock
35176 #: ../tools/virt-make-fs.pl:240
35177 msgid "The default is C<ext2>."
35178 msgstr ""
35179
35180 # type: textblock
35181 #. type: textblock
35182 #: ../tools/virt-make-fs.pl:242
35183 msgid ""
35184 "Any filesystem which is supported read-write by libguestfs can be used here."
35185 msgstr ""
35186
35187 # type: =item
35188 #. type: =item
35189 #: ../tools/virt-make-fs.pl:249
35190 msgid "B<--partition>"
35191 msgstr ""
35192
35193 # type: =item
35194 #. type: =item
35195 #: ../tools/virt-make-fs.pl:251
35196 msgid "B<--partition=E<lt>parttypeE<gt>>"
35197 msgstr ""
35198
35199 # type: textblock
35200 #. type: textblock
35201 #: ../tools/virt-make-fs.pl:253
35202 msgid ""
35203 "If specified, this flag adds an MBR partition table to the output disk image."
35204 msgstr ""
35205
35206 # type: textblock
35207 #. type: textblock
35208 #: ../tools/virt-make-fs.pl:256
35209 msgid ""
35210 "You can change the partition table type, eg. C<--partition=gpt> for large "
35211 "disks."
35212 msgstr ""
35213
35214 # type: textblock
35215 #. type: textblock
35216 #: ../tools/virt-make-fs.pl:259
35217 msgid ""
35218 "Note that if you just use a lonesome C<--partition>, the Perl option parser "
35219 "might consider the next parameter to be the partition type.  For example:"
35220 msgstr ""
35221
35222 # type: verbatim
35223 #. type: verbatim
35224 #: ../tools/virt-make-fs.pl:263
35225 #, no-wrap
35226 msgid ""
35227 " virt-make-fs --partition input.tar ...\n"
35228 "\n"
35229 msgstr ""
35230
35231 # type: textblock
35232 #. type: textblock
35233 #: ../tools/virt-make-fs.pl:265
35234 msgid ""
35235 "would cause virt-make-fs to think you wanted to use a partition type of "
35236 "C<input.tar> which is completely wrong.  To avoid this, use C<--> (a double "
35237 "dash) between options and the input file argument:"
35238 msgstr ""
35239
35240 # type: verbatim
35241 #. type: verbatim
35242 #: ../tools/virt-make-fs.pl:269
35243 #, no-wrap
35244 msgid ""
35245 " virt-make-fs --partition -- input.tar ...\n"
35246 "\n"
35247 msgstr ""
35248
35249 #. type: textblock
35250 #: ../tools/virt-make-fs.pl:541
35251 msgid ""
35252 "L<guestfish(1)>, L<virt-resize(1)>, L<virt-tar-in(1)>, L<mkisofs(1)>, "
35253 "L<genisoimage(1)>, L<mksquashfs(1)>, L<mke2fs(8)>, L<resize2fs(8)>, L<guestfs"
35254 "(3)>, L<Sys::Guestfs(3)>, L<http://libguestfs.org/>."
35255 msgstr ""
35256
35257 # type: verbatim
35258 #. type: verbatim
35259 #: ../tools/virt-make-fs.pl:558
35260 #, no-wrap
35261 msgid ""
35262 " export LIBGUESTFS_DEBUG=1\n"
35263 " virt-make-fs --debug [...] > /tmp/virt-make-fs.log 2>&1\n"
35264 "\n"
35265 msgstr ""
35266
35267 # type: textblock
35268 #. type: textblock
35269 #: ../tools/virt-make-fs.pl:561
35270 msgid ""
35271 "Attach /tmp/virt-make-fs.log to a new bug report at L<https://bugzilla."
35272 "redhat.com/>"
35273 msgstr ""
35274
35275 # type: textblock
35276 #. type: textblock
35277 #: ../tools/virt-list-partitions.pl:32
35278 msgid ""
35279 "virt-list-partitions - List partitions in a virtual machine or disk image"
35280 msgstr ""
35281
35282 # type: verbatim
35283 #. type: verbatim
35284 #: ../tools/virt-list-partitions.pl:36
35285 #, no-wrap
35286 msgid ""
35287 " virt-list-partitions [--options] domname\n"
35288 "\n"
35289 msgstr ""
35290
35291 # type: verbatim
35292 #. type: verbatim
35293 #: ../tools/virt-list-partitions.pl:38
35294 #, no-wrap
35295 msgid ""
35296 " virt-list-partitions [--options] disk.img [disk.img ...]\n"
35297 "\n"
35298 msgstr ""
35299
35300 # type: textblock
35301 #. type: textblock
35302 #: ../tools/virt-list-partitions.pl:45
35303 msgid ""
35304 "C<virt-list-partitions> is a command line tool to list the partitions that "
35305 "are contained in a virtual machine or disk image.  It is mainly useful as a "
35306 "first step to using L<virt-resize(1)>."
35307 msgstr ""
35308
35309 # type: textblock
35310 #. type: textblock
35311 #: ../tools/virt-list-partitions.pl:50
35312 msgid ""
35313 "C<virt-list-partitions> is just a simple wrapper around L<libguestfs(3)> "
35314 "functionality.  For more complex cases you should look at the L<guestfish(1)"
35315 "> tool."
35316 msgstr ""
35317
35318 # type: =item
35319 #. type: =item
35320 #: ../tools/virt-list-partitions.pl:107
35321 msgid "B<-h> | B<--human-readable>"
35322 msgstr ""
35323
35324 # type: textblock
35325 #. type: textblock
35326 #: ../tools/virt-list-partitions.pl:109
35327 msgid "Show sizes in human-readable form (eg. \"1G\")."
35328 msgstr ""
35329
35330 # type: textblock
35331 #. type: textblock
35332 #: ../tools/virt-list-partitions.pl:117
35333 msgid ""
35334 "With this option, C<virt-list-partitions> displays the type and size of each "
35335 "partition too (where \"type\" means C<ext3>, C<pv> etc.)"
35336 msgstr ""
35337
35338 # type: =item
35339 #. type: =item
35340 #: ../tools/virt-list-partitions.pl:124
35341 msgid "B<-t> | B<--total>"
35342 msgstr ""
35343
35344 # type: textblock
35345 #. type: textblock
35346 #: ../tools/virt-list-partitions.pl:126
35347 msgid ""
35348 "Display the total size of each block device (as a separate row or rows)."
35349 msgstr ""
35350
35351 # type: textblock
35352 #. type: textblock
35353 #: ../tools/virt-list-partitions.pl:259
35354 msgid ""
35355 "L<guestfs(3)>, L<guestfish(1)>, L<virt-filesystems(1)>, L<virt-list-"
35356 "filesystems(1)>, L<virt-resize(1)>, L<Sys::Guestfs(3)>, L<Sys::Guestfs::Lib"
35357 "(3)>, L<Sys::Virt(3)>, L<http://libguestfs.org/>."
35358 msgstr ""